/ Hex Artifact Content
Login

Artifact 30cd8af354e3a067a494196e11f6795fc4bc42f9:


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 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ts..*/.static vo
05f0: 69 64 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79  id resizeOpArray
0600: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 4e 29  (Vdbe *p, int N)
0610: 7b 0a 20 20 69 66 28 20 70 2d 3e 6e 4f 70 41 6c  {.  if( p->nOpAl
0620: 6c 6f 63 3c 4e 20 29 7b 0a 20 20 20 20 69 6e 74  loc<N ){.    int
0630: 20 6f 6c 64 53 69 7a 65 20 3d 20 70 2d 3e 6e 4f   oldSize = p->nO
0640: 70 41 6c 6c 6f 63 3b 0a 20 20 20 20 70 2d 3e 6e  pAlloc;.    p->n
0650: 4f 70 41 6c 6c 6f 63 20 3d 20 4e 2b 31 30 30 3b  OpAlloc = N+100;
0660: 0a 20 20 20 20 70 2d 3e 61 4f 70 20 3d 20 73 71  .    p->aOp = sq
0670: 6c 69 74 65 52 65 61 6c 6c 6f 63 28 70 2d 3e 61  liteRealloc(p->a
0680: 4f 70 2c 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 2a  Op, p->nOpAlloc*
0690: 73 69 7a 65 6f 66 28 4f 70 29 29 3b 0a 20 20 20  sizeof(Op));.   
06a0: 20 69 66 28 20 70 2d 3e 61 4f 70 20 29 7b 0a 20   if( p->aOp ){. 
06b0: 20 20 20 20 20 6d 65 6d 73 65 74 28 26 70 2d 3e       memset(&p->
06c0: 61 4f 70 5b 6f 6c 64 53 69 7a 65 5d 2c 20 30 2c  aOp[oldSize], 0,
06d0: 20 28 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 2d 6f 6c   (p->nOpAlloc-ol
06e0: 64 53 69 7a 65 29 2a 73 69 7a 65 6f 66 28 4f 70  dSize)*sizeof(Op
06f0: 29 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a  ));.    }.  }.}.
0700: 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 6e 65 77  ./*.** Add a new
0710: 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f 20   instruction to 
0720: 74 68 65 20 6c 69 73 74 20 6f 66 20 69 6e 73 74  the list of inst
0730: 72 75 63 74 69 6f 6e 73 20 63 75 72 72 65 6e 74  ructions current
0740: 20 69 6e 20 74 68 65 0a 2a 2a 20 56 44 42 45 2e   in the.** VDBE.
0750: 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 64 64    Return the add
0760: 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 77 20  ress of the new 
0770: 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 0a  instruction..**.
0780: 2a 2a 20 50 61 72 61 6d 65 74 65 72 73 3a 0a 2a  ** Parameters:.*
0790: 2a 0a 2a 2a 20 20 20 20 70 20 20 20 20 20 20 20  *.**    p       
07a0: 20 20 20 20 20 20 20 20 50 6f 69 6e 74 65 72 20          Pointer 
07b0: 74 6f 20 74 68 65 20 56 44 42 45 0a 2a 2a 0a 2a  to the VDBE.**.*
07c0: 2a 20 20 20 20 6f 70 20 20 20 20 20 20 20 20 20  *    op         
07d0: 20 20 20 20 20 54 68 65 20 6f 70 63 6f 64 65 20       The opcode 
07e0: 66 6f 72 20 74 68 69 73 20 69 6e 73 74 72 75 63  for this instruc
07f0: 74 69 6f 6e 0a 2a 2a 0a 2a 2a 20 20 20 20 70 31  tion.**.**    p1
0800: 2c 20 70 32 20 20 20 20 20 20 20 20 20 20 46 69  , p2          Fi
0810: 72 73 74 20 74 77 6f 20 6f 66 20 74 68 65 20 74  rst two of the t
0820: 68 72 65 65 20 70 6f 73 73 69 62 6c 65 20 6f 70  hree possible op
0830: 65 72 61 6e 64 73 2e 0a 2a 2a 0a 2a 2a 20 55 73  erands..**.** Us
0840: 65 20 74 68 65 20 73 71 6c 69 74 65 33 56 64 62  e the sqlite3Vdb
0850: 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 29 20  eResolveLabel() 
0860: 66 75 6e 63 74 69 6f 6e 20 74 6f 20 66 69 78 20  function to fix 
0870: 61 6e 20 61 64 64 72 65 73 73 20 61 6e 64 0a 2a  an address and.*
0880: 2a 20 74 68 65 20 73 71 6c 69 74 65 33 56 64 62  * the sqlite3Vdb
0890: 65 43 68 61 6e 67 65 50 33 28 29 20 66 75 6e 63  eChangeP3() func
08a0: 74 69 6f 6e 20 74 6f 20 63 68 61 6e 67 65 20 74  tion to change t
08b0: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20  he value of the 
08c0: 50 33 0a 2a 2a 20 6f 70 65 72 61 6e 64 2e 0a 2a  P3.** operand..*
08d0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
08e0: 65 41 64 64 4f 70 28 56 64 62 65 20 2a 70 2c 20  eAddOp(Vdbe *p, 
08f0: 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c 20  int op, int p1, 
0900: 69 6e 74 20 70 32 29 7b 0a 20 20 69 6e 74 20 69  int p2){.  int i
0910: 3b 0a 20 20 56 64 62 65 4f 70 20 2a 70 4f 70 3b  ;.  VdbeOp *pOp;
0920: 0a 0a 20 20 69 20 3d 20 70 2d 3e 6e 4f 70 3b 0a  ..  i = p->nOp;.
0930: 20 20 70 2d 3e 6e 4f 70 2b 2b 3b 0a 20 20 61 73    p->nOp++;.  as
0940: 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d  sert( p->magic==
0950: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
0960: 29 3b 0a 20 20 72 65 73 69 7a 65 4f 70 41 72 72  );.  resizeOpArr
0970: 61 79 28 70 2c 20 69 2b 31 29 3b 0a 20 20 69 66  ay(p, i+1);.  if
0980: 28 20 70 2d 3e 61 4f 70 3d 3d 30 20 29 7b 0a 20  ( p->aOp==0 ){. 
0990: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
09a0: 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70  .  pOp = &p->aOp
09b0: 5b 69 5d 3b 0a 20 20 70 4f 70 2d 3e 6f 70 63 6f  [i];.  pOp->opco
09c0: 64 65 20 3d 20 6f 70 3b 0a 20 20 70 4f 70 2d 3e  de = op;.  pOp->
09d0: 70 31 20 3d 20 70 31 3b 0a 20 20 70 4f 70 2d 3e  p1 = p1;.  pOp->
09e0: 70 32 20 3d 20 70 32 3b 0a 20 20 70 4f 70 2d 3e  p2 = p2;.  pOp->
09f0: 70 33 20 3d 20 30 3b 0a 20 20 70 4f 70 2d 3e 70  p3 = 0;.  pOp->p
0a00: 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53  3type = P3_NOTUS
0a10: 45 44 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54  ED;.#ifdef SQLIT
0a20: 45 5f 44 45 42 55 47 0a 20 20 69 66 28 20 73 71  E_DEBUG.  if( sq
0a30: 6c 69 74 65 33 5f 76 64 62 65 5f 61 64 64 6f 70  lite3_vdbe_addop
0a40: 5f 74 72 61 63 65 20 29 20 73 71 6c 69 74 65 33  _trace ) sqlite3
0a50: 56 64 62 65 50 72 69 6e 74 4f 70 28 30 2c 20 69  VdbePrintOp(0, i
0a60: 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 23  , &p->aOp[i]);.#
0a70: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 69  endif.  return i
0a80: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61  ;.}../*.** Add a
0a90: 6e 20 6f 70 63 6f 64 65 20 74 68 61 74 20 69 6e  n opcode that in
0aa0: 63 6c 75 64 65 73 20 74 68 65 20 70 33 20 76 61  cludes the p3 va
0ab0: 6c 75 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  lue..*/.int sqli
0ac0: 74 65 33 56 64 62 65 4f 70 33 28 56 64 62 65 20  te3VdbeOp3(Vdbe 
0ad0: 2a 70 2c 20 69 6e 74 20 6f 70 2c 20 69 6e 74 20  *p, int op, int 
0ae0: 70 31 2c 20 69 6e 74 20 70 32 2c 20 63 6f 6e 73  p1, int p2, cons
0af0: 74 20 63 68 61 72 20 2a 7a 50 33 2c 69 6e 74 20  t char *zP3,int 
0b00: 70 33 74 79 70 65 29 7b 0a 20 20 69 6e 74 20 61  p3type){.  int a
0b10: 64 64 72 20 3d 20 73 71 6c 69 74 65 33 56 64 62  ddr = sqlite3Vdb
0b20: 65 41 64 64 4f 70 28 70 2c 20 6f 70 2c 20 70 31  eAddOp(p, op, p1
0b30: 2c 20 70 32 29 3b 0a 20 20 73 71 6c 69 74 65 33  , p2);.  sqlite3
0b40: 56 64 62 65 43 68 61 6e 67 65 50 33 28 70 2c 20  VdbeChangeP3(p, 
0b50: 61 64 64 72 2c 20 7a 50 33 2c 20 70 33 74 79 70  addr, zP3, p3typ
0b60: 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 61 64 64  e);.  return add
0b70: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61  r;.}../*.** Crea
0b80: 74 65 20 61 20 6e 65 77 20 73 79 6d 62 6f 6c 69  te a new symboli
0b90: 63 20 6c 61 62 65 6c 20 66 6f 72 20 61 6e 20 69  c label for an i
0ba0: 6e 73 74 72 75 63 74 69 6f 6e 20 74 68 61 74 20  nstruction that 
0bb0: 68 61 73 20 79 65 74 20 74 6f 20 62 65 0a 2a 2a  has yet to be.**
0bc0: 20 63 6f 64 65 64 2e 20 20 54 68 65 20 73 79 6d   coded.  The sym
0bd0: 62 6f 6c 69 63 20 6c 61 62 65 6c 20 69 73 20 72  bolic label is r
0be0: 65 61 6c 6c 79 20 6a 75 73 74 20 61 20 6e 65 67  eally just a neg
0bf0: 61 74 69 76 65 20 6e 75 6d 62 65 72 2e 20 20 54  ative number.  T
0c00: 68 65 0a 2a 2a 20 6c 61 62 65 6c 20 63 61 6e 20  he.** label can 
0c10: 62 65 20 75 73 65 64 20 61 73 20 74 68 65 20 50  be used as the P
0c20: 32 20 76 61 6c 75 65 20 6f 66 20 61 6e 20 6f 70  2 value of an op
0c30: 65 72 61 74 69 6f 6e 2e 20 20 4c 61 74 65 72 2c  eration.  Later,
0c40: 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 6c 61 62   when.** the lab
0c50: 65 6c 20 69 73 20 72 65 73 6f 6c 76 65 64 20 74  el is resolved t
0c60: 6f 20 61 20 73 70 65 63 69 66 69 63 20 61 64 64  o a specific add
0c70: 72 65 73 73 2c 20 74 68 65 20 56 44 42 45 20 77  ress, the VDBE w
0c80: 69 6c 6c 20 73 63 61 6e 0a 2a 2a 20 74 68 72 6f  ill scan.** thro
0c90: 75 67 68 20 69 74 73 20 6f 70 65 72 61 74 69 6f  ugh its operatio
0ca0: 6e 20 6c 69 73 74 20 61 6e 64 20 63 68 61 6e 67  n list and chang
0cb0: 65 20 61 6c 6c 20 76 61 6c 75 65 73 20 6f 66 20  e all values of 
0cc0: 50 32 20 77 68 69 63 68 20 6d 61 74 63 68 0a 2a  P2 which match.*
0cd0: 2a 20 74 68 65 20 6c 61 62 65 6c 20 69 6e 74 6f  * the label into
0ce0: 20 74 68 65 20 72 65 73 6f 6c 76 65 64 20 61 64   the resolved ad
0cf0: 64 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  dress..**.** The
0d00: 20 56 44 42 45 20 6b 6e 6f 77 73 20 74 68 61 74   VDBE knows that
0d10: 20 61 20 50 32 20 76 61 6c 75 65 20 69 73 20 61   a P2 value is a
0d20: 20 6c 61 62 65 6c 20 62 65 63 61 75 73 65 20 6c   label because l
0d30: 61 62 65 6c 73 20 61 72 65 0a 2a 2a 20 61 6c 77  abels are.** alw
0d40: 61 79 73 20 6e 65 67 61 74 69 76 65 20 61 6e 64  ays negative and
0d50: 20 50 32 20 76 61 6c 75 65 73 20 61 72 65 20 73   P2 values are s
0d60: 75 70 70 6f 73 65 20 74 6f 20 62 65 20 6e 6f 6e  uppose to be non
0d70: 2d 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 48 65  -negative..** He
0d80: 6e 63 65 2c 20 61 20 6e 65 67 61 74 69 76 65 20  nce, a negative 
0d90: 50 32 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61  P2 value is a la
0da0: 62 65 6c 20 74 68 61 74 20 68 61 73 20 79 65 74  bel that has yet
0db0: 20 74 6f 20 62 65 20 72 65 73 6f 6c 76 65 64 2e   to be resolved.
0dc0: 0a 2a 2a 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 72  .**.** Zero is r
0dd0: 65 74 75 72 6e 65 64 20 69 66 20 61 20 6d 61 6c  eturned if a mal
0de0: 6c 6f 63 28 29 20 66 61 69 6c 73 2e 0a 2a 2f 0a  loc() fails..*/.
0df0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d  int sqlite3VdbeM
0e00: 61 6b 65 4c 61 62 65 6c 28 56 64 62 65 20 2a 70  akeLabel(Vdbe *p
0e10: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 20  ){.  int i;.  i 
0e20: 3d 20 70 2d 3e 6e 4c 61 62 65 6c 2b 2b 3b 0a 20  = p->nLabel++;. 
0e30: 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69   assert( p->magi
0e40: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  c==VDBE_MAGIC_IN
0e50: 49 54 20 29 3b 0a 20 20 69 66 28 20 69 3e 3d 70  IT );.  if( i>=p
0e60: 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20 29 7b  ->nLabelAlloc ){
0e70: 0a 20 20 20 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c  .    p->nLabelAl
0e80: 6c 6f 63 20 3d 20 70 2d 3e 6e 4c 61 62 65 6c 41  loc = p->nLabelA
0e90: 6c 6c 6f 63 2a 32 20 2b 20 31 30 3b 0a 20 20 20  lloc*2 + 10;.   
0ea0: 20 70 2d 3e 61 4c 61 62 65 6c 20 3d 20 73 71 6c   p->aLabel = sql
0eb0: 69 74 65 52 65 61 6c 6c 6f 63 28 20 70 2d 3e 61  iteRealloc( p->a
0ec0: 4c 61 62 65 6c 2c 20 70 2d 3e 6e 4c 61 62 65 6c  Label, p->nLabel
0ed0: 41 6c 6c 6f 63 2a 73 69 7a 65 6f 66 28 70 2d 3e  Alloc*sizeof(p->
0ee0: 61 4c 61 62 65 6c 5b 30 5d 29 29 3b 0a 20 20 7d  aLabel[0]));.  }
0ef0: 0a 20 20 69 66 28 20 70 2d 3e 61 4c 61 62 65 6c  .  if( p->aLabel
0f00: 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4c 61 62 65   ){.    p->aLabe
0f10: 6c 5b 69 5d 20 3d 20 2d 31 3b 0a 20 20 7d 0a 20  l[i] = -1;.  }. 
0f20: 20 72 65 74 75 72 6e 20 2d 31 2d 69 3b 0a 7d 0a   return -1-i;.}.
0f30: 0a 2f 2a 0a 2a 2a 20 52 65 73 6f 6c 76 65 20 6c  ./*.** Resolve l
0f40: 61 62 65 6c 20 22 78 22 20 74 6f 20 62 65 20 74  abel "x" to be t
0f50: 68 65 20 61 64 64 72 65 73 73 20 6f 66 20 74 68  he address of th
0f60: 65 20 6e 65 78 74 20 69 6e 73 74 72 75 63 74 69  e next instructi
0f70: 6f 6e 20 74 6f 0a 2a 2a 20 62 65 20 69 6e 73 65  on to.** be inse
0f80: 72 74 65 64 2e 20 20 54 68 65 20 70 61 72 61 6d  rted.  The param
0f90: 65 74 65 72 20 22 78 22 20 6d 75 73 74 20 68 61  eter "x" must ha
0fa0: 76 65 20 62 65 65 6e 20 6f 62 74 61 69 6e 65 64  ve been obtained
0fb0: 20 66 72 6f 6d 0a 2a 2a 20 61 20 70 72 69 6f 72   from.** a prior
0fc0: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
0fd0: 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 29 2e  VdbeMakeLabel().
0fe0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
0ff0: 56 64 62 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c  VdbeResolveLabel
1000: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 78 29  (Vdbe *p, int x)
1010: 7b 0a 20 20 69 6e 74 20 6a 20 3d 20 2d 31 2d 78  {.  int j = -1-x
1020: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d  ;.  assert( p->m
1030: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
1040: 5f 49 4e 49 54 20 29 3b 0a 20 20 61 73 73 65 72  _INIT );.  asser
1050: 74 28 20 6a 3e 3d 30 20 26 26 20 6a 3c 70 2d 3e  t( j>=0 && j<p->
1060: 6e 4c 61 62 65 6c 20 29 3b 0a 20 20 69 66 28 20  nLabel );.  if( 
1070: 70 2d 3e 61 4c 61 62 65 6c 20 29 7b 0a 20 20 20  p->aLabel ){.   
1080: 20 70 2d 3e 61 4c 61 62 65 6c 5b 6a 5d 20 3d 20   p->aLabel[j] = 
1090: 70 2d 3e 6e 4f 70 3b 0a 20 20 7d 0a 7d 0a 0a 2f  p->nOp;.  }.}../
10a0: 2a 0a 2a 2a 20 4c 6f 6f 70 20 74 68 72 6f 75 67  *.** Loop throug
10b0: 68 20 74 68 65 20 70 72 6f 67 72 61 6d 20 6c 6f  h the program lo
10c0: 6f 6b 69 6e 67 20 66 6f 72 20 50 32 20 76 61 6c  oking for P2 val
10d0: 75 65 73 20 74 68 61 74 20 61 72 65 20 6e 65 67  ues that are neg
10e0: 61 74 69 76 65 2e 0a 2a 2a 20 45 61 63 68 20 73  ative..** Each s
10f0: 75 63 68 20 76 61 6c 75 65 20 69 73 20 61 20 6c  uch value is a l
1100: 61 62 65 6c 2e 20 20 52 65 73 6f 6c 76 65 20 74  abel.  Resolve t
1110: 68 65 20 6c 61 62 65 6c 20 62 79 20 73 65 74 74  he label by sett
1120: 69 6e 67 20 74 68 65 20 50 32 0a 2a 2a 20 76 61  ing the P2.** va
1130: 6c 75 65 20 74 6f 20 69 74 73 20 63 6f 72 72 65  lue to its corre
1140: 63 74 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75  ct non-zero valu
1150: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  e..**.** This ro
1160: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20  utine is called 
1170: 6f 6e 63 65 20 61 66 74 65 72 20 61 6c 6c 20 6f  once after all o
1180: 70 63 6f 64 65 73 20 68 61 76 65 20 62 65 65 6e  pcodes have been
1190: 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2f 0a 73 74   inserted..*/.st
11a0: 61 74 69 63 20 76 6f 69 64 20 72 65 73 6f 6c 76  atic void resolv
11b0: 65 50 32 56 61 6c 75 65 73 28 56 64 62 65 20 2a  eP2Values(Vdbe *
11c0: 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 4f  p){.  int i;.  O
11d0: 70 20 2a 70 4f 70 3b 0a 20 20 69 6e 74 20 2a 61  p *pOp;.  int *a
11e0: 4c 61 62 65 6c 20 3d 20 70 2d 3e 61 4c 61 62 65  Label = p->aLabe
11f0: 6c 3b 0a 20 20 69 66 28 20 61 4c 61 62 65 6c 3d  l;.  if( aLabel=
1200: 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 66  =0 ) return;.  f
1210: 6f 72 28 70 4f 70 3d 70 2d 3e 61 4f 70 2c 20 69  or(pOp=p->aOp, i
1220: 3d 70 2d 3e 6e 4f 70 2d 31 3b 20 69 3e 3d 30 3b  =p->nOp-1; i>=0;
1230: 20 69 2d 2d 2c 20 70 4f 70 2b 2b 29 7b 0a 20 20   i--, pOp++){.  
1240: 20 20 69 66 28 20 70 4f 70 2d 3e 70 32 3e 3d 30    if( pOp->p2>=0
1250: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
1260: 20 61 73 73 65 72 74 28 20 2d 31 2d 70 4f 70 2d   assert( -1-pOp-
1270: 3e 70 32 3c 70 2d 3e 6e 4c 61 62 65 6c 20 29 3b  >p2<p->nLabel );
1280: 0a 20 20 20 20 70 4f 70 2d 3e 70 32 20 3d 20 61  .    pOp->p2 = a
1290: 4c 61 62 65 6c 5b 2d 31 2d 70 4f 70 2d 3e 70 32  Label[-1-pOp->p2
12a0: 5d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46  ];.  }.  sqliteF
12b0: 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a  ree(p->aLabel);.
12c0: 20 20 70 2d 3e 61 4c 61 62 65 6c 20 3d 20 30 3b    p->aLabel = 0;
12d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
12e0: 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66 20   the address of 
12f0: 74 68 65 20 6e 65 78 74 20 69 6e 73 74 72 75 63  the next instruc
1300: 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 73 65 72  tion to be inser
1310: 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ted..*/.int sqli
1320: 74 65 33 56 64 62 65 43 75 72 72 65 6e 74 41 64  te3VdbeCurrentAd
1330: 64 72 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 61  dr(Vdbe *p){.  a
1340: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
1350: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
1360: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e   );.  return p->
1370: 6e 4f 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64  nOp;.}../*.** Ad
1380: 64 20 61 20 77 68 6f 6c 65 20 6c 69 73 74 20 6f  d a whole list o
1390: 66 20 6f 70 65 72 61 74 69 6f 6e 73 20 74 6f 20  f operations to 
13a0: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 73 74  the operation st
13b0: 61 63 6b 2e 20 20 52 65 74 75 72 6e 20 74 68 65  ack.  Return the
13c0: 0a 2a 2a 20 61 64 64 72 65 73 73 20 6f 66 20 74  .** address of t
13d0: 68 65 20 66 69 72 73 74 20 6f 70 65 72 61 74 69  he first operati
13e0: 6f 6e 20 61 64 64 65 64 2e 0a 2a 2f 0a 69 6e 74  on added..*/.int
13f0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
1400: 70 4c 69 73 74 28 56 64 62 65 20 2a 70 2c 20 69  pList(Vdbe *p, i
1410: 6e 74 20 6e 4f 70 2c 20 56 64 62 65 4f 70 4c 69  nt nOp, VdbeOpLi
1420: 73 74 20 63 6f 6e 73 74 20 2a 61 4f 70 29 7b 0a  st const *aOp){.
1430: 20 20 69 6e 74 20 61 64 64 72 3b 0a 20 20 61 73    int addr;.  as
1440: 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d  sert( p->magic==
1450: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
1460: 29 3b 0a 20 20 72 65 73 69 7a 65 4f 70 41 72 72  );.  resizeOpArr
1470: 61 79 28 70 2c 20 70 2d 3e 6e 4f 70 20 2b 20 6e  ay(p, p->nOp + n
1480: 4f 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61 4f  Op);.  if( p->aO
1490: 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  p==0 ){.    retu
14a0: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 61 64 64 72  rn 0;.  }.  addr
14b0: 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 69 66 28   = p->nOp;.  if(
14c0: 20 6e 4f 70 3e 30 20 29 7b 0a 20 20 20 20 69 6e   nOp>0 ){.    in
14d0: 74 20 69 3b 0a 20 20 20 20 56 64 62 65 4f 70 4c  t i;.    VdbeOpL
14e0: 69 73 74 20 63 6f 6e 73 74 20 2a 70 49 6e 20 3d  ist const *pIn =
14f0: 20 61 4f 70 3b 0a 20 20 20 20 66 6f 72 28 69 3d   aOp;.    for(i=
1500: 30 3b 20 69 3c 6e 4f 70 3b 20 69 2b 2b 2c 20 70  0; i<nOp; i++, p
1510: 49 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 69 6e 74  In++){.      int
1520: 20 70 32 20 3d 20 70 49 6e 2d 3e 70 32 3b 0a 20   p2 = pIn->p2;. 
1530: 20 20 20 20 20 56 64 62 65 4f 70 20 2a 70 4f 75       VdbeOp *pOu
1540: 74 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 2b 61 64  t = &p->aOp[i+ad
1550: 64 72 5d 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d  dr];.      pOut-
1560: 3e 6f 70 63 6f 64 65 20 3d 20 70 49 6e 2d 3e 6f  >opcode = pIn->o
1570: 70 63 6f 64 65 3b 0a 20 20 20 20 20 20 70 4f 75  pcode;.      pOu
1580: 74 2d 3e 70 31 20 3d 20 70 49 6e 2d 3e 70 31 3b  t->p1 = pIn->p1;
1590: 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 32 20  .      pOut->p2 
15a0: 3d 20 70 32 3c 30 20 3f 20 61 64 64 72 20 2b 20  = p2<0 ? addr + 
15b0: 41 44 44 52 28 70 32 29 20 3a 20 70 32 3b 0a 20  ADDR(p2) : p2;. 
15c0: 20 20 20 20 20 70 4f 75 74 2d 3e 70 33 20 3d 20       pOut->p3 = 
15d0: 70 49 6e 2d 3e 70 33 3b 0a 20 20 20 20 20 20 70  pIn->p3;.      p
15e0: 4f 75 74 2d 3e 70 33 74 79 70 65 20 3d 20 70 49  Out->p3type = pI
15f0: 6e 2d 3e 70 33 20 3f 20 50 33 5f 53 54 41 54 49  n->p3 ? P3_STATI
1600: 43 20 3a 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a  C : P3_NOTUSED;.
1610: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
1620: 42 55 47 0a 20 20 20 20 20 20 69 66 28 20 73 71  BUG.      if( sq
1630: 6c 69 74 65 33 5f 76 64 62 65 5f 61 64 64 6f 70  lite3_vdbe_addop
1640: 5f 74 72 61 63 65 20 29 7b 0a 20 20 20 20 20 20  _trace ){.      
1650: 20 20 73 71 6c 69 74 65 33 56 64 62 65 50 72 69    sqlite3VdbePri
1660: 6e 74 4f 70 28 30 2c 20 69 2b 61 64 64 72 2c 20  ntOp(0, i+addr, 
1670: 26 70 2d 3e 61 4f 70 5b 69 2b 61 64 64 72 5d 29  &p->aOp[i+addr])
1680: 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66  ;.      }.#endif
1690: 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 6e 4f  .    }.    p->nO
16a0: 70 20 2b 3d 20 6e 4f 70 3b 0a 20 20 7d 0a 20 20  p += nOp;.  }.  
16b0: 72 65 74 75 72 6e 20 61 64 64 72 3b 0a 7d 0a 0a  return addr;.}..
16c0: 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65  /*.** Change the
16d0: 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 50 31   value of the P1
16e0: 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61 20 73   operand for a s
16f0: 70 65 63 69 66 69 63 20 69 6e 73 74 72 75 63 74  pecific instruct
1700: 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ion..** This rou
1710: 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c 20 77  tine is useful w
1720: 68 65 6e 20 61 20 6c 61 72 67 65 20 70 72 6f 67  hen a large prog
1730: 72 61 6d 20 69 73 20 6c 6f 61 64 65 64 20 66 72  ram is loaded fr
1740: 6f 6d 20 61 0a 2a 2a 20 73 74 61 74 69 63 20 61  om a.** static a
1750: 72 72 61 79 20 75 73 69 6e 67 20 73 71 6c 69 74  rray using sqlit
1760: 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74 20  e3VdbeAddOpList 
1770: 62 75 74 20 77 65 20 77 61 6e 74 20 74 6f 20 6d  but we want to m
1780: 61 6b 65 20 61 0a 2a 2a 20 66 65 77 20 6d 69 6e  ake a.** few min
1790: 6f 72 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68  or changes to th
17a0: 65 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 76 6f  e program..*/.vo
17b0: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 43 68  id sqlite3VdbeCh
17c0: 61 6e 67 65 50 31 28 56 64 62 65 20 2a 70 2c 20  angeP1(Vdbe *p, 
17d0: 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20 76 61  int addr, int va
17e0: 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 2d  l){.  assert( p-
17f0: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
1800: 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66 28  IC_INIT );.  if(
1810: 20 70 20 26 26 20 61 64 64 72 3e 3d 30 20 26 26   p && addr>=0 &&
1820: 20 70 2d 3e 6e 4f 70 3e 61 64 64 72 20 26 26 20   p->nOp>addr && 
1830: 70 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 70 2d  p->aOp ){.    p-
1840: 3e 61 4f 70 5b 61 64 64 72 5d 2e 70 31 20 3d 20  >aOp[addr].p1 = 
1850: 76 61 6c 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  val;.  }.}../*.*
1860: 2a 20 43 68 61 6e 67 65 20 74 68 65 20 76 61 6c  * Change the val
1870: 75 65 20 6f 66 20 74 68 65 20 50 32 20 6f 70 65  ue of the P2 ope
1880: 72 61 6e 64 20 66 6f 72 20 61 20 73 70 65 63 69  rand for a speci
1890: 66 69 63 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e  fic instruction.
18a0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
18b0: 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 73   is useful for s
18c0: 65 74 74 69 6e 67 20 61 20 6a 75 6d 70 20 64 65  etting a jump de
18d0: 73 74 69 6e 61 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f  stination..*/.vo
18e0: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 43 68  id sqlite3VdbeCh
18f0: 61 6e 67 65 50 32 28 56 64 62 65 20 2a 70 2c 20  angeP2(Vdbe *p, 
1900: 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20 76 61  int addr, int va
1910: 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20 76 61  l){.  assert( va
1920: 6c 3e 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  l>=0 );.  assert
1930: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
1940: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
1950: 20 69 66 28 20 70 20 26 26 20 61 64 64 72 3e 3d   if( p && addr>=
1960: 30 20 26 26 20 70 2d 3e 6e 4f 70 3e 61 64 64 72  0 && p->nOp>addr
1970: 20 26 26 20 70 2d 3e 61 4f 70 20 29 7b 0a 20 20   && p->aOp ){.  
1980: 20 20 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 2e 70    p->aOp[addr].p
1990: 32 20 3d 20 76 61 6c 3b 0a 20 20 7d 0a 7d 0a 0a  2 = val;.  }.}..
19a0: 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65  /*.** Change the
19b0: 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 50 33   value of the P3
19c0: 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61 20 73   operand for a s
19d0: 70 65 63 69 66 69 63 20 69 6e 73 74 72 75 63 74  pecific instruct
19e0: 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ion..** This rou
19f0: 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c 20 77  tine is useful w
1a00: 68 65 6e 20 61 20 6c 61 72 67 65 20 70 72 6f 67  hen a large prog
1a10: 72 61 6d 20 69 73 20 6c 6f 61 64 65 64 20 66 72  ram is loaded fr
1a20: 6f 6d 20 61 0a 2a 2a 20 73 74 61 74 69 63 20 61  om a.** static a
1a30: 72 72 61 79 20 75 73 69 6e 67 20 73 71 6c 69 74  rray using sqlit
1a40: 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74 20  e3VdbeAddOpList 
1a50: 62 75 74 20 77 65 20 77 61 6e 74 20 74 6f 20 6d  but we want to m
1a60: 61 6b 65 20 61 0a 2a 2a 20 66 65 77 20 6d 69 6e  ake a.** few min
1a70: 6f 72 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68  or changes to th
1a80: 65 20 70 72 6f 67 72 61 6d 2e 0a 2a 2a 0a 2a 2a  e program..**.**
1a90: 20 49 66 20 6e 3e 3d 30 20 74 68 65 6e 20 74 68   If n>=0 then th
1aa0: 65 20 50 33 20 6f 70 65 72 61 6e 64 20 69 73 20  e P3 operand is 
1ab0: 64 79 6e 61 6d 69 63 2c 20 6d 65 61 6e 69 6e 67  dynamic, meaning
1ac0: 20 74 68 61 74 20 61 20 63 6f 70 79 20 6f 66 0a   that a copy of.
1ad0: 2a 2a 20 74 68 65 20 73 74 72 69 6e 67 20 69 73  ** the string is
1ae0: 20 6d 61 64 65 20 69 6e 74 6f 20 6d 65 6d 6f 72   made into memor
1af0: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20  y obtained from 
1b00: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 2e 0a  sqliteMalloc()..
1b10: 2a 2a 20 41 20 76 61 6c 75 65 20 6f 66 20 6e 3d  ** A value of n=
1b20: 3d 30 20 6d 65 61 6e 73 20 63 6f 70 79 20 62 79  =0 means copy by
1b30: 74 65 73 20 6f 66 20 7a 50 33 20 75 70 20 74 6f  tes of zP3 up to
1b40: 20 61 6e 64 20 69 6e 63 6c 75 64 69 6e 67 20 74   and including t
1b50: 68 65 0a 2a 2a 20 66 69 72 73 74 20 6e 75 6c 6c  he.** first null
1b60: 20 62 79 74 65 2e 20 20 49 66 20 6e 3e 30 20 74   byte.  If n>0 t
1b70: 68 65 6e 20 63 6f 70 79 20 6e 2b 31 20 62 79 74  hen copy n+1 byt
1b80: 65 73 20 6f 66 20 7a 50 33 2e 0a 2a 2a 0a 2a 2a  es of zP3..**.**
1b90: 20 49 66 20 6e 3d 3d 50 33 5f 53 54 41 54 49 43   If n==P3_STATIC
1ba0: 20 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20    it means that 
1bb0: 7a 50 33 20 69 73 20 61 20 70 6f 69 6e 74 65 72  zP3 is a pointer
1bc0: 20 74 6f 20 61 20 63 6f 6e 73 74 61 6e 74 20 73   to a constant s
1bd0: 74 61 74 69 63 0a 2a 2a 20 73 74 72 69 6e 67 20  tatic.** string 
1be0: 61 6e 64 20 77 65 20 63 61 6e 20 6a 75 73 74 20  and we can just 
1bf0: 63 6f 70 79 20 74 68 65 20 70 6f 69 6e 74 65 72  copy the pointer
1c00: 2e 20 20 6e 3d 3d 50 33 5f 50 4f 49 4e 54 45 52  .  n==P3_POINTER
1c10: 20 6d 65 61 6e 73 20 7a 50 33 20 69 73 0a 2a 2a   means zP3 is.**
1c20: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 73 6f   a pointer to so
1c30: 6d 65 20 6f 62 6a 65 63 74 20 6f 74 68 65 72 20  me object other 
1c40: 74 68 61 6e 20 61 20 73 74 72 69 6e 67 2e 20 20  than a string.  
1c50: 6e 3d 3d 50 33 5f 43 4f 4c 4c 53 45 51 20 61 6e  n==P3_COLLSEQ an
1c60: 64 0a 2a 2a 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e  d.** n==P3_KEYIN
1c70: 46 4f 20 6d 65 61 6e 20 74 68 61 74 20 7a 50 33  FO mean that zP3
1c80: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f   is a pointer to
1c90: 20 61 20 43 6f 6c 6c 53 65 71 20 6f 72 20 4b 65   a CollSeq or Ke
1ca0: 79 49 6e 66 6f 0a 2a 2a 20 73 74 72 75 63 74 75  yInfo.** structu
1cb0: 72 65 2e 20 20 41 20 63 6f 70 79 20 69 73 20 6d  re.  A copy is m
1cc0: 61 64 65 20 6f 66 20 4b 65 79 49 6e 66 6f 20 73  ade of KeyInfo s
1cd0: 74 72 75 63 74 75 72 65 73 20 69 6e 74 6f 20 6d  tructures into m
1ce0: 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64 0a 2a  emory obtained.*
1cf0: 2a 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d 61 6c  * from sqliteMal
1d00: 6c 6f 63 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 64  loc..**.** If ad
1d10: 64 72 3c 30 20 74 68 65 6e 20 63 68 61 6e 67 65  dr<0 then change
1d20: 20 50 33 20 6f 6e 20 74 68 65 20 6d 6f 73 74 20   P3 on the most 
1d30: 72 65 63 65 6e 74 6c 79 20 69 6e 73 65 72 74 65  recently inserte
1d40: 64 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a  d instruction..*
1d50: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
1d60: 62 65 43 68 61 6e 67 65 50 33 28 56 64 62 65 20  beChangeP3(Vdbe 
1d70: 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20 63 6f  *p, int addr, co
1d80: 6e 73 74 20 63 68 61 72 20 2a 7a 50 33 2c 20 69  nst char *zP3, i
1d90: 6e 74 20 6e 29 7b 0a 20 20 4f 70 20 2a 70 4f 70  nt n){.  Op *pOp
1da0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d  ;.  assert( p->m
1db0: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
1dc0: 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66 28 20 70  _INIT );.  if( p
1dd0: 3d 3d 30 20 7c 7c 20 70 2d 3e 61 4f 70 3d 3d 30  ==0 || p->aOp==0
1de0: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 69 66 28   ) return;.  if(
1df0: 20 61 64 64 72 3c 30 20 7c 7c 20 61 64 64 72 3e   addr<0 || addr>
1e00: 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20 20 20 61  =p->nOp ){.    a
1e10: 64 64 72 20 3d 20 70 2d 3e 6e 4f 70 20 2d 20 31  ddr = p->nOp - 1
1e20: 3b 0a 20 20 20 20 69 66 28 20 61 64 64 72 3c 30  ;.    if( addr<0
1e30: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20   ) return;.  }. 
1e40: 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 61   pOp = &p->aOp[a
1e50: 64 64 72 5d 3b 0a 20 20 69 66 28 20 70 4f 70 2d  ddr];.  if( pOp-
1e60: 3e 70 33 20 26 26 20 70 4f 70 2d 3e 70 33 74 79  >p3 && pOp->p3ty
1e70: 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29  pe==P3_DYNAMIC )
1e80: 7b 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65  {.    sqliteFree
1e90: 28 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20 70  (pOp->p3);.    p
1ea0: 4f 70 2d 3e 70 33 20 3d 20 30 3b 0a 20 20 7d 0a  Op->p3 = 0;.  }.
1eb0: 20 20 69 66 28 20 7a 50 33 3d 3d 30 20 29 7b 0a    if( zP3==0 ){.
1ec0: 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 30 3b      pOp->p3 = 0;
1ed0: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65  .    pOp->p3type
1ee0: 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a 20   = P3_NOTUSED;. 
1ef0: 20 7d 65 6c 73 65 20 69 66 28 20 6e 3d 3d 50 33   }else if( n==P3
1f00: 5f 4b 45 59 49 4e 46 4f 20 29 7b 0a 20 20 20 20  _KEYINFO ){.    
1f10: 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66  KeyInfo *pKeyInf
1f20: 6f 3b 0a 20 20 20 20 69 6e 74 20 6e 46 69 65 6c  o;.    int nFiel
1f30: 64 2c 20 6e 42 79 74 65 3b 0a 20 20 20 20 6e 46  d, nByte;.    nF
1f40: 69 65 6c 64 20 3d 20 28 28 4b 65 79 49 6e 66 6f  ield = ((KeyInfo
1f50: 2a 29 7a 50 33 29 2d 3e 6e 46 69 65 6c 64 3b 0a  *)zP3)->nField;.
1f60: 20 20 20 20 6e 42 79 74 65 20 3d 20 73 69 7a 65      nByte = size
1f70: 6f 66 28 2a 70 4b 65 79 49 6e 66 6f 29 20 2b 20  of(*pKeyInfo) + 
1f80: 28 6e 46 69 65 6c 64 2d 31 29 2a 73 69 7a 65 6f  (nField-1)*sizeo
1f90: 66 28 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c  f(pKeyInfo->aCol
1fa0: 6c 5b 30 5d 29 3b 0a 20 20 20 20 70 4b 65 79 49  l[0]);.    pKeyI
1fb0: 6e 66 6f 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c  nfo = sqliteMall
1fc0: 6f 63 52 61 77 28 20 6e 42 79 74 65 20 29 3b 0a  ocRaw( nByte );.
1fd0: 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63      pOp->p3 = (c
1fe0: 68 61 72 2a 29 70 4b 65 79 49 6e 66 6f 3b 0a 20  har*)pKeyInfo;. 
1ff0: 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 20     if( pKeyInfo 
2000: 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28  ){.      memcpy(
2010: 70 4b 65 79 49 6e 66 6f 2c 20 7a 50 33 2c 20 6e  pKeyInfo, zP3, n
2020: 42 79 74 65 29 3b 0a 20 20 20 20 20 20 70 4f 70  Byte);.      pOp
2030: 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4b 45  ->p3type = P3_KE
2040: 59 49 4e 46 4f 3b 0a 20 20 20 20 7d 65 6c 73 65  YINFO;.    }else
2050: 7b 0a 20 20 20 20 20 20 70 4f 70 2d 3e 70 33 74  {.      pOp->p3t
2060: 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44  ype = P3_NOTUSED
2070: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20  ;.    }.  }else 
2080: 69 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46  if( n==P3_KEYINF
2090: 4f 5f 48 41 4e 44 4f 46 46 20 29 7b 0a 20 20 20  O_HANDOFF ){.   
20a0: 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63 68 61 72   pOp->p3 = (char
20b0: 2a 29 7a 50 33 3b 0a 20 20 20 20 70 4f 70 2d 3e  *)zP3;.    pOp->
20c0: 70 33 74 79 70 65 20 3d 20 50 33 5f 4b 45 59 49  p3type = P3_KEYI
20d0: 4e 46 4f 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  NFO;.  }else if(
20e0: 20 6e 3c 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d   n<0 ){.    pOp-
20f0: 3e 70 33 20 3d 20 28 63 68 61 72 2a 29 7a 50 33  >p3 = (char*)zP3
2100: 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70  ;.    pOp->p3typ
2110: 65 20 3d 20 6e 3b 0a 20 20 7d 65 6c 73 65 7b 0a  e = n;.  }else{.
2120: 20 20 20 20 69 66 28 20 6e 3d 3d 30 20 29 20 6e      if( n==0 ) n
2130: 20 3d 20 73 74 72 6c 65 6e 28 7a 50 33 29 3b 0a   = strlen(zP3);.
2140: 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 73 71      pOp->p3 = sq
2150: 6c 69 74 65 53 74 72 4e 44 75 70 28 7a 50 33 2c  liteStrNDup(zP3,
2160: 20 6e 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33   n);.    pOp->p3
2170: 74 79 70 65 20 3d 20 50 33 5f 44 59 4e 41 4d 49  type = P3_DYNAMI
2180: 43 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65  C;.  }.}..#ifnde
2190: 66 20 4e 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52  f NDEBUG./*.** R
21a0: 65 70 6c 61 63 65 20 74 68 65 20 50 33 20 66 69  eplace the P3 fi
21b0: 65 6c 64 20 6f 66 20 74 68 65 20 6d 6f 73 74 20  eld of the most 
21c0: 72 65 63 65 6e 74 6c 79 20 63 6f 64 65 64 20 69  recently coded i
21d0: 6e 73 74 72 75 63 74 69 6f 6e 20 77 69 74 68 0a  nstruction with.
21e0: 2a 2a 20 63 6f 6d 6d 65 6e 74 20 74 65 78 74 2e  ** comment text.
21f0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
2200: 56 64 62 65 43 6f 6d 6d 65 6e 74 28 56 64 62 65  VdbeComment(Vdbe
2210: 20 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20   *p, const char 
2220: 2a 7a 46 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b 0a  *zFormat, ...){.
2230: 20 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20    va_list ap;.  
2240: 61 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30  assert( p->nOp>0
2250: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d   );.  assert( p-
2260: 3e 61 4f 70 3d 3d 30 20 7c 7c 20 70 2d 3e 61 4f  >aOp==0 || p->aO
2270: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 3d 3d  p[p->nOp-1].p3==
2280: 30 20 29 3b 0a 20 20 76 61 5f 73 74 61 72 74 28  0 );.  va_start(
2290: 61 70 2c 20 7a 46 6f 72 6d 61 74 29 3b 0a 20 20  ap, zFormat);.  
22a0: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
22b0: 65 50 33 28 70 2c 20 2d 31 2c 20 73 71 6c 69 74  eP3(p, -1, sqlit
22c0: 65 33 56 4d 50 72 69 6e 74 66 28 7a 46 6f 72 6d  e3VMPrintf(zForm
22d0: 61 74 2c 20 61 70 29 2c 20 50 33 5f 44 59 4e 41  at, ap), P3_DYNA
22e0: 4d 49 43 29 3b 0a 20 20 76 61 5f 65 6e 64 28 61  MIC);.  va_end(a
22f0: 70 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a  p);.}.#endif../*
2300: 0a 2a 2a 20 49 66 20 74 68 65 20 50 33 20 6f 70  .** If the P3 op
2310: 65 72 61 6e 64 20 74 6f 20 74 68 65 20 73 70 65  erand to the spe
2320: 63 69 66 69 65 64 20 69 6e 73 74 72 75 63 74 69  cified instructi
2330: 6f 6e 20 61 70 70 65 61 72 73 0a 2a 2a 20 74 6f  on appears.** to
2340: 20 62 65 20 61 20 71 75 6f 74 65 64 20 73 74 72   be a quoted str
2350: 69 6e 67 20 74 6f 6b 65 6e 2c 20 74 68 65 6e 20  ing token, then 
2360: 74 68 69 73 20 70 72 6f 63 65 64 75 72 65 20 72  this procedure r
2370: 65 6d 6f 76 65 73 20 0a 2a 2a 20 74 68 65 20 71  emoves .** the q
2380: 75 6f 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  uotes..**.** The
2390: 20 71 75 6f 74 69 6e 67 20 6f 70 65 72 61 74 6f   quoting operato
23a0: 72 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20  r can be either 
23b0: 61 20 67 72 61 76 65 20 61 73 63 65 6e 74 20 28  a grave ascent (
23c0: 41 53 43 49 49 20 30 78 32 37 29 0a 2a 2a 20 6f  ASCII 0x27).** o
23d0: 72 20 61 20 64 6f 75 62 6c 65 20 71 75 6f 74 65  r a double quote
23e0: 20 63 68 61 72 61 63 74 65 72 20 28 41 53 43 49   character (ASCI
23f0: 49 20 30 78 32 32 29 2e 20 20 54 77 6f 20 71 75  I 0x22).  Two qu
2400: 6f 74 65 73 20 69 6e 20 61 20 72 6f 77 0a 2a 2a  otes in a row.**
2410: 20 72 65 73 6f 6c 76 65 20 74 6f 20 62 65 20 61   resolve to be a
2420: 20 73 69 6e 67 6c 65 20 61 63 74 75 61 6c 20 71   single actual q
2430: 75 6f 74 65 20 63 68 61 72 61 63 74 65 72 20 77  uote character w
2440: 69 74 68 69 6e 20 74 68 65 20 73 74 72 69 6e 67  ithin the string
2450: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
2460: 33 56 64 62 65 44 65 71 75 6f 74 65 50 33 28 56  3VdbeDequoteP3(V
2470: 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72  dbe *p, int addr
2480: 29 7b 0a 20 20 4f 70 20 2a 70 4f 70 3b 0a 20 20  ){.  Op *pOp;.  
2490: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
24a0: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
24b0: 54 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61 4f  T );.  if( p->aO
24c0: 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  p==0 ) return;. 
24d0: 20 69 66 28 20 61 64 64 72 3c 30 20 7c 7c 20 61   if( addr<0 || a
24e0: 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20  ddr>=p->nOp ){. 
24f0: 20 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70     addr = p->nOp
2500: 20 2d 20 31 3b 0a 20 20 20 20 69 66 28 20 61 64   - 1;.    if( ad
2510: 64 72 3c 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  dr<0 ) return;. 
2520: 20 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61   }.  pOp = &p->a
2530: 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 69 66 28 20  Op[addr];.  if( 
2540: 70 4f 70 2d 3e 70 33 3d 3d 30 20 7c 7c 20 70 4f  pOp->p3==0 || pO
2550: 70 2d 3e 70 33 5b 30 5d 3d 3d 30 20 29 20 72 65  p->p3[0]==0 ) re
2560: 74 75 72 6e 3b 0a 20 20 69 66 28 20 70 4f 70 2d  turn;.  if( pOp-
2570: 3e 70 33 74 79 70 65 3d 3d 50 33 5f 53 54 41 54  >p3type==P3_STAT
2580: 49 43 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70  IC ){.    pOp->p
2590: 33 20 3d 20 73 71 6c 69 74 65 53 74 72 44 75 70  3 = sqliteStrDup
25a0: 28 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20 70  (pOp->p3);.    p
25b0: 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f  Op->p3type = P3_
25c0: 44 59 4e 41 4d 49 43 3b 0a 20 20 7d 0a 20 20 61  DYNAMIC;.  }.  a
25d0: 73 73 65 72 74 28 20 70 4f 70 2d 3e 70 33 74 79  ssert( pOp->p3ty
25e0: 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29  pe==P3_DYNAMIC )
25f0: 3b 0a 20 20 73 71 6c 69 74 65 33 44 65 71 75 6f  ;.  sqlite3Dequo
2600: 74 65 28 70 4f 70 2d 3e 70 33 29 3b 0a 7d 0a 0a  te(pOp->p3);.}..
2610: 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 20 74 68 65  /*.** Search the
2620: 20 63 75 72 72 65 6e 74 20 70 72 6f 67 72 61 6d   current program
2630: 20 73 74 61 72 74 69 6e 67 20 61 74 20 69 6e 73   starting at ins
2640: 74 72 75 63 74 69 6f 6e 20 61 64 64 72 20 66 6f  truction addr fo
2650: 72 20 74 68 65 20 67 69 76 65 6e 0a 2a 2a 20 6f  r the given.** o
2660: 70 63 6f 64 65 20 61 6e 64 20 50 32 20 76 61 6c  pcode and P2 val
2670: 75 65 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20  ue.  Return the 
2680: 61 64 64 72 65 73 73 20 70 6c 75 73 20 31 20 69  address plus 1 i
2690: 66 20 66 6f 75 6e 64 20 61 6e 64 20 30 20 69 66  f found and 0 if
26a0: 20 6e 6f 74 0a 2a 2a 20 66 6f 75 6e 64 2e 0a 2a   not.** found..*
26b0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
26c0: 65 46 69 6e 64 4f 70 28 56 64 62 65 20 2a 70 2c  eFindOp(Vdbe *p,
26d0: 20 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20 6f   int addr, int o
26e0: 70 2c 20 69 6e 74 20 70 32 29 7b 0a 20 20 69 6e  p, int p2){.  in
26f0: 74 20 69 3b 0a 20 20 61 73 73 65 72 74 28 20 70  t i;.  assert( p
2700: 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41  ->magic==VDBE_MA
2710: 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 66 6f  GIC_INIT );.  fo
2720: 72 28 69 3d 61 64 64 72 3b 20 69 3c 70 2d 3e 6e  r(i=addr; i<p->n
2730: 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66  Op; i++){.    if
2740: 28 20 70 2d 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f  ( p->aOp[i].opco
2750: 64 65 3d 3d 6f 70 20 26 26 20 70 2d 3e 61 4f 70  de==op && p->aOp
2760: 5b 69 5d 2e 70 32 3d 3d 70 32 20 29 20 72 65 74  [i].p2==p2 ) ret
2770: 75 72 6e 20 69 2b 31 3b 0a 20 20 7d 0a 20 20 72  urn i+1;.  }.  r
2780: 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a  eturn 0;.}../*.*
2790: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6f 70 63  * Return the opc
27a0: 6f 64 65 20 66 6f 72 20 61 20 67 69 76 65 6e 20  ode for a given 
27b0: 61 64 64 72 65 73 73 2e 0a 2a 2f 0a 56 64 62 65  address..*/.Vdbe
27c0: 4f 70 20 2a 73 71 6c 69 74 65 33 56 64 62 65 47  Op *sqlite3VdbeG
27d0: 65 74 4f 70 28 56 64 62 65 20 2a 70 2c 20 69 6e  etOp(Vdbe *p, in
27e0: 74 20 61 64 64 72 29 7b 0a 20 20 61 73 73 65 72  t addr){.  asser
27f0: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
2800: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a  E_MAGIC_INIT );.
2810: 20 20 61 73 73 65 72 74 28 20 61 64 64 72 3e 3d    assert( addr>=
2820: 30 20 26 26 20 61 64 64 72 3c 70 2d 3e 6e 4f 70  0 && addr<p->nOp
2830: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 26 70 2d   );.  return &p-
2840: 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 7d 0a 0a 23  >aOp[addr];.}..#
2850: 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49  if !defined(SQLI
2860: 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 29  TE_OMIT_EXPLAIN)
2870: 20 7c 7c 20 21 64 65 66 69 6e 65 64 28 4e 44 45   || !defined(NDE
2880: 42 55 47 29 20 5c 0a 20 20 20 20 20 7c 7c 20 64  BUG) \.     || d
2890: 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52 4f 46  efined(VDBE_PROF
28a0: 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e 65 64 28  ILE) || defined(
28b0: 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 2f 2a  SQLITE_DEBUG)./*
28c0: 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 61 20 73 74  .** Compute a st
28d0: 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 69  ring that descri
28e0: 62 65 73 20 74 68 65 20 50 33 20 70 61 72 61 6d  bes the P3 param
28f0: 65 74 65 72 20 66 6f 72 20 61 6e 20 6f 70 63 6f  eter for an opco
2900: 64 65 2e 0a 2a 2a 20 55 73 65 20 7a 54 65 6d 70  de..** Use zTemp
2910: 20 66 6f 72 20 61 6e 79 20 72 65 71 75 69 72 65   for any require
2920: 64 20 74 65 6d 70 6f 72 61 72 79 20 62 75 66 66  d temporary buff
2930: 65 72 20 73 70 61 63 65 2e 0a 2a 2f 0a 73 74 61  er space..*/.sta
2940: 74 69 63 20 63 68 61 72 20 2a 64 69 73 70 6c 61  tic char *displa
2950: 79 50 33 28 4f 70 20 2a 70 4f 70 2c 20 63 68 61  yP3(Op *pOp, cha
2960: 72 20 2a 7a 54 65 6d 70 2c 20 69 6e 74 20 6e 54  r *zTemp, int nT
2970: 65 6d 70 29 7b 0a 20 20 63 68 61 72 20 2a 7a 50  emp){.  char *zP
2980: 33 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 54 65  3;.  assert( nTe
2990: 6d 70 3e 3d 32 30 20 29 3b 0a 20 20 73 77 69 74  mp>=20 );.  swit
29a0: 63 68 28 20 70 4f 70 2d 3e 70 33 74 79 70 65 20  ch( pOp->p3type 
29b0: 29 7b 0a 20 20 20 20 63 61 73 65 20 50 33 5f 50  ){.    case P3_P
29c0: 4f 49 4e 54 45 52 3a 20 7b 0a 20 20 20 20 20 20  OINTER: {.      
29d0: 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22  sprintf(zTemp, "
29e0: 70 74 72 28 25 23 78 29 22 2c 20 28 69 6e 74 29  ptr(%#x)", (int)
29f0: 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20 20 20  pOp->p3);.      
2a00: 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20  zP3 = zTemp;.   
2a10: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
2a20: 20 20 20 20 63 61 73 65 20 50 33 5f 4b 45 59 49      case P3_KEYI
2a30: 4e 46 4f 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74  NFO: {.      int
2a40: 20 69 2c 20 6a 3b 0a 20 20 20 20 20 20 4b 65 79   i, j;.      Key
2a50: 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20 3d  Info *pKeyInfo =
2a60: 20 28 4b 65 79 49 6e 66 6f 2a 29 70 4f 70 2d 3e   (KeyInfo*)pOp->
2a70: 70 33 3b 0a 20 20 20 20 20 20 73 70 72 69 6e 74  p3;.      sprint
2a80: 66 28 7a 54 65 6d 70 2c 20 22 6b 65 79 69 6e 66  f(zTemp, "keyinf
2a90: 6f 28 25 64 22 2c 20 70 4b 65 79 49 6e 66 6f 2d  o(%d", pKeyInfo-
2aa0: 3e 6e 46 69 65 6c 64 29 3b 0a 20 20 20 20 20 20  >nField);.      
2ab0: 69 20 3d 20 73 74 72 6c 65 6e 28 7a 54 65 6d 70  i = strlen(zTemp
2ac0: 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d 30  );.      for(j=0
2ad0: 3b 20 6a 3c 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46  ; j<pKeyInfo->nF
2ae0: 69 65 6c 64 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20  ield; j++){.    
2af0: 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f      CollSeq *pCo
2b00: 6c 6c 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 61  ll = pKeyInfo->a
2b10: 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 20 20 20  Coll[j];.       
2b20: 20 69 66 28 20 70 43 6f 6c 6c 20 29 7b 0a 20 20   if( pColl ){.  
2b30: 20 20 20 20 20 20 20 20 69 6e 74 20 6e 20 3d 20          int n = 
2b40: 73 74 72 6c 65 6e 28 70 43 6f 6c 6c 2d 3e 7a 4e  strlen(pColl->zN
2b50: 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ame);.          
2b60: 69 66 28 20 69 2b 6e 3e 6e 54 65 6d 70 2d 36 20  if( i+n>nTemp-6 
2b70: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73  ){.            s
2b80: 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d 2c  trcpy(&zTemp[i],
2b90: 22 2c 2e 2e 2e 22 29 3b 0a 20 20 20 20 20 20 20  ",...");.       
2ba0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
2bb0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
2bc0: 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20 27    zTemp[i++] = '
2bd0: 2c 27 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66  ,';.          if
2be0: 28 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72  ( pKeyInfo->aSor
2bf0: 74 4f 72 64 65 72 20 26 26 20 70 4b 65 79 49 6e  tOrder && pKeyIn
2c00: 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b 6a  fo->aSortOrder[j
2c10: 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  ] ){.           
2c20: 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20 27 2d   zTemp[i++] = '-
2c30: 27 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20  ';.          }. 
2c40: 20 20 20 20 20 20 20 20 20 73 74 72 63 70 79 28           strcpy(
2c50: 26 7a 54 65 6d 70 5b 69 5d 2c 20 70 43 6f 6c 6c  &zTemp[i], pColl
2c60: 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20  ->zName);.      
2c70: 20 20 20 20 69 20 2b 3d 20 6e 3b 0a 20 20 20 20      i += n;.    
2c80: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 69 2b      }else if( i+
2c90: 34 3c 6e 54 65 6d 70 2d 36 20 29 7b 0a 20 20 20  4<nTemp-6 ){.   
2ca0: 20 20 20 20 20 20 20 73 74 72 63 70 79 28 26 7a         strcpy(&z
2cb0: 54 65 6d 70 5b 69 5d 2c 22 2c 6e 69 6c 22 29 3b  Temp[i],",nil");
2cc0: 0a 20 20 20 20 20 20 20 20 20 20 69 20 2b 3d 20  .          i += 
2cd0: 34 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  4;.        }.   
2ce0: 20 20 20 7d 0a 20 20 20 20 20 20 7a 54 65 6d 70     }.      zTemp
2cf0: 5b 69 2b 2b 5d 20 3d 20 27 29 27 3b 0a 20 20 20  [i++] = ')';.   
2d00: 20 20 20 7a 54 65 6d 70 5b 69 5d 20 3d 20 30 3b     zTemp[i] = 0;
2d10: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69  .      assert( i
2d20: 3c 6e 54 65 6d 70 20 29 3b 0a 20 20 20 20 20 20  <nTemp );.      
2d30: 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20  zP3 = zTemp;.   
2d40: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
2d50: 20 20 20 20 63 61 73 65 20 50 33 5f 43 4f 4c 4c      case P3_COLL
2d60: 53 45 51 3a 20 7b 0a 20 20 20 20 20 20 43 6f 6c  SEQ: {.      Col
2d70: 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28 43  lSeq *pColl = (C
2d80: 6f 6c 6c 53 65 71 2a 29 70 4f 70 2d 3e 70 33 3b  ollSeq*)pOp->p3;
2d90: 0a 20 20 20 20 20 20 73 70 72 69 6e 74 66 28 7a  .      sprintf(z
2da0: 54 65 6d 70 2c 20 22 63 6f 6c 6c 73 65 71 28 25  Temp, "collseq(%
2db0: 2e 32 30 73 29 22 2c 20 70 43 6f 6c 6c 2d 3e 7a  .20s)", pColl->z
2dc0: 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 7a 50 33  Name);.      zP3
2dd0: 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20 20 20 20   = zTemp;.      
2de0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20  break;.    }.   
2df0: 20 63 61 73 65 20 50 33 5f 46 55 4e 43 44 45 46   case P3_FUNCDEF
2e00: 3a 20 7b 0a 20 20 20 20 20 20 46 75 6e 63 44 65  : {.      FuncDe
2e10: 66 20 2a 70 44 65 66 20 3d 20 28 46 75 6e 63 44  f *pDef = (FuncD
2e20: 65 66 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20  ef*)pOp->p3;.   
2e30: 20 20 20 63 68 61 72 20 7a 4e 75 6d 5b 33 30 5d     char zNum[30]
2e40: 3b 0a 20 20 20 20 20 20 73 70 72 69 6e 74 66 28  ;.      sprintf(
2e50: 7a 54 65 6d 70 2c 20 22 25 2e 2a 73 22 2c 20 6e  zTemp, "%.*s", n
2e60: 54 65 6d 70 2c 20 70 44 65 66 2d 3e 7a 4e 61 6d  Temp, pDef->zNam
2e70: 65 29 3b 0a 20 20 20 20 20 20 73 70 72 69 6e 74  e);.      sprint
2e80: 66 28 7a 4e 75 6d 2c 22 28 25 64 29 22 2c 20 70  f(zNum,"(%d)", p
2e90: 44 65 66 2d 3e 6e 41 72 67 29 3b 0a 20 20 20 20  Def->nArg);.    
2ea0: 20 20 69 66 28 20 73 74 72 6c 65 6e 28 7a 54 65    if( strlen(zTe
2eb0: 6d 70 29 2b 73 74 72 6c 65 6e 28 7a 4e 75 6d 29  mp)+strlen(zNum)
2ec0: 2b 31 3c 3d 6e 54 65 6d 70 20 29 7b 0a 20 20 20  +1<=nTemp ){.   
2ed0: 20 20 20 20 20 73 74 72 63 61 74 28 7a 54 65 6d       strcat(zTem
2ee0: 70 2c 20 7a 4e 75 6d 29 3b 0a 20 20 20 20 20 20  p, zNum);.      
2ef0: 7d 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54  }.      zP3 = zT
2f00: 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  emp;.      break
2f10: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61  ;.    }.    defa
2f20: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 7a 50 33  ult: {.      zP3
2f30: 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20   = pOp->p3;.    
2f40: 20 20 69 66 28 20 7a 50 33 3d 3d 30 20 7c 7c 20    if( zP3==0 || 
2f50: 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f  pOp->opcode==OP_
2f60: 4e 6f 6f 70 20 29 7b 0a 20 20 20 20 20 20 20 20  Noop ){.        
2f70: 7a 50 33 20 3d 20 22 22 3b 0a 20 20 20 20 20 20  zP3 = "";.      
2f80: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  }.    }.  }.  re
2f90: 74 75 72 6e 20 7a 50 33 3b 0a 7d 0a 23 65 6e 64  turn zP3;.}.#end
2fa0: 69 66 0a 0a 0a 23 69 66 20 64 65 66 69 6e 65 64  if...#if defined
2fb0: 28 56 44 42 45 5f 50 52 4f 46 49 4c 45 29 20 7c  (VDBE_PROFILE) |
2fc0: 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45  | defined(SQLITE
2fd0: 5f 44 45 42 55 47 29 0a 2f 2a 0a 2a 2a 20 50 72  _DEBUG)./*.** Pr
2fe0: 69 6e 74 20 61 20 73 69 6e 67 6c 65 20 6f 70 63  int a single opc
2ff0: 6f 64 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69  ode.  This routi
3000: 6e 65 20 69 73 20 75 73 65 64 20 66 6f 72 20 64  ne is used for d
3010: 65 62 75 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a  ebugging only..*
3020: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
3030: 62 65 50 72 69 6e 74 4f 70 28 46 49 4c 45 20 2a  bePrintOp(FILE *
3040: 70 4f 75 74 2c 20 69 6e 74 20 70 63 2c 20 4f 70  pOut, int pc, Op
3050: 20 2a 70 4f 70 29 7b 0a 20 20 63 68 61 72 20 2a   *pOp){.  char *
3060: 7a 50 33 3b 0a 20 20 63 68 61 72 20 7a 50 74 72  zP3;.  char zPtr
3070: 5b 35 30 5d 3b 0a 20 20 73 74 61 74 69 63 20 63  [50];.  static c
3080: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 6f 72 6d  onst char *zForm
3090: 61 74 31 20 3d 20 22 25 34 64 20 25 2d 31 33 73  at1 = "%4d %-13s
30a0: 20 25 34 64 20 25 34 64 20 25 73 5c 6e 22 3b 0a   %4d %4d %s\n";.
30b0: 20 20 69 66 28 20 70 4f 75 74 3d 3d 30 20 29 20    if( pOut==0 ) 
30c0: 70 4f 75 74 20 3d 20 73 74 64 6f 75 74 3b 0a 20  pOut = stdout;. 
30d0: 20 7a 50 33 20 3d 20 64 69 73 70 6c 61 79 50 33   zP3 = displayP3
30e0: 28 70 4f 70 2c 20 7a 50 74 72 2c 20 73 69 7a 65  (pOp, zPtr, size
30f0: 6f 66 28 7a 50 74 72 29 29 3b 0a 20 20 66 70 72  of(zPtr));.  fpr
3100: 69 6e 74 66 28 70 4f 75 74 2c 20 7a 46 6f 72 6d  intf(pOut, zForm
3110: 61 74 31 2c 0a 20 20 20 20 20 20 70 63 2c 20 73  at1,.      pc, s
3120: 71 6c 69 74 65 33 4f 70 63 6f 64 65 4e 61 6d 65  qlite3OpcodeName
3130: 73 5b 70 4f 70 2d 3e 6f 70 63 6f 64 65 5d 2c 20  s[pOp->opcode], 
3140: 70 4f 70 2d 3e 70 31 2c 20 70 4f 70 2d 3e 70 32  pOp->p1, pOp->p2
3150: 2c 20 7a 50 33 29 3b 0a 20 20 66 66 6c 75 73 68  , zP3);.  fflush
3160: 28 70 4f 75 74 29 3b 0a 7d 0a 23 65 6e 64 69 66  (pOut);.}.#endif
3170: 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20  ../*.** Release 
3180: 61 6e 20 61 72 72 61 79 20 6f 66 20 4e 20 4d 65  an array of N Me
3190: 6d 20 65 6c 65 6d 65 6e 74 73 0a 2a 2f 0a 73 74  m elements.*/.st
31a0: 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73  atic void releas
31b0: 65 4d 65 6d 41 72 72 61 79 28 4d 65 6d 20 2a 70  eMemArray(Mem *p
31c0: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 69 66 28 20  , int N){.  if( 
31d0: 70 20 29 7b 0a 20 20 20 20 77 68 69 6c 65 28 20  p ){.    while( 
31e0: 4e 2d 2d 3e 30 20 29 7b 0a 20 20 20 20 20 20 73  N-->0 ){.      s
31f0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
3200: 65 61 73 65 28 70 2b 2b 29 3b 0a 20 20 20 20 7d  ease(p++);.    }
3210: 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66 20  .  }.}..#ifndef 
3220: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c  SQLITE_OMIT_EXPL
3230: 41 49 4e 0a 2f 2a 0a 2a 2a 20 47 69 76 65 20 61  AIN./*.** Give a
3240: 20 6c 69 73 74 69 6e 67 20 6f 66 20 74 68 65 20   listing of the 
3250: 70 72 6f 67 72 61 6d 20 69 6e 20 74 68 65 20 76  program in the v
3260: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 0a  irtual machine..
3270: 2a 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 72 66  **.** The interf
3280: 61 63 65 20 69 73 20 74 68 65 20 73 61 6d 65 20  ace is the same 
3290: 61 73 20 73 71 6c 69 74 65 33 56 64 62 65 45 78  as sqlite3VdbeEx
32a0: 65 63 28 29 2e 20 20 42 75 74 20 69 6e 73 74 65  ec().  But inste
32b0: 61 64 20 6f 66 0a 2a 2a 20 72 75 6e 6e 69 6e 67  ad of.** running
32c0: 20 74 68 65 20 63 6f 64 65 2c 20 69 74 20 69 6e   the code, it in
32d0: 76 6f 6b 65 73 20 74 68 65 20 63 61 6c 6c 62 61  vokes the callba
32e0: 63 6b 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68  ck once for each
32f0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a   instruction..**
3300: 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 73   This feature is
3310: 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65   used to impleme
3320: 6e 74 20 22 45 58 50 4c 41 49 4e 22 2e 0a 2a 2f  nt "EXPLAIN"..*/
3330: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
3340: 4c 69 73 74 28 0a 20 20 56 64 62 65 20 2a 70 20  List(.  Vdbe *p 
3350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3360: 20 20 2f 2a 20 54 68 65 20 56 44 42 45 20 2a 2f    /* The VDBE */
3370: 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  .){.  sqlite3 *d
3380: 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69 6e 74  b = p->db;.  int
3390: 20 69 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53   i;.  int rc = S
33a0: 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73  QLITE_OK;..  ass
33b0: 65 72 74 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20  ert( p->explain 
33c0: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69  );.  if( p->magi
33d0: 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c!=VDBE_MAGIC_RU
33e0: 4e 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54  N ) return SQLIT
33f0: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 61 73 73 65  E_MISUSE;.  asse
3400: 72 74 28 20 64 62 2d 3e 6d 61 67 69 63 3d 3d 53  rt( db->magic==S
3410: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59  QLITE_MAGIC_BUSY
3420: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d   );.  assert( p-
3430: 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c  >rc==SQLITE_OK |
3440: 7c 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f  | p->rc==SQLITE_
3450: 42 55 53 59 20 29 3b 0a 0a 20 20 2f 2a 20 45 76  BUSY );..  /* Ev
3460: 65 6e 20 74 68 6f 75 67 68 20 74 68 69 73 20 6f  en though this o
3470: 70 63 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 70  pcode does not p
3480: 75 74 20 64 79 6e 61 6d 69 63 20 73 74 72 69 6e  ut dynamic strin
3490: 67 73 20 6f 6e 74 6f 20 74 68 65 0a 20 20 2a 2a  gs onto the.  **
34a0: 20 74 68 65 20 73 74 61 63 6b 2c 20 74 68 65 79   the stack, they
34b0: 20 6d 61 79 20 62 65 63 6f 6d 65 20 64 79 6e 61   may become dyna
34c0: 6d 69 63 20 69 66 20 74 68 65 20 75 73 65 72 20  mic if the user 
34d0: 63 61 6c 6c 73 0a 20 20 2a 2a 20 73 71 6c 69 74  calls.  ** sqlit
34e0: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36  e3_column_text16
34f0: 28 29 2c 20 63 61 75 73 69 6e 67 20 61 20 74 72  (), causing a tr
3500: 61 6e 73 6c 61 74 69 6f 6e 20 74 6f 20 55 54 46  anslation to UTF
3510: 2d 31 36 20 65 6e 63 6f 64 69 6e 67 2e 0a 20 20  -16 encoding..  
3520: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 54 6f 73  */.  if( p->pTos
3530: 3d 3d 26 70 2d 3e 61 53 74 61 63 6b 5b 34 5d 20  ==&p->aStack[4] 
3540: 29 7b 0a 20 20 20 20 72 65 6c 65 61 73 65 4d 65  ){.    releaseMe
3550: 6d 41 72 72 61 79 28 70 2d 3e 61 53 74 61 63 6b  mArray(p->aStack
3560: 2c 20 35 29 3b 0a 20 20 7d 0a 20 20 70 2d 3e 72  , 5);.  }.  p->r
3570: 65 73 4f 6e 53 74 61 63 6b 20 3d 20 30 3b 0a 0a  esOnStack = 0;..
3580: 0a 20 20 69 20 3d 20 70 2d 3e 70 63 2b 2b 3b 0a  .  i = p->pc++;.
3590: 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4f 70 20    if( i>=p->nOp 
35a0: 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53  ){.    p->rc = S
35b0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 72 63  QLITE_OK;.    rc
35c0: 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a   = SQLITE_DONE;.
35d0: 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e    }else if( db->
35e0: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49  flags & SQLITE_I
35f0: 6e 74 65 72 72 75 70 74 20 29 7b 0a 20 20 20 20  nterrupt ){.    
3600: 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51  db->flags &= ~SQ
3610: 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b 0a  LITE_Interrupt;.
3620: 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49      p->rc = SQLI
3630: 54 45 5f 49 4e 54 45 52 52 55 50 54 3b 0a 20 20  TE_INTERRUPT;.  
3640: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52    rc = SQLITE_ER
3650: 52 4f 52 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ROR;.    sqlite3
3660: 53 65 74 53 74 72 69 6e 67 28 26 70 2d 3e 7a 45  SetString(&p->zE
3670: 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 33 45 72  rrMsg, sqlite3Er
3680: 72 53 74 72 28 70 2d 3e 72 63 29 2c 20 28 63 68  rStr(p->rc), (ch
3690: 61 72 2a 29 30 29 3b 0a 20 20 7d 65 6c 73 65 7b  ar*)0);.  }else{
36a0: 0a 20 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26  .    Op *pOp = &
36b0: 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 4d  p->aOp[i];.    M
36c0: 65 6d 20 2a 70 4d 65 6d 20 3d 20 70 2d 3e 61 53  em *pMem = p->aS
36d0: 74 61 63 6b 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  tack;.    pMem->
36e0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b  flags = MEM_Int;
36f0: 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20  .    pMem->type 
3700: 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52  = SQLITE_INTEGER
3710: 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20  ;.    pMem->i = 
3720: 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  i;              
3730: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3740: 20 20 2f 2a 20 50 72 6f 67 72 61 6d 20 63 6f 75    /* Program cou
3750: 6e 74 65 72 20 2a 2f 0a 20 20 20 20 70 4d 65 6d  nter */.    pMem
3760: 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66  ++;..    pMem->f
3770: 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 74 61 74 69  lags = MEM_Stati
3780: 63 7c 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 54 65  c|MEM_Str|MEM_Te
3790: 72 6d 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a 20  rm;.    pMem->z 
37a0: 3d 20 73 71 6c 69 74 65 33 4f 70 63 6f 64 65 4e  = sqlite3OpcodeN
37b0: 61 6d 65 73 5b 70 4f 70 2d 3e 6f 70 63 6f 64 65  ames[pOp->opcode
37c0: 5d 3b 20 20 2f 2a 20 4f 70 63 6f 64 65 20 2a 2f  ];  /* Opcode */
37d0: 0a 20 20 20 20 70 4d 65 6d 2d 3e 6e 20 3d 20 73  .    pMem->n = s
37e0: 74 72 6c 65 6e 28 70 4d 65 6d 2d 3e 7a 29 3b 0a  trlen(pMem->z);.
37f0: 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d      pMem->type =
3800: 20 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20 20   SQLITE_TEXT;.  
3810: 20 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20 53 51    pMem->enc = SQ
3820: 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20 20 20 70  LITE_UTF8;.    p
3830: 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d  Mem++;..    pMem
3840: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
3850: 74 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d  t;.    pMem->i =
3860: 20 70 4f 70 2d 3e 70 31 3b 20 20 20 20 20 20 20   pOp->p1;       
3870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3880: 20 20 20 2f 2a 20 50 31 20 2a 2f 0a 20 20 20 20     /* P1 */.    
3890: 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c  pMem->type = SQL
38a0: 49 54 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20  ITE_INTEGER;.   
38b0: 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d   pMem++;..    pM
38c0: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
38d0: 49 6e 74 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 69  Int;.    pMem->i
38e0: 20 3d 20 70 4f 70 2d 3e 70 32 3b 20 20 20 20 20   = pOp->p2;     
38f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3900: 20 20 20 20 20 2f 2a 20 50 32 20 2a 2f 0a 20 20       /* P2 */.  
3910: 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53    pMem->type = S
3920: 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b 0a 20  QLITE_INTEGER;. 
3930: 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20     pMem++;..    
3940: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
3950: 4d 5f 53 68 6f 72 74 7c 4d 45 4d 5f 53 74 72 7c  M_Short|MEM_Str|
3960: 4d 45 4d 5f 54 65 72 6d 3b 20 20 20 2f 2a 20 50  MEM_Term;   /* P
3970: 33 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a  3 */.    pMem->z
3980: 20 3d 20 64 69 73 70 6c 61 79 50 33 28 70 4f 70   = displayP3(pOp
3990: 2c 20 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 2c 20  , pMem->zShort, 
39a0: 73 69 7a 65 6f 66 28 70 4d 65 6d 2d 3e 7a 53 68  sizeof(pMem->zSh
39b0: 6f 72 74 29 29 3b 0a 20 20 20 20 70 4d 65 6d 2d  ort));.    pMem-
39c0: 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 54  >type = SQLITE_T
39d0: 45 58 54 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 65  EXT;.    pMem->e
39e0: 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38  nc = SQLITE_UTF8
39f0: 3b 0a 0a 20 20 20 20 70 2d 3e 6e 52 65 73 43 6f  ;..    p->nResCo
3a00: 6c 75 6d 6e 20 3d 20 35 3b 0a 20 20 20 20 70 2d  lumn = 5;.    p-
3a10: 3e 70 54 6f 73 20 3d 20 70 4d 65 6d 3b 0a 20 20  >pTos = pMem;.  
3a20: 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45    p->rc = SQLITE
3a30: 5f 4f 4b 3b 0a 20 20 20 20 70 2d 3e 72 65 73 4f  _OK;.    p->resO
3a40: 6e 53 74 61 63 6b 20 3d 20 31 3b 0a 20 20 20 20  nStack = 1;.    
3a50: 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 4f 57 3b  rc = SQLITE_ROW;
3a60: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
3a70: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
3a80: 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49  LITE_OMIT_EXPLAI
3a90: 4e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 50 72 69 6e  N */../*.** Prin
3aa0: 74 20 74 68 65 20 53 51 4c 20 74 68 61 74 20 77  t the SQL that w
3ab0: 61 73 20 75 73 65 64 20 74 6f 20 67 65 6e 65 72  as used to gener
3ac0: 61 74 65 20 61 20 56 44 42 45 20 70 72 6f 67 72  ate a VDBE progr
3ad0: 61 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  am..*/.void sqli
3ae0: 74 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c 28  te3VdbePrintSql(
3af0: 56 64 62 65 20 2a 70 29 7b 0a 23 69 66 64 65 66  Vdbe *p){.#ifdef
3b00: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20   SQLITE_DEBUG.  
3b10: 69 6e 74 20 6e 4f 70 20 3d 20 70 2d 3e 6e 4f 70  int nOp = p->nOp
3b20: 3b 0a 20 20 56 64 62 65 4f 70 20 2a 70 4f 70 3b  ;.  VdbeOp *pOp;
3b30: 0a 20 20 69 66 28 20 6e 4f 70 3c 31 20 29 20 72  .  if( nOp<1 ) r
3b40: 65 74 75 72 6e 3b 0a 20 20 70 4f 70 20 3d 20 26  eturn;.  pOp = &
3b50: 70 2d 3e 61 4f 70 5b 6e 4f 70 2d 31 5d 3b 0a 20  p->aOp[nOp-1];. 
3b60: 20 69 66 28 20 70 4f 70 2d 3e 6f 70 63 6f 64 65   if( pOp->opcode
3b70: 3d 3d 4f 50 5f 4e 6f 6f 70 20 26 26 20 70 4f 70  ==OP_Noop && pOp
3b80: 2d 3e 70 33 21 3d 30 20 29 7b 0a 20 20 20 20 63  ->p3!=0 ){.    c
3b90: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 70  onst char *z = p
3ba0: 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 77 68 69 6c  Op->p3;.    whil
3bb0: 65 28 20 69 73 73 70 61 63 65 28 2a 28 75 38 2a  e( isspace(*(u8*
3bc0: 29 7a 29 20 29 20 7a 2b 2b 3b 0a 20 20 20 20 70  )z) ) z++;.    p
3bd0: 72 69 6e 74 66 28 22 53 51 4c 3a 20 5b 25 73 5d  rintf("SQL: [%s]
3be0: 5c 6e 22 2c 20 7a 29 3b 0a 20 20 7d 0a 23 65 6e  \n", z);.  }.#en
3bf0: 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 72 65  dif.}../*.** Pre
3c00: 70 61 72 65 20 61 20 76 69 72 74 75 61 6c 20 6d  pare a virtual m
3c10: 61 63 68 69 6e 65 20 66 6f 72 20 65 78 65 63 75  achine for execu
3c20: 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 6e 76 6f  tion.  This invo
3c30: 6c 76 65 73 20 74 68 69 6e 67 73 20 73 75 63 68  lves things such
3c40: 0a 2a 2a 20 61 73 20 61 6c 6c 6f 63 61 74 69 6e  .** as allocatin
3c50: 67 20 73 74 61 63 6b 20 73 70 61 63 65 20 61 6e  g stack space an
3c60: 64 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74  d initializing t
3c70: 68 65 20 70 72 6f 67 72 61 6d 20 63 6f 75 6e 74  he program count
3c80: 65 72 2e 0a 2a 2a 20 41 66 74 65 72 20 74 68 65  er..** After the
3c90: 20 56 44 42 45 20 68 61 73 20 62 65 20 70 72 65   VDBE has be pre
3ca0: 70 70 65 64 2c 20 69 74 20 63 61 6e 20 62 65 20  pped, it can be 
3cb0: 65 78 65 63 75 74 65 64 20 62 79 20 6f 6e 65 20  executed by one 
3cc0: 6f 72 20 6d 6f 72 65 0a 2a 2a 20 63 61 6c 6c 73  or more.** calls
3cd0: 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65 45   to sqlite3VdbeE
3ce0: 78 65 63 28 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 54  xec().  .**.** T
3cf0: 68 69 73 20 69 73 20 74 68 65 20 6f 6e 6c 79 20  his is the only 
3d00: 77 61 79 20 74 6f 20 6d 6f 76 65 20 61 20 56 44  way to move a VD
3d10: 42 45 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41 47  BE from VDBE_MAG
3d20: 49 43 5f 49 4e 49 54 20 74 6f 0a 2a 2a 20 56 44  IC_INIT to.** VD
3d30: 42 45 5f 4d 41 47 49 43 5f 52 55 4e 2e 0a 2a 2f  BE_MAGIC_RUN..*/
3d40: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
3d50: 65 4d 61 6b 65 52 65 61 64 79 28 0a 20 20 56 64  eMakeReady(.  Vd
3d60: 62 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20  be *p,          
3d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
3d80: 54 68 65 20 56 44 42 45 20 2a 2f 0a 20 20 69 6e  The VDBE */.  in
3d90: 74 20 6e 56 61 72 2c 20 20 20 20 20 20 20 20 20  t nVar,         
3da0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
3db0: 4e 75 6d 62 65 72 20 6f 66 20 27 3f 27 20 73 65  Number of '?' se
3dc0: 65 20 69 6e 20 74 68 65 20 53 51 4c 20 73 74 61  e in the SQL sta
3dd0: 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20  tement */.  int 
3de0: 6e 4d 65 6d 2c 20 20 20 20 20 20 20 20 20 20 20  nMem,           
3df0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
3e00: 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79 20 63  mber of memory c
3e10: 65 6c 6c 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65  ells to allocate
3e20: 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 75 72 73 6f   */.  int nCurso
3e30: 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  r,              
3e40: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
3e50: 66 20 63 75 72 73 6f 72 73 20 74 6f 20 61 6c 6c  f cursors to all
3e60: 6f 63 61 74 65 20 2a 2f 0a 20 20 69 6e 74 20 69  ocate */.  int i
3e70: 73 45 78 70 6c 61 69 6e 20 20 20 20 20 20 20 20  sExplain        
3e80: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75            /* Tru
3e90: 65 20 69 66 20 74 68 65 20 45 58 50 4c 41 49 4e  e if the EXPLAIN
3ea0: 20 6b 65 79 77 6f 72 64 73 20 69 73 20 70 72 65   keywords is pre
3eb0: 73 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  sent */.){.  int
3ec0: 20 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70   n;..  assert( p
3ed0: 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  !=0 );.  assert(
3ee0: 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f   p->magic==VDBE_
3ef0: 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 0a 20  MAGIC_INIT );.. 
3f00: 20 2f 2a 20 54 68 65 72 65 20 73 68 6f 75 6c 64   /* There should
3f10: 20 62 65 20 61 74 20 6c 65 61 73 74 20 6f 6e 65   be at least one
3f20: 20 6f 70 63 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20   opcode..  */.  
3f30: 61 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30  assert( p->nOp>0
3f40: 20 29 3b 0a 0a 20 20 2f 2a 20 4e 6f 20 69 6e 73   );..  /* No ins
3f50: 74 72 75 63 74 69 6f 6e 20 65 76 65 72 20 70 75  truction ever pu
3f60: 73 68 65 73 20 6d 6f 72 65 20 74 68 61 6e 20 61  shes more than a
3f70: 20 73 69 6e 67 6c 65 20 65 6c 65 6d 65 6e 74 20   single element 
3f80: 6f 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 73 74  onto the.  ** st
3f90: 61 63 6b 2e 20 20 41 6e 64 20 74 68 65 20 73 74  ack.  And the st
3fa0: 61 63 6b 20 6e 65 76 65 72 20 67 72 6f 77 73 20  ack never grows 
3fb0: 6f 6e 20 73 75 63 63 65 73 73 69 76 65 20 65 78  on successive ex
3fc0: 65 63 75 74 69 6f 6e 73 20 6f 66 20 74 68 65 0a  ecutions of the.
3fd0: 20 20 2a 2a 20 73 61 6d 65 20 6c 6f 6f 70 2e 20    ** same loop. 
3fe0: 20 53 6f 20 74 68 65 20 74 6f 74 61 6c 20 6e 75   So the total nu
3ff0: 6d 62 65 72 20 6f 66 20 69 6e 73 74 72 75 63 74  mber of instruct
4000: 69 6f 6e 73 20 69 73 20 61 6e 20 75 70 70 65 72  ions is an upper
4010: 20 62 6f 75 6e 64 0a 20 20 2a 2a 20 6f 6e 20 74   bound.  ** on t
4020: 68 65 20 6d 61 78 69 6d 75 6d 20 73 74 61 63 6b  he maximum stack
4030: 20 64 65 70 74 68 20 72 65 71 75 69 72 65 64 2e   depth required.
4040: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 6c 6c 6f 63  .  **.  ** Alloc
4050: 61 74 69 6f 6e 20 61 6c 6c 20 74 68 65 20 73 74  ation all the st
4060: 61 63 6b 20 73 70 61 63 65 20 77 65 20 77 69 6c  ack space we wil
4070: 6c 20 65 76 65 72 20 6e 65 65 64 2e 0a 20 20 2a  l ever need..  *
4080: 2f 0a 20 20 69 66 28 20 70 2d 3e 61 53 74 61 63  /.  if( p->aStac
4090: 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 73 6f  k==0 ){.    reso
40a0: 6c 76 65 50 32 56 61 6c 75 65 73 28 70 29 3b 0a  lveP2Values(p);.
40b0: 20 20 20 20 61 73 73 65 72 74 28 20 6e 56 61 72      assert( nVar
40c0: 3e 3d 30 20 29 3b 0a 20 20 20 20 6e 20 3d 20 69  >=0 );.    n = i
40d0: 73 45 78 70 6c 61 69 6e 20 3f 20 31 30 20 3a 20  sExplain ? 10 : 
40e0: 70 2d 3e 6e 4f 70 3b 0a 20 20 20 20 70 2d 3e 61  p->nOp;.    p->a
40f0: 53 74 61 63 6b 20 3d 20 73 71 6c 69 74 65 4d 61  Stack = sqliteMa
4100: 6c 6c 6f 63 28 0a 20 20 20 20 20 20 20 20 6e 2a  lloc(.        n*
4110: 73 69 7a 65 6f 66 28 70 2d 3e 61 53 74 61 63 6b  sizeof(p->aStack
4120: 5b 30 5d 29 20 20 20 20 20 20 20 20 20 2f 2a 20  [0])         /* 
4130: 61 53 74 61 63 6b 20 2a 2f 0a 20 20 20 20 20 20  aStack */.      
4140: 2b 20 6e 2a 73 69 7a 65 6f 66 28 4d 65 6d 2a 29  + n*sizeof(Mem*)
4150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4160: 20 2f 2a 20 61 70 41 72 67 20 2a 2f 0a 20 20 20   /* apArg */.   
4170: 20 20 20 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66     + nVar*sizeof
4180: 28 4d 65 6d 29 20 20 20 20 20 20 20 20 20 20 20  (Mem)           
4190: 20 20 20 20 2f 2a 20 61 56 61 72 20 2a 2f 0a 20      /* aVar */. 
41a0: 20 20 20 20 20 2b 20 6e 56 61 72 2a 73 69 7a 65       + nVar*size
41b0: 6f 66 28 63 68 61 72 2a 29 20 20 20 20 20 20 20  of(char*)       
41c0: 20 20 20 20 20 20 2f 2a 20 61 7a 56 61 72 20 2a        /* azVar *
41d0: 2f 0a 20 20 20 20 20 20 2b 20 6e 4d 65 6d 2a 73  /.      + nMem*s
41e0: 69 7a 65 6f 66 28 4d 65 6d 29 20 20 20 20 20 20  izeof(Mem)      
41f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 61 4d 65 6d           /* aMem
4200: 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 43 75 72   */.      + nCur
4210: 73 6f 72 2a 73 69 7a 65 6f 66 28 43 75 72 73 6f  sor*sizeof(Curso
4220: 72 2a 29 20 20 20 20 20 20 20 20 2f 2a 20 61 70  r*)        /* ap
4230: 43 73 72 20 2a 2f 0a 20 20 20 20 29 3b 0a 20 20  Csr */.    );.  
4240: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 5f 6d    if( !sqlite3_m
4250: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a  alloc_failed ){.
4260: 20 20 20 20 20 20 70 2d 3e 61 4d 65 6d 20 3d 20        p->aMem = 
4270: 26 70 2d 3e 61 53 74 61 63 6b 5b 6e 5d 3b 0a 20  &p->aStack[n];. 
4280: 20 20 20 20 20 70 2d 3e 6e 4d 65 6d 20 3d 20 6e       p->nMem = n
4290: 4d 65 6d 3b 0a 20 20 20 20 20 20 70 2d 3e 61 56  Mem;.      p->aV
42a0: 61 72 20 3d 20 26 70 2d 3e 61 4d 65 6d 5b 6e 4d  ar = &p->aMem[nM
42b0: 65 6d 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 56  em];.      p->nV
42c0: 61 72 20 3d 20 6e 56 61 72 3b 0a 20 20 20 20 20  ar = nVar;.     
42d0: 20 70 2d 3e 6f 6b 56 61 72 20 3d 20 30 3b 0a 20   p->okVar = 0;. 
42e0: 20 20 20 20 20 70 2d 3e 61 70 41 72 67 20 3d 20       p->apArg = 
42f0: 28 4d 65 6d 2a 2a 29 26 70 2d 3e 61 56 61 72 5b  (Mem**)&p->aVar[
4300: 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20 70 2d 3e  nVar];.      p->
4310: 61 7a 56 61 72 20 3d 20 28 63 68 61 72 2a 2a 29  azVar = (char**)
4320: 26 70 2d 3e 61 70 41 72 67 5b 6e 5d 3b 0a 20 20  &p->apArg[n];.  
4330: 20 20 20 20 70 2d 3e 61 70 43 73 72 20 3d 20 28      p->apCsr = (
4340: 43 75 72 73 6f 72 2a 2a 29 26 70 2d 3e 61 7a 56  Cursor**)&p->azV
4350: 61 72 5b 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20  ar[nVar];.      
4360: 70 2d 3e 6e 43 75 72 73 6f 72 20 3d 20 6e 43 75  p->nCursor = nCu
4370: 72 73 6f 72 3b 0a 20 20 20 20 20 20 66 6f 72 28  rsor;.      for(
4380: 6e 3d 30 3b 20 6e 3c 6e 56 61 72 3b 20 6e 2b 2b  n=0; n<nVar; n++
4390: 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 61 56  ){.        p->aV
43a0: 61 72 5b 6e 5d 2e 66 6c 61 67 73 20 3d 20 4d 45  ar[n].flags = ME
43b0: 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 7d 0a  M_Null;.      }.
43c0: 20 20 20 20 20 20 66 6f 72 28 6e 3d 30 3b 20 6e        for(n=0; n
43d0: 3c 6e 4d 65 6d 3b 20 6e 2b 2b 29 7b 0a 20 20 20  <nMem; n++){.   
43e0: 20 20 20 20 20 70 2d 3e 61 4d 65 6d 5b 6e 5d 2e       p->aMem[n].
43f0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
4400: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
4410: 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49    }..#ifdef SQLI
4420: 54 45 5f 44 45 42 55 47 0a 20 20 69 66 28 20 28  TE_DEBUG.  if( (
4430: 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  p->db->flags & S
4440: 51 4c 49 54 45 5f 56 64 62 65 4c 69 73 74 69 6e  QLITE_VdbeListin
4450: 67 29 21 3d 30 0a 20 20 20 20 7c 7c 20 73 71 6c  g)!=0.    || sql
4460: 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73  ite3OsFileExists
4470: 28 22 76 64 62 65 5f 65 78 70 6c 61 69 6e 22 29  ("vdbe_explain")
4480: 0a 20 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b  .  ){.    int i;
4490: 0a 20 20 20 20 70 72 69 6e 74 66 28 22 56 44 42  .    printf("VDB
44a0: 45 20 50 72 6f 67 72 61 6d 20 4c 69 73 74 69 6e  E Program Listin
44b0: 67 3a 5c 6e 22 29 3b 0a 20 20 20 20 73 71 6c 69  g:\n");.    sqli
44c0: 74 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c 28  te3VdbePrintSql(
44d0: 70 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b  p);.    for(i=0;
44e0: 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b   i<p->nOp; i++){
44f0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
4500: 62 65 50 72 69 6e 74 4f 70 28 73 74 64 6f 75 74  bePrintOp(stdout
4510: 2c 20 69 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29  , i, &p->aOp[i])
4520: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66  ;.    }.  }.  if
4530: 28 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45  ( sqlite3OsFileE
4540: 78 69 73 74 73 28 22 76 64 62 65 5f 74 72 61 63  xists("vdbe_trac
4550: 65 22 29 20 29 7b 0a 20 20 20 20 70 2d 3e 74 72  e") ){.    p->tr
4560: 61 63 65 20 3d 20 73 74 64 6f 75 74 3b 0a 20 20  ace = stdout;.  
4570: 7d 0a 23 65 6e 64 69 66 0a 20 20 70 2d 3e 70 54  }.#endif.  p->pT
4580: 6f 73 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b  os = &p->aStack[
4590: 2d 31 5d 3b 0a 20 20 70 2d 3e 70 63 20 3d 20 2d  -1];.  p->pc = -
45a0: 31 3b 0a 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c  1;.  p->rc = SQL
45b0: 49 54 45 5f 4f 4b 3b 0a 20 20 70 2d 3e 75 6e 69  ITE_OK;.  p->uni
45c0: 71 75 65 43 6e 74 20 3d 20 30 3b 0a 20 20 70 2d  queCnt = 0;.  p-
45d0: 3e 72 65 74 75 72 6e 44 65 70 74 68 20 3d 20 30  >returnDepth = 0
45e0: 3b 0a 20 20 70 2d 3e 65 72 72 6f 72 41 63 74 69  ;.  p->errorActi
45f0: 6f 6e 20 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20  on = OE_Abort;. 
4600: 20 70 2d 3e 70 6f 70 53 74 61 63 6b 20 3d 20 20   p->popStack =  
4610: 30 3b 0a 20 20 70 2d 3e 65 78 70 6c 61 69 6e 20  0;.  p->explain 
4620: 7c 3d 20 69 73 45 78 70 6c 61 69 6e 3b 0a 20 20  |= isExplain;.  
4630: 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f  p->magic = VDBE_
4640: 4d 41 47 49 43 5f 52 55 4e 3b 0a 20 20 70 2d 3e  MAGIC_RUN;.  p->
4650: 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 23 69 66  nChange = 0;.#if
4660: 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45  def VDBE_PROFILE
4670: 0a 20 20 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a  .  {.    int i;.
4680: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
4690: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nOp; i++){.   
46a0: 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74     p->aOp[i].cnt
46b0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d 3e 61   = 0;.      p->a
46c0: 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 20 3d 20 30  Op[i].cycles = 0
46d0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64  ;.    }.  }.#end
46e0: 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d  if.}.../*.** Rem
46f0: 6f 76 65 20 61 6e 79 20 65 6c 65 6d 65 6e 74 73  ove any elements
4700: 20 74 68 61 74 20 72 65 6d 61 69 6e 20 6f 6e 20   that remain on 
4710: 74 68 65 20 73 6f 72 74 65 72 20 66 6f 72 20 74  the sorter for t
4720: 68 65 20 56 44 42 45 20 67 69 76 65 6e 2e 0a 2a  he VDBE given..*
4730: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
4740: 62 65 53 6f 72 74 65 72 52 65 73 65 74 28 56 64  beSorterReset(Vd
4750: 62 65 20 2a 70 29 7b 0a 20 20 77 68 69 6c 65 28  be *p){.  while(
4760: 20 70 2d 3e 70 53 6f 72 74 20 29 7b 0a 20 20 20   p->pSort ){.   
4770: 20 53 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72   Sorter *pSorter
4780: 20 3d 20 70 2d 3e 70 53 6f 72 74 3b 0a 20 20 20   = p->pSort;.   
4790: 20 70 2d 3e 70 53 6f 72 74 20 3d 20 70 53 6f 72   p->pSort = pSor
47a0: 74 65 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  ter->pNext;.    
47b0: 73 71 6c 69 74 65 46 72 65 65 28 70 53 6f 72 74  sqliteFree(pSort
47c0: 65 72 2d 3e 7a 4b 65 79 29 3b 0a 20 20 20 20 73  er->zKey);.    s
47d0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
47e0: 65 61 73 65 28 26 70 53 6f 72 74 65 72 2d 3e 64  ease(&pSorter->d
47f0: 61 74 61 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  ata);.    sqlite
4800: 46 72 65 65 28 70 53 6f 72 74 65 72 29 3b 0a 20  Free(pSorter);. 
4810: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65   }.}../*.** Free
4820: 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 20 61   all resources a
4830: 6c 6c 6f 63 69 61 74 65 64 20 77 69 74 68 20 41  llociated with A
4840: 67 67 45 6c 65 6d 20 70 45 6c 65 6d 2c 20 61 6e  ggElem pElem, an
4850: 20 65 6c 65 6d 65 6e 74 20 6f 66 0a 2a 2a 20 61   element of.** a
4860: 67 67 72 65 67 61 74 65 20 70 41 67 67 2e 0a 2a  ggregate pAgg..*
4870: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 72  /.static void fr
4880: 65 65 41 67 67 45 6c 65 6d 28 41 67 67 45 6c 65  eeAggElem(AggEle
4890: 6d 20 2a 70 45 6c 65 6d 2c 20 41 67 67 20 2a 70  m *pElem, Agg *p
48a0: 41 67 67 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20  Agg){.  int i;. 
48b0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 41 67 67   for(i=0; i<pAgg
48c0: 2d 3e 6e 4d 65 6d 3b 20 69 2b 2b 29 7b 0a 20 20  ->nMem; i++){.  
48d0: 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 26 70    Mem *pMem = &p
48e0: 45 6c 65 6d 2d 3e 61 4d 65 6d 5b 69 5d 3b 0a 20  Elem->aMem[i];. 
48f0: 20 20 20 69 66 28 20 70 41 67 67 2d 3e 61 70 46     if( pAgg->apF
4900: 75 6e 63 20 26 26 20 70 41 67 67 2d 3e 61 70 46  unc && pAgg->apF
4910: 75 6e 63 5b 69 5d 20 26 26 20 28 70 4d 65 6d 2d  unc[i] && (pMem-
4920: 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41 67 67  >flags & MEM_Agg
4930: 43 74 78 29 21 3d 30 20 29 7b 0a 20 20 20 20 20  Ctx)!=0 ){.     
4940: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
4950: 20 63 74 78 3b 0a 20 20 20 20 20 20 63 74 78 2e   ctx;.      ctx.
4960: 70 46 75 6e 63 20 3d 20 70 41 67 67 2d 3e 61 70  pFunc = pAgg->ap
4970: 46 75 6e 63 5b 69 5d 3b 0a 20 20 20 20 20 20 63  Func[i];.      c
4980: 74 78 2e 73 2e 66 6c 61 67 73 20 3d 20 4d 45 4d  tx.s.flags = MEM
4990: 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 63 74 78  _Null;.      ctx
49a0: 2e 70 41 67 67 20 3d 20 70 4d 65 6d 2d 3e 7a 3b  .pAgg = pMem->z;
49b0: 0a 20 20 20 20 20 20 63 74 78 2e 63 6e 74 20 3d  .      ctx.cnt =
49c0: 20 70 4d 65 6d 2d 3e 69 3b 0a 20 20 20 20 20 20   pMem->i;.      
49d0: 63 74 78 2e 69 73 45 72 72 6f 72 20 3d 20 30 3b  ctx.isError = 0;
49e0: 0a 20 20 20 20 20 20 28 2a 63 74 78 2e 70 46 75  .      (*ctx.pFu
49f0: 6e 63 2d 3e 78 46 69 6e 61 6c 69 7a 65 29 28 26  nc->xFinalize)(&
4a00: 63 74 78 29 3b 0a 20 20 20 20 20 20 70 4d 65 6d  ctx);.      pMem
4a10: 2d 3e 7a 20 3d 20 63 74 78 2e 70 41 67 67 3b 0a  ->z = ctx.pAgg;.
4a20: 20 20 20 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e        if( pMem->
4a30: 7a 21 3d 30 20 26 26 20 70 4d 65 6d 2d 3e 7a 21  z!=0 && pMem->z!
4a40: 3d 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 20 29 7b  =pMem->zShort ){
4a50: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 46  .        sqliteF
4a60: 72 65 65 28 70 4d 65 6d 2d 3e 7a 29 3b 0a 20 20  ree(pMem->z);.  
4a70: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69      }.      sqli
4a80: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
4a90: 65 28 26 63 74 78 2e 73 29 3b 0a 20 20 20 20 7d  e(&ctx.s);.    }
4aa0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69  else{.      sqli
4ab0: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
4ac0: 65 28 70 4d 65 6d 29 3b 0a 20 20 20 20 7d 0a 20  e(pMem);.    }. 
4ad0: 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28   }.  sqliteFree(
4ae0: 70 45 6c 65 6d 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  pElem);.}../*.**
4af0: 20 52 65 73 65 74 20 61 6e 20 41 67 67 20 73 74   Reset an Agg st
4b00: 72 75 63 74 75 72 65 2e 20 20 44 65 6c 65 74 65  ructure.  Delete
4b10: 20 61 6c 6c 20 69 74 73 20 63 6f 6e 74 65 6e 74   all its content
4b20: 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 69 6e 73  s..**.** For ins
4b30: 74 61 6c 6c 61 62 6c 65 20 61 67 67 72 65 67 61  tallable aggrega
4b40: 74 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20 69 66  te functions, if
4b50: 20 74 68 65 20 73 74 65 70 20 66 75 6e 63 74 69   the step functi
4b60: 6f 6e 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 63  on has been.** c
4b70: 61 6c 6c 65 64 2c 20 6d 61 6b 65 20 73 75 72 65  alled, make sure
4b80: 20 74 68 65 20 66 69 6e 61 6c 69 7a 65 72 20 66   the finalizer f
4b90: 75 6e 63 74 69 6f 6e 20 68 61 73 20 61 6c 73 6f  unction has also
4ba0: 20 62 65 65 6e 20 63 61 6c 6c 65 64 2e 20 20 54   been called.  T
4bb0: 68 65 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 72 20  he.** finalizer 
4bc0: 6d 69 67 68 74 20 6e 65 65 64 20 74 6f 20 66 72  might need to fr
4bd0: 65 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 77  ee memory that w
4be0: 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 73 20  as allocated as 
4bf0: 70 61 72 74 20 6f 66 20 69 74 73 0a 2a 2a 20 70  part of its.** p
4c00: 72 69 76 61 74 65 20 63 6f 6e 74 65 78 74 2e 20  rivate context. 
4c10: 20 49 66 20 74 68 65 20 66 69 6e 61 6c 69 7a 65   If the finalize
4c20: 72 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 63  r has not been c
4c30: 61 6c 6c 65 64 20 79 65 74 2c 20 63 61 6c 6c 20  alled yet, call 
4c40: 69 74 0a 2a 2a 20 6e 6f 77 2e 0a 2a 2a 0a 2a 2a  it.** now..**.**
4c50: 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20   If db is NULL, 
4c60: 74 68 65 6e 20 74 68 69 73 20 69 73 20 62 65 69  then this is bei
4c70: 6e 67 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73  ng called from s
4c80: 71 6c 69 74 65 56 64 62 65 52 65 73 65 74 28 29  qliteVdbeReset()
4c90: 2e 20 49 6e 0a 2a 2a 20 74 68 69 73 20 63 61 73  . In.** this cas
4ca0: 65 20 63 6c 65 61 6e 20 75 70 20 61 6c 6c 20 72  e clean up all r
4cb0: 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 65  eferences to the
4cc0: 20 74 65 6d 70 2d 74 61 62 6c 65 20 75 73 65 64   temp-table used
4cd0: 20 66 6f 72 0a 2a 2a 20 61 67 67 72 65 67 61 74   for.** aggregat
4ce0: 65 73 20 28 69 66 20 69 74 20 77 61 73 20 65 76  es (if it was ev
4cf0: 65 72 20 6f 70 65 6e 65 64 29 2e 0a 2a 2a 0a 2a  er opened)..**.*
4d00: 2a 20 49 66 20 64 62 20 69 73 20 6e 6f 74 20 4e  * If db is not N
4d10: 55 4c 4c 2c 20 74 68 65 6e 20 74 68 69 73 20 69  ULL, then this i
4d20: 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 20 66  s being called f
4d30: 72 6f 6d 20 77 69 74 68 20 61 6e 20 4f 50 5f 41  rom with an OP_A
4d40: 67 67 52 65 73 65 74 0a 2a 2a 20 6f 70 63 6f 64  ggReset.** opcod
4d50: 65 2e 20 4f 70 65 6e 20 74 68 65 20 74 65 6d 70  e. Open the temp
4d60: 2d 74 61 62 6c 65 2c 20 69 66 20 69 74 20 68 61  -table, if it ha
4d70: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 62 65  s not already be
4d80: 65 6e 20 6f 70 65 6e 65 64 20 61 6e 64 0a 2a 2a  en opened and.**
4d90: 20 64 65 6c 65 74 65 20 74 68 65 20 63 6f 6e 74   delete the cont
4da0: 65 6e 74 73 20 6f 66 20 74 68 65 20 74 61 62 6c  ents of the tabl
4db0: 65 20 75 73 65 64 20 66 6f 72 20 61 67 67 72 65  e used for aggre
4dc0: 67 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  gate information
4dd0: 2c 20 72 65 61 64 79 0a 2a 2a 20 66 6f 72 20 74  , ready.** for t
4de0: 68 65 20 6e 65 78 74 20 72 6f 75 6e 64 20 6f 66  he next round of
4df0: 20 61 67 67 72 65 67 61 74 65 20 70 72 6f 63 65   aggregate proce
4e00: 73 73 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ssing..*/.int sq
4e10: 6c 69 74 65 33 56 64 62 65 41 67 67 52 65 73 65  lite3VdbeAggRese
4e20: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 41  t(sqlite3 *db, A
4e30: 67 67 20 2a 70 41 67 67 2c 20 4b 65 79 49 6e 66  gg *pAgg, KeyInf
4e40: 6f 20 2a 70 4b 65 79 49 6e 66 6f 29 7b 0a 20 20  o *pKeyInfo){.  
4e50: 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20 20 42 74  int rc = 0;.  Bt
4e60: 43 75 72 73 6f 72 20 2a 70 43 73 72 20 3d 20 70  Cursor *pCsr = p
4e70: 41 67 67 2d 3e 70 43 73 72 3b 0a 0a 20 20 61 73  Agg->pCsr;..  as
4e80: 73 65 72 74 28 20 28 70 43 73 72 20 26 26 20 70  sert( (pCsr && p
4e90: 41 67 67 2d 3e 6e 54 61 62 3e 30 29 20 7c 7c 20  Agg->nTab>0) || 
4ea0: 28 21 70 43 73 72 20 26 26 20 70 41 67 67 2d 3e  (!pCsr && pAgg->
4eb0: 6e 54 61 62 3d 3d 30 29 0a 20 20 20 20 20 20 20  nTab==0).       
4ec0: 20 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 61 6c    || sqlite3_mal
4ed0: 6c 6f 63 5f 66 61 69 6c 65 64 20 29 3b 0a 0a 20  loc_failed );.. 
4ee0: 20 2f 2a 20 49 66 20 70 43 73 72 20 69 73 20 6e   /* If pCsr is n
4ef0: 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68  ot NULL, then th
4f00: 65 20 74 61 62 6c 65 20 75 73 65 64 20 66 6f 72  e table used for
4f10: 20 61 67 67 72 65 67 61 74 65 20 69 6e 66 6f 72   aggregate infor
4f20: 6d 61 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 6f  mation.  ** is o
4f30: 70 65 6e 2e 20 4c 6f 6f 70 20 74 68 72 6f 75 67  pen. Loop throug
4f40: 68 20 69 74 20 61 6e 64 20 66 72 65 65 20 74 68  h it and free th
4f50: 65 20 41 67 67 45 6c 65 6d 2a 20 73 74 72 75 63  e AggElem* struc
4f60: 74 75 72 65 20 70 6f 69 6e 74 65 64 20 61 74 0a  ture pointed at.
4f70: 20 20 2a 2a 20 62 79 20 65 61 63 68 20 65 6e 74    ** by each ent
4f80: 72 79 2e 20 49 66 20 74 68 65 20 66 69 6e 61 6c  ry. If the final
4f90: 69 7a 65 72 20 68 61 73 20 6e 6f 74 20 62 65 65  izer has not bee
4fa0: 6e 20 63 61 6c 6c 65 64 20 66 6f 72 20 61 6e 20  n called for an 
4fb0: 41 67 67 45 6c 65 6d 2c 0a 20 20 2a 2a 20 64 6f  AggElem,.  ** do
4fc0: 20 74 68 61 74 20 74 6f 6f 2e 20 46 69 6e 61 6c   that too. Final
4fd0: 6c 79 2c 20 63 6c 65 61 72 20 74 68 65 20 62 74  ly, clear the bt
4fe0: 72 65 65 20 74 61 62 6c 65 20 69 74 73 65 6c 66  ree table itself
4ff0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 43 73  ..  */.  if( pCs
5000: 72 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 65 73  r ){.    int res
5010: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 41  ;.    assert( pA
5020: 67 67 2d 3e 70 42 74 72 65 65 20 29 3b 0a 20 20  gg->pBtree );.  
5030: 20 20 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e    assert( pAgg->
5040: 6e 54 61 62 3e 30 20 29 3b 0a 0a 20 20 20 20 72  nTab>0 );..    r
5050: 63 3d 73 71 6c 69 74 65 33 42 74 72 65 65 46 69  c=sqlite3BtreeFi
5060: 72 73 74 28 70 43 73 72 2c 20 26 72 65 73 29 3b  rst(pCsr, &res);
5070: 0a 20 20 20 20 77 68 69 6c 65 28 20 72 65 73 3d  .    while( res=
5080: 3d 30 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45  =0 && rc==SQLITE
5090: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 41 67 67  _OK ){.      Agg
50a0: 45 6c 65 6d 20 2a 70 45 6c 65 6d 3b 0a 20 20 20  Elem *pElem;.   
50b0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
50c0: 74 72 65 65 44 61 74 61 28 70 43 73 72 2c 20 30  treeData(pCsr, 0
50d0: 2c 20 73 69 7a 65 6f 66 28 41 67 67 45 6c 65 6d  , sizeof(AggElem
50e0: 2a 29 2c 20 28 63 68 61 72 20 2a 29 26 70 45 6c  *), (char *)&pEl
50f0: 65 6d 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  em);.      if( r
5100: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
5110: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72          return r
5120: 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  c;.      }.     
5130: 20 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e 61   assert( pAgg->a
5140: 70 46 75 6e 63 21 3d 30 20 29 3b 0a 20 20 20 20  pFunc!=0 );.    
5150: 20 20 66 72 65 65 41 67 67 45 6c 65 6d 28 70 45    freeAggElem(pE
5160: 6c 65 6d 2c 20 70 41 67 67 29 3b 0a 20 20 20 20  lem, pAgg);.    
5170: 20 20 72 63 3d 73 71 6c 69 74 65 33 42 74 72 65    rc=sqlite3Btre
5180: 65 4e 65 78 74 28 70 43 73 72 2c 20 26 72 65 73  eNext(pCsr, &res
5190: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28  );.    }.    if(
51a0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
51b0: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  {.      return r
51c0: 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73 71  c;.    }..    sq
51d0: 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43  lite3BtreeCloseC
51e0: 75 72 73 6f 72 28 70 43 73 72 29 3b 0a 20 20 20  ursor(pCsr);.   
51f0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65   sqlite3BtreeCle
5200: 61 72 54 61 62 6c 65 28 70 41 67 67 2d 3e 70 42  arTable(pAgg->pB
5210: 74 72 65 65 2c 20 70 41 67 67 2d 3e 6e 54 61 62  tree, pAgg->nTab
5220: 29 3b 0a 20 20 7d 65 6c 73 65 7b 20 0a 20 20 20  );.  }else{ .   
5230: 20 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 20 6d   /* The cursor m
5240: 61 79 20 6e 6f 74 20 62 65 20 6f 70 65 6e 20 62  ay not be open b
5250: 65 63 61 75 73 65 20 74 68 65 20 61 67 67 72 65  ecause the aggre
5260: 67 61 74 6f 72 20 77 61 73 20 6e 65 76 65 72 20  gator was never 
5270: 75 73 65 64 2c 0a 20 20 20 20 2a 2a 20 6f 72 20  used,.    ** or 
5280: 69 74 20 63 6f 75 6c 64 20 62 65 20 74 68 61 74  it could be that
5290: 20 69 74 20 77 61 73 20 75 73 65 64 20 62 75 74   it was used but
52a0: 20 74 68 65 72 65 20 77 61 73 20 6e 6f 20 47 52   there was no GR
52b0: 4f 55 50 20 42 59 20 63 6c 61 75 73 65 2e 0a 20  OUP BY clause.. 
52c0: 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 41     */.    if( pA
52d0: 67 67 2d 3e 70 43 75 72 72 65 6e 74 20 29 7b 0a  gg->pCurrent ){.
52e0: 20 20 20 20 20 20 66 72 65 65 41 67 67 45 6c 65        freeAggEle
52f0: 6d 28 70 41 67 67 2d 3e 70 43 75 72 72 65 6e 74  m(pAgg->pCurrent
5300: 2c 20 70 41 67 67 29 3b 0a 20 20 20 20 7d 0a 20  , pAgg);.    }. 
5310: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 64 62 20 69   }..  /* If db i
5320: 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 77  s not NULL and w
5330: 65 20 68 61 76 65 20 6e 6f 74 20 79 65 74 20 61  e have not yet a
5340: 6e 64 20 77 65 20 68 61 76 65 20 6e 6f 74 20 79  nd we have not y
5350: 65 74 20 6f 70 65 6e 65 64 0a 20 20 2a 2a 20 74  et opened.  ** t
5360: 68 65 20 74 65 6d 70 6f 72 61 72 79 20 62 74 72  he temporary btr
5370: 65 65 20 74 68 65 6e 20 64 6f 20 73 6f 20 61 6e  ee then do so an
5380: 64 20 63 72 65 61 74 65 20 74 68 65 20 74 61 62  d create the tab
5390: 6c 65 20 74 6f 20 73 74 6f 72 65 20 61 67 67 72  le to store aggr
53a0: 65 67 61 74 65 0a 20 20 2a 2a 20 69 6e 66 6f 72  egate.  ** infor
53b0: 6d 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a  mation..  **.  *
53c0: 2a 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c  * If db is NULL,
53d0: 20 74 68 65 6e 20 63 6c 6f 73 65 20 74 68 65 20   then close the 
53e0: 74 65 6d 70 6f 72 61 72 79 20 62 74 72 65 65 20  temporary btree 
53f0: 69 66 20 69 74 20 69 73 20 6f 70 65 6e 2e 0a 20  if it is open.. 
5400: 20 2a 2f 0a 20 20 69 66 28 20 64 62 20 29 7b 0a   */.  if( db ){.
5410: 20 20 20 20 69 66 28 20 21 70 41 67 67 2d 3e 70      if( !pAgg->p
5420: 42 74 72 65 65 20 29 7b 0a 20 20 20 20 20 20 61  Btree ){.      a
5430: 73 73 65 72 74 28 20 70 41 67 67 2d 3e 6e 54 61  ssert( pAgg->nTa
5440: 62 3d 3d 30 20 29 3b 0a 23 69 66 6e 64 65 66 20  b==0 );.#ifndef 
5450: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f  SQLITE_OMIT_MEMO
5460: 52 59 44 42 0a 20 20 20 20 20 20 72 63 20 3d 20  RYDB.      rc = 
5470: 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74  sqlite3BtreeFact
5480: 6f 72 79 28 64 62 2c 20 22 3a 6d 65 6d 6f 72 79  ory(db, ":memory
5490: 3a 22 2c 20 30 2c 20 54 45 4d 50 5f 50 41 47 45  :", 0, TEMP_PAGE
54a0: 53 2c 20 26 70 41 67 67 2d 3e 70 42 74 72 65 65  S, &pAgg->pBtree
54b0: 29 3b 0a 23 65 6c 73 65 0a 20 20 20 20 20 20 72  );.#else.      r
54c0: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
54d0: 46 61 63 74 6f 72 79 28 64 62 2c 20 30 2c 20 30  Factory(db, 0, 0
54e0: 2c 20 54 45 4d 50 5f 50 41 47 45 53 2c 20 26 70  , TEMP_PAGES, &p
54f0: 41 67 67 2d 3e 70 42 74 72 65 65 29 3b 0a 23 65  Agg->pBtree);.#e
5500: 6e 64 69 66 0a 20 20 20 20 20 20 69 66 28 20 72  ndif.      if( r
5510: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
5520: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
5530: 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 69  sqlite3BtreeBegi
5540: 6e 54 72 61 6e 73 28 70 41 67 67 2d 3e 70 42 74  nTrans(pAgg->pBt
5550: 72 65 65 2c 20 31 29 3b 0a 20 20 20 20 20 20 72  ree, 1);.      r
5560: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
5570: 43 72 65 61 74 65 54 61 62 6c 65 28 70 41 67 67  CreateTable(pAgg
5580: 2d 3e 70 42 74 72 65 65 2c 20 26 70 41 67 67 2d  ->pBtree, &pAgg-
5590: 3e 6e 54 61 62 2c 20 30 29 3b 0a 20 20 20 20 20  >nTab, 0);.     
55a0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
55b0: 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  OK ) return rc;.
55c0: 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74      }.    assert
55d0: 28 20 70 41 67 67 2d 3e 6e 54 61 62 21 3d 30 20  ( pAgg->nTab!=0 
55e0: 29 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  );..    rc = sql
55f0: 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 28  ite3BtreeCursor(
5600: 70 41 67 67 2d 3e 70 42 74 72 65 65 2c 20 70 41  pAgg->pBtree, pA
5610: 67 67 2d 3e 6e 54 61 62 2c 20 31 2c 0a 20 20 20  gg->nTab, 1,.   
5620: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
5630: 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 2c 20 70  RecordCompare, p
5640: 4b 65 79 49 6e 66 6f 2c 20 26 70 41 67 67 2d 3e  KeyInfo, &pAgg->
5650: 70 43 73 72 29 3b 0a 20 20 20 20 69 66 28 20 72  pCsr);.    if( r
5660: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
5670: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 65 6c 73  eturn rc;.  }els
5680: 65 7b 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d  e{.    if( pAgg-
5690: 3e 70 42 74 72 65 65 20 29 7b 0a 20 20 20 20 20  >pBtree ){.     
56a0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
56b0: 73 65 28 70 41 67 67 2d 3e 70 42 74 72 65 65 29  se(pAgg->pBtree)
56c0: 3b 0a 20 20 20 20 20 20 70 41 67 67 2d 3e 70 42  ;.      pAgg->pB
56d0: 74 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 20 20  tree = 0;.      
56e0: 70 41 67 67 2d 3e 6e 54 61 62 20 3d 20 30 3b 0a  pAgg->nTab = 0;.
56f0: 20 20 20 20 7d 0a 20 20 20 20 70 41 67 67 2d 3e      }.    pAgg->
5700: 70 43 73 72 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20  pCsr = 0;.  }.. 
5710: 20 69 66 28 20 70 41 67 67 2d 3e 61 70 46 75 6e   if( pAgg->apFun
5720: 63 20 29 7b 20 0a 20 20 20 20 73 71 6c 69 74 65  c ){ .    sqlite
5730: 46 72 65 65 28 70 41 67 67 2d 3e 61 70 46 75 6e  Free(pAgg->apFun
5740: 63 29 3b 0a 20 20 20 20 70 41 67 67 2d 3e 61 70  c);.    pAgg->ap
5750: 46 75 6e 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  Func = 0;.  }.  
5760: 70 41 67 67 2d 3e 70 43 75 72 72 65 6e 74 20 3d  pAgg->pCurrent =
5770: 20 30 3b 0a 20 20 70 41 67 67 2d 3e 6e 4d 65 6d   0;.  pAgg->nMem
5780: 20 3d 20 30 3b 0a 20 20 70 41 67 67 2d 3e 73 65   = 0;.  pAgg->se
5790: 61 72 63 68 69 6e 67 20 3d 20 30 3b 0a 20 20 72  arching = 0;.  r
57a0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
57b0: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74  .}.../*.** Delet
57c0: 65 20 61 20 6b 65 79 6c 69 73 74 0a 2a 2f 0a 76  e a keylist.*/.v
57d0: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 4b  oid sqlite3VdbeK
57e0: 65 79 6c 69 73 74 46 72 65 65 28 4b 65 79 6c 69  eylistFree(Keyli
57f0: 73 74 20 2a 70 29 7b 0a 20 20 77 68 69 6c 65 28  st *p){.  while(
5800: 20 70 20 29 7b 0a 20 20 20 20 4b 65 79 6c 69 73   p ){.    Keylis
5810: 74 20 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e  t *pNext = p->pN
5820: 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 46  ext;.    sqliteF
5830: 72 65 65 28 70 29 3b 0a 20 20 20 20 70 20 3d 20  ree(p);.    p = 
5840: 70 4e 65 78 74 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  pNext;.  }.}../*
5850: 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 75 72 73  .** Close a curs
5860: 6f 72 20 61 6e 64 20 72 65 6c 65 61 73 65 20 61  or and release a
5870: 6c 6c 20 74 68 65 20 72 65 73 6f 75 72 63 65 73  ll the resources
5880: 20 74 68 61 74 20 63 75 72 73 6f 72 20 68 61 70   that cursor hap
5890: 70 65 6e 73 0a 2a 2a 20 74 6f 20 68 6f 6c 64 2e  pens.** to hold.
58a0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
58b0: 56 64 62 65 46 72 65 65 43 75 72 73 6f 72 28 43  VdbeFreeCursor(C
58c0: 75 72 73 6f 72 20 2a 70 43 78 29 7b 0a 20 20 69  ursor *pCx){.  i
58d0: 66 28 20 70 43 78 3d 3d 30 20 29 7b 0a 20 20 20  f( pCx==0 ){.   
58e0: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69   return;.  }.  i
58f0: 66 28 20 70 43 78 2d 3e 70 43 75 72 73 6f 72 20  f( pCx->pCursor 
5900: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74  ){.    sqlite3Bt
5910: 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70  reeCloseCursor(p
5920: 43 78 2d 3e 70 43 75 72 73 6f 72 29 3b 0a 20 20  Cx->pCursor);.  
5930: 7d 0a 20 20 69 66 28 20 70 43 78 2d 3e 70 42 74  }.  if( pCx->pBt
5940: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42   ){.    sqlite3B
5950: 74 72 65 65 43 6c 6f 73 65 28 70 43 78 2d 3e 70  treeClose(pCx->p
5960: 42 74 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  Bt);.  }.  sqlit
5970: 65 46 72 65 65 28 70 43 78 2d 3e 70 44 61 74 61  eFree(pCx->pData
5980: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
5990: 70 43 78 2d 3e 61 54 79 70 65 29 3b 0a 20 20 73  pCx->aType);.  s
59a0: 71 6c 69 74 65 46 72 65 65 28 70 43 78 29 3b 0a  qliteFree(pCx);.
59b0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61  }../*.** Close a
59c0: 6c 6c 20 63 75 72 73 6f 72 73 0a 2a 2f 0a 73 74  ll cursors.*/.st
59d0: 61 74 69 63 20 76 6f 69 64 20 63 6c 6f 73 65 41  atic void closeA
59e0: 6c 6c 43 75 72 73 6f 72 73 28 56 64 62 65 20 2a  llCursors(Vdbe *
59f0: 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  p){.  int i;.  i
5a00: 66 28 20 70 2d 3e 61 70 43 73 72 3d 3d 30 20 29  f( p->apCsr==0 )
5a10: 20 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 69   return;.  for(i
5a20: 3d 30 3b 20 69 3c 70 2d 3e 6e 43 75 72 73 6f 72  =0; i<p->nCursor
5a30: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69  ; i++){.    sqli
5a40: 74 65 33 56 64 62 65 46 72 65 65 43 75 72 73 6f  te3VdbeFreeCurso
5a50: 72 28 70 2d 3e 61 70 43 73 72 5b 69 5d 29 3b 0a  r(p->apCsr[i]);.
5a60: 20 20 20 20 70 2d 3e 61 70 43 73 72 5b 69 5d 20      p->apCsr[i] 
5a70: 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  = 0;.  }.}../*.*
5a80: 2a 20 43 6c 65 61 6e 20 75 70 20 74 68 65 20 56  * Clean up the V
5a90: 4d 20 61 66 74 65 72 20 65 78 65 63 75 74 69 6f  M after executio
5aa0: 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  n..**.** This ro
5ab0: 75 74 69 6e 65 20 77 69 6c 6c 20 61 75 74 6f 6d  utine will autom
5ac0: 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 20 61  atically close a
5ad0: 6e 79 20 63 75 72 73 6f 72 73 2c 20 6c 69 73 74  ny cursors, list
5ae0: 73 2c 20 61 6e 64 2f 6f 72 0a 2a 2a 20 73 6f 72  s, and/or.** sor
5af0: 74 65 72 73 20 74 68 61 74 20 77 65 72 65 20 6c  ters that were l
5b00: 65 66 74 20 6f 70 65 6e 2e 20 20 49 74 20 61 6c  eft open.  It al
5b10: 73 6f 20 64 65 6c 65 74 65 73 20 74 68 65 20 76  so deletes the v
5b20: 61 6c 75 65 73 20 6f 66 0a 2a 2a 20 76 61 72 69  alues of.** vari
5b30: 61 62 6c 65 73 20 69 6e 20 74 68 65 20 61 56 61  ables in the aVa
5b40: 72 5b 5d 20 61 72 72 61 79 2e 0a 2a 2f 0a 73 74  r[] array..*/.st
5b50: 61 74 69 63 20 76 6f 69 64 20 43 6c 65 61 6e 75  atic void Cleanu
5b60: 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  p(Vdbe *p){.  in
5b70: 74 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61 53  t i;.  if( p->aS
5b80: 74 61 63 6b 20 29 7b 0a 20 20 20 20 72 65 6c 65  tack ){.    rele
5b90: 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61  aseMemArray(p->a
5ba0: 53 74 61 63 6b 2c 20 31 20 2b 20 28 70 2d 3e 70  Stack, 1 + (p->p
5bb0: 54 6f 73 20 2d 20 70 2d 3e 61 53 74 61 63 6b 29  Tos - p->aStack)
5bc0: 29 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d  );.    p->pTos =
5bd0: 20 26 70 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d 3b   &p->aStack[-1];
5be0: 0a 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43  .  }.  closeAllC
5bf0: 75 72 73 6f 72 73 28 70 29 3b 0a 20 20 72 65 6c  ursors(p);.  rel
5c00: 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e  easeMemArray(p->
5c10: 61 4d 65 6d 2c 20 70 2d 3e 6e 4d 65 6d 29 3b 0a  aMem, p->nMem);.
5c20: 20 20 69 66 28 20 70 2d 3e 70 4c 69 73 74 20 29    if( p->pList )
5c30: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
5c40: 65 4b 65 79 6c 69 73 74 46 72 65 65 28 70 2d 3e  eKeylistFree(p->
5c50: 70 4c 69 73 74 29 3b 0a 20 20 20 20 70 2d 3e 70  pList);.    p->p
5c60: 4c 69 73 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  List = 0;.  }.  
5c70: 69 66 28 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74  if( p->contextSt
5c80: 61 63 6b 20 29 7b 0a 20 20 20 20 66 6f 72 28 69  ack ){.    for(i
5c90: 3d 30 3b 20 69 3c 70 2d 3e 63 6f 6e 74 65 78 74  =0; i<p->context
5ca0: 53 74 61 63 6b 54 6f 70 3b 20 69 2b 2b 29 7b 0a  StackTop; i++){.
5cb0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
5cc0: 65 4b 65 79 6c 69 73 74 46 72 65 65 28 70 2d 3e  eKeylistFree(p->
5cd0: 63 6f 6e 74 65 78 74 53 74 61 63 6b 5b 69 5d 2e  contextStack[i].
5ce0: 70 4c 69 73 74 29 3b 0a 20 20 20 20 7d 0a 20 20  pList);.    }.  
5cf0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
5d00: 63 6f 6e 74 65 78 74 53 74 61 63 6b 29 3b 0a 20  contextStack);. 
5d10: 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65   }.  sqlite3Vdbe
5d20: 53 6f 72 74 65 72 52 65 73 65 74 28 70 29 3b 0a  SorterReset(p);.
5d30: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 67 67    sqlite3VdbeAgg
5d40: 52 65 73 65 74 28 30 2c 20 26 70 2d 3e 61 67 67  Reset(0, &p->agg
5d50: 2c 20 30 29 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65  , 0);.  p->conte
5d60: 78 74 53 74 61 63 6b 20 3d 20 30 3b 0a 20 20 70  xtStack = 0;.  p
5d70: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 44 65  ->contextStackDe
5d80: 70 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f  pth = 0;.  p->co
5d90: 6e 74 65 78 74 53 74 61 63 6b 54 6f 70 20 3d 20  ntextStackTop = 
5da0: 30 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  0;.  sqliteFree(
5db0: 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 70  p->zErrMsg);.  p
5dc0: 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 7d  ->zErrMsg = 0;.}
5dd0: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
5de0: 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74  number of result
5df0: 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 77 69   columns that wi
5e00: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 62  ll be returned b
5e10: 79 20 74 68 69 73 20 53 51 4c 0a 2a 2a 20 73 74  y this SQL.** st
5e20: 61 74 65 6d 65 6e 74 2e 20 54 68 69 73 20 69 73  atement. This is
5e30: 20 6e 6f 77 20 73 65 74 20 61 74 20 63 6f 6d 70   now set at comp
5e40: 69 6c 65 20 74 69 6d 65 2c 20 72 61 74 68 65 72  ile time, rather
5e50: 20 74 68 61 6e 20 64 75 72 69 6e 67 0a 2a 2a 20   than during.** 
5e60: 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65  execution of the
5e70: 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20 73 6f   vdbe program so
5e80: 20 74 68 61 74 20 73 71 6c 69 74 65 33 5f 63 6f   that sqlite3_co
5e90: 6c 75 6d 6e 5f 63 6f 75 6e 74 28 29 20 63 61 6e  lumn_count() can
5ea0: 0a 2a 2a 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e  .** be called on
5eb0: 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e   an SQL statemen
5ec0: 74 20 62 65 66 6f 72 65 20 73 71 6c 69 74 65 33  t before sqlite3
5ed0: 5f 73 74 65 70 28 29 2e 0a 2a 2f 0a 76 6f 69 64  _step()..*/.void
5ee0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e   sqlite3VdbeSetN
5ef0: 75 6d 43 6f 6c 73 28 56 64 62 65 20 2a 70 2c 20  umCols(Vdbe *p, 
5f00: 69 6e 74 20 6e 52 65 73 43 6f 6c 75 6d 6e 29 7b  int nResColumn){
5f10: 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65  .  Mem *pColName
5f20: 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 61 73 73  ;.  int n;.  ass
5f30: 65 72 74 28 20 30 3d 3d 70 2d 3e 6e 52 65 73 43  ert( 0==p->nResC
5f40: 6f 6c 75 6d 6e 20 29 3b 0a 20 20 70 2d 3e 6e 52  olumn );.  p->nR
5f50: 65 73 43 6f 6c 75 6d 6e 20 3d 20 6e 52 65 73 43  esColumn = nResC
5f60: 6f 6c 75 6d 6e 3b 0a 20 20 6e 20 3d 20 6e 52 65  olumn;.  n = nRe
5f70: 73 43 6f 6c 75 6d 6e 2a 32 3b 0a 20 20 70 2d 3e  sColumn*2;.  p->
5f80: 61 43 6f 6c 4e 61 6d 65 20 3d 20 70 43 6f 6c 4e  aColName = pColN
5f90: 61 6d 65 20 3d 20 28 4d 65 6d 2a 29 73 71 6c 69  ame = (Mem*)sqli
5fa0: 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66  teMalloc( sizeof
5fb0: 28 4d 65 6d 29 2a 6e 20 29 3b 0a 20 20 69 66 28  (Mem)*n );.  if(
5fc0: 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 3d 3d 30 20   p->aColName==0 
5fd0: 29 20 72 65 74 75 72 6e 3b 0a 20 20 77 68 69 6c  ) return;.  whil
5fe0: 65 28 20 6e 2d 2d 20 3e 20 30 20 29 7b 0a 20 20  e( n-- > 0 ){.  
5ff0: 20 20 28 70 43 6f 6c 4e 61 6d 65 2b 2b 29 2d 3e    (pColName++)->
6000: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
6010: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  ;.  }.}../*.** S
6020: 65 74 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  et the name of t
6030: 68 65 20 69 64 78 27 74 68 20 63 6f 6c 75 6d 6e  he idx'th column
6040: 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 20   to be returned 
6050: 62 79 20 74 68 65 20 53 51 4c 20 73 74 61 74 65  by the SQL state
6060: 6d 65 6e 74 2e 0a 2a 2a 20 7a 4e 61 6d 65 20 6d  ment..** zName m
6070: 75 73 74 20 62 65 20 61 20 70 6f 69 6e 74 65 72  ust be a pointer
6080: 20 74 6f 20 61 20 6e 75 6c 20 74 65 72 6d 69 6e   to a nul termin
6090: 61 74 65 64 20 73 74 72 69 6e 67 2e 0a 2a 2a 0a  ated string..**.
60a0: 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 75 73  ** This call mus
60b0: 74 20 62 65 20 6d 61 64 65 20 61 66 74 65 72 20  t be made after 
60c0: 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65  a call to sqlite
60d0: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
60e0: 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e 3d 3d 50  )..**.** If N==P
60f0: 33 5f 53 54 41 54 49 43 20 20 69 74 20 6d 65 61  3_STATIC  it mea
6100: 6e 73 20 74 68 61 74 20 7a 4e 61 6d 65 20 69 73  ns that zName is
6110: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20   a pointer to a 
6120: 63 6f 6e 73 74 61 6e 74 20 73 74 61 74 69 63 0a  constant static.
6130: 2a 2a 20 73 74 72 69 6e 67 20 61 6e 64 20 77 65  ** string and we
6140: 20 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74   can just copy t
6150: 68 65 20 70 6f 69 6e 74 65 72 2e 20 49 66 20 69  he pointer. If i
6160: 74 20 69 73 20 50 33 5f 44 59 4e 41 4d 49 43 2c  t is P3_DYNAMIC,
6170: 20 74 68 65 6e 20 0a 2a 2a 20 74 68 65 20 73 74   then .** the st
6180: 72 69 6e 67 20 69 73 20 66 72 65 65 64 20 75 73  ring is freed us
6190: 69 6e 67 20 73 71 6c 69 74 65 46 72 65 65 28 29  ing sqliteFree()
61a0: 20 77 68 65 6e 20 74 68 65 20 76 64 62 65 20 69   when the vdbe i
61b0: 73 20 66 69 6e 69 73 68 65 64 20 77 69 74 68 0a  s finished with.
61c0: 2a 2a 20 69 74 2e 20 4f 74 68 65 72 77 69 73 65  ** it. Otherwise
61d0: 2c 20 4e 20 62 79 74 65 73 20 6f 66 20 7a 4e 61  , N bytes of zNa
61e0: 6d 65 20 61 72 65 20 63 6f 70 69 65 64 2e 0a 2a  me are copied..*
61f0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
6200: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 56 64 62 65  eSetColName(Vdbe
6210: 20 2a 70 2c 20 69 6e 74 20 69 64 78 2c 20 63 6f   *p, int idx, co
6220: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
6230: 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72   int N){.  int r
6240: 63 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61  c;.  Mem *pColNa
6250: 6d 65 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64  me;.  assert( id
6260: 78 3c 28 32 2a 70 2d 3e 6e 52 65 73 43 6f 6c 75  x<(2*p->nResColu
6270: 6d 6e 29 20 29 3b 0a 20 20 69 66 28 20 73 71 6c  mn) );.  if( sql
6280: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
6290: 65 64 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49  ed ) return SQLI
62a0: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 61 73 73 65  TE_NOMEM;.  asse
62b0: 72 74 28 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21  rt( p->aColName!
62c0: 3d 30 20 29 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65  =0 );.  pColName
62d0: 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65   = &(p->aColName
62e0: 5b 69 64 78 5d 29 3b 0a 20 20 69 66 28 20 4e 3d  [idx]);.  if( N=
62f0: 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 4e  =P3_DYNAMIC || N
6300: 3d 3d 50 33 5f 53 54 41 54 49 43 20 29 7b 0a 20  ==P3_STATIC ){. 
6310: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
6320: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 6f  dbeMemSetStr(pCo
6330: 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31  lName, zName, -1
6340: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53  , SQLITE_UTF8, S
6350: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
6360: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d   }else{.    rc =
6370: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
6380: 65 74 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20  etStr(pColName, 
6390: 7a 4e 61 6d 65 2c 20 4e 2c 20 53 51 4c 49 54 45  zName, N, SQLITE
63a0: 5f 55 54 46 38 2c 53 51 4c 49 54 45 5f 54 52 41  _UTF8,SQLITE_TRA
63b0: 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 0a 20 20 69  NSIENT);.  }.  i
63c0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
63d0: 20 26 26 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49   && N==P3_DYNAMI
63e0: 43 20 29 7b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d  C ){.    pColNam
63f0: 65 2d 3e 66 6c 61 67 73 20 3d 20 28 70 43 6f 6c  e->flags = (pCol
6400: 4e 61 6d 65 2d 3e 66 6c 61 67 73 26 28 7e 4d 45  Name->flags&(~ME
6410: 4d 5f 53 74 61 74 69 63 29 29 7c 4d 45 4d 5f 44  M_Static))|MEM_D
6420: 79 6e 3b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65  yn;.    pColName
6430: 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a  ->xDel = 0;.  }.
6440: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6450: 2f 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6f 72 20  /*.** A read or 
6460: 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f  write transactio
6470: 6e 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74  n may or may not
6480: 20 62 65 20 61 63 74 69 76 65 20 6f 6e 20 64 61   be active on da
6490: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a  tabase handle.**
64a0: 20 64 62 2e 20 49 66 20 61 20 74 72 61 6e 73 61   db. If a transa
64b0: 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2c  ction is active,
64c0: 20 63 6f 6d 6d 69 74 20 69 74 2e 20 49 66 20 74   commit it. If t
64d0: 68 65 72 65 20 69 73 20 61 0a 2a 2a 20 77 72 69  here is a.** wri
64e0: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73  te-transaction s
64f0: 70 61 6e 6e 69 6e 67 20 6d 6f 72 65 20 74 68 61  panning more tha
6500: 6e 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66  n one database f
6510: 69 6c 65 2c 20 74 68 69 73 20 72 6f 75 74 69 6e  ile, this routin
6520: 65 0a 2a 2a 20 74 61 6b 65 73 20 63 61 72 65 20  e.** takes care 
6530: 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  of the master jo
6540: 75 72 6e 61 6c 20 74 72 69 63 6b 65 72 79 2e 0a  urnal trickery..
6550: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64  */.static int vd
6560: 62 65 43 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33  beCommit(sqlite3
6570: 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a   *db){.  int i;.
6580: 20 20 69 6e 74 20 6e 54 72 61 6e 73 20 3d 20 30    int nTrans = 0
6590: 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20  ;  /* Number of 
65a0: 64 61 74 61 62 61 73 65 73 20 77 69 74 68 20 61  databases with a
65b0: 6e 20 61 63 74 69 76 65 20 77 72 69 74 65 2d 74  n active write-t
65c0: 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20  ransaction */.  
65d0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
65e0: 4f 4b 3b 0a 20 20 69 6e 74 20 6e 65 65 64 58 63  OK;.  int needXc
65f0: 6f 6d 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 66 6f  ommit = 0;..  fo
6600: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62  r(i=0; i<db->nDb
6610: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 42 74 72  ; i++){ .    Btr
6620: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
6630: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66  b[i].pBt;.    if
6640: 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65 33  ( pBt && sqlite3
6650: 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70  BtreeIsInTrans(p
6660: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 6e 65 65  Bt) ){.      nee
6670: 64 58 63 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20  dXcommit = 1;.  
6680: 20 20 20 20 69 66 28 20 69 21 3d 31 20 29 20 6e      if( i!=1 ) n
6690: 54 72 61 6e 73 2b 2b 3b 0a 20 20 20 20 7d 0a 20  Trans++;.    }. 
66a0: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72   }..  /* If ther
66b0: 65 20 61 72 65 20 61 6e 79 20 77 72 69 74 65 2d  e are any write-
66c0: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 74 20  transactions at 
66d0: 61 6c 6c 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20  all, invoke the 
66e0: 63 6f 6d 6d 69 74 20 68 6f 6f 6b 20 2a 2f 0a 20  commit hook */. 
66f0: 20 69 66 28 20 6e 65 65 64 58 63 6f 6d 6d 69 74   if( needXcommit
6700: 20 26 26 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43   && db->xCommitC
6710: 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 69  allback ){.    i
6720: 6e 74 20 72 63 3b 0a 20 20 20 20 73 71 6c 69 74  nt rc;.    sqlit
6730: 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b  e3SafetyOff(db);
6740: 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 78 43  .    rc = db->xC
6750: 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 28 64 62  ommitCallback(db
6760: 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 29 3b 0a 20  ->pCommitArg);. 
6770: 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79     sqlite3Safety
6780: 4f 6e 28 64 62 29 3b 0a 20 20 20 20 69 66 28 20  On(db);.    if( 
6790: 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75  rc ){.      retu
67a0: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52  rn SQLITE_CONSTR
67b0: 41 49 4e 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  AINT;.    }.  }.
67c0: 0a 20 20 2f 2a 20 54 68 65 20 73 69 6d 70 6c 65  .  /* The simple
67d0: 20 63 61 73 65 20 2d 20 6e 6f 20 6d 6f 72 65 20   case - no more 
67e0: 74 68 61 6e 20 6f 6e 65 20 64 61 74 61 62 61 73  than one databas
67f0: 65 20 66 69 6c 65 20 28 6e 6f 74 20 63 6f 75 6e  e file (not coun
6800: 74 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 54 45  ting the.  ** TE
6810: 4d 50 20 64 61 74 61 62 61 73 65 29 20 68 61 73  MP database) has
6820: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61   a transaction a
6830: 63 74 69 76 65 2e 20 20 20 54 68 65 72 65 20 69  ctive.   There i
6840: 73 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 74 68  s no need for th
6850: 65 0a 20 20 2a 2a 20 6d 61 73 74 65 72 2d 6a 6f  e.  ** master-jo
6860: 75 72 6e 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  urnal..  **.  **
6870: 20 49 66 20 74 68 65 20 72 65 74 75 72 6e 20 76   If the return v
6880: 61 6c 75 65 20 6f 66 20 73 71 6c 69 74 65 33 42  alue of sqlite3B
6890: 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28  treeGetFilename(
68a0: 29 20 69 73 20 61 20 7a 65 72 6f 20 6c 65 6e 67  ) is a zero leng
68b0: 74 68 0a 20 20 2a 2a 20 73 74 72 69 6e 67 2c 20  th.  ** string, 
68c0: 69 74 20 6d 65 61 6e 73 20 74 68 65 20 6d 61 69  it means the mai
68d0: 6e 20 64 61 74 61 62 61 73 65 20 69 73 20 3a 6d  n database is :m
68e0: 65 6d 6f 72 79 3a 2e 20 20 49 6e 20 74 68 61 74  emory:.  In that
68f0: 20 63 61 73 65 20 77 65 20 64 6f 0a 20 20 2a 2a   case we do.  **
6900: 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 74 6f   not support ato
6910: 6d 69 63 20 6d 75 6c 74 69 2d 66 69 6c 65 20 63  mic multi-file c
6920: 6f 6d 6d 69 74 73 2c 20 73 6f 20 75 73 65 20 74  ommits, so use t
6930: 68 65 20 73 69 6d 70 6c 65 20 63 61 73 65 20 74  he simple case t
6940: 68 65 6e 0a 20 20 2a 2a 20 74 6f 6f 2e 0a 20 20  hen.  ** too..  
6950: 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 73 74 72 6c  */.  if( 0==strl
6960: 65 6e 28 73 71 6c 69 74 65 33 42 74 72 65 65 47  en(sqlite3BtreeG
6970: 65 74 46 69 6c 65 6e 61 6d 65 28 64 62 2d 3e 61  etFilename(db->a
6980: 44 62 5b 30 5d 2e 70 42 74 29 29 20 7c 7c 20 6e  Db[0].pBt)) || n
6990: 54 72 61 6e 73 3c 3d 31 20 29 7b 0a 20 20 20 20  Trans<=1 ){.    
69a0: 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c  for(i=0; rc==SQL
69b0: 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e  ITE_OK && i<db->
69c0: 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20  nDb; i++){ .    
69d0: 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64    Btree *pBt = d
69e0: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20  b->aDb[i].pBt;. 
69f0: 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a       if( pBt ){.
6a00: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
6a10: 69 74 65 33 42 74 72 65 65 53 79 6e 63 28 70 42  ite3BtreeSync(pB
6a20: 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20  t, 0);.      }. 
6a30: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 6f 20     }..    /* Do 
6a40: 74 68 65 20 63 6f 6d 6d 69 74 20 6f 6e 6c 79 20  the commit only 
6a50: 69 66 20 61 6c 6c 20 64 61 74 61 62 61 73 65 73  if all databases
6a60: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 73 79   successfully sy
6a70: 6e 63 65 64 20 2a 2f 0a 20 20 20 20 69 66 28 20  nced */.    if( 
6a80: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
6a90: 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  .      for(i=0; 
6aa0: 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b  i<db->nDb; i++){
6ab0: 0a 20 20 20 20 20 20 20 20 42 74 72 65 65 20 2a  .        Btree *
6ac0: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d  pBt = db->aDb[i]
6ad0: 2e 70 42 74 3b 0a 20 20 20 20 20 20 20 20 69 66  .pBt;.        if
6ae0: 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20  ( pBt ){.       
6af0: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
6b00: 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20  ommit(pBt);.    
6b10: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20      }.      }.  
6b20: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68    }.  }..  /* Th
6b30: 65 20 63 6f 6d 70 6c 65 78 20 63 61 73 65 20 2d  e complex case -
6b40: 20 54 68 65 72 65 20 69 73 20 61 20 6d 75 6c 74   There is a mult
6b50: 69 2d 66 69 6c 65 20 77 72 69 74 65 2d 74 72 61  i-file write-tra
6b60: 6e 73 61 63 74 69 6f 6e 20 61 63 74 69 76 65 2e  nsaction active.
6b70: 0a 20 20 2a 2a 20 54 68 69 73 20 72 65 71 75 69  .  ** This requi
6b80: 72 65 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  res a master jou
6b90: 72 6e 61 6c 20 66 69 6c 65 20 74 6f 20 65 6e 73  rnal file to ens
6ba0: 75 72 65 20 74 68 65 20 74 72 61 6e 73 61 63 74  ure the transact
6bb0: 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 63 6f 6d 6d  ion is.  ** comm
6bc0: 69 74 74 65 64 20 61 74 6f 6d 69 63 6c 79 2e 0a  itted atomicly..
6bd0: 20 20 2a 2f 0a 20 20 65 6c 73 65 7b 0a 20 20 20    */.  else{.   
6be0: 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d   char *zMaster =
6bf0: 20 30 3b 20 20 20 2f 2a 20 46 69 6c 65 2d 6e 61   0;   /* File-na
6c00: 6d 65 20 66 6f 72 20 74 68 65 20 6d 61 73 74 65  me for the maste
6c10: 72 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20  r journal */.   
6c20: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61   char const *zMa
6c30: 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33  inFile = sqlite3
6c40: 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65  BtreeGetFilename
6c50: 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29  (db->aDb[0].pBt)
6c60: 3b 0a 20 20 20 20 4f 73 46 69 6c 65 20 6d 61 73  ;.    OsFile mas
6c70: 74 65 72 3b 0a 0a 20 20 20 20 2f 2a 20 53 65 6c  ter;..    /* Sel
6c80: 65 63 74 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  ect a master jou
6c90: 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 2a  rnal file name *
6ca0: 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20  /.    do {.     
6cb0: 20 75 33 32 20 72 61 6e 64 6f 6d 3b 0a 20 20 20   u32 random;.   
6cc0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
6cd0: 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71  aster);.      sq
6ce0: 6c 69 74 65 33 52 61 6e 64 6f 6d 6e 65 73 73 28  lite3Randomness(
6cf0: 73 69 7a 65 6f 66 28 72 61 6e 64 6f 6d 29 2c 20  sizeof(random), 
6d00: 26 72 61 6e 64 6f 6d 29 3b 0a 20 20 20 20 20 20  &random);.      
6d10: 7a 4d 61 73 74 65 72 20 3d 20 73 71 6c 69 74 65  zMaster = sqlite
6d20: 33 4d 50 72 69 6e 74 66 28 22 25 73 2d 6d 6a 25  3MPrintf("%s-mj%
6d30: 30 38 58 22 2c 20 7a 4d 61 69 6e 46 69 6c 65 2c  08X", zMainFile,
6d40: 20 72 61 6e 64 6f 6d 26 30 78 37 66 66 66 66 66   random&0x7fffff
6d50: 66 66 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21  ff);.      if( !
6d60: 7a 4d 61 73 74 65 72 20 29 7b 0a 20 20 20 20 20  zMaster ){.     
6d70: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
6d80: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a  _NOMEM;.      }.
6d90: 20 20 20 20 7d 77 68 69 6c 65 28 20 73 71 6c 69      }while( sqli
6da0: 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73 28  te3OsFileExists(
6db0: 7a 4d 61 73 74 65 72 29 20 29 3b 0a 0a 20 20 20  zMaster) );..   
6dc0: 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 6d 61 73   /* Open the mas
6dd0: 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a  ter journal. */.
6de0: 20 20 20 20 6d 65 6d 73 65 74 28 26 6d 61 73 74      memset(&mast
6df0: 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 61  er, 0, sizeof(ma
6e00: 73 74 65 72 29 29 3b 0a 20 20 20 20 72 63 20 3d  ster));.    rc =
6e10: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78   sqlite3OsOpenEx
6e20: 63 6c 75 73 69 76 65 28 7a 4d 61 73 74 65 72 2c  clusive(zMaster,
6e30: 20 26 6d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20   &master, 0);.  
6e40: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
6e50: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  _OK ){.      sql
6e60: 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29  iteFree(zMaster)
6e70: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  ;.      return r
6e80: 63 3b 0a 20 20 20 20 7d 0a 20 0a 20 20 20 20 2f  c;.    }. .    /
6e90: 2a 20 57 72 69 74 65 20 74 68 65 20 6e 61 6d 65  * Write the name
6ea0: 20 6f 66 20 65 61 63 68 20 64 61 74 61 62 61 73   of each databas
6eb0: 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20 74 72  e file in the tr
6ec0: 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74 6f 20 74  ansaction into t
6ed0: 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20 6d 61  he new.    ** ma
6ee0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
6ef0: 65 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f  e. If an error o
6f00: 63 63 75 72 73 20 61 74 20 74 68 69 73 20 70 6f  ccurs at this po
6f10: 69 6e 74 20 63 6c 6f 73 65 0a 20 20 20 20 2a 2a  int close.    **
6f20: 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20   and delete the 
6f30: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
6f40: 69 6c 65 2e 20 41 6c 6c 20 74 68 65 20 69 6e 64  ile. All the ind
6f50: 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20  ividual journal 
6f60: 66 69 6c 65 73 0a 20 20 20 20 2a 2a 20 73 74 69  files.    ** sti
6f70: 6c 6c 20 68 61 76 65 20 27 6e 75 6c 6c 27 20 61  ll have 'null' a
6f80: 73 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  s the master jou
6f90: 72 6e 61 6c 20 70 6f 69 6e 74 65 72 2c 20 73 6f  rnal pointer, so
6fa0: 20 74 68 65 79 20 77 69 6c 6c 20 72 6f 6c 6c 0a   they will roll.
6fb0: 20 20 20 20 2a 2a 20 62 61 63 6b 20 69 6e 64 65      ** back inde
6fc0: 70 65 6e 64 65 6e 74 6c 79 20 69 66 20 61 20 66  pendently if a f
6fd0: 61 69 6c 75 72 65 20 6f 63 63 75 72 73 2e 0a 20  ailure occurs.. 
6fe0: 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d     */.    for(i=
6ff0: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  0; i<db->nDb; i+
7000: 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65 65  +){ .      Btree
7010: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b   *pBt = db->aDb[
7020: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66  i].pBt;.      if
7030: 28 20 69 3d 3d 31 20 29 20 63 6f 6e 74 69 6e 75  ( i==1 ) continu
7040: 65 3b 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74  e;   /* Ignore t
7050: 68 65 20 54 45 4d 50 20 64 61 74 61 62 61 73 65  he TEMP database
7060: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42   */.      if( pB
7070: 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 72 65  t && sqlite3Btre
7080: 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20  eIsInTrans(pBt) 
7090: 29 7b 0a 20 20 20 20 20 20 20 20 63 68 61 72 20  ){.        char 
70a0: 63 6f 6e 73 74 20 2a 7a 46 69 6c 65 20 3d 20 73  const *zFile = s
70b0: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 4a 6f  qlite3BtreeGetJo
70c0: 75 72 6e 61 6c 6e 61 6d 65 28 70 42 74 29 3b 0a  urnalname(pBt);.
70d0: 20 20 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c          if( zFil
70e0: 65 5b 30 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e  e[0]==0 ) contin
70f0: 75 65 3b 20 20 2f 2a 20 49 67 6e 6f 72 65 20 3a  ue;  /* Ignore :
7100: 6d 65 6d 6f 72 79 3a 20 64 61 74 61 62 61 73 65  memory: database
7110: 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20  s */.        rc 
7120: 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65  = sqlite3OsWrite
7130: 28 26 6d 61 73 74 65 72 2c 20 7a 46 69 6c 65 2c  (&master, zFile,
7140: 20 73 74 72 6c 65 6e 28 7a 46 69 6c 65 29 2b 31   strlen(zFile)+1
7150: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72  );.        if( r
7160: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
7170: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
7180: 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72  3OsClose(&master
7190: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  );.          sql
71a0: 69 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61  ite3OsDelete(zMa
71b0: 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20  ster);.         
71c0: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
71d0: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ter);.          
71e0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20  return rc;.     
71f0: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
7200: 20 7d 0a 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63   }...    /* Sync
7210: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72   the master jour
7220: 6e 61 6c 20 66 69 6c 65 2e 20 42 65 66 6f 72 65  nal file. Before
7230: 20 64 6f 69 6e 67 20 74 68 69 73 2c 20 6f 70 65   doing this, ope
7240: 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a  n the directory.
7250: 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 73 74 65      ** the maste
7260: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69  r journal file i
7270: 73 20 73 74 6f 72 65 20 69 6e 20 73 6f 20 74 68  s store in so th
7280: 61 74 20 69 74 20 67 65 74 73 20 73 79 6e 63 65  at it gets synce
7290: 64 20 74 6f 6f 2e 0a 20 20 20 20 2a 2f 0a 20 20  d too..    */.  
72a0: 20 20 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71    zMainFile = sq
72b0: 6c 69 74 65 33 42 74 72 65 65 47 65 74 44 69 72  lite3BtreeGetDir
72c0: 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e  name(db->aDb[0].
72d0: 70 42 74 29 3b 0a 20 20 20 20 72 63 20 3d 20 73  pBt);.    rc = s
72e0: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 44 69 72 65  qlite3OsOpenDire
72f0: 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69 6c 65 2c  ctory(zMainFile,
7300: 20 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 69   &master);.    i
7310: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
7320: 20 7c 7c 20 28 72 63 20 3d 20 73 71 6c 69 74 65   || (rc = sqlite
7330: 33 4f 73 53 79 6e 63 28 26 6d 61 73 74 65 72 29  3OsSync(&master)
7340: 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  )!=SQLITE_OK ){.
7350: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43        sqlite3OsC
7360: 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20  lose(&master);. 
7370: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65       sqlite3OsDe
7380: 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20  lete(zMaster);. 
7390: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
73a0: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  zMaster);.      
73b0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d  return rc;.    }
73c0: 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63 20 61 6c  ..    /* Sync al
73d0: 6c 20 74 68 65 20 64 62 20 66 69 6c 65 73 20 69  l the db files i
73e0: 6e 76 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 74  nvolved in the t
73f0: 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20  ransaction. The 
7400: 73 61 6d 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a  same call.    **
7410: 20 73 65 74 73 20 74 68 65 20 6d 61 73 74 65 72   sets the master
7420: 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72   journal pointer
7430: 20 69 6e 20 65 61 63 68 20 69 6e 64 69 76 69 64   in each individ
7440: 75 61 6c 20 6a 6f 75 72 6e 61 6c 2e 20 49 66 0a  ual journal. If.
7450: 20 20 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 20      ** an error 
7460: 6f 63 63 75 72 73 20 68 65 72 65 2c 20 64 6f 20  occurs here, do 
7470: 6e 6f 74 20 64 65 6c 65 74 65 20 74 68 65 20 6d  not delete the m
7480: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
7490: 6c 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a  le..    **.    *
74a0: 2a 20 49 66 20 74 68 65 20 65 72 72 6f 72 20 6f  * If the error o
74b0: 63 63 75 72 73 20 64 75 72 69 6e 67 20 74 68 65  ccurs during the
74c0: 20 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 20 73   first call to s
74d0: 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63 28  qlite3BtreeSync(
74e0: 29 2c 0a 20 20 20 20 2a 2a 20 74 68 65 6e 20 74  ),.    ** then t
74f0: 68 65 72 65 20 69 73 20 61 20 63 68 61 6e 63 65  here is a chance
7500: 20 74 68 61 74 20 74 68 65 20 6d 61 73 74 65 72   that the master
7510: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 69   journal file wi
7520: 6c 6c 20 62 65 0a 20 20 20 20 2a 2a 20 6f 72 70  ll be.    ** orp
7530: 68 61 6e 65 64 2e 20 42 75 74 20 77 65 20 63 61  haned. But we ca
7540: 6e 6e 6f 74 20 64 65 6c 65 74 65 20 69 74 2c 20  nnot delete it, 
7550: 69 6e 20 63 61 73 65 20 74 68 65 20 6d 61 73 74  in case the mast
7560: 65 72 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a  er journal.    *
7570: 2a 20 66 69 6c 65 20 6e 61 6d 65 20 77 61 73 20  * file name was 
7580: 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65  written into the
7590: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 62 65   journal file be
75a0: 66 6f 72 65 20 74 68 65 20 66 61 69 6c 75 72 65  fore the failure
75b0: 0a 20 20 20 20 2a 2a 20 6f 63 63 75 72 65 64 2e  .    ** occured.
75c0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28  .    */.    for(
75d0: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
75e0: 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72  i++){ .      Btr
75f0: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
7600: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20  b[i].pBt;.      
7610: 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 74  if( pBt && sqlit
7620: 65 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73  e3BtreeIsInTrans
7630: 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 20  (pBt) ){.       
7640: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
7650: 65 65 53 79 6e 63 28 70 42 74 2c 20 7a 4d 61 73  eeSync(pBt, zMas
7660: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69 66  ter);.        if
7670: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
7680: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  ){.          sql
7690: 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73  ite3OsClose(&mas
76a0: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ter);.          
76b0: 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74  sqliteFree(zMast
76c0: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72  er);.          r
76d0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
76e0: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20    }.      }.    
76f0: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43  }.    sqlite3OsC
7700: 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 0a  lose(&master);..
7710: 20 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 74 68      /* Delete th
7720: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
7730: 20 66 69 6c 65 2e 20 54 68 69 73 20 63 6f 6d 6d   file. This comm
7740: 69 74 73 20 74 68 65 20 74 72 61 6e 73 61 63 74  its the transact
7750: 69 6f 6e 2e 20 41 66 74 65 72 0a 20 20 20 20 2a  ion. After.    *
7760: 2a 20 64 6f 69 6e 67 20 74 68 69 73 20 74 68 65  * doing this the
7770: 20 64 69 72 65 63 74 6f 72 79 20 69 73 20 73 79   directory is sy
7780: 6e 63 65 64 20 61 67 61 69 6e 20 62 65 66 6f 72  nced again befor
7790: 65 20 61 6e 79 20 69 6e 64 69 76 69 64 75 61 6c  e any individual
77a0: 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74  .    ** transact
77b0: 69 6f 6e 20 66 69 6c 65 73 20 61 72 65 20 64 65  ion files are de
77c0: 6c 65 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  leted..    */.  
77d0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
77e0: 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b  Delete(zMaster);
77f0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d  .    assert( rc=
7800: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20  =SQLITE_OK );.  
7810: 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61    sqliteFree(zMa
7820: 73 74 65 72 29 3b 0a 20 20 20 20 7a 4d 61 73 74  ster);.    zMast
7830: 65 72 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d  er = 0;.    rc =
7840: 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69   sqlite3OsSyncDi
7850: 72 65 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69 6c  rectory(zMainFil
7860: 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d  e);.    if( rc!=
7870: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
7880: 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 6e 6f     /* This is no
7890: 74 20 67 6f 6f 64 2e 20 54 68 65 20 6d 61 73 74  t good. The mast
78a0: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  er journal file 
78b0: 68 61 73 20 62 65 65 6e 20 64 65 6c 65 74 65 64  has been deleted
78c0: 2c 20 62 75 74 0a 20 20 20 20 20 20 2a 2a 20 74  , but.      ** t
78d0: 68 65 20 64 69 72 65 63 74 6f 72 79 20 73 79 6e  he directory syn
78e0: 63 20 66 61 69 6c 65 64 2e 20 54 68 65 72 65 20  c failed. There 
78f0: 69 73 20 6e 6f 20 63 6f 6d 70 6c 65 74 65 6c 79  is no completely
7900: 20 73 61 66 65 20 63 6f 75 72 73 65 20 6f 66 0a   safe course of.
7910: 20 20 20 20 20 20 2a 2a 20 61 63 74 69 6f 6e 20        ** action 
7920: 66 72 6f 6d 20 68 65 72 65 2e 20 54 68 65 20 69  from here. The i
7930: 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61  ndividual journa
7940: 6c 73 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 6e  ls contain the n
7950: 61 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20  ame of the.     
7960: 20 2a 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e   ** master journ
7970: 61 6c 20 66 69 6c 65 2c 20 62 75 74 20 74 68 65  al file, but the
7980: 72 65 20 69 73 20 6e 6f 20 77 61 79 20 6f 66 20  re is no way of 
7990: 6b 6e 6f 77 69 6e 67 20 69 66 20 74 68 61 74 0a  knowing if that.
79a0: 20 20 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20        ** master 
79b0: 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74 73 20 6e  journal exists n
79c0: 6f 77 20 6f 72 20 69 66 20 69 74 20 77 69 6c 6c  ow or if it will
79d0: 20 65 78 69 73 74 20 61 66 74 65 72 20 74 68 65   exist after the
79e0: 20 6f 70 65 72 61 74 69 6e 67 0a 20 20 20 20 20   operating.     
79f0: 20 2a 2a 20 73 79 73 74 65 6d 20 63 72 61 73 68   ** system crash
7a00: 20 74 68 61 74 20 6d 61 79 20 66 6f 6c 6c 6f 77   that may follow
7a10: 20 74 68 65 20 66 73 79 6e 63 28 29 20 66 61 69   the fsync() fai
7a20: 6c 75 72 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  lure..      */. 
7a30: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
7a40: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 41 6c      }..    /* Al
7a50: 6c 20 66 69 6c 65 73 20 61 6e 64 20 64 69 72 65  l files and dire
7a60: 63 74 6f 72 69 65 73 20 68 61 76 65 20 61 6c 72  ctories have alr
7a70: 65 61 64 79 20 62 65 65 6e 20 73 79 6e 63 65 64  eady been synced
7a80: 2c 20 73 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69  , so the followi
7a90: 6e 67 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 73 20  ng.    ** calls 
7aa0: 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 43  to sqlite3BtreeC
7ab0: 6f 6d 6d 69 74 28 29 20 61 72 65 20 6f 6e 6c 79  ommit() are only
7ac0: 20 63 6c 6f 73 69 6e 67 20 66 69 6c 65 73 20 61   closing files a
7ad0: 6e 64 20 64 65 6c 65 74 69 6e 67 0a 20 20 20 20  nd deleting.    
7ae0: 2a 2a 20 6a 6f 75 72 6e 61 6c 73 2e 20 49 66 20  ** journals. If 
7af0: 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77  something goes w
7b00: 72 6f 6e 67 20 77 68 69 6c 65 20 74 68 69 73 20  rong while this 
7b10: 69 73 20 68 61 70 70 65 6e 69 6e 67 20 77 65 20  is happening we 
7b20: 64 6f 6e 27 74 0a 20 20 20 20 2a 2a 20 72 65 61  don't.    ** rea
7b30: 6c 6c 79 20 63 61 72 65 2e 20 54 68 65 20 69 6e  lly care. The in
7b40: 74 65 67 72 69 74 79 20 6f 66 20 74 68 65 20 74  tegrity of the t
7b50: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 6c  ransaction is al
7b60: 72 65 61 64 79 20 67 75 61 72 61 6e 74 65 65 64  ready guaranteed
7b70: 2c 0a 20 20 20 20 2a 2a 20 62 75 74 20 73 6f 6d  ,.    ** but som
7b80: 65 20 73 74 72 61 79 20 27 63 6f 6c 64 27 20 6a  e stray 'cold' j
7b90: 6f 75 72 6e 61 6c 73 20 6d 61 79 20 62 65 20 6c  ournals may be l
7ba0: 79 69 6e 67 20 61 72 6f 75 6e 64 2e 20 52 65 74  ying around. Ret
7bb0: 75 72 6e 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a  urning an.    **
7bc0: 20 65 72 72 6f 72 20 63 6f 64 65 20 77 6f 6e 27   error code won'
7bd0: 74 20 68 65 6c 70 20 6d 61 74 74 65 72 73 2e 0a  t help matters..
7be0: 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69      */.    for(i
7bf0: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
7c00: 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65  ++){ .      Btre
7c10: 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62  e *pBt = db->aDb
7c20: 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69  [i].pBt;.      i
7c30: 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20  f( pBt ){.      
7c40: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f    sqlite3BtreeCo
7c50: 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20 20  mmit(pBt);.     
7c60: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20   }.    }.  }..  
7c70: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
7c80: 0a 2a 2a 20 46 69 6e 64 20 65 76 65 72 79 20 61  .** Find every a
7c90: 63 74 69 76 65 20 56 4d 20 6f 74 68 65 72 20 74  ctive VM other t
7ca0: 68 61 6e 20 70 56 64 62 65 20 61 6e 64 20 63 68  han pVdbe and ch
7cb0: 61 6e 67 65 20 69 74 73 20 73 74 61 74 75 73 20  ange its status 
7cc0: 74 6f 0a 2a 2a 20 61 62 6f 72 74 65 64 2e 20 20  to.** aborted.  
7cd0: 54 68 69 73 20 68 61 70 70 65 6e 73 20 77 68 65  This happens whe
7ce0: 6e 20 6f 6e 65 20 56 4d 20 63 61 75 73 65 73 20  n one VM causes 
7cf0: 61 20 72 6f 6c 6c 62 61 63 6b 20 64 75 65 20 74  a rollback due t
7d00: 6f 20 61 6e 0a 2a 2a 20 4f 4e 20 43 4f 4e 46 4c  o an.** ON CONFL
7d10: 49 43 54 20 52 4f 4c 4c 42 41 43 4b 20 63 6c 61  ICT ROLLBACK cla
7d20: 75 73 65 20 28 66 6f 72 20 65 78 61 6d 70 6c 65  use (for example
7d30: 29 2e 20 20 54 68 65 20 6f 74 68 65 72 20 56 4d  ).  The other VM
7d40: 73 20 6d 75 73 74 20 62 65 0a 2a 2a 20 61 62 6f  s must be.** abo
7d50: 72 74 65 64 20 73 6f 20 74 68 61 74 20 74 68 65  rted so that the
7d60: 79 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 64 61  y do not have da
7d70: 74 61 20 72 6f 6c 6c 65 64 20 6f 75 74 20 66 72  ta rolled out fr
7d80: 6f 6d 20 75 6e 64 65 72 6e 65 61 74 68 0a 2a 2a  om underneath.**
7d90: 20 74 68 65 6d 20 6c 65 61 64 69 6e 67 20 74 6f   them leading to
7da0: 20 61 20 73 65 67 66 61 75 6c 74 2e 0a 2a 2f 0a   a segfault..*/.
7db0: 73 74 61 74 69 63 20 76 6f 69 64 20 61 62 6f 72  static void abor
7dc0: 74 4f 74 68 65 72 41 63 74 69 76 65 56 64 62 65  tOtherActiveVdbe
7dd0: 73 28 56 64 62 65 20 2a 70 56 64 62 65 29 7b 0a  s(Vdbe *pVdbe){.
7de0: 20 20 56 64 62 65 20 2a 70 4f 74 68 65 72 3b 0a    Vdbe *pOther;.
7df0: 20 20 66 6f 72 28 70 4f 74 68 65 72 3d 70 56 64    for(pOther=pVd
7e00: 62 65 2d 3e 64 62 2d 3e 70 56 64 62 65 3b 20 70  be->db->pVdbe; p
7e10: 4f 74 68 65 72 3b 20 70 4f 74 68 65 72 3d 70 4f  Other; pOther=pO
7e20: 74 68 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20  ther->pNext){.  
7e30: 20 20 69 66 28 20 70 4f 74 68 65 72 3d 3d 70 56    if( pOther==pV
7e40: 64 62 65 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a  dbe ) continue;.
7e50: 20 20 20 20 69 66 28 20 70 4f 74 68 65 72 2d 3e      if( pOther->
7e60: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
7e70: 43 5f 52 55 4e 20 7c 7c 20 70 4f 74 68 65 72 2d  C_RUN || pOther-
7e80: 3e 70 63 3c 30 20 29 20 63 6f 6e 74 69 6e 75 65  >pc<0 ) continue
7e90: 3b 0a 20 20 20 20 63 6c 6f 73 65 41 6c 6c 43 75  ;.    closeAllCu
7ea0: 72 73 6f 72 73 28 70 4f 74 68 65 72 29 3b 0a 20  rsors(pOther);. 
7eb0: 20 20 20 70 4f 74 68 65 72 2d 3e 61 62 6f 72 74     pOther->abort
7ec0: 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f  ed = 1;.  }.}../
7ed0: 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  * .** This routi
7ee0: 6e 65 20 63 68 65 63 6b 73 20 74 68 61 74 20 74  ne checks that t
7ef0: 68 65 20 73 71 6c 69 74 65 33 2e 61 63 74 69 76  he sqlite3.activ
7f00: 65 56 64 62 65 43 6e 74 20 63 6f 75 6e 74 20 76  eVdbeCnt count v
7f10: 61 72 69 61 62 6c 65 0a 2a 2a 20 6d 61 74 63 68  ariable.** match
7f20: 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  es the number of
7f30: 20 76 64 62 65 27 73 20 69 6e 20 74 68 65 20 6c   vdbe's in the l
7f40: 69 73 74 20 73 71 6c 69 74 65 33 2e 70 56 64 62  ist sqlite3.pVdb
7f50: 65 20 74 68 61 74 20 61 72 65 0a 2a 2a 20 63 75  e that are.** cu
7f60: 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 2e 20  rrently active. 
7f70: 41 6e 20 61 73 73 65 72 74 69 6f 6e 20 66 61 69  An assertion fai
7f80: 6c 73 20 69 66 20 74 68 65 20 74 77 6f 20 63 6f  ls if the two co
7f90: 75 6e 74 73 20 64 6f 20 6e 6f 74 20 6d 61 74 63  unts do not matc
7fa0: 68 2e 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 6e  h..** This is an
7fb0: 20 69 6e 74 65 72 6e 61 6c 20 73 65 6c 66 2d 63   internal self-c
7fc0: 68 65 63 6b 20 6f 6e 6c 79 20 2d 20 69 74 20 69  heck only - it i
7fd0: 73 20 6e 6f 74 20 61 6e 20 65 73 73 65 6e 74 69  s not an essenti
7fe0: 61 6c 20 70 72 6f 63 65 73 73 69 6e 67 0a 2a 2a  al processing.**
7ff0: 20 73 74 65 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69   step..**.** Thi
8000: 73 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20  s is a no-op if 
8010: 4e 44 45 42 55 47 20 69 73 20 64 65 66 69 6e 65  NDEBUG is define
8020: 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44  d..*/.#ifndef ND
8030: 45 42 55 47 0a 73 74 61 74 69 63 20 76 6f 69 64  EBUG.static void
8040: 20 63 68 65 63 6b 41 63 74 69 76 65 56 64 62 65   checkActiveVdbe
8050: 43 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29  Cnt(sqlite3 *db)
8060: 7b 0a 20 20 56 64 62 65 20 2a 70 3b 0a 20 20 69  {.  Vdbe *p;.  i
8070: 6e 74 20 63 6e 74 20 3d 20 30 3b 0a 20 20 70 20  nt cnt = 0;.  p 
8080: 3d 20 64 62 2d 3e 70 56 64 62 65 3b 0a 20 20 77  = db->pVdbe;.  w
8090: 68 69 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 69  hile( p ){.    i
80a0: 66 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  f( p->magic==VDB
80b0: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 70  E_MAGIC_RUN && p
80c0: 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 20  ->pc>=0 ){.     
80d0: 20 63 6e 74 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20   cnt++;.    }.  
80e0: 20 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a    p = p->pNext;.
80f0: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 63 6e    }.  assert( cn
8100: 74 3d 3d 64 62 2d 3e 61 63 74 69 76 65 56 64 62  t==db->activeVdb
8110: 65 43 6e 74 20 29 3b 0a 7d 0a 23 65 6c 73 65 0a  eCnt );.}.#else.
8120: 23 64 65 66 69 6e 65 20 63 68 65 63 6b 41 63 74  #define checkAct
8130: 69 76 65 56 64 62 65 43 6e 74 28 78 29 0a 23 65  iveVdbeCnt(x).#e
8140: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  ndif../*.** This
8150: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c   routine is call
8160: 65 64 20 74 68 65 20 77 68 65 6e 20 61 20 56 44  ed the when a VD
8170: 42 45 20 74 72 69 65 73 20 74 6f 20 68 61 6c 74  BE tries to halt
8180: 2e 20 20 49 66 20 74 68 65 20 56 44 42 45 0a 2a  .  If the VDBE.*
8190: 2a 20 68 61 73 20 6d 61 64 65 20 63 68 61 6e 67  * has made chang
81a0: 65 73 20 61 6e 64 20 69 73 20 69 6e 20 61 75 74  es and is in aut
81b0: 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 2c 20 74 68  ocommit mode, th
81c0: 65 6e 20 63 6f 6d 6d 69 74 20 74 68 6f 73 65 0a  en commit those.
81d0: 2a 2a 20 63 68 61 6e 67 65 73 2e 20 20 49 66 20  ** changes.  If 
81e0: 61 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6e 65  a rollback is ne
81f0: 65 64 65 64 2c 20 74 68 65 6e 20 64 6f 20 74 68  eded, then do th
8200: 65 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a  e rollback..**.*
8210: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
8220: 73 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74  s the only way t
8230: 6f 20 6d 6f 76 65 20 74 68 65 20 73 74 61 74 65  o move the state
8240: 20 6f 66 20 61 20 56 4d 20 66 72 6f 6d 0a 2a 2a   of a VM from.**
8250: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 52 55   SQLITE_MAGIC_RU
8260: 4e 20 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49  N to SQLITE_MAGI
8270: 43 5f 48 41 4c 54 2e 0a 2a 2a 0a 2a 2a 20 52 65  C_HALT..**.** Re
8280: 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f  turn an error co
8290: 64 65 2e 20 20 49 66 20 74 68 65 20 63 6f 6d 6d  de.  If the comm
82a0: 69 74 20 63 6f 75 6c 64 20 6e 6f 74 20 63 6f 6d  it could not com
82b0: 70 6c 65 74 65 20 62 65 63 61 75 73 65 20 6f 66  plete because of
82c0: 0a 2a 2a 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74  .** lock content
82d0: 69 6f 6e 2c 20 72 65 74 75 72 6e 20 53 51 4c 49  ion, return SQLI
82e0: 54 45 5f 42 55 53 59 2e 20 20 49 66 20 53 51 4c  TE_BUSY.  If SQL
82f0: 49 54 45 5f 42 55 53 59 20 69 73 20 72 65 74 75  ITE_BUSY is retu
8300: 72 6e 65 64 2c 20 69 74 0a 2a 2a 20 6d 65 61 6e  rned, it.** mean
8310: 73 20 74 68 65 20 63 6c 6f 73 65 20 64 69 64 20  s the close did 
8320: 6e 6f 74 20 68 61 70 70 65 6e 20 61 6e 64 20 6e  not happen and n
8330: 65 65 64 73 20 74 6f 20 62 65 20 72 65 70 65 61  eeds to be repea
8340: 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ted..*/.int sqli
8350: 74 65 33 56 64 62 65 48 61 6c 74 28 56 64 62 65  te3VdbeHalt(Vdbe
8360: 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 65 33 20   *p){.  sqlite3 
8370: 2a 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69  *db = p->db;.  i
8380: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 28 2a 78 46  nt i;.  int (*xF
8390: 75 6e 63 29 28 42 74 72 65 65 20 2a 70 42 74 29  unc)(Btree *pBt)
83a0: 20 3d 20 30 3b 20 20 2f 2a 20 46 75 6e 63 74 69   = 0;  /* Functi
83b0: 6f 6e 20 74 6f 20 63 61 6c 6c 20 6f 6e 20 65 61  on to call on ea
83c0: 63 68 20 62 74 72 65 65 20 62 61 63 6b 65 6e 64  ch btree backend
83d0: 20 2a 2f 0a 0a 20 20 69 66 28 20 70 2d 3e 6d 61   */..  if( p->ma
83e0: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
83f0: 52 55 4e 20 29 7b 0a 20 20 20 20 2f 2a 20 41 6c  RUN ){.    /* Al
8400: 72 65 61 64 79 20 68 61 6c 74 65 64 2e 20 20 4e  ready halted.  N
8410: 6f 74 68 69 6e 67 20 74 6f 20 64 6f 2e 20 2a 2f  othing to do. */
8420: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
8430: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
8440: 43 5f 48 41 4c 54 20 29 3b 0a 20 20 20 20 72 65  C_HALT );.    re
8450: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
8460: 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75    }.  closeAllCu
8470: 72 73 6f 72 73 28 70 29 3b 0a 20 20 63 68 65 63  rsors(p);.  chec
8480: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64  kActiveVdbeCnt(d
8490: 62 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70 63 3c  b);.  if( p->pc<
84a0: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4e 6f 20 63  0 ){.    /* No c
84b0: 6f 6d 6d 69 74 20 6f 72 20 72 6f 6c 6c 62 61 63  ommit or rollbac
84c0: 6b 20 6e 65 65 64 65 64 20 69 66 20 74 68 65 20  k needed if the 
84d0: 70 72 6f 67 72 61 6d 20 6e 65 76 65 72 20 73 74  program never st
84e0: 61 72 74 65 64 20 2a 2f 0a 20 20 7d 65 6c 73 65  arted */.  }else
84f0: 20 69 66 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d   if( db->autoCom
8500: 6d 69 74 20 26 26 20 64 62 2d 3e 61 63 74 69 76  mit && db->activ
8510: 65 56 64 62 65 43 6e 74 3d 3d 31 20 29 7b 0a 20  eVdbeCnt==1 ){. 
8520: 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51     if( p->rc==SQ
8530: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 65 72  LITE_OK || p->er
8540: 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61  rorAction==OE_Fa
8550: 69 6c 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54  il ){.      /* T
8560: 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66  he auto-commit f
8570: 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68 65  lag is true, the
8580: 72 65 20 61 72 65 20 6e 6f 20 6f 74 68 65 72 20  re are no other 
8590: 61 63 74 69 76 65 20 71 75 65 72 69 65 73 0a 20  active queries. 
85a0: 20 20 20 20 20 2a 2a 20 75 73 69 6e 67 20 74 68       ** using th
85b0: 69 73 20 68 61 6e 64 6c 65 20 61 6e 64 20 74 68  is handle and th
85c0: 65 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20 77  e vdbe program w
85d0: 61 73 20 73 75 63 63 65 73 73 66 75 6c 20 6f 72  as successful or
85e0: 20 68 69 74 20 61 6e 0a 20 20 20 20 20 20 2a 2a   hit an.      **
85f0: 20 27 4f 52 20 46 41 49 4c 27 20 63 6f 6e 73 74   'OR FAIL' const
8600: 72 61 69 6e 74 2e 20 54 68 69 73 20 6d 65 61 6e  raint. This mean
8610: 73 20 61 20 63 6f 6d 6d 69 74 20 69 73 20 72 65  s a commit is re
8620: 71 75 69 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f  quired..      */
8630: 0a 20 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20  .      int rc = 
8640: 76 64 62 65 43 6f 6d 6d 69 74 28 64 62 29 3b 0a  vdbeCommit(db);.
8650: 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51        if( rc==SQ
8660: 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20  LITE_BUSY ){.   
8670: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49       return SQLI
8680: 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 7d  TE_BUSY;.      }
8690: 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c  else if( rc!=SQL
86a0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
86b0: 20 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20    p->rc = rc;.  
86c0: 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71        xFunc = sq
86d0: 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61  lite3BtreeRollba
86e0: 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ck;.      }.    
86f0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 78 46 75  }else{.      xFu
8700: 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  nc = sqlite3Btre
8710: 65 52 6f 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 7d  eRollback;.    }
8720: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66  .  }else{.    if
8730: 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f  ( p->rc==SQLITE_
8740: 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72 6f 72 41 63  OK || p->errorAc
8750: 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20 29 7b  tion==OE_Fail ){
8760: 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73  .      xFunc = s
8770: 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69  qlite3BtreeCommi
8780: 74 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c 73 65  tStmt;.    }else
8790: 20 69 66 28 20 70 2d 3e 65 72 72 6f 72 41 63 74   if( p->errorAct
87a0: 69 6f 6e 3d 3d 4f 45 5f 41 62 6f 72 74 20 29 7b  ion==OE_Abort ){
87b0: 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73  .      xFunc = s
87c0: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62  qlite3BtreeRollb
87d0: 61 63 6b 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c  ackStmt;.    }el
87e0: 73 65 7b 0a 20 20 20 20 20 20 78 46 75 6e 63 20  se{.      xFunc 
87f0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f  = sqlite3BtreeRo
8800: 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 20 20 64 62  llback;.      db
8810: 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31  ->autoCommit = 1
8820: 3b 0a 20 20 20 20 20 20 61 62 6f 72 74 4f 74 68  ;.      abortOth
8830: 65 72 41 63 74 69 76 65 56 64 62 65 73 28 70 29  erActiveVdbes(p)
8840: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
8850: 2a 20 49 66 20 78 46 75 6e 63 20 69 73 20 6e 6f  * If xFunc is no
8860: 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 74 20  t NULL, then it 
8870: 69 73 20 6f 6e 65 20 6f 66 20 73 71 6c 69 74 65  is one of sqlite
8880: 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 2c 0a  3BtreeRollback,.
8890: 20 20 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65    ** sqlite3Btre
88a0: 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 20 6f 72  eRollbackStmt or
88b0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
88c0: 6d 69 74 53 74 6d 74 2e 20 43 61 6c 6c 20 69 74  mitStmt. Call it
88d0: 20 6f 6e 63 65 20 6f 6e 0a 20 20 2a 2a 20 65 61   once on.  ** ea
88e0: 63 68 20 62 61 63 6b 65 6e 64 2e 20 49 66 20 61  ch backend. If a
88f0: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61  n error occurs a
8900: 6e 64 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f  nd the return co
8910: 64 65 20 69 73 20 73 74 69 6c 6c 0a 20 20 2a 2a  de is still.  **
8920: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 73 65 74 20   SQLITE_OK, set 
8930: 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20  the return code 
8940: 74 6f 20 74 68 65 20 6e 65 77 20 65 72 72 6f 72  to the new error
8950: 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 66   value..  */.  f
8960: 6f 72 28 69 3d 30 3b 20 78 46 75 6e 63 20 26 26  or(i=0; xFunc &&
8970: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
8980: 7b 20 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20  { .    int rc;. 
8990: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
89a0: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
89b0: 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20      if( pBt ){. 
89c0: 20 20 20 20 20 72 63 20 3d 20 78 46 75 6e 63 28       rc = xFunc(
89d0: 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20  pBt);.      if( 
89e0: 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  p->rc==SQLITE_OK
89f0: 20 29 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20   ) p->rc = rc;. 
8a00: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49     }.  }..  /* I
8a10: 66 20 74 68 69 73 20 77 61 73 20 61 6e 20 49 4e  f this was an IN
8a20: 53 45 52 54 2c 20 55 50 44 41 54 45 20 6f 72 20  SERT, UPDATE or 
8a30: 44 45 4c 45 54 45 2c 20 73 65 74 20 74 68 65 20  DELETE, set the 
8a40: 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20  change counter. 
8a50: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 63 68 61 6e  */.  if( p->chan
8a60: 67 65 43 6e 74 4f 6e 20 26 26 20 70 2d 3e 70 63  geCntOn && p->pc
8a70: 3e 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 21  >=0 ){.    if( !
8a80: 78 46 75 6e 63 20 7c 7c 20 78 46 75 6e 63 3d 3d  xFunc || xFunc==
8a90: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
8aa0: 69 74 53 74 6d 74 20 29 7b 0a 20 20 20 20 20 20  itStmt ){.      
8ab0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 68  sqlite3VdbeSetCh
8ac0: 61 6e 67 65 73 28 64 62 2c 20 70 2d 3e 6e 43 68  anges(db, p->nCh
8ad0: 61 6e 67 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65  ange);.    }else
8ae0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  {.      sqlite3V
8af0: 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 64 62  dbeSetChanges(db
8b00: 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  , 0);.    }.    
8b10: 70 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a  p->nChange = 0;.
8b20: 20 20 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61    }..  /* Rollba
8b30: 63 6b 20 6f 72 20 63 6f 6d 6d 69 74 20 61 6e 79  ck or commit any
8b40: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 20   schema changes 
8b50: 74 68 61 74 20 6f 63 63 75 72 72 65 64 2e 20 2a  that occurred. *
8b60: 2f 0a 20 20 69 66 28 20 70 2d 3e 72 63 21 3d 53  /.  if( p->rc!=S
8b70: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
8b80: 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 49  sqlite3RollbackI
8b90: 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64  nternalChanges(d
8ba0: 62 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  b);.  }else if( 
8bb0: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
8bc0: 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73  TE_InternChanges
8bd0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43   ){.    sqlite3C
8be0: 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61  ommitInternalCha
8bf0: 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20  nges(db);.  }.. 
8c00: 20 2f 2a 20 57 65 20 68 61 76 65 20 73 75 63 63   /* We have succ
8c10: 65 73 73 66 75 6c 6c 79 20 68 61 6c 74 65 64 20  essfully halted 
8c20: 61 6e 64 20 63 6c 6f 73 65 64 20 74 68 65 20 56  and closed the V
8c30: 4d 2e 20 20 52 65 63 6f 72 64 20 74 68 69 73 20  M.  Record this 
8c40: 66 61 63 74 2e 20 2a 2f 0a 20 20 69 66 28 20 70  fact. */.  if( p
8c50: 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 64  ->pc>=0 ){.    d
8c60: 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74  b->activeVdbeCnt
8c70: 2d 2d 3b 0a 20 20 7d 0a 20 20 70 2d 3e 6d 61 67  --;.  }.  p->mag
8c80: 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f  ic = VDBE_MAGIC_
8c90: 48 41 4c 54 3b 0a 20 20 63 68 65 63 6b 41 63 74  HALT;.  checkAct
8ca0: 69 76 65 56 64 62 65 43 6e 74 28 64 62 29 3b 0a  iveVdbeCnt(db);.
8cb0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
8cc0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c  _OK;.}../*.** Cl
8cd0: 65 61 6e 20 75 70 20 61 20 56 44 42 45 20 61 66  ean up a VDBE af
8ce0: 74 65 72 20 65 78 65 63 75 74 69 6f 6e 20 62 75  ter execution bu
8cf0: 74 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20  t do not delete 
8d00: 74 68 65 20 56 44 42 45 20 6a 75 73 74 20 79 65  the VDBE just ye
8d10: 74 2e 0a 2a 2a 20 57 72 69 74 65 20 61 6e 79 20  t..** Write any 
8d20: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 69  error messages i
8d30: 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 20 20  nto *pzErrMsg.  
8d40: 52 65 74 75 72 6e 20 74 68 65 20 72 65 73 75 6c  Return the resul
8d50: 74 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 66  t code..**.** Af
8d60: 74 65 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65  ter this routine
8d70: 20 69 73 20 72 75 6e 2c 20 74 68 65 20 56 44 42   is run, the VDB
8d80: 45 20 73 68 6f 75 6c 64 20 62 65 20 72 65 61 64  E should be read
8d90: 79 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64  y to be executed
8da0: 0a 2a 2a 20 61 67 61 69 6e 2e 0a 2a 2a 0a 2a 2a  .** again..**.**
8db0: 20 54 6f 20 6c 6f 6f 6b 20 61 74 20 69 74 20 61   To look at it a
8dc0: 6e 6f 74 68 65 72 20 77 61 79 2c 20 74 68 69 73  nother way, this
8dd0: 20 72 6f 75 74 69 6e 65 20 72 65 73 65 74 73 20   routine resets 
8de0: 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65  the state of the
8df0: 0a 2a 2a 20 76 69 72 74 75 61 6c 20 6d 61 63 68  .** virtual mach
8e00: 69 6e 65 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41  ine from VDBE_MA
8e10: 47 49 43 5f 52 55 4e 20 6f 72 20 56 44 42 45 5f  GIC_RUN or VDBE_
8e20: 4d 41 47 49 43 5f 48 41 4c 54 20 62 61 63 6b 20  MAGIC_HALT back 
8e30: 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43  to.** VDBE_MAGIC
8e40: 5f 49 4e 49 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71  _INIT..*/.int sq
8e50: 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28 56  lite3VdbeReset(V
8e60: 64 62 65 20 2a 70 29 7b 0a 20 20 69 66 28 20 70  dbe *p){.  if( p
8e70: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
8e80: 47 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 6d 61  GIC_RUN && p->ma
8e90: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
8ea0: 48 41 4c 54 20 29 7b 0a 20 20 20 20 73 71 6c 69  HALT ){.    sqli
8eb0: 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20  te3Error(p->db, 
8ec0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 30  SQLITE_MISUSE, 0
8ed0: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
8ee0: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d  LITE_MISUSE;.  }
8ef0: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 56 4d  ..  /* If the VM
8f00: 20 64 69 64 20 6e 6f 74 20 72 75 6e 20 74 6f 20   did not run to 
8f10: 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 72 20 69 66  completion or if
8f20: 20 69 74 20 65 6e 63 6f 75 6e 74 65 72 65 64 20   it encountered 
8f30: 61 6e 0a 20 20 2a 2a 20 65 72 72 6f 72 2c 20 74  an.  ** error, t
8f40: 68 65 6e 20 69 74 20 6d 69 67 68 74 20 6e 6f 74  hen it might not
8f50: 20 68 61 76 65 20 62 65 65 6e 20 68 61 6c 74 65   have been halte
8f60: 64 20 70 72 6f 70 65 72 6c 79 2e 20 20 53 6f 20  d properly.  So 
8f70: 68 61 6c 74 0a 20 20 2a 2a 20 69 74 20 6e 6f 77  halt.  ** it now
8f80: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ..  */.  sqlite3
8f90: 56 64 62 65 48 61 6c 74 28 70 29 3b 0a 0a 20 20  VdbeHalt(p);..  
8fa0: 2f 2a 20 49 66 20 74 68 65 20 56 44 42 45 20 68  /* If the VDBE h
8fb0: 61 73 20 62 65 20 72 75 6e 20 65 76 65 6e 20 70  as be run even p
8fc0: 61 72 74 69 61 6c 6c 79 2c 20 74 68 65 6e 20 74  artially, then t
8fd0: 72 61 6e 73 66 65 72 20 74 68 65 20 65 72 72 6f  ransfer the erro
8fe0: 72 20 63 6f 64 65 0a 20 20 2a 2a 20 61 6e 64 20  r code.  ** and 
8ff0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 72  error message fr
9000: 6f 6d 20 74 68 65 20 56 44 42 45 20 69 6e 74 6f  om the VDBE into
9010: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61   the main databa
9020: 73 65 20 73 74 72 75 63 74 75 72 65 2e 20 20 42  se structure.  B
9030: 75 74 0a 20 20 2a 2a 20 69 66 20 74 68 65 20 56  ut.  ** if the V
9040: 44 42 45 20 68 61 73 20 6a 75 73 74 20 62 65 65  DBE has just bee
9050: 6e 20 73 65 74 20 74 6f 20 72 75 6e 20 62 75 74  n set to run but
9060: 20 68 61 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c   has not actuall
9070: 79 20 65 78 65 63 75 74 65 64 20 61 6e 79 0a 20  y executed any. 
9080: 20 2a 2a 20 69 6e 73 74 72 75 63 74 69 6f 6e 73   ** instructions
9090: 20 79 65 74 2c 20 6c 65 61 76 65 20 74 68 65 20   yet, leave the 
90a0: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 65 72  main database er
90b0: 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ror information 
90c0: 75 6e 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2f 0a  unchanged..  */.
90d0: 20 20 69 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29    if( p->pc>=0 )
90e0: 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 7a 45 72  {.    if( p->zEr
90f0: 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 73 71  rMsg ){.      sq
9100: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62  lite3Error(p->db
9110: 2c 20 70 2d 3e 72 63 2c 20 22 25 73 22 2c 20 70  , p->rc, "%s", p
9120: 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  ->zErrMsg);.    
9130: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
9140: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20  zErrMsg);.      
9150: 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a  p->zErrMsg = 0;.
9160: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d      }else if( p-
9170: 3e 72 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  >rc ){.      sql
9180: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c  ite3Error(p->db,
9190: 20 70 2d 3e 72 63 2c 20 30 29 3b 0a 20 20 20 20   p->rc, 0);.    
91a0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
91b0: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c  ite3Error(p->db,
91c0: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a   SQLITE_OK, 0);.
91d0: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66      }.  }else if
91e0: 28 20 70 2d 3e 72 63 20 26 26 20 70 2d 3e 65 78  ( p->rc && p->ex
91f0: 70 69 72 65 64 20 29 7b 0a 20 20 20 20 2f 2a 20  pired ){.    /* 
9200: 54 68 65 20 65 78 70 69 72 65 64 20 66 6c 61 67  The expired flag
9210: 20 77 61 73 20 73 65 74 20 6f 6e 20 74 68 65 20   was set on the 
9220: 56 44 42 45 20 62 65 66 6f 72 65 20 74 68 65 20  VDBE before the 
9230: 66 69 72 73 74 20 63 61 6c 6c 0a 20 20 20 20 2a  first call.    *
9240: 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f 73 74 65  * to sqlite3_ste
9250: 70 28 29 2e 20 46 6f 72 20 63 6f 6e 73 69 73 74  p(). For consist
9260: 65 6e 63 79 20 28 73 69 6e 63 65 20 73 71 6c 69  ency (since sqli
9270: 74 65 33 5f 73 74 65 70 28 29 20 77 61 73 0a 20  te3_step() was. 
9280: 20 20 20 2a 2a 20 63 61 6c 6c 65 64 29 2c 20 73     ** called), s
9290: 65 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20  et the database 
92a0: 65 72 72 6f 72 20 69 6e 20 74 68 69 73 20 63 61  error in this ca
92b0: 73 65 20 61 73 20 77 65 6c 6c 2e 0a 20 20 20 20  se as well..    
92c0: 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72  */.    sqlite3Er
92d0: 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63  ror(p->db, p->rc
92e0: 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  , 0);.  }..  /* 
92f0: 52 65 63 6c 61 69 6d 20 61 6c 6c 20 6d 65 6d 6f  Reclaim all memo
9300: 72 79 20 75 73 65 64 20 62 79 20 74 68 65 20 56  ry used by the V
9310: 44 42 45 0a 20 20 2a 2f 0a 20 20 43 6c 65 61 6e  DBE.  */.  Clean
9320: 75 70 28 70 29 3b 0a 0a 20 20 2f 2a 20 53 61 76  up(p);..  /* Sav
9330: 65 20 70 72 6f 66 69 6c 69 6e 67 20 69 6e 66 6f  e profiling info
9340: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 69  rmation from thi
9350: 73 20 56 44 42 45 20 72 75 6e 2e 0a 20 20 2a 2f  s VDBE run..  */
9360: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 54  .  assert( p->pT
9370: 6f 73 3c 26 70 2d 3e 61 53 74 61 63 6b 5b 70 2d  os<&p->aStack[p-
9380: 3e 70 63 3c 30 3f 30 3a 70 2d 3e 70 63 5d 20 7c  >pc<0?0:p->pc] |
9390: 7c 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  | sqlite3_malloc
93a0: 5f 66 61 69 6c 65 64 3d 3d 31 20 29 3b 0a 23 69  _failed==1 );.#i
93b0: 66 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c  fdef VDBE_PROFIL
93c0: 45 0a 20 20 7b 0a 20 20 20 20 46 49 4c 45 20 2a  E.  {.    FILE *
93d0: 6f 75 74 20 3d 20 66 6f 70 65 6e 28 22 76 64 62  out = fopen("vdb
93e0: 65 5f 70 72 6f 66 69 6c 65 2e 6f 75 74 22 2c 20  e_profile.out", 
93f0: 22 61 22 29 3b 0a 20 20 20 20 69 66 28 20 6f 75  "a");.    if( ou
9400: 74 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69  t ){.      int i
9410: 3b 0a 20 20 20 20 20 20 66 70 72 69 6e 74 66 28  ;.      fprintf(
9420: 6f 75 74 2c 20 22 2d 2d 2d 2d 20 22 29 3b 0a 20  out, "---- ");. 
9430: 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c       for(i=0; i<
9440: 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20  p->nOp; i++){.  
9450: 20 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75        fprintf(ou
9460: 74 2c 20 22 25 30 32 78 22 2c 20 70 2d 3e 61 4f  t, "%02x", p->aO
9470: 70 5b 69 5d 2e 6f 70 63 6f 64 65 29 3b 0a 20 20  p[i].opcode);.  
9480: 20 20 20 20 7d 0a 20 20 20 20 20 20 66 70 72 69      }.      fpri
9490: 6e 74 66 28 6f 75 74 2c 20 22 5c 6e 22 29 3b 0a  ntf(out, "\n");.
94a0: 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69        for(i=0; i
94b0: 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20  <p->nOp; i++){. 
94c0: 20 20 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f         fprintf(o
94d0: 75 74 2c 20 22 25 36 64 20 25 31 30 6c 6c 64 20  ut, "%6d %10lld 
94e0: 25 38 6c 6c 64 20 22 2c 0a 20 20 20 20 20 20 20  %8lld ",.       
94f0: 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e      p->aOp[i].cn
9500: 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 2d  t,.           p-
9510: 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 2c 0a  >aOp[i].cycles,.
9520: 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f             p->aO
9530: 70 5b 69 5d 2e 63 6e 74 3e 30 20 3f 20 70 2d 3e  p[i].cnt>0 ? p->
9540: 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 2f 70 2d  aOp[i].cycles/p-
9550: 3e 61 4f 70 5b 69 5d 2e 63 6e 74 20 3a 20 30 0a  >aOp[i].cnt : 0.
9560: 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20          );.     
9570: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 50 72     sqlite3VdbePr
9580: 69 6e 74 4f 70 28 6f 75 74 2c 20 69 2c 20 26 70  intOp(out, i, &p
9590: 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20 20 20 20 20  ->aOp[i]);.     
95a0: 20 7d 0a 20 20 20 20 20 20 66 63 6c 6f 73 65 28   }.      fclose(
95b0: 6f 75 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  out);.    }.  }.
95c0: 23 65 6e 64 69 66 0a 20 20 70 2d 3e 6d 61 67 69  #endif.  p->magi
95d0: 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  c = VDBE_MAGIC_I
95e0: 4e 49 54 3b 0a 20 20 70 2d 3e 61 62 6f 72 74 65  NIT;.  p->aborte
95f0: 64 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 2d 3e  d = 0;.  if( p->
9600: 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d  rc==SQLITE_SCHEM
9610: 41 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  A ){.    sqlite3
9620: 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68  ResetInternalSch
9630: 65 6d 61 28 70 2d 3e 64 62 2c 20 30 29 3b 0a 20  ema(p->db, 0);. 
9640: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 72   }.  return p->r
9650: 63 3b 0a 7d 0a 20 0a 2f 2a 0a 2a 2a 20 43 6c 65  c;.}. ./*.** Cle
9660: 61 6e 20 75 70 20 61 6e 64 20 64 65 6c 65 74 65  an up and delete
9670: 20 61 20 56 44 42 45 20 61 66 74 65 72 20 65 78   a VDBE after ex
9680: 65 63 75 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e  ecution.  Return
9690: 20 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63   an integer whic
96a0: 68 20 69 73 0a 2a 2a 20 74 68 65 20 72 65 73 75  h is.** the resu
96b0: 6c 74 20 63 6f 64 65 2e 20 20 57 72 69 74 65 20  lt code.  Write 
96c0: 61 6e 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67  any error messag
96d0: 65 20 74 65 78 74 20 69 6e 74 6f 20 2a 70 7a 45  e text into *pzE
96e0: 72 72 4d 73 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71  rrMsg..*/.int sq
96f0: 6c 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a  lite3VdbeFinaliz
9700: 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  e(Vdbe *p){.  in
9710: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
9720: 3b 0a 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69  ;..  if( p->magi
9730: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c==VDBE_MAGIC_RU
9740: 4e 20 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  N || p->magic==V
9750: 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29  DBE_MAGIC_HALT )
9760: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
9770: 65 33 56 64 62 65 52 65 73 65 74 28 70 29 3b 0a  e3VdbeReset(p);.
9780: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6d    }else if( p->m
9790: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43  agic!=VDBE_MAGIC
97a0: 5f 49 4e 49 54 20 29 7b 0a 20 20 20 20 72 65 74  _INIT ){.    ret
97b0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
97c0: 45 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  E;.  }.  sqlite3
97d0: 56 64 62 65 44 65 6c 65 74 65 28 70 29 3b 0a 20  VdbeDelete(p);. 
97e0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
97f0: 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 65 20 64 65  *.** Call the de
9800: 73 74 72 75 63 74 6f 72 20 66 6f 72 20 65 61 63  structor for eac
9810: 68 20 61 75 78 64 61 74 61 20 65 6e 74 72 79 20  h auxdata entry 
9820: 69 6e 20 70 56 64 62 65 46 75 6e 63 20 66 6f 72  in pVdbeFunc for
9830: 20 77 68 69 63 68 0a 2a 2a 20 74 68 65 20 63 6f   which.** the co
9840: 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20  rresponding bit 
9850: 69 6e 20 6d 61 73 6b 20 69 73 20 63 6c 65 61 72  in mask is clear
9860: 2e 20 20 41 75 78 64 61 74 61 20 65 6e 74 72 69  .  Auxdata entri
9870: 65 73 20 62 65 79 6f 6e 64 20 33 31 0a 2a 2a 20  es beyond 31.** 
9880: 61 72 65 20 61 6c 77 61 79 73 20 64 65 73 74 72  are always destr
9890: 6f 79 65 64 2e 20 20 54 6f 20 64 65 73 74 72 6f  oyed.  To destro
98a0: 79 20 61 6c 6c 20 61 75 78 64 61 74 61 20 65 6e  y all auxdata en
98b0: 74 72 69 65 73 2c 20 63 61 6c 6c 20 74 68 69 73  tries, call this
98c0: 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 77 69 74 68  .** routine with
98d0: 20 6d 61 73 6b 3d 3d 30 2e 0a 2a 2f 0a 76 6f 69   mask==0..*/.voi
98e0: 64 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c  d sqlite3VdbeDel
98f0: 65 74 65 41 75 78 44 61 74 61 28 56 64 62 65 46  eteAuxData(VdbeF
9900: 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 2c 20  unc *pVdbeFunc, 
9910: 69 6e 74 20 6d 61 73 6b 29 7b 0a 20 20 69 6e 74  int mask){.  int
9920: 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69   i;.  for(i=0; i
9930: 3c 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78  <pVdbeFunc->nAux
9940: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75  ; i++){.    stru
9950: 63 74 20 41 75 78 44 61 74 61 20 2a 70 41 75 78  ct AuxData *pAux
9960: 20 3d 20 26 70 56 64 62 65 46 75 6e 63 2d 3e 61   = &pVdbeFunc->a
9970: 70 41 75 78 5b 69 5d 3b 0a 20 20 20 20 69 66 28  pAux[i];.    if(
9980: 20 28 69 3e 33 31 20 7c 7c 20 21 28 6d 61 73 6b   (i>31 || !(mask
9990: 26 28 31 3c 3c 69 29 29 29 20 26 26 20 70 41 75  &(1<<i))) && pAu
99a0: 78 2d 3e 70 41 75 78 20 29 7b 0a 20 20 20 20 20  x->pAux ){.     
99b0: 20 69 66 28 20 70 41 75 78 2d 3e 78 44 65 6c 65   if( pAux->xDele
99c0: 74 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70 41  te ){.        pA
99d0: 75 78 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78  ux->xDelete(pAux
99e0: 2d 3e 70 41 75 78 29 3b 0a 20 20 20 20 20 20 7d  ->pAux);.      }
99f0: 0a 20 20 20 20 20 20 70 41 75 78 2d 3e 70 41 75  .      pAux->pAu
9a00: 78 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d  x = 0;.    }.  }
9a10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65  .}../*.** Delete
9a20: 20 61 6e 20 65 6e 74 69 72 65 20 56 44 42 45 2e   an entire VDBE.
9a30: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
9a40: 56 64 62 65 44 65 6c 65 74 65 28 56 64 62 65 20  VdbeDelete(Vdbe 
9a50: 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  *p){.  int i;.  
9a60: 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72  if( p==0 ) retur
9a70: 6e 3b 0a 20 20 43 6c 65 61 6e 75 70 28 70 29 3b  n;.  Cleanup(p);
9a80: 0a 20 20 69 66 28 20 70 2d 3e 70 50 72 65 76 20  .  if( p->pPrev 
9a90: 29 7b 0a 20 20 20 20 70 2d 3e 70 50 72 65 76 2d  ){.    p->pPrev-
9aa0: 3e 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78  >pNext = p->pNex
9ab0: 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  t;.  }else{.    
9ac0: 61 73 73 65 72 74 28 20 70 2d 3e 64 62 2d 3e 70  assert( p->db->p
9ad0: 56 64 62 65 3d 3d 70 20 29 3b 0a 20 20 20 20 70  Vdbe==p );.    p
9ae0: 2d 3e 64 62 2d 3e 70 56 64 62 65 20 3d 20 70 2d  ->db->pVdbe = p-
9af0: 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66  >pNext;.  }.  if
9b00: 28 20 70 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20  ( p->pNext ){.  
9b10: 20 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65    p->pNext->pPre
9b20: 76 20 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 20 20  v = p->pPrev;.  
9b30: 7d 0a 20 20 69 66 28 20 70 2d 3e 61 4f 70 20 29  }.  if( p->aOp )
9b40: 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  {.    for(i=0; i
9b50: 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20  <p->nOp; i++){. 
9b60: 20 20 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26       Op *pOp = &
9b70: 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 20  p->aOp[i];.     
9b80: 20 69 66 28 20 70 4f 70 2d 3e 70 33 74 79 70 65   if( pOp->p3type
9b90: 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20  ==P3_DYNAMIC || 
9ba0: 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f  pOp->p3type==P3_
9bb0: 4b 45 59 49 4e 46 4f 20 29 7b 0a 20 20 20 20 20  KEYINFO ){.     
9bc0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 4f     sqliteFree(pO
9bd0: 70 2d 3e 70 33 29 3b 0a 20 20 20 20 20 20 7d 0a  p->p3);.      }.
9be0: 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70        if( pOp->p
9bf0: 33 74 79 70 65 3d 3d 50 33 5f 56 44 42 45 46 55  3type==P3_VDBEFU
9c00: 4e 43 20 29 7b 0a 20 20 20 20 20 20 20 20 56 64  NC ){.        Vd
9c10: 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e  beFunc *pVdbeFun
9c20: 63 20 3d 20 28 56 64 62 65 46 75 6e 63 20 2a 29  c = (VdbeFunc *)
9c30: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 20  pOp->p3;.       
9c40: 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65   sqlite3VdbeDele
9c50: 74 65 41 75 78 44 61 74 61 28 70 56 64 62 65 46  teAuxData(pVdbeF
9c60: 75 6e 63 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  unc, 0);.       
9c70: 20 73 71 6c 69 74 65 46 72 65 65 28 70 56 64 62   sqliteFree(pVdb
9c80: 65 46 75 6e 63 29 3b 0a 20 20 20 20 20 20 7d 0a  eFunc);.      }.
9c90: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
9ca0: 46 72 65 65 28 70 2d 3e 61 4f 70 29 3b 0a 20 20  Free(p->aOp);.  
9cb0: 7d 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72  }.  releaseMemAr
9cc0: 72 61 79 28 70 2d 3e 61 56 61 72 2c 20 70 2d 3e  ray(p->aVar, p->
9cd0: 6e 56 61 72 29 3b 0a 20 20 73 71 6c 69 74 65 46  nVar);.  sqliteF
9ce0: 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a  ree(p->aLabel);.
9cf0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
9d00: 61 53 74 61 63 6b 29 3b 0a 20 20 72 65 6c 65 61  aStack);.  relea
9d10: 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 43  seMemArray(p->aC
9d20: 6f 6c 4e 61 6d 65 2c 20 70 2d 3e 6e 52 65 73 43  olName, p->nResC
9d30: 6f 6c 75 6d 6e 2a 32 29 3b 0a 20 20 73 71 6c 69  olumn*2);.  sqli
9d40: 74 65 46 72 65 65 28 70 2d 3e 61 43 6f 6c 4e 61  teFree(p->aColNa
9d50: 6d 65 29 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20  me);.  p->magic 
9d60: 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 44 45 41  = VDBE_MAGIC_DEA
9d70: 44 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  D;.  sqliteFree(
9d80: 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20  p);.}../*.** If 
9d90: 61 20 4d 6f 76 65 54 6f 20 6f 70 65 72 61 74 69  a MoveTo operati
9da0: 6f 6e 20 69 73 20 70 65 6e 64 69 6e 67 20 6f 6e  on is pending on
9db0: 20 74 68 65 20 67 69 76 65 6e 20 63 75 72 73 6f   the given curso
9dc0: 72 2c 20 74 68 65 6e 20 64 6f 20 74 68 61 74 0a  r, then do that.
9dd0: 2a 2a 20 4d 6f 76 65 54 6f 20 6e 6f 77 2e 20 20  ** MoveTo now.  
9de0: 52 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20  Return an error 
9df0: 63 6f 64 65 2e 20 20 49 66 20 6e 6f 20 4d 6f 76  code.  If no Mov
9e00: 65 54 6f 20 69 73 20 70 65 6e 64 69 6e 67 2c 20  eTo is pending, 
9e10: 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20  this.** routine 
9e20: 64 6f 65 73 20 6e 6f 74 68 69 6e 67 20 61 6e 64  does nothing and
9e30: 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f   returns SQLITE_
9e40: 4f 4b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  OK..*/.int sqlit
9e50: 65 33 56 64 62 65 43 75 72 73 6f 72 4d 6f 76 65  e3VdbeCursorMove
9e60: 74 6f 28 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20  to(Cursor *p){. 
9e70: 20 69 66 28 20 70 2d 3e 64 65 66 65 72 72 65 64   if( p->deferred
9e80: 4d 6f 76 65 74 6f 20 29 7b 0a 20 20 20 20 69 6e  Moveto ){.    in
9e90: 74 20 72 65 73 3b 0a 20 20 20 20 65 78 74 65 72  t res;.    exter
9ea0: 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 65  n int sqlite3_se
9eb0: 61 72 63 68 5f 63 6f 75 6e 74 3b 0a 20 20 20 20  arch_count;.    
9ec0: 61 73 73 65 72 74 28 20 70 2d 3e 69 6e 74 4b 65  assert( p->intKe
9ed0: 79 20 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e  y );.    if( p->
9ee0: 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20  intKey ){.      
9ef0: 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65  sqlite3BtreeMove
9f00: 74 6f 28 70 2d 3e 70 43 75 72 73 6f 72 2c 20 30  to(p->pCursor, 0
9f10: 2c 20 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65  , p->movetoTarge
9f20: 74 2c 20 26 72 65 73 29 3b 0a 20 20 20 20 7d 65  t, &res);.    }e
9f30: 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  lse{.      sqlit
9f40: 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 28 70 2d  e3BtreeMoveto(p-
9f50: 3e 70 43 75 72 73 6f 72 2c 28 63 68 61 72 2a 29  >pCursor,(char*)
9f60: 26 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74  &p->movetoTarget
9f70: 2c 73 69 7a 65 6f 66 28 69 36 34 29 2c 26 72 65  ,sizeof(i64),&re
9f80: 73 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2a 70  s);.    }.    *p
9f90: 2d 3e 70 49 6e 63 72 4b 65 79 20 3d 20 30 3b 0a  ->pIncrKey = 0;.
9fa0: 20 20 20 20 70 2d 3e 6c 61 73 74 52 65 63 6e 6f      p->lastRecno
9fb0: 20 3d 20 6b 65 79 54 6f 49 6e 74 28 70 2d 3e 6d   = keyToInt(p->m
9fc0: 6f 76 65 74 6f 54 61 72 67 65 74 29 3b 0a 20 20  ovetoTarget);.  
9fd0: 20 20 70 2d 3e 72 65 63 6e 6f 49 73 56 61 6c 69    p->recnoIsVali
9fe0: 64 20 3d 20 72 65 73 3d 3d 30 3b 0a 20 20 20 20  d = res==0;.    
9ff0: 69 66 28 20 72 65 73 3c 30 20 29 7b 0a 20 20 20  if( res<0 ){.   
a000: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e     sqlite3BtreeN
a010: 65 78 74 28 70 2d 3e 70 43 75 72 73 6f 72 2c 20  ext(p->pCursor, 
a020: 26 72 65 73 29 3b 0a 20 20 20 20 7d 0a 20 20 20  &res);.    }.   
a030: 20 73 71 6c 69 74 65 33 5f 73 65 61 72 63 68 5f   sqlite3_search_
a040: 63 6f 75 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e  count++;.    p->
a050: 64 65 66 65 72 72 65 64 4d 6f 76 65 74 6f 20 3d  deferredMoveto =
a060: 20 30 3b 0a 20 20 20 20 70 2d 3e 63 61 63 68 65   0;.    p->cache
a070: 56 61 6c 69 64 20 3d 20 30 3b 0a 20 20 7d 0a 20  Valid = 0;.  }. 
a080: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
a090: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  K;.}../*.** The 
a0a0: 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69  following functi
a0b0: 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74  ons:.**.** sqlit
a0c0: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
a0d0: 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62  ().** sqlite3Vdb
a0e0: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 29  eSerialTypeLen()
a0f0: 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53  .** sqlite3VdbeS
a100: 65 72 69 61 6c 52 65 61 64 28 29 0a 2a 2a 20 73  erialRead().** s
a110: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
a120: 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33  Len().** sqlite3
a130: 56 64 62 65 53 65 72 69 61 6c 57 72 69 74 65 28  VdbeSerialWrite(
a140: 29 0a 2a 2a 0a 2a 2a 20 65 6e 63 61 70 73 75 6c  ).**.** encapsul
a150: 61 74 65 20 74 68 65 20 63 6f 64 65 20 74 68 61  ate the code tha
a160: 74 20 73 65 72 69 61 6c 69 7a 65 73 20 76 61 6c  t serializes val
a170: 75 65 73 20 66 6f 72 20 73 74 6f 72 61 67 65 20  ues for storage 
a180: 69 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 64 61 74  in SQLite.** dat
a190: 61 20 61 6e 64 20 69 6e 64 65 78 20 72 65 63 6f  a and index reco
a1a0: 72 64 73 2e 20 45 61 63 68 20 73 65 72 69 61 6c  rds. Each serial
a1b0: 69 7a 65 64 20 76 61 6c 75 65 20 63 6f 6e 73 69  ized value consi
a1c0: 73 74 73 20 6f 66 20 61 0a 2a 2a 20 27 73 65 72  sts of a.** 'ser
a1d0: 69 61 6c 2d 74 79 70 65 27 20 61 6e 64 20 61 20  ial-type' and a 
a1e0: 62 6c 6f 62 20 6f 66 20 64 61 74 61 2e 20 54 68  blob of data. Th
a1f0: 65 20 73 65 72 69 61 6c 20 74 79 70 65 20 69 73  e serial type is
a200: 20 61 6e 20 38 2d 62 79 74 65 20 75 6e 73 69 67   an 8-byte unsig
a210: 6e 65 64 0a 2a 2a 20 69 6e 74 65 67 65 72 2c 20  ned.** integer, 
a220: 73 74 6f 72 65 64 20 61 73 20 61 20 76 61 72 69  stored as a vari
a230: 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 61 6e 20  nt..**.** In an 
a240: 53 51 4c 69 74 65 20 69 6e 64 65 78 20 72 65 63  SQLite index rec
a250: 6f 72 64 2c 20 74 68 65 20 73 65 72 69 61 6c 20  ord, the serial 
a260: 74 79 70 65 20 69 73 20 73 74 6f 72 65 64 20 64  type is stored d
a270: 69 72 65 63 74 6c 79 20 62 65 66 6f 72 65 0a 2a  irectly before.*
a280: 2a 20 74 68 65 20 62 6c 6f 62 20 6f 66 20 64 61  * the blob of da
a290: 74 61 20 74 68 61 74 20 69 74 20 63 6f 72 72 65  ta that it corre
a2a0: 73 70 6f 6e 64 73 20 74 6f 2e 20 49 6e 20 61 20  sponds to. In a 
a2b0: 74 61 62 6c 65 20 72 65 63 6f 72 64 2c 20 61 6c  table record, al
a2c0: 6c 20 73 65 72 69 61 6c 0a 2a 2a 20 74 79 70 65  l serial.** type
a2d0: 73 20 61 72 65 20 73 74 6f 72 65 64 20 61 74 20  s are stored at 
a2e0: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65  the start of the
a2f0: 20 72 65 63 6f 72 64 2c 20 61 6e 64 20 74 68 65   record, and the
a300: 20 62 6c 6f 62 73 20 6f 66 20 64 61 74 61 20 61   blobs of data a
a310: 74 0a 2a 2a 20 74 68 65 20 65 6e 64 2e 20 48 65  t.** the end. He
a320: 6e 63 65 20 74 68 65 73 65 20 66 75 6e 63 74 69  nce these functi
a330: 6f 6e 73 20 61 6c 6c 6f 77 20 74 68 65 20 63 61  ons allow the ca
a340: 6c 6c 65 72 20 74 6f 20 68 61 6e 64 6c 65 20 74  ller to handle t
a350: 68 65 0a 2a 2a 20 73 65 72 69 61 6c 2d 74 79 70  he.** serial-typ
a360: 65 20 61 6e 64 20 64 61 74 61 20 62 6c 6f 62 20  e and data blob 
a370: 73 65 70 65 72 61 74 65 6c 79 2e 0a 2a 2a 0a 2a  seperately..**.*
a380: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
a390: 74 61 62 6c 65 20 64 65 73 63 72 69 62 65 73 20  table describes 
a3a0: 74 68 65 20 76 61 72 69 6f 75 73 20 73 74 6f 72  the various stor
a3b0: 61 67 65 20 63 6c 61 73 73 65 73 20 66 6f 72 20  age classes for 
a3c0: 64 61 74 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 73 65  data:.**.**   se
a3d0: 72 69 61 6c 20 74 79 70 65 20 20 20 20 20 20 20  rial type       
a3e0: 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 20   bytes of data  
a3f0: 20 20 20 20 74 79 70 65 0a 2a 2a 20 20 20 2d 2d      type.**   --
a400: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20  ------------    
a410: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d   ---------------
a420: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d      ------------
a430: 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 30 20 20 20  ---.**      0   
a440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a450: 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 4e    0            N
a460: 55 4c 4c 0a 2a 2a 20 20 20 20 20 20 31 20 20 20  ULL.**      1   
a470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a480: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 73    1            s
a490: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a  igned integer.**
a4a0: 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20        2         
a4b0: 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20              2   
a4c0: 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20           signed 
a4d0: 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20  integer.**      
a4e0: 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  3               
a4f0: 20 20 20 20 20 20 33 20 20 20 20 20 20 20 20 20        3         
a500: 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65     signed intege
a510: 72 0a 2a 2a 20 20 20 20 20 20 34 20 20 20 20 20  r.**      4     
a520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a530: 34 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67  4            sig
a540: 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20  ned integer.**  
a550: 20 20 20 20 35 20 20 20 20 20 20 20 20 20 20 20      5           
a560: 20 20 20 20 20 20 20 20 20 20 36 20 20 20 20 20            6     
a570: 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e         signed in
a580: 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 36 20  teger.**      6 
a590: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a5a0: 20 20 20 20 38 20 20 20 20 20 20 20 20 20 20 20      8           
a5b0: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a   signed integer.
a5c0: 2a 2a 20 20 20 20 20 20 37 20 20 20 20 20 20 20  **      7       
a5d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 38 20                8 
a5e0: 20 20 20 20 20 20 20 20 20 20 20 49 45 45 45 20             IEEE 
a5f0: 66 6c 6f 61 74 0a 2a 2a 20 20 20 20 20 38 2d 31  float.**     8-1
a600: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1               
a610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a620: 20 72 65 73 65 72 76 65 64 20 66 6f 72 20 65 78   reserved for ex
a630: 70 61 6e 73 69 6f 6e 0a 2a 2a 20 20 20 20 4e 3e  pansion.**    N>
a640: 3d 31 32 20 61 6e 64 20 65 76 65 6e 20 20 20 20  =12 and even    
a650: 20 20 20 28 4e 2d 31 32 29 2f 32 20 20 20 20 20     (N-12)/2     
a660: 20 20 20 42 4c 4f 42 0a 2a 2a 20 20 20 20 4e 3e     BLOB.**    N>
a670: 3d 31 33 20 61 6e 64 20 6f 64 64 20 20 20 20 20  =13 and odd     
a680: 20 20 20 28 4e 2d 31 33 29 2f 32 20 20 20 20 20     (N-13)/2     
a690: 20 20 20 74 65 78 74 0a 2a 2a 0a 2a 2f 0a 0a 2f     text.**.*/../
a6a0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
a6b0: 73 65 72 69 61 6c 2d 74 79 70 65 20 66 6f 72 20  serial-type for 
a6c0: 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64  the value stored
a6d0: 20 69 6e 20 70 4d 65 6d 2e 0a 2a 2f 0a 75 33 32   in pMem..*/.u32
a6e0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
a6f0: 61 6c 54 79 70 65 28 4d 65 6d 20 2a 70 4d 65 6d  alType(Mem *pMem
a700: 29 7b 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 3d  ){.  int flags =
a710: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 3b 0a 0a 20   pMem->flags;.. 
a720: 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 4e   if( flags&MEM_N
a730: 75 6c 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ull ){.    retur
a740: 6e 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66  n 0;.  }.  if( f
a750: 6c 61 67 73 26 4d 45 4d 5f 49 6e 74 20 29 7b 0a  lags&MEM_Int ){.
a760: 20 20 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75      /* Figure ou
a770: 74 20 77 68 65 74 68 65 72 20 74 6f 20 75 73 65  t whether to use
a780: 20 31 2c 20 32 2c 20 34 2c 20 36 20 6f 72 20 38   1, 2, 4, 6 or 8
a790: 20 62 79 74 65 73 2e 20 2a 2f 0a 23 20 20 20 64   bytes. */.#   d
a7a0: 65 66 69 6e 65 20 4d 41 58 5f 36 42 59 54 45 20  efine MAX_6BYTE 
a7b0: 28 28 28 28 69 36 34 29 30 78 30 30 30 31 30 30  ((((i64)0x000100
a7c0: 30 30 29 3c 3c 33 32 29 2d 31 29 0a 20 20 20 20  00)<<32)-1).    
a7d0: 69 36 34 20 69 20 3d 20 70 4d 65 6d 2d 3e 69 3b  i64 i = pMem->i;
a7e0: 0a 20 20 20 20 69 66 28 20 69 3e 3d 2d 31 32 37  .    if( i>=-127
a7f0: 20 26 26 20 69 3c 3d 31 32 37 20 29 20 72 65 74   && i<=127 ) ret
a800: 75 72 6e 20 31 3b 0a 20 20 20 20 69 66 28 20 69  urn 1;.    if( i
a810: 3e 3d 2d 33 32 37 36 37 20 26 26 20 69 3c 3d 33  >=-32767 && i<=3
a820: 32 37 36 37 20 29 20 72 65 74 75 72 6e 20 32 3b  2767 ) return 2;
a830: 0a 20 20 20 20 69 66 28 20 69 3e 3d 2d 38 33 38  .    if( i>=-838
a840: 38 36 30 37 20 26 26 20 69 3c 3d 38 33 38 38 36  8607 && i<=83886
a850: 30 37 20 29 20 72 65 74 75 72 6e 20 33 3b 0a 20  07 ) return 3;. 
a860: 20 20 20 69 66 28 20 69 3e 3d 2d 32 31 34 37 34     if( i>=-21474
a870: 38 33 36 34 37 20 26 26 20 69 3c 3d 32 31 34 37  83647 && i<=2147
a880: 34 38 33 36 34 37 20 29 20 72 65 74 75 72 6e 20  483647 ) return 
a890: 34 3b 0a 20 20 20 20 69 66 28 20 69 3e 3d 2d 4d  4;.    if( i>=-M
a8a0: 41 58 5f 36 42 59 54 45 20 26 26 20 69 3c 3d 4d  AX_6BYTE && i<=M
a8b0: 41 58 5f 36 42 59 54 45 20 29 20 72 65 74 75 72  AX_6BYTE ) retur
a8c0: 6e 20 35 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  n 5;.    return 
a8d0: 36 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61  6;.  }.  if( fla
a8e0: 67 73 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a 20  gs&MEM_Real ){. 
a8f0: 20 20 20 72 65 74 75 72 6e 20 37 3b 0a 20 20 7d     return 7;.  }
a900: 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d  .  if( flags&MEM
a910: 5f 53 74 72 20 29 7b 0a 20 20 20 20 69 6e 74 20  _Str ){.    int 
a920: 6e 20 3d 20 70 4d 65 6d 2d 3e 6e 3b 0a 20 20 20  n = pMem->n;.   
a930: 20 61 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b   assert( n>=0 );
a940: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 28 6e 2a  .    return ((n*
a950: 32 29 20 2b 20 31 33 29 3b 0a 20 20 7d 0a 20 20  2) + 13);.  }.  
a960: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 42 6c  if( flags&MEM_Bl
a970: 6f 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ob ){.    return
a980: 20 28 70 4d 65 6d 2d 3e 6e 2a 32 20 2b 20 31 32   (pMem->n*2 + 12
a990: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
a9a0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  0;.}../*.** Retu
a9b0: 72 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66  rn the length of
a9c0: 20 74 68 65 20 64 61 74 61 20 63 6f 72 72 65 73   the data corres
a9d0: 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 73  ponding to the s
a9e0: 75 70 70 6c 69 65 64 20 73 65 72 69 61 6c 2d 74  upplied serial-t
a9f0: 79 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ype..*/.int sqli
aa00: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
aa10: 65 4c 65 6e 28 75 33 32 20 73 65 72 69 61 6c 5f  eLen(u32 serial_
aa20: 74 79 70 65 29 7b 0a 20 20 69 66 28 20 73 65 72  type){.  if( ser
aa30: 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b 0a  ial_type>=12 ){.
aa40: 20 20 20 20 72 65 74 75 72 6e 20 28 73 65 72 69      return (seri
aa50: 61 6c 5f 74 79 70 65 2d 31 32 29 2f 32 3b 0a 20  al_type-12)/2;. 
aa60: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 61 74   }else{.    stat
aa70: 69 63 20 63 6f 6e 73 74 20 75 38 20 61 53 69 7a  ic const u8 aSiz
aa80: 65 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c 20 32 2c  e[] = { 0, 1, 2,
aa90: 20 33 2c 20 34 2c 20 36 2c 20 38 2c 20 38 2c 20   3, 4, 6, 8, 8, 
aaa0: 30 2c 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 20 20  0, 0, 0, 0 };.  
aab0: 20 20 72 65 74 75 72 6e 20 61 53 69 7a 65 5b 73    return aSize[s
aac0: 65 72 69 61 6c 5f 74 79 70 65 5d 3b 0a 20 20 7d  erial_type];.  }
aad0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20  .}../*.** Write 
aae0: 74 68 65 20 73 65 72 69 61 6c 69 7a 65 64 20 64  the serialized d
aaf0: 61 74 61 20 62 6c 6f 62 20 66 6f 72 20 74 68 65  ata blob for the
ab00: 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e   value stored in
ab10: 20 70 4d 65 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62   pMem into .** b
ab20: 75 66 2e 20 49 74 20 69 73 20 61 73 73 75 6d 65  uf. It is assume
ab30: 64 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65  d that the calle
ab40: 72 20 68 61 73 20 61 6c 6c 6f 63 61 74 65 64 20  r has allocated 
ab50: 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65  sufficient space
ab60: 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  ..** Return the 
ab70: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  number of bytes 
ab80: 77 72 69 74 74 65 6e 2e 0a 2a 2f 20 0a 69 6e 74  written..*/ .int
ab90: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
aba0: 61 6c 50 75 74 28 75 6e 73 69 67 6e 65 64 20 63  alPut(unsigned c
abb0: 68 61 72 20 2a 62 75 66 2c 20 4d 65 6d 20 2a 70  har *buf, Mem *p
abc0: 4d 65 6d 29 7b 0a 20 20 75 33 32 20 73 65 72 69  Mem){.  u32 seri
abd0: 61 6c 5f 74 79 70 65 20 3d 20 73 71 6c 69 74 65  al_type = sqlite
abe0: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28  3VdbeSerialType(
abf0: 70 4d 65 6d 29 3b 0a 20 20 69 6e 74 20 6c 65 6e  pMem);.  int len
ac00: 3b 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a  ;..  /* NULL */.
ac10: 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70    if( serial_typ
ac20: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  e==0 ){.    retu
ac30: 72 6e 20 30 3b 0a 20 20 7d 0a 20 0a 20 20 2f 2a  rn 0;.  }. .  /*
ac40: 20 49 6e 74 65 67 65 72 20 61 6e 64 20 52 65 61   Integer and Rea
ac50: 6c 20 2a 2f 0a 20 20 69 66 28 20 73 65 72 69 61  l */.  if( seria
ac60: 6c 5f 74 79 70 65 3c 3d 37 20 29 7b 0a 20 20 20  l_type<=7 ){.   
ac70: 20 75 36 34 20 76 3b 0a 20 20 20 20 69 6e 74 20   u64 v;.    int 
ac80: 69 3b 0a 20 20 20 20 69 66 28 20 73 65 72 69 61  i;.    if( seria
ac90: 6c 5f 74 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20  l_type==7 ){.   
aca0: 20 20 20 76 20 3d 20 2a 28 75 36 34 2a 29 26 70     v = *(u64*)&p
acb0: 4d 65 6d 2d 3e 72 3b 0a 20 20 20 20 7d 65 6c 73  Mem->r;.    }els
acc0: 65 7b 0a 20 20 20 20 20 20 76 20 3d 20 2a 28 75  e{.      v = *(u
acd0: 36 34 2a 29 26 70 4d 65 6d 2d 3e 69 3b 0a 20 20  64*)&pMem->i;.  
ace0: 20 20 7d 0a 20 20 20 20 6c 65 6e 20 3d 20 69 20    }.    len = i 
acf0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
ad00: 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61  ialTypeLen(seria
ad10: 6c 5f 74 79 70 65 29 3b 0a 20 20 20 20 77 68 69  l_type);.    whi
ad20: 6c 65 28 20 69 2d 2d 20 29 7b 0a 20 20 20 20 20  le( i-- ){.     
ad30: 20 62 75 66 5b 69 5d 20 3d 20 28 76 26 30 78 46   buf[i] = (v&0xF
ad40: 46 29 3b 0a 20 20 20 20 20 20 76 20 3e 3e 3d 20  F);.      v >>= 
ad50: 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74  8;.    }.    ret
ad60: 75 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a 20 20 0a  urn len;.  }.  .
ad70: 20 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72 20 62    /* String or b
ad80: 6c 6f 62 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  lob */.  assert(
ad90: 20 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32   serial_type>=12
ada0: 20 29 3b 0a 20 20 6c 65 6e 20 3d 20 73 71 6c 69   );.  len = sqli
adb0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
adc0: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
add0: 29 3b 0a 20 20 6d 65 6d 63 70 79 28 62 75 66 2c  );.  memcpy(buf,
ade0: 20 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29 3b 0a   pMem->z, len);.
adf0: 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 7d 0a    return len;.}.
ae00: 0a 2f 2a 0a 2a 2a 20 44 65 73 65 72 69 61 6c 69  ./*.** Deseriali
ae10: 7a 65 20 74 68 65 20 64 61 74 61 20 62 6c 6f 62  ze the data blob
ae20: 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 62   pointed to by b
ae30: 75 66 20 61 73 20 73 65 72 69 61 6c 20 74 79 70  uf as serial typ
ae40: 65 20 73 65 72 69 61 6c 5f 74 79 70 65 0a 2a 2a  e serial_type.**
ae50: 20 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 72   and store the r
ae60: 65 73 75 6c 74 20 69 6e 20 70 4d 65 6d 2e 20 20  esult in pMem.  
ae70: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
ae80: 72 20 6f 66 20 62 79 74 65 73 20 72 65 61 64 2e  r of bytes read.
ae90: 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33  .*/ .int sqlite3
aea0: 56 64 62 65 53 65 72 69 61 6c 47 65 74 28 0a 20  VdbeSerialGet(. 
aeb0: 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20   const unsigned 
aec0: 63 68 61 72 20 2a 62 75 66 2c 20 20 20 20 20 2f  char *buf,     /
aed0: 2a 20 42 75 66 66 65 72 20 74 6f 20 64 65 73 65  * Buffer to dese
aee0: 72 69 61 6c 69 7a 65 20 66 72 6f 6d 20 2a 2f 0a  rialize from */.
aef0: 20 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70    u32 serial_typ
af00: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
af10: 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 74  /* Serial type t
af20: 6f 20 64 65 73 65 72 69 61 6c 69 7a 65 20 2a 2f  o deserialize */
af30: 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 20 20 20  .  Mem *pMem    
af40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
af50: 20 2f 2a 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20   /* Memory cell 
af60: 74 6f 20 77 72 69 74 65 20 76 61 6c 75 65 20 69  to write value i
af70: 6e 74 6f 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20  nto */.){.  int 
af80: 6c 65 6e 3b 0a 0a 20 20 69 66 28 20 73 65 72 69  len;..  if( seri
af90: 61 6c 5f 74 79 70 65 3d 3d 30 20 29 7b 0a 20 20  al_type==0 ){.  
afa0: 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20    /* NULL */.   
afb0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
afc0: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 72 65 74  EM_Null;.    ret
afd0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 6c 65 6e  urn 0;.  }.  len
afe0: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65   = sqlite3VdbeSe
aff0: 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69  rialTypeLen(seri
b000: 61 6c 5f 74 79 70 65 29 3b 0a 20 20 69 66 28 20  al_type);.  if( 
b010: 73 65 72 69 61 6c 5f 74 79 70 65 3c 3d 37 20 29  serial_type<=7 )
b020: 7b 0a 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72  {.    /* Integer
b030: 20 61 6e 64 20 52 65 61 6c 20 2a 2f 0a 20 20 20   and Real */.   
b040: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
b050: 3c 3d 34 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  <=4 ){.      /* 
b060: 33 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 74  32-bit integer t
b070: 79 70 65 2e 20 20 54 68 69 73 20 69 73 20 68 61  ype.  This is ha
b080: 6e 64 6c 65 64 20 62 79 20 61 20 73 70 65 63 69  ndled by a speci
b090: 61 6c 20 63 61 73 65 20 66 6f 72 0a 20 20 20 20  al case for.    
b0a0: 20 20 2a 2a 20 70 65 72 66 6f 72 6d 61 6e 63 65    ** performance
b0b0: 20 72 65 61 73 6f 6e 73 2e 20 2a 2f 0a 20 20 20   reasons. */.   
b0c0: 20 20 20 69 6e 74 20 76 20 3d 20 62 75 66 5b 30     int v = buf[0
b0d0: 5d 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 3b 0a  ];.      int n;.
b0e0: 20 20 20 20 20 20 69 66 28 20 76 26 30 78 38 30        if( v&0x80
b0f0: 20 29 7b 0a 20 20 20 20 20 20 20 20 76 20 7c 3d   ){.        v |=
b100: 20 2d 32 35 36 3b 0a 20 20 20 20 20 20 7d 0a 20   -256;.      }. 
b110: 20 20 20 20 20 66 6f 72 28 6e 3d 31 3b 20 6e 3c       for(n=1; n<
b120: 6c 65 6e 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20 20  len; n++){.     
b130: 20 20 20 76 20 3d 20 28 76 3c 3c 38 29 20 7c 20     v = (v<<8) | 
b140: 62 75 66 5b 6e 5d 3b 0a 20 20 20 20 20 20 7d 0a  buf[n];.      }.
b150: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
b160: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
b170: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 76 3b 0a     pMem->i = v;.
b180: 20 20 20 20 20 20 72 65 74 75 72 6e 20 6e 3b 0a        return n;.
b190: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
b1a0: 20 75 36 34 20 76 20 3d 20 30 3b 0a 20 20 20 20   u64 v = 0;.    
b1b0: 20 20 69 6e 74 20 6e 3b 0a 0a 20 20 20 20 20 20    int n;..      
b1c0: 69 66 28 20 62 75 66 5b 30 5d 26 30 78 38 30 20  if( buf[0]&0x80 
b1d0: 29 7b 0a 20 20 20 20 20 20 20 20 76 20 3d 20 2d  ){.        v = -
b1e0: 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  1;.      }.     
b1f0: 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c 6c 65 6e 3b   for(n=0; n<len;
b200: 20 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 76   n++){.        v
b210: 20 3d 20 28 76 3c 3c 38 29 20 7c 20 62 75 66 5b   = (v<<8) | buf[
b220: 6e 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  n];.      }.    
b230: 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70    if( serial_typ
b240: 65 3d 3d 37 20 29 7b 0a 20 20 20 20 20 20 20 20  e==7 ){.        
b250: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
b260: 4d 5f 52 65 61 6c 3b 0a 20 20 20 20 20 20 20 20  M_Real;.        
b270: 70 4d 65 6d 2d 3e 72 20 3d 20 2a 28 64 6f 75 62  pMem->r = *(doub
b280: 6c 65 2a 29 26 76 3b 0a 20 20 20 20 20 20 7d 65  le*)&v;.      }e
b290: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65  lse{.        pMe
b2a0: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49  m->flags = MEM_I
b2b0: 6e 74 3b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d  nt;.        pMem
b2c0: 2d 3e 69 20 3d 20 2a 28 69 36 34 2a 29 26 76 3b  ->i = *(i64*)&v;
b2d0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
b2e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 53   }else{.    /* S
b2f0: 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 2a 2f  tring or blob */
b300: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 65 72  .    assert( ser
b310: 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 3b 0a  ial_type>=12 );.
b320: 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 28 63      pMem->z = (c
b330: 68 61 72 20 2a 29 62 75 66 3b 0a 20 20 20 20 70  har *)buf;.    p
b340: 4d 65 6d 2d 3e 6e 20 3d 20 6c 65 6e 3b 0a 20 20  Mem->n = len;.  
b350: 20 20 70 4d 65 6d 2d 3e 78 44 65 6c 20 3d 20 30    pMem->xDel = 0
b360: 3b 0a 20 20 20 20 69 66 28 20 73 65 72 69 61 6c  ;.    if( serial
b370: 5f 74 79 70 65 26 30 78 30 31 20 29 7b 0a 20 20  _type&0x01 ){.  
b380: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
b390: 3d 20 4d 45 4d 5f 53 74 72 20 7c 20 4d 45 4d 5f  = MEM_Str | MEM_
b3a0: 45 70 68 65 6d 3b 0a 20 20 20 20 7d 65 6c 73 65  Ephem;.    }else
b3b0: 7b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  {.      pMem->fl
b3c0: 61 67 73 20 3d 20 4d 45 4d 5f 42 6c 6f 62 20 7c  ags = MEM_Blob |
b3d0: 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20 20   MEM_Ephem;.    
b3e0: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6c  }.  }.  return l
b3f0: 65 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  en;.}../*.** Thi
b400: 73 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 70 61  s function compa
b410: 72 65 73 20 74 68 65 20 74 77 6f 20 74 61 62 6c  res the two tabl
b420: 65 20 72 6f 77 73 20 6f 72 20 69 6e 64 65 78 20  e rows or index 
b430: 72 65 63 6f 72 64 73 20 73 70 65 63 69 66 69 65  records specifie
b440: 64 20 62 79 20 0a 2a 2a 20 7b 6e 4b 65 79 31 2c  d by .** {nKey1,
b450: 20 70 4b 65 79 31 7d 20 61 6e 64 20 7b 6e 4b 65   pKey1} and {nKe
b460: 79 32 2c 20 70 4b 65 79 32 7d 2c 20 72 65 74 75  y2, pKey2}, retu
b470: 72 6e 69 6e 67 20 61 20 6e 65 67 61 74 69 76 65  rning a negative
b480: 2c 20 7a 65 72 6f 0a 2a 2a 20 6f 72 20 70 6f 73  , zero.** or pos
b490: 69 74 69 76 65 20 69 6e 74 65 67 65 72 20 69 66  itive integer if
b4a0: 20 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20   {nKey1, pKey1} 
b4b0: 69 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65 71  is less than, eq
b4c0: 75 61 6c 20 74 6f 20 6f 72 20 0a 2a 2a 20 67 72  ual to or .** gr
b4d0: 65 61 74 65 72 20 74 68 61 6e 20 7b 6e 4b 65 79  eater than {nKey
b4e0: 32 2c 20 70 4b 65 79 32 7d 2e 20 20 42 6f 74 68  2, pKey2}.  Both
b4f0: 20 4b 65 79 31 20 61 6e 64 20 4b 65 79 32 20 6d   Key1 and Key2 m
b500: 75 73 74 20 62 65 20 62 79 74 65 20 73 74 72 69  ust be byte stri
b510: 6e 67 73 0a 2a 2a 20 63 6f 6d 70 6f 73 65 64 20  ngs.** composed 
b520: 62 79 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65  by the OP_MakeRe
b530: 63 6f 72 64 20 6f 70 63 6f 64 65 20 6f 66 20 74  cord opcode of t
b540: 68 65 20 56 44 42 45 2e 0a 2a 2f 0a 69 6e 74 20  he VDBE..*/.int 
b550: 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72  sqlite3VdbeRecor
b560: 64 43 6f 6d 70 61 72 65 28 0a 20 20 76 6f 69 64  dCompare(.  void
b570: 20 2a 75 73 65 72 44 61 74 61 2c 0a 20 20 69 6e   *userData,.  in
b580: 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76  t nKey1, const v
b590: 6f 69 64 20 2a 70 4b 65 79 31 2c 20 0a 20 20 69  oid *pKey1, .  i
b5a0: 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20  nt nKey2, const 
b5b0: 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20  void *pKey2.){. 
b5c0: 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e   KeyInfo *pKeyIn
b5d0: 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 75  fo = (KeyInfo*)u
b5e0: 73 65 72 44 61 74 61 3b 0a 20 20 75 33 32 20 64  serData;.  u32 d
b5f0: 31 2c 20 64 32 3b 20 20 20 20 20 20 20 20 20 20  1, d2;          
b600: 2f 2a 20 4f 66 66 73 65 74 20 69 6e 74 6f 20 61  /* Offset into a
b610: 4b 65 79 5b 5d 20 6f 66 20 6e 65 78 74 20 64 61  Key[] of next da
b620: 74 61 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20  ta element */.  
b630: 75 33 32 20 69 64 78 31 2c 20 69 64 78 32 3b 20  u32 idx1, idx2; 
b640: 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69       /* Offset i
b650: 6e 74 6f 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65  nto aKey[] of ne
b660: 78 74 20 68 65 61 64 65 72 20 65 6c 65 6d 65 6e  xt header elemen
b670: 74 20 2a 2f 0a 20 20 75 33 32 20 73 7a 48 64 72  t */.  u32 szHdr
b680: 31 2c 20 73 7a 48 64 72 32 3b 20 20 2f 2a 20 4e  1, szHdr2;  /* N
b690: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69  umber of bytes i
b6a0: 6e 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e  n header */.  in
b6b0: 74 20 69 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e  t i = 0;.  int n
b6c0: 46 69 65 6c 64 3b 0a 20 20 69 6e 74 20 72 63 20  Field;.  int rc 
b6d0: 3d 20 30 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73  = 0;.  const uns
b6e0: 69 67 6e 65 64 20 63 68 61 72 20 2a 61 4b 65 79  igned char *aKey
b6f0: 31 20 3d 20 28 63 6f 6e 73 74 20 75 6e 73 69 67  1 = (const unsig
b700: 6e 65 64 20 63 68 61 72 20 2a 29 70 4b 65 79 31  ned char *)pKey1
b710: 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  ;.  const unsign
b720: 65 64 20 63 68 61 72 20 2a 61 4b 65 79 32 20 3d  ed char *aKey2 =
b730: 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64   (const unsigned
b740: 20 63 68 61 72 20 2a 29 70 4b 65 79 32 3b 0a 0a   char *)pKey2;..
b750: 20 20 4d 65 6d 20 6d 65 6d 31 3b 0a 20 20 4d 65    Mem mem1;.  Me
b760: 6d 20 6d 65 6d 32 3b 0a 20 20 6d 65 6d 31 2e 65  m mem2;.  mem1.e
b770: 6e 63 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65  nc = pKeyInfo->e
b780: 6e 63 3b 0a 20 20 6d 65 6d 32 2e 65 6e 63 20 3d  nc;.  mem2.enc =
b790: 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a   pKeyInfo->enc;.
b7a0: 20 20 0a 20 20 69 64 78 31 20 3d 20 73 71 6c 69    .  idx1 = sqli
b7b0: 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 70  te3GetVarint32(p
b7c0: 4b 65 79 31 2c 20 26 73 7a 48 64 72 31 29 3b 0a  Key1, &szHdr1);.
b7d0: 20 20 64 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20    d1 = szHdr1;. 
b7e0: 20 69 64 78 32 20 3d 20 73 71 6c 69 74 65 33 47   idx2 = sqlite3G
b7f0: 65 74 56 61 72 69 6e 74 33 32 28 70 4b 65 79 32  etVarint32(pKey2
b800: 2c 20 26 73 7a 48 64 72 32 29 3b 0a 20 20 64 32  , &szHdr2);.  d2
b810: 20 3d 20 73 7a 48 64 72 32 3b 0a 20 20 6e 46 69   = szHdr2;.  nFi
b820: 65 6c 64 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e  eld = pKeyInfo->
b830: 6e 46 69 65 6c 64 3b 0a 20 20 77 68 69 6c 65 28  nField;.  while(
b840: 20 69 64 78 31 3c 73 7a 48 64 72 31 20 26 26 20   idx1<szHdr1 && 
b850: 69 64 78 32 3c 73 7a 48 64 72 32 20 29 7b 0a 20  idx2<szHdr2 ){. 
b860: 20 20 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79     u32 serial_ty
b870: 70 65 31 3b 0a 20 20 20 20 75 33 32 20 73 65 72  pe1;.    u32 ser
b880: 69 61 6c 5f 74 79 70 65 32 3b 0a 0a 20 20 20 20  ial_type2;..    
b890: 2f 2a 20 52 65 61 64 20 74 68 65 20 73 65 72 69  /* Read the seri
b8a0: 61 6c 20 74 79 70 65 73 20 66 6f 72 20 74 68 65  al types for the
b8b0: 20 6e 65 78 74 20 65 6c 65 6d 65 6e 74 20 69 6e   next element in
b8c0: 20 65 61 63 68 20 6b 65 79 2e 20 2a 2f 0a 20 20   each key. */.  
b8d0: 20 20 69 64 78 31 20 2b 3d 20 73 71 6c 69 74 65    idx1 += sqlite
b8e0: 33 47 65 74 56 61 72 69 6e 74 33 32 28 26 61 4b  3GetVarint32(&aK
b8f0: 65 79 31 5b 69 64 78 31 5d 2c 20 26 73 65 72 69  ey1[idx1], &seri
b900: 61 6c 5f 74 79 70 65 31 29 3b 0a 20 20 20 20 69  al_type1);.    i
b910: 66 28 20 64 31 3e 3d 6e 4b 65 79 31 20 26 26 20  f( d1>=nKey1 && 
b920: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
b930: 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f  lTypeLen(serial_
b940: 74 79 70 65 31 29 3e 30 20 29 20 62 72 65 61 6b  type1)>0 ) break
b950: 3b 0a 20 20 20 20 69 64 78 32 20 2b 3d 20 73 71  ;.    idx2 += sq
b960: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
b970: 28 26 61 4b 65 79 32 5b 69 64 78 32 5d 2c 20 26  (&aKey2[idx2], &
b980: 73 65 72 69 61 6c 5f 74 79 70 65 32 29 3b 0a 20  serial_type2);. 
b990: 20 20 20 69 66 28 20 64 32 3e 3d 6e 4b 65 79 32     if( d2>=nKey2
b9a0: 20 26 26 20 73 71 6c 69 74 65 33 56 64 62 65 53   && sqlite3VdbeS
b9b0: 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72  erialTypeLen(ser
b9c0: 69 61 6c 5f 74 79 70 65 32 29 3e 30 20 29 20 62  ial_type2)>0 ) b
b9d0: 72 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20 41 73  reak;..    /* As
b9e0: 73 65 72 74 20 74 68 61 74 20 74 68 65 72 65 20  sert that there 
b9f0: 69 73 20 65 6e 6f 75 67 68 20 73 70 61 63 65 20  is enough space 
ba00: 6c 65 66 74 20 69 6e 20 65 61 63 68 20 6b 65 79  left in each key
ba10: 20 66 6f 72 20 74 68 65 20 62 6c 6f 62 20 6f 66   for the blob of
ba20: 0a 20 20 20 20 2a 2a 20 64 61 74 61 20 74 6f 20  .    ** data to 
ba30: 67 6f 20 77 69 74 68 20 74 68 65 20 73 65 72 69  go with the seri
ba40: 61 6c 20 74 79 70 65 20 6a 75 73 74 20 72 65 61  al type just rea
ba50: 64 2e 20 54 68 69 73 20 61 73 73 65 72 74 20 6d  d. This assert m
ba60: 61 79 20 66 61 69 6c 20 69 66 0a 20 20 20 20 2a  ay fail if.    *
ba70: 2a 20 74 68 65 20 66 69 6c 65 20 69 73 20 63 6f  * the file is co
ba80: 72 72 75 70 74 65 64 2e 20 20 54 68 65 6e 20 72  rrupted.  Then r
ba90: 65 61 64 20 74 68 65 20 76 61 6c 75 65 20 66 72  ead the value fr
baa0: 6f 6d 20 65 61 63 68 20 6b 65 79 20 69 6e 74 6f  om each key into
bab0: 20 6d 65 6d 31 0a 20 20 20 20 2a 2a 20 61 6e 64   mem1.    ** and
bac0: 20 6d 65 6d 32 20 72 65 73 70 65 63 74 69 76 65   mem2 respective
bad0: 6c 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64  ly..    */.    d
bae0: 31 20 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65  1 += sqlite3Vdbe
baf0: 53 65 72 69 61 6c 47 65 74 28 26 61 4b 65 79 31  SerialGet(&aKey1
bb00: 5b 64 31 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70  [d1], serial_typ
bb10: 65 31 2c 20 26 6d 65 6d 31 29 3b 0a 20 20 20 20  e1, &mem1);.    
bb20: 64 32 20 2b 3d 20 73 71 6c 69 74 65 33 56 64 62  d2 += sqlite3Vdb
bb30: 65 53 65 72 69 61 6c 47 65 74 28 26 61 4b 65 79  eSerialGet(&aKey
bb40: 32 5b 64 32 5d 2c 20 73 65 72 69 61 6c 5f 74 79  2[d2], serial_ty
bb50: 70 65 32 2c 20 26 6d 65 6d 32 29 3b 0a 0a 20 20  pe2, &mem2);..  
bb60: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4d 65    rc = sqlite3Me
bb70: 6d 43 6f 6d 70 61 72 65 28 26 6d 65 6d 31 2c 20  mCompare(&mem1, 
bb80: 26 6d 65 6d 32 2c 20 69 3c 6e 46 69 65 6c 64 20  &mem2, i<nField 
bb90: 3f 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c  ? pKeyInfo->aCol
bba0: 6c 5b 69 5d 20 3a 20 30 29 3b 0a 20 20 20 20 73  l[i] : 0);.    s
bbb0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
bbc0: 65 61 73 65 28 26 6d 65 6d 31 29 3b 0a 20 20 20  ease(&mem1);.   
bbd0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52   sqlite3VdbeMemR
bbe0: 65 6c 65 61 73 65 28 26 6d 65 6d 32 29 3b 0a 20  elease(&mem2);. 
bbf0: 20 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a     if( rc!=0 ){.
bc00: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
bc10: 20 7d 0a 20 20 20 20 69 2b 2b 3b 0a 20 20 7d 0a   }.    i++;.  }.
bc20: 0a 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65  .  /* One of the
bc30: 20 6b 65 79 73 20 72 61 6e 20 6f 75 74 20 6f 66   keys ran out of
bc40: 20 66 69 65 6c 64 73 2c 20 62 75 74 20 61 6c 6c   fields, but all
bc50: 20 74 68 65 20 66 69 65 6c 64 73 20 75 70 20 74   the fields up t
bc60: 6f 20 74 68 61 74 20 70 6f 69 6e 74 0a 20 20 2a  o that point.  *
bc70: 2a 20 77 65 72 65 20 65 71 75 61 6c 2e 20 49 66  * were equal. If
bc80: 20 74 68 65 20 69 6e 63 72 4b 65 79 20 66 6c 61   the incrKey fla
bc90: 67 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20  g is true, then 
bca0: 74 68 65 20 73 65 63 6f 6e 64 20 6b 65 79 20 69  the second key i
bcb0: 73 0a 20 20 2a 2a 20 74 72 65 61 74 65 64 20 61  s.  ** treated a
bcc0: 73 20 6c 61 72 67 65 72 2e 0a 20 20 2a 2f 0a 20  s larger..  */. 
bcd0: 20 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20   if( rc==0 ){.  
bce0: 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e    if( pKeyInfo->
bcf0: 69 6e 63 72 4b 65 79 20 29 7b 0a 20 20 20 20 20  incrKey ){.     
bd00: 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 65   rc = -1;.    }e
bd10: 6c 73 65 20 69 66 28 20 64 31 3c 6e 4b 65 79 31  lse if( d1<nKey1
bd20: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 31   ){.      rc = 1
bd30: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20  ;.    }else if( 
bd40: 64 32 3c 6e 4b 65 79 32 20 29 7b 0a 20 20 20 20  d2<nKey2 ){.    
bd50: 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d    rc = -1;.    }
bd60: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 4b 65 79  .  }..  if( pKey
bd70: 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72  Info->aSortOrder
bd80: 20 26 26 20 69 3c 70 4b 65 79 49 6e 66 6f 2d 3e   && i<pKeyInfo->
bd90: 6e 46 69 65 6c 64 20 26 26 20 70 4b 65 79 49 6e  nField && pKeyIn
bda0: 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b 69  fo->aSortOrder[i
bdb0: 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 2d 72  ] ){.    rc = -r
bdc0: 63 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e  c;.  }..  return
bdd0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68   rc;.}../*.** Th
bde0: 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e  e argument is an
bdf0: 20 69 6e 64 65 78 20 65 6e 74 72 79 20 63 6f 6d   index entry com
be00: 70 6f 73 65 64 20 75 73 69 6e 67 20 74 68 65 20  posed using the 
be10: 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70  OP_MakeRecord op
be20: 63 6f 64 65 2e 0a 2a 2a 20 54 68 65 20 6c 61 73  code..** The las
be30: 74 20 65 6e 74 72 79 20 69 6e 20 74 68 69 73 20  t entry in this 
be40: 72 65 63 6f 72 64 20 73 68 6f 75 6c 64 20 62 65  record should be
be50: 20 61 6e 20 69 6e 74 65 67 65 72 20 28 73 70 65   an integer (spe
be60: 63 69 66 69 63 61 6c 6c 79 0a 2a 2a 20 61 6e 20  cifically.** an 
be70: 69 6e 74 65 67 65 72 20 72 6f 77 69 64 29 2e 20  integer rowid). 
be80: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65   This routine re
be90: 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72  turns the number
bea0: 20 6f 66 20 62 79 74 65 73 20 69 6e 0a 2a 2a 20   of bytes in.** 
beb0: 74 68 61 74 20 69 6e 74 65 67 65 72 2e 0a 2a 2f  that integer..*/
bec0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
bed0: 49 64 78 52 6f 77 69 64 4c 65 6e 28 69 6e 74 20  IdxRowidLen(int 
bee0: 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38 20 2a  nKey, const u8 *
bef0: 61 4b 65 79 29 7b 0a 20 20 75 33 32 20 73 7a 48  aKey){.  u32 szH
bf00: 64 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 69  dr;        /* Si
bf10: 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72  ze of the header
bf20: 20 2a 2f 0a 20 20 75 33 32 20 74 79 70 65 52 6f   */.  u32 typeRo
bf30: 77 69 64 3b 20 20 20 20 2f 2a 20 53 65 72 69 61  wid;    /* Seria
bf40: 6c 20 74 79 70 65 20 6f 66 20 74 68 65 20 72 6f  l type of the ro
bf50: 77 69 64 20 2a 2f 0a 0a 20 20 73 71 6c 69 74 65  wid */..  sqlite
bf60: 33 47 65 74 56 61 72 69 6e 74 33 32 28 61 4b 65  3GetVarint32(aKe
bf70: 79 2c 20 26 73 7a 48 64 72 29 3b 0a 20 20 73 71  y, &szHdr);.  sq
bf80: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
bf90: 28 26 61 4b 65 79 5b 73 7a 48 64 72 2d 31 5d 2c  (&aKey[szHdr-1],
bfa0: 20 26 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20   &typeRowid);.  
bfb0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64  return sqlite3Vd
bfc0: 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28  beSerialTypeLen(
bfd0: 74 79 70 65 52 6f 77 69 64 29 3b 0a 7d 0a 20 20  typeRowid);.}.  
bfe0: 0a 0a 2f 2a 0a 2a 2a 20 70 43 75 72 20 70 6f 69  ../*.** pCur poi
bff0: 6e 74 73 20 61 74 20 61 6e 20 69 6e 64 65 78 20  nts at an index 
c000: 65 6e 74 72 79 20 63 72 65 61 74 65 64 20 75 73  entry created us
c010: 69 6e 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52  ing the OP_MakeR
c020: 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a  ecord opcode..**
c030: 20 52 65 61 64 20 74 68 65 20 72 6f 77 69 64 20   Read the rowid 
c040: 28 74 68 65 20 6c 61 73 74 20 66 69 65 6c 64 20  (the last field 
c050: 69 6e 20 74 68 65 20 72 65 63 6f 72 64 29 20 61  in the record) a
c060: 6e 64 20 73 74 6f 72 65 20 69 74 20 69 6e 20 2a  nd store it in *
c070: 72 6f 77 69 64 2e 0a 2a 2a 20 52 65 74 75 72 6e  rowid..** Return
c080: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76   SQLITE_OK if ev
c090: 65 72 79 74 68 69 6e 67 20 77 6f 72 6b 73 2c 20  erything works, 
c0a0: 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65  or an error code
c0b0: 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69   otherwise..*/.i
c0c0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 49 64  nt sqlite3VdbeId
c0d0: 78 52 6f 77 69 64 28 42 74 43 75 72 73 6f 72 20  xRowid(BtCursor 
c0e0: 2a 70 43 75 72 2c 20 69 36 34 20 2a 72 6f 77 69  *pCur, i64 *rowi
c0f0: 64 29 7b 0a 20 20 69 36 34 20 6e 43 65 6c 6c 4b  d){.  i64 nCellK
c100: 65 79 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  ey;.  int rc;.  
c110: 75 33 32 20 73 7a 48 64 72 3b 20 20 20 20 20 20  u32 szHdr;      
c120: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65    /* Size of the
c130: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75 33 32   header */.  u32
c140: 20 74 79 70 65 52 6f 77 69 64 3b 20 20 20 20 2f   typeRowid;    /
c150: 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 6f 66  * Serial type of
c160: 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20   the rowid */.  
c170: 75 33 32 20 6c 65 6e 52 6f 77 69 64 3b 20 20 20  u32 lenRowid;   
c180: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65    /* Size of the
c190: 20 72 6f 77 69 64 20 2a 2f 0a 20 20 4d 65 6d 20   rowid */.  Mem 
c1a0: 6d 2c 20 76 3b 0a 0a 20 20 73 71 6c 69 74 65 33  m, v;..  sqlite3
c1b0: 42 74 72 65 65 4b 65 79 53 69 7a 65 28 70 43 75  BtreeKeySize(pCu
c1c0: 72 2c 20 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20  r, &nCellKey);. 
c1d0: 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30   if( nCellKey<=0
c1e0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
c1f0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 20  QLITE_CORRUPT;. 
c200: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65   }.  rc = sqlite
c210: 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65  3VdbeMemFromBtre
c220: 65 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 6c 6c  e(pCur, 0, nCell
c230: 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a 20 20 69  Key, 1, &m);.  i
c240: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72 65 74  f( rc ){.    ret
c250: 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 73 71  urn rc;.  }.  sq
c260: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
c270: 28 6d 2e 7a 2c 20 26 73 7a 48 64 72 29 3b 0a 20  (m.z, &szHdr);. 
c280: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
c290: 74 33 32 28 26 6d 2e 7a 5b 73 7a 48 64 72 2d 31  t32(&m.z[szHdr-1
c2a0: 5d 2c 20 26 74 79 70 65 52 6f 77 69 64 29 3b 0a  ], &typeRowid);.
c2b0: 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20 73 71 6c    lenRowid = sql
c2c0: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
c2d0: 70 65 4c 65 6e 28 74 79 70 65 52 6f 77 69 64 29  peLen(typeRowid)
c2e0: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 53  ;.  sqlite3VdbeS
c2f0: 65 72 69 61 6c 47 65 74 28 26 6d 2e 7a 5b 6d 2e  erialGet(&m.z[m.
c300: 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20 74 79 70  n-lenRowid], typ
c310: 65 52 6f 77 69 64 2c 20 26 76 29 3b 0a 20 20 2a  eRowid, &v);.  *
c320: 72 6f 77 69 64 20 3d 20 76 2e 69 3b 0a 20 20 73  rowid = v.i;.  s
c330: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
c340: 65 61 73 65 28 26 6d 29 3b 0a 20 20 72 65 74 75  ease(&m);.  retu
c350: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
c360: 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72 65 20 74  ./*.** Compare t
c370: 68 65 20 6b 65 79 20 6f 66 20 74 68 65 20 69 6e  he key of the in
c380: 64 65 78 20 65 6e 74 72 79 20 74 68 61 74 20 63  dex entry that c
c390: 75 72 73 6f 72 20 70 43 20 69 73 20 70 6f 69 6e  ursor pC is poin
c3a0: 74 20 74 6f 20 61 67 61 69 6e 73 74 0a 2a 2a 20  t to against.** 
c3b0: 74 68 65 20 6b 65 79 20 73 74 72 69 6e 67 20 69  the key string i
c3c0: 6e 20 70 4b 65 79 20 28 6f 66 20 6c 65 6e 67 74  n pKey (of lengt
c3d0: 68 20 6e 4b 65 79 29 2e 20 20 57 72 69 74 65 20  h nKey).  Write 
c3e0: 69 6e 74 6f 20 2a 70 52 65 73 20 61 20 6e 75 6d  into *pRes a num
c3f0: 62 65 72 0a 2a 2a 20 74 68 61 74 20 69 73 20 6e  ber.** that is n
c400: 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 2c 20 6f  egative, zero, o
c410: 72 20 70 6f 73 69 74 69 76 65 20 69 66 20 70 43  r positive if pC
c420: 20 69 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65   is less than, e
c430: 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f 72 20 67  qual to,.** or g
c440: 72 65 61 74 65 72 20 74 68 61 6e 20 70 4b 65 79  reater than pKey
c450: 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45  .  Return SQLITE
c460: 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 2e 0a  _OK on success..
c470: 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69 73 20 65 69  **.** pKey is ei
c480: 74 68 65 72 20 63 72 65 61 74 65 64 20 77 69 74  ther created wit
c490: 68 6f 75 74 20 61 20 72 6f 77 69 64 20 6f 72 20  hout a rowid or 
c4a0: 69 73 20 74 72 75 6e 63 61 74 65 64 20 73 6f 20  is truncated so 
c4b0: 74 68 61 74 20 69 74 0a 2a 2a 20 6f 6d 69 74 73  that it.** omits
c4c0: 20 74 68 65 20 72 6f 77 69 64 20 61 74 20 74 68   the rowid at th
c4d0: 65 20 65 6e 64 2e 20 20 54 68 65 20 72 6f 77 69  e end.  The rowi
c4e0: 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20  d at the end of 
c4f0: 74 68 65 20 69 6e 64 65 78 20 65 6e 74 72 79 0a  the index entry.
c500: 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64 20 61 73  ** is ignored as
c510: 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71   well..*/.int sq
c520: 6c 69 74 65 33 56 64 62 65 49 64 78 4b 65 79 43  lite3VdbeIdxKeyC
c530: 6f 6d 70 61 72 65 28 0a 20 20 43 75 72 73 6f 72  ompare(.  Cursor
c540: 20 2a 70 43 2c 20 20 20 20 20 20 20 20 20 20 20   *pC,           
c550: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72        /* The cur
c560: 73 6f 72 20 74 6f 20 63 6f 6d 70 61 72 65 20 61  sor to compare a
c570: 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69 6e 74 20  gainst */.  int 
c580: 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38 20 2a  nKey, const u8 *
c590: 70 4b 65 79 2c 20 20 20 2f 2a 20 54 68 65 20 6b  pKey,   /* The k
c5a0: 65 79 20 74 6f 20 63 6f 6d 70 61 72 65 20 2a 2f  ey to compare */
c5b0: 0a 20 20 69 6e 74 20 2a 72 65 73 20 20 20 20 20  .  int *res     
c5c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
c5d0: 2a 20 57 72 69 74 65 20 74 68 65 20 63 6f 6d 70  * Write the comp
c5e0: 61 72 69 73 6f 6e 20 72 65 73 75 6c 74 20 68 65  arison result he
c5f0: 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 36 34 20 6e  re */.){.  i64 n
c600: 43 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74 20 72  CellKey;.  int r
c610: 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70  c;.  BtCursor *p
c620: 43 75 72 20 3d 20 70 43 2d 3e 70 43 75 72 73 6f  Cur = pC->pCurso
c630: 72 3b 0a 20 20 69 6e 74 20 6c 65 6e 52 6f 77 69  r;.  int lenRowi
c640: 64 3b 0a 20 20 4d 65 6d 20 6d 3b 0a 0a 20 20 73  d;.  Mem m;..  s
c650: 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79 53 69  qlite3BtreeKeySi
c660: 7a 65 28 70 43 75 72 2c 20 26 6e 43 65 6c 6c 4b  ze(pCur, &nCellK
c670: 65 79 29 3b 0a 20 20 69 66 28 20 6e 43 65 6c 6c  ey);.  if( nCell
c680: 4b 65 79 3c 3d 30 20 29 7b 0a 20 20 20 20 2a 72  Key<=0 ){.    *r
c690: 65 73 20 3d 20 30 3b 0a 20 20 20 20 72 65 74 75  es = 0;.    retu
c6a0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
c6b0: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  }.  rc = sqlite3
c6c0: 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65 65  VdbeMemFromBtree
c6d0: 28 70 43 2d 3e 70 43 75 72 73 6f 72 2c 20 30 2c  (pC->pCursor, 0,
c6e0: 20 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d   nCellKey, 1, &m
c6f0: 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20  );.  if( rc ){. 
c700: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
c710: 7d 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20 73  }.  lenRowid = s
c720: 71 6c 69 74 65 33 56 64 62 65 49 64 78 52 6f 77  qlite3VdbeIdxRow
c730: 69 64 4c 65 6e 28 6d 2e 6e 2c 20 6d 2e 7a 29 3b  idLen(m.n, m.z);
c740: 0a 20 20 2a 72 65 73 20 3d 20 73 71 6c 69 74 65  .  *res = sqlite
c750: 33 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61  3VdbeRecordCompa
c760: 72 65 28 70 43 2d 3e 70 4b 65 79 49 6e 66 6f 2c  re(pC->pKeyInfo,
c770: 20 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 2c 20 6d   m.n-lenRowid, m
c780: 2e 7a 2c 20 6e 4b 65 79 2c 20 70 4b 65 79 29 3b  .z, nKey, pKey);
c790: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
c7a0: 6d 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20  mRelease(&m);.  
c7b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
c7c0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
c7d0: 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65  routine sets the
c7e0: 20 76 61 6c 75 65 20 74 6f 20 62 65 20 72 65 74   value to be ret
c7f0: 75 72 6e 65 64 20 62 79 20 73 75 62 73 65 71 75  urned by subsequ
c800: 65 6e 74 20 63 61 6c 6c 73 20 74 6f 0a 2a 2a 20  ent calls to.** 
c810: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 28  sqlite3_changes(
c820: 29 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73  ) on the databas
c830: 65 20 68 61 6e 64 6c 65 20 27 64 62 27 2e 20 0a  e handle 'db'. .
c840: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
c850: 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 73 71  dbeSetChanges(sq
c860: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6e  lite3 *db, int n
c870: 43 68 61 6e 67 65 29 7b 0a 20 20 64 62 2d 3e 6e  Change){.  db->n
c880: 43 68 61 6e 67 65 20 3d 20 6e 43 68 61 6e 67 65  Change = nChange
c890: 3b 0a 20 20 64 62 2d 3e 6e 54 6f 74 61 6c 43 68  ;.  db->nTotalCh
c8a0: 61 6e 67 65 20 2b 3d 20 6e 43 68 61 6e 67 65 3b  ange += nChange;
c8b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 61 20  .}../*.** Set a 
c8c0: 66 6c 61 67 20 69 6e 20 74 68 65 20 76 64 62 65  flag in the vdbe
c8d0: 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 20 63   to update the c
c8e0: 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 77 68  hange counter wh
c8f0: 65 6e 20 69 74 20 69 73 20 66 69 6e 61 6c 69 73  en it is finalis
c900: 65 64 0a 2a 2a 20 6f 72 20 72 65 73 65 74 2e 0a  ed.** or reset..
c910: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
c920: 64 62 65 43 6f 75 6e 74 43 68 61 6e 67 65 73 28  dbeCountChanges(
c930: 56 64 62 65 20 2a 76 29 7b 0a 20 20 76 2d 3e 63  Vdbe *v){.  v->c
c940: 68 61 6e 67 65 43 6e 74 4f 6e 20 3d 20 31 3b 0a  hangeCntOn = 1;.
c950: 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 72 6b 20 65 76  }../*.** Mark ev
c960: 65 72 79 20 70 72 65 70 61 72 65 64 20 73 74 61  ery prepared sta
c970: 74 65 6d 65 6e 74 20 61 73 73 6f 63 69 61 74 65  tement associate
c980: 64 20 77 69 74 68 20 61 20 64 61 74 61 62 61 73  d with a databas
c990: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20  e connection.** 
c9a0: 61 73 20 65 78 70 69 72 65 64 2e 0a 2a 2a 0a 2a  as expired..**.*
c9b0: 2a 20 41 6e 20 65 78 70 69 72 65 64 20 73 74 61  * An expired sta
c9c0: 74 65 6d 65 6e 74 20 6d 65 61 6e 73 20 74 68 61  tement means tha
c9d0: 74 20 72 65 63 6f 6d 70 69 6c 61 74 69 6f 6e 20  t recompilation 
c9e0: 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  of the statement
c9f0: 20 69 73 0a 2a 2a 20 72 65 63 6f 6d 6d 65 6e 64   is.** recommend
ca00: 2e 20 20 53 74 61 74 65 6d 65 6e 74 73 20 65 78  .  Statements ex
ca10: 70 69 72 65 20 77 68 65 6e 20 74 68 69 6e 67 73  pire when things
ca20: 20 68 61 70 70 65 6e 20 74 68 61 74 20 6d 61 6b   happen that mak
ca30: 65 20 74 68 65 69 72 0a 2a 2a 20 70 72 6f 67 72  e their.** progr
ca40: 61 6d 73 20 6f 62 73 6f 6c 65 74 65 2e 20 20 52  ams obsolete.  R
ca50: 65 6d 6f 76 69 6e 67 20 75 73 65 72 2d 64 65 66  emoving user-def
ca60: 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 6f  ined functions o
ca70: 72 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a 2a 20 73  r collating.** s
ca80: 65 71 75 65 6e 63 65 73 2c 20 6f 72 20 63 68 61  equences, or cha
ca90: 6e 67 69 6e 67 20 61 6e 20 61 75 74 68 6f 72 69  nging an authori
caa0: 7a 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 20  zation function 
cab0: 61 72 65 20 74 68 65 20 74 79 70 65 73 20 6f 66  are the types of
cac0: 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 74 20  .** things that 
cad0: 6d 61 6b 65 20 70 72 65 70 61 72 65 64 20 73 74  make prepared st
cae0: 61 74 65 6d 65 6e 74 73 20 6f 62 73 6f 6c 65 74  atements obsolet
caf0: 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  e..*/.void sqlit
cb00: 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 64  e3ExpirePrepared
cb10: 53 74 61 74 65 6d 65 6e 74 73 28 73 71 6c 69 74  Statements(sqlit
cb20: 65 33 20 2a 64 62 29 7b 0a 20 20 56 64 62 65 20  e3 *db){.  Vdbe 
cb30: 2a 70 3b 0a 20 20 66 6f 72 28 70 20 3d 20 64 62  *p;.  for(p = db
cb40: 2d 3e 70 56 64 62 65 3b 20 70 3b 20 70 3d 70 2d  ->pVdbe; p; p=p-
cb50: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 2d 3e  >pNext){.    p->
cb60: 65 78 70 69 72 65 64 20 3d 20 31 3b 0a 20 20 7d  expired = 1;.  }
cb70: 0a 7d 0a                                         .}.