/ Hex Artifact Content
Login

Artifact b28883d9efc9d4c1ec26c0d2473d5d8febc8178e:


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 6e 64 65  tream..*/.#ifnde
03c0: 66 20 4e 44 45 42 55 47 0a 69 6e 74 20 73 71 6c  f NDEBUG.int sql
03d0: 69 74 65 33 5f 76 64 62 65 5f 61 64 64 6f 70 5f  ite3_vdbe_addop_
03e0: 74 72 61 63 65 20 3d 20 30 3b 0a 23 65 6e 64 69  trace = 0;.#endi
03f0: 66 0a 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65  f.../*.** Create
0400: 20 61 20 6e 65 77 20 76 69 72 74 75 61 6c 20 64   a new virtual d
0410: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 2e 0a  atabase engine..
0420: 2a 2f 0a 56 64 62 65 20 2a 73 71 6c 69 74 65 33  */.Vdbe *sqlite3
0430: 56 64 62 65 43 72 65 61 74 65 28 73 71 6c 69 74  VdbeCreate(sqlit
0440: 65 33 20 2a 64 62 29 7b 0a 20 20 56 64 62 65 20  e3 *db){.  Vdbe 
0450: 2a 70 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65  *p;.  p = sqlite
0460: 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 56  Malloc( sizeof(V
0470: 64 62 65 29 20 29 3b 0a 20 20 69 66 28 20 70 3d  dbe) );.  if( p=
0480: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
0490: 20 70 2d 3e 64 62 20 3d 20 64 62 3b 0a 20 20 69   p->db = db;.  i
04a0: 66 28 20 64 62 2d 3e 70 56 64 62 65 20 29 7b 0a  f( db->pVdbe ){.
04b0: 20 20 20 20 64 62 2d 3e 70 56 64 62 65 2d 3e 70      db->pVdbe->p
04c0: 50 72 65 76 20 3d 20 70 3b 0a 20 20 7d 0a 20 20  Prev = p;.  }.  
04d0: 70 2d 3e 70 4e 65 78 74 20 3d 20 64 62 2d 3e 70  p->pNext = db->p
04e0: 56 64 62 65 3b 0a 20 20 70 2d 3e 70 50 72 65 76  Vdbe;.  p->pPrev
04f0: 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 70 56 64 62   = 0;.  db->pVdb
0500: 65 20 3d 20 70 3b 0a 20 20 70 2d 3e 6d 61 67 69  e = p;.  p->magi
0510: 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  c = VDBE_MAGIC_I
0520: 4e 49 54 3b 0a 20 20 72 65 74 75 72 6e 20 70 3b  NIT;.  return p;
0530: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 75 72 6e 20 74  .}../*.** Turn t
0540: 72 61 63 69 6e 67 20 6f 6e 20 6f 72 20 6f 66 66  racing on or off
0550: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
0560: 56 64 62 65 54 72 61 63 65 28 56 64 62 65 20 2a  VdbeTrace(Vdbe *
0570: 70 2c 20 46 49 4c 45 20 2a 74 72 61 63 65 29 7b  p, FILE *trace){
0580: 0a 20 20 70 2d 3e 74 72 61 63 65 20 3d 20 74 72  .  p->trace = tr
0590: 61 63 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  ace;.}../*.** Re
05a0: 73 69 7a 65 20 74 68 65 20 56 64 62 65 2e 61 4f  size the Vdbe.aO
05b0: 70 20 61 72 72 61 79 20 73 6f 20 74 68 61 74 20  p array so that 
05c0: 69 74 20 63 6f 6e 74 61 69 6e 73 20 61 74 20 6c  it contains at l
05d0: 65 61 73 74 20 4e 0a 2a 2a 20 65 6c 65 6d 65 6e  east N.** elemen
05e0: 74 73 2e 20 49 66 20 74 68 65 20 56 64 62 65 20  ts. If the Vdbe 
05f0: 69 73 20 69 6e 20 56 44 42 45 5f 4d 41 47 49 43  is in VDBE_MAGIC
0600: 5f 52 55 4e 20 73 74 61 74 65 2c 20 74 68 65 6e  _RUN state, then
0610: 0a 2a 2a 20 74 68 65 20 56 64 62 65 2e 61 4f 70  .** the Vdbe.aOp
0620: 20 61 72 72 61 79 20 77 69 6c 6c 20 62 65 20 73   array will be s
0630: 69 7a 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20  ized to contain 
0640: 65 78 61 63 74 6c 79 20 4e 20 0a 2a 2a 20 65 6c  exactly N .** el
0650: 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 73 74 61 74 69  ements..*/.stati
0660: 63 20 76 6f 69 64 20 72 65 73 69 7a 65 4f 70 41  c void resizeOpA
0670: 72 72 61 79 28 56 64 62 65 20 2a 70 2c 20 69 6e  rray(Vdbe *p, in
0680: 74 20 4e 29 7b 0a 20 20 69 66 28 20 70 2d 3e 6d  t N){.  if( p->m
0690: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
06a0: 5f 52 55 4e 20 29 7b 0a 20 20 20 20 61 73 73 65  _RUN ){.    asse
06b0: 72 74 28 20 4e 3d 3d 70 2d 3e 6e 4f 70 20 29 3b  rt( N==p->nOp );
06c0: 0a 20 20 20 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63  .    p->nOpAlloc
06d0: 20 3d 20 4e 3b 0a 20 20 20 20 70 2d 3e 61 4f 70   = N;.    p->aOp
06e0: 20 3d 20 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63   = sqliteRealloc
06f0: 28 70 2d 3e 61 4f 70 2c 20 4e 2a 73 69 7a 65 6f  (p->aOp, N*sizeo
0700: 66 28 4f 70 29 29 3b 0a 20 20 7d 65 6c 73 65 20  f(Op));.  }else 
0710: 69 66 28 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 3c  if( p->nOpAlloc<
0720: 4e 20 29 7b 0a 20 20 20 20 69 6e 74 20 6f 6c 64  N ){.    int old
0730: 53 69 7a 65 20 3d 20 70 2d 3e 6e 4f 70 41 6c 6c  Size = p->nOpAll
0740: 6f 63 3b 0a 20 20 20 20 70 2d 3e 6e 4f 70 41 6c  oc;.    p->nOpAl
0750: 6c 6f 63 20 3d 20 4e 2b 31 30 30 3b 0a 20 20 20  loc = N+100;.   
0760: 20 70 2d 3e 61 4f 70 20 3d 20 73 71 6c 69 74 65   p->aOp = sqlite
0770: 52 65 61 6c 6c 6f 63 28 70 2d 3e 61 4f 70 2c 20  Realloc(p->aOp, 
0780: 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 2a 73 69 7a 65  p->nOpAlloc*size
0790: 6f 66 28 4f 70 29 29 3b 0a 20 20 20 20 69 66 28  of(Op));.    if(
07a0: 20 70 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 20   p->aOp ){.     
07b0: 20 6d 65 6d 73 65 74 28 26 70 2d 3e 61 4f 70 5b   memset(&p->aOp[
07c0: 6f 6c 64 53 69 7a 65 5d 2c 20 30 2c 20 28 70 2d  oldSize], 0, (p-
07d0: 3e 6e 4f 70 41 6c 6c 6f 63 2d 6f 6c 64 53 69 7a  >nOpAlloc-oldSiz
07e0: 65 29 2a 73 69 7a 65 6f 66 28 4f 70 29 29 3b 0a  e)*sizeof(Op));.
07f0: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a      }.  }.}../*.
0800: 2a 2a 20 41 64 64 20 61 20 6e 65 77 20 69 6e 73  ** Add a new ins
0810: 74 72 75 63 74 69 6f 6e 20 74 6f 20 74 68 65 20  truction to the 
0820: 6c 69 73 74 20 6f 66 20 69 6e 73 74 72 75 63 74  list of instruct
0830: 69 6f 6e 73 20 63 75 72 72 65 6e 74 20 69 6e 20  ions current in 
0840: 74 68 65 0a 2a 2a 20 56 44 42 45 2e 20 20 52 65  the.** VDBE.  Re
0850: 74 75 72 6e 20 74 68 65 20 61 64 64 72 65 73 73  turn the address
0860: 20 6f 66 20 74 68 65 20 6e 65 77 20 69 6e 73 74   of the new inst
0870: 72 75 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50  ruction..**.** P
0880: 61 72 61 6d 65 74 65 72 73 3a 0a 2a 2a 0a 2a 2a  arameters:.**.**
0890: 20 20 20 20 70 20 20 20 20 20 20 20 20 20 20 20      p           
08a0: 20 20 20 20 50 6f 69 6e 74 65 72 20 74 6f 20 74      Pointer to t
08b0: 68 65 20 56 44 42 45 0a 2a 2a 0a 2a 2a 20 20 20  he VDBE.**.**   
08c0: 20 6f 70 20 20 20 20 20 20 20 20 20 20 20 20 20   op             
08d0: 20 54 68 65 20 6f 70 63 6f 64 65 20 66 6f 72 20   The opcode for 
08e0: 74 68 69 73 20 69 6e 73 74 72 75 63 74 69 6f 6e  this instruction
08f0: 0a 2a 2a 0a 2a 2a 20 20 20 20 70 31 2c 20 70 32  .**.**    p1, p2
0900: 20 20 20 20 20 20 20 20 20 20 46 69 72 73 74 20            First 
0910: 74 77 6f 20 6f 66 20 74 68 65 20 74 68 72 65 65  two of the three
0920: 20 70 6f 73 73 69 62 6c 65 20 6f 70 65 72 61 6e   possible operan
0930: 64 73 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68  ds..**.** Use th
0940: 65 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73  e sqlite3VdbeRes
0950: 6f 6c 76 65 4c 61 62 65 6c 28 29 20 66 75 6e 63  olveLabel() func
0960: 74 69 6f 6e 20 74 6f 20 66 69 78 20 61 6e 20 61  tion to fix an a
0970: 64 64 72 65 73 73 20 61 6e 64 0a 2a 2a 20 74 68  ddress and.** th
0980: 65 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61  e sqlite3VdbeCha
0990: 6e 67 65 50 33 28 29 20 66 75 6e 63 74 69 6f 6e  ngeP3() function
09a0: 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 76   to change the v
09b0: 61 6c 75 65 20 6f 66 20 74 68 65 20 50 33 0a 2a  alue of the P3.*
09c0: 2a 20 6f 70 65 72 61 6e 64 2e 0a 2a 2f 0a 69 6e  * operand..*/.in
09d0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64  t sqlite3VdbeAdd
09e0: 4f 70 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20  Op(Vdbe *p, int 
09f0: 6f 70 2c 20 69 6e 74 20 70 31 2c 20 69 6e 74 20  op, int p1, int 
0a00: 70 32 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  p2){.  int i;.  
0a10: 56 64 62 65 4f 70 20 2a 70 4f 70 3b 0a 0a 20 20  VdbeOp *pOp;..  
0a20: 69 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 70 2d  i = p->nOp;.  p-
0a30: 3e 6e 4f 70 2b 2b 3b 0a 20 20 61 73 73 65 72 74  >nOp++;.  assert
0a40: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
0a50: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
0a60: 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70   resizeOpArray(p
0a70: 2c 20 69 2b 31 29 3b 0a 20 20 69 66 28 20 70 2d  , i+1);.  if( p-
0a80: 3e 61 4f 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72  >aOp==0 ){.    r
0a90: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 70  eturn 0;.  }.  p
0aa0: 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b  Op = &p->aOp[i];
0ab0: 0a 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d  .  pOp->opcode =
0ac0: 20 6f 70 3b 0a 20 20 70 4f 70 2d 3e 70 31 20 3d   op;.  pOp->p1 =
0ad0: 20 70 31 3b 0a 20 20 70 4f 70 2d 3e 70 32 20 3d   p1;.  pOp->p2 =
0ae0: 20 70 32 3b 0a 20 20 70 4f 70 2d 3e 70 33 20 3d   p2;.  pOp->p3 =
0af0: 20 30 3b 0a 20 20 70 4f 70 2d 3e 70 33 74 79 70   0;.  pOp->p3typ
0b00: 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a  e = P3_NOTUSED;.
0b10: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
0b20: 42 55 47 0a 20 20 69 66 28 20 73 71 6c 69 74 65  BUG.  if( sqlite
0b30: 33 5f 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61  3_vdbe_addop_tra
0b40: 63 65 20 29 20 73 71 6c 69 74 65 33 56 64 62 65  ce ) sqlite3Vdbe
0b50: 50 72 69 6e 74 4f 70 28 30 2c 20 69 2c 20 26 70  PrintOp(0, i, &p
0b60: 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 23 65 6e 64 69  ->aOp[i]);.#endi
0b70: 66 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d 0a  f.  return i;.}.
0b80: 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 6e 20 6f 70  ./*.** Add an op
0b90: 63 6f 64 65 20 74 68 61 74 20 69 6e 63 6c 75 64  code that includ
0ba0: 65 73 20 74 68 65 20 70 33 20 76 61 6c 75 65 2e  es the p3 value.
0bb0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
0bc0: 64 62 65 4f 70 33 28 56 64 62 65 20 2a 70 2c 20  dbeOp3(Vdbe *p, 
0bd0: 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c 20  int op, int p1, 
0be0: 69 6e 74 20 70 32 2c 20 63 6f 6e 73 74 20 63 68  int p2, const ch
0bf0: 61 72 20 2a 7a 50 33 2c 69 6e 74 20 70 33 74 79  ar *zP3,int p3ty
0c00: 70 65 29 7b 0a 20 20 69 6e 74 20 61 64 64 72 20  pe){.  int addr 
0c10: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64  = sqlite3VdbeAdd
0c20: 4f 70 28 70 2c 20 6f 70 2c 20 70 31 2c 20 70 32  Op(p, op, p1, p2
0c30: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
0c40: 43 68 61 6e 67 65 50 33 28 70 2c 20 61 64 64 72  ChangeP3(p, addr
0c50: 2c 20 7a 50 33 2c 20 70 33 74 79 70 65 29 3b 0a  , zP3, p3type);.
0c60: 20 20 72 65 74 75 72 6e 20 61 64 64 72 3b 0a 7d    return addr;.}
0c70: 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61  ../*.** Create a
0c80: 20 6e 65 77 20 73 79 6d 62 6f 6c 69 63 20 6c 61   new symbolic la
0c90: 62 65 6c 20 66 6f 72 20 61 6e 20 69 6e 73 74 72  bel for an instr
0ca0: 75 63 74 69 6f 6e 20 74 68 61 74 20 68 61 73 20  uction that has 
0cb0: 79 65 74 20 74 6f 20 62 65 0a 2a 2a 20 63 6f 64  yet to be.** cod
0cc0: 65 64 2e 20 20 54 68 65 20 73 79 6d 62 6f 6c 69  ed.  The symboli
0cd0: 63 20 6c 61 62 65 6c 20 69 73 20 72 65 61 6c 6c  c label is reall
0ce0: 79 20 6a 75 73 74 20 61 20 6e 65 67 61 74 69 76  y just a negativ
0cf0: 65 20 6e 75 6d 62 65 72 2e 20 20 54 68 65 0a 2a  e number.  The.*
0d00: 2a 20 6c 61 62 65 6c 20 63 61 6e 20 62 65 20 75  * label can be u
0d10: 73 65 64 20 61 73 20 74 68 65 20 50 32 20 76 61  sed as the P2 va
0d20: 6c 75 65 20 6f 66 20 61 6e 20 6f 70 65 72 61 74  lue of an operat
0d30: 69 6f 6e 2e 20 20 4c 61 74 65 72 2c 20 77 68 65  ion.  Later, whe
0d40: 6e 0a 2a 2a 20 74 68 65 20 6c 61 62 65 6c 20 69  n.** the label i
0d50: 73 20 72 65 73 6f 6c 76 65 64 20 74 6f 20 61 20  s resolved to a 
0d60: 73 70 65 63 69 66 69 63 20 61 64 64 72 65 73 73  specific address
0d70: 2c 20 74 68 65 20 56 44 42 45 20 77 69 6c 6c 20  , the VDBE will 
0d80: 73 63 61 6e 0a 2a 2a 20 74 68 72 6f 75 67 68 20  scan.** through 
0d90: 69 74 73 20 6f 70 65 72 61 74 69 6f 6e 20 6c 69  its operation li
0da0: 73 74 20 61 6e 64 20 63 68 61 6e 67 65 20 61 6c  st and change al
0db0: 6c 20 76 61 6c 75 65 73 20 6f 66 20 50 32 20 77  l values of P2 w
0dc0: 68 69 63 68 20 6d 61 74 63 68 0a 2a 2a 20 74 68  hich match.** th
0dd0: 65 20 6c 61 62 65 6c 20 69 6e 74 6f 20 74 68 65  e label into the
0de0: 20 72 65 73 6f 6c 76 65 64 20 61 64 64 72 65 73   resolved addres
0df0: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 56 44 42  s..**.** The VDB
0e00: 45 20 6b 6e 6f 77 73 20 74 68 61 74 20 61 20 50  E knows that a P
0e10: 32 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62  2 value is a lab
0e20: 65 6c 20 62 65 63 61 75 73 65 20 6c 61 62 65 6c  el because label
0e30: 73 20 61 72 65 0a 2a 2a 20 61 6c 77 61 79 73 20  s are.** always 
0e40: 6e 65 67 61 74 69 76 65 20 61 6e 64 20 50 32 20  negative and P2 
0e50: 76 61 6c 75 65 73 20 61 72 65 20 73 75 70 70 6f  values are suppo
0e60: 73 65 20 74 6f 20 62 65 20 6e 6f 6e 2d 6e 65 67  se to be non-neg
0e70: 61 74 69 76 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c  ative..** Hence,
0e80: 20 61 20 6e 65 67 61 74 69 76 65 20 50 32 20 76   a negative P2 v
0e90: 61 6c 75 65 20 69 73 20 61 20 6c 61 62 65 6c 20  alue is a label 
0ea0: 74 68 61 74 20 68 61 73 20 79 65 74 20 74 6f 20  that has yet to 
0eb0: 62 65 20 72 65 73 6f 6c 76 65 64 2e 0a 2a 2a 0a  be resolved..**.
0ec0: 2a 2a 20 5a 65 72 6f 20 69 73 20 72 65 74 75 72  ** Zero is retur
0ed0: 6e 65 64 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28  ned if a malloc(
0ee0: 29 20 66 61 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20  ) fails..*/.int 
0ef0: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c  sqlite3VdbeMakeL
0f00: 61 62 65 6c 28 56 64 62 65 20 2a 70 29 7b 0a 20  abel(Vdbe *p){. 
0f10: 20 69 6e 74 20 69 3b 0a 20 20 69 20 3d 20 70 2d   int i;.  i = p-
0f20: 3e 6e 4c 61 62 65 6c 2b 2b 3b 0a 20 20 61 73 73  >nLabel++;.  ass
0f30: 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  ert( p->magic==V
0f40: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29  DBE_MAGIC_INIT )
0f50: 3b 0a 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4c  ;.  if( i>=p->nL
0f60: 61 62 65 6c 41 6c 6c 6f 63 20 29 7b 0a 20 20 20  abelAlloc ){.   
0f70: 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20   p->nLabelAlloc 
0f80: 3d 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63  = p->nLabelAlloc
0f90: 2a 32 20 2b 20 31 30 3b 0a 20 20 20 20 70 2d 3e  *2 + 10;.    p->
0fa0: 61 4c 61 62 65 6c 20 3d 20 73 71 6c 69 74 65 52  aLabel = sqliteR
0fb0: 65 61 6c 6c 6f 63 28 20 70 2d 3e 61 4c 61 62 65  ealloc( p->aLabe
0fc0: 6c 2c 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f  l, p->nLabelAllo
0fd0: 63 2a 73 69 7a 65 6f 66 28 70 2d 3e 61 4c 61 62  c*sizeof(p->aLab
0fe0: 65 6c 5b 30 5d 29 29 3b 0a 20 20 7d 0a 20 20 69  el[0]));.  }.  i
0ff0: 66 28 20 70 2d 3e 61 4c 61 62 65 6c 20 29 7b 0a  f( p->aLabel ){.
1000: 20 20 20 20 70 2d 3e 61 4c 61 62 65 6c 5b 69 5d      p->aLabel[i]
1010: 20 3d 20 2d 31 3b 0a 20 20 7d 0a 20 20 72 65 74   = -1;.  }.  ret
1020: 75 72 6e 20 2d 31 2d 69 3b 0a 7d 0a 0a 2f 2a 0a  urn -1-i;.}../*.
1030: 2a 2a 20 52 65 73 6f 6c 76 65 20 6c 61 62 65 6c  ** Resolve label
1040: 20 22 78 22 20 74 6f 20 62 65 20 74 68 65 20 61   "x" to be the a
1050: 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65  ddress of the ne
1060: 78 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74  xt instruction t
1070: 6f 0a 2a 2a 20 62 65 20 69 6e 73 65 72 74 65 64  o.** be inserted
1080: 2e 20 20 54 68 65 20 70 61 72 61 6d 65 74 65 72  .  The parameter
1090: 20 22 78 22 20 6d 75 73 74 20 68 61 76 65 20 62   "x" must have b
10a0: 65 65 6e 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  een obtained fro
10b0: 6d 0a 2a 2a 20 61 20 70 72 69 6f 72 20 63 61 6c  m.** a prior cal
10c0: 6c 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65  l to sqlite3Vdbe
10d0: 4d 61 6b 65 4c 61 62 65 6c 28 29 2e 0a 2a 2f 0a  MakeLabel()..*/.
10e0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
10f0: 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62  ResolveLabel(Vdb
1100: 65 20 2a 70 2c 20 69 6e 74 20 78 29 7b 0a 20 20  e *p, int x){.  
1110: 69 6e 74 20 6a 20 3d 20 2d 31 2d 78 3b 0a 20 20  int j = -1-x;.  
1120: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
1130: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
1140: 54 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6a  T );.  assert( j
1150: 3e 3d 30 20 26 26 20 6a 3c 70 2d 3e 6e 4c 61 62  >=0 && j<p->nLab
1160: 65 6c 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61  el );.  if( p->a
1170: 4c 61 62 65 6c 20 29 7b 0a 20 20 20 20 70 2d 3e  Label ){.    p->
1180: 61 4c 61 62 65 6c 5b 6a 5d 20 3d 20 70 2d 3e 6e  aLabel[j] = p->n
1190: 4f 70 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  Op;.  }.}../*.**
11a0: 20 52 65 74 75 72 6e 20 6e 6f 6e 2d 7a 65 72 6f   Return non-zero
11b0: 20 69 66 20 6f 70 63 6f 64 65 20 27 6f 70 27 20   if opcode 'op' 
11c0: 69 73 20 67 75 61 72 65 6e 74 65 65 64 20 6e 6f  is guarenteed no
11d0: 74 20 74 6f 20 70 75 73 68 20 6d 6f 72 65 20 76  t to push more v
11e0: 61 6c 75 65 73 0a 2a 2a 20 6f 6e 74 6f 20 74 68  alues.** onto th
11f0: 65 20 56 44 42 45 20 73 74 61 63 6b 20 74 68 61  e VDBE stack tha
1200: 6e 20 69 74 20 70 6f 70 73 20 6f 66 66 2e 0a 2a  n it pops off..*
1210: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6f 70 63  /.static int opc
1220: 6f 64 65 55 73 65 73 53 74 61 63 6b 28 75 38 20  odeUsesStack(u8 
1230: 6f 70 29 7b 0a 20 20 2f 2a 20 54 68 65 20 31 30  op){.  /* The 10
1240: 20 53 54 41 43 4b 5f 4d 41 53 4b 5f 6e 20 63 6f   STACK_MASK_n co
1250: 6e 73 74 61 6e 74 73 20 61 72 65 20 64 65 66 69  nstants are defi
1260: 6e 65 64 20 69 6e 20 74 68 65 20 61 75 74 6f 6d  ned in the autom
1270: 61 74 69 63 61 6c 6c 79 0a 20 20 2a 2a 20 67 65  atically.  ** ge
1280: 6e 65 72 61 74 65 64 20 68 65 61 64 65 72 20 66  nerated header f
1290: 69 6c 65 20 6f 70 63 6f 64 65 73 2e 68 2e 20 45  ile opcodes.h. E
12a0: 61 63 68 20 69 73 20 61 20 31 36 2d 62 69 74 20  ach is a 16-bit 
12b0: 62 69 74 6d 61 73 6b 2c 20 6f 6e 65 0a 20 20 2a  bitmask, one.  *
12c0: 2a 20 62 69 74 20 63 6f 72 72 65 73 70 6f 6e 64  * bit correspond
12d0: 69 6e 67 20 74 6f 20 65 61 63 68 20 6f 70 63 6f  ing to each opco
12e0: 64 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62  de implemented b
12f0: 79 20 74 68 65 20 76 69 72 74 75 61 6c 0a 20 20  y the virtual.  
1300: 2a 2a 20 6d 61 63 68 69 6e 65 20 69 6e 20 76 64  ** machine in vd
1310: 62 65 2e 63 2e 20 54 68 65 20 62 69 74 20 69 73  be.c. The bit is
1320: 20 74 72 75 65 20 69 66 20 74 68 65 20 77 6f 72   true if the wor
1330: 64 20 22 73 74 61 63 6b 22 20 61 70 70 65 61 72  d "stack" appear
1340: 73 0a 20 20 2a 2a 20 69 6e 20 61 20 63 6f 6d 6d  s.  ** in a comm
1350: 65 6e 74 20 6f 6e 20 74 68 65 20 73 61 6d 65 20  ent on the same 
1360: 6c 69 6e 65 20 61 73 20 74 68 65 20 22 63 61 73  line as the "cas
1370: 65 20 4f 50 5f 58 58 58 3a 22 20 69 6e 20 0a 20  e OP_XXX:" in . 
1380: 20 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 45   ** sqlite3VdbeE
1390: 78 65 63 28 29 20 69 6e 20 76 64 62 65 2e 63 2e  xec() in vdbe.c.
13a0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 74 68  .  **.  ** If th
13b0: 65 20 62 69 74 20 69 73 20 74 72 75 65 2c 20 74  e bit is true, t
13c0: 68 65 6e 20 74 68 65 20 63 6f 72 72 65 73 70 6f  hen the correspo
13d0: 6e 64 69 6e 67 20 6f 70 63 6f 64 65 20 69 73 20  nding opcode is 
13e0: 67 75 61 72 65 6e 74 65 65 64 20 6e 6f 74 0a 20  guarenteed not. 
13f0: 20 2a 2a 20 74 6f 20 67 72 6f 77 20 74 68 65 20   ** to grow the 
1400: 73 74 61 63 6b 20 77 68 65 6e 20 69 74 20 69 73  stack when it is
1410: 20 65 78 65 63 75 74 65 64 2e 20 4f 74 68 65 72   executed. Other
1420: 77 69 73 65 2c 20 69 74 20 6d 61 79 20 67 72 6f  wise, it may gro
1430: 77 20 74 68 65 0a 20 20 2a 2a 20 73 74 61 63 6b  w the.  ** stack
1440: 20 62 79 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20   by at most one 
1450: 65 6e 74 72 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  entry..  **.  **
1460: 20 53 54 41 43 4b 5f 4d 41 53 4b 5f 30 20 63 6f   STACK_MASK_0 co
1470: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 6f 70 63  rresponds to opc
1480: 6f 64 65 73 20 30 20 74 6f 20 31 35 2e 20 53 54  odes 0 to 15. ST
1490: 41 43 4b 5f 4d 41 53 4b 5f 31 20 63 6f 6e 74 61  ACK_MASK_1 conta
14a0: 69 6e 73 0a 20 20 2a 2a 20 6f 6e 65 20 62 69 74  ins.  ** one bit
14b0: 20 66 6f 72 20 6f 70 63 6f 64 65 73 20 31 36 20   for opcodes 16 
14c0: 74 6f 20 33 31 2c 20 61 6e 64 20 73 6f 20 6f 6e  to 31, and so on
14d0: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 31 36 2d 62  ..  **.  ** 16-b
14e0: 69 74 20 62 69 74 6d 61 73 6b 73 20 28 72 61 74  it bitmasks (rat
14f0: 68 65 72 20 74 68 61 6e 20 33 32 2d 62 69 74 29  her than 32-bit)
1500: 20 61 72 65 20 73 70 65 63 69 66 69 65 64 20 69   are specified i
1510: 6e 20 6f 70 63 6f 64 65 73 2e 68 20 0a 20 20 2a  n opcodes.h .  *
1520: 2a 20 62 65 63 61 75 73 65 20 74 68 65 20 66 69  * because the fi
1530: 6c 65 20 69 73 20 67 65 6e 65 72 61 74 65 64 20  le is generated 
1540: 62 79 20 61 6e 20 61 77 6b 20 70 72 6f 67 72 61  by an awk progra
1550: 6d 2e 20 41 77 6b 20 6d 61 6e 69 70 75 6c 61 74  m. Awk manipulat
1560: 65 73 0a 20 20 2a 2a 20 61 6c 6c 20 6e 75 6d 62  es.  ** all numb
1570: 65 72 73 20 61 73 20 66 6c 6f 61 74 69 6e 67 2d  ers as floating-
1580: 70 6f 69 6e 74 20 61 6e 64 20 77 65 20 64 6f 6e  point and we don
1590: 27 74 20 77 61 6e 74 20 74 6f 20 72 69 73 6b 20  't want to risk 
15a0: 61 20 72 6f 75 6e 64 69 6e 67 0a 20 20 2a 2a 20  a rounding.  ** 
15b0: 65 72 72 6f 72 20 69 66 20 73 6f 6d 65 6f 6e 65  error if someone
15c0: 20 62 75 69 6c 64 73 20 77 69 74 68 20 61 6e 20   builds with an 
15d0: 61 77 6b 20 74 68 61 74 20 75 73 65 73 20 28 66  awk that uses (f
15e0: 6f 72 20 65 78 61 6d 70 6c 65 29 20 33 32 2d 62  or example) 32-b
15f0: 69 74 20 0a 20 20 2a 2a 20 49 45 45 45 20 66 6c  it .  ** IEEE fl
1600: 6f 61 74 73 2e 0a 20 20 2a 2f 20 0a 20 20 73 74  oats..  */ .  st
1610: 61 74 69 63 20 75 33 32 20 6d 61 73 6b 73 5b 35  atic u32 masks[5
1620: 5d 20 3d 20 7b 0a 20 20 20 20 53 54 41 43 4b 5f  ] = {.    STACK_
1630: 4d 41 53 4b 5f 30 20 2b 20 28 53 54 41 43 4b 5f  MASK_0 + (STACK_
1640: 4d 41 53 4b 5f 31 3c 3c 31 36 29 2c 0a 20 20 20  MASK_1<<16),.   
1650: 20 53 54 41 43 4b 5f 4d 41 53 4b 5f 32 20 2b 20   STACK_MASK_2 + 
1660: 28 53 54 41 43 4b 5f 4d 41 53 4b 5f 33 3c 3c 31  (STACK_MASK_3<<1
1670: 36 29 2c 0a 20 20 20 20 53 54 41 43 4b 5f 4d 41  6),.    STACK_MA
1680: 53 4b 5f 34 20 2b 20 28 53 54 41 43 4b 5f 4d 41  SK_4 + (STACK_MA
1690: 53 4b 5f 35 3c 3c 31 36 29 2c 0a 20 20 20 20 53  SK_5<<16),.    S
16a0: 54 41 43 4b 5f 4d 41 53 4b 5f 36 20 2b 20 28 53  TACK_MASK_6 + (S
16b0: 54 41 43 4b 5f 4d 41 53 4b 5f 37 3c 3c 31 36 29  TACK_MASK_7<<16)
16c0: 2c 0a 20 20 20 20 53 54 41 43 4b 5f 4d 41 53 4b  ,.    STACK_MASK
16d0: 5f 38 20 2b 20 28 53 54 41 43 4b 5f 4d 41 53 4b  _8 + (STACK_MASK
16e0: 5f 39 3c 3c 31 36 29 0a 20 20 7d 3b 0a 20 20 72  _9<<16).  };.  r
16f0: 65 74 75 72 6e 20 28 6d 61 73 6b 73 5b 6f 70 3e  eturn (masks[op>
1700: 3e 35 5d 20 26 20 28 31 3c 3c 28 6f 70 26 30 78  >5] & (1<<(op&0x
1710: 31 46 29 29 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65  1F)));.}..#ifnde
1720: 66 20 4e 44 45 42 55 47 0a 69 6e 74 20 73 71 6c  f NDEBUG.int sql
1730: 69 74 65 33 56 64 62 65 4f 70 63 6f 64 65 55 73  ite3VdbeOpcodeUs
1740: 65 73 53 74 61 63 6b 28 75 38 20 6f 70 29 7b 0a  esStack(u8 op){.
1750: 20 20 72 65 74 75 72 6e 20 6f 70 63 6f 64 65 55    return opcodeU
1760: 73 65 73 53 74 61 63 6b 28 6f 70 29 3b 0a 7d 0a  sesStack(op);.}.
1770: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4c 6f  #endif../*.** Lo
1780: 6f 70 20 74 68 72 6f 75 67 68 20 74 68 65 20 70  op through the p
1790: 72 6f 67 72 61 6d 20 6c 6f 6f 6b 69 6e 67 20 66  rogram looking f
17a0: 6f 72 20 50 32 20 76 61 6c 75 65 73 20 74 68 61  or P2 values tha
17b0: 74 20 61 72 65 20 6e 65 67 61 74 69 76 65 2e 0a  t are negative..
17c0: 2a 2a 20 45 61 63 68 20 73 75 63 68 20 76 61 6c  ** Each such val
17d0: 75 65 20 69 73 20 61 20 6c 61 62 65 6c 2e 20 20  ue is a label.  
17e0: 52 65 73 6f 6c 76 65 20 74 68 65 20 6c 61 62 65  Resolve the labe
17f0: 6c 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65  l by setting the
1800: 20 50 32 0a 2a 2a 20 76 61 6c 75 65 20 74 6f 20   P2.** value to 
1810: 69 74 73 20 63 6f 72 72 65 63 74 20 6e 6f 6e 2d  its correct non-
1820: 7a 65 72 6f 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a  zero value..**.*
1830: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
1840: 73 20 63 61 6c 6c 65 64 20 6f 6e 63 65 20 61 66  s called once af
1850: 74 65 72 20 61 6c 6c 20 6f 70 63 6f 64 65 73 20  ter all opcodes 
1860: 68 61 76 65 20 62 65 65 6e 20 69 6e 73 65 72 74  have been insert
1870: 65 64 2e 0a 2a 2a 0a 2a 2a 20 56 61 72 69 61 62  ed..**.** Variab
1880: 6c 65 20 2a 70 4d 61 78 46 75 6e 63 41 72 67 73  le *pMaxFuncArgs
1890: 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6d   is set to the m
18a0: 61 78 69 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20  aximum value of 
18b0: 61 6e 79 20 50 31 20 61 72 67 75 6d 65 6e 74 20  any P1 argument 
18c0: 0a 2a 2a 20 74 6f 20 61 6e 20 4f 50 5f 46 75 6e  .** to an OP_Fun
18d0: 63 74 69 6f 6e 20 6f 72 20 50 32 20 74 6f 20 61  ction or P2 to a
18e0: 6e 20 4f 50 5f 41 67 67 46 75 6e 63 20 6f 70 63  n OP_AggFunc opc
18f0: 6f 64 65 2e 20 54 68 69 73 20 69 73 20 75 73 65  ode. This is use
1900: 64 20 62 79 20 0a 2a 2a 20 73 71 6c 69 74 65 33  d by .** sqlite3
1910: 56 64 62 65 4d 61 6b 65 52 65 61 64 79 28 29 20  VdbeMakeReady() 
1920: 74 6f 20 73 69 7a 65 20 74 68 65 20 56 64 62 65  to size the Vdbe
1930: 2e 61 70 41 72 67 5b 5d 20 61 72 72 61 79 2e 0a  .apArg[] array..
1940: 2a 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 67 65  **.** The intege
1950: 72 20 2a 70 4d 61 78 53 74 61 63 6b 20 69 73 20  r *pMaxStack is 
1960: 73 65 74 20 74 6f 20 74 68 65 20 6d 61 78 69 6d  set to the maxim
1970: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 76 64 62  um number of vdb
1980: 65 20 73 74 61 63 6b 0a 2a 2a 20 65 6e 74 72 69  e stack.** entri
1990: 65 73 20 74 68 61 74 20 73 74 61 74 69 63 20 61  es that static a
19a0: 6e 61 6c 79 73 69 73 20 72 65 76 65 61 6c 73 20  nalysis reveals 
19b0: 74 68 69 73 20 70 72 6f 67 72 61 6d 20 6d 69 67  this program mig
19c0: 68 74 20 6e 65 65 64 2e 0a 2a 2f 0a 73 74 61 74  ht need..*/.stat
19d0: 69 63 20 76 6f 69 64 20 72 65 73 6f 6c 76 65 50  ic void resolveP
19e0: 32 56 61 6c 75 65 73 28 56 64 62 65 20 2a 70 2c  2Values(Vdbe *p,
19f0: 20 69 6e 74 20 2a 70 4d 61 78 46 75 6e 63 41 72   int *pMaxFuncAr
1a00: 67 73 2c 20 69 6e 74 20 2a 70 4d 61 78 53 74 61  gs, int *pMaxSta
1a10: 63 6b 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  ck){.  int i;.  
1a20: 69 6e 74 20 6e 4d 61 78 41 72 67 73 20 3d 20 30  int nMaxArgs = 0
1a30: 3b 0a 20 20 69 6e 74 20 6e 4d 61 78 53 74 61 63  ;.  int nMaxStac
1a40: 6b 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 4f 70  k = p->nOp;.  Op
1a50: 20 2a 70 4f 70 3b 0a 20 20 69 6e 74 20 2a 61 4c   *pOp;.  int *aL
1a60: 61 62 65 6c 20 3d 20 70 2d 3e 61 4c 61 62 65 6c  abel = p->aLabel
1a70: 3b 0a 20 20 66 6f 72 28 70 4f 70 3d 70 2d 3e 61  ;.  for(pOp=p->a
1a80: 4f 70 2c 20 69 3d 70 2d 3e 6e 4f 70 2d 31 3b 20  Op, i=p->nOp-1; 
1a90: 69 3e 3d 30 3b 20 69 2d 2d 2c 20 70 4f 70 2b 2b  i>=0; i--, pOp++
1aa0: 29 7b 0a 20 20 20 20 75 38 20 6f 70 63 6f 64 65  ){.    u8 opcode
1ab0: 20 3d 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3b 0a   = pOp->opcode;.
1ac0: 0a 20 20 20 20 2f 2a 20 54 6f 64 6f 3a 20 4d 61  .    /* Todo: Ma
1ad0: 79 62 65 20 4f 50 5f 41 67 67 46 75 6e 63 20 73  ybe OP_AggFunc s
1ae0: 68 6f 75 6c 64 20 63 68 61 6e 67 65 20 74 6f 20  hould change to 
1af0: 75 73 65 20 50 31 20 69 6e 20 74 68 65 20 73 61  use P1 in the sa
1b00: 6d 65 0a 20 20 20 20 20 2a 20 77 61 79 20 61 73  me.     * way as
1b10: 20 4f 50 5f 46 75 6e 63 74 69 6f 6e 2e 20 0a 20   OP_Function. . 
1b20: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6f      */.    if( o
1b30: 70 63 6f 64 65 3d 3d 4f 50 5f 46 75 6e 63 74 69  pcode==OP_Functi
1b40: 6f 6e 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20  on ){.      if( 
1b50: 70 4f 70 2d 3e 70 31 3e 6e 4d 61 78 41 72 67 73  pOp->p1>nMaxArgs
1b60: 20 29 20 6e 4d 61 78 41 72 67 73 20 3d 20 70 4f   ) nMaxArgs = pO
1b70: 70 2d 3e 70 31 3b 0a 20 20 20 20 7d 65 6c 73 65  p->p1;.    }else
1b80: 20 69 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f   if( opcode==OP_
1b90: 41 67 67 46 75 6e 63 20 29 7b 0a 20 20 20 20 20  AggFunc ){.     
1ba0: 20 69 66 28 20 70 4f 70 2d 3e 70 32 3e 6e 4d 61   if( pOp->p2>nMa
1bb0: 78 41 72 67 73 20 29 20 6e 4d 61 78 41 72 67 73  xArgs ) nMaxArgs
1bc0: 20 3d 20 70 4f 70 2d 3e 70 32 3b 0a 20 20 20 20   = pOp->p2;.    
1bd0: 7d 0a 0a 20 20 20 20 69 66 28 20 6f 70 63 6f 64  }..    if( opcod
1be0: 65 55 73 65 73 53 74 61 63 6b 28 6f 70 63 6f 64  eUsesStack(opcod
1bf0: 65 29 20 29 7b 0a 20 20 20 20 20 20 6e 4d 61 78  e) ){.      nMax
1c00: 53 74 61 63 6b 2d 2d 3b 0a 20 20 20 20 7d 0a 0a  Stack--;.    }..
1c10: 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 32 3e      if( pOp->p2>
1c20: 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20  =0 ) continue;. 
1c30: 20 20 20 61 73 73 65 72 74 28 20 2d 31 2d 70 4f     assert( -1-pO
1c40: 70 2d 3e 70 32 3c 70 2d 3e 6e 4c 61 62 65 6c 20  p->p2<p->nLabel 
1c50: 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 32 20 3d  );.    pOp->p2 =
1c60: 20 61 4c 61 62 65 6c 5b 2d 31 2d 70 4f 70 2d 3e   aLabel[-1-pOp->
1c70: 70 32 5d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  p2];.  }.  sqlit
1c80: 65 46 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c 29  eFree(p->aLabel)
1c90: 3b 0a 20 20 70 2d 3e 61 4c 61 62 65 6c 20 3d 20  ;.  p->aLabel = 
1ca0: 30 3b 0a 0a 20 20 2a 70 4d 61 78 46 75 6e 63 41  0;..  *pMaxFuncA
1cb0: 72 67 73 20 3d 20 6e 4d 61 78 41 72 67 73 3b 0a  rgs = nMaxArgs;.
1cc0: 20 20 2a 70 4d 61 78 53 74 61 63 6b 20 3d 20 6e    *pMaxStack = n
1cd0: 4d 61 78 53 74 61 63 6b 3b 0a 7d 0a 0a 2f 2a 0a  MaxStack;.}../*.
1ce0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61 64  ** Return the ad
1cf0: 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 78  dress of the nex
1d00: 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f  t instruction to
1d10: 20 62 65 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2f   be inserted..*/
1d20: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
1d30: 43 75 72 72 65 6e 74 41 64 64 72 28 56 64 62 65  CurrentAddr(Vdbe
1d40: 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20   *p){.  assert( 
1d50: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
1d60: 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 72  AGIC_INIT );.  r
1d70: 65 74 75 72 6e 20 70 2d 3e 6e 4f 70 3b 0a 7d 0a  eturn p->nOp;.}.
1d80: 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 77 68 6f  ./*.** Add a who
1d90: 6c 65 20 6c 69 73 74 20 6f 66 20 6f 70 65 72 61  le list of opera
1da0: 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 6f 70 65  tions to the ope
1db0: 72 61 74 69 6f 6e 20 73 74 61 63 6b 2e 20 20 52  ration stack.  R
1dc0: 65 74 75 72 6e 20 74 68 65 0a 2a 2a 20 61 64 64  eturn the.** add
1dd0: 72 65 73 73 20 6f 66 20 74 68 65 20 66 69 72 73  ress of the firs
1de0: 74 20 6f 70 65 72 61 74 69 6f 6e 20 61 64 64 65  t operation adde
1df0: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  d..*/.int sqlite
1e00: 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28 56  3VdbeAddOpList(V
1e10: 64 62 65 20 2a 70 2c 20 69 6e 74 20 6e 4f 70 2c  dbe *p, int nOp,
1e20: 20 56 64 62 65 4f 70 4c 69 73 74 20 63 6f 6e 73   VdbeOpList cons
1e30: 74 20 2a 61 4f 70 29 7b 0a 20 20 69 6e 74 20 61  t *aOp){.  int a
1e40: 64 64 72 3b 0a 20 20 61 73 73 65 72 74 28 20 70  ddr;.  assert( p
1e50: 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41  ->magic==VDBE_MA
1e60: 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 72 65  GIC_INIT );.  re
1e70: 73 69 7a 65 4f 70 41 72 72 61 79 28 70 2c 20 70  sizeOpArray(p, p
1e80: 2d 3e 6e 4f 70 20 2b 20 6e 4f 70 29 3b 0a 20 20  ->nOp + nOp);.  
1e90: 69 66 28 20 70 2d 3e 61 4f 70 3d 3d 30 20 29 7b  if( p->aOp==0 ){
1ea0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
1eb0: 20 7d 0a 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e   }.  addr = p->n
1ec0: 4f 70 3b 0a 20 20 69 66 28 20 6e 4f 70 3e 30 20  Op;.  if( nOp>0 
1ed0: 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20  ){.    int i;.  
1ee0: 20 20 56 64 62 65 4f 70 4c 69 73 74 20 63 6f 6e    VdbeOpList con
1ef0: 73 74 20 2a 70 49 6e 20 3d 20 61 4f 70 3b 0a 20  st *pIn = aOp;. 
1f00: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 4f     for(i=0; i<nO
1f10: 70 3b 20 69 2b 2b 2c 20 70 49 6e 2b 2b 29 7b 0a  p; i++, pIn++){.
1f20: 20 20 20 20 20 20 69 6e 74 20 70 32 20 3d 20 70        int p2 = p
1f30: 49 6e 2d 3e 70 32 3b 0a 20 20 20 20 20 20 56 64  In->p2;.      Vd
1f40: 62 65 4f 70 20 2a 70 4f 75 74 20 3d 20 26 70 2d  beOp *pOut = &p-
1f50: 3e 61 4f 70 5b 69 2b 61 64 64 72 5d 3b 0a 20 20  >aOp[i+addr];.  
1f60: 20 20 20 20 70 4f 75 74 2d 3e 6f 70 63 6f 64 65      pOut->opcode
1f70: 20 3d 20 70 49 6e 2d 3e 6f 70 63 6f 64 65 3b 0a   = pIn->opcode;.
1f80: 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 31 20 3d        pOut->p1 =
1f90: 20 70 49 6e 2d 3e 70 31 3b 0a 20 20 20 20 20 20   pIn->p1;.      
1fa0: 70 4f 75 74 2d 3e 70 32 20 3d 20 70 32 3c 30 20  pOut->p2 = p2<0 
1fb0: 3f 20 61 64 64 72 20 2b 20 41 44 44 52 28 70 32  ? addr + ADDR(p2
1fc0: 29 20 3a 20 70 32 3b 0a 20 20 20 20 20 20 70 4f  ) : p2;.      pO
1fd0: 75 74 2d 3e 70 33 20 3d 20 70 49 6e 2d 3e 70 33  ut->p3 = pIn->p3
1fe0: 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 33  ;.      pOut->p3
1ff0: 74 79 70 65 20 3d 20 70 49 6e 2d 3e 70 33 20 3f  type = pIn->p3 ?
2000: 20 50 33 5f 53 54 41 54 49 43 20 3a 20 50 33 5f   P3_STATIC : P3_
2010: 4e 4f 54 55 53 45 44 3b 0a 23 69 66 64 65 66 20  NOTUSED;.#ifdef 
2020: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20  SQLITE_DEBUG.   
2030: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 76     if( sqlite3_v
2040: 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63 65 20  dbe_addop_trace 
2050: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ){.        sqlit
2060: 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28 30 2c  e3VdbePrintOp(0,
2070: 20 69 2b 61 64 64 72 2c 20 26 70 2d 3e 61 4f 70   i+addr, &p->aOp
2080: 5b 69 2b 61 64 64 72 5d 29 3b 0a 20 20 20 20 20  [i+addr]);.     
2090: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a   }.#endif.    }.
20a0: 20 20 20 20 70 2d 3e 6e 4f 70 20 2b 3d 20 6e 4f      p->nOp += nO
20b0: 70 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  p;.  }.  return 
20c0: 61 64 64 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  addr;.}../*.** C
20d0: 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20  hange the value 
20e0: 6f 66 20 74 68 65 20 50 31 20 6f 70 65 72 61 6e  of the P1 operan
20f0: 64 20 66 6f 72 20 61 20 73 70 65 63 69 66 69 63  d for a specific
2100: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a   instruction..**
2110: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
2120: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 61 20 6c   useful when a l
2130: 61 72 67 65 20 70 72 6f 67 72 61 6d 20 69 73 20  arge program is 
2140: 6c 6f 61 64 65 64 20 66 72 6f 6d 20 61 0a 2a 2a  loaded from a.**
2150: 20 73 74 61 74 69 63 20 61 72 72 61 79 20 75 73   static array us
2160: 69 6e 67 20 73 71 6c 69 74 65 33 56 64 62 65 41  ing sqlite3VdbeA
2170: 64 64 4f 70 4c 69 73 74 20 62 75 74 20 77 65 20  ddOpList but we 
2180: 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 61 0a 2a  want to make a.*
2190: 2a 20 66 65 77 20 6d 69 6e 6f 72 20 63 68 61 6e  * few minor chan
21a0: 67 65 73 20 74 6f 20 74 68 65 20 70 72 6f 67 72  ges to the progr
21b0: 61 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  am..*/.void sqli
21c0: 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 31 28  te3VdbeChangeP1(
21d0: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64  Vdbe *p, int add
21e0: 72 2c 20 69 6e 74 20 76 61 6c 29 7b 0a 20 20 61  r, int val){.  a
21f0: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
2200: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
2210: 20 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 61   );.  if( p && a
2220: 64 64 72 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f 70  ddr>=0 && p->nOp
2230: 3e 61 64 64 72 20 26 26 20 70 2d 3e 61 4f 70 20  >addr && p->aOp 
2240: 29 7b 0a 20 20 20 20 70 2d 3e 61 4f 70 5b 61 64  ){.    p->aOp[ad
2250: 64 72 5d 2e 70 31 20 3d 20 76 61 6c 3b 0a 20 20  dr].p1 = val;.  
2260: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67  }.}../*.** Chang
2270: 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74  e the value of t
2280: 68 65 20 50 32 20 6f 70 65 72 61 6e 64 20 66 6f  he P2 operand fo
2290: 72 20 61 20 73 70 65 63 69 66 69 63 20 69 6e 73  r a specific ins
22a0: 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69  truction..** Thi
22b0: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65  s routine is use
22c0: 66 75 6c 20 66 6f 72 20 73 65 74 74 69 6e 67 20  ful for setting 
22d0: 61 20 6a 75 6d 70 20 64 65 73 74 69 6e 61 74 69  a jump destinati
22e0: 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  on..*/.void sqli
22f0: 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 32 28  te3VdbeChangeP2(
2300: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64  Vdbe *p, int add
2310: 72 2c 20 69 6e 74 20 76 61 6c 29 7b 0a 20 20 61  r, int val){.  a
2320: 73 73 65 72 74 28 20 76 61 6c 3e 3d 30 20 29 3b  ssert( val>=0 );
2330: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61  .  assert( p->ma
2340: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
2350: 49 4e 49 54 20 29 3b 0a 20 20 69 66 28 20 70 20  INIT );.  if( p 
2360: 26 26 20 61 64 64 72 3e 3d 30 20 26 26 20 70 2d  && addr>=0 && p-
2370: 3e 6e 4f 70 3e 61 64 64 72 20 26 26 20 70 2d 3e  >nOp>addr && p->
2380: 61 4f 70 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4f  aOp ){.    p->aO
2390: 70 5b 61 64 64 72 5d 2e 70 32 20 3d 20 76 61 6c  p[addr].p2 = val
23a0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  ;.  }.}../*.** C
23b0: 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20  hange the value 
23c0: 6f 66 20 74 68 65 20 50 33 20 6f 70 65 72 61 6e  of the P3 operan
23d0: 64 20 66 6f 72 20 61 20 73 70 65 63 69 66 69 63  d for a specific
23e0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a   instruction..**
23f0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
2400: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 61 20 6c   useful when a l
2410: 61 72 67 65 20 70 72 6f 67 72 61 6d 20 69 73 20  arge program is 
2420: 6c 6f 61 64 65 64 20 66 72 6f 6d 20 61 0a 2a 2a  loaded from a.**
2430: 20 73 74 61 74 69 63 20 61 72 72 61 79 20 75 73   static array us
2440: 69 6e 67 20 73 71 6c 69 74 65 33 56 64 62 65 41  ing sqlite3VdbeA
2450: 64 64 4f 70 4c 69 73 74 20 62 75 74 20 77 65 20  ddOpList but we 
2460: 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 61 0a 2a  want to make a.*
2470: 2a 20 66 65 77 20 6d 69 6e 6f 72 20 63 68 61 6e  * few minor chan
2480: 67 65 73 20 74 6f 20 74 68 65 20 70 72 6f 67 72  ges to the progr
2490: 61 6d 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 3e 3d  am..**.** If n>=
24a0: 30 20 74 68 65 6e 20 74 68 65 20 50 33 20 6f 70  0 then the P3 op
24b0: 65 72 61 6e 64 20 69 73 20 64 79 6e 61 6d 69 63  erand is dynamic
24c0: 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 61  , meaning that a
24d0: 20 63 6f 70 79 20 6f 66 0a 2a 2a 20 74 68 65 20   copy of.** the 
24e0: 73 74 72 69 6e 67 20 69 73 20 6d 61 64 65 20 69  string is made i
24f0: 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69  nto memory obtai
2500: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  ned from sqliteM
2510: 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20 41 20 76 61  alloc()..** A va
2520: 6c 75 65 20 6f 66 20 6e 3d 3d 30 20 6d 65 61 6e  lue of n==0 mean
2530: 73 20 63 6f 70 79 20 62 79 74 65 73 20 6f 66 20  s copy bytes of 
2540: 7a 50 33 20 75 70 20 74 6f 20 61 6e 64 20 69 6e  zP3 up to and in
2550: 63 6c 75 64 69 6e 67 20 74 68 65 0a 2a 2a 20 66  cluding the.** f
2560: 69 72 73 74 20 6e 75 6c 6c 20 62 79 74 65 2e 20  irst null byte. 
2570: 20 49 66 20 6e 3e 30 20 74 68 65 6e 20 63 6f 70   If n>0 then cop
2580: 79 20 6e 2b 31 20 62 79 74 65 73 20 6f 66 20 7a  y n+1 bytes of z
2590: 50 33 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 3d 3d  P3..**.** If n==
25a0: 50 33 5f 53 54 41 54 49 43 20 20 69 74 20 6d 65  P3_STATIC  it me
25b0: 61 6e 73 20 74 68 61 74 20 7a 50 33 20 69 73 20  ans that zP3 is 
25c0: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 63  a pointer to a c
25d0: 6f 6e 73 74 61 6e 74 20 73 74 61 74 69 63 0a 2a  onstant static.*
25e0: 2a 20 73 74 72 69 6e 67 20 61 6e 64 20 77 65 20  * string and we 
25f0: 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74 68  can just copy th
2600: 65 20 70 6f 69 6e 74 65 72 2e 20 20 6e 3d 3d 50  e pointer.  n==P
2610: 33 5f 50 4f 49 4e 54 45 52 20 6d 65 61 6e 73 20  3_POINTER means 
2620: 7a 50 33 20 69 73 0a 2a 2a 20 61 20 70 6f 69 6e  zP3 is.** a poin
2630: 74 65 72 20 74 6f 20 73 6f 6d 65 20 6f 62 6a 65  ter to some obje
2640: 63 74 20 6f 74 68 65 72 20 74 68 61 6e 20 61 20  ct other than a 
2650: 73 74 72 69 6e 67 2e 20 20 6e 3d 3d 50 33 5f 43  string.  n==P3_C
2660: 4f 4c 4c 53 45 51 20 61 6e 64 0a 2a 2a 20 6e 3d  OLLSEQ and.** n=
2670: 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 6d 65 61 6e  =P3_KEYINFO mean
2680: 20 74 68 61 74 20 7a 50 33 20 69 73 20 61 20 70   that zP3 is a p
2690: 6f 69 6e 74 65 72 20 74 6f 20 61 20 43 6f 6c 6c  ointer to a Coll
26a0: 53 65 71 20 6f 72 20 4b 65 79 49 6e 66 6f 0a 2a  Seq or KeyInfo.*
26b0: 2a 20 73 74 72 75 63 74 75 72 65 2e 20 20 41 20  * structure.  A 
26c0: 63 6f 70 79 20 69 73 20 6d 61 64 65 20 6f 66 20  copy is made of 
26d0: 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72  KeyInfo structur
26e0: 65 73 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f  es into memory o
26f0: 62 74 61 69 6e 65 64 0a 2a 2a 20 66 72 6f 6d 20  btained.** from 
2700: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 2e 0a 2a 2a  sqliteMalloc..**
2710: 0a 2a 2a 20 49 66 20 61 64 64 72 3c 30 20 74 68  .** If addr<0 th
2720: 65 6e 20 63 68 61 6e 67 65 20 50 33 20 6f 6e 20  en change P3 on 
2730: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c  the most recentl
2740: 79 20 69 6e 73 65 72 74 65 64 20 69 6e 73 74 72  y inserted instr
2750: 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20  uction..*/.void 
2760: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
2770: 65 50 33 28 56 64 62 65 20 2a 70 2c 20 69 6e 74  eP3(Vdbe *p, int
2780: 20 61 64 64 72 2c 20 63 6f 6e 73 74 20 63 68 61   addr, const cha
2790: 72 20 2a 7a 50 33 2c 20 69 6e 74 20 6e 29 7b 0a  r *zP3, int n){.
27a0: 20 20 4f 70 20 2a 70 4f 70 3b 0a 20 20 61 73 73    Op *pOp;.  ass
27b0: 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  ert( p->magic==V
27c0: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29  DBE_MAGIC_INIT )
27d0: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20  ;.  if( p==0 || 
27e0: 70 2d 3e 61 4f 70 3d 3d 30 20 29 7b 0a 20 20 20  p->aOp==0 ){.   
27f0: 20 69 66 28 20 6e 3d 3d 50 33 5f 44 59 4e 41 4d   if( n==P3_DYNAM
2800: 49 43 20 7c 7c 20 6e 3d 3d 50 33 5f 4b 45 59 49  IC || n==P3_KEYI
2810: 4e 46 4f 5f 48 41 4e 44 4f 46 46 20 29 7b 0a 20  NFO_HANDOFF ){. 
2820: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
2830: 28 76 6f 69 64 2a 29 7a 50 33 29 3b 0a 20 20 20  (void*)zP3);.   
2840: 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20   }.    return;. 
2850: 20 7d 0a 20 20 69 66 28 20 61 64 64 72 3c 30 20   }.  if( addr<0 
2860: 7c 7c 20 61 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20  || addr>=p->nOp 
2870: 29 7b 0a 20 20 20 20 61 64 64 72 20 3d 20 70 2d  ){.    addr = p-
2880: 3e 6e 4f 70 20 2d 20 31 3b 0a 20 20 20 20 69 66  >nOp - 1;.    if
2890: 28 20 61 64 64 72 3c 30 20 29 20 72 65 74 75 72  ( addr<0 ) retur
28a0: 6e 3b 0a 20 20 7d 0a 20 20 70 4f 70 20 3d 20 26  n;.  }.  pOp = &
28b0: 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 20 20  p->aOp[addr];.  
28c0: 69 66 28 20 70 4f 70 2d 3e 70 33 20 26 26 20 70  if( pOp->p3 && p
28d0: 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44  Op->p3type==P3_D
28e0: 59 4e 41 4d 49 43 20 29 7b 0a 20 20 20 20 73 71  YNAMIC ){.    sq
28f0: 6c 69 74 65 46 72 65 65 28 70 4f 70 2d 3e 70 33  liteFree(pOp->p3
2900: 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d  );.    pOp->p3 =
2910: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 7a 50   0;.  }.  if( zP
2920: 33 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d  3==0 ){.    pOp-
2930: 3e 70 33 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70  >p3 = 0;.    pOp
2940: 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f  ->p3type = P3_NO
2950: 54 55 53 45 44 3b 0a 20 20 7d 65 6c 73 65 20 69  TUSED;.  }else i
2960: 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f  f( n==P3_KEYINFO
2970: 20 29 7b 0a 20 20 20 20 4b 65 79 49 6e 66 6f 20   ){.    KeyInfo 
2980: 2a 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 20 20 69  *pKeyInfo;.    i
2990: 6e 74 20 6e 46 69 65 6c 64 2c 20 6e 42 79 74 65  nt nField, nByte
29a0: 3b 0a 20 20 20 20 6e 46 69 65 6c 64 20 3d 20 28  ;.    nField = (
29b0: 28 4b 65 79 49 6e 66 6f 2a 29 7a 50 33 29 2d 3e  (KeyInfo*)zP3)->
29c0: 6e 46 69 65 6c 64 3b 0a 20 20 20 20 6e 42 79 74  nField;.    nByt
29d0: 65 20 3d 20 73 69 7a 65 6f 66 28 2a 70 4b 65 79  e = sizeof(*pKey
29e0: 49 6e 66 6f 29 20 2b 20 28 6e 46 69 65 6c 64 2d  Info) + (nField-
29f0: 31 29 2a 73 69 7a 65 6f 66 28 70 4b 65 79 49 6e  1)*sizeof(pKeyIn
2a00: 66 6f 2d 3e 61 43 6f 6c 6c 5b 30 5d 29 3b 0a 20  fo->aColl[0]);. 
2a10: 20 20 20 70 4b 65 79 49 6e 66 6f 20 3d 20 73 71     pKeyInfo = sq
2a20: 6c 69 74 65 4d 61 6c 6c 6f 63 52 61 77 28 20 6e  liteMallocRaw( n
2a30: 42 79 74 65 20 29 3b 0a 20 20 20 20 70 4f 70 2d  Byte );.    pOp-
2a40: 3e 70 33 20 3d 20 28 63 68 61 72 2a 29 70 4b 65  >p3 = (char*)pKe
2a50: 79 49 6e 66 6f 3b 0a 20 20 20 20 69 66 28 20 70  yInfo;.    if( p
2a60: 4b 65 79 49 6e 66 6f 20 29 7b 0a 20 20 20 20 20  KeyInfo ){.     
2a70: 20 6d 65 6d 63 70 79 28 70 4b 65 79 49 6e 66 6f   memcpy(pKeyInfo
2a80: 2c 20 7a 50 33 2c 20 6e 42 79 74 65 29 3b 0a 20  , zP3, nByte);. 
2a90: 20 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65       pOp->p3type
2aa0: 20 3d 20 50 33 5f 4b 45 59 49 4e 46 4f 3b 0a 20   = P3_KEYINFO;. 
2ab0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
2ac0: 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33  pOp->p3type = P3
2ad0: 5f 4e 4f 54 55 53 45 44 3b 0a 20 20 20 20 7d 0a  _NOTUSED;.    }.
2ae0: 20 20 7d 65 6c 73 65 20 69 66 28 20 6e 3d 3d 50    }else if( n==P
2af0: 33 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46  3_KEYINFO_HANDOF
2b00: 46 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70 33  F ){.    pOp->p3
2b10: 20 3d 20 28 63 68 61 72 2a 29 7a 50 33 3b 0a 20   = (char*)zP3;. 
2b20: 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d     pOp->p3type =
2b30: 20 50 33 5f 4b 45 59 49 4e 46 4f 3b 0a 20 20 7d   P3_KEYINFO;.  }
2b40: 65 6c 73 65 20 69 66 28 20 6e 3c 30 20 29 7b 0a  else if( n<0 ){.
2b50: 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63      pOp->p3 = (c
2b60: 68 61 72 2a 29 7a 50 33 3b 0a 20 20 20 20 70 4f  har*)zP3;.    pO
2b70: 70 2d 3e 70 33 74 79 70 65 20 3d 20 6e 3b 0a 20  p->p3type = n;. 
2b80: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20   }else{.    if( 
2b90: 6e 3d 3d 30 20 29 20 6e 20 3d 20 73 74 72 6c 65  n==0 ) n = strle
2ba0: 6e 28 7a 50 33 29 3b 0a 20 20 20 20 70 4f 70 2d  n(zP3);.    pOp-
2bb0: 3e 70 33 20 3d 20 73 71 6c 69 74 65 53 74 72 4e  >p3 = sqliteStrN
2bc0: 44 75 70 28 7a 50 33 2c 20 6e 29 3b 0a 20 20 20  Dup(zP3, n);.   
2bd0: 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50   pOp->p3type = P
2be0: 33 5f 44 59 4e 41 4d 49 43 3b 0a 20 20 7d 0a 7d  3_DYNAMIC;.  }.}
2bf0: 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47  ..#ifndef NDEBUG
2c00: 0a 2f 2a 0a 2a 2a 20 52 65 70 6c 61 63 65 20 74  ./*.** Replace t
2c10: 68 65 20 50 33 20 66 69 65 6c 64 20 6f 66 20 74  he P3 field of t
2c20: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79  he most recently
2c30: 20 63 6f 64 65 64 20 69 6e 73 74 72 75 63 74 69   coded instructi
2c40: 6f 6e 20 77 69 74 68 0a 2a 2a 20 63 6f 6d 6d 65  on with.** comme
2c50: 6e 74 20 74 65 78 74 2e 0a 2a 2f 0a 76 6f 69 64  nt text..*/.void
2c60: 20 73 71 6c 69 74 65 33 56 64 62 65 43 6f 6d 6d   sqlite3VdbeComm
2c70: 65 6e 74 28 56 64 62 65 20 2a 70 2c 20 63 6f 6e  ent(Vdbe *p, con
2c80: 73 74 20 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74  st char *zFormat
2c90: 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73  , ...){.  va_lis
2ca0: 74 20 61 70 3b 0a 20 20 61 73 73 65 72 74 28 20  t ap;.  assert( 
2cb0: 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 20 20 61 73  p->nOp>0 );.  as
2cc0: 73 65 72 74 28 20 70 2d 3e 61 4f 70 3d 3d 30 20  sert( p->aOp==0 
2cd0: 7c 7c 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70  || p->aOp[p->nOp
2ce0: 2d 31 5d 2e 70 33 3d 3d 30 20 29 3b 0a 20 20 76  -1].p3==0 );.  v
2cf0: 61 5f 73 74 61 72 74 28 61 70 2c 20 7a 46 6f 72  a_start(ap, zFor
2d00: 6d 61 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  mat);.  sqlite3V
2d10: 64 62 65 43 68 61 6e 67 65 50 33 28 70 2c 20 2d  dbeChangeP3(p, -
2d20: 31 2c 20 73 71 6c 69 74 65 33 56 4d 50 72 69 6e  1, sqlite3VMPrin
2d30: 74 66 28 7a 46 6f 72 6d 61 74 2c 20 61 70 29 2c  tf(zFormat, ap),
2d40: 20 50 33 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20   P3_DYNAMIC);.  
2d50: 76 61 5f 65 6e 64 28 61 70 29 3b 0a 7d 0a 23 65  va_end(ap);.}.#e
2d60: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74  ndif../*.** If t
2d70: 68 65 20 50 33 20 6f 70 65 72 61 6e 64 20 74 6f  he P3 operand to
2d80: 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 69   the specified i
2d90: 6e 73 74 72 75 63 74 69 6f 6e 20 61 70 70 65 61  nstruction appea
2da0: 72 73 0a 2a 2a 20 74 6f 20 62 65 20 61 20 71 75  rs.** to be a qu
2db0: 6f 74 65 64 20 73 74 72 69 6e 67 20 74 6f 6b 65  oted string toke
2dc0: 6e 2c 20 74 68 65 6e 20 74 68 69 73 20 70 72 6f  n, then this pro
2dd0: 63 65 64 75 72 65 20 72 65 6d 6f 76 65 73 20 0a  cedure removes .
2de0: 2a 2a 20 74 68 65 20 71 75 6f 74 65 73 2e 0a 2a  ** the quotes..*
2df0: 2a 0a 2a 2a 20 54 68 65 20 71 75 6f 74 69 6e 67  *.** The quoting
2e00: 20 6f 70 65 72 61 74 6f 72 20 63 61 6e 20 62 65   operator can be
2e10: 20 65 69 74 68 65 72 20 61 20 67 72 61 76 65 20   either a grave 
2e20: 61 73 63 65 6e 74 20 28 41 53 43 49 49 20 30 78  ascent (ASCII 0x
2e30: 32 37 29 0a 2a 2a 20 6f 72 20 61 20 64 6f 75 62  27).** or a doub
2e40: 6c 65 20 71 75 6f 74 65 20 63 68 61 72 61 63 74  le quote charact
2e50: 65 72 20 28 41 53 43 49 49 20 30 78 32 32 29 2e  er (ASCII 0x22).
2e60: 20 20 54 77 6f 20 71 75 6f 74 65 73 20 69 6e 20    Two quotes in 
2e70: 61 20 72 6f 77 0a 2a 2a 20 72 65 73 6f 6c 76 65  a row.** resolve
2e80: 20 74 6f 20 62 65 20 61 20 73 69 6e 67 6c 65 20   to be a single 
2e90: 61 63 74 75 61 6c 20 71 75 6f 74 65 20 63 68 61  actual quote cha
2ea0: 72 61 63 74 65 72 20 77 69 74 68 69 6e 20 74 68  racter within th
2eb0: 65 20 73 74 72 69 6e 67 2e 0a 2a 2f 0a 76 6f 69  e string..*/.voi
2ec0: 64 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 71  d sqlite3VdbeDeq
2ed0: 75 6f 74 65 50 33 28 56 64 62 65 20 2a 70 2c 20  uoteP3(Vdbe *p, 
2ee0: 69 6e 74 20 61 64 64 72 29 7b 0a 20 20 4f 70 20  int addr){.  Op 
2ef0: 2a 70 4f 70 3b 0a 20 20 61 73 73 65 72 74 28 20  *pOp;.  assert( 
2f00: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
2f10: 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69  AGIC_INIT );.  i
2f20: 66 28 20 70 2d 3e 61 4f 70 3d 3d 30 20 29 20 72  f( p->aOp==0 ) r
2f30: 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 61 64 64  eturn;.  if( add
2f40: 72 3c 30 20 7c 7c 20 61 64 64 72 3e 3d 70 2d 3e  r<0 || addr>=p->
2f50: 6e 4f 70 20 29 7b 0a 20 20 20 20 61 64 64 72 20  nOp ){.    addr 
2f60: 3d 20 70 2d 3e 6e 4f 70 20 2d 20 31 3b 0a 20 20  = p->nOp - 1;.  
2f70: 20 20 69 66 28 20 61 64 64 72 3c 30 20 29 20 72    if( addr<0 ) r
2f80: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 70 4f 70  eturn;.  }.  pOp
2f90: 20 3d 20 26 70 2d 3e 61 4f 70 5b 61 64 64 72 5d   = &p->aOp[addr]
2fa0: 3b 0a 20 20 69 66 28 20 70 4f 70 2d 3e 70 33 3d  ;.  if( pOp->p3=
2fb0: 3d 30 20 7c 7c 20 70 4f 70 2d 3e 70 33 5b 30 5d  =0 || pOp->p3[0]
2fc0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  ==0 ) return;.  
2fd0: 69 66 28 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d  if( pOp->p3type=
2fe0: 3d 50 33 5f 53 54 41 54 49 43 20 29 7b 0a 20 20  =P3_STATIC ){.  
2ff0: 20 20 70 4f 70 2d 3e 70 33 20 3d 20 73 71 6c 69    pOp->p3 = sqli
3000: 74 65 53 74 72 44 75 70 28 70 4f 70 2d 3e 70 33  teStrDup(pOp->p3
3010: 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79  );.    pOp->p3ty
3020: 70 65 20 3d 20 50 33 5f 44 59 4e 41 4d 49 43 3b  pe = P3_DYNAMIC;
3030: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70  .  }.  assert( p
3040: 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44  Op->p3type==P3_D
3050: 59 4e 41 4d 49 43 20 29 3b 0a 20 20 73 71 6c 69  YNAMIC );.  sqli
3060: 74 65 33 44 65 71 75 6f 74 65 28 70 4f 70 2d 3e  te3Dequote(pOp->
3070: 70 33 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65  p3);.}../*.** Se
3080: 61 72 63 68 20 74 68 65 20 63 75 72 72 65 6e 74  arch the current
3090: 20 70 72 6f 67 72 61 6d 20 73 74 61 72 74 69 6e   program startin
30a0: 67 20 61 74 20 69 6e 73 74 72 75 63 74 69 6f 6e  g at instruction
30b0: 20 61 64 64 72 20 66 6f 72 20 74 68 65 20 67 69   addr for the gi
30c0: 76 65 6e 0a 2a 2a 20 6f 70 63 6f 64 65 20 61 6e  ven.** opcode an
30d0: 64 20 50 32 20 76 61 6c 75 65 2e 20 20 52 65 74  d P2 value.  Ret
30e0: 75 72 6e 20 74 68 65 20 61 64 64 72 65 73 73 20  urn the address 
30f0: 70 6c 75 73 20 31 20 69 66 20 66 6f 75 6e 64 20  plus 1 if found 
3100: 61 6e 64 20 30 20 69 66 20 6e 6f 74 0a 2a 2a 20  and 0 if not.** 
3110: 66 6f 75 6e 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71  found..*/.int sq
3120: 6c 69 74 65 33 56 64 62 65 46 69 6e 64 4f 70 28  lite3VdbeFindOp(
3130: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64  Vdbe *p, int add
3140: 72 2c 20 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70  r, int op, int p
3150: 32 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 61  2){.  int i;.  a
3160: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
3170: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
3180: 20 29 3b 0a 20 20 66 6f 72 28 69 3d 61 64 64 72   );.  for(i=addr
3190: 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29  ; i<p->nOp; i++)
31a0: 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 61 4f 70  {.    if( p->aOp
31b0: 5b 69 5d 2e 6f 70 63 6f 64 65 3d 3d 6f 70 20 26  [i].opcode==op &
31c0: 26 20 70 2d 3e 61 4f 70 5b 69 5d 2e 70 32 3d 3d  & p->aOp[i].p2==
31d0: 70 32 20 29 20 72 65 74 75 72 6e 20 69 2b 31 3b  p2 ) return i+1;
31e0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b  .  }.  return 0;
31f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
3200: 20 74 68 65 20 6f 70 63 6f 64 65 20 66 6f 72 20   the opcode for 
3210: 61 20 67 69 76 65 6e 20 61 64 64 72 65 73 73 2e  a given address.
3220: 0a 2a 2f 0a 56 64 62 65 4f 70 20 2a 73 71 6c 69  .*/.VdbeOp *sqli
3230: 74 65 33 56 64 62 65 47 65 74 4f 70 28 56 64 62  te3VdbeGetOp(Vdb
3240: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 29 7b  e *p, int addr){
3250: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61  .  assert( p->ma
3260: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
3270: 49 4e 49 54 20 29 3b 0a 20 20 61 73 73 65 72 74  INIT );.  assert
3280: 28 20 61 64 64 72 3e 3d 30 20 26 26 20 61 64 64  ( addr>=0 && add
3290: 72 3c 70 2d 3e 6e 4f 70 20 29 3b 0a 20 20 72 65  r<p->nOp );.  re
32a0: 74 75 72 6e 20 26 70 2d 3e 61 4f 70 5b 61 64 64  turn &p->aOp[add
32b0: 72 5d 3b 0a 7d 0a 0a 23 69 66 20 21 64 65 66 69  r];.}..#if !defi
32c0: 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ned(SQLITE_OMIT_
32d0: 45 58 50 4c 41 49 4e 29 20 7c 7c 20 21 64 65 66  EXPLAIN) || !def
32e0: 69 6e 65 64 28 4e 44 45 42 55 47 29 20 5c 0a 20  ined(NDEBUG) \. 
32f0: 20 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 56      || defined(V
3300: 44 42 45 5f 50 52 4f 46 49 4c 45 29 20 7c 7c 20  DBE_PROFILE) || 
3310: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44  defined(SQLITE_D
3320: 45 42 55 47 29 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70  EBUG)./*.** Comp
3330: 75 74 65 20 61 20 73 74 72 69 6e 67 20 74 68 61  ute a string tha
3340: 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20  t describes the 
3350: 50 33 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72  P3 parameter for
3360: 20 61 6e 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 55   an opcode..** U
3370: 73 65 20 7a 54 65 6d 70 20 66 6f 72 20 61 6e 79  se zTemp for any
3380: 20 72 65 71 75 69 72 65 64 20 74 65 6d 70 6f 72   required tempor
3390: 61 72 79 20 62 75 66 66 65 72 20 73 70 61 63 65  ary buffer space
33a0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 68 61 72  ..*/.static char
33b0: 20 2a 64 69 73 70 6c 61 79 50 33 28 4f 70 20 2a   *displayP3(Op *
33c0: 70 4f 70 2c 20 63 68 61 72 20 2a 7a 54 65 6d 70  pOp, char *zTemp
33d0: 2c 20 69 6e 74 20 6e 54 65 6d 70 29 7b 0a 20 20  , int nTemp){.  
33e0: 63 68 61 72 20 2a 7a 50 33 3b 0a 20 20 61 73 73  char *zP3;.  ass
33f0: 65 72 74 28 20 6e 54 65 6d 70 3e 3d 32 30 20 29  ert( nTemp>=20 )
3400: 3b 0a 20 20 73 77 69 74 63 68 28 20 70 4f 70 2d  ;.  switch( pOp-
3410: 3e 70 33 74 79 70 65 20 29 7b 0a 20 20 20 20 63  >p3type ){.    c
3420: 61 73 65 20 50 33 5f 50 4f 49 4e 54 45 52 3a 20  ase P3_POINTER: 
3430: 7b 0a 20 20 20 20 20 20 73 70 72 69 6e 74 66 28  {.      sprintf(
3440: 7a 54 65 6d 70 2c 20 22 70 74 72 28 25 23 78 29  zTemp, "ptr(%#x)
3450: 22 2c 20 28 69 6e 74 29 70 4f 70 2d 3e 70 33 29  ", (int)pOp->p3)
3460: 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54  ;.      zP3 = zT
3470: 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  emp;.      break
3480: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
3490: 20 50 33 5f 4b 45 59 49 4e 46 4f 3a 20 7b 0a 20   P3_KEYINFO: {. 
34a0: 20 20 20 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20       int i, j;. 
34b0: 20 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b       KeyInfo *pK
34c0: 65 79 49 6e 66 6f 20 3d 20 28 4b 65 79 49 6e 66  eyInfo = (KeyInf
34d0: 6f 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20  o*)pOp->p3;.    
34e0: 20 20 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c    sprintf(zTemp,
34f0: 20 22 6b 65 79 69 6e 66 6f 28 25 64 22 2c 20 70   "keyinfo(%d", p
3500: 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 29  KeyInfo->nField)
3510: 3b 0a 20 20 20 20 20 20 69 20 3d 20 73 74 72 6c  ;.      i = strl
3520: 65 6e 28 7a 54 65 6d 70 29 3b 0a 20 20 20 20 20  en(zTemp);.     
3530: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 4b 65 79   for(j=0; j<pKey
3540: 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 3b 20 6a 2b  Info->nField; j+
3550: 2b 29 7b 0a 20 20 20 20 20 20 20 20 43 6f 6c 6c  +){.        Coll
3560: 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 70 4b 65  Seq *pColl = pKe
3570: 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 6a 5d 3b  yInfo->aColl[j];
3580: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 43 6f  .        if( pCo
3590: 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  ll ){.          
35a0: 69 6e 74 20 6e 20 3d 20 73 74 72 6c 65 6e 28 70  int n = strlen(p
35b0: 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20  Coll->zName);.  
35c0: 20 20 20 20 20 20 20 20 69 66 28 20 69 2b 6e 3e          if( i+n>
35d0: 6e 54 65 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20  nTemp-6 ){.     
35e0: 20 20 20 20 20 20 20 73 74 72 63 70 79 28 26 7a         strcpy(&z
35f0: 54 65 6d 70 5b 69 5d 2c 22 2c 2e 2e 2e 22 29 3b  Temp[i],",...");
3600: 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65  .            bre
3610: 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  ak;.          }.
3620: 20 20 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b            zTemp[
3630: 69 2b 2b 5d 20 3d 20 27 2c 27 3b 0a 20 20 20 20  i++] = ',';.    
3640: 20 20 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e        if( pKeyIn
3650: 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20 26  fo->aSortOrder &
3660: 26 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72  & pKeyInfo->aSor
3670: 74 4f 72 64 65 72 5b 6a 5d 20 29 7b 0a 20 20 20  tOrder[j] ){.   
3680: 20 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b 69           zTemp[i
3690: 2b 2b 5d 20 3d 20 27 2d 27 3b 0a 20 20 20 20 20  ++] = '-';.     
36a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
36b0: 20 73 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69   strcpy(&zTemp[i
36c0: 5d 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29  ], pColl->zName)
36d0: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 20 2b 3d  ;.          i +=
36e0: 20 6e 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73   n;.        }els
36f0: 65 20 69 66 28 20 69 2b 34 3c 6e 54 65 6d 70 2d  e if( i+4<nTemp-
3700: 36 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73  6 ){.          s
3710: 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d 2c  trcpy(&zTemp[i],
3720: 22 2c 6e 69 6c 22 29 3b 0a 20 20 20 20 20 20 20  ",nil");.       
3730: 20 20 20 69 20 2b 3d 20 34 3b 0a 20 20 20 20 20     i += 4;.     
3740: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
3750: 20 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20     zTemp[i++] = 
3760: 27 29 27 3b 0a 20 20 20 20 20 20 7a 54 65 6d 70  ')';.      zTemp
3770: 5b 69 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 61  [i] = 0;.      a
3780: 73 73 65 72 74 28 20 69 3c 6e 54 65 6d 70 20 29  ssert( i<nTemp )
3790: 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54  ;.      zP3 = zT
37a0: 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  emp;.      break
37b0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
37c0: 20 50 33 5f 43 4f 4c 4c 53 45 51 3a 20 7b 0a 20   P3_COLLSEQ: {. 
37d0: 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43       CollSeq *pC
37e0: 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 2a 29  oll = (CollSeq*)
37f0: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 73  pOp->p3;.      s
3800: 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22 63  printf(zTemp, "c
3810: 6f 6c 6c 73 65 71 28 25 2e 32 30 73 29 22 2c 20  ollseq(%.20s)", 
3820: 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20  pColl->zName);. 
3830: 20 20 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70       zP3 = zTemp
3840: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;.      break;. 
3850: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 50 33     }.    case P3
3860: 5f 46 55 4e 43 44 45 46 3a 20 7b 0a 20 20 20 20  _FUNCDEF: {.    
3870: 20 20 46 75 6e 63 44 65 66 20 2a 70 44 65 66 20    FuncDef *pDef 
3880: 3d 20 28 46 75 6e 63 44 65 66 2a 29 70 4f 70 2d  = (FuncDef*)pOp-
3890: 3e 70 33 3b 0a 20 20 20 20 20 20 63 68 61 72 20  >p3;.      char 
38a0: 7a 4e 75 6d 5b 33 30 5d 3b 0a 20 20 20 20 20 20  zNum[30];.      
38b0: 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22  sprintf(zTemp, "
38c0: 25 2e 2a 73 22 2c 20 6e 54 65 6d 70 2c 20 70 44  %.*s", nTemp, pD
38d0: 65 66 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20  ef->zName);.    
38e0: 20 20 73 70 72 69 6e 74 66 28 7a 4e 75 6d 2c 22    sprintf(zNum,"
38f0: 28 25 64 29 22 2c 20 70 44 65 66 2d 3e 6e 41 72  (%d)", pDef->nAr
3900: 67 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 74  g);.      if( st
3910: 72 6c 65 6e 28 7a 54 65 6d 70 29 2b 73 74 72 6c  rlen(zTemp)+strl
3920: 65 6e 28 7a 4e 75 6d 29 2b 31 3c 3d 6e 54 65 6d  en(zNum)+1<=nTem
3930: 70 20 29 7b 0a 20 20 20 20 20 20 20 20 73 74 72  p ){.        str
3940: 63 61 74 28 7a 54 65 6d 70 2c 20 7a 4e 75 6d 29  cat(zTemp, zNum)
3950: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
3960: 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20  zP3 = zTemp;.   
3970: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
3980: 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20      default: {. 
3990: 20 20 20 20 20 7a 50 33 20 3d 20 70 4f 70 2d 3e       zP3 = pOp->
39a0: 70 33 3b 0a 20 20 20 20 20 20 69 66 28 20 7a 50  p3;.      if( zP
39b0: 33 3d 3d 30 20 7c 7c 20 70 4f 70 2d 3e 6f 70 63  3==0 || pOp->opc
39c0: 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a  ode==OP_Noop ){.
39d0: 20 20 20 20 20 20 20 20 7a 50 33 20 3d 20 22 22          zP3 = ""
39e0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
39f0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 50 33    }.  return zP3
3a00: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66  ;.}.#endif...#if
3a10: 20 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52   defined(VDBE_PR
3a20: 4f 46 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e 65  OFILE) || define
3a30: 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a  d(SQLITE_DEBUG).
3a40: 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 61 20 73 69  /*.** Print a si
3a50: 6e 67 6c 65 20 6f 70 63 6f 64 65 2e 20 20 54 68  ngle opcode.  Th
3a60: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73  is routine is us
3a70: 65 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67  ed for debugging
3a80: 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73   only..*/.void s
3a90: 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f  qlite3VdbePrintO
3aa0: 70 28 46 49 4c 45 20 2a 70 4f 75 74 2c 20 69 6e  p(FILE *pOut, in
3ab0: 74 20 70 63 2c 20 4f 70 20 2a 70 4f 70 29 7b 0a  t pc, Op *pOp){.
3ac0: 20 20 63 68 61 72 20 2a 7a 50 33 3b 0a 20 20 63    char *zP3;.  c
3ad0: 68 61 72 20 7a 50 74 72 5b 35 30 5d 3b 0a 20 20  har zPtr[50];.  
3ae0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61  static const cha
3af0: 72 20 2a 7a 46 6f 72 6d 61 74 31 20 3d 20 22 25  r *zFormat1 = "%
3b00: 34 64 20 25 2d 31 33 73 20 25 34 64 20 25 34 64  4d %-13s %4d %4d
3b10: 20 25 73 5c 6e 22 3b 0a 20 20 69 66 28 20 70 4f   %s\n";.  if( pO
3b20: 75 74 3d 3d 30 20 29 20 70 4f 75 74 20 3d 20 73  ut==0 ) pOut = s
3b30: 74 64 6f 75 74 3b 0a 20 20 7a 50 33 20 3d 20 64  tdout;.  zP3 = d
3b40: 69 73 70 6c 61 79 50 33 28 70 4f 70 2c 20 7a 50  isplayP3(pOp, zP
3b50: 74 72 2c 20 73 69 7a 65 6f 66 28 7a 50 74 72 29  tr, sizeof(zPtr)
3b60: 29 3b 0a 20 20 66 70 72 69 6e 74 66 28 70 4f 75  );.  fprintf(pOu
3b70: 74 2c 20 7a 46 6f 72 6d 61 74 31 2c 0a 20 20 20  t, zFormat1,.   
3b80: 20 20 20 70 63 2c 20 73 71 6c 69 74 65 33 4f 70     pc, sqlite3Op
3b90: 63 6f 64 65 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f  codeNames[pOp->o
3ba0: 70 63 6f 64 65 5d 2c 20 70 4f 70 2d 3e 70 31 2c  pcode], pOp->p1,
3bb0: 20 70 4f 70 2d 3e 70 32 2c 20 7a 50 33 29 3b 0a   pOp->p2, zP3);.
3bc0: 20 20 66 66 6c 75 73 68 28 70 4f 75 74 29 3b 0a    fflush(pOut);.
3bd0: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  }.#endif../*.** 
3be0: 52 65 6c 65 61 73 65 20 61 6e 20 61 72 72 61 79  Release an array
3bf0: 20 6f 66 20 4e 20 4d 65 6d 20 65 6c 65 6d 65 6e   of N Mem elemen
3c00: 74 73 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  ts.*/.static voi
3c10: 64 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61  d releaseMemArra
3c20: 79 28 4d 65 6d 20 2a 70 2c 20 69 6e 74 20 4e 29  y(Mem *p, int N)
3c30: 7b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20  {.  if( p ){.   
3c40: 20 77 68 69 6c 65 28 20 4e 2d 2d 3e 30 20 29 7b   while( N-->0 ){
3c50: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
3c60: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 70 2b 2b  beMemRelease(p++
3c70: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a  );.    }.  }.}..
3c80: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
3c90: 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 2f 2a 0a 2a  MIT_EXPLAIN./*.*
3ca0: 2a 20 47 69 76 65 20 61 20 6c 69 73 74 69 6e 67  * Give a listing
3cb0: 20 6f 66 20 74 68 65 20 70 72 6f 67 72 61 6d 20   of the program 
3cc0: 69 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d  in the virtual m
3cd0: 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  achine..**.** Th
3ce0: 65 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 74  e interface is t
3cf0: 68 65 20 73 61 6d 65 20 61 73 20 73 71 6c 69 74  he same as sqlit
3d00: 65 33 56 64 62 65 45 78 65 63 28 29 2e 20 20 42  e3VdbeExec().  B
3d10: 75 74 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a  ut instead of.**
3d20: 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 63 6f 64   running the cod
3d30: 65 2c 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68  e, it invokes th
3d40: 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20  e callback once 
3d50: 66 6f 72 20 65 61 63 68 20 69 6e 73 74 72 75 63  for each instruc
3d60: 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 66 65  tion..** This fe
3d70: 61 74 75 72 65 20 69 73 20 75 73 65 64 20 74 6f  ature is used to
3d80: 20 69 6d 70 6c 65 6d 65 6e 74 20 22 45 58 50 4c   implement "EXPL
3d90: 41 49 4e 22 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  AIN"..*/.int sql
3da0: 69 74 65 33 56 64 62 65 4c 69 73 74 28 0a 20 20  ite3VdbeList(.  
3db0: 56 64 62 65 20 2a 70 20 20 20 20 20 20 20 20 20  Vdbe *p         
3dc0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
3dd0: 20 56 44 42 45 20 2a 2f 0a 29 7b 0a 20 20 73 71   VDBE */.){.  sq
3de0: 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64  lite3 *db = p->d
3df0: 62 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e  b;.  int i;.  in
3e00: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
3e10: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  ;..  assert( p->
3e20: 65 78 70 6c 61 69 6e 20 29 3b 0a 20 20 69 66 28  explain );.  if(
3e30: 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f   p->magic!=VDBE_
3e40: 4d 41 47 49 43 5f 52 55 4e 20 29 20 72 65 74 75  MAGIC_RUN ) retu
3e50: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
3e60: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e  ;.  assert( db->
3e70: 6d 61 67 69 63 3d 3d 53 51 4c 49 54 45 5f 4d 41  magic==SQLITE_MA
3e80: 47 49 43 5f 42 55 53 59 20 29 3b 0a 20 20 61 73  GIC_BUSY );.  as
3e90: 73 65 72 74 28 20 70 2d 3e 72 63 3d 3d 53 51 4c  sert( p->rc==SQL
3ea0: 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 72 63 3d  ITE_OK || p->rc=
3eb0: 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29 3b 0a  =SQLITE_BUSY );.
3ec0: 0a 20 20 2f 2a 20 45 76 65 6e 20 74 68 6f 75 67  .  /* Even thoug
3ed0: 68 20 74 68 69 73 20 6f 70 63 6f 64 65 20 64 6f  h this opcode do
3ee0: 65 73 20 6e 6f 74 20 70 75 74 20 64 79 6e 61 6d  es not put dynam
3ef0: 69 63 20 73 74 72 69 6e 67 73 20 6f 6e 74 6f 20  ic strings onto 
3f00: 74 68 65 0a 20 20 2a 2a 20 74 68 65 20 73 74 61  the.  ** the sta
3f10: 63 6b 2c 20 74 68 65 79 20 6d 61 79 20 62 65 63  ck, they may bec
3f20: 6f 6d 65 20 64 79 6e 61 6d 69 63 20 69 66 20 74  ome dynamic if t
3f30: 68 65 20 75 73 65 72 20 63 61 6c 6c 73 0a 20 20  he user calls.  
3f40: 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  ** sqlite3_colum
3f50: 6e 5f 74 65 78 74 31 36 28 29 2c 20 63 61 75 73  n_text16(), caus
3f60: 69 6e 67 20 61 20 74 72 61 6e 73 6c 61 74 69 6f  ing a translatio
3f70: 6e 20 74 6f 20 55 54 46 2d 31 36 20 65 6e 63 6f  n to UTF-16 enco
3f80: 64 69 6e 67 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ding..  */.  if(
3f90: 20 70 2d 3e 70 54 6f 73 3d 3d 26 70 2d 3e 61 53   p->pTos==&p->aS
3fa0: 74 61 63 6b 5b 34 5d 20 29 7b 0a 20 20 20 20 72  tack[4] ){.    r
3fb0: 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70  eleaseMemArray(p
3fc0: 2d 3e 61 53 74 61 63 6b 2c 20 35 29 3b 0a 20 20  ->aStack, 5);.  
3fd0: 7d 0a 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61 63  }.  p->resOnStac
3fe0: 6b 20 3d 20 30 3b 0a 0a 0a 20 20 69 20 3d 20 70  k = 0;...  i = p
3ff0: 2d 3e 70 63 2b 2b 3b 0a 20 20 69 66 28 20 69 3e  ->pc++;.  if( i>
4000: 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20 20 20 70  =p->nOp ){.    p
4010: 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  ->rc = SQLITE_OK
4020: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ;.    rc = SQLIT
4030: 45 5f 44 4f 4e 45 3b 0a 20 20 7d 65 6c 73 65 20  E_DONE;.  }else 
4040: 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20  if( db->flags & 
4050: 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74  SQLITE_Interrupt
4060: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67   ){.    db->flag
4070: 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e 74  s &= ~SQLITE_Int
4080: 65 72 72 75 70 74 3b 0a 20 20 20 20 70 2d 3e 72  errupt;.    p->r
4090: 63 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45 52  c = SQLITE_INTER
40a0: 52 55 50 54 3b 0a 20 20 20 20 72 63 20 3d 20 53  RUPT;.    rc = S
40b0: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20  QLITE_ERROR;.   
40c0: 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e   sqlite3SetStrin
40d0: 67 28 26 70 2d 3e 7a 45 72 72 4d 73 67 2c 20 73  g(&p->zErrMsg, s
40e0: 71 6c 69 74 65 33 45 72 72 53 74 72 28 70 2d 3e  qlite3ErrStr(p->
40f0: 72 63 29 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a  rc), (char*)0);.
4100: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 4f 70 20    }else{.    Op 
4110: 2a 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69  *pOp = &p->aOp[i
4120: 5d 3b 0a 20 20 20 20 4d 65 6d 20 2a 70 4d 65 6d  ];.    Mem *pMem
4130: 20 3d 20 70 2d 3e 61 53 74 61 63 6b 3b 0a 20 20   = p->aStack;.  
4140: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
4150: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70 4d 65  MEM_Int;.    pMe
4160: 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45  m->type = SQLITE
4170: 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70 4d  _INTEGER;.    pM
4180: 65 6d 2d 3e 69 20 3d 20 69 3b 20 20 20 20 20 20  em->i = i;      
4190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
41a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 6f            /* Pro
41b0: 67 72 61 6d 20 63 6f 75 6e 74 65 72 20 2a 2f 0a  gram counter */.
41c0: 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20      pMem++;..   
41d0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
41e0: 45 4d 5f 53 74 61 74 69 63 7c 4d 45 4d 5f 53 74  EM_Static|MEM_St
41f0: 72 7c 4d 45 4d 5f 54 65 72 6d 3b 0a 20 20 20 20  r|MEM_Term;.    
4200: 70 4d 65 6d 2d 3e 7a 20 3d 20 73 71 6c 69 74 65  pMem->z = sqlite
4210: 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70 4f 70  3OpcodeNames[pOp
4220: 2d 3e 6f 70 63 6f 64 65 5d 3b 20 20 2f 2a 20 4f  ->opcode];  /* O
4230: 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 70 4d 65  pcode */.    pMe
4240: 6d 2d 3e 6e 20 3d 20 73 74 72 6c 65 6e 28 70 4d  m->n = strlen(pM
4250: 65 6d 2d 3e 7a 29 3b 0a 20 20 20 20 70 4d 65 6d  em->z);.    pMem
4260: 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f  ->type = SQLITE_
4270: 54 45 58 54 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  TEXT;.    pMem->
4280: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46  enc = SQLITE_UTF
4290: 38 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a  8;.    pMem++;..
42a0: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
42b0: 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70  = MEM_Int;.    p
42c0: 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70 2d 3e 70 31  Mem->i = pOp->p1
42d0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
42e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 31             /* P1
42f0: 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79   */.    pMem->ty
4300: 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45  pe = SQLITE_INTE
4310: 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b  GER;.    pMem++;
4320: 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67  ..    pMem->flag
4330: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
4340: 20 70 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70 2d 3e   pMem->i = pOp->
4350: 70 32 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  p2;             
4360: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4370: 50 32 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e  P2 */.    pMem->
4380: 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e  type = SQLITE_IN
4390: 54 45 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2b  TEGER;.    pMem+
43a0: 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  +;..    pMem->fl
43b0: 61 67 73 20 3d 20 4d 45 4d 5f 53 68 6f 72 74 7c  ags = MEM_Short|
43c0: 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 54 65 72 6d  MEM_Str|MEM_Term
43d0: 3b 20 20 20 2f 2a 20 50 33 20 2a 2f 0a 20 20 20  ;   /* P3 */.   
43e0: 20 70 4d 65 6d 2d 3e 7a 20 3d 20 64 69 73 70 6c   pMem->z = displ
43f0: 61 79 50 33 28 70 4f 70 2c 20 70 4d 65 6d 2d 3e  ayP3(pOp, pMem->
4400: 7a 53 68 6f 72 74 2c 20 73 69 7a 65 6f 66 28 70  zShort, sizeof(p
4410: 4d 65 6d 2d 3e 7a 53 68 6f 72 74 29 29 3b 0a 20  Mem->zShort));. 
4420: 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20     pMem->type = 
4430: 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20 20 20  SQLITE_TEXT;.   
4440: 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20 53 51 4c   pMem->enc = SQL
4450: 49 54 45 5f 55 54 46 38 3b 0a 0a 20 20 20 20 70  ITE_UTF8;..    p
4460: 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3d 20 35  ->nResColumn = 5
4470: 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d 20  ;.    p->pTos = 
4480: 70 4d 65 6d 3b 0a 20 20 20 20 70 2d 3e 72 63 20  pMem;.    p->rc 
4490: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20  = SQLITE_OK;.   
44a0: 20 70 2d 3e 72 65 73 4f 6e 53 74 61 63 6b 20 3d   p->resOnStack =
44b0: 20 31 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c   1;.    rc = SQL
44c0: 49 54 45 5f 52 4f 57 3b 0a 20 20 7d 0a 20 20 72  ITE_ROW;.  }.  r
44d0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64  eturn rc;.}.#end
44e0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
44f0: 54 5f 45 58 50 4c 41 49 4e 20 2a 2f 0a 0a 2f 2a  T_EXPLAIN */../*
4500: 0a 2a 2a 20 50 72 69 6e 74 20 74 68 65 20 53 51  .** Print the SQ
4510: 4c 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20  L that was used 
4520: 74 6f 20 67 65 6e 65 72 61 74 65 20 61 20 56 44  to generate a VD
4530: 42 45 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 76  BE program..*/.v
4540: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 50  oid sqlite3VdbeP
4550: 72 69 6e 74 53 71 6c 28 56 64 62 65 20 2a 70 29  rintSql(Vdbe *p)
4560: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  {.#ifdef SQLITE_
4570: 44 45 42 55 47 0a 20 20 69 6e 74 20 6e 4f 70 20  DEBUG.  int nOp 
4580: 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 56 64 62 65  = p->nOp;.  Vdbe
4590: 4f 70 20 2a 70 4f 70 3b 0a 20 20 69 66 28 20 6e  Op *pOp;.  if( n
45a0: 4f 70 3c 31 20 29 20 72 65 74 75 72 6e 3b 0a 20  Op<1 ) return;. 
45b0: 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 6e   pOp = &p->aOp[n
45c0: 4f 70 2d 31 5d 3b 0a 20 20 69 66 28 20 70 4f 70  Op-1];.  if( pOp
45d0: 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f  ->opcode==OP_Noo
45e0: 70 20 26 26 20 70 4f 70 2d 3e 70 33 21 3d 30 20  p && pOp->p3!=0 
45f0: 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61  ){.    const cha
4600: 72 20 2a 7a 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a  r *z = pOp->p3;.
4610: 20 20 20 20 77 68 69 6c 65 28 20 69 73 73 70 61      while( isspa
4620: 63 65 28 2a 28 75 38 2a 29 7a 29 20 29 20 7a 2b  ce(*(u8*)z) ) z+
4630: 2b 3b 0a 20 20 20 20 70 72 69 6e 74 66 28 22 53  +;.    printf("S
4640: 51 4c 3a 20 5b 25 73 5d 5c 6e 22 2c 20 7a 29 3b  QL: [%s]\n", z);
4650: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f  .  }.#endif.}../
4660: 2a 0a 2a 2a 20 50 72 65 70 61 72 65 20 61 20 76  *.** Prepare a v
4670: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 66  irtual machine f
4680: 6f 72 20 65 78 65 63 75 74 69 6f 6e 2e 20 20 54  or execution.  T
4690: 68 69 73 20 69 6e 76 6f 6c 76 65 73 20 74 68 69  his involves thi
46a0: 6e 67 73 20 73 75 63 68 0a 2a 2a 20 61 73 20 61  ngs such.** as a
46b0: 6c 6c 6f 63 61 74 69 6e 67 20 73 74 61 63 6b 20  llocating stack 
46c0: 73 70 61 63 65 20 61 6e 64 20 69 6e 69 74 69 61  space and initia
46d0: 6c 69 7a 69 6e 67 20 74 68 65 20 70 72 6f 67 72  lizing the progr
46e0: 61 6d 20 63 6f 75 6e 74 65 72 2e 0a 2a 2a 20 41  am counter..** A
46f0: 66 74 65 72 20 74 68 65 20 56 44 42 45 20 68 61  fter the VDBE ha
4700: 73 20 62 65 20 70 72 65 70 70 65 64 2c 20 69 74  s be prepped, it
4710: 20 63 61 6e 20 62 65 20 65 78 65 63 75 74 65 64   can be executed
4720: 20 62 79 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 0a   by one or more.
4730: 2a 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69  ** calls to sqli
4740: 74 65 33 56 64 62 65 45 78 65 63 28 29 2e 20 20  te3VdbeExec().  
4750: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74  .**.** This is t
4760: 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 6d  he only way to m
4770: 6f 76 65 20 61 20 56 44 42 45 20 66 72 6f 6d 20  ove a VDBE from 
4780: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
4790: 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43  to.** VDBE_MAGIC
47a0: 5f 52 55 4e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  _RUN..*/.void sq
47b0: 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61  lite3VdbeMakeRea
47c0: 64 79 28 0a 20 20 56 64 62 65 20 2a 70 2c 20 20  dy(.  Vdbe *p,  
47d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
47e0: 20 20 20 20 20 2f 2a 20 54 68 65 20 56 44 42 45       /* The VDBE
47f0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 61 72 2c 20   */.  int nVar, 
4800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4810: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
4820: 66 20 27 3f 27 20 73 65 65 20 69 6e 20 74 68 65  f '?' see in the
4830: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 2a   SQL statement *
4840: 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 2c 20 20 20  /.  int nMem,   
4850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4860: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
4870: 6d 65 6d 6f 72 79 20 63 65 6c 6c 73 20 74 6f 20  memory cells to 
4880: 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a 20 20 69 6e  allocate */.  in
4890: 74 20 6e 43 75 72 73 6f 72 2c 20 20 20 20 20 20  t nCursor,      
48a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
48b0: 4e 75 6d 62 65 72 20 6f 66 20 63 75 72 73 6f 72  Number of cursor
48c0: 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f  s to allocate */
48d0: 0a 20 20 69 6e 74 20 6e 41 67 67 2c 20 20 20 20  .  int nAgg,    
48e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
48f0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61    /* Number of a
4900: 67 67 72 65 67 61 74 65 20 63 6f 6e 74 65 78 74  ggregate context
4910: 73 20 72 65 71 75 69 72 65 64 20 2a 2f 0a 20 20  s required */.  
4920: 69 6e 74 20 69 73 45 78 70 6c 61 69 6e 20 20 20  int isExplain   
4930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
4940: 2a 20 54 72 75 65 20 69 66 20 74 68 65 20 45 58  * True if the EX
4950: 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64 73 20 69  PLAIN keywords i
4960: 73 20 70 72 65 73 65 6e 74 20 2a 2f 0a 29 7b 0a  s present */.){.
4970: 20 20 69 6e 74 20 6e 3b 0a 0a 20 20 61 73 73 65    int n;..  asse
4980: 72 74 28 20 70 21 3d 30 20 29 3b 0a 20 20 61 73  rt( p!=0 );.  as
4990: 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d  sert( p->magic==
49a0: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
49b0: 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 72 65 20 73  );..  /* There s
49c0: 68 6f 75 6c 64 20 62 65 20 61 74 20 6c 65 61 73  hould be at leas
49d0: 74 20 6f 6e 65 20 6f 70 63 6f 64 65 2e 0a 20 20  t one opcode..  
49e0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  */.  assert( p->
49f0: 6e 4f 70 3e 30 20 29 3b 0a 0a 20 20 2f 2a 20 53  nOp>0 );..  /* S
4a00: 65 74 20 74 68 65 20 6d 61 67 69 63 20 74 6f 20  et the magic to 
4a10: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 73  VDBE_MAGIC_RUN s
4a20: 6f 6f 6e 65 72 20 72 61 74 68 65 72 20 74 68 61  ooner rather tha
4a30: 6e 20 6c 61 74 65 72 2e 20 54 68 69 73 0a 20 20  n later. This.  
4a40: 20 2a 20 69 73 20 62 65 63 61 75 73 65 20 74 68   * is because th
4a50: 65 20 63 61 6c 6c 20 74 6f 20 72 65 73 69 7a 65  e call to resize
4a60: 4f 70 41 72 72 61 79 28 29 20 62 65 6c 6f 77 20  OpArray() below 
4a70: 6d 61 79 20 73 68 72 69 6e 6b 20 74 68 65 0a 20  may shrink the. 
4a80: 20 20 2a 20 70 2d 3e 61 4f 70 5b 5d 20 61 72 72    * p->aOp[] arr
4a90: 61 79 20 74 6f 20 73 61 76 65 20 6d 65 6d 6f 72  ay to save memor
4aa0: 79 20 69 66 20 63 61 6c 6c 65 64 20 77 68 65 6e  y if called when
4ab0: 20 69 6e 20 56 44 42 45 5f 4d 41 47 49 43 5f 52   in VDBE_MAGIC_R
4ac0: 55 4e 20 0a 20 20 20 2a 20 73 74 61 74 65 2e 0a  UN .   * state..
4ad0: 20 20 20 2a 2f 0a 20 20 70 2d 3e 6d 61 67 69 63     */.  p->magic
4ae0: 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 52 55   = VDBE_MAGIC_RU
4af0: 4e 3b 0a 0a 20 20 2f 2a 20 4e 6f 20 69 6e 73 74  N;..  /* No inst
4b00: 72 75 63 74 69 6f 6e 20 65 76 65 72 20 70 75 73  ruction ever pus
4b10: 68 65 73 20 6d 6f 72 65 20 74 68 61 6e 20 61 20  hes more than a 
4b20: 73 69 6e 67 6c 65 20 65 6c 65 6d 65 6e 74 20 6f  single element o
4b30: 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 73 74 61  nto the.  ** sta
4b40: 63 6b 2e 20 20 41 6e 64 20 74 68 65 20 73 74 61  ck.  And the sta
4b50: 63 6b 20 6e 65 76 65 72 20 67 72 6f 77 73 20 6f  ck never grows o
4b60: 6e 20 73 75 63 63 65 73 73 69 76 65 20 65 78 65  n successive exe
4b70: 63 75 74 69 6f 6e 73 20 6f 66 20 74 68 65 0a 20  cutions of the. 
4b80: 20 2a 2a 20 73 61 6d 65 20 6c 6f 6f 70 2e 20 20   ** same loop.  
4b90: 53 6f 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d  So the total num
4ba0: 62 65 72 20 6f 66 20 69 6e 73 74 72 75 63 74 69  ber of instructi
4bb0: 6f 6e 73 20 69 73 20 61 6e 20 75 70 70 65 72 20  ons is an upper 
4bc0: 62 6f 75 6e 64 0a 20 20 2a 2a 20 6f 6e 20 74 68  bound.  ** on th
4bd0: 65 20 6d 61 78 69 6d 75 6d 20 73 74 61 63 6b 20  e maximum stack 
4be0: 64 65 70 74 68 20 72 65 71 75 69 72 65 64 2e 0a  depth required..
4bf0: 20 20 2a 2a 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61    **.  ** Alloca
4c00: 74 69 6f 6e 20 61 6c 6c 20 74 68 65 20 73 74 61  tion all the sta
4c10: 63 6b 20 73 70 61 63 65 20 77 65 20 77 69 6c 6c  ck space we will
4c20: 20 65 76 65 72 20 6e 65 65 64 2e 0a 20 20 2a 2f   ever need..  */
4c30: 0a 20 20 69 66 28 20 70 2d 3e 61 53 74 61 63 6b  .  if( p->aStack
4c40: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e  ==0 ){.    int n
4c50: 41 72 67 3b 20 20 20 20 20 20 20 2f 2a 20 4d 61  Arg;       /* Ma
4c60: 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20  ximum number of 
4c70: 61 72 67 73 20 70 61 73 73 65 64 20 74 6f 20 61  args passed to a
4c80: 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20   user function. 
4c90: 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 53 74 61 63  */.    int nStac
4ca0: 6b 3b 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75  k;     /* Maximu
4cb0: 6d 20 6e 75 6d 62 65 72 20 6f 66 20 73 74 61 63  m number of stac
4cc0: 6b 20 65 6e 74 72 69 65 73 20 72 65 71 75 69 72  k entries requir
4cd0: 65 64 20 2a 2f 0a 20 20 20 20 72 65 73 6f 6c 76  ed */.    resolv
4ce0: 65 50 32 56 61 6c 75 65 73 28 70 2c 20 26 6e 41  eP2Values(p, &nA
4cf0: 72 67 2c 20 26 6e 53 74 61 63 6b 29 3b 0a 20 20  rg, &nStack);.  
4d00: 20 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28    resizeOpArray(
4d10: 70 2c 20 70 2d 3e 6e 4f 70 29 3b 0a 20 20 20 20  p, p->nOp);.    
4d20: 61 73 73 65 72 74 28 20 6e 56 61 72 3e 3d 30 20  assert( nVar>=0 
4d30: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e  );.    assert( n
4d40: 53 74 61 63 6b 3c 70 2d 3e 6e 4f 70 20 29 3b 0a  Stack<p->nOp );.
4d50: 20 20 20 20 6e 53 74 61 63 6b 20 3d 20 69 73 45      nStack = isE
4d60: 78 70 6c 61 69 6e 20 3f 20 31 30 20 3a 20 6e 53  xplain ? 10 : nS
4d70: 74 61 63 6b 3b 0a 20 20 20 20 70 2d 3e 61 53 74  tack;.    p->aSt
4d80: 61 63 6b 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c  ack = sqliteMall
4d90: 6f 63 28 0a 20 20 20 20 20 20 20 20 6e 53 74 61  oc(.        nSta
4da0: 63 6b 2a 73 69 7a 65 6f 66 28 70 2d 3e 61 53 74  ck*sizeof(p->aSt
4db0: 61 63 6b 5b 30 5d 29 20 20 20 20 2f 2a 20 61 53  ack[0])    /* aS
4dc0: 74 61 63 6b 20 2a 2f 0a 20 20 20 20 20 20 2b 20  tack */.      + 
4dd0: 6e 41 72 67 2a 73 69 7a 65 6f 66 28 4d 65 6d 2a  nArg*sizeof(Mem*
4de0: 29 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  )              /
4df0: 2a 20 61 70 41 72 67 20 2a 2f 0a 20 20 20 20 20  * apArg */.     
4e00: 20 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66 28 4d   + nVar*sizeof(M
4e10: 65 6d 29 20 20 20 20 20 20 20 20 20 20 20 20 20  em)             
4e20: 20 20 2f 2a 20 61 56 61 72 20 2a 2f 0a 20 20 20    /* aVar */.   
4e30: 20 20 20 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66     + nVar*sizeof
4e40: 28 63 68 61 72 2a 29 20 20 20 20 20 20 20 20 20  (char*)         
4e50: 20 20 20 20 2f 2a 20 61 7a 56 61 72 20 2a 2f 0a      /* azVar */.
4e60: 20 20 20 20 20 20 2b 20 6e 4d 65 6d 2a 73 69 7a        + nMem*siz
4e70: 65 6f 66 28 4d 65 6d 29 20 20 20 20 20 20 20 20  eof(Mem)        
4e80: 20 20 20 20 20 20 20 2f 2a 20 61 4d 65 6d 20 2a         /* aMem *
4e90: 2f 0a 20 20 20 20 20 20 2b 20 6e 43 75 72 73 6f  /.      + nCurso
4ea0: 72 2a 73 69 7a 65 6f 66 28 43 75 72 73 6f 72 2a  r*sizeof(Cursor*
4eb0: 29 20 20 20 20 20 20 20 20 2f 2a 20 61 70 43 73  )        /* apCs
4ec0: 72 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 41 67  r */.      + nAg
4ed0: 67 2a 73 69 7a 65 6f 66 28 41 67 67 29 20 20 20  g*sizeof(Agg)   
4ee0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41              /* A
4ef0: 67 67 72 65 67 61 74 65 20 63 6f 6e 74 65 78 74  ggregate context
4f00: 73 20 2a 2f 0a 20 20 20 20 29 3b 0a 20 20 20 20  s */.    );.    
4f10: 69 66 28 20 21 73 71 6c 69 74 65 33 5f 6d 61 6c  if( !sqlite3_mal
4f20: 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20  loc_failed ){.  
4f30: 20 20 20 20 70 2d 3e 61 4d 65 6d 20 3d 20 26 70      p->aMem = &p
4f40: 2d 3e 61 53 74 61 63 6b 5b 6e 53 74 61 63 6b 5d  ->aStack[nStack]
4f50: 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 4d 65 6d 20  ;.      p->nMem 
4f60: 3d 20 6e 4d 65 6d 3b 0a 20 20 20 20 20 20 70 2d  = nMem;.      p-
4f70: 3e 61 56 61 72 20 3d 20 26 70 2d 3e 61 4d 65 6d  >aVar = &p->aMem
4f80: 5b 6e 4d 65 6d 5d 3b 0a 20 20 20 20 20 20 70 2d  [nMem];.      p-
4f90: 3e 6e 56 61 72 20 3d 20 6e 56 61 72 3b 0a 20 20  >nVar = nVar;.  
4fa0: 20 20 20 20 70 2d 3e 6f 6b 56 61 72 20 3d 20 30      p->okVar = 0
4fb0: 3b 0a 20 20 20 20 20 20 70 2d 3e 61 70 41 72 67  ;.      p->apArg
4fc0: 20 3d 20 28 4d 65 6d 2a 2a 29 26 70 2d 3e 61 56   = (Mem**)&p->aV
4fd0: 61 72 5b 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20  ar[nVar];.      
4fe0: 70 2d 3e 61 7a 56 61 72 20 3d 20 28 63 68 61 72  p->azVar = (char
4ff0: 2a 2a 29 26 70 2d 3e 61 70 41 72 67 5b 6e 41 72  **)&p->apArg[nAr
5000: 67 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 61 70 43  g];.      p->apC
5010: 73 72 20 3d 20 28 43 75 72 73 6f 72 2a 2a 29 26  sr = (Cursor**)&
5020: 70 2d 3e 61 7a 56 61 72 5b 6e 56 61 72 5d 3b 0a  p->azVar[nVar];.
5030: 20 20 20 20 20 20 69 66 28 20 6e 41 67 67 3e 30        if( nAgg>0
5040: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 6e   ){.        p->n
5050: 41 67 67 20 3d 20 6e 41 67 67 3b 0a 20 20 20 20  Agg = nAgg;.    
5060: 20 20 20 20 70 2d 3e 61 70 41 67 67 20 3d 20 28      p->apAgg = (
5070: 41 67 67 2a 29 26 70 2d 3e 61 70 43 73 72 5b 6e  Agg*)&p->apCsr[n
5080: 43 75 72 73 6f 72 5d 3b 0a 20 20 20 20 20 20 7d  Cursor];.      }
5090: 0a 20 20 20 20 20 20 70 2d 3e 6e 43 75 72 73 6f  .      p->nCurso
50a0: 72 20 3d 20 6e 43 75 72 73 6f 72 3b 0a 20 20 20  r = nCursor;.   
50b0: 20 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c 6e 56     for(n=0; n<nV
50c0: 61 72 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20 20 20  ar; n++){.      
50d0: 20 20 70 2d 3e 61 56 61 72 5b 6e 5d 2e 66 6c 61    p->aVar[n].fla
50e0: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20  gs = MEM_Null;. 
50f0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
5100: 0a 20 20 70 2d 3e 70 41 67 67 20 3d 20 70 2d 3e  .  p->pAgg = p->
5110: 61 70 41 67 67 3b 0a 20 20 66 6f 72 28 6e 3d 30  apAgg;.  for(n=0
5120: 3b 20 6e 3c 70 2d 3e 6e 4d 65 6d 3b 20 6e 2b 2b  ; n<p->nMem; n++
5130: 29 7b 0a 20 20 20 20 70 2d 3e 61 4d 65 6d 5b 6e  ){.    p->aMem[n
5140: 5d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75  ].flags = MEM_Nu
5150: 6c 6c 3b 0a 20 20 7d 0a 0a 23 69 66 64 65 66 20  ll;.  }..#ifdef 
5160: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 69  SQLITE_DEBUG.  i
5170: 66 28 20 28 70 2d 3e 64 62 2d 3e 66 6c 61 67 73  f( (p->db->flags
5180: 20 26 20 53 51 4c 49 54 45 5f 56 64 62 65 4c 69   & SQLITE_VdbeLi
5190: 73 74 69 6e 67 29 21 3d 30 0a 20 20 20 20 7c 7c  sting)!=0.    ||
51a0: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78   sqlite3OsFileEx
51b0: 69 73 74 73 28 22 76 64 62 65 5f 65 78 70 6c 61  ists("vdbe_expla
51c0: 69 6e 22 29 0a 20 20 29 7b 0a 20 20 20 20 69 6e  in").  ){.    in
51d0: 74 20 69 3b 0a 20 20 20 20 70 72 69 6e 74 66 28  t i;.    printf(
51e0: 22 56 44 42 45 20 50 72 6f 67 72 61 6d 20 4c 69  "VDBE Program Li
51f0: 73 74 69 6e 67 3a 5c 6e 22 29 3b 0a 20 20 20 20  sting:\n");.    
5200: 73 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74  sqlite3VdbePrint
5210: 53 71 6c 28 70 29 3b 0a 20 20 20 20 66 6f 72 28  Sql(p);.    for(
5220: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69  i=0; i<p->nOp; i
5230: 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ++){.      sqlit
5240: 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28 73 74  e3VdbePrintOp(st
5250: 64 6f 75 74 2c 20 69 2c 20 26 70 2d 3e 61 4f 70  dout, i, &p->aOp
5260: 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  [i]);.    }.  }.
5270: 20 20 69 66 28 20 73 71 6c 69 74 65 33 4f 73 46    if( sqlite3OsF
5280: 69 6c 65 45 78 69 73 74 73 28 22 76 64 62 65 5f  ileExists("vdbe_
5290: 74 72 61 63 65 22 29 20 29 7b 0a 20 20 20 20 70  trace") ){.    p
52a0: 2d 3e 74 72 61 63 65 20 3d 20 73 74 64 6f 75 74  ->trace = stdout
52b0: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70  ;.  }.#endif.  p
52c0: 2d 3e 70 54 6f 73 20 3d 20 26 70 2d 3e 61 53 74  ->pTos = &p->aSt
52d0: 61 63 6b 5b 2d 31 5d 3b 0a 20 20 70 2d 3e 70 63  ack[-1];.  p->pc
52e0: 20 3d 20 2d 31 3b 0a 20 20 70 2d 3e 72 63 20 3d   = -1;.  p->rc =
52f0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 70 2d   SQLITE_OK;.  p-
5300: 3e 75 6e 69 71 75 65 43 6e 74 20 3d 20 30 3b 0a  >uniqueCnt = 0;.
5310: 20 20 70 2d 3e 72 65 74 75 72 6e 44 65 70 74 68    p->returnDepth
5320: 20 3d 20 30 3b 0a 20 20 70 2d 3e 65 72 72 6f 72   = 0;.  p->error
5330: 41 63 74 69 6f 6e 20 3d 20 4f 45 5f 41 62 6f 72  Action = OE_Abor
5340: 74 3b 0a 20 20 70 2d 3e 70 6f 70 53 74 61 63 6b  t;.  p->popStack
5350: 20 3d 20 20 30 3b 0a 20 20 70 2d 3e 65 78 70 6c   =  0;.  p->expl
5360: 61 69 6e 20 7c 3d 20 69 73 45 78 70 6c 61 69 6e  ain |= isExplain
5370: 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56  ;.  p->magic = V
5380: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 3b 0a 20  DBE_MAGIC_RUN;. 
5390: 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b   p->nChange = 0;
53a0: 0a 23 69 66 64 65 66 20 56 44 42 45 5f 50 52 4f  .#ifdef VDBE_PRO
53b0: 46 49 4c 45 0a 20 20 7b 0a 20 20 20 20 69 6e 74  FILE.  {.    int
53c0: 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b   i;.    for(i=0;
53d0: 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b   i<p->nOp; i++){
53e0: 0a 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d  .      p->aOp[i]
53f0: 2e 63 6e 74 20 3d 20 30 3b 0a 20 20 20 20 20 20  .cnt = 0;.      
5400: 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73  p->aOp[i].cycles
5410: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
5420: 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  #endif.}.../*.**
5430: 20 52 65 6d 6f 76 65 20 61 6e 79 20 65 6c 65 6d   Remove any elem
5440: 65 6e 74 73 20 74 68 61 74 20 72 65 6d 61 69 6e  ents that remain
5450: 20 6f 6e 20 74 68 65 20 73 6f 72 74 65 72 20 66   on the sorter f
5460: 6f 72 20 74 68 65 20 56 44 42 45 20 67 69 76 65  or the VDBE give
5470: 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  n..*/.void sqlit
5480: 65 33 56 64 62 65 53 6f 72 74 65 72 52 65 73 65  e3VdbeSorterRese
5490: 74 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 77 68  t(Vdbe *p){.  wh
54a0: 69 6c 65 28 20 70 2d 3e 70 53 6f 72 74 20 29 7b  ile( p->pSort ){
54b0: 0a 20 20 20 20 53 6f 72 74 65 72 20 2a 70 53 6f  .    Sorter *pSo
54c0: 72 74 65 72 20 3d 20 70 2d 3e 70 53 6f 72 74 3b  rter = p->pSort;
54d0: 0a 20 20 20 20 70 2d 3e 70 53 6f 72 74 20 3d 20  .    p->pSort = 
54e0: 70 53 6f 72 74 65 72 2d 3e 70 4e 65 78 74 3b 0a  pSorter->pNext;.
54f0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
5500: 53 6f 72 74 65 72 2d 3e 7a 4b 65 79 29 3b 0a 20  Sorter->zKey);. 
5510: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
5520: 6d 52 65 6c 65 61 73 65 28 26 70 53 6f 72 74 65  mRelease(&pSorte
5530: 72 2d 3e 64 61 74 61 29 3b 0a 20 20 20 20 73 71  r->data);.    sq
5540: 6c 69 74 65 46 72 65 65 28 70 53 6f 72 74 65 72  liteFree(pSorter
5550: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
5560: 46 72 65 65 20 61 6c 6c 20 72 65 73 6f 75 72 63  Free all resourc
5570: 65 73 20 61 6c 6c 6f 63 69 61 74 65 64 20 77 69  es allociated wi
5580: 74 68 20 41 67 67 45 6c 65 6d 20 70 45 6c 65 6d  th AggElem pElem
5590: 2c 20 61 6e 20 65 6c 65 6d 65 6e 74 20 6f 66 0a  , an element of.
55a0: 2a 2a 20 61 67 67 72 65 67 61 74 65 20 70 41 67  ** aggregate pAg
55b0: 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  g..*/.static voi
55c0: 64 20 66 72 65 65 41 67 67 45 6c 65 6d 28 41 67  d freeAggElem(Ag
55d0: 67 45 6c 65 6d 20 2a 70 45 6c 65 6d 2c 20 41 67  gElem *pElem, Ag
55e0: 67 20 2a 70 41 67 67 29 7b 0a 20 20 69 6e 74 20  g *pAgg){.  int 
55f0: 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  i;.  for(i=0; i<
5600: 70 41 67 67 2d 3e 6e 4d 65 6d 3b 20 69 2b 2b 29  pAgg->nMem; i++)
5610: 7b 0a 20 20 20 20 4d 65 6d 20 2a 70 4d 65 6d 20  {.    Mem *pMem 
5620: 3d 20 26 70 45 6c 65 6d 2d 3e 61 4d 65 6d 5b 69  = &pElem->aMem[i
5630: 5d 3b 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d  ];.    if( pAgg-
5640: 3e 61 70 46 75 6e 63 20 26 26 20 70 41 67 67 2d  >apFunc && pAgg-
5650: 3e 61 70 46 75 6e 63 5b 69 5d 20 26 26 20 28 70  >apFunc[i] && (p
5660: 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d  Mem->flags & MEM
5670: 5f 41 67 67 43 74 78 29 21 3d 30 20 29 7b 0a 20  _AggCtx)!=0 ){. 
5680: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e       sqlite3_con
5690: 74 65 78 74 20 63 74 78 3b 0a 20 20 20 20 20 20  text ctx;.      
56a0: 63 74 78 2e 70 46 75 6e 63 20 3d 20 70 41 67 67  ctx.pFunc = pAgg
56b0: 2d 3e 61 70 46 75 6e 63 5b 69 5d 3b 0a 20 20 20  ->apFunc[i];.   
56c0: 20 20 20 63 74 78 2e 73 2e 66 6c 61 67 73 20 3d     ctx.s.flags =
56d0: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20   MEM_Null;.     
56e0: 20 63 74 78 2e 70 41 67 67 20 3d 20 70 4d 65 6d   ctx.pAgg = pMem
56f0: 2d 3e 7a 3b 0a 20 20 20 20 20 20 63 74 78 2e 63  ->z;.      ctx.c
5700: 6e 74 20 3d 20 70 4d 65 6d 2d 3e 69 3b 0a 20 20  nt = pMem->i;.  
5710: 20 20 20 20 63 74 78 2e 69 73 45 72 72 6f 72 20      ctx.isError 
5720: 3d 20 30 3b 0a 20 20 20 20 20 20 28 2a 63 74 78  = 0;.      (*ctx
5730: 2e 70 46 75 6e 63 2d 3e 78 46 69 6e 61 6c 69 7a  .pFunc->xFinaliz
5740: 65 29 28 26 63 74 78 29 3b 0a 20 20 20 20 20 20  e)(&ctx);.      
5750: 70 4d 65 6d 2d 3e 7a 20 3d 20 63 74 78 2e 70 41  pMem->z = ctx.pA
5760: 67 67 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4d  gg;.      if( pM
5770: 65 6d 2d 3e 7a 21 3d 30 20 26 26 20 70 4d 65 6d  em->z!=0 && pMem
5780: 2d 3e 7a 21 3d 70 4d 65 6d 2d 3e 7a 53 68 6f 72  ->z!=pMem->zShor
5790: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  t ){.        sql
57a0: 69 74 65 46 72 65 65 28 70 4d 65 6d 2d 3e 7a 29  iteFree(pMem->z)
57b0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
57c0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
57d0: 6c 65 61 73 65 28 26 63 74 78 2e 73 29 3b 0a 20  lease(&ctx.s);. 
57e0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
57f0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
5800: 6c 65 61 73 65 28 70 4d 65 6d 29 3b 0a 20 20 20  lease(pMem);.   
5810: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46   }.  }.  sqliteF
5820: 72 65 65 28 70 45 6c 65 6d 29 3b 0a 7d 0a 0a 2f  ree(pElem);.}../
5830: 2a 0a 2a 2a 20 52 65 73 65 74 20 61 6e 20 41 67  *.** Reset an Ag
5840: 67 20 73 74 72 75 63 74 75 72 65 2e 20 20 44 65  g structure.  De
5850: 6c 65 74 65 20 61 6c 6c 20 69 74 73 20 63 6f 6e  lete all its con
5860: 74 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72  tents..**.** For
5870: 20 69 6e 73 74 61 6c 6c 61 62 6c 65 20 61 67 67   installable agg
5880: 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73  regate functions
5890: 2c 20 69 66 20 74 68 65 20 73 74 65 70 20 66 75  , if the step fu
58a0: 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e 0a  nction has been.
58b0: 2a 2a 20 63 61 6c 6c 65 64 2c 20 6d 61 6b 65 20  ** called, make 
58c0: 73 75 72 65 20 74 68 65 20 66 69 6e 61 6c 69 7a  sure the finaliz
58d0: 65 72 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20  er function has 
58e0: 61 6c 73 6f 20 62 65 65 6e 20 63 61 6c 6c 65 64  also been called
58f0: 2e 20 20 54 68 65 0a 2a 2a 20 66 69 6e 61 6c 69  .  The.** finali
5900: 7a 65 72 20 6d 69 67 68 74 20 6e 65 65 64 20 74  zer might need t
5910: 6f 20 66 72 65 65 20 6d 65 6d 6f 72 79 20 74 68  o free memory th
5920: 61 74 20 77 61 73 20 61 6c 6c 6f 63 61 74 65 64  at was allocated
5930: 20 61 73 20 70 61 72 74 20 6f 66 20 69 74 73 0a   as part of its.
5940: 2a 2a 20 70 72 69 76 61 74 65 20 63 6f 6e 74 65  ** private conte
5950: 78 74 2e 20 20 49 66 20 74 68 65 20 66 69 6e 61  xt.  If the fina
5960: 6c 69 7a 65 72 20 68 61 73 20 6e 6f 74 20 62 65  lizer has not be
5970: 65 6e 20 63 61 6c 6c 65 64 20 79 65 74 2c 20 63  en called yet, c
5980: 61 6c 6c 20 69 74 0a 2a 2a 20 6e 6f 77 2e 0a 2a  all it.** now..*
5990: 2a 0a 2a 2a 20 49 66 20 64 62 20 69 73 20 4e 55  *.** If db is NU
59a0: 4c 4c 2c 20 74 68 65 6e 20 74 68 69 73 20 69 73  LL, then this is
59b0: 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 20 66 72   being called fr
59c0: 6f 6d 20 73 71 6c 69 74 65 56 64 62 65 52 65 73  om sqliteVdbeRes
59d0: 65 74 28 29 2e 20 49 6e 0a 2a 2a 20 74 68 69 73  et(). In.** this
59e0: 20 63 61 73 65 20 63 6c 65 61 6e 20 75 70 20 61   case clean up a
59f0: 6c 6c 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f  ll references to
5a00: 20 74 68 65 20 74 65 6d 70 2d 74 61 62 6c 65 20   the temp-table 
5a10: 75 73 65 64 20 66 6f 72 0a 2a 2a 20 61 67 67 72  used for.** aggr
5a20: 65 67 61 74 65 73 20 28 69 66 20 69 74 20 77 61  egates (if it wa
5a30: 73 20 65 76 65 72 20 6f 70 65 6e 65 64 29 2e 0a  s ever opened)..
5a40: 2a 2a 0a 2a 2a 20 49 66 20 64 62 20 69 73 20 6e  **.** If db is n
5a50: 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68  ot NULL, then th
5a60: 69 73 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c  is is being call
5a70: 65 64 20 66 72 6f 6d 20 77 69 74 68 20 61 6e 20  ed from with an 
5a80: 4f 50 5f 41 67 67 52 65 73 65 74 0a 2a 2a 20 6f  OP_AggReset.** o
5a90: 70 63 6f 64 65 2e 20 4f 70 65 6e 20 74 68 65 20  pcode. Open the 
5aa0: 74 65 6d 70 2d 74 61 62 6c 65 2c 20 69 66 20 69  temp-table, if i
5ab0: 74 20 68 61 73 20 6e 6f 74 20 61 6c 72 65 61 64  t has not alread
5ac0: 79 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 61 6e  y been opened an
5ad0: 64 0a 2a 2a 20 64 65 6c 65 74 65 20 74 68 65 20  d.** delete the 
5ae0: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20  contents of the 
5af0: 74 61 62 6c 65 20 75 73 65 64 20 66 6f 72 20 61  table used for a
5b00: 67 67 72 65 67 61 74 65 20 69 6e 66 6f 72 6d 61  ggregate informa
5b10: 74 69 6f 6e 2c 20 72 65 61 64 79 0a 2a 2a 20 66  tion, ready.** f
5b20: 6f 72 20 74 68 65 20 6e 65 78 74 20 72 6f 75 6e  or the next roun
5b30: 64 20 6f 66 20 61 67 67 72 65 67 61 74 65 20 70  d of aggregate p
5b40: 72 6f 63 65 73 73 69 6e 67 2e 0a 2a 2f 0a 69 6e  rocessing..*/.in
5b50: 74 20 73 71 6c 69 74 65 33 56 64 62 65 41 67 67  t sqlite3VdbeAgg
5b60: 52 65 73 65 74 28 73 71 6c 69 74 65 33 20 2a 64  Reset(sqlite3 *d
5b70: 62 2c 20 41 67 67 20 2a 70 41 67 67 2c 20 4b 65  b, Agg *pAgg, Ke
5b80: 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 29  yInfo *pKeyInfo)
5b90: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a  {.  int rc = 0;.
5ba0: 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 73 72    BtCursor *pCsr
5bb0: 3b 0a 0a 20 20 69 66 28 20 21 70 41 67 67 20 29  ;..  if( !pAgg )
5bc0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
5bd0: 4b 3b 0a 20 20 70 43 73 72 20 3d 20 70 41 67 67  K;.  pCsr = pAgg
5be0: 2d 3e 70 43 73 72 3b 0a 20 20 61 73 73 65 72 74  ->pCsr;.  assert
5bf0: 28 20 28 70 43 73 72 20 26 26 20 70 41 67 67 2d  ( (pCsr && pAgg-
5c00: 3e 6e 54 61 62 3e 30 29 20 7c 7c 20 28 21 70 43  >nTab>0) || (!pC
5c10: 73 72 20 26 26 20 70 41 67 67 2d 3e 6e 54 61 62  sr && pAgg->nTab
5c20: 3d 3d 30 29 0a 20 20 20 20 20 20 20 20 20 7c 7c  ==0).         ||
5c30: 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f   sqlite3_malloc_
5c40: 66 61 69 6c 65 64 20 29 3b 0a 0a 20 20 2f 2a 20  failed );..  /* 
5c50: 49 66 20 70 43 73 72 20 69 73 20 6e 6f 74 20 4e  If pCsr is not N
5c60: 55 4c 4c 2c 20 74 68 65 6e 20 74 68 65 20 74 61  ULL, then the ta
5c70: 62 6c 65 20 75 73 65 64 20 66 6f 72 20 61 67 67  ble used for agg
5c80: 72 65 67 61 74 65 20 69 6e 66 6f 72 6d 61 74 69  regate informati
5c90: 6f 6e 0a 20 20 2a 2a 20 69 73 20 6f 70 65 6e 2e  on.  ** is open.
5ca0: 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 69 74   Loop through it
5cb0: 20 61 6e 64 20 66 72 65 65 20 74 68 65 20 41 67   and free the Ag
5cc0: 67 45 6c 65 6d 2a 20 73 74 72 75 63 74 75 72 65  gElem* structure
5cd0: 20 70 6f 69 6e 74 65 64 20 61 74 0a 20 20 2a 2a   pointed at.  **
5ce0: 20 62 79 20 65 61 63 68 20 65 6e 74 72 79 2e 20   by each entry. 
5cf0: 49 66 20 74 68 65 20 66 69 6e 61 6c 69 7a 65 72  If the finalizer
5d00: 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 63 61   has not been ca
5d10: 6c 6c 65 64 20 66 6f 72 20 61 6e 20 41 67 67 45  lled for an AggE
5d20: 6c 65 6d 2c 0a 20 20 2a 2a 20 64 6f 20 74 68 61  lem,.  ** do tha
5d30: 74 20 74 6f 6f 2e 20 46 69 6e 61 6c 6c 79 2c 20  t too. Finally, 
5d40: 63 6c 65 61 72 20 74 68 65 20 62 74 72 65 65 20  clear the btree 
5d50: 74 61 62 6c 65 20 69 74 73 65 6c 66 2e 0a 20 20  table itself..  
5d60: 2a 2f 0a 20 20 69 66 28 20 70 43 73 72 20 29 7b  */.  if( pCsr ){
5d70: 0a 20 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20  .    int res;.  
5d80: 20 20 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e    assert( pAgg->
5d90: 70 42 74 72 65 65 20 29 3b 0a 20 20 20 20 61 73  pBtree );.    as
5da0: 73 65 72 74 28 20 70 41 67 67 2d 3e 6e 54 61 62  sert( pAgg->nTab
5db0: 3e 30 20 29 3b 0a 0a 20 20 20 20 72 63 3d 73 71  >0 );..    rc=sq
5dc0: 6c 69 74 65 33 42 74 72 65 65 46 69 72 73 74 28  lite3BtreeFirst(
5dd0: 70 43 73 72 2c 20 26 72 65 73 29 3b 0a 20 20 20  pCsr, &res);.   
5de0: 20 77 68 69 6c 65 28 20 72 65 73 3d 3d 30 20 26   while( res==0 &
5df0: 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  & rc==SQLITE_OK 
5e00: 29 7b 0a 20 20 20 20 20 20 41 67 67 45 6c 65 6d  ){.      AggElem
5e10: 20 2a 70 45 6c 65 6d 3b 0a 20 20 20 20 20 20 72   *pElem;.      r
5e20: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
5e30: 44 61 74 61 28 70 43 73 72 2c 20 30 2c 20 73 69  Data(pCsr, 0, si
5e40: 7a 65 6f 66 28 41 67 67 45 6c 65 6d 2a 29 2c 20  zeof(AggElem*), 
5e50: 28 63 68 61 72 20 2a 29 26 70 45 6c 65 6d 29 3b  (char *)&pElem);
5e60: 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53  .      if( rc!=S
5e70: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
5e80: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
5e90: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73       }.      ass
5ea0: 65 72 74 28 20 70 41 67 67 2d 3e 61 70 46 75 6e  ert( pAgg->apFun
5eb0: 63 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 66 72  c!=0 );.      fr
5ec0: 65 65 41 67 67 45 6c 65 6d 28 70 45 6c 65 6d 2c  eeAggElem(pElem,
5ed0: 20 70 41 67 67 29 3b 0a 20 20 20 20 20 20 72 63   pAgg);.      rc
5ee0: 3d 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78  =sqlite3BtreeNex
5ef0: 74 28 70 43 73 72 2c 20 26 72 65 73 29 3b 0a 20  t(pCsr, &res);. 
5f00: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 21     }.    if( rc!
5f10: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
5f20: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
5f30: 20 20 20 7d 0a 0a 20 20 20 20 73 71 6c 69 74 65     }..    sqlite
5f40: 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f  3BtreeCloseCurso
5f50: 72 28 70 43 73 72 29 3b 0a 20 20 20 20 73 71 6c  r(pCsr);.    sql
5f60: 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 54 61  ite3BtreeClearTa
5f70: 62 6c 65 28 70 41 67 67 2d 3e 70 42 74 72 65 65  ble(pAgg->pBtree
5f80: 2c 20 70 41 67 67 2d 3e 6e 54 61 62 29 3b 0a 20  , pAgg->nTab);. 
5f90: 20 7d 65 6c 73 65 7b 20 0a 20 20 20 20 2f 2a 20   }else{ .    /* 
5fa0: 54 68 65 20 63 75 72 73 6f 72 20 6d 61 79 20 6e  The cursor may n
5fb0: 6f 74 20 62 65 20 6f 70 65 6e 20 62 65 63 61 75  ot be open becau
5fc0: 73 65 20 74 68 65 20 61 67 67 72 65 67 61 74 6f  se the aggregato
5fd0: 72 20 77 61 73 20 6e 65 76 65 72 20 75 73 65 64  r was never used
5fe0: 2c 0a 20 20 20 20 2a 2a 20 6f 72 20 69 74 20 63  ,.    ** or it c
5ff0: 6f 75 6c 64 20 62 65 20 74 68 61 74 20 69 74 20  ould be that it 
6000: 77 61 73 20 75 73 65 64 20 62 75 74 20 74 68 65  was used but the
6010: 72 65 20 77 61 73 20 6e 6f 20 47 52 4f 55 50 20  re was no GROUP 
6020: 42 59 20 63 6c 61 75 73 65 2e 0a 20 20 20 20 2a  BY clause..    *
6030: 2f 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d 3e  /.    if( pAgg->
6040: 70 43 75 72 72 65 6e 74 20 29 7b 0a 20 20 20 20  pCurrent ){.    
6050: 20 20 66 72 65 65 41 67 67 45 6c 65 6d 28 70 41    freeAggElem(pA
6060: 67 67 2d 3e 70 43 75 72 72 65 6e 74 2c 20 70 41  gg->pCurrent, pA
6070: 67 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  gg);.    }.  }..
6080: 20 20 2f 2a 20 49 66 20 64 62 20 69 73 20 6e 6f    /* If db is no
6090: 74 20 4e 55 4c 4c 20 61 6e 64 20 77 65 20 68 61  t NULL and we ha
60a0: 76 65 20 6e 6f 74 20 79 65 74 20 61 6e 64 20 77  ve not yet and w
60b0: 65 20 68 61 76 65 20 6e 6f 74 20 79 65 74 20 6f  e have not yet o
60c0: 70 65 6e 65 64 0a 20 20 2a 2a 20 74 68 65 20 74  pened.  ** the t
60d0: 65 6d 70 6f 72 61 72 79 20 62 74 72 65 65 20 74  emporary btree t
60e0: 68 65 6e 20 64 6f 20 73 6f 20 61 6e 64 20 63 72  hen do so and cr
60f0: 65 61 74 65 20 74 68 65 20 74 61 62 6c 65 20 74  eate the table t
6100: 6f 20 73 74 6f 72 65 20 61 67 67 72 65 67 61 74  o store aggregat
6110: 65 0a 20 20 2a 2a 20 69 6e 66 6f 72 6d 61 74 69  e.  ** informati
6120: 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66  on..  **.  ** If
6130: 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65   db is NULL, the
6140: 6e 20 63 6c 6f 73 65 20 74 68 65 20 74 65 6d 70  n close the temp
6150: 6f 72 61 72 79 20 62 74 72 65 65 20 69 66 20 69  orary btree if i
6160: 74 20 69 73 20 6f 70 65 6e 2e 0a 20 20 2a 2f 0a  t is open..  */.
6170: 20 20 69 66 28 20 64 62 20 29 7b 0a 20 20 20 20    if( db ){.    
6180: 69 66 28 20 21 70 41 67 67 2d 3e 70 42 74 72 65  if( !pAgg->pBtre
6190: 65 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72  e ){.      asser
61a0: 74 28 20 70 41 67 67 2d 3e 6e 54 61 62 3d 3d 30  t( pAgg->nTab==0
61b0: 20 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49   );.#ifndef SQLI
61c0: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42  TE_OMIT_MEMORYDB
61d0: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
61e0: 74 65 33 42 74 72 65 65 46 61 63 74 6f 72 79 28  te3BtreeFactory(
61f0: 64 62 2c 20 22 3a 6d 65 6d 6f 72 79 3a 22 2c 20  db, ":memory:", 
6200: 30 2c 20 54 45 4d 50 5f 50 41 47 45 53 2c 20 26  0, TEMP_PAGES, &
6210: 70 41 67 67 2d 3e 70 42 74 72 65 65 29 3b 0a 23  pAgg->pBtree);.#
6220: 65 6c 73 65 0a 20 20 20 20 20 20 72 63 20 3d 20  else.      rc = 
6230: 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74  sqlite3BtreeFact
6240: 6f 72 79 28 64 62 2c 20 30 2c 20 30 2c 20 54 45  ory(db, 0, 0, TE
6250: 4d 50 5f 50 41 47 45 53 2c 20 26 70 41 67 67 2d  MP_PAGES, &pAgg-
6260: 3e 70 42 74 72 65 65 29 3b 0a 23 65 6e 64 69 66  >pBtree);.#endif
6270: 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53  .      if( rc!=S
6280: 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72  QLITE_OK ) retur
6290: 6e 20 72 63 3b 0a 20 20 20 20 20 20 73 71 6c 69  n rc;.      sqli
62a0: 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 72 61  te3BtreeBeginTra
62b0: 6e 73 28 70 41 67 67 2d 3e 70 42 74 72 65 65 2c  ns(pAgg->pBtree,
62c0: 20 31 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20   1);.      rc = 
62d0: 73 71 6c 69 74 65 33 42 74 72 65 65 43 72 65 61  sqlite3BtreeCrea
62e0: 74 65 54 61 62 6c 65 28 70 41 67 67 2d 3e 70 42  teTable(pAgg->pB
62f0: 74 72 65 65 2c 20 26 70 41 67 67 2d 3e 6e 54 61  tree, &pAgg->nTa
6300: 62 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28  b, 0);.      if(
6310: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
6320: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
6330: 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 41  }.    assert( pA
6340: 67 67 2d 3e 6e 54 61 62 21 3d 30 20 29 3b 0a 0a  gg->nTab!=0 );..
6350: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
6360: 42 74 72 65 65 43 75 72 73 6f 72 28 70 41 67 67  BtreeCursor(pAgg
6370: 2d 3e 70 42 74 72 65 65 2c 20 70 41 67 67 2d 3e  ->pBtree, pAgg->
6380: 6e 54 61 62 2c 20 31 2c 0a 20 20 20 20 20 20 20  nTab, 1,.       
6390: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
63a0: 72 64 43 6f 6d 70 61 72 65 2c 20 70 4b 65 79 49  rdCompare, pKeyI
63b0: 6e 66 6f 2c 20 26 70 41 67 67 2d 3e 70 43 73 72  nfo, &pAgg->pCsr
63c0: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53  );.    if( rc!=S
63d0: 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72  QLITE_OK ) retur
63e0: 6e 20 72 63 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  n rc;.  }else{. 
63f0: 20 20 20 69 66 28 20 70 41 67 67 2d 3e 70 42 74     if( pAgg->pBt
6400: 72 65 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  ree ){.      sql
6410: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70  ite3BtreeClose(p
6420: 41 67 67 2d 3e 70 42 74 72 65 65 29 3b 0a 20 20  Agg->pBtree);.  
6430: 20 20 20 20 70 41 67 67 2d 3e 70 42 74 72 65 65      pAgg->pBtree
6440: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 41 67 67   = 0;.      pAgg
6450: 2d 3e 6e 54 61 62 20 3d 20 30 3b 0a 20 20 20 20  ->nTab = 0;.    
6460: 7d 0a 20 20 20 20 70 41 67 67 2d 3e 70 43 73 72  }.    pAgg->pCsr
6470: 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 69 66 28   = 0;.  }..  if(
6480: 20 70 41 67 67 2d 3e 61 70 46 75 6e 63 20 29 7b   pAgg->apFunc ){
6490: 20 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65   .    sqliteFree
64a0: 28 70 41 67 67 2d 3e 61 70 46 75 6e 63 29 3b 0a  (pAgg->apFunc);.
64b0: 20 20 20 20 70 41 67 67 2d 3e 61 70 46 75 6e 63      pAgg->apFunc
64c0: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 41 67 67   = 0;.  }.  pAgg
64d0: 2d 3e 70 43 75 72 72 65 6e 74 20 3d 20 30 3b 0a  ->pCurrent = 0;.
64e0: 20 20 70 41 67 67 2d 3e 6e 4d 65 6d 20 3d 20 30    pAgg->nMem = 0
64f0: 3b 0a 20 20 70 41 67 67 2d 3e 73 65 61 72 63 68  ;.  pAgg->search
6500: 69 6e 67 20 3d 20 30 3b 0a 20 20 72 65 74 75 72  ing = 0;.  retur
6510: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
6520: 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65 20 61 20  ./*.** Delete a 
6530: 6b 65 79 6c 69 73 74 0a 2a 2f 0a 76 6f 69 64 20  keylist.*/.void 
6540: 73 71 6c 69 74 65 33 56 64 62 65 4b 65 79 6c 69  sqlite3VdbeKeyli
6550: 73 74 46 72 65 65 28 4b 65 79 6c 69 73 74 20 2a  stFree(Keylist *
6560: 70 29 7b 0a 20 20 77 68 69 6c 65 28 20 70 20 29  p){.  while( p )
6570: 7b 0a 20 20 20 20 4b 65 79 6c 69 73 74 20 2a 70  {.    Keylist *p
6580: 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b  Next = p->pNext;
6590: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28  .    sqliteFree(
65a0: 70 29 3b 0a 20 20 20 20 70 20 3d 20 70 4e 65 78  p);.    p = pNex
65b0: 74 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  t;.  }.}../*.** 
65c0: 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 20 61  Close a cursor a
65d0: 6e 64 20 72 65 6c 65 61 73 65 20 61 6c 6c 20 74  nd release all t
65e0: 68 65 20 72 65 73 6f 75 72 63 65 73 20 74 68 61  he resources tha
65f0: 74 20 63 75 72 73 6f 72 20 68 61 70 70 65 6e 73  t cursor happens
6600: 0a 2a 2a 20 74 6f 20 68 6f 6c 64 2e 0a 2a 2f 0a  .** to hold..*/.
6610: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
6620: 46 72 65 65 43 75 72 73 6f 72 28 43 75 72 73 6f  FreeCursor(Curso
6630: 72 20 2a 70 43 78 29 7b 0a 20 20 69 66 28 20 70  r *pCx){.  if( p
6640: 43 78 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74  Cx==0 ){.    ret
6650: 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  urn;.  }.  if( p
6660: 43 78 2d 3e 70 43 75 72 73 6f 72 20 29 7b 0a 20  Cx->pCursor ){. 
6670: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
6680: 6c 6f 73 65 43 75 72 73 6f 72 28 70 43 78 2d 3e  loseCursor(pCx->
6690: 70 43 75 72 73 6f 72 29 3b 0a 20 20 7d 0a 20 20  pCursor);.  }.  
66a0: 69 66 28 20 70 43 78 2d 3e 70 42 74 20 29 7b 0a  if( pCx->pBt ){.
66b0: 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65      sqlite3Btree
66c0: 43 6c 6f 73 65 28 70 43 78 2d 3e 70 42 74 29 3b  Close(pCx->pBt);
66d0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65  .  }.  sqliteFre
66e0: 65 28 70 43 78 2d 3e 70 44 61 74 61 29 3b 0a 20  e(pCx->pData);. 
66f0: 20 73 71 6c 69 74 65 46 72 65 65 28 70 43 78 2d   sqliteFree(pCx-
6700: 3e 61 54 79 70 65 29 3b 0a 20 20 73 71 6c 69 74  >aType);.  sqlit
6710: 65 46 72 65 65 28 70 43 78 29 3b 0a 7d 0a 0a 2f  eFree(pCx);.}../
6720: 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 63  *.** Close all c
6730: 75 72 73 6f 72 73 0a 2a 2f 0a 73 74 61 74 69 63  ursors.*/.static
6740: 20 76 6f 69 64 20 63 6c 6f 73 65 41 6c 6c 43 75   void closeAllCu
6750: 72 73 6f 72 73 28 56 64 62 65 20 2a 70 29 7b 0a  rsors(Vdbe *p){.
6760: 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28 20 70    int i;.  if( p
6770: 2d 3e 61 70 43 73 72 3d 3d 30 20 29 20 72 65 74  ->apCsr==0 ) ret
6780: 75 72 6e 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20  urn;.  for(i=0; 
6790: 69 3c 70 2d 3e 6e 43 75 72 73 6f 72 3b 20 69 2b  i<p->nCursor; i+
67a0: 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56  +){.    sqlite3V
67b0: 64 62 65 46 72 65 65 43 75 72 73 6f 72 28 70 2d  dbeFreeCursor(p-
67c0: 3e 61 70 43 73 72 5b 69 5d 29 3b 0a 20 20 20 20  >apCsr[i]);.    
67d0: 70 2d 3e 61 70 43 73 72 5b 69 5d 20 3d 20 30 3b  p->apCsr[i] = 0;
67e0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c  .  }.}../*.** Cl
67f0: 65 61 6e 20 75 70 20 74 68 65 20 56 4d 20 61 66  ean up the VM af
6800: 74 65 72 20 65 78 65 63 75 74 69 6f 6e 2e 0a 2a  ter execution..*
6810: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
6820: 65 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63  e will automatic
6830: 61 6c 6c 79 20 63 6c 6f 73 65 20 61 6e 79 20 63  ally close any c
6840: 75 72 73 6f 72 73 2c 20 6c 69 73 74 73 2c 20 61  ursors, lists, a
6850: 6e 64 2f 6f 72 0a 2a 2a 20 73 6f 72 74 65 72 73  nd/or.** sorters
6860: 20 74 68 61 74 20 77 65 72 65 20 6c 65 66 74 20   that were left 
6870: 6f 70 65 6e 2e 20 20 49 74 20 61 6c 73 6f 20 64  open.  It also d
6880: 65 6c 65 74 65 73 20 74 68 65 20 76 61 6c 75 65  eletes the value
6890: 73 20 6f 66 0a 2a 2a 20 76 61 72 69 61 62 6c 65  s of.** variable
68a0: 73 20 69 6e 20 74 68 65 20 61 56 61 72 5b 5d 20  s in the aVar[] 
68b0: 61 72 72 61 79 2e 0a 2a 2f 0a 73 74 61 74 69 63  array..*/.static
68c0: 20 76 6f 69 64 20 43 6c 65 61 6e 75 70 28 56 64   void Cleanup(Vd
68d0: 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b  be *p){.  int i;
68e0: 0a 20 20 69 66 28 20 70 2d 3e 61 53 74 61 63 6b  .  if( p->aStack
68f0: 20 29 7b 0a 20 20 20 20 72 65 6c 65 61 73 65 4d   ){.    releaseM
6900: 65 6d 41 72 72 61 79 28 70 2d 3e 61 53 74 61 63  emArray(p->aStac
6910: 6b 2c 20 31 20 2b 20 28 70 2d 3e 70 54 6f 73 20  k, 1 + (p->pTos 
6920: 2d 20 70 2d 3e 61 53 74 61 63 6b 29 29 3b 0a 20  - p->aStack));. 
6930: 20 20 20 70 2d 3e 70 54 6f 73 20 3d 20 26 70 2d     p->pTos = &p-
6940: 3e 61 53 74 61 63 6b 5b 2d 31 5d 3b 0a 20 20 7d  >aStack[-1];.  }
6950: 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f  .  closeAllCurso
6960: 72 73 28 70 29 3b 0a 20 20 72 65 6c 65 61 73 65  rs(p);.  release
6970: 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 4d 65 6d  MemArray(p->aMem
6980: 2c 20 70 2d 3e 6e 4d 65 6d 29 3b 0a 20 20 69 66  , p->nMem);.  if
6990: 28 20 70 2d 3e 70 4c 69 73 74 20 29 7b 0a 20 20  ( p->pList ){.  
69a0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4b 65 79    sqlite3VdbeKey
69b0: 6c 69 73 74 46 72 65 65 28 70 2d 3e 70 4c 69 73  listFree(p->pLis
69c0: 74 29 3b 0a 20 20 20 20 70 2d 3e 70 4c 69 73 74  t);.    p->pList
69d0: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20   = 0;.  }.  if( 
69e0: 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 20  p->contextStack 
69f0: 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  ){.    for(i=0; 
6a00: 69 3c 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63  i<p->contextStac
6a10: 6b 54 6f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  kTop; i++){.    
6a20: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4b 65 79    sqlite3VdbeKey
6a30: 6c 69 73 74 46 72 65 65 28 70 2d 3e 63 6f 6e 74  listFree(p->cont
6a40: 65 78 74 53 74 61 63 6b 5b 69 5d 2e 70 4c 69 73  extStack[i].pLis
6a50: 74 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71  t);.    }.    sq
6a60: 6c 69 74 65 46 72 65 65 28 70 2d 3e 63 6f 6e 74  liteFree(p->cont
6a70: 65 78 74 53 74 61 63 6b 29 3b 0a 20 20 7d 0a 20  extStack);.  }. 
6a80: 20 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74   sqlite3VdbeSort
6a90: 65 72 52 65 73 65 74 28 70 29 3b 0a 20 20 66 6f  erReset(p);.  fo
6aa0: 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 41 67 67  r(i=0; i<p->nAgg
6ab0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69  ; i++){.    sqli
6ac0: 74 65 33 56 64 62 65 41 67 67 52 65 73 65 74 28  te3VdbeAggReset(
6ad0: 30 2c 20 26 70 2d 3e 61 70 41 67 67 5b 69 5d 2c  0, &p->apAgg[i],
6ae0: 20 30 29 3b 0a 20 20 7d 0a 20 20 70 2d 3e 63 6f   0);.  }.  p->co
6af0: 6e 74 65 78 74 53 74 61 63 6b 20 3d 20 30 3b 0a  ntextStack = 0;.
6b00: 20 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63    p->contextStac
6b10: 6b 44 65 70 74 68 20 3d 20 30 3b 0a 20 20 70 2d  kDepth = 0;.  p-
6b20: 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 54 6f 70  >contextStackTop
6b30: 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 46 72   = 0;.  sqliteFr
6b40: 65 65 28 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a  ee(p->zErrMsg);.
6b50: 20 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30    p->zErrMsg = 0
6b60: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74  ;.}../*.** Set t
6b70: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73  he number of res
6b80: 75 6c 74 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74  ult columns that
6b90: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65   will be returne
6ba0: 64 20 62 79 20 74 68 69 73 20 53 51 4c 0a 2a 2a  d by this SQL.**
6bb0: 20 73 74 61 74 65 6d 65 6e 74 2e 20 54 68 69 73   statement. This
6bc0: 20 69 73 20 6e 6f 77 20 73 65 74 20 61 74 20 63   is now set at c
6bd0: 6f 6d 70 69 6c 65 20 74 69 6d 65 2c 20 72 61 74  ompile time, rat
6be0: 68 65 72 20 74 68 61 6e 20 64 75 72 69 6e 67 0a  her than during.
6bf0: 2a 2a 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20  ** execution of 
6c00: 74 68 65 20 76 64 62 65 20 70 72 6f 67 72 61 6d  the vdbe program
6c10: 20 73 6f 20 74 68 61 74 20 73 71 6c 69 74 65 33   so that sqlite3
6c20: 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 29 20  _column_count() 
6c30: 63 61 6e 0a 2a 2a 20 62 65 20 63 61 6c 6c 65 64  can.** be called
6c40: 20 6f 6e 20 61 6e 20 53 51 4c 20 73 74 61 74 65   on an SQL state
6c50: 6d 65 6e 74 20 62 65 66 6f 72 65 20 73 71 6c 69  ment before sqli
6c60: 74 65 33 5f 73 74 65 70 28 29 2e 0a 2a 2f 0a 76  te3_step()..*/.v
6c70: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 53  oid sqlite3VdbeS
6c80: 65 74 4e 75 6d 43 6f 6c 73 28 56 64 62 65 20 2a  etNumCols(Vdbe *
6c90: 70 2c 20 69 6e 74 20 6e 52 65 73 43 6f 6c 75 6d  p, int nResColum
6ca0: 6e 29 7b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e  n){.  Mem *pColN
6cb0: 61 6d 65 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20  ame;.  int n;.  
6cc0: 61 73 73 65 72 74 28 20 30 3d 3d 70 2d 3e 6e 52  assert( 0==p->nR
6cd0: 65 73 43 6f 6c 75 6d 6e 20 29 3b 0a 20 20 70 2d  esColumn );.  p-
6ce0: 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3d 20 6e 52  >nResColumn = nR
6cf0: 65 73 43 6f 6c 75 6d 6e 3b 0a 20 20 6e 20 3d 20  esColumn;.  n = 
6d00: 6e 52 65 73 43 6f 6c 75 6d 6e 2a 32 3b 0a 20 20  nResColumn*2;.  
6d10: 70 2d 3e 61 43 6f 6c 4e 61 6d 65 20 3d 20 70 43  p->aColName = pC
6d20: 6f 6c 4e 61 6d 65 20 3d 20 28 4d 65 6d 2a 29 73  olName = (Mem*)s
6d30: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a  qliteMalloc( siz
6d40: 65 6f 66 28 4d 65 6d 29 2a 6e 20 29 3b 0a 20 20  eof(Mem)*n );.  
6d50: 69 66 28 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 3d  if( p->aColName=
6d60: 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 77  =0 ) return;.  w
6d70: 68 69 6c 65 28 20 6e 2d 2d 20 3e 20 30 20 29 7b  hile( n-- > 0 ){
6d80: 0a 20 20 20 20 28 70 43 6f 6c 4e 61 6d 65 2b 2b  .    (pColName++
6d90: 29 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e  )->flags = MEM_N
6da0: 75 6c 6c 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  ull;.  }.}../*.*
6db0: 2a 20 53 65 74 20 74 68 65 20 6e 61 6d 65 20 6f  * Set the name o
6dc0: 66 20 74 68 65 20 69 64 78 27 74 68 20 63 6f 6c  f the idx'th col
6dd0: 75 6d 6e 20 74 6f 20 62 65 20 72 65 74 75 72 6e  umn to be return
6de0: 65 64 20 62 79 20 74 68 65 20 53 51 4c 20 73 74  ed by the SQL st
6df0: 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 7a 4e 61 6d  atement..** zNam
6e00: 65 20 6d 75 73 74 20 62 65 20 61 20 70 6f 69 6e  e must be a poin
6e10: 74 65 72 20 74 6f 20 61 20 6e 75 6c 20 74 65 72  ter to a nul ter
6e20: 6d 69 6e 61 74 65 64 20 73 74 72 69 6e 67 2e 0a  minated string..
6e30: 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20  **.** This call 
6e40: 6d 75 73 74 20 62 65 20 6d 61 64 65 20 61 66 74  must be made aft
6e50: 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c  er a call to sql
6e60: 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d 43 6f  ite3VdbeSetNumCo
6e70: 6c 73 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e  ls()..**.** If N
6e80: 3d 3d 50 33 5f 53 54 41 54 49 43 20 20 69 74 20  ==P3_STATIC  it 
6e90: 6d 65 61 6e 73 20 74 68 61 74 20 7a 4e 61 6d 65  means that zName
6ea0: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f   is a pointer to
6eb0: 20 61 20 63 6f 6e 73 74 61 6e 74 20 73 74 61 74   a constant stat
6ec0: 69 63 0a 2a 2a 20 73 74 72 69 6e 67 20 61 6e 64  ic.** string and
6ed0: 20 77 65 20 63 61 6e 20 6a 75 73 74 20 63 6f 70   we can just cop
6ee0: 79 20 74 68 65 20 70 6f 69 6e 74 65 72 2e 20 49  y the pointer. I
6ef0: 66 20 69 74 20 69 73 20 50 33 5f 44 59 4e 41 4d  f it is P3_DYNAM
6f00: 49 43 2c 20 74 68 65 6e 20 0a 2a 2a 20 74 68 65  IC, then .** the
6f10: 20 73 74 72 69 6e 67 20 69 73 20 66 72 65 65 64   string is freed
6f20: 20 75 73 69 6e 67 20 73 71 6c 69 74 65 46 72 65   using sqliteFre
6f30: 65 28 29 20 77 68 65 6e 20 74 68 65 20 76 64 62  e() when the vdb
6f40: 65 20 69 73 20 66 69 6e 69 73 68 65 64 20 77 69  e is finished wi
6f50: 74 68 0a 2a 2a 20 69 74 2e 20 4f 74 68 65 72 77  th.** it. Otherw
6f60: 69 73 65 2c 20 4e 20 62 79 74 65 73 20 6f 66 20  ise, N bytes of 
6f70: 7a 4e 61 6d 65 20 61 72 65 20 63 6f 70 69 65 64  zName are copied
6f80: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
6f90: 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 56  VdbeSetColName(V
6fa0: 64 62 65 20 2a 70 2c 20 69 6e 74 20 69 64 78 2c  dbe *p, int idx,
6fb0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
6fc0: 6d 65 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e  me, int N){.  in
6fd0: 74 20 72 63 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f  t rc;.  Mem *pCo
6fe0: 6c 4e 61 6d 65 3b 0a 20 20 61 73 73 65 72 74 28  lName;.  assert(
6ff0: 20 69 64 78 3c 28 32 2a 70 2d 3e 6e 52 65 73 43   idx<(2*p->nResC
7000: 6f 6c 75 6d 6e 29 20 29 3b 0a 20 20 69 66 28 20  olumn) );.  if( 
7010: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
7020: 61 69 6c 65 64 20 29 20 72 65 74 75 72 6e 20 53  ailed ) return S
7030: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 61  QLITE_NOMEM;.  a
7040: 73 73 65 72 74 28 20 70 2d 3e 61 43 6f 6c 4e 61  ssert( p->aColNa
7050: 6d 65 21 3d 30 20 29 3b 0a 20 20 70 43 6f 6c 4e  me!=0 );.  pColN
7060: 61 6d 65 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e  ame = &(p->aColN
7070: 61 6d 65 5b 69 64 78 5d 29 3b 0a 20 20 69 66 28  ame[idx]);.  if(
7080: 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c   N==P3_DYNAMIC |
7090: 7c 20 4e 3d 3d 50 33 5f 53 54 41 54 49 43 20 29  | N==P3_STATIC )
70a0: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
70b0: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
70c0: 70 43 6f 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c  pColName, zName,
70d0: 20 2d 31 2c 20 53 51 4c 49 54 45 5f 55 54 46 38   -1, SQLITE_UTF8
70e0: 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29  , SQLITE_STATIC)
70f0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72  ;.  }else{.    r
7100: 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d  c = sqlite3VdbeM
7110: 65 6d 53 65 74 53 74 72 28 70 43 6f 6c 4e 61 6d  emSetStr(pColNam
7120: 65 2c 20 7a 4e 61 6d 65 2c 20 4e 2c 20 53 51 4c  e, zName, N, SQL
7130: 49 54 45 5f 55 54 46 38 2c 53 51 4c 49 54 45 5f  ITE_UTF8,SQLITE_
7140: 54 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 0a  TRANSIENT);.  }.
7150: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
7160: 5f 4f 4b 20 26 26 20 4e 3d 3d 50 33 5f 44 59 4e  _OK && N==P3_DYN
7170: 41 4d 49 43 20 29 7b 0a 20 20 20 20 70 43 6f 6c  AMIC ){.    pCol
7180: 4e 61 6d 65 2d 3e 66 6c 61 67 73 20 3d 20 28 70  Name->flags = (p
7190: 43 6f 6c 4e 61 6d 65 2d 3e 66 6c 61 67 73 26 28  ColName->flags&(
71a0: 7e 4d 45 4d 5f 53 74 61 74 69 63 29 29 7c 4d 45  ~MEM_Static))|ME
71b0: 4d 5f 44 79 6e 3b 0a 20 20 20 20 70 43 6f 6c 4e  M_Dyn;.    pColN
71c0: 61 6d 65 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20  ame->xDel = 0;. 
71d0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
71e0: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 72 65 61 64 20  }../*.** A read 
71f0: 6f 72 20 77 72 69 74 65 20 74 72 61 6e 73 61 63  or write transac
7200: 74 69 6f 6e 20 6d 61 79 20 6f 72 20 6d 61 79 20  tion may or may 
7210: 6e 6f 74 20 62 65 20 61 63 74 69 76 65 20 6f 6e  not be active on
7220: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
7230: 0a 2a 2a 20 64 62 2e 20 49 66 20 61 20 74 72 61  .** db. If a tra
7240: 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69  nsaction is acti
7250: 76 65 2c 20 63 6f 6d 6d 69 74 20 69 74 2e 20 49  ve, commit it. I
7260: 66 20 74 68 65 72 65 20 69 73 20 61 0a 2a 2a 20  f there is a.** 
7270: 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f  write-transactio
7280: 6e 20 73 70 61 6e 6e 69 6e 67 20 6d 6f 72 65 20  n spanning more 
7290: 74 68 61 6e 20 6f 6e 65 20 64 61 74 61 62 61 73  than one databas
72a0: 65 20 66 69 6c 65 2c 20 74 68 69 73 20 72 6f 75  e file, this rou
72b0: 74 69 6e 65 0a 2a 2a 20 74 61 6b 65 73 20 63 61  tine.** takes ca
72c0: 72 65 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72  re of the master
72d0: 20 6a 6f 75 72 6e 61 6c 20 74 72 69 63 6b 65 72   journal tricker
72e0: 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  y..*/.static int
72f0: 20 76 64 62 65 43 6f 6d 6d 69 74 28 73 71 6c 69   vdbeCommit(sqli
7300: 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20  te3 *db){.  int 
7310: 69 3b 0a 20 20 69 6e 74 20 6e 54 72 61 6e 73 20  i;.  int nTrans 
7320: 3d 20 30 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20  = 0;  /* Number 
7330: 6f 66 20 64 61 74 61 62 61 73 65 73 20 77 69 74  of databases wit
7340: 68 20 61 6e 20 61 63 74 69 76 65 20 77 72 69 74  h an active writ
7350: 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f  e-transaction */
7360: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
7370: 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 6e 65 65  TE_OK;.  int nee
7380: 64 58 63 6f 6d 6d 69 74 20 3d 20 30 3b 0a 0a 20  dXcommit = 0;.. 
7390: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e   for(i=0; i<db->
73a0: 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20  nDb; i++){ .    
73b0: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d  Btree *pBt = db-
73c0: 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20  >aDb[i].pBt;.   
73d0: 20 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69   if( pBt && sqli
73e0: 74 65 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e  te3BtreeIsInTran
73f0: 73 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20  s(pBt) ){.      
7400: 6e 65 65 64 58 63 6f 6d 6d 69 74 20 3d 20 31 3b  needXcommit = 1;
7410: 0a 20 20 20 20 20 20 69 66 28 20 69 21 3d 31 20  .      if( i!=1 
7420: 29 20 6e 54 72 61 6e 73 2b 2b 3b 0a 20 20 20 20  ) nTrans++;.    
7430: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74  }.  }..  /* If t
7440: 68 65 72 65 20 61 72 65 20 61 6e 79 20 77 72 69  here are any wri
7450: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20  te-transactions 
7460: 61 74 20 61 6c 6c 2c 20 69 6e 76 6f 6b 65 20 74  at all, invoke t
7470: 68 65 20 63 6f 6d 6d 69 74 20 68 6f 6f 6b 20 2a  he commit hook *
7480: 2f 0a 20 20 69 66 28 20 6e 65 65 64 58 63 6f 6d  /.  if( needXcom
7490: 6d 69 74 20 26 26 20 64 62 2d 3e 78 43 6f 6d 6d  mit && db->xComm
74a0: 69 74 43 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20  itCallback ){.  
74b0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 73 71    int rc;.    sq
74c0: 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28 64  lite3SafetyOff(d
74d0: 62 29 3b 0a 20 20 20 20 72 63 20 3d 20 64 62 2d  b);.    rc = db-
74e0: 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b  >xCommitCallback
74f0: 28 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 29  (db->pCommitArg)
7500: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 61 66  ;.    sqlite3Saf
7510: 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 20 20 69  etyOn(db);.    i
7520: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 72  f( rc ){.      r
7530: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e  eturn SQLITE_CON
7540: 53 54 52 41 49 4e 54 3b 0a 20 20 20 20 7d 0a 20  STRAINT;.    }. 
7550: 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 73 69 6d   }..  /* The sim
7560: 70 6c 65 20 63 61 73 65 20 2d 20 6e 6f 20 6d 6f  ple case - no mo
7570: 72 65 20 74 68 61 6e 20 6f 6e 65 20 64 61 74 61  re than one data
7580: 62 61 73 65 20 66 69 6c 65 20 28 6e 6f 74 20 63  base file (not c
7590: 6f 75 6e 74 69 6e 67 20 74 68 65 0a 20 20 2a 2a  ounting the.  **
75a0: 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 29 20   TEMP database) 
75b0: 68 61 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f  has a transactio
75c0: 6e 20 61 63 74 69 76 65 2e 20 20 20 54 68 65 72  n active.   Ther
75d0: 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 66 6f 72  e is no need for
75e0: 20 74 68 65 0a 20 20 2a 2a 20 6d 61 73 74 65 72   the.  ** master
75f0: 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2a 0a 20  -journal..  **. 
7600: 20 2a 2a 20 49 66 20 74 68 65 20 72 65 74 75 72   ** If the retur
7610: 6e 20 76 61 6c 75 65 20 6f 66 20 73 71 6c 69 74  n value of sqlit
7620: 65 33 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61  e3BtreeGetFilena
7630: 6d 65 28 29 20 69 73 20 61 20 7a 65 72 6f 20 6c  me() is a zero l
7640: 65 6e 67 74 68 0a 20 20 2a 2a 20 73 74 72 69 6e  ength.  ** strin
7650: 67 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 65 20  g, it means the 
7660: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 69 73  main database is
7670: 20 3a 6d 65 6d 6f 72 79 3a 2e 20 20 49 6e 20 74   :memory:.  In t
7680: 68 61 74 20 63 61 73 65 20 77 65 20 64 6f 0a 20  hat case we do. 
7690: 20 2a 2a 20 6e 6f 74 20 73 75 70 70 6f 72 74 20   ** not support 
76a0: 61 74 6f 6d 69 63 20 6d 75 6c 74 69 2d 66 69 6c  atomic multi-fil
76b0: 65 20 63 6f 6d 6d 69 74 73 2c 20 73 6f 20 75 73  e commits, so us
76c0: 65 20 74 68 65 20 73 69 6d 70 6c 65 20 63 61 73  e the simple cas
76d0: 65 20 74 68 65 6e 0a 20 20 2a 2a 20 74 6f 6f 2e  e then.  ** too.
76e0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 73  .  */.  if( 0==s
76f0: 74 72 6c 65 6e 28 73 71 6c 69 74 65 33 42 74 72  trlen(sqlite3Btr
7700: 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 64 62  eeGetFilename(db
7710: 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 29 20 7c  ->aDb[0].pBt)) |
7720: 7c 20 6e 54 72 61 6e 73 3c 3d 31 20 29 7b 0a 20  | nTrans<=1 ){. 
7730: 20 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d     for(i=0; rc==
7740: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64  SQLITE_OK && i<d
7750: 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20  b->nDb; i++){ . 
7760: 20 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20       Btree *pBt 
7770: 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74  = db->aDb[i].pBt
7780: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 20  ;.      if( pBt 
7790: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  ){.        rc = 
77a0: 73 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63  sqlite3BtreeSync
77b0: 28 70 42 74 2c 20 30 29 3b 0a 20 20 20 20 20 20  (pBt, 0);.      
77c0: 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20  }.    }..    /* 
77d0: 44 6f 20 74 68 65 20 63 6f 6d 6d 69 74 20 6f 6e  Do the commit on
77e0: 6c 79 20 69 66 20 61 6c 6c 20 64 61 74 61 62 61  ly if all databa
77f0: 73 65 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79  ses successfully
7800: 20 73 79 6e 63 65 64 20 2a 2f 0a 20 20 20 20 69   synced */.    i
7810: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
7820: 20 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d   ){.      for(i=
7830: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  0; i<db->nDb; i+
7840: 2b 29 7b 0a 20 20 20 20 20 20 20 20 42 74 72 65  +){.        Btre
7850: 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62  e *pBt = db->aDb
7860: 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 20  [i].pBt;.       
7870: 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20   if( pBt ){.    
7880: 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72        sqlite3Btr
7890: 65 65 43 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20  eeCommit(pBt);. 
78a0: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
78b0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a  .    }.  }..  /*
78c0: 20 54 68 65 20 63 6f 6d 70 6c 65 78 20 63 61 73   The complex cas
78d0: 65 20 2d 20 54 68 65 72 65 20 69 73 20 61 20 6d  e - There is a m
78e0: 75 6c 74 69 2d 66 69 6c 65 20 77 72 69 74 65 2d  ulti-file write-
78f0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 74 69  transaction acti
7900: 76 65 2e 0a 20 20 2a 2a 20 54 68 69 73 20 72 65  ve..  ** This re
7910: 71 75 69 72 65 73 20 61 20 6d 61 73 74 65 72 20  quires a master 
7920: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 6f 20  journal file to 
7930: 65 6e 73 75 72 65 20 74 68 65 20 74 72 61 6e 73  ensure the trans
7940: 61 63 74 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 63  action is.  ** c
7950: 6f 6d 6d 69 74 74 65 64 20 61 74 6f 6d 69 63 6c  ommitted atomicl
7960: 79 2e 0a 20 20 2a 2f 0a 20 20 65 6c 73 65 7b 0a  y..  */.  else{.
7970: 20 20 20 20 63 68 61 72 20 2a 7a 4d 61 73 74 65      char *zMaste
7980: 72 20 3d 20 30 3b 20 20 20 2f 2a 20 46 69 6c 65  r = 0;   /* File
7990: 2d 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 6d 61  -name for the ma
79a0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a  ster journal */.
79b0: 20 20 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a      char const *
79c0: 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69  zMainFile = sqli
79d0: 74 65 33 42 74 72 65 65 47 65 74 46 69 6c 65 6e  te3BtreeGetFilen
79e0: 61 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70  ame(db->aDb[0].p
79f0: 42 74 29 3b 0a 20 20 20 20 4f 73 46 69 6c 65 20  Bt);.    OsFile 
7a00: 6d 61 73 74 65 72 3b 0a 0a 20 20 20 20 2f 2a 20  master;..    /* 
7a10: 53 65 6c 65 63 74 20 61 20 6d 61 73 74 65 72 20  Select a master 
7a20: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d  journal file nam
7a30: 65 20 2a 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 20  e */.    do {.  
7a40: 20 20 20 20 75 33 32 20 72 61 6e 64 6f 6d 3b 0a      u32 random;.
7a50: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
7a60: 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20  (zMaster);.     
7a70: 20 73 71 6c 69 74 65 33 52 61 6e 64 6f 6d 6e 65   sqlite3Randomne
7a80: 73 73 28 73 69 7a 65 6f 66 28 72 61 6e 64 6f 6d  ss(sizeof(random
7a90: 29 2c 20 26 72 61 6e 64 6f 6d 29 3b 0a 20 20 20  ), &random);.   
7aa0: 20 20 20 7a 4d 61 73 74 65 72 20 3d 20 73 71 6c     zMaster = sql
7ab0: 69 74 65 33 4d 50 72 69 6e 74 66 28 22 25 73 2d  ite3MPrintf("%s-
7ac0: 6d 6a 25 30 38 58 22 2c 20 7a 4d 61 69 6e 46 69  mj%08X", zMainFi
7ad0: 6c 65 2c 20 72 61 6e 64 6f 6d 26 30 78 37 66 66  le, random&0x7ff
7ae0: 66 66 66 66 66 29 3b 0a 20 20 20 20 20 20 69 66  fffff);.      if
7af0: 28 20 21 7a 4d 61 73 74 65 72 20 29 7b 0a 20 20  ( !zMaster ){.  
7b00: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c        return SQL
7b10: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20  ITE_NOMEM;.     
7b20: 20 7d 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 73   }.    }while( s
7b30: 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73  qlite3OsFileExis
7b40: 74 73 28 7a 4d 61 73 74 65 72 29 20 29 3b 0a 0a  ts(zMaster) );..
7b50: 20 20 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20      /* Open the 
7b60: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20  master journal. 
7b70: 2a 2f 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 6d  */.    memset(&m
7b80: 61 73 74 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66  aster, 0, sizeof
7b90: 28 6d 61 73 74 65 72 29 29 3b 0a 20 20 20 20 72  (master));.    r
7ba0: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65  c = sqlite3OsOpe
7bb0: 6e 45 78 63 6c 75 73 69 76 65 28 7a 4d 61 73 74  nExclusive(zMast
7bc0: 65 72 2c 20 26 6d 61 73 74 65 72 2c 20 30 29 3b  er, &master, 0);
7bd0: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c  .    if( rc!=SQL
7be0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
7bf0: 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74  sqliteFree(zMast
7c00: 65 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72  er);.      retur
7c10: 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 0a 20 20  n rc;.    }. .  
7c20: 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e    /* Write the n
7c30: 61 6d 65 20 6f 66 20 65 61 63 68 20 64 61 74 61  ame of each data
7c40: 62 61 73 65 20 66 69 6c 65 20 69 6e 20 74 68 65  base file in the
7c50: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74   transaction int
7c60: 6f 20 74 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a  o the new.    **
7c70: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
7c80: 66 69 6c 65 2e 20 49 66 20 61 6e 20 65 72 72 6f  file. If an erro
7c90: 72 20 6f 63 63 75 72 73 20 61 74 20 74 68 69 73  r occurs at this
7ca0: 20 70 6f 69 6e 74 20 63 6c 6f 73 65 0a 20 20 20   point close.   
7cb0: 20 2a 2a 20 61 6e 64 20 64 65 6c 65 74 65 20 74   ** and delete t
7cc0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
7cd0: 6c 20 66 69 6c 65 2e 20 41 6c 6c 20 74 68 65 20  l file. All the 
7ce0: 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e  individual journ
7cf0: 61 6c 20 66 69 6c 65 73 0a 20 20 20 20 2a 2a 20  al files.    ** 
7d00: 73 74 69 6c 6c 20 68 61 76 65 20 27 6e 75 6c 6c  still have 'null
7d10: 27 20 61 73 20 74 68 65 20 6d 61 73 74 65 72 20  ' as the master 
7d20: 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 2c  journal pointer,
7d30: 20 73 6f 20 74 68 65 79 20 77 69 6c 6c 20 72 6f   so they will ro
7d40: 6c 6c 0a 20 20 20 20 2a 2a 20 62 61 63 6b 20 69  ll.    ** back i
7d50: 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 69 66 20  ndependently if 
7d60: 61 20 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73  a failure occurs
7d70: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72  ..    */.    for
7d80: 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b  (i=0; i<db->nDb;
7d90: 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74   i++){ .      Bt
7da0: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
7db0: 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20  Db[i].pBt;.     
7dc0: 20 69 66 28 20 69 3d 3d 31 20 29 20 63 6f 6e 74   if( i==1 ) cont
7dd0: 69 6e 75 65 3b 20 20 20 2f 2a 20 49 67 6e 6f 72  inue;   /* Ignor
7de0: 65 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 62  e the TEMP datab
7df0: 61 73 65 20 2a 2f 0a 20 20 20 20 20 20 69 66 28  ase */.      if(
7e00: 20 70 42 74 20 26 26 20 73 71 6c 69 74 65 33 42   pBt && sqlite3B
7e10: 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70 42  treeIsInTrans(pB
7e20: 74 29 20 29 7b 0a 20 20 20 20 20 20 20 20 63 68  t) ){.        ch
7e30: 61 72 20 63 6f 6e 73 74 20 2a 7a 46 69 6c 65 20  ar const *zFile 
7e40: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65  = sqlite3BtreeGe
7e50: 74 4a 6f 75 72 6e 61 6c 6e 61 6d 65 28 70 42 74  tJournalname(pBt
7e60: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a  );.        if( z
7e70: 46 69 6c 65 5b 30 5d 3d 3d 30 20 29 20 63 6f 6e  File[0]==0 ) con
7e80: 74 69 6e 75 65 3b 20 20 2f 2a 20 49 67 6e 6f 72  tinue;  /* Ignor
7e90: 65 20 3a 6d 65 6d 6f 72 79 3a 20 64 61 74 61 62  e :memory: datab
7ea0: 61 73 65 73 20 2a 2f 0a 20 20 20 20 20 20 20 20  ases */.        
7eb0: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72  rc = sqlite3OsWr
7ec0: 69 74 65 28 26 6d 61 73 74 65 72 2c 20 7a 46 69  ite(&master, zFi
7ed0: 6c 65 2c 20 73 74 72 6c 65 6e 28 7a 46 69 6c 65  le, strlen(zFile
7ee0: 29 2b 31 29 3b 0a 20 20 20 20 20 20 20 20 69 66  )+1);.        if
7ef0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
7f00: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  ){.          sql
7f10: 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73  ite3OsClose(&mas
7f20: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ter);.          
7f30: 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28  sqlite3OsDelete(
7f40: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  zMaster);.      
7f50: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a      sqliteFree(z
7f60: 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20  Master);.       
7f70: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
7f80: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
7f90: 20 20 20 20 7d 0a 0a 0a 20 20 20 20 2f 2a 20 53      }...    /* S
7fa0: 79 6e 63 20 74 68 65 20 6d 61 73 74 65 72 20 6a  ync the master j
7fb0: 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 42 65 66  ournal file. Bef
7fc0: 6f 72 65 20 64 6f 69 6e 67 20 74 68 69 73 2c 20  ore doing this, 
7fd0: 6f 70 65 6e 20 74 68 65 20 64 69 72 65 63 74 6f  open the directo
7fe0: 72 79 0a 20 20 20 20 2a 2a 20 74 68 65 20 6d 61  ry.    ** the ma
7ff0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
8000: 65 20 69 73 20 73 74 6f 72 65 20 69 6e 20 73 6f  e is store in so
8010: 20 74 68 61 74 20 69 74 20 67 65 74 73 20 73 79   that it gets sy
8020: 6e 63 65 64 20 74 6f 6f 2e 0a 20 20 20 20 2a 2f  nced too..    */
8030: 0a 20 20 20 20 7a 4d 61 69 6e 46 69 6c 65 20 3d  .    zMainFile =
8040: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74   sqlite3BtreeGet
8050: 44 69 72 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b  Dirname(db->aDb[
8060: 30 5d 2e 70 42 74 29 3b 0a 20 20 20 20 72 63 20  0].pBt);.    rc 
8070: 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 44  = sqlite3OsOpenD
8080: 69 72 65 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69  irectory(zMainFi
8090: 6c 65 2c 20 26 6d 61 73 74 65 72 29 3b 0a 20 20  le, &master);.  
80a0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
80b0: 5f 4f 4b 20 7c 7c 20 28 72 63 20 3d 20 73 71 6c  _OK || (rc = sql
80c0: 69 74 65 33 4f 73 53 79 6e 63 28 26 6d 61 73 74  ite3OsSync(&mast
80d0: 65 72 29 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  er))!=SQLITE_OK 
80e0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
80f0: 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72 29  OsClose(&master)
8100: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f  ;.      sqlite3O
8110: 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29  sDelete(zMaster)
8120: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72  ;.      sqliteFr
8130: 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20  ee(zMaster);.   
8140: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
8150: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63    }..    /* Sync
8160: 20 61 6c 6c 20 74 68 65 20 64 62 20 66 69 6c 65   all the db file
8170: 73 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 74 68  s involved in th
8180: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54  e transaction. T
8190: 68 65 20 73 61 6d 65 20 63 61 6c 6c 0a 20 20 20  he same call.   
81a0: 20 2a 2a 20 73 65 74 73 20 74 68 65 20 6d 61 73   ** sets the mas
81b0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e  ter journal poin
81c0: 74 65 72 20 69 6e 20 65 61 63 68 20 69 6e 64 69  ter in each indi
81d0: 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 2e 20  vidual journal. 
81e0: 49 66 0a 20 20 20 20 2a 2a 20 61 6e 20 65 72 72  If.    ** an err
81f0: 6f 72 20 6f 63 63 75 72 73 20 68 65 72 65 2c 20  or occurs here, 
8200: 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74 68  do not delete th
8210: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
8220: 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a 0a 20 20   file..    **.  
8230: 20 20 2a 2a 20 49 66 20 74 68 65 20 65 72 72 6f    ** If the erro
8240: 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 20  r occurs during 
8250: 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20 74  the first call t
8260: 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 79  o sqlite3BtreeSy
8270: 6e 63 28 29 2c 0a 20 20 20 20 2a 2a 20 74 68 65  nc(),.    ** the
8280: 6e 20 74 68 65 72 65 20 69 73 20 61 20 63 68 61  n there is a cha
8290: 6e 63 65 20 74 68 61 74 20 74 68 65 20 6d 61 73  nce that the mas
82a0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
82b0: 20 77 69 6c 6c 20 62 65 0a 20 20 20 20 2a 2a 20   will be.    ** 
82c0: 6f 72 70 68 61 6e 65 64 2e 20 42 75 74 20 77 65  orphaned. But we
82d0: 20 63 61 6e 6e 6f 74 20 64 65 6c 65 74 65 20 69   cannot delete i
82e0: 74 2c 20 69 6e 20 63 61 73 65 20 74 68 65 20 6d  t, in case the m
82f0: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 0a 20 20  aster journal.  
8300: 20 20 2a 2a 20 66 69 6c 65 20 6e 61 6d 65 20 77    ** file name w
8310: 61 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20  as written into 
8320: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
8330: 20 62 65 66 6f 72 65 20 74 68 65 20 66 61 69 6c   before the fail
8340: 75 72 65 0a 20 20 20 20 2a 2a 20 6f 63 63 75 72  ure.    ** occur
8350: 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66  ed..    */.    f
8360: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44  or(i=0; i<db->nD
8370: 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20  b; i++){ .      
8380: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d  Btree *pBt = db-
8390: 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20  >aDb[i].pBt;.   
83a0: 20 20 20 69 66 28 20 70 42 74 20 26 26 20 73 71     if( pBt && sq
83b0: 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e 54 72  lite3BtreeIsInTr
83c0: 61 6e 73 28 70 42 74 29 20 29 7b 0a 20 20 20 20  ans(pBt) ){.    
83d0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
83e0: 42 74 72 65 65 53 79 6e 63 28 70 42 74 2c 20 7a  BtreeSync(pBt, z
83f0: 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20  Master);.       
8400: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
8410: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  OK ){.          
8420: 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 26  sqlite3OsClose(&
8430: 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20  master);.       
8440: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
8450: 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20  aster);.        
8460: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20    return rc;.   
8470: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20       }.      }. 
8480: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33     }.    sqlite3
8490: 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72 29  OsClose(&master)
84a0: 3b 0a 0a 20 20 20 20 2f 2a 20 44 65 6c 65 74 65  ;..    /* Delete
84b0: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72   the master jour
84c0: 6e 61 6c 20 66 69 6c 65 2e 20 54 68 69 73 20 63  nal file. This c
84d0: 6f 6d 6d 69 74 73 20 74 68 65 20 74 72 61 6e 73  ommits the trans
84e0: 61 63 74 69 6f 6e 2e 20 41 66 74 65 72 0a 20 20  action. After.  
84f0: 20 20 2a 2a 20 64 6f 69 6e 67 20 74 68 69 73 20    ** doing this 
8500: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 69 73  the directory is
8510: 20 73 79 6e 63 65 64 20 61 67 61 69 6e 20 62 65   synced again be
8520: 66 6f 72 65 20 61 6e 79 20 69 6e 64 69 76 69 64  fore any individ
8530: 75 61 6c 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73  ual.    ** trans
8540: 61 63 74 69 6f 6e 20 66 69 6c 65 73 20 61 72 65  action files are
8550: 20 64 65 6c 65 74 65 64 2e 0a 20 20 20 20 2a 2f   deleted..    */
8560: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
8570: 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65  3OsDelete(zMaste
8580: 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  r);.    assert( 
8590: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b  rc==SQLITE_OK );
85a0: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28  .    sqliteFree(
85b0: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 7a 4d  zMaster);.    zM
85c0: 61 73 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 72  aster = 0;.    r
85d0: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e  c = sqlite3OsSyn
85e0: 63 44 69 72 65 63 74 6f 72 79 28 7a 4d 61 69 6e  cDirectory(zMain
85f0: 46 69 6c 65 29 3b 0a 20 20 20 20 69 66 28 20 72  File);.    if( r
8600: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
8610: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73        /* This is
8620: 20 6e 6f 74 20 67 6f 6f 64 2e 20 54 68 65 20 6d   not good. The m
8630: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
8640: 6c 65 20 68 61 73 20 62 65 65 6e 20 64 65 6c 65  le has been dele
8650: 74 65 64 2c 20 62 75 74 0a 20 20 20 20 20 20 2a  ted, but.      *
8660: 2a 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20  * the directory 
8670: 73 79 6e 63 20 66 61 69 6c 65 64 2e 20 54 68 65  sync failed. The
8680: 72 65 20 69 73 20 6e 6f 20 63 6f 6d 70 6c 65 74  re is no complet
8690: 65 6c 79 20 73 61 66 65 20 63 6f 75 72 73 65 20  ely safe course 
86a0: 6f 66 0a 20 20 20 20 20 20 2a 2a 20 61 63 74 69  of.      ** acti
86b0: 6f 6e 20 66 72 6f 6d 20 68 65 72 65 2e 20 54 68  on from here. Th
86c0: 65 20 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75  e individual jou
86d0: 72 6e 61 6c 73 20 63 6f 6e 74 61 69 6e 20 74 68  rnals contain th
86e0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 0a 20 20  e name of the.  
86f0: 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a 6f      ** master jo
8700: 75 72 6e 61 6c 20 66 69 6c 65 2c 20 62 75 74 20  urnal file, but 
8710: 74 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79 20  there is no way 
8720: 6f 66 20 6b 6e 6f 77 69 6e 67 20 69 66 20 74 68  of knowing if th
8730: 61 74 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73 74  at.      ** mast
8740: 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74  er journal exist
8750: 73 20 6e 6f 77 20 6f 72 20 69 66 20 69 74 20 77  s now or if it w
8760: 69 6c 6c 20 65 78 69 73 74 20 61 66 74 65 72 20  ill exist after 
8770: 74 68 65 20 6f 70 65 72 61 74 69 6e 67 0a 20 20  the operating.  
8780: 20 20 20 20 2a 2a 20 73 79 73 74 65 6d 20 63 72      ** system cr
8790: 61 73 68 20 74 68 61 74 20 6d 61 79 20 66 6f 6c  ash that may fol
87a0: 6c 6f 77 20 74 68 65 20 66 73 79 6e 63 28 29 20  low the fsync() 
87b0: 66 61 69 6c 75 72 65 2e 0a 20 20 20 20 20 20 2a  failure..      *
87c0: 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  /.      return r
87d0: 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a  c;.    }..    /*
87e0: 20 41 6c 6c 20 66 69 6c 65 73 20 61 6e 64 20 64   All files and d
87f0: 69 72 65 63 74 6f 72 69 65 73 20 68 61 76 65 20  irectories have 
8800: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 73 79 6e  already been syn
8810: 63 65 64 2c 20 73 6f 20 74 68 65 20 66 6f 6c 6c  ced, so the foll
8820: 6f 77 69 6e 67 0a 20 20 20 20 2a 2a 20 63 61 6c  owing.    ** cal
8830: 6c 73 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72  ls to sqlite3Btr
8840: 65 65 43 6f 6d 6d 69 74 28 29 20 61 72 65 20 6f  eeCommit() are o
8850: 6e 6c 79 20 63 6c 6f 73 69 6e 67 20 66 69 6c 65  nly closing file
8860: 73 20 61 6e 64 20 64 65 6c 65 74 69 6e 67 0a 20  s and deleting. 
8870: 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 73 2e 20     ** journals. 
8880: 49 66 20 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65  If something goe
8890: 73 20 77 72 6f 6e 67 20 77 68 69 6c 65 20 74 68  s wrong while th
88a0: 69 73 20 69 73 20 68 61 70 70 65 6e 69 6e 67 20  is is happening 
88b0: 77 65 20 64 6f 6e 27 74 0a 20 20 20 20 2a 2a 20  we don't.    ** 
88c0: 72 65 61 6c 6c 79 20 63 61 72 65 2e 20 54 68 65  really care. The
88d0: 20 69 6e 74 65 67 72 69 74 79 20 6f 66 20 74 68   integrity of th
88e0: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73  e transaction is
88f0: 20 61 6c 72 65 61 64 79 20 67 75 61 72 61 6e 74   already guarant
8900: 65 65 64 2c 0a 20 20 20 20 2a 2a 20 62 75 74 20  eed,.    ** but 
8910: 73 6f 6d 65 20 73 74 72 61 79 20 27 63 6f 6c 64  some stray 'cold
8920: 27 20 6a 6f 75 72 6e 61 6c 73 20 6d 61 79 20 62  ' journals may b
8930: 65 20 6c 79 69 6e 67 20 61 72 6f 75 6e 64 2e 20  e lying around. 
8940: 52 65 74 75 72 6e 69 6e 67 20 61 6e 0a 20 20 20  Returning an.   
8950: 20 2a 2a 20 65 72 72 6f 72 20 63 6f 64 65 20 77   ** error code w
8960: 6f 6e 27 74 20 68 65 6c 70 20 6d 61 74 74 65 72  on't help matter
8970: 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f  s..    */.    fo
8980: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62  r(i=0; i<db->nDb
8990: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42  ; i++){ .      B
89a0: 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e  tree *pBt = db->
89b0: 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20  aDb[i].pBt;.    
89c0: 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20    if( pBt ){.   
89d0: 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65       sqlite3Btre
89e0: 65 43 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20  eCommit(pBt);.  
89f0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
8a00: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
8a10: 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 65 76 65 72  ./*.** Find ever
8a20: 79 20 61 63 74 69 76 65 20 56 4d 20 6f 74 68 65  y active VM othe
8a30: 72 20 74 68 61 6e 20 70 56 64 62 65 20 61 6e 64  r than pVdbe and
8a40: 20 63 68 61 6e 67 65 20 69 74 73 20 73 74 61 74   change its stat
8a50: 75 73 20 74 6f 0a 2a 2a 20 61 62 6f 72 74 65 64  us to.** aborted
8a60: 2e 20 20 54 68 69 73 20 68 61 70 70 65 6e 73 20  .  This happens 
8a70: 77 68 65 6e 20 6f 6e 65 20 56 4d 20 63 61 75 73  when one VM caus
8a80: 65 73 20 61 20 72 6f 6c 6c 62 61 63 6b 20 64 75  es a rollback du
8a90: 65 20 74 6f 20 61 6e 0a 2a 2a 20 4f 4e 20 43 4f  e to an.** ON CO
8aa0: 4e 46 4c 49 43 54 20 52 4f 4c 4c 42 41 43 4b 20  NFLICT ROLLBACK 
8ab0: 63 6c 61 75 73 65 20 28 66 6f 72 20 65 78 61 6d  clause (for exam
8ac0: 70 6c 65 29 2e 20 20 54 68 65 20 6f 74 68 65 72  ple).  The other
8ad0: 20 56 4d 73 20 6d 75 73 74 20 62 65 0a 2a 2a 20   VMs must be.** 
8ae0: 61 62 6f 72 74 65 64 20 73 6f 20 74 68 61 74 20  aborted so that 
8af0: 74 68 65 79 20 64 6f 20 6e 6f 74 20 68 61 76 65  they do not have
8b00: 20 64 61 74 61 20 72 6f 6c 6c 65 64 20 6f 75 74   data rolled out
8b10: 20 66 72 6f 6d 20 75 6e 64 65 72 6e 65 61 74 68   from underneath
8b20: 0a 2a 2a 20 74 68 65 6d 20 6c 65 61 64 69 6e 67  .** them leading
8b30: 20 74 6f 20 61 20 73 65 67 66 61 75 6c 74 2e 0a   to a segfault..
8b40: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 61  */.static void a
8b50: 62 6f 72 74 4f 74 68 65 72 41 63 74 69 76 65 56  bortOtherActiveV
8b60: 64 62 65 73 28 56 64 62 65 20 2a 70 56 64 62 65  dbes(Vdbe *pVdbe
8b70: 29 7b 0a 20 20 56 64 62 65 20 2a 70 4f 74 68 65  ){.  Vdbe *pOthe
8b80: 72 3b 0a 20 20 66 6f 72 28 70 4f 74 68 65 72 3d  r;.  for(pOther=
8b90: 70 56 64 62 65 2d 3e 64 62 2d 3e 70 56 64 62 65  pVdbe->db->pVdbe
8ba0: 3b 20 70 4f 74 68 65 72 3b 20 70 4f 74 68 65 72  ; pOther; pOther
8bb0: 3d 70 4f 74 68 65 72 2d 3e 70 4e 65 78 74 29 7b  =pOther->pNext){
8bc0: 0a 20 20 20 20 69 66 28 20 70 4f 74 68 65 72 3d  .    if( pOther=
8bd0: 3d 70 56 64 62 65 20 29 20 63 6f 6e 74 69 6e 75  =pVdbe ) continu
8be0: 65 3b 0a 20 20 20 20 69 66 28 20 70 4f 74 68 65  e;.    if( pOthe
8bf0: 72 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d  r->magic!=VDBE_M
8c00: 41 47 49 43 5f 52 55 4e 20 7c 7c 20 70 4f 74 68  AGIC_RUN || pOth
8c10: 65 72 2d 3e 70 63 3c 30 20 29 20 63 6f 6e 74 69  er->pc<0 ) conti
8c20: 6e 75 65 3b 0a 20 20 20 20 63 6c 6f 73 65 41 6c  nue;.    closeAl
8c30: 6c 43 75 72 73 6f 72 73 28 70 4f 74 68 65 72 29  lCursors(pOther)
8c40: 3b 0a 20 20 20 20 70 4f 74 68 65 72 2d 3e 61 62  ;.    pOther->ab
8c50: 6f 72 74 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 7d  orted = 1;.  }.}
8c60: 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f  ../* .** This ro
8c70: 75 74 69 6e 65 20 63 68 65 63 6b 73 20 74 68 61  utine checks tha
8c80: 74 20 74 68 65 20 73 71 6c 69 74 65 33 2e 61 63  t the sqlite3.ac
8c90: 74 69 76 65 56 64 62 65 43 6e 74 20 63 6f 75 6e  tiveVdbeCnt coun
8ca0: 74 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 6d 61  t variable.** ma
8cb0: 74 63 68 65 73 20 74 68 65 20 6e 75 6d 62 65 72  tches the number
8cc0: 20 6f 66 20 76 64 62 65 27 73 20 69 6e 20 74 68   of vdbe's in th
8cd0: 65 20 6c 69 73 74 20 73 71 6c 69 74 65 33 2e 70  e list sqlite3.p
8ce0: 56 64 62 65 20 74 68 61 74 20 61 72 65 0a 2a 2a  Vdbe that are.**
8cf0: 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76   currently activ
8d00: 65 2e 20 41 6e 20 61 73 73 65 72 74 69 6f 6e 20  e. An assertion 
8d10: 66 61 69 6c 73 20 69 66 20 74 68 65 20 74 77 6f  fails if the two
8d20: 20 63 6f 75 6e 74 73 20 64 6f 20 6e 6f 74 20 6d   counts do not m
8d30: 61 74 63 68 2e 0a 2a 2a 20 54 68 69 73 20 69 73  atch..** This is
8d40: 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 73 65 6c   an internal sel
8d50: 66 2d 63 68 65 63 6b 20 6f 6e 6c 79 20 2d 20 69  f-check only - i
8d60: 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 73 73 65  t is not an esse
8d70: 6e 74 69 61 6c 20 70 72 6f 63 65 73 73 69 6e 67  ntial processing
8d80: 0a 2a 2a 20 73 74 65 70 2e 0a 2a 2a 0a 2a 2a 20  .** step..**.** 
8d90: 54 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 20  This is a no-op 
8da0: 69 66 20 4e 44 45 42 55 47 20 69 73 20 64 65 66  if NDEBUG is def
8db0: 69 6e 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66  ined..*/.#ifndef
8dc0: 20 4e 44 45 42 55 47 0a 73 74 61 74 69 63 20 76   NDEBUG.static v
8dd0: 6f 69 64 20 63 68 65 63 6b 41 63 74 69 76 65 56  oid checkActiveV
8de0: 64 62 65 43 6e 74 28 73 71 6c 69 74 65 33 20 2a  dbeCnt(sqlite3 *
8df0: 64 62 29 7b 0a 20 20 56 64 62 65 20 2a 70 3b 0a  db){.  Vdbe *p;.
8e00: 20 20 69 6e 74 20 63 6e 74 20 3d 20 30 3b 0a 20    int cnt = 0;. 
8e10: 20 70 20 3d 20 64 62 2d 3e 70 56 64 62 65 3b 0a   p = db->pVdbe;.
8e20: 20 20 77 68 69 6c 65 28 20 70 20 29 7b 0a 20 20    while( p ){.  
8e30: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 3d 3d    if( p->magic==
8e40: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26  VDBE_MAGIC_RUN &
8e50: 26 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20  & p->pc>=0 ){.  
8e60: 20 20 20 20 63 6e 74 2b 2b 3b 0a 20 20 20 20 7d      cnt++;.    }
8e70: 0a 20 20 20 20 70 20 3d 20 70 2d 3e 70 4e 65 78  .    p = p->pNex
8e80: 74 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28  t;.  }.  assert(
8e90: 20 63 6e 74 3d 3d 64 62 2d 3e 61 63 74 69 76 65   cnt==db->active
8ea0: 56 64 62 65 43 6e 74 20 29 3b 0a 7d 0a 23 65 6c  VdbeCnt );.}.#el
8eb0: 73 65 0a 23 64 65 66 69 6e 65 20 63 68 65 63 6b  se.#define check
8ec0: 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 78 29  ActiveVdbeCnt(x)
8ed0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54  .#endif../*.** T
8ee0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63  his routine is c
8ef0: 61 6c 6c 65 64 20 74 68 65 20 77 68 65 6e 20 61  alled the when a
8f00: 20 56 44 42 45 20 74 72 69 65 73 20 74 6f 20 68   VDBE tries to h
8f10: 61 6c 74 2e 20 20 49 66 20 74 68 65 20 56 44 42  alt.  If the VDB
8f20: 45 0a 2a 2a 20 68 61 73 20 6d 61 64 65 20 63 68  E.** has made ch
8f30: 61 6e 67 65 73 20 61 6e 64 20 69 73 20 69 6e 20  anges and is in 
8f40: 61 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 2c  autocommit mode,
8f50: 20 74 68 65 6e 20 63 6f 6d 6d 69 74 20 74 68 6f   then commit tho
8f60: 73 65 0a 2a 2a 20 63 68 61 6e 67 65 73 2e 20 20  se.** changes.  
8f70: 49 66 20 61 20 72 6f 6c 6c 62 61 63 6b 20 69 73  If a rollback is
8f80: 20 6e 65 65 64 65 64 2c 20 74 68 65 6e 20 64 6f   needed, then do
8f90: 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a   the rollback..*
8fa0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
8fb0: 65 20 69 73 20 74 68 65 20 6f 6e 6c 79 20 77 61  e is the only wa
8fc0: 79 20 74 6f 20 6d 6f 76 65 20 74 68 65 20 73 74  y to move the st
8fd0: 61 74 65 20 6f 66 20 61 20 56 4d 20 66 72 6f 6d  ate of a VM from
8fe0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 41 47 49 43  .** SQLITE_MAGIC
8ff0: 5f 52 55 4e 20 74 6f 20 53 51 4c 49 54 45 5f 4d  _RUN to SQLITE_M
9000: 41 47 49 43 5f 48 41 4c 54 2e 0a 2a 2a 0a 2a 2a  AGIC_HALT..**.**
9010: 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72   Return an error
9020: 20 63 6f 64 65 2e 20 20 49 66 20 74 68 65 20 63   code.  If the c
9030: 6f 6d 6d 69 74 20 63 6f 75 6c 64 20 6e 6f 74 20  ommit could not 
9040: 63 6f 6d 70 6c 65 74 65 20 62 65 63 61 75 73 65  complete because
9050: 20 6f 66 0a 2a 2a 20 6c 6f 63 6b 20 63 6f 6e 74   of.** lock cont
9060: 65 6e 74 69 6f 6e 2c 20 72 65 74 75 72 6e 20 53  ention, return S
9070: 51 4c 49 54 45 5f 42 55 53 59 2e 20 20 49 66 20  QLITE_BUSY.  If 
9080: 53 51 4c 49 54 45 5f 42 55 53 59 20 69 73 20 72  SQLITE_BUSY is r
9090: 65 74 75 72 6e 65 64 2c 20 69 74 0a 2a 2a 20 6d  eturned, it.** m
90a0: 65 61 6e 73 20 74 68 65 20 63 6c 6f 73 65 20 64  eans the close d
90b0: 69 64 20 6e 6f 74 20 68 61 70 70 65 6e 20 61 6e  id not happen an
90c0: 64 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65  d needs to be re
90d0: 70 65 61 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  peated..*/.int s
90e0: 71 6c 69 74 65 33 56 64 62 65 48 61 6c 74 28 56  qlite3VdbeHalt(V
90f0: 64 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74  dbe *p){.  sqlit
9100: 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 62 3b 0a  e3 *db = p->db;.
9110: 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 28    int i;.  int (
9120: 2a 78 46 75 6e 63 29 28 42 74 72 65 65 20 2a 70  *xFunc)(Btree *p
9130: 42 74 29 20 3d 20 30 3b 20 20 2f 2a 20 46 75 6e  Bt) = 0;  /* Fun
9140: 63 74 69 6f 6e 20 74 6f 20 63 61 6c 6c 20 6f 6e  ction to call on
9150: 20 65 61 63 68 20 62 74 72 65 65 20 62 61 63 6b   each btree back
9160: 65 6e 64 20 2a 2f 0a 0a 20 20 69 66 28 20 70 2d  end */..  if( p-
9170: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47  >magic!=VDBE_MAG
9180: 49 43 5f 52 55 4e 20 29 7b 0a 20 20 20 20 2f 2a  IC_RUN ){.    /*
9190: 20 41 6c 72 65 61 64 79 20 68 61 6c 74 65 64 2e   Already halted.
91a0: 20 20 4e 6f 74 68 69 6e 67 20 74 6f 20 64 6f 2e    Nothing to do.
91b0: 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20   */.    assert( 
91c0: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
91d0: 41 47 49 43 5f 48 41 4c 54 20 29 3b 0a 20 20 20  AGIC_HALT );.   
91e0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
91f0: 4b 3b 0a 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c  K;.  }.  closeAl
9200: 6c 43 75 72 73 6f 72 73 28 70 29 3b 0a 20 20 63  lCursors(p);.  c
9210: 68 65 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e  heckActiveVdbeCn
9220: 74 28 64 62 29 3b 0a 20 20 69 66 28 20 70 2d 3e  t(db);.  if( p->
9230: 70 63 3c 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4e  pc<0 ){.    /* N
9240: 6f 20 63 6f 6d 6d 69 74 20 6f 72 20 72 6f 6c 6c  o commit or roll
9250: 62 61 63 6b 20 6e 65 65 64 65 64 20 69 66 20 74  back needed if t
9260: 68 65 20 70 72 6f 67 72 61 6d 20 6e 65 76 65 72  he program never
9270: 20 73 74 61 72 74 65 64 20 2a 2f 0a 20 20 7d 65   started */.  }e
9280: 6c 73 65 20 69 66 28 20 64 62 2d 3e 61 75 74 6f  lse if( db->auto
9290: 43 6f 6d 6d 69 74 20 26 26 20 64 62 2d 3e 61 63  Commit && db->ac
92a0: 74 69 76 65 56 64 62 65 43 6e 74 3d 3d 31 20 29  tiveVdbeCnt==1 )
92b0: 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 72 63 3d  {.    if( p->rc=
92c0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d  =SQLITE_OK || p-
92d0: 3e 65 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45  >errorAction==OE
92e0: 5f 46 61 69 6c 20 29 7b 0a 20 20 20 20 20 20 2f  _Fail ){.      /
92f0: 2a 20 54 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69  * The auto-commi
9300: 74 20 66 6c 61 67 20 69 73 20 74 72 75 65 2c 20  t flag is true, 
9310: 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 74 68  there are no oth
9320: 65 72 20 61 63 74 69 76 65 20 71 75 65 72 69 65  er active querie
9330: 73 0a 20 20 20 20 20 20 2a 2a 20 75 73 69 6e 67  s.      ** using
9340: 20 74 68 69 73 20 68 61 6e 64 6c 65 20 61 6e 64   this handle and
9350: 20 74 68 65 20 76 64 62 65 20 70 72 6f 67 72 61   the vdbe progra
9360: 6d 20 77 61 73 20 73 75 63 63 65 73 73 66 75 6c  m was successful
9370: 20 6f 72 20 68 69 74 20 61 6e 0a 20 20 20 20 20   or hit an.     
9380: 20 2a 2a 20 27 4f 52 20 46 41 49 4c 27 20 63 6f   ** 'OR FAIL' co
9390: 6e 73 74 72 61 69 6e 74 2e 20 54 68 69 73 20 6d  nstraint. This m
93a0: 65 61 6e 73 20 61 20 63 6f 6d 6d 69 74 20 69 73  eans a commit is
93b0: 20 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 20   required..     
93c0: 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 72 63   */.      int rc
93d0: 20 3d 20 76 64 62 65 43 6f 6d 6d 69 74 28 64 62   = vdbeCommit(db
93e0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d  );.      if( rc=
93f0: 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a  =SQLITE_BUSY ){.
9400: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53          return S
9410: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20  QLITE_BUSY;.    
9420: 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d    }else if( rc!=
9430: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
9440: 20 20 20 20 20 70 2d 3e 72 63 20 3d 20 72 63 3b       p->rc = rc;
9450: 0a 20 20 20 20 20 20 20 20 78 46 75 6e 63 20 3d  .        xFunc =
9460: 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c   sqlite3BtreeRol
9470: 6c 62 61 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 20  lback;.      }. 
9480: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
9490: 78 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 33 42  xFunc = sqlite3B
94a0: 74 72 65 65 52 6f 6c 6c 62 61 63 6b 3b 0a 20 20  treeRollback;.  
94b0: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20    }.  }else{.   
94c0: 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49   if( p->rc==SQLI
94d0: 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72 6f  TE_OK || p->erro
94e0: 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c  rAction==OE_Fail
94f0: 20 29 7b 0a 20 20 20 20 20 20 78 46 75 6e 63 20   ){.      xFunc 
9500: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f  = sqlite3BtreeCo
9510: 6d 6d 69 74 53 74 6d 74 3b 0a 20 20 20 20 7d 65  mmitStmt;.    }e
9520: 6c 73 65 20 69 66 28 20 70 2d 3e 65 72 72 6f 72  lse if( p->error
9530: 41 63 74 69 6f 6e 3d 3d 4f 45 5f 41 62 6f 72 74  Action==OE_Abort
9540: 20 29 7b 0a 20 20 20 20 20 20 78 46 75 6e 63 20   ){.      xFunc 
9550: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f  = sqlite3BtreeRo
9560: 6c 6c 62 61 63 6b 53 74 6d 74 3b 0a 20 20 20 20  llbackStmt;.    
9570: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 78 46 75  }else{.      xFu
9580: 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  nc = sqlite3Btre
9590: 65 52 6f 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 20  eRollback;.     
95a0: 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20   db->autoCommit 
95b0: 3d 20 31 3b 0a 20 20 20 20 20 20 61 62 6f 72 74  = 1;.      abort
95c0: 4f 74 68 65 72 41 63 74 69 76 65 56 64 62 65 73  OtherActiveVdbes
95d0: 28 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  (p);.    }.  }..
95e0: 20 20 2f 2a 20 49 66 20 78 46 75 6e 63 20 69 73    /* If xFunc is
95f0: 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20   not NULL, then 
9600: 69 74 20 69 73 20 6f 6e 65 20 6f 66 20 73 71 6c  it is one of sql
9610: 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63  ite3BtreeRollbac
9620: 6b 2c 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 42  k,.  ** sqlite3B
9630: 74 72 65 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74  treeRollbackStmt
9640: 20 6f 72 20 73 71 6c 69 74 65 33 42 74 72 65 65   or sqlite3Btree
9650: 43 6f 6d 6d 69 74 53 74 6d 74 2e 20 43 61 6c 6c  CommitStmt. Call
9660: 20 69 74 20 6f 6e 63 65 20 6f 6e 0a 20 20 2a 2a   it once on.  **
9670: 20 65 61 63 68 20 62 61 63 6b 65 6e 64 2e 20 49   each backend. I
9680: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  f an error occur
9690: 73 20 61 6e 64 20 74 68 65 20 72 65 74 75 72 6e  s and the return
96a0: 20 63 6f 64 65 20 69 73 20 73 74 69 6c 6c 0a 20   code is still. 
96b0: 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 73   ** SQLITE_OK, s
96c0: 65 74 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f  et the return co
96d0: 64 65 20 74 6f 20 74 68 65 20 6e 65 77 20 65 72  de to the new er
96e0: 72 6f 72 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a  ror value..  */.
96f0: 20 20 66 6f 72 28 69 3d 30 3b 20 78 46 75 6e 63    for(i=0; xFunc
9700: 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69   && i<db->nDb; i
9710: 2b 2b 29 7b 20 0a 20 20 20 20 69 6e 74 20 72 63  ++){ .    int rc
9720: 3b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42 74  ;.    Btree *pBt
9730: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42   = db->aDb[i].pB
9740: 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74 20 29  t;.    if( pBt )
9750: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 78 46 75  {.      rc = xFu
9760: 6e 63 28 70 42 74 29 3b 0a 20 20 20 20 20 20 69  nc(pBt);.      i
9770: 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45  f( p->rc==SQLITE
9780: 5f 4f 4b 20 29 20 70 2d 3e 72 63 20 3d 20 72 63  _OK ) p->rc = rc
9790: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
97a0: 2a 20 49 66 20 74 68 69 73 20 77 61 73 20 61 6e  * If this was an
97b0: 20 49 4e 53 45 52 54 2c 20 55 50 44 41 54 45 20   INSERT, UPDATE 
97c0: 6f 72 20 44 45 4c 45 54 45 2c 20 73 65 74 20 74  or DELETE, set t
97d0: 68 65 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65  he change counte
97e0: 72 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 63  r. */.  if( p->c
97f0: 68 61 6e 67 65 43 6e 74 4f 6e 20 26 26 20 70 2d  hangeCntOn && p-
9800: 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 69 66  >pc>=0 ){.    if
9810: 28 20 21 78 46 75 6e 63 20 7c 7c 20 78 46 75 6e  ( !xFunc || xFun
9820: 63 3d 3d 73 71 6c 69 74 65 33 42 74 72 65 65 43  c==sqlite3BtreeC
9830: 6f 6d 6d 69 74 53 74 6d 74 20 29 7b 0a 20 20 20  ommitStmt ){.   
9840: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65     sqlite3VdbeSe
9850: 74 43 68 61 6e 67 65 73 28 64 62 2c 20 70 2d 3e  tChanges(db, p->
9860: 6e 43 68 61 6e 67 65 29 3b 0a 20 20 20 20 7d 65  nChange);.    }e
9870: 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  lse{.      sqlit
9880: 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 65 73  e3VdbeSetChanges
9890: 28 64 62 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20  (db, 0);.    }. 
98a0: 20 20 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d 20     p->nChange = 
98b0: 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 6f 6c  0;.  }..  /* Rol
98c0: 6c 62 61 63 6b 20 6f 72 20 63 6f 6d 6d 69 74 20  lback or commit 
98d0: 61 6e 79 20 73 63 68 65 6d 61 20 63 68 61 6e 67  any schema chang
98e0: 65 73 20 74 68 61 74 20 6f 63 63 75 72 72 65 64  es that occurred
98f0: 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 72 63  . */.  if( p->rc
9900: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
9910: 20 20 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61     sqlite3Rollba
9920: 63 6b 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65  ckInternalChange
9930: 73 28 64 62 29 3b 0a 20 20 7d 65 6c 73 65 20 69  s(db);.  }else i
9940: 66 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  f( db->flags & S
9950: 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e  QLITE_InternChan
9960: 67 65 73 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ges ){.    sqlit
9970: 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c  e3CommitInternal
9980: 43 68 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d  Changes(db);.  }
9990: 0a 0a 20 20 2f 2a 20 57 65 20 68 61 76 65 20 73  ..  /* We have s
99a0: 75 63 63 65 73 73 66 75 6c 6c 79 20 68 61 6c 74  uccessfully halt
99b0: 65 64 20 61 6e 64 20 63 6c 6f 73 65 64 20 74 68  ed and closed th
99c0: 65 20 56 4d 2e 20 20 52 65 63 6f 72 64 20 74 68  e VM.  Record th
99d0: 69 73 20 66 61 63 74 2e 20 2a 2f 0a 20 20 69 66  is fact. */.  if
99e0: 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20  ( p->pc>=0 ){.  
99f0: 20 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65    db->activeVdbe
9a00: 43 6e 74 2d 2d 3b 0a 20 20 7d 0a 20 20 70 2d 3e  Cnt--;.  }.  p->
9a10: 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47  magic = VDBE_MAG
9a20: 49 43 5f 48 41 4c 54 3b 0a 20 20 63 68 65 63 6b  IC_HALT;.  check
9a30: 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64 62  ActiveVdbeCnt(db
9a40: 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  );..  return SQL
9a50: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
9a60: 20 43 6c 65 61 6e 20 75 70 20 61 20 56 44 42 45   Clean up a VDBE
9a70: 20 61 66 74 65 72 20 65 78 65 63 75 74 69 6f 6e   after execution
9a80: 20 62 75 74 20 64 6f 20 6e 6f 74 20 64 65 6c 65   but do not dele
9a90: 74 65 20 74 68 65 20 56 44 42 45 20 6a 75 73 74  te the VDBE just
9aa0: 20 79 65 74 2e 0a 2a 2a 20 57 72 69 74 65 20 61   yet..** Write a
9ab0: 6e 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  ny error message
9ac0: 73 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67  s into *pzErrMsg
9ad0: 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 72 65  .  Return the re
9ae0: 73 75 6c 74 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a  sult code..**.**
9af0: 20 41 66 74 65 72 20 74 68 69 73 20 72 6f 75 74   After this rout
9b00: 69 6e 65 20 69 73 20 72 75 6e 2c 20 74 68 65 20  ine is run, the 
9b10: 56 44 42 45 20 73 68 6f 75 6c 64 20 62 65 20 72  VDBE should be r
9b20: 65 61 64 79 20 74 6f 20 62 65 20 65 78 65 63 75  eady to be execu
9b30: 74 65 64 0a 2a 2a 20 61 67 61 69 6e 2e 0a 2a 2a  ted.** again..**
9b40: 0a 2a 2a 20 54 6f 20 6c 6f 6f 6b 20 61 74 20 69  .** To look at i
9b50: 74 20 61 6e 6f 74 68 65 72 20 77 61 79 2c 20 74  t another way, t
9b60: 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 73 65  his routine rese
9b70: 74 73 20 74 68 65 20 73 74 61 74 65 20 6f 66 20  ts the state of 
9b80: 74 68 65 0a 2a 2a 20 76 69 72 74 75 61 6c 20 6d  the.** virtual m
9b90: 61 63 68 69 6e 65 20 66 72 6f 6d 20 56 44 42 45  achine from VDBE
9ba0: 5f 4d 41 47 49 43 5f 52 55 4e 20 6f 72 20 56 44  _MAGIC_RUN or VD
9bb0: 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 62 61  BE_MAGIC_HALT ba
9bc0: 63 6b 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41  ck to.** VDBE_MA
9bd0: 47 49 43 5f 49 4e 49 54 2e 0a 2a 2f 0a 69 6e 74  GIC_INIT..*/.int
9be0: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73 65   sqlite3VdbeRese
9bf0: 74 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 66  t(Vdbe *p){.  if
9c00: 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45  ( p->magic!=VDBE
9c10: 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 70 2d  _MAGIC_RUN && p-
9c20: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47  >magic!=VDBE_MAG
9c30: 49 43 5f 48 41 4c 54 20 29 7b 0a 20 20 20 20 73  IC_HALT ){.    s
9c40: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64  qlite3Error(p->d
9c50: 62 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  b, SQLITE_MISUSE
9c60: 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  , 0);.    return
9c70: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
9c80: 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65    }..  /* If the
9c90: 20 56 4d 20 64 69 64 20 6e 6f 74 20 72 75 6e 20   VM did not run 
9ca0: 74 6f 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 72  to completion or
9cb0: 20 69 66 20 69 74 20 65 6e 63 6f 75 6e 74 65 72   if it encounter
9cc0: 65 64 20 61 6e 0a 20 20 2a 2a 20 65 72 72 6f 72  ed an.  ** error
9cd0: 2c 20 74 68 65 6e 20 69 74 20 6d 69 67 68 74 20  , then it might 
9ce0: 6e 6f 74 20 68 61 76 65 20 62 65 65 6e 20 68 61  not have been ha
9cf0: 6c 74 65 64 20 70 72 6f 70 65 72 6c 79 2e 20 20  lted properly.  
9d00: 53 6f 20 68 61 6c 74 0a 20 20 2a 2a 20 69 74 20  So halt.  ** it 
9d10: 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69  now..  */.  sqli
9d20: 74 65 33 56 64 62 65 48 61 6c 74 28 70 29 3b 0a  te3VdbeHalt(p);.
9d30: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 56 44 42  .  /* If the VDB
9d40: 45 20 68 61 73 20 62 65 20 72 75 6e 20 65 76 65  E has be run eve
9d50: 6e 20 70 61 72 74 69 61 6c 6c 79 2c 20 74 68 65  n partially, the
9d60: 6e 20 74 72 61 6e 73 66 65 72 20 74 68 65 20 65  n transfer the e
9d70: 72 72 6f 72 20 63 6f 64 65 0a 20 20 2a 2a 20 61  rror code.  ** a
9d80: 6e 64 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  nd error message
9d90: 20 66 72 6f 6d 20 74 68 65 20 56 44 42 45 20 69   from the VDBE i
9da0: 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20 64 61 74  nto the main dat
9db0: 61 62 61 73 65 20 73 74 72 75 63 74 75 72 65 2e  abase structure.
9dc0: 20 20 42 75 74 0a 20 20 2a 2a 20 69 66 20 74 68    But.  ** if th
9dd0: 65 20 56 44 42 45 20 68 61 73 20 6a 75 73 74 20  e VDBE has just 
9de0: 62 65 65 6e 20 73 65 74 20 74 6f 20 72 75 6e 20  been set to run 
9df0: 62 75 74 20 68 61 73 20 6e 6f 74 20 61 63 74 75  but has not actu
9e00: 61 6c 6c 79 20 65 78 65 63 75 74 65 64 20 61 6e  ally executed an
9e10: 79 0a 20 20 2a 2a 20 69 6e 73 74 72 75 63 74 69  y.  ** instructi
9e20: 6f 6e 73 20 79 65 74 2c 20 6c 65 61 76 65 20 74  ons yet, leave t
9e30: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
9e40: 20 65 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69   error informati
9e50: 6f 6e 20 75 6e 63 68 61 6e 67 65 64 2e 0a 20 20  on unchanged..  
9e60: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 63 3e 3d  */.  if( p->pc>=
9e70: 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e  0 ){.    if( p->
9e80: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 20  zErrMsg ){.     
9e90: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d   sqlite3Error(p-
9ea0: 3e 64 62 2c 20 70 2d 3e 72 63 2c 20 22 25 73 22  >db, p->rc, "%s"
9eb0: 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20  , p->zErrMsg);. 
9ec0: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
9ed0: 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  p->zErrMsg);.   
9ee0: 20 20 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20     p->zErrMsg = 
9ef0: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28  0;.    }else if(
9f00: 20 70 2d 3e 72 63 20 29 7b 0a 20 20 20 20 20 20   p->rc ){.      
9f10: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e  sqlite3Error(p->
9f20: 64 62 2c 20 70 2d 3e 72 63 2c 20 30 29 3b 0a 20  db, p->rc, 0);. 
9f30: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
9f40: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e  sqlite3Error(p->
9f50: 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30  db, SQLITE_OK, 0
9f60: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  );.    }.  }else
9f70: 20 69 66 28 20 70 2d 3e 72 63 20 26 26 20 70 2d   if( p->rc && p-
9f80: 3e 65 78 70 69 72 65 64 20 29 7b 0a 20 20 20 20  >expired ){.    
9f90: 2f 2a 20 54 68 65 20 65 78 70 69 72 65 64 20 66  /* The expired f
9fa0: 6c 61 67 20 77 61 73 20 73 65 74 20 6f 6e 20 74  lag was set on t
9fb0: 68 65 20 56 44 42 45 20 62 65 66 6f 72 65 20 74  he VDBE before t
9fc0: 68 65 20 66 69 72 73 74 20 63 61 6c 6c 0a 20 20  he first call.  
9fd0: 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f    ** to sqlite3_
9fe0: 73 74 65 70 28 29 2e 20 46 6f 72 20 63 6f 6e 73  step(). For cons
9ff0: 69 73 74 65 6e 63 79 20 28 73 69 6e 63 65 20 73  istency (since s
a000: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 20 77 61  qlite3_step() wa
a010: 73 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 65 64 29  s.    ** called)
a020: 2c 20 73 65 74 20 74 68 65 20 64 61 74 61 62 61  , set the databa
a030: 73 65 20 65 72 72 6f 72 20 69 6e 20 74 68 69 73  se error in this
a040: 20 63 61 73 65 20 61 73 20 77 65 6c 6c 2e 0a 20   case as well.. 
a050: 20 20 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65     */.    sqlite
a060: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d  3Error(p->db, p-
a070: 3e 72 63 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20  >rc, 0);.  }..  
a080: 2f 2a 20 52 65 63 6c 61 69 6d 20 61 6c 6c 20 6d  /* Reclaim all m
a090: 65 6d 6f 72 79 20 75 73 65 64 20 62 79 20 74 68  emory used by th
a0a0: 65 20 56 44 42 45 0a 20 20 2a 2f 0a 20 20 43 6c  e VDBE.  */.  Cl
a0b0: 65 61 6e 75 70 28 70 29 3b 0a 0a 20 20 2f 2a 20  eanup(p);..  /* 
a0c0: 53 61 76 65 20 70 72 6f 66 69 6c 69 6e 67 20 69  Save profiling i
a0d0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20  nformation from 
a0e0: 74 68 69 73 20 56 44 42 45 20 72 75 6e 2e 0a 20  this VDBE run.. 
a0f0: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d   */.  assert( p-
a100: 3e 70 54 6f 73 3c 26 70 2d 3e 61 53 74 61 63 6b  >pTos<&p->aStack
a110: 5b 70 2d 3e 70 63 3c 30 3f 30 3a 70 2d 3e 70 63  [p->pc<0?0:p->pc
a120: 5d 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 61 6c  ] || sqlite3_mal
a130: 6c 6f 63 5f 66 61 69 6c 65 64 3d 3d 31 20 29 3b  loc_failed==1 );
a140: 0a 23 69 66 64 65 66 20 56 44 42 45 5f 50 52 4f  .#ifdef VDBE_PRO
a150: 46 49 4c 45 0a 20 20 7b 0a 20 20 20 20 46 49 4c  FILE.  {.    FIL
a160: 45 20 2a 6f 75 74 20 3d 20 66 6f 70 65 6e 28 22  E *out = fopen("
a170: 76 64 62 65 5f 70 72 6f 66 69 6c 65 2e 6f 75 74  vdbe_profile.out
a180: 22 2c 20 22 61 22 29 3b 0a 20 20 20 20 69 66 28  ", "a");.    if(
a190: 20 6f 75 74 20 29 7b 0a 20 20 20 20 20 20 69 6e   out ){.      in
a1a0: 74 20 69 3b 0a 20 20 20 20 20 20 66 70 72 69 6e  t i;.      fprin
a1b0: 74 66 28 6f 75 74 2c 20 22 2d 2d 2d 2d 20 22 29  tf(out, "---- ")
a1c0: 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b  ;.      for(i=0;
a1d0: 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b   i<p->nOp; i++){
a1e0: 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74 66  .        fprintf
a1f0: 28 6f 75 74 2c 20 22 25 30 32 78 22 2c 20 70 2d  (out, "%02x", p-
a200: 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f 64 65 29 3b  >aOp[i].opcode);
a210: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66  .      }.      f
a220: 70 72 69 6e 74 66 28 6f 75 74 2c 20 22 5c 6e 22  printf(out, "\n"
a230: 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30  );.      for(i=0
a240: 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29  ; i<p->nOp; i++)
a250: 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74  {.        fprint
a260: 66 28 6f 75 74 2c 20 22 25 36 64 20 25 31 30 6c  f(out, "%6d %10l
a270: 6c 64 20 25 38 6c 6c 64 20 22 2c 0a 20 20 20 20  ld %8lld ",.    
a280: 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d         p->aOp[i]
a290: 2e 63 6e 74 2c 0a 20 20 20 20 20 20 20 20 20 20  .cnt,.          
a2a0: 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65   p->aOp[i].cycle
a2b0: 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 2d  s,.           p-
a2c0: 3e 61 4f 70 5b 69 5d 2e 63 6e 74 3e 30 20 3f 20  >aOp[i].cnt>0 ? 
a2d0: 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73  p->aOp[i].cycles
a2e0: 2f 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 20 3a  /p->aOp[i].cnt :
a2f0: 20 30 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20   0.        );.  
a300: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
a310: 65 50 72 69 6e 74 4f 70 28 6f 75 74 2c 20 69 2c  ePrintOp(out, i,
a320: 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20 20   &p->aOp[i]);.  
a330: 20 20 20 20 7d 0a 20 20 20 20 20 20 66 63 6c 6f      }.      fclo
a340: 73 65 28 6f 75 74 29 3b 0a 20 20 20 20 7d 0a 20  se(out);.    }. 
a350: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 2d 3e 6d   }.#endif.  p->m
a360: 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49  agic = VDBE_MAGI
a370: 43 5f 49 4e 49 54 3b 0a 20 20 70 2d 3e 61 62 6f  C_INIT;.  p->abo
a380: 72 74 65 64 20 3d 20 30 3b 0a 20 20 69 66 28 20  rted = 0;.  if( 
a390: 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43  p->rc==SQLITE_SC
a3a0: 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c 69  HEMA ){.    sqli
a3b0: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
a3c0: 53 63 68 65 6d 61 28 70 2d 3e 64 62 2c 20 30 29  Schema(p->db, 0)
a3d0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
a3e0: 2d 3e 72 63 3b 0a 7d 0a 20 0a 2f 2a 0a 2a 2a 20  ->rc;.}. ./*.** 
a3f0: 43 6c 65 61 6e 20 75 70 20 61 6e 64 20 64 65 6c  Clean up and del
a400: 65 74 65 20 61 20 56 44 42 45 20 61 66 74 65 72  ete a VDBE after
a410: 20 65 78 65 63 75 74 69 6f 6e 2e 20 20 52 65 74   execution.  Ret
a420: 75 72 6e 20 61 6e 20 69 6e 74 65 67 65 72 20 77  urn an integer w
a430: 68 69 63 68 20 69 73 0a 2a 2a 20 74 68 65 20 72  hich is.** the r
a440: 65 73 75 6c 74 20 63 6f 64 65 2e 20 20 57 72 69  esult code.  Wri
a450: 74 65 20 61 6e 79 20 65 72 72 6f 72 20 6d 65 73  te any error mes
a460: 73 61 67 65 20 74 65 78 74 20 69 6e 74 6f 20 2a  sage text into *
a470: 70 7a 45 72 72 4d 73 67 2e 0a 2a 2f 0a 69 6e 74  pzErrMsg..*/.int
a480: 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e 61   sqlite3VdbeFina
a490: 6c 69 7a 65 28 56 64 62 65 20 2a 70 29 7b 0a 20  lize(Vdbe *p){. 
a4a0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
a4b0: 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 70 2d 3e 6d  _OK;..  if( p->m
a4c0: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
a4d0: 5f 52 55 4e 20 7c 7c 20 70 2d 3e 6d 61 67 69 63  _RUN || p->magic
a4e0: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  ==VDBE_MAGIC_HAL
a4f0: 54 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71  T ){.    rc = sq
a500: 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28 70  lite3VdbeReset(p
a510: 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70  );.  }else if( p
a520: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
a530: 47 49 43 5f 49 4e 49 54 20 29 7b 0a 20 20 20 20  GIC_INIT ){.    
a540: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
a550: 53 55 53 45 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  SUSE;.  }.  sqli
a560: 74 65 33 56 64 62 65 44 65 6c 65 74 65 28 70 29  te3VdbeDelete(p)
a570: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
a580: 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 65  ../*.** Call the
a590: 20 64 65 73 74 72 75 63 74 6f 72 20 66 6f 72 20   destructor for 
a5a0: 65 61 63 68 20 61 75 78 64 61 74 61 20 65 6e 74  each auxdata ent
a5b0: 72 79 20 69 6e 20 70 56 64 62 65 46 75 6e 63 20  ry in pVdbeFunc 
a5c0: 66 6f 72 20 77 68 69 63 68 0a 2a 2a 20 74 68 65  for which.** the
a5d0: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 62   corresponding b
a5e0: 69 74 20 69 6e 20 6d 61 73 6b 20 69 73 20 63 6c  it in mask is cl
a5f0: 65 61 72 2e 20 20 41 75 78 64 61 74 61 20 65 6e  ear.  Auxdata en
a600: 74 72 69 65 73 20 62 65 79 6f 6e 64 20 33 31 0a  tries beyond 31.
a610: 2a 2a 20 61 72 65 20 61 6c 77 61 79 73 20 64 65  ** are always de
a620: 73 74 72 6f 79 65 64 2e 20 20 54 6f 20 64 65 73  stroyed.  To des
a630: 74 72 6f 79 20 61 6c 6c 20 61 75 78 64 61 74 61  troy all auxdata
a640: 20 65 6e 74 72 69 65 73 2c 20 63 61 6c 6c 20 74   entries, call t
a650: 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 77  his.** routine w
a660: 69 74 68 20 6d 61 73 6b 3d 3d 30 2e 0a 2a 2f 0a  ith mask==0..*/.
a670: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
a680: 44 65 6c 65 74 65 41 75 78 44 61 74 61 28 56 64  DeleteAuxData(Vd
a690: 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e  beFunc *pVdbeFun
a6a0: 63 2c 20 69 6e 74 20 6d 61 73 6b 29 7b 0a 20 20  c, int mask){.  
a6b0: 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30  int i;.  for(i=0
a6c0: 3b 20 69 3c 70 56 64 62 65 46 75 6e 63 2d 3e 6e  ; i<pVdbeFunc->n
a6d0: 41 75 78 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73  Aux; i++){.    s
a6e0: 74 72 75 63 74 20 41 75 78 44 61 74 61 20 2a 70  truct AuxData *p
a6f0: 41 75 78 20 3d 20 26 70 56 64 62 65 46 75 6e 63  Aux = &pVdbeFunc
a700: 2d 3e 61 70 41 75 78 5b 69 5d 3b 0a 20 20 20 20  ->apAux[i];.    
a710: 69 66 28 20 28 69 3e 33 31 20 7c 7c 20 21 28 6d  if( (i>31 || !(m
a720: 61 73 6b 26 28 31 3c 3c 69 29 29 29 20 26 26 20  ask&(1<<i))) && 
a730: 70 41 75 78 2d 3e 70 41 75 78 20 29 7b 0a 20 20  pAux->pAux ){.  
a740: 20 20 20 20 69 66 28 20 70 41 75 78 2d 3e 78 44      if( pAux->xD
a750: 65 6c 65 74 65 20 29 7b 0a 20 20 20 20 20 20 20  elete ){.       
a760: 20 70 41 75 78 2d 3e 78 44 65 6c 65 74 65 28 70   pAux->xDelete(p
a770: 41 75 78 2d 3e 70 41 75 78 29 3b 0a 20 20 20 20  Aux->pAux);.    
a780: 20 20 7d 0a 20 20 20 20 20 20 70 41 75 78 2d 3e    }.      pAux->
a790: 70 41 75 78 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  pAux = 0;.    }.
a7a0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c    }.}../*.** Del
a7b0: 65 74 65 20 61 6e 20 65 6e 74 69 72 65 20 56 44  ete an entire VD
a7c0: 42 45 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  BE..*/.void sqli
a7d0: 74 65 33 56 64 62 65 44 65 6c 65 74 65 28 56 64  te3VdbeDelete(Vd
a7e0: 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b  be *p){.  int i;
a7f0: 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65  .  if( p==0 ) re
a800: 74 75 72 6e 3b 0a 20 20 43 6c 65 61 6e 75 70 28  turn;.  Cleanup(
a810: 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70 50 72  p);.  if( p->pPr
a820: 65 76 20 29 7b 0a 20 20 20 20 70 2d 3e 70 50 72  ev ){.    p->pPr
a830: 65 76 2d 3e 70 4e 65 78 74 20 3d 20 70 2d 3e 70  ev->pNext = p->p
a840: 4e 65 78 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  Next;.  }else{. 
a850: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 64 62     assert( p->db
a860: 2d 3e 70 56 64 62 65 3d 3d 70 20 29 3b 0a 20 20  ->pVdbe==p );.  
a870: 20 20 70 2d 3e 64 62 2d 3e 70 56 64 62 65 20 3d    p->db->pVdbe =
a880: 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20   p->pNext;.  }. 
a890: 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 7b   if( p->pNext ){
a8a0: 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 2d 3e 70  .    p->pNext->p
a8b0: 50 72 65 76 20 3d 20 70 2d 3e 70 50 72 65 76 3b  Prev = p->pPrev;
a8c0: 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e 61 4f  .  }.  if( p->aO
a8d0: 70 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30  p ){.    for(i=0
a8e0: 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29  ; i<p->nOp; i++)
a8f0: 7b 0a 20 20 20 20 20 20 4f 70 20 2a 70 4f 70 20  {.      Op *pOp 
a900: 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20  = &p->aOp[i];.  
a910: 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 33 74      if( pOp->p3t
a920: 79 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20  ype==P3_DYNAMIC 
a930: 7c 7c 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d  || pOp->p3type==
a940: 50 33 5f 4b 45 59 49 4e 46 4f 20 29 7b 0a 20 20  P3_KEYINFO ){.  
a950: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
a960: 28 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20 20  (pOp->p3);.     
a970: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70 4f 70   }.      if( pOp
a980: 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 56 44 42  ->p3type==P3_VDB
a990: 45 46 55 4e 43 20 29 7b 0a 20 20 20 20 20 20 20  EFUNC ){.       
a9a0: 20 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65   VdbeFunc *pVdbe
a9b0: 46 75 6e 63 20 3d 20 28 56 64 62 65 46 75 6e 63  Func = (VdbeFunc
a9c0: 20 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20   *)pOp->p3;.    
a9d0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 44      sqlite3VdbeD
a9e0: 65 6c 65 74 65 41 75 78 44 61 74 61 28 70 56 64  eleteAuxData(pVd
a9f0: 62 65 46 75 6e 63 2c 20 30 29 3b 0a 20 20 20 20  beFunc, 0);.    
aa00: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
aa10: 56 64 62 65 46 75 6e 63 29 3b 0a 20 20 20 20 20  VdbeFunc);.     
aa20: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70 4f 70   }.      if( pOp
aa30: 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 4d 45 4d  ->p3type==P3_MEM
aa40: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69   ){.        sqli
aa50: 74 65 33 56 61 6c 75 65 46 72 65 65 28 28 73 71  te3ValueFree((sq
aa60: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 70 4f 70  lite3_value*)pOp
aa70: 2d 3e 70 33 29 3b 0a 20 20 20 20 20 20 7d 0a 20  ->p3);.      }. 
aa80: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 46     }.    sqliteF
aa90: 72 65 65 28 70 2d 3e 61 4f 70 29 3b 0a 20 20 7d  ree(p->aOp);.  }
aaa0: 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72  .  releaseMemArr
aab0: 61 79 28 70 2d 3e 61 56 61 72 2c 20 70 2d 3e 6e  ay(p->aVar, p->n
aac0: 56 61 72 29 3b 0a 20 20 73 71 6c 69 74 65 46 72  Var);.  sqliteFr
aad0: 65 65 28 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20  ee(p->aLabel);. 
aae0: 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61   sqliteFree(p->a
aaf0: 53 74 61 63 6b 29 3b 0a 20 20 72 65 6c 65 61 73  Stack);.  releas
ab00: 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 43 6f  eMemArray(p->aCo
ab10: 6c 4e 61 6d 65 2c 20 70 2d 3e 6e 52 65 73 43 6f  lName, p->nResCo
ab20: 6c 75 6d 6e 2a 32 29 3b 0a 20 20 73 71 6c 69 74  lumn*2);.  sqlit
ab30: 65 46 72 65 65 28 70 2d 3e 61 43 6f 6c 4e 61 6d  eFree(p->aColNam
ab40: 65 29 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d  e);.  p->magic =
ab50: 20 56 44 42 45 5f 4d 41 47 49 43 5f 44 45 41 44   VDBE_MAGIC_DEAD
ab60: 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  ;.  sqliteFree(p
ab70: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 61  );.}../*.** If a
ab80: 20 4d 6f 76 65 54 6f 20 6f 70 65 72 61 74 69 6f   MoveTo operatio
ab90: 6e 20 69 73 20 70 65 6e 64 69 6e 67 20 6f 6e 20  n is pending on 
aba0: 74 68 65 20 67 69 76 65 6e 20 63 75 72 73 6f 72  the given cursor
abb0: 2c 20 74 68 65 6e 20 64 6f 20 74 68 61 74 0a 2a  , then do that.*
abc0: 2a 20 4d 6f 76 65 54 6f 20 6e 6f 77 2e 20 20 52  * MoveTo now.  R
abd0: 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63  eturn an error c
abe0: 6f 64 65 2e 20 20 49 66 20 6e 6f 20 4d 6f 76 65  ode.  If no Move
abf0: 54 6f 20 69 73 20 70 65 6e 64 69 6e 67 2c 20 74  To is pending, t
ac00: 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 64  his.** routine d
ac10: 6f 65 73 20 6e 6f 74 68 69 6e 67 20 61 6e 64 20  oes nothing and 
ac20: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f  returns SQLITE_O
ac30: 4b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  K..*/.int sqlite
ac40: 33 56 64 62 65 43 75 72 73 6f 72 4d 6f 76 65 74  3VdbeCursorMovet
ac50: 6f 28 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20  o(Cursor *p){.  
ac60: 69 66 28 20 70 2d 3e 64 65 66 65 72 72 65 64 4d  if( p->deferredM
ac70: 6f 76 65 74 6f 20 29 7b 0a 20 20 20 20 69 6e 74  oveto ){.    int
ac80: 20 72 65 73 2c 20 72 63 3b 0a 20 20 20 20 65 78   res, rc;.    ex
ac90: 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33  tern int sqlite3
aca0: 5f 73 65 61 72 63 68 5f 63 6f 75 6e 74 3b 0a 20  _search_count;. 
acb0: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 6e     assert( p->in
acc0: 74 4b 65 79 20 29 3b 0a 20 20 20 20 69 66 28 20  tKey );.    if( 
acd0: 70 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20  p->intKey ){.   
ace0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
acf0: 74 72 65 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43  treeMoveto(p->pC
ad00: 75 72 73 6f 72 2c 20 30 2c 20 70 2d 3e 6d 6f 76  ursor, 0, p->mov
ad10: 65 74 6f 54 61 72 67 65 74 2c 20 26 72 65 73 29  etoTarget, &res)
ad20: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
ad30: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
ad40: 74 72 65 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43  treeMoveto(p->pC
ad50: 75 72 73 6f 72 2c 28 63 68 61 72 2a 29 26 70 2d  ursor,(char*)&p-
ad60: 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74 2c 0a 20  >movetoTarget,. 
ad70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ad80: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 69 7a               siz
ad90: 65 6f 66 28 69 36 34 29 2c 26 72 65 73 29 3b 0a  eof(i64),&res);.
ada0: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63      }.    if( rc
adb0: 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20   ) return rc;.  
adc0: 20 20 2a 70 2d 3e 70 49 6e 63 72 4b 65 79 20 3d    *p->pIncrKey =
add0: 20 30 3b 0a 20 20 20 20 70 2d 3e 6c 61 73 74 52   0;.    p->lastR
ade0: 65 63 6e 6f 20 3d 20 6b 65 79 54 6f 49 6e 74 28  ecno = keyToInt(
adf0: 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74 29  p->movetoTarget)
ae00: 3b 0a 20 20 20 20 70 2d 3e 72 65 63 6e 6f 49 73  ;.    p->recnoIs
ae10: 56 61 6c 69 64 20 3d 20 72 65 73 3d 3d 30 3b 0a  Valid = res==0;.
ae20: 20 20 20 20 69 66 28 20 72 65 73 3c 30 20 29 7b      if( res<0 ){
ae30: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
ae40: 74 65 33 42 74 72 65 65 4e 65 78 74 28 70 2d 3e  te3BtreeNext(p->
ae50: 70 43 75 72 73 6f 72 2c 20 26 72 65 73 29 3b 0a  pCursor, &res);.
ae60: 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72        if( rc ) r
ae70: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a  eturn rc;.    }.
ae80: 20 20 20 20 73 71 6c 69 74 65 33 5f 73 65 61 72      sqlite3_sear
ae90: 63 68 5f 63 6f 75 6e 74 2b 2b 3b 0a 20 20 20 20  ch_count++;.    
aea0: 70 2d 3e 64 65 66 65 72 72 65 64 4d 6f 76 65 74  p->deferredMovet
aeb0: 6f 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 63 61  o = 0;.    p->ca
aec0: 63 68 65 56 61 6c 69 64 20 3d 20 30 3b 0a 20 20  cheValid = 0;.  
aed0: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  }.  return SQLIT
aee0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  E_OK;.}../*.** T
aef0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e  he following fun
af00: 63 74 69 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73 71  ctions:.**.** sq
af10: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54  lite3VdbeSerialT
af20: 79 70 65 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33  ype().** sqlite3
af30: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
af40: 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64  n().** sqlite3Vd
af50: 62 65 53 65 72 69 61 6c 52 65 61 64 28 29 0a 2a  beSerialRead().*
af60: 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  * sqlite3VdbeSer
af70: 69 61 6c 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69  ialLen().** sqli
af80: 74 65 33 56 64 62 65 53 65 72 69 61 6c 57 72 69  te3VdbeSerialWri
af90: 74 65 28 29 0a 2a 2a 0a 2a 2a 20 65 6e 63 61 70  te().**.** encap
afa0: 73 75 6c 61 74 65 20 74 68 65 20 63 6f 64 65 20  sulate the code 
afb0: 74 68 61 74 20 73 65 72 69 61 6c 69 7a 65 73 20  that serializes 
afc0: 76 61 6c 75 65 73 20 66 6f 72 20 73 74 6f 72 61  values for stora
afd0: 67 65 20 69 6e 20 53 51 4c 69 74 65 0a 2a 2a 20  ge in SQLite.** 
afe0: 64 61 74 61 20 61 6e 64 20 69 6e 64 65 78 20 72  data and index r
aff0: 65 63 6f 72 64 73 2e 20 45 61 63 68 20 73 65 72  ecords. Each ser
b000: 69 61 6c 69 7a 65 64 20 76 61 6c 75 65 20 63 6f  ialized value co
b010: 6e 73 69 73 74 73 20 6f 66 20 61 0a 2a 2a 20 27  nsists of a.** '
b020: 73 65 72 69 61 6c 2d 74 79 70 65 27 20 61 6e 64  serial-type' and
b030: 20 61 20 62 6c 6f 62 20 6f 66 20 64 61 74 61 2e   a blob of data.
b040: 20 54 68 65 20 73 65 72 69 61 6c 20 74 79 70 65   The serial type
b050: 20 69 73 20 61 6e 20 38 2d 62 79 74 65 20 75 6e   is an 8-byte un
b060: 73 69 67 6e 65 64 0a 2a 2a 20 69 6e 74 65 67 65  signed.** intege
b070: 72 2c 20 73 74 6f 72 65 64 20 61 73 20 61 20 76  r, stored as a v
b080: 61 72 69 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20  arint..**.** In 
b090: 61 6e 20 53 51 4c 69 74 65 20 69 6e 64 65 78 20  an SQLite index 
b0a0: 72 65 63 6f 72 64 2c 20 74 68 65 20 73 65 72 69  record, the seri
b0b0: 61 6c 20 74 79 70 65 20 69 73 20 73 74 6f 72 65  al type is store
b0c0: 64 20 64 69 72 65 63 74 6c 79 20 62 65 66 6f 72  d directly befor
b0d0: 65 0a 2a 2a 20 74 68 65 20 62 6c 6f 62 20 6f 66  e.** the blob of
b0e0: 20 64 61 74 61 20 74 68 61 74 20 69 74 20 63 6f   data that it co
b0f0: 72 72 65 73 70 6f 6e 64 73 20 74 6f 2e 20 49 6e  rresponds to. In
b100: 20 61 20 74 61 62 6c 65 20 72 65 63 6f 72 64 2c   a table record,
b110: 20 61 6c 6c 20 73 65 72 69 61 6c 0a 2a 2a 20 74   all serial.** t
b120: 79 70 65 73 20 61 72 65 20 73 74 6f 72 65 64 20  ypes are stored 
b130: 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 20  at the start of 
b140: 74 68 65 20 72 65 63 6f 72 64 2c 20 61 6e 64 20  the record, and 
b150: 74 68 65 20 62 6c 6f 62 73 20 6f 66 20 64 61 74  the blobs of dat
b160: 61 20 61 74 0a 2a 2a 20 74 68 65 20 65 6e 64 2e  a at.** the end.
b170: 20 48 65 6e 63 65 20 74 68 65 73 65 20 66 75 6e   Hence these fun
b180: 63 74 69 6f 6e 73 20 61 6c 6c 6f 77 20 74 68 65  ctions allow the
b190: 20 63 61 6c 6c 65 72 20 74 6f 20 68 61 6e 64 6c   caller to handl
b1a0: 65 20 74 68 65 0a 2a 2a 20 73 65 72 69 61 6c 2d  e the.** serial-
b1b0: 74 79 70 65 20 61 6e 64 20 64 61 74 61 20 62 6c  type and data bl
b1c0: 6f 62 20 73 65 70 65 72 61 74 65 6c 79 2e 0a 2a  ob seperately..*
b1d0: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
b1e0: 6e 67 20 74 61 62 6c 65 20 64 65 73 63 72 69 62  ng table describ
b1f0: 65 73 20 74 68 65 20 76 61 72 69 6f 75 73 20 73  es the various s
b200: 74 6f 72 61 67 65 20 63 6c 61 73 73 65 73 20 66  torage classes f
b210: 6f 72 20 64 61 74 61 3a 0a 2a 2a 0a 2a 2a 20 20  or data:.**.**  
b220: 20 73 65 72 69 61 6c 20 74 79 70 65 20 20 20 20   serial type    
b230: 20 20 20 20 62 79 74 65 73 20 6f 66 20 64 61 74      bytes of dat
b240: 61 20 20 20 20 20 20 74 79 70 65 0a 2a 2a 20 20  a      type.**  
b250: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20   -------------- 
b260: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d      ------------
b270: 2d 2d 2d 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d  ---    ---------
b280: 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 30  ------.**      0
b290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b2a0: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20       0          
b2b0: 20 20 4e 55 4c 4c 0a 2a 2a 20 20 20 20 20 20 31    NULL.**      1
b2c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b2d0: 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20       1          
b2e0: 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72    signed integer
b2f0: 0a 2a 2a 20 20 20 20 20 20 32 20 20 20 20 20 20  .**      2      
b300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 32                 2
b310: 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67 6e              sign
b320: 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20  ed integer.**   
b330: 20 20 20 33 20 20 20 20 20 20 20 20 20 20 20 20     3            
b340: 20 20 20 20 20 20 20 20 20 33 20 20 20 20 20 20           3      
b350: 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74        signed int
b360: 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 34 20 20  eger.**      4  
b370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b380: 20 20 20 34 20 20 20 20 20 20 20 20 20 20 20 20     4            
b390: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a  signed integer.*
b3a0: 2a 20 20 20 20 20 20 35 20 20 20 20 20 20 20 20  *      5        
b3b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 36 20 20               6  
b3c0: 20 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64            signed
b3d0: 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20   integer.**     
b3e0: 20 36 20 20 20 20 20 20 20 20 20 20 20 20 20 20   6              
b3f0: 20 20 20 20 20 20 20 38 20 20 20 20 20 20 20 20         8        
b400: 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67      signed integ
b410: 65 72 0a 2a 2a 20 20 20 20 20 20 37 20 20 20 20  er.**      7    
b420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b430: 20 38 20 20 20 20 20 20 20 20 20 20 20 20 49 45   8            IE
b440: 45 45 20 66 6c 6f 61 74 0a 2a 2a 20 20 20 20 20  EE float.**     
b450: 38 2d 31 31 20 20 20 20 20 20 20 20 20 20 20 20  8-11            
b460: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b470: 20 20 20 20 72 65 73 65 72 76 65 64 20 66 6f 72      reserved for
b480: 20 65 78 70 61 6e 73 69 6f 6e 0a 2a 2a 20 20 20   expansion.**   
b490: 20 4e 3e 3d 31 32 20 61 6e 64 20 65 76 65 6e 20   N>=12 and even 
b4a0: 20 20 20 20 20 20 28 4e 2d 31 32 29 2f 32 20 20        (N-12)/2  
b4b0: 20 20 20 20 20 20 42 4c 4f 42 0a 2a 2a 20 20 20        BLOB.**   
b4c0: 20 4e 3e 3d 31 33 20 61 6e 64 20 6f 64 64 20 20   N>=13 and odd  
b4d0: 20 20 20 20 20 20 28 4e 2d 31 33 29 2f 32 20 20        (N-13)/2  
b4e0: 20 20 20 20 20 20 74 65 78 74 0a 2a 2a 0a 2a 2f        text.**.*/
b4f0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
b500: 68 65 20 73 65 72 69 61 6c 2d 74 79 70 65 20 66  he serial-type f
b510: 6f 72 20 74 68 65 20 76 61 6c 75 65 20 73 74 6f  or the value sto
b520: 72 65 64 20 69 6e 20 70 4d 65 6d 2e 0a 2a 2f 0a  red in pMem..*/.
b530: 75 33 32 20 73 71 6c 69 74 65 33 56 64 62 65 53  u32 sqlite3VdbeS
b540: 65 72 69 61 6c 54 79 70 65 28 4d 65 6d 20 2a 70  erialType(Mem *p
b550: 4d 65 6d 29 7b 0a 20 20 69 6e 74 20 66 6c 61 67  Mem){.  int flag
b560: 73 20 3d 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 3b  s = pMem->flags;
b570: 0a 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45  ..  if( flags&ME
b580: 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20 20 20 72 65  M_Null ){.    re
b590: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 69 66  turn 0;.  }.  if
b5a0: 28 20 66 6c 61 67 73 26 4d 45 4d 5f 49 6e 74 20  ( flags&MEM_Int 
b5b0: 29 7b 0a 20 20 20 20 2f 2a 20 46 69 67 75 72 65  ){.    /* Figure
b5c0: 20 6f 75 74 20 77 68 65 74 68 65 72 20 74 6f 20   out whether to 
b5d0: 75 73 65 20 31 2c 20 32 2c 20 34 2c 20 36 20 6f  use 1, 2, 4, 6 o
b5e0: 72 20 38 20 62 79 74 65 73 2e 20 2a 2f 0a 23 20  r 8 bytes. */.# 
b5f0: 20 20 64 65 66 69 6e 65 20 4d 41 58 5f 36 42 59    define MAX_6BY
b600: 54 45 20 28 28 28 28 69 36 34 29 30 78 30 30 30  TE ((((i64)0x000
b610: 31 30 30 30 30 29 3c 3c 33 32 29 2d 31 29 0a 20  10000)<<32)-1). 
b620: 20 20 20 69 36 34 20 69 20 3d 20 70 4d 65 6d 2d     i64 i = pMem-
b630: 3e 69 3b 0a 20 20 20 20 75 36 34 20 75 20 3d 20  >i;.    u64 u = 
b640: 69 3c 30 20 3f 20 2d 69 20 3a 20 69 3b 0a 20 20  i<0 ? -i : i;.  
b650: 20 20 69 66 28 20 75 3c 3d 31 32 37 20 29 20 72    if( u<=127 ) r
b660: 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 69 66 28  eturn 1;.    if(
b670: 20 75 3c 3d 33 32 37 36 37 20 29 20 72 65 74 75   u<=32767 ) retu
b680: 72 6e 20 32 3b 0a 20 20 20 20 69 66 28 20 75 3c  rn 2;.    if( u<
b690: 3d 38 33 38 38 36 30 37 20 29 20 72 65 74 75 72  =8388607 ) retur
b6a0: 6e 20 33 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d  n 3;.    if( u<=
b6b0: 32 31 34 37 34 38 33 36 34 37 20 29 20 72 65 74  2147483647 ) ret
b6c0: 75 72 6e 20 34 3b 0a 20 20 20 20 69 66 28 20 75  urn 4;.    if( u
b6d0: 3c 3d 4d 41 58 5f 36 42 59 54 45 20 29 20 72 65  <=MAX_6BYTE ) re
b6e0: 74 75 72 6e 20 35 3b 0a 20 20 20 20 72 65 74 75  turn 5;.    retu
b6f0: 72 6e 20 36 3b 0a 20 20 7d 0a 20 20 69 66 28 20  rn 6;.  }.  if( 
b700: 66 6c 61 67 73 26 4d 45 4d 5f 52 65 61 6c 20 29  flags&MEM_Real )
b710: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 37 3b 0a  {.    return 7;.
b720: 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 73 26    }.  if( flags&
b730: 4d 45 4d 5f 53 74 72 20 29 7b 0a 20 20 20 20 69  MEM_Str ){.    i
b740: 6e 74 20 6e 20 3d 20 70 4d 65 6d 2d 3e 6e 3b 0a  nt n = pMem->n;.
b750: 20 20 20 20 61 73 73 65 72 74 28 20 6e 3e 3d 30      assert( n>=0
b760: 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 28   );.    return (
b770: 28 6e 2a 32 29 20 2b 20 31 33 29 3b 0a 20 20 7d  (n*2) + 13);.  }
b780: 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d  .  if( flags&MEM
b790: 5f 42 6c 6f 62 20 29 7b 0a 20 20 20 20 72 65 74  _Blob ){.    ret
b7a0: 75 72 6e 20 28 70 4d 65 6d 2d 3e 6e 2a 32 20 2b  urn (pMem->n*2 +
b7b0: 20 31 32 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75   12);.  }.  retu
b7c0: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  rn 0;.}../*.** R
b7d0: 65 74 75 72 6e 20 74 68 65 20 6c 65 6e 67 74 68  eturn the length
b7e0: 20 6f 66 20 74 68 65 20 64 61 74 61 20 63 6f 72   of the data cor
b7f0: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68  responding to th
b800: 65 20 73 75 70 70 6c 69 65 64 20 73 65 72 69 61  e supplied seria
b810: 6c 2d 74 79 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73  l-type..*/.int s
b820: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
b830: 54 79 70 65 4c 65 6e 28 75 33 32 20 73 65 72 69  TypeLen(u32 seri
b840: 61 6c 5f 74 79 70 65 29 7b 0a 20 20 69 66 28 20  al_type){.  if( 
b850: 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20  serial_type>=12 
b860: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73  ){.    return (s
b870: 65 72 69 61 6c 5f 74 79 70 65 2d 31 32 29 2f 32  erial_type-12)/2
b880: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
b890: 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20 61  tatic const u8 a
b8a0: 53 69 7a 65 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c  Size[] = { 0, 1,
b8b0: 20 32 2c 20 33 2c 20 34 2c 20 36 2c 20 38 2c 20   2, 3, 4, 6, 8, 
b8c0: 38 2c 20 30 2c 20 30 2c 20 30 2c 20 30 20 7d 3b  8, 0, 0, 0, 0 };
b8d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 61 53 69 7a  .    return aSiz
b8e0: 65 5b 73 65 72 69 61 6c 5f 74 79 70 65 5d 3b 0a  e[serial_type];.
b8f0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69    }.}../*.** Wri
b900: 74 65 20 74 68 65 20 73 65 72 69 61 6c 69 7a 65  te the serialize
b910: 64 20 64 61 74 61 20 62 6c 6f 62 20 66 6f 72 20  d data blob for 
b920: 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64  the value stored
b930: 20 69 6e 20 70 4d 65 6d 20 69 6e 74 6f 20 0a 2a   in pMem into .*
b940: 2a 20 62 75 66 2e 20 49 74 20 69 73 20 61 73 73  * buf. It is ass
b950: 75 6d 65 64 20 74 68 61 74 20 74 68 65 20 63 61  umed that the ca
b960: 6c 6c 65 72 20 68 61 73 20 61 6c 6c 6f 63 61 74  ller has allocat
b970: 65 64 20 73 75 66 66 69 63 69 65 6e 74 20 73 70  ed sufficient sp
b980: 61 63 65 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ace..** Return t
b990: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74  he number of byt
b9a0: 65 73 20 77 72 69 74 74 65 6e 2e 0a 2a 2f 20 0a  es written..*/ .
b9b0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 53  int sqlite3VdbeS
b9c0: 65 72 69 61 6c 50 75 74 28 75 6e 73 69 67 6e 65  erialPut(unsigne
b9d0: 64 20 63 68 61 72 20 2a 62 75 66 2c 20 4d 65 6d  d char *buf, Mem
b9e0: 20 2a 70 4d 65 6d 29 7b 0a 20 20 75 33 32 20 73   *pMem){.  u32 s
b9f0: 65 72 69 61 6c 5f 74 79 70 65 20 3d 20 73 71 6c  erial_type = sql
ba00: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
ba10: 70 65 28 70 4d 65 6d 29 3b 0a 20 20 69 6e 74 20  pe(pMem);.  int 
ba20: 6c 65 6e 3b 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20  len;..  /* NULL 
ba30: 2a 2f 0a 20 20 69 66 28 20 73 65 72 69 61 6c 5f  */.  if( serial_
ba40: 74 79 70 65 3d 3d 30 20 29 7b 0a 20 20 20 20 72  type==0 ){.    r
ba50: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 0a 20  eturn 0;.  }. . 
ba60: 20 2f 2a 20 49 6e 74 65 67 65 72 20 61 6e 64 20   /* Integer and 
ba70: 52 65 61 6c 20 2a 2f 0a 20 20 69 66 28 20 73 65  Real */.  if( se
ba80: 72 69 61 6c 5f 74 79 70 65 3c 3d 37 20 29 7b 0a  rial_type<=7 ){.
ba90: 20 20 20 20 75 36 34 20 76 3b 0a 20 20 20 20 69      u64 v;.    i
baa0: 6e 74 20 69 3b 0a 20 20 20 20 69 66 28 20 73 65  nt i;.    if( se
bab0: 72 69 61 6c 5f 74 79 70 65 3d 3d 37 20 29 7b 0a  rial_type==7 ){.
bac0: 20 20 20 20 20 20 76 20 3d 20 2a 28 75 36 34 2a        v = *(u64*
bad0: 29 26 70 4d 65 6d 2d 3e 72 3b 0a 20 20 20 20 7d  )&pMem->r;.    }
bae0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 76 20 3d 20  else{.      v = 
baf0: 2a 28 75 36 34 2a 29 26 70 4d 65 6d 2d 3e 69 3b  *(u64*)&pMem->i;
bb00: 0a 20 20 20 20 7d 0a 20 20 20 20 6c 65 6e 20 3d  .    }.    len =
bb10: 20 69 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65   i = sqlite3Vdbe
bb20: 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65  SerialTypeLen(se
bb30: 72 69 61 6c 5f 74 79 70 65 29 3b 0a 20 20 20 20  rial_type);.    
bb40: 77 68 69 6c 65 28 20 69 2d 2d 20 29 7b 0a 20 20  while( i-- ){.  
bb50: 20 20 20 20 62 75 66 5b 69 5d 20 3d 20 28 76 26      buf[i] = (v&
bb60: 30 78 46 46 29 3b 0a 20 20 20 20 20 20 76 20 3e  0xFF);.      v >
bb70: 3e 3d 20 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20  >= 8;.    }.    
bb80: 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a  return len;.  }.
bb90: 20 20 0a 20 20 2f 2a 20 53 74 72 69 6e 67 20 6f    .  /* String o
bba0: 72 20 62 6c 6f 62 20 2a 2f 0a 20 20 61 73 73 65  r blob */.  asse
bbb0: 72 74 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3e  rt( serial_type>
bbc0: 3d 31 32 20 29 3b 0a 20 20 6c 65 6e 20 3d 20 73  =12 );.  len = s
bbd0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
bbe0: 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74  TypeLen(serial_t
bbf0: 79 70 65 29 3b 0a 20 20 6d 65 6d 63 70 79 28 62  ype);.  memcpy(b
bc00: 75 66 2c 20 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e  uf, pMem->z, len
bc10: 29 3b 0a 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b  );.  return len;
bc20: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 73 65 72 69  .}../*.** Deseri
bc30: 61 6c 69 7a 65 20 74 68 65 20 64 61 74 61 20 62  alize the data b
bc40: 6c 6f 62 20 70 6f 69 6e 74 65 64 20 74 6f 20 62  lob pointed to b
bc50: 79 20 62 75 66 20 61 73 20 73 65 72 69 61 6c 20  y buf as serial 
bc60: 74 79 70 65 20 73 65 72 69 61 6c 5f 74 79 70 65  type serial_type
bc70: 0a 2a 2a 20 61 6e 64 20 73 74 6f 72 65 20 74 68  .** and store th
bc80: 65 20 72 65 73 75 6c 74 20 69 6e 20 70 4d 65 6d  e result in pMem
bc90: 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  .  Return the nu
bca0: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 72 65  mber of bytes re
bcb0: 61 64 2e 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c 69  ad..*/ .int sqli
bcc0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65 74  te3VdbeSerialGet
bcd0: 28 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  (.  const unsign
bce0: 65 64 20 63 68 61 72 20 2a 62 75 66 2c 20 20 20  ed char *buf,   
bcf0: 20 20 2f 2a 20 42 75 66 66 65 72 20 74 6f 20 64    /* Buffer to d
bd00: 65 73 65 72 69 61 6c 69 7a 65 20 66 72 6f 6d 20  eserialize from 
bd10: 2a 2f 0a 20 20 75 33 32 20 73 65 72 69 61 6c 5f  */.  u32 serial_
bd20: 74 79 70 65 2c 20 20 20 20 20 20 20 20 20 20 20  type,           
bd30: 20 20 20 2f 2a 20 53 65 72 69 61 6c 20 74 79 70     /* Serial typ
bd40: 65 20 74 6f 20 64 65 73 65 72 69 61 6c 69 7a 65  e to deserialize
bd50: 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20   */.  Mem *pMem 
bd60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bd70: 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 63 65      /* Memory ce
bd80: 6c 6c 20 74 6f 20 77 72 69 74 65 20 76 61 6c 75  ll to write valu
bd90: 65 20 69 6e 74 6f 20 2a 2f 0a 29 7b 0a 20 20 69  e into */.){.  i
bda0: 6e 74 20 6c 65 6e 3b 0a 0a 20 20 69 66 28 20 73  nt len;..  if( s
bdb0: 65 72 69 61 6c 5f 74 79 70 65 3d 3d 30 20 29 7b  erial_type==0 ){
bdc0: 0a 20 20 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a  .    /* NULL */.
bdd0: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
bde0: 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20  = MEM_Null;.    
bdf0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
be00: 6c 65 6e 20 3d 20 73 71 6c 69 74 65 33 56 64 62  len = sqlite3Vdb
be10: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73  eSerialTypeLen(s
be20: 65 72 69 61 6c 5f 74 79 70 65 29 3b 0a 20 20 69  erial_type);.  i
be30: 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3c 3d  f( serial_type<=
be40: 37 20 29 7b 0a 20 20 20 20 2f 2a 20 49 6e 74 65  7 ){.    /* Inte
be50: 67 65 72 20 61 6e 64 20 52 65 61 6c 20 2a 2f 0a  ger and Real */.
be60: 20 20 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74      if( serial_t
be70: 79 70 65 3c 3d 34 20 29 7b 0a 20 20 20 20 20 20  ype<=4 ){.      
be80: 2f 2a 20 33 32 2d 62 69 74 20 69 6e 74 65 67 65  /* 32-bit intege
be90: 72 20 74 79 70 65 2e 20 20 54 68 69 73 20 69 73  r type.  This is
bea0: 20 68 61 6e 64 6c 65 64 20 62 79 20 61 20 73 70   handled by a sp
beb0: 65 63 69 61 6c 20 63 61 73 65 20 66 6f 72 0a 20  ecial case for. 
bec0: 20 20 20 20 20 2a 2a 20 70 65 72 66 6f 72 6d 61       ** performa
bed0: 6e 63 65 20 72 65 61 73 6f 6e 73 2e 20 2a 2f 0a  nce reasons. */.
bee0: 20 20 20 20 20 20 69 6e 74 20 76 20 3d 20 62 75        int v = bu
bef0: 66 5b 30 5d 3b 0a 20 20 20 20 20 20 69 6e 74 20  f[0];.      int 
bf00: 6e 3b 0a 20 20 20 20 20 20 69 66 28 20 76 26 30  n;.      if( v&0
bf10: 78 38 30 20 29 7b 0a 20 20 20 20 20 20 20 20 76  x80 ){.        v
bf20: 20 7c 3d 20 2d 32 35 36 3b 0a 20 20 20 20 20 20   |= -256;.      
bf30: 7d 0a 20 20 20 20 20 20 66 6f 72 28 6e 3d 31 3b  }.      for(n=1;
bf40: 20 6e 3c 6c 65 6e 3b 20 6e 2b 2b 29 7b 0a 20 20   n<len; n++){.  
bf50: 20 20 20 20 20 20 76 20 3d 20 28 76 3c 3c 38 29        v = (v<<8)
bf60: 20 7c 20 62 75 66 5b 6e 5d 3b 0a 20 20 20 20 20   | buf[n];.     
bf70: 20 7d 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66   }.      pMem->f
bf80: 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a  lags = MEM_Int;.
bf90: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20        pMem->i = 
bfa0: 76 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  v;.      return 
bfb0: 6e 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  n;.    }else{.  
bfc0: 20 20 20 20 75 36 34 20 76 20 3d 20 30 3b 0a 20      u64 v = 0;. 
bfd0: 20 20 20 20 20 69 6e 74 20 6e 3b 0a 0a 20 20 20       int n;..   
bfe0: 20 20 20 69 66 28 20 62 75 66 5b 30 5d 26 30 78     if( buf[0]&0x
bff0: 38 30 20 29 7b 0a 20 20 20 20 20 20 20 20 76 20  80 ){.        v 
c000: 3d 20 2d 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20  = -1;.      }.  
c010: 20 20 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c 6c      for(n=0; n<l
c020: 65 6e 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20 20 20  en; n++){.      
c030: 20 20 76 20 3d 20 28 76 3c 3c 38 29 20 7c 20 62    v = (v<<8) | b
c040: 75 66 5b 6e 5d 3b 0a 20 20 20 20 20 20 7d 0a 20  uf[n];.      }. 
c050: 20 20 20 20 20 69 66 28 20 73 65 72 69 61 6c 5f       if( serial_
c060: 74 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20 20 20  type==7 ){.     
c070: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
c080: 20 4d 45 4d 5f 52 65 61 6c 3b 0a 20 20 20 20 20   MEM_Real;.     
c090: 20 20 20 70 4d 65 6d 2d 3e 72 20 3d 20 2a 28 64     pMem->r = *(d
c0a0: 6f 75 62 6c 65 2a 29 26 76 3b 0a 20 20 20 20 20  ouble*)&v;.     
c0b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
c0c0: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
c0d0: 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20 20 20 70  M_Int;.        p
c0e0: 4d 65 6d 2d 3e 69 20 3d 20 2a 28 69 36 34 2a 29  Mem->i = *(i64*)
c0f0: 26 76 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  &v;.      }.    
c100: 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f  }.  }else{.    /
c110: 2a 20 53 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62  * String or blob
c120: 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20   */.    assert( 
c130: 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20  serial_type>=12 
c140: 29 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d  );.    pMem->z =
c150: 20 28 63 68 61 72 20 2a 29 62 75 66 3b 0a 20 20   (char *)buf;.  
c160: 20 20 70 4d 65 6d 2d 3e 6e 20 3d 20 6c 65 6e 3b    pMem->n = len;
c170: 0a 20 20 20 20 70 4d 65 6d 2d 3e 78 44 65 6c 20  .    pMem->xDel 
c180: 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 73 65 72  = 0;.    if( ser
c190: 69 61 6c 5f 74 79 70 65 26 30 78 30 31 20 29 7b  ial_type&0x01 ){
c1a0: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61  .      pMem->fla
c1b0: 67 73 20 3d 20 4d 45 4d 5f 53 74 72 20 7c 20 4d  gs = MEM_Str | M
c1c0: 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20 20 7d 65  EM_Ephem;.    }e
c1d0: 6c 73 65 7b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  lse{.      pMem-
c1e0: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 42 6c 6f  >flags = MEM_Blo
c1f0: 62 20 7c 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20  b | MEM_Ephem;. 
c200: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
c210: 6e 20 6c 65 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  n len;.}../*.** 
c220: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 6f  This function co
c230: 6d 70 61 72 65 73 20 74 68 65 20 74 77 6f 20 74  mpares the two t
c240: 61 62 6c 65 20 72 6f 77 73 20 6f 72 20 69 6e 64  able rows or ind
c250: 65 78 20 72 65 63 6f 72 64 73 20 73 70 65 63 69  ex records speci
c260: 66 69 65 64 20 62 79 20 0a 2a 2a 20 7b 6e 4b 65  fied by .** {nKe
c270: 79 31 2c 20 70 4b 65 79 31 7d 20 61 6e 64 20 7b  y1, pKey1} and {
c280: 6e 4b 65 79 32 2c 20 70 4b 65 79 32 7d 2c 20 72  nKey2, pKey2}, r
c290: 65 74 75 72 6e 69 6e 67 20 61 20 6e 65 67 61 74  eturning a negat
c2a0: 69 76 65 2c 20 7a 65 72 6f 0a 2a 2a 20 6f 72 20  ive, zero.** or 
c2b0: 70 6f 73 69 74 69 76 65 20 69 6e 74 65 67 65 72  positive integer
c2c0: 20 69 66 20 7b 6e 4b 65 79 31 2c 20 70 4b 65 79   if {nKey1, pKey
c2d0: 31 7d 20 69 73 20 6c 65 73 73 20 74 68 61 6e 2c  1} is less than,
c2e0: 20 65 71 75 61 6c 20 74 6f 20 6f 72 20 0a 2a 2a   equal to or .**
c2f0: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 7b 6e   greater than {n
c300: 4b 65 79 32 2c 20 70 4b 65 79 32 7d 2e 20 20 42  Key2, pKey2}.  B
c310: 6f 74 68 20 4b 65 79 31 20 61 6e 64 20 4b 65 79  oth Key1 and Key
c320: 32 20 6d 75 73 74 20 62 65 20 62 79 74 65 20 73  2 must be byte s
c330: 74 72 69 6e 67 73 0a 2a 2a 20 63 6f 6d 70 6f 73  trings.** compos
c340: 65 64 20 62 79 20 74 68 65 20 4f 50 5f 4d 61 6b  ed by the OP_Mak
c350: 65 52 65 63 6f 72 64 20 6f 70 63 6f 64 65 20 6f  eRecord opcode o
c360: 66 20 74 68 65 20 56 44 42 45 2e 0a 2a 2f 0a 69  f the VDBE..*/.i
c370: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 52 65  nt sqlite3VdbeRe
c380: 63 6f 72 64 43 6f 6d 70 61 72 65 28 0a 20 20 76  cordCompare(.  v
c390: 6f 69 64 20 2a 75 73 65 72 44 61 74 61 2c 0a 20  oid *userData,. 
c3a0: 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73   int nKey1, cons
c3b0: 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 20 0a  t void *pKey1, .
c3c0: 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e    int nKey2, con
c3d0: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29  st void *pKey2.)
c3e0: 7b 0a 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65  {.  KeyInfo *pKe
c3f0: 79 49 6e 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f  yInfo = (KeyInfo
c400: 2a 29 75 73 65 72 44 61 74 61 3b 0a 20 20 75 33  *)userData;.  u3
c410: 32 20 64 31 2c 20 64 32 3b 20 20 20 20 20 20 20  2 d1, d2;       
c420: 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 74     /* Offset int
c430: 6f 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65 78 74  o aKey[] of next
c440: 20 64 61 74 61 20 65 6c 65 6d 65 6e 74 20 2a 2f   data element */
c450: 0a 20 20 75 33 32 20 69 64 78 31 2c 20 69 64 78  .  u32 idx1, idx
c460: 32 3b 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65  2;      /* Offse
c470: 74 20 69 6e 74 6f 20 61 4b 65 79 5b 5d 20 6f 66  t into aKey[] of
c480: 20 6e 65 78 74 20 68 65 61 64 65 72 20 65 6c 65   next header ele
c490: 6d 65 6e 74 20 2a 2f 0a 20 20 75 33 32 20 73 7a  ment */.  u32 sz
c4a0: 48 64 72 31 2c 20 73 7a 48 64 72 32 3b 20 20 2f  Hdr1, szHdr2;  /
c4b0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  * Number of byte
c4c0: 73 20 69 6e 20 68 65 61 64 65 72 20 2a 2f 0a 20  s in header */. 
c4d0: 20 69 6e 74 20 69 20 3d 20 30 3b 0a 20 20 69 6e   int i = 0;.  in
c4e0: 74 20 6e 46 69 65 6c 64 3b 0a 20 20 69 6e 74 20  t nField;.  int 
c4f0: 72 63 20 3d 20 30 3b 0a 20 20 63 6f 6e 73 74 20  rc = 0;.  const 
c500: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 61  unsigned char *a
c510: 4b 65 79 31 20 3d 20 28 63 6f 6e 73 74 20 75 6e  Key1 = (const un
c520: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29 70 4b  signed char *)pK
c530: 65 79 31 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73  ey1;.  const uns
c540: 69 67 6e 65 64 20 63 68 61 72 20 2a 61 4b 65 79  igned char *aKey
c550: 32 20 3d 20 28 63 6f 6e 73 74 20 75 6e 73 69 67  2 = (const unsig
c560: 6e 65 64 20 63 68 61 72 20 2a 29 70 4b 65 79 32  ned char *)pKey2
c570: 3b 0a 0a 20 20 4d 65 6d 20 6d 65 6d 31 3b 0a 20  ;..  Mem mem1;. 
c580: 20 4d 65 6d 20 6d 65 6d 32 3b 0a 20 20 6d 65 6d   Mem mem2;.  mem
c590: 31 2e 65 6e 63 20 3d 20 70 4b 65 79 49 6e 66 6f  1.enc = pKeyInfo
c5a0: 2d 3e 65 6e 63 3b 0a 20 20 6d 65 6d 32 2e 65 6e  ->enc;.  mem2.en
c5b0: 63 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e  c = pKeyInfo->en
c5c0: 63 3b 0a 20 20 0a 20 20 69 64 78 31 20 3d 20 73  c;.  .  idx1 = s
c5d0: 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33  qlite3GetVarint3
c5e0: 32 28 70 4b 65 79 31 2c 20 26 73 7a 48 64 72 31  2(pKey1, &szHdr1
c5f0: 29 3b 0a 20 20 64 31 20 3d 20 73 7a 48 64 72 31  );.  d1 = szHdr1
c600: 3b 0a 20 20 69 64 78 32 20 3d 20 73 71 6c 69 74  ;.  idx2 = sqlit
c610: 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 70 4b  e3GetVarint32(pK
c620: 65 79 32 2c 20 26 73 7a 48 64 72 32 29 3b 0a 20  ey2, &szHdr2);. 
c630: 20 64 32 20 3d 20 73 7a 48 64 72 32 3b 0a 20 20   d2 = szHdr2;.  
c640: 6e 46 69 65 6c 64 20 3d 20 70 4b 65 79 49 6e 66  nField = pKeyInf
c650: 6f 2d 3e 6e 46 69 65 6c 64 3b 0a 20 20 77 68 69  o->nField;.  whi
c660: 6c 65 28 20 69 64 78 31 3c 73 7a 48 64 72 31 20  le( idx1<szHdr1 
c670: 26 26 20 69 64 78 32 3c 73 7a 48 64 72 32 20 29  && idx2<szHdr2 )
c680: 7b 0a 20 20 20 20 75 33 32 20 73 65 72 69 61 6c  {.    u32 serial
c690: 5f 74 79 70 65 31 3b 0a 20 20 20 20 75 33 32 20  _type1;.    u32 
c6a0: 73 65 72 69 61 6c 5f 74 79 70 65 32 3b 0a 0a 20  serial_type2;.. 
c6b0: 20 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73     /* Read the s
c6c0: 65 72 69 61 6c 20 74 79 70 65 73 20 66 6f 72 20  erial types for 
c6d0: 74 68 65 20 6e 65 78 74 20 65 6c 65 6d 65 6e 74  the next element
c6e0: 20 69 6e 20 65 61 63 68 20 6b 65 79 2e 20 2a 2f   in each key. */
c6f0: 0a 20 20 20 20 69 64 78 31 20 2b 3d 20 73 71 6c  .    idx1 += sql
c700: 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28  ite3GetVarint32(
c710: 26 61 4b 65 79 31 5b 69 64 78 31 5d 2c 20 26 73  &aKey1[idx1], &s
c720: 65 72 69 61 6c 5f 74 79 70 65 31 29 3b 0a 20 20  erial_type1);.  
c730: 20 20 69 66 28 20 64 31 3e 3d 6e 4b 65 79 31 20    if( d1>=nKey1 
c740: 26 26 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  && sqlite3VdbeSe
c750: 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69  rialTypeLen(seri
c760: 61 6c 5f 74 79 70 65 31 29 3e 30 20 29 20 62 72  al_type1)>0 ) br
c770: 65 61 6b 3b 0a 20 20 20 20 69 64 78 32 20 2b 3d  eak;.    idx2 +=
c780: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
c790: 74 33 32 28 26 61 4b 65 79 32 5b 69 64 78 32 5d  t32(&aKey2[idx2]
c7a0: 2c 20 26 73 65 72 69 61 6c 5f 74 79 70 65 32 29  , &serial_type2)
c7b0: 3b 0a 20 20 20 20 69 66 28 20 64 32 3e 3d 6e 4b  ;.    if( d2>=nK
c7c0: 65 79 32 20 26 26 20 73 71 6c 69 74 65 33 56 64  ey2 && sqlite3Vd
c7d0: 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28  beSerialTypeLen(
c7e0: 73 65 72 69 61 6c 5f 74 79 70 65 32 29 3e 30 20  serial_type2)>0 
c7f0: 29 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a  ) break;..    /*
c800: 20 41 73 73 65 72 74 20 74 68 61 74 20 74 68 65   Assert that the
c810: 72 65 20 69 73 20 65 6e 6f 75 67 68 20 73 70 61  re is enough spa
c820: 63 65 20 6c 65 66 74 20 69 6e 20 65 61 63 68 20  ce left in each 
c830: 6b 65 79 20 66 6f 72 20 74 68 65 20 62 6c 6f 62  key for the blob
c840: 20 6f 66 0a 20 20 20 20 2a 2a 20 64 61 74 61 20   of.    ** data 
c850: 74 6f 20 67 6f 20 77 69 74 68 20 74 68 65 20 73  to go with the s
c860: 65 72 69 61 6c 20 74 79 70 65 20 6a 75 73 74 20  erial type just 
c870: 72 65 61 64 2e 20 54 68 69 73 20 61 73 73 65 72  read. This asser
c880: 74 20 6d 61 79 20 66 61 69 6c 20 69 66 0a 20 20  t may fail if.  
c890: 20 20 2a 2a 20 74 68 65 20 66 69 6c 65 20 69 73    ** the file is
c8a0: 20 63 6f 72 72 75 70 74 65 64 2e 20 20 54 68 65   corrupted.  The
c8b0: 6e 20 72 65 61 64 20 74 68 65 20 76 61 6c 75 65  n read the value
c8c0: 20 66 72 6f 6d 20 65 61 63 68 20 6b 65 79 20 69   from each key i
c8d0: 6e 74 6f 20 6d 65 6d 31 0a 20 20 20 20 2a 2a 20  nto mem1.    ** 
c8e0: 61 6e 64 20 6d 65 6d 32 20 72 65 73 70 65 63 74  and mem2 respect
c8f0: 69 76 65 6c 79 2e 0a 20 20 20 20 2a 2f 0a 20 20  ively..    */.  
c900: 20 20 64 31 20 2b 3d 20 73 71 6c 69 74 65 33 56    d1 += sqlite3V
c910: 64 62 65 53 65 72 69 61 6c 47 65 74 28 26 61 4b  dbeSerialGet(&aK
c920: 65 79 31 5b 64 31 5d 2c 20 73 65 72 69 61 6c 5f  ey1[d1], serial_
c930: 74 79 70 65 31 2c 20 26 6d 65 6d 31 29 3b 0a 20  type1, &mem1);. 
c940: 20 20 20 64 32 20 2b 3d 20 73 71 6c 69 74 65 33     d2 += sqlite3
c950: 56 64 62 65 53 65 72 69 61 6c 47 65 74 28 26 61  VdbeSerialGet(&a
c960: 4b 65 79 32 5b 64 32 5d 2c 20 73 65 72 69 61 6c  Key2[d2], serial
c970: 5f 74 79 70 65 32 2c 20 26 6d 65 6d 32 29 3b 0a  _type2, &mem2);.
c980: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
c990: 33 4d 65 6d 43 6f 6d 70 61 72 65 28 26 6d 65 6d  3MemCompare(&mem
c9a0: 31 2c 20 26 6d 65 6d 32 2c 20 69 3c 6e 46 69 65  1, &mem2, i<nFie
c9b0: 6c 64 20 3f 20 70 4b 65 79 49 6e 66 6f 2d 3e 61  ld ? pKeyInfo->a
c9c0: 43 6f 6c 6c 5b 69 5d 20 3a 20 30 29 3b 0a 20 20  Coll[i] : 0);.  
c9d0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
c9e0: 52 65 6c 65 61 73 65 28 26 6d 65 6d 31 29 3b 0a  Release(&mem1);.
c9f0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d      sqlite3VdbeM
ca00: 65 6d 52 65 6c 65 61 73 65 28 26 6d 65 6d 32 29  emRelease(&mem2)
ca10: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 30 20  ;.    if( rc!=0 
ca20: 29 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  ){.      break;.
ca30: 20 20 20 20 7d 0a 20 20 20 20 69 2b 2b 3b 0a 20      }.    i++;. 
ca40: 20 7d 0a 0a 20 20 2f 2a 20 4f 6e 65 20 6f 66 20   }..  /* One of 
ca50: 74 68 65 20 6b 65 79 73 20 72 61 6e 20 6f 75 74  the keys ran out
ca60: 20 6f 66 20 66 69 65 6c 64 73 2c 20 62 75 74 20   of fields, but 
ca70: 61 6c 6c 20 74 68 65 20 66 69 65 6c 64 73 20 75  all the fields u
ca80: 70 20 74 6f 20 74 68 61 74 20 70 6f 69 6e 74 0a  p to that point.
ca90: 20 20 2a 2a 20 77 65 72 65 20 65 71 75 61 6c 2e    ** were equal.
caa0: 20 49 66 20 74 68 65 20 69 6e 63 72 4b 65 79 20   If the incrKey 
cab0: 66 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68  flag is true, th
cac0: 65 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 6b 65  en the second ke
cad0: 79 20 69 73 0a 20 20 2a 2a 20 74 72 65 61 74 65  y is.  ** treate
cae0: 64 20 61 73 20 6c 61 72 67 65 72 2e 0a 20 20 2a  d as larger..  *
caf0: 2f 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b  /.  if( rc==0 ){
cb00: 0a 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66  .    if( pKeyInf
cb10: 6f 2d 3e 69 6e 63 72 4b 65 79 20 29 7b 0a 20 20  o->incrKey ){.  
cb20: 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20      rc = -1;.   
cb30: 20 7d 65 6c 73 65 20 69 66 28 20 64 31 3c 6e 4b   }else if( d1<nK
cb40: 65 79 31 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ey1 ){.      rc 
cb50: 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69  = 1;.    }else i
cb60: 66 28 20 64 32 3c 6e 4b 65 79 32 20 29 7b 0a 20  f( d2<nKey2 ){. 
cb70: 20 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20       rc = -1;.  
cb80: 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70    }.  }..  if( p
cb90: 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72  KeyInfo->aSortOr
cba0: 64 65 72 20 26 26 20 69 3c 70 4b 65 79 49 6e 66  der && i<pKeyInf
cbb0: 6f 2d 3e 6e 46 69 65 6c 64 20 26 26 20 70 4b 65  o->nField && pKe
cbc0: 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65  yInfo->aSortOrde
cbd0: 72 5b 69 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d  r[i] ){.    rc =
cbe0: 20 2d 72 63 3b 0a 20 20 7d 0a 0a 20 20 72 65 74   -rc;.  }..  ret
cbf0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
cc00: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73   The argument is
cc10: 20 61 6e 20 69 6e 64 65 78 20 65 6e 74 72 79 20   an index entry 
cc20: 63 6f 6d 70 6f 73 65 64 20 75 73 69 6e 67 20 74  composed using t
cc30: 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64  he OP_MakeRecord
cc40: 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 54 68 65 20   opcode..** The 
cc50: 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68  last entry in th
cc60: 69 73 20 72 65 63 6f 72 64 20 73 68 6f 75 6c 64  is record should
cc70: 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 20 28   be an integer (
cc80: 73 70 65 63 69 66 69 63 61 6c 6c 79 0a 2a 2a 20  specifically.** 
cc90: 61 6e 20 69 6e 74 65 67 65 72 20 72 6f 77 69 64  an integer rowid
cca0: 29 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65  ).  This routine
ccb0: 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d   returns the num
ccc0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 0a  ber of bytes in.
ccd0: 2a 2a 20 74 68 61 74 20 69 6e 74 65 67 65 72 2e  ** that integer.
cce0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
ccf0: 64 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 69  dbeIdxRowidLen(i
cd00: 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75  nt nKey, const u
cd10: 38 20 2a 61 4b 65 79 29 7b 0a 20 20 75 33 32 20  8 *aKey){.  u32 
cd20: 73 7a 48 64 72 3b 20 20 20 20 20 20 20 20 2f 2a  szHdr;        /*
cd30: 20 53 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61   Size of the hea
cd40: 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 74 79 70  der */.  u32 typ
cd50: 65 52 6f 77 69 64 3b 20 20 20 20 2f 2a 20 53 65  eRowid;    /* Se
cd60: 72 69 61 6c 20 74 79 70 65 20 6f 66 20 74 68 65  rial type of the
cd70: 20 72 6f 77 69 64 20 2a 2f 0a 0a 20 20 73 71 6c   rowid */..  sql
cd80: 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28  ite3GetVarint32(
cd90: 61 4b 65 79 2c 20 26 73 7a 48 64 72 29 3b 0a 20  aKey, &szHdr);. 
cda0: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
cdb0: 74 33 32 28 26 61 4b 65 79 5b 73 7a 48 64 72 2d  t32(&aKey[szHdr-
cdc0: 31 5d 2c 20 26 74 79 70 65 52 6f 77 69 64 29 3b  1], &typeRowid);
cdd0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
cde0: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
cdf0: 65 6e 28 74 79 70 65 52 6f 77 69 64 29 3b 0a 7d  en(typeRowid);.}
ce00: 0a 20 20 0a 0a 2f 2a 0a 2a 2a 20 70 43 75 72 20  .  ../*.** pCur 
ce10: 70 6f 69 6e 74 73 20 61 74 20 61 6e 20 69 6e 64  points at an ind
ce20: 65 78 20 65 6e 74 72 79 20 63 72 65 61 74 65 64  ex entry created
ce30: 20 75 73 69 6e 67 20 74 68 65 20 4f 50 5f 4d 61   using the OP_Ma
ce40: 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e  keRecord opcode.
ce50: 0a 2a 2a 20 52 65 61 64 20 74 68 65 20 72 6f 77  .** Read the row
ce60: 69 64 20 28 74 68 65 20 6c 61 73 74 20 66 69 65  id (the last fie
ce70: 6c 64 20 69 6e 20 74 68 65 20 72 65 63 6f 72 64  ld in the record
ce80: 29 20 61 6e 64 20 73 74 6f 72 65 20 69 74 20 69  ) and store it i
ce90: 6e 20 2a 72 6f 77 69 64 2e 0a 2a 2a 20 52 65 74  n *rowid..** Ret
cea0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66  urn SQLITE_OK if
ceb0: 20 65 76 65 72 79 74 68 69 6e 67 20 77 6f 72 6b   everything work
cec0: 73 2c 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63  s, or an error c
ced0: 6f 64 65 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a  ode otherwise..*
cee0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
cef0: 65 49 64 78 52 6f 77 69 64 28 42 74 43 75 72 73  eIdxRowid(BtCurs
cf00: 6f 72 20 2a 70 43 75 72 2c 20 69 36 34 20 2a 72  or *pCur, i64 *r
cf10: 6f 77 69 64 29 7b 0a 20 20 69 36 34 20 6e 43 65  owid){.  i64 nCe
cf20: 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74 20 72 63 3b  llKey;.  int rc;
cf30: 0a 20 20 75 33 32 20 73 7a 48 64 72 3b 20 20 20  .  u32 szHdr;   
cf40: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20       /* Size of 
cf50: 74 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20  the header */.  
cf60: 75 33 32 20 74 79 70 65 52 6f 77 69 64 3b 20 20  u32 typeRowid;  
cf70: 20 20 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65    /* Serial type
cf80: 20 6f 66 20 74 68 65 20 72 6f 77 69 64 20 2a 2f   of the rowid */
cf90: 0a 20 20 75 33 32 20 6c 65 6e 52 6f 77 69 64 3b  .  u32 lenRowid;
cfa0: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20       /* Size of 
cfb0: 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20 4d  the rowid */.  M
cfc0: 65 6d 20 6d 2c 20 76 3b 0a 0a 20 20 73 71 6c 69  em m, v;..  sqli
cfd0: 74 65 33 42 74 72 65 65 4b 65 79 53 69 7a 65 28  te3BtreeKeySize(
cfe0: 70 43 75 72 2c 20 26 6e 43 65 6c 6c 4b 65 79 29  pCur, &nCellKey)
cff0: 3b 0a 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79  ;.  if( nCellKey
d000: 3c 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  <=0 ){.    retur
d010: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54  n SQLITE_CORRUPT
d020: 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c  ;.  }.  rc = sql
d030: 69 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42  ite3VdbeMemFromB
d040: 74 72 65 65 28 70 43 75 72 2c 20 30 2c 20 6e 43  tree(pCur, 0, nC
d050: 65 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a  ellKey, 1, &m);.
d060: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20    if( rc ){.    
d070: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20  return rc;.  }. 
d080: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
d090: 74 33 32 28 6d 2e 7a 2c 20 26 73 7a 48 64 72 29  t32(m.z, &szHdr)
d0a0: 3b 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56 61  ;.  sqlite3GetVa
d0b0: 72 69 6e 74 33 32 28 26 6d 2e 7a 5b 73 7a 48 64  rint32(&m.z[szHd
d0c0: 72 2d 31 5d 2c 20 26 74 79 70 65 52 6f 77 69 64  r-1], &typeRowid
d0d0: 29 3b 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20  );.  lenRowid = 
d0e0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
d0f0: 6c 54 79 70 65 4c 65 6e 28 74 79 70 65 52 6f 77  lTypeLen(typeRow
d100: 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  id);.  sqlite3Vd
d110: 62 65 53 65 72 69 61 6c 47 65 74 28 26 6d 2e 7a  beSerialGet(&m.z
d120: 5b 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20  [m.n-lenRowid], 
d130: 74 79 70 65 52 6f 77 69 64 2c 20 26 76 29 3b 0a  typeRowid, &v);.
d140: 20 20 2a 72 6f 77 69 64 20 3d 20 76 2e 69 3b 0a    *rowid = v.i;.
d150: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
d160: 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20 72  Release(&m);.  r
d170: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
d180: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72  .}../*.** Compar
d190: 65 20 74 68 65 20 6b 65 79 20 6f 66 20 74 68 65  e the key of the
d1a0: 20 69 6e 64 65 78 20 65 6e 74 72 79 20 74 68 61   index entry tha
d1b0: 74 20 63 75 72 73 6f 72 20 70 43 20 69 73 20 70  t cursor pC is p
d1c0: 6f 69 6e 74 20 74 6f 20 61 67 61 69 6e 73 74 0a  oint to against.
d1d0: 2a 2a 20 74 68 65 20 6b 65 79 20 73 74 72 69 6e  ** the key strin
d1e0: 67 20 69 6e 20 70 4b 65 79 20 28 6f 66 20 6c 65  g in pKey (of le
d1f0: 6e 67 74 68 20 6e 4b 65 79 29 2e 20 20 57 72 69  ngth nKey).  Wri
d200: 74 65 20 69 6e 74 6f 20 2a 70 52 65 73 20 61 20  te into *pRes a 
d210: 6e 75 6d 62 65 72 0a 2a 2a 20 74 68 61 74 20 69  number.** that i
d220: 73 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f  s negative, zero
d230: 2c 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 66  , or positive if
d240: 20 70 43 20 69 73 20 6c 65 73 73 20 74 68 61 6e   pC is less than
d250: 2c 20 65 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f  , equal to,.** o
d260: 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 70  r greater than p
d270: 4b 65 79 2e 20 20 52 65 74 75 72 6e 20 53 51 4c  Key.  Return SQL
d280: 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73  ITE_OK on succes
d290: 73 2e 0a 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69 73  s..**.** pKey is
d2a0: 20 65 69 74 68 65 72 20 63 72 65 61 74 65 64 20   either created 
d2b0: 77 69 74 68 6f 75 74 20 61 20 72 6f 77 69 64 20  without a rowid 
d2c0: 6f 72 20 69 73 20 74 72 75 6e 63 61 74 65 64 20  or is truncated 
d2d0: 73 6f 20 74 68 61 74 20 69 74 0a 2a 2a 20 6f 6d  so that it.** om
d2e0: 69 74 73 20 74 68 65 20 72 6f 77 69 64 20 61 74  its the rowid at
d2f0: 20 74 68 65 20 65 6e 64 2e 20 20 54 68 65 20 72   the end.  The r
d300: 6f 77 69 64 20 61 74 20 74 68 65 20 65 6e 64 20  owid at the end 
d310: 6f 66 20 74 68 65 20 69 6e 64 65 78 20 65 6e 74  of the index ent
d320: 72 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64  ry.** is ignored
d330: 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74   as well..*/.int
d340: 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b   sqlite3VdbeIdxK
d350: 65 79 43 6f 6d 70 61 72 65 28 0a 20 20 43 75 72  eyCompare(.  Cur
d360: 73 6f 72 20 2a 70 43 2c 20 20 20 20 20 20 20 20  sor *pC,        
d370: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
d380: 63 75 72 73 6f 72 20 74 6f 20 63 6f 6d 70 61 72  cursor to compar
d390: 65 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69  e against */.  i
d3a0: 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75  nt nKey, const u
d3b0: 38 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 54 68  8 *pKey,   /* Th
d3c0: 65 20 6b 65 79 20 74 6f 20 63 6f 6d 70 61 72 65  e key to compare
d3d0: 20 2a 2f 0a 20 20 69 6e 74 20 2a 72 65 73 20 20   */.  int *res  
d3e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d3f0: 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63    /* Write the c
d400: 6f 6d 70 61 72 69 73 6f 6e 20 72 65 73 75 6c 74  omparison result
d410: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 36   here */.){.  i6
d420: 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e  4 nCellKey;.  in
d430: 74 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72  t rc;.  BtCursor
d440: 20 2a 70 43 75 72 20 3d 20 70 43 2d 3e 70 43 75   *pCur = pC->pCu
d450: 72 73 6f 72 3b 0a 20 20 69 6e 74 20 6c 65 6e 52  rsor;.  int lenR
d460: 6f 77 69 64 3b 0a 20 20 4d 65 6d 20 6d 3b 0a 0a  owid;.  Mem m;..
d470: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65    sqlite3BtreeKe
d480: 79 53 69 7a 65 28 70 43 75 72 2c 20 26 6e 43 65  ySize(pCur, &nCe
d490: 6c 6c 4b 65 79 29 3b 0a 20 20 69 66 28 20 6e 43  llKey);.  if( nC
d4a0: 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b 0a 20 20 20  ellKey<=0 ){.   
d4b0: 20 2a 72 65 73 20 3d 20 30 3b 0a 20 20 20 20 72   *res = 0;.    r
d4c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
d4d0: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69  .  }.  rc = sqli
d4e0: 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74  te3VdbeMemFromBt
d4f0: 72 65 65 28 70 43 2d 3e 70 43 75 72 73 6f 72 2c  ree(pC->pCursor,
d500: 20 30 2c 20 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c   0, nCellKey, 1,
d510: 20 26 6d 29 3b 0a 20 20 69 66 28 20 72 63 20 29   &m);.  if( rc )
d520: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  {.    return rc;
d530: 0a 20 20 7d 0a 20 20 6c 65 6e 52 6f 77 69 64 20  .  }.  lenRowid 
d540: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78  = sqlite3VdbeIdx
d550: 52 6f 77 69 64 4c 65 6e 28 6d 2e 6e 2c 20 6d 2e  RowidLen(m.n, m.
d560: 7a 29 3b 0a 20 20 2a 72 65 73 20 3d 20 73 71 6c  z);.  *res = sql
d570: 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f  ite3VdbeRecordCo
d580: 6d 70 61 72 65 28 70 43 2d 3e 70 4b 65 79 49 6e  mpare(pC->pKeyIn
d590: 66 6f 2c 20 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64  fo, m.n-lenRowid
d5a0: 2c 20 6d 2e 7a 2c 20 6e 4b 65 79 2c 20 70 4b 65  , m.z, nKey, pKe
d5b0: 79 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  y);.  sqlite3Vdb
d5c0: 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 29 3b  eMemRelease(&m);
d5d0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
d5e0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  _OK;.}../*.** Th
d5f0: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20  is routine sets 
d600: 74 68 65 20 76 61 6c 75 65 20 74 6f 20 62 65 20  the value to be 
d610: 72 65 74 75 72 6e 65 64 20 62 79 20 73 75 62 73  returned by subs
d620: 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 6f 0a  equent calls to.
d630: 2a 2a 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67  ** sqlite3_chang
d640: 65 73 28 29 20 6f 6e 20 74 68 65 20 64 61 74 61  es() on the data
d650: 62 61 73 65 20 68 61 6e 64 6c 65 20 27 64 62 27  base handle 'db'
d660: 2e 20 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  . .*/.void sqlit
d670: 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 65 73  e3VdbeSetChanges
d680: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e  (sqlite3 *db, in
d690: 74 20 6e 43 68 61 6e 67 65 29 7b 0a 20 20 64 62  t nChange){.  db
d6a0: 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 6e 43 68 61  ->nChange = nCha
d6b0: 6e 67 65 3b 0a 20 20 64 62 2d 3e 6e 54 6f 74 61  nge;.  db->nTota
d6c0: 6c 43 68 61 6e 67 65 20 2b 3d 20 6e 43 68 61 6e  lChange += nChan
d6d0: 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  ge;.}../*.** Set
d6e0: 20 61 20 66 6c 61 67 20 69 6e 20 74 68 65 20 76   a flag in the v
d6f0: 64 62 65 20 74 6f 20 75 70 64 61 74 65 20 74 68  dbe to update th
d700: 65 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72  e change counter
d710: 20 77 68 65 6e 20 69 74 20 69 73 20 66 69 6e 61   when it is fina
d720: 6c 69 73 65 64 0a 2a 2a 20 6f 72 20 72 65 73 65  lised.** or rese
d730: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
d740: 65 33 56 64 62 65 43 6f 75 6e 74 43 68 61 6e 67  e3VdbeCountChang
d750: 65 73 28 56 64 62 65 20 2a 76 29 7b 0a 20 20 76  es(Vdbe *v){.  v
d760: 2d 3e 63 68 61 6e 67 65 43 6e 74 4f 6e 20 3d 20  ->changeCntOn = 
d770: 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 72 6b  1;.}../*.** Mark
d780: 20 65 76 65 72 79 20 70 72 65 70 61 72 65 64 20   every prepared 
d790: 73 74 61 74 65 6d 65 6e 74 20 61 73 73 6f 63 69  statement associ
d7a0: 61 74 65 64 20 77 69 74 68 20 61 20 64 61 74 61  ated with a data
d7b0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a  base connection.
d7c0: 2a 2a 20 61 73 20 65 78 70 69 72 65 64 2e 0a 2a  ** as expired..*
d7d0: 2a 0a 2a 2a 20 41 6e 20 65 78 70 69 72 65 64 20  *.** An expired 
d7e0: 73 74 61 74 65 6d 65 6e 74 20 6d 65 61 6e 73 20  statement means 
d7f0: 74 68 61 74 20 72 65 63 6f 6d 70 69 6c 61 74 69  that recompilati
d800: 6f 6e 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d  on of the statem
d810: 65 6e 74 20 69 73 0a 2a 2a 20 72 65 63 6f 6d 6d  ent is.** recomm
d820: 65 6e 64 2e 20 20 53 74 61 74 65 6d 65 6e 74 73  end.  Statements
d830: 20 65 78 70 69 72 65 20 77 68 65 6e 20 74 68 69   expire when thi
d840: 6e 67 73 20 68 61 70 70 65 6e 20 74 68 61 74 20  ngs happen that 
d850: 6d 61 6b 65 20 74 68 65 69 72 0a 2a 2a 20 70 72  make their.** pr
d860: 6f 67 72 61 6d 73 20 6f 62 73 6f 6c 65 74 65 2e  ograms obsolete.
d870: 20 20 52 65 6d 6f 76 69 6e 67 20 75 73 65 72 2d    Removing user-
d880: 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e  defined function
d890: 73 20 6f 72 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a  s or collating.*
d8a0: 2a 20 73 65 71 75 65 6e 63 65 73 2c 20 6f 72 20  * sequences, or 
d8b0: 63 68 61 6e 67 69 6e 67 20 61 6e 20 61 75 74 68  changing an auth
d8c0: 6f 72 69 7a 61 74 69 6f 6e 20 66 75 6e 63 74 69  orization functi
d8d0: 6f 6e 20 61 72 65 20 74 68 65 20 74 79 70 65 73  on are the types
d8e0: 20 6f 66 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68   of.** things th
d8f0: 61 74 20 6d 61 6b 65 20 70 72 65 70 61 72 65 64  at make prepared
d900: 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 62 73 6f   statements obso
d910: 6c 65 74 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  lete..*/.void sq
d920: 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61  lite3ExpirePrepa
d930: 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 73 71  redStatements(sq
d940: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 56 64  lite3 *db){.  Vd
d950: 62 65 20 2a 70 3b 0a 20 20 66 6f 72 28 70 20 3d  be *p;.  for(p =
d960: 20 64 62 2d 3e 70 56 64 62 65 3b 20 70 3b 20 70   db->pVdbe; p; p
d970: 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20  =p->pNext){.    
d980: 70 2d 3e 65 78 70 69 72 65 64 20 3d 20 31 3b 0a  p->expired = 1;.
d990: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74    }.}../*.** Ret
d9a0: 75 72 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  urn the database
d9b0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
d9c0: 20 74 68 65 20 56 64 62 65 2e 0a 2a 2f 0a 73 71   the Vdbe..*/.sq
d9d0: 6c 69 74 65 33 20 2a 73 71 6c 69 74 65 33 56 64  lite3 *sqlite3Vd
d9e0: 62 65 44 62 28 56 64 62 65 20 2a 76 29 7b 0a 20  beDb(Vdbe *v){. 
d9f0: 20 72 65 74 75 72 6e 20 76 2d 3e 64 62 3b 0a 7d   return v->db;.}
da00: 0a                                               .