/ Hex Artifact Content
Login

Artifact 192e0dbeaaa0bfa652b0c2579c19894e5e5626fc:


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 66 28  p, int N){.  if(
0690: 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f   p->magic==VDBE_
06a0: 4d 41 47 49 43 5f 52 55 4e 20 29 7b 0a 20 20 20  MAGIC_RUN ){.   
06b0: 20 61 73 73 65 72 74 28 20 4e 3d 3d 70 2d 3e 6e   assert( N==p->n
06c0: 4f 70 20 29 3b 0a 20 20 20 20 70 2d 3e 6e 4f 70  Op );.    p->nOp
06d0: 41 6c 6c 6f 63 20 3d 20 4e 3b 0a 20 20 20 20 70  Alloc = N;.    p
06e0: 2d 3e 61 4f 70 20 3d 20 73 71 6c 69 74 65 52 65  ->aOp = sqliteRe
06f0: 61 6c 6c 6f 63 28 70 2d 3e 61 4f 70 2c 20 4e 2a  alloc(p->aOp, N*
0700: 73 69 7a 65 6f 66 28 4f 70 29 29 3b 0a 20 20 7d  sizeof(Op));.  }
0710: 65 6c 73 65 20 69 66 28 20 70 2d 3e 6e 4f 70 41  else if( p->nOpA
0720: 6c 6c 6f 63 3c 4e 20 29 7b 0a 20 20 20 20 69 6e  lloc<N ){.    in
0730: 74 20 6f 6c 64 53 69 7a 65 20 3d 20 70 2d 3e 6e  t oldSize = p->n
0740: 4f 70 41 6c 6c 6f 63 3b 0a 20 20 20 20 70 2d 3e  OpAlloc;.    p->
0750: 6e 4f 70 41 6c 6c 6f 63 20 3d 20 4e 2b 31 30 30  nOpAlloc = N+100
0760: 3b 0a 20 20 20 20 70 2d 3e 61 4f 70 20 3d 20 73  ;.    p->aOp = s
0770: 71 6c 69 74 65 52 65 61 6c 6c 6f 63 28 70 2d 3e  qliteRealloc(p->
0780: 61 4f 70 2c 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63  aOp, p->nOpAlloc
0790: 2a 73 69 7a 65 6f 66 28 4f 70 29 29 3b 0a 20 20  *sizeof(Op));.  
07a0: 20 20 69 66 28 20 70 2d 3e 61 4f 70 20 29 7b 0a    if( p->aOp ){.
07b0: 20 20 20 20 20 20 6d 65 6d 73 65 74 28 26 70 2d        memset(&p-
07c0: 3e 61 4f 70 5b 6f 6c 64 53 69 7a 65 5d 2c 20 30  >aOp[oldSize], 0
07d0: 2c 20 28 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 2d 6f  , (p->nOpAlloc-o
07e0: 6c 64 53 69 7a 65 29 2a 73 69 7a 65 6f 66 28 4f  ldSize)*sizeof(O
07f0: 70 29 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d  p));.    }.  }.}
0800: 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 6e 65  ../*.** Add a ne
0810: 77 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f  w instruction to
0820: 20 74 68 65 20 6c 69 73 74 20 6f 66 20 69 6e 73   the list of ins
0830: 74 72 75 63 74 69 6f 6e 73 20 63 75 72 72 65 6e  tructions curren
0840: 74 20 69 6e 20 74 68 65 0a 2a 2a 20 56 44 42 45  t in the.** VDBE
0850: 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 64  .  Return the ad
0860: 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 77  dress of the new
0870: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a   instruction..**
0880: 0a 2a 2a 20 50 61 72 61 6d 65 74 65 72 73 3a 0a  .** Parameters:.
0890: 2a 2a 0a 2a 2a 20 20 20 20 70 20 20 20 20 20 20  **.**    p      
08a0: 20 20 20 20 20 20 20 20 20 50 6f 69 6e 74 65 72           Pointer
08b0: 20 74 6f 20 74 68 65 20 56 44 42 45 0a 2a 2a 0a   to the VDBE.**.
08c0: 2a 2a 20 20 20 20 6f 70 20 20 20 20 20 20 20 20  **    op        
08d0: 20 20 20 20 20 20 54 68 65 20 6f 70 63 6f 64 65        The opcode
08e0: 20 66 6f 72 20 74 68 69 73 20 69 6e 73 74 72 75   for this instru
08f0: 63 74 69 6f 6e 0a 2a 2a 0a 2a 2a 20 20 20 20 70  ction.**.**    p
0900: 31 2c 20 70 32 20 20 20 20 20 20 20 20 20 20 46  1, p2          F
0910: 69 72 73 74 20 74 77 6f 20 6f 66 20 74 68 65 20  irst two of the 
0920: 74 68 72 65 65 20 70 6f 73 73 69 62 6c 65 20 6f  three possible o
0930: 70 65 72 61 6e 64 73 2e 0a 2a 2a 0a 2a 2a 20 55  perands..**.** U
0940: 73 65 20 74 68 65 20 73 71 6c 69 74 65 33 56 64  se the sqlite3Vd
0950: 62 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 29  beResolveLabel()
0960: 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 66 69 78   function to fix
0970: 20 61 6e 20 61 64 64 72 65 73 73 20 61 6e 64 0a   an address and.
0980: 2a 2a 20 74 68 65 20 73 71 6c 69 74 65 33 56 64  ** the sqlite3Vd
0990: 62 65 43 68 61 6e 67 65 50 33 28 29 20 66 75 6e  beChangeP3() fun
09a0: 63 74 69 6f 6e 20 74 6f 20 63 68 61 6e 67 65 20  ction to change 
09b0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65  the value of the
09c0: 20 50 33 0a 2a 2a 20 6f 70 65 72 61 6e 64 2e 0a   P3.** operand..
09d0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
09e0: 62 65 41 64 64 4f 70 28 56 64 62 65 20 2a 70 2c  beAddOp(Vdbe *p,
09f0: 20 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c   int op, int p1,
0a00: 20 69 6e 74 20 70 32 29 7b 0a 20 20 69 6e 74 20   int p2){.  int 
0a10: 69 3b 0a 20 20 56 64 62 65 4f 70 20 2a 70 4f 70  i;.  VdbeOp *pOp
0a20: 3b 0a 0a 20 20 69 20 3d 20 70 2d 3e 6e 4f 70 3b  ;..  i = p->nOp;
0a30: 0a 20 20 70 2d 3e 6e 4f 70 2b 2b 3b 0a 20 20 61  .  p->nOp++;.  a
0a40: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
0a50: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
0a60: 20 29 3b 0a 20 20 72 65 73 69 7a 65 4f 70 41 72   );.  resizeOpAr
0a70: 72 61 79 28 70 2c 20 69 2b 31 29 3b 0a 20 20 69  ray(p, i+1);.  i
0a80: 66 28 20 70 2d 3e 61 4f 70 3d 3d 30 20 29 7b 0a  f( p->aOp==0 ){.
0a90: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
0aa0: 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f  }.  pOp = &p->aO
0ab0: 70 5b 69 5d 3b 0a 20 20 70 4f 70 2d 3e 6f 70 63  p[i];.  pOp->opc
0ac0: 6f 64 65 20 3d 20 6f 70 3b 0a 20 20 70 4f 70 2d  ode = op;.  pOp-
0ad0: 3e 70 31 20 3d 20 70 31 3b 0a 20 20 70 4f 70 2d  >p1 = p1;.  pOp-
0ae0: 3e 70 32 20 3d 20 70 32 3b 0a 20 20 70 4f 70 2d  >p2 = p2;.  pOp-
0af0: 3e 70 33 20 3d 20 30 3b 0a 20 20 70 4f 70 2d 3e  >p3 = 0;.  pOp->
0b00: 70 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55  p3type = P3_NOTU
0b10: 53 45 44 3b 0a 20 20 70 2d 3e 65 78 70 69 72 65  SED;.  p->expire
0b20: 64 20 3d 20 30 3b 0a 23 69 66 64 65 66 20 53 51  d = 0;.#ifdef SQ
0b30: 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 69 66 28  LITE_DEBUG.  if(
0b40: 20 73 71 6c 69 74 65 33 5f 76 64 62 65 5f 61 64   sqlite3_vdbe_ad
0b50: 64 6f 70 5f 74 72 61 63 65 20 29 20 73 71 6c 69  dop_trace ) sqli
0b60: 74 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28 30  te3VdbePrintOp(0
0b70: 2c 20 69 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29  , i, &p->aOp[i])
0b80: 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72  ;.#endif.  retur
0b90: 6e 20 69 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64  n i;.}../*.** Ad
0ba0: 64 20 61 6e 20 6f 70 63 6f 64 65 20 74 68 61 74  d an opcode that
0bb0: 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20 70 33   includes the p3
0bc0: 20 76 61 6c 75 65 2e 0a 2a 2f 0a 69 6e 74 20 73   value..*/.int s
0bd0: 71 6c 69 74 65 33 56 64 62 65 4f 70 33 28 56 64  qlite3VdbeOp3(Vd
0be0: 62 65 20 2a 70 2c 20 69 6e 74 20 6f 70 2c 20 69  be *p, int op, i
0bf0: 6e 74 20 70 31 2c 20 69 6e 74 20 70 32 2c 20 63  nt p1, int p2, c
0c00: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 33 2c 69  onst char *zP3,i
0c10: 6e 74 20 70 33 74 79 70 65 29 7b 0a 20 20 69 6e  nt p3type){.  in
0c20: 74 20 61 64 64 72 20 3d 20 73 71 6c 69 74 65 33  t addr = sqlite3
0c30: 56 64 62 65 41 64 64 4f 70 28 70 2c 20 6f 70 2c  VdbeAddOp(p, op,
0c40: 20 70 31 2c 20 70 32 29 3b 0a 20 20 73 71 6c 69   p1, p2);.  sqli
0c50: 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 33 28  te3VdbeChangeP3(
0c60: 70 2c 20 61 64 64 72 2c 20 7a 50 33 2c 20 70 33  p, addr, zP3, p3
0c70: 74 79 70 65 29 3b 0a 20 20 72 65 74 75 72 6e 20  type);.  return 
0c80: 61 64 64 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  addr;.}../*.** C
0c90: 72 65 61 74 65 20 61 20 6e 65 77 20 73 79 6d 62  reate a new symb
0ca0: 6f 6c 69 63 20 6c 61 62 65 6c 20 66 6f 72 20 61  olic label for a
0cb0: 6e 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 68  n instruction th
0cc0: 61 74 20 68 61 73 20 79 65 74 20 74 6f 20 62 65  at has yet to be
0cd0: 0a 2a 2a 20 63 6f 64 65 64 2e 20 20 54 68 65 20  .** coded.  The 
0ce0: 73 79 6d 62 6f 6c 69 63 20 6c 61 62 65 6c 20 69  symbolic label i
0cf0: 73 20 72 65 61 6c 6c 79 20 6a 75 73 74 20 61 20  s really just a 
0d00: 6e 65 67 61 74 69 76 65 20 6e 75 6d 62 65 72 2e  negative number.
0d10: 20 20 54 68 65 0a 2a 2a 20 6c 61 62 65 6c 20 63    The.** label c
0d20: 61 6e 20 62 65 20 75 73 65 64 20 61 73 20 74 68  an be used as th
0d30: 65 20 50 32 20 76 61 6c 75 65 20 6f 66 20 61 6e  e P2 value of an
0d40: 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 4c 61 74   operation.  Lat
0d50: 65 72 2c 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20  er, when.** the 
0d60: 6c 61 62 65 6c 20 69 73 20 72 65 73 6f 6c 76 65  label is resolve
0d70: 64 20 74 6f 20 61 20 73 70 65 63 69 66 69 63 20  d to a specific 
0d80: 61 64 64 72 65 73 73 2c 20 74 68 65 20 56 44 42  address, the VDB
0d90: 45 20 77 69 6c 6c 20 73 63 61 6e 0a 2a 2a 20 74  E will scan.** t
0da0: 68 72 6f 75 67 68 20 69 74 73 20 6f 70 65 72 61  hrough its opera
0db0: 74 69 6f 6e 20 6c 69 73 74 20 61 6e 64 20 63 68  tion list and ch
0dc0: 61 6e 67 65 20 61 6c 6c 20 76 61 6c 75 65 73 20  ange all values 
0dd0: 6f 66 20 50 32 20 77 68 69 63 68 20 6d 61 74 63  of P2 which matc
0de0: 68 0a 2a 2a 20 74 68 65 20 6c 61 62 65 6c 20 69  h.** the label i
0df0: 6e 74 6f 20 74 68 65 20 72 65 73 6f 6c 76 65 64  nto the resolved
0e00: 20 61 64 64 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20   address..**.** 
0e10: 54 68 65 20 56 44 42 45 20 6b 6e 6f 77 73 20 74  The VDBE knows t
0e20: 68 61 74 20 61 20 50 32 20 76 61 6c 75 65 20 69  hat a P2 value i
0e30: 73 20 61 20 6c 61 62 65 6c 20 62 65 63 61 75 73  s a label becaus
0e40: 65 20 6c 61 62 65 6c 73 20 61 72 65 0a 2a 2a 20  e labels are.** 
0e50: 61 6c 77 61 79 73 20 6e 65 67 61 74 69 76 65 20  always negative 
0e60: 61 6e 64 20 50 32 20 76 61 6c 75 65 73 20 61 72  and P2 values ar
0e70: 65 20 73 75 70 70 6f 73 65 20 74 6f 20 62 65 20  e suppose to be 
0e80: 6e 6f 6e 2d 6e 65 67 61 74 69 76 65 2e 0a 2a 2a  non-negative..**
0e90: 20 48 65 6e 63 65 2c 20 61 20 6e 65 67 61 74 69   Hence, a negati
0ea0: 76 65 20 50 32 20 76 61 6c 75 65 20 69 73 20 61  ve P2 value is a
0eb0: 20 6c 61 62 65 6c 20 74 68 61 74 20 68 61 73 20   label that has 
0ec0: 79 65 74 20 74 6f 20 62 65 20 72 65 73 6f 6c 76  yet to be resolv
0ed0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 5a 65 72 6f 20 69  ed..**.** Zero i
0ee0: 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 61 20  s returned if a 
0ef0: 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 73 2e 0a  malloc() fails..
0f00: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
0f10: 62 65 4d 61 6b 65 4c 61 62 65 6c 28 56 64 62 65  beMakeLabel(Vdbe
0f20: 20 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20   *p){.  int i;. 
0f30: 20 69 20 3d 20 70 2d 3e 6e 4c 61 62 65 6c 2b 2b   i = p->nLabel++
0f40: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d  ;.  assert( p->m
0f50: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
0f60: 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66 28 20 69  _INIT );.  if( i
0f70: 3e 3d 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63  >=p->nLabelAlloc
0f80: 20 29 7b 0a 20 20 20 20 70 2d 3e 6e 4c 61 62 65   ){.    p->nLabe
0f90: 6c 41 6c 6c 6f 63 20 3d 20 70 2d 3e 6e 4c 61 62  lAlloc = p->nLab
0fa0: 65 6c 41 6c 6c 6f 63 2a 32 20 2b 20 31 30 3b 0a  elAlloc*2 + 10;.
0fb0: 20 20 20 20 70 2d 3e 61 4c 61 62 65 6c 20 3d 20      p->aLabel = 
0fc0: 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63 28 20 70  sqliteRealloc( p
0fd0: 2d 3e 61 4c 61 62 65 6c 2c 20 70 2d 3e 6e 4c 61  ->aLabel, p->nLa
0fe0: 62 65 6c 41 6c 6c 6f 63 2a 73 69 7a 65 6f 66 28  belAlloc*sizeof(
0ff0: 70 2d 3e 61 4c 61 62 65 6c 5b 30 5d 29 29 3b 0a  p->aLabel[0]));.
1000: 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e 61 4c 61    }.  if( p->aLa
1010: 62 65 6c 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4c  bel ){.    p->aL
1020: 61 62 65 6c 5b 69 5d 20 3d 20 2d 31 3b 0a 20 20  abel[i] = -1;.  
1030: 7d 0a 20 20 72 65 74 75 72 6e 20 2d 31 2d 69 3b  }.  return -1-i;
1040: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 6f 6c 76  .}../*.** Resolv
1050: 65 20 6c 61 62 65 6c 20 22 78 22 20 74 6f 20 62  e label "x" to b
1060: 65 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66  e the address of
1070: 20 74 68 65 20 6e 65 78 74 20 69 6e 73 74 72 75   the next instru
1080: 63 74 69 6f 6e 20 74 6f 0a 2a 2a 20 62 65 20 69  ction to.** be i
1090: 6e 73 65 72 74 65 64 2e 20 20 54 68 65 20 70 61  nserted.  The pa
10a0: 72 61 6d 65 74 65 72 20 22 78 22 20 6d 75 73 74  rameter "x" must
10b0: 20 68 61 76 65 20 62 65 65 6e 20 6f 62 74 61 69   have been obtai
10c0: 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 61 20 70 72  ned from.** a pr
10d0: 69 6f 72 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69  ior call to sqli
10e0: 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c  te3VdbeMakeLabel
10f0: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ()..*/.void sqli
1100: 74 65 33 56 64 62 65 52 65 73 6f 6c 76 65 4c 61  te3VdbeResolveLa
1110: 62 65 6c 28 56 64 62 65 20 2a 70 2c 20 69 6e 74  bel(Vdbe *p, int
1120: 20 78 29 7b 0a 20 20 69 6e 74 20 6a 20 3d 20 2d   x){.  int j = -
1130: 31 2d 78 3b 0a 20 20 61 73 73 65 72 74 28 20 70  1-x;.  assert( p
1140: 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41  ->magic==VDBE_MA
1150: 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 61 73  GIC_INIT );.  as
1160: 73 65 72 74 28 20 6a 3e 3d 30 20 26 26 20 6a 3c  sert( j>=0 && j<
1170: 70 2d 3e 6e 4c 61 62 65 6c 20 29 3b 0a 20 20 69  p->nLabel );.  i
1180: 66 28 20 70 2d 3e 61 4c 61 62 65 6c 20 29 7b 0a  f( p->aLabel ){.
1190: 20 20 20 20 70 2d 3e 61 4c 61 62 65 6c 5b 6a 5d      p->aLabel[j]
11a0: 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 7d 0a 7d   = p->nOp;.  }.}
11b0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 6e  ../*.** Return n
11c0: 6f 6e 2d 7a 65 72 6f 20 69 66 20 6f 70 63 6f 64  on-zero if opcod
11d0: 65 20 27 6f 70 27 20 69 73 20 67 75 61 72 65 6e  e 'op' is guaren
11e0: 74 65 65 64 20 6e 6f 74 20 74 6f 20 70 75 73 68  teed not to push
11f0: 20 6d 6f 72 65 20 76 61 6c 75 65 73 0a 2a 2a 20   more values.** 
1200: 6f 6e 74 6f 20 74 68 65 20 56 44 42 45 20 73 74  onto the VDBE st
1210: 61 63 6b 20 74 68 61 6e 20 69 74 20 70 6f 70 73  ack than it pops
1220: 20 6f 66 66 2e 0a 2a 2f 0a 73 74 61 74 69 63 20   off..*/.static 
1230: 69 6e 74 20 6f 70 63 6f 64 65 4e 6f 50 75 73 68  int opcodeNoPush
1240: 28 75 38 20 6f 70 29 7b 0a 20 20 2f 2a 20 54 68  (u8 op){.  /* Th
1250: 65 20 31 30 20 4e 4f 50 55 53 48 5f 4d 41 53 4b  e 10 NOPUSH_MASK
1260: 5f 6e 20 63 6f 6e 73 74 61 6e 74 73 20 61 72 65  _n constants are
1270: 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20   defined in the 
1280: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 20 20  automatically.  
1290: 2a 2a 20 67 65 6e 65 72 61 74 65 64 20 68 65 61  ** generated hea
12a0: 64 65 72 20 66 69 6c 65 20 6f 70 63 6f 64 65 73  der file opcodes
12b0: 2e 68 2e 20 45 61 63 68 20 69 73 20 61 20 31 36  .h. Each is a 16
12c0: 2d 62 69 74 20 62 69 74 6d 61 73 6b 2c 20 6f 6e  -bit bitmask, on
12d0: 65 0a 20 20 2a 2a 20 62 69 74 20 63 6f 72 72 65  e.  ** bit corre
12e0: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 65 61 63 68  sponding to each
12f0: 20 6f 70 63 6f 64 65 20 69 6d 70 6c 65 6d 65 6e   opcode implemen
1300: 74 65 64 20 62 79 20 74 68 65 20 76 69 72 74 75  ted by the virtu
1310: 61 6c 0a 20 20 2a 2a 20 6d 61 63 68 69 6e 65 20  al.  ** machine 
1320: 69 6e 20 76 64 62 65 2e 63 2e 20 54 68 65 20 62  in vdbe.c. The b
1330: 69 74 20 69 73 20 74 72 75 65 20 69 66 20 74 68  it is true if th
1340: 65 20 77 6f 72 64 20 22 6e 6f 2d 70 75 73 68 22  e word "no-push"
1350: 20 61 70 70 65 61 72 73 0a 20 20 2a 2a 20 69 6e   appears.  ** in
1360: 20 61 20 63 6f 6d 6d 65 6e 74 20 6f 6e 20 74 68   a comment on th
1370: 65 20 73 61 6d 65 20 6c 69 6e 65 20 61 73 20 74  e same line as t
1380: 68 65 20 22 63 61 73 65 20 4f 50 5f 58 58 58 3a  he "case OP_XXX:
1390: 22 20 69 6e 20 0a 20 20 2a 2a 20 73 71 6c 69 74  " in .  ** sqlit
13a0: 65 33 56 64 62 65 45 78 65 63 28 29 20 69 6e 20  e3VdbeExec() in 
13b0: 76 64 62 65 2e 63 2e 0a 20 20 2a 2a 0a 20 20 2a  vdbe.c..  **.  *
13c0: 2a 20 49 66 20 74 68 65 20 62 69 74 20 69 73 20  * If the bit is 
13d0: 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20 63  true, then the c
13e0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 6f 70 63  orresponding opc
13f0: 6f 64 65 20 69 73 20 67 75 61 72 65 6e 74 65 65  ode is guarentee
1400: 64 20 6e 6f 74 0a 20 20 2a 2a 20 74 6f 20 67 72  d not.  ** to gr
1410: 6f 77 20 74 68 65 20 73 74 61 63 6b 20 77 68 65  ow the stack whe
1420: 6e 20 69 74 20 69 73 20 65 78 65 63 75 74 65 64  n it is executed
1430: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20  . Otherwise, it 
1440: 6d 61 79 20 67 72 6f 77 20 74 68 65 0a 20 20 2a  may grow the.  *
1450: 2a 20 73 74 61 63 6b 20 62 79 20 61 74 20 6d 6f  * stack by at mo
1460: 73 74 20 6f 6e 65 20 65 6e 74 72 79 2e 0a 20 20  st one entry..  
1470: 2a 2a 0a 20 20 2a 2a 20 4e 4f 50 55 53 48 5f 4d  **.  ** NOPUSH_M
1480: 41 53 4b 5f 30 20 63 6f 72 72 65 73 70 6f 6e 64  ASK_0 correspond
1490: 73 20 74 6f 20 6f 70 63 6f 64 65 73 20 30 20 74  s to opcodes 0 t
14a0: 6f 20 31 35 2e 20 4e 4f 50 55 53 48 5f 4d 41 53  o 15. NOPUSH_MAS
14b0: 4b 5f 31 20 63 6f 6e 74 61 69 6e 73 0a 20 20 2a  K_1 contains.  *
14c0: 2a 20 6f 6e 65 20 62 69 74 20 66 6f 72 20 6f 70  * one bit for op
14d0: 63 6f 64 65 73 20 31 36 20 74 6f 20 33 31 2c 20  codes 16 to 31, 
14e0: 61 6e 64 20 73 6f 20 6f 6e 2e 0a 20 20 2a 2a 0a  and so on..  **.
14f0: 20 20 2a 2a 20 31 36 2d 62 69 74 20 62 69 74 6d    ** 16-bit bitm
1500: 61 73 6b 73 20 28 72 61 74 68 65 72 20 74 68 61  asks (rather tha
1510: 6e 20 33 32 2d 62 69 74 29 20 61 72 65 20 73 70  n 32-bit) are sp
1520: 65 63 69 66 69 65 64 20 69 6e 20 6f 70 63 6f 64  ecified in opcod
1530: 65 73 2e 68 20 0a 20 20 2a 2a 20 62 65 63 61 75  es.h .  ** becau
1540: 73 65 20 74 68 65 20 66 69 6c 65 20 69 73 20 67  se the file is g
1550: 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e 20 61  enerated by an a
1560: 77 6b 20 70 72 6f 67 72 61 6d 2e 20 41 77 6b 20  wk program. Awk 
1570: 6d 61 6e 69 70 75 6c 61 74 65 73 0a 20 20 2a 2a  manipulates.  **
1580: 20 61 6c 6c 20 6e 75 6d 62 65 72 73 20 61 73 20   all numbers as 
1590: 66 6c 6f 61 74 69 6e 67 2d 70 6f 69 6e 74 20 61  floating-point a
15a0: 6e 64 20 77 65 20 64 6f 6e 27 74 20 77 61 6e 74  nd we don't want
15b0: 20 74 6f 20 72 69 73 6b 20 61 20 72 6f 75 6e 64   to risk a round
15c0: 69 6e 67 0a 20 20 2a 2a 20 65 72 72 6f 72 20 69  ing.  ** error i
15d0: 66 20 73 6f 6d 65 6f 6e 65 20 62 75 69 6c 64 73  f someone builds
15e0: 20 77 69 74 68 20 61 6e 20 61 77 6b 20 74 68 61   with an awk tha
15f0: 74 20 75 73 65 73 20 28 66 6f 72 20 65 78 61 6d  t uses (for exam
1600: 70 6c 65 29 20 33 32 2d 62 69 74 20 0a 20 20 2a  ple) 32-bit .  *
1610: 2a 20 49 45 45 45 20 66 6c 6f 61 74 73 2e 0a 20  * IEEE floats.. 
1620: 20 2a 2f 20 0a 20 20 73 74 61 74 69 63 20 63 6f   */ .  static co
1630: 6e 73 74 20 75 33 32 20 6d 61 73 6b 73 5b 35 5d  nst u32 masks[5]
1640: 20 3d 20 7b 0a 20 20 20 20 4e 4f 50 55 53 48 5f   = {.    NOPUSH_
1650: 4d 41 53 4b 5f 30 20 2b 20 28 4e 4f 50 55 53 48  MASK_0 + (NOPUSH
1660: 5f 4d 41 53 4b 5f 31 3c 3c 31 36 29 2c 0a 20 20  _MASK_1<<16),.  
1670: 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 32 20    NOPUSH_MASK_2 
1680: 2b 20 28 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 33  + (NOPUSH_MASK_3
1690: 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f 50 55 53  <<16),.    NOPUS
16a0: 48 5f 4d 41 53 4b 5f 34 20 2b 20 28 4e 4f 50 55  H_MASK_4 + (NOPU
16b0: 53 48 5f 4d 41 53 4b 5f 35 3c 3c 31 36 29 2c 0a  SH_MASK_5<<16),.
16c0: 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f      NOPUSH_MASK_
16d0: 36 20 2b 20 28 4e 4f 50 55 53 48 5f 4d 41 53 4b  6 + (NOPUSH_MASK
16e0: 5f 37 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f 50  _7<<16),.    NOP
16f0: 55 53 48 5f 4d 41 53 4b 5f 38 20 2b 20 28 4e 4f  USH_MASK_8 + (NO
1700: 50 55 53 48 5f 4d 41 53 4b 5f 39 3c 3c 31 36 29  PUSH_MASK_9<<16)
1710: 0a 20 20 7d 3b 0a 20 20 72 65 74 75 72 6e 20 28  .  };.  return (
1720: 6d 61 73 6b 73 5b 6f 70 3e 3e 35 5d 20 26 20 28  masks[op>>5] & (
1730: 31 3c 3c 28 6f 70 26 30 78 31 46 29 29 29 3b 0a  1<<(op&0x1F)));.
1740: 7d 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55  }..#ifndef NDEBU
1750: 47 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  G.int sqlite3Vdb
1760: 65 4f 70 63 6f 64 65 4e 6f 50 75 73 68 28 75 38  eOpcodeNoPush(u8
1770: 20 6f 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f   op){.  return o
1780: 70 63 6f 64 65 4e 6f 50 75 73 68 28 6f 70 29 3b  pcodeNoPush(op);
1790: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  .}.#endif../*.**
17a0: 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 74 68   Loop through th
17b0: 65 20 70 72 6f 67 72 61 6d 20 6c 6f 6f 6b 69 6e  e program lookin
17c0: 67 20 66 6f 72 20 50 32 20 76 61 6c 75 65 73 20  g for P2 values 
17d0: 74 68 61 74 20 61 72 65 20 6e 65 67 61 74 69 76  that are negativ
17e0: 65 2e 0a 2a 2a 20 45 61 63 68 20 73 75 63 68 20  e..** Each such 
17f0: 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62 65 6c  value is a label
1800: 2e 20 20 52 65 73 6f 6c 76 65 20 74 68 65 20 6c  .  Resolve the l
1810: 61 62 65 6c 20 62 79 20 73 65 74 74 69 6e 67 20  abel by setting 
1820: 74 68 65 20 50 32 0a 2a 2a 20 76 61 6c 75 65 20  the P2.** value 
1830: 74 6f 20 69 74 73 20 63 6f 72 72 65 63 74 20 6e  to its correct n
1840: 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 2e 0a 2a  on-zero value..*
1850: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
1860: 65 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 63 65  e is called once
1870: 20 61 66 74 65 72 20 61 6c 6c 20 6f 70 63 6f 64   after all opcod
1880: 65 73 20 68 61 76 65 20 62 65 65 6e 20 69 6e 73  es have been ins
1890: 65 72 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 56 61 72  erted..**.** Var
18a0: 69 61 62 6c 65 20 2a 70 4d 61 78 46 75 6e 63 41  iable *pMaxFuncA
18b0: 72 67 73 20 69 73 20 73 65 74 20 74 6f 20 74 68  rgs is set to th
18c0: 65 20 6d 61 78 69 6d 75 6d 20 76 61 6c 75 65 20  e maximum value 
18d0: 6f 66 20 61 6e 79 20 50 31 20 61 72 67 75 6d 65  of any P1 argume
18e0: 6e 74 20 0a 2a 2a 20 74 6f 20 61 6e 20 4f 50 5f  nt .** to an OP_
18f0: 46 75 6e 63 74 69 6f 6e 20 6f 72 20 50 32 20 74  Function or P2 t
1900: 6f 20 61 6e 20 4f 50 5f 41 67 67 46 75 6e 63 20  o an OP_AggFunc 
1910: 6f 70 63 6f 64 65 2e 20 54 68 69 73 20 69 73 20  opcode. This is 
1920: 75 73 65 64 20 62 79 20 0a 2a 2a 20 73 71 6c 69  used by .** sqli
1930: 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61 64 79  te3VdbeMakeReady
1940: 28 29 20 74 6f 20 73 69 7a 65 20 74 68 65 20 56  () to size the V
1950: 64 62 65 2e 61 70 41 72 67 5b 5d 20 61 72 72 61  dbe.apArg[] arra
1960: 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 6e 74  y..**.** The int
1970: 65 67 65 72 20 2a 70 4d 61 78 53 74 61 63 6b 20  eger *pMaxStack 
1980: 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6d 61  is set to the ma
1990: 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20  ximum number of 
19a0: 76 64 62 65 20 73 74 61 63 6b 0a 2a 2a 20 65 6e  vdbe stack.** en
19b0: 74 72 69 65 73 20 74 68 61 74 20 73 74 61 74 69  tries that stati
19c0: 63 20 61 6e 61 6c 79 73 69 73 20 72 65 76 65 61  c analysis revea
19d0: 6c 73 20 74 68 69 73 20 70 72 6f 67 72 61 6d 20  ls this program 
19e0: 6d 69 67 68 74 20 6e 65 65 64 2e 0a 2a 2a 0a 2a  might need..**.*
19f0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 61  * This routine a
1a00: 6c 73 6f 20 64 6f 65 73 20 74 68 65 20 66 6f 6c  lso does the fol
1a10: 6c 6f 77 69 6e 67 20 6f 70 74 69 6d 69 7a 61 74  lowing optimizat
1a20: 69 6f 6e 3a 20 20 49 74 20 73 63 61 6e 73 20 66  ion:  It scans f
1a30: 6f 72 0a 2a 2a 20 48 61 6c 74 20 69 6e 73 74 72  or.** Halt instr
1a40: 75 63 74 69 6f 6e 73 20 77 68 65 72 65 20 50 31  uctions where P1
1a50: 3d 3d 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41  ==SQLITE_CONSTRA
1a60: 49 4e 54 20 6f 72 20 50 32 3d 3d 4f 45 5f 41 62  INT or P2==OE_Ab
1a70: 6f 72 74 20 6f 72 20 66 6f 72 0a 2a 2a 20 49 64  ort or for.** Id
1a80: 78 49 6e 73 65 72 74 20 69 6e 73 74 72 75 63 74  xInsert instruct
1a90: 69 6f 6e 73 20 77 68 65 72 65 20 50 32 21 3d 30  ions where P2!=0
1aa0: 2e 20 20 49 66 20 6e 6f 20 73 75 63 68 20 69 6e  .  If no such in
1ab0: 73 74 72 75 63 74 69 6f 6e 20 69 73 0a 2a 2a 20  struction is.** 
1ac0: 66 6f 75 6e 64 2c 20 74 68 65 6e 20 65 76 65 72  found, then ever
1ad0: 79 20 53 74 61 74 65 6d 65 6e 74 20 69 6e 73 74  y Statement inst
1ae0: 72 75 63 74 69 6f 6e 20 69 73 20 63 68 61 6e 67  ruction is chang
1af0: 65 64 20 74 6f 20 61 20 4e 6f 6f 70 2e 20 20 49  ed to a Noop.  I
1b00: 6e 0a 2a 2a 20 74 68 69 73 20 77 61 79 2c 20 77  n.** this way, w
1b10: 65 20 61 76 6f 69 64 20 63 72 65 61 74 69 6e 67  e avoid creating
1b20: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a   the statement j
1b30: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 75 6e 6e 65  ournal file unne
1b40: 63 65 73 73 61 72 69 6c 79 2e 0a 2a 2f 0a 73 74  cessarily..*/.st
1b50: 61 74 69 63 20 76 6f 69 64 20 72 65 73 6f 6c 76  atic void resolv
1b60: 65 50 32 56 61 6c 75 65 73 28 56 64 62 65 20 2a  eP2Values(Vdbe *
1b70: 70 2c 20 69 6e 74 20 2a 70 4d 61 78 46 75 6e 63  p, int *pMaxFunc
1b80: 41 72 67 73 2c 20 69 6e 74 20 2a 70 4d 61 78 53  Args, int *pMaxS
1b90: 74 61 63 6b 29 7b 0a 20 20 69 6e 74 20 69 3b 0a  tack){.  int i;.
1ba0: 20 20 69 6e 74 20 6e 4d 61 78 41 72 67 73 20 3d    int nMaxArgs =
1bb0: 20 30 3b 0a 20 20 69 6e 74 20 6e 4d 61 78 53 74   0;.  int nMaxSt
1bc0: 61 63 6b 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20  ack = p->nOp;.  
1bd0: 4f 70 20 2a 70 4f 70 3b 0a 20 20 69 6e 74 20 2a  Op *pOp;.  int *
1be0: 61 4c 61 62 65 6c 20 3d 20 70 2d 3e 61 4c 61 62  aLabel = p->aLab
1bf0: 65 6c 3b 0a 20 20 69 6e 74 20 64 6f 65 73 53 74  el;.  int doesSt
1c00: 61 74 65 6d 65 6e 74 52 6f 6c 6c 62 61 63 6b 20  atementRollback 
1c10: 3d 20 30 3b 0a 20 20 69 6e 74 20 68 61 73 53 74  = 0;.  int hasSt
1c20: 61 74 65 6d 65 6e 74 42 65 67 69 6e 20 3d 20 30  atementBegin = 0
1c30: 3b 0a 20 20 66 6f 72 28 70 4f 70 3d 70 2d 3e 61  ;.  for(pOp=p->a
1c40: 4f 70 2c 20 69 3d 70 2d 3e 6e 4f 70 2d 31 3b 20  Op, i=p->nOp-1; 
1c50: 69 3e 3d 30 3b 20 69 2d 2d 2c 20 70 4f 70 2b 2b  i>=0; i--, pOp++
1c60: 29 7b 0a 20 20 20 20 75 38 20 6f 70 63 6f 64 65  ){.    u8 opcode
1c70: 20 3d 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3b 0a   = pOp->opcode;.
1c80: 0a 20 20 20 20 2f 2a 20 54 6f 64 6f 3a 20 4d 61  .    /* Todo: Ma
1c90: 79 62 65 20 4f 50 5f 41 67 67 46 75 6e 63 20 73  ybe OP_AggFunc s
1ca0: 68 6f 75 6c 64 20 63 68 61 6e 67 65 20 74 6f 20  hould change to 
1cb0: 75 73 65 20 50 31 20 69 6e 20 74 68 65 20 73 61  use P1 in the sa
1cc0: 6d 65 0a 20 20 20 20 20 2a 20 77 61 79 20 61 73  me.     * way as
1cd0: 20 4f 50 5f 46 75 6e 63 74 69 6f 6e 2e 20 0a 20   OP_Function. . 
1ce0: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6f      */.    if( o
1cf0: 70 63 6f 64 65 3d 3d 4f 50 5f 46 75 6e 63 74 69  pcode==OP_Functi
1d00: 6f 6e 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20  on ){.      if( 
1d10: 70 4f 70 2d 3e 70 31 3e 6e 4d 61 78 41 72 67 73  pOp->p1>nMaxArgs
1d20: 20 29 20 6e 4d 61 78 41 72 67 73 20 3d 20 70 4f   ) nMaxArgs = pO
1d30: 70 2d 3e 70 31 3b 0a 20 20 20 20 7d 65 6c 73 65  p->p1;.    }else
1d40: 20 69 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f   if( opcode==OP_
1d50: 41 67 67 46 75 6e 63 20 29 7b 0a 20 20 20 20 20  AggFunc ){.     
1d60: 20 69 66 28 20 70 4f 70 2d 3e 70 32 3e 6e 4d 61   if( pOp->p2>nMa
1d70: 78 41 72 67 73 20 29 20 6e 4d 61 78 41 72 67 73  xArgs ) nMaxArgs
1d80: 20 3d 20 70 4f 70 2d 3e 70 32 3b 0a 20 20 20 20   = pOp->p2;.    
1d90: 7d 65 6c 73 65 20 69 66 28 20 6f 70 63 6f 64 65  }else if( opcode
1da0: 3d 3d 4f 50 5f 48 61 6c 74 20 29 7b 0a 20 20 20  ==OP_Halt ){.   
1db0: 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 31 3d 3d     if( pOp->p1==
1dc0: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e  SQLITE_CONSTRAIN
1dd0: 54 20 26 26 20 70 4f 70 2d 3e 70 32 3d 3d 4f 45  T && pOp->p2==OE
1de0: 5f 41 62 6f 72 74 20 29 7b 0a 20 20 20 20 20 20  _Abort ){.      
1df0: 20 20 64 6f 65 73 53 74 61 74 65 6d 65 6e 74 52    doesStatementR
1e00: 6f 6c 6c 62 61 63 6b 20 3d 20 31 3b 0a 20 20 20  ollback = 1;.   
1e10: 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69     }.    }else i
1e20: 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 49 64  f( opcode==OP_Id
1e30: 78 49 6e 73 65 72 74 20 29 7b 0a 20 20 20 20 20  xInsert ){.     
1e40: 20 69 66 28 20 70 4f 70 2d 3e 70 32 20 29 7b 0a   if( pOp->p2 ){.
1e50: 20 20 20 20 20 20 20 20 64 6f 65 73 53 74 61 74          doesStat
1e60: 65 6d 65 6e 74 52 6f 6c 6c 62 61 63 6b 20 3d 20  ementRollback = 
1e70: 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  1;.      }.    }
1e80: 65 6c 73 65 20 69 66 28 20 6f 70 63 6f 64 65 3d  else if( opcode=
1e90: 3d 4f 50 5f 53 74 61 74 65 6d 65 6e 74 20 29 7b  =OP_Statement ){
1ea0: 0a 20 20 20 20 20 20 68 61 73 53 74 61 74 65 6d  .      hasStatem
1eb0: 65 6e 74 42 65 67 69 6e 20 3d 20 31 3b 0a 20 20  entBegin = 1;.  
1ec0: 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 6f 70 63    }..    if( opc
1ed0: 6f 64 65 4e 6f 50 75 73 68 28 6f 70 63 6f 64 65  odeNoPush(opcode
1ee0: 29 20 29 7b 0a 20 20 20 20 20 20 6e 4d 61 78 53  ) ){.      nMaxS
1ef0: 74 61 63 6b 2d 2d 3b 0a 20 20 20 20 7d 0a 0a 20  tack--;.    }.. 
1f00: 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 32 3e 3d     if( pOp->p2>=
1f10: 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20  0 ) continue;.  
1f20: 20 20 61 73 73 65 72 74 28 20 2d 31 2d 70 4f 70    assert( -1-pOp
1f30: 2d 3e 70 32 3c 70 2d 3e 6e 4c 61 62 65 6c 20 29  ->p2<p->nLabel )
1f40: 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 32 20 3d 20  ;.    pOp->p2 = 
1f50: 61 4c 61 62 65 6c 5b 2d 31 2d 70 4f 70 2d 3e 70  aLabel[-1-pOp->p
1f60: 32 5d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  2];.  }.  sqlite
1f70: 46 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c 29 3b  Free(p->aLabel);
1f80: 0a 20 20 70 2d 3e 61 4c 61 62 65 6c 20 3d 20 30  .  p->aLabel = 0
1f90: 3b 0a 0a 20 20 2a 70 4d 61 78 46 75 6e 63 41 72  ;..  *pMaxFuncAr
1fa0: 67 73 20 3d 20 6e 4d 61 78 41 72 67 73 3b 0a 20  gs = nMaxArgs;. 
1fb0: 20 2a 70 4d 61 78 53 74 61 63 6b 20 3d 20 6e 4d   *pMaxStack = nM
1fc0: 61 78 53 74 61 63 6b 3b 0a 0a 20 20 2f 2a 20 49  axStack;..  /* I
1fd0: 66 20 77 65 20 6e 65 76 65 72 20 72 6f 6c 6c 62  f we never rollb
1fe0: 61 63 6b 20 61 20 73 74 61 74 65 6d 65 6e 74 20  ack a statement 
1ff0: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65  transaction, the
2000: 6e 20 73 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a  n statement.  **
2010: 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 72   transactions ar
2020: 65 20 6e 6f 74 20 6e 65 65 64 65 64 2e 20 20 53  e not needed.  S
2030: 6f 20 63 68 61 6e 67 65 20 65 76 65 72 79 20 4f  o change every O
2040: 50 5f 53 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a  P_Statement.  **
2050: 20 6f 70 63 6f 64 65 20 69 6e 74 6f 20 61 6e 20   opcode into an 
2060: 4f 50 5f 4e 6f 6f 70 2e 20 20 54 68 69 73 20 61  OP_Noop.  This a
2070: 76 6f 69 64 20 61 20 63 61 6c 6c 20 74 6f 20 73  void a call to s
2080: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c  qlite3OsOpenExcl
2090: 75 73 69 76 65 28 29 0a 20 20 2a 2a 20 77 68 69  usive().  ** whi
20a0: 63 68 20 63 61 6e 20 62 65 20 65 78 70 65 6e 73  ch can be expens
20b0: 69 76 65 20 6f 6e 20 73 6f 6d 65 20 70 6c 61 74  ive on some plat
20c0: 66 6f 72 6d 73 2e 0a 20 20 2a 2f 0a 20 20 69 66  forms..  */.  if
20d0: 28 20 68 61 73 53 74 61 74 65 6d 65 6e 74 42 65  ( hasStatementBe
20e0: 67 69 6e 20 26 26 20 21 64 6f 65 73 53 74 61 74  gin && !doesStat
20f0: 65 6d 65 6e 74 52 6f 6c 6c 62 61 63 6b 20 29 7b  ementRollback ){
2100: 0a 20 20 20 20 66 6f 72 28 70 4f 70 3d 70 2d 3e  .    for(pOp=p->
2110: 61 4f 70 2c 20 69 3d 70 2d 3e 6e 4f 70 2d 31 3b  aOp, i=p->nOp-1;
2120: 20 69 3e 3d 30 3b 20 69 2d 2d 2c 20 70 4f 70 2b   i>=0; i--, pOp+
2130: 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 4f  +){.      if( pO
2140: 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 53 74  p->opcode==OP_St
2150: 61 74 65 6d 65 6e 74 20 29 7b 0a 20 20 20 20 20  atement ){.     
2160: 20 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d     pOp->opcode =
2170: 20 4f 50 5f 4e 6f 6f 70 3b 0a 20 20 20 20 20 20   OP_Noop;.      
2180: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f  }.    }.  }.}../
2190: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
21a0: 61 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e  address of the n
21b0: 65 78 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20  ext instruction 
21c0: 74 6f 20 62 65 20 69 6e 73 65 72 74 65 64 2e 0a  to be inserted..
21d0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
21e0: 62 65 43 75 72 72 65 6e 74 41 64 64 72 28 56 64  beCurrentAddr(Vd
21f0: 62 65 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74  be *p){.  assert
2200: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
2210: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
2220: 20 72 65 74 75 72 6e 20 70 2d 3e 6e 4f 70 3b 0a   return p->nOp;.
2230: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 77  }../*.** Add a w
2240: 68 6f 6c 65 20 6c 69 73 74 20 6f 66 20 6f 70 65  hole list of ope
2250: 72 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 6f  rations to the o
2260: 70 65 72 61 74 69 6f 6e 20 73 74 61 63 6b 2e 20  peration stack. 
2270: 20 52 65 74 75 72 6e 20 74 68 65 0a 2a 2a 20 61   Return the.** a
2280: 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 66 69  ddress of the fi
2290: 72 73 74 20 6f 70 65 72 61 74 69 6f 6e 20 61 64  rst operation ad
22a0: 64 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ded..*/.int sqli
22b0: 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74  te3VdbeAddOpList
22c0: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 6e 4f  (Vdbe *p, int nO
22d0: 70 2c 20 56 64 62 65 4f 70 4c 69 73 74 20 63 6f  p, VdbeOpList co
22e0: 6e 73 74 20 2a 61 4f 70 29 7b 0a 20 20 69 6e 74  nst *aOp){.  int
22f0: 20 61 64 64 72 3b 0a 20 20 61 73 73 65 72 74 28   addr;.  assert(
2300: 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f   p->magic==VDBE_
2310: 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20  MAGIC_INIT );.  
2320: 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70 2c  resizeOpArray(p,
2330: 20 70 2d 3e 6e 4f 70 20 2b 20 6e 4f 70 29 3b 0a   p->nOp + nOp);.
2340: 20 20 69 66 28 20 70 2d 3e 61 4f 70 3d 3d 30 20    if( p->aOp==0 
2350: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
2360: 0a 20 20 7d 0a 20 20 61 64 64 72 20 3d 20 70 2d  .  }.  addr = p-
2370: 3e 6e 4f 70 3b 0a 20 20 69 66 28 20 6e 4f 70 3e  >nOp;.  if( nOp>
2380: 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a  0 ){.    int i;.
2390: 20 20 20 20 56 64 62 65 4f 70 4c 69 73 74 20 63      VdbeOpList c
23a0: 6f 6e 73 74 20 2a 70 49 6e 20 3d 20 61 4f 70 3b  onst *pIn = aOp;
23b0: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
23c0: 6e 4f 70 3b 20 69 2b 2b 2c 20 70 49 6e 2b 2b 29  nOp; i++, pIn++)
23d0: 7b 0a 20 20 20 20 20 20 69 6e 74 20 70 32 20 3d  {.      int p2 =
23e0: 20 70 49 6e 2d 3e 70 32 3b 0a 20 20 20 20 20 20   pIn->p2;.      
23f0: 56 64 62 65 4f 70 20 2a 70 4f 75 74 20 3d 20 26  VdbeOp *pOut = &
2400: 70 2d 3e 61 4f 70 5b 69 2b 61 64 64 72 5d 3b 0a  p->aOp[i+addr];.
2410: 20 20 20 20 20 20 70 4f 75 74 2d 3e 6f 70 63 6f        pOut->opco
2420: 64 65 20 3d 20 70 49 6e 2d 3e 6f 70 63 6f 64 65  de = pIn->opcode
2430: 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 31  ;.      pOut->p1
2440: 20 3d 20 70 49 6e 2d 3e 70 31 3b 0a 20 20 20 20   = pIn->p1;.    
2450: 20 20 70 4f 75 74 2d 3e 70 32 20 3d 20 70 32 3c    pOut->p2 = p2<
2460: 30 20 3f 20 61 64 64 72 20 2b 20 41 44 44 52 28  0 ? addr + ADDR(
2470: 70 32 29 20 3a 20 70 32 3b 0a 20 20 20 20 20 20  p2) : p2;.      
2480: 70 4f 75 74 2d 3e 70 33 20 3d 20 70 49 6e 2d 3e  pOut->p3 = pIn->
2490: 70 33 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e  p3;.      pOut->
24a0: 70 33 74 79 70 65 20 3d 20 70 49 6e 2d 3e 70 33  p3type = pIn->p3
24b0: 20 3f 20 50 33 5f 53 54 41 54 49 43 20 3a 20 50   ? P3_STATIC : P
24c0: 33 5f 4e 4f 54 55 53 45 44 3b 0a 23 69 66 64 65  3_NOTUSED;.#ifde
24d0: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20  f SQLITE_DEBUG. 
24e0: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33       if( sqlite3
24f0: 5f 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63  _vdbe_addop_trac
2500: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  e ){.        sql
2510: 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28  ite3VdbePrintOp(
2520: 30 2c 20 69 2b 61 64 64 72 2c 20 26 70 2d 3e 61  0, i+addr, &p->a
2530: 4f 70 5b 69 2b 61 64 64 72 5d 29 3b 0a 20 20 20  Op[i+addr]);.   
2540: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20     }.#endif.    
2550: 7d 0a 20 20 20 20 70 2d 3e 6e 4f 70 20 2b 3d 20  }.    p->nOp += 
2560: 6e 4f 70 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  nOp;.  }.  retur
2570: 6e 20 61 64 64 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  n addr;.}../*.**
2580: 20 43 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75   Change the valu
2590: 65 20 6f 66 20 74 68 65 20 50 31 20 6f 70 65 72  e of the P1 oper
25a0: 61 6e 64 20 66 6f 72 20 61 20 73 70 65 63 69 66  and for a specif
25b0: 69 63 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a  ic instruction..
25c0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
25d0: 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 61  is useful when a
25e0: 20 6c 61 72 67 65 20 70 72 6f 67 72 61 6d 20 69   large program i
25f0: 73 20 6c 6f 61 64 65 64 20 66 72 6f 6d 20 61 0a  s loaded from a.
2600: 2a 2a 20 73 74 61 74 69 63 20 61 72 72 61 79 20  ** static array 
2610: 75 73 69 6e 67 20 73 71 6c 69 74 65 33 56 64 62  using sqlite3Vdb
2620: 65 41 64 64 4f 70 4c 69 73 74 20 62 75 74 20 77  eAddOpList but w
2630: 65 20 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 61  e want to make a
2640: 0a 2a 2a 20 66 65 77 20 6d 69 6e 6f 72 20 63 68  .** few minor ch
2650: 61 6e 67 65 73 20 74 6f 20 74 68 65 20 70 72 6f  anges to the pro
2660: 67 72 61 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  gram..*/.void sq
2670: 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 50  lite3VdbeChangeP
2680: 31 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61  1(Vdbe *p, int a
2690: 64 64 72 2c 20 69 6e 74 20 76 61 6c 29 7b 0a 20  ddr, int val){. 
26a0: 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69   assert( p->magi
26b0: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  c==VDBE_MAGIC_IN
26c0: 49 54 20 29 3b 0a 20 20 69 66 28 20 70 20 26 26  IT );.  if( p &&
26d0: 20 61 64 64 72 3e 3d 30 20 26 26 20 70 2d 3e 6e   addr>=0 && p->n
26e0: 4f 70 3e 61 64 64 72 20 26 26 20 70 2d 3e 61 4f  Op>addr && p->aO
26f0: 70 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4f 70 5b  p ){.    p->aOp[
2700: 61 64 64 72 5d 2e 70 31 20 3d 20 76 61 6c 3b 0a  addr].p1 = val;.
2710: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61    }.}../*.** Cha
2720: 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66  nge the value of
2730: 20 74 68 65 20 50 32 20 6f 70 65 72 61 6e 64 20   the P2 operand 
2740: 66 6f 72 20 61 20 73 70 65 63 69 66 69 63 20 69  for a specific i
2750: 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54  nstruction..** T
2760: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75  his routine is u
2770: 73 65 66 75 6c 20 66 6f 72 20 73 65 74 74 69 6e  seful for settin
2780: 67 20 61 20 6a 75 6d 70 20 64 65 73 74 69 6e 61  g a jump destina
2790: 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  tion..*/.void sq
27a0: 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 50  lite3VdbeChangeP
27b0: 32 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61  2(Vdbe *p, int a
27c0: 64 64 72 2c 20 69 6e 74 20 76 61 6c 29 7b 0a 20  ddr, int val){. 
27d0: 20 61 73 73 65 72 74 28 20 76 61 6c 3e 3d 30 20   assert( val>=0 
27e0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  );.  assert( p->
27f0: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
2800: 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66 28 20  C_INIT );.  if( 
2810: 70 20 26 26 20 61 64 64 72 3e 3d 30 20 26 26 20  p && addr>=0 && 
2820: 70 2d 3e 6e 4f 70 3e 61 64 64 72 20 26 26 20 70  p->nOp>addr && p
2830: 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 70 2d 3e  ->aOp ){.    p->
2840: 61 4f 70 5b 61 64 64 72 5d 2e 70 32 20 3d 20 76  aOp[addr].p2 = v
2850: 61 6c 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  al;.  }.}../*.**
2860: 20 43 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75   Change the valu
2870: 65 20 6f 66 20 74 68 65 20 50 33 20 6f 70 65 72  e of the P3 oper
2880: 61 6e 64 20 66 6f 72 20 61 20 73 70 65 63 69 66  and for a specif
2890: 69 63 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a  ic instruction..
28a0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
28b0: 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 61  is useful when a
28c0: 20 6c 61 72 67 65 20 70 72 6f 67 72 61 6d 20 69   large program i
28d0: 73 20 6c 6f 61 64 65 64 20 66 72 6f 6d 20 61 0a  s loaded from a.
28e0: 2a 2a 20 73 74 61 74 69 63 20 61 72 72 61 79 20  ** static array 
28f0: 75 73 69 6e 67 20 73 71 6c 69 74 65 33 56 64 62  using sqlite3Vdb
2900: 65 41 64 64 4f 70 4c 69 73 74 20 62 75 74 20 77  eAddOpList but w
2910: 65 20 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 61  e want to make a
2920: 0a 2a 2a 20 66 65 77 20 6d 69 6e 6f 72 20 63 68  .** few minor ch
2930: 61 6e 67 65 73 20 74 6f 20 74 68 65 20 70 72 6f  anges to the pro
2940: 67 72 61 6d 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e  gram..**.** If n
2950: 3e 3d 30 20 74 68 65 6e 20 74 68 65 20 50 33 20  >=0 then the P3 
2960: 6f 70 65 72 61 6e 64 20 69 73 20 64 79 6e 61 6d  operand is dynam
2970: 69 63 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 74  ic, meaning that
2980: 20 61 20 63 6f 70 79 20 6f 66 0a 2a 2a 20 74 68   a copy of.** th
2990: 65 20 73 74 72 69 6e 67 20 69 73 20 6d 61 64 65  e string is made
29a0: 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74   into memory obt
29b0: 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74  ained from sqlit
29c0: 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20 41 20  eMalloc()..** A 
29d0: 76 61 6c 75 65 20 6f 66 20 6e 3d 3d 30 20 6d 65  value of n==0 me
29e0: 61 6e 73 20 63 6f 70 79 20 62 79 74 65 73 20 6f  ans copy bytes o
29f0: 66 20 7a 50 33 20 75 70 20 74 6f 20 61 6e 64 20  f zP3 up to and 
2a00: 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 0a 2a 2a  including the.**
2a10: 20 66 69 72 73 74 20 6e 75 6c 6c 20 62 79 74 65   first null byte
2a20: 2e 20 20 49 66 20 6e 3e 30 20 74 68 65 6e 20 63  .  If n>0 then c
2a30: 6f 70 79 20 6e 2b 31 20 62 79 74 65 73 20 6f 66  opy n+1 bytes of
2a40: 20 7a 50 33 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e   zP3..**.** If n
2a50: 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 69 74 20  ==P3_KEYINFO it 
2a60: 6d 65 61 6e 73 20 74 68 61 74 20 7a 50 33 20 69  means that zP3 i
2a70: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61  s a pointer to a
2a80: 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75   KeyInfo structu
2a90: 72 65 2e 0a 2a 2a 20 41 20 63 6f 70 79 20 69 73  re..** A copy is
2aa0: 20 6d 61 64 65 20 6f 66 20 74 68 65 20 4b 65 79   made of the Key
2ab0: 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 20 69  Info structure i
2ac0: 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69  nto memory obtai
2ad0: 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 73 71 6c 69  ned from.** sqli
2ae0: 74 65 4d 61 6c 6c 6f 63 2c 20 74 6f 20 62 65 20  teMalloc, to be 
2af0: 66 72 65 65 64 20 77 68 65 6e 20 74 68 65 20 56  freed when the V
2b00: 64 62 65 20 69 73 20 66 69 6e 61 6c 69 7a 65 64  dbe is finalized
2b10: 2e 0a 2a 2a 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e  ..** n==P3_KEYIN
2b20: 46 4f 5f 48 41 4e 44 4f 46 46 20 69 6e 64 69 63  FO_HANDOFF indic
2b30: 61 74 65 73 20 74 68 61 74 20 7a 50 33 20 70 6f  ates that zP3 po
2b40: 69 6e 74 73 20 74 6f 20 61 20 4b 65 79 49 6e 66  ints to a KeyInf
2b50: 6f 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 73  o structure.** s
2b60: 74 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20  tored in memory 
2b70: 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20  that the caller 
2b80: 68 61 73 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  has obtained fro
2b90: 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 2e 20  m sqliteMalloc. 
2ba0: 54 68 65 20 0a 2a 2a 20 63 61 6c 6c 65 72 20 73  The .** caller s
2bb0: 68 6f 75 6c 64 20 6e 6f 74 20 66 72 65 65 20 74  hould not free t
2bc0: 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 20 69  he allocation, i
2bd0: 74 20 77 69 6c 6c 20 62 65 20 66 72 65 65 64 20  t will be freed 
2be0: 77 68 65 6e 20 74 68 65 20 56 64 62 65 20 69 73  when the Vdbe is
2bf0: 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 64 2e 0a 2a  .** finalized..*
2c00: 2a 20 0a 2a 2a 20 4f 74 68 65 72 20 76 61 6c 75  * .** Other valu
2c10: 65 73 20 6f 66 20 6e 20 28 50 33 5f 53 54 41 54  es of n (P3_STAT
2c20: 49 43 2c 20 50 33 5f 43 4f 4c 4c 53 45 51 20 65  IC, P3_COLLSEQ e
2c30: 74 63 2e 29 20 69 6e 64 69 63 61 74 65 20 74 68  tc.) indicate th
2c40: 61 74 20 7a 50 33 20 70 6f 69 6e 74 73 0a 2a 2a  at zP3 points.**
2c50: 20 74 6f 20 61 20 73 74 72 69 6e 67 20 6f 72 20   to a string or 
2c60: 73 74 72 75 63 74 75 72 65 20 74 68 61 74 20 69  structure that i
2c70: 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f 20  s guaranteed to 
2c80: 65 78 69 73 74 20 66 6f 72 20 74 68 65 20 6c 69  exist for the li
2c90: 66 65 74 69 6d 65 20 6f 66 0a 2a 2a 20 74 68 65  fetime of.** the
2ca0: 20 56 64 62 65 2e 20 49 6e 20 74 68 65 73 65 20   Vdbe. In these 
2cb0: 63 61 73 65 73 20 77 65 20 63 61 6e 20 6a 75 73  cases we can jus
2cc0: 74 20 63 6f 70 79 20 74 68 65 20 70 6f 69 6e 74  t copy the point
2cd0: 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 64 64  er..**.** If add
2ce0: 72 3c 30 20 74 68 65 6e 20 63 68 61 6e 67 65 20  r<0 then change 
2cf0: 50 33 20 6f 6e 20 74 68 65 20 6d 6f 73 74 20 72  P3 on the most r
2d00: 65 63 65 6e 74 6c 79 20 69 6e 73 65 72 74 65 64  ecently inserted
2d10: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2f   instruction..*/
2d20: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
2d30: 65 43 68 61 6e 67 65 50 33 28 56 64 62 65 20 2a  eChangeP3(Vdbe *
2d40: 70 2c 20 69 6e 74 20 61 64 64 72 2c 20 63 6f 6e  p, int addr, con
2d50: 73 74 20 63 68 61 72 20 2a 7a 50 33 2c 20 69 6e  st char *zP3, in
2d60: 74 20 6e 29 7b 0a 20 20 4f 70 20 2a 70 4f 70 3b  t n){.  Op *pOp;
2d70: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61  .  assert( p->ma
2d80: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
2d90: 49 4e 49 54 20 29 3b 0a 20 20 69 66 28 20 70 3d  INIT );.  if( p=
2da0: 3d 30 20 7c 7c 20 70 2d 3e 61 4f 70 3d 3d 30 20  =0 || p->aOp==0 
2db0: 29 7b 0a 20 20 20 20 69 66 28 20 6e 3d 3d 50 33  ){.    if( n==P3
2dc0: 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 6e 3d 3d 50  _DYNAMIC || n==P
2dd0: 33 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46  3_KEYINFO_HANDOF
2de0: 46 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  F ){.      sqlit
2df0: 65 46 72 65 65 28 28 76 6f 69 64 2a 29 7a 50 33  eFree((void*)zP3
2e00: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28  );.    }.    if(
2e10: 20 6e 3d 3d 50 33 5f 4d 45 4d 20 29 7b 0a 20 20   n==P3_MEM ){.  
2e20: 20 20 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65      sqlite3Value
2e30: 46 72 65 65 28 28 73 71 6c 69 74 65 33 5f 76 61  Free((sqlite3_va
2e40: 6c 75 65 20 2a 29 7a 50 33 29 3b 0a 20 20 20 20  lue *)zP3);.    
2e50: 7d 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20  }.    return;.  
2e60: 7d 0a 20 20 69 66 28 20 61 64 64 72 3c 30 20 7c  }.  if( addr<0 |
2e70: 7c 20 61 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29  | addr>=p->nOp )
2e80: 7b 0a 20 20 20 20 61 64 64 72 20 3d 20 70 2d 3e  {.    addr = p->
2e90: 6e 4f 70 20 2d 20 31 3b 0a 20 20 20 20 69 66 28  nOp - 1;.    if(
2ea0: 20 61 64 64 72 3c 30 20 29 20 72 65 74 75 72 6e   addr<0 ) return
2eb0: 3b 0a 20 20 7d 0a 20 20 70 4f 70 20 3d 20 26 70  ;.  }.  pOp = &p
2ec0: 2d 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 69  ->aOp[addr];.  i
2ed0: 66 28 20 70 4f 70 2d 3e 70 33 20 26 26 20 70 4f  f( pOp->p3 && pO
2ee0: 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59  p->p3type==P3_DY
2ef0: 4e 41 4d 49 43 20 29 7b 0a 20 20 20 20 73 71 6c  NAMIC ){.    sql
2f00: 69 74 65 46 72 65 65 28 70 4f 70 2d 3e 70 33 29  iteFree(pOp->p3)
2f10: 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20  ;.    pOp->p3 = 
2f20: 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 7a 50 33  0;.  }.  if( zP3
2f30: 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e  ==0 ){.    pOp->
2f40: 70 33 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70 2d  p3 = 0;.    pOp-
2f50: 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54  >p3type = P3_NOT
2f60: 55 53 45 44 3b 0a 20 20 7d 65 6c 73 65 20 69 66  USED;.  }else if
2f70: 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20  ( n==P3_KEYINFO 
2f80: 29 7b 0a 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a  ){.    KeyInfo *
2f90: 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 20 20 69 6e  pKeyInfo;.    in
2fa0: 74 20 6e 46 69 65 6c 64 2c 20 6e 42 79 74 65 3b  t nField, nByte;
2fb0: 0a 20 20 20 20 6e 46 69 65 6c 64 20 3d 20 28 28  .    nField = ((
2fc0: 4b 65 79 49 6e 66 6f 2a 29 7a 50 33 29 2d 3e 6e  KeyInfo*)zP3)->n
2fd0: 46 69 65 6c 64 3b 0a 20 20 20 20 6e 42 79 74 65  Field;.    nByte
2fe0: 20 3d 20 73 69 7a 65 6f 66 28 2a 70 4b 65 79 49   = sizeof(*pKeyI
2ff0: 6e 66 6f 29 20 2b 20 28 6e 46 69 65 6c 64 2d 31  nfo) + (nField-1
3000: 29 2a 73 69 7a 65 6f 66 28 70 4b 65 79 49 6e 66  )*sizeof(pKeyInf
3010: 6f 2d 3e 61 43 6f 6c 6c 5b 30 5d 29 3b 0a 20 20  o->aColl[0]);.  
3020: 20 20 70 4b 65 79 49 6e 66 6f 20 3d 20 73 71 6c    pKeyInfo = sql
3030: 69 74 65 4d 61 6c 6c 6f 63 52 61 77 28 20 6e 42  iteMallocRaw( nB
3040: 79 74 65 20 29 3b 0a 20 20 20 20 70 4f 70 2d 3e  yte );.    pOp->
3050: 70 33 20 3d 20 28 63 68 61 72 2a 29 70 4b 65 79  p3 = (char*)pKey
3060: 49 6e 66 6f 3b 0a 20 20 20 20 69 66 28 20 70 4b  Info;.    if( pK
3070: 65 79 49 6e 66 6f 20 29 7b 0a 20 20 20 20 20 20  eyInfo ){.      
3080: 6d 65 6d 63 70 79 28 70 4b 65 79 49 6e 66 6f 2c  memcpy(pKeyInfo,
3090: 20 7a 50 33 2c 20 6e 42 79 74 65 29 3b 0a 20 20   zP3, nByte);.  
30a0: 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20      pOp->p3type 
30b0: 3d 20 50 33 5f 4b 45 59 49 4e 46 4f 3b 0a 20 20  = P3_KEYINFO;.  
30c0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70    }else{.      p
30d0: 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f  Op->p3type = P3_
30e0: 4e 4f 54 55 53 45 44 3b 0a 20 20 20 20 7d 0a 20  NOTUSED;.    }. 
30f0: 20 7d 65 6c 73 65 20 69 66 28 20 6e 3d 3d 50 33   }else if( n==P3
3100: 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46 46  _KEYINFO_HANDOFF
3110: 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20   ){.    pOp->p3 
3120: 3d 20 28 63 68 61 72 2a 29 7a 50 33 3b 0a 20 20  = (char*)zP3;.  
3130: 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20    pOp->p3type = 
3140: 50 33 5f 4b 45 59 49 4e 46 4f 3b 0a 20 20 7d 65  P3_KEYINFO;.  }e
3150: 6c 73 65 20 69 66 28 20 6e 3c 30 20 29 7b 0a 20  lse if( n<0 ){. 
3160: 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63 68     pOp->p3 = (ch
3170: 61 72 2a 29 7a 50 33 3b 0a 20 20 20 20 70 4f 70  ar*)zP3;.    pOp
3180: 2d 3e 70 33 74 79 70 65 20 3d 20 6e 3b 0a 20 20  ->p3type = n;.  
3190: 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 6e  }else{.    if( n
31a0: 3d 3d 30 20 29 20 6e 20 3d 20 73 74 72 6c 65 6e  ==0 ) n = strlen
31b0: 28 7a 50 33 29 3b 0a 20 20 20 20 70 4f 70 2d 3e  (zP3);.    pOp->
31c0: 70 33 20 3d 20 73 71 6c 69 74 65 53 74 72 4e 44  p3 = sqliteStrND
31d0: 75 70 28 7a 50 33 2c 20 6e 29 3b 0a 20 20 20 20  up(zP3, n);.    
31e0: 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33  pOp->p3type = P3
31f0: 5f 44 59 4e 41 4d 49 43 3b 0a 20 20 7d 0a 7d 0a  _DYNAMIC;.  }.}.
3200: 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a  .#ifndef NDEBUG.
3210: 2f 2a 0a 2a 2a 20 52 65 70 6c 61 63 65 20 74 68  /*.** Replace th
3220: 65 20 50 33 20 66 69 65 6c 64 20 6f 66 20 74 68  e P3 field of th
3230: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20  e most recently 
3240: 63 6f 64 65 64 20 69 6e 73 74 72 75 63 74 69 6f  coded instructio
3250: 6e 20 77 69 74 68 0a 2a 2a 20 63 6f 6d 6d 65 6e  n with.** commen
3260: 74 20 74 65 78 74 2e 0a 2a 2f 0a 76 6f 69 64 20  t text..*/.void 
3270: 73 71 6c 69 74 65 33 56 64 62 65 43 6f 6d 6d 65  sqlite3VdbeComme
3280: 6e 74 28 56 64 62 65 20 2a 70 2c 20 63 6f 6e 73  nt(Vdbe *p, cons
3290: 74 20 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74 2c  t char *zFormat,
32a0: 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74   ...){.  va_list
32b0: 20 61 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70   ap;.  assert( p
32c0: 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 20 20 61 73 73  ->nOp>0 );.  ass
32d0: 65 72 74 28 20 70 2d 3e 61 4f 70 3d 3d 30 20 7c  ert( p->aOp==0 |
32e0: 7c 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d  | p->aOp[p->nOp-
32f0: 31 5d 2e 70 33 3d 3d 30 20 29 3b 0a 20 20 76 61  1].p3==0 );.  va
3300: 5f 73 74 61 72 74 28 61 70 2c 20 7a 46 6f 72 6d  _start(ap, zForm
3310: 61 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  at);.  sqlite3Vd
3320: 62 65 43 68 61 6e 67 65 50 33 28 70 2c 20 2d 31  beChangeP3(p, -1
3330: 2c 20 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74  , sqlite3VMPrint
3340: 66 28 7a 46 6f 72 6d 61 74 2c 20 61 70 29 2c 20  f(zFormat, ap), 
3350: 50 33 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20 76  P3_DYNAMIC);.  v
3360: 61 5f 65 6e 64 28 61 70 29 3b 0a 7d 0a 23 65 6e  a_end(ap);.}.#en
3370: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  dif../*.** Retur
3380: 6e 20 74 68 65 20 6f 70 63 6f 64 65 20 66 6f 72  n the opcode for
3390: 20 61 20 67 69 76 65 6e 20 61 64 64 72 65 73 73   a given address
33a0: 2e 0a 2a 2f 0a 56 64 62 65 4f 70 20 2a 73 71 6c  ..*/.VdbeOp *sql
33b0: 69 74 65 33 56 64 62 65 47 65 74 4f 70 28 56 64  ite3VdbeGetOp(Vd
33c0: 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 29  be *p, int addr)
33d0: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d  {.  assert( p->m
33e0: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
33f0: 5f 49 4e 49 54 20 29 3b 0a 20 20 61 73 73 65 72  _INIT );.  asser
3400: 74 28 20 61 64 64 72 3e 3d 30 20 26 26 20 61 64  t( addr>=0 && ad
3410: 64 72 3c 70 2d 3e 6e 4f 70 20 29 3b 0a 20 20 72  dr<p->nOp );.  r
3420: 65 74 75 72 6e 20 26 70 2d 3e 61 4f 70 5b 61 64  eturn &p->aOp[ad
3430: 64 72 5d 3b 0a 7d 0a 0a 23 69 66 20 21 64 65 66  dr];.}..#if !def
3440: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54  ined(SQLITE_OMIT
3450: 5f 45 58 50 4c 41 49 4e 29 20 7c 7c 20 21 64 65  _EXPLAIN) || !de
3460: 66 69 6e 65 64 28 4e 44 45 42 55 47 29 20 5c 0a  fined(NDEBUG) \.
3470: 20 20 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28       || defined(
3480: 56 44 42 45 5f 50 52 4f 46 49 4c 45 29 20 7c 7c  VDBE_PROFILE) ||
3490: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f   defined(SQLITE_
34a0: 44 45 42 55 47 29 0a 2f 2a 0a 2a 2a 20 43 6f 6d  DEBUG)./*.** Com
34b0: 70 75 74 65 20 61 20 73 74 72 69 6e 67 20 74 68  pute a string th
34c0: 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65  at describes the
34d0: 20 50 33 20 70 61 72 61 6d 65 74 65 72 20 66 6f   P3 parameter fo
34e0: 72 20 61 6e 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20  r an opcode..** 
34f0: 55 73 65 20 7a 54 65 6d 70 20 66 6f 72 20 61 6e  Use zTemp for an
3500: 79 20 72 65 71 75 69 72 65 64 20 74 65 6d 70 6f  y required tempo
3510: 72 61 72 79 20 62 75 66 66 65 72 20 73 70 61 63  rary buffer spac
3520: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 68 61  e..*/.static cha
3530: 72 20 2a 64 69 73 70 6c 61 79 50 33 28 4f 70 20  r *displayP3(Op 
3540: 2a 70 4f 70 2c 20 63 68 61 72 20 2a 7a 54 65 6d  *pOp, char *zTem
3550: 70 2c 20 69 6e 74 20 6e 54 65 6d 70 29 7b 0a 20  p, int nTemp){. 
3560: 20 63 68 61 72 20 2a 7a 50 33 3b 0a 20 20 61 73   char *zP3;.  as
3570: 73 65 72 74 28 20 6e 54 65 6d 70 3e 3d 32 30 20  sert( nTemp>=20 
3580: 29 3b 0a 20 20 73 77 69 74 63 68 28 20 70 4f 70  );.  switch( pOp
3590: 2d 3e 70 33 74 79 70 65 20 29 7b 0a 20 20 20 20  ->p3type ){.    
35a0: 63 61 73 65 20 50 33 5f 4b 45 59 49 4e 46 4f 3a  case P3_KEYINFO:
35b0: 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 2c 20   {.      int i, 
35c0: 6a 3b 0a 20 20 20 20 20 20 4b 65 79 49 6e 66 6f  j;.      KeyInfo
35d0: 20 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 28 4b 65   *pKeyInfo = (Ke
35e0: 79 49 6e 66 6f 2a 29 70 4f 70 2d 3e 70 33 3b 0a  yInfo*)pOp->p3;.
35f0: 20 20 20 20 20 20 73 70 72 69 6e 74 66 28 7a 54        sprintf(zT
3600: 65 6d 70 2c 20 22 6b 65 79 69 6e 66 6f 28 25 64  emp, "keyinfo(%d
3610: 22 2c 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69  ", pKeyInfo->nFi
3620: 65 6c 64 29 3b 0a 20 20 20 20 20 20 69 20 3d 20  eld);.      i = 
3630: 73 74 72 6c 65 6e 28 7a 54 65 6d 70 29 3b 0a 20  strlen(zTemp);. 
3640: 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c       for(j=0; j<
3650: 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64  pKeyInfo->nField
3660: 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20  ; j++){.        
3670: 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d  CollSeq *pColl =
3680: 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c   pKeyInfo->aColl
3690: 5b 6a 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28  [j];.        if(
36a0: 20 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 20 20   pColl ){.      
36b0: 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 74 72 6c      int n = strl
36c0: 65 6e 28 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29  en(pColl->zName)
36d0: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20  ;.          if( 
36e0: 69 2b 6e 3e 6e 54 65 6d 70 2d 36 20 29 7b 0a 20  i+n>nTemp-6 ){. 
36f0: 20 20 20 20 20 20 20 20 20 20 20 73 74 72 63 70             strcp
3700: 79 28 26 7a 54 65 6d 70 5b 69 5d 2c 22 2c 2e 2e  y(&zTemp[i],",..
3710: 2e 22 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20  .");.           
3720: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
3730: 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7a 54    }.          zT
3740: 65 6d 70 5b 69 2b 2b 5d 20 3d 20 27 2c 27 3b 0a  emp[i++] = ',';.
3750: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 4b            if( pK
3760: 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64  eyInfo->aSortOrd
3770: 65 72 20 26 26 20 70 4b 65 79 49 6e 66 6f 2d 3e  er && pKeyInfo->
3780: 61 53 6f 72 74 4f 72 64 65 72 5b 6a 5d 20 29 7b  aSortOrder[j] ){
3790: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7a 54 65  .            zTe
37a0: 6d 70 5b 69 2b 2b 5d 20 3d 20 27 2d 27 3b 0a 20  mp[i++] = '-';. 
37b0: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20           }.     
37c0: 20 20 20 20 20 73 74 72 63 70 79 28 26 7a 54 65       strcpy(&zTe
37d0: 6d 70 5b 69 5d 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e  mp[i], pColl->zN
37e0: 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ame);.          
37f0: 69 20 2b 3d 20 6e 3b 0a 20 20 20 20 20 20 20 20  i += n;.        
3800: 7d 65 6c 73 65 20 69 66 28 20 69 2b 34 3c 6e 54  }else if( i+4<nT
3810: 65 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20 20 20  emp-6 ){.       
3820: 20 20 20 73 74 72 63 70 79 28 26 7a 54 65 6d 70     strcpy(&zTemp
3830: 5b 69 5d 2c 22 2c 6e 69 6c 22 29 3b 0a 20 20 20  [i],",nil");.   
3840: 20 20 20 20 20 20 20 69 20 2b 3d 20 34 3b 0a 20         i += 4;. 
3850: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
3860: 0a 20 20 20 20 20 20 7a 54 65 6d 70 5b 69 2b 2b  .      zTemp[i++
3870: 5d 20 3d 20 27 29 27 3b 0a 20 20 20 20 20 20 7a  ] = ')';.      z
3880: 54 65 6d 70 5b 69 5d 20 3d 20 30 3b 0a 20 20 20  Temp[i] = 0;.   
3890: 20 20 20 61 73 73 65 72 74 28 20 69 3c 6e 54 65     assert( i<nTe
38a0: 6d 70 20 29 3b 0a 20 20 20 20 20 20 7a 50 33 20  mp );.      zP3 
38b0: 3d 20 7a 54 65 6d 70 3b 0a 20 20 20 20 20 20 62  = zTemp;.      b
38c0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
38d0: 63 61 73 65 20 50 33 5f 43 4f 4c 4c 53 45 51 3a  case P3_COLLSEQ:
38e0: 20 7b 0a 20 20 20 20 20 20 43 6f 6c 6c 53 65 71   {.      CollSeq
38f0: 20 2a 70 43 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53   *pColl = (CollS
3900: 65 71 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20  eq*)pOp->p3;.   
3910: 20 20 20 73 70 72 69 6e 74 66 28 7a 54 65 6d 70     sprintf(zTemp
3920: 2c 20 22 63 6f 6c 6c 73 65 71 28 25 2e 32 30 73  , "collseq(%.20s
3930: 29 22 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65  )", pColl->zName
3940: 29 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a  );.      zP3 = z
3950: 54 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61  Temp;.      brea
3960: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  k;.    }.    cas
3970: 65 20 50 33 5f 46 55 4e 43 44 45 46 3a 20 7b 0a  e P3_FUNCDEF: {.
3980: 20 20 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70        FuncDef *p
3990: 44 65 66 20 3d 20 28 46 75 6e 63 44 65 66 2a 29  Def = (FuncDef*)
39a0: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 63  pOp->p3;.      c
39b0: 68 61 72 20 7a 4e 75 6d 5b 33 30 5d 3b 0a 20 20  har zNum[30];.  
39c0: 20 20 20 20 73 70 72 69 6e 74 66 28 7a 54 65 6d      sprintf(zTem
39d0: 70 2c 20 22 25 2e 2a 73 22 2c 20 6e 54 65 6d 70  p, "%.*s", nTemp
39e0: 2c 20 70 44 65 66 2d 3e 7a 4e 61 6d 65 29 3b 0a  , pDef->zName);.
39f0: 20 20 20 20 20 20 73 70 72 69 6e 74 66 28 7a 4e        sprintf(zN
3a00: 75 6d 2c 22 28 25 64 29 22 2c 20 70 44 65 66 2d  um,"(%d)", pDef-
3a10: 3e 6e 41 72 67 29 3b 0a 20 20 20 20 20 20 69 66  >nArg);.      if
3a20: 28 20 73 74 72 6c 65 6e 28 7a 54 65 6d 70 29 2b  ( strlen(zTemp)+
3a30: 73 74 72 6c 65 6e 28 7a 4e 75 6d 29 2b 31 3c 3d  strlen(zNum)+1<=
3a40: 6e 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 20 20  nTemp ){.       
3a50: 20 73 74 72 63 61 74 28 7a 54 65 6d 70 2c 20 7a   strcat(zTemp, z
3a60: 4e 75 6d 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Num);.      }.  
3a70: 20 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b      zP3 = zTemp;
3a80: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  .      break;.  
3a90: 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a    }.    default:
3aa0: 20 7b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 70   {.      zP3 = p
3ab0: 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 69 66  Op->p3;.      if
3ac0: 28 20 7a 50 33 3d 3d 30 20 7c 7c 20 70 4f 70 2d  ( zP3==0 || pOp-
3ad0: 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f 70  >opcode==OP_Noop
3ae0: 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 50 33 20   ){.        zP3 
3af0: 3d 20 22 22 3b 0a 20 20 20 20 20 20 7d 0a 20 20  = "";.      }.  
3b00: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e    }.  }.  return
3b10: 20 7a 50 33 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a   zP3;.}.#endif..
3b20: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 56 44 42  .#if defined(VDB
3b30: 45 5f 50 52 4f 46 49 4c 45 29 20 7c 7c 20 64 65  E_PROFILE) || de
3b40: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42  fined(SQLITE_DEB
3b50: 55 47 29 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20  UG)./*.** Print 
3b60: 61 20 73 69 6e 67 6c 65 20 6f 70 63 6f 64 65 2e  a single opcode.
3b70: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69    This routine i
3b80: 73 20 75 73 65 64 20 66 6f 72 20 64 65 62 75 67  s used for debug
3b90: 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76 6f  ging only..*/.vo
3ba0: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 50 72  id sqlite3VdbePr
3bb0: 69 6e 74 4f 70 28 46 49 4c 45 20 2a 70 4f 75 74  intOp(FILE *pOut
3bc0: 2c 20 69 6e 74 20 70 63 2c 20 4f 70 20 2a 70 4f  , int pc, Op *pO
3bd0: 70 29 7b 0a 20 20 63 68 61 72 20 2a 7a 50 33 3b  p){.  char *zP3;
3be0: 0a 20 20 63 68 61 72 20 7a 50 74 72 5b 35 30 5d  .  char zPtr[50]
3bf0: 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  ;.  static const
3c00: 20 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74 31 20   char *zFormat1 
3c10: 3d 20 22 25 34 64 20 25 2d 31 33 73 20 25 34 64  = "%4d %-13s %4d
3c20: 20 25 34 64 20 25 73 5c 6e 22 3b 0a 20 20 69 66   %4d %s\n";.  if
3c30: 28 20 70 4f 75 74 3d 3d 30 20 29 20 70 4f 75 74  ( pOut==0 ) pOut
3c40: 20 3d 20 73 74 64 6f 75 74 3b 0a 20 20 7a 50 33   = stdout;.  zP3
3c50: 20 3d 20 64 69 73 70 6c 61 79 50 33 28 70 4f 70   = displayP3(pOp
3c60: 2c 20 7a 50 74 72 2c 20 73 69 7a 65 6f 66 28 7a  , zPtr, sizeof(z
3c70: 50 74 72 29 29 3b 0a 20 20 66 70 72 69 6e 74 66  Ptr));.  fprintf
3c80: 28 70 4f 75 74 2c 20 7a 46 6f 72 6d 61 74 31 2c  (pOut, zFormat1,
3c90: 0a 20 20 20 20 20 20 70 63 2c 20 73 71 6c 69 74  .      pc, sqlit
3ca0: 65 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70 4f  e3OpcodeNames[pO
3cb0: 70 2d 3e 6f 70 63 6f 64 65 5d 2c 20 70 4f 70 2d  p->opcode], pOp-
3cc0: 3e 70 31 2c 20 70 4f 70 2d 3e 70 32 2c 20 7a 50  >p1, pOp->p2, zP
3cd0: 33 29 3b 0a 20 20 66 66 6c 75 73 68 28 70 4f 75  3);.  fflush(pOu
3ce0: 74 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a  t);.}.#endif../*
3cf0: 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 6e 20 61  .** Release an a
3d00: 72 72 61 79 20 6f 66 20 4e 20 4d 65 6d 20 65 6c  rray of N Mem el
3d10: 65 6d 65 6e 74 73 0a 2a 2f 0a 73 74 61 74 69 63  ements.*/.static
3d20: 20 76 6f 69 64 20 72 65 6c 65 61 73 65 4d 65 6d   void releaseMem
3d30: 41 72 72 61 79 28 4d 65 6d 20 2a 70 2c 20 69 6e  Array(Mem *p, in
3d40: 74 20 4e 29 7b 0a 20 20 69 66 28 20 70 20 29 7b  t N){.  if( p ){
3d50: 0a 20 20 20 20 77 68 69 6c 65 28 20 4e 2d 2d 3e  .    while( N-->
3d60: 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  0 ){.      sqlit
3d70: 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65  e3VdbeMemRelease
3d80: 28 70 2b 2b 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  (p++);.    }.  }
3d90: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  .}..#ifndef SQLI
3da0: 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a  TE_OMIT_EXPLAIN.
3db0: 2f 2a 0a 2a 2a 20 47 69 76 65 20 61 20 6c 69 73  /*.** Give a lis
3dc0: 74 69 6e 67 20 6f 66 20 74 68 65 20 70 72 6f 67  ting of the prog
3dd0: 72 61 6d 20 69 6e 20 74 68 65 20 76 69 72 74 75  ram in the virtu
3de0: 61 6c 20 6d 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a  al machine..**.*
3df0: 2a 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 20  * The interface 
3e00: 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 73  is the same as s
3e10: 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 29  qlite3VdbeExec()
3e20: 2e 20 20 42 75 74 20 69 6e 73 74 65 61 64 20 6f  .  But instead o
3e30: 66 0a 2a 2a 20 72 75 6e 6e 69 6e 67 20 74 68 65  f.** running the
3e40: 20 63 6f 64 65 2c 20 69 74 20 69 6e 76 6f 6b 65   code, it invoke
3e50: 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 6f  s the callback o
3e60: 6e 63 65 20 66 6f 72 20 65 61 63 68 20 69 6e 73  nce for each ins
3e70: 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69  truction..** Thi
3e80: 73 20 66 65 61 74 75 72 65 20 69 73 20 75 73 65  s feature is use
3e90: 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 22  d to implement "
3ea0: 45 58 50 4c 41 49 4e 22 2e 0a 2a 2f 0a 69 6e 74  EXPLAIN"..*/.int
3eb0: 20 73 71 6c 69 74 65 33 56 64 62 65 4c 69 73 74   sqlite3VdbeList
3ec0: 28 0a 20 20 56 64 62 65 20 2a 70 20 20 20 20 20  (.  Vdbe *p     
3ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3ee0: 20 54 68 65 20 56 44 42 45 20 2a 2f 0a 29 7b 0a   The VDBE */.){.
3ef0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20    sqlite3 *db = 
3f00: 70 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 3b 0a  p->db;.  int i;.
3f10: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
3f20: 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28  E_OK;..  assert(
3f30: 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29 3b 0a 20   p->explain );. 
3f40: 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56   if( p->magic!=V
3f50: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 20  DBE_MAGIC_RUN ) 
3f60: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
3f70: 53 55 53 45 3b 0a 20 20 61 73 73 65 72 74 28 20  SUSE;.  assert( 
3f80: 64 62 2d 3e 6d 61 67 69 63 3d 3d 53 51 4c 49 54  db->magic==SQLIT
3f90: 45 5f 4d 41 47 49 43 5f 42 55 53 59 20 29 3b 0a  E_MAGIC_BUSY );.
3fa0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 72 63 3d    assert( p->rc=
3fb0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d  =SQLITE_OK || p-
3fc0: 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59  >rc==SQLITE_BUSY
3fd0: 20 29 3b 0a 0a 20 20 2f 2a 20 45 76 65 6e 20 74   );..  /* Even t
3fe0: 68 6f 75 67 68 20 74 68 69 73 20 6f 70 63 6f 64  hough this opcod
3ff0: 65 20 64 6f 65 73 20 6e 6f 74 20 70 75 74 20 64  e does not put d
4000: 79 6e 61 6d 69 63 20 73 74 72 69 6e 67 73 20 6f  ynamic strings o
4010: 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 74 68 65  nto the.  ** the
4020: 20 73 74 61 63 6b 2c 20 74 68 65 79 20 6d 61 79   stack, they may
4030: 20 62 65 63 6f 6d 65 20 64 79 6e 61 6d 69 63 20   become dynamic 
4040: 69 66 20 74 68 65 20 75 73 65 72 20 63 61 6c 6c  if the user call
4050: 73 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63  s.  ** sqlite3_c
4060: 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 2c 20  olumn_text16(), 
4070: 63 61 75 73 69 6e 67 20 61 20 74 72 61 6e 73 6c  causing a transl
4080: 61 74 69 6f 6e 20 74 6f 20 55 54 46 2d 31 36 20  ation to UTF-16 
4090: 65 6e 63 6f 64 69 6e 67 2e 0a 20 20 2a 2f 0a 20  encoding..  */. 
40a0: 20 69 66 28 20 70 2d 3e 70 54 6f 73 3d 3d 26 70   if( p->pTos==&p
40b0: 2d 3e 61 53 74 61 63 6b 5b 34 5d 20 29 7b 0a 20  ->aStack[4] ){. 
40c0: 20 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72     releaseMemArr
40d0: 61 79 28 70 2d 3e 61 53 74 61 63 6b 2c 20 35 29  ay(p->aStack, 5)
40e0: 3b 0a 20 20 7d 0a 20 20 70 2d 3e 72 65 73 4f 6e  ;.  }.  p->resOn
40f0: 53 74 61 63 6b 20 3d 20 30 3b 0a 0a 0a 20 20 69  Stack = 0;...  i
4100: 20 3d 20 70 2d 3e 70 63 2b 2b 3b 0a 20 20 69 66   = p->pc++;.  if
4110: 28 20 69 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20  ( i>=p->nOp ){. 
4120: 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54     p->rc = SQLIT
4130: 45 5f 4f 4b 3b 0a 20 20 20 20 72 63 20 3d 20 53  E_OK;.    rc = S
4140: 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 65  QLITE_DONE;.  }e
4150: 6c 73 65 20 69 66 28 20 64 62 2d 3e 66 6c 61 67  lse if( db->flag
4160: 73 20 26 20 53 51 4c 49 54 45 5f 49 6e 74 65 72  s & SQLITE_Inter
4170: 72 75 70 74 20 29 7b 0a 20 20 20 20 64 62 2d 3e  rupt ){.    db->
4180: 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45  flags &= ~SQLITE
4190: 5f 49 6e 74 65 72 72 75 70 74 3b 0a 20 20 20 20  _Interrupt;.    
41a0: 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 49  p->rc = SQLITE_I
41b0: 4e 54 45 52 52 55 50 54 3b 0a 20 20 20 20 72 63  NTERRUPT;.    rc
41c0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b   = SQLITE_ERROR;
41d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53  .    sqlite3SetS
41e0: 74 72 69 6e 67 28 26 70 2d 3e 7a 45 72 72 4d 73  tring(&p->zErrMs
41f0: 67 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 72  g, sqlite3ErrStr
4200: 28 70 2d 3e 72 63 29 2c 20 28 63 68 61 72 2a 29  (p->rc), (char*)
4210: 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  0);.  }else{.   
4220: 20 4f 70 20 2a 70 4f 70 20 3d 20 26 70 2d 3e 61   Op *pOp = &p->a
4230: 4f 70 5b 69 5d 3b 0a 20 20 20 20 4d 65 6d 20 2a  Op[i];.    Mem *
4240: 70 4d 65 6d 20 3d 20 70 2d 3e 61 53 74 61 63 6b  pMem = p->aStack
4250: 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67  ;.    pMem->flag
4260: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
4270: 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51   pMem->type = SQ
4280: 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20  LITE_INTEGER;.  
4290: 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 69 3b 20 20    pMem->i = i;  
42a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
42b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
42c0: 20 50 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72   Program counter
42d0: 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a   */.    pMem++;.
42e0: 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73  .    pMem->flags
42f0: 20 3d 20 4d 45 4d 5f 53 74 61 74 69 63 7c 4d 45   = MEM_Static|ME
4300: 4d 5f 53 74 72 7c 4d 45 4d 5f 54 65 72 6d 3b 0a  M_Str|MEM_Term;.
4310: 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 73 71      pMem->z = sq
4320: 6c 69 74 65 33 4f 70 63 6f 64 65 4e 61 6d 65 73  lite3OpcodeNames
4330: 5b 70 4f 70 2d 3e 6f 70 63 6f 64 65 5d 3b 20 20  [pOp->opcode];  
4340: 2f 2a 20 4f 70 63 6f 64 65 20 2a 2f 0a 20 20 20  /* Opcode */.   
4350: 20 70 4d 65 6d 2d 3e 6e 20 3d 20 73 74 72 6c 65   pMem->n = strle
4360: 6e 28 70 4d 65 6d 2d 3e 7a 29 3b 0a 20 20 20 20  n(pMem->z);.    
4370: 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c  pMem->type = SQL
4380: 49 54 45 5f 54 45 58 54 3b 0a 20 20 20 20 70 4d  ITE_TEXT;.    pM
4390: 65 6d 2d 3e 65 6e 63 20 3d 20 53 51 4c 49 54 45  em->enc = SQLITE
43a0: 5f 55 54 46 38 3b 0a 20 20 20 20 70 4d 65 6d 2b  _UTF8;.    pMem+
43b0: 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  +;..    pMem->fl
43c0: 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20  ags = MEM_Int;. 
43d0: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70     pMem->i = pOp
43e0: 2d 3e 70 31 3b 20 20 20 20 20 20 20 20 20 20 20  ->p1;           
43f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
4400: 2a 20 50 31 20 2a 2f 0a 20 20 20 20 70 4d 65 6d  * P1 */.    pMem
4410: 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f  ->type = SQLITE_
4420: 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70 4d 65  INTEGER;.    pMe
4430: 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e  m++;..    pMem->
4440: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b  flags = MEM_Int;
4450: 0a 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 70  .    pMem->i = p
4460: 4f 70 2d 3e 70 32 3b 20 20 20 20 20 20 20 20 20  Op->p2;         
4470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4480: 20 2f 2a 20 50 32 20 2a 2f 0a 20 20 20 20 70 4d   /* P2 */.    pM
4490: 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54  em->type = SQLIT
44a0: 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70  E_INTEGER;.    p
44b0: 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d  Mem++;..    pMem
44c0: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 68  ->flags = MEM_Sh
44d0: 6f 72 74 7c 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f  ort|MEM_Str|MEM_
44e0: 54 65 72 6d 3b 20 20 20 2f 2a 20 50 33 20 2a 2f  Term;   /* P3 */
44f0: 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 64  .    pMem->z = d
4500: 69 73 70 6c 61 79 50 33 28 70 4f 70 2c 20 70 4d  isplayP3(pOp, pM
4510: 65 6d 2d 3e 7a 53 68 6f 72 74 2c 20 73 69 7a 65  em->zShort, size
4520: 6f 66 28 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 29  of(pMem->zShort)
4530: 29 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70  );.    pMem->typ
4540: 65 20 3d 20 53 51 4c 49 54 45 5f 54 45 58 54 3b  e = SQLITE_TEXT;
4550: 0a 20 20 20 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d  .    pMem->enc =
4560: 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 0a 20   SQLITE_UTF8;.. 
4570: 20 20 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e     p->nResColumn
4580: 20 3d 20 35 3b 0a 20 20 20 20 70 2d 3e 70 54 6f   = 5;.    p->pTo
4590: 73 20 3d 20 70 4d 65 6d 3b 0a 20 20 20 20 70 2d  s = pMem;.    p-
45a0: 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  >rc = SQLITE_OK;
45b0: 0a 20 20 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61  .    p->resOnSta
45c0: 63 6b 20 3d 20 31 3b 0a 20 20 20 20 72 63 20 3d  ck = 1;.    rc =
45d0: 20 53 51 4c 49 54 45 5f 52 4f 57 3b 0a 20 20 7d   SQLITE_ROW;.  }
45e0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
45f0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
4600: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 20 2a 2f  _OMIT_EXPLAIN */
4610: 0a 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 74 68  ../*.** Print th
4620: 65 20 53 51 4c 20 74 68 61 74 20 77 61 73 20 75  e SQL that was u
4630: 73 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20  sed to generate 
4640: 61 20 56 44 42 45 20 70 72 6f 67 72 61 6d 2e 0a  a VDBE program..
4650: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
4660: 64 62 65 50 72 69 6e 74 53 71 6c 28 56 64 62 65  dbePrintSql(Vdbe
4670: 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 51 4c   *p){.#ifdef SQL
4680: 49 54 45 5f 44 45 42 55 47 0a 20 20 69 6e 74 20  ITE_DEBUG.  int 
4690: 6e 4f 70 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20  nOp = p->nOp;.  
46a0: 56 64 62 65 4f 70 20 2a 70 4f 70 3b 0a 20 20 69  VdbeOp *pOp;.  i
46b0: 66 28 20 6e 4f 70 3c 31 20 29 20 72 65 74 75 72  f( nOp<1 ) retur
46c0: 6e 3b 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61  n;.  pOp = &p->a
46d0: 4f 70 5b 6e 4f 70 2d 31 5d 3b 0a 20 20 69 66 28  Op[nOp-1];.  if(
46e0: 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50   pOp->opcode==OP
46f0: 5f 4e 6f 6f 70 20 26 26 20 70 4f 70 2d 3e 70 33  _Noop && pOp->p3
4700: 21 3d 30 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74  !=0 ){.    const
4710: 20 63 68 61 72 20 2a 7a 20 3d 20 70 4f 70 2d 3e   char *z = pOp->
4720: 70 33 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 69  p3;.    while( i
4730: 73 73 70 61 63 65 28 2a 28 75 38 2a 29 7a 29 20  sspace(*(u8*)z) 
4740: 29 20 7a 2b 2b 3b 0a 20 20 20 20 70 72 69 6e 74  ) z++;.    print
4750: 66 28 22 53 51 4c 3a 20 5b 25 73 5d 5c 6e 22 2c  f("SQL: [%s]\n",
4760: 20 7a 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a   z);.  }.#endif.
4770: 7d 0a 0a 2f 2a 0a 2a 2a 20 50 72 65 70 61 72 65  }../*.** Prepare
4780: 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69   a virtual machi
4790: 6e 65 20 66 6f 72 20 65 78 65 63 75 74 69 6f 6e  ne for execution
47a0: 2e 20 20 54 68 69 73 20 69 6e 76 6f 6c 76 65 73  .  This involves
47b0: 20 74 68 69 6e 67 73 20 73 75 63 68 0a 2a 2a 20   things such.** 
47c0: 61 73 20 61 6c 6c 6f 63 61 74 69 6e 67 20 73 74  as allocating st
47d0: 61 63 6b 20 73 70 61 63 65 20 61 6e 64 20 69 6e  ack space and in
47e0: 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 70  itializing the p
47f0: 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 2e 0a  rogram counter..
4800: 2a 2a 20 41 66 74 65 72 20 74 68 65 20 56 44 42  ** After the VDB
4810: 45 20 68 61 73 20 62 65 20 70 72 65 70 70 65 64  E has be prepped
4820: 2c 20 69 74 20 63 61 6e 20 62 65 20 65 78 65 63  , it can be exec
4830: 75 74 65 64 20 62 79 20 6f 6e 65 20 6f 72 20 6d  uted by one or m
4840: 6f 72 65 0a 2a 2a 20 63 61 6c 6c 73 20 74 6f 20  ore.** calls to 
4850: 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28  sqlite3VdbeExec(
4860: 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ).  .**.** This 
4870: 69 73 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 20  is the only way 
4880: 74 6f 20 6d 6f 76 65 20 61 20 56 44 42 45 20 66  to move a VDBE f
4890: 72 6f 6d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  rom VDBE_MAGIC_I
48a0: 4e 49 54 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d  NIT to.** VDBE_M
48b0: 41 47 49 43 5f 52 55 4e 2e 0a 2a 2f 0a 76 6f 69  AGIC_RUN..*/.voi
48c0: 64 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b  d sqlite3VdbeMak
48d0: 65 52 65 61 64 79 28 0a 20 20 56 64 62 65 20 2a  eReady(.  Vdbe *
48e0: 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  p,              
48f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
4900: 56 44 42 45 20 2a 2f 0a 20 20 69 6e 74 20 6e 56  VDBE */.  int nV
4910: 61 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ar,             
4920: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
4930: 65 72 20 6f 66 20 27 3f 27 20 73 65 65 20 69 6e  er of '?' see in
4940: 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65   the SQL stateme
4950: 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d  nt */.  int nMem
4960: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
4970: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
4980: 20 6f 66 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73   of memory cells
4990: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a   to allocate */.
49a0: 20 20 69 6e 74 20 6e 43 75 72 73 6f 72 2c 20 20    int nCursor,  
49b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
49c0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 75   /* Number of cu
49d0: 72 73 6f 72 73 20 74 6f 20 61 6c 6c 6f 63 61 74  rsors to allocat
49e0: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 67 67 2c  e */.  int nAgg,
49f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4a00: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
4a10: 6f 66 20 61 67 67 72 65 67 61 74 65 20 63 6f 6e  of aggregate con
4a20: 74 65 78 74 73 20 72 65 71 75 69 72 65 64 20 2a  texts required *
4a30: 2f 0a 20 20 69 6e 74 20 69 73 45 78 70 6c 61 69  /.  int isExplai
4a40: 6e 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  n               
4a50: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68     /* True if th
4a60: 65 20 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72  e EXPLAIN keywor
4a70: 64 73 20 69 73 20 70 72 65 73 65 6e 74 20 2a 2f  ds is present */
4a80: 0a 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 0a 20 20  .){.  int n;..  
4a90: 61 73 73 65 72 74 28 20 70 21 3d 30 20 29 3b 0a  assert( p!=0 );.
4aa0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67    assert( p->mag
4ab0: 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49  ic==VDBE_MAGIC_I
4ac0: 4e 49 54 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 65  NIT );..  /* The
4ad0: 72 65 20 73 68 6f 75 6c 64 20 62 65 20 61 74 20  re should be at 
4ae0: 6c 65 61 73 74 20 6f 6e 65 20 6f 70 63 6f 64 65  least one opcode
4af0: 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  ..  */.  assert(
4b00: 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 0a 20 20   p->nOp>0 );..  
4b10: 2f 2a 20 53 65 74 20 74 68 65 20 6d 61 67 69 63  /* Set the magic
4b20: 20 74 6f 20 56 44 42 45 5f 4d 41 47 49 43 5f 52   to VDBE_MAGIC_R
4b30: 55 4e 20 73 6f 6f 6e 65 72 20 72 61 74 68 65 72  UN sooner rather
4b40: 20 74 68 61 6e 20 6c 61 74 65 72 2e 20 54 68 69   than later. Thi
4b50: 73 0a 20 20 20 2a 20 69 73 20 62 65 63 61 75 73  s.   * is becaus
4b60: 65 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 72 65  e the call to re
4b70: 73 69 7a 65 4f 70 41 72 72 61 79 28 29 20 62 65  sizeOpArray() be
4b80: 6c 6f 77 20 6d 61 79 20 73 68 72 69 6e 6b 20 74  low may shrink t
4b90: 68 65 0a 20 20 20 2a 20 70 2d 3e 61 4f 70 5b 5d  he.   * p->aOp[]
4ba0: 20 61 72 72 61 79 20 74 6f 20 73 61 76 65 20 6d   array to save m
4bb0: 65 6d 6f 72 79 20 69 66 20 63 61 6c 6c 65 64 20  emory if called 
4bc0: 77 68 65 6e 20 69 6e 20 56 44 42 45 5f 4d 41 47  when in VDBE_MAG
4bd0: 49 43 5f 52 55 4e 20 0a 20 20 20 2a 20 73 74 61  IC_RUN .   * sta
4be0: 74 65 2e 0a 20 20 20 2a 2f 0a 20 20 70 2d 3e 6d  te..   */.  p->m
4bf0: 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49  agic = VDBE_MAGI
4c00: 43 5f 52 55 4e 3b 0a 0a 20 20 2f 2a 20 4e 6f 20  C_RUN;..  /* No 
4c10: 69 6e 73 74 72 75 63 74 69 6f 6e 20 65 76 65 72  instruction ever
4c20: 20 70 75 73 68 65 73 20 6d 6f 72 65 20 74 68 61   pushes more tha
4c30: 6e 20 61 20 73 69 6e 67 6c 65 20 65 6c 65 6d 65  n a single eleme
4c40: 6e 74 20 6f 6e 74 6f 20 74 68 65 0a 20 20 2a 2a  nt onto the.  **
4c50: 20 73 74 61 63 6b 2e 20 20 41 6e 64 20 74 68 65   stack.  And the
4c60: 20 73 74 61 63 6b 20 6e 65 76 65 72 20 67 72 6f   stack never gro
4c70: 77 73 20 6f 6e 20 73 75 63 63 65 73 73 69 76 65  ws on successive
4c80: 20 65 78 65 63 75 74 69 6f 6e 73 20 6f 66 20 74   executions of t
4c90: 68 65 0a 20 20 2a 2a 20 73 61 6d 65 20 6c 6f 6f  he.  ** same loo
4ca0: 70 2e 20 20 53 6f 20 74 68 65 20 74 6f 74 61 6c  p.  So the total
4cb0: 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 73 74 72   number of instr
4cc0: 75 63 74 69 6f 6e 73 20 69 73 20 61 6e 20 75 70  uctions is an up
4cd0: 70 65 72 20 62 6f 75 6e 64 0a 20 20 2a 2a 20 6f  per bound.  ** o
4ce0: 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 73 74  n the maximum st
4cf0: 61 63 6b 20 64 65 70 74 68 20 72 65 71 75 69 72  ack depth requir
4d00: 65 64 2e 20 20 28 41 64 64 65 64 20 6c 61 74 65  ed.  (Added late
4d10: 72 3a 29 20 20 54 68 65 0a 20 20 2a 2a 20 72 65  r:)  The.  ** re
4d20: 73 6f 6c 76 65 50 32 56 61 6c 75 65 73 28 29 20  solveP2Values() 
4d30: 63 61 6c 6c 20 63 6f 6d 70 75 74 65 73 20 61 20  call computes a 
4d40: 74 69 67 68 74 65 72 20 75 70 70 65 72 20 62 6f  tighter upper bo
4d50: 75 6e 64 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20  und on the.  ** 
4d60: 73 74 61 63 6b 20 73 69 7a 65 2e 0a 20 20 2a 2a  stack size..  **
4d70: 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61 74 69 6f 6e  .  ** Allocation
4d80: 20 61 6c 6c 20 74 68 65 20 73 74 61 63 6b 20 73   all the stack s
4d90: 70 61 63 65 20 77 65 20 77 69 6c 6c 20 65 76 65  pace we will eve
4da0: 72 20 6e 65 65 64 2e 0a 20 20 2a 2f 0a 20 20 69  r need..  */.  i
4db0: 66 28 20 70 2d 3e 61 53 74 61 63 6b 3d 3d 30 20  f( p->aStack==0 
4dc0: 29 7b 0a 20 20 20 20 69 6e 74 20 6e 41 72 67 3b  ){.    int nArg;
4dd0: 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75         /* Maximu
4de0: 6d 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 73  m number of args
4df0: 20 70 61 73 73 65 64 20 74 6f 20 61 20 75 73 65   passed to a use
4e00: 72 20 66 75 6e 63 74 69 6f 6e 2e 20 2a 2f 0a 20  r function. */. 
4e10: 20 20 20 69 6e 74 20 6e 53 74 61 63 6b 3b 20 20     int nStack;  
4e20: 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e 75     /* Maximum nu
4e30: 6d 62 65 72 20 6f 66 20 73 74 61 63 6b 20 65 6e  mber of stack en
4e40: 74 72 69 65 73 20 72 65 71 75 69 72 65 64 20 2a  tries required *
4e50: 2f 0a 20 20 20 20 72 65 73 6f 6c 76 65 50 32 56  /.    resolveP2V
4e60: 61 6c 75 65 73 28 70 2c 20 26 6e 41 72 67 2c 20  alues(p, &nArg, 
4e70: 26 6e 53 74 61 63 6b 29 3b 0a 20 20 20 20 72 65  &nStack);.    re
4e80: 73 69 7a 65 4f 70 41 72 72 61 79 28 70 2c 20 70  sizeOpArray(p, p
4e90: 2d 3e 6e 4f 70 29 3b 0a 20 20 20 20 61 73 73 65  ->nOp);.    asse
4ea0: 72 74 28 20 6e 56 61 72 3e 3d 30 20 29 3b 0a 20  rt( nVar>=0 );. 
4eb0: 20 20 20 61 73 73 65 72 74 28 20 6e 53 74 61 63     assert( nStac
4ec0: 6b 3c 70 2d 3e 6e 4f 70 20 29 3b 0a 20 20 20 20  k<p->nOp );.    
4ed0: 6e 53 74 61 63 6b 20 3d 20 69 73 45 78 70 6c 61  nStack = isExpla
4ee0: 69 6e 20 3f 20 31 30 20 3a 20 6e 53 74 61 63 6b  in ? 10 : nStack
4ef0: 3b 0a 20 20 20 20 70 2d 3e 61 53 74 61 63 6b 20  ;.    p->aStack 
4f00: 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 0a  = sqliteMalloc(.
4f10: 20 20 20 20 20 20 20 20 6e 53 74 61 63 6b 2a 73          nStack*s
4f20: 69 7a 65 6f 66 28 70 2d 3e 61 53 74 61 63 6b 5b  izeof(p->aStack[
4f30: 30 5d 29 20 20 20 20 2f 2a 20 61 53 74 61 63 6b  0])    /* aStack
4f40: 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 41 72 67   */.      + nArg
4f50: 2a 73 69 7a 65 6f 66 28 4d 65 6d 2a 29 20 20 20  *sizeof(Mem*)   
4f60: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 61 70             /* ap
4f70: 41 72 67 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e  Arg */.      + n
4f80: 56 61 72 2a 73 69 7a 65 6f 66 28 4d 65 6d 29 20  Var*sizeof(Mem) 
4f90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4fa0: 20 61 56 61 72 20 2a 2f 0a 20 20 20 20 20 20 2b   aVar */.      +
4fb0: 20 6e 56 61 72 2a 73 69 7a 65 6f 66 28 63 68 61   nVar*sizeof(cha
4fc0: 72 2a 29 20 20 20 20 20 20 20 20 20 20 20 20 20  r*)             
4fd0: 2f 2a 20 61 7a 56 61 72 20 2a 2f 0a 20 20 20 20  /* azVar */.    
4fe0: 20 20 2b 20 6e 4d 65 6d 2a 73 69 7a 65 6f 66 28    + nMem*sizeof(
4ff0: 4d 65 6d 29 20 20 20 20 20 20 20 20 20 20 20 20  Mem)            
5000: 20 20 20 2f 2a 20 61 4d 65 6d 20 2a 2f 0a 20 20     /* aMem */.  
5010: 20 20 20 20 2b 20 6e 43 75 72 73 6f 72 2a 73 69      + nCursor*si
5020: 7a 65 6f 66 28 43 75 72 73 6f 72 2a 29 20 20 20  zeof(Cursor*)   
5030: 20 20 20 20 20 2f 2a 20 61 70 43 73 72 20 2a 2f       /* apCsr */
5040: 0a 20 20 20 20 20 20 2b 20 6e 41 67 67 2a 73 69  .      + nAgg*si
5050: 7a 65 6f 66 28 41 67 67 29 20 20 20 20 20 20 20  zeof(Agg)       
5060: 20 20 20 20 20 20 20 20 2f 2a 20 41 67 67 72 65          /* Aggre
5070: 67 61 74 65 20 63 6f 6e 74 65 78 74 73 20 2a 2f  gate contexts */
5080: 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66 28 20  .    );.    if( 
5090: 21 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f  !sqlite3_malloc_
50a0: 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 20 20  failed ){.      
50b0: 70 2d 3e 61 4d 65 6d 20 3d 20 26 70 2d 3e 61 53  p->aMem = &p->aS
50c0: 74 61 63 6b 5b 6e 53 74 61 63 6b 5d 3b 0a 20 20  tack[nStack];.  
50d0: 20 20 20 20 70 2d 3e 6e 4d 65 6d 20 3d 20 6e 4d      p->nMem = nM
50e0: 65 6d 3b 0a 20 20 20 20 20 20 70 2d 3e 61 56 61  em;.      p->aVa
50f0: 72 20 3d 20 26 70 2d 3e 61 4d 65 6d 5b 6e 4d 65  r = &p->aMem[nMe
5100: 6d 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 56 61  m];.      p->nVa
5110: 72 20 3d 20 6e 56 61 72 3b 0a 20 20 20 20 20 20  r = nVar;.      
5120: 70 2d 3e 6f 6b 56 61 72 20 3d 20 30 3b 0a 20 20  p->okVar = 0;.  
5130: 20 20 20 20 70 2d 3e 61 70 41 72 67 20 3d 20 28      p->apArg = (
5140: 4d 65 6d 2a 2a 29 26 70 2d 3e 61 56 61 72 5b 6e  Mem**)&p->aVar[n
5150: 56 61 72 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 61  Var];.      p->a
5160: 7a 56 61 72 20 3d 20 28 63 68 61 72 2a 2a 29 26  zVar = (char**)&
5170: 70 2d 3e 61 70 41 72 67 5b 6e 41 72 67 5d 3b 0a  p->apArg[nArg];.
5180: 20 20 20 20 20 20 70 2d 3e 61 70 43 73 72 20 3d        p->apCsr =
5190: 20 28 43 75 72 73 6f 72 2a 2a 29 26 70 2d 3e 61   (Cursor**)&p->a
51a0: 7a 56 61 72 5b 6e 56 61 72 5d 3b 0a 20 20 20 20  zVar[nVar];.    
51b0: 20 20 69 66 28 20 6e 41 67 67 3e 30 20 29 7b 0a    if( nAgg>0 ){.
51c0: 20 20 20 20 20 20 20 20 70 2d 3e 6e 41 67 67 20          p->nAgg 
51d0: 3d 20 6e 41 67 67 3b 0a 20 20 20 20 20 20 20 20  = nAgg;.        
51e0: 70 2d 3e 61 70 41 67 67 20 3d 20 28 41 67 67 2a  p->apAgg = (Agg*
51f0: 29 26 70 2d 3e 61 70 43 73 72 5b 6e 43 75 72 73  )&p->apCsr[nCurs
5200: 6f 72 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  or];.      }.   
5210: 20 20 20 70 2d 3e 6e 43 75 72 73 6f 72 20 3d 20     p->nCursor = 
5220: 6e 43 75 72 73 6f 72 3b 0a 20 20 20 20 20 20 66  nCursor;.      f
5230: 6f 72 28 6e 3d 30 3b 20 6e 3c 6e 56 61 72 3b 20  or(n=0; n<nVar; 
5240: 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 2d  n++){.        p-
5250: 3e 61 56 61 72 5b 6e 5d 2e 66 6c 61 67 73 20 3d  >aVar[n].flags =
5260: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20   MEM_Null;.     
5270: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 70   }.    }.  }.  p
5280: 2d 3e 70 41 67 67 20 3d 20 70 2d 3e 61 70 41 67  ->pAgg = p->apAg
5290: 67 3b 0a 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c  g;.  for(n=0; n<
52a0: 70 2d 3e 6e 4d 65 6d 3b 20 6e 2b 2b 29 7b 0a 20  p->nMem; n++){. 
52b0: 20 20 20 70 2d 3e 61 4d 65 6d 5b 6e 5d 2e 66 6c     p->aMem[n].fl
52c0: 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a  ags = MEM_Null;.
52d0: 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49    }..#ifdef SQLI
52e0: 54 45 5f 44 45 42 55 47 0a 20 20 69 66 28 20 28  TE_DEBUG.  if( (
52f0: 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  p->db->flags & S
5300: 51 4c 49 54 45 5f 56 64 62 65 4c 69 73 74 69 6e  QLITE_VdbeListin
5310: 67 29 21 3d 30 0a 20 20 20 20 7c 7c 20 73 71 6c  g)!=0.    || sql
5320: 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73  ite3OsFileExists
5330: 28 22 76 64 62 65 5f 65 78 70 6c 61 69 6e 22 29  ("vdbe_explain")
5340: 0a 20 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b  .  ){.    int i;
5350: 0a 20 20 20 20 70 72 69 6e 74 66 28 22 56 44 42  .    printf("VDB
5360: 45 20 50 72 6f 67 72 61 6d 20 4c 69 73 74 69 6e  E Program Listin
5370: 67 3a 5c 6e 22 29 3b 0a 20 20 20 20 73 71 6c 69  g:\n");.    sqli
5380: 74 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c 28  te3VdbePrintSql(
5390: 70 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b  p);.    for(i=0;
53a0: 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b   i<p->nOp; i++){
53b0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
53c0: 62 65 50 72 69 6e 74 4f 70 28 73 74 64 6f 75 74  bePrintOp(stdout
53d0: 2c 20 69 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29  , i, &p->aOp[i])
53e0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66  ;.    }.  }.  if
53f0: 28 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45  ( sqlite3OsFileE
5400: 78 69 73 74 73 28 22 76 64 62 65 5f 74 72 61 63  xists("vdbe_trac
5410: 65 22 29 20 29 7b 0a 20 20 20 20 70 2d 3e 74 72  e") ){.    p->tr
5420: 61 63 65 20 3d 20 73 74 64 6f 75 74 3b 0a 20 20  ace = stdout;.  
5430: 7d 0a 23 65 6e 64 69 66 0a 20 20 70 2d 3e 70 54  }.#endif.  p->pT
5440: 6f 73 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b  os = &p->aStack[
5450: 2d 31 5d 3b 0a 20 20 70 2d 3e 70 63 20 3d 20 2d  -1];.  p->pc = -
5460: 31 3b 0a 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c  1;.  p->rc = SQL
5470: 49 54 45 5f 4f 4b 3b 0a 20 20 70 2d 3e 75 6e 69  ITE_OK;.  p->uni
5480: 71 75 65 43 6e 74 20 3d 20 30 3b 0a 20 20 70 2d  queCnt = 0;.  p-
5490: 3e 72 65 74 75 72 6e 44 65 70 74 68 20 3d 20 30  >returnDepth = 0
54a0: 3b 0a 20 20 70 2d 3e 65 72 72 6f 72 41 63 74 69  ;.  p->errorActi
54b0: 6f 6e 20 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20  on = OE_Abort;. 
54c0: 20 70 2d 3e 70 6f 70 53 74 61 63 6b 20 3d 20 20   p->popStack =  
54d0: 30 3b 0a 20 20 70 2d 3e 65 78 70 6c 61 69 6e 20  0;.  p->explain 
54e0: 7c 3d 20 69 73 45 78 70 6c 61 69 6e 3b 0a 20 20  |= isExplain;.  
54f0: 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f  p->magic = VDBE_
5500: 4d 41 47 49 43 5f 52 55 4e 3b 0a 20 20 70 2d 3e  MAGIC_RUN;.  p->
5510: 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 23 69 66  nChange = 0;.#if
5520: 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45  def VDBE_PROFILE
5530: 0a 20 20 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a  .  {.    int i;.
5540: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
5550: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nOp; i++){.   
5560: 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74     p->aOp[i].cnt
5570: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d 3e 61   = 0;.      p->a
5580: 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 20 3d 20 30  Op[i].cycles = 0
5590: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64  ;.    }.  }.#end
55a0: 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d  if.}.../*.** Rem
55b0: 6f 76 65 20 61 6e 79 20 65 6c 65 6d 65 6e 74 73  ove any elements
55c0: 20 74 68 61 74 20 72 65 6d 61 69 6e 20 6f 6e 20   that remain on 
55d0: 74 68 65 20 73 6f 72 74 65 72 20 66 6f 72 20 74  the sorter for t
55e0: 68 65 20 56 44 42 45 20 67 69 76 65 6e 2e 0a 2a  he VDBE given..*
55f0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
5600: 62 65 53 6f 72 74 65 72 52 65 73 65 74 28 56 64  beSorterReset(Vd
5610: 62 65 20 2a 70 29 7b 0a 20 20 77 68 69 6c 65 28  be *p){.  while(
5620: 20 70 2d 3e 70 53 6f 72 74 20 29 7b 0a 20 20 20   p->pSort ){.   
5630: 20 53 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72   Sorter *pSorter
5640: 20 3d 20 70 2d 3e 70 53 6f 72 74 3b 0a 20 20 20   = p->pSort;.   
5650: 20 70 2d 3e 70 53 6f 72 74 20 3d 20 70 53 6f 72   p->pSort = pSor
5660: 74 65 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  ter->pNext;.    
5670: 73 71 6c 69 74 65 46 72 65 65 28 70 53 6f 72 74  sqliteFree(pSort
5680: 65 72 2d 3e 7a 4b 65 79 29 3b 0a 20 20 20 20 73  er->zKey);.    s
5690: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
56a0: 65 61 73 65 28 26 70 53 6f 72 74 65 72 2d 3e 64  ease(&pSorter->d
56b0: 61 74 61 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  ata);.    sqlite
56c0: 46 72 65 65 28 70 53 6f 72 74 65 72 29 3b 0a 20  Free(pSorter);. 
56d0: 20 7d 0a 20 20 70 2d 3e 70 53 6f 72 74 54 61 69   }.  p->pSortTai
56e0: 6c 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  l = 0;.}../*.** 
56f0: 46 72 65 65 20 61 6c 6c 20 72 65 73 6f 75 72 63  Free all resourc
5700: 65 73 20 61 6c 6c 6f 63 69 61 74 65 64 20 77 69  es allociated wi
5710: 74 68 20 41 67 67 45 6c 65 6d 20 70 45 6c 65 6d  th AggElem pElem
5720: 2c 20 61 6e 20 65 6c 65 6d 65 6e 74 20 6f 66 0a  , an element of.
5730: 2a 2a 20 61 67 67 72 65 67 61 74 65 20 70 41 67  ** aggregate pAg
5740: 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  g..*/.static voi
5750: 64 20 66 72 65 65 41 67 67 45 6c 65 6d 28 41 67  d freeAggElem(Ag
5760: 67 45 6c 65 6d 20 2a 70 45 6c 65 6d 2c 20 41 67  gElem *pElem, Ag
5770: 67 20 2a 70 41 67 67 29 7b 0a 20 20 69 6e 74 20  g *pAgg){.  int 
5780: 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  i;.  for(i=0; i<
5790: 70 41 67 67 2d 3e 6e 4d 65 6d 3b 20 69 2b 2b 29  pAgg->nMem; i++)
57a0: 7b 0a 20 20 20 20 4d 65 6d 20 2a 70 4d 65 6d 20  {.    Mem *pMem 
57b0: 3d 20 26 70 45 6c 65 6d 2d 3e 61 4d 65 6d 5b 69  = &pElem->aMem[i
57c0: 5d 3b 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d  ];.    if( pAgg-
57d0: 3e 61 70 46 75 6e 63 20 26 26 20 70 41 67 67 2d  >apFunc && pAgg-
57e0: 3e 61 70 46 75 6e 63 5b 69 5d 20 26 26 20 28 70  >apFunc[i] && (p
57f0: 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d  Mem->flags & MEM
5800: 5f 41 67 67 43 74 78 29 21 3d 30 20 29 7b 0a 20  _AggCtx)!=0 ){. 
5810: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e       sqlite3_con
5820: 74 65 78 74 20 63 74 78 3b 0a 20 20 20 20 20 20  text ctx;.      
5830: 63 74 78 2e 70 46 75 6e 63 20 3d 20 70 41 67 67  ctx.pFunc = pAgg
5840: 2d 3e 61 70 46 75 6e 63 5b 69 5d 3b 0a 20 20 20  ->apFunc[i];.   
5850: 20 20 20 63 74 78 2e 73 2e 66 6c 61 67 73 20 3d     ctx.s.flags =
5860: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20   MEM_Null;.     
5870: 20 63 74 78 2e 70 41 67 67 20 3d 20 70 4d 65 6d   ctx.pAgg = pMem
5880: 2d 3e 7a 3b 0a 20 20 20 20 20 20 63 74 78 2e 63  ->z;.      ctx.c
5890: 6e 74 20 3d 20 70 4d 65 6d 2d 3e 69 3b 0a 20 20  nt = pMem->i;.  
58a0: 20 20 20 20 63 74 78 2e 69 73 45 72 72 6f 72 20      ctx.isError 
58b0: 3d 20 30 3b 0a 20 20 20 20 20 20 28 2a 63 74 78  = 0;.      (*ctx
58c0: 2e 70 46 75 6e 63 2d 3e 78 46 69 6e 61 6c 69 7a  .pFunc->xFinaliz
58d0: 65 29 28 26 63 74 78 29 3b 0a 20 20 20 20 20 20  e)(&ctx);.      
58e0: 70 4d 65 6d 2d 3e 7a 20 3d 20 63 74 78 2e 70 41  pMem->z = ctx.pA
58f0: 67 67 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4d  gg;.      if( pM
5900: 65 6d 2d 3e 7a 21 3d 30 20 26 26 20 70 4d 65 6d  em->z!=0 && pMem
5910: 2d 3e 7a 21 3d 70 4d 65 6d 2d 3e 7a 53 68 6f 72  ->z!=pMem->zShor
5920: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  t ){.        sql
5930: 69 74 65 46 72 65 65 28 70 4d 65 6d 2d 3e 7a 29  iteFree(pMem->z)
5940: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
5950: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
5960: 6c 65 61 73 65 28 26 63 74 78 2e 73 29 3b 0a 20  lease(&ctx.s);. 
5970: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
5980: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
5990: 6c 65 61 73 65 28 70 4d 65 6d 29 3b 0a 20 20 20  lease(pMem);.   
59a0: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46   }.  }.  sqliteF
59b0: 72 65 65 28 70 45 6c 65 6d 29 3b 0a 7d 0a 0a 2f  ree(pElem);.}../
59c0: 2a 0a 2a 2a 20 52 65 73 65 74 20 61 6e 20 41 67  *.** Reset an Ag
59d0: 67 20 73 74 72 75 63 74 75 72 65 2e 20 20 44 65  g structure.  De
59e0: 6c 65 74 65 20 61 6c 6c 20 69 74 73 20 63 6f 6e  lete all its con
59f0: 74 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72  tents..**.** For
5a00: 20 69 6e 73 74 61 6c 6c 61 62 6c 65 20 61 67 67   installable agg
5a10: 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73  regate functions
5a20: 2c 20 69 66 20 74 68 65 20 73 74 65 70 20 66 75  , if the step fu
5a30: 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e 0a  nction has been.
5a40: 2a 2a 20 63 61 6c 6c 65 64 2c 20 6d 61 6b 65 20  ** called, make 
5a50: 73 75 72 65 20 74 68 65 20 66 69 6e 61 6c 69 7a  sure the finaliz
5a60: 65 72 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20  er function has 
5a70: 61 6c 73 6f 20 62 65 65 6e 20 63 61 6c 6c 65 64  also been called
5a80: 2e 20 20 54 68 65 0a 2a 2a 20 66 69 6e 61 6c 69  .  The.** finali
5a90: 7a 65 72 20 6d 69 67 68 74 20 6e 65 65 64 20 74  zer might need t
5aa0: 6f 20 66 72 65 65 20 6d 65 6d 6f 72 79 20 74 68  o free memory th
5ab0: 61 74 20 77 61 73 20 61 6c 6c 6f 63 61 74 65 64  at was allocated
5ac0: 20 61 73 20 70 61 72 74 20 6f 66 20 69 74 73 0a   as part of its.
5ad0: 2a 2a 20 70 72 69 76 61 74 65 20 63 6f 6e 74 65  ** private conte
5ae0: 78 74 2e 20 20 49 66 20 74 68 65 20 66 69 6e 61  xt.  If the fina
5af0: 6c 69 7a 65 72 20 68 61 73 20 6e 6f 74 20 62 65  lizer has not be
5b00: 65 6e 20 63 61 6c 6c 65 64 20 79 65 74 2c 20 63  en called yet, c
5b10: 61 6c 6c 20 69 74 0a 2a 2a 20 6e 6f 77 2e 0a 2a  all it.** now..*
5b20: 2a 0a 2a 2a 20 49 66 20 64 62 20 69 73 20 4e 55  *.** If db is NU
5b30: 4c 4c 2c 20 74 68 65 6e 20 74 68 69 73 20 69 73  LL, then this is
5b40: 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 20 66 72   being called fr
5b50: 6f 6d 20 73 71 6c 69 74 65 56 64 62 65 52 65 73  om sqliteVdbeRes
5b60: 65 74 28 29 2e 20 49 6e 0a 2a 2a 20 74 68 69 73  et(). In.** this
5b70: 20 63 61 73 65 20 63 6c 65 61 6e 20 75 70 20 61   case clean up a
5b80: 6c 6c 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f  ll references to
5b90: 20 74 68 65 20 74 65 6d 70 2d 74 61 62 6c 65 20   the temp-table 
5ba0: 75 73 65 64 20 66 6f 72 0a 2a 2a 20 61 67 67 72  used for.** aggr
5bb0: 65 67 61 74 65 73 20 28 69 66 20 69 74 20 77 61  egates (if it wa
5bc0: 73 20 65 76 65 72 20 6f 70 65 6e 65 64 29 2e 0a  s ever opened)..
5bd0: 2a 2a 0a 2a 2a 20 49 66 20 64 62 20 69 73 20 6e  **.** If db is n
5be0: 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68  ot NULL, then th
5bf0: 69 73 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c  is is being call
5c00: 65 64 20 66 72 6f 6d 20 77 69 74 68 20 61 6e 20  ed from with an 
5c10: 4f 50 5f 41 67 67 52 65 73 65 74 0a 2a 2a 20 6f  OP_AggReset.** o
5c20: 70 63 6f 64 65 2e 20 4f 70 65 6e 20 74 68 65 20  pcode. Open the 
5c30: 74 65 6d 70 2d 74 61 62 6c 65 2c 20 69 66 20 69  temp-table, if i
5c40: 74 20 68 61 73 20 6e 6f 74 20 61 6c 72 65 61 64  t has not alread
5c50: 79 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 61 6e  y been opened an
5c60: 64 0a 2a 2a 20 64 65 6c 65 74 65 20 74 68 65 20  d.** delete the 
5c70: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20  contents of the 
5c80: 74 61 62 6c 65 20 75 73 65 64 20 66 6f 72 20 61  table used for a
5c90: 67 67 72 65 67 61 74 65 20 69 6e 66 6f 72 6d 61  ggregate informa
5ca0: 74 69 6f 6e 2c 20 72 65 61 64 79 0a 2a 2a 20 66  tion, ready.** f
5cb0: 6f 72 20 74 68 65 20 6e 65 78 74 20 72 6f 75 6e  or the next roun
5cc0: 64 20 6f 66 20 61 67 67 72 65 67 61 74 65 20 70  d of aggregate p
5cd0: 72 6f 63 65 73 73 69 6e 67 2e 0a 2a 2f 0a 69 6e  rocessing..*/.in
5ce0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 41 67 67  t sqlite3VdbeAgg
5cf0: 52 65 73 65 74 28 73 71 6c 69 74 65 33 20 2a 64  Reset(sqlite3 *d
5d00: 62 2c 20 41 67 67 20 2a 70 41 67 67 2c 20 4b 65  b, Agg *pAgg, Ke
5d10: 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 29  yInfo *pKeyInfo)
5d20: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a  {.  int rc = 0;.
5d30: 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 73 72    BtCursor *pCsr
5d40: 3b 0a 0a 20 20 69 66 28 20 21 70 41 67 67 20 29  ;..  if( !pAgg )
5d50: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
5d60: 4b 3b 0a 20 20 70 43 73 72 20 3d 20 70 41 67 67  K;.  pCsr = pAgg
5d70: 2d 3e 70 43 73 72 3b 0a 20 20 61 73 73 65 72 74  ->pCsr;.  assert
5d80: 28 20 28 70 43 73 72 20 26 26 20 70 41 67 67 2d  ( (pCsr && pAgg-
5d90: 3e 6e 54 61 62 3e 30 29 20 7c 7c 20 28 21 70 43  >nTab>0) || (!pC
5da0: 73 72 20 26 26 20 70 41 67 67 2d 3e 6e 54 61 62  sr && pAgg->nTab
5db0: 3d 3d 30 29 0a 20 20 20 20 20 20 20 20 20 7c 7c  ==0).         ||
5dc0: 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f   sqlite3_malloc_
5dd0: 66 61 69 6c 65 64 20 29 3b 0a 0a 20 20 2f 2a 20  failed );..  /* 
5de0: 49 66 20 70 43 73 72 20 69 73 20 6e 6f 74 20 4e  If pCsr is not N
5df0: 55 4c 4c 2c 20 74 68 65 6e 20 74 68 65 20 74 61  ULL, then the ta
5e00: 62 6c 65 20 75 73 65 64 20 66 6f 72 20 61 67 67  ble used for agg
5e10: 72 65 67 61 74 65 20 69 6e 66 6f 72 6d 61 74 69  regate informati
5e20: 6f 6e 0a 20 20 2a 2a 20 69 73 20 6f 70 65 6e 2e  on.  ** is open.
5e30: 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 69 74   Loop through it
5e40: 20 61 6e 64 20 66 72 65 65 20 74 68 65 20 41 67   and free the Ag
5e50: 67 45 6c 65 6d 2a 20 73 74 72 75 63 74 75 72 65  gElem* structure
5e60: 20 70 6f 69 6e 74 65 64 20 61 74 0a 20 20 2a 2a   pointed at.  **
5e70: 20 62 79 20 65 61 63 68 20 65 6e 74 72 79 2e 20   by each entry. 
5e80: 49 66 20 74 68 65 20 66 69 6e 61 6c 69 7a 65 72  If the finalizer
5e90: 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 63 61   has not been ca
5ea0: 6c 6c 65 64 20 66 6f 72 20 61 6e 20 41 67 67 45  lled for an AggE
5eb0: 6c 65 6d 2c 0a 20 20 2a 2a 20 64 6f 20 74 68 61  lem,.  ** do tha
5ec0: 74 20 74 6f 6f 2e 20 46 69 6e 61 6c 6c 79 2c 20  t too. Finally, 
5ed0: 63 6c 65 61 72 20 74 68 65 20 62 74 72 65 65 20  clear the btree 
5ee0: 74 61 62 6c 65 20 69 74 73 65 6c 66 2e 0a 20 20  table itself..  
5ef0: 2a 2f 0a 20 20 69 66 28 20 70 43 73 72 20 29 7b  */.  if( pCsr ){
5f00: 0a 20 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20  .    int res;.  
5f10: 20 20 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e    assert( pAgg->
5f20: 70 42 74 72 65 65 20 29 3b 0a 20 20 20 20 61 73  pBtree );.    as
5f30: 73 65 72 74 28 20 70 41 67 67 2d 3e 6e 54 61 62  sert( pAgg->nTab
5f40: 3e 30 20 29 3b 0a 0a 20 20 20 20 72 63 3d 73 71  >0 );..    rc=sq
5f50: 6c 69 74 65 33 42 74 72 65 65 46 69 72 73 74 28  lite3BtreeFirst(
5f60: 70 43 73 72 2c 20 26 72 65 73 29 3b 0a 20 20 20  pCsr, &res);.   
5f70: 20 77 68 69 6c 65 28 20 72 65 73 3d 3d 30 20 26   while( res==0 &
5f80: 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  & rc==SQLITE_OK 
5f90: 29 7b 0a 20 20 20 20 20 20 41 67 67 45 6c 65 6d  ){.      AggElem
5fa0: 20 2a 70 45 6c 65 6d 3b 0a 20 20 20 20 20 20 72   *pElem;.      r
5fb0: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
5fc0: 44 61 74 61 28 70 43 73 72 2c 20 30 2c 20 73 69  Data(pCsr, 0, si
5fd0: 7a 65 6f 66 28 41 67 67 45 6c 65 6d 2a 29 2c 20  zeof(AggElem*), 
5fe0: 28 63 68 61 72 20 2a 29 26 70 45 6c 65 6d 29 3b  (char *)&pElem);
5ff0: 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53  .      if( rc!=S
6000: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
6010: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
6020: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73       }.      ass
6030: 65 72 74 28 20 70 41 67 67 2d 3e 61 70 46 75 6e  ert( pAgg->apFun
6040: 63 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 66 72  c!=0 );.      fr
6050: 65 65 41 67 67 45 6c 65 6d 28 70 45 6c 65 6d 2c  eeAggElem(pElem,
6060: 20 70 41 67 67 29 3b 0a 20 20 20 20 20 20 72 63   pAgg);.      rc
6070: 3d 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78  =sqlite3BtreeNex
6080: 74 28 70 43 73 72 2c 20 26 72 65 73 29 3b 0a 20  t(pCsr, &res);. 
6090: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 21     }.    if( rc!
60a0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
60b0: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
60c0: 20 20 20 7d 0a 0a 20 20 20 20 73 71 6c 69 74 65     }..    sqlite
60d0: 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f  3BtreeCloseCurso
60e0: 72 28 70 43 73 72 29 3b 0a 20 20 20 20 73 71 6c  r(pCsr);.    sql
60f0: 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 54 61  ite3BtreeClearTa
6100: 62 6c 65 28 70 41 67 67 2d 3e 70 42 74 72 65 65  ble(pAgg->pBtree
6110: 2c 20 70 41 67 67 2d 3e 6e 54 61 62 29 3b 0a 20  , pAgg->nTab);. 
6120: 20 7d 65 6c 73 65 7b 20 0a 20 20 20 20 2f 2a 20   }else{ .    /* 
6130: 54 68 65 20 63 75 72 73 6f 72 20 6d 61 79 20 6e  The cursor may n
6140: 6f 74 20 62 65 20 6f 70 65 6e 20 62 65 63 61 75  ot be open becau
6150: 73 65 20 74 68 65 20 61 67 67 72 65 67 61 74 6f  se the aggregato
6160: 72 20 77 61 73 20 6e 65 76 65 72 20 75 73 65 64  r was never used
6170: 2c 0a 20 20 20 20 2a 2a 20 6f 72 20 69 74 20 63  ,.    ** or it c
6180: 6f 75 6c 64 20 62 65 20 74 68 61 74 20 69 74 20  ould be that it 
6190: 77 61 73 20 75 73 65 64 20 62 75 74 20 74 68 65  was used but the
61a0: 72 65 20 77 61 73 20 6e 6f 20 47 52 4f 55 50 20  re was no GROUP 
61b0: 42 59 20 63 6c 61 75 73 65 2e 0a 20 20 20 20 2a  BY clause..    *
61c0: 2f 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d 3e  /.    if( pAgg->
61d0: 70 43 75 72 72 65 6e 74 20 29 7b 0a 20 20 20 20  pCurrent ){.    
61e0: 20 20 66 72 65 65 41 67 67 45 6c 65 6d 28 70 41    freeAggElem(pA
61f0: 67 67 2d 3e 70 43 75 72 72 65 6e 74 2c 20 70 41  gg->pCurrent, pA
6200: 67 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  gg);.    }.  }..
6210: 20 20 2f 2a 20 49 66 20 64 62 20 69 73 20 6e 6f    /* If db is no
6220: 74 20 4e 55 4c 4c 20 61 6e 64 20 77 65 20 68 61  t NULL and we ha
6230: 76 65 20 6e 6f 74 20 79 65 74 20 61 6e 64 20 77  ve not yet and w
6240: 65 20 68 61 76 65 20 6e 6f 74 20 79 65 74 20 6f  e have not yet o
6250: 70 65 6e 65 64 0a 20 20 2a 2a 20 74 68 65 20 74  pened.  ** the t
6260: 65 6d 70 6f 72 61 72 79 20 62 74 72 65 65 20 74  emporary btree t
6270: 68 65 6e 20 64 6f 20 73 6f 20 61 6e 64 20 63 72  hen do so and cr
6280: 65 61 74 65 20 74 68 65 20 74 61 62 6c 65 20 74  eate the table t
6290: 6f 20 73 74 6f 72 65 20 61 67 67 72 65 67 61 74  o store aggregat
62a0: 65 0a 20 20 2a 2a 20 69 6e 66 6f 72 6d 61 74 69  e.  ** informati
62b0: 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66  on..  **.  ** If
62c0: 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65   db is NULL, the
62d0: 6e 20 63 6c 6f 73 65 20 74 68 65 20 74 65 6d 70  n close the temp
62e0: 6f 72 61 72 79 20 62 74 72 65 65 20 69 66 20 69  orary btree if i
62f0: 74 20 69 73 20 6f 70 65 6e 2e 0a 20 20 2a 2f 0a  t is open..  */.
6300: 20 20 69 66 28 20 64 62 20 29 7b 0a 20 20 20 20    if( db ){.    
6310: 69 66 28 20 21 70 41 67 67 2d 3e 70 42 74 72 65  if( !pAgg->pBtre
6320: 65 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72  e ){.      asser
6330: 74 28 20 70 41 67 67 2d 3e 6e 54 61 62 3d 3d 30  t( pAgg->nTab==0
6340: 20 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49   );.#ifndef SQLI
6350: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42  TE_OMIT_MEMORYDB
6360: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
6370: 74 65 33 42 74 72 65 65 46 61 63 74 6f 72 79 28  te3BtreeFactory(
6380: 64 62 2c 20 22 3a 6d 65 6d 6f 72 79 3a 22 2c 20  db, ":memory:", 
6390: 30 2c 20 54 45 4d 50 5f 50 41 47 45 53 2c 20 26  0, TEMP_PAGES, &
63a0: 70 41 67 67 2d 3e 70 42 74 72 65 65 29 3b 0a 23  pAgg->pBtree);.#
63b0: 65 6c 73 65 0a 20 20 20 20 20 20 72 63 20 3d 20  else.      rc = 
63c0: 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74  sqlite3BtreeFact
63d0: 6f 72 79 28 64 62 2c 20 30 2c 20 30 2c 20 54 45  ory(db, 0, 0, TE
63e0: 4d 50 5f 50 41 47 45 53 2c 20 26 70 41 67 67 2d  MP_PAGES, &pAgg-
63f0: 3e 70 42 74 72 65 65 29 3b 0a 23 65 6e 64 69 66  >pBtree);.#endif
6400: 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53  .      if( rc!=S
6410: 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72  QLITE_OK ) retur
6420: 6e 20 72 63 3b 0a 20 20 20 20 20 20 73 71 6c 69  n rc;.      sqli
6430: 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 72 61  te3BtreeBeginTra
6440: 6e 73 28 70 41 67 67 2d 3e 70 42 74 72 65 65 2c  ns(pAgg->pBtree,
6450: 20 31 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20   1);.      rc = 
6460: 73 71 6c 69 74 65 33 42 74 72 65 65 43 72 65 61  sqlite3BtreeCrea
6470: 74 65 54 61 62 6c 65 28 70 41 67 67 2d 3e 70 42  teTable(pAgg->pB
6480: 74 72 65 65 2c 20 26 70 41 67 67 2d 3e 6e 54 61  tree, &pAgg->nTa
6490: 62 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28  b, 0);.      if(
64a0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
64b0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
64c0: 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 41  }.    assert( pA
64d0: 67 67 2d 3e 6e 54 61 62 21 3d 30 20 29 3b 0a 0a  gg->nTab!=0 );..
64e0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
64f0: 42 74 72 65 65 43 75 72 73 6f 72 28 70 41 67 67  BtreeCursor(pAgg
6500: 2d 3e 70 42 74 72 65 65 2c 20 70 41 67 67 2d 3e  ->pBtree, pAgg->
6510: 6e 54 61 62 2c 20 31 2c 0a 20 20 20 20 20 20 20  nTab, 1,.       
6520: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
6530: 72 64 43 6f 6d 70 61 72 65 2c 20 70 4b 65 79 49  rdCompare, pKeyI
6540: 6e 66 6f 2c 20 26 70 41 67 67 2d 3e 70 43 73 72  nfo, &pAgg->pCsr
6550: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53  );.    if( rc!=S
6560: 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72  QLITE_OK ) retur
6570: 6e 20 72 63 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  n rc;.  }else{. 
6580: 20 20 20 69 66 28 20 70 41 67 67 2d 3e 70 42 74     if( pAgg->pBt
6590: 72 65 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  ree ){.      sql
65a0: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70  ite3BtreeClose(p
65b0: 41 67 67 2d 3e 70 42 74 72 65 65 29 3b 0a 20 20  Agg->pBtree);.  
65c0: 20 20 20 20 70 41 67 67 2d 3e 70 42 74 72 65 65      pAgg->pBtree
65d0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 41 67 67   = 0;.      pAgg
65e0: 2d 3e 6e 54 61 62 20 3d 20 30 3b 0a 20 20 20 20  ->nTab = 0;.    
65f0: 7d 0a 20 20 20 20 70 41 67 67 2d 3e 70 43 73 72  }.    pAgg->pCsr
6600: 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 69 66 28   = 0;.  }..  if(
6610: 20 70 41 67 67 2d 3e 61 70 46 75 6e 63 20 29 7b   pAgg->apFunc ){
6620: 20 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65   .    sqliteFree
6630: 28 70 41 67 67 2d 3e 61 70 46 75 6e 63 29 3b 0a  (pAgg->apFunc);.
6640: 20 20 20 20 70 41 67 67 2d 3e 61 70 46 75 6e 63      pAgg->apFunc
6650: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 41 67 67   = 0;.  }.  pAgg
6660: 2d 3e 70 43 75 72 72 65 6e 74 20 3d 20 30 3b 0a  ->pCurrent = 0;.
6670: 20 20 70 41 67 67 2d 3e 6e 4d 65 6d 20 3d 20 30    pAgg->nMem = 0
6680: 3b 0a 20 20 70 41 67 67 2d 3e 73 65 61 72 63 68  ;.  pAgg->search
6690: 69 6e 67 20 3d 20 30 3b 0a 20 20 72 65 74 75 72  ing = 0;.  retur
66a0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
66b0: 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 75  /*.** Close a cu
66c0: 72 73 6f 72 20 61 6e 64 20 72 65 6c 65 61 73 65  rsor and release
66d0: 20 61 6c 6c 20 74 68 65 20 72 65 73 6f 75 72 63   all the resourc
66e0: 65 73 20 74 68 61 74 20 63 75 72 73 6f 72 20 68  es that cursor h
66f0: 61 70 70 65 6e 73 0a 2a 2a 20 74 6f 20 68 6f 6c  appens.** to hol
6700: 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  d..*/.void sqlit
6710: 65 33 56 64 62 65 46 72 65 65 43 75 72 73 6f 72  e3VdbeFreeCursor
6720: 28 43 75 72 73 6f 72 20 2a 70 43 78 29 7b 0a 20  (Cursor *pCx){. 
6730: 20 69 66 28 20 70 43 78 3d 3d 30 20 29 7b 0a 20   if( pCx==0 ){. 
6740: 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20     return;.  }. 
6750: 20 69 66 28 20 70 43 78 2d 3e 70 43 75 72 73 6f   if( pCx->pCurso
6760: 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  r ){.    sqlite3
6770: 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72  BtreeCloseCursor
6780: 28 70 43 78 2d 3e 70 43 75 72 73 6f 72 29 3b 0a  (pCx->pCursor);.
6790: 20 20 7d 0a 20 20 69 66 28 20 70 43 78 2d 3e 70    }.  if( pCx->p
67a0: 42 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  Bt ){.    sqlite
67b0: 33 42 74 72 65 65 43 6c 6f 73 65 28 70 43 78 2d  3BtreeClose(pCx-
67c0: 3e 70 42 74 29 3b 0a 20 20 7d 0a 20 20 73 71 6c  >pBt);.  }.  sql
67d0: 69 74 65 46 72 65 65 28 70 43 78 2d 3e 70 44 61  iteFree(pCx->pDa
67e0: 74 61 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65  ta);.  sqliteFre
67f0: 65 28 70 43 78 2d 3e 61 54 79 70 65 29 3b 0a 20  e(pCx->aType);. 
6800: 20 73 71 6c 69 74 65 46 72 65 65 28 70 43 78 29   sqliteFree(pCx)
6810: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65  ;.}../*.** Close
6820: 20 61 6c 6c 20 63 75 72 73 6f 72 73 0a 2a 2f 0a   all cursors.*/.
6830: 73 74 61 74 69 63 20 76 6f 69 64 20 63 6c 6f 73  static void clos
6840: 65 41 6c 6c 43 75 72 73 6f 72 73 28 56 64 62 65  eAllCursors(Vdbe
6850: 20 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20   *p){.  int i;. 
6860: 20 69 66 28 20 70 2d 3e 61 70 43 73 72 3d 3d 30   if( p->apCsr==0
6870: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72   ) return;.  for
6880: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 43 75 72 73  (i=0; i<p->nCurs
6890: 6f 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71  or; i++){.    sq
68a0: 6c 69 74 65 33 56 64 62 65 46 72 65 65 43 75 72  lite3VdbeFreeCur
68b0: 73 6f 72 28 70 2d 3e 61 70 43 73 72 5b 69 5d 29  sor(p->apCsr[i])
68c0: 3b 0a 20 20 20 20 70 2d 3e 61 70 43 73 72 5b 69  ;.    p->apCsr[i
68d0: 5d 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  ] = 0;.  }.}../*
68e0: 0a 2a 2a 20 43 6c 65 61 6e 20 75 70 20 74 68 65  .** Clean up the
68f0: 20 56 4d 20 61 66 74 65 72 20 65 78 65 63 75 74   VM after execut
6900: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ion..**.** This 
6910: 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 75 74  routine will aut
6920: 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65  omatically close
6930: 20 61 6e 79 20 63 75 72 73 6f 72 73 2c 20 6c 69   any cursors, li
6940: 73 74 73 2c 20 61 6e 64 2f 6f 72 0a 2a 2a 20 73  sts, and/or.** s
6950: 6f 72 74 65 72 73 20 74 68 61 74 20 77 65 72 65  orters that were
6960: 20 6c 65 66 74 20 6f 70 65 6e 2e 20 20 49 74 20   left open.  It 
6970: 61 6c 73 6f 20 64 65 6c 65 74 65 73 20 74 68 65  also deletes the
6980: 20 76 61 6c 75 65 73 20 6f 66 0a 2a 2a 20 76 61   values of.** va
6990: 72 69 61 62 6c 65 73 20 69 6e 20 74 68 65 20 61  riables in the a
69a0: 56 61 72 5b 5d 20 61 72 72 61 79 2e 0a 2a 2f 0a  Var[] array..*/.
69b0: 73 74 61 74 69 63 20 76 6f 69 64 20 43 6c 65 61  static void Clea
69c0: 6e 75 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 20  nup(Vdbe *p){.  
69d0: 69 6e 74 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e  int i;.  if( p->
69e0: 61 53 74 61 63 6b 20 29 7b 0a 20 20 20 20 72 65  aStack ){.    re
69f0: 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d  leaseMemArray(p-
6a00: 3e 61 53 74 61 63 6b 2c 20 31 20 2b 20 28 70 2d  >aStack, 1 + (p-
6a10: 3e 70 54 6f 73 20 2d 20 70 2d 3e 61 53 74 61 63  >pTos - p->aStac
6a20: 6b 29 29 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73  k));.    p->pTos
6a30: 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b 2d 31   = &p->aStack[-1
6a40: 5d 3b 0a 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c  ];.  }.  closeAl
6a50: 6c 43 75 72 73 6f 72 73 28 70 29 3b 0a 20 20 72  lCursors(p);.  r
6a60: 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70  eleaseMemArray(p
6a70: 2d 3e 61 4d 65 6d 2c 20 70 2d 3e 6e 4d 65 6d 29  ->aMem, p->nMem)
6a80: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 46  ;.  sqlite3VdbeF
6a90: 69 66 6f 43 6c 65 61 72 28 26 70 2d 3e 73 46 69  ifoClear(&p->sFi
6aa0: 66 6f 29 3b 0a 20 20 69 66 28 20 70 2d 3e 63 6f  fo);.  if( p->co
6ab0: 6e 74 65 78 74 53 74 61 63 6b 20 29 7b 0a 20 20  ntextStack ){.  
6ac0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e    for(i=0; i<p->
6ad0: 63 6f 6e 74 65 78 74 53 74 61 63 6b 54 6f 70 3b  contextStackTop;
6ae0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 6c   i++){.      sql
6af0: 69 74 65 33 56 64 62 65 46 69 66 6f 43 6c 65 61  ite3VdbeFifoClea
6b00: 72 28 26 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61  r(&p->contextSta
6b10: 63 6b 5b 69 5d 2e 73 46 69 66 6f 29 3b 0a 20 20  ck[i].sFifo);.  
6b20: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 46 72    }.    sqliteFr
6b30: 65 65 28 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61  ee(p->contextSta
6b40: 63 6b 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  ck);.  }.  sqlit
6b50: 65 33 56 64 62 65 53 6f 72 74 65 72 52 65 73 65  e3VdbeSorterRese
6b60: 74 28 70 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b  t(p);.  for(i=0;
6b70: 20 69 3c 70 2d 3e 6e 41 67 67 3b 20 69 2b 2b 29   i<p->nAgg; i++)
6b80: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
6b90: 65 41 67 67 52 65 73 65 74 28 30 2c 20 26 70 2d  eAggReset(0, &p-
6ba0: 3e 61 70 41 67 67 5b 69 5d 2c 20 30 29 3b 0a 20  >apAgg[i], 0);. 
6bb0: 20 7d 0a 20 20 70 2d 3e 63 6f 6e 74 65 78 74 53   }.  p->contextS
6bc0: 74 61 63 6b 20 3d 20 30 3b 0a 20 20 70 2d 3e 63  tack = 0;.  p->c
6bd0: 6f 6e 74 65 78 74 53 74 61 63 6b 44 65 70 74 68  ontextStackDepth
6be0: 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65   = 0;.  p->conte
6bf0: 78 74 53 74 61 63 6b 54 6f 70 20 3d 20 30 3b 0a  xtStackTop = 0;.
6c00: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
6c10: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 70 2d 3e 7a  zErrMsg);.  p->z
6c20: 45 72 72 4d 73 67 20 3d 20 30 3b 0a 7d 0a 0a 2f  ErrMsg = 0;.}../
6c30: 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 6e 75 6d  *.** Set the num
6c40: 62 65 72 20 6f 66 20 72 65 73 75 6c 74 20 63 6f  ber of result co
6c50: 6c 75 6d 6e 73 20 74 68 61 74 20 77 69 6c 6c 20  lumns that will 
6c60: 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 74  be returned by t
6c70: 68 69 73 20 53 51 4c 0a 2a 2a 20 73 74 61 74 65  his SQL.** state
6c80: 6d 65 6e 74 2e 20 54 68 69 73 20 69 73 20 6e 6f  ment. This is no
6c90: 77 20 73 65 74 20 61 74 20 63 6f 6d 70 69 6c 65  w set at compile
6ca0: 20 74 69 6d 65 2c 20 72 61 74 68 65 72 20 74 68   time, rather th
6cb0: 61 6e 20 64 75 72 69 6e 67 0a 2a 2a 20 65 78 65  an during.** exe
6cc0: 63 75 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 64  cution of the vd
6cd0: 62 65 20 70 72 6f 67 72 61 6d 20 73 6f 20 74 68  be program so th
6ce0: 61 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  at sqlite3_colum
6cf0: 6e 5f 63 6f 75 6e 74 28 29 20 63 61 6e 0a 2a 2a  n_count() can.**
6d00: 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e 20 61 6e   be called on an
6d10: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 62   SQL statement b
6d20: 65 66 6f 72 65 20 73 71 6c 69 74 65 33 5f 73 74  efore sqlite3_st
6d30: 65 70 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  ep()..*/.void sq
6d40: 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d 43  lite3VdbeSetNumC
6d50: 6f 6c 73 28 56 64 62 65 20 2a 70 2c 20 69 6e 74  ols(Vdbe *p, int
6d60: 20 6e 52 65 73 43 6f 6c 75 6d 6e 29 7b 0a 20 20   nResColumn){.  
6d70: 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 20  Mem *pColName;. 
6d80: 20 69 6e 74 20 6e 3b 0a 20 20 61 73 73 65 72 74   int n;.  assert
6d90: 28 20 30 3d 3d 70 2d 3e 6e 52 65 73 43 6f 6c 75  ( 0==p->nResColu
6da0: 6d 6e 20 29 3b 0a 20 20 70 2d 3e 6e 52 65 73 43  mn );.  p->nResC
6db0: 6f 6c 75 6d 6e 20 3d 20 6e 52 65 73 43 6f 6c 75  olumn = nResColu
6dc0: 6d 6e 3b 0a 20 20 6e 20 3d 20 6e 52 65 73 43 6f  mn;.  n = nResCo
6dd0: 6c 75 6d 6e 2a 32 3b 0a 20 20 70 2d 3e 61 43 6f  lumn*2;.  p->aCo
6de0: 6c 4e 61 6d 65 20 3d 20 70 43 6f 6c 4e 61 6d 65  lName = pColName
6df0: 20 3d 20 28 4d 65 6d 2a 29 73 71 6c 69 74 65 4d   = (Mem*)sqliteM
6e00: 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 4d 65  alloc( sizeof(Me
6e10: 6d 29 2a 6e 20 29 3b 0a 20 20 69 66 28 20 70 2d  m)*n );.  if( p-
6e20: 3e 61 43 6f 6c 4e 61 6d 65 3d 3d 30 20 29 20 72  >aColName==0 ) r
6e30: 65 74 75 72 6e 3b 0a 20 20 77 68 69 6c 65 28 20  eturn;.  while( 
6e40: 6e 2d 2d 20 3e 20 30 20 29 7b 0a 20 20 20 20 28  n-- > 0 ){.    (
6e50: 70 43 6f 6c 4e 61 6d 65 2b 2b 29 2d 3e 66 6c 61  pColName++)->fla
6e60: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20  gs = MEM_Null;. 
6e70: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20   }.}../*.** Set 
6e80: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
6e90: 69 64 78 27 74 68 20 63 6f 6c 75 6d 6e 20 74 6f  idx'th column to
6ea0: 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20   be returned by 
6eb0: 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  the SQL statemen
6ec0: 74 2e 0a 2a 2a 20 7a 4e 61 6d 65 20 6d 75 73 74  t..** zName must
6ed0: 20 62 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f   be a pointer to
6ee0: 20 61 20 6e 75 6c 20 74 65 72 6d 69 6e 61 74 65   a nul terminate
6ef0: 64 20 73 74 72 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20  d string..**.** 
6f00: 54 68 69 73 20 63 61 6c 6c 20 6d 75 73 74 20 62  This call must b
6f10: 65 20 6d 61 64 65 20 61 66 74 65 72 20 61 20 63  e made after a c
6f20: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 56 64  all to sqlite3Vd
6f30: 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 29 2e 0a  beSetNumCols()..
6f40: 2a 2a 0a 2a 2a 20 49 66 20 4e 3d 3d 50 33 5f 53  **.** If N==P3_S
6f50: 54 41 54 49 43 20 20 69 74 20 6d 65 61 6e 73 20  TATIC  it means 
6f60: 74 68 61 74 20 7a 4e 61 6d 65 20 69 73 20 61 20  that zName is a 
6f70: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 63 6f 6e  pointer to a con
6f80: 73 74 61 6e 74 20 73 74 61 74 69 63 0a 2a 2a 20  stant static.** 
6f90: 73 74 72 69 6e 67 20 61 6e 64 20 77 65 20 63 61  string and we ca
6fa0: 6e 20 6a 75 73 74 20 63 6f 70 79 20 74 68 65 20  n just copy the 
6fb0: 70 6f 69 6e 74 65 72 2e 20 49 66 20 69 74 20 69  pointer. If it i
6fc0: 73 20 50 33 5f 44 59 4e 41 4d 49 43 2c 20 74 68  s P3_DYNAMIC, th
6fd0: 65 6e 20 0a 2a 2a 20 74 68 65 20 73 74 72 69 6e  en .** the strin
6fe0: 67 20 69 73 20 66 72 65 65 64 20 75 73 69 6e 67  g is freed using
6ff0: 20 73 71 6c 69 74 65 46 72 65 65 28 29 20 77 68   sqliteFree() wh
7000: 65 6e 20 74 68 65 20 76 64 62 65 20 69 73 20 66  en the vdbe is f
7010: 69 6e 69 73 68 65 64 20 77 69 74 68 0a 2a 2a 20  inished with.** 
7020: 69 74 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 4e  it. Otherwise, N
7030: 20 62 79 74 65 73 20 6f 66 20 7a 4e 61 6d 65 20   bytes of zName 
7040: 61 72 65 20 63 6f 70 69 65 64 2e 0a 2a 2f 0a 69  are copied..*/.i
7050: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  nt sqlite3VdbeSe
7060: 74 43 6f 6c 4e 61 6d 65 28 56 64 62 65 20 2a 70  tColName(Vdbe *p
7070: 2c 20 69 6e 74 20 69 64 78 2c 20 63 6f 6e 73 74  , int idx, const
7080: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e   char *zName, in
7090: 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  t N){.  int rc;.
70a0: 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b    Mem *pColName;
70b0: 0a 20 20 61 73 73 65 72 74 28 20 69 64 78 3c 28  .  assert( idx<(
70c0: 32 2a 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 29  2*p->nResColumn)
70d0: 20 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65   );.  if( sqlite
70e0: 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20  3_malloc_failed 
70f0: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  ) return SQLITE_
7100: 4e 4f 4d 45 4d 3b 0a 20 20 61 73 73 65 72 74 28  NOMEM;.  assert(
7110: 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21 3d 30 20   p->aColName!=0 
7120: 29 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65 20 3d 20  );.  pColName = 
7130: 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 69 64  &(p->aColName[id
7140: 78 5d 29 3b 0a 20 20 69 66 28 20 4e 3d 3d 50 33  x]);.  if( N==P3
7150: 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 4e 3d 3d 50  _DYNAMIC || N==P
7160: 33 5f 53 54 41 54 49 43 20 29 7b 0a 20 20 20 20  3_STATIC ){.    
7170: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
7180: 4d 65 6d 53 65 74 53 74 72 28 70 43 6f 6c 4e 61  MemSetStr(pColNa
7190: 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53  me, zName, -1, S
71a0: 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49  QLITE_UTF8, SQLI
71b0: 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7d 65  TE_STATIC);.  }e
71c0: 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71  lse{.    rc = sq
71d0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
71e0: 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20 7a 4e 61  tr(pColName, zNa
71f0: 6d 65 2c 20 4e 2c 20 53 51 4c 49 54 45 5f 55 54  me, N, SQLITE_UT
7200: 46 38 2c 53 51 4c 49 54 45 5f 54 52 41 4e 53 49  F8,SQLITE_TRANSI
7210: 45 4e 54 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  ENT);.  }.  if( 
7220: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
7230: 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29   N==P3_DYNAMIC )
7240: 7b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65 2d 3e  {.    pColName->
7250: 66 6c 61 67 73 20 3d 20 28 70 43 6f 6c 4e 61 6d  flags = (pColNam
7260: 65 2d 3e 66 6c 61 67 73 26 28 7e 4d 45 4d 5f 53  e->flags&(~MEM_S
7270: 74 61 74 69 63 29 29 7c 4d 45 4d 5f 44 79 6e 3b  tatic))|MEM_Dyn;
7280: 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65 2d 3e 78  .    pColName->x
7290: 44 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72  Del = 0;.  }.  r
72a0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
72b0: 2a 2a 20 41 20 72 65 61 64 20 6f 72 20 77 72 69  ** A read or wri
72c0: 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d  te transaction m
72d0: 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65  ay or may not be
72e0: 20 61 63 74 69 76 65 20 6f 6e 20 64 61 74 61 62   active on datab
72f0: 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62  ase handle.** db
7300: 2e 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69  . If a transacti
7310: 6f 6e 20 69 73 20 61 63 74 69 76 65 2c 20 63 6f  on is active, co
7320: 6d 6d 69 74 20 69 74 2e 20 49 66 20 74 68 65 72  mmit it. If ther
7330: 65 20 69 73 20 61 0a 2a 2a 20 77 72 69 74 65 2d  e is a.** write-
7340: 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 70 61 6e  transaction span
7350: 6e 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 6f  ning more than o
7360: 6e 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ne database file
7370: 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a  , this routine.*
7380: 2a 20 74 61 6b 65 73 20 63 61 72 65 20 6f 66 20  * takes care of 
7390: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  the master journ
73a0: 61 6c 20 74 72 69 63 6b 65 72 79 2e 0a 2a 2f 0a  al trickery..*/.
73b0: 73 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 43  static int vdbeC
73c0: 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64  ommit(sqlite3 *d
73d0: 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  b){.  int i;.  i
73e0: 6e 74 20 6e 54 72 61 6e 73 20 3d 20 30 3b 20 20  nt nTrans = 0;  
73f0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 61 74  /* Number of dat
7400: 61 62 61 73 65 73 20 77 69 74 68 20 61 6e 20 61  abases with an a
7410: 63 74 69 76 65 20 77 72 69 74 65 2d 74 72 61 6e  ctive write-tran
7420: 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74  saction */.  int
7430: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
7440: 0a 20 20 69 6e 74 20 6e 65 65 64 58 63 6f 6d 6d  .  int needXcomm
7450: 69 74 20 3d 20 30 3b 0a 0a 20 20 66 6f 72 28 69  it = 0;..  for(i
7460: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
7470: 2b 2b 29 7b 20 0a 20 20 20 20 42 74 72 65 65 20  ++){ .    Btree 
7480: 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69  *pBt = db->aDb[i
7490: 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70  ].pBt;.    if( p
74a0: 42 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 72  Bt && sqlite3Btr
74b0: 65 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29  eeIsInTrans(pBt)
74c0: 20 29 7b 0a 20 20 20 20 20 20 6e 65 65 64 58 63   ){.      needXc
74d0: 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 20 20 20  ommit = 1;.     
74e0: 20 69 66 28 20 69 21 3d 31 20 29 20 6e 54 72 61   if( i!=1 ) nTra
74f0: 6e 73 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  ns++;.    }.  }.
7500: 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61  .  /* If there a
7510: 72 65 20 61 6e 79 20 77 72 69 74 65 2d 74 72 61  re any write-tra
7520: 6e 73 61 63 74 69 6f 6e 73 20 61 74 20 61 6c 6c  nsactions at all
7530: 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 6f 6d  , invoke the com
7540: 6d 69 74 20 68 6f 6f 6b 20 2a 2f 0a 20 20 69 66  mit hook */.  if
7550: 28 20 6e 65 65 64 58 63 6f 6d 6d 69 74 20 26 26  ( needXcommit &&
7560: 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c   db->xCommitCall
7570: 62 61 63 6b 20 29 7b 0a 20 20 20 20 69 6e 74 20  back ){.    int 
7580: 72 63 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53  rc;.    sqlite3S
7590: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20  afetyOff(db);.  
75a0: 20 20 72 63 20 3d 20 64 62 2d 3e 78 43 6f 6d 6d    rc = db->xComm
75b0: 69 74 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70  itCallback(db->p
75c0: 43 6f 6d 6d 69 74 41 72 67 29 3b 0a 20 20 20 20  CommitArg);.    
75d0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
75e0: 64 62 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20  db);.    if( rc 
75f0: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  ){.      return 
7600: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e  SQLITE_CONSTRAIN
7610: 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20  T;.    }.  }..  
7620: 2f 2a 20 54 68 65 20 73 69 6d 70 6c 65 20 63 61  /* The simple ca
7630: 73 65 20 2d 20 6e 6f 20 6d 6f 72 65 20 74 68 61  se - no more tha
7640: 6e 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66  n one database f
7650: 69 6c 65 20 28 6e 6f 74 20 63 6f 75 6e 74 69 6e  ile (not countin
7660: 67 20 74 68 65 0a 20 20 2a 2a 20 54 45 4d 50 20  g the.  ** TEMP 
7670: 64 61 74 61 62 61 73 65 29 20 68 61 73 20 61 20  database) has a 
7680: 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 74 69  transaction acti
7690: 76 65 2e 20 20 20 54 68 65 72 65 20 69 73 20 6e  ve.   There is n
76a0: 6f 20 6e 65 65 64 20 66 6f 72 20 74 68 65 0a 20  o need for the. 
76b0: 20 2a 2a 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e   ** master-journ
76c0: 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66  al..  **.  ** If
76d0: 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   the return valu
76e0: 65 20 6f 66 20 73 71 6c 69 74 65 33 42 74 72 65  e of sqlite3Btre
76f0: 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 29 20 69  eGetFilename() i
7700: 73 20 61 20 7a 65 72 6f 20 6c 65 6e 67 74 68 0a  s a zero length.
7710: 20 20 2a 2a 20 73 74 72 69 6e 67 2c 20 69 74 20    ** string, it 
7720: 6d 65 61 6e 73 20 74 68 65 20 6d 61 69 6e 20 64  means the main d
7730: 61 74 61 62 61 73 65 20 69 73 20 3a 6d 65 6d 6f  atabase is :memo
7740: 72 79 3a 2e 20 20 49 6e 20 74 68 61 74 20 63 61  ry:.  In that ca
7750: 73 65 20 77 65 20 64 6f 0a 20 20 2a 2a 20 6e 6f  se we do.  ** no
7760: 74 20 73 75 70 70 6f 72 74 20 61 74 6f 6d 69 63  t support atomic
7770: 20 6d 75 6c 74 69 2d 66 69 6c 65 20 63 6f 6d 6d   multi-file comm
7780: 69 74 73 2c 20 73 6f 20 75 73 65 20 74 68 65 20  its, so use the 
7790: 73 69 6d 70 6c 65 20 63 61 73 65 20 74 68 65 6e  simple case then
77a0: 0a 20 20 2a 2a 20 74 6f 6f 2e 0a 20 20 2a 2f 0a  .  ** too..  */.
77b0: 20 20 69 66 28 20 30 3d 3d 73 74 72 6c 65 6e 28    if( 0==strlen(
77c0: 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 46  sqlite3BtreeGetF
77d0: 69 6c 65 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b  ilename(db->aDb[
77e0: 30 5d 2e 70 42 74 29 29 20 7c 7c 20 6e 54 72 61  0].pBt)) || nTra
77f0: 6e 73 3c 3d 31 20 29 7b 0a 20 20 20 20 66 6f 72  ns<=1 ){.    for
7800: 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45  (i=0; rc==SQLITE
7810: 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62  _OK && i<db->nDb
7820: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42  ; i++){ .      B
7830: 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e  tree *pBt = db->
7840: 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20  aDb[i].pBt;.    
7850: 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20    if( pBt ){.   
7860: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
7870: 33 42 74 72 65 65 53 79 6e 63 28 70 42 74 2c 20  3BtreeSync(pBt, 
7880: 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  0);.      }.    
7890: 7d 0a 0a 20 20 20 20 2f 2a 20 44 6f 20 74 68 65  }..    /* Do the
78a0: 20 63 6f 6d 6d 69 74 20 6f 6e 6c 79 20 69 66 20   commit only if 
78b0: 61 6c 6c 20 64 61 74 61 62 61 73 65 73 20 73 75  all databases su
78c0: 63 63 65 73 73 66 75 6c 6c 79 20 73 79 6e 63 65  ccessfully synce
78d0: 64 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d  d */.    if( rc=
78e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
78f0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64      for(i=0; i<d
7900: 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20  b->nDb; i++){.  
7910: 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 42 74        Btree *pBt
7920: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42   = db->aDb[i].pB
7930: 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70  t;.        if( p
7940: 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  Bt ){.          
7950: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
7960: 69 74 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20  it(pBt);.       
7970: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d   }.      }.    }
7980: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 63  .  }..  /* The c
7990: 6f 6d 70 6c 65 78 20 63 61 73 65 20 2d 20 54 68  omplex case - Th
79a0: 65 72 65 20 69 73 20 61 20 6d 75 6c 74 69 2d 66  ere is a multi-f
79b0: 69 6c 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61  ile write-transa
79c0: 63 74 69 6f 6e 20 61 63 74 69 76 65 2e 0a 20 20  ction active..  
79d0: 2a 2a 20 54 68 69 73 20 72 65 71 75 69 72 65 73  ** This requires
79e0: 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61   a master journa
79f0: 6c 20 66 69 6c 65 20 74 6f 20 65 6e 73 75 72 65  l file to ensure
7a00: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
7a10: 20 69 73 0a 20 20 2a 2a 20 63 6f 6d 6d 69 74 74   is.  ** committ
7a20: 65 64 20 61 74 6f 6d 69 63 6c 79 2e 0a 20 20 2a  ed atomicly..  *
7a30: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  /.#ifndef SQLITE
7a40: 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 20 20 65  _OMIT_DISKIO.  e
7a50: 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 6e 65 65  lse{.    int nee
7a60: 64 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20 63  dSync = 0;.    c
7a70: 68 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d 20 30  har *zMaster = 0
7a80: 3b 20 20 20 2f 2a 20 46 69 6c 65 2d 6e 61 6d 65  ;   /* File-name
7a90: 20 66 6f 72 20 74 68 65 20 6d 61 73 74 65 72 20   for the master 
7aa0: 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20 20 63  journal */.    c
7ab0: 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61 69 6e  har const *zMain
7ac0: 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 42 74  File = sqlite3Bt
7ad0: 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 64  reeGetFilename(d
7ae0: 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a  b->aDb[0].pBt);.
7af0: 20 20 20 20 4f 73 46 69 6c 65 20 6d 61 73 74 65      OsFile maste
7b00: 72 3b 0a 0a 20 20 20 20 2f 2a 20 53 65 6c 65 63  r;..    /* Selec
7b10: 74 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  t a master journ
7b20: 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 2a 2f 0a  al file name */.
7b30: 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 75      do {.      u
7b40: 33 32 20 72 61 6e 64 6f 6d 3b 0a 20 20 20 20 20  32 random;.     
7b50: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
7b60: 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  ter);.      sqli
7b70: 74 65 33 52 61 6e 64 6f 6d 6e 65 73 73 28 73 69  te3Randomness(si
7b80: 7a 65 6f 66 28 72 61 6e 64 6f 6d 29 2c 20 26 72  zeof(random), &r
7b90: 61 6e 64 6f 6d 29 3b 0a 20 20 20 20 20 20 7a 4d  andom);.      zM
7ba0: 61 73 74 65 72 20 3d 20 73 71 6c 69 74 65 33 4d  aster = sqlite3M
7bb0: 50 72 69 6e 74 66 28 22 25 73 2d 6d 6a 25 30 38  Printf("%s-mj%08
7bc0: 58 22 2c 20 7a 4d 61 69 6e 46 69 6c 65 2c 20 72  X", zMainFile, r
7bd0: 61 6e 64 6f 6d 26 30 78 37 66 66 66 66 66 66 66  andom&0x7fffffff
7be0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21 7a 4d  );.      if( !zM
7bf0: 61 73 74 65 72 20 29 7b 0a 20 20 20 20 20 20 20  aster ){.       
7c00: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e   return SQLITE_N
7c10: 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 20  OMEM;.      }.  
7c20: 20 20 7d 77 68 69 6c 65 28 20 73 71 6c 69 74 65    }while( sqlite
7c30: 33 4f 73 46 69 6c 65 45 78 69 73 74 73 28 7a 4d  3OsFileExists(zM
7c40: 61 73 74 65 72 29 20 29 3b 0a 0a 20 20 20 20 2f  aster) );..    /
7c50: 2a 20 4f 70 65 6e 20 74 68 65 20 6d 61 73 74 65  * Open the maste
7c60: 72 20 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a 20 20  r journal. */.  
7c70: 20 20 6d 65 6d 73 65 74 28 26 6d 61 73 74 65 72    memset(&master
7c80: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 61 73 74  , 0, sizeof(mast
7c90: 65 72 29 29 3b 0a 20 20 20 20 72 63 20 3d 20 73  er));.    rc = s
7ca0: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c  qlite3OsOpenExcl
7cb0: 75 73 69 76 65 28 7a 4d 61 73 74 65 72 2c 20 26  usive(zMaster, &
7cc0: 6d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20 20 20  master, 0);.    
7cd0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
7ce0: 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  K ){.      sqlit
7cf0: 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a  eFree(zMaster);.
7d00: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
7d10: 0a 20 20 20 20 7d 0a 20 0a 20 20 20 20 2f 2a 20  .    }. .    /* 
7d20: 57 72 69 74 65 20 74 68 65 20 6e 61 6d 65 20 6f  Write the name o
7d30: 66 20 65 61 63 68 20 64 61 74 61 62 61 73 65 20  f each database 
7d40: 66 69 6c 65 20 69 6e 20 74 68 65 20 74 72 61 6e  file in the tran
7d50: 73 61 63 74 69 6f 6e 20 69 6e 74 6f 20 74 68 65  saction into the
7d60: 20 6e 65 77 0a 20 20 20 20 2a 2a 20 6d 61 73 74   new.    ** mast
7d70: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e  er journal file.
7d80: 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   If an error occ
7d90: 75 72 73 20 61 74 20 74 68 69 73 20 70 6f 69 6e  urs at this poin
7da0: 74 20 63 6c 6f 73 65 0a 20 20 20 20 2a 2a 20 61  t close.    ** a
7db0: 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61  nd delete the ma
7dc0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
7dd0: 65 2e 20 41 6c 6c 20 74 68 65 20 69 6e 64 69 76  e. All the indiv
7de0: 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 66 69  idual journal fi
7df0: 6c 65 73 0a 20 20 20 20 2a 2a 20 73 74 69 6c 6c  les.    ** still
7e00: 20 68 61 76 65 20 27 6e 75 6c 6c 27 20 61 73 20   have 'null' as 
7e10: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  the master journ
7e20: 61 6c 20 70 6f 69 6e 74 65 72 2c 20 73 6f 20 74  al pointer, so t
7e30: 68 65 79 20 77 69 6c 6c 20 72 6f 6c 6c 0a 20 20  hey will roll.  
7e40: 20 20 2a 2a 20 62 61 63 6b 20 69 6e 64 65 70 65    ** back indepe
7e50: 6e 64 65 6e 74 6c 79 20 69 66 20 61 20 66 61 69  ndently if a fai
7e60: 6c 75 72 65 20 6f 63 63 75 72 73 2e 0a 20 20 20  lure occurs..   
7e70: 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b   */.    for(i=0;
7e80: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
7e90: 7b 20 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a  { .      Btree *
7ea0: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d  pBt = db->aDb[i]
7eb0: 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20  .pBt;.      if( 
7ec0: 69 3d 3d 31 20 29 20 63 6f 6e 74 69 6e 75 65 3b  i==1 ) continue;
7ed0: 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74 68 65     /* Ignore the
7ee0: 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 20 2a   TEMP database *
7ef0: 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 20  /.      if( pBt 
7f00: 26 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49  && sqlite3BtreeI
7f10: 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b  sInTrans(pBt) ){
7f20: 0a 20 20 20 20 20 20 20 20 63 68 61 72 20 63 6f  .        char co
7f30: 6e 73 74 20 2a 7a 46 69 6c 65 20 3d 20 73 71 6c  nst *zFile = sql
7f40: 69 74 65 33 42 74 72 65 65 47 65 74 4a 6f 75 72  ite3BtreeGetJour
7f50: 6e 61 6c 6e 61 6d 65 28 70 42 74 29 3b 0a 20 20  nalname(pBt);.  
7f60: 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c 65 5b        if( zFile[
7f70: 30 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65  0]==0 ) continue
7f80: 3b 20 20 2f 2a 20 49 67 6e 6f 72 65 20 3a 6d 65  ;  /* Ignore :me
7f90: 6d 6f 72 79 3a 20 64 61 74 61 62 61 73 65 73 20  mory: databases 
7fa0: 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 21  */.        if( !
7fb0: 6e 65 65 64 53 79 6e 63 20 26 26 20 21 73 71 6c  needSync && !sql
7fc0: 69 74 65 33 42 74 72 65 65 53 79 6e 63 44 69 73  ite3BtreeSyncDis
7fd0: 61 62 6c 65 64 28 70 42 74 29 20 29 7b 0a 20 20  abled(pBt) ){.  
7fe0: 20 20 20 20 20 20 20 20 6e 65 65 64 53 79 6e 63          needSync
7ff0: 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a   = 1;.        }.
8000: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
8010: 69 74 65 33 4f 73 57 72 69 74 65 28 26 6d 61 73  ite3OsWrite(&mas
8020: 74 65 72 2c 20 7a 46 69 6c 65 2c 20 73 74 72 6c  ter, zFile, strl
8030: 65 6e 28 7a 46 69 6c 65 29 2b 31 29 3b 0a 20 20  en(zFile)+1);.  
8040: 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51        if( rc!=SQ
8050: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
8060: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c       sqlite3OsCl
8070: 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20  ose(&master);.  
8080: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f          sqlite3O
8090: 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29  sDelete(zMaster)
80a0: 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  ;.          sqli
80b0: 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b  teFree(zMaster);
80c0: 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72  .          retur
80d0: 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a  n rc;.        }.
80e0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 0a        }.    }...
80f0: 20 20 20 20 2f 2a 20 53 79 6e 63 20 74 68 65 20      /* Sync the 
8100: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
8110: 69 6c 65 2e 20 42 65 66 6f 72 65 20 64 6f 69 6e  ile. Before doin
8120: 67 20 74 68 69 73 2c 20 6f 70 65 6e 20 74 68 65  g this, open the
8130: 20 64 69 72 65 63 74 6f 72 79 0a 20 20 20 20 2a   directory.    *
8140: 2a 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  * the master jou
8150: 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 73 74 6f  rnal file is sto
8160: 72 65 20 69 6e 20 73 6f 20 74 68 61 74 20 69 74  re in so that it
8170: 20 67 65 74 73 20 73 79 6e 63 65 64 20 74 6f 6f   gets synced too
8180: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 7a 4d 61  ..    */.    zMa
8190: 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33  inFile = sqlite3
81a0: 42 74 72 65 65 47 65 74 44 69 72 6e 61 6d 65 28  BtreeGetDirname(
81b0: 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b  db->aDb[0].pBt);
81c0: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
81d0: 33 4f 73 4f 70 65 6e 44 69 72 65 63 74 6f 72 79  3OsOpenDirectory
81e0: 28 7a 4d 61 69 6e 46 69 6c 65 2c 20 26 6d 61 73  (zMainFile, &mas
81f0: 74 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63  ter);.    if( rc
8200: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28  !=SQLITE_OK || (
8210: 6e 65 65 64 53 79 6e 63 20 26 26 20 28 72 63 3d  needSync && (rc=
8220: 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 26 6d  sqlite3OsSync(&m
8230: 61 73 74 65 72 29 29 21 3d 53 51 4c 49 54 45 5f  aster))!=SQLITE_
8240: 4f 4b 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  OK) ){.      sql
8250: 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73  ite3OsClose(&mas
8260: 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  ter);.      sqli
8270: 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73  te3OsDelete(zMas
8280: 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  ter);.      sqli
8290: 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b  teFree(zMaster);
82a0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63  .      return rc
82b0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20  ;.    }..    /* 
82c0: 53 79 6e 63 20 61 6c 6c 20 74 68 65 20 64 62 20  Sync all the db 
82d0: 66 69 6c 65 73 20 69 6e 76 6f 6c 76 65 64 20 69  files involved i
82e0: 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  n the transactio
82f0: 6e 2e 20 54 68 65 20 73 61 6d 65 20 63 61 6c 6c  n. The same call
8300: 0a 20 20 20 20 2a 2a 20 73 65 74 73 20 74 68 65  .    ** sets the
8310: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
8320: 70 6f 69 6e 74 65 72 20 69 6e 20 65 61 63 68 20  pointer in each 
8330: 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e  individual journ
8340: 61 6c 2e 20 49 66 0a 20 20 20 20 2a 2a 20 61 6e  al. If.    ** an
8350: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 68 65   error occurs he
8360: 72 65 2c 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74  re, do not delet
8370: 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  e the master jou
8380: 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 20 20 2a  rnal file..    *
8390: 2a 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20  *.    ** If the 
83a0: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72  error occurs dur
83b0: 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 63 61  ing the first ca
83c0: 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72  ll to sqlite3Btr
83d0: 65 65 53 79 6e 63 28 29 2c 0a 20 20 20 20 2a 2a  eeSync(),.    **
83e0: 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 20 61   then there is a
83f0: 20 63 68 61 6e 63 65 20 74 68 61 74 20 74 68 65   chance that the
8400: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
8410: 66 69 6c 65 20 77 69 6c 6c 20 62 65 0a 20 20 20  file will be.   
8420: 20 2a 2a 20 6f 72 70 68 61 6e 65 64 2e 20 42 75   ** orphaned. Bu
8430: 74 20 77 65 20 63 61 6e 6e 6f 74 20 64 65 6c 65  t we cannot dele
8440: 74 65 20 69 74 2c 20 69 6e 20 63 61 73 65 20 74  te it, in case t
8450: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
8460: 6c 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 6e 61  l.    ** file na
8470: 6d 65 20 77 61 73 20 77 72 69 74 74 65 6e 20 69  me was written i
8480: 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  nto the journal 
8490: 66 69 6c 65 20 62 65 66 6f 72 65 20 74 68 65 20  file before the 
84a0: 66 61 69 6c 75 72 65 0a 20 20 20 20 2a 2a 20 6f  failure.    ** o
84b0: 63 63 75 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20  ccured..    */. 
84c0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62     for(i=0; i<db
84d0: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20  ->nDb; i++){ .  
84e0: 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d      Btree *pBt =
84f0: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b   db->aDb[i].pBt;
8500: 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 20 26  .      if( pBt &
8510: 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73  & sqlite3BtreeIs
8520: 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a  InTrans(pBt) ){.
8530: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
8540: 69 74 65 33 42 74 72 65 65 53 79 6e 63 28 70 42  ite3BtreeSync(pB
8550: 74 2c 20 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20  t, zMaster);.   
8560: 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c       if( rc!=SQL
8570: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
8580: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f      sqlite3OsClo
8590: 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20 20  se(&master);.   
85a0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65         sqliteFre
85b0: 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20  e(zMaster);.    
85c0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
85d0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
85e0: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c   }.    }.    sql
85f0: 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73  ite3OsClose(&mas
8600: 74 65 72 29 3b 0a 0a 20 20 20 20 2f 2a 20 44 65  ter);..    /* De
8610: 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65 72 20  lete the master 
8620: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68  journal file. Th
8630: 69 73 20 63 6f 6d 6d 69 74 73 20 74 68 65 20 74  is commits the t
8640: 72 61 6e 73 61 63 74 69 6f 6e 2e 20 41 66 74 65  ransaction. Afte
8650: 72 0a 20 20 20 20 2a 2a 20 64 6f 69 6e 67 20 74  r.    ** doing t
8660: 68 69 73 20 74 68 65 20 64 69 72 65 63 74 6f 72  his the director
8670: 79 20 69 73 20 73 79 6e 63 65 64 20 61 67 61 69  y is synced agai
8680: 6e 20 62 65 66 6f 72 65 20 61 6e 79 20 69 6e 64  n before any ind
8690: 69 76 69 64 75 61 6c 0a 20 20 20 20 2a 2a 20 74  ividual.    ** t
86a0: 72 61 6e 73 61 63 74 69 6f 6e 20 66 69 6c 65 73  ransaction files
86b0: 20 61 72 65 20 64 65 6c 65 74 65 64 2e 0a 20 20   are deleted..  
86c0: 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71    */.    rc = sq
86d0: 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d  lite3OsDelete(zM
86e0: 61 73 74 65 72 29 3b 0a 20 20 20 20 61 73 73 65  aster);.    asse
86f0: 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  rt( rc==SQLITE_O
8700: 4b 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46  K );.    sqliteF
8710: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
8720: 20 20 7a 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20    zMaster = 0;. 
8730: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f     rc = sqlite3O
8740: 73 53 79 6e 63 44 69 72 65 63 74 6f 72 79 28 7a  sSyncDirectory(z
8750: 4d 61 69 6e 46 69 6c 65 29 3b 0a 20 20 20 20 69  MainFile);.    i
8760: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
8770: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69   ){.      /* Thi
8780: 73 20 69 73 20 6e 6f 74 20 67 6f 6f 64 2e 20 54  s is not good. T
8790: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
87a0: 6c 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20  l file has been 
87b0: 64 65 6c 65 74 65 64 2c 20 62 75 74 0a 20 20 20  deleted, but.   
87c0: 20 20 20 2a 2a 20 74 68 65 20 64 69 72 65 63 74     ** the direct
87d0: 6f 72 79 20 73 79 6e 63 20 66 61 69 6c 65 64 2e  ory sync failed.
87e0: 20 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f 6d   There is no com
87f0: 70 6c 65 74 65 6c 79 20 73 61 66 65 20 63 6f 75  pletely safe cou
8800: 72 73 65 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20  rse of.      ** 
8810: 61 63 74 69 6f 6e 20 66 72 6f 6d 20 68 65 72 65  action from here
8820: 2e 20 54 68 65 20 69 6e 64 69 76 69 64 75 61 6c  . The individual
8830: 20 6a 6f 75 72 6e 61 6c 73 20 63 6f 6e 74 61 69   journals contai
8840: 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  n the name of th
8850: 65 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73 74 65  e.      ** maste
8860: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20  r journal file, 
8870: 62 75 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20  but there is no 
8880: 77 61 79 20 6f 66 20 6b 6e 6f 77 69 6e 67 20 69  way of knowing i
8890: 66 20 74 68 61 74 0a 20 20 20 20 20 20 2a 2a 20  f that.      ** 
88a0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 65  master journal e
88b0: 78 69 73 74 73 20 6e 6f 77 20 6f 72 20 69 66 20  xists now or if 
88c0: 69 74 20 77 69 6c 6c 20 65 78 69 73 74 20 61 66  it will exist af
88d0: 74 65 72 20 74 68 65 20 6f 70 65 72 61 74 69 6e  ter the operatin
88e0: 67 0a 20 20 20 20 20 20 2a 2a 20 73 79 73 74 65  g.      ** syste
88f0: 6d 20 63 72 61 73 68 20 74 68 61 74 20 6d 61 79  m crash that may
8900: 20 66 6f 6c 6c 6f 77 20 74 68 65 20 66 73 79 6e   follow the fsyn
8910: 63 28 29 20 66 61 69 6c 75 72 65 2e 0a 20 20 20  c() failure..   
8920: 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75     */.      retu
8930: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20  rn rc;.    }..  
8940: 20 20 2f 2a 20 41 6c 6c 20 66 69 6c 65 73 20 61    /* All files a
8950: 6e 64 20 64 69 72 65 63 74 6f 72 69 65 73 20 68  nd directories h
8960: 61 76 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e  ave already been
8970: 20 73 79 6e 63 65 64 2c 20 73 6f 20 74 68 65 20   synced, so the 
8980: 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 2a 2a  following.    **
8990: 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74 65   calls to sqlite
89a0: 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 29 20 61  3BtreeCommit() a
89b0: 72 65 20 6f 6e 6c 79 20 63 6c 6f 73 69 6e 67 20  re only closing 
89c0: 66 69 6c 65 73 20 61 6e 64 20 64 65 6c 65 74 69  files and deleti
89d0: 6e 67 0a 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61  ng.    ** journa
89e0: 6c 73 2e 20 49 66 20 73 6f 6d 65 74 68 69 6e 67  ls. If something
89f0: 20 67 6f 65 73 20 77 72 6f 6e 67 20 77 68 69 6c   goes wrong whil
8a00: 65 20 74 68 69 73 20 69 73 20 68 61 70 70 65 6e  e this is happen
8a10: 69 6e 67 20 77 65 20 64 6f 6e 27 74 0a 20 20 20  ing we don't.   
8a20: 20 2a 2a 20 72 65 61 6c 6c 79 20 63 61 72 65 2e   ** really care.
8a30: 20 54 68 65 20 69 6e 74 65 67 72 69 74 79 20 6f   The integrity o
8a40: 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  f the transactio
8a50: 6e 20 69 73 20 61 6c 72 65 61 64 79 20 67 75 61  n is already gua
8a60: 72 61 6e 74 65 65 64 2c 0a 20 20 20 20 2a 2a 20  ranteed,.    ** 
8a70: 62 75 74 20 73 6f 6d 65 20 73 74 72 61 79 20 27  but some stray '
8a80: 63 6f 6c 64 27 20 6a 6f 75 72 6e 61 6c 73 20 6d  cold' journals m
8a90: 61 79 20 62 65 20 6c 79 69 6e 67 20 61 72 6f 75  ay be lying arou
8aa0: 6e 64 2e 20 52 65 74 75 72 6e 69 6e 67 20 61 6e  nd. Returning an
8ab0: 0a 20 20 20 20 2a 2a 20 65 72 72 6f 72 20 63 6f  .    ** error co
8ac0: 64 65 20 77 6f 6e 27 74 20 68 65 6c 70 20 6d 61  de won't help ma
8ad0: 74 74 65 72 73 2e 0a 20 20 20 20 2a 2f 0a 20 20  tters..    */.  
8ae0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d    for(i=0; i<db-
8af0: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20  >nDb; i++){ .   
8b00: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
8b10: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
8b20: 20 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b        if( pBt ){
8b30: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
8b40: 42 74 72 65 65 43 6f 6d 6d 69 74 28 70 42 74 29  BtreeCommit(pBt)
8b50: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
8b60: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65    }.#endif..  re
8b70: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
8b80: 2a 20 46 69 6e 64 20 65 76 65 72 79 20 61 63 74  * Find every act
8b90: 69 76 65 20 56 4d 20 6f 74 68 65 72 20 74 68 61  ive VM other tha
8ba0: 6e 20 70 56 64 62 65 20 61 6e 64 20 63 68 61 6e  n pVdbe and chan
8bb0: 67 65 20 69 74 73 20 73 74 61 74 75 73 20 74 6f  ge its status to
8bc0: 0a 2a 2a 20 61 62 6f 72 74 65 64 2e 20 20 54 68  .** aborted.  Th
8bd0: 69 73 20 68 61 70 70 65 6e 73 20 77 68 65 6e 20  is happens when 
8be0: 6f 6e 65 20 56 4d 20 63 61 75 73 65 73 20 61 20  one VM causes a 
8bf0: 72 6f 6c 6c 62 61 63 6b 20 64 75 65 20 74 6f 20  rollback due to 
8c00: 61 6e 0a 2a 2a 20 4f 4e 20 43 4f 4e 46 4c 49 43  an.** ON CONFLIC
8c10: 54 20 52 4f 4c 4c 42 41 43 4b 20 63 6c 61 75 73  T ROLLBACK claus
8c20: 65 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 29 2e  e (for example).
8c30: 20 20 54 68 65 20 6f 74 68 65 72 20 56 4d 73 20    The other VMs 
8c40: 6d 75 73 74 20 62 65 0a 2a 2a 20 61 62 6f 72 74  must be.** abort
8c50: 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 79 20  ed so that they 
8c60: 64 6f 20 6e 6f 74 20 68 61 76 65 20 64 61 74 61  do not have data
8c70: 20 72 6f 6c 6c 65 64 20 6f 75 74 20 66 72 6f 6d   rolled out from
8c80: 20 75 6e 64 65 72 6e 65 61 74 68 0a 2a 2a 20 74   underneath.** t
8c90: 68 65 6d 20 6c 65 61 64 69 6e 67 20 74 6f 20 61  hem leading to a
8ca0: 20 73 65 67 66 61 75 6c 74 2e 0a 2a 2f 0a 73 74   segfault..*/.st
8cb0: 61 74 69 63 20 76 6f 69 64 20 61 62 6f 72 74 4f  atic void abortO
8cc0: 74 68 65 72 41 63 74 69 76 65 56 64 62 65 73 28  therActiveVdbes(
8cd0: 56 64 62 65 20 2a 70 56 64 62 65 29 7b 0a 20 20  Vdbe *pVdbe){.  
8ce0: 56 64 62 65 20 2a 70 4f 74 68 65 72 3b 0a 20 20  Vdbe *pOther;.  
8cf0: 66 6f 72 28 70 4f 74 68 65 72 3d 70 56 64 62 65  for(pOther=pVdbe
8d00: 2d 3e 64 62 2d 3e 70 56 64 62 65 3b 20 70 4f 74  ->db->pVdbe; pOt
8d10: 68 65 72 3b 20 70 4f 74 68 65 72 3d 70 4f 74 68  her; pOther=pOth
8d20: 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20  er->pNext){.    
8d30: 69 66 28 20 70 4f 74 68 65 72 3d 3d 70 56 64 62  if( pOther==pVdb
8d40: 65 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20  e ) continue;.  
8d50: 20 20 69 66 28 20 70 4f 74 68 65 72 2d 3e 6d 61    if( pOther->ma
8d60: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
8d70: 52 55 4e 20 7c 7c 20 70 4f 74 68 65 72 2d 3e 70  RUN || pOther->p
8d80: 63 3c 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a  c<0 ) continue;.
8d90: 20 20 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73      closeAllCurs
8da0: 6f 72 73 28 70 4f 74 68 65 72 29 3b 0a 20 20 20  ors(pOther);.   
8db0: 20 70 4f 74 68 65 72 2d 3e 61 62 6f 72 74 65 64   pOther->aborted
8dc0: 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 20   = 1;.  }.}../* 
8dd0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
8de0: 20 63 68 65 63 6b 73 20 74 68 61 74 20 74 68 65   checks that the
8df0: 20 73 71 6c 69 74 65 33 2e 61 63 74 69 76 65 56   sqlite3.activeV
8e00: 64 62 65 43 6e 74 20 63 6f 75 6e 74 20 76 61 72  dbeCnt count var
8e10: 69 61 62 6c 65 0a 2a 2a 20 6d 61 74 63 68 65 73  iable.** matches
8e20: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76   the number of v
8e30: 64 62 65 27 73 20 69 6e 20 74 68 65 20 6c 69 73  dbe's in the lis
8e40: 74 20 73 71 6c 69 74 65 33 2e 70 56 64 62 65 20  t sqlite3.pVdbe 
8e50: 74 68 61 74 20 61 72 65 0a 2a 2a 20 63 75 72 72  that are.** curr
8e60: 65 6e 74 6c 79 20 61 63 74 69 76 65 2e 20 41 6e  ently active. An
8e70: 20 61 73 73 65 72 74 69 6f 6e 20 66 61 69 6c 73   assertion fails
8e80: 20 69 66 20 74 68 65 20 74 77 6f 20 63 6f 75 6e   if the two coun
8e90: 74 73 20 64 6f 20 6e 6f 74 20 6d 61 74 63 68 2e  ts do not match.
8ea0: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 6e 20 69  .** This is an i
8eb0: 6e 74 65 72 6e 61 6c 20 73 65 6c 66 2d 63 68 65  nternal self-che
8ec0: 63 6b 20 6f 6e 6c 79 20 2d 20 69 74 20 69 73 20  ck only - it is 
8ed0: 6e 6f 74 20 61 6e 20 65 73 73 65 6e 74 69 61 6c  not an essential
8ee0: 20 70 72 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 73   processing.** s
8ef0: 74 65 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  tep..**.** This 
8f00: 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 4e 44  is a no-op if ND
8f10: 45 42 55 47 20 69 73 20 64 65 66 69 6e 65 64 2e  EBUG is defined.
8f20: 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 42  .*/.#ifndef NDEB
8f30: 55 47 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63  UG.static void c
8f40: 68 65 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e  heckActiveVdbeCn
8f50: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  t(sqlite3 *db){.
8f60: 20 20 56 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74    Vdbe *p;.  int
8f70: 20 63 6e 74 20 3d 20 30 3b 0a 20 20 70 20 3d 20   cnt = 0;.  p = 
8f80: 64 62 2d 3e 70 56 64 62 65 3b 0a 20 20 77 68 69  db->pVdbe;.  whi
8f90: 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 69 66 28  le( p ){.    if(
8fa0: 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f   p->magic==VDBE_
8fb0: 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e  MAGIC_RUN && p->
8fc0: 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 63  pc>=0 ){.      c
8fd0: 6e 74 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  nt++;.    }.    
8fe0: 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20  p = p->pNext;.  
8ff0: 7d 0a 20 20 61 73 73 65 72 74 28 20 63 6e 74 3d  }.  assert( cnt=
9000: 3d 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43  =db->activeVdbeC
9010: 6e 74 20 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64  nt );.}.#else.#d
9020: 65 66 69 6e 65 20 63 68 65 63 6b 41 63 74 69 76  efine checkActiv
9030: 65 56 64 62 65 43 6e 74 28 78 29 0a 23 65 6e 64  eVdbeCnt(x).#end
9040: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  if../*.** This r
9050: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64  outine is called
9060: 20 74 68 65 20 77 68 65 6e 20 61 20 56 44 42 45   the when a VDBE
9070: 20 74 72 69 65 73 20 74 6f 20 68 61 6c 74 2e 20   tries to halt. 
9080: 20 49 66 20 74 68 65 20 56 44 42 45 0a 2a 2a 20   If the VDBE.** 
9090: 68 61 73 20 6d 61 64 65 20 63 68 61 6e 67 65 73  has made changes
90a0: 20 61 6e 64 20 69 73 20 69 6e 20 61 75 74 6f 63   and is in autoc
90b0: 6f 6d 6d 69 74 20 6d 6f 64 65 2c 20 74 68 65 6e  ommit mode, then
90c0: 20 63 6f 6d 6d 69 74 20 74 68 6f 73 65 0a 2a 2a   commit those.**
90d0: 20 63 68 61 6e 67 65 73 2e 20 20 49 66 20 61 20   changes.  If a 
90e0: 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6e 65 65 64  rollback is need
90f0: 65 64 2c 20 74 68 65 6e 20 64 6f 20 74 68 65 20  ed, then do the 
9100: 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20  rollback..**.** 
9110: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
9120: 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20  the only way to 
9130: 6d 6f 76 65 20 74 68 65 20 73 74 61 74 65 20 6f  move the state o
9140: 66 20 61 20 56 4d 20 66 72 6f 6d 0a 2a 2a 20 53  f a VM from.** S
9150: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 52 55 4e 20  QLITE_MAGIC_RUN 
9160: 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  to SQLITE_MAGIC_
9170: 48 41 4c 54 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75  HALT..**.** Retu
9180: 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65  rn an error code
9190: 2e 20 20 49 66 20 74 68 65 20 63 6f 6d 6d 69 74  .  If the commit
91a0: 20 63 6f 75 6c 64 20 6e 6f 74 20 63 6f 6d 70 6c   could not compl
91b0: 65 74 65 20 62 65 63 61 75 73 65 20 6f 66 0a 2a  ete because of.*
91c0: 2a 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f  * lock contentio
91d0: 6e 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  n, return SQLITE
91e0: 5f 42 55 53 59 2e 20 20 49 66 20 53 51 4c 49 54  _BUSY.  If SQLIT
91f0: 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 72 6e  E_BUSY is return
9200: 65 64 2c 20 69 74 0a 2a 2a 20 6d 65 61 6e 73 20  ed, it.** means 
9210: 74 68 65 20 63 6c 6f 73 65 20 64 69 64 20 6e 6f  the close did no
9220: 74 20 68 61 70 70 65 6e 20 61 6e 64 20 6e 65 65  t happen and nee
9230: 64 73 20 74 6f 20 62 65 20 72 65 70 65 61 74 65  ds to be repeate
9240: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  d..*/.int sqlite
9250: 33 56 64 62 65 48 61 6c 74 28 56 64 62 65 20 2a  3VdbeHalt(Vdbe *
9260: 70 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  p){.  sqlite3 *d
9270: 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69 6e 74  b = p->db;.  int
9280: 20 69 3b 0a 20 20 69 6e 74 20 28 2a 78 46 75 6e   i;.  int (*xFun
9290: 63 29 28 42 74 72 65 65 20 2a 70 42 74 29 20 3d  c)(Btree *pBt) =
92a0: 20 30 3b 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e   0;  /* Function
92b0: 20 74 6f 20 63 61 6c 6c 20 6f 6e 20 65 61 63 68   to call on each
92c0: 20 62 74 72 65 65 20 62 61 63 6b 65 6e 64 20 2a   btree backend *
92d0: 2f 0a 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69  /..  if( p->magi
92e0: 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c!=VDBE_MAGIC_RU
92f0: 4e 20 29 7b 0a 20 20 20 20 2f 2a 20 41 6c 72 65  N ){.    /* Alre
9300: 61 64 79 20 68 61 6c 74 65 64 2e 20 20 4e 6f 74  ady halted.  Not
9310: 68 69 6e 67 20 74 6f 20 64 6f 2e 20 2a 2f 0a 20  hing to do. */. 
9320: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61     assert( p->ma
9330: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
9340: 48 41 4c 54 20 29 3b 0a 20 20 20 20 72 65 74 75  HALT );.    retu
9350: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
9360: 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73  }.  closeAllCurs
9370: 6f 72 73 28 70 29 3b 0a 20 20 63 68 65 63 6b 41  ors(p);.  checkA
9380: 63 74 69 76 65 56 64 62 65 43 6e 74 28 64 62 29  ctiveVdbeCnt(db)
9390: 3b 0a 20 20 69 66 28 20 70 2d 3e 70 63 3c 30 20  ;.  if( p->pc<0 
93a0: 29 7b 0a 20 20 20 20 2f 2a 20 4e 6f 20 63 6f 6d  ){.    /* No com
93b0: 6d 69 74 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20  mit or rollback 
93c0: 6e 65 65 64 65 64 20 69 66 20 74 68 65 20 70 72  needed if the pr
93d0: 6f 67 72 61 6d 20 6e 65 76 65 72 20 73 74 61 72  ogram never star
93e0: 74 65 64 20 2a 2f 0a 20 20 7d 65 6c 73 65 20 69  ted */.  }else i
93f0: 66 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69  f( db->autoCommi
9400: 74 20 26 26 20 64 62 2d 3e 61 63 74 69 76 65 56  t && db->activeV
9410: 64 62 65 43 6e 74 3d 3d 31 20 29 7b 0a 20 20 20  dbeCnt==1 ){.   
9420: 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49   if( p->rc==SQLI
9430: 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72 6f  TE_OK || p->erro
9440: 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c  rAction==OE_Fail
9450: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 65   ){.      /* The
9460: 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61   auto-commit fla
9470: 67 20 69 73 20 74 72 75 65 2c 20 74 68 65 72 65  g is true, there
9480: 20 61 72 65 20 6e 6f 20 6f 74 68 65 72 20 61 63   are no other ac
9490: 74 69 76 65 20 71 75 65 72 69 65 73 0a 20 20 20  tive queries.   
94a0: 20 20 20 2a 2a 20 75 73 69 6e 67 20 74 68 69 73     ** using this
94b0: 20 68 61 6e 64 6c 65 20 61 6e 64 20 74 68 65 20   handle and the 
94c0: 76 64 62 65 20 70 72 6f 67 72 61 6d 20 77 61 73  vdbe program was
94d0: 20 73 75 63 63 65 73 73 66 75 6c 20 6f 72 20 68   successful or h
94e0: 69 74 20 61 6e 0a 20 20 20 20 20 20 2a 2a 20 27  it an.      ** '
94f0: 4f 52 20 46 41 49 4c 27 20 63 6f 6e 73 74 72 61  OR FAIL' constra
9500: 69 6e 74 2e 20 54 68 69 73 20 6d 65 61 6e 73 20  int. This means 
9510: 61 20 63 6f 6d 6d 69 74 20 69 73 20 72 65 71 75  a commit is requ
9520: 69 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  ired..      */. 
9530: 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20 76 64       int rc = vd
9540: 62 65 43 6f 6d 6d 69 74 28 64 62 29 3b 0a 20 20  beCommit(db);.  
9550: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
9560: 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20  TE_BUSY ){.     
9570: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
9580: 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 7d 65 6c  _BUSY;.      }el
9590: 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  se if( rc!=SQLIT
95a0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20  E_OK ){.        
95b0: 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20  p->rc = rc;.    
95c0: 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c 69      xFunc = sqli
95d0: 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  te3BtreeRollback
95e0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65  ;.      }.    }e
95f0: 6c 73 65 7b 0a 20 20 20 20 20 20 78 46 75 6e 63  lse{.      xFunc
9600: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 52   = sqlite3BtreeR
9610: 6f 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 7d 0a 20  ollback;.    }. 
9620: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20   }else{.    if( 
9630: 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  p->rc==SQLITE_OK
9640: 20 7c 7c 20 70 2d 3e 65 72 72 6f 72 41 63 74 69   || p->errorActi
9650: 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20 29 7b 0a 20  on==OE_Fail ){. 
9660: 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c       xFunc = sql
9670: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 53  ite3BtreeCommitS
9680: 74 6d 74 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69  tmt;.    }else i
9690: 66 28 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f  f( p->errorActio
96a0: 6e 3d 3d 4f 45 5f 41 62 6f 72 74 20 29 7b 0a 20  n==OE_Abort ){. 
96b0: 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c       xFunc = sql
96c0: 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63  ite3BtreeRollbac
96d0: 6b 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c 73 65  kStmt;.    }else
96e0: 7b 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20  {.      xFunc = 
96f0: 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c  sqlite3BtreeRoll
9700: 62 61 63 6b 3b 0a 20 20 20 20 20 20 64 62 2d 3e  back;.      db->
9710: 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a  autoCommit = 1;.
9720: 20 20 20 20 20 20 61 62 6f 72 74 4f 74 68 65 72        abortOther
9730: 41 63 74 69 76 65 56 64 62 65 73 28 70 29 3b 0a  ActiveVdbes(p);.
9740: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
9750: 49 66 20 78 46 75 6e 63 20 69 73 20 6e 6f 74 20  If xFunc is not 
9760: 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 74 20 69 73  NULL, then it is
9770: 20 6f 6e 65 20 6f 66 20 73 71 6c 69 74 65 33 42   one of sqlite3B
9780: 74 72 65 65 52 6f 6c 6c 62 61 63 6b 2c 0a 20 20  treeRollback,.  
9790: 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 52  ** sqlite3BtreeR
97a0: 6f 6c 6c 62 61 63 6b 53 74 6d 74 20 6f 72 20 73  ollbackStmt or s
97b0: 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69  qlite3BtreeCommi
97c0: 74 53 74 6d 74 2e 20 43 61 6c 6c 20 69 74 20 6f  tStmt. Call it o
97d0: 6e 63 65 20 6f 6e 0a 20 20 2a 2a 20 65 61 63 68  nce on.  ** each
97e0: 20 62 61 63 6b 65 6e 64 2e 20 49 66 20 61 6e 20   backend. If an 
97f0: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61 6e 64  error occurs and
9800: 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65   the return code
9810: 20 69 73 20 73 74 69 6c 6c 0a 20 20 2a 2a 20 53   is still.  ** S
9820: 51 4c 49 54 45 5f 4f 4b 2c 20 73 65 74 20 74 68  QLITE_OK, set th
9830: 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 74 6f  e return code to
9840: 20 74 68 65 20 6e 65 77 20 65 72 72 6f 72 20 76   the new error v
9850: 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72  alue..  */.  for
9860: 28 69 3d 30 3b 20 78 46 75 6e 63 20 26 26 20 69  (i=0; xFunc && i
9870: 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20  <db->nDb; i++){ 
9880: 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20  .    int rc;.   
9890: 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62   Btree *pBt = db
98a0: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20  ->aDb[i].pBt;.  
98b0: 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20    if( pBt ){.   
98c0: 20 20 20 72 63 20 3d 20 78 46 75 6e 63 28 70 42     rc = xFunc(pB
98d0: 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 2d  t);.      if( p-
98e0: 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29  >rc==SQLITE_OK )
98f0: 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20   p->rc = rc;.   
9900: 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20   }.  }..  /* If 
9910: 74 68 69 73 20 77 61 73 20 61 6e 20 49 4e 53 45  this was an INSE
9920: 52 54 2c 20 55 50 44 41 54 45 20 6f 72 20 44 45  RT, UPDATE or DE
9930: 4c 45 54 45 2c 20 73 65 74 20 74 68 65 20 63 68  LETE, set the ch
9940: 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20 2a 2f  ange counter. */
9950: 0a 20 20 69 66 28 20 70 2d 3e 63 68 61 6e 67 65  .  if( p->change
9960: 43 6e 74 4f 6e 20 26 26 20 70 2d 3e 70 63 3e 3d  CntOn && p->pc>=
9970: 30 20 29 7b 0a 20 20 20 20 69 66 28 20 21 78 46  0 ){.    if( !xF
9980: 75 6e 63 20 7c 7c 20 78 46 75 6e 63 3d 3d 73 71  unc || xFunc==sq
9990: 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74  lite3BtreeCommit
99a0: 53 74 6d 74 20 29 7b 0a 20 20 20 20 20 20 73 71  Stmt ){.      sq
99b0: 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61 6e  lite3VdbeSetChan
99c0: 67 65 73 28 64 62 2c 20 70 2d 3e 6e 43 68 61 6e  ges(db, p->nChan
99d0: 67 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  ge);.    }else{.
99e0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
99f0: 65 53 65 74 43 68 61 6e 67 65 73 28 64 62 2c 20  eSetChanges(db, 
9a00: 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d  0);.    }.    p-
9a10: 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 20 20  >nChange = 0;.  
9a20: 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b  }..  /* Rollback
9a30: 20 6f 72 20 63 6f 6d 6d 69 74 20 61 6e 79 20 73   or commit any s
9a40: 63 68 65 6d 61 20 63 68 61 6e 67 65 73 20 74 68  chema changes th
9a50: 61 74 20 6f 63 63 75 72 72 65 64 2e 20 2a 2f 0a  at occurred. */.
9a60: 20 20 69 66 28 20 70 2d 3e 72 63 21 3d 53 51 4c    if( p->rc!=SQL
9a70: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71  ITE_OK ){.    sq
9a80: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 49 6e 74  lite3RollbackInt
9a90: 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29  ernalChanges(db)
9aa0: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62  ;.  }else if( db
9ab0: 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45  ->flags & SQLITE
9ac0: 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 29  _InternChanges )
9ad0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6d  {.    sqlite3Com
9ae0: 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67  mitInternalChang
9af0: 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20 20 2f  es(db);.  }..  /
9b00: 2a 20 57 65 20 68 61 76 65 20 73 75 63 63 65 73  * We have succes
9b10: 73 66 75 6c 6c 79 20 68 61 6c 74 65 64 20 61 6e  sfully halted an
9b20: 64 20 63 6c 6f 73 65 64 20 74 68 65 20 56 4d 2e  d closed the VM.
9b30: 20 20 52 65 63 6f 72 64 20 74 68 69 73 20 66 61    Record this fa
9b40: 63 74 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e  ct. */.  if( p->
9b50: 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d  pc>=0 ){.    db-
9b60: 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 2d 2d  >activeVdbeCnt--
9b70: 3b 0a 20 20 7d 0a 20 20 70 2d 3e 6d 61 67 69 63  ;.  }.  p->magic
9b80: 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 48 41   = VDBE_MAGIC_HA
9b90: 4c 54 3b 0a 20 20 63 68 65 63 6b 41 63 74 69 76  LT;.  checkActiv
9ba0: 65 56 64 62 65 43 6e 74 28 64 62 29 3b 0a 0a 20  eVdbeCnt(db);.. 
9bb0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
9bc0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61  K;.}../*.** Clea
9bd0: 6e 20 75 70 20 61 20 56 44 42 45 20 61 66 74 65  n up a VDBE afte
9be0: 72 20 65 78 65 63 75 74 69 6f 6e 20 62 75 74 20  r execution but 
9bf0: 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74 68  do not delete th
9c00: 65 20 56 44 42 45 20 6a 75 73 74 20 79 65 74 2e  e VDBE just yet.
9c10: 0a 2a 2a 20 57 72 69 74 65 20 61 6e 79 20 65 72  .** Write any er
9c20: 72 6f 72 20 6d 65 73 73 61 67 65 73 20 69 6e 74  ror messages int
9c30: 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 20 20 52 65  o *pzErrMsg.  Re
9c40: 74 75 72 6e 20 74 68 65 20 72 65 73 75 6c 74 20  turn the result 
9c50: 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65  code..**.** Afte
9c60: 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69  r this routine i
9c70: 73 20 72 75 6e 2c 20 74 68 65 20 56 44 42 45 20  s run, the VDBE 
9c80: 73 68 6f 75 6c 64 20 62 65 20 72 65 61 64 79 20  should be ready 
9c90: 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 0a 2a  to be executed.*
9ca0: 2a 20 61 67 61 69 6e 2e 0a 2a 2a 0a 2a 2a 20 54  * again..**.** T
9cb0: 6f 20 6c 6f 6f 6b 20 61 74 20 69 74 20 61 6e 6f  o look at it ano
9cc0: 74 68 65 72 20 77 61 79 2c 20 74 68 69 73 20 72  ther way, this r
9cd0: 6f 75 74 69 6e 65 20 72 65 73 65 74 73 20 74 68  outine resets th
9ce0: 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 0a 2a  e state of the.*
9cf0: 2a 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e  * virtual machin
9d00: 65 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41 47 49  e from VDBE_MAGI
9d10: 43 5f 52 55 4e 20 6f 72 20 56 44 42 45 5f 4d 41  C_RUN or VDBE_MA
9d20: 47 49 43 5f 48 41 4c 54 20 62 61 63 6b 20 74 6f  GIC_HALT back to
9d30: 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  .** VDBE_MAGIC_I
9d40: 4e 49 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  NIT..*/.int sqli
9d50: 74 65 33 56 64 62 65 52 65 73 65 74 28 56 64 62  te3VdbeReset(Vdb
9d60: 65 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e  e *p){.  if( p->
9d70: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
9d80: 43 5f 52 55 4e 20 26 26 20 70 2d 3e 6d 61 67 69  C_RUN && p->magi
9d90: 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41  c!=VDBE_MAGIC_HA
9da0: 4c 54 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  LT ){.    sqlite
9db0: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51  3Error(p->db, SQ
9dc0: 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b  LITE_MISUSE, 0);
9dd0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
9de0: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a  TE_MISUSE;.  }..
9df0: 20 20 2f 2a 20 49 66 20 74 68 65 20 56 4d 20 64    /* If the VM d
9e00: 69 64 20 6e 6f 74 20 72 75 6e 20 74 6f 20 63 6f  id not run to co
9e10: 6d 70 6c 65 74 69 6f 6e 20 6f 72 20 69 66 20 69  mpletion or if i
9e20: 74 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 6e  t encountered an
9e30: 0a 20 20 2a 2a 20 65 72 72 6f 72 2c 20 74 68 65  .  ** error, the
9e40: 6e 20 69 74 20 6d 69 67 68 74 20 6e 6f 74 20 68  n it might not h
9e50: 61 76 65 20 62 65 65 6e 20 68 61 6c 74 65 64 20  ave been halted 
9e60: 70 72 6f 70 65 72 6c 79 2e 20 20 53 6f 20 68 61  properly.  So ha
9e70: 6c 74 0a 20 20 2a 2a 20 69 74 20 6e 6f 77 2e 0a  lt.  ** it now..
9e80: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 56 64    */.  sqlite3Vd
9e90: 62 65 48 61 6c 74 28 70 29 3b 0a 0a 20 20 2f 2a  beHalt(p);..  /*
9ea0: 20 49 66 20 74 68 65 20 56 44 42 45 20 68 61 73   If the VDBE has
9eb0: 20 62 65 20 72 75 6e 20 65 76 65 6e 20 70 61 72   be run even par
9ec0: 74 69 61 6c 6c 79 2c 20 74 68 65 6e 20 74 72 61  tially, then tra
9ed0: 6e 73 66 65 72 20 74 68 65 20 65 72 72 6f 72 20  nsfer the error 
9ee0: 63 6f 64 65 0a 20 20 2a 2a 20 61 6e 64 20 65 72  code.  ** and er
9ef0: 72 6f 72 20 6d 65 73 73 61 67 65 20 66 72 6f 6d  ror message from
9f00: 20 74 68 65 20 56 44 42 45 20 69 6e 74 6f 20 74   the VDBE into t
9f10: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
9f20: 20 73 74 72 75 63 74 75 72 65 2e 20 20 42 75 74   structure.  But
9f30: 0a 20 20 2a 2a 20 69 66 20 74 68 65 20 56 44 42  .  ** if the VDB
9f40: 45 20 68 61 73 20 6a 75 73 74 20 62 65 65 6e 20  E has just been 
9f50: 73 65 74 20 74 6f 20 72 75 6e 20 62 75 74 20 68  set to run but h
9f60: 61 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20  as not actually 
9f70: 65 78 65 63 75 74 65 64 20 61 6e 79 0a 20 20 2a  executed any.  *
9f80: 2a 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 79  * instructions y
9f90: 65 74 2c 20 6c 65 61 76 65 20 74 68 65 20 6d 61  et, leave the ma
9fa0: 69 6e 20 64 61 74 61 62 61 73 65 20 65 72 72 6f  in database erro
9fb0: 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 6e  r information un
9fc0: 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2f 0a 20 20  changed..  */.  
9fd0: 69 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a  if( p->pc>=0 ){.
9fe0: 20 20 20 20 69 66 28 20 70 2d 3e 7a 45 72 72 4d      if( p->zErrM
9ff0: 73 67 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  sg ){.      sqli
a000: 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20  te3Error(p->db, 
a010: 70 2d 3e 72 63 2c 20 22 25 73 22 2c 20 70 2d 3e  p->rc, "%s", p->
a020: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20  zErrMsg);.      
a030: 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 7a 45  sqliteFree(p->zE
a040: 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 70 2d  rrMsg);.      p-
a050: 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20  >zErrMsg = 0;.  
a060: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 72    }else if( p->r
a070: 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  c ){.      sqlit
a080: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70  e3Error(p->db, p
a090: 2d 3e 72 63 2c 20 30 29 3b 0a 20 20 20 20 7d 65  ->rc, 0);.    }e
a0a0: 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  lse{.      sqlit
a0b0: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53  e3Error(p->db, S
a0c0: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20  QLITE_OK, 0);.  
a0d0: 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20    }.  }else if( 
a0e0: 70 2d 3e 72 63 20 26 26 20 70 2d 3e 65 78 70 69  p->rc && p->expi
a0f0: 72 65 64 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68  red ){.    /* Th
a100: 65 20 65 78 70 69 72 65 64 20 66 6c 61 67 20 77  e expired flag w
a110: 61 73 20 73 65 74 20 6f 6e 20 74 68 65 20 56 44  as set on the VD
a120: 42 45 20 62 65 66 6f 72 65 20 74 68 65 20 66 69  BE before the fi
a130: 72 73 74 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20  rst call.    ** 
a140: 74 6f 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28  to sqlite3_step(
a150: 29 2e 20 46 6f 72 20 63 6f 6e 73 69 73 74 65 6e  ). For consisten
a160: 63 79 20 28 73 69 6e 63 65 20 73 71 6c 69 74 65  cy (since sqlite
a170: 33 5f 73 74 65 70 28 29 20 77 61 73 0a 20 20 20  3_step() was.   
a180: 20 2a 2a 20 63 61 6c 6c 65 64 29 2c 20 73 65 74   ** called), set
a190: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 65 72   the database er
a1a0: 72 6f 72 20 69 6e 20 74 68 69 73 20 63 61 73 65  ror in this case
a1b0: 20 61 73 20 77 65 6c 6c 2e 0a 20 20 20 20 2a 2f   as well..    */
a1c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
a1d0: 72 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 2c 20  r(p->db, p->rc, 
a1e0: 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65  0);.  }..  /* Re
a1f0: 63 6c 61 69 6d 20 61 6c 6c 20 6d 65 6d 6f 72 79  claim all memory
a200: 20 75 73 65 64 20 62 79 20 74 68 65 20 56 44 42   used by the VDB
a210: 45 0a 20 20 2a 2f 0a 20 20 43 6c 65 61 6e 75 70  E.  */.  Cleanup
a220: 28 70 29 3b 0a 0a 20 20 2f 2a 20 53 61 76 65 20  (p);..  /* Save 
a230: 70 72 6f 66 69 6c 69 6e 67 20 69 6e 66 6f 72 6d  profiling inform
a240: 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 69 73 20  ation from this 
a250: 56 44 42 45 20 72 75 6e 2e 0a 20 20 2a 2f 0a 20  VDBE run..  */. 
a260: 20 61 73 73 65 72 74 28 20 70 2d 3e 70 54 6f 73   assert( p->pTos
a270: 3c 26 70 2d 3e 61 53 74 61 63 6b 5b 70 2d 3e 70  <&p->aStack[p->p
a280: 63 3c 30 3f 30 3a 70 2d 3e 70 63 5d 20 7c 7c 20  c<0?0:p->pc] || 
a290: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
a2a0: 61 69 6c 65 64 3d 3d 31 20 29 3b 0a 23 69 66 64  ailed==1 );.#ifd
a2b0: 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45 0a  ef VDBE_PROFILE.
a2c0: 20 20 7b 0a 20 20 20 20 46 49 4c 45 20 2a 6f 75    {.    FILE *ou
a2d0: 74 20 3d 20 66 6f 70 65 6e 28 22 76 64 62 65 5f  t = fopen("vdbe_
a2e0: 70 72 6f 66 69 6c 65 2e 6f 75 74 22 2c 20 22 61  profile.out", "a
a2f0: 22 29 3b 0a 20 20 20 20 69 66 28 20 6f 75 74 20  ");.    if( out 
a300: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a  ){.      int i;.
a310: 20 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75        fprintf(ou
a320: 74 2c 20 22 2d 2d 2d 2d 20 22 29 3b 0a 20 20 20  t, "---- ");.   
a330: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d     for(i=0; i<p-
a340: 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  >nOp; i++){.    
a350: 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c      fprintf(out,
a360: 20 22 25 30 32 78 22 2c 20 70 2d 3e 61 4f 70 5b   "%02x", p->aOp[
a370: 69 5d 2e 6f 70 63 6f 64 65 29 3b 0a 20 20 20 20  i].opcode);.    
a380: 20 20 7d 0a 20 20 20 20 20 20 66 70 72 69 6e 74    }.      fprint
a390: 66 28 6f 75 74 2c 20 22 5c 6e 22 29 3b 0a 20 20  f(out, "\n");.  
a3a0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
a3b0: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nOp; i++){.   
a3c0: 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74       fprintf(out
a3d0: 2c 20 22 25 36 64 20 25 31 30 6c 6c 64 20 25 38  , "%6d %10lld %8
a3e0: 6c 6c 64 20 22 2c 0a 20 20 20 20 20 20 20 20 20  lld ",.         
a3f0: 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 2c    p->aOp[i].cnt,
a400: 0a 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61  .           p->a
a410: 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 2c 0a 20 20  Op[i].cycles,.  
a420: 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b           p->aOp[
a430: 69 5d 2e 63 6e 74 3e 30 20 3f 20 70 2d 3e 61 4f  i].cnt>0 ? p->aO
a440: 70 5b 69 5d 2e 63 79 63 6c 65 73 2f 70 2d 3e 61  p[i].cycles/p->a
a450: 4f 70 5b 69 5d 2e 63 6e 74 20 3a 20 30 0a 20 20  Op[i].cnt : 0.  
a460: 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20        );.       
a470: 20 73 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e   sqlite3VdbePrin
a480: 74 4f 70 28 6f 75 74 2c 20 69 2c 20 26 70 2d 3e  tOp(out, i, &p->
a490: 61 4f 70 5b 69 5d 29 3b 0a 20 20 20 20 20 20 7d  aOp[i]);.      }
a4a0: 0a 20 20 20 20 20 20 66 63 6c 6f 73 65 28 6f 75  .      fclose(ou
a4b0: 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65  t);.    }.  }.#e
a4c0: 6e 64 69 66 0a 20 20 70 2d 3e 6d 61 67 69 63 20  ndif.  p->magic 
a4d0: 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  = VDBE_MAGIC_INI
a4e0: 54 3b 0a 20 20 70 2d 3e 61 62 6f 72 74 65 64 20  T;.  p->aborted 
a4f0: 3d 20 30 3b 0a 20 20 69 66 28 20 70 2d 3e 72 63  = 0;.  if( p->rc
a500: 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20  ==SQLITE_SCHEMA 
a510: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65  ){.    sqlite3Re
a520: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
a530: 61 28 70 2d 3e 64 62 2c 20 30 29 3b 0a 20 20 7d  a(p->db, 0);.  }
a540: 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 72 63 3b  .  return p->rc;
a550: 0a 7d 0a 20 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e  .}. ./*.** Clean
a560: 20 75 70 20 61 6e 64 20 64 65 6c 65 74 65 20 61   up and delete a
a570: 20 56 44 42 45 20 61 66 74 65 72 20 65 78 65 63   VDBE after exec
a580: 75 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20 61  ution.  Return a
a590: 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20  n integer which 
a5a0: 69 73 0a 2a 2a 20 74 68 65 20 72 65 73 75 6c 74  is.** the result
a5b0: 20 63 6f 64 65 2e 20 20 57 72 69 74 65 20 61 6e   code.  Write an
a5c0: 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20  y error message 
a5d0: 74 65 78 74 20 69 6e 74 6f 20 2a 70 7a 45 72 72  text into *pzErr
a5e0: 4d 73 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  Msg..*/.int sqli
a5f0: 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28  te3VdbeFinalize(
a600: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20  Vdbe *p){.  int 
a610: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
a620: 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 3d  .  if( p->magic=
a630: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20  =VDBE_MAGIC_RUN 
a640: 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  || p->magic==VDB
a650: 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 7b 0a  E_MAGIC_HALT ){.
a660: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
a670: 56 64 62 65 52 65 73 65 74 28 70 29 3b 0a 20 20  VdbeReset(p);.  
a680: 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6d 61 67  }else if( p->mag
a690: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49  ic!=VDBE_MAGIC_I
a6a0: 4e 49 54 20 29 7b 0a 20 20 20 20 72 65 74 75 72  NIT ){.    retur
a6b0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
a6c0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 64  .  }.  sqlite3Vd
a6d0: 62 65 44 65 6c 65 74 65 28 70 29 3b 0a 20 20 72  beDelete(p);.  r
a6e0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
a6f0: 2a 2a 20 43 61 6c 6c 20 74 68 65 20 64 65 73 74  ** Call the dest
a700: 72 75 63 74 6f 72 20 66 6f 72 20 65 61 63 68 20  ructor for each 
a710: 61 75 78 64 61 74 61 20 65 6e 74 72 79 20 69 6e  auxdata entry in
a720: 20 70 56 64 62 65 46 75 6e 63 20 66 6f 72 20 77   pVdbeFunc for w
a730: 68 69 63 68 0a 2a 2a 20 74 68 65 20 63 6f 72 72  hich.** the corr
a740: 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 69 6e  esponding bit in
a750: 20 6d 61 73 6b 20 69 73 20 63 6c 65 61 72 2e 20   mask is clear. 
a760: 20 41 75 78 64 61 74 61 20 65 6e 74 72 69 65 73   Auxdata entries
a770: 20 62 65 79 6f 6e 64 20 33 31 0a 2a 2a 20 61 72   beyond 31.** ar
a780: 65 20 61 6c 77 61 79 73 20 64 65 73 74 72 6f 79  e always destroy
a790: 65 64 2e 20 20 54 6f 20 64 65 73 74 72 6f 79 20  ed.  To destroy 
a7a0: 61 6c 6c 20 61 75 78 64 61 74 61 20 65 6e 74 72  all auxdata entr
a7b0: 69 65 73 2c 20 63 61 6c 6c 20 74 68 69 73 0a 2a  ies, call this.*
a7c0: 2a 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20 6d  * routine with m
a7d0: 61 73 6b 3d 3d 30 2e 0a 2a 2f 0a 76 6f 69 64 20  ask==0..*/.void 
a7e0: 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74  sqlite3VdbeDelet
a7f0: 65 41 75 78 44 61 74 61 28 56 64 62 65 46 75 6e  eAuxData(VdbeFun
a800: 63 20 2a 70 56 64 62 65 46 75 6e 63 2c 20 69 6e  c *pVdbeFunc, in
a810: 74 20 6d 61 73 6b 29 7b 0a 20 20 69 6e 74 20 69  t mask){.  int i
a820: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70  ;.  for(i=0; i<p
a830: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 3b 20  VdbeFunc->nAux; 
a840: 69 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74  i++){.    struct
a850: 20 41 75 78 44 61 74 61 20 2a 70 41 75 78 20 3d   AuxData *pAux =
a860: 20 26 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41   &pVdbeFunc->apA
a870: 75 78 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20 28  ux[i];.    if( (
a880: 69 3e 33 31 20 7c 7c 20 21 28 6d 61 73 6b 26 28  i>31 || !(mask&(
a890: 31 3c 3c 69 29 29 29 20 26 26 20 70 41 75 78 2d  1<<i))) && pAux-
a8a0: 3e 70 41 75 78 20 29 7b 0a 20 20 20 20 20 20 69  >pAux ){.      i
a8b0: 66 28 20 70 41 75 78 2d 3e 78 44 65 6c 65 74 65  f( pAux->xDelete
a8c0: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 41 75 78   ){.        pAux
a8d0: 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78 2d 3e  ->xDelete(pAux->
a8e0: 70 41 75 78 29 3b 0a 20 20 20 20 20 20 7d 0a 20  pAux);.      }. 
a8f0: 20 20 20 20 20 70 41 75 78 2d 3e 70 41 75 78 20       pAux->pAux 
a900: 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d  = 0;.    }.  }.}
a910: 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65 20 61  ../*.** Delete a
a920: 6e 20 65 6e 74 69 72 65 20 56 44 42 45 2e 0a 2a  n entire VDBE..*
a930: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
a940: 62 65 44 65 6c 65 74 65 28 56 64 62 65 20 2a 70  beDelete(Vdbe *p
a950: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66  ){.  int i;.  if
a960: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  ( p==0 ) return;
a970: 0a 20 20 43 6c 65 61 6e 75 70 28 70 29 3b 0a 20  .  Cleanup(p);. 
a980: 20 69 66 28 20 70 2d 3e 70 50 72 65 76 20 29 7b   if( p->pPrev ){
a990: 0a 20 20 20 20 70 2d 3e 70 50 72 65 76 2d 3e 70  .    p->pPrev->p
a9a0: 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b  Next = p->pNext;
a9b0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
a9c0: 73 65 72 74 28 20 70 2d 3e 64 62 2d 3e 70 56 64  sert( p->db->pVd
a9d0: 62 65 3d 3d 70 20 29 3b 0a 20 20 20 20 70 2d 3e  be==p );.    p->
a9e0: 64 62 2d 3e 70 56 64 62 65 20 3d 20 70 2d 3e 70  db->pVdbe = p->p
a9f0: 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Next;.  }.  if( 
aa00: 70 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20  p->pNext ){.    
aa10: 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20  p->pNext->pPrev 
aa20: 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 20 20 7d 0a  = p->pPrev;.  }.
aa30: 20 20 69 66 28 20 70 2d 3e 61 4f 70 20 29 7b 0a    if( p->aOp ){.
aa40: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
aa50: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nOp; i++){.   
aa60: 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26 70 2d     Op *pOp = &p-
aa70: 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 20 20 69  >aOp[i];.      i
aa80: 66 28 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d  f( pOp->p3type==
aa90: 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 70 4f  P3_DYNAMIC || pO
aaa0: 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 4b 45  p->p3type==P3_KE
aab0: 59 49 4e 46 4f 20 29 7b 0a 20 20 20 20 20 20 20  YINFO ){.       
aac0: 20 73 71 6c 69 74 65 46 72 65 65 28 70 4f 70 2d   sqliteFree(pOp-
aad0: 3e 70 33 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  >p3);.      }.  
aae0: 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 33 74      if( pOp->p3t
aaf0: 79 70 65 3d 3d 50 33 5f 56 44 42 45 46 55 4e 43  ype==P3_VDBEFUNC
ab00: 20 29 7b 0a 20 20 20 20 20 20 20 20 56 64 62 65   ){.        Vdbe
ab10: 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 20  Func *pVdbeFunc 
ab20: 3d 20 28 56 64 62 65 46 75 6e 63 20 2a 29 70 4f  = (VdbeFunc *)pO
ab30: 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 20 20 73  p->p3;.        s
ab40: 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74 65  qlite3VdbeDelete
ab50: 41 75 78 44 61 74 61 28 70 56 64 62 65 46 75 6e  AuxData(pVdbeFun
ab60: 63 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 73  c, 0);.        s
ab70: 71 6c 69 74 65 46 72 65 65 28 70 56 64 62 65 46  qliteFree(pVdbeF
ab80: 75 6e 63 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  unc);.      }.  
ab90: 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 33 74      if( pOp->p3t
aba0: 79 70 65 3d 3d 50 33 5f 4d 45 4d 20 29 7b 0a 20  ype==P3_MEM ){. 
abb0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 61         sqlite3Va
abc0: 6c 75 65 46 72 65 65 28 28 73 71 6c 69 74 65 33  lueFree((sqlite3
abd0: 5f 76 61 6c 75 65 2a 29 70 4f 70 2d 3e 70 33 29  _value*)pOp->p3)
abe0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
abf0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
ac00: 2d 3e 61 4f 70 29 3b 0a 20 20 7d 0a 20 20 72 65  ->aOp);.  }.  re
ac10: 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d  leaseMemArray(p-
ac20: 3e 61 56 61 72 2c 20 70 2d 3e 6e 56 61 72 29 3b  >aVar, p->nVar);
ac30: 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d  .  sqliteFree(p-
ac40: 3e 61 4c 61 62 65 6c 29 3b 0a 20 20 73 71 6c 69  >aLabel);.  sqli
ac50: 74 65 46 72 65 65 28 70 2d 3e 61 53 74 61 63 6b  teFree(p->aStack
ac60: 29 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41  );.  releaseMemA
ac70: 72 72 61 79 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65  rray(p->aColName
ac80: 2c 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 2a  , p->nResColumn*
ac90: 32 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65  2);.  sqliteFree
aca0: 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 29 3b 0a 20  (p->aColName);. 
acb0: 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45   p->magic = VDBE
acc0: 5f 4d 41 47 49 43 5f 44 45 41 44 3b 0a 20 20 73  _MAGIC_DEAD;.  s
acd0: 71 6c 69 74 65 46 72 65 65 28 70 29 3b 0a 7d 0a  qliteFree(p);.}.
ace0: 0a 2f 2a 0a 2a 2a 20 49 66 20 61 20 4d 6f 76 65  ./*.** If a Move
acf0: 54 6f 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20  To operation is 
ad00: 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 67  pending on the g
ad10: 69 76 65 6e 20 63 75 72 73 6f 72 2c 20 74 68 65  iven cursor, the
ad20: 6e 20 64 6f 20 74 68 61 74 0a 2a 2a 20 4d 6f 76  n do that.** Mov
ad30: 65 54 6f 20 6e 6f 77 2e 20 20 52 65 74 75 72 6e  eTo now.  Return
ad40: 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 20   an error code. 
ad50: 20 49 66 20 6e 6f 20 4d 6f 76 65 54 6f 20 69 73   If no MoveTo is
ad60: 20 70 65 6e 64 69 6e 67 2c 20 74 68 69 73 0a 2a   pending, this.*
ad70: 2a 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 6e  * routine does n
ad80: 6f 74 68 69 6e 67 20 61 6e 64 20 72 65 74 75 72  othing and retur
ad90: 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f  ns SQLITE_OK..*/
ada0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
adb0: 43 75 72 73 6f 72 4d 6f 76 65 74 6f 28 43 75 72  CursorMoveto(Cur
adc0: 73 6f 72 20 2a 70 29 7b 0a 20 20 69 66 28 20 70  sor *p){.  if( p
add0: 2d 3e 64 65 66 65 72 72 65 64 4d 6f 76 65 74 6f  ->deferredMoveto
ade0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 65 73 2c   ){.    int res,
adf0: 20 72 63 3b 0a 20 20 20 20 65 78 74 65 72 6e 20   rc;.    extern 
ae00: 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 65 61 72  int sqlite3_sear
ae10: 63 68 5f 63 6f 75 6e 74 3b 0a 20 20 20 20 61 73  ch_count;.    as
ae20: 73 65 72 74 28 20 70 2d 3e 69 73 54 61 62 6c 65  sert( p->isTable
ae30: 20 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 69   );.    if( p->i
ae40: 73 54 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20  sTable ){.      
ae50: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
ae60: 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73  eMoveto(p->pCurs
ae70: 6f 72 2c 20 30 2c 20 70 2d 3e 6d 6f 76 65 74 6f  or, 0, p->moveto
ae80: 54 61 72 67 65 74 2c 20 26 72 65 73 29 3b 0a 20  Target, &res);. 
ae90: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
aea0: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
aeb0: 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73  eMoveto(p->pCurs
aec0: 6f 72 2c 28 63 68 61 72 2a 29 26 70 2d 3e 6d 6f  or,(char*)&p->mo
aed0: 76 65 74 6f 54 61 72 67 65 74 2c 0a 20 20 20 20  vetoTarget,.    
aee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aef0: 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66            sizeof
af00: 28 69 36 34 29 2c 26 72 65 73 29 3b 0a 20 20 20  (i64),&res);.   
af10: 20 7d 0a 20 20 20 20 69 66 28 20 72 63 20 29 20   }.    if( rc ) 
af20: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 2a  return rc;.    *
af30: 70 2d 3e 70 49 6e 63 72 4b 65 79 20 3d 20 30 3b  p->pIncrKey = 0;
af40: 0a 20 20 20 20 70 2d 3e 6c 61 73 74 52 6f 77 69  .    p->lastRowi
af50: 64 20 3d 20 6b 65 79 54 6f 49 6e 74 28 70 2d 3e  d = keyToInt(p->
af60: 6d 6f 76 65 74 6f 54 61 72 67 65 74 29 3b 0a 20  movetoTarget);. 
af70: 20 20 20 70 2d 3e 72 6f 77 69 64 49 73 56 61 6c     p->rowidIsVal
af80: 69 64 20 3d 20 72 65 73 3d 3d 30 3b 0a 20 20 20  id = res==0;.   
af90: 20 69 66 28 20 72 65 73 3c 30 20 29 7b 0a 20 20   if( res<0 ){.  
afa0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
afb0: 42 74 72 65 65 4e 65 78 74 28 70 2d 3e 70 43 75  BtreeNext(p->pCu
afc0: 72 73 6f 72 2c 20 26 72 65 73 29 3b 0a 20 20 20  rsor, &res);.   
afd0: 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75     if( rc ) retu
afe0: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20  rn rc;.    }.   
aff0: 20 73 71 6c 69 74 65 33 5f 73 65 61 72 63 68 5f   sqlite3_search_
b000: 63 6f 75 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e  count++;.    p->
b010: 64 65 66 65 72 72 65 64 4d 6f 76 65 74 6f 20 3d  deferredMoveto =
b020: 20 30 3b 0a 20 20 20 20 70 2d 3e 63 61 63 68 65   0;.    p->cache
b030: 56 61 6c 69 64 20 3d 20 30 3b 0a 20 20 7d 0a 20  Valid = 0;.  }. 
b040: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
b050: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  K;.}../*.** The 
b060: 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69  following functi
b070: 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74  ons:.**.** sqlit
b080: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
b090: 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62  ().** sqlite3Vdb
b0a0: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 29  eSerialTypeLen()
b0b0: 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53  .** sqlite3VdbeS
b0c0: 65 72 69 61 6c 52 65 61 64 28 29 0a 2a 2a 20 73  erialRead().** s
b0d0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
b0e0: 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33  Len().** sqlite3
b0f0: 56 64 62 65 53 65 72 69 61 6c 57 72 69 74 65 28  VdbeSerialWrite(
b100: 29 0a 2a 2a 0a 2a 2a 20 65 6e 63 61 70 73 75 6c  ).**.** encapsul
b110: 61 74 65 20 74 68 65 20 63 6f 64 65 20 74 68 61  ate the code tha
b120: 74 20 73 65 72 69 61 6c 69 7a 65 73 20 76 61 6c  t serializes val
b130: 75 65 73 20 66 6f 72 20 73 74 6f 72 61 67 65 20  ues for storage 
b140: 69 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 64 61 74  in SQLite.** dat
b150: 61 20 61 6e 64 20 69 6e 64 65 78 20 72 65 63 6f  a and index reco
b160: 72 64 73 2e 20 45 61 63 68 20 73 65 72 69 61 6c  rds. Each serial
b170: 69 7a 65 64 20 76 61 6c 75 65 20 63 6f 6e 73 69  ized value consi
b180: 73 74 73 20 6f 66 20 61 0a 2a 2a 20 27 73 65 72  sts of a.** 'ser
b190: 69 61 6c 2d 74 79 70 65 27 20 61 6e 64 20 61 20  ial-type' and a 
b1a0: 62 6c 6f 62 20 6f 66 20 64 61 74 61 2e 20 54 68  blob of data. Th
b1b0: 65 20 73 65 72 69 61 6c 20 74 79 70 65 20 69 73  e serial type is
b1c0: 20 61 6e 20 38 2d 62 79 74 65 20 75 6e 73 69 67   an 8-byte unsig
b1d0: 6e 65 64 0a 2a 2a 20 69 6e 74 65 67 65 72 2c 20  ned.** integer, 
b1e0: 73 74 6f 72 65 64 20 61 73 20 61 20 76 61 72 69  stored as a vari
b1f0: 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 61 6e 20  nt..**.** In an 
b200: 53 51 4c 69 74 65 20 69 6e 64 65 78 20 72 65 63  SQLite index rec
b210: 6f 72 64 2c 20 74 68 65 20 73 65 72 69 61 6c 20  ord, the serial 
b220: 74 79 70 65 20 69 73 20 73 74 6f 72 65 64 20 64  type is stored d
b230: 69 72 65 63 74 6c 79 20 62 65 66 6f 72 65 0a 2a  irectly before.*
b240: 2a 20 74 68 65 20 62 6c 6f 62 20 6f 66 20 64 61  * the blob of da
b250: 74 61 20 74 68 61 74 20 69 74 20 63 6f 72 72 65  ta that it corre
b260: 73 70 6f 6e 64 73 20 74 6f 2e 20 49 6e 20 61 20  sponds to. In a 
b270: 74 61 62 6c 65 20 72 65 63 6f 72 64 2c 20 61 6c  table record, al
b280: 6c 20 73 65 72 69 61 6c 0a 2a 2a 20 74 79 70 65  l serial.** type
b290: 73 20 61 72 65 20 73 74 6f 72 65 64 20 61 74 20  s are stored at 
b2a0: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65  the start of the
b2b0: 20 72 65 63 6f 72 64 2c 20 61 6e 64 20 74 68 65   record, and the
b2c0: 20 62 6c 6f 62 73 20 6f 66 20 64 61 74 61 20 61   blobs of data a
b2d0: 74 0a 2a 2a 20 74 68 65 20 65 6e 64 2e 20 48 65  t.** the end. He
b2e0: 6e 63 65 20 74 68 65 73 65 20 66 75 6e 63 74 69  nce these functi
b2f0: 6f 6e 73 20 61 6c 6c 6f 77 20 74 68 65 20 63 61  ons allow the ca
b300: 6c 6c 65 72 20 74 6f 20 68 61 6e 64 6c 65 20 74  ller to handle t
b310: 68 65 0a 2a 2a 20 73 65 72 69 61 6c 2d 74 79 70  he.** serial-typ
b320: 65 20 61 6e 64 20 64 61 74 61 20 62 6c 6f 62 20  e and data blob 
b330: 73 65 70 65 72 61 74 65 6c 79 2e 0a 2a 2a 0a 2a  seperately..**.*
b340: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
b350: 74 61 62 6c 65 20 64 65 73 63 72 69 62 65 73 20  table describes 
b360: 74 68 65 20 76 61 72 69 6f 75 73 20 73 74 6f 72  the various stor
b370: 61 67 65 20 63 6c 61 73 73 65 73 20 66 6f 72 20  age classes for 
b380: 64 61 74 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 73 65  data:.**.**   se
b390: 72 69 61 6c 20 74 79 70 65 20 20 20 20 20 20 20  rial type       
b3a0: 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 20   bytes of data  
b3b0: 20 20 20 20 74 79 70 65 0a 2a 2a 20 20 20 2d 2d      type.**   --
b3c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20  ------------    
b3d0: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d   ---------------
b3e0: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d      ------------
b3f0: 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 30 20 20 20  ---.**      0   
b400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b410: 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 4e    0            N
b420: 55 4c 4c 0a 2a 2a 20 20 20 20 20 20 31 20 20 20  ULL.**      1   
b430: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b440: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 73    1            s
b450: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a  igned integer.**
b460: 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20        2         
b470: 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20              2   
b480: 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20           signed 
b490: 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20  integer.**      
b4a0: 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  3               
b4b0: 20 20 20 20 20 20 33 20 20 20 20 20 20 20 20 20        3         
b4c0: 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65     signed intege
b4d0: 72 0a 2a 2a 20 20 20 20 20 20 34 20 20 20 20 20  r.**      4     
b4e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b4f0: 34 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67  4            sig
b500: 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20  ned integer.**  
b510: 20 20 20 20 35 20 20 20 20 20 20 20 20 20 20 20      5           
b520: 20 20 20 20 20 20 20 20 20 20 36 20 20 20 20 20            6     
b530: 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e         signed in
b540: 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 36 20  teger.**      6 
b550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b560: 20 20 20 20 38 20 20 20 20 20 20 20 20 20 20 20      8           
b570: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a   signed integer.
b580: 2a 2a 20 20 20 20 20 20 37 20 20 20 20 20 20 20  **      7       
b590: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 38 20                8 
b5a0: 20 20 20 20 20 20 20 20 20 20 20 49 45 45 45 20             IEEE 
b5b0: 66 6c 6f 61 74 0a 2a 2a 20 20 20 20 20 38 2d 31  float.**     8-1
b5c0: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1               
b5d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b5e0: 20 72 65 73 65 72 76 65 64 20 66 6f 72 20 65 78   reserved for ex
b5f0: 70 61 6e 73 69 6f 6e 0a 2a 2a 20 20 20 20 4e 3e  pansion.**    N>
b600: 3d 31 32 20 61 6e 64 20 65 76 65 6e 20 20 20 20  =12 and even    
b610: 20 20 20 28 4e 2d 31 32 29 2f 32 20 20 20 20 20     (N-12)/2     
b620: 20 20 20 42 4c 4f 42 0a 2a 2a 20 20 20 20 4e 3e     BLOB.**    N>
b630: 3d 31 33 20 61 6e 64 20 6f 64 64 20 20 20 20 20  =13 and odd     
b640: 20 20 20 28 4e 2d 31 33 29 2f 32 20 20 20 20 20     (N-13)/2     
b650: 20 20 20 74 65 78 74 0a 2a 2a 0a 2a 2f 0a 0a 2f     text.**.*/../
b660: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
b670: 73 65 72 69 61 6c 2d 74 79 70 65 20 66 6f 72 20  serial-type for 
b680: 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64  the value stored
b690: 20 69 6e 20 70 4d 65 6d 2e 0a 2a 2f 0a 75 33 32   in pMem..*/.u32
b6a0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
b6b0: 61 6c 54 79 70 65 28 4d 65 6d 20 2a 70 4d 65 6d  alType(Mem *pMem
b6c0: 29 7b 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 3d  ){.  int flags =
b6d0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 3b 0a 0a 20   pMem->flags;.. 
b6e0: 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 4e   if( flags&MEM_N
b6f0: 75 6c 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ull ){.    retur
b700: 6e 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66  n 0;.  }.  if( f
b710: 6c 61 67 73 26 4d 45 4d 5f 49 6e 74 20 29 7b 0a  lags&MEM_Int ){.
b720: 20 20 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75      /* Figure ou
b730: 74 20 77 68 65 74 68 65 72 20 74 6f 20 75 73 65  t whether to use
b740: 20 31 2c 20 32 2c 20 34 2c 20 36 20 6f 72 20 38   1, 2, 4, 6 or 8
b750: 20 62 79 74 65 73 2e 20 2a 2f 0a 23 20 20 20 64   bytes. */.#   d
b760: 65 66 69 6e 65 20 4d 41 58 5f 36 42 59 54 45 20  efine MAX_6BYTE 
b770: 28 28 28 28 69 36 34 29 30 78 30 30 30 30 31 30  ((((i64)0x000010
b780: 30 30 29 3c 3c 33 32 29 2d 31 29 0a 20 20 20 20  00)<<32)-1).    
b790: 69 36 34 20 69 20 3d 20 70 4d 65 6d 2d 3e 69 3b  i64 i = pMem->i;
b7a0: 0a 20 20 20 20 75 36 34 20 75 20 3d 20 69 3c 30  .    u64 u = i<0
b7b0: 20 3f 20 2d 69 20 3a 20 69 3b 0a 20 20 20 20 69   ? -i : i;.    i
b7c0: 66 28 20 75 3c 3d 31 32 37 20 29 20 72 65 74 75  f( u<=127 ) retu
b7d0: 72 6e 20 31 3b 0a 20 20 20 20 69 66 28 20 75 3c  rn 1;.    if( u<
b7e0: 3d 33 32 37 36 37 20 29 20 72 65 74 75 72 6e 20  =32767 ) return 
b7f0: 32 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 38 33  2;.    if( u<=83
b800: 38 38 36 30 37 20 29 20 72 65 74 75 72 6e 20 33  88607 ) return 3
b810: 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 32 31 34  ;.    if( u<=214
b820: 37 34 38 33 36 34 37 20 29 20 72 65 74 75 72 6e  7483647 ) return
b830: 20 34 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 4d   4;.    if( u<=M
b840: 41 58 5f 36 42 59 54 45 20 29 20 72 65 74 75 72  AX_6BYTE ) retur
b850: 6e 20 35 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  n 5;.    return 
b860: 36 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61  6;.  }.  if( fla
b870: 67 73 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a 20  gs&MEM_Real ){. 
b880: 20 20 20 72 65 74 75 72 6e 20 37 3b 0a 20 20 7d     return 7;.  }
b890: 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d  .  if( flags&MEM
b8a0: 5f 53 74 72 20 29 7b 0a 20 20 20 20 69 6e 74 20  _Str ){.    int 
b8b0: 6e 20 3d 20 70 4d 65 6d 2d 3e 6e 3b 0a 20 20 20  n = pMem->n;.   
b8c0: 20 61 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b   assert( n>=0 );
b8d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 28 6e 2a  .    return ((n*
b8e0: 32 29 20 2b 20 31 33 29 3b 0a 20 20 7d 0a 20 20  2) + 13);.  }.  
b8f0: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 42 6c  if( flags&MEM_Bl
b900: 6f 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ob ){.    return
b910: 20 28 70 4d 65 6d 2d 3e 6e 2a 32 20 2b 20 31 32   (pMem->n*2 + 12
b920: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
b930: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  0;.}../*.** Retu
b940: 72 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66  rn the length of
b950: 20 74 68 65 20 64 61 74 61 20 63 6f 72 72 65 73   the data corres
b960: 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 73  ponding to the s
b970: 75 70 70 6c 69 65 64 20 73 65 72 69 61 6c 2d 74  upplied serial-t
b980: 79 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ype..*/.int sqli
b990: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
b9a0: 65 4c 65 6e 28 75 33 32 20 73 65 72 69 61 6c 5f  eLen(u32 serial_
b9b0: 74 79 70 65 29 7b 0a 20 20 69 66 28 20 73 65 72  type){.  if( ser
b9c0: 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b 0a  ial_type>=12 ){.
b9d0: 20 20 20 20 72 65 74 75 72 6e 20 28 73 65 72 69      return (seri
b9e0: 61 6c 5f 74 79 70 65 2d 31 32 29 2f 32 3b 0a 20  al_type-12)/2;. 
b9f0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 61 74   }else{.    stat
ba00: 69 63 20 63 6f 6e 73 74 20 75 38 20 61 53 69 7a  ic const u8 aSiz
ba10: 65 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c 20 32 2c  e[] = { 0, 1, 2,
ba20: 20 33 2c 20 34 2c 20 36 2c 20 38 2c 20 38 2c 20   3, 4, 6, 8, 8, 
ba30: 30 2c 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 20 20  0, 0, 0, 0 };.  
ba40: 20 20 72 65 74 75 72 6e 20 61 53 69 7a 65 5b 73    return aSize[s
ba50: 65 72 69 61 6c 5f 74 79 70 65 5d 3b 0a 20 20 7d  erial_type];.  }
ba60: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20  .}../*.** Write 
ba70: 74 68 65 20 73 65 72 69 61 6c 69 7a 65 64 20 64  the serialized d
ba80: 61 74 61 20 62 6c 6f 62 20 66 6f 72 20 74 68 65  ata blob for the
ba90: 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e   value stored in
baa0: 20 70 4d 65 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62   pMem into .** b
bab0: 75 66 2e 20 49 74 20 69 73 20 61 73 73 75 6d 65  uf. It is assume
bac0: 64 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65  d that the calle
bad0: 72 20 68 61 73 20 61 6c 6c 6f 63 61 74 65 64 20  r has allocated 
bae0: 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65  sufficient space
baf0: 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  ..** Return the 
bb00: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  number of bytes 
bb10: 77 72 69 74 74 65 6e 2e 0a 2a 2f 20 0a 69 6e 74  written..*/ .int
bb20: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
bb30: 61 6c 50 75 74 28 75 6e 73 69 67 6e 65 64 20 63  alPut(unsigned c
bb40: 68 61 72 20 2a 62 75 66 2c 20 4d 65 6d 20 2a 70  har *buf, Mem *p
bb50: 4d 65 6d 29 7b 0a 20 20 75 33 32 20 73 65 72 69  Mem){.  u32 seri
bb60: 61 6c 5f 74 79 70 65 20 3d 20 73 71 6c 69 74 65  al_type = sqlite
bb70: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28  3VdbeSerialType(
bb80: 70 4d 65 6d 29 3b 0a 20 20 69 6e 74 20 6c 65 6e  pMem);.  int len
bb90: 3b 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a  ;..  /* NULL */.
bba0: 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70    if( serial_typ
bbb0: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  e==0 ){.    retu
bbc0: 72 6e 20 30 3b 0a 20 20 7d 0a 20 0a 20 20 2f 2a  rn 0;.  }. .  /*
bbd0: 20 49 6e 74 65 67 65 72 20 61 6e 64 20 52 65 61   Integer and Rea
bbe0: 6c 20 2a 2f 0a 20 20 69 66 28 20 73 65 72 69 61  l */.  if( seria
bbf0: 6c 5f 74 79 70 65 3c 3d 37 20 29 7b 0a 20 20 20  l_type<=7 ){.   
bc00: 20 75 36 34 20 76 3b 0a 20 20 20 20 69 6e 74 20   u64 v;.    int 
bc10: 69 3b 0a 20 20 20 20 69 66 28 20 73 65 72 69 61  i;.    if( seria
bc20: 6c 5f 74 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20  l_type==7 ){.   
bc30: 20 20 20 76 20 3d 20 2a 28 75 36 34 2a 29 26 70     v = *(u64*)&p
bc40: 4d 65 6d 2d 3e 72 3b 0a 20 20 20 20 7d 65 6c 73  Mem->r;.    }els
bc50: 65 7b 0a 20 20 20 20 20 20 76 20 3d 20 2a 28 75  e{.      v = *(u
bc60: 36 34 2a 29 26 70 4d 65 6d 2d 3e 69 3b 0a 20 20  64*)&pMem->i;.  
bc70: 20 20 7d 0a 20 20 20 20 6c 65 6e 20 3d 20 69 20    }.    len = i 
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 77 68 69  l_type);.    whi
bcb0: 6c 65 28 20 69 2d 2d 20 29 7b 0a 20 20 20 20 20  le( i-- ){.     
bcc0: 20 62 75 66 5b 69 5d 20 3d 20 28 76 26 30 78 46   buf[i] = (v&0xF
bcd0: 46 29 3b 0a 20 20 20 20 20 20 76 20 3e 3e 3d 20  F);.      v >>= 
bce0: 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74  8;.    }.    ret
bcf0: 75 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a 20 20 0a  urn len;.  }.  .
bd00: 20 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72 20 62    /* String or b
bd10: 6c 6f 62 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  lob */.  assert(
bd20: 20 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32   serial_type>=12
bd30: 20 29 3b 0a 20 20 6c 65 6e 20 3d 20 73 71 6c 69   );.  len = sqli
bd40: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
bd50: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
bd60: 29 3b 0a 20 20 6d 65 6d 63 70 79 28 62 75 66 2c  );.  memcpy(buf,
bd70: 20 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29 3b 0a   pMem->z, len);.
bd80: 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 7d 0a    return len;.}.
bd90: 0a 2f 2a 0a 2a 2a 20 44 65 73 65 72 69 61 6c 69  ./*.** Deseriali
bda0: 7a 65 20 74 68 65 20 64 61 74 61 20 62 6c 6f 62  ze the data blob
bdb0: 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 62   pointed to by b
bdc0: 75 66 20 61 73 20 73 65 72 69 61 6c 20 74 79 70  uf as serial typ
bdd0: 65 20 73 65 72 69 61 6c 5f 74 79 70 65 0a 2a 2a  e serial_type.**
bde0: 20 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 72   and store the r
bdf0: 65 73 75 6c 74 20 69 6e 20 70 4d 65 6d 2e 20 20  esult in pMem.  
be00: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
be10: 72 20 6f 66 20 62 79 74 65 73 20 72 65 61 64 2e  r of bytes read.
be20: 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33  .*/ .int sqlite3
be30: 56 64 62 65 53 65 72 69 61 6c 47 65 74 28 0a 20  VdbeSerialGet(. 
be40: 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20   const unsigned 
be50: 63 68 61 72 20 2a 62 75 66 2c 20 20 20 20 20 2f  char *buf,     /
be60: 2a 20 42 75 66 66 65 72 20 74 6f 20 64 65 73 65  * Buffer to dese
be70: 72 69 61 6c 69 7a 65 20 66 72 6f 6d 20 2a 2f 0a  rialize from */.
be80: 20 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70    u32 serial_typ
be90: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
bea0: 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 74  /* Serial type t
beb0: 6f 20 64 65 73 65 72 69 61 6c 69 7a 65 20 2a 2f  o deserialize */
bec0: 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 20 20 20  .  Mem *pMem    
bed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bee0: 20 2f 2a 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20   /* Memory cell 
bef0: 74 6f 20 77 72 69 74 65 20 76 61 6c 75 65 20 69  to write value i
bf00: 6e 74 6f 20 2a 2f 0a 29 7b 0a 20 20 73 77 69 74  nto */.){.  swit
bf10: 63 68 28 20 73 65 72 69 61 6c 5f 74 79 70 65 20  ch( serial_type 
bf20: 29 7b 0a 20 20 20 20 63 61 73 65 20 38 3a 20 20  ){.    case 8:  
bf30: 20 20 2f 2a 20 52 65 73 65 72 76 65 64 20 66 6f    /* Reserved fo
bf40: 72 20 66 75 74 75 72 65 20 75 73 65 20 2a 2f 0a  r future use */.
bf50: 20 20 20 20 63 61 73 65 20 39 3a 20 20 20 20 2f      case 9:    /
bf60: 2a 20 52 65 73 65 72 76 65 64 20 66 6f 72 20 66  * Reserved for f
bf70: 75 74 75 72 65 20 75 73 65 20 2a 2f 0a 20 20 20  uture use */.   
bf80: 20 63 61 73 65 20 31 30 3a 20 20 20 2f 2a 20 52   case 10:   /* R
bf90: 65 73 65 72 76 65 64 20 66 6f 72 20 66 75 74 75  eserved for futu
bfa0: 72 65 20 75 73 65 20 2a 2f 0a 20 20 20 20 63 61  re use */.    ca
bfb0: 73 65 20 31 31 3a 20 20 20 2f 2a 20 52 65 73 65  se 11:   /* Rese
bfc0: 72 76 65 64 20 66 6f 72 20 66 75 74 75 72 65 20  rved for future 
bfd0: 75 73 65 20 2a 2f 0a 20 20 20 20 63 61 73 65 20  use */.    case 
bfe0: 30 3a 20 7b 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f  0: {  /* NULL */
bff0: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61  .      pMem->fla
c000: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20  gs = MEM_Null;. 
c010: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
c020: 7d 0a 20 20 20 20 63 61 73 65 20 31 3a 20 7b 20  }.    case 1: { 
c030: 2f 2a 20 31 2d 62 79 74 65 20 73 69 67 6e 65 64  /* 1-byte signed
c040: 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20 20   integer */.    
c050: 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 28 73 69 67    pMem->i = (sig
c060: 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30 5d 3b  ned char)buf[0];
c070: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61  .      pMem->fla
c080: 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20  gs = MEM_Int;.  
c090: 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20      return 1;.  
c0a0: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 32 3a 20    }.    case 2: 
c0b0: 7b 20 2f 2a 20 32 2d 62 79 74 65 20 73 69 67 6e  { /* 2-byte sign
c0c0: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20  ed integer */.  
c0d0: 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 28 28      pMem->i = ((
c0e0: 28 73 69 67 6e 65 64 20 63 68 61 72 29 62 75 66  (signed char)buf
c0f0: 5b 30 5d 29 3c 3c 38 29 20 7c 20 62 75 66 5b 31  [0])<<8) | buf[1
c100: 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  ];.      pMem->f
c110: 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a  lags = MEM_Int;.
c120: 20 20 20 20 20 20 72 65 74 75 72 6e 20 32 3b 0a        return 2;.
c130: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 33      }.    case 3
c140: 3a 20 7b 20 2f 2a 20 33 2d 62 79 74 65 20 73 69  : { /* 3-byte si
c150: 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a  gned integer */.
c160: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20        pMem->i = 
c170: 28 28 28 73 69 67 6e 65 64 20 63 68 61 72 29 62  (((signed char)b
c180: 75 66 5b 30 5d 29 3c 3c 31 36 29 20 7c 20 28 62  uf[0])<<16) | (b
c190: 75 66 5b 31 5d 3c 3c 38 29 20 7c 20 62 75 66 5b  uf[1]<<8) | buf[
c1a0: 32 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e  2];.      pMem->
c1b0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b  flags = MEM_Int;
c1c0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 33 3b  .      return 3;
c1d0: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20  .    }.    case 
c1e0: 34 3a 20 7b 20 2f 2a 20 34 2d 62 79 74 65 20 73  4: { /* 4-byte s
c1f0: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f  igned integer */
c200: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d  .      pMem->i =
c210: 20 28 62 75 66 5b 30 5d 3c 3c 32 34 29 20 7c 20   (buf[0]<<24) | 
c220: 28 62 75 66 5b 31 5d 3c 3c 31 36 29 20 7c 20 28  (buf[1]<<16) | (
c230: 62 75 66 5b 32 5d 3c 3c 38 29 20 7c 20 62 75 66  buf[2]<<8) | buf
c240: 5b 33 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  [3];.      pMem-
c250: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74  >flags = MEM_Int
c260: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 34  ;.      return 4
c270: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
c280: 20 35 3a 20 7b 20 2f 2a 20 36 2d 62 79 74 65 20   5: { /* 6-byte 
c290: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a  signed integer *
c2a0: 2f 0a 20 20 20 20 20 20 75 36 34 20 78 20 3d 20  /.      u64 x = 
c2b0: 28 28 28 73 69 67 6e 65 64 20 63 68 61 72 29 62  (((signed char)b
c2c0: 75 66 5b 30 5d 29 3c 3c 38 29 20 7c 20 62 75 66  uf[0])<<8) | buf
c2d0: 5b 31 5d 3b 0a 20 20 20 20 20 20 75 33 32 20 79  [1];.      u32 y
c2e0: 20 3d 20 28 62 75 66 5b 32 5d 3c 3c 32 34 29 20   = (buf[2]<<24) 
c2f0: 7c 20 28 62 75 66 5b 33 5d 3c 3c 31 36 29 20 7c  | (buf[3]<<16) |
c300: 20 28 62 75 66 5b 34 5d 3c 3c 38 29 20 7c 20 62   (buf[4]<<8) | b
c310: 75 66 5b 35 5d 3b 0a 20 20 20 20 20 20 78 20 3d  uf[5];.      x =
c320: 20 28 78 3c 3c 33 32 29 20 7c 20 79 3b 0a 20 20   (x<<32) | y;.  
c330: 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 2a 28      pMem->i = *(
c340: 69 36 34 2a 29 26 78 3b 0a 20 20 20 20 20 20 70  i64*)&x;.      p
c350: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
c360: 5f 49 6e 74 3b 0a 20 20 20 20 20 20 72 65 74 75  _Int;.      retu
c370: 72 6e 20 36 3b 0a 20 20 20 20 7d 0a 20 20 20 20  rn 6;.    }.    
c380: 63 61 73 65 20 36 3a 20 20 20 2f 2a 20 38 2d 62  case 6:   /* 8-b
c390: 79 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67  yte signed integ
c3a0: 65 72 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 37  er */.    case 7
c3b0: 3a 20 7b 20 2f 2a 20 49 45 45 45 20 66 6c 6f 61  : { /* IEEE floa
c3c0: 74 69 6e 67 20 70 6f 69 6e 74 20 2a 2f 0a 23 69  ting point */.#i
c3d0: 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 20 20  fndef NDEBUG.   
c3e0: 20 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68 61     /* Verify tha
c3f0: 74 20 69 6e 74 65 67 65 72 73 20 61 6e 64 20 66  t integers and f
c400: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 76 61  loating point va
c410: 6c 75 65 73 20 75 73 65 20 74 68 65 20 73 61 6d  lues use the sam
c420: 65 0a 20 20 20 20 20 20 2a 2a 20 62 79 74 65 20  e.      ** byte 
c430: 6f 72 64 65 72 2e 20 20 54 68 65 20 62 79 74 65  order.  The byte
c440: 20 6f 72 64 65 72 20 64 69 66 66 65 72 73 20 6f   order differs o
c450: 6e 20 73 6f 6d 65 20 28 62 72 6f 6b 65 6e 29 20  n some (broken) 
c460: 61 72 63 68 69 74 65 63 74 75 72 65 73 2e 0a 20  architectures.. 
c470: 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 73 74       */.      st
c480: 61 74 69 63 20 63 6f 6e 73 74 20 75 36 34 20 74  atic const u64 t
c490: 31 20 3d 20 28 28 75 36 34 29 30 78 33 66 66 30  1 = ((u64)0x3ff0
c4a0: 30 30 30 30 29 3c 3c 33 32 3b 0a 20 20 20 20 20  0000)<<32;.     
c4b0: 20 61 73 73 65 72 74 28 20 31 2e 30 3d 3d 2a 28   assert( 1.0==*(
c4c0: 64 6f 75 62 6c 65 2a 29 26 74 31 20 29 3b 0a 23  double*)&t1 );.#
c4d0: 65 6e 64 69 66 0a 0a 20 20 20 20 20 20 75 36 34  endif..      u64
c4e0: 20 78 20 3d 20 28 62 75 66 5b 30 5d 3c 3c 32 34   x = (buf[0]<<24
c4f0: 29 20 7c 20 28 62 75 66 5b 31 5d 3c 3c 31 36 29  ) | (buf[1]<<16)
c500: 20 7c 20 28 62 75 66 5b 32 5d 3c 3c 38 29 20 7c   | (buf[2]<<8) |
c510: 20 62 75 66 5b 33 5d 3b 0a 20 20 20 20 20 20 75   buf[3];.      u
c520: 33 32 20 79 20 3d 20 28 62 75 66 5b 34 5d 3c 3c  32 y = (buf[4]<<
c530: 32 34 29 20 7c 20 28 62 75 66 5b 35 5d 3c 3c 31  24) | (buf[5]<<1
c540: 36 29 20 7c 20 28 62 75 66 5b 36 5d 3c 3c 38 29  6) | (buf[6]<<8)
c550: 20 7c 20 62 75 66 5b 37 5d 3b 0a 20 20 20 20 20   | buf[7];.     
c560: 20 78 20 3d 20 28 78 3c 3c 33 32 29 20 7c 20 79   x = (x<<32) | y
c570: 3b 0a 20 20 20 20 20 20 69 66 28 20 73 65 72 69  ;.      if( seri
c580: 61 6c 5f 74 79 70 65 3d 3d 36 20 29 7b 0a 20 20  al_type==6 ){.  
c590: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20        pMem->i = 
c5a0: 2a 28 69 36 34 2a 29 26 78 3b 0a 20 20 20 20 20  *(i64*)&x;.     
c5b0: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
c5c0: 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20   MEM_Int;.      
c5d0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70  }else{.        p
c5e0: 4d 65 6d 2d 3e 72 20 3d 20 2a 28 64 6f 75 62 6c  Mem->r = *(doubl
c5f0: 65 2a 29 26 78 3b 0a 20 20 20 20 20 20 20 20 70  e*)&x;.        p
c600: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
c610: 5f 52 65 61 6c 3b 0a 20 20 20 20 20 20 7d 0a 20  _Real;.      }. 
c620: 20 20 20 20 20 72 65 74 75 72 6e 20 38 3b 0a 20       return 8;. 
c630: 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74     }.    default
c640: 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 6c 65  : {.      int le
c650: 6e 20 3d 20 28 73 65 72 69 61 6c 5f 74 79 70 65  n = (serial_type
c660: 2d 31 32 29 2f 32 3b 0a 20 20 20 20 20 20 70 4d  -12)/2;.      pM
c670: 65 6d 2d 3e 7a 20 3d 20 28 63 68 61 72 20 2a 29  em->z = (char *)
c680: 62 75 66 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  buf;.      pMem-
c690: 3e 6e 20 3d 20 6c 65 6e 3b 0a 20 20 20 20 20 20  >n = len;.      
c6a0: 70 4d 65 6d 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a  pMem->xDel = 0;.
c6b0: 20 20 20 20 20 20 69 66 28 20 73 65 72 69 61 6c        if( serial
c6c0: 5f 74 79 70 65 26 30 78 30 31 20 29 7b 0a 20 20  _type&0x01 ){.  
c6d0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
c6e0: 73 20 3d 20 4d 45 4d 5f 53 74 72 20 7c 20 4d 45  s = MEM_Str | ME
c6f0: 4d 5f 45 70 68 65 6d 3b 0a 20 20 20 20 20 20 7d  M_Ephem;.      }
c700: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d  else{.        pM
c710: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
c720: 42 6c 6f 62 20 7c 20 4d 45 4d 5f 45 70 68 65 6d  Blob | MEM_Ephem
c730: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
c740: 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 20 20 20 20  return len;.    
c750: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30  }.  }.  return 0
c760: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
c770: 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 70 61 72 65  function compare
c780: 73 20 74 68 65 20 74 77 6f 20 74 61 62 6c 65 20  s the two table 
c790: 72 6f 77 73 20 6f 72 20 69 6e 64 65 78 20 72 65  rows or index re
c7a0: 63 6f 72 64 73 20 73 70 65 63 69 66 69 65 64 20  cords specified 
c7b0: 62 79 20 0a 2a 2a 20 7b 6e 4b 65 79 31 2c 20 70  by .** {nKey1, p
c7c0: 4b 65 79 31 7d 20 61 6e 64 20 7b 6e 4b 65 79 32  Key1} and {nKey2
c7d0: 2c 20 70 4b 65 79 32 7d 2c 20 72 65 74 75 72 6e  , pKey2}, return
c7e0: 69 6e 67 20 61 20 6e 65 67 61 74 69 76 65 2c 20  ing a negative, 
c7f0: 7a 65 72 6f 0a 2a 2a 20 6f 72 20 70 6f 73 69 74  zero.** or posit
c800: 69 76 65 20 69 6e 74 65 67 65 72 20 69 66 20 7b  ive integer if {
c810: 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20 69 73  nKey1, pKey1} is
c820: 20 6c 65 73 73 20 74 68 61 6e 2c 20 65 71 75 61   less than, equa
c830: 6c 20 74 6f 20 6f 72 20 0a 2a 2a 20 67 72 65 61  l to or .** grea
c840: 74 65 72 20 74 68 61 6e 20 7b 6e 4b 65 79 32 2c  ter than {nKey2,
c850: 20 70 4b 65 79 32 7d 2e 20 20 42 6f 74 68 20 4b   pKey2}.  Both K
c860: 65 79 31 20 61 6e 64 20 4b 65 79 32 20 6d 75 73  ey1 and Key2 mus
c870: 74 20 62 65 20 62 79 74 65 20 73 74 72 69 6e 67  t be byte string
c880: 73 0a 2a 2a 20 63 6f 6d 70 6f 73 65 64 20 62 79  s.** composed by
c890: 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f   the OP_MakeReco
c8a0: 72 64 20 6f 70 63 6f 64 65 20 6f 66 20 74 68 65  rd opcode of the
c8b0: 20 56 44 42 45 2e 0a 2a 2f 0a 69 6e 74 20 73 71   VDBE..*/.int sq
c8c0: 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43  lite3VdbeRecordC
c8d0: 6f 6d 70 61 72 65 28 0a 20 20 76 6f 69 64 20 2a  ompare(.  void *
c8e0: 75 73 65 72 44 61 74 61 2c 0a 20 20 69 6e 74 20  userData,.  int 
c8f0: 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69  nKey1, const voi
c900: 64 20 2a 70 4b 65 79 31 2c 20 0a 20 20 69 6e 74  d *pKey1, .  int
c910: 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f   nKey2, const vo
c920: 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 4b  id *pKey2.){.  K
c930: 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f  eyInfo *pKeyInfo
c940: 20 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 75 73 65   = (KeyInfo*)use
c950: 72 44 61 74 61 3b 0a 20 20 75 33 32 20 64 31 2c  rData;.  u32 d1,
c960: 20 64 32 3b 20 20 20 20 20 20 20 20 20 20 2f 2a   d2;          /*
c970: 20 4f 66 66 73 65 74 20 69 6e 74 6f 20 61 4b 65   Offset into aKe
c980: 79 5b 5d 20 6f 66 20 6e 65 78 74 20 64 61 74 61  y[] of next data
c990: 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 75 33   element */.  u3
c9a0: 32 20 69 64 78 31 2c 20 69 64 78 32 3b 20 20 20  2 idx1, idx2;   
c9b0: 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 74     /* Offset int
c9c0: 6f 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65 78 74  o aKey[] of next
c9d0: 20 68 65 61 64 65 72 20 65 6c 65 6d 65 6e 74 20   header element 
c9e0: 2a 2f 0a 20 20 75 33 32 20 73 7a 48 64 72 31 2c  */.  u32 szHdr1,
c9f0: 20 73 7a 48 64 72 32 3b 20 20 2f 2a 20 4e 75 6d   szHdr2;  /* Num
ca00: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20  ber of bytes in 
ca10: 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e 74 20  header */.  int 
ca20: 69 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 46 69  i = 0;.  int nFi
ca30: 65 6c 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  eld;.  int rc = 
ca40: 30 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67  0;.  const unsig
ca50: 6e 65 64 20 63 68 61 72 20 2a 61 4b 65 79 31 20  ned char *aKey1 
ca60: 3d 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  = (const unsigne
ca70: 64 20 63 68 61 72 20 2a 29 70 4b 65 79 31 3b 0a  d char *)pKey1;.
ca80: 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64    const unsigned
ca90: 20 63 68 61 72 20 2a 61 4b 65 79 32 20 3d 20 28   char *aKey2 = (
caa0: 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63  const unsigned c
cab0: 68 61 72 20 2a 29 70 4b 65 79 32 3b 0a 0a 20 20  har *)pKey2;..  
cac0: 4d 65 6d 20 6d 65 6d 31 3b 0a 20 20 4d 65 6d 20  Mem mem1;.  Mem 
cad0: 6d 65 6d 32 3b 0a 20 20 6d 65 6d 31 2e 65 6e 63  mem2;.  mem1.enc
cae0: 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63   = pKeyInfo->enc
caf0: 3b 0a 20 20 6d 65 6d 32 2e 65 6e 63 20 3d 20 70  ;.  mem2.enc = p
cb00: 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20  KeyInfo->enc;.  
cb10: 0a 20 20 69 64 78 31 20 3d 20 73 71 6c 69 74 65  .  idx1 = sqlite
cb20: 33 47 65 74 56 61 72 69 6e 74 33 32 28 70 4b 65  3GetVarint32(pKe
cb30: 79 31 2c 20 26 73 7a 48 64 72 31 29 3b 0a 20 20  y1, &szHdr1);.  
cb40: 64 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20 20 69  d1 = szHdr1;.  i
cb50: 64 78 32 20 3d 20 73 71 6c 69 74 65 33 47 65 74  dx2 = sqlite3Get
cb60: 56 61 72 69 6e 74 33 32 28 70 4b 65 79 32 2c 20  Varint32(pKey2, 
cb70: 26 73 7a 48 64 72 32 29 3b 0a 20 20 64 32 20 3d  &szHdr2);.  d2 =
cb80: 20 73 7a 48 64 72 32 3b 0a 20 20 6e 46 69 65 6c   szHdr2;.  nFiel
cb90: 64 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46  d = pKeyInfo->nF
cba0: 69 65 6c 64 3b 0a 20 20 77 68 69 6c 65 28 20 69  ield;.  while( i
cbb0: 64 78 31 3c 73 7a 48 64 72 31 20 26 26 20 69 64  dx1<szHdr1 && id
cbc0: 78 32 3c 73 7a 48 64 72 32 20 29 7b 0a 20 20 20  x2<szHdr2 ){.   
cbd0: 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65   u32 serial_type
cbe0: 31 3b 0a 20 20 20 20 75 33 32 20 73 65 72 69 61  1;.    u32 seria
cbf0: 6c 5f 74 79 70 65 32 3b 0a 0a 20 20 20 20 2f 2a  l_type2;..    /*
cc00: 20 52 65 61 64 20 74 68 65 20 73 65 72 69 61 6c   Read the serial
cc10: 20 74 79 70 65 73 20 66 6f 72 20 74 68 65 20 6e   types for the n
cc20: 65 78 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20 65  ext element in e
cc30: 61 63 68 20 6b 65 79 2e 20 2a 2f 0a 20 20 20 20  ach key. */.    
cc40: 69 64 78 31 20 2b 3d 20 73 71 6c 69 74 65 33 47  idx1 += sqlite3G
cc50: 65 74 56 61 72 69 6e 74 33 32 28 26 61 4b 65 79  etVarint32(&aKey
cc60: 31 5b 69 64 78 31 5d 2c 20 26 73 65 72 69 61 6c  1[idx1], &serial
cc70: 5f 74 79 70 65 31 29 3b 0a 20 20 20 20 69 66 28  _type1);.    if(
cc80: 20 64 31 3e 3d 6e 4b 65 79 31 20 26 26 20 73 71   d1>=nKey1 && sq
cc90: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54  lite3VdbeSerialT
cca0: 79 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79  ypeLen(serial_ty
ccb0: 70 65 31 29 3e 30 20 29 20 62 72 65 61 6b 3b 0a  pe1)>0 ) break;.
ccc0: 20 20 20 20 69 64 78 32 20 2b 3d 20 73 71 6c 69      idx2 += sqli
ccd0: 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 26  te3GetVarint32(&
cce0: 61 4b 65 79 32 5b 69 64 78 32 5d 2c 20 26 73 65  aKey2[idx2], &se
ccf0: 72 69 61 6c 5f 74 79 70 65 32 29 3b 0a 20 20 20  rial_type2);.   
cd00: 20 69 66 28 20 64 32 3e 3d 6e 4b 65 79 32 20 26   if( d2>=nKey2 &
cd10: 26 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  & sqlite3VdbeSer
cd20: 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61  ialTypeLen(seria
cd30: 6c 5f 74 79 70 65 32 29 3e 30 20 29 20 62 72 65  l_type2)>0 ) bre
cd40: 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20 41 73 73 65  ak;..    /* Asse
cd50: 72 74 20 74 68 61 74 20 74 68 65 72 65 20 69 73  rt that there is
cd60: 20 65 6e 6f 75 67 68 20 73 70 61 63 65 20 6c 65   enough space le
cd70: 66 74 20 69 6e 20 65 61 63 68 20 6b 65 79 20 66  ft in each key f
cd80: 6f 72 20 74 68 65 20 62 6c 6f 62 20 6f 66 0a 20  or the blob of. 
cd90: 20 20 20 2a 2a 20 64 61 74 61 20 74 6f 20 67 6f     ** data to go
cda0: 20 77 69 74 68 20 74 68 65 20 73 65 72 69 61 6c   with the serial
cdb0: 20 74 79 70 65 20 6a 75 73 74 20 72 65 61 64 2e   type just read.
cdc0: 20 54 68 69 73 20 61 73 73 65 72 74 20 6d 61 79   This assert may
cdd0: 20 66 61 69 6c 20 69 66 0a 20 20 20 20 2a 2a 20   fail if.    ** 
cde0: 74 68 65 20 66 69 6c 65 20 69 73 20 63 6f 72 72  the file is corr
cdf0: 75 70 74 65 64 2e 20 20 54 68 65 6e 20 72 65 61  upted.  Then rea
ce00: 64 20 74 68 65 20 76 61 6c 75 65 20 66 72 6f 6d  d the value from
ce10: 20 65 61 63 68 20 6b 65 79 20 69 6e 74 6f 20 6d   each key into m
ce20: 65 6d 31 0a 20 20 20 20 2a 2a 20 61 6e 64 20 6d  em1.    ** and m
ce30: 65 6d 32 20 72 65 73 70 65 63 74 69 76 65 6c 79  em2 respectively
ce40: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64 31 20  ..    */.    d1 
ce50: 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  += sqlite3VdbeSe
ce60: 72 69 61 6c 47 65 74 28 26 61 4b 65 79 31 5b 64  rialGet(&aKey1[d
ce70: 31 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 31  1], serial_type1
ce80: 2c 20 26 6d 65 6d 31 29 3b 0a 20 20 20 20 64 32  , &mem1);.    d2
ce90: 20 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53   += sqlite3VdbeS
cea0: 65 72 69 61 6c 47 65 74 28 26 61 4b 65 79 32 5b  erialGet(&aKey2[
ceb0: 64 32 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65  d2], serial_type
cec0: 32 2c 20 26 6d 65 6d 32 29 3b 0a 0a 20 20 20 20  2, &mem2);..    
ced0: 72 63 20 3d 20 73 71 6c 69 74 65 33 4d 65 6d 43  rc = sqlite3MemC
cee0: 6f 6d 70 61 72 65 28 26 6d 65 6d 31 2c 20 26 6d  ompare(&mem1, &m
cef0: 65 6d 32 2c 20 69 3c 6e 46 69 65 6c 64 20 3f 20  em2, i<nField ? 
cf00: 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b  pKeyInfo->aColl[
cf10: 69 5d 20 3a 20 30 29 3b 0a 20 20 20 20 69 66 28  i] : 0);.    if(
cf20: 20 6d 65 6d 31 2e 66 6c 61 67 73 20 26 20 4d 45   mem1.flags & ME
cf30: 4d 5f 44 79 6e 20 29 20 73 71 6c 69 74 65 33 56  M_Dyn ) sqlite3V
cf40: 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d  dbeMemRelease(&m
cf50: 65 6d 31 29 3b 0a 20 20 20 20 69 66 28 20 6d 65  em1);.    if( me
cf60: 6d 32 2e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 44  m2.flags & MEM_D
cf70: 79 6e 20 29 20 73 71 6c 69 74 65 33 56 64 62 65  yn ) sqlite3Vdbe
cf80: 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 65 6d 32  MemRelease(&mem2
cf90: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 30  );.    if( rc!=0
cfa0: 20 29 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b   ){.      break;
cfb0: 0a 20 20 20 20 7d 0a 20 20 20 20 69 2b 2b 3b 0a  .    }.    i++;.
cfc0: 20 20 7d 0a 0a 20 20 2f 2a 20 4f 6e 65 20 6f 66    }..  /* One of
cfd0: 20 74 68 65 20 6b 65 79 73 20 72 61 6e 20 6f 75   the keys ran ou
cfe0: 74 20 6f 66 20 66 69 65 6c 64 73 2c 20 62 75 74  t of fields, but
cff0: 20 61 6c 6c 20 74 68 65 20 66 69 65 6c 64 73 20   all the fields 
d000: 75 70 20 74 6f 20 74 68 61 74 20 70 6f 69 6e 74  up to that point
d010: 0a 20 20 2a 2a 20 77 65 72 65 20 65 71 75 61 6c  .  ** were equal
d020: 2e 20 49 66 20 74 68 65 20 69 6e 63 72 4b 65 79  . If the incrKey
d030: 20 66 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74   flag is true, t
d040: 68 65 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 6b  hen the second k
d050: 65 79 20 69 73 0a 20 20 2a 2a 20 74 72 65 61 74  ey is.  ** treat
d060: 65 64 20 61 73 20 6c 61 72 67 65 72 2e 0a 20 20  ed as larger..  
d070: 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29  */.  if( rc==0 )
d080: 7b 0a 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e  {.    if( pKeyIn
d090: 66 6f 2d 3e 69 6e 63 72 4b 65 79 20 29 7b 0a 20  fo->incrKey ){. 
d0a0: 20 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20       rc = -1;.  
d0b0: 20 20 7d 65 6c 73 65 20 69 66 28 20 64 31 3c 6e    }else if( d1<n
d0c0: 4b 65 79 31 20 29 7b 0a 20 20 20 20 20 20 72 63  Key1 ){.      rc
d0d0: 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 20   = 1;.    }else 
d0e0: 69 66 28 20 64 32 3c 6e 4b 65 79 32 20 29 7b 0a  if( d2<nKey2 ){.
d0f0: 20 20 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20        rc = -1;. 
d100: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20     }.  }..  if( 
d110: 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f  pKeyInfo->aSortO
d120: 72 64 65 72 20 26 26 20 69 3c 70 4b 65 79 49 6e  rder && i<pKeyIn
d130: 66 6f 2d 3e 6e 46 69 65 6c 64 20 26 26 20 70 4b  fo->nField && pK
d140: 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64  eyInfo->aSortOrd
d150: 65 72 5b 69 5d 20 29 7b 0a 20 20 20 20 72 63 20  er[i] ){.    rc 
d160: 3d 20 2d 72 63 3b 0a 20 20 7d 0a 0a 20 20 72 65  = -rc;.  }..  re
d170: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
d180: 2a 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 69  * The argument i
d190: 73 20 61 6e 20 69 6e 64 65 78 20 65 6e 74 72 79  s an index entry
d1a0: 20 63 6f 6d 70 6f 73 65 64 20 75 73 69 6e 67 20   composed using 
d1b0: 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72  the OP_MakeRecor
d1c0: 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 54 68 65  d opcode..** The
d1d0: 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74   last entry in t
d1e0: 68 69 73 20 72 65 63 6f 72 64 20 73 68 6f 75 6c  his record shoul
d1f0: 64 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 20  d be an integer 
d200: 28 73 70 65 63 69 66 69 63 61 6c 6c 79 0a 2a 2a  (specifically.**
d210: 20 61 6e 20 69 6e 74 65 67 65 72 20 72 6f 77 69   an integer rowi
d220: 64 29 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e  d).  This routin
d230: 65 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75  e returns the nu
d240: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e  mber of bytes in
d250: 0a 2a 2a 20 74 68 61 74 20 69 6e 74 65 67 65 72  .** that integer
d260: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
d270: 56 64 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28  VdbeIdxRowidLen(
d280: 69 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20  int nKey, const 
d290: 75 38 20 2a 61 4b 65 79 29 7b 0a 20 20 75 33 32  u8 *aKey){.  u32
d2a0: 20 73 7a 48 64 72 3b 20 20 20 20 20 20 20 20 2f   szHdr;        /
d2b0: 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 68 65  * Size of the he
d2c0: 61 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 74 79  ader */.  u32 ty
d2d0: 70 65 52 6f 77 69 64 3b 20 20 20 20 2f 2a 20 53  peRowid;    /* S
d2e0: 65 72 69 61 6c 20 74 79 70 65 20 6f 66 20 74 68  erial type of th
d2f0: 65 20 72 6f 77 69 64 20 2a 2f 0a 0a 20 20 73 71  e rowid */..  sq
d300: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
d310: 28 61 4b 65 79 2c 20 26 73 7a 48 64 72 29 3b 0a  (aKey, &szHdr);.
d320: 20 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69    sqlite3GetVari
d330: 6e 74 33 32 28 26 61 4b 65 79 5b 73 7a 48 64 72  nt32(&aKey[szHdr
d340: 2d 31 5d 2c 20 26 74 79 70 65 52 6f 77 69 64 29  -1], &typeRowid)
d350: 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  ;.  return sqlit
d360: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
d370: 4c 65 6e 28 74 79 70 65 52 6f 77 69 64 29 3b 0a  Len(typeRowid);.
d380: 7d 0a 20 20 0a 0a 2f 2a 0a 2a 2a 20 70 43 75 72  }.  ../*.** pCur
d390: 20 70 6f 69 6e 74 73 20 61 74 20 61 6e 20 69 6e   points at an in
d3a0: 64 65 78 20 65 6e 74 72 79 20 63 72 65 61 74 65  dex entry create
d3b0: 64 20 75 73 69 6e 67 20 74 68 65 20 4f 50 5f 4d  d using the OP_M
d3c0: 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f 64 65  akeRecord opcode
d3d0: 2e 0a 2a 2a 20 52 65 61 64 20 74 68 65 20 72 6f  ..** Read the ro
d3e0: 77 69 64 20 28 74 68 65 20 6c 61 73 74 20 66 69  wid (the last fi
d3f0: 65 6c 64 20 69 6e 20 74 68 65 20 72 65 63 6f 72  eld in the recor
d400: 64 29 20 61 6e 64 20 73 74 6f 72 65 20 69 74 20  d) and store it 
d410: 69 6e 20 2a 72 6f 77 69 64 2e 0a 2a 2a 20 52 65  in *rowid..** Re
d420: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69  turn SQLITE_OK i
d430: 66 20 65 76 65 72 79 74 68 69 6e 67 20 77 6f 72  f everything wor
d440: 6b 73 2c 20 6f 72 20 61 6e 20 65 72 72 6f 72 20  ks, or an error 
d450: 63 6f 64 65 20 6f 74 68 65 72 77 69 73 65 2e 0a  code otherwise..
d460: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
d470: 62 65 49 64 78 52 6f 77 69 64 28 42 74 43 75 72  beIdxRowid(BtCur
d480: 73 6f 72 20 2a 70 43 75 72 2c 20 69 36 34 20 2a  sor *pCur, i64 *
d490: 72 6f 77 69 64 29 7b 0a 20 20 69 36 34 20 6e 43  rowid){.  i64 nC
d4a0: 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74 20 72 63  ellKey;.  int rc
d4b0: 3b 0a 20 20 75 33 32 20 73 7a 48 64 72 3b 20 20  ;.  u32 szHdr;  
d4c0: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66        /* Size of
d4d0: 20 74 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20   the header */. 
d4e0: 20 75 33 32 20 74 79 70 65 52 6f 77 69 64 3b 20   u32 typeRowid; 
d4f0: 20 20 20 2f 2a 20 53 65 72 69 61 6c 20 74 79 70     /* Serial typ
d500: 65 20 6f 66 20 74 68 65 20 72 6f 77 69 64 20 2a  e of the rowid *
d510: 2f 0a 20 20 75 33 32 20 6c 65 6e 52 6f 77 69 64  /.  u32 lenRowid
d520: 3b 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66  ;     /* Size of
d530: 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20   the rowid */.  
d540: 4d 65 6d 20 6d 2c 20 76 3b 0a 0a 20 20 73 71 6c  Mem m, v;..  sql
d550: 69 74 65 33 42 74 72 65 65 4b 65 79 53 69 7a 65  ite3BtreeKeySize
d560: 28 70 43 75 72 2c 20 26 6e 43 65 6c 6c 4b 65 79  (pCur, &nCellKey
d570: 29 3b 0a 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65  );.  if( nCellKe
d580: 79 3c 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  y<=0 ){.    retu
d590: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50  rn SQLITE_CORRUP
d5a0: 54 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71  T;.  }.  rc = sq
d5b0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d  lite3VdbeMemFrom
d5c0: 42 74 72 65 65 28 70 43 75 72 2c 20 30 2c 20 6e  Btree(pCur, 0, n
d5d0: 43 65 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b  CellKey, 1, &m);
d5e0: 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20  .  if( rc ){.   
d5f0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a   return rc;.  }.
d600: 20 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69    sqlite3GetVari
d610: 6e 74 33 32 28 6d 2e 7a 2c 20 26 73 7a 48 64 72  nt32(m.z, &szHdr
d620: 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56  );.  sqlite3GetV
d630: 61 72 69 6e 74 33 32 28 26 6d 2e 7a 5b 73 7a 48  arint32(&m.z[szH
d640: 64 72 2d 31 5d 2c 20 26 74 79 70 65 52 6f 77 69  dr-1], &typeRowi
d650: 64 29 3b 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d  d);.  lenRowid =
d660: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
d670: 61 6c 54 79 70 65 4c 65 6e 28 74 79 70 65 52 6f  alTypeLen(typeRo
d680: 77 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  wid);.  sqlite3V
d690: 64 62 65 53 65 72 69 61 6c 47 65 74 28 26 6d 2e  dbeSerialGet(&m.
d6a0: 7a 5b 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c  z[m.n-lenRowid],
d6b0: 20 74 79 70 65 52 6f 77 69 64 2c 20 26 76 29 3b   typeRowid, &v);
d6c0: 0a 20 20 2a 72 6f 77 69 64 20 3d 20 76 2e 69 3b  .  *rowid = v.i;
d6d0: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
d6e0: 6d 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20  mRelease(&m);.  
d6f0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
d700: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61  ;.}../*.** Compa
d710: 72 65 20 74 68 65 20 6b 65 79 20 6f 66 20 74 68  re the key of th
d720: 65 20 69 6e 64 65 78 20 65 6e 74 72 79 20 74 68  e index entry th
d730: 61 74 20 63 75 72 73 6f 72 20 70 43 20 69 73 20  at cursor pC is 
d740: 70 6f 69 6e 74 20 74 6f 20 61 67 61 69 6e 73 74  point to against
d750: 0a 2a 2a 20 74 68 65 20 6b 65 79 20 73 74 72 69  .** the key stri
d760: 6e 67 20 69 6e 20 70 4b 65 79 20 28 6f 66 20 6c  ng in pKey (of l
d770: 65 6e 67 74 68 20 6e 4b 65 79 29 2e 20 20 57 72  ength nKey).  Wr
d780: 69 74 65 20 69 6e 74 6f 20 2a 70 52 65 73 20 61  ite into *pRes a
d790: 20 6e 75 6d 62 65 72 0a 2a 2a 20 74 68 61 74 20   number.** that 
d7a0: 69 73 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72  is negative, zer
d7b0: 6f 2c 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69  o, or positive i
d7c0: 66 20 70 43 20 69 73 20 6c 65 73 73 20 74 68 61  f pC is less tha
d7d0: 6e 2c 20 65 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20  n, equal to,.** 
d7e0: 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20  or greater than 
d7f0: 70 4b 65 79 2e 20 20 52 65 74 75 72 6e 20 53 51  pKey.  Return SQ
d800: 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65  LITE_OK on succe
d810: 73 73 2e 0a 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69  ss..**.** pKey i
d820: 73 20 65 69 74 68 65 72 20 63 72 65 61 74 65 64  s either created
d830: 20 77 69 74 68 6f 75 74 20 61 20 72 6f 77 69 64   without a rowid
d840: 20 6f 72 20 69 73 20 74 72 75 6e 63 61 74 65 64   or is truncated
d850: 20 73 6f 20 74 68 61 74 20 69 74 0a 2a 2a 20 6f   so that it.** o
d860: 6d 69 74 73 20 74 68 65 20 72 6f 77 69 64 20 61  mits the rowid a
d870: 74 20 74 68 65 20 65 6e 64 2e 20 20 54 68 65 20  t the end.  The 
d880: 72 6f 77 69 64 20 61 74 20 74 68 65 20 65 6e 64  rowid at the end
d890: 20 6f 66 20 74 68 65 20 69 6e 64 65 78 20 65 6e   of the index en
d8a0: 74 72 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65  try.** is ignore
d8b0: 64 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e  d as well..*/.in
d8c0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78  t sqlite3VdbeIdx
d8d0: 4b 65 79 43 6f 6d 70 61 72 65 28 0a 20 20 43 75  KeyCompare(.  Cu
d8e0: 72 73 6f 72 20 2a 70 43 2c 20 20 20 20 20 20 20  rsor *pC,       
d8f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
d900: 20 63 75 72 73 6f 72 20 74 6f 20 63 6f 6d 70 61   cursor to compa
d910: 72 65 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20  re against */.  
d920: 69 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20  int nKey, const 
d930: 75 38 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 54  u8 *pKey,   /* T
d940: 68 65 20 6b 65 79 20 74 6f 20 63 6f 6d 70 61 72  he key to compar
d950: 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 72 65 73 20  e */.  int *res 
d960: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d970: 20 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20     /* Write the 
d980: 63 6f 6d 70 61 72 69 73 6f 6e 20 72 65 73 75 6c  comparison resul
d990: 74 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69  t here */.){.  i
d9a0: 36 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 69  64 nCellKey;.  i
d9b0: 6e 74 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f  nt rc;.  BtCurso
d9c0: 72 20 2a 70 43 75 72 20 3d 20 70 43 2d 3e 70 43  r *pCur = pC->pC
d9d0: 75 72 73 6f 72 3b 0a 20 20 69 6e 74 20 6c 65 6e  ursor;.  int len
d9e0: 52 6f 77 69 64 3b 0a 20 20 4d 65 6d 20 6d 3b 0a  Rowid;.  Mem m;.
d9f0: 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b  .  sqlite3BtreeK
da00: 65 79 53 69 7a 65 28 70 43 75 72 2c 20 26 6e 43  eySize(pCur, &nC
da10: 65 6c 6c 4b 65 79 29 3b 0a 20 20 69 66 28 20 6e  ellKey);.  if( n
da20: 43 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b 0a 20 20  CellKey<=0 ){.  
da30: 20 20 2a 72 65 73 20 3d 20 30 3b 0a 20 20 20 20    *res = 0;.    
da40: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
da50: 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c  ;.  }.  rc = sql
da60: 69 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42  ite3VdbeMemFromB
da70: 74 72 65 65 28 70 43 2d 3e 70 43 75 72 73 6f 72  tree(pC->pCursor
da80: 2c 20 30 2c 20 6e 43 65 6c 6c 4b 65 79 2c 20 31  , 0, nCellKey, 1
da90: 2c 20 26 6d 29 3b 0a 20 20 69 66 28 20 72 63 20  , &m);.  if( rc 
daa0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63  ){.    return rc
dab0: 3b 0a 20 20 7d 0a 20 20 6c 65 6e 52 6f 77 69 64  ;.  }.  lenRowid
dac0: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 49 64   = sqlite3VdbeId
dad0: 78 52 6f 77 69 64 4c 65 6e 28 6d 2e 6e 2c 20 6d  xRowidLen(m.n, m
dae0: 2e 7a 29 3b 0a 20 20 2a 72 65 73 20 3d 20 73 71  .z);.  *res = sq
daf0: 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43  lite3VdbeRecordC
db00: 6f 6d 70 61 72 65 28 70 43 2d 3e 70 4b 65 79 49  ompare(pC->pKeyI
db10: 6e 66 6f 2c 20 6d 2e 6e 2d 6c 65 6e 52 6f 77 69  nfo, m.n-lenRowi
db20: 64 2c 20 6d 2e 7a 2c 20 6e 4b 65 79 2c 20 70 4b  d, m.z, nKey, pK
db30: 65 79 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  ey);.  sqlite3Vd
db40: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 29  beMemRelease(&m)
db50: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
db60: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  E_OK;.}../*.** T
db70: 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73  his routine sets
db80: 20 74 68 65 20 76 61 6c 75 65 20 74 6f 20 62 65   the value to be
db90: 20 72 65 74 75 72 6e 65 64 20 62 79 20 73 75 62   returned by sub
dba0: 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 6f  sequent calls to
dbb0: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 68 61 6e  .** sqlite3_chan
dbc0: 67 65 73 28 29 20 6f 6e 20 74 68 65 20 64 61 74  ges() on the dat
dbd0: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 27 64 62  abase handle 'db
dbe0: 27 2e 20 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  '. .*/.void sqli
dbf0: 74 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 65  te3VdbeSetChange
dc00: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69  s(sqlite3 *db, i
dc10: 6e 74 20 6e 43 68 61 6e 67 65 29 7b 0a 20 20 64  nt nChange){.  d
dc20: 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 6e 43 68  b->nChange = nCh
dc30: 61 6e 67 65 3b 0a 20 20 64 62 2d 3e 6e 54 6f 74  ange;.  db->nTot
dc40: 61 6c 43 68 61 6e 67 65 20 2b 3d 20 6e 43 68 61  alChange += nCha
dc50: 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65  nge;.}../*.** Se
dc60: 74 20 61 20 66 6c 61 67 20 69 6e 20 74 68 65 20  t a flag in the 
dc70: 76 64 62 65 20 74 6f 20 75 70 64 61 74 65 20 74  vdbe to update t
dc80: 68 65 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65  he change counte
dc90: 72 20 77 68 65 6e 20 69 74 20 69 73 20 66 69 6e  r when it is fin
dca0: 61 6c 69 73 65 64 0a 2a 2a 20 6f 72 20 72 65 73  alised.** or res
dcb0: 65 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  et..*/.void sqli
dcc0: 74 65 33 56 64 62 65 43 6f 75 6e 74 43 68 61 6e  te3VdbeCountChan
dcd0: 67 65 73 28 56 64 62 65 20 2a 76 29 7b 0a 20 20  ges(Vdbe *v){.  
dce0: 76 2d 3e 63 68 61 6e 67 65 43 6e 74 4f 6e 20 3d  v->changeCntOn =
dcf0: 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 72   1;.}../*.** Mar
dd00: 6b 20 65 76 65 72 79 20 70 72 65 70 61 72 65 64  k every prepared
dd10: 20 73 74 61 74 65 6d 65 6e 74 20 61 73 73 6f 63   statement assoc
dd20: 69 61 74 65 64 20 77 69 74 68 20 61 20 64 61 74  iated with a dat
dd30: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
dd40: 0a 2a 2a 20 61 73 20 65 78 70 69 72 65 64 2e 0a  .** as expired..
dd50: 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 69 72 65 64  **.** An expired
dd60: 20 73 74 61 74 65 6d 65 6e 74 20 6d 65 61 6e 73   statement means
dd70: 20 74 68 61 74 20 72 65 63 6f 6d 70 69 6c 61 74   that recompilat
dd80: 69 6f 6e 20 6f 66 20 74 68 65 20 73 74 61 74 65  ion of the state
dd90: 6d 65 6e 74 20 69 73 0a 2a 2a 20 72 65 63 6f 6d  ment is.** recom
dda0: 6d 65 6e 64 2e 20 20 53 74 61 74 65 6d 65 6e 74  mend.  Statement
ddb0: 73 20 65 78 70 69 72 65 20 77 68 65 6e 20 74 68  s expire when th
ddc0: 69 6e 67 73 20 68 61 70 70 65 6e 20 74 68 61 74  ings happen that
ddd0: 20 6d 61 6b 65 20 74 68 65 69 72 0a 2a 2a 20 70   make their.** p
dde0: 72 6f 67 72 61 6d 73 20 6f 62 73 6f 6c 65 74 65  rograms obsolete
ddf0: 2e 20 20 52 65 6d 6f 76 69 6e 67 20 75 73 65 72  .  Removing user
de00: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f  -defined functio
de10: 6e 73 20 6f 72 20 63 6f 6c 6c 61 74 69 6e 67 0a  ns or collating.
de20: 2a 2a 20 73 65 71 75 65 6e 63 65 73 2c 20 6f 72  ** sequences, or
de30: 20 63 68 61 6e 67 69 6e 67 20 61 6e 20 61 75 74   changing an aut
de40: 68 6f 72 69 7a 61 74 69 6f 6e 20 66 75 6e 63 74  horization funct
de50: 69 6f 6e 20 61 72 65 20 74 68 65 20 74 79 70 65  ion are the type
de60: 73 20 6f 66 0a 2a 2a 20 74 68 69 6e 67 73 20 74  s of.** things t
de70: 68 61 74 20 6d 61 6b 65 20 70 72 65 70 61 72 65  hat make prepare
de80: 64 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 62 73  d statements obs
de90: 6f 6c 65 74 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73  olete..*/.void s
dea0: 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70  qlite3ExpirePrep
deb0: 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 73  aredStatements(s
dec0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 56  qlite3 *db){.  V
ded0: 64 62 65 20 2a 70 3b 0a 20 20 66 6f 72 28 70 20  dbe *p;.  for(p 
dee0: 3d 20 64 62 2d 3e 70 56 64 62 65 3b 20 70 3b 20  = db->pVdbe; p; 
def0: 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20  p=p->pNext){.   
df00: 20 70 2d 3e 65 78 70 69 72 65 64 20 3d 20 31 3b   p->expired = 1;
df10: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  .  }.}../*.** Re
df20: 74 75 72 6e 20 74 68 65 20 64 61 74 61 62 61 73  turn the databas
df30: 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  e associated wit
df40: 68 20 74 68 65 20 56 64 62 65 2e 0a 2a 2f 0a 73  h the Vdbe..*/.s
df50: 71 6c 69 74 65 33 20 2a 73 71 6c 69 74 65 33 56  qlite3 *sqlite3V
df60: 64 62 65 44 62 28 56 64 62 65 20 2a 76 29 7b 0a  dbeDb(Vdbe *v){.
df70: 20 20 72 65 74 75 72 6e 20 76 2d 3e 64 62 3b 0a    return v->db;.
df80: 7d 0a                                            }.