/ Hex Artifact Content
Login

Artifact 68d5d0881ded9867db1521fa2c0ae5ac8007a9d5:


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 2f 2a 0a 2a 2a 20 46 72 65 65  if.}../*.** Free
55b0: 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 20 61   all resources a
55c0: 6c 6c 6f 63 69 61 74 65 64 20 77 69 74 68 20 41  llociated with A
55d0: 67 67 45 6c 65 6d 20 70 45 6c 65 6d 2c 20 61 6e  ggElem pElem, an
55e0: 20 65 6c 65 6d 65 6e 74 20 6f 66 0a 2a 2a 20 61   element of.** a
55f0: 67 67 72 65 67 61 74 65 20 70 41 67 67 2e 0a 2a  ggregate pAgg..*
5600: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 72  /.static void fr
5610: 65 65 41 67 67 45 6c 65 6d 28 41 67 67 45 6c 65  eeAggElem(AggEle
5620: 6d 20 2a 70 45 6c 65 6d 2c 20 41 67 67 20 2a 70  m *pElem, Agg *p
5630: 41 67 67 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20  Agg){.  int i;. 
5640: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 41 67 67   for(i=0; i<pAgg
5650: 2d 3e 6e 4d 65 6d 3b 20 69 2b 2b 29 7b 0a 20 20  ->nMem; i++){.  
5660: 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 26 70    Mem *pMem = &p
5670: 45 6c 65 6d 2d 3e 61 4d 65 6d 5b 69 5d 3b 0a 20  Elem->aMem[i];. 
5680: 20 20 20 69 66 28 20 70 41 67 67 2d 3e 61 70 46     if( pAgg->apF
5690: 75 6e 63 20 26 26 20 70 41 67 67 2d 3e 61 70 46  unc && pAgg->apF
56a0: 75 6e 63 5b 69 5d 20 26 26 20 28 70 4d 65 6d 2d  unc[i] && (pMem-
56b0: 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41 67 67  >flags & MEM_Agg
56c0: 43 74 78 29 21 3d 30 20 29 7b 0a 20 20 20 20 20  Ctx)!=0 ){.     
56d0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
56e0: 20 63 74 78 3b 0a 20 20 20 20 20 20 63 74 78 2e   ctx;.      ctx.
56f0: 70 46 75 6e 63 20 3d 20 70 41 67 67 2d 3e 61 70  pFunc = pAgg->ap
5700: 46 75 6e 63 5b 69 5d 3b 0a 20 20 20 20 20 20 63  Func[i];.      c
5710: 74 78 2e 73 2e 66 6c 61 67 73 20 3d 20 4d 45 4d  tx.s.flags = MEM
5720: 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 63 74 78  _Null;.      ctx
5730: 2e 70 41 67 67 20 3d 20 70 4d 65 6d 2d 3e 7a 3b  .pAgg = pMem->z;
5740: 0a 20 20 20 20 20 20 63 74 78 2e 63 6e 74 20 3d  .      ctx.cnt =
5750: 20 70 4d 65 6d 2d 3e 69 3b 0a 20 20 20 20 20 20   pMem->i;.      
5760: 63 74 78 2e 69 73 45 72 72 6f 72 20 3d 20 30 3b  ctx.isError = 0;
5770: 0a 20 20 20 20 20 20 28 2a 63 74 78 2e 70 46 75  .      (*ctx.pFu
5780: 6e 63 2d 3e 78 46 69 6e 61 6c 69 7a 65 29 28 26  nc->xFinalize)(&
5790: 63 74 78 29 3b 0a 20 20 20 20 20 20 70 4d 65 6d  ctx);.      pMem
57a0: 2d 3e 7a 20 3d 20 63 74 78 2e 70 41 67 67 3b 0a  ->z = ctx.pAgg;.
57b0: 20 20 20 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e        if( pMem->
57c0: 7a 21 3d 30 20 26 26 20 70 4d 65 6d 2d 3e 7a 21  z!=0 && pMem->z!
57d0: 3d 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 20 29 7b  =pMem->zShort ){
57e0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 46  .        sqliteF
57f0: 72 65 65 28 70 4d 65 6d 2d 3e 7a 29 3b 0a 20 20  ree(pMem->z);.  
5800: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69      }.      sqli
5810: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
5820: 65 28 26 63 74 78 2e 73 29 3b 0a 20 20 20 20 7d  e(&ctx.s);.    }
5830: 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69  else{.      sqli
5840: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
5850: 65 28 70 4d 65 6d 29 3b 0a 20 20 20 20 7d 0a 20  e(pMem);.    }. 
5860: 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28   }.  sqliteFree(
5870: 70 45 6c 65 6d 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  pElem);.}../*.**
5880: 20 52 65 73 65 74 20 61 6e 20 41 67 67 20 73 74   Reset an Agg st
5890: 72 75 63 74 75 72 65 2e 20 20 44 65 6c 65 74 65  ructure.  Delete
58a0: 20 61 6c 6c 20 69 74 73 20 63 6f 6e 74 65 6e 74   all its content
58b0: 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 69 6e 73  s..**.** For ins
58c0: 74 61 6c 6c 61 62 6c 65 20 61 67 67 72 65 67 61  tallable aggrega
58d0: 74 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20 69 66  te functions, if
58e0: 20 74 68 65 20 73 74 65 70 20 66 75 6e 63 74 69   the step functi
58f0: 6f 6e 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 63  on has been.** c
5900: 61 6c 6c 65 64 2c 20 6d 61 6b 65 20 73 75 72 65  alled, make sure
5910: 20 74 68 65 20 66 69 6e 61 6c 69 7a 65 72 20 66   the finalizer f
5920: 75 6e 63 74 69 6f 6e 20 68 61 73 20 61 6c 73 6f  unction has also
5930: 20 62 65 65 6e 20 63 61 6c 6c 65 64 2e 20 20 54   been called.  T
5940: 68 65 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 72 20  he.** finalizer 
5950: 6d 69 67 68 74 20 6e 65 65 64 20 74 6f 20 66 72  might need to fr
5960: 65 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 77  ee memory that w
5970: 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 73 20  as allocated as 
5980: 70 61 72 74 20 6f 66 20 69 74 73 0a 2a 2a 20 70  part of its.** p
5990: 72 69 76 61 74 65 20 63 6f 6e 74 65 78 74 2e 20  rivate context. 
59a0: 20 49 66 20 74 68 65 20 66 69 6e 61 6c 69 7a 65   If the finalize
59b0: 72 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 63  r has not been c
59c0: 61 6c 6c 65 64 20 79 65 74 2c 20 63 61 6c 6c 20  alled yet, call 
59d0: 69 74 0a 2a 2a 20 6e 6f 77 2e 0a 2a 2a 0a 2a 2a  it.** now..**.**
59e0: 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20   If db is NULL, 
59f0: 74 68 65 6e 20 74 68 69 73 20 69 73 20 62 65 69  then this is bei
5a00: 6e 67 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73  ng called from s
5a10: 71 6c 69 74 65 56 64 62 65 52 65 73 65 74 28 29  qliteVdbeReset()
5a20: 2e 20 49 6e 0a 2a 2a 20 74 68 69 73 20 63 61 73  . In.** this cas
5a30: 65 20 63 6c 65 61 6e 20 75 70 20 61 6c 6c 20 72  e clean up all r
5a40: 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 65  eferences to the
5a50: 20 74 65 6d 70 2d 74 61 62 6c 65 20 75 73 65 64   temp-table used
5a60: 20 66 6f 72 0a 2a 2a 20 61 67 67 72 65 67 61 74   for.** aggregat
5a70: 65 73 20 28 69 66 20 69 74 20 77 61 73 20 65 76  es (if it was ev
5a80: 65 72 20 6f 70 65 6e 65 64 29 2e 0a 2a 2a 0a 2a  er opened)..**.*
5a90: 2a 20 49 66 20 64 62 20 69 73 20 6e 6f 74 20 4e  * If db is not N
5aa0: 55 4c 4c 2c 20 74 68 65 6e 20 74 68 69 73 20 69  ULL, then this i
5ab0: 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 20 66  s being called f
5ac0: 72 6f 6d 20 77 69 74 68 20 61 6e 20 4f 50 5f 41  rom with an OP_A
5ad0: 67 67 52 65 73 65 74 0a 2a 2a 20 6f 70 63 6f 64  ggReset.** opcod
5ae0: 65 2e 20 4f 70 65 6e 20 74 68 65 20 74 65 6d 70  e. Open the temp
5af0: 2d 74 61 62 6c 65 2c 20 69 66 20 69 74 20 68 61  -table, if it ha
5b00: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 62 65  s not already be
5b10: 65 6e 20 6f 70 65 6e 65 64 20 61 6e 64 0a 2a 2a  en opened and.**
5b20: 20 64 65 6c 65 74 65 20 74 68 65 20 63 6f 6e 74   delete the cont
5b30: 65 6e 74 73 20 6f 66 20 74 68 65 20 74 61 62 6c  ents of the tabl
5b40: 65 20 75 73 65 64 20 66 6f 72 20 61 67 67 72 65  e used for aggre
5b50: 67 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  gate information
5b60: 2c 20 72 65 61 64 79 0a 2a 2a 20 66 6f 72 20 74  , ready.** for t
5b70: 68 65 20 6e 65 78 74 20 72 6f 75 6e 64 20 6f 66  he next round of
5b80: 20 61 67 67 72 65 67 61 74 65 20 70 72 6f 63 65   aggregate proce
5b90: 73 73 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ssing..*/.int sq
5ba0: 6c 69 74 65 33 56 64 62 65 41 67 67 52 65 73 65  lite3VdbeAggRese
5bb0: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 41  t(sqlite3 *db, A
5bc0: 67 67 20 2a 70 41 67 67 2c 20 4b 65 79 49 6e 66  gg *pAgg, KeyInf
5bd0: 6f 20 2a 70 4b 65 79 49 6e 66 6f 29 7b 0a 20 20  o *pKeyInfo){.  
5be0: 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20 20 42 74  int rc = 0;.  Bt
5bf0: 43 75 72 73 6f 72 20 2a 70 43 73 72 3b 0a 0a 20  Cursor *pCsr;.. 
5c00: 20 69 66 28 20 21 70 41 67 67 20 29 20 72 65 74   if( !pAgg ) ret
5c10: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
5c20: 20 70 43 73 72 20 3d 20 70 41 67 67 2d 3e 70 43   pCsr = pAgg->pC
5c30: 73 72 3b 0a 20 20 61 73 73 65 72 74 28 20 28 70  sr;.  assert( (p
5c40: 43 73 72 20 26 26 20 70 41 67 67 2d 3e 6e 54 61  Csr && pAgg->nTa
5c50: 62 3e 30 29 20 7c 7c 20 28 21 70 43 73 72 20 26  b>0) || (!pCsr &
5c60: 26 20 70 41 67 67 2d 3e 6e 54 61 62 3d 3d 30 29  & pAgg->nTab==0)
5c70: 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c  .         || sql
5c80: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
5c90: 65 64 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70  ed );..  /* If p
5ca0: 43 73 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c  Csr is not NULL,
5cb0: 20 74 68 65 6e 20 74 68 65 20 74 61 62 6c 65 20   then the table 
5cc0: 75 73 65 64 20 66 6f 72 20 61 67 67 72 65 67 61  used for aggrega
5cd0: 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 20  te information. 
5ce0: 20 2a 2a 20 69 73 20 6f 70 65 6e 2e 20 4c 6f 6f   ** is open. Loo
5cf0: 70 20 74 68 72 6f 75 67 68 20 69 74 20 61 6e 64  p through it and
5d00: 20 66 72 65 65 20 74 68 65 20 41 67 67 45 6c 65   free the AggEle
5d10: 6d 2a 20 73 74 72 75 63 74 75 72 65 20 70 6f 69  m* structure poi
5d20: 6e 74 65 64 20 61 74 0a 20 20 2a 2a 20 62 79 20  nted at.  ** by 
5d30: 65 61 63 68 20 65 6e 74 72 79 2e 20 49 66 20 74  each entry. If t
5d40: 68 65 20 66 69 6e 61 6c 69 7a 65 72 20 68 61 73  he finalizer has
5d50: 20 6e 6f 74 20 62 65 65 6e 20 63 61 6c 6c 65 64   not been called
5d60: 20 66 6f 72 20 61 6e 20 41 67 67 45 6c 65 6d 2c   for an AggElem,
5d70: 0a 20 20 2a 2a 20 64 6f 20 74 68 61 74 20 74 6f  .  ** do that to
5d80: 6f 2e 20 46 69 6e 61 6c 6c 79 2c 20 63 6c 65 61  o. Finally, clea
5d90: 72 20 74 68 65 20 62 74 72 65 65 20 74 61 62 6c  r the btree tabl
5da0: 65 20 69 74 73 65 6c 66 2e 0a 20 20 2a 2f 0a 20  e itself..  */. 
5db0: 20 69 66 28 20 70 43 73 72 20 29 7b 0a 20 20 20   if( pCsr ){.   
5dc0: 20 69 6e 74 20 72 65 73 3b 0a 20 20 20 20 61 73   int res;.    as
5dd0: 73 65 72 74 28 20 70 41 67 67 2d 3e 70 42 74 72  sert( pAgg->pBtr
5de0: 65 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  ee );.    assert
5df0: 28 20 70 41 67 67 2d 3e 6e 54 61 62 3e 30 20 29  ( pAgg->nTab>0 )
5e00: 3b 0a 0a 20 20 20 20 72 63 3d 73 71 6c 69 74 65  ;..    rc=sqlite
5e10: 33 42 74 72 65 65 46 69 72 73 74 28 70 43 73 72  3BtreeFirst(pCsr
5e20: 2c 20 26 72 65 73 29 3b 0a 20 20 20 20 77 68 69  , &res);.    whi
5e30: 6c 65 28 20 72 65 73 3d 3d 30 20 26 26 20 72 63  le( res==0 && rc
5e40: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
5e50: 20 20 20 20 20 41 67 67 45 6c 65 6d 20 2a 70 45       AggElem *pE
5e60: 6c 65 6d 3b 0a 20 20 20 20 20 20 72 63 20 3d 20  lem;.      rc = 
5e70: 73 71 6c 69 74 65 33 42 74 72 65 65 44 61 74 61  sqlite3BtreeData
5e80: 28 70 43 73 72 2c 20 30 2c 20 73 69 7a 65 6f 66  (pCsr, 0, sizeof
5e90: 28 41 67 67 45 6c 65 6d 2a 29 2c 20 28 63 68 61  (AggElem*), (cha
5ea0: 72 20 2a 29 26 70 45 6c 65 6d 29 3b 0a 20 20 20  r *)&pElem);.   
5eb0: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
5ec0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20  E_OK ){.        
5ed0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20  return rc;.     
5ee0: 20 7d 0a 20 20 20 20 20 20 61 73 73 65 72 74 28   }.      assert(
5ef0: 20 70 41 67 67 2d 3e 61 70 46 75 6e 63 21 3d 30   pAgg->apFunc!=0
5f00: 20 29 3b 0a 20 20 20 20 20 20 66 72 65 65 41 67   );.      freeAg
5f10: 67 45 6c 65 6d 28 70 45 6c 65 6d 2c 20 70 41 67  gElem(pElem, pAg
5f20: 67 29 3b 0a 20 20 20 20 20 20 72 63 3d 73 71 6c  g);.      rc=sql
5f30: 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 70 43  ite3BtreeNext(pC
5f40: 73 72 2c 20 26 72 65 73 29 3b 0a 20 20 20 20 7d  sr, &res);.    }
5f50: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c  .    if( rc!=SQL
5f60: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
5f70: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d  return rc;.    }
5f80: 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72  ..    sqlite3Btr
5f90: 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70 43  eeCloseCursor(pC
5fa0: 73 72 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  sr);.    sqlite3
5fb0: 42 74 72 65 65 43 6c 65 61 72 54 61 62 6c 65 28  BtreeClearTable(
5fc0: 70 41 67 67 2d 3e 70 42 74 72 65 65 2c 20 70 41  pAgg->pBtree, pA
5fd0: 67 67 2d 3e 6e 54 61 62 29 3b 0a 20 20 7d 65 6c  gg->nTab);.  }el
5fe0: 73 65 7b 20 0a 20 20 20 20 2f 2a 20 54 68 65 20  se{ .    /* The 
5ff0: 63 75 72 73 6f 72 20 6d 61 79 20 6e 6f 74 20 62  cursor may not b
6000: 65 20 6f 70 65 6e 20 62 65 63 61 75 73 65 20 74  e open because t
6010: 68 65 20 61 67 67 72 65 67 61 74 6f 72 20 77 61  he aggregator wa
6020: 73 20 6e 65 76 65 72 20 75 73 65 64 2c 0a 20 20  s never used,.  
6030: 20 20 2a 2a 20 6f 72 20 69 74 20 63 6f 75 6c 64    ** or it could
6040: 20 62 65 20 74 68 61 74 20 69 74 20 77 61 73 20   be that it was 
6050: 75 73 65 64 20 62 75 74 20 74 68 65 72 65 20 77  used but there w
6060: 61 73 20 6e 6f 20 47 52 4f 55 50 20 42 59 20 63  as no GROUP BY c
6070: 6c 61 75 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 20  lause..    */.  
6080: 20 20 69 66 28 20 70 41 67 67 2d 3e 70 43 75 72    if( pAgg->pCur
6090: 72 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 66 72  rent ){.      fr
60a0: 65 65 41 67 67 45 6c 65 6d 28 70 41 67 67 2d 3e  eeAggElem(pAgg->
60b0: 70 43 75 72 72 65 6e 74 2c 20 70 41 67 67 29 3b  pCurrent, pAgg);
60c0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a  .    }.  }..  /*
60d0: 20 49 66 20 64 62 20 69 73 20 6e 6f 74 20 4e 55   If db is not NU
60e0: 4c 4c 20 61 6e 64 20 77 65 20 68 61 76 65 20 6e  LL and we have n
60f0: 6f 74 20 79 65 74 20 61 6e 64 20 77 65 20 68 61  ot yet and we ha
6100: 76 65 20 6e 6f 74 20 79 65 74 20 6f 70 65 6e 65  ve not yet opene
6110: 64 0a 20 20 2a 2a 20 74 68 65 20 74 65 6d 70 6f  d.  ** the tempo
6120: 72 61 72 79 20 62 74 72 65 65 20 74 68 65 6e 20  rary btree then 
6130: 64 6f 20 73 6f 20 61 6e 64 20 63 72 65 61 74 65  do so and create
6140: 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 73 74   the table to st
6150: 6f 72 65 20 61 67 67 72 65 67 61 74 65 0a 20 20  ore aggregate.  
6160: 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a  ** information..
6170: 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 64 62 20    **.  ** If db 
6180: 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 63 6c  is NULL, then cl
6190: 6f 73 65 20 74 68 65 20 74 65 6d 70 6f 72 61 72  ose the temporar
61a0: 79 20 62 74 72 65 65 20 69 66 20 69 74 20 69 73  y btree if it is
61b0: 20 6f 70 65 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66   open..  */.  if
61c0: 28 20 64 62 20 29 7b 0a 20 20 20 20 69 66 28 20  ( db ){.    if( 
61d0: 21 70 41 67 67 2d 3e 70 42 74 72 65 65 20 29 7b  !pAgg->pBtree ){
61e0: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
61f0: 41 67 67 2d 3e 6e 54 61 62 3d 3d 30 20 29 3b 0a  Agg->nTab==0 );.
6200: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
6210: 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a 20 20 20  MIT_MEMORYDB.   
6220: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
6230: 74 72 65 65 46 61 63 74 6f 72 79 28 64 62 2c 20  treeFactory(db, 
6240: 22 3a 6d 65 6d 6f 72 79 3a 22 2c 20 30 2c 20 54  ":memory:", 0, T
6250: 45 4d 50 5f 50 41 47 45 53 2c 20 26 70 41 67 67  EMP_PAGES, &pAgg
6260: 2d 3e 70 42 74 72 65 65 29 3b 0a 23 65 6c 73 65  ->pBtree);.#else
6270: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
6280: 74 65 33 42 74 72 65 65 46 61 63 74 6f 72 79 28  te3BtreeFactory(
6290: 64 62 2c 20 30 2c 20 30 2c 20 54 45 4d 50 5f 50  db, 0, 0, TEMP_P
62a0: 41 47 45 53 2c 20 26 70 41 67 67 2d 3e 70 42 74  AGES, &pAgg->pBt
62b0: 72 65 65 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20  ree);.#endif.   
62c0: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
62d0: 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63  E_OK ) return rc
62e0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42  ;.      sqlite3B
62f0: 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73 28 70  treeBeginTrans(p
6300: 41 67 67 2d 3e 70 42 74 72 65 65 2c 20 31 29 3b  Agg->pBtree, 1);
6310: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
6320: 74 65 33 42 74 72 65 65 43 72 65 61 74 65 54 61  te3BtreeCreateTa
6330: 62 6c 65 28 70 41 67 67 2d 3e 70 42 74 72 65 65  ble(pAgg->pBtree
6340: 2c 20 26 70 41 67 67 2d 3e 6e 54 61 62 2c 20 30  , &pAgg->nTab, 0
6350: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21  );.      if( rc!
6360: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74  =SQLITE_OK ) ret
6370: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20  urn rc;.    }.  
6380: 20 20 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e    assert( pAgg->
6390: 6e 54 61 62 21 3d 30 20 29 3b 0a 0a 20 20 20 20  nTab!=0 );..    
63a0: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
63b0: 65 43 75 72 73 6f 72 28 70 41 67 67 2d 3e 70 42  eCursor(pAgg->pB
63c0: 74 72 65 65 2c 20 70 41 67 67 2d 3e 6e 54 61 62  tree, pAgg->nTab
63d0: 2c 20 31 2c 0a 20 20 20 20 20 20 20 20 73 71 6c  , 1,.        sql
63e0: 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f  ite3VdbeRecordCo
63f0: 6d 70 61 72 65 2c 20 70 4b 65 79 49 6e 66 6f 2c  mpare, pKeyInfo,
6400: 20 26 70 41 67 67 2d 3e 70 43 73 72 29 3b 0a 20   &pAgg->pCsr);. 
6410: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
6420: 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63  E_OK ) return rc
6430: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69  ;.  }else{.    i
6440: 66 28 20 70 41 67 67 2d 3e 70 42 74 72 65 65 20  f( pAgg->pBtree 
6450: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
6460: 42 74 72 65 65 43 6c 6f 73 65 28 70 41 67 67 2d  BtreeClose(pAgg-
6470: 3e 70 42 74 72 65 65 29 3b 0a 20 20 20 20 20 20  >pBtree);.      
6480: 70 41 67 67 2d 3e 70 42 74 72 65 65 20 3d 20 30  pAgg->pBtree = 0
6490: 3b 0a 20 20 20 20 20 20 70 41 67 67 2d 3e 6e 54  ;.      pAgg->nT
64a0: 61 62 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20  ab = 0;.    }.  
64b0: 20 20 70 41 67 67 2d 3e 70 43 73 72 20 3d 20 30    pAgg->pCsr = 0
64c0: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 41 67  ;.  }..  if( pAg
64d0: 67 2d 3e 61 70 46 75 6e 63 20 29 7b 20 0a 20 20  g->apFunc ){ .  
64e0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 41 67    sqliteFree(pAg
64f0: 67 2d 3e 61 70 46 75 6e 63 29 3b 0a 20 20 20 20  g->apFunc);.    
6500: 70 41 67 67 2d 3e 61 70 46 75 6e 63 20 3d 20 30  pAgg->apFunc = 0
6510: 3b 0a 20 20 7d 0a 20 20 70 41 67 67 2d 3e 70 43  ;.  }.  pAgg->pC
6520: 75 72 72 65 6e 74 20 3d 20 30 3b 0a 20 20 70 41  urrent = 0;.  pA
6530: 67 67 2d 3e 6e 4d 65 6d 20 3d 20 30 3b 0a 20 20  gg->nMem = 0;.  
6540: 70 41 67 67 2d 3e 73 65 61 72 63 68 69 6e 67 20  pAgg->searching 
6550: 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  = 0;.  return SQ
6560: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
6570: 2a 20 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72  * Close a cursor
6580: 20 61 6e 64 20 72 65 6c 65 61 73 65 20 61 6c 6c   and release all
6590: 20 74 68 65 20 72 65 73 6f 75 72 63 65 73 20 74   the resources t
65a0: 68 61 74 20 63 75 72 73 6f 72 20 68 61 70 70 65  hat cursor happe
65b0: 6e 73 0a 2a 2a 20 74 6f 20 68 6f 6c 64 2e 0a 2a  ns.** to hold..*
65c0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
65d0: 62 65 46 72 65 65 43 75 72 73 6f 72 28 43 75 72  beFreeCursor(Cur
65e0: 73 6f 72 20 2a 70 43 78 29 7b 0a 20 20 69 66 28  sor *pCx){.  if(
65f0: 20 70 43 78 3d 3d 30 20 29 7b 0a 20 20 20 20 72   pCx==0 ){.    r
6600: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28  eturn;.  }.  if(
6610: 20 70 43 78 2d 3e 70 43 75 72 73 6f 72 20 29 7b   pCx->pCursor ){
6620: 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65  .    sqlite3Btre
6630: 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70 43 78  eCloseCursor(pCx
6640: 2d 3e 70 43 75 72 73 6f 72 29 3b 0a 20 20 7d 0a  ->pCursor);.  }.
6650: 20 20 69 66 28 20 70 43 78 2d 3e 70 42 74 20 29    if( pCx->pBt )
6660: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72  {.    sqlite3Btr
6670: 65 65 43 6c 6f 73 65 28 70 43 78 2d 3e 70 42 74  eeClose(pCx->pBt
6680: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46  );.  }.  sqliteF
6690: 72 65 65 28 70 43 78 2d 3e 70 44 61 74 61 29 3b  ree(pCx->pData);
66a0: 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 43  .  sqliteFree(pC
66b0: 78 2d 3e 61 54 79 70 65 29 3b 0a 20 20 73 71 6c  x->aType);.  sql
66c0: 69 74 65 46 72 65 65 28 70 43 78 29 3b 0a 7d 0a  iteFree(pCx);.}.
66d0: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c  ./*.** Close all
66e0: 20 63 75 72 73 6f 72 73 0a 2a 2f 0a 73 74 61 74   cursors.*/.stat
66f0: 69 63 20 76 6f 69 64 20 63 6c 6f 73 65 41 6c 6c  ic void closeAll
6700: 43 75 72 73 6f 72 73 28 56 64 62 65 20 2a 70 29  Cursors(Vdbe *p)
6710: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28  {.  int i;.  if(
6720: 20 70 2d 3e 61 70 43 73 72 3d 3d 30 20 29 20 72   p->apCsr==0 ) r
6730: 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 69 3d 30  eturn;.  for(i=0
6740: 3b 20 69 3c 70 2d 3e 6e 43 75 72 73 6f 72 3b 20  ; i<p->nCursor; 
6750: 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  i++){.    sqlite
6760: 33 56 64 62 65 46 72 65 65 43 75 72 73 6f 72 28  3VdbeFreeCursor(
6770: 70 2d 3e 61 70 43 73 72 5b 69 5d 29 3b 0a 20 20  p->apCsr[i]);.  
6780: 20 20 70 2d 3e 61 70 43 73 72 5b 69 5d 20 3d 20    p->apCsr[i] = 
6790: 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  0;.  }.}../*.** 
67a0: 43 6c 65 61 6e 20 75 70 20 74 68 65 20 56 4d 20  Clean up the VM 
67b0: 61 66 74 65 72 20 65 78 65 63 75 74 69 6f 6e 2e  after execution.
67c0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
67d0: 69 6e 65 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74  ine will automat
67e0: 69 63 61 6c 6c 79 20 63 6c 6f 73 65 20 61 6e 79  ically close any
67f0: 20 63 75 72 73 6f 72 73 2c 20 6c 69 73 74 73 2c   cursors, lists,
6800: 20 61 6e 64 2f 6f 72 0a 2a 2a 20 73 6f 72 74 65   and/or.** sorte
6810: 72 73 20 74 68 61 74 20 77 65 72 65 20 6c 65 66  rs that were lef
6820: 74 20 6f 70 65 6e 2e 20 20 49 74 20 61 6c 73 6f  t open.  It also
6830: 20 64 65 6c 65 74 65 73 20 74 68 65 20 76 61 6c   deletes the val
6840: 75 65 73 20 6f 66 0a 2a 2a 20 76 61 72 69 61 62  ues of.** variab
6850: 6c 65 73 20 69 6e 20 74 68 65 20 61 56 61 72 5b  les in the aVar[
6860: 5d 20 61 72 72 61 79 2e 0a 2a 2f 0a 73 74 61 74  ] array..*/.stat
6870: 69 63 20 76 6f 69 64 20 43 6c 65 61 6e 75 70 28  ic void Cleanup(
6880: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20  Vdbe *p){.  int 
6890: 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61 53 74 61  i;.  if( p->aSta
68a0: 63 6b 20 29 7b 0a 20 20 20 20 72 65 6c 65 61 73  ck ){.    releas
68b0: 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 53 74  eMemArray(p->aSt
68c0: 61 63 6b 2c 20 31 20 2b 20 28 70 2d 3e 70 54 6f  ack, 1 + (p->pTo
68d0: 73 20 2d 20 70 2d 3e 61 53 74 61 63 6b 29 29 3b  s - p->aStack));
68e0: 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d 20 26  .    p->pTos = &
68f0: 70 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d 3b 0a 20  p->aStack[-1];. 
6900: 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72   }.  closeAllCur
6910: 73 6f 72 73 28 70 29 3b 0a 20 20 72 65 6c 65 61  sors(p);.  relea
6920: 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 4d  seMemArray(p->aM
6930: 65 6d 2c 20 70 2d 3e 6e 4d 65 6d 29 3b 0a 20 20  em, p->nMem);.  
6940: 73 71 6c 69 74 65 33 56 64 62 65 46 69 66 6f 43  sqlite3VdbeFifoC
6950: 6c 65 61 72 28 26 70 2d 3e 73 46 69 66 6f 29 3b  lear(&p->sFifo);
6960: 0a 20 20 69 66 28 20 70 2d 3e 63 6f 6e 74 65 78  .  if( p->contex
6970: 74 53 74 61 63 6b 20 29 7b 0a 20 20 20 20 66 6f  tStack ){.    fo
6980: 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 63 6f 6e 74  r(i=0; i<p->cont
6990: 65 78 74 53 74 61 63 6b 54 6f 70 3b 20 69 2b 2b  extStackTop; i++
69a0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
69b0: 56 64 62 65 46 69 66 6f 43 6c 65 61 72 28 26 70  VdbeFifoClear(&p
69c0: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 5b 69  ->contextStack[i
69d0: 5d 2e 73 46 69 66 6f 29 3b 0a 20 20 20 20 7d 0a  ].sFifo);.    }.
69e0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
69f0: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 29 3b  ->contextStack);
6a00: 0a 20 20 7d 0a 20 20 66 6f 72 28 69 3d 30 3b 20  .  }.  for(i=0; 
6a10: 69 3c 70 2d 3e 6e 41 67 67 3b 20 69 2b 2b 29 7b  i<p->nAgg; i++){
6a20: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
6a30: 41 67 67 52 65 73 65 74 28 30 2c 20 26 70 2d 3e  AggReset(0, &p->
6a40: 61 70 41 67 67 5b 69 5d 2c 20 30 29 3b 0a 20 20  apAgg[i], 0);.  
6a50: 7d 0a 20 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74  }.  p->contextSt
6a60: 61 63 6b 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f  ack = 0;.  p->co
6a70: 6e 74 65 78 74 53 74 61 63 6b 44 65 70 74 68 20  ntextStackDepth 
6a80: 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65 78  = 0;.  p->contex
6a90: 74 53 74 61 63 6b 54 6f 70 20 3d 20 30 3b 0a 20  tStackTop = 0;. 
6aa0: 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 7a   sqliteFree(p->z
6ab0: 45 72 72 4d 73 67 29 3b 0a 20 20 70 2d 3e 7a 45  ErrMsg);.  p->zE
6ac0: 72 72 4d 73 67 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a  rrMsg = 0;.}../*
6ad0: 0a 2a 2a 20 53 65 74 20 74 68 65 20 6e 75 6d 62  .** Set the numb
6ae0: 65 72 20 6f 66 20 72 65 73 75 6c 74 20 63 6f 6c  er of result col
6af0: 75 6d 6e 73 20 74 68 61 74 20 77 69 6c 6c 20 62  umns that will b
6b00: 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68  e returned by th
6b10: 69 73 20 53 51 4c 0a 2a 2a 20 73 74 61 74 65 6d  is SQL.** statem
6b20: 65 6e 74 2e 20 54 68 69 73 20 69 73 20 6e 6f 77  ent. This is now
6b30: 20 73 65 74 20 61 74 20 63 6f 6d 70 69 6c 65 20   set at compile 
6b40: 74 69 6d 65 2c 20 72 61 74 68 65 72 20 74 68 61  time, rather tha
6b50: 6e 20 64 75 72 69 6e 67 0a 2a 2a 20 65 78 65 63  n during.** exec
6b60: 75 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 64 62  ution of the vdb
6b70: 65 20 70 72 6f 67 72 61 6d 20 73 6f 20 74 68 61  e program so tha
6b80: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  t sqlite3_column
6b90: 5f 63 6f 75 6e 74 28 29 20 63 61 6e 0a 2a 2a 20  _count() can.** 
6ba0: 62 65 20 63 61 6c 6c 65 64 20 6f 6e 20 61 6e 20  be called on an 
6bb0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 62 65  SQL statement be
6bc0: 66 6f 72 65 20 73 71 6c 69 74 65 33 5f 73 74 65  fore sqlite3_ste
6bd0: 70 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  p()..*/.void sql
6be0: 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d 43 6f  ite3VdbeSetNumCo
6bf0: 6c 73 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20  ls(Vdbe *p, int 
6c00: 6e 52 65 73 43 6f 6c 75 6d 6e 29 7b 0a 20 20 4d  nResColumn){.  M
6c10: 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 20 20  em *pColName;.  
6c20: 69 6e 74 20 6e 3b 0a 20 20 61 73 73 65 72 74 28  int n;.  assert(
6c30: 20 30 3d 3d 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d   0==p->nResColum
6c40: 6e 20 29 3b 0a 20 20 70 2d 3e 6e 52 65 73 43 6f  n );.  p->nResCo
6c50: 6c 75 6d 6e 20 3d 20 6e 52 65 73 43 6f 6c 75 6d  lumn = nResColum
6c60: 6e 3b 0a 20 20 6e 20 3d 20 6e 52 65 73 43 6f 6c  n;.  n = nResCol
6c70: 75 6d 6e 2a 32 3b 0a 20 20 70 2d 3e 61 43 6f 6c  umn*2;.  p->aCol
6c80: 4e 61 6d 65 20 3d 20 70 43 6f 6c 4e 61 6d 65 20  Name = pColName 
6c90: 3d 20 28 4d 65 6d 2a 29 73 71 6c 69 74 65 4d 61  = (Mem*)sqliteMa
6ca0: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 4d 65 6d  lloc( sizeof(Mem
6cb0: 29 2a 6e 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e  )*n );.  if( p->
6cc0: 61 43 6f 6c 4e 61 6d 65 3d 3d 30 20 29 20 72 65  aColName==0 ) re
6cd0: 74 75 72 6e 3b 0a 20 20 77 68 69 6c 65 28 20 6e  turn;.  while( n
6ce0: 2d 2d 20 3e 20 30 20 29 7b 0a 20 20 20 20 28 70  -- > 0 ){.    (p
6cf0: 43 6f 6c 4e 61 6d 65 2b 2b 29 2d 3e 66 6c 61 67  ColName++)->flag
6d00: 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20  s = MEM_Null;.  
6d10: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74  }.}../*.** Set t
6d20: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 69  he name of the i
6d30: 64 78 27 74 68 20 63 6f 6c 75 6d 6e 20 74 6f 20  dx'th column to 
6d40: 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 74  be returned by t
6d50: 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  he SQL statement
6d60: 2e 0a 2a 2a 20 7a 4e 61 6d 65 20 6d 75 73 74 20  ..** zName must 
6d70: 62 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  be a pointer to 
6d80: 61 20 6e 75 6c 20 74 65 72 6d 69 6e 61 74 65 64  a nul terminated
6d90: 20 73 74 72 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54   string..**.** T
6da0: 68 69 73 20 63 61 6c 6c 20 6d 75 73 74 20 62 65  his call must be
6db0: 20 6d 61 64 65 20 61 66 74 65 72 20 61 20 63 61   made after a ca
6dc0: 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62  ll to sqlite3Vdb
6dd0: 65 53 65 74 4e 75 6d 43 6f 6c 73 28 29 2e 0a 2a  eSetNumCols()..*
6de0: 2a 0a 2a 2a 20 49 66 20 4e 3d 3d 50 33 5f 53 54  *.** If N==P3_ST
6df0: 41 54 49 43 20 20 69 74 20 6d 65 61 6e 73 20 74  ATIC  it means t
6e00: 68 61 74 20 7a 4e 61 6d 65 20 69 73 20 61 20 70  hat zName is a p
6e10: 6f 69 6e 74 65 72 20 74 6f 20 61 20 63 6f 6e 73  ointer to a cons
6e20: 74 61 6e 74 20 73 74 61 74 69 63 0a 2a 2a 20 73  tant static.** s
6e30: 74 72 69 6e 67 20 61 6e 64 20 77 65 20 63 61 6e  tring and we can
6e40: 20 6a 75 73 74 20 63 6f 70 79 20 74 68 65 20 70   just copy the p
6e50: 6f 69 6e 74 65 72 2e 20 49 66 20 69 74 20 69 73  ointer. If it is
6e60: 20 50 33 5f 44 59 4e 41 4d 49 43 2c 20 74 68 65   P3_DYNAMIC, the
6e70: 6e 20 0a 2a 2a 20 74 68 65 20 73 74 72 69 6e 67  n .** the string
6e80: 20 69 73 20 66 72 65 65 64 20 75 73 69 6e 67 20   is freed using 
6e90: 73 71 6c 69 74 65 46 72 65 65 28 29 20 77 68 65  sqliteFree() whe
6ea0: 6e 20 74 68 65 20 76 64 62 65 20 69 73 20 66 69  n the vdbe is fi
6eb0: 6e 69 73 68 65 64 20 77 69 74 68 0a 2a 2a 20 69  nished with.** i
6ec0: 74 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 4e 20  t. Otherwise, N 
6ed0: 62 79 74 65 73 20 6f 66 20 7a 4e 61 6d 65 20 61  bytes of zName a
6ee0: 72 65 20 63 6f 70 69 65 64 2e 0a 2a 2f 0a 69 6e  re copied..*/.in
6ef0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74  t sqlite3VdbeSet
6f00: 43 6f 6c 4e 61 6d 65 28 56 64 62 65 20 2a 70 2c  ColName(Vdbe *p,
6f10: 20 69 6e 74 20 69 64 78 2c 20 63 6f 6e 73 74 20   int idx, const 
6f20: 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e 74  char *zName, int
6f30: 20 4e 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20   N){.  int rc;. 
6f40: 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b 0a   Mem *pColName;.
6f50: 20 20 61 73 73 65 72 74 28 20 69 64 78 3c 28 32    assert( idx<(2
6f60: 2a 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 29 20  *p->nResColumn) 
6f70: 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  );.  if( sqlite3
6f80: 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29  _malloc_failed )
6f90: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e   return SQLITE_N
6fa0: 4f 4d 45 4d 3b 0a 20 20 61 73 73 65 72 74 28 20  OMEM;.  assert( 
6fb0: 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21 3d 30 20 29  p->aColName!=0 )
6fc0: 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65 20 3d 20 26  ;.  pColName = &
6fd0: 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 69 64 78  (p->aColName[idx
6fe0: 5d 29 3b 0a 20 20 69 66 28 20 4e 3d 3d 50 33 5f  ]);.  if( N==P3_
6ff0: 44 59 4e 41 4d 49 43 20 7c 7c 20 4e 3d 3d 50 33  DYNAMIC || N==P3
7000: 5f 53 54 41 54 49 43 20 29 7b 0a 20 20 20 20 72  _STATIC ){.    r
7010: 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d  c = sqlite3VdbeM
7020: 65 6d 53 65 74 53 74 72 28 70 43 6f 6c 4e 61 6d  emSetStr(pColNam
7030: 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53 51  e, zName, -1, SQ
7040: 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54  LITE_UTF8, SQLIT
7050: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7d 65 6c  E_STATIC);.  }el
7060: 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  se{.    rc = sql
7070: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
7080: 72 28 70 43 6f 6c 4e 61 6d 65 2c 20 7a 4e 61 6d  r(pColName, zNam
7090: 65 2c 20 4e 2c 20 53 51 4c 49 54 45 5f 55 54 46  e, N, SQLITE_UTF
70a0: 38 2c 53 51 4c 49 54 45 5f 54 52 41 4e 53 49 45  8,SQLITE_TRANSIE
70b0: 4e 54 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72  NT);.  }.  if( r
70c0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c==SQLITE_OK && 
70d0: 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29 7b  N==P3_DYNAMIC ){
70e0: 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65 2d 3e 66  .    pColName->f
70f0: 6c 61 67 73 20 3d 20 28 70 43 6f 6c 4e 61 6d 65  lags = (pColName
7100: 2d 3e 66 6c 61 67 73 26 28 7e 4d 45 4d 5f 53 74  ->flags&(~MEM_St
7110: 61 74 69 63 29 29 7c 4d 45 4d 5f 44 79 6e 3b 0a  atic))|MEM_Dyn;.
7120: 20 20 20 20 70 43 6f 6c 4e 61 6d 65 2d 3e 78 44      pColName->xD
7130: 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65  el = 0;.  }.  re
7140: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
7150: 2a 20 41 20 72 65 61 64 20 6f 72 20 77 72 69 74  * A read or writ
7160: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 61  e transaction ma
7170: 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65 20  y or may not be 
7180: 61 63 74 69 76 65 20 6f 6e 20 64 61 74 61 62 61  active on databa
7190: 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e  se handle.** db.
71a0: 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   If a transactio
71b0: 6e 20 69 73 20 61 63 74 69 76 65 2c 20 63 6f 6d  n is active, com
71c0: 6d 69 74 20 69 74 2e 20 49 66 20 74 68 65 72 65  mit it. If there
71d0: 20 69 73 20 61 0a 2a 2a 20 77 72 69 74 65 2d 74   is a.** write-t
71e0: 72 61 6e 73 61 63 74 69 6f 6e 20 73 70 61 6e 6e  ransaction spann
71f0: 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e  ing more than on
7200: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
7210: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a   this routine.**
7220: 20 74 61 6b 65 73 20 63 61 72 65 20 6f 66 20 74   takes care of t
7230: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
7240: 6c 20 74 72 69 63 6b 65 72 79 2e 0a 2a 2f 0a 73  l trickery..*/.s
7250: 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 43 6f  tatic int vdbeCo
7260: 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62  mmit(sqlite3 *db
7270: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e  ){.  int i;.  in
7280: 74 20 6e 54 72 61 6e 73 20 3d 20 30 3b 20 20 2f  t nTrans = 0;  /
7290: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 61 74 61  * Number of data
72a0: 62 61 73 65 73 20 77 69 74 68 20 61 6e 20 61 63  bases with an ac
72b0: 74 69 76 65 20 77 72 69 74 65 2d 74 72 61 6e 73  tive write-trans
72c0: 61 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20  action */.  int 
72d0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
72e0: 20 20 69 6e 74 20 6e 65 65 64 58 63 6f 6d 6d 69    int needXcommi
72f0: 74 20 3d 20 30 3b 0a 0a 20 20 66 6f 72 28 69 3d  t = 0;..  for(i=
7300: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  0; i<db->nDb; i+
7310: 2b 29 7b 20 0a 20 20 20 20 42 74 72 65 65 20 2a  +){ .    Btree *
7320: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d  pBt = db->aDb[i]
7330: 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42  .pBt;.    if( pB
7340: 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 72 65  t && sqlite3Btre
7350: 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20  eIsInTrans(pBt) 
7360: 29 7b 0a 20 20 20 20 20 20 6e 65 65 64 58 63 6f  ){.      needXco
7370: 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 20  mmit = 1;.      
7380: 69 66 28 20 69 21 3d 31 20 29 20 6e 54 72 61 6e  if( i!=1 ) nTran
7390: 73 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  s++;.    }.  }..
73a0: 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72    /* If there ar
73b0: 65 20 61 6e 79 20 77 72 69 74 65 2d 74 72 61 6e  e any write-tran
73c0: 73 61 63 74 69 6f 6e 73 20 61 74 20 61 6c 6c 2c  sactions at all,
73d0: 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 6f 6d 6d   invoke the comm
73e0: 69 74 20 68 6f 6f 6b 20 2a 2f 0a 20 20 69 66 28  it hook */.  if(
73f0: 20 6e 65 65 64 58 63 6f 6d 6d 69 74 20 26 26 20   needXcommit && 
7400: 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62  db->xCommitCallb
7410: 61 63 6b 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  ack ){.    int r
7420: 63 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 61  c;.    sqlite3Sa
7430: 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 20  fetyOff(db);.   
7440: 20 72 63 20 3d 20 64 62 2d 3e 78 43 6f 6d 6d 69   rc = db->xCommi
7450: 74 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 43  tCallback(db->pC
7460: 6f 6d 6d 69 74 41 72 67 29 3b 0a 20 20 20 20 73  ommitArg);.    s
7470: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64  qlite3SafetyOn(d
7480: 62 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29  b);.    if( rc )
7490: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53  {.      return S
74a0: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54  QLITE_CONSTRAINT
74b0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
74c0: 2a 20 54 68 65 20 73 69 6d 70 6c 65 20 63 61 73  * The simple cas
74d0: 65 20 2d 20 6e 6f 20 6d 6f 72 65 20 74 68 61 6e  e - no more than
74e0: 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66 69   one database fi
74f0: 6c 65 20 28 6e 6f 74 20 63 6f 75 6e 74 69 6e 67  le (not counting
7500: 20 74 68 65 0a 20 20 2a 2a 20 54 45 4d 50 20 64   the.  ** TEMP d
7510: 61 74 61 62 61 73 65 29 20 68 61 73 20 61 20 74  atabase) has a t
7520: 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 74 69 76  ransaction activ
7530: 65 2e 20 20 20 54 68 65 72 65 20 69 73 20 6e 6f  e.   There is no
7540: 20 6e 65 65 64 20 66 6f 72 20 74 68 65 0a 20 20   need for the.  
7550: 2a 2a 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61  ** master-journa
7560: 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20  l..  **.  ** If 
7570: 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65  the return value
7580: 20 6f 66 20 73 71 6c 69 74 65 33 42 74 72 65 65   of sqlite3Btree
7590: 47 65 74 46 69 6c 65 6e 61 6d 65 28 29 20 69 73  GetFilename() is
75a0: 20 61 20 7a 65 72 6f 20 6c 65 6e 67 74 68 0a 20   a zero length. 
75b0: 20 2a 2a 20 73 74 72 69 6e 67 2c 20 69 74 20 6d   ** string, it m
75c0: 65 61 6e 73 20 74 68 65 20 6d 61 69 6e 20 64 61  eans the main da
75d0: 74 61 62 61 73 65 20 69 73 20 3a 6d 65 6d 6f 72  tabase is :memor
75e0: 79 3a 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73  y:.  In that cas
75f0: 65 20 77 65 20 64 6f 0a 20 20 2a 2a 20 6e 6f 74  e we do.  ** not
7600: 20 73 75 70 70 6f 72 74 20 61 74 6f 6d 69 63 20   support atomic 
7610: 6d 75 6c 74 69 2d 66 69 6c 65 20 63 6f 6d 6d 69  multi-file commi
7620: 74 73 2c 20 73 6f 20 75 73 65 20 74 68 65 20 73  ts, so use the s
7630: 69 6d 70 6c 65 20 63 61 73 65 20 74 68 65 6e 0a  imple case then.
7640: 20 20 2a 2a 20 74 6f 6f 2e 0a 20 20 2a 2f 0a 20    ** too..  */. 
7650: 20 69 66 28 20 30 3d 3d 73 74 72 6c 65 6e 28 73   if( 0==strlen(s
7660: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 46 69  qlite3BtreeGetFi
7670: 6c 65 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b 30  lename(db->aDb[0
7680: 5d 2e 70 42 74 29 29 20 7c 7c 20 6e 54 72 61 6e  ].pBt)) || nTran
7690: 73 3c 3d 31 20 29 7b 0a 20 20 20 20 66 6f 72 28  s<=1 ){.    for(
76a0: 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f  i=0; rc==SQLITE_
76b0: 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b  OK && i<db->nDb;
76c0: 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74   i++){ .      Bt
76d0: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
76e0: 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20  Db[i].pBt;.     
76f0: 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20   if( pBt ){.    
7700: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
7710: 42 74 72 65 65 53 79 6e 63 28 70 42 74 2c 20 30  BtreeSync(pBt, 0
7720: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  );.      }.    }
7730: 0a 0a 20 20 20 20 2f 2a 20 44 6f 20 74 68 65 20  ..    /* Do the 
7740: 63 6f 6d 6d 69 74 20 6f 6e 6c 79 20 69 66 20 61  commit only if a
7750: 6c 6c 20 64 61 74 61 62 61 73 65 73 20 73 75 63  ll databases suc
7760: 63 65 73 73 66 75 6c 6c 79 20 73 79 6e 63 65 64  cessfully synced
7770: 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d 3d   */.    if( rc==
7780: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
7790: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62     for(i=0; i<db
77a0: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nDb; i++){.   
77b0: 20 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20       Btree *pBt 
77c0: 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74  = db->aDb[i].pBt
77d0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 42  ;.        if( pB
77e0: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73  t ){.          s
77f0: 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69  qlite3BtreeCommi
7800: 74 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20 20  t(pBt);.        
7810: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  }.      }.    }.
7820: 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 63 6f    }..  /* The co
7830: 6d 70 6c 65 78 20 63 61 73 65 20 2d 20 54 68 65  mplex case - The
7840: 72 65 20 69 73 20 61 20 6d 75 6c 74 69 2d 66 69  re is a multi-fi
7850: 6c 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63  le write-transac
7860: 74 69 6f 6e 20 61 63 74 69 76 65 2e 0a 20 20 2a  tion active..  *
7870: 2a 20 54 68 69 73 20 72 65 71 75 69 72 65 73 20  * This requires 
7880: 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  a master journal
7890: 20 66 69 6c 65 20 74 6f 20 65 6e 73 75 72 65 20   file to ensure 
78a0: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  the transaction 
78b0: 69 73 0a 20 20 2a 2a 20 63 6f 6d 6d 69 74 74 65  is.  ** committe
78c0: 64 20 61 74 6f 6d 69 63 6c 79 2e 0a 20 20 2a 2f  d atomicly..  */
78d0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
78e0: 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 20 20 65 6c  OMIT_DISKIO.  el
78f0: 73 65 7b 0a 20 20 20 20 69 6e 74 20 6e 65 65 64  se{.    int need
7900: 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20 63 68  Sync = 0;.    ch
7910: 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d 20 30 3b  ar *zMaster = 0;
7920: 20 20 20 2f 2a 20 46 69 6c 65 2d 6e 61 6d 65 20     /* File-name 
7930: 66 6f 72 20 74 68 65 20 6d 61 73 74 65 72 20 6a  for the master j
7940: 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20 20 63 68  ournal */.    ch
7950: 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61 69 6e 46  ar const *zMainF
7960: 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 42 74 72  ile = sqlite3Btr
7970: 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 64 62  eeGetFilename(db
7980: 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20  ->aDb[0].pBt);. 
7990: 20 20 20 4f 73 46 69 6c 65 20 6d 61 73 74 65 72     OsFile master
79a0: 3b 0a 0a 20 20 20 20 2f 2a 20 53 65 6c 65 63 74  ;..    /* Select
79b0: 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61   a master journa
79c0: 6c 20 66 69 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20  l file name */. 
79d0: 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 75 33     do {.      u3
79e0: 32 20 72 61 6e 64 6f 6d 3b 0a 20 20 20 20 20 20  2 random;.      
79f0: 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74  sqliteFree(zMast
7a00: 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  er);.      sqlit
7a10: 65 33 52 61 6e 64 6f 6d 6e 65 73 73 28 73 69 7a  e3Randomness(siz
7a20: 65 6f 66 28 72 61 6e 64 6f 6d 29 2c 20 26 72 61  eof(random), &ra
7a30: 6e 64 6f 6d 29 3b 0a 20 20 20 20 20 20 7a 4d 61  ndom);.      zMa
7a40: 73 74 65 72 20 3d 20 73 71 6c 69 74 65 33 4d 50  ster = sqlite3MP
7a50: 72 69 6e 74 66 28 22 25 73 2d 6d 6a 25 30 38 58  rintf("%s-mj%08X
7a60: 22 2c 20 7a 4d 61 69 6e 46 69 6c 65 2c 20 72 61  ", zMainFile, ra
7a70: 6e 64 6f 6d 26 30 78 37 66 66 66 66 66 66 66 29  ndom&0x7fffffff)
7a80: 3b 0a 20 20 20 20 20 20 69 66 28 20 21 7a 4d 61  ;.      if( !zMa
7a90: 73 74 65 72 20 29 7b 0a 20 20 20 20 20 20 20 20  ster ){.        
7aa0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
7ab0: 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  MEM;.      }.   
7ac0: 20 7d 77 68 69 6c 65 28 20 73 71 6c 69 74 65 33   }while( sqlite3
7ad0: 4f 73 46 69 6c 65 45 78 69 73 74 73 28 7a 4d 61  OsFileExists(zMa
7ae0: 73 74 65 72 29 20 29 3b 0a 0a 20 20 20 20 2f 2a  ster) );..    /*
7af0: 20 4f 70 65 6e 20 74 68 65 20 6d 61 73 74 65 72   Open the master
7b00: 20 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a 20 20 20   journal. */.   
7b10: 20 6d 65 6d 73 65 74 28 26 6d 61 73 74 65 72 2c   memset(&master,
7b20: 20 30 2c 20 73 69 7a 65 6f 66 28 6d 61 73 74 65   0, sizeof(maste
7b30: 72 29 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71  r));.    rc = sq
7b40: 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75  lite3OsOpenExclu
7b50: 73 69 76 65 28 7a 4d 61 73 74 65 72 2c 20 26 6d  sive(zMaster, &m
7b60: 61 73 74 65 72 2c 20 30 29 3b 0a 20 20 20 20 69  aster, 0);.    i
7b70: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
7b80: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
7b90: 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20  Free(zMaster);. 
7ba0: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
7bb0: 20 20 20 20 7d 0a 20 0a 20 20 20 20 2f 2a 20 57      }. .    /* W
7bc0: 72 69 74 65 20 74 68 65 20 6e 61 6d 65 20 6f 66  rite the name of
7bd0: 20 65 61 63 68 20 64 61 74 61 62 61 73 65 20 66   each database f
7be0: 69 6c 65 20 69 6e 20 74 68 65 20 74 72 61 6e 73  ile in the trans
7bf0: 61 63 74 69 6f 6e 20 69 6e 74 6f 20 74 68 65 20  action into the 
7c00: 6e 65 77 0a 20 20 20 20 2a 2a 20 6d 61 73 74 65  new.    ** maste
7c10: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20  r journal file. 
7c20: 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75  If an error occu
7c30: 72 73 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74  rs at this point
7c40: 20 63 6c 6f 73 65 0a 20 20 20 20 2a 2a 20 61 6e   close.    ** an
7c50: 64 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61 73  d delete the mas
7c60: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
7c70: 2e 20 41 6c 6c 20 74 68 65 20 69 6e 64 69 76 69  . All the indivi
7c80: 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  dual journal fil
7c90: 65 73 0a 20 20 20 20 2a 2a 20 73 74 69 6c 6c 20  es.    ** still 
7ca0: 68 61 76 65 20 27 6e 75 6c 6c 27 20 61 73 20 74  have 'null' as t
7cb0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
7cc0: 6c 20 70 6f 69 6e 74 65 72 2c 20 73 6f 20 74 68  l pointer, so th
7cd0: 65 79 20 77 69 6c 6c 20 72 6f 6c 6c 0a 20 20 20  ey will roll.   
7ce0: 20 2a 2a 20 62 61 63 6b 20 69 6e 64 65 70 65 6e   ** back indepen
7cf0: 64 65 6e 74 6c 79 20 69 66 20 61 20 66 61 69 6c  dently if a fail
7d00: 75 72 65 20 6f 63 63 75 72 73 2e 0a 20 20 20 20  ure occurs..    
7d10: 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  */.    for(i=0; 
7d20: 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b  i<db->nDb; i++){
7d30: 20 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a 70   .      Btree *p
7d40: 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e  Bt = db->aDb[i].
7d50: 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 69  pBt;.      if( i
7d60: 3d 3d 31 20 29 20 63 6f 6e 74 69 6e 75 65 3b 20  ==1 ) continue; 
7d70: 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74 68 65 20    /* Ignore the 
7d80: 54 45 4d 50 20 64 61 74 61 62 61 73 65 20 2a 2f  TEMP database */
7d90: 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 20 26  .      if( pBt &
7da0: 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73  & sqlite3BtreeIs
7db0: 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a  InTrans(pBt) ){.
7dc0: 20 20 20 20 20 20 20 20 63 68 61 72 20 63 6f 6e          char con
7dd0: 73 74 20 2a 7a 46 69 6c 65 20 3d 20 73 71 6c 69  st *zFile = sqli
7de0: 74 65 33 42 74 72 65 65 47 65 74 4a 6f 75 72 6e  te3BtreeGetJourn
7df0: 61 6c 6e 61 6d 65 28 70 42 74 29 3b 0a 20 20 20  alname(pBt);.   
7e00: 20 20 20 20 20 69 66 28 20 7a 46 69 6c 65 5b 30       if( zFile[0
7e10: 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b  ]==0 ) continue;
7e20: 20 20 2f 2a 20 49 67 6e 6f 72 65 20 3a 6d 65 6d    /* Ignore :mem
7e30: 6f 72 79 3a 20 64 61 74 61 62 61 73 65 73 20 2a  ory: databases *
7e40: 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 6e  /.        if( !n
7e50: 65 65 64 53 79 6e 63 20 26 26 20 21 73 71 6c 69  eedSync && !sqli
7e60: 74 65 33 42 74 72 65 65 53 79 6e 63 44 69 73 61  te3BtreeSyncDisa
7e70: 62 6c 65 64 28 70 42 74 29 20 29 7b 0a 20 20 20  bled(pBt) ){.   
7e80: 20 20 20 20 20 20 20 6e 65 65 64 53 79 6e 63 20         needSync 
7e90: 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  = 1;.        }. 
7ea0: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
7eb0: 74 65 33 4f 73 57 72 69 74 65 28 26 6d 61 73 74  te3OsWrite(&mast
7ec0: 65 72 2c 20 7a 46 69 6c 65 2c 20 73 74 72 6c 65  er, zFile, strle
7ed0: 6e 28 7a 46 69 6c 65 29 2b 31 29 3b 0a 20 20 20  n(zFile)+1);.   
7ee0: 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c       if( rc!=SQL
7ef0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
7f00: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f      sqlite3OsClo
7f10: 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20 20  se(&master);.   
7f20: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73         sqlite3Os
7f30: 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b  Delete(zMaster);
7f40: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  .          sqlit
7f50: 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a  eFree(zMaster);.
7f60: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e            return
7f70: 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20   rc;.        }. 
7f80: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 0a 20       }.    }... 
7f90: 20 20 20 2f 2a 20 53 79 6e 63 20 74 68 65 20 6d     /* Sync the m
7fa0: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
7fb0: 6c 65 2e 20 42 65 66 6f 72 65 20 64 6f 69 6e 67  le. Before doing
7fc0: 20 74 68 69 73 2c 20 6f 70 65 6e 20 74 68 65 20   this, open the 
7fd0: 64 69 72 65 63 74 6f 72 79 0a 20 20 20 20 2a 2a  directory.    **
7fe0: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72   the master jour
7ff0: 6e 61 6c 20 66 69 6c 65 20 69 73 20 73 74 6f 72  nal file is stor
8000: 65 20 69 6e 20 73 6f 20 74 68 61 74 20 69 74 20  e in so that it 
8010: 67 65 74 73 20 73 79 6e 63 65 64 20 74 6f 6f 2e  gets synced too.
8020: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 7a 4d 61 69  .    */.    zMai
8030: 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 42  nFile = sqlite3B
8040: 74 72 65 65 47 65 74 44 69 72 6e 61 6d 65 28 64  treeGetDirname(d
8050: 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a  b->aDb[0].pBt);.
8060: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
8070: 4f 73 4f 70 65 6e 44 69 72 65 63 74 6f 72 79 28  OsOpenDirectory(
8080: 7a 4d 61 69 6e 46 69 6c 65 2c 20 26 6d 61 73 74  zMainFile, &mast
8090: 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21  er);.    if( rc!
80a0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 6e  =SQLITE_OK || (n
80b0: 65 65 64 53 79 6e 63 20 26 26 20 28 72 63 3d 73  eedSync && (rc=s
80c0: 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 26 6d 61  qlite3OsSync(&ma
80d0: 73 74 65 72 29 29 21 3d 53 51 4c 49 54 45 5f 4f  ster))!=SQLITE_O
80e0: 4b 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  K) ){.      sqli
80f0: 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74  te3OsClose(&mast
8100: 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  er);.      sqlit
8110: 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74  e3OsDelete(zMast
8120: 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  er);.      sqlit
8130: 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a  eFree(zMaster);.
8140: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
8150: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 53  .    }..    /* S
8160: 79 6e 63 20 61 6c 6c 20 74 68 65 20 64 62 20 66  ync all the db f
8170: 69 6c 65 73 20 69 6e 76 6f 6c 76 65 64 20 69 6e  iles involved in
8180: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
8190: 2e 20 54 68 65 20 73 61 6d 65 20 63 61 6c 6c 0a  . The same call.
81a0: 20 20 20 20 2a 2a 20 73 65 74 73 20 74 68 65 20      ** sets the 
81b0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 70  master journal p
81c0: 6f 69 6e 74 65 72 20 69 6e 20 65 61 63 68 20 69  ointer in each i
81d0: 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61  ndividual journa
81e0: 6c 2e 20 49 66 0a 20 20 20 20 2a 2a 20 61 6e 20  l. If.    ** an 
81f0: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 68 65 72  error occurs her
8200: 65 2c 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65  e, do not delete
8210: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72   the master jour
8220: 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a  nal file..    **
8230: 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20 65  .    ** If the e
8240: 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69  rror occurs duri
8250: 6e 67 20 74 68 65 20 66 69 72 73 74 20 63 61 6c  ng the first cal
8260: 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65  l to sqlite3Btre
8270: 65 53 79 6e 63 28 29 2c 0a 20 20 20 20 2a 2a 20  eSync(),.    ** 
8280: 74 68 65 6e 20 74 68 65 72 65 20 69 73 20 61 20  then there is a 
8290: 63 68 61 6e 63 65 20 74 68 61 74 20 74 68 65 20  chance that the 
82a0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
82b0: 69 6c 65 20 77 69 6c 6c 20 62 65 0a 20 20 20 20  ile will be.    
82c0: 2a 2a 20 6f 72 70 68 61 6e 65 64 2e 20 42 75 74  ** orphaned. But
82d0: 20 77 65 20 63 61 6e 6e 6f 74 20 64 65 6c 65 74   we cannot delet
82e0: 65 20 69 74 2c 20 69 6e 20 63 61 73 65 20 74 68  e it, in case th
82f0: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
8300: 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 6e 61 6d  .    ** file nam
8310: 65 20 77 61 73 20 77 72 69 74 74 65 6e 20 69 6e  e was written in
8320: 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66  to the journal f
8330: 69 6c 65 20 62 65 66 6f 72 65 20 74 68 65 20 66  ile before the f
8340: 61 69 6c 75 72 65 0a 20 20 20 20 2a 2a 20 6f 63  ailure.    ** oc
8350: 63 75 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  cured..    */.  
8360: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d    for(i=0; i<db-
8370: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20  >nDb; i++){ .   
8380: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
8390: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
83a0: 20 20 20 20 20 20 69 66 28 20 70 42 74 20 26 26        if( pBt &&
83b0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 49   sqlite3BtreeIsI
83c0: 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20  nTrans(pBt) ){. 
83d0: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
83e0: 74 65 33 42 74 72 65 65 53 79 6e 63 28 70 42 74  te3BtreeSync(pBt
83f0: 2c 20 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20  , zMaster);.    
8400: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
8410: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20  TE_OK ){.       
8420: 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73     sqlite3OsClos
8430: 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20  e(&master);.    
8440: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
8450: 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20  (zMaster);.     
8460: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
8470: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
8480: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  }.    }.    sqli
8490: 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74  te3OsClose(&mast
84a0: 65 72 29 3b 0a 0a 20 20 20 20 2f 2a 20 44 65 6c  er);..    /* Del
84b0: 65 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a  ete the master j
84c0: 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 69  ournal file. Thi
84d0: 73 20 63 6f 6d 6d 69 74 73 20 74 68 65 20 74 72  s commits the tr
84e0: 61 6e 73 61 63 74 69 6f 6e 2e 20 41 66 74 65 72  ansaction. After
84f0: 0a 20 20 20 20 2a 2a 20 64 6f 69 6e 67 20 74 68  .    ** doing th
8500: 69 73 20 74 68 65 20 64 69 72 65 63 74 6f 72 79  is the directory
8510: 20 69 73 20 73 79 6e 63 65 64 20 61 67 61 69 6e   is synced again
8520: 20 62 65 66 6f 72 65 20 61 6e 79 20 69 6e 64 69   before any indi
8530: 76 69 64 75 61 6c 0a 20 20 20 20 2a 2a 20 74 72  vidual.    ** tr
8540: 61 6e 73 61 63 74 69 6f 6e 20 66 69 6c 65 73 20  ansaction files 
8550: 61 72 65 20 64 65 6c 65 74 65 64 2e 0a 20 20 20  are deleted..   
8560: 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   */.    rc = sql
8570: 69 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61  ite3OsDelete(zMa
8580: 73 74 65 72 29 3b 0a 20 20 20 20 61 73 73 65 72  ster);.    asser
8590: 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  t( rc==SQLITE_OK
85a0: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72   );.    sqliteFr
85b0: 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20  ee(zMaster);.   
85c0: 20 7a 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20 20   zMaster = 0;.  
85d0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
85e0: 53 79 6e 63 44 69 72 65 63 74 6f 72 79 28 7a 4d  SyncDirectory(zM
85f0: 61 69 6e 46 69 6c 65 29 3b 0a 20 20 20 20 69 66  ainFile);.    if
8600: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
8610: 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73  ){.      /* This
8620: 20 69 73 20 6e 6f 74 20 67 6f 6f 64 2e 20 54 68   is not good. Th
8630: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
8640: 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20 64   file has been d
8650: 65 6c 65 74 65 64 2c 20 62 75 74 0a 20 20 20 20  eleted, but.    
8660: 20 20 2a 2a 20 74 68 65 20 64 69 72 65 63 74 6f    ** the directo
8670: 72 79 20 73 79 6e 63 20 66 61 69 6c 65 64 2e 20  ry sync failed. 
8680: 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f 6d 70  There is no comp
8690: 6c 65 74 65 6c 79 20 73 61 66 65 20 63 6f 75 72  letely safe cour
86a0: 73 65 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 61  se of.      ** a
86b0: 63 74 69 6f 6e 20 66 72 6f 6d 20 68 65 72 65 2e  ction from here.
86c0: 20 54 68 65 20 69 6e 64 69 76 69 64 75 61 6c 20   The individual 
86d0: 6a 6f 75 72 6e 61 6c 73 20 63 6f 6e 74 61 69 6e  journals contain
86e0: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65   the name of the
86f0: 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73 74 65 72  .      ** master
8700: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 62   journal file, b
8710: 75 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77  ut there is no w
8720: 61 79 20 6f 66 20 6b 6e 6f 77 69 6e 67 20 69 66  ay of knowing if
8730: 20 74 68 61 74 0a 20 20 20 20 20 20 2a 2a 20 6d   that.      ** m
8740: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78  aster journal ex
8750: 69 73 74 73 20 6e 6f 77 20 6f 72 20 69 66 20 69  ists now or if i
8760: 74 20 77 69 6c 6c 20 65 78 69 73 74 20 61 66 74  t will exist aft
8770: 65 72 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67  er the operating
8780: 0a 20 20 20 20 20 20 2a 2a 20 73 79 73 74 65 6d  .      ** system
8790: 20 63 72 61 73 68 20 74 68 61 74 20 6d 61 79 20   crash that may 
87a0: 66 6f 6c 6c 6f 77 20 74 68 65 20 66 73 79 6e 63  follow the fsync
87b0: 28 29 20 66 61 69 6c 75 72 65 2e 0a 20 20 20 20  () failure..    
87c0: 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72    */.      retur
87d0: 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20  n rc;.    }..   
87e0: 20 2f 2a 20 41 6c 6c 20 66 69 6c 65 73 20 61 6e   /* All files an
87f0: 64 20 64 69 72 65 63 74 6f 72 69 65 73 20 68 61  d directories ha
8800: 76 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20  ve already been 
8810: 73 79 6e 63 65 64 2c 20 73 6f 20 74 68 65 20 66  synced, so the f
8820: 6f 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 2a 2a 20  ollowing.    ** 
8830: 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74 65 33  calls to sqlite3
8840: 42 74 72 65 65 43 6f 6d 6d 69 74 28 29 20 61 72  BtreeCommit() ar
8850: 65 20 6f 6e 6c 79 20 63 6c 6f 73 69 6e 67 20 66  e only closing f
8860: 69 6c 65 73 20 61 6e 64 20 64 65 6c 65 74 69 6e  iles and deletin
8870: 67 0a 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c  g.    ** journal
8880: 73 2e 20 49 66 20 73 6f 6d 65 74 68 69 6e 67 20  s. If something 
8890: 67 6f 65 73 20 77 72 6f 6e 67 20 77 68 69 6c 65  goes wrong while
88a0: 20 74 68 69 73 20 69 73 20 68 61 70 70 65 6e 69   this is happeni
88b0: 6e 67 20 77 65 20 64 6f 6e 27 74 0a 20 20 20 20  ng we don't.    
88c0: 2a 2a 20 72 65 61 6c 6c 79 20 63 61 72 65 2e 20  ** really care. 
88d0: 54 68 65 20 69 6e 74 65 67 72 69 74 79 20 6f 66  The integrity of
88e0: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
88f0: 20 69 73 20 61 6c 72 65 61 64 79 20 67 75 61 72   is already guar
8900: 61 6e 74 65 65 64 2c 0a 20 20 20 20 2a 2a 20 62  anteed,.    ** b
8910: 75 74 20 73 6f 6d 65 20 73 74 72 61 79 20 27 63  ut some stray 'c
8920: 6f 6c 64 27 20 6a 6f 75 72 6e 61 6c 73 20 6d 61  old' journals ma
8930: 79 20 62 65 20 6c 79 69 6e 67 20 61 72 6f 75 6e  y be lying aroun
8940: 64 2e 20 52 65 74 75 72 6e 69 6e 67 20 61 6e 0a  d. Returning an.
8950: 20 20 20 20 2a 2a 20 65 72 72 6f 72 20 63 6f 64      ** error cod
8960: 65 20 77 6f 6e 27 74 20 68 65 6c 70 20 6d 61 74  e won't help mat
8970: 74 65 72 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  ters..    */.   
8980: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e   for(i=0; i<db->
8990: 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20  nDb; i++){ .    
89a0: 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64    Btree *pBt = d
89b0: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20  b->aDb[i].pBt;. 
89c0: 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a       if( pBt ){.
89d0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42          sqlite3B
89e0: 74 72 65 65 43 6f 6d 6d 69 74 28 70 42 74 29 3b  treeCommit(pBt);
89f0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
8a00: 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74   }.#endif..  ret
8a10: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
8a20: 20 46 69 6e 64 20 65 76 65 72 79 20 61 63 74 69   Find every acti
8a30: 76 65 20 56 4d 20 6f 74 68 65 72 20 74 68 61 6e  ve VM other than
8a40: 20 70 56 64 62 65 20 61 6e 64 20 63 68 61 6e 67   pVdbe and chang
8a50: 65 20 69 74 73 20 73 74 61 74 75 73 20 74 6f 0a  e its status to.
8a60: 2a 2a 20 61 62 6f 72 74 65 64 2e 20 20 54 68 69  ** aborted.  Thi
8a70: 73 20 68 61 70 70 65 6e 73 20 77 68 65 6e 20 6f  s happens when o
8a80: 6e 65 20 56 4d 20 63 61 75 73 65 73 20 61 20 72  ne VM causes a r
8a90: 6f 6c 6c 62 61 63 6b 20 64 75 65 20 74 6f 20 61  ollback due to a
8aa0: 6e 0a 2a 2a 20 4f 4e 20 43 4f 4e 46 4c 49 43 54  n.** ON CONFLICT
8ab0: 20 52 4f 4c 4c 42 41 43 4b 20 63 6c 61 75 73 65   ROLLBACK clause
8ac0: 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 29 2e 20   (for example). 
8ad0: 20 54 68 65 20 6f 74 68 65 72 20 56 4d 73 20 6d   The other VMs m
8ae0: 75 73 74 20 62 65 0a 2a 2a 20 61 62 6f 72 74 65  ust be.** aborte
8af0: 64 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 64  d so that they d
8b00: 6f 20 6e 6f 74 20 68 61 76 65 20 64 61 74 61 20  o not have data 
8b10: 72 6f 6c 6c 65 64 20 6f 75 74 20 66 72 6f 6d 20  rolled out from 
8b20: 75 6e 64 65 72 6e 65 61 74 68 0a 2a 2a 20 74 68  underneath.** th
8b30: 65 6d 20 6c 65 61 64 69 6e 67 20 74 6f 20 61 20  em leading to a 
8b40: 73 65 67 66 61 75 6c 74 2e 0a 2a 2f 0a 73 74 61  segfault..*/.sta
8b50: 74 69 63 20 76 6f 69 64 20 61 62 6f 72 74 4f 74  tic void abortOt
8b60: 68 65 72 41 63 74 69 76 65 56 64 62 65 73 28 56  herActiveVdbes(V
8b70: 64 62 65 20 2a 70 56 64 62 65 29 7b 0a 20 20 56  dbe *pVdbe){.  V
8b80: 64 62 65 20 2a 70 4f 74 68 65 72 3b 0a 20 20 66  dbe *pOther;.  f
8b90: 6f 72 28 70 4f 74 68 65 72 3d 70 56 64 62 65 2d  or(pOther=pVdbe-
8ba0: 3e 64 62 2d 3e 70 56 64 62 65 3b 20 70 4f 74 68  >db->pVdbe; pOth
8bb0: 65 72 3b 20 70 4f 74 68 65 72 3d 70 4f 74 68 65  er; pOther=pOthe
8bc0: 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69  r->pNext){.    i
8bd0: 66 28 20 70 4f 74 68 65 72 3d 3d 70 56 64 62 65  f( pOther==pVdbe
8be0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
8bf0: 20 69 66 28 20 70 4f 74 68 65 72 2d 3e 6d 61 67   if( pOther->mag
8c00: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52  ic!=VDBE_MAGIC_R
8c10: 55 4e 20 7c 7c 20 70 4f 74 68 65 72 2d 3e 70 63  UN || pOther->pc
8c20: 3c 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20  <0 ) continue;. 
8c30: 20 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f     closeAllCurso
8c40: 72 73 28 70 4f 74 68 65 72 29 3b 0a 20 20 20 20  rs(pOther);.    
8c50: 70 4f 74 68 65 72 2d 3e 61 62 6f 72 74 65 64 20  pOther->aborted 
8c60: 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 20 0a  = 1;.  }.}../* .
8c70: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
8c80: 63 68 65 63 6b 73 20 74 68 61 74 20 74 68 65 20  checks that the 
8c90: 73 71 6c 69 74 65 33 2e 61 63 74 69 76 65 56 64  sqlite3.activeVd
8ca0: 62 65 43 6e 74 20 63 6f 75 6e 74 20 76 61 72 69  beCnt count vari
8cb0: 61 62 6c 65 0a 2a 2a 20 6d 61 74 63 68 65 73 20  able.** matches 
8cc0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 64  the number of vd
8cd0: 62 65 27 73 20 69 6e 20 74 68 65 20 6c 69 73 74  be's in the list
8ce0: 20 73 71 6c 69 74 65 33 2e 70 56 64 62 65 20 74   sqlite3.pVdbe t
8cf0: 68 61 74 20 61 72 65 0a 2a 2a 20 63 75 72 72 65  hat are.** curre
8d00: 6e 74 6c 79 20 61 63 74 69 76 65 2e 20 41 6e 20  ntly active. An 
8d10: 61 73 73 65 72 74 69 6f 6e 20 66 61 69 6c 73 20  assertion fails 
8d20: 69 66 20 74 68 65 20 74 77 6f 20 63 6f 75 6e 74  if the two count
8d30: 73 20 64 6f 20 6e 6f 74 20 6d 61 74 63 68 2e 0a  s do not match..
8d40: 2a 2a 20 54 68 69 73 20 69 73 20 61 6e 20 69 6e  ** This is an in
8d50: 74 65 72 6e 61 6c 20 73 65 6c 66 2d 63 68 65 63  ternal self-chec
8d60: 6b 20 6f 6e 6c 79 20 2d 20 69 74 20 69 73 20 6e  k only - it is n
8d70: 6f 74 20 61 6e 20 65 73 73 65 6e 74 69 61 6c 20  ot an essential 
8d80: 70 72 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 73 74  processing.** st
8d90: 65 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69  ep..**.** This i
8da0: 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 4e 44 45  s a no-op if NDE
8db0: 42 55 47 20 69 73 20 64 65 66 69 6e 65 64 2e 0a  BUG is defined..
8dc0: 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55  */.#ifndef NDEBU
8dd0: 47 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 68  G.static void ch
8de0: 65 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74  eckActiveVdbeCnt
8df0: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
8e00: 20 56 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74 20   Vdbe *p;.  int 
8e10: 63 6e 74 20 3d 20 30 3b 0a 20 20 70 20 3d 20 64  cnt = 0;.  p = d
8e20: 62 2d 3e 70 56 64 62 65 3b 0a 20 20 77 68 69 6c  b->pVdbe;.  whil
8e30: 65 28 20 70 20 29 7b 0a 20 20 20 20 69 66 28 20  e( p ){.    if( 
8e40: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
8e50: 41 47 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 70  AGIC_RUN && p->p
8e60: 63 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6e  c>=0 ){.      cn
8e70: 74 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  t++;.    }.    p
8e80: 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d   = p->pNext;.  }
8e90: 0a 20 20 61 73 73 65 72 74 28 20 63 6e 74 3d 3d  .  assert( cnt==
8ea0: 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e  db->activeVdbeCn
8eb0: 74 20 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 65  t );.}.#else.#de
8ec0: 66 69 6e 65 20 63 68 65 63 6b 41 63 74 69 76 65  fine checkActive
8ed0: 56 64 62 65 43 6e 74 28 78 29 0a 23 65 6e 64 69  VdbeCnt(x).#endi
8ee0: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  f../*.** This ro
8ef0: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20  utine is called 
8f00: 74 68 65 20 77 68 65 6e 20 61 20 56 44 42 45 20  the when a VDBE 
8f10: 74 72 69 65 73 20 74 6f 20 68 61 6c 74 2e 20 20  tries to halt.  
8f20: 49 66 20 74 68 65 20 56 44 42 45 0a 2a 2a 20 68  If the VDBE.** h
8f30: 61 73 20 6d 61 64 65 20 63 68 61 6e 67 65 73 20  as made changes 
8f40: 61 6e 64 20 69 73 20 69 6e 20 61 75 74 6f 63 6f  and is in autoco
8f50: 6d 6d 69 74 20 6d 6f 64 65 2c 20 74 68 65 6e 20  mmit mode, then 
8f60: 63 6f 6d 6d 69 74 20 74 68 6f 73 65 0a 2a 2a 20  commit those.** 
8f70: 63 68 61 6e 67 65 73 2e 20 20 49 66 20 61 20 72  changes.  If a r
8f80: 6f 6c 6c 62 61 63 6b 20 69 73 20 6e 65 65 64 65  ollback is neede
8f90: 64 2c 20 74 68 65 6e 20 64 6f 20 74 68 65 20 72  d, then do the r
8fa0: 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 54  ollback..**.** T
8fb0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 74  his routine is t
8fc0: 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 6d  he only way to m
8fd0: 6f 76 65 20 74 68 65 20 73 74 61 74 65 20 6f 66  ove the state of
8fe0: 20 61 20 56 4d 20 66 72 6f 6d 0a 2a 2a 20 53 51   a VM from.** SQ
8ff0: 4c 49 54 45 5f 4d 41 47 49 43 5f 52 55 4e 20 74  LITE_MAGIC_RUN t
9000: 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 48  o SQLITE_MAGIC_H
9010: 41 4c 54 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72  ALT..**.** Retur
9020: 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e  n an error code.
9030: 20 20 49 66 20 74 68 65 20 63 6f 6d 6d 69 74 20    If the commit 
9040: 63 6f 75 6c 64 20 6e 6f 74 20 63 6f 6d 70 6c 65  could not comple
9050: 74 65 20 62 65 63 61 75 73 65 20 6f 66 0a 2a 2a  te because of.**
9060: 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e   lock contention
9070: 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  , return SQLITE_
9080: 42 55 53 59 2e 20 20 49 66 20 53 51 4c 49 54 45  BUSY.  If SQLITE
9090: 5f 42 55 53 59 20 69 73 20 72 65 74 75 72 6e 65  _BUSY is returne
90a0: 64 2c 20 69 74 0a 2a 2a 20 6d 65 61 6e 73 20 74  d, it.** means t
90b0: 68 65 20 63 6c 6f 73 65 20 64 69 64 20 6e 6f 74  he close did not
90c0: 20 68 61 70 70 65 6e 20 61 6e 64 20 6e 65 65 64   happen and need
90d0: 73 20 74 6f 20 62 65 20 72 65 70 65 61 74 65 64  s to be repeated
90e0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
90f0: 56 64 62 65 48 61 6c 74 28 56 64 62 65 20 2a 70  VdbeHalt(Vdbe *p
9100: 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  ){.  sqlite3 *db
9110: 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69 6e 74 20   = p->db;.  int 
9120: 69 3b 0a 20 20 69 6e 74 20 28 2a 78 46 75 6e 63  i;.  int (*xFunc
9130: 29 28 42 74 72 65 65 20 2a 70 42 74 29 20 3d 20  )(Btree *pBt) = 
9140: 30 3b 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20  0;  /* Function 
9150: 74 6f 20 63 61 6c 6c 20 6f 6e 20 65 61 63 68 20  to call on each 
9160: 62 74 72 65 65 20 62 61 63 6b 65 6e 64 20 2a 2f  btree backend */
9170: 0a 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63  ..  if( p->magic
9180: 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e  !=VDBE_MAGIC_RUN
9190: 20 29 7b 0a 20 20 20 20 2f 2a 20 41 6c 72 65 61   ){.    /* Alrea
91a0: 64 79 20 68 61 6c 74 65 64 2e 20 20 4e 6f 74 68  dy halted.  Noth
91b0: 69 6e 67 20 74 6f 20 64 6f 2e 20 2a 2f 0a 20 20  ing to do. */.  
91c0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67    assert( p->mag
91d0: 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48  ic==VDBE_MAGIC_H
91e0: 41 4c 54 20 29 3b 0a 20 20 20 20 72 65 74 75 72  ALT );.    retur
91f0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  n SQLITE_OK;.  }
9200: 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f  .  closeAllCurso
9210: 72 73 28 70 29 3b 0a 20 20 63 68 65 63 6b 41 63  rs(p);.  checkAc
9220: 74 69 76 65 56 64 62 65 43 6e 74 28 64 62 29 3b  tiveVdbeCnt(db);
9230: 0a 20 20 69 66 28 20 70 2d 3e 70 63 3c 30 20 29  .  if( p->pc<0 )
9240: 7b 0a 20 20 20 20 2f 2a 20 4e 6f 20 63 6f 6d 6d  {.    /* No comm
9250: 69 74 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 6e  it or rollback n
9260: 65 65 64 65 64 20 69 66 20 74 68 65 20 70 72 6f  eeded if the pro
9270: 67 72 61 6d 20 6e 65 76 65 72 20 73 74 61 72 74  gram never start
9280: 65 64 20 2a 2f 0a 20 20 7d 65 6c 73 65 20 69 66  ed */.  }else if
9290: 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74  ( db->autoCommit
92a0: 20 26 26 20 64 62 2d 3e 61 63 74 69 76 65 56 64   && db->activeVd
92b0: 62 65 43 6e 74 3d 3d 31 20 29 7b 0a 20 20 20 20  beCnt==1 ){.    
92c0: 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54  if( p->rc==SQLIT
92d0: 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72 6f 72  E_OK || p->error
92e0: 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20  Action==OE_Fail 
92f0: 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20  ){.      /* The 
9300: 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61 67  auto-commit flag
9310: 20 69 73 20 74 72 75 65 2c 20 74 68 65 72 65 20   is true, there 
9320: 61 72 65 20 6e 6f 20 6f 74 68 65 72 20 61 63 74  are no other act
9330: 69 76 65 20 71 75 65 72 69 65 73 0a 20 20 20 20  ive queries.    
9340: 20 20 2a 2a 20 75 73 69 6e 67 20 74 68 69 73 20    ** using this 
9350: 68 61 6e 64 6c 65 20 61 6e 64 20 74 68 65 20 76  handle and the v
9360: 64 62 65 20 70 72 6f 67 72 61 6d 20 77 61 73 20  dbe program was 
9370: 73 75 63 63 65 73 73 66 75 6c 20 6f 72 20 68 69  successful or hi
9380: 74 20 61 6e 0a 20 20 20 20 20 20 2a 2a 20 27 4f  t an.      ** 'O
9390: 52 20 46 41 49 4c 27 20 63 6f 6e 73 74 72 61 69  R FAIL' constrai
93a0: 6e 74 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 61  nt. This means a
93b0: 20 63 6f 6d 6d 69 74 20 69 73 20 72 65 71 75 69   commit is requi
93c0: 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  red..      */.  
93d0: 20 20 20 20 69 6e 74 20 72 63 20 3d 20 76 64 62      int rc = vdb
93e0: 65 43 6f 6d 6d 69 74 28 64 62 29 3b 0a 20 20 20  eCommit(db);.   
93f0: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
9400: 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20  E_BUSY ){.      
9410: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
9420: 42 55 53 59 3b 0a 20 20 20 20 20 20 7d 65 6c 73  BUSY;.      }els
9430: 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45  e if( rc!=SQLITE
9440: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70  _OK ){.        p
9450: 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20 20  ->rc = rc;.     
9460: 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c 69 74     xFunc = sqlit
9470: 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 3b  e3BtreeRollback;
9480: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c  .      }.    }el
9490: 73 65 7b 0a 20 20 20 20 20 20 78 46 75 6e 63 20  se{.      xFunc 
94a0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f  = sqlite3BtreeRo
94b0: 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 7d 0a 20 20  llback;.    }.  
94c0: 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 70  }else{.    if( p
94d0: 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ->rc==SQLITE_OK 
94e0: 7c 7c 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f  || p->errorActio
94f0: 6e 3d 3d 4f 45 5f 46 61 69 6c 20 29 7b 0a 20 20  n==OE_Fail ){.  
9500: 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c 69      xFunc = sqli
9510: 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 53 74  te3BtreeCommitSt
9520: 6d 74 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66  mt;.    }else if
9530: 28 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f 6e  ( p->errorAction
9540: 3d 3d 4f 45 5f 41 62 6f 72 74 20 29 7b 0a 20 20  ==OE_Abort ){.  
9550: 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c 69      xFunc = sqli
9560: 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  te3BtreeRollback
9570: 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  Stmt;.    }else{
9580: 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73  .      xFunc = s
9590: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62  qlite3BtreeRollb
95a0: 61 63 6b 3b 0a 20 20 20 20 20 20 64 62 2d 3e 61  ack;.      db->a
95b0: 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20  utoCommit = 1;. 
95c0: 20 20 20 20 20 61 62 6f 72 74 4f 74 68 65 72 41       abortOtherA
95d0: 63 74 69 76 65 56 64 62 65 73 28 70 29 3b 0a 20  ctiveVdbes(p);. 
95e0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49     }.  }..  /* I
95f0: 66 20 78 46 75 6e 63 20 69 73 20 6e 6f 74 20 4e  f xFunc is not N
9600: 55 4c 4c 2c 20 74 68 65 6e 20 69 74 20 69 73 20  ULL, then it is 
9610: 6f 6e 65 20 6f 66 20 73 71 6c 69 74 65 33 42 74  one of sqlite3Bt
9620: 72 65 65 52 6f 6c 6c 62 61 63 6b 2c 0a 20 20 2a  reeRollback,.  *
9630: 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f  * sqlite3BtreeRo
9640: 6c 6c 62 61 63 6b 53 74 6d 74 20 6f 72 20 73 71  llbackStmt or sq
9650: 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74  lite3BtreeCommit
9660: 53 74 6d 74 2e 20 43 61 6c 6c 20 69 74 20 6f 6e  Stmt. Call it on
9670: 63 65 20 6f 6e 0a 20 20 2a 2a 20 65 61 63 68 20  ce on.  ** each 
9680: 62 61 63 6b 65 6e 64 2e 20 49 66 20 61 6e 20 65  backend. If an e
9690: 72 72 6f 72 20 6f 63 63 75 72 73 20 61 6e 64 20  rror occurs and 
96a0: 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20  the return code 
96b0: 69 73 20 73 74 69 6c 6c 0a 20 20 2a 2a 20 53 51  is still.  ** SQ
96c0: 4c 49 54 45 5f 4f 4b 2c 20 73 65 74 20 74 68 65  LITE_OK, set the
96d0: 20 72 65 74 75 72 6e 20 63 6f 64 65 20 74 6f 20   return code to 
96e0: 74 68 65 20 6e 65 77 20 65 72 72 6f 72 20 76 61  the new error va
96f0: 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72 28  lue..  */.  for(
9700: 69 3d 30 3b 20 78 46 75 6e 63 20 26 26 20 69 3c  i=0; xFunc && i<
9710: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a  db->nDb; i++){ .
9720: 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20      int rc;.    
9730: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d  Btree *pBt = db-
9740: 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20  >aDb[i].pBt;.   
9750: 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20   if( pBt ){.    
9760: 20 20 72 63 20 3d 20 78 46 75 6e 63 28 70 42 74    rc = xFunc(pBt
9770: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e  );.      if( p->
9780: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc==SQLITE_OK ) 
9790: 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20  p->rc = rc;.    
97a0: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74  }.  }..  /* If t
97b0: 68 69 73 20 77 61 73 20 61 6e 20 49 4e 53 45 52  his was an INSER
97c0: 54 2c 20 55 50 44 41 54 45 20 6f 72 20 44 45 4c  T, UPDATE or DEL
97d0: 45 54 45 2c 20 73 65 74 20 74 68 65 20 63 68 61  ETE, set the cha
97e0: 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20 2a 2f 0a  nge counter. */.
97f0: 20 20 69 66 28 20 70 2d 3e 63 68 61 6e 67 65 43    if( p->changeC
9800: 6e 74 4f 6e 20 26 26 20 70 2d 3e 70 63 3e 3d 30  ntOn && p->pc>=0
9810: 20 29 7b 0a 20 20 20 20 69 66 28 20 21 78 46 75   ){.    if( !xFu
9820: 6e 63 20 7c 7c 20 78 46 75 6e 63 3d 3d 73 71 6c  nc || xFunc==sql
9830: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 53  ite3BtreeCommitS
9840: 74 6d 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  tmt ){.      sql
9850: 69 74 65 33 56 64 62 65 53 65 74 43 68 61 6e 67  ite3VdbeSetChang
9860: 65 73 28 64 62 2c 20 70 2d 3e 6e 43 68 61 6e 67  es(db, p->nChang
9870: 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  e);.    }else{. 
9880: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
9890: 53 65 74 43 68 61 6e 67 65 73 28 64 62 2c 20 30  SetChanges(db, 0
98a0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e  );.    }.    p->
98b0: 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 20 20 7d  nChange = 0;.  }
98c0: 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b 20  ..  /* Rollback 
98d0: 6f 72 20 63 6f 6d 6d 69 74 20 61 6e 79 20 73 63  or commit any sc
98e0: 68 65 6d 61 20 63 68 61 6e 67 65 73 20 74 68 61  hema changes tha
98f0: 74 20 6f 63 63 75 72 72 65 64 2e 20 2a 2f 0a 20  t occurred. */. 
9900: 20 69 66 28 20 70 2d 3e 72 63 21 3d 53 51 4c 49   if( p->rc!=SQLI
9910: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
9920: 69 74 65 33 52 6f 6c 6c 62 61 63 6b 49 6e 74 65  ite3RollbackInte
9930: 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29 3b  rnalChanges(db);
9940: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d  .  }else if( db-
9950: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
9960: 49 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 29 7b  InternChanges ){
9970: 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6d 6d  .    sqlite3Comm
9980: 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65  itInternalChange
9990: 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  s(db);.  }..  /*
99a0: 20 57 65 20 68 61 76 65 20 73 75 63 63 65 73 73   We have success
99b0: 66 75 6c 6c 79 20 68 61 6c 74 65 64 20 61 6e 64  fully halted and
99c0: 20 63 6c 6f 73 65 64 20 74 68 65 20 56 4d 2e 20   closed the VM. 
99d0: 20 52 65 63 6f 72 64 20 74 68 69 73 20 66 61 63   Record this fac
99e0: 74 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70  t. */.  if( p->p
99f0: 63 3e 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e  c>=0 ){.    db->
9a00: 61 63 74 69 76 65 56 64 62 65 43 6e 74 2d 2d 3b  activeVdbeCnt--;
9a10: 0a 20 20 7d 0a 20 20 70 2d 3e 6d 61 67 69 63 20  .  }.  p->magic 
9a20: 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  = VDBE_MAGIC_HAL
9a30: 54 3b 0a 20 20 63 68 65 63 6b 41 63 74 69 76 65  T;.  checkActive
9a40: 56 64 62 65 43 6e 74 28 64 62 29 3b 0a 0a 20 20  VdbeCnt(db);..  
9a50: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
9a60: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e  ;.}../*.** Clean
9a70: 20 75 70 20 61 20 56 44 42 45 20 61 66 74 65 72   up a VDBE after
9a80: 20 65 78 65 63 75 74 69 6f 6e 20 62 75 74 20 64   execution but d
9a90: 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74 68 65  o not delete the
9aa0: 20 56 44 42 45 20 6a 75 73 74 20 79 65 74 2e 0a   VDBE just yet..
9ab0: 2a 2a 20 57 72 69 74 65 20 61 6e 79 20 65 72 72  ** Write any err
9ac0: 6f 72 20 6d 65 73 73 61 67 65 73 20 69 6e 74 6f  or messages into
9ad0: 20 2a 70 7a 45 72 72 4d 73 67 2e 20 20 52 65 74   *pzErrMsg.  Ret
9ae0: 75 72 6e 20 74 68 65 20 72 65 73 75 6c 74 20 63  urn the result c
9af0: 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72  ode..**.** After
9b00: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   this routine is
9b10: 20 72 75 6e 2c 20 74 68 65 20 56 44 42 45 20 73   run, the VDBE s
9b20: 68 6f 75 6c 64 20 62 65 20 72 65 61 64 79 20 74  hould be ready t
9b30: 6f 20 62 65 20 65 78 65 63 75 74 65 64 0a 2a 2a  o be executed.**
9b40: 20 61 67 61 69 6e 2e 0a 2a 2a 0a 2a 2a 20 54 6f   again..**.** To
9b50: 20 6c 6f 6f 6b 20 61 74 20 69 74 20 61 6e 6f 74   look at it anot
9b60: 68 65 72 20 77 61 79 2c 20 74 68 69 73 20 72 6f  her way, this ro
9b70: 75 74 69 6e 65 20 72 65 73 65 74 73 20 74 68 65  utine resets the
9b80: 20 73 74 61 74 65 20 6f 66 20 74 68 65 0a 2a 2a   state of the.**
9b90: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
9ba0: 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41 47 49 43   from VDBE_MAGIC
9bb0: 5f 52 55 4e 20 6f 72 20 56 44 42 45 5f 4d 41 47  _RUN or VDBE_MAG
9bc0: 49 43 5f 48 41 4c 54 20 62 61 63 6b 20 74 6f 0a  IC_HALT back to.
9bd0: 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  ** VDBE_MAGIC_IN
9be0: 49 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  IT..*/.int sqlit
9bf0: 65 33 56 64 62 65 52 65 73 65 74 28 56 64 62 65  e3VdbeReset(Vdbe
9c00: 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e 6d   *p){.  if( p->m
9c10: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43  agic!=VDBE_MAGIC
9c20: 5f 52 55 4e 20 26 26 20 70 2d 3e 6d 61 67 69 63  _RUN && p->magic
9c30: 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  !=VDBE_MAGIC_HAL
9c40: 54 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  T ){.    sqlite3
9c50: 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c  Error(p->db, SQL
9c60: 49 54 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b 0a  ITE_MISUSE, 0);.
9c70: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
9c80: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20  E_MISUSE;.  }.. 
9c90: 20 2f 2a 20 49 66 20 74 68 65 20 56 4d 20 64 69   /* If the VM di
9ca0: 64 20 6e 6f 74 20 72 75 6e 20 74 6f 20 63 6f 6d  d not run to com
9cb0: 70 6c 65 74 69 6f 6e 20 6f 72 20 69 66 20 69 74  pletion or if it
9cc0: 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 6e 0a   encountered an.
9cd0: 20 20 2a 2a 20 65 72 72 6f 72 2c 20 74 68 65 6e    ** error, then
9ce0: 20 69 74 20 6d 69 67 68 74 20 6e 6f 74 20 68 61   it might not ha
9cf0: 76 65 20 62 65 65 6e 20 68 61 6c 74 65 64 20 70  ve been halted p
9d00: 72 6f 70 65 72 6c 79 2e 20 20 53 6f 20 68 61 6c  roperly.  So hal
9d10: 74 0a 20 20 2a 2a 20 69 74 20 6e 6f 77 2e 0a 20  t.  ** it now.. 
9d20: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 56 64 62   */.  sqlite3Vdb
9d30: 65 48 61 6c 74 28 70 29 3b 0a 0a 20 20 2f 2a 20  eHalt(p);..  /* 
9d40: 49 66 20 74 68 65 20 56 44 42 45 20 68 61 73 20  If the VDBE has 
9d50: 62 65 20 72 75 6e 20 65 76 65 6e 20 70 61 72 74  be run even part
9d60: 69 61 6c 6c 79 2c 20 74 68 65 6e 20 74 72 61 6e  ially, then tran
9d70: 73 66 65 72 20 74 68 65 20 65 72 72 6f 72 20 63  sfer the error c
9d80: 6f 64 65 0a 20 20 2a 2a 20 61 6e 64 20 65 72 72  ode.  ** and err
9d90: 6f 72 20 6d 65 73 73 61 67 65 20 66 72 6f 6d 20  or message from 
9da0: 74 68 65 20 56 44 42 45 20 69 6e 74 6f 20 74 68  the VDBE into th
9db0: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20  e main database 
9dc0: 73 74 72 75 63 74 75 72 65 2e 20 20 42 75 74 0a  structure.  But.
9dd0: 20 20 2a 2a 20 69 66 20 74 68 65 20 56 44 42 45    ** if the VDBE
9de0: 20 68 61 73 20 6a 75 73 74 20 62 65 65 6e 20 73   has just been s
9df0: 65 74 20 74 6f 20 72 75 6e 20 62 75 74 20 68 61  et to run but ha
9e00: 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 65  s not actually e
9e10: 78 65 63 75 74 65 64 20 61 6e 79 0a 20 20 2a 2a  xecuted any.  **
9e20: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 79 65   instructions ye
9e30: 74 2c 20 6c 65 61 76 65 20 74 68 65 20 6d 61 69  t, leave the mai
9e40: 6e 20 64 61 74 61 62 61 73 65 20 65 72 72 6f 72  n database error
9e50: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 6e 63   information unc
9e60: 68 61 6e 67 65 64 2e 0a 20 20 2a 2f 0a 20 20 69  hanged..  */.  i
9e70: 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20  f( p->pc>=0 ){. 
9e80: 20 20 20 69 66 28 20 70 2d 3e 7a 45 72 72 4d 73     if( p->zErrMs
9e90: 67 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  g ){.      sqlit
9ea0: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70  e3Error(p->db, p
9eb0: 2d 3e 72 63 2c 20 22 25 73 22 2c 20 70 2d 3e 7a  ->rc, "%s", p->z
9ec0: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 73  ErrMsg);.      s
9ed0: 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 7a 45 72  qliteFree(p->zEr
9ee0: 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 70 2d 3e  rMsg);.      p->
9ef0: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20  zErrMsg = 0;.   
9f00: 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 72 63   }else if( p->rc
9f10: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
9f20: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d  3Error(p->db, p-
9f30: 3e 72 63 2c 20 30 29 3b 0a 20 20 20 20 7d 65 6c  >rc, 0);.    }el
9f40: 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  se{.      sqlite
9f50: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51  3Error(p->db, SQ
9f60: 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20  LITE_OK, 0);.   
9f70: 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70   }.  }else if( p
9f80: 2d 3e 72 63 20 26 26 20 70 2d 3e 65 78 70 69 72  ->rc && p->expir
9f90: 65 64 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65  ed ){.    /* The
9fa0: 20 65 78 70 69 72 65 64 20 66 6c 61 67 20 77 61   expired flag wa
9fb0: 73 20 73 65 74 20 6f 6e 20 74 68 65 20 56 44 42  s set on the VDB
9fc0: 45 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72  E before the fir
9fd0: 73 74 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74  st call.    ** t
9fe0: 6f 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  o sqlite3_step()
9ff0: 2e 20 46 6f 72 20 63 6f 6e 73 69 73 74 65 6e 63  . For consistenc
a000: 79 20 28 73 69 6e 63 65 20 73 71 6c 69 74 65 33  y (since sqlite3
a010: 5f 73 74 65 70 28 29 20 77 61 73 0a 20 20 20 20  _step() was.    
a020: 2a 2a 20 63 61 6c 6c 65 64 29 2c 20 73 65 74 20  ** called), set 
a030: 74 68 65 20 64 61 74 61 62 61 73 65 20 65 72 72  the database err
a040: 6f 72 20 69 6e 20 74 68 69 73 20 63 61 73 65 20  or in this case 
a050: 61 73 20 77 65 6c 6c 2e 0a 20 20 20 20 2a 2f 0a  as well..    */.
a060: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
a070: 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 2c 20 30  (p->db, p->rc, 0
a080: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 63  );.  }..  /* Rec
a090: 6c 61 69 6d 20 61 6c 6c 20 6d 65 6d 6f 72 79 20  laim all memory 
a0a0: 75 73 65 64 20 62 79 20 74 68 65 20 56 44 42 45  used by the VDBE
a0b0: 0a 20 20 2a 2f 0a 20 20 43 6c 65 61 6e 75 70 28  .  */.  Cleanup(
a0c0: 70 29 3b 0a 0a 20 20 2f 2a 20 53 61 76 65 20 70  p);..  /* Save p
a0d0: 72 6f 66 69 6c 69 6e 67 20 69 6e 66 6f 72 6d 61  rofiling informa
a0e0: 74 69 6f 6e 20 66 72 6f 6d 20 74 68 69 73 20 56  tion from this V
a0f0: 44 42 45 20 72 75 6e 2e 0a 20 20 2a 2f 0a 20 20  DBE run..  */.  
a100: 61 73 73 65 72 74 28 20 70 2d 3e 70 54 6f 73 3c  assert( p->pTos<
a110: 26 70 2d 3e 61 53 74 61 63 6b 5b 70 2d 3e 70 63  &p->aStack[p->pc
a120: 3c 30 3f 30 3a 70 2d 3e 70 63 5d 20 7c 7c 20 73  <0?0:p->pc] || s
a130: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61  qlite3_malloc_fa
a140: 69 6c 65 64 3d 3d 31 20 29 3b 0a 23 69 66 64 65  iled==1 );.#ifde
a150: 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45 0a 20  f VDBE_PROFILE. 
a160: 20 7b 0a 20 20 20 20 46 49 4c 45 20 2a 6f 75 74   {.    FILE *out
a170: 20 3d 20 66 6f 70 65 6e 28 22 76 64 62 65 5f 70   = fopen("vdbe_p
a180: 72 6f 66 69 6c 65 2e 6f 75 74 22 2c 20 22 61 22  rofile.out", "a"
a190: 29 3b 0a 20 20 20 20 69 66 28 20 6f 75 74 20 29  );.    if( out )
a1a0: 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20  {.      int i;. 
a1b0: 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74       fprintf(out
a1c0: 2c 20 22 2d 2d 2d 2d 20 22 29 3b 0a 20 20 20 20  , "---- ");.    
a1d0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e    for(i=0; i<p->
a1e0: 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  nOp; i++){.     
a1f0: 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c 20     fprintf(out, 
a200: 22 25 30 32 78 22 2c 20 70 2d 3e 61 4f 70 5b 69  "%02x", p->aOp[i
a210: 5d 2e 6f 70 63 6f 64 65 29 3b 0a 20 20 20 20 20  ].opcode);.     
a220: 20 7d 0a 20 20 20 20 20 20 66 70 72 69 6e 74 66   }.      fprintf
a230: 28 6f 75 74 2c 20 22 5c 6e 22 29 3b 0a 20 20 20  (out, "\n");.   
a240: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d     for(i=0; i<p-
a250: 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  >nOp; i++){.    
a260: 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c      fprintf(out,
a270: 20 22 25 36 64 20 25 31 30 6c 6c 64 20 25 38 6c   "%6d %10lld %8l
a280: 6c 64 20 22 2c 0a 20 20 20 20 20 20 20 20 20 20  ld ",.          
a290: 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 2c 0a   p->aOp[i].cnt,.
a2a0: 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f             p->aO
a2b0: 70 5b 69 5d 2e 63 79 63 6c 65 73 2c 0a 20 20 20  p[i].cycles,.   
a2c0: 20 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69          p->aOp[i
a2d0: 5d 2e 63 6e 74 3e 30 20 3f 20 70 2d 3e 61 4f 70  ].cnt>0 ? p->aOp
a2e0: 5b 69 5d 2e 63 79 63 6c 65 73 2f 70 2d 3e 61 4f  [i].cycles/p->aO
a2f0: 70 5b 69 5d 2e 63 6e 74 20 3a 20 30 0a 20 20 20  p[i].cnt : 0.   
a300: 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20       );.        
a310: 73 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74  sqlite3VdbePrint
a320: 4f 70 28 6f 75 74 2c 20 69 2c 20 26 70 2d 3e 61  Op(out, i, &p->a
a330: 4f 70 5b 69 5d 29 3b 0a 20 20 20 20 20 20 7d 0a  Op[i]);.      }.
a340: 20 20 20 20 20 20 66 63 6c 6f 73 65 28 6f 75 74        fclose(out
a350: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e  );.    }.  }.#en
a360: 64 69 66 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d  dif.  p->magic =
a370: 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54   VDBE_MAGIC_INIT
a380: 3b 0a 20 20 70 2d 3e 61 62 6f 72 74 65 64 20 3d  ;.  p->aborted =
a390: 20 30 3b 0a 20 20 69 66 28 20 70 2d 3e 72 63 3d   0;.  if( p->rc=
a3a0: 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 29  =SQLITE_SCHEMA )
a3b0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 73  {.    sqlite3Res
a3c0: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61  etInternalSchema
a3d0: 28 70 2d 3e 64 62 2c 20 30 29 3b 0a 20 20 7d 0a  (p->db, 0);.  }.
a3e0: 20 20 72 65 74 75 72 6e 20 70 2d 3e 72 63 3b 0a    return p->rc;.
a3f0: 7d 0a 20 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e 20  }. ./*.** Clean 
a400: 75 70 20 61 6e 64 20 64 65 6c 65 74 65 20 61 20  up and delete a 
a410: 56 44 42 45 20 61 66 74 65 72 20 65 78 65 63 75  VDBE after execu
a420: 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20 61 6e  tion.  Return an
a430: 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69   integer which i
a440: 73 0a 2a 2a 20 74 68 65 20 72 65 73 75 6c 74 20  s.** the result 
a450: 63 6f 64 65 2e 20 20 57 72 69 74 65 20 61 6e 79  code.  Write any
a460: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74   error message t
a470: 65 78 74 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d  ext into *pzErrM
a480: 73 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  sg..*/.int sqlit
a490: 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28 56  e3VdbeFinalize(V
a4a0: 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72  dbe *p){.  int r
a4b0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a  c = SQLITE_OK;..
a4c0: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 3d 3d    if( p->magic==
a4d0: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 7c  VDBE_MAGIC_RUN |
a4e0: 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  | p->magic==VDBE
a4f0: 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 7b 0a 20  _MAGIC_HALT ){. 
a500: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
a510: 64 62 65 52 65 73 65 74 28 70 29 3b 0a 20 20 7d  dbeReset(p);.  }
a520: 65 6c 73 65 20 69 66 28 20 70 2d 3e 6d 61 67 69  else if( p->magi
a530: 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  c!=VDBE_MAGIC_IN
a540: 49 54 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  IT ){.    return
a550: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
a560: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 64 62    }.  sqlite3Vdb
a570: 65 44 65 6c 65 74 65 28 70 29 3b 0a 20 20 72 65  eDelete(p);.  re
a580: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
a590: 2a 20 43 61 6c 6c 20 74 68 65 20 64 65 73 74 72  * Call the destr
a5a0: 75 63 74 6f 72 20 66 6f 72 20 65 61 63 68 20 61  uctor for each a
a5b0: 75 78 64 61 74 61 20 65 6e 74 72 79 20 69 6e 20  uxdata entry in 
a5c0: 70 56 64 62 65 46 75 6e 63 20 66 6f 72 20 77 68  pVdbeFunc for wh
a5d0: 69 63 68 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65  ich.** the corre
a5e0: 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 69 6e 20  sponding bit in 
a5f0: 6d 61 73 6b 20 69 73 20 63 6c 65 61 72 2e 20 20  mask is clear.  
a600: 41 75 78 64 61 74 61 20 65 6e 74 72 69 65 73 20  Auxdata entries 
a610: 62 65 79 6f 6e 64 20 33 31 0a 2a 2a 20 61 72 65  beyond 31.** are
a620: 20 61 6c 77 61 79 73 20 64 65 73 74 72 6f 79 65   always destroye
a630: 64 2e 20 20 54 6f 20 64 65 73 74 72 6f 79 20 61  d.  To destroy a
a640: 6c 6c 20 61 75 78 64 61 74 61 20 65 6e 74 72 69  ll auxdata entri
a650: 65 73 2c 20 63 61 6c 6c 20 74 68 69 73 0a 2a 2a  es, call this.**
a660: 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20 6d 61   routine with ma
a670: 73 6b 3d 3d 30 2e 0a 2a 2f 0a 76 6f 69 64 20 73  sk==0..*/.void s
a680: 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74 65  qlite3VdbeDelete
a690: 41 75 78 44 61 74 61 28 56 64 62 65 46 75 6e 63  AuxData(VdbeFunc
a6a0: 20 2a 70 56 64 62 65 46 75 6e 63 2c 20 69 6e 74   *pVdbeFunc, int
a6b0: 20 6d 61 73 6b 29 7b 0a 20 20 69 6e 74 20 69 3b   mask){.  int i;
a6c0: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 56  .  for(i=0; i<pV
a6d0: 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 3b 20 69  dbeFunc->nAux; i
a6e0: 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20  ++){.    struct 
a6f0: 41 75 78 44 61 74 61 20 2a 70 41 75 78 20 3d 20  AuxData *pAux = 
a700: 26 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41 75  &pVdbeFunc->apAu
a710: 78 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20 28 69  x[i];.    if( (i
a720: 3e 33 31 20 7c 7c 20 21 28 6d 61 73 6b 26 28 31  >31 || !(mask&(1
a730: 3c 3c 69 29 29 29 20 26 26 20 70 41 75 78 2d 3e  <<i))) && pAux->
a740: 70 41 75 78 20 29 7b 0a 20 20 20 20 20 20 69 66  pAux ){.      if
a750: 28 20 70 41 75 78 2d 3e 78 44 65 6c 65 74 65 20  ( pAux->xDelete 
a760: 29 7b 0a 20 20 20 20 20 20 20 20 70 41 75 78 2d  ){.        pAux-
a770: 3e 78 44 65 6c 65 74 65 28 70 41 75 78 2d 3e 70  >xDelete(pAux->p
a780: 41 75 78 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Aux);.      }.  
a790: 20 20 20 20 70 41 75 78 2d 3e 70 41 75 78 20 3d      pAux->pAux =
a7a0: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a   0;.    }.  }.}.
a7b0: 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65 20 61 6e  ./*.** Delete an
a7c0: 20 65 6e 74 69 72 65 20 56 44 42 45 2e 0a 2a 2f   entire VDBE..*/
a7d0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
a7e0: 65 44 65 6c 65 74 65 28 56 64 62 65 20 2a 70 29  eDelete(Vdbe *p)
a7f0: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28  {.  int i;.  if(
a800: 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a   p==0 ) return;.
a810: 20 20 43 6c 65 61 6e 75 70 28 70 29 3b 0a 20 20    Cleanup(p);.  
a820: 69 66 28 20 70 2d 3e 70 50 72 65 76 20 29 7b 0a  if( p->pPrev ){.
a830: 20 20 20 20 70 2d 3e 70 50 72 65 76 2d 3e 70 4e      p->pPrev->pN
a840: 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a  ext = p->pNext;.
a850: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73    }else{.    ass
a860: 65 72 74 28 20 70 2d 3e 64 62 2d 3e 70 56 64 62  ert( p->db->pVdb
a870: 65 3d 3d 70 20 29 3b 0a 20 20 20 20 70 2d 3e 64  e==p );.    p->d
a880: 62 2d 3e 70 56 64 62 65 20 3d 20 70 2d 3e 70 4e  b->pVdbe = p->pN
a890: 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  ext;.  }.  if( p
a8a0: 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 70  ->pNext ){.    p
a8b0: 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d  ->pNext->pPrev =
a8c0: 20 70 2d 3e 70 50 72 65 76 3b 0a 20 20 7d 0a 20   p->pPrev;.  }. 
a8d0: 20 69 66 28 20 70 2d 3e 61 4f 70 20 29 7b 0a 20   if( p->aOp ){. 
a8e0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d     for(i=0; i<p-
a8f0: 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  >nOp; i++){.    
a900: 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26 70 2d 3e    Op *pOp = &p->
a910: 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 20 20 69 66  aOp[i];.      if
a920: 28 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50  ( pOp->p3type==P
a930: 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 70 4f 70  3_DYNAMIC || pOp
a940: 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 4b 45 59  ->p3type==P3_KEY
a950: 49 4e 46 4f 20 29 7b 0a 20 20 20 20 20 20 20 20  INFO ){.        
a960: 73 71 6c 69 74 65 46 72 65 65 28 70 4f 70 2d 3e  sqliteFree(pOp->
a970: 70 33 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  p3);.      }.   
a980: 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 33 74 79     if( pOp->p3ty
a990: 70 65 3d 3d 50 33 5f 56 44 42 45 46 55 4e 43 20  pe==P3_VDBEFUNC 
a9a0: 29 7b 0a 20 20 20 20 20 20 20 20 56 64 62 65 46  ){.        VdbeF
a9b0: 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 20 3d  unc *pVdbeFunc =
a9c0: 20 28 56 64 62 65 46 75 6e 63 20 2a 29 70 4f 70   (VdbeFunc *)pOp
a9d0: 2d 3e 70 33 3b 0a 20 20 20 20 20 20 20 20 73 71  ->p3;.        sq
a9e0: 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74 65 41  lite3VdbeDeleteA
a9f0: 75 78 44 61 74 61 28 70 56 64 62 65 46 75 6e 63  uxData(pVdbeFunc
aa00: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 73 71  , 0);.        sq
aa10: 6c 69 74 65 46 72 65 65 28 70 56 64 62 65 46 75  liteFree(pVdbeFu
aa20: 6e 63 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  nc);.      }.   
aa30: 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 33 74 79     if( pOp->p3ty
aa40: 70 65 3d 3d 50 33 5f 4d 45 4d 20 29 7b 0a 20 20  pe==P3_MEM ){.  
aa50: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 61 6c        sqlite3Val
aa60: 75 65 46 72 65 65 28 28 73 71 6c 69 74 65 33 5f  ueFree((sqlite3_
aa70: 76 61 6c 75 65 2a 29 70 4f 70 2d 3e 70 33 29 3b  value*)pOp->p3);
aa80: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
aa90: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d     sqliteFree(p-
aaa0: 3e 61 4f 70 29 3b 0a 20 20 7d 0a 20 20 72 65 6c  >aOp);.  }.  rel
aab0: 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e  easeMemArray(p->
aac0: 61 56 61 72 2c 20 70 2d 3e 6e 56 61 72 29 3b 0a  aVar, p->nVar);.
aad0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
aae0: 61 4c 61 62 65 6c 29 3b 0a 20 20 73 71 6c 69 74  aLabel);.  sqlit
aaf0: 65 46 72 65 65 28 70 2d 3e 61 53 74 61 63 6b 29  eFree(p->aStack)
ab00: 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72  ;.  releaseMemAr
ab10: 72 61 79 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 2c  ray(p->aColName,
ab20: 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 2a 32   p->nResColumn*2
ab30: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
ab40: 70 2d 3e 61 43 6f 6c 4e 61 6d 65 29 3b 0a 20 20  p->aColName);.  
ab50: 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f  p->magic = VDBE_
ab60: 4d 41 47 49 43 5f 44 45 41 44 3b 0a 20 20 73 71  MAGIC_DEAD;.  sq
ab70: 6c 69 74 65 46 72 65 65 28 70 29 3b 0a 7d 0a 0a  liteFree(p);.}..
ab80: 2f 2a 0a 2a 2a 20 49 66 20 61 20 4d 6f 76 65 54  /*.** If a MoveT
ab90: 6f 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 70  o operation is p
aba0: 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 67 69  ending on the gi
abb0: 76 65 6e 20 63 75 72 73 6f 72 2c 20 74 68 65 6e  ven cursor, then
abc0: 20 64 6f 20 74 68 61 74 0a 2a 2a 20 4d 6f 76 65   do that.** Move
abd0: 54 6f 20 6e 6f 77 2e 20 20 52 65 74 75 72 6e 20  To now.  Return 
abe0: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 20  an error code.  
abf0: 49 66 20 6e 6f 20 4d 6f 76 65 54 6f 20 69 73 20  If no MoveTo is 
ac00: 70 65 6e 64 69 6e 67 2c 20 74 68 69 73 0a 2a 2a  pending, this.**
ac10: 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 6e 6f   routine does no
ac20: 74 68 69 6e 67 20 61 6e 64 20 72 65 74 75 72 6e  thing and return
ac30: 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a  s SQLITE_OK..*/.
ac40: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 43  int sqlite3VdbeC
ac50: 75 72 73 6f 72 4d 6f 76 65 74 6f 28 43 75 72 73  ursorMoveto(Curs
ac60: 6f 72 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d  or *p){.  if( p-
ac70: 3e 64 65 66 65 72 72 65 64 4d 6f 76 65 74 6f 20  >deferredMoveto 
ac80: 29 7b 0a 20 20 20 20 69 6e 74 20 72 65 73 2c 20  ){.    int res, 
ac90: 72 63 3b 0a 20 20 20 20 65 78 74 65 72 6e 20 69  rc;.    extern i
aca0: 6e 74 20 73 71 6c 69 74 65 33 5f 73 65 61 72 63  nt sqlite3_searc
acb0: 68 5f 63 6f 75 6e 74 3b 0a 20 20 20 20 61 73 73  h_count;.    ass
acc0: 65 72 74 28 20 70 2d 3e 69 73 54 61 62 6c 65 20  ert( p->isTable 
acd0: 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 69 73  );.    if( p->is
ace0: 54 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 72  Table ){.      r
acf0: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
ad00: 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73 6f  Moveto(p->pCurso
ad10: 72 2c 20 30 2c 20 70 2d 3e 6d 6f 76 65 74 6f 54  r, 0, p->movetoT
ad20: 61 72 67 65 74 2c 20 26 72 65 73 29 3b 0a 20 20  arget, &res);.  
ad30: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72    }else{.      r
ad40: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
ad50: 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73 6f  Moveto(p->pCurso
ad60: 72 2c 28 63 68 61 72 2a 29 26 70 2d 3e 6d 6f 76  r,(char*)&p->mov
ad70: 65 74 6f 54 61 72 67 65 74 2c 0a 20 20 20 20 20  etoTarget,.     
ad80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ad90: 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28           sizeof(
ada0: 69 36 34 29 2c 26 72 65 73 29 3b 0a 20 20 20 20  i64),&res);.    
adb0: 7d 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72  }.    if( rc ) r
adc0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 2a 70  eturn rc;.    *p
add0: 2d 3e 70 49 6e 63 72 4b 65 79 20 3d 20 30 3b 0a  ->pIncrKey = 0;.
ade0: 20 20 20 20 70 2d 3e 6c 61 73 74 52 6f 77 69 64      p->lastRowid
adf0: 20 3d 20 6b 65 79 54 6f 49 6e 74 28 70 2d 3e 6d   = keyToInt(p->m
ae00: 6f 76 65 74 6f 54 61 72 67 65 74 29 3b 0a 20 20  ovetoTarget);.  
ae10: 20 20 70 2d 3e 72 6f 77 69 64 49 73 56 61 6c 69    p->rowidIsVali
ae20: 64 20 3d 20 72 65 73 3d 3d 30 3b 0a 20 20 20 20  d = res==0;.    
ae30: 69 66 28 20 72 65 73 3c 30 20 29 7b 0a 20 20 20  if( res<0 ){.   
ae40: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
ae50: 74 72 65 65 4e 65 78 74 28 70 2d 3e 70 43 75 72  treeNext(p->pCur
ae60: 73 6f 72 2c 20 26 72 65 73 29 3b 0a 20 20 20 20  sor, &res);.    
ae70: 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72    if( rc ) retur
ae80: 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20  n rc;.    }.    
ae90: 73 71 6c 69 74 65 33 5f 73 65 61 72 63 68 5f 63  sqlite3_search_c
aea0: 6f 75 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e 64  ount++;.    p->d
aeb0: 65 66 65 72 72 65 64 4d 6f 76 65 74 6f 20 3d 20  eferredMoveto = 
aec0: 30 3b 0a 20 20 20 20 70 2d 3e 63 61 63 68 65 56  0;.    p->cacheV
aed0: 61 6c 69 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  alid = 0;.  }.  
aee0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
aef0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66  ;.}../*.** The f
af00: 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69 6f  ollowing functio
af10: 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65  ns:.**.** sqlite
af20: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28  3VdbeSerialType(
af30: 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65  ).** sqlite3Vdbe
af40: 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 29 0a  SerialTypeLen().
af50: 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  ** sqlite3VdbeSe
af60: 72 69 61 6c 52 65 61 64 28 29 0a 2a 2a 20 73 71  rialRead().** sq
af70: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 4c  lite3VdbeSerialL
af80: 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56  en().** sqlite3V
af90: 64 62 65 53 65 72 69 61 6c 57 72 69 74 65 28 29  dbeSerialWrite()
afa0: 0a 2a 2a 0a 2a 2a 20 65 6e 63 61 70 73 75 6c 61  .**.** encapsula
afb0: 74 65 20 74 68 65 20 63 6f 64 65 20 74 68 61 74  te the code that
afc0: 20 73 65 72 69 61 6c 69 7a 65 73 20 76 61 6c 75   serializes valu
afd0: 65 73 20 66 6f 72 20 73 74 6f 72 61 67 65 20 69  es for storage i
afe0: 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 64 61 74 61  n SQLite.** data
aff0: 20 61 6e 64 20 69 6e 64 65 78 20 72 65 63 6f 72   and index recor
b000: 64 73 2e 20 45 61 63 68 20 73 65 72 69 61 6c 69  ds. Each seriali
b010: 7a 65 64 20 76 61 6c 75 65 20 63 6f 6e 73 69 73  zed value consis
b020: 74 73 20 6f 66 20 61 0a 2a 2a 20 27 73 65 72 69  ts of a.** 'seri
b030: 61 6c 2d 74 79 70 65 27 20 61 6e 64 20 61 20 62  al-type' and a b
b040: 6c 6f 62 20 6f 66 20 64 61 74 61 2e 20 54 68 65  lob of data. The
b050: 20 73 65 72 69 61 6c 20 74 79 70 65 20 69 73 20   serial type is 
b060: 61 6e 20 38 2d 62 79 74 65 20 75 6e 73 69 67 6e  an 8-byte unsign
b070: 65 64 0a 2a 2a 20 69 6e 74 65 67 65 72 2c 20 73  ed.** integer, s
b080: 74 6f 72 65 64 20 61 73 20 61 20 76 61 72 69 6e  tored as a varin
b090: 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 61 6e 20 53  t..**.** In an S
b0a0: 51 4c 69 74 65 20 69 6e 64 65 78 20 72 65 63 6f  QLite index reco
b0b0: 72 64 2c 20 74 68 65 20 73 65 72 69 61 6c 20 74  rd, the serial t
b0c0: 79 70 65 20 69 73 20 73 74 6f 72 65 64 20 64 69  ype is stored di
b0d0: 72 65 63 74 6c 79 20 62 65 66 6f 72 65 0a 2a 2a  rectly before.**
b0e0: 20 74 68 65 20 62 6c 6f 62 20 6f 66 20 64 61 74   the blob of dat
b0f0: 61 20 74 68 61 74 20 69 74 20 63 6f 72 72 65 73  a that it corres
b100: 70 6f 6e 64 73 20 74 6f 2e 20 49 6e 20 61 20 74  ponds to. In a t
b110: 61 62 6c 65 20 72 65 63 6f 72 64 2c 20 61 6c 6c  able record, all
b120: 20 73 65 72 69 61 6c 0a 2a 2a 20 74 79 70 65 73   serial.** types
b130: 20 61 72 65 20 73 74 6f 72 65 64 20 61 74 20 74   are stored at t
b140: 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20  he start of the 
b150: 72 65 63 6f 72 64 2c 20 61 6e 64 20 74 68 65 20  record, and the 
b160: 62 6c 6f 62 73 20 6f 66 20 64 61 74 61 20 61 74  blobs of data at
b170: 0a 2a 2a 20 74 68 65 20 65 6e 64 2e 20 48 65 6e  .** the end. Hen
b180: 63 65 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f  ce these functio
b190: 6e 73 20 61 6c 6c 6f 77 20 74 68 65 20 63 61 6c  ns allow the cal
b1a0: 6c 65 72 20 74 6f 20 68 61 6e 64 6c 65 20 74 68  ler to handle th
b1b0: 65 0a 2a 2a 20 73 65 72 69 61 6c 2d 74 79 70 65  e.** serial-type
b1c0: 20 61 6e 64 20 64 61 74 61 20 62 6c 6f 62 20 73   and data blob s
b1d0: 65 70 65 72 61 74 65 6c 79 2e 0a 2a 2a 0a 2a 2a  eperately..**.**
b1e0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74   The following t
b1f0: 61 62 6c 65 20 64 65 73 63 72 69 62 65 73 20 74  able describes t
b200: 68 65 20 76 61 72 69 6f 75 73 20 73 74 6f 72 61  he various stora
b210: 67 65 20 63 6c 61 73 73 65 73 20 66 6f 72 20 64  ge classes for d
b220: 61 74 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 73 65 72  ata:.**.**   ser
b230: 69 61 6c 20 74 79 70 65 20 20 20 20 20 20 20 20  ial type        
b240: 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 20 20  bytes of data   
b250: 20 20 20 74 79 70 65 0a 2a 2a 20 20 20 2d 2d 2d     type.**   ---
b260: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20  -----------     
b270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20  --------------- 
b280: 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d     -------------
b290: 2d 2d 0a 2a 2a 20 20 20 20 20 20 30 20 20 20 20  --.**      0    
b2a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b2b0: 20 30 20 20 20 20 20 20 20 20 20 20 20 20 4e 55   0            NU
b2c0: 4c 4c 0a 2a 2a 20 20 20 20 20 20 31 20 20 20 20  LL.**      1    
b2d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b2e0: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 73 69   1            si
b2f0: 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20  gned integer.** 
b300: 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20       2          
b310: 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20             2    
b320: 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69          signed i
b330: 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 33  nteger.**      3
b340: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b350: 20 20 20 20 20 33 20 20 20 20 20 20 20 20 20 20       3          
b360: 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72    signed integer
b370: 0a 2a 2a 20 20 20 20 20 20 34 20 20 20 20 20 20  .**      4      
b380: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 34                 4
b390: 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67 6e              sign
b3a0: 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20  ed integer.**   
b3b0: 20 20 20 35 20 20 20 20 20 20 20 20 20 20 20 20     5            
b3c0: 20 20 20 20 20 20 20 20 20 36 20 20 20 20 20 20           6      
b3d0: 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74        signed int
b3e0: 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 36 20 20  eger.**      6  
b3f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b400: 20 20 20 38 20 20 20 20 20 20 20 20 20 20 20 20     8            
b410: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a  signed integer.*
b420: 2a 20 20 20 20 20 20 37 20 20 20 20 20 20 20 20  *      7        
b430: 20 20 20 20 20 20 20 20 20 20 20 20 20 38 20 20               8  
b440: 20 20 20 20 20 20 20 20 20 20 49 45 45 45 20 66            IEEE f
b450: 6c 6f 61 74 0a 2a 2a 20 20 20 20 20 38 2d 31 31  loat.**     8-11
b460: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b480: 72 65 73 65 72 76 65 64 20 66 6f 72 20 65 78 70  reserved for exp
b490: 61 6e 73 69 6f 6e 0a 2a 2a 20 20 20 20 4e 3e 3d  ansion.**    N>=
b4a0: 31 32 20 61 6e 64 20 65 76 65 6e 20 20 20 20 20  12 and even     
b4b0: 20 20 28 4e 2d 31 32 29 2f 32 20 20 20 20 20 20    (N-12)/2      
b4c0: 20 20 42 4c 4f 42 0a 2a 2a 20 20 20 20 4e 3e 3d    BLOB.**    N>=
b4d0: 31 33 20 61 6e 64 20 6f 64 64 20 20 20 20 20 20  13 and odd      
b4e0: 20 20 28 4e 2d 31 33 29 2f 32 20 20 20 20 20 20    (N-13)/2      
b4f0: 20 20 74 65 78 74 0a 2a 2a 0a 2a 2f 0a 0a 2f 2a    text.**.*/../*
b500: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73  .** Return the s
b510: 65 72 69 61 6c 2d 74 79 70 65 20 66 6f 72 20 74  erial-type for t
b520: 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20  he value stored 
b530: 69 6e 20 70 4d 65 6d 2e 0a 2a 2f 0a 75 33 32 20  in pMem..*/.u32 
b540: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
b550: 6c 54 79 70 65 28 4d 65 6d 20 2a 70 4d 65 6d 29  lType(Mem *pMem)
b560: 7b 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 3d 20  {.  int flags = 
b570: 70 4d 65 6d 2d 3e 66 6c 61 67 73 3b 0a 0a 20 20  pMem->flags;..  
b580: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 4e 75  if( flags&MEM_Nu
b590: 6c 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ll ){.    return
b5a0: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c   0;.  }.  if( fl
b5b0: 61 67 73 26 4d 45 4d 5f 49 6e 74 20 29 7b 0a 20  ags&MEM_Int ){. 
b5c0: 20 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74     /* Figure out
b5d0: 20 77 68 65 74 68 65 72 20 74 6f 20 75 73 65 20   whether to use 
b5e0: 31 2c 20 32 2c 20 34 2c 20 36 20 6f 72 20 38 20  1, 2, 4, 6 or 8 
b5f0: 62 79 74 65 73 2e 20 2a 2f 0a 23 20 20 20 64 65  bytes. */.#   de
b600: 66 69 6e 65 20 4d 41 58 5f 36 42 59 54 45 20 28  fine MAX_6BYTE (
b610: 28 28 28 69 36 34 29 30 78 30 30 30 30 31 30 30  (((i64)0x0000100
b620: 30 29 3c 3c 33 32 29 2d 31 29 0a 20 20 20 20 69  0)<<32)-1).    i
b630: 36 34 20 69 20 3d 20 70 4d 65 6d 2d 3e 69 3b 0a  64 i = pMem->i;.
b640: 20 20 20 20 75 36 34 20 75 20 3d 20 69 3c 30 20      u64 u = i<0 
b650: 3f 20 2d 69 20 3a 20 69 3b 0a 20 20 20 20 69 66  ? -i : i;.    if
b660: 28 20 75 3c 3d 31 32 37 20 29 20 72 65 74 75 72  ( u<=127 ) retur
b670: 6e 20 31 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d  n 1;.    if( u<=
b680: 33 32 37 36 37 20 29 20 72 65 74 75 72 6e 20 32  32767 ) return 2
b690: 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 38 33 38  ;.    if( u<=838
b6a0: 38 36 30 37 20 29 20 72 65 74 75 72 6e 20 33 3b  8607 ) return 3;
b6b0: 0a 20 20 20 20 69 66 28 20 75 3c 3d 32 31 34 37  .    if( u<=2147
b6c0: 34 38 33 36 34 37 20 29 20 72 65 74 75 72 6e 20  483647 ) return 
b6d0: 34 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 4d 41  4;.    if( u<=MA
b6e0: 58 5f 36 42 59 54 45 20 29 20 72 65 74 75 72 6e  X_6BYTE ) return
b6f0: 20 35 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 36   5;.    return 6
b700: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67  ;.  }.  if( flag
b710: 73 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a 20 20  s&MEM_Real ){.  
b720: 20 20 72 65 74 75 72 6e 20 37 3b 0a 20 20 7d 0a    return 7;.  }.
b730: 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f    if( flags&MEM_
b740: 53 74 72 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e  Str ){.    int n
b750: 20 3d 20 70 4d 65 6d 2d 3e 6e 3b 0a 20 20 20 20   = pMem->n;.    
b760: 61 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b 0a  assert( n>=0 );.
b770: 20 20 20 20 72 65 74 75 72 6e 20 28 28 6e 2a 32      return ((n*2
b780: 29 20 2b 20 31 33 29 3b 0a 20 20 7d 0a 20 20 69  ) + 13);.  }.  i
b790: 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 42 6c 6f  f( flags&MEM_Blo
b7a0: 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  b ){.    return 
b7b0: 28 70 4d 65 6d 2d 3e 6e 2a 32 20 2b 20 31 32 29  (pMem->n*2 + 12)
b7c0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30  ;.  }.  return 0
b7d0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
b7e0: 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66 20  n the length of 
b7f0: 74 68 65 20 64 61 74 61 20 63 6f 72 72 65 73 70  the data corresp
b800: 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 73 75  onding to the su
b810: 70 70 6c 69 65 64 20 73 65 72 69 61 6c 2d 74 79  pplied serial-ty
b820: 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  pe..*/.int sqlit
b830: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
b840: 4c 65 6e 28 75 33 32 20 73 65 72 69 61 6c 5f 74  Len(u32 serial_t
b850: 79 70 65 29 7b 0a 20 20 69 66 28 20 73 65 72 69  ype){.  if( seri
b860: 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b 0a 20  al_type>=12 ){. 
b870: 20 20 20 72 65 74 75 72 6e 20 28 73 65 72 69 61     return (seria
b880: 6c 5f 74 79 70 65 2d 31 32 29 2f 32 3b 0a 20 20  l_type-12)/2;.  
b890: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 61 74 69  }else{.    stati
b8a0: 63 20 63 6f 6e 73 74 20 75 38 20 61 53 69 7a 65  c const u8 aSize
b8b0: 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c 20 32 2c 20  [] = { 0, 1, 2, 
b8c0: 33 2c 20 34 2c 20 36 2c 20 38 2c 20 38 2c 20 30  3, 4, 6, 8, 8, 0
b8d0: 2c 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 20 20 20  , 0, 0, 0 };.   
b8e0: 20 72 65 74 75 72 6e 20 61 53 69 7a 65 5b 73 65   return aSize[se
b8f0: 72 69 61 6c 5f 74 79 70 65 5d 3b 0a 20 20 7d 0a  rial_type];.  }.
b900: 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 74  }../*.** Write t
b910: 68 65 20 73 65 72 69 61 6c 69 7a 65 64 20 64 61  he serialized da
b920: 74 61 20 62 6c 6f 62 20 66 6f 72 20 74 68 65 20  ta blob for the 
b930: 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 20  value stored in 
b940: 70 4d 65 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62 75  pMem into .** bu
b950: 66 2e 20 49 74 20 69 73 20 61 73 73 75 6d 65 64  f. It is assumed
b960: 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72   that the caller
b970: 20 68 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 73   has allocated s
b980: 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65 2e  ufficient space.
b990: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
b9a0: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 77  umber of bytes w
b9b0: 72 69 74 74 65 6e 2e 0a 2a 2f 20 0a 69 6e 74 20  ritten..*/ .int 
b9c0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
b9d0: 6c 50 75 74 28 75 6e 73 69 67 6e 65 64 20 63 68  lPut(unsigned ch
b9e0: 61 72 20 2a 62 75 66 2c 20 4d 65 6d 20 2a 70 4d  ar *buf, Mem *pM
b9f0: 65 6d 29 7b 0a 20 20 75 33 32 20 73 65 72 69 61  em){.  u32 seria
ba00: 6c 5f 74 79 70 65 20 3d 20 73 71 6c 69 74 65 33  l_type = sqlite3
ba10: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28 70  VdbeSerialType(p
ba20: 4d 65 6d 29 3b 0a 20 20 69 6e 74 20 6c 65 6e 3b  Mem);.  int len;
ba30: 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a 20  ..  /* NULL */. 
ba40: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
ba50: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ==0 ){.    retur
ba60: 6e 20 30 3b 0a 20 20 7d 0a 20 0a 20 20 2f 2a 20  n 0;.  }. .  /* 
ba70: 49 6e 74 65 67 65 72 20 61 6e 64 20 52 65 61 6c  Integer and Real
ba80: 20 2a 2f 0a 20 20 69 66 28 20 73 65 72 69 61 6c   */.  if( serial
ba90: 5f 74 79 70 65 3c 3d 37 20 29 7b 0a 20 20 20 20  _type<=7 ){.    
baa0: 75 36 34 20 76 3b 0a 20 20 20 20 69 6e 74 20 69  u64 v;.    int i
bab0: 3b 0a 20 20 20 20 69 66 28 20 73 65 72 69 61 6c  ;.    if( serial
bac0: 5f 74 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20 20  _type==7 ){.    
bad0: 20 20 76 20 3d 20 2a 28 75 36 34 2a 29 26 70 4d    v = *(u64*)&pM
bae0: 65 6d 2d 3e 72 3b 0a 20 20 20 20 7d 65 6c 73 65  em->r;.    }else
baf0: 7b 0a 20 20 20 20 20 20 76 20 3d 20 2a 28 75 36  {.      v = *(u6
bb00: 34 2a 29 26 70 4d 65 6d 2d 3e 69 3b 0a 20 20 20  4*)&pMem->i;.   
bb10: 20 7d 0a 20 20 20 20 6c 65 6e 20 3d 20 69 20 3d   }.    len = i =
bb20: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
bb30: 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c  alTypeLen(serial
bb40: 5f 74 79 70 65 29 3b 0a 20 20 20 20 77 68 69 6c  _type);.    whil
bb50: 65 28 20 69 2d 2d 20 29 7b 0a 20 20 20 20 20 20  e( i-- ){.      
bb60: 62 75 66 5b 69 5d 20 3d 20 28 76 26 30 78 46 46  buf[i] = (v&0xFF
bb70: 29 3b 0a 20 20 20 20 20 20 76 20 3e 3e 3d 20 38  );.      v >>= 8
bb80: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75  ;.    }.    retu
bb90: 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a 20 20 0a 20  rn len;.  }.  . 
bba0: 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72 20 62 6c   /* String or bl
bbb0: 6f 62 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  ob */.  assert( 
bbc0: 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20  serial_type>=12 
bbd0: 29 3b 0a 20 20 6c 65 6e 20 3d 20 73 71 6c 69 74  );.  len = sqlit
bbe0: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
bbf0: 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 29  Len(serial_type)
bc00: 3b 0a 20 20 6d 65 6d 63 70 79 28 62 75 66 2c 20  ;.  memcpy(buf, 
bc10: 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29 3b 0a 20  pMem->z, len);. 
bc20: 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 7d 0a 0a   return len;.}..
bc30: 2f 2a 0a 2a 2a 20 44 65 73 65 72 69 61 6c 69 7a  /*.** Deserializ
bc40: 65 20 74 68 65 20 64 61 74 61 20 62 6c 6f 62 20  e the data blob 
bc50: 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 62 75  pointed to by bu
bc60: 66 20 61 73 20 73 65 72 69 61 6c 20 74 79 70 65  f as serial type
bc70: 20 73 65 72 69 61 6c 5f 74 79 70 65 0a 2a 2a 20   serial_type.** 
bc80: 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 72 65  and store the re
bc90: 73 75 6c 74 20 69 6e 20 70 4d 65 6d 2e 20 20 52  sult in pMem.  R
bca0: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
bcb0: 20 6f 66 20 62 79 74 65 73 20 72 65 61 64 2e 0a   of bytes read..
bcc0: 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  */ .int sqlite3V
bcd0: 64 62 65 53 65 72 69 61 6c 47 65 74 28 0a 20 20  dbeSerialGet(.  
bce0: 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63  const unsigned c
bcf0: 68 61 72 20 2a 62 75 66 2c 20 20 20 20 20 2f 2a  har *buf,     /*
bd00: 20 42 75 66 66 65 72 20 74 6f 20 64 65 73 65 72   Buffer to deser
bd10: 69 61 6c 69 7a 65 20 66 72 6f 6d 20 2a 2f 0a 20  ialize from */. 
bd20: 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65   u32 serial_type
bd30: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
bd40: 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 74 6f  * Serial type to
bd50: 20 64 65 73 65 72 69 61 6c 69 7a 65 20 2a 2f 0a   deserialize */.
bd60: 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 20 20 20 20    Mem *pMem     
bd70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bd80: 2f 2a 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20 74  /* Memory cell t
bd90: 6f 20 77 72 69 74 65 20 76 61 6c 75 65 20 69 6e  o write value in
bda0: 74 6f 20 2a 2f 0a 29 7b 0a 20 20 73 77 69 74 63  to */.){.  switc
bdb0: 68 28 20 73 65 72 69 61 6c 5f 74 79 70 65 20 29  h( serial_type )
bdc0: 7b 0a 20 20 20 20 63 61 73 65 20 38 3a 20 20 20  {.    case 8:   
bdd0: 20 2f 2a 20 52 65 73 65 72 76 65 64 20 66 6f 72   /* Reserved for
bde0: 20 66 75 74 75 72 65 20 75 73 65 20 2a 2f 0a 20   future use */. 
bdf0: 20 20 20 63 61 73 65 20 39 3a 20 20 20 20 2f 2a     case 9:    /*
be00: 20 52 65 73 65 72 76 65 64 20 66 6f 72 20 66 75   Reserved for fu
be10: 74 75 72 65 20 75 73 65 20 2a 2f 0a 20 20 20 20  ture use */.    
be20: 63 61 73 65 20 31 30 3a 20 20 20 2f 2a 20 52 65  case 10:   /* Re
be30: 73 65 72 76 65 64 20 66 6f 72 20 66 75 74 75 72  served for futur
be40: 65 20 75 73 65 20 2a 2f 0a 20 20 20 20 63 61 73  e use */.    cas
be50: 65 20 31 31 3a 20 20 20 2f 2a 20 52 65 73 65 72  e 11:   /* Reser
be60: 76 65 64 20 66 6f 72 20 66 75 74 75 72 65 20 75  ved for future u
be70: 73 65 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 30  se */.    case 0
be80: 3a 20 7b 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a  : {  /* NULL */.
be90: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
bea0: 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20  s = MEM_Null;.  
beb0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
bec0: 0a 20 20 20 20 63 61 73 65 20 31 3a 20 7b 20 2f  .    case 1: { /
bed0: 2a 20 31 2d 62 79 74 65 20 73 69 67 6e 65 64 20  * 1-byte signed 
bee0: 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 20  integer */.     
bef0: 20 70 4d 65 6d 2d 3e 69 20 3d 20 28 73 69 67 6e   pMem->i = (sign
bf00: 65 64 20 63 68 61 72 29 62 75 66 5b 30 5d 3b 0a  ed char)buf[0];.
bf10: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
bf20: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
bf30: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20     return 1;.   
bf40: 20 7d 0a 20 20 20 20 63 61 73 65 20 32 3a 20 7b   }.    case 2: {
bf50: 20 2f 2a 20 32 2d 62 79 74 65 20 73 69 67 6e 65   /* 2-byte signe
bf60: 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20  d integer */.   
bf70: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 28 28 28     pMem->i = (((
bf80: 73 69 67 6e 65 64 20 63 68 61 72 29 62 75 66 5b  signed char)buf[
bf90: 30 5d 29 3c 3c 38 29 20 7c 20 62 75 66 5b 31 5d  0])<<8) | buf[1]
bfa0: 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  ;.      pMem->fl
bfb0: 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20  ags = MEM_Int;. 
bfc0: 20 20 20 20 20 72 65 74 75 72 6e 20 32 3b 0a 20       return 2;. 
bfd0: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 33 3a     }.    case 3:
bfe0: 20 7b 20 2f 2a 20 33 2d 62 79 74 65 20 73 69 67   { /* 3-byte sig
bff0: 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20  ned integer */. 
c000: 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 28       pMem->i = (
c010: 28 28 73 69 67 6e 65 64 20 63 68 61 72 29 62 75  ((signed char)bu
c020: 66 5b 30 5d 29 3c 3c 31 36 29 20 7c 20 28 62 75  f[0])<<16) | (bu
c030: 66 5b 31 5d 3c 3c 38 29 20 7c 20 62 75 66 5b 32  f[1]<<8) | buf[2
c040: 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  ];.      pMem->f
c050: 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a  lags = MEM_Int;.
c060: 20 20 20 20 20 20 72 65 74 75 72 6e 20 33 3b 0a        return 3;.
c070: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 34      }.    case 4
c080: 3a 20 7b 20 2f 2a 20 34 2d 62 79 74 65 20 73 69  : { /* 4-byte si
c090: 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a  gned integer */.
c0a0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20        pMem->i = 
c0b0: 28 62 75 66 5b 30 5d 3c 3c 32 34 29 20 7c 20 28  (buf[0]<<24) | (
c0c0: 62 75 66 5b 31 5d 3c 3c 31 36 29 20 7c 20 28 62  buf[1]<<16) | (b
c0d0: 75 66 5b 32 5d 3c 3c 38 29 20 7c 20 62 75 66 5b  uf[2]<<8) | buf[
c0e0: 33 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e  3];.      pMem->
c0f0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b  flags = MEM_Int;
c100: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 34 3b  .      return 4;
c110: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20  .    }.    case 
c120: 35 3a 20 7b 20 2f 2a 20 36 2d 62 79 74 65 20 73  5: { /* 6-byte s
c130: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f  igned integer */
c140: 0a 20 20 20 20 20 20 75 36 34 20 78 20 3d 20 28  .      u64 x = (
c150: 28 28 73 69 67 6e 65 64 20 63 68 61 72 29 62 75  ((signed char)bu
c160: 66 5b 30 5d 29 3c 3c 38 29 20 7c 20 62 75 66 5b  f[0])<<8) | buf[
c170: 31 5d 3b 0a 20 20 20 20 20 20 75 33 32 20 79 20  1];.      u32 y 
c180: 3d 20 28 62 75 66 5b 32 5d 3c 3c 32 34 29 20 7c  = (buf[2]<<24) |
c190: 20 28 62 75 66 5b 33 5d 3c 3c 31 36 29 20 7c 20   (buf[3]<<16) | 
c1a0: 28 62 75 66 5b 34 5d 3c 3c 38 29 20 7c 20 62 75  (buf[4]<<8) | bu
c1b0: 66 5b 35 5d 3b 0a 20 20 20 20 20 20 78 20 3d 20  f[5];.      x = 
c1c0: 28 78 3c 3c 33 32 29 20 7c 20 79 3b 0a 20 20 20  (x<<32) | y;.   
c1d0: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 2a 28 69     pMem->i = *(i
c1e0: 36 34 2a 29 26 78 3b 0a 20 20 20 20 20 20 70 4d  64*)&x;.      pM
c1f0: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
c200: 49 6e 74 3b 0a 20 20 20 20 20 20 72 65 74 75 72  Int;.      retur
c210: 6e 20 36 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  n 6;.    }.    c
c220: 61 73 65 20 36 3a 20 20 20 2f 2a 20 38 2d 62 79  ase 6:   /* 8-by
c230: 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65  te signed intege
c240: 72 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 37 3a  r */.    case 7:
c250: 20 7b 20 2f 2a 20 49 45 45 45 20 66 6c 6f 61 74   { /* IEEE float
c260: 69 6e 67 20 70 6f 69 6e 74 20 2a 2f 0a 23 69 66  ing point */.#if
c270: 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 20 20 20  ndef NDEBUG.    
c280: 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68 61 74    /* Verify that
c290: 20 69 6e 74 65 67 65 72 73 20 61 6e 64 20 66 6c   integers and fl
c2a0: 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 76 61 6c  oating point val
c2b0: 75 65 73 20 75 73 65 20 74 68 65 20 73 61 6d 65  ues use the same
c2c0: 0a 20 20 20 20 20 20 2a 2a 20 62 79 74 65 20 6f  .      ** byte o
c2d0: 72 64 65 72 2e 20 20 54 68 65 20 62 79 74 65 20  rder.  The byte 
c2e0: 6f 72 64 65 72 20 64 69 66 66 65 72 73 20 6f 6e  order differs on
c2f0: 20 73 6f 6d 65 20 28 62 72 6f 6b 65 6e 29 20 61   some (broken) a
c300: 72 63 68 69 74 65 63 74 75 72 65 73 2e 0a 20 20  rchitectures..  
c310: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 73 74 61      */.      sta
c320: 74 69 63 20 63 6f 6e 73 74 20 75 36 34 20 74 31  tic const u64 t1
c330: 20 3d 20 28 28 75 36 34 29 30 78 33 66 66 30 30   = ((u64)0x3ff00
c340: 30 30 30 29 3c 3c 33 32 3b 0a 20 20 20 20 20 20  000)<<32;.      
c350: 61 73 73 65 72 74 28 20 31 2e 30 3d 3d 2a 28 64  assert( 1.0==*(d
c360: 6f 75 62 6c 65 2a 29 26 74 31 20 29 3b 0a 23 65  ouble*)&t1 );.#e
c370: 6e 64 69 66 0a 0a 20 20 20 20 20 20 75 36 34 20  ndif..      u64 
c380: 78 20 3d 20 28 62 75 66 5b 30 5d 3c 3c 32 34 29  x = (buf[0]<<24)
c390: 20 7c 20 28 62 75 66 5b 31 5d 3c 3c 31 36 29 20   | (buf[1]<<16) 
c3a0: 7c 20 28 62 75 66 5b 32 5d 3c 3c 38 29 20 7c 20  | (buf[2]<<8) | 
c3b0: 62 75 66 5b 33 5d 3b 0a 20 20 20 20 20 20 75 33  buf[3];.      u3
c3c0: 32 20 79 20 3d 20 28 62 75 66 5b 34 5d 3c 3c 32  2 y = (buf[4]<<2
c3d0: 34 29 20 7c 20 28 62 75 66 5b 35 5d 3c 3c 31 36  4) | (buf[5]<<16
c3e0: 29 20 7c 20 28 62 75 66 5b 36 5d 3c 3c 38 29 20  ) | (buf[6]<<8) 
c3f0: 7c 20 62 75 66 5b 37 5d 3b 0a 20 20 20 20 20 20  | buf[7];.      
c400: 78 20 3d 20 28 78 3c 3c 33 32 29 20 7c 20 79 3b  x = (x<<32) | y;
c410: 0a 20 20 20 20 20 20 69 66 28 20 73 65 72 69 61  .      if( seria
c420: 6c 5f 74 79 70 65 3d 3d 36 20 29 7b 0a 20 20 20  l_type==6 ){.   
c430: 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 2a       pMem->i = *
c440: 28 69 36 34 2a 29 26 78 3b 0a 20 20 20 20 20 20  (i64*)&x;.      
c450: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
c460: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20 7d  MEM_Int;.      }
c470: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d  else{.        pM
c480: 65 6d 2d 3e 72 20 3d 20 2a 28 64 6f 75 62 6c 65  em->r = *(double
c490: 2a 29 26 78 3b 0a 20 20 20 20 20 20 20 20 70 4d  *)&x;.        pM
c4a0: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
c4b0: 52 65 61 6c 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Real;.      }.  
c4c0: 20 20 20 20 72 65 74 75 72 6e 20 38 3b 0a 20 20      return 8;.  
c4d0: 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a    }.    default:
c4e0: 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 6c 65 6e   {.      int len
c4f0: 20 3d 20 28 73 65 72 69 61 6c 5f 74 79 70 65 2d   = (serial_type-
c500: 31 32 29 2f 32 3b 0a 20 20 20 20 20 20 70 4d 65  12)/2;.      pMe
c510: 6d 2d 3e 7a 20 3d 20 28 63 68 61 72 20 2a 29 62  m->z = (char *)b
c520: 75 66 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e  uf;.      pMem->
c530: 6e 20 3d 20 6c 65 6e 3b 0a 20 20 20 20 20 20 70  n = len;.      p
c540: 4d 65 6d 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20  Mem->xDel = 0;. 
c550: 20 20 20 20 20 69 66 28 20 73 65 72 69 61 6c 5f       if( serial_
c560: 74 79 70 65 26 30 78 30 31 20 29 7b 0a 20 20 20  type&0x01 ){.   
c570: 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73       pMem->flags
c580: 20 3d 20 4d 45 4d 5f 53 74 72 20 7c 20 4d 45 4d   = MEM_Str | MEM
c590: 5f 45 70 68 65 6d 3b 0a 20 20 20 20 20 20 7d 65  _Ephem;.      }e
c5a0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65  lse{.        pMe
c5b0: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 42  m->flags = MEM_B
c5c0: 6c 6f 62 20 7c 20 4d 45 4d 5f 45 70 68 65 6d 3b  lob | MEM_Ephem;
c5d0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72  .      }.      r
c5e0: 65 74 75 72 6e 20 6c 65 6e 3b 0a 20 20 20 20 7d  eturn len;.    }
c5f0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b  .  }.  return 0;
c600: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
c610: 75 6e 63 74 69 6f 6e 20 63 6f 6d 70 61 72 65 73  unction compares
c620: 20 74 68 65 20 74 77 6f 20 74 61 62 6c 65 20 72   the two table r
c630: 6f 77 73 20 6f 72 20 69 6e 64 65 78 20 72 65 63  ows or index rec
c640: 6f 72 64 73 20 73 70 65 63 69 66 69 65 64 20 62  ords specified b
c650: 79 20 0a 2a 2a 20 7b 6e 4b 65 79 31 2c 20 70 4b  y .** {nKey1, pK
c660: 65 79 31 7d 20 61 6e 64 20 7b 6e 4b 65 79 32 2c  ey1} and {nKey2,
c670: 20 70 4b 65 79 32 7d 2c 20 72 65 74 75 72 6e 69   pKey2}, returni
c680: 6e 67 20 61 20 6e 65 67 61 74 69 76 65 2c 20 7a  ng a negative, z
c690: 65 72 6f 0a 2a 2a 20 6f 72 20 70 6f 73 69 74 69  ero.** or positi
c6a0: 76 65 20 69 6e 74 65 67 65 72 20 69 66 20 7b 6e  ve integer if {n
c6b0: 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20 69 73 20  Key1, pKey1} is 
c6c0: 6c 65 73 73 20 74 68 61 6e 2c 20 65 71 75 61 6c  less than, equal
c6d0: 20 74 6f 20 6f 72 20 0a 2a 2a 20 67 72 65 61 74   to or .** great
c6e0: 65 72 20 74 68 61 6e 20 7b 6e 4b 65 79 32 2c 20  er than {nKey2, 
c6f0: 70 4b 65 79 32 7d 2e 20 20 42 6f 74 68 20 4b 65  pKey2}.  Both Ke
c700: 79 31 20 61 6e 64 20 4b 65 79 32 20 6d 75 73 74  y1 and Key2 must
c710: 20 62 65 20 62 79 74 65 20 73 74 72 69 6e 67 73   be byte strings
c720: 0a 2a 2a 20 63 6f 6d 70 6f 73 65 64 20 62 79 20  .** composed by 
c730: 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72  the OP_MakeRecor
c740: 64 20 6f 70 63 6f 64 65 20 6f 66 20 74 68 65 20  d opcode of the 
c750: 56 44 42 45 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  VDBE..*/.int sql
c760: 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f  ite3VdbeRecordCo
c770: 6d 70 61 72 65 28 0a 20 20 76 6f 69 64 20 2a 75  mpare(.  void *u
c780: 73 65 72 44 61 74 61 2c 0a 20 20 69 6e 74 20 6e  serData,.  int n
c790: 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64  Key1, const void
c7a0: 20 2a 70 4b 65 79 31 2c 20 0a 20 20 69 6e 74 20   *pKey1, .  int 
c7b0: 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69  nKey2, const voi
c7c0: 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 4b 65  d *pKey2.){.  Ke
c7d0: 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20  yInfo *pKeyInfo 
c7e0: 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 75 73 65 72  = (KeyInfo*)user
c7f0: 44 61 74 61 3b 0a 20 20 75 33 32 20 64 31 2c 20  Data;.  u32 d1, 
c800: 64 32 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  d2;          /* 
c810: 4f 66 66 73 65 74 20 69 6e 74 6f 20 61 4b 65 79  Offset into aKey
c820: 5b 5d 20 6f 66 20 6e 65 78 74 20 64 61 74 61 20  [] of next data 
c830: 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 75 33 32  element */.  u32
c840: 20 69 64 78 31 2c 20 69 64 78 32 3b 20 20 20 20   idx1, idx2;    
c850: 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 74 6f    /* Offset into
c860: 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65 78 74 20   aKey[] of next 
c870: 68 65 61 64 65 72 20 65 6c 65 6d 65 6e 74 20 2a  header element *
c880: 2f 0a 20 20 75 33 32 20 73 7a 48 64 72 31 2c 20  /.  u32 szHdr1, 
c890: 73 7a 48 64 72 32 3b 20 20 2f 2a 20 4e 75 6d 62  szHdr2;  /* Numb
c8a0: 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 68  er of bytes in h
c8b0: 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e 74 20 69  eader */.  int i
c8c0: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 46 69 65   = 0;.  int nFie
c8d0: 6c 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 30  ld;.  int rc = 0
c8e0: 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  ;.  const unsign
c8f0: 65 64 20 63 68 61 72 20 2a 61 4b 65 79 31 20 3d  ed char *aKey1 =
c900: 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64   (const unsigned
c910: 20 63 68 61 72 20 2a 29 70 4b 65 79 31 3b 0a 20   char *)pKey1;. 
c920: 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20   const unsigned 
c930: 63 68 61 72 20 2a 61 4b 65 79 32 20 3d 20 28 63  char *aKey2 = (c
c940: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
c950: 61 72 20 2a 29 70 4b 65 79 32 3b 0a 0a 20 20 4d  ar *)pKey2;..  M
c960: 65 6d 20 6d 65 6d 31 3b 0a 20 20 4d 65 6d 20 6d  em mem1;.  Mem m
c970: 65 6d 32 3b 0a 20 20 6d 65 6d 31 2e 65 6e 63 20  em2;.  mem1.enc 
c980: 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b  = pKeyInfo->enc;
c990: 0a 20 20 6d 65 6d 32 2e 65 6e 63 20 3d 20 70 4b  .  mem2.enc = pK
c9a0: 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20 0a  eyInfo->enc;.  .
c9b0: 20 20 69 64 78 31 20 3d 20 73 71 6c 69 74 65 33    idx1 = sqlite3
c9c0: 47 65 74 56 61 72 69 6e 74 33 32 28 70 4b 65 79  GetVarint32(pKey
c9d0: 31 2c 20 26 73 7a 48 64 72 31 29 3b 0a 20 20 64  1, &szHdr1);.  d
c9e0: 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20 20 69 64  1 = szHdr1;.  id
c9f0: 78 32 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56  x2 = sqlite3GetV
ca00: 61 72 69 6e 74 33 32 28 70 4b 65 79 32 2c 20 26  arint32(pKey2, &
ca10: 73 7a 48 64 72 32 29 3b 0a 20 20 64 32 20 3d 20  szHdr2);.  d2 = 
ca20: 73 7a 48 64 72 32 3b 0a 20 20 6e 46 69 65 6c 64  szHdr2;.  nField
ca30: 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69   = pKeyInfo->nFi
ca40: 65 6c 64 3b 0a 20 20 77 68 69 6c 65 28 20 69 64  eld;.  while( id
ca50: 78 31 3c 73 7a 48 64 72 31 20 26 26 20 69 64 78  x1<szHdr1 && idx
ca60: 32 3c 73 7a 48 64 72 32 20 29 7b 0a 20 20 20 20  2<szHdr2 ){.    
ca70: 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65 31  u32 serial_type1
ca80: 3b 0a 20 20 20 20 75 33 32 20 73 65 72 69 61 6c  ;.    u32 serial
ca90: 5f 74 79 70 65 32 3b 0a 0a 20 20 20 20 2f 2a 20  _type2;..    /* 
caa0: 52 65 61 64 20 74 68 65 20 73 65 72 69 61 6c 20  Read the serial 
cab0: 74 79 70 65 73 20 66 6f 72 20 74 68 65 20 6e 65  types for the ne
cac0: 78 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20 65 61  xt element in ea
cad0: 63 68 20 6b 65 79 2e 20 2a 2f 0a 20 20 20 20 69  ch key. */.    i
cae0: 64 78 31 20 2b 3d 20 73 71 6c 69 74 65 33 47 65  dx1 += sqlite3Ge
caf0: 74 56 61 72 69 6e 74 33 32 28 26 61 4b 65 79 31  tVarint32(&aKey1
cb00: 5b 69 64 78 31 5d 2c 20 26 73 65 72 69 61 6c 5f  [idx1], &serial_
cb10: 74 79 70 65 31 29 3b 0a 20 20 20 20 69 66 28 20  type1);.    if( 
cb20: 64 31 3e 3d 6e 4b 65 79 31 20 26 26 20 73 71 6c  d1>=nKey1 && sql
cb30: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
cb40: 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70  peLen(serial_typ
cb50: 65 31 29 3e 30 20 29 20 62 72 65 61 6b 3b 0a 20  e1)>0 ) break;. 
cb60: 20 20 20 69 64 78 32 20 2b 3d 20 73 71 6c 69 74     idx2 += sqlit
cb70: 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 26 61  e3GetVarint32(&a
cb80: 4b 65 79 32 5b 69 64 78 32 5d 2c 20 26 73 65 72  Key2[idx2], &ser
cb90: 69 61 6c 5f 74 79 70 65 32 29 3b 0a 20 20 20 20  ial_type2);.    
cba0: 69 66 28 20 64 32 3e 3d 6e 4b 65 79 32 20 26 26  if( d2>=nKey2 &&
cbb0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
cbc0: 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c  alTypeLen(serial
cbd0: 5f 74 79 70 65 32 29 3e 30 20 29 20 62 72 65 61  _type2)>0 ) brea
cbe0: 6b 3b 0a 0a 20 20 20 20 2f 2a 20 41 73 73 65 72  k;..    /* Asser
cbf0: 74 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20  t that there is 
cc00: 65 6e 6f 75 67 68 20 73 70 61 63 65 20 6c 65 66  enough space lef
cc10: 74 20 69 6e 20 65 61 63 68 20 6b 65 79 20 66 6f  t in each key fo
cc20: 72 20 74 68 65 20 62 6c 6f 62 20 6f 66 0a 20 20  r the blob of.  
cc30: 20 20 2a 2a 20 64 61 74 61 20 74 6f 20 67 6f 20    ** data to go 
cc40: 77 69 74 68 20 74 68 65 20 73 65 72 69 61 6c 20  with the serial 
cc50: 74 79 70 65 20 6a 75 73 74 20 72 65 61 64 2e 20  type just read. 
cc60: 54 68 69 73 20 61 73 73 65 72 74 20 6d 61 79 20  This assert may 
cc70: 66 61 69 6c 20 69 66 0a 20 20 20 20 2a 2a 20 74  fail if.    ** t
cc80: 68 65 20 66 69 6c 65 20 69 73 20 63 6f 72 72 75  he file is corru
cc90: 70 74 65 64 2e 20 20 54 68 65 6e 20 72 65 61 64  pted.  Then read
cca0: 20 74 68 65 20 76 61 6c 75 65 20 66 72 6f 6d 20   the value from 
ccb0: 65 61 63 68 20 6b 65 79 20 69 6e 74 6f 20 6d 65  each key into me
ccc0: 6d 31 0a 20 20 20 20 2a 2a 20 61 6e 64 20 6d 65  m1.    ** and me
ccd0: 6d 32 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e  m2 respectively.
cce0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64 31 20 2b  .    */.    d1 +
ccf0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
cd00: 69 61 6c 47 65 74 28 26 61 4b 65 79 31 5b 64 31  ialGet(&aKey1[d1
cd10: 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 31 2c  ], serial_type1,
cd20: 20 26 6d 65 6d 31 29 3b 0a 20 20 20 20 64 32 20   &mem1);.    d2 
cd30: 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  += sqlite3VdbeSe
cd40: 72 69 61 6c 47 65 74 28 26 61 4b 65 79 32 5b 64  rialGet(&aKey2[d
cd50: 32 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 32  2], serial_type2
cd60: 2c 20 26 6d 65 6d 32 29 3b 0a 0a 20 20 20 20 72  , &mem2);..    r
cd70: 63 20 3d 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f  c = sqlite3MemCo
cd80: 6d 70 61 72 65 28 26 6d 65 6d 31 2c 20 26 6d 65  mpare(&mem1, &me
cd90: 6d 32 2c 20 69 3c 6e 46 69 65 6c 64 20 3f 20 70  m2, i<nField ? p
cda0: 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 69  KeyInfo->aColl[i
cdb0: 5d 20 3a 20 30 29 3b 0a 20 20 20 20 69 66 28 20  ] : 0);.    if( 
cdc0: 6d 65 6d 31 2e 66 6c 61 67 73 20 26 20 4d 45 4d  mem1.flags & MEM
cdd0: 5f 44 79 6e 20 29 20 73 71 6c 69 74 65 33 56 64  _Dyn ) sqlite3Vd
cde0: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 65  beMemRelease(&me
cdf0: 6d 31 29 3b 0a 20 20 20 20 69 66 28 20 6d 65 6d  m1);.    if( mem
ce00: 32 2e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 44 79  2.flags & MEM_Dy
ce10: 6e 20 29 20 73 71 6c 69 74 65 33 56 64 62 65 4d  n ) sqlite3VdbeM
ce20: 65 6d 52 65 6c 65 61 73 65 28 26 6d 65 6d 32 29  emRelease(&mem2)
ce30: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 30 20  ;.    if( rc!=0 
ce40: 29 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  ){.      break;.
ce50: 20 20 20 20 7d 0a 20 20 20 20 69 2b 2b 3b 0a 20      }.    i++;. 
ce60: 20 7d 0a 0a 20 20 2f 2a 20 4f 6e 65 20 6f 66 20   }..  /* One of 
ce70: 74 68 65 20 6b 65 79 73 20 72 61 6e 20 6f 75 74  the keys ran out
ce80: 20 6f 66 20 66 69 65 6c 64 73 2c 20 62 75 74 20   of fields, but 
ce90: 61 6c 6c 20 74 68 65 20 66 69 65 6c 64 73 20 75  all the fields u
cea0: 70 20 74 6f 20 74 68 61 74 20 70 6f 69 6e 74 0a  p to that point.
ceb0: 20 20 2a 2a 20 77 65 72 65 20 65 71 75 61 6c 2e    ** were equal.
cec0: 20 49 66 20 74 68 65 20 69 6e 63 72 4b 65 79 20   If the incrKey 
ced0: 66 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68  flag is true, th
cee0: 65 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 6b 65  en the second ke
cef0: 79 20 69 73 0a 20 20 2a 2a 20 74 72 65 61 74 65  y is.  ** treate
cf00: 64 20 61 73 20 6c 61 72 67 65 72 2e 0a 20 20 2a  d as larger..  *
cf10: 2f 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b  /.  if( rc==0 ){
cf20: 0a 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66  .    if( pKeyInf
cf30: 6f 2d 3e 69 6e 63 72 4b 65 79 20 29 7b 0a 20 20  o->incrKey ){.  
cf40: 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20      rc = -1;.   
cf50: 20 7d 65 6c 73 65 20 69 66 28 20 64 31 3c 6e 4b   }else if( d1<nK
cf60: 65 79 31 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ey1 ){.      rc 
cf70: 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69  = 1;.    }else i
cf80: 66 28 20 64 32 3c 6e 4b 65 79 32 20 29 7b 0a 20  f( d2<nKey2 ){. 
cf90: 20 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20       rc = -1;.  
cfa0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70    }.  }..  if( p
cfb0: 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72  KeyInfo->aSortOr
cfc0: 64 65 72 20 26 26 20 69 3c 70 4b 65 79 49 6e 66  der && i<pKeyInf
cfd0: 6f 2d 3e 6e 46 69 65 6c 64 20 26 26 20 70 4b 65  o->nField && pKe
cfe0: 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65  yInfo->aSortOrde
cff0: 72 5b 69 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d  r[i] ){.    rc =
d000: 20 2d 72 63 3b 0a 20 20 7d 0a 0a 20 20 72 65 74   -rc;.  }..  ret
d010: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
d020: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73   The argument is
d030: 20 61 6e 20 69 6e 64 65 78 20 65 6e 74 72 79 20   an index entry 
d040: 63 6f 6d 70 6f 73 65 64 20 75 73 69 6e 67 20 74  composed using t
d050: 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64  he OP_MakeRecord
d060: 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 54 68 65 20   opcode..** The 
d070: 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68  last entry in th
d080: 69 73 20 72 65 63 6f 72 64 20 73 68 6f 75 6c 64  is record should
d090: 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 20 28   be an integer (
d0a0: 73 70 65 63 69 66 69 63 61 6c 6c 79 0a 2a 2a 20  specifically.** 
d0b0: 61 6e 20 69 6e 74 65 67 65 72 20 72 6f 77 69 64  an integer rowid
d0c0: 29 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65  ).  This routine
d0d0: 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d   returns the num
d0e0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 0a  ber of bytes in.
d0f0: 2a 2a 20 74 68 61 74 20 69 6e 74 65 67 65 72 2e  ** that integer.
d100: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
d110: 64 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 69  dbeIdxRowidLen(i
d120: 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75  nt nKey, const u
d130: 38 20 2a 61 4b 65 79 29 7b 0a 20 20 75 33 32 20  8 *aKey){.  u32 
d140: 73 7a 48 64 72 3b 20 20 20 20 20 20 20 20 2f 2a  szHdr;        /*
d150: 20 53 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61   Size of the hea
d160: 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 74 79 70  der */.  u32 typ
d170: 65 52 6f 77 69 64 3b 20 20 20 20 2f 2a 20 53 65  eRowid;    /* Se
d180: 72 69 61 6c 20 74 79 70 65 20 6f 66 20 74 68 65  rial type of the
d190: 20 72 6f 77 69 64 20 2a 2f 0a 0a 20 20 73 71 6c   rowid */..  sql
d1a0: 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28  ite3GetVarint32(
d1b0: 61 4b 65 79 2c 20 26 73 7a 48 64 72 29 3b 0a 20  aKey, &szHdr);. 
d1c0: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
d1d0: 74 33 32 28 26 61 4b 65 79 5b 73 7a 48 64 72 2d  t32(&aKey[szHdr-
d1e0: 31 5d 2c 20 26 74 79 70 65 52 6f 77 69 64 29 3b  1], &typeRowid);
d1f0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
d200: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
d210: 65 6e 28 74 79 70 65 52 6f 77 69 64 29 3b 0a 7d  en(typeRowid);.}
d220: 0a 20 20 0a 0a 2f 2a 0a 2a 2a 20 70 43 75 72 20  .  ../*.** pCur 
d230: 70 6f 69 6e 74 73 20 61 74 20 61 6e 20 69 6e 64  points at an ind
d240: 65 78 20 65 6e 74 72 79 20 63 72 65 61 74 65 64  ex entry created
d250: 20 75 73 69 6e 67 20 74 68 65 20 4f 50 5f 4d 61   using the OP_Ma
d260: 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e  keRecord opcode.
d270: 0a 2a 2a 20 52 65 61 64 20 74 68 65 20 72 6f 77  .** Read the row
d280: 69 64 20 28 74 68 65 20 6c 61 73 74 20 66 69 65  id (the last fie
d290: 6c 64 20 69 6e 20 74 68 65 20 72 65 63 6f 72 64  ld in the record
d2a0: 29 20 61 6e 64 20 73 74 6f 72 65 20 69 74 20 69  ) and store it i
d2b0: 6e 20 2a 72 6f 77 69 64 2e 0a 2a 2a 20 52 65 74  n *rowid..** Ret
d2c0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66  urn SQLITE_OK if
d2d0: 20 65 76 65 72 79 74 68 69 6e 67 20 77 6f 72 6b   everything work
d2e0: 73 2c 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63  s, or an error c
d2f0: 6f 64 65 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a  ode otherwise..*
d300: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
d310: 65 49 64 78 52 6f 77 69 64 28 42 74 43 75 72 73  eIdxRowid(BtCurs
d320: 6f 72 20 2a 70 43 75 72 2c 20 69 36 34 20 2a 72  or *pCur, i64 *r
d330: 6f 77 69 64 29 7b 0a 20 20 69 36 34 20 6e 43 65  owid){.  i64 nCe
d340: 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74 20 72 63 3b  llKey;.  int rc;
d350: 0a 20 20 75 33 32 20 73 7a 48 64 72 3b 20 20 20  .  u32 szHdr;   
d360: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20       /* Size of 
d370: 74 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20  the header */.  
d380: 75 33 32 20 74 79 70 65 52 6f 77 69 64 3b 20 20  u32 typeRowid;  
d390: 20 20 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65    /* Serial type
d3a0: 20 6f 66 20 74 68 65 20 72 6f 77 69 64 20 2a 2f   of the rowid */
d3b0: 0a 20 20 75 33 32 20 6c 65 6e 52 6f 77 69 64 3b  .  u32 lenRowid;
d3c0: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20       /* Size of 
d3d0: 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20 4d  the rowid */.  M
d3e0: 65 6d 20 6d 2c 20 76 3b 0a 0a 20 20 73 71 6c 69  em m, v;..  sqli
d3f0: 74 65 33 42 74 72 65 65 4b 65 79 53 69 7a 65 28  te3BtreeKeySize(
d400: 70 43 75 72 2c 20 26 6e 43 65 6c 6c 4b 65 79 29  pCur, &nCellKey)
d410: 3b 0a 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79  ;.  if( nCellKey
d420: 3c 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  <=0 ){.    retur
d430: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54  n SQLITE_CORRUPT
d440: 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c  ;.  }.  rc = sql
d450: 69 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42  ite3VdbeMemFromB
d460: 74 72 65 65 28 70 43 75 72 2c 20 30 2c 20 6e 43  tree(pCur, 0, nC
d470: 65 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a  ellKey, 1, &m);.
d480: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20    if( rc ){.    
d490: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20  return rc;.  }. 
d4a0: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
d4b0: 74 33 32 28 6d 2e 7a 2c 20 26 73 7a 48 64 72 29  t32(m.z, &szHdr)
d4c0: 3b 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56 61  ;.  sqlite3GetVa
d4d0: 72 69 6e 74 33 32 28 26 6d 2e 7a 5b 73 7a 48 64  rint32(&m.z[szHd
d4e0: 72 2d 31 5d 2c 20 26 74 79 70 65 52 6f 77 69 64  r-1], &typeRowid
d4f0: 29 3b 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20  );.  lenRowid = 
d500: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
d510: 6c 54 79 70 65 4c 65 6e 28 74 79 70 65 52 6f 77  lTypeLen(typeRow
d520: 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  id);.  sqlite3Vd
d530: 62 65 53 65 72 69 61 6c 47 65 74 28 26 6d 2e 7a  beSerialGet(&m.z
d540: 5b 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20  [m.n-lenRowid], 
d550: 74 79 70 65 52 6f 77 69 64 2c 20 26 76 29 3b 0a  typeRowid, &v);.
d560: 20 20 2a 72 6f 77 69 64 20 3d 20 76 2e 69 3b 0a    *rowid = v.i;.
d570: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
d580: 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20 72  Release(&m);.  r
d590: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
d5a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72  .}../*.** Compar
d5b0: 65 20 74 68 65 20 6b 65 79 20 6f 66 20 74 68 65  e the key of the
d5c0: 20 69 6e 64 65 78 20 65 6e 74 72 79 20 74 68 61   index entry tha
d5d0: 74 20 63 75 72 73 6f 72 20 70 43 20 69 73 20 70  t cursor pC is p
d5e0: 6f 69 6e 74 20 74 6f 20 61 67 61 69 6e 73 74 0a  oint to against.
d5f0: 2a 2a 20 74 68 65 20 6b 65 79 20 73 74 72 69 6e  ** the key strin
d600: 67 20 69 6e 20 70 4b 65 79 20 28 6f 66 20 6c 65  g in pKey (of le
d610: 6e 67 74 68 20 6e 4b 65 79 29 2e 20 20 57 72 69  ngth nKey).  Wri
d620: 74 65 20 69 6e 74 6f 20 2a 70 52 65 73 20 61 20  te into *pRes a 
d630: 6e 75 6d 62 65 72 0a 2a 2a 20 74 68 61 74 20 69  number.** that i
d640: 73 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f  s negative, zero
d650: 2c 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 66  , or positive if
d660: 20 70 43 20 69 73 20 6c 65 73 73 20 74 68 61 6e   pC is less than
d670: 2c 20 65 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f  , equal to,.** o
d680: 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 70  r greater than p
d690: 4b 65 79 2e 20 20 52 65 74 75 72 6e 20 53 51 4c  Key.  Return SQL
d6a0: 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73  ITE_OK on succes
d6b0: 73 2e 0a 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69 73  s..**.** pKey is
d6c0: 20 65 69 74 68 65 72 20 63 72 65 61 74 65 64 20   either created 
d6d0: 77 69 74 68 6f 75 74 20 61 20 72 6f 77 69 64 20  without a rowid 
d6e0: 6f 72 20 69 73 20 74 72 75 6e 63 61 74 65 64 20  or is truncated 
d6f0: 73 6f 20 74 68 61 74 20 69 74 0a 2a 2a 20 6f 6d  so that it.** om
d700: 69 74 73 20 74 68 65 20 72 6f 77 69 64 20 61 74  its the rowid at
d710: 20 74 68 65 20 65 6e 64 2e 20 20 54 68 65 20 72   the end.  The r
d720: 6f 77 69 64 20 61 74 20 74 68 65 20 65 6e 64 20  owid at the end 
d730: 6f 66 20 74 68 65 20 69 6e 64 65 78 20 65 6e 74  of the index ent
d740: 72 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64  ry.** is ignored
d750: 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74   as well..*/.int
d760: 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b   sqlite3VdbeIdxK
d770: 65 79 43 6f 6d 70 61 72 65 28 0a 20 20 43 75 72  eyCompare(.  Cur
d780: 73 6f 72 20 2a 70 43 2c 20 20 20 20 20 20 20 20  sor *pC,        
d790: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
d7a0: 63 75 72 73 6f 72 20 74 6f 20 63 6f 6d 70 61 72  cursor to compar
d7b0: 65 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69  e against */.  i
d7c0: 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75  nt nKey, const u
d7d0: 38 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 54 68  8 *pKey,   /* Th
d7e0: 65 20 6b 65 79 20 74 6f 20 63 6f 6d 70 61 72 65  e key to compare
d7f0: 20 2a 2f 0a 20 20 69 6e 74 20 2a 72 65 73 20 20   */.  int *res  
d800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d810: 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63    /* Write the c
d820: 6f 6d 70 61 72 69 73 6f 6e 20 72 65 73 75 6c 74  omparison result
d830: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 36   here */.){.  i6
d840: 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e  4 nCellKey;.  in
d850: 74 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72  t rc;.  BtCursor
d860: 20 2a 70 43 75 72 20 3d 20 70 43 2d 3e 70 43 75   *pCur = pC->pCu
d870: 72 73 6f 72 3b 0a 20 20 69 6e 74 20 6c 65 6e 52  rsor;.  int lenR
d880: 6f 77 69 64 3b 0a 20 20 4d 65 6d 20 6d 3b 0a 0a  owid;.  Mem m;..
d890: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65    sqlite3BtreeKe
d8a0: 79 53 69 7a 65 28 70 43 75 72 2c 20 26 6e 43 65  ySize(pCur, &nCe
d8b0: 6c 6c 4b 65 79 29 3b 0a 20 20 69 66 28 20 6e 43  llKey);.  if( nC
d8c0: 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b 0a 20 20 20  ellKey<=0 ){.   
d8d0: 20 2a 72 65 73 20 3d 20 30 3b 0a 20 20 20 20 72   *res = 0;.    r
d8e0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
d8f0: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69  .  }.  rc = sqli
d900: 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74  te3VdbeMemFromBt
d910: 72 65 65 28 70 43 2d 3e 70 43 75 72 73 6f 72 2c  ree(pC->pCursor,
d920: 20 30 2c 20 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c   0, nCellKey, 1,
d930: 20 26 6d 29 3b 0a 20 20 69 66 28 20 72 63 20 29   &m);.  if( rc )
d940: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  {.    return rc;
d950: 0a 20 20 7d 0a 20 20 6c 65 6e 52 6f 77 69 64 20  .  }.  lenRowid 
d960: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78  = sqlite3VdbeIdx
d970: 52 6f 77 69 64 4c 65 6e 28 6d 2e 6e 2c 20 6d 2e  RowidLen(m.n, m.
d980: 7a 29 3b 0a 20 20 2a 72 65 73 20 3d 20 73 71 6c  z);.  *res = sql
d990: 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f  ite3VdbeRecordCo
d9a0: 6d 70 61 72 65 28 70 43 2d 3e 70 4b 65 79 49 6e  mpare(pC->pKeyIn
d9b0: 66 6f 2c 20 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64  fo, m.n-lenRowid
d9c0: 2c 20 6d 2e 7a 2c 20 6e 4b 65 79 2c 20 70 4b 65  , m.z, nKey, pKe
d9d0: 79 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  y);.  sqlite3Vdb
d9e0: 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 29 3b  eMemRelease(&m);
d9f0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
da00: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  _OK;.}../*.** Th
da10: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20  is routine sets 
da20: 74 68 65 20 76 61 6c 75 65 20 74 6f 20 62 65 20  the value to be 
da30: 72 65 74 75 72 6e 65 64 20 62 79 20 73 75 62 73  returned by subs
da40: 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 6f 0a  equent calls to.
da50: 2a 2a 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67  ** sqlite3_chang
da60: 65 73 28 29 20 6f 6e 20 74 68 65 20 64 61 74 61  es() on the data
da70: 62 61 73 65 20 68 61 6e 64 6c 65 20 27 64 62 27  base handle 'db'
da80: 2e 20 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  . .*/.void sqlit
da90: 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 65 73  e3VdbeSetChanges
daa0: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e  (sqlite3 *db, in
dab0: 74 20 6e 43 68 61 6e 67 65 29 7b 0a 20 20 64 62  t nChange){.  db
dac0: 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 6e 43 68 61  ->nChange = nCha
dad0: 6e 67 65 3b 0a 20 20 64 62 2d 3e 6e 54 6f 74 61  nge;.  db->nTota
dae0: 6c 43 68 61 6e 67 65 20 2b 3d 20 6e 43 68 61 6e  lChange += nChan
daf0: 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  ge;.}../*.** Set
db00: 20 61 20 66 6c 61 67 20 69 6e 20 74 68 65 20 76   a flag in the v
db10: 64 62 65 20 74 6f 20 75 70 64 61 74 65 20 74 68  dbe to update th
db20: 65 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72  e change counter
db30: 20 77 68 65 6e 20 69 74 20 69 73 20 66 69 6e 61   when it is fina
db40: 6c 69 73 65 64 0a 2a 2a 20 6f 72 20 72 65 73 65  lised.** or rese
db50: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
db60: 65 33 56 64 62 65 43 6f 75 6e 74 43 68 61 6e 67  e3VdbeCountChang
db70: 65 73 28 56 64 62 65 20 2a 76 29 7b 0a 20 20 76  es(Vdbe *v){.  v
db80: 2d 3e 63 68 61 6e 67 65 43 6e 74 4f 6e 20 3d 20  ->changeCntOn = 
db90: 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 72 6b  1;.}../*.** Mark
dba0: 20 65 76 65 72 79 20 70 72 65 70 61 72 65 64 20   every prepared 
dbb0: 73 74 61 74 65 6d 65 6e 74 20 61 73 73 6f 63 69  statement associ
dbc0: 61 74 65 64 20 77 69 74 68 20 61 20 64 61 74 61  ated with a data
dbd0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a  base connection.
dbe0: 2a 2a 20 61 73 20 65 78 70 69 72 65 64 2e 0a 2a  ** as expired..*
dbf0: 2a 0a 2a 2a 20 41 6e 20 65 78 70 69 72 65 64 20  *.** An expired 
dc00: 73 74 61 74 65 6d 65 6e 74 20 6d 65 61 6e 73 20  statement means 
dc10: 74 68 61 74 20 72 65 63 6f 6d 70 69 6c 61 74 69  that recompilati
dc20: 6f 6e 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d  on of the statem
dc30: 65 6e 74 20 69 73 0a 2a 2a 20 72 65 63 6f 6d 6d  ent is.** recomm
dc40: 65 6e 64 2e 20 20 53 74 61 74 65 6d 65 6e 74 73  end.  Statements
dc50: 20 65 78 70 69 72 65 20 77 68 65 6e 20 74 68 69   expire when thi
dc60: 6e 67 73 20 68 61 70 70 65 6e 20 74 68 61 74 20  ngs happen that 
dc70: 6d 61 6b 65 20 74 68 65 69 72 0a 2a 2a 20 70 72  make their.** pr
dc80: 6f 67 72 61 6d 73 20 6f 62 73 6f 6c 65 74 65 2e  ograms obsolete.
dc90: 20 20 52 65 6d 6f 76 69 6e 67 20 75 73 65 72 2d    Removing user-
dca0: 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e  defined function
dcb0: 73 20 6f 72 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a  s or collating.*
dcc0: 2a 20 73 65 71 75 65 6e 63 65 73 2c 20 6f 72 20  * sequences, or 
dcd0: 63 68 61 6e 67 69 6e 67 20 61 6e 20 61 75 74 68  changing an auth
dce0: 6f 72 69 7a 61 74 69 6f 6e 20 66 75 6e 63 74 69  orization functi
dcf0: 6f 6e 20 61 72 65 20 74 68 65 20 74 79 70 65 73  on are the types
dd00: 20 6f 66 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68   of.** things th
dd10: 61 74 20 6d 61 6b 65 20 70 72 65 70 61 72 65 64  at make prepared
dd20: 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 62 73 6f   statements obso
dd30: 6c 65 74 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  lete..*/.void sq
dd40: 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61  lite3ExpirePrepa
dd50: 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 73 71  redStatements(sq
dd60: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 56 64  lite3 *db){.  Vd
dd70: 62 65 20 2a 70 3b 0a 20 20 66 6f 72 28 70 20 3d  be *p;.  for(p =
dd80: 20 64 62 2d 3e 70 56 64 62 65 3b 20 70 3b 20 70   db->pVdbe; p; p
dd90: 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20  =p->pNext){.    
dda0: 70 2d 3e 65 78 70 69 72 65 64 20 3d 20 31 3b 0a  p->expired = 1;.
ddb0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74    }.}../*.** Ret
ddc0: 75 72 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  urn the database
ddd0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
dde0: 20 74 68 65 20 56 64 62 65 2e 0a 2a 2f 0a 73 71   the Vdbe..*/.sq
ddf0: 6c 69 74 65 33 20 2a 73 71 6c 69 74 65 33 56 64  lite3 *sqlite3Vd
de00: 62 65 44 62 28 56 64 62 65 20 2a 76 29 7b 0a 20  beDb(Vdbe *v){. 
de10: 20 72 65 74 75 72 6e 20 76 2d 3e 64 62 3b 0a 7d   return v->db;.}
de20: 0a                                               .