/ Hex Artifact Content
Login

Artifact 73928b98034cf3321afb6aa815723f08705bb135:


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 6e 64 65 66 20 4e 44 45 42  ED;.#ifndef NDEB
0a20: 55 47 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  UG.  if( sqlite3
0a30: 5f 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63  _vdbe_addop_trac
0a40: 65 20 29 20 73 71 6c 69 74 65 33 56 64 62 65 50  e ) sqlite3VdbeP
0a50: 72 69 6e 74 4f 70 28 30 2c 20 69 2c 20 26 70 2d  rintOp(0, i, &p-
0a60: 3e 61 4f 70 5b 69 5d 29 3b 0a 23 65 6e 64 69 66  >aOp[i]);.#endif
0a70: 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d 0a 0a  .  return i;.}..
0a80: 2f 2a 0a 2a 2a 20 41 64 64 20 61 6e 20 6f 70 63  /*.** Add an opc
0a90: 6f 64 65 20 74 68 61 74 20 69 6e 63 6c 75 64 65  ode that include
0aa0: 73 20 74 68 65 20 70 33 20 76 61 6c 75 65 2e 0a  s the p3 value..
0ab0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
0ac0: 62 65 4f 70 33 28 56 64 62 65 20 2a 70 2c 20 69  beOp3(Vdbe *p, i
0ad0: 6e 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c 20 69  nt op, int p1, i
0ae0: 6e 74 20 70 32 2c 20 63 6f 6e 73 74 20 63 68 61  nt p2, const cha
0af0: 72 20 2a 7a 50 33 2c 69 6e 74 20 70 33 74 79 70  r *zP3,int p3typ
0b00: 65 29 7b 0a 20 20 69 6e 74 20 61 64 64 72 20 3d  e){.  int addr =
0b10: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
0b20: 70 28 70 2c 20 6f 70 2c 20 70 31 2c 20 70 32 29  p(p, op, p1, p2)
0b30: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 43  ;.  sqlite3VdbeC
0b40: 68 61 6e 67 65 50 33 28 70 2c 20 61 64 64 72 2c  hangeP3(p, addr,
0b50: 20 7a 50 33 2c 20 70 33 74 79 70 65 29 3b 0a 20   zP3, p3type);. 
0b60: 20 72 65 74 75 72 6e 20 61 64 64 72 3b 0a 7d 0a   return addr;.}.
0b70: 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20  ./*.** Create a 
0b80: 6e 65 77 20 73 79 6d 62 6f 6c 69 63 20 6c 61 62  new symbolic lab
0b90: 65 6c 20 66 6f 72 20 61 6e 20 69 6e 73 74 72 75  el for an instru
0ba0: 63 74 69 6f 6e 20 74 68 61 74 20 68 61 73 20 79  ction that has y
0bb0: 65 74 20 74 6f 20 62 65 0a 2a 2a 20 63 6f 64 65  et to be.** code
0bc0: 64 2e 20 20 54 68 65 20 73 79 6d 62 6f 6c 69 63  d.  The symbolic
0bd0: 20 6c 61 62 65 6c 20 69 73 20 72 65 61 6c 6c 79   label is really
0be0: 20 6a 75 73 74 20 61 20 6e 65 67 61 74 69 76 65   just a negative
0bf0: 20 6e 75 6d 62 65 72 2e 20 20 54 68 65 0a 2a 2a   number.  The.**
0c00: 20 6c 61 62 65 6c 20 63 61 6e 20 62 65 20 75 73   label can be us
0c10: 65 64 20 61 73 20 74 68 65 20 50 32 20 76 61 6c  ed as the P2 val
0c20: 75 65 20 6f 66 20 61 6e 20 6f 70 65 72 61 74 69  ue of an operati
0c30: 6f 6e 2e 20 20 4c 61 74 65 72 2c 20 77 68 65 6e  on.  Later, when
0c40: 0a 2a 2a 20 74 68 65 20 6c 61 62 65 6c 20 69 73  .** the label is
0c50: 20 72 65 73 6f 6c 76 65 64 20 74 6f 20 61 20 73   resolved to a s
0c60: 70 65 63 69 66 69 63 20 61 64 64 72 65 73 73 2c  pecific address,
0c70: 20 74 68 65 20 56 44 42 45 20 77 69 6c 6c 20 73   the VDBE will s
0c80: 63 61 6e 0a 2a 2a 20 74 68 72 6f 75 67 68 20 69  can.** through i
0c90: 74 73 20 6f 70 65 72 61 74 69 6f 6e 20 6c 69 73  ts operation lis
0ca0: 74 20 61 6e 64 20 63 68 61 6e 67 65 20 61 6c 6c  t and change all
0cb0: 20 76 61 6c 75 65 73 20 6f 66 20 50 32 20 77 68   values of P2 wh
0cc0: 69 63 68 20 6d 61 74 63 68 0a 2a 2a 20 74 68 65  ich match.** the
0cd0: 20 6c 61 62 65 6c 20 69 6e 74 6f 20 74 68 65 20   label into the 
0ce0: 72 65 73 6f 6c 76 65 64 20 61 64 64 72 65 73 73  resolved address
0cf0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 56 44 42 45  ..**.** The VDBE
0d00: 20 6b 6e 6f 77 73 20 74 68 61 74 20 61 20 50 32   knows that a P2
0d10: 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62 65   value is a labe
0d20: 6c 20 62 65 63 61 75 73 65 20 6c 61 62 65 6c 73  l because labels
0d30: 20 61 72 65 0a 2a 2a 20 61 6c 77 61 79 73 20 6e   are.** always n
0d40: 65 67 61 74 69 76 65 20 61 6e 64 20 50 32 20 76  egative and P2 v
0d50: 61 6c 75 65 73 20 61 72 65 20 73 75 70 70 6f 73  alues are suppos
0d60: 65 20 74 6f 20 62 65 20 6e 6f 6e 2d 6e 65 67 61  e to be non-nega
0d70: 74 69 76 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c 20  tive..** Hence, 
0d80: 61 20 6e 65 67 61 74 69 76 65 20 50 32 20 76 61  a negative P2 va
0d90: 6c 75 65 20 69 73 20 61 20 6c 61 62 65 6c 20 74  lue is a label t
0da0: 68 61 74 20 68 61 73 20 79 65 74 20 74 6f 20 62  hat has yet to b
0db0: 65 20 72 65 73 6f 6c 76 65 64 2e 0a 2a 2a 0a 2a  e resolved..**.*
0dc0: 2a 20 5a 65 72 6f 20 69 73 20 72 65 74 75 72 6e  * Zero is return
0dd0: 65 64 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29  ed if a malloc()
0de0: 20 66 61 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20 73   fails..*/.int s
0df0: 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61  qlite3VdbeMakeLa
0e00: 62 65 6c 28 56 64 62 65 20 2a 70 29 7b 0a 20 20  bel(Vdbe *p){.  
0e10: 69 6e 74 20 69 3b 0a 20 20 69 20 3d 20 70 2d 3e  int i;.  i = p->
0e20: 6e 4c 61 62 65 6c 2b 2b 3b 0a 20 20 61 73 73 65  nLabel++;.  asse
0e30: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
0e40: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
0e50: 0a 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4c 61  .  if( i>=p->nLa
0e60: 62 65 6c 41 6c 6c 6f 63 20 29 7b 0a 20 20 20 20  belAlloc ){.    
0e70: 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20 3d  p->nLabelAlloc =
0e80: 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 2a   p->nLabelAlloc*
0e90: 32 20 2b 20 31 30 3b 0a 20 20 20 20 70 2d 3e 61  2 + 10;.    p->a
0ea0: 4c 61 62 65 6c 20 3d 20 73 71 6c 69 74 65 52 65  Label = sqliteRe
0eb0: 61 6c 6c 6f 63 28 20 70 2d 3e 61 4c 61 62 65 6c  alloc( p->aLabel
0ec0: 2c 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63  , p->nLabelAlloc
0ed0: 2a 73 69 7a 65 6f 66 28 70 2d 3e 61 4c 61 62 65  *sizeof(p->aLabe
0ee0: 6c 5b 30 5d 29 29 3b 0a 20 20 7d 0a 20 20 69 66  l[0]));.  }.  if
0ef0: 28 20 70 2d 3e 61 4c 61 62 65 6c 20 29 7b 0a 20  ( p->aLabel ){. 
0f00: 20 20 20 70 2d 3e 61 4c 61 62 65 6c 5b 69 5d 20     p->aLabel[i] 
0f10: 3d 20 2d 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75  = -1;.  }.  retu
0f20: 72 6e 20 2d 31 2d 69 3b 0a 7d 0a 0a 2f 2a 0a 2a  rn -1-i;.}../*.*
0f30: 2a 20 52 65 73 6f 6c 76 65 20 6c 61 62 65 6c 20  * Resolve label 
0f40: 22 78 22 20 74 6f 20 62 65 20 74 68 65 20 61 64  "x" to be the ad
0f50: 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 78  dress of the nex
0f60: 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f  t instruction to
0f70: 0a 2a 2a 20 62 65 20 69 6e 73 65 72 74 65 64 2e  .** be inserted.
0f80: 20 20 54 68 65 20 70 61 72 61 6d 65 74 65 72 20    The parameter 
0f90: 22 78 22 20 6d 75 73 74 20 68 61 76 65 20 62 65  "x" must have be
0fa0: 65 6e 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d  en obtained from
0fb0: 0a 2a 2a 20 61 20 70 72 69 6f 72 20 63 61 6c 6c  .** a prior call
0fc0: 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65 4d   to sqlite3VdbeM
0fd0: 61 6b 65 4c 61 62 65 6c 28 29 2e 0a 2a 2f 0a 76  akeLabel()..*/.v
0fe0: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 52  oid sqlite3VdbeR
0ff0: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62 65  esolveLabel(Vdbe
1000: 20 2a 70 2c 20 69 6e 74 20 78 29 7b 0a 20 20 69   *p, int x){.  i
1010: 6e 74 20 6a 20 3d 20 2d 31 2d 78 3b 0a 20 20 61  nt j = -1-x;.  a
1020: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
1030: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
1040: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6a 3e   );.  assert( j>
1050: 3d 30 20 26 26 20 6a 3c 70 2d 3e 6e 4c 61 62 65  =0 && j<p->nLabe
1060: 6c 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61 4c  l );.  if( p->aL
1070: 61 62 65 6c 20 29 7b 0a 20 20 20 20 70 2d 3e 61  abel ){.    p->a
1080: 4c 61 62 65 6c 5b 6a 5d 20 3d 20 70 2d 3e 6e 4f  Label[j] = p->nO
1090: 70 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  p;.  }.}../*.** 
10a0: 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 74 68 65  Loop through the
10b0: 20 70 72 6f 67 72 61 6d 20 6c 6f 6f 6b 69 6e 67   program looking
10c0: 20 66 6f 72 20 50 32 20 76 61 6c 75 65 73 20 74   for P2 values t
10d0: 68 61 74 20 61 72 65 20 6e 65 67 61 74 69 76 65  hat are negative
10e0: 2e 0a 2a 2a 20 45 61 63 68 20 73 75 63 68 20 76  ..** Each such v
10f0: 61 6c 75 65 20 69 73 20 61 20 6c 61 62 65 6c 2e  alue is a label.
1100: 20 20 52 65 73 6f 6c 76 65 20 74 68 65 20 6c 61    Resolve the la
1110: 62 65 6c 20 62 79 20 73 65 74 74 69 6e 67 20 74  bel by setting t
1120: 68 65 20 50 32 0a 2a 2a 20 76 61 6c 75 65 20 74  he P2.** value t
1130: 6f 20 69 74 73 20 63 6f 72 72 65 63 74 20 6e 6f  o its correct no
1140: 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 2e 0a 2a 2a  n-zero value..**
1150: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1160: 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 63 65 20   is called once 
1170: 61 66 74 65 72 20 61 6c 6c 20 6f 70 63 6f 64 65  after all opcode
1180: 73 20 68 61 76 65 20 62 65 65 6e 20 69 6e 73 65  s have been inse
1190: 72 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  rted..*/.static 
11a0: 76 6f 69 64 20 72 65 73 6f 6c 76 65 50 32 56 61  void resolveP2Va
11b0: 6c 75 65 73 28 56 64 62 65 20 2a 70 29 7b 0a 20  lues(Vdbe *p){. 
11c0: 20 69 6e 74 20 69 3b 0a 20 20 4f 70 20 2a 70 4f   int i;.  Op *pO
11d0: 70 3b 0a 20 20 69 6e 74 20 2a 61 4c 61 62 65 6c  p;.  int *aLabel
11e0: 20 3d 20 70 2d 3e 61 4c 61 62 65 6c 3b 0a 20 20   = p->aLabel;.  
11f0: 69 66 28 20 61 4c 61 62 65 6c 3d 3d 30 20 29 20  if( aLabel==0 ) 
1200: 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 70 4f  return;.  for(pO
1210: 70 3d 70 2d 3e 61 4f 70 2c 20 69 3d 70 2d 3e 6e  p=p->aOp, i=p->n
1220: 4f 70 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 2c  Op-1; i>=0; i--,
1230: 20 70 4f 70 2b 2b 29 7b 0a 20 20 20 20 69 66 28   pOp++){.    if(
1240: 20 70 4f 70 2d 3e 70 32 3e 3d 30 20 29 20 63 6f   pOp->p2>=0 ) co
1250: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 61 73 73 65  ntinue;.    asse
1260: 72 74 28 20 2d 31 2d 70 4f 70 2d 3e 70 32 3c 70  rt( -1-pOp->p2<p
1270: 2d 3e 6e 4c 61 62 65 6c 20 29 3b 0a 20 20 20 20  ->nLabel );.    
1280: 70 4f 70 2d 3e 70 32 20 3d 20 61 4c 61 62 65 6c  pOp->p2 = aLabel
1290: 5b 2d 31 2d 70 4f 70 2d 3e 70 32 5d 3b 0a 20 20  [-1-pOp->p2];.  
12a0: 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  }.  sqliteFree(p
12b0: 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20 20 70 2d 3e  ->aLabel);.  p->
12c0: 61 4c 61 62 65 6c 20 3d 20 30 3b 0a 7d 0a 0a 2f  aLabel = 0;.}../
12d0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
12e0: 61 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e  address of the n
12f0: 65 78 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20  ext instruction 
1300: 74 6f 20 62 65 20 69 6e 73 65 72 74 65 64 2e 0a  to be inserted..
1310: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
1320: 62 65 43 75 72 72 65 6e 74 41 64 64 72 28 56 64  beCurrentAddr(Vd
1330: 62 65 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74  be *p){.  assert
1340: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
1350: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
1360: 20 72 65 74 75 72 6e 20 70 2d 3e 6e 4f 70 3b 0a   return p->nOp;.
1370: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 77  }../*.** Add a w
1380: 68 6f 6c 65 20 6c 69 73 74 20 6f 66 20 6f 70 65  hole list of ope
1390: 72 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 6f  rations to the o
13a0: 70 65 72 61 74 69 6f 6e 20 73 74 61 63 6b 2e 20  peration stack. 
13b0: 20 52 65 74 75 72 6e 20 74 68 65 0a 2a 2a 20 61   Return the.** a
13c0: 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 66 69  ddress of the fi
13d0: 72 73 74 20 6f 70 65 72 61 74 69 6f 6e 20 61 64  rst operation ad
13e0: 64 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ded..*/.int sqli
13f0: 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74  te3VdbeAddOpList
1400: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 6e 4f  (Vdbe *p, int nO
1410: 70 2c 20 56 64 62 65 4f 70 4c 69 73 74 20 63 6f  p, VdbeOpList co
1420: 6e 73 74 20 2a 61 4f 70 29 7b 0a 20 20 69 6e 74  nst *aOp){.  int
1430: 20 61 64 64 72 3b 0a 20 20 61 73 73 65 72 74 28   addr;.  assert(
1440: 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f   p->magic==VDBE_
1450: 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20  MAGIC_INIT );.  
1460: 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70 2c  resizeOpArray(p,
1470: 20 70 2d 3e 6e 4f 70 20 2b 20 6e 4f 70 29 3b 0a   p->nOp + nOp);.
1480: 20 20 69 66 28 20 70 2d 3e 61 4f 70 3d 3d 30 20    if( p->aOp==0 
1490: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
14a0: 0a 20 20 7d 0a 20 20 61 64 64 72 20 3d 20 70 2d  .  }.  addr = p-
14b0: 3e 6e 4f 70 3b 0a 20 20 69 66 28 20 6e 4f 70 3e  >nOp;.  if( nOp>
14c0: 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a  0 ){.    int i;.
14d0: 20 20 20 20 56 64 62 65 4f 70 4c 69 73 74 20 63      VdbeOpList c
14e0: 6f 6e 73 74 20 2a 70 49 6e 20 3d 20 61 4f 70 3b  onst *pIn = aOp;
14f0: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
1500: 6e 4f 70 3b 20 69 2b 2b 2c 20 70 49 6e 2b 2b 29  nOp; i++, pIn++)
1510: 7b 0a 20 20 20 20 20 20 69 6e 74 20 70 32 20 3d  {.      int p2 =
1520: 20 70 49 6e 2d 3e 70 32 3b 0a 20 20 20 20 20 20   pIn->p2;.      
1530: 56 64 62 65 4f 70 20 2a 70 4f 75 74 20 3d 20 26  VdbeOp *pOut = &
1540: 70 2d 3e 61 4f 70 5b 69 2b 61 64 64 72 5d 3b 0a  p->aOp[i+addr];.
1550: 20 20 20 20 20 20 70 4f 75 74 2d 3e 6f 70 63 6f        pOut->opco
1560: 64 65 20 3d 20 70 49 6e 2d 3e 6f 70 63 6f 64 65  de = pIn->opcode
1570: 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 31  ;.      pOut->p1
1580: 20 3d 20 70 49 6e 2d 3e 70 31 3b 0a 20 20 20 20   = pIn->p1;.    
1590: 20 20 70 4f 75 74 2d 3e 70 32 20 3d 20 70 32 3c    pOut->p2 = p2<
15a0: 30 20 3f 20 61 64 64 72 20 2b 20 41 44 44 52 28  0 ? addr + ADDR(
15b0: 70 32 29 20 3a 20 70 32 3b 0a 20 20 20 20 20 20  p2) : p2;.      
15c0: 70 4f 75 74 2d 3e 70 33 20 3d 20 70 49 6e 2d 3e  pOut->p3 = pIn->
15d0: 70 33 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e  p3;.      pOut->
15e0: 70 33 74 79 70 65 20 3d 20 70 49 6e 2d 3e 70 33  p3type = pIn->p3
15f0: 20 3f 20 50 33 5f 53 54 41 54 49 43 20 3a 20 50   ? P3_STATIC : P
1600: 33 5f 4e 4f 54 55 53 45 44 3b 0a 23 69 66 6e 64  3_NOTUSED;.#ifnd
1610: 65 66 20 4e 44 45 42 55 47 0a 20 20 20 20 20 20  ef NDEBUG.      
1620: 69 66 28 20 73 71 6c 69 74 65 33 5f 76 64 62 65  if( sqlite3_vdbe
1630: 5f 61 64 64 6f 70 5f 74 72 61 63 65 20 29 7b 0a  _addop_trace ){.
1640: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56          sqlite3V
1650: 64 62 65 50 72 69 6e 74 4f 70 28 30 2c 20 69 2b  dbePrintOp(0, i+
1660: 61 64 64 72 2c 20 26 70 2d 3e 61 4f 70 5b 69 2b  addr, &p->aOp[i+
1670: 61 64 64 72 5d 29 3b 0a 20 20 20 20 20 20 7d 0a  addr]);.      }.
1680: 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20  #endif.    }.   
1690: 20 70 2d 3e 6e 4f 70 20 2b 3d 20 6e 4f 70 3b 0a   p->nOp += nOp;.
16a0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 61 64 64    }.  return add
16b0: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e  r;.}../*.** Chan
16c0: 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ge the value of 
16d0: 74 68 65 20 50 31 20 6f 70 65 72 61 6e 64 20 66  the P1 operand f
16e0: 6f 72 20 61 20 73 70 65 63 69 66 69 63 20 69 6e  or a specific in
16f0: 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68  struction..** Th
1700: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73  is routine is us
1710: 65 66 75 6c 20 77 68 65 6e 20 61 20 6c 61 72 67  eful when a larg
1720: 65 20 70 72 6f 67 72 61 6d 20 69 73 20 6c 6f 61  e program is loa
1730: 64 65 64 20 66 72 6f 6d 20 61 0a 2a 2a 20 73 74  ded from a.** st
1740: 61 74 69 63 20 61 72 72 61 79 20 75 73 69 6e 67  atic array using
1750: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
1760: 70 4c 69 73 74 20 62 75 74 20 77 65 20 77 61 6e  pList but we wan
1770: 74 20 74 6f 20 6d 61 6b 65 20 61 0a 2a 2a 20 66  t to make a.** f
1780: 65 77 20 6d 69 6e 6f 72 20 63 68 61 6e 67 65 73  ew minor changes
1790: 20 74 6f 20 74 68 65 20 70 72 6f 67 72 61 6d 2e   to the program.
17a0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
17b0: 56 64 62 65 43 68 61 6e 67 65 50 31 28 56 64 62  VdbeChangeP1(Vdb
17c0: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20  e *p, int addr, 
17d0: 69 6e 74 20 76 61 6c 29 7b 0a 20 20 61 73 73 65  int val){.  asse
17e0: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
17f0: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
1800: 0a 20 20 69 66 28 20 70 20 26 26 20 61 64 64 72  .  if( p && addr
1810: 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f 70 3e 61 64  >=0 && p->nOp>ad
1820: 64 72 20 26 26 20 70 2d 3e 61 4f 70 20 29 7b 0a  dr && p->aOp ){.
1830: 20 20 20 20 70 2d 3e 61 4f 70 5b 61 64 64 72 5d      p->aOp[addr]
1840: 2e 70 31 20 3d 20 76 61 6c 3b 0a 20 20 7d 0a 7d  .p1 = val;.  }.}
1850: 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74  ../*.** Change t
1860: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20  he value of the 
1870: 50 32 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61  P2 operand for a
1880: 20 73 70 65 63 69 66 69 63 20 69 6e 73 74 72 75   specific instru
1890: 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72  ction..** This r
18a0: 6f 75 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c  outine is useful
18b0: 20 66 6f 72 20 73 65 74 74 69 6e 67 20 61 20 6a   for setting a j
18c0: 75 6d 70 20 64 65 73 74 69 6e 61 74 69 6f 6e 2e  ump destination.
18d0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
18e0: 56 64 62 65 43 68 61 6e 67 65 50 32 28 56 64 62  VdbeChangeP2(Vdb
18f0: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20  e *p, int addr, 
1900: 69 6e 74 20 76 61 6c 29 7b 0a 20 20 61 73 73 65  int val){.  asse
1910: 72 74 28 20 76 61 6c 3e 3d 30 20 29 3b 0a 20 20  rt( val>=0 );.  
1920: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
1930: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
1940: 54 20 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20  T );.  if( p && 
1950: 61 64 64 72 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f  addr>=0 && p->nO
1960: 70 3e 61 64 64 72 20 26 26 20 70 2d 3e 61 4f 70  p>addr && p->aOp
1970: 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4f 70 5b 61   ){.    p->aOp[a
1980: 64 64 72 5d 2e 70 32 20 3d 20 76 61 6c 3b 0a 20  ddr].p2 = val;. 
1990: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e   }.}../*.** Chan
19a0: 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ge the value of 
19b0: 74 68 65 20 50 33 20 6f 70 65 72 61 6e 64 20 66  the P3 operand f
19c0: 6f 72 20 61 20 73 70 65 63 69 66 69 63 20 69 6e  or a specific in
19d0: 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68  struction..** Th
19e0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73  is routine is us
19f0: 65 66 75 6c 20 77 68 65 6e 20 61 20 6c 61 72 67  eful when a larg
1a00: 65 20 70 72 6f 67 72 61 6d 20 69 73 20 6c 6f 61  e program is loa
1a10: 64 65 64 20 66 72 6f 6d 20 61 0a 2a 2a 20 73 74  ded from a.** st
1a20: 61 74 69 63 20 61 72 72 61 79 20 75 73 69 6e 67  atic array using
1a30: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
1a40: 70 4c 69 73 74 20 62 75 74 20 77 65 20 77 61 6e  pList but we wan
1a50: 74 20 74 6f 20 6d 61 6b 65 20 61 0a 2a 2a 20 66  t to make a.** f
1a60: 65 77 20 6d 69 6e 6f 72 20 63 68 61 6e 67 65 73  ew minor changes
1a70: 20 74 6f 20 74 68 65 20 70 72 6f 67 72 61 6d 2e   to the program.
1a80: 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 3e 3d 30 20 74  .**.** If n>=0 t
1a90: 68 65 6e 20 74 68 65 20 50 33 20 6f 70 65 72 61  hen the P3 opera
1aa0: 6e 64 20 69 73 20 64 79 6e 61 6d 69 63 2c 20 6d  nd is dynamic, m
1ab0: 65 61 6e 69 6e 67 20 74 68 61 74 20 61 20 63 6f  eaning that a co
1ac0: 70 79 20 6f 66 0a 2a 2a 20 74 68 65 20 73 74 72  py of.** the str
1ad0: 69 6e 67 20 69 73 20 6d 61 64 65 20 69 6e 74 6f  ing is made into
1ae0: 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64   memory obtained
1af0: 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d 61 6c 6c   from sqliteMall
1b00: 6f 63 28 29 2e 0a 2a 2a 20 41 20 76 61 6c 75 65  oc()..** A value
1b10: 20 6f 66 20 6e 3d 3d 30 20 6d 65 61 6e 73 20 63   of n==0 means c
1b20: 6f 70 79 20 62 79 74 65 73 20 6f 66 20 7a 50 33  opy bytes of zP3
1b30: 20 75 70 20 74 6f 20 61 6e 64 20 69 6e 63 6c 75   up to and inclu
1b40: 64 69 6e 67 20 74 68 65 0a 2a 2a 20 66 69 72 73  ding the.** firs
1b50: 74 20 6e 75 6c 6c 20 62 79 74 65 2e 20 20 49 66  t null byte.  If
1b60: 20 6e 3e 30 20 74 68 65 6e 20 63 6f 70 79 20 6e   n>0 then copy n
1b70: 2b 31 20 62 79 74 65 73 20 6f 66 20 7a 50 33 2e  +1 bytes of zP3.
1b80: 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 3d 3d 50 33 5f  .**.** If n==P3_
1b90: 53 54 41 54 49 43 20 20 69 74 20 6d 65 61 6e 73  STATIC  it means
1ba0: 20 74 68 61 74 20 7a 50 33 20 69 73 20 61 20 70   that zP3 is a p
1bb0: 6f 69 6e 74 65 72 20 74 6f 20 61 20 63 6f 6e 73  ointer to a cons
1bc0: 74 61 6e 74 20 73 74 61 74 69 63 0a 2a 2a 20 73  tant static.** s
1bd0: 74 72 69 6e 67 20 61 6e 64 20 77 65 20 63 61 6e  tring and we can
1be0: 20 6a 75 73 74 20 63 6f 70 79 20 74 68 65 20 70   just copy the p
1bf0: 6f 69 6e 74 65 72 2e 20 20 6e 3d 3d 50 33 5f 50  ointer.  n==P3_P
1c00: 4f 49 4e 54 45 52 20 6d 65 61 6e 73 20 7a 50 33  OINTER means zP3
1c10: 20 69 73 0a 2a 2a 20 61 20 70 6f 69 6e 74 65 72   is.** a pointer
1c20: 20 74 6f 20 73 6f 6d 65 20 6f 62 6a 65 63 74 20   to some object 
1c30: 6f 74 68 65 72 20 74 68 61 6e 20 61 20 73 74 72  other than a str
1c40: 69 6e 67 2e 20 20 6e 3d 3d 50 33 5f 43 4f 4c 4c  ing.  n==P3_COLL
1c50: 53 45 51 20 61 6e 64 0a 2a 2a 20 6e 3d 3d 50 33  SEQ and.** n==P3
1c60: 5f 4b 45 59 49 4e 46 4f 20 6d 65 61 6e 20 74 68  _KEYINFO mean th
1c70: 61 74 20 7a 50 33 20 69 73 20 61 20 70 6f 69 6e  at zP3 is a poin
1c80: 74 65 72 20 74 6f 20 61 20 43 6f 6c 6c 53 65 71  ter to a CollSeq
1c90: 20 6f 72 20 4b 65 79 49 6e 66 6f 0a 2a 2a 20 73   or KeyInfo.** s
1ca0: 74 72 75 63 74 75 72 65 2e 20 20 41 20 63 6f 70  tructure.  A cop
1cb0: 79 20 69 73 20 6d 61 64 65 20 6f 66 20 4b 65 79  y is made of Key
1cc0: 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 73 20  Info structures 
1cd0: 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74 61  into memory obta
1ce0: 69 6e 65 64 0a 2a 2a 20 66 72 6f 6d 20 73 71 6c  ined.** from sql
1cf0: 69 74 65 4d 61 6c 6c 6f 63 2e 0a 2a 2a 0a 2a 2a  iteMalloc..**.**
1d00: 20 49 66 20 61 64 64 72 3c 30 20 74 68 65 6e 20   If addr<0 then 
1d10: 63 68 61 6e 67 65 20 50 33 20 6f 6e 20 74 68 65  change P3 on the
1d20: 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 69   most recently i
1d30: 6e 73 65 72 74 65 64 20 69 6e 73 74 72 75 63 74  nserted instruct
1d40: 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ion..*/.void sql
1d50: 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 33  ite3VdbeChangeP3
1d60: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64  (Vdbe *p, int ad
1d70: 64 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  dr, const char *
1d80: 7a 50 33 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 4f  zP3, int n){.  O
1d90: 70 20 2a 70 4f 70 3b 0a 20 20 61 73 73 65 72 74  p *pOp;.  assert
1da0: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
1db0: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
1dc0: 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e   if( p==0 || p->
1dd0: 61 4f 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  aOp==0 ) return;
1de0: 0a 20 20 69 66 28 20 61 64 64 72 3c 30 20 7c 7c  .  if( addr<0 ||
1df0: 20 61 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29 7b   addr>=p->nOp ){
1e00: 0a 20 20 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e  .    addr = p->n
1e10: 4f 70 20 2d 20 31 3b 0a 20 20 20 20 69 66 28 20  Op - 1;.    if( 
1e20: 61 64 64 72 3c 30 20 29 20 72 65 74 75 72 6e 3b  addr<0 ) return;
1e30: 0a 20 20 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d  .  }.  pOp = &p-
1e40: 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 69 66  >aOp[addr];.  if
1e50: 28 20 70 4f 70 2d 3e 70 33 20 26 26 20 70 4f 70  ( pOp->p3 && pOp
1e60: 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e  ->p3type==P3_DYN
1e70: 41 4d 49 43 20 29 7b 0a 20 20 20 20 73 71 6c 69  AMIC ){.    sqli
1e80: 74 65 46 72 65 65 28 70 4f 70 2d 3e 70 33 29 3b  teFree(pOp->p3);
1e90: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 30  .    pOp->p3 = 0
1ea0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 7a 50 33 3d  ;.  }.  if( zP3=
1eb0: 3d 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70  =0 ){.    pOp->p
1ec0: 33 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70 2d 3e  3 = 0;.    pOp->
1ed0: 70 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55  p3type = P3_NOTU
1ee0: 53 45 44 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  SED;.  }else if(
1ef0: 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 29   n==P3_KEYINFO )
1f00: 7b 0a 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70  {.    KeyInfo *p
1f10: 4b 65 79 49 6e 66 6f 3b 0a 20 20 20 20 69 6e 74  KeyInfo;.    int
1f20: 20 6e 46 69 65 6c 64 2c 20 6e 42 79 74 65 3b 0a   nField, nByte;.
1f30: 20 20 20 20 6e 46 69 65 6c 64 20 3d 20 28 28 4b      nField = ((K
1f40: 65 79 49 6e 66 6f 2a 29 7a 50 33 29 2d 3e 6e 46  eyInfo*)zP3)->nF
1f50: 69 65 6c 64 3b 0a 20 20 20 20 6e 42 79 74 65 20  ield;.    nByte 
1f60: 3d 20 73 69 7a 65 6f 66 28 2a 70 4b 65 79 49 6e  = sizeof(*pKeyIn
1f70: 66 6f 29 20 2b 20 28 6e 46 69 65 6c 64 2d 31 29  fo) + (nField-1)
1f80: 2a 73 69 7a 65 6f 66 28 70 4b 65 79 49 6e 66 6f  *sizeof(pKeyInfo
1f90: 2d 3e 61 43 6f 6c 6c 5b 30 5d 29 3b 0a 20 20 20  ->aColl[0]);.   
1fa0: 20 70 4b 65 79 49 6e 66 6f 20 3d 20 73 71 6c 69   pKeyInfo = sqli
1fb0: 74 65 4d 61 6c 6c 6f 63 52 61 77 28 20 6e 42 79  teMallocRaw( nBy
1fc0: 74 65 20 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70  te );.    pOp->p
1fd0: 33 20 3d 20 28 63 68 61 72 2a 29 70 4b 65 79 49  3 = (char*)pKeyI
1fe0: 6e 66 6f 3b 0a 20 20 20 20 69 66 28 20 70 4b 65  nfo;.    if( pKe
1ff0: 79 49 6e 66 6f 20 29 7b 0a 20 20 20 20 20 20 6d  yInfo ){.      m
2000: 65 6d 63 70 79 28 70 4b 65 79 49 6e 66 6f 2c 20  emcpy(pKeyInfo, 
2010: 7a 50 33 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20  zP3, nByte);.   
2020: 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d     pOp->p3type =
2030: 20 50 33 5f 4b 45 59 49 4e 46 4f 3b 0a 20 20 20   P3_KEYINFO;.   
2040: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4f   }else{.      pO
2050: 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4e  p->p3type = P3_N
2060: 4f 54 55 53 45 44 3b 0a 20 20 20 20 7d 0a 20 20  OTUSED;.    }.  
2070: 7d 65 6c 73 65 20 69 66 28 20 6e 3d 3d 50 33 5f  }else if( n==P3_
2080: 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46 46 20  KEYINFO_HANDOFF 
2090: 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d  ){.    pOp->p3 =
20a0: 20 28 63 68 61 72 2a 29 7a 50 33 3b 0a 20 20 20   (char*)zP3;.   
20b0: 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50   pOp->p3type = P
20c0: 33 5f 4b 45 59 49 4e 46 4f 3b 0a 20 20 7d 65 6c  3_KEYINFO;.  }el
20d0: 73 65 20 69 66 28 20 6e 3c 30 20 29 7b 0a 20 20  se if( n<0 ){.  
20e0: 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63 68 61    pOp->p3 = (cha
20f0: 72 2a 29 7a 50 33 3b 0a 20 20 20 20 70 4f 70 2d  r*)zP3;.    pOp-
2100: 3e 70 33 74 79 70 65 20 3d 20 6e 3b 0a 20 20 7d  >p3type = n;.  }
2110: 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 6e 3d  else{.    if( n=
2120: 3d 30 20 29 20 6e 20 3d 20 73 74 72 6c 65 6e 28  =0 ) n = strlen(
2130: 7a 50 33 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70  zP3);.    pOp->p
2140: 33 20 3d 20 73 71 6c 69 74 65 53 74 72 4e 44 75  3 = sqliteStrNDu
2150: 70 28 7a 50 33 2c 20 6e 29 3b 0a 20 20 20 20 70  p(zP3, n);.    p
2160: 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f  Op->p3type = P3_
2170: 44 59 4e 41 4d 49 43 3b 0a 20 20 7d 0a 7d 0a 0a  DYNAMIC;.  }.}..
2180: 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 2f  #ifndef NDEBUG./
2190: 2a 0a 2a 2a 20 52 65 70 6c 61 63 65 20 74 68 65  *.** Replace the
21a0: 20 50 33 20 66 69 65 6c 64 20 6f 66 20 74 68 65   P3 field of the
21b0: 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 63   most recently c
21c0: 6f 64 65 64 20 69 6e 73 74 72 75 63 74 69 6f 6e  oded instruction
21d0: 20 77 69 74 68 0a 2a 2a 20 63 6f 6d 6d 65 6e 74   with.** comment
21e0: 20 74 65 78 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73   text..*/.void s
21f0: 71 6c 69 74 65 33 56 64 62 65 43 6f 6d 6d 65 6e  qlite3VdbeCommen
2200: 74 28 56 64 62 65 20 2a 70 2c 20 63 6f 6e 73 74  t(Vdbe *p, const
2210: 20 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74 2c 20   char *zFormat, 
2220: 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20  ...){.  va_list 
2230: 61 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d  ap;.  assert( p-
2240: 3e 6e 4f 70 3e 30 20 29 3b 0a 20 20 61 73 73 65  >nOp>0 );.  asse
2250: 72 74 28 20 70 2d 3e 61 4f 70 3d 3d 30 20 7c 7c  rt( p->aOp==0 ||
2260: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31   p->aOp[p->nOp-1
2270: 5d 2e 70 33 3d 3d 30 20 29 3b 0a 20 20 76 61 5f  ].p3==0 );.  va_
2280: 73 74 61 72 74 28 61 70 2c 20 7a 46 6f 72 6d 61  start(ap, zForma
2290: 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  t);.  sqlite3Vdb
22a0: 65 43 68 61 6e 67 65 50 33 28 70 2c 20 2d 31 2c  eChangeP3(p, -1,
22b0: 20 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74 66   sqlite3VMPrintf
22c0: 28 7a 46 6f 72 6d 61 74 2c 20 61 70 29 2c 20 50  (zFormat, ap), P
22d0: 33 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20 76 61  3_DYNAMIC);.  va
22e0: 5f 65 6e 64 28 61 70 29 3b 0a 7d 0a 23 65 6e 64  _end(ap);.}.#end
22f0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65  if../*.** If the
2300: 20 50 33 20 6f 70 65 72 61 6e 64 20 74 6f 20 74   P3 operand to t
2310: 68 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 73  he specified ins
2320: 74 72 75 63 74 69 6f 6e 20 61 70 70 65 61 72 73  truction appears
2330: 0a 2a 2a 20 74 6f 20 62 65 20 61 20 71 75 6f 74  .** to be a quot
2340: 65 64 20 73 74 72 69 6e 67 20 74 6f 6b 65 6e 2c  ed string token,
2350: 20 74 68 65 6e 20 74 68 69 73 20 70 72 6f 63 65   then this proce
2360: 64 75 72 65 20 72 65 6d 6f 76 65 73 20 0a 2a 2a  dure removes .**
2370: 20 74 68 65 20 71 75 6f 74 65 73 2e 0a 2a 2a 0a   the quotes..**.
2380: 2a 2a 20 54 68 65 20 71 75 6f 74 69 6e 67 20 6f  ** The quoting o
2390: 70 65 72 61 74 6f 72 20 63 61 6e 20 62 65 20 65  perator can be e
23a0: 69 74 68 65 72 20 61 20 67 72 61 76 65 20 61 73  ither a grave as
23b0: 63 65 6e 74 20 28 41 53 43 49 49 20 30 78 32 37  cent (ASCII 0x27
23c0: 29 0a 2a 2a 20 6f 72 20 61 20 64 6f 75 62 6c 65  ).** or a double
23d0: 20 71 75 6f 74 65 20 63 68 61 72 61 63 74 65 72   quote character
23e0: 20 28 41 53 43 49 49 20 30 78 32 32 29 2e 20 20   (ASCII 0x22).  
23f0: 54 77 6f 20 71 75 6f 74 65 73 20 69 6e 20 61 20  Two quotes in a 
2400: 72 6f 77 0a 2a 2a 20 72 65 73 6f 6c 76 65 20 74  row.** resolve t
2410: 6f 20 62 65 20 61 20 73 69 6e 67 6c 65 20 61 63  o be a single ac
2420: 74 75 61 6c 20 71 75 6f 74 65 20 63 68 61 72 61  tual quote chara
2430: 63 74 65 72 20 77 69 74 68 69 6e 20 74 68 65 20  cter within the 
2440: 73 74 72 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20  string..*/.void 
2450: 73 71 6c 69 74 65 33 56 64 62 65 44 65 71 75 6f  sqlite3VdbeDequo
2460: 74 65 50 33 28 56 64 62 65 20 2a 70 2c 20 69 6e  teP3(Vdbe *p, in
2470: 74 20 61 64 64 72 29 7b 0a 20 20 4f 70 20 2a 70  t addr){.  Op *p
2480: 4f 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d  Op;.  assert( p-
2490: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
24a0: 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66 28  IC_INIT );.  if(
24b0: 20 70 2d 3e 61 4f 70 3d 3d 30 20 29 20 72 65 74   p->aOp==0 ) ret
24c0: 75 72 6e 3b 0a 20 20 69 66 28 20 61 64 64 72 3c  urn;.  if( addr<
24d0: 30 20 7c 7c 20 61 64 64 72 3e 3d 70 2d 3e 6e 4f  0 || addr>=p->nO
24e0: 70 20 29 7b 0a 20 20 20 20 61 64 64 72 20 3d 20  p ){.    addr = 
24f0: 70 2d 3e 6e 4f 70 20 2d 20 31 3b 0a 20 20 20 20  p->nOp - 1;.    
2500: 69 66 28 20 61 64 64 72 3c 30 20 29 20 72 65 74  if( addr<0 ) ret
2510: 75 72 6e 3b 0a 20 20 7d 0a 20 20 70 4f 70 20 3d  urn;.  }.  pOp =
2520: 20 26 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a   &p->aOp[addr];.
2530: 20 20 69 66 28 20 70 4f 70 2d 3e 70 33 3d 3d 30    if( pOp->p3==0
2540: 20 7c 7c 20 70 4f 70 2d 3e 70 33 5b 30 5d 3d 3d   || pOp->p3[0]==
2550: 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 69 66  0 ) return;.  if
2560: 28 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50  ( pOp->p3type==P
2570: 33 5f 53 54 41 54 49 43 20 29 7b 0a 20 20 20 20  3_STATIC ){.    
2580: 70 4f 70 2d 3e 70 33 20 3d 20 73 71 6c 69 74 65  pOp->p3 = sqlite
2590: 53 74 72 44 75 70 28 70 4f 70 2d 3e 70 33 29 3b  StrDup(pOp->p3);
25a0: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65  .    pOp->p3type
25b0: 20 3d 20 50 33 5f 44 59 4e 41 4d 49 43 3b 0a 20   = P3_DYNAMIC;. 
25c0: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 4f 70   }.  assert( pOp
25d0: 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e  ->p3type==P3_DYN
25e0: 41 4d 49 43 20 29 3b 0a 20 20 73 71 6c 69 74 65  AMIC );.  sqlite
25f0: 33 44 65 71 75 6f 74 65 28 70 4f 70 2d 3e 70 33  3Dequote(pOp->p3
2600: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 61 72  );.}../*.** Sear
2610: 63 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 70  ch the current p
2620: 72 6f 67 72 61 6d 20 73 74 61 72 74 69 6e 67 20  rogram starting 
2630: 61 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 61  at instruction a
2640: 64 64 72 20 66 6f 72 20 74 68 65 20 67 69 76 65  ddr for the give
2650: 6e 0a 2a 2a 20 6f 70 63 6f 64 65 20 61 6e 64 20  n.** opcode and 
2660: 50 32 20 76 61 6c 75 65 2e 20 20 52 65 74 75 72  P2 value.  Retur
2670: 6e 20 74 68 65 20 61 64 64 72 65 73 73 20 70 6c  n the address pl
2680: 75 73 20 31 20 69 66 20 66 6f 75 6e 64 20 61 6e  us 1 if found an
2690: 64 20 30 20 69 66 20 6e 6f 74 0a 2a 2a 20 66 6f  d 0 if not.** fo
26a0: 75 6e 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  und..*/.int sqli
26b0: 74 65 33 56 64 62 65 46 69 6e 64 4f 70 28 56 64  te3VdbeFindOp(Vd
26c0: 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c  be *p, int addr,
26d0: 20 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70 32 29   int op, int p2)
26e0: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 61 73 73  {.  int i;.  ass
26f0: 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  ert( p->magic==V
2700: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29  DBE_MAGIC_INIT )
2710: 3b 0a 20 20 66 6f 72 28 69 3d 61 64 64 72 3b 20  ;.  for(i=addr; 
2720: 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a  i<p->nOp; i++){.
2730: 20 20 20 20 69 66 28 20 70 2d 3e 61 4f 70 5b 69      if( p->aOp[i
2740: 5d 2e 6f 70 63 6f 64 65 3d 3d 6f 70 20 26 26 20  ].opcode==op && 
2750: 70 2d 3e 61 4f 70 5b 69 5d 2e 70 32 3d 3d 70 32  p->aOp[i].p2==p2
2760: 20 29 20 72 65 74 75 72 6e 20 69 2b 31 3b 0a 20   ) return i+1;. 
2770: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d   }.  return 0;.}
2780: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
2790: 68 65 20 6f 70 63 6f 64 65 20 66 6f 72 20 61 20  he opcode for a 
27a0: 67 69 76 65 6e 20 61 64 64 72 65 73 73 2e 0a 2a  given address..*
27b0: 2f 0a 56 64 62 65 4f 70 20 2a 73 71 6c 69 74 65  /.VdbeOp *sqlite
27c0: 33 56 64 62 65 47 65 74 4f 70 28 56 64 62 65 20  3VdbeGetOp(Vdbe 
27d0: 2a 70 2c 20 69 6e 74 20 61 64 64 72 29 7b 0a 20  *p, int addr){. 
27e0: 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69   assert( p->magi
27f0: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  c==VDBE_MAGIC_IN
2800: 49 54 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  IT );.  assert( 
2810: 61 64 64 72 3e 3d 30 20 26 26 20 61 64 64 72 3c  addr>=0 && addr<
2820: 70 2d 3e 6e 4f 70 20 29 3b 0a 20 20 72 65 74 75  p->nOp );.  retu
2830: 72 6e 20 26 70 2d 3e 61 4f 70 5b 61 64 64 72 5d  rn &p->aOp[addr]
2840: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75  ;.}../*.** Compu
2850: 74 65 20 61 20 73 74 72 69 6e 67 20 74 68 61 74  te a string that
2860: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 50   describes the P
2870: 33 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20  3 parameter for 
2880: 61 6e 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 55 73  an opcode..** Us
2890: 65 20 7a 54 65 6d 70 20 66 6f 72 20 61 6e 79 20  e zTemp for any 
28a0: 72 65 71 75 69 72 65 64 20 74 65 6d 70 6f 72 61  required tempora
28b0: 72 79 20 62 75 66 66 65 72 20 73 70 61 63 65 2e  ry buffer space.
28c0: 0a 2a 2f 0a 73 74 61 74 69 63 20 63 68 61 72 20  .*/.static char 
28d0: 2a 64 69 73 70 6c 61 79 50 33 28 4f 70 20 2a 70  *displayP3(Op *p
28e0: 4f 70 2c 20 63 68 61 72 20 2a 7a 54 65 6d 70 2c  Op, char *zTemp,
28f0: 20 69 6e 74 20 6e 54 65 6d 70 29 7b 0a 20 20 63   int nTemp){.  c
2900: 68 61 72 20 2a 7a 50 33 3b 0a 20 20 61 73 73 65  har *zP3;.  asse
2910: 72 74 28 20 6e 54 65 6d 70 3e 3d 32 30 20 29 3b  rt( nTemp>=20 );
2920: 0a 20 20 73 77 69 74 63 68 28 20 70 4f 70 2d 3e  .  switch( pOp->
2930: 70 33 74 79 70 65 20 29 7b 0a 20 20 20 20 63 61  p3type ){.    ca
2940: 73 65 20 50 33 5f 50 4f 49 4e 54 45 52 3a 20 7b  se P3_POINTER: {
2950: 0a 20 20 20 20 20 20 73 70 72 69 6e 74 66 28 7a  .      sprintf(z
2960: 54 65 6d 70 2c 20 22 70 74 72 28 25 23 78 29 22  Temp, "ptr(%#x)"
2970: 2c 20 28 69 6e 74 29 70 4f 70 2d 3e 70 33 29 3b  , (int)pOp->p3);
2980: 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54 65  .      zP3 = zTe
2990: 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b  mp;.      break;
29a0: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20  .    }.    case 
29b0: 50 33 5f 4b 45 59 49 4e 46 4f 3a 20 7b 0a 20 20  P3_KEYINFO: {.  
29c0: 20 20 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20      int i, j;.  
29d0: 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65      KeyInfo *pKe
29e0: 79 49 6e 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f  yInfo = (KeyInfo
29f0: 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20  *)pOp->p3;.     
2a00: 20 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20   sprintf(zTemp, 
2a10: 22 6b 65 79 69 6e 66 6f 28 25 64 22 2c 20 70 4b  "keyinfo(%d", pK
2a20: 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 29 3b  eyInfo->nField);
2a30: 0a 20 20 20 20 20 20 69 20 3d 20 73 74 72 6c 65  .      i = strle
2a40: 6e 28 7a 54 65 6d 70 29 3b 0a 20 20 20 20 20 20  n(zTemp);.      
2a50: 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 4b 65 79 49  for(j=0; j<pKeyI
2a60: 6e 66 6f 2d 3e 6e 46 69 65 6c 64 3b 20 6a 2b 2b  nfo->nField; j++
2a70: 29 7b 0a 20 20 20 20 20 20 20 20 43 6f 6c 6c 53  ){.        CollS
2a80: 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 70 4b 65 79  eq *pColl = pKey
2a90: 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 6a 5d 3b 0a  Info->aColl[j];.
2aa0: 20 20 20 20 20 20 20 20 69 66 28 20 70 43 6f 6c          if( pCol
2ab0: 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69  l ){.          i
2ac0: 6e 74 20 6e 20 3d 20 73 74 72 6c 65 6e 28 70 43  nt n = strlen(pC
2ad0: 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20  oll->zName);.   
2ae0: 20 20 20 20 20 20 20 69 66 28 20 69 2b 6e 3e 6e         if( i+n>n
2af0: 54 65 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20 20  Temp-6 ){.      
2b00: 20 20 20 20 20 20 73 74 72 63 70 79 28 26 7a 54        strcpy(&zT
2b10: 65 6d 70 5b 69 5d 2c 22 2c 2e 2e 2e 22 29 3b 0a  emp[i],",...");.
2b20: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61              brea
2b30: 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20  k;.          }. 
2b40: 20 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b 69           zTemp[i
2b50: 2b 2b 5d 20 3d 20 27 2c 27 3b 0a 20 20 20 20 20  ++] = ',';.     
2b60: 20 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66       if( pKeyInf
2b70: 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20 26 26  o->aSortOrder &&
2b80: 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74   pKeyInfo->aSort
2b90: 4f 72 64 65 72 5b 6a 5d 20 29 7b 0a 20 20 20 20  Order[j] ){.    
2ba0: 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b 69 2b          zTemp[i+
2bb0: 2b 5d 20 3d 20 27 2d 27 3b 0a 20 20 20 20 20 20  +] = '-';.      
2bc0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20      }.          
2bd0: 73 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d  strcpy(&zTemp[i]
2be0: 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b  , pColl->zName);
2bf0: 0a 20 20 20 20 20 20 20 20 20 20 69 20 2b 3d 20  .          i += 
2c00: 6e 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65  n;.        }else
2c10: 20 69 66 28 20 69 2b 34 3c 6e 54 65 6d 70 2d 36   if( i+4<nTemp-6
2c20: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74   ){.          st
2c30: 72 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d 2c 22  rcpy(&zTemp[i],"
2c40: 2c 6e 69 6c 22 29 3b 0a 20 20 20 20 20 20 20 20  ,nil");.        
2c50: 20 20 69 20 2b 3d 20 34 3b 0a 20 20 20 20 20 20    i += 4;.      
2c60: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20    }.      }.    
2c70: 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20 27    zTemp[i++] = '
2c80: 29 27 3b 0a 20 20 20 20 20 20 7a 54 65 6d 70 5b  )';.      zTemp[
2c90: 69 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 61 73  i] = 0;.      as
2ca0: 73 65 72 74 28 20 69 3c 6e 54 65 6d 70 20 29 3b  sert( i<nTemp );
2cb0: 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54 65  .      zP3 = zTe
2cc0: 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b  mp;.      break;
2cd0: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20  .    }.    case 
2ce0: 50 33 5f 43 4f 4c 4c 53 45 51 3a 20 7b 0a 20 20  P3_COLLSEQ: {.  
2cf0: 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f      CollSeq *pCo
2d00: 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 2a 29 70  ll = (CollSeq*)p
2d10: 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 73 70  Op->p3;.      sp
2d20: 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22 63 6f  rintf(zTemp, "co
2d30: 6c 6c 73 65 71 28 25 2e 32 30 73 29 22 2c 20 70  llseq(%.20s)", p
2d40: 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20  Coll->zName);.  
2d50: 20 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b      zP3 = zTemp;
2d60: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  .      break;.  
2d70: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 50 33 5f    }.    case P3_
2d80: 46 55 4e 43 44 45 46 3a 20 7b 0a 20 20 20 20 20  FUNCDEF: {.     
2d90: 20 46 75 6e 63 44 65 66 20 2a 70 44 65 66 20 3d   FuncDef *pDef =
2da0: 20 28 46 75 6e 63 44 65 66 2a 29 70 4f 70 2d 3e   (FuncDef*)pOp->
2db0: 70 33 3b 0a 20 20 20 20 20 20 63 68 61 72 20 7a  p3;.      char z
2dc0: 4e 75 6d 5b 33 30 5d 3b 0a 20 20 20 20 20 20 73  Num[30];.      s
2dd0: 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22 25  printf(zTemp, "%
2de0: 2e 2a 73 22 2c 20 6e 54 65 6d 70 2c 20 70 44 65  .*s", nTemp, pDe
2df0: 66 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20  f->zName);.     
2e00: 20 73 70 72 69 6e 74 66 28 7a 4e 75 6d 2c 22 28   sprintf(zNum,"(
2e10: 25 64 29 22 2c 20 70 44 65 66 2d 3e 6e 41 72 67  %d)", pDef->nArg
2e20: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 74 72  );.      if( str
2e30: 6c 65 6e 28 7a 54 65 6d 70 29 2b 73 74 72 6c 65  len(zTemp)+strle
2e40: 6e 28 7a 4e 75 6d 29 2b 31 3c 3d 6e 54 65 6d 70  n(zNum)+1<=nTemp
2e50: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 74 72 63   ){.        strc
2e60: 61 74 28 7a 54 65 6d 70 2c 20 7a 4e 75 6d 29 3b  at(zTemp, zNum);
2e70: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7a  .      }.      z
2e80: 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20 20  P3 = zTemp;.    
2e90: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20    break;.    }. 
2ea0: 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20     default: {.  
2eb0: 20 20 20 20 7a 50 33 20 3d 20 70 4f 70 2d 3e 70      zP3 = pOp->p
2ec0: 33 3b 0a 20 20 20 20 20 20 69 66 28 20 7a 50 33  3;.      if( zP3
2ed0: 3d 3d 30 20 7c 7c 20 70 4f 70 2d 3e 6f 70 63 6f  ==0 || pOp->opco
2ee0: 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a 20  de==OP_Noop ){. 
2ef0: 20 20 20 20 20 20 20 7a 50 33 20 3d 20 22 22 3b         zP3 = "";
2f00: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
2f10: 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 50 33 3b   }.  return zP3;
2f20: 0a 7d 0a 0a 0a 23 69 66 20 21 64 65 66 69 6e 65  .}...#if !define
2f30: 64 28 4e 44 45 42 55 47 29 20 7c 7c 20 64 65 66  d(NDEBUG) || def
2f40: 69 6e 65 64 28 56 44 42 45 5f 50 52 4f 46 49 4c  ined(VDBE_PROFIL
2f50: 45 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51  E) || defined(SQ
2f60: 4c 49 54 45 5f 44 45 42 55 47 29 0a 2f 2a 0a 2a  LITE_DEBUG)./*.*
2f70: 2a 20 50 72 69 6e 74 20 61 20 73 69 6e 67 6c 65  * Print a single
2f80: 20 6f 70 63 6f 64 65 2e 20 20 54 68 69 73 20 72   opcode.  This r
2f90: 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 66  outine is used f
2fa0: 6f 72 20 64 65 62 75 67 67 69 6e 67 20 6f 6e 6c  or debugging onl
2fb0: 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  y..*/.void sqlit
2fc0: 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28 46 49  e3VdbePrintOp(FI
2fd0: 4c 45 20 2a 70 4f 75 74 2c 20 69 6e 74 20 70 63  LE *pOut, int pc
2fe0: 2c 20 4f 70 20 2a 70 4f 70 29 7b 0a 20 20 63 68  , Op *pOp){.  ch
2ff0: 61 72 20 2a 7a 50 33 3b 0a 20 20 63 68 61 72 20  ar *zP3;.  char 
3000: 7a 50 74 72 5b 35 30 5d 3b 0a 20 20 73 74 61 74  zPtr[50];.  stat
3010: 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  ic const char *z
3020: 46 6f 72 6d 61 74 31 20 3d 20 22 25 34 64 20 25  Format1 = "%4d %
3030: 2d 31 33 73 20 25 34 64 20 25 34 64 20 25 73 5c  -13s %4d %4d %s\
3040: 6e 22 3b 0a 20 20 69 66 28 20 70 4f 75 74 3d 3d  n";.  if( pOut==
3050: 30 20 29 20 70 4f 75 74 20 3d 20 73 74 64 6f 75  0 ) pOut = stdou
3060: 74 3b 0a 20 20 7a 50 33 20 3d 20 64 69 73 70 6c  t;.  zP3 = displ
3070: 61 79 50 33 28 70 4f 70 2c 20 7a 50 74 72 2c 20  ayP3(pOp, zPtr, 
3080: 73 69 7a 65 6f 66 28 7a 50 74 72 29 29 3b 0a 20  sizeof(zPtr));. 
3090: 20 66 70 72 69 6e 74 66 28 70 4f 75 74 2c 20 7a   fprintf(pOut, z
30a0: 46 6f 72 6d 61 74 31 2c 0a 20 20 20 20 20 20 70  Format1,.      p
30b0: 63 2c 20 73 71 6c 69 74 65 33 4f 70 63 6f 64 65  c, sqlite3Opcode
30c0: 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f 70 63 6f 64  Names[pOp->opcod
30d0: 65 5d 2c 20 70 4f 70 2d 3e 70 31 2c 20 70 4f 70  e], pOp->p1, pOp
30e0: 2d 3e 70 32 2c 20 7a 50 33 29 3b 0a 20 20 66 66  ->p2, zP3);.  ff
30f0: 6c 75 73 68 28 70 4f 75 74 29 3b 0a 7d 0a 23 65  lush(pOut);.}.#e
3100: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65  ndif../*.** Rele
3110: 61 73 65 20 61 6e 20 61 72 72 61 79 20 6f 66 20  ase an array of 
3120: 4e 20 4d 65 6d 20 65 6c 65 6d 65 6e 74 73 0a 2a  N Mem elements.*
3130: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 65  /.static void re
3140: 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 4d 65  leaseMemArray(Me
3150: 6d 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20  m *p, int N){.  
3160: 69 66 28 20 70 20 29 7b 0a 20 20 20 20 77 68 69  if( p ){.    whi
3170: 6c 65 28 20 4e 2d 2d 3e 30 20 29 7b 0a 20 20 20  le( N-->0 ){.   
3180: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
3190: 6d 52 65 6c 65 61 73 65 28 70 2b 2b 29 3b 0a 20  mRelease(p++);. 
31a0: 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a     }.  }.}../*.*
31b0: 2a 20 47 69 76 65 20 61 20 6c 69 73 74 69 6e 67  * Give a listing
31c0: 20 6f 66 20 74 68 65 20 70 72 6f 67 72 61 6d 20   of the program 
31d0: 69 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d  in the virtual m
31e0: 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  achine..**.** Th
31f0: 65 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 74  e interface is t
3200: 68 65 20 73 61 6d 65 20 61 73 20 73 71 6c 69 74  he same as sqlit
3210: 65 33 56 64 62 65 45 78 65 63 28 29 2e 20 20 42  e3VdbeExec().  B
3220: 75 74 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a  ut instead of.**
3230: 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 63 6f 64   running the cod
3240: 65 2c 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68  e, it invokes th
3250: 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20  e callback once 
3260: 66 6f 72 20 65 61 63 68 20 69 6e 73 74 72 75 63  for each instruc
3270: 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 66 65  tion..** This fe
3280: 61 74 75 72 65 20 69 73 20 75 73 65 64 20 74 6f  ature is used to
3290: 20 69 6d 70 6c 65 6d 65 6e 74 20 22 45 58 50 4c   implement "EXPL
32a0: 41 49 4e 22 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  AIN"..*/.int sql
32b0: 69 74 65 33 56 64 62 65 4c 69 73 74 28 0a 20 20  ite3VdbeList(.  
32c0: 56 64 62 65 20 2a 70 20 20 20 20 20 20 20 20 20  Vdbe *p         
32d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
32e0: 20 56 44 42 45 20 2a 2f 0a 29 7b 0a 20 20 73 71   VDBE */.){.  sq
32f0: 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64  lite3 *db = p->d
3300: 62 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e  b;.  int i;.  in
3310: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
3320: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  ;..  assert( p->
3330: 65 78 70 6c 61 69 6e 20 29 3b 0a 0a 20 20 2f 2a  explain );..  /*
3340: 20 45 76 65 6e 20 74 68 6f 75 67 68 20 74 68 69   Even though thi
3350: 73 20 6f 70 63 6f 64 65 20 64 6f 65 73 20 6e 6f  s opcode does no
3360: 74 20 70 75 74 20 64 79 6e 61 6d 69 63 20 73 74  t put dynamic st
3370: 72 69 6e 67 73 20 6f 6e 74 6f 20 74 68 65 0a 20  rings onto the. 
3380: 20 2a 2a 20 74 68 65 20 73 74 61 63 6b 2c 20 74   ** the stack, t
3390: 68 65 79 20 6d 61 79 20 62 65 63 6f 6d 65 20 64  hey may become d
33a0: 79 6e 61 6d 69 63 20 69 66 20 74 68 65 20 75 73  ynamic if the us
33b0: 65 72 20 63 61 6c 6c 73 0a 20 20 2a 2a 20 73 71  er calls.  ** sq
33c0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78  lite3_column_tex
33d0: 74 31 36 28 29 2c 20 63 61 75 73 69 6e 67 20 61  t16(), causing a
33e0: 20 74 72 61 6e 73 6c 61 74 69 6f 6e 20 74 6f 20   translation to 
33f0: 55 54 46 2d 31 36 20 65 6e 63 6f 64 69 6e 67 2e  UTF-16 encoding.
3400: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70  .  */.  if( p->p
3410: 54 6f 73 3d 3d 26 70 2d 3e 61 53 74 61 63 6b 5b  Tos==&p->aStack[
3420: 34 5d 20 29 7b 0a 20 20 20 20 72 65 6c 65 61 73  4] ){.    releas
3430: 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 53 74  eMemArray(p->aSt
3440: 61 63 6b 2c 20 35 29 3b 0a 20 20 7d 0a 20 20 70  ack, 5);.  }.  p
3450: 2d 3e 72 65 73 4f 6e 53 74 61 63 6b 20 3d 20 30  ->resOnStack = 0
3460: 3b 0a 0a 20 20 69 20 3d 20 70 2d 3e 70 63 2b 2b  ;..  i = p->pc++
3470: 3b 0a 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4f  ;.  if( i>=p->nO
3480: 70 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d  p ){.    p->rc =
3490: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20   SQLITE_OK;.    
34a0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45  rc = SQLITE_DONE
34b0: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62  ;.  }else if( db
34c0: 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45  ->flags & SQLITE
34d0: 5f 49 6e 74 65 72 72 75 70 74 20 29 7b 0a 20 20  _Interrupt ){.  
34e0: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e    db->flags &= ~
34f0: 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74  SQLITE_Interrupt
3500: 3b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 61  ;.    if( db->ma
3510: 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49  gic!=SQLITE_MAGI
3520: 43 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20  C_BUSY ){.      
3530: 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d  p->rc = SQLITE_M
3540: 49 53 55 53 45 3b 0a 20 20 20 20 7d 65 6c 73 65  ISUSE;.    }else
3550: 7b 0a 20 20 20 20 20 20 70 2d 3e 72 63 20 3d 20  {.      p->rc = 
3560: 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54  SQLITE_INTERRUPT
3570: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d  ;.    }.    rc =
3580: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
3590: 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72     sqlite3SetStr
35a0: 69 6e 67 28 26 70 2d 3e 7a 45 72 72 4d 73 67 2c  ing(&p->zErrMsg,
35b0: 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 70   sqlite3ErrStr(p
35c0: 2d 3e 72 63 29 2c 20 28 63 68 61 72 2a 29 30 29  ->rc), (char*)0)
35d0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 4f  ;.  }else{.    O
35e0: 70 20 2a 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70  p *pOp = &p->aOp
35f0: 5b 69 5d 3b 0a 20 20 20 20 4d 65 6d 20 2a 70 4d  [i];.    Mem *pM
3600: 65 6d 20 3d 20 70 2d 3e 61 53 74 61 63 6b 3b 0a  em = p->aStack;.
3610: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
3620: 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70  = MEM_Int;.    p
3630: 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49  Mem->type = SQLI
3640: 54 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20  TE_INTEGER;.    
3650: 70 4d 65 6d 2d 3e 69 20 3d 20 69 3b 20 20 20 20  pMem->i = i;    
3660: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3670: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
3680: 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 20 2a  rogram counter *
3690: 2f 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20  /.    pMem++;.. 
36a0: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
36b0: 20 4d 45 4d 5f 53 74 61 74 69 63 7c 4d 45 4d 5f   MEM_Static|MEM_
36c0: 53 74 72 7c 4d 45 4d 5f 54 65 72 6d 3b 0a 20 20  Str|MEM_Term;.  
36d0: 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 73 71 6c 69    pMem->z = sqli
36e0: 74 65 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70  te3OpcodeNames[p
36f0: 4f 70 2d 3e 6f 70 63 6f 64 65 5d 3b 20 20 2f 2a  Op->opcode];  /*
3700: 20 4f 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 70   Opcode */.    p
3710: 4d 65 6d 2d 3e 6e 20 3d 20 73 74 72 6c 65 6e 28  Mem->n = strlen(
3720: 70 4d 65 6d 2d 3e 7a 29 3b 0a 20 20 20 20 70 4d  pMem->z);.    pM
3730: 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54  em->type = SQLIT
3740: 45 5f 54 45 58 54 3b 0a 20 20 20 20 70 4d 65 6d  E_TEXT;.    pMem
3750: 2d 3e 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55  ->enc = SQLITE_U
3760: 54 46 38 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b  TF8;.    pMem++;
3770: 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67  ..    pMem->flag
3780: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
3790: 20 70 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70 2d 3e   pMem->i = pOp->
37a0: 70 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  p1;             
37b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
37c0: 50 31 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e  P1 */.    pMem->
37d0: 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e  type = SQLITE_IN
37e0: 54 45 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2b  TEGER;.    pMem+
37f0: 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  +;..    pMem->fl
3800: 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20  ags = MEM_Int;. 
3810: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70     pMem->i = pOp
3820: 2d 3e 70 32 3b 20 20 20 20 20 20 20 20 20 20 20  ->p2;           
3830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
3840: 2a 20 50 32 20 2a 2f 0a 20 20 20 20 70 4d 65 6d  * P2 */.    pMem
3850: 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f  ->type = SQLITE_
3860: 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70 4d 65  INTEGER;.    pMe
3870: 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e  m++;..    pMem->
3880: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 68 6f 72  flags = MEM_Shor
3890: 74 7c 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 54 65  t|MEM_Str|MEM_Te
38a0: 72 6d 3b 20 20 20 2f 2a 20 50 33 20 2a 2f 0a 20  rm;   /* P3 */. 
38b0: 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 64 69 73     pMem->z = dis
38c0: 70 6c 61 79 50 33 28 70 4f 70 2c 20 70 4d 65 6d  playP3(pOp, pMem
38d0: 2d 3e 7a 53 68 6f 72 74 2c 20 73 69 7a 65 6f 66  ->zShort, sizeof
38e0: 28 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 29 29 3b  (pMem->zShort));
38f0: 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20  .    pMem->type 
3900: 3d 20 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20  = SQLITE_TEXT;. 
3910: 20 20 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20 53     pMem->enc = S
3920: 51 4c 49 54 45 5f 55 54 46 38 3b 0a 0a 20 20 20  QLITE_UTF8;..   
3930: 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3d   p->nResColumn =
3940: 20 35 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20   5;.    p->pTos 
3950: 3d 20 70 4d 65 6d 3b 0a 20 20 20 20 70 2d 3e 72  = pMem;.    p->r
3960: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
3970: 20 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61 63 6b     p->resOnStack
3980: 20 3d 20 31 3b 0a 20 20 20 20 72 63 20 3d 20 53   = 1;.    rc = S
3990: 51 4c 49 54 45 5f 52 4f 57 3b 0a 20 20 7d 0a 20  QLITE_ROW;.  }. 
39a0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
39b0: 2a 0a 2a 2a 20 50 72 69 6e 74 20 74 68 65 20 53  *.** Print the S
39c0: 51 4c 20 74 68 61 74 20 77 61 73 20 75 73 65 64  QL that was used
39d0: 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 20 56   to generate a V
39e0: 44 42 45 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a  DBE program..*/.
39f0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
3a00: 50 72 69 6e 74 53 71 6c 28 56 64 62 65 20 2a 70  PrintSql(Vdbe *p
3a10: 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  ){.#ifdef SQLITE
3a20: 5f 44 45 42 55 47 0a 20 20 69 6e 74 20 6e 4f 70  _DEBUG.  int nOp
3a30: 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 56 64 62   = p->nOp;.  Vdb
3a40: 65 4f 70 20 2a 70 4f 70 3b 0a 20 20 69 66 28 20  eOp *pOp;.  if( 
3a50: 6e 4f 70 3c 31 20 29 20 72 65 74 75 72 6e 3b 0a  nOp<1 ) return;.
3a60: 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b    pOp = &p->aOp[
3a70: 6e 4f 70 2d 31 5d 3b 0a 20 20 69 66 28 20 70 4f  nOp-1];.  if( pO
3a80: 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f  p->opcode==OP_No
3a90: 6f 70 20 26 26 20 70 4f 70 2d 3e 70 33 21 3d 30  op && pOp->p3!=0
3aa0: 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68   ){.    const ch
3ab0: 61 72 20 2a 7a 20 3d 20 70 4f 70 2d 3e 70 33 3b  ar *z = pOp->p3;
3ac0: 0a 20 20 20 20 77 68 69 6c 65 28 20 69 73 73 70  .    while( issp
3ad0: 61 63 65 28 2a 28 75 38 2a 29 7a 29 20 29 20 7a  ace(*(u8*)z) ) z
3ae0: 2b 2b 3b 0a 20 20 20 20 70 72 69 6e 74 66 28 22  ++;.    printf("
3af0: 53 51 4c 3a 20 5b 25 73 5d 5c 6e 22 2c 20 7a 29  SQL: [%s]\n", z)
3b00: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a  ;.  }.#endif.}..
3b10: 2f 2a 0a 2a 2a 20 50 72 65 70 61 72 65 20 61 20  /*.** Prepare a 
3b20: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20  virtual machine 
3b30: 66 6f 72 20 65 78 65 63 75 74 69 6f 6e 2e 20 20  for execution.  
3b40: 54 68 69 73 20 69 6e 76 6f 6c 76 65 73 20 74 68  This involves th
3b50: 69 6e 67 73 20 73 75 63 68 0a 2a 2a 20 61 73 20  ings such.** as 
3b60: 61 6c 6c 6f 63 61 74 69 6e 67 20 73 74 61 63 6b  allocating stack
3b70: 20 73 70 61 63 65 20 61 6e 64 20 69 6e 69 74 69   space and initi
3b80: 61 6c 69 7a 69 6e 67 20 74 68 65 20 70 72 6f 67  alizing the prog
3b90: 72 61 6d 20 63 6f 75 6e 74 65 72 2e 0a 2a 2a 20  ram counter..** 
3ba0: 41 66 74 65 72 20 74 68 65 20 56 44 42 45 20 68  After the VDBE h
3bb0: 61 73 20 62 65 20 70 72 65 70 70 65 64 2c 20 69  as be prepped, i
3bc0: 74 20 63 61 6e 20 62 65 20 65 78 65 63 75 74 65  t can be execute
3bd0: 64 20 62 79 20 6f 6e 65 20 6f 72 20 6d 6f 72 65  d by one or more
3be0: 0a 2a 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c  .** calls to sql
3bf0: 69 74 65 33 56 64 62 65 45 78 65 63 28 29 2e 20  ite3VdbeExec(). 
3c00: 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20   .**.** This is 
3c10: 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20  the only way to 
3c20: 6d 6f 76 65 20 61 20 56 44 42 45 20 66 72 6f 6d  move a VDBE from
3c30: 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54   VDBE_MAGIC_INIT
3c40: 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49   to.** VDBE_MAGI
3c50: 43 5f 52 55 4e 2e 0a 2a 2f 0a 76 6f 69 64 20 73  C_RUN..*/.void s
3c60: 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52 65  qlite3VdbeMakeRe
3c70: 61 64 79 28 0a 20 20 56 64 62 65 20 2a 70 2c 20  ady(.  Vdbe *p, 
3c80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3c90: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 56 44 42        /* The VDB
3ca0: 45 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 61 72 2c  E */.  int nVar,
3cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3cc0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
3cd0: 6f 66 20 27 3f 27 20 73 65 65 20 69 6e 20 74 68  of '?' see in th
3ce0: 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  e SQL statement 
3cf0: 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 2c 20 20  */.  int nMem,  
3d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3d10: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
3d20: 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73 20 74 6f   memory cells to
3d30: 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a 20 20 69   allocate */.  i
3d40: 6e 74 20 6e 43 75 72 73 6f 72 2c 20 20 20 20 20  nt nCursor,     
3d50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3d60: 20 4e 75 6d 62 65 72 20 6f 66 20 63 75 72 73 6f   Number of curso
3d70: 72 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a  rs to allocate *
3d80: 2f 0a 20 20 69 6e 74 20 69 73 45 78 70 6c 61 69  /.  int isExplai
3d90: 6e 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  n               
3da0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68     /* True if th
3db0: 65 20 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72  e EXPLAIN keywor
3dc0: 64 73 20 69 73 20 70 72 65 73 65 6e 74 20 2a 2f  ds is present */
3dd0: 0a 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 0a 20 20  .){.  int n;..  
3de0: 61 73 73 65 72 74 28 20 70 21 3d 30 20 29 3b 0a  assert( p!=0 );.
3df0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67    assert( p->mag
3e00: 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49  ic==VDBE_MAGIC_I
3e10: 4e 49 54 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 65  NIT );..  /* The
3e20: 72 65 20 73 68 6f 75 6c 64 20 62 65 20 61 74 20  re should be at 
3e30: 6c 65 61 73 74 20 6f 6e 65 20 6f 70 63 6f 64 65  least one opcode
3e40: 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  ..  */.  assert(
3e50: 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 0a 20 20   p->nOp>0 );..  
3e60: 2f 2a 20 4e 6f 20 69 6e 73 74 72 75 63 74 69 6f  /* No instructio
3e70: 6e 20 65 76 65 72 20 70 75 73 68 65 73 20 6d 6f  n ever pushes mo
3e80: 72 65 20 74 68 61 6e 20 61 20 73 69 6e 67 6c 65  re than a single
3e90: 20 65 6c 65 6d 65 6e 74 20 6f 6e 74 6f 20 74 68   element onto th
3ea0: 65 0a 20 20 2a 2a 20 73 74 61 63 6b 2e 20 20 41  e.  ** stack.  A
3eb0: 6e 64 20 74 68 65 20 73 74 61 63 6b 20 6e 65 76  nd the stack nev
3ec0: 65 72 20 67 72 6f 77 73 20 6f 6e 20 73 75 63 63  er grows on succ
3ed0: 65 73 73 69 76 65 20 65 78 65 63 75 74 69 6f 6e  essive execution
3ee0: 73 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 73 61  s of the.  ** sa
3ef0: 6d 65 20 6c 6f 6f 70 2e 20 20 53 6f 20 74 68 65  me loop.  So the
3f00: 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   total number of
3f10: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 73   instructions is
3f20: 20 61 6e 20 75 70 70 65 72 20 62 6f 75 6e 64 0a   an upper bound.
3f30: 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6d 61 78 69    ** on the maxi
3f40: 6d 75 6d 20 73 74 61 63 6b 20 64 65 70 74 68 20  mum stack depth 
3f50: 72 65 71 75 69 72 65 64 2e 0a 20 20 2a 2a 0a 20  required..  **. 
3f60: 20 2a 2a 20 41 6c 6c 6f 63 61 74 69 6f 6e 20 61   ** Allocation a
3f70: 6c 6c 20 74 68 65 20 73 74 61 63 6b 20 73 70 61  ll the stack spa
3f80: 63 65 20 77 65 20 77 69 6c 6c 20 65 76 65 72 20  ce we will ever 
3f90: 6e 65 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  need..  */.  if(
3fa0: 20 70 2d 3e 61 53 74 61 63 6b 3d 3d 30 20 29 7b   p->aStack==0 ){
3fb0: 0a 20 20 20 20 72 65 73 6f 6c 76 65 50 32 56 61  .    resolveP2Va
3fc0: 6c 75 65 73 28 70 29 3b 0a 20 20 20 20 61 73 73  lues(p);.    ass
3fd0: 65 72 74 28 20 6e 56 61 72 3e 3d 30 20 29 3b 0a  ert( nVar>=0 );.
3fe0: 20 20 20 20 6e 20 3d 20 69 73 45 78 70 6c 61 69      n = isExplai
3ff0: 6e 20 3f 20 31 30 20 3a 20 70 2d 3e 6e 4f 70 3b  n ? 10 : p->nOp;
4000: 0a 20 20 20 20 70 2d 3e 61 53 74 61 63 6b 20 3d  .    p->aStack =
4010: 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 0a 20   sqliteMalloc(. 
4020: 20 20 20 20 20 20 20 6e 2a 73 69 7a 65 6f 66 28         n*sizeof(
4030: 70 2d 3e 61 53 74 61 63 6b 5b 30 5d 29 20 20 20  p->aStack[0])   
4040: 20 20 20 20 20 20 2f 2a 20 61 53 74 61 63 6b 20        /* aStack 
4050: 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 2a 73 69 7a  */.      + n*siz
4060: 65 6f 66 28 4d 65 6d 2a 29 20 20 20 20 20 20 20  eof(Mem*)       
4070: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 61 70 41            /* apA
4080: 72 67 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 56  rg */.      + nV
4090: 61 72 2a 73 69 7a 65 6f 66 28 4d 65 6d 29 20 20  ar*sizeof(Mem)  
40a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
40b0: 61 56 61 72 20 2a 2f 0a 20 20 20 20 20 20 2b 20  aVar */.      + 
40c0: 6e 56 61 72 2a 73 69 7a 65 6f 66 28 63 68 61 72  nVar*sizeof(char
40d0: 2a 29 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  *)             /
40e0: 2a 20 61 7a 56 61 72 20 2a 2f 0a 20 20 20 20 20  * azVar */.     
40f0: 20 2b 20 6e 4d 65 6d 2a 73 69 7a 65 6f 66 28 4d   + nMem*sizeof(M
4100: 65 6d 29 20 20 20 20 20 20 20 20 20 20 20 20 20  em)             
4110: 20 20 2f 2a 20 61 4d 65 6d 20 2a 2f 0a 20 20 20    /* aMem */.   
4120: 20 20 20 2b 20 6e 43 75 72 73 6f 72 2a 73 69 7a     + nCursor*siz
4130: 65 6f 66 28 43 75 72 73 6f 72 2a 29 20 20 20 20  eof(Cursor*)    
4140: 20 20 20 20 2f 2a 20 61 70 43 73 72 20 2a 2f 0a      /* apCsr */.
4150: 20 20 20 20 29 3b 0a 20 20 20 20 69 66 28 20 21      );.    if( !
4160: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
4170: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 20 20 70  ailed ){.      p
4180: 2d 3e 61 4d 65 6d 20 3d 20 26 70 2d 3e 61 53 74  ->aMem = &p->aSt
4190: 61 63 6b 5b 6e 5d 3b 0a 20 20 20 20 20 20 70 2d  ack[n];.      p-
41a0: 3e 6e 4d 65 6d 20 3d 20 6e 4d 65 6d 3b 0a 20 20  >nMem = nMem;.  
41b0: 20 20 20 20 70 2d 3e 61 56 61 72 20 3d 20 26 70      p->aVar = &p
41c0: 2d 3e 61 4d 65 6d 5b 6e 4d 65 6d 5d 3b 0a 20 20  ->aMem[nMem];.  
41d0: 20 20 20 20 70 2d 3e 6e 56 61 72 20 3d 20 6e 56      p->nVar = nV
41e0: 61 72 3b 0a 20 20 20 20 20 20 70 2d 3e 6f 6b 56  ar;.      p->okV
41f0: 61 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d  ar = 0;.      p-
4200: 3e 61 70 41 72 67 20 3d 20 28 4d 65 6d 2a 2a 29  >apArg = (Mem**)
4210: 26 70 2d 3e 61 56 61 72 5b 6e 56 61 72 5d 3b 0a  &p->aVar[nVar];.
4220: 20 20 20 20 20 20 70 2d 3e 61 7a 56 61 72 20 3d        p->azVar =
4230: 20 28 63 68 61 72 2a 2a 29 26 70 2d 3e 61 70 41   (char**)&p->apA
4240: 72 67 5b 6e 5d 3b 0a 20 20 20 20 20 20 70 2d 3e  rg[n];.      p->
4250: 61 70 43 73 72 20 3d 20 28 43 75 72 73 6f 72 2a  apCsr = (Cursor*
4260: 2a 29 26 70 2d 3e 61 7a 56 61 72 5b 6e 56 61 72  *)&p->azVar[nVar
4270: 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 43 75 72  ];.      p->nCur
4280: 73 6f 72 20 3d 20 6e 43 75 72 73 6f 72 3b 0a 20  sor = nCursor;. 
4290: 20 20 20 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c       for(n=0; n<
42a0: 6e 56 61 72 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20  nVar; n++){.    
42b0: 20 20 20 20 70 2d 3e 61 56 61 72 5b 6e 5d 2e 66      p->aVar[n].f
42c0: 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b  lags = MEM_Null;
42d0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66  .      }.      f
42e0: 6f 72 28 6e 3d 30 3b 20 6e 3c 6e 4d 65 6d 3b 20  or(n=0; n<nMem; 
42f0: 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 2d  n++){.        p-
4300: 3e 61 4d 65 6d 5b 6e 5d 2e 66 6c 61 67 73 20 3d  >aMem[n].flags =
4310: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20   MEM_Null;.     
4320: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69   }.    }.  }..#i
4330: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55  fdef SQLITE_DEBU
4340: 47 0a 20 20 69 66 28 20 28 70 2d 3e 64 62 2d 3e  G.  if( (p->db->
4350: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 56  flags & SQLITE_V
4360: 64 62 65 4c 69 73 74 69 6e 67 29 21 3d 30 0a 20  dbeListing)!=0. 
4370: 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 4f 73 46     || sqlite3OsF
4380: 69 6c 65 45 78 69 73 74 73 28 22 76 64 62 65 5f  ileExists("vdbe_
4390: 65 78 70 6c 61 69 6e 22 29 0a 20 20 29 7b 0a 20  explain").  ){. 
43a0: 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 70 72     int i;.    pr
43b0: 69 6e 74 66 28 22 56 44 42 45 20 50 72 6f 67 72  intf("VDBE Progr
43c0: 61 6d 20 4c 69 73 74 69 6e 67 3a 5c 6e 22 29 3b  am Listing:\n");
43d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
43e0: 50 72 69 6e 74 53 71 6c 28 70 29 3b 0a 20 20 20  PrintSql(p);.   
43f0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e   for(i=0; i<p->n
4400: 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  Op; i++){.      
4410: 73 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74  sqlite3VdbePrint
4420: 4f 70 28 73 74 64 6f 75 74 2c 20 69 2c 20 26 70  Op(stdout, i, &p
4430: 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20 20 20 20 7d  ->aOp[i]);.    }
4440: 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74  .  }.  if( sqlit
4450: 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73 28 22  e3OsFileExists("
4460: 76 64 62 65 5f 74 72 61 63 65 22 29 20 29 7b 0a  vdbe_trace") ){.
4470: 20 20 20 20 70 2d 3e 74 72 61 63 65 20 3d 20 73      p->trace = s
4480: 74 64 6f 75 74 3b 0a 20 20 7d 0a 23 65 6e 64 69  tdout;.  }.#endi
4490: 66 0a 20 20 70 2d 3e 70 54 6f 73 20 3d 20 26 70  f.  p->pTos = &p
44a0: 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d 3b 0a 20 20  ->aStack[-1];.  
44b0: 70 2d 3e 70 63 20 3d 20 2d 31 3b 0a 20 20 70 2d  p->pc = -1;.  p-
44c0: 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  >rc = SQLITE_OK;
44d0: 0a 20 20 70 2d 3e 75 6e 69 71 75 65 43 6e 74 20  .  p->uniqueCnt 
44e0: 3d 20 30 3b 0a 20 20 70 2d 3e 72 65 74 75 72 6e  = 0;.  p->return
44f0: 44 65 70 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e  Depth = 0;.  p->
4500: 65 72 72 6f 72 41 63 74 69 6f 6e 20 3d 20 4f 45  errorAction = OE
4510: 5f 41 62 6f 72 74 3b 0a 20 20 70 2d 3e 70 6f 70  _Abort;.  p->pop
4520: 53 74 61 63 6b 20 3d 20 20 30 3b 0a 20 20 70 2d  Stack =  0;.  p-
4530: 3e 65 78 70 6c 61 69 6e 20 7c 3d 20 69 73 45 78  >explain |= isEx
4540: 70 6c 61 69 6e 3b 0a 20 20 70 2d 3e 6d 61 67 69  plain;.  p->magi
4550: 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 52  c = VDBE_MAGIC_R
4560: 55 4e 3b 0a 20 20 70 2d 3e 6e 43 68 61 6e 67 65  UN;.  p->nChange
4570: 20 3d 20 30 3b 0a 23 69 66 64 65 66 20 56 44 42   = 0;.#ifdef VDB
4580: 45 5f 50 52 4f 46 49 4c 45 0a 20 20 7b 0a 20 20  E_PROFILE.  {.  
4590: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72    int i;.    for
45a0: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20  (i=0; i<p->nOp; 
45b0: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 70 2d 3e 61  i++){.      p->a
45c0: 4f 70 5b 69 5d 2e 63 6e 74 20 3d 20 30 3b 0a 20  Op[i].cnt = 0;. 
45d0: 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63       p->aOp[i].c
45e0: 79 63 6c 65 73 20 3d 20 30 3b 0a 20 20 20 20 7d  ycles = 0;.    }
45f0: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 0a  .  }.#endif.}...
4600: 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 61 6e 79  /*.** Remove any
4610: 20 65 6c 65 6d 65 6e 74 73 20 74 68 61 74 20 72   elements that r
4620: 65 6d 61 69 6e 20 6f 6e 20 74 68 65 20 73 6f 72  emain on the sor
4630: 74 65 72 20 66 6f 72 20 74 68 65 20 56 44 42 45  ter for the VDBE
4640: 20 67 69 76 65 6e 2e 0a 2a 2f 0a 76 6f 69 64 20   given..*/.void 
4650: 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65  sqlite3VdbeSorte
4660: 72 52 65 73 65 74 28 56 64 62 65 20 2a 70 29 7b  rReset(Vdbe *p){
4670: 0a 20 20 77 68 69 6c 65 28 20 70 2d 3e 70 53 6f  .  while( p->pSo
4680: 72 74 20 29 7b 0a 20 20 20 20 53 6f 72 74 65 72  rt ){.    Sorter
4690: 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 2d 3e 70   *pSorter = p->p
46a0: 53 6f 72 74 3b 0a 20 20 20 20 70 2d 3e 70 53 6f  Sort;.    p->pSo
46b0: 72 74 20 3d 20 70 53 6f 72 74 65 72 2d 3e 70 4e  rt = pSorter->pN
46c0: 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 46  ext;.    sqliteF
46d0: 72 65 65 28 70 53 6f 72 74 65 72 2d 3e 7a 4b 65  ree(pSorter->zKe
46e0: 79 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56  y);.    sqlite3V
46f0: 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 70  dbeMemRelease(&p
4700: 53 6f 72 74 65 72 2d 3e 64 61 74 61 29 3b 0a 20  Sorter->data);. 
4710: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 53     sqliteFree(pS
4720: 6f 72 74 65 72 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  orter);.  }.}../
4730: 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c 20 72 65  *.** Free all re
4740: 73 6f 75 72 63 65 73 20 61 6c 6c 6f 63 69 61 74  sources allociat
4750: 65 64 20 77 69 74 68 20 41 67 67 45 6c 65 6d 20  ed with AggElem 
4760: 70 45 6c 65 6d 2c 20 61 6e 20 65 6c 65 6d 65 6e  pElem, an elemen
4770: 74 20 6f 66 0a 2a 2a 20 61 67 67 72 65 67 61 74  t of.** aggregat
4780: 65 20 70 41 67 67 2e 0a 2a 2f 0a 76 6f 69 64 20  e pAgg..*/.void 
4790: 66 72 65 65 41 67 67 45 6c 65 6d 28 41 67 67 45  freeAggElem(AggE
47a0: 6c 65 6d 20 2a 70 45 6c 65 6d 2c 20 41 67 67 20  lem *pElem, Agg 
47b0: 2a 70 41 67 67 29 7b 0a 20 20 69 6e 74 20 69 3b  *pAgg){.  int i;
47c0: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 41  .  for(i=0; i<pA
47d0: 67 67 2d 3e 6e 4d 65 6d 3b 20 69 2b 2b 29 7b 0a  gg->nMem; i++){.
47e0: 20 20 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20      Mem *pMem = 
47f0: 26 70 45 6c 65 6d 2d 3e 61 4d 65 6d 5b 69 5d 3b  &pElem->aMem[i];
4800: 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d 3e 61  .    if( pAgg->a
4810: 70 46 75 6e 63 20 26 26 20 70 41 67 67 2d 3e 61  pFunc && pAgg->a
4820: 70 46 75 6e 63 5b 69 5d 20 26 26 20 28 70 4d 65  pFunc[i] && (pMe
4830: 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41  m->flags & MEM_A
4840: 67 67 43 74 78 29 21 3d 30 20 29 7b 0a 20 20 20  ggCtx)!=0 ){.   
4850: 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65     sqlite3_conte
4860: 78 74 20 63 74 78 3b 0a 20 20 20 20 20 20 63 74  xt ctx;.      ct
4870: 78 2e 70 46 75 6e 63 20 3d 20 70 41 67 67 2d 3e  x.pFunc = pAgg->
4880: 61 70 46 75 6e 63 5b 69 5d 3b 0a 20 20 20 20 20  apFunc[i];.     
4890: 20 63 74 78 2e 73 2e 66 6c 61 67 73 20 3d 20 4d   ctx.s.flags = M
48a0: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 63  EM_Null;.      c
48b0: 74 78 2e 70 41 67 67 20 3d 20 70 4d 65 6d 2d 3e  tx.pAgg = pMem->
48c0: 7a 3b 0a 20 20 20 20 20 20 63 74 78 2e 63 6e 74  z;.      ctx.cnt
48d0: 20 3d 20 70 4d 65 6d 2d 3e 69 3b 0a 20 20 20 20   = pMem->i;.    
48e0: 20 20 63 74 78 2e 69 73 53 74 65 70 20 3d 20 30    ctx.isStep = 0
48f0: 3b 0a 20 20 20 20 20 20 63 74 78 2e 69 73 45 72  ;.      ctx.isEr
4900: 72 6f 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 28  ror = 0;.      (
4910: 2a 70 41 67 67 2d 3e 61 70 46 75 6e 63 5b 69 5d  *pAgg->apFunc[i]
4920: 2d 3e 78 46 69 6e 61 6c 69 7a 65 29 28 26 63 74  ->xFinalize)(&ct
4930: 78 29 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e  x);.      pMem->
4940: 7a 20 3d 20 63 74 78 2e 70 41 67 67 3b 0a 20 20  z = ctx.pAgg;.  
4950: 20 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e 7a 21      if( pMem->z!
4960: 3d 30 20 26 26 20 70 4d 65 6d 2d 3e 7a 21 3d 70  =0 && pMem->z!=p
4970: 4d 65 6d 2d 3e 7a 53 68 6f 72 74 20 29 7b 0a 20  Mem->zShort ){. 
4980: 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65         sqliteFre
4990: 65 28 70 4d 65 6d 2d 3e 7a 29 3b 0a 20 20 20 20  e(pMem->z);.    
49a0: 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65    }.      sqlite
49b0: 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28  3VdbeMemRelease(
49c0: 26 63 74 78 2e 73 29 3b 0a 20 20 20 20 7d 65 6c  &ctx.s);.    }el
49d0: 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  se{.      sqlite
49e0: 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28  3VdbeMemRelease(
49f0: 70 4d 65 6d 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  pMem);.    }.  }
4a00: 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 45  .  sqliteFree(pE
4a10: 6c 65 6d 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  lem);.}../*.** R
4a20: 65 73 65 74 20 61 6e 20 41 67 67 20 73 74 72 75  eset an Agg stru
4a30: 63 74 75 72 65 2e 20 20 44 65 6c 65 74 65 20 61  cture.  Delete a
4a40: 6c 6c 20 69 74 73 20 63 6f 6e 74 65 6e 74 73 2e  ll its contents.
4a50: 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 69 6e 73 74 61  .**.** For insta
4a60: 6c 6c 61 62 6c 65 20 61 67 67 72 65 67 61 74 65  llable aggregate
4a70: 20 66 75 6e 63 74 69 6f 6e 73 2c 20 69 66 20 74   functions, if t
4a80: 68 65 20 73 74 65 70 20 66 75 6e 63 74 69 6f 6e  he step function
4a90: 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 63 61 6c   has been.** cal
4aa0: 6c 65 64 2c 20 6d 61 6b 65 20 73 75 72 65 20 74  led, make sure t
4ab0: 68 65 20 66 69 6e 61 6c 69 7a 65 72 20 66 75 6e  he finalizer fun
4ac0: 63 74 69 6f 6e 20 68 61 73 20 61 6c 73 6f 20 62  ction has also b
4ad0: 65 65 6e 20 63 61 6c 6c 65 64 2e 20 20 54 68 65  een called.  The
4ae0: 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 72 20 6d 69  .** finalizer mi
4af0: 67 68 74 20 6e 65 65 64 20 74 6f 20 66 72 65 65  ght need to free
4b00: 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 77 61 73   memory that was
4b10: 20 61 6c 6c 6f 63 61 74 65 64 20 61 73 20 70 61   allocated as pa
4b20: 72 74 20 6f 66 20 69 74 73 0a 2a 2a 20 70 72 69  rt of its.** pri
4b30: 76 61 74 65 20 63 6f 6e 74 65 78 74 2e 20 20 49  vate context.  I
4b40: 66 20 74 68 65 20 66 69 6e 61 6c 69 7a 65 72 20  f the finalizer 
4b50: 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 63 61 6c  has not been cal
4b60: 6c 65 64 20 79 65 74 2c 20 63 61 6c 6c 20 69 74  led yet, call it
4b70: 0a 2a 2a 20 6e 6f 77 2e 0a 2a 2a 0a 2a 2a 20 49  .** now..**.** I
4b80: 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20 74 68  f db is NULL, th
4b90: 65 6e 20 74 68 69 73 20 69 73 20 62 65 69 6e 67  en this is being
4ba0: 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71 6c   called from sql
4bb0: 69 74 65 56 64 62 65 52 65 73 65 74 28 29 2e 20  iteVdbeReset(). 
4bc0: 49 6e 0a 2a 2a 20 74 68 69 73 20 63 61 73 65 20  In.** this case 
4bd0: 63 6c 65 61 6e 20 75 70 20 61 6c 6c 20 72 65 66  clean up all ref
4be0: 65 72 65 6e 63 65 73 20 74 6f 20 74 68 65 20 74  erences to the t
4bf0: 65 6d 70 2d 74 61 62 6c 65 20 75 73 65 64 20 66  emp-table used f
4c00: 6f 72 0a 2a 2a 20 61 67 67 72 65 67 61 74 65 73  or.** aggregates
4c10: 20 28 69 66 20 69 74 20 77 61 73 20 65 76 65 72   (if it was ever
4c20: 20 6f 70 65 6e 65 64 29 2e 0a 2a 2a 0a 2a 2a 20   opened)..**.** 
4c30: 49 66 20 64 62 20 69 73 20 6e 6f 74 20 4e 55 4c  If db is not NUL
4c40: 4c 2c 20 74 68 65 6e 20 74 68 69 73 20 69 73 20  L, then this is 
4c50: 62 65 69 6e 67 20 63 61 6c 6c 65 64 20 66 72 6f  being called fro
4c60: 6d 20 77 69 74 68 20 61 6e 20 4f 50 5f 41 67 67  m with an OP_Agg
4c70: 52 65 73 65 74 0a 2a 2a 20 6f 70 63 6f 64 65 2e  Reset.** opcode.
4c80: 20 4f 70 65 6e 20 74 68 65 20 74 65 6d 70 2d 74   Open the temp-t
4c90: 61 62 6c 65 2c 20 69 66 20 69 74 20 68 61 73 20  able, if it has 
4ca0: 6e 6f 74 20 61 6c 72 65 61 64 79 20 62 65 65 6e  not already been
4cb0: 20 6f 70 65 6e 65 64 20 61 6e 64 0a 2a 2a 20 64   opened and.** d
4cc0: 65 6c 65 74 65 20 74 68 65 20 63 6f 6e 74 65 6e  elete the conten
4cd0: 74 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  ts of the table 
4ce0: 75 73 65 64 20 66 6f 72 20 61 67 67 72 65 67 61  used for aggrega
4cf0: 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20  te information, 
4d00: 72 65 61 64 79 0a 2a 2a 20 66 6f 72 20 74 68 65  ready.** for the
4d10: 20 6e 65 78 74 20 72 6f 75 6e 64 20 6f 66 20 61   next round of a
4d20: 67 67 72 65 67 61 74 65 20 70 72 6f 63 65 73 73  ggregate process
4d30: 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ing..*/.int sqli
4d40: 74 65 33 56 64 62 65 41 67 67 52 65 73 65 74 28  te3VdbeAggReset(
4d50: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 41 67 67  sqlite3 *db, Agg
4d60: 20 2a 70 41 67 67 2c 20 4b 65 79 49 6e 66 6f 20   *pAgg, KeyInfo 
4d70: 2a 70 4b 65 79 49 6e 66 6f 29 7b 0a 20 20 69 6e  *pKeyInfo){.  in
4d80: 74 20 72 63 20 3d 20 30 3b 0a 20 20 42 74 43 75  t rc = 0;.  BtCu
4d90: 72 73 6f 72 20 2a 70 43 73 72 20 3d 20 70 41 67  rsor *pCsr = pAg
4da0: 67 2d 3e 70 43 73 72 3b 0a 0a 20 20 61 73 73 65  g->pCsr;..  asse
4db0: 72 74 28 20 28 70 43 73 72 20 26 26 20 70 41 67  rt( (pCsr && pAg
4dc0: 67 2d 3e 6e 54 61 62 3e 30 29 20 7c 7c 20 28 21  g->nTab>0) || (!
4dd0: 70 43 73 72 20 26 26 20 70 41 67 67 2d 3e 6e 54  pCsr && pAgg->nT
4de0: 61 62 3d 3d 30 29 0a 20 20 20 20 20 20 20 20 20  ab==0).         
4df0: 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f  || sqlite3_mallo
4e00: 63 5f 66 61 69 6c 65 64 20 29 3b 0a 0a 20 20 2f  c_failed );..  /
4e10: 2a 20 49 66 20 70 43 73 72 20 69 73 20 6e 6f 74  * If pCsr is not
4e20: 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68 65 20   NULL, then the 
4e30: 74 61 62 6c 65 20 75 73 65 64 20 66 6f 72 20 61  table used for a
4e40: 67 67 72 65 67 61 74 65 20 69 6e 66 6f 72 6d 61  ggregate informa
4e50: 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 6f 70 65  tion.  ** is ope
4e60: 6e 2e 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20  n. Loop through 
4e70: 69 74 20 61 6e 64 20 66 72 65 65 20 74 68 65 20  it and free the 
4e80: 41 67 67 45 6c 65 6d 2a 20 73 74 72 75 63 74 75  AggElem* structu
4e90: 72 65 20 70 6f 69 6e 74 65 64 20 61 74 0a 20 20  re pointed at.  
4ea0: 2a 2a 20 62 79 20 65 61 63 68 20 65 6e 74 72 79  ** by each entry
4eb0: 2e 20 49 66 20 74 68 65 20 66 69 6e 61 6c 69 7a  . If the finaliz
4ec0: 65 72 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20  er has not been 
4ed0: 63 61 6c 6c 65 64 20 66 6f 72 20 61 6e 20 41 67  called for an Ag
4ee0: 67 45 6c 65 6d 2c 0a 20 20 2a 2a 20 64 6f 20 74  gElem,.  ** do t
4ef0: 68 61 74 20 74 6f 6f 2e 20 46 69 6e 61 6c 6c 79  hat too. Finally
4f00: 2c 20 63 6c 65 61 72 20 74 68 65 20 62 74 72 65  , clear the btre
4f10: 65 20 74 61 62 6c 65 20 69 74 73 65 6c 66 2e 0a  e table itself..
4f20: 20 20 2a 2f 0a 20 20 69 66 28 20 70 43 73 72 20    */.  if( pCsr 
4f30: 29 7b 0a 20 20 20 20 69 6e 74 20 72 65 73 3b 0a  ){.    int res;.
4f40: 20 20 20 20 61 73 73 65 72 74 28 20 70 41 67 67      assert( pAgg
4f50: 2d 3e 70 42 74 72 65 65 20 29 3b 0a 20 20 20 20  ->pBtree );.    
4f60: 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e 6e 54  assert( pAgg->nT
4f70: 61 62 3e 30 20 29 3b 0a 0a 20 20 20 20 72 63 3d  ab>0 );..    rc=
4f80: 73 71 6c 69 74 65 33 42 74 72 65 65 46 69 72 73  sqlite3BtreeFirs
4f90: 74 28 70 43 73 72 2c 20 26 72 65 73 29 3b 0a 20  t(pCsr, &res);. 
4fa0: 20 20 20 77 68 69 6c 65 28 20 72 65 73 3d 3d 30     while( res==0
4fb0: 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f   && rc==SQLITE_O
4fc0: 4b 20 29 7b 0a 20 20 20 20 20 20 41 67 67 45 6c  K ){.      AggEl
4fd0: 65 6d 20 2a 70 45 6c 65 6d 3b 0a 20 20 20 20 20  em *pElem;.     
4fe0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
4ff0: 65 65 44 61 74 61 28 70 43 73 72 2c 20 30 2c 20  eeData(pCsr, 0, 
5000: 73 69 7a 65 6f 66 28 41 67 67 45 6c 65 6d 2a 29  sizeof(AggElem*)
5010: 2c 20 28 63 68 61 72 20 2a 29 26 70 45 6c 65 6d  , (char *)&pElem
5020: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 65 73  );.      if( res
5030: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
5040: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63         return rc
5050: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
5060: 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e 61 70  assert( pAgg->ap
5070: 46 75 6e 63 21 3d 30 20 29 3b 0a 20 20 20 20 20  Func!=0 );.     
5080: 20 66 72 65 65 41 67 67 45 6c 65 6d 28 70 45 6c   freeAggElem(pEl
5090: 65 6d 2c 20 70 41 67 67 29 3b 0a 20 20 20 20 20  em, pAgg);.     
50a0: 20 72 63 3d 73 71 6c 69 74 65 33 42 74 72 65 65   rc=sqlite3Btree
50b0: 4e 65 78 74 28 70 43 73 72 2c 20 26 72 65 73 29  Next(pCsr, &res)
50c0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20  ;.    }.    if( 
50d0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
50e0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63  .      return rc
50f0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73 71 6c  ;.    }..    sql
5100: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75  ite3BtreeCloseCu
5110: 72 73 6f 72 28 70 43 73 72 29 3b 0a 20 20 20 20  rsor(pCsr);.    
5120: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61  sqlite3BtreeClea
5130: 72 54 61 62 6c 65 28 70 41 67 67 2d 3e 70 42 74  rTable(pAgg->pBt
5140: 72 65 65 2c 20 70 41 67 67 2d 3e 6e 54 61 62 29  ree, pAgg->nTab)
5150: 3b 0a 20 20 7d 65 6c 73 65 7b 20 0a 20 20 20 20  ;.  }else{ .    
5160: 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 20 6d 61  /* The cursor ma
5170: 79 20 6e 6f 74 20 62 65 20 6f 70 65 6e 20 62 65  y not be open be
5180: 63 61 75 73 65 20 74 68 65 20 61 67 67 72 65 67  cause the aggreg
5190: 61 74 6f 72 20 77 61 73 20 6e 65 76 65 72 20 75  ator was never u
51a0: 73 65 64 2c 0a 20 20 20 20 2a 2a 20 6f 72 20 69  sed,.    ** or i
51b0: 74 20 63 6f 75 6c 64 20 62 65 20 74 68 61 74 20  t could be that 
51c0: 69 74 20 77 61 73 20 75 73 65 64 20 62 75 74 20  it was used but 
51d0: 74 68 65 72 65 20 77 61 73 20 6e 6f 20 47 52 4f  there was no GRO
51e0: 55 50 20 42 59 20 63 6c 61 75 73 65 2e 0a 20 20  UP BY clause..  
51f0: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 41 67    */.    if( pAg
5200: 67 2d 3e 70 43 75 72 72 65 6e 74 20 29 7b 0a 20  g->pCurrent ){. 
5210: 20 20 20 20 20 66 72 65 65 41 67 67 45 6c 65 6d       freeAggElem
5220: 28 70 41 67 67 2d 3e 70 43 75 72 72 65 6e 74 2c  (pAgg->pCurrent,
5230: 20 70 41 67 67 29 3b 0a 20 20 20 20 7d 0a 20 20   pAgg);.    }.  
5240: 7d 0a 0a 20 20 2f 2a 20 49 66 20 64 62 20 69 73  }..  /* If db is
5250: 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 77 65   not NULL and we
5260: 20 68 61 76 65 20 6e 6f 74 20 79 65 74 20 61 6e   have not yet an
5270: 64 20 77 65 20 68 61 76 65 20 6e 6f 74 20 79 65  d we have not ye
5280: 74 20 6f 70 65 6e 65 64 0a 20 20 2a 2a 20 74 68  t opened.  ** th
5290: 65 20 74 65 6d 70 6f 72 61 72 79 20 62 74 72 65  e temporary btre
52a0: 65 20 74 68 65 6e 20 64 6f 20 73 6f 20 61 6e 64  e then do so and
52b0: 20 63 72 65 61 74 65 20 74 68 65 20 74 61 62 6c   create the tabl
52c0: 65 20 74 6f 20 73 74 6f 72 65 20 61 67 67 72 65  e to store aggre
52d0: 67 61 74 65 0a 20 20 2a 2a 20 69 6e 66 6f 72 6d  gate.  ** inform
52e0: 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  ation..  **.  **
52f0: 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20   If db is NULL, 
5300: 74 68 65 6e 20 63 6c 6f 73 65 20 74 68 65 20 74  then close the t
5310: 65 6d 70 6f 72 61 72 79 20 62 74 72 65 65 20 69  emporary btree i
5320: 66 20 69 74 20 69 73 20 6f 70 65 6e 2e 0a 20 20  f it is open..  
5330: 2a 2f 0a 20 20 69 66 28 20 64 62 20 29 7b 0a 20  */.  if( db ){. 
5340: 20 20 20 69 66 28 20 21 70 41 67 67 2d 3e 70 42     if( !pAgg->pB
5350: 74 72 65 65 20 29 7b 0a 20 20 20 20 20 20 61 73  tree ){.      as
5360: 73 65 72 74 28 20 70 41 67 67 2d 3e 6e 54 61 62  sert( pAgg->nTab
5370: 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 72 63 20  ==0 );.      rc 
5380: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 61  = sqlite3BtreeFa
5390: 63 74 6f 72 79 28 64 62 2c 20 22 3a 6d 65 6d 6f  ctory(db, ":memo
53a0: 72 79 3a 22 2c 20 30 2c 20 54 45 4d 50 5f 50 41  ry:", 0, TEMP_PA
53b0: 47 45 53 2c 20 26 70 41 67 67 2d 3e 70 42 74 72  GES, &pAgg->pBtr
53c0: 65 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  ee);.      if( r
53d0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
53e0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
53f0: 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 69  sqlite3BtreeBegi
5400: 6e 54 72 61 6e 73 28 70 41 67 67 2d 3e 70 42 74  nTrans(pAgg->pBt
5410: 72 65 65 2c 20 31 29 3b 0a 20 20 20 20 20 20 72  ree, 1);.      r
5420: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
5430: 43 72 65 61 74 65 54 61 62 6c 65 28 70 41 67 67  CreateTable(pAgg
5440: 2d 3e 70 42 74 72 65 65 2c 20 26 70 41 67 67 2d  ->pBtree, &pAgg-
5450: 3e 6e 54 61 62 2c 20 30 29 3b 0a 20 20 20 20 20  >nTab, 0);.     
5460: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
5470: 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  OK ) return rc;.
5480: 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74      }.    assert
5490: 28 20 70 41 67 67 2d 3e 6e 54 61 62 21 3d 30 20  ( pAgg->nTab!=0 
54a0: 29 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  );..    rc = sql
54b0: 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 28  ite3BtreeCursor(
54c0: 70 41 67 67 2d 3e 70 42 74 72 65 65 2c 20 70 41  pAgg->pBtree, pA
54d0: 67 67 2d 3e 6e 54 61 62 2c 20 31 2c 0a 20 20 20  gg->nTab, 1,.   
54e0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
54f0: 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 2c 20 70  RecordCompare, p
5500: 4b 65 79 49 6e 66 6f 2c 20 26 70 41 67 67 2d 3e  KeyInfo, &pAgg->
5510: 70 43 73 72 29 3b 0a 20 20 20 20 69 66 28 20 72  pCsr);.    if( r
5520: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
5530: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 65 6c 73  eturn rc;.  }els
5540: 65 7b 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d  e{.    if( pAgg-
5550: 3e 70 42 74 72 65 65 20 29 7b 0a 20 20 20 20 20  >pBtree ){.     
5560: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
5570: 73 65 28 70 41 67 67 2d 3e 70 42 74 72 65 65 29  se(pAgg->pBtree)
5580: 3b 0a 20 20 20 20 20 20 70 41 67 67 2d 3e 70 42  ;.      pAgg->pB
5590: 74 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 20 20  tree = 0;.      
55a0: 70 41 67 67 2d 3e 6e 54 61 62 20 3d 20 30 3b 0a  pAgg->nTab = 0;.
55b0: 20 20 20 20 7d 0a 20 20 20 20 70 41 67 67 2d 3e      }.    pAgg->
55c0: 70 43 73 72 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20  pCsr = 0;.  }.. 
55d0: 20 69 66 28 20 70 41 67 67 2d 3e 61 70 46 75 6e   if( pAgg->apFun
55e0: 63 20 29 7b 20 0a 20 20 20 20 73 71 6c 69 74 65  c ){ .    sqlite
55f0: 46 72 65 65 28 70 41 67 67 2d 3e 61 70 46 75 6e  Free(pAgg->apFun
5600: 63 29 3b 0a 20 20 20 20 70 41 67 67 2d 3e 61 70  c);.    pAgg->ap
5610: 46 75 6e 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  Func = 0;.  }.  
5620: 70 41 67 67 2d 3e 70 43 75 72 72 65 6e 74 20 3d  pAgg->pCurrent =
5630: 20 30 3b 0a 20 20 70 41 67 67 2d 3e 6e 4d 65 6d   0;.  pAgg->nMem
5640: 20 3d 20 30 3b 0a 20 20 70 41 67 67 2d 3e 73 65   = 0;.  pAgg->se
5650: 61 72 63 68 69 6e 67 20 3d 20 30 3b 0a 20 20 72  arching = 0;.  r
5660: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
5670: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74  .}.../*.** Delet
5680: 65 20 61 20 6b 65 79 6c 69 73 74 0a 2a 2f 0a 76  e a keylist.*/.v
5690: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 4b  oid sqlite3VdbeK
56a0: 65 79 6c 69 73 74 46 72 65 65 28 4b 65 79 6c 69  eylistFree(Keyli
56b0: 73 74 20 2a 70 29 7b 0a 20 20 77 68 69 6c 65 28  st *p){.  while(
56c0: 20 70 20 29 7b 0a 20 20 20 20 4b 65 79 6c 69 73   p ){.    Keylis
56d0: 74 20 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e  t *pNext = p->pN
56e0: 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 46  ext;.    sqliteF
56f0: 72 65 65 28 70 29 3b 0a 20 20 20 20 70 20 3d 20  ree(p);.    p = 
5700: 70 4e 65 78 74 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  pNext;.  }.}../*
5710: 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 75 72 73  .** Close a curs
5720: 6f 72 20 61 6e 64 20 72 65 6c 65 61 73 65 20 61  or and release a
5730: 6c 6c 20 74 68 65 20 72 65 73 6f 75 72 63 65 73  ll the resources
5740: 20 74 68 61 74 20 63 75 72 73 6f 72 20 68 61 70   that cursor hap
5750: 70 65 6e 73 0a 2a 2a 20 74 6f 20 68 6f 6c 64 2e  pens.** to hold.
5760: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
5770: 56 64 62 65 46 72 65 65 43 75 72 73 6f 72 28 43  VdbeFreeCursor(C
5780: 75 72 73 6f 72 20 2a 70 43 78 29 7b 0a 20 20 69  ursor *pCx){.  i
5790: 66 28 20 70 43 78 3d 3d 30 20 29 7b 0a 20 20 20  f( pCx==0 ){.   
57a0: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69   return;.  }.  i
57b0: 66 28 20 70 43 78 2d 3e 70 43 75 72 73 6f 72 20  f( pCx->pCursor 
57c0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74  ){.    sqlite3Bt
57d0: 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70  reeCloseCursor(p
57e0: 43 78 2d 3e 70 43 75 72 73 6f 72 29 3b 0a 20 20  Cx->pCursor);.  
57f0: 7d 0a 20 20 69 66 28 20 70 43 78 2d 3e 70 42 74  }.  if( pCx->pBt
5800: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42   ){.    sqlite3B
5810: 74 72 65 65 43 6c 6f 73 65 28 70 43 78 2d 3e 70  treeClose(pCx->p
5820: 42 74 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  Bt);.  }.  sqlit
5830: 65 46 72 65 65 28 70 43 78 2d 3e 70 44 61 74 61  eFree(pCx->pData
5840: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
5850: 70 43 78 2d 3e 61 54 79 70 65 29 3b 0a 20 20 73  pCx->aType);.  s
5860: 71 6c 69 74 65 46 72 65 65 28 70 43 78 29 3b 0a  qliteFree(pCx);.
5870: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61  }../*.** Close a
5880: 6c 6c 20 63 75 72 73 6f 72 73 0a 2a 2f 0a 73 74  ll cursors.*/.st
5890: 61 74 69 63 20 76 6f 69 64 20 63 6c 6f 73 65 41  atic void closeA
58a0: 6c 6c 43 75 72 73 6f 72 73 28 56 64 62 65 20 2a  llCursors(Vdbe *
58b0: 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  p){.  int i;.  i
58c0: 66 28 20 70 2d 3e 61 70 43 73 72 3d 3d 30 20 29  f( p->apCsr==0 )
58d0: 20 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 69   return;.  for(i
58e0: 3d 30 3b 20 69 3c 70 2d 3e 6e 43 75 72 73 6f 72  =0; i<p->nCursor
58f0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69  ; i++){.    sqli
5900: 74 65 33 56 64 62 65 46 72 65 65 43 75 72 73 6f  te3VdbeFreeCurso
5910: 72 28 70 2d 3e 61 70 43 73 72 5b 69 5d 29 3b 0a  r(p->apCsr[i]);.
5920: 20 20 20 20 70 2d 3e 61 70 43 73 72 5b 69 5d 20      p->apCsr[i] 
5930: 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  = 0;.  }.}../*.*
5940: 2a 20 43 6c 65 61 6e 20 75 70 20 74 68 65 20 56  * Clean up the V
5950: 4d 20 61 66 74 65 72 20 65 78 65 63 75 74 69 6f  M after executio
5960: 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  n..**.** This ro
5970: 75 74 69 6e 65 20 77 69 6c 6c 20 61 75 74 6f 6d  utine will autom
5980: 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 20 61  atically close a
5990: 6e 79 20 63 75 72 73 6f 72 73 2c 20 6c 69 73 74  ny cursors, list
59a0: 73 2c 20 61 6e 64 2f 6f 72 0a 2a 2a 20 73 6f 72  s, and/or.** sor
59b0: 74 65 72 73 20 74 68 61 74 20 77 65 72 65 20 6c  ters that were l
59c0: 65 66 74 20 6f 70 65 6e 2e 20 20 49 74 20 61 6c  eft open.  It al
59d0: 73 6f 20 64 65 6c 65 74 65 73 20 74 68 65 20 76  so deletes the v
59e0: 61 6c 75 65 73 20 6f 66 0a 2a 2a 20 76 61 72 69  alues of.** vari
59f0: 61 62 6c 65 73 20 69 6e 20 74 68 65 20 61 56 61  ables in the aVa
5a00: 72 5b 5d 20 61 72 72 61 79 2e 0a 2a 2f 0a 73 74  r[] array..*/.st
5a10: 61 74 69 63 20 76 6f 69 64 20 43 6c 65 61 6e 75  atic void Cleanu
5a20: 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  p(Vdbe *p){.  in
5a30: 74 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61 53  t i;.  if( p->aS
5a40: 74 61 63 6b 20 29 7b 0a 20 20 20 20 72 65 6c 65  tack ){.    rele
5a50: 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61  aseMemArray(p->a
5a60: 53 74 61 63 6b 2c 20 31 20 2b 20 28 70 2d 3e 70  Stack, 1 + (p->p
5a70: 54 6f 73 20 2d 20 70 2d 3e 61 53 74 61 63 6b 29  Tos - p->aStack)
5a80: 29 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d  );.    p->pTos =
5a90: 20 26 70 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d 3b   &p->aStack[-1];
5aa0: 0a 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43  .  }.  closeAllC
5ab0: 75 72 73 6f 72 73 28 70 29 3b 0a 20 20 72 65 6c  ursors(p);.  rel
5ac0: 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e  easeMemArray(p->
5ad0: 61 4d 65 6d 2c 20 70 2d 3e 6e 4d 65 6d 29 3b 0a  aMem, p->nMem);.
5ae0: 20 20 69 66 28 20 70 2d 3e 70 4c 69 73 74 20 29    if( p->pList )
5af0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
5b00: 65 4b 65 79 6c 69 73 74 46 72 65 65 28 70 2d 3e  eKeylistFree(p->
5b10: 70 4c 69 73 74 29 3b 0a 20 20 20 20 70 2d 3e 70  pList);.    p->p
5b20: 4c 69 73 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  List = 0;.  }.  
5b30: 69 66 28 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74  if( p->contextSt
5b40: 61 63 6b 20 29 7b 0a 20 20 20 20 66 6f 72 28 69  ack ){.    for(i
5b50: 3d 30 3b 20 69 3c 70 2d 3e 63 6f 6e 74 65 78 74  =0; i<p->context
5b60: 53 74 61 63 6b 54 6f 70 3b 20 69 2b 2b 29 7b 0a  StackTop; i++){.
5b70: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
5b80: 65 4b 65 79 6c 69 73 74 46 72 65 65 28 70 2d 3e  eKeylistFree(p->
5b90: 63 6f 6e 74 65 78 74 53 74 61 63 6b 5b 69 5d 2e  contextStack[i].
5ba0: 70 4c 69 73 74 29 3b 0a 20 20 20 20 7d 0a 20 20  pList);.    }.  
5bb0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
5bc0: 63 6f 6e 74 65 78 74 53 74 61 63 6b 29 3b 0a 20  contextStack);. 
5bd0: 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65   }.  sqlite3Vdbe
5be0: 53 6f 72 74 65 72 52 65 73 65 74 28 70 29 3b 0a  SorterReset(p);.
5bf0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 67 67    sqlite3VdbeAgg
5c00: 52 65 73 65 74 28 30 2c 20 26 70 2d 3e 61 67 67  Reset(0, &p->agg
5c10: 2c 20 30 29 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65  , 0);.  p->conte
5c20: 78 74 53 74 61 63 6b 20 3d 20 30 3b 0a 20 20 70  xtStack = 0;.  p
5c30: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 44 65  ->contextStackDe
5c40: 70 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f  pth = 0;.  p->co
5c50: 6e 74 65 78 74 53 74 61 63 6b 54 6f 70 20 3d 20  ntextStackTop = 
5c60: 30 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  0;.  sqliteFree(
5c70: 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 70  p->zErrMsg);.  p
5c80: 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 7d  ->zErrMsg = 0;.}
5c90: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
5ca0: 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74  number of result
5cb0: 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 77 69   columns that wi
5cc0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 62  ll be returned b
5cd0: 79 20 74 68 69 73 20 53 51 4c 0a 2a 2a 20 73 74  y this SQL.** st
5ce0: 61 74 65 6d 65 6e 74 2e 20 54 68 69 73 20 69 73  atement. This is
5cf0: 20 6e 6f 77 20 73 65 74 20 61 74 20 63 6f 6d 70   now set at comp
5d00: 69 6c 65 20 74 69 6d 65 2c 20 72 61 74 68 65 72  ile time, rather
5d10: 20 74 68 61 6e 20 64 75 72 69 6e 67 0a 2a 2a 20   than during.** 
5d20: 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65  execution of the
5d30: 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20 73 6f   vdbe program so
5d40: 20 74 68 61 74 20 73 71 6c 69 74 65 33 5f 63 6f   that sqlite3_co
5d50: 6c 75 6d 6e 5f 63 6f 75 6e 74 28 29 20 63 61 6e  lumn_count() can
5d60: 0a 2a 2a 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e  .** be called on
5d70: 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e   an SQL statemen
5d80: 74 20 62 65 66 6f 72 65 20 73 71 6c 69 74 65 33  t before sqlite3
5d90: 5f 73 74 65 70 28 29 2e 0a 2a 2f 0a 76 6f 69 64  _step()..*/.void
5da0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e   sqlite3VdbeSetN
5db0: 75 6d 43 6f 6c 73 28 56 64 62 65 20 2a 70 2c 20  umCols(Vdbe *p, 
5dc0: 69 6e 74 20 6e 52 65 73 43 6f 6c 75 6d 6e 29 7b  int nResColumn){
5dd0: 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65  .  Mem *pColName
5de0: 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 61 73 73  ;.  int n;.  ass
5df0: 65 72 74 28 20 30 3d 3d 70 2d 3e 6e 52 65 73 43  ert( 0==p->nResC
5e00: 6f 6c 75 6d 6e 20 29 3b 0a 20 20 70 2d 3e 6e 52  olumn );.  p->nR
5e10: 65 73 43 6f 6c 75 6d 6e 20 3d 20 6e 52 65 73 43  esColumn = nResC
5e20: 6f 6c 75 6d 6e 3b 0a 20 20 6e 20 3d 20 6e 52 65  olumn;.  n = nRe
5e30: 73 43 6f 6c 75 6d 6e 2a 32 3b 0a 20 20 70 2d 3e  sColumn*2;.  p->
5e40: 61 43 6f 6c 4e 61 6d 65 20 3d 20 70 43 6f 6c 4e  aColName = pColN
5e50: 61 6d 65 20 3d 20 28 4d 65 6d 2a 29 73 71 6c 69  ame = (Mem*)sqli
5e60: 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66  teMalloc( sizeof
5e70: 28 4d 65 6d 29 2a 6e 20 29 3b 0a 20 20 69 66 28  (Mem)*n );.  if(
5e80: 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 3d 3d 30 20   p->aColName==0 
5e90: 29 20 72 65 74 75 72 6e 3b 0a 20 20 77 68 69 6c  ) return;.  whil
5ea0: 65 28 20 6e 2d 2d 20 3e 20 30 20 29 7b 0a 20 20  e( n-- > 0 ){.  
5eb0: 20 20 28 70 43 6f 6c 4e 61 6d 65 2b 2b 29 2d 3e    (pColName++)->
5ec0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
5ed0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  ;.  }.}../*.** S
5ee0: 65 74 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  et the name of t
5ef0: 68 65 20 69 64 78 27 74 68 20 63 6f 6c 75 6d 6e  he idx'th column
5f00: 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 20   to be returned 
5f10: 62 79 20 74 68 65 20 53 51 4c 20 73 74 61 74 65  by the SQL state
5f20: 6d 65 6e 74 2e 0a 2a 2a 20 7a 4e 61 6d 65 20 6d  ment..** zName m
5f30: 75 73 74 20 62 65 20 61 20 70 6f 69 6e 74 65 72  ust be a pointer
5f40: 20 74 6f 20 61 20 6e 75 6c 20 74 65 72 6d 69 6e   to a nul termin
5f50: 61 74 65 64 20 73 74 72 69 6e 67 2e 0a 2a 2a 0a  ated string..**.
5f60: 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 75 73  ** This call mus
5f70: 74 20 62 65 20 6d 61 64 65 20 61 66 74 65 72 20  t be made after 
5f80: 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65  a call to sqlite
5f90: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
5fa0: 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e 3d 3d 50  )..**.** If N==P
5fb0: 33 5f 53 54 41 54 49 43 20 20 69 74 20 6d 65 61  3_STATIC  it mea
5fc0: 6e 73 20 74 68 61 74 20 7a 4e 61 6d 65 20 69 73  ns that zName is
5fd0: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20   a pointer to a 
5fe0: 63 6f 6e 73 74 61 6e 74 20 73 74 61 74 69 63 0a  constant static.
5ff0: 2a 2a 20 73 74 72 69 6e 67 20 61 6e 64 20 77 65  ** string and we
6000: 20 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74   can just copy t
6010: 68 65 20 70 6f 69 6e 74 65 72 2e 20 49 66 20 69  he pointer. If i
6020: 74 20 69 73 20 50 33 5f 44 59 4e 41 4d 49 43 2c  t is P3_DYNAMIC,
6030: 20 74 68 65 6e 20 0a 2a 2a 20 74 68 65 20 73 74   then .** the st
6040: 72 69 6e 67 20 69 73 20 66 72 65 65 64 20 75 73  ring is freed us
6050: 69 6e 67 20 73 71 6c 69 74 65 46 72 65 65 28 29  ing sqliteFree()
6060: 20 77 68 65 6e 20 74 68 65 20 76 64 62 65 20 69   when the vdbe i
6070: 73 20 66 69 6e 69 73 68 65 64 20 77 69 74 68 0a  s finished with.
6080: 2a 2a 20 69 74 2e 20 4f 74 68 65 72 77 69 73 65  ** it. Otherwise
6090: 2c 20 4e 20 62 79 74 65 73 20 6f 66 20 7a 4e 61  , N bytes of zNa
60a0: 6d 65 20 61 72 65 20 63 6f 70 69 65 64 2e 0a 2a  me are copied..*
60b0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
60c0: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 56 64 62 65  eSetColName(Vdbe
60d0: 20 2a 70 2c 20 69 6e 74 20 69 64 78 2c 20 63 6f   *p, int idx, co
60e0: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
60f0: 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72   int N){.  int r
6100: 63 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61  c;.  Mem *pColNa
6110: 6d 65 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64  me;.  assert( id
6120: 78 3c 28 32 2a 70 2d 3e 6e 52 65 73 43 6f 6c 75  x<(2*p->nResColu
6130: 6d 6e 29 20 29 3b 0a 20 20 69 66 28 20 73 71 6c  mn) );.  if( sql
6140: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
6150: 65 64 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49  ed ) return SQLI
6160: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 61 73 73 65  TE_NOMEM;.  asse
6170: 72 74 28 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21  rt( p->aColName!
6180: 3d 30 20 29 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65  =0 );.  pColName
6190: 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65   = &(p->aColName
61a0: 5b 69 64 78 5d 29 3b 0a 20 20 69 66 28 20 4e 3d  [idx]);.  if( N=
61b0: 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 4e  =P3_DYNAMIC || N
61c0: 3d 3d 50 33 5f 53 54 41 54 49 43 20 29 7b 0a 20  ==P3_STATIC ){. 
61d0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
61e0: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 6f  dbeMemSetStr(pCo
61f0: 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31  lName, zName, -1
6200: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53  , SQLITE_UTF8, S
6210: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
6220: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d   }else{.    rc =
6230: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
6240: 65 74 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20  etStr(pColName, 
6250: 7a 4e 61 6d 65 2c 20 4e 2c 20 53 51 4c 49 54 45  zName, N, SQLITE
6260: 5f 55 54 46 38 2c 53 51 4c 49 54 45 5f 54 52 41  _UTF8,SQLITE_TRA
6270: 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 0a 20 20 69  NSIENT);.  }.  i
6280: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
6290: 20 26 26 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49   && N==P3_DYNAMI
62a0: 43 20 29 7b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d  C ){.    pColNam
62b0: 65 2d 3e 66 6c 61 67 73 20 3d 20 28 70 43 6f 6c  e->flags = (pCol
62c0: 4e 61 6d 65 2d 3e 66 6c 61 67 73 26 28 7e 4d 45  Name->flags&(~ME
62d0: 4d 5f 53 74 61 74 69 63 29 29 7c 4d 45 4d 5f 44  M_Static))|MEM_D
62e0: 79 6e 3b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65  yn;.    pColName
62f0: 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a  ->xDel = 0;.  }.
6300: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6310: 2f 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6f 72 20  /*.** A read or 
6320: 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f  write transactio
6330: 6e 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74  n may or may not
6340: 20 62 65 20 61 63 74 69 76 65 20 6f 6e 20 64 61   be active on da
6350: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a  tabase handle.**
6360: 20 64 62 2e 20 49 66 20 61 20 74 72 61 6e 73 61   db. If a transa
6370: 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2c  ction is active,
6380: 20 63 6f 6d 6d 69 74 20 69 74 2e 20 49 66 20 74   commit it. If t
6390: 68 65 72 65 20 69 73 20 61 0a 2a 2a 20 77 72 69  here is a.** wri
63a0: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73  te-transaction s
63b0: 70 61 6e 6e 69 6e 67 20 6d 6f 72 65 20 74 68 61  panning more tha
63c0: 6e 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66  n one database f
63d0: 69 6c 65 2c 20 74 68 69 73 20 72 6f 75 74 69 6e  ile, this routin
63e0: 65 0a 2a 2a 20 74 61 6b 65 73 20 63 61 72 65 20  e.** takes care 
63f0: 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  of the master jo
6400: 75 72 6e 61 6c 20 74 72 69 63 6b 65 72 79 2e 0a  urnal trickery..
6410: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64  */.static int vd
6420: 62 65 43 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33  beCommit(sqlite3
6430: 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a   *db){.  int i;.
6440: 20 20 69 6e 74 20 6e 54 72 61 6e 73 20 3d 20 30    int nTrans = 0
6450: 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20  ;  /* Number of 
6460: 64 61 74 61 62 61 73 65 73 20 77 69 74 68 20 61  databases with a
6470: 6e 20 61 63 74 69 76 65 20 77 72 69 74 65 2d 74  n active write-t
6480: 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20  ransaction */.  
6490: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
64a0: 4f 4b 3b 0a 20 20 69 6e 74 20 6e 65 65 64 58 63  OK;.  int needXc
64b0: 6f 6d 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 66 6f  ommit = 0;..  fo
64c0: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62  r(i=0; i<db->nDb
64d0: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 42 74 72  ; i++){ .    Btr
64e0: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
64f0: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66  b[i].pBt;.    if
6500: 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65 33  ( pBt && sqlite3
6510: 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70  BtreeIsInTrans(p
6520: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 6e 65 65  Bt) ){.      nee
6530: 64 58 63 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20  dXcommit = 1;.  
6540: 20 20 20 20 69 66 28 20 69 21 3d 31 20 29 20 6e      if( i!=1 ) n
6550: 54 72 61 6e 73 2b 2b 3b 0a 20 20 20 20 7d 0a 20  Trans++;.    }. 
6560: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72   }..  /* If ther
6570: 65 20 61 72 65 20 61 6e 79 20 77 72 69 74 65 2d  e are any write-
6580: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 74 20  transactions at 
6590: 61 6c 6c 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20  all, invoke the 
65a0: 63 6f 6d 6d 69 74 20 68 6f 6f 6b 20 2a 2f 0a 20  commit hook */. 
65b0: 20 69 66 28 20 6e 65 65 64 58 63 6f 6d 6d 69 74   if( needXcommit
65c0: 20 26 26 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43   && db->xCommitC
65d0: 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 69  allback ){.    i
65e0: 6e 74 20 72 63 3b 0a 20 20 20 20 73 71 6c 69 74  nt rc;.    sqlit
65f0: 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b  e3SafetyOff(db);
6600: 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 78 43  .    rc = db->xC
6610: 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 28 64 62  ommitCallback(db
6620: 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 29 3b 0a 20  ->pCommitArg);. 
6630: 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79     sqlite3Safety
6640: 4f 6e 28 64 62 29 3b 0a 20 20 20 20 69 66 28 20  On(db);.    if( 
6650: 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75  rc ){.      retu
6660: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52  rn SQLITE_CONSTR
6670: 41 49 4e 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  AINT;.    }.  }.
6680: 0a 20 20 2f 2a 20 54 68 65 20 73 69 6d 70 6c 65  .  /* The simple
6690: 20 63 61 73 65 20 2d 20 6e 6f 20 6d 6f 72 65 20   case - no more 
66a0: 74 68 61 6e 20 6f 6e 65 20 64 61 74 61 62 61 73  than one databas
66b0: 65 20 66 69 6c 65 20 28 6e 6f 74 20 63 6f 75 6e  e file (not coun
66c0: 74 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 54 45  ting the.  ** TE
66d0: 4d 50 20 64 61 74 61 62 61 73 65 29 20 68 61 73  MP database) has
66e0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61   a transaction a
66f0: 63 74 69 76 65 2e 20 20 20 54 68 65 72 65 20 69  ctive.   There i
6700: 73 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 74 68  s no need for th
6710: 65 0a 20 20 2a 2a 20 6d 61 73 74 65 72 2d 6a 6f  e.  ** master-jo
6720: 75 72 6e 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  urnal..  **.  **
6730: 20 49 66 20 74 68 65 20 72 65 74 75 72 6e 20 76   If the return v
6740: 61 6c 75 65 20 6f 66 20 73 71 6c 69 74 65 33 42  alue of sqlite3B
6750: 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28  treeGetFilename(
6760: 29 20 69 73 20 61 20 7a 65 72 6f 20 6c 65 6e 67  ) is a zero leng
6770: 74 68 0a 20 20 2a 2a 20 73 74 72 69 6e 67 2c 20  th.  ** string, 
6780: 69 74 20 6d 65 61 6e 73 20 74 68 65 20 6d 61 69  it means the mai
6790: 6e 20 64 61 74 61 62 61 73 65 20 69 73 20 3a 6d  n database is :m
67a0: 65 6d 6f 72 79 3a 2e 20 20 49 6e 20 74 68 61 74  emory:.  In that
67b0: 20 63 61 73 65 20 77 65 20 64 6f 0a 20 20 2a 2a   case we do.  **
67c0: 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 74 6f   not support ato
67d0: 6d 69 63 20 6d 75 6c 74 69 2d 66 69 6c 65 20 63  mic multi-file c
67e0: 6f 6d 6d 69 74 73 2c 20 73 6f 20 75 73 65 20 74  ommits, so use t
67f0: 68 65 20 73 69 6d 70 6c 65 20 63 61 73 65 20 74  he simple case t
6800: 68 65 6e 0a 20 20 2a 2a 20 74 6f 6f 2e 0a 20 20  hen.  ** too..  
6810: 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 73 74 72 6c  */.  if( 0==strl
6820: 65 6e 28 73 71 6c 69 74 65 33 42 74 72 65 65 47  en(sqlite3BtreeG
6830: 65 74 46 69 6c 65 6e 61 6d 65 28 64 62 2d 3e 61  etFilename(db->a
6840: 44 62 5b 30 5d 2e 70 42 74 29 29 20 7c 7c 20 6e  Db[0].pBt)) || n
6850: 54 72 61 6e 73 3c 3d 31 20 29 7b 0a 20 20 20 20  Trans<=1 ){.    
6860: 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c  for(i=0; rc==SQL
6870: 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e  ITE_OK && i<db->
6880: 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20  nDb; i++){ .    
6890: 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64    Btree *pBt = d
68a0: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20  b->aDb[i].pBt;. 
68b0: 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a       if( pBt ){.
68c0: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
68d0: 69 74 65 33 42 74 72 65 65 53 79 6e 63 28 70 42  ite3BtreeSync(pB
68e0: 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20  t, 0);.      }. 
68f0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 6f 20     }..    /* Do 
6900: 74 68 65 20 63 6f 6d 6d 69 74 20 6f 6e 6c 79 20  the commit only 
6910: 69 66 20 61 6c 6c 20 64 61 74 61 62 61 73 65 73  if all databases
6920: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 73 79   successfully sy
6930: 6e 63 65 64 20 2a 2f 0a 20 20 20 20 69 66 28 20  nced */.    if( 
6940: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
6950: 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  .      for(i=0; 
6960: 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b  i<db->nDb; i++){
6970: 0a 20 20 20 20 20 20 20 20 42 74 72 65 65 20 2a  .        Btree *
6980: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d  pBt = db->aDb[i]
6990: 2e 70 42 74 3b 0a 20 20 20 20 20 20 20 20 69 66  .pBt;.        if
69a0: 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20  ( pBt ){.       
69b0: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
69c0: 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20  ommit(pBt);.    
69d0: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20      }.      }.  
69e0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68    }.  }..  /* Th
69f0: 65 20 63 6f 6d 70 6c 65 78 20 63 61 73 65 20 2d  e complex case -
6a00: 20 54 68 65 72 65 20 69 73 20 61 20 6d 75 6c 74   There is a mult
6a10: 69 2d 66 69 6c 65 20 77 72 69 74 65 2d 74 72 61  i-file write-tra
6a20: 6e 73 61 63 74 69 6f 6e 20 61 63 74 69 76 65 2e  nsaction active.
6a30: 0a 20 20 2a 2a 20 54 68 69 73 20 72 65 71 75 69  .  ** This requi
6a40: 72 65 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  res a master jou
6a50: 72 6e 61 6c 20 66 69 6c 65 20 74 6f 20 65 6e 73  rnal file to ens
6a60: 75 72 65 20 74 68 65 20 74 72 61 6e 73 61 63 74  ure the transact
6a70: 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 63 6f 6d 6d  ion is.  ** comm
6a80: 69 74 74 65 64 20 61 74 6f 6d 69 63 6c 79 2e 0a  itted atomicly..
6a90: 20 20 2a 2f 0a 20 20 65 6c 73 65 7b 0a 20 20 20    */.  else{.   
6aa0: 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d   char *zMaster =
6ab0: 20 30 3b 20 20 20 2f 2a 20 46 69 6c 65 2d 6e 61   0;   /* File-na
6ac0: 6d 65 20 66 6f 72 20 74 68 65 20 6d 61 73 74 65  me for the maste
6ad0: 72 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20  r journal */.   
6ae0: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61   char const *zMa
6af0: 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33  inFile = sqlite3
6b00: 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65  BtreeGetFilename
6b10: 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29  (db->aDb[0].pBt)
6b20: 3b 0a 20 20 20 20 4f 73 46 69 6c 65 20 6d 61 73  ;.    OsFile mas
6b30: 74 65 72 3b 0a 0a 20 20 20 20 2f 2a 20 53 65 6c  ter;..    /* Sel
6b40: 65 63 74 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  ect a master jou
6b50: 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 2a  rnal file name *
6b60: 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20  /.    do {.     
6b70: 20 75 33 32 20 72 61 6e 64 6f 6d 3b 0a 20 20 20   u32 random;.   
6b80: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
6b90: 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71  aster);.      sq
6ba0: 6c 69 74 65 33 52 61 6e 64 6f 6d 6e 65 73 73 28  lite3Randomness(
6bb0: 73 69 7a 65 6f 66 28 72 61 6e 64 6f 6d 29 2c 20  sizeof(random), 
6bc0: 26 72 61 6e 64 6f 6d 29 3b 0a 20 20 20 20 20 20  &random);.      
6bd0: 7a 4d 61 73 74 65 72 20 3d 20 73 71 6c 69 74 65  zMaster = sqlite
6be0: 33 4d 50 72 69 6e 74 66 28 22 25 73 2d 6d 6a 25  3MPrintf("%s-mj%
6bf0: 30 38 58 22 2c 20 7a 4d 61 69 6e 46 69 6c 65 2c  08X", zMainFile,
6c00: 20 72 61 6e 64 6f 6d 26 30 78 37 66 66 66 66 66   random&0x7fffff
6c10: 66 66 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21  ff);.      if( !
6c20: 7a 4d 61 73 74 65 72 20 29 7b 0a 20 20 20 20 20  zMaster ){.     
6c30: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
6c40: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a  _NOMEM;.      }.
6c50: 20 20 20 20 7d 77 68 69 6c 65 28 20 73 71 6c 69      }while( sqli
6c60: 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73 28  te3OsFileExists(
6c70: 7a 4d 61 73 74 65 72 29 20 29 3b 0a 0a 20 20 20  zMaster) );..   
6c80: 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 6d 61 73   /* Open the mas
6c90: 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a  ter journal. */.
6ca0: 20 20 20 20 6d 65 6d 73 65 74 28 26 6d 61 73 74      memset(&mast
6cb0: 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 61  er, 0, sizeof(ma
6cc0: 73 74 65 72 29 29 3b 0a 20 20 20 20 72 63 20 3d  ster));.    rc =
6cd0: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78   sqlite3OsOpenEx
6ce0: 63 6c 75 73 69 76 65 28 7a 4d 61 73 74 65 72 2c  clusive(zMaster,
6cf0: 20 26 6d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20   &master, 0);.  
6d00: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
6d10: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  _OK ){.      sql
6d20: 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29  iteFree(zMaster)
6d30: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  ;.      return r
6d40: 63 3b 0a 20 20 20 20 7d 0a 20 0a 20 20 20 20 2f  c;.    }. .    /
6d50: 2a 20 57 72 69 74 65 20 74 68 65 20 6e 61 6d 65  * Write the name
6d60: 20 6f 66 20 65 61 63 68 20 64 61 74 61 62 61 73   of each databas
6d70: 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20 74 72  e file in the tr
6d80: 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74 6f 20 74  ansaction into t
6d90: 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20 6d 61  he new.    ** ma
6da0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
6db0: 65 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f  e. If an error o
6dc0: 63 63 75 72 73 20 61 74 20 74 68 69 73 20 70 6f  ccurs at this po
6dd0: 69 6e 74 20 63 6c 6f 73 65 0a 20 20 20 20 2a 2a  int close.    **
6de0: 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20   and delete the 
6df0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
6e00: 69 6c 65 2e 20 41 6c 6c 20 74 68 65 20 69 6e 64  ile. All the ind
6e10: 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20  ividual journal 
6e20: 66 69 6c 65 73 0a 20 20 20 20 2a 2a 20 73 74 69  files.    ** sti
6e30: 6c 6c 20 68 61 76 65 20 27 6e 75 6c 6c 27 20 61  ll have 'null' a
6e40: 73 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  s the master jou
6e50: 72 6e 61 6c 20 70 6f 69 6e 74 65 72 2c 20 73 6f  rnal pointer, so
6e60: 20 74 68 65 79 20 77 69 6c 6c 20 72 6f 6c 6c 0a   they will roll.
6e70: 20 20 20 20 2a 2a 20 62 61 63 6b 20 69 6e 64 65      ** back inde
6e80: 70 65 6e 64 61 6e 74 6c 79 20 69 66 20 61 20 66  pendantly if a f
6e90: 61 69 6c 75 72 65 20 6f 63 63 75 72 73 2e 0a 20  ailure occurs.. 
6ea0: 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d     */.    for(i=
6eb0: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  0; i<db->nDb; i+
6ec0: 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65 65  +){ .      Btree
6ed0: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b   *pBt = db->aDb[
6ee0: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66  i].pBt;.      if
6ef0: 28 20 69 3d 3d 31 20 29 20 63 6f 6e 74 69 6e 75  ( i==1 ) continu
6f00: 65 3b 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74  e;   /* Ignore t
6f10: 68 65 20 54 45 4d 50 20 64 61 74 61 62 61 73 65  he TEMP database
6f20: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42   */.      if( pB
6f30: 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 72 65  t && sqlite3Btre
6f40: 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20  eIsInTrans(pBt) 
6f50: 29 7b 0a 20 20 20 20 20 20 20 20 63 68 61 72 20  ){.        char 
6f60: 63 6f 6e 73 74 20 2a 7a 46 69 6c 65 20 3d 20 73  const *zFile = s
6f70: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 4a 6f  qlite3BtreeGetJo
6f80: 75 72 6e 61 6c 6e 61 6d 65 28 70 42 74 29 3b 0a  urnalname(pBt);.
6f90: 20 20 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c          if( zFil
6fa0: 65 5b 30 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e  e[0]==0 ) contin
6fb0: 75 65 3b 20 20 2f 2a 20 49 67 6e 6f 72 65 20 3a  ue;  /* Ignore :
6fc0: 6d 65 6d 6f 72 79 3a 20 64 61 74 61 62 61 73 65  memory: database
6fd0: 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20  s */.        rc 
6fe0: 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65  = sqlite3OsWrite
6ff0: 28 26 6d 61 73 74 65 72 2c 20 7a 46 69 6c 65 2c  (&master, zFile,
7000: 20 73 74 72 6c 65 6e 28 7a 46 69 6c 65 29 2b 31   strlen(zFile)+1
7010: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72  );.        if( r
7020: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
7030: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
7040: 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72  3OsClose(&master
7050: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  );.          sql
7060: 69 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61  ite3OsDelete(zMa
7070: 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20  ster);.         
7080: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
7090: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ter);.          
70a0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20  return rc;.     
70b0: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
70c0: 20 7d 0a 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63   }...    /* Sync
70d0: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72   the master jour
70e0: 6e 61 6c 20 66 69 6c 65 2e 20 42 65 66 6f 72 65  nal file. Before
70f0: 20 64 6f 69 6e 67 20 74 68 69 73 2c 20 6f 70 65   doing this, ope
7100: 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a  n the directory.
7110: 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 73 74 65      ** the maste
7120: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69  r journal file i
7130: 73 20 73 74 6f 72 65 20 69 6e 20 73 6f 20 74 68  s store in so th
7140: 61 74 20 69 74 20 67 65 74 73 20 73 79 6e 63 65  at it gets synce
7150: 64 20 74 6f 6f 2e 0a 20 20 20 20 2a 2f 0a 20 20  d too..    */.  
7160: 20 20 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71    zMainFile = sq
7170: 6c 69 74 65 33 42 74 72 65 65 47 65 74 44 69 72  lite3BtreeGetDir
7180: 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e  name(db->aDb[0].
7190: 70 42 74 29 3b 0a 20 20 20 20 72 63 20 3d 20 73  pBt);.    rc = s
71a0: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 44 69 72 65  qlite3OsOpenDire
71b0: 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69 6c 65 2c  ctory(zMainFile,
71c0: 20 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 69   &master);.    i
71d0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
71e0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
71f0: 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72  3OsClose(&master
7200: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
7210: 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72  OsDelete(zMaster
7220: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46  );.      sqliteF
7230: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
7240: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
7250: 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71     }.    rc = sq
7260: 6c 69 74 65 33 4f 73 53 79 6e 63 28 26 6d 61 73  lite3OsSync(&mas
7270: 74 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63  ter);.    if( rc
7280: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
7290: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c       sqlite3OsCl
72a0: 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20  ose(&master);.  
72b0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a      sqliteFree(z
72c0: 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 72  Master);.      r
72d0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a  eturn rc;.    }.
72e0: 0a 20 20 20 20 2f 2a 20 53 79 6e 63 20 61 6c 6c  .    /* Sync all
72f0: 20 74 68 65 20 64 62 20 66 69 6c 65 73 20 69 6e   the db files in
7300: 76 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 74 72  volved in the tr
7310: 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73  ansaction. The s
7320: 61 6d 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20  ame call.    ** 
7330: 73 65 74 73 20 74 68 65 20 6d 61 73 74 65 72 20  sets the master 
7340: 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20  journal pointer 
7350: 69 6e 20 65 61 63 68 20 69 6e 64 69 76 69 64 75  in each individu
7360: 61 6c 20 6a 6f 75 72 6e 61 6c 2e 20 49 66 0a 20  al journal. If. 
7370: 20 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 20 6f     ** an error o
7380: 63 63 75 72 73 20 68 65 72 65 2c 20 64 6f 20 6e  ccurs here, do n
7390: 6f 74 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61  ot delete the ma
73a0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
73b0: 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a  e..    **.    **
73c0: 20 49 66 20 74 68 65 20 65 72 72 6f 72 20 6f 63   If the error oc
73d0: 63 75 72 73 20 64 75 72 69 6e 67 20 74 68 65 20  curs during the 
73e0: 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 20 73 71  first call to sq
73f0: 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63 28 29  lite3BtreeSync()
7400: 2c 0a 20 20 20 20 2a 2a 20 74 68 65 6e 20 74 68  ,.    ** then th
7410: 65 72 65 20 69 73 20 61 20 63 68 61 6e 63 65 20  ere is a chance 
7420: 74 68 61 74 20 74 68 65 20 6d 61 73 74 65 72 20  that the master 
7430: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 69 6c  journal file wil
7440: 6c 20 62 65 0a 20 20 20 20 2a 2a 20 6f 72 70 68  l be.    ** orph
7450: 61 6e 65 64 2e 20 42 75 74 20 77 65 20 63 61 6e  aned. But we can
7460: 6e 6f 74 20 64 65 6c 65 74 65 20 69 74 2c 20 69  not delete it, i
7470: 6e 20 63 61 73 65 20 74 68 65 20 6d 61 73 74 65  n case the maste
7480: 72 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a  r journal.    **
7490: 20 66 69 6c 65 20 6e 61 6d 65 20 77 61 73 20 77   file name was w
74a0: 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20  ritten into the 
74b0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 62 65 66  journal file bef
74c0: 6f 72 65 20 74 68 65 20 66 61 69 6c 75 72 65 0a  ore the failure.
74d0: 20 20 20 20 2a 2a 20 6f 63 63 75 72 65 64 2e 0a      ** occured..
74e0: 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69      */.    for(i
74f0: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
7500: 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65  ++){ .      Btre
7510: 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62  e *pBt = db->aDb
7520: 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69  [i].pBt;.      i
7530: 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65  f( pBt && sqlite
7540: 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28  3BtreeIsInTrans(
7550: 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 20 20  pBt) ){.        
7560: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
7570: 65 53 79 6e 63 28 70 42 74 2c 20 7a 4d 61 73 74  eSync(pBt, zMast
7580: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28  er);.        if(
7590: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
75a0: 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  {.          sqli
75b0: 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74  te3OsClose(&mast
75c0: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73  er);.          s
75d0: 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65  qliteFree(zMaste
75e0: 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65  r);.          re
75f0: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20  turn rc;.       
7600: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d   }.      }.    }
7610: 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c  .    sqlite3OsCl
7620: 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 0a 20  ose(&master);.. 
7630: 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 74 68 65     /* Delete the
7640: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
7650: 66 69 6c 65 2e 20 54 68 69 73 20 63 6f 6d 6d 69  file. This commi
7660: 74 73 20 74 68 65 20 74 72 61 6e 73 61 63 74 69  ts the transacti
7670: 6f 6e 2e 20 41 66 74 65 72 0a 20 20 20 20 2a 2a  on. After.    **
7680: 20 64 6f 69 6e 67 20 74 68 69 73 20 74 68 65 20   doing this the 
7690: 64 69 72 65 63 74 6f 72 79 20 69 73 20 73 79 6e  directory is syn
76a0: 63 65 64 20 61 67 61 69 6e 20 62 65 66 6f 72 65  ced again before
76b0: 20 61 6e 79 20 69 6e 64 69 76 69 64 75 61 6c 0a   any individual.
76c0: 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69      ** transacti
76d0: 6f 6e 20 66 69 6c 65 73 20 61 72 65 20 64 65 6c  on files are del
76e0: 65 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  eted..    */.   
76f0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44   rc = sqlite3OsD
7700: 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a  elete(zMaster);.
7710: 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d      assert( rc==
7720: 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20  SQLITE_OK );.   
7730: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
7740: 74 65 72 29 3b 0a 20 20 20 20 7a 4d 61 73 74 65  ter);.    zMaste
7750: 72 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d 20  r = 0;.    rc = 
7760: 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69 72  sqlite3OsSyncDir
7770: 65 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69 6c 65  ectory(zMainFile
7780: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53  );.    if( rc!=S
7790: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
77a0: 20 20 2f 2a 20 54 68 69 73 20 69 73 20 6e 6f 74    /* This is not
77b0: 20 67 6f 6f 64 2e 20 54 68 65 20 6d 61 73 74 65   good. The maste
77c0: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68  r journal file h
77d0: 61 73 20 62 65 65 6e 20 64 65 6c 65 74 65 64 2c  as been deleted,
77e0: 20 62 75 74 0a 20 20 20 20 20 20 2a 2a 20 74 68   but.      ** th
77f0: 65 20 64 69 72 65 63 74 6f 72 79 20 73 79 6e 63  e directory sync
7800: 20 66 61 69 6c 65 64 2e 20 54 68 65 72 65 20 69   failed. There i
7810: 73 20 6e 6f 20 63 6f 6d 70 6c 65 74 65 6c 79 20  s no completely 
7820: 73 61 66 65 20 63 6f 75 72 73 65 20 6f 66 0a 20  safe course of. 
7830: 20 20 20 20 20 2a 2a 20 61 63 74 69 6f 6e 20 66       ** action f
7840: 72 6f 6d 20 68 65 72 65 2e 20 54 68 65 20 69 6e  rom here. The in
7850: 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c  dividual journal
7860: 73 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 6e 61  s contain the na
7870: 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20  me of the.      
7880: 2a 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  ** master journa
7890: 6c 20 66 69 6c 65 2c 20 62 75 74 20 74 68 65 72  l file, but ther
78a0: 65 20 69 73 20 6e 6f 20 77 61 79 20 6f 66 20 6b  e is no way of k
78b0: 6e 6f 77 69 6e 67 20 69 66 20 74 68 61 74 0a 20  nowing if that. 
78c0: 20 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a       ** master j
78d0: 6f 75 72 6e 61 6c 20 65 78 69 73 74 73 20 6e 6f  ournal exists no
78e0: 77 20 6f 72 20 69 66 20 69 74 20 77 69 6c 6c 20  w or if it will 
78f0: 65 78 69 73 74 20 61 66 74 65 72 20 74 68 65 20  exist after the 
7900: 6f 70 65 72 61 74 69 6e 67 0a 20 20 20 20 20 20  operating.      
7910: 2a 2a 20 73 79 73 74 65 6d 20 63 72 61 73 68 20  ** system crash 
7920: 74 68 61 74 20 6d 61 79 20 66 6f 6c 6c 6f 77 20  that may follow 
7930: 74 68 65 20 66 73 79 6e 63 28 29 20 66 61 69 6c  the fsync() fail
7940: 75 72 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  ure..      */.  
7950: 20 20 20 20 61 73 73 65 72 74 28 30 29 3b 0a 20      assert(0);. 
7960: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
7970: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  zMaster);.      
7980: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d  return rc;.    }
7990: 0a 0a 20 20 20 20 2f 2a 20 41 6c 6c 20 66 69 6c  ..    /* All fil
79a0: 65 73 20 61 6e 64 20 64 69 72 65 63 74 6f 72 69  es and directori
79b0: 65 73 20 68 61 76 65 20 61 6c 72 65 61 64 79 20  es have already 
79c0: 62 65 65 6e 20 73 79 6e 63 65 64 2c 20 73 6f 20  been synced, so 
79d0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20  the following.  
79e0: 20 20 2a 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71    ** calls to sq
79f0: 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74  lite3BtreeCommit
7a00: 28 29 20 61 72 65 20 6f 6e 6c 79 20 63 6c 6f 73  () are only clos
7a10: 69 6e 67 20 66 69 6c 65 73 20 61 6e 64 20 64 65  ing files and de
7a20: 6c 65 74 69 6e 67 0a 20 20 20 20 2a 2a 20 6a 6f  leting.    ** jo
7a30: 75 72 6e 61 6c 73 2e 20 49 66 20 73 6f 6d 65 74  urnals. If somet
7a40: 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 20  hing goes wrong 
7a50: 77 68 69 6c 65 20 74 68 69 73 20 69 73 20 68 61  while this is ha
7a60: 70 70 65 6e 69 6e 67 20 77 65 20 64 6f 6e 27 74  ppening we don't
7a70: 0a 20 20 20 20 2a 2a 20 72 65 61 6c 6c 79 20 63  .    ** really c
7a80: 61 72 65 2e 20 54 68 65 20 69 6e 74 65 67 72 69  are. The integri
7a90: 74 79 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61  ty of the transa
7aa0: 63 74 69 6f 6e 20 69 73 20 61 6c 72 65 61 64 79  ction is already
7ab0: 20 67 75 61 72 61 6e 74 65 65 64 2c 0a 20 20 20   guaranteed,.   
7ac0: 20 2a 2a 20 62 75 74 20 73 6f 6d 65 20 73 74 72   ** but some str
7ad0: 61 79 20 27 63 6f 6c 64 27 20 6a 6f 75 72 6e 61  ay 'cold' journa
7ae0: 6c 73 20 6d 61 79 20 62 65 20 6c 79 69 6e 67 20  ls may be lying 
7af0: 61 72 6f 75 6e 64 2e 20 52 65 74 75 72 6e 69 6e  around. Returnin
7b00: 67 20 61 6e 0a 20 20 20 20 2a 2a 20 65 72 72 6f  g an.    ** erro
7b10: 72 20 63 6f 64 65 20 77 6f 6e 27 74 20 68 65 6c  r code won't hel
7b20: 70 20 6d 61 74 74 65 72 73 2e 0a 20 20 20 20 2a  p matters..    *
7b30: 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  /.    for(i=0; i
7b40: 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20  <db->nDb; i++){ 
7b50: 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 42  .      Btree *pB
7b60: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70  t = db->aDb[i].p
7b70: 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42  Bt;.      if( pB
7b80: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  t ){.        sql
7b90: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28  ite3BtreeCommit(
7ba0: 70 42 74 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  pBt);.      }.  
7bb0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72    }.  }..  retur
7bc0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  n rc;.}../*.** F
7bd0: 69 6e 64 20 65 76 65 72 79 20 61 63 74 69 76 65  ind every active
7be0: 20 56 4d 20 6f 74 68 65 72 20 74 68 61 6e 20 70   VM other than p
7bf0: 56 64 62 65 20 61 6e 64 20 63 68 61 6e 67 65 20  Vdbe and change 
7c00: 69 74 73 20 73 74 61 74 75 73 20 74 6f 0a 2a 2a  its status to.**
7c10: 20 61 62 6f 72 74 65 64 2e 20 20 54 68 69 73 20   aborted.  This 
7c20: 68 61 70 70 65 6e 73 20 77 68 65 6e 20 6f 6e 65  happens when one
7c30: 20 56 4d 20 63 61 75 73 65 73 20 61 20 72 6f 6c   VM causes a rol
7c40: 6c 62 61 63 6b 20 64 75 65 20 74 6f 20 61 6e 0a  lback due to an.
7c50: 2a 2a 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 52  ** ON CONFLICT R
7c60: 4f 4c 4c 42 41 43 4b 20 63 6c 61 75 73 65 20 28  OLLBACK clause (
7c70: 66 6f 72 20 65 78 61 6d 70 6c 65 29 2e 20 20 54  for example).  T
7c80: 68 65 20 6f 74 68 65 72 20 56 4d 73 20 6d 75 73  he other VMs mus
7c90: 74 20 62 65 0a 2a 2a 20 61 62 6f 72 74 65 64 20  t be.** aborted 
7ca0: 73 6f 20 74 68 61 74 20 74 68 65 79 20 64 6f 20  so that they do 
7cb0: 6e 6f 74 20 68 61 76 65 20 64 61 74 61 20 72 6f  not have data ro
7cc0: 6c 6c 65 64 20 6f 75 74 20 66 72 6f 6d 20 75 6e  lled out from un
7cd0: 64 65 72 6e 65 61 74 68 0a 2a 2a 20 74 68 65 6d  derneath.** them
7ce0: 20 6c 65 61 64 69 6e 67 20 74 6f 20 61 20 73 65   leading to a se
7cf0: 67 66 61 75 6c 74 2e 0a 2a 2f 0a 73 74 61 74 69  gfault..*/.stati
7d00: 63 20 76 6f 69 64 20 61 62 6f 72 74 4f 74 68 65  c void abortOthe
7d10: 72 41 63 74 69 76 65 56 64 62 65 73 28 56 64 62  rActiveVdbes(Vdb
7d20: 65 20 2a 70 56 64 62 65 29 7b 0a 20 20 56 64 62  e *pVdbe){.  Vdb
7d30: 65 20 2a 70 4f 74 68 65 72 3b 0a 20 20 66 6f 72  e *pOther;.  for
7d40: 28 70 4f 74 68 65 72 3d 70 56 64 62 65 2d 3e 64  (pOther=pVdbe->d
7d50: 62 2d 3e 70 56 64 62 65 3b 20 70 4f 74 68 65 72  b->pVdbe; pOther
7d60: 3b 20 70 4f 74 68 65 72 3d 70 4f 74 68 65 72 2d  ; pOther=pOther-
7d70: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28  >pNext){.    if(
7d80: 20 70 4f 74 68 65 72 3d 3d 70 56 64 62 65 20 29   pOther==pVdbe )
7d90: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69   continue;.    i
7da0: 66 28 20 70 4f 74 68 65 72 2d 3e 6d 61 67 69 63  f( pOther->magic
7db0: 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e  !=VDBE_MAGIC_RUN
7dc0: 20 7c 7c 20 70 4f 74 68 65 72 2d 3e 70 63 3c 30   || pOther->pc<0
7dd0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
7de0: 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73   closeAllCursors
7df0: 28 70 4f 74 68 65 72 29 3b 0a 20 20 20 20 70 4f  (pOther);.    pO
7e00: 74 68 65 72 2d 3e 61 62 6f 72 74 65 64 20 3d 20  ther->aborted = 
7e10: 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 20 0a 2a 2a  1;.  }.}../* .**
7e20: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 68   This routine ch
7e30: 65 63 6b 73 20 74 68 61 74 20 74 68 65 20 73 71  ecks that the sq
7e40: 6c 69 74 65 33 2e 61 63 74 69 76 65 56 64 62 65  lite3.activeVdbe
7e50: 43 6e 74 20 63 6f 75 6e 74 20 76 61 72 69 61 62  Cnt count variab
7e60: 6c 65 0a 2a 2a 20 6d 61 74 63 68 65 73 20 74 68  le.** matches th
7e70: 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 64 62 65  e number of vdbe
7e80: 27 73 20 69 6e 20 74 68 65 20 6c 69 73 74 20 73  's in the list s
7e90: 71 6c 69 74 65 33 2e 70 56 64 62 65 20 74 68 61  qlite3.pVdbe tha
7ea0: 74 20 61 72 65 0a 2a 2a 20 63 75 72 72 65 6e 74  t are.** current
7eb0: 6c 79 20 61 63 74 69 76 65 2e 20 41 6e 20 61 73  ly active. An as
7ec0: 73 65 72 74 69 6f 6e 20 66 61 69 6c 73 20 69 66  sertion fails if
7ed0: 20 74 68 65 20 74 77 6f 20 63 6f 75 6e 74 73 20   the two counts 
7ee0: 64 6f 20 6e 6f 74 20 6d 61 74 63 68 2e 0a 2a 2a  do not match..**
7ef0: 20 54 68 69 73 20 69 73 20 61 6e 20 69 6e 74 65   This is an inte
7f00: 72 6e 61 6c 20 73 65 6c 66 2d 63 68 65 63 6b 20  rnal self-check 
7f10: 6f 6e 6c 79 20 2d 20 69 74 20 69 73 20 6e 6f 74  only - it is not
7f20: 20 61 6e 20 65 73 73 65 6e 74 69 61 6c 20 70 72   an essential pr
7f30: 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 73 74 65 70  ocessing.** step
7f40: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20  ..**.** This is 
7f50: 61 20 6e 6f 2d 6f 70 20 69 66 20 4e 44 45 42 55  a no-op if NDEBU
7f60: 47 20 69 73 20 64 65 66 69 6e 65 64 2e 0a 2a 2f  G is defined..*/
7f70: 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a  .#ifndef NDEBUG.
7f80: 73 74 61 74 69 63 20 76 6f 69 64 20 63 68 65 63  static void chec
7f90: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 73  kActiveVdbeCnt(s
7fa0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 56  qlite3 *db){.  V
7fb0: 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74 20 63 6e  dbe *p;.  int cn
7fc0: 74 20 3d 20 30 3b 0a 20 20 70 20 3d 20 64 62 2d  t = 0;.  p = db-
7fd0: 3e 70 56 64 62 65 3b 0a 20 20 77 68 69 6c 65 28  >pVdbe;.  while(
7fe0: 20 70 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d   p ){.    if( p-
7ff0: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
8000: 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 70 63 3e  IC_RUN && p->pc>
8010: 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6e 74 2b  =0 ){.      cnt+
8020: 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 20 3d  +;.    }.    p =
8030: 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20   p->pNext;.  }. 
8040: 20 61 73 73 65 72 74 28 20 63 6e 74 3d 3d 64 62   assert( cnt==db
8050: 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20  ->activeVdbeCnt 
8060: 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 65 66 69  );.}.#else.#defi
8070: 6e 65 20 63 68 65 63 6b 41 63 74 69 76 65 56 64  ne checkActiveVd
8080: 62 65 43 6e 74 28 78 29 0a 23 65 6e 64 69 66 0a  beCnt(x).#endif.
8090: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
80a0: 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 74 68  ine is called th
80b0: 65 20 77 68 65 6e 20 61 20 56 44 42 45 20 74 72  e when a VDBE tr
80c0: 69 65 73 20 74 6f 20 68 61 6c 74 2e 20 20 49 66  ies to halt.  If
80d0: 20 74 68 65 20 56 44 42 45 0a 2a 2a 20 68 61 73   the VDBE.** has
80e0: 20 6d 61 64 65 20 63 68 61 6e 67 65 73 20 61 6e   made changes an
80f0: 64 20 69 73 20 69 6e 20 61 75 74 6f 63 6f 6d 6d  d is in autocomm
8100: 69 74 20 6d 6f 64 65 2c 20 74 68 65 6e 20 63 6f  it mode, then co
8110: 6d 6d 69 74 20 74 68 6f 73 65 0a 2a 2a 20 63 68  mmit those.** ch
8120: 61 6e 67 65 73 2e 20 20 49 66 20 61 20 72 6f 6c  anges.  If a rol
8130: 6c 62 61 63 6b 20 69 73 20 6e 65 65 64 65 64 2c  lback is needed,
8140: 20 74 68 65 6e 20 64 6f 20 74 68 65 20 72 6f 6c   then do the rol
8150: 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  lback..**.** Thi
8160: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 74 68 65  s routine is the
8170: 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 6d 6f 76   only way to mov
8180: 65 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 61  e the state of a
8190: 20 56 4d 20 66 72 6f 6d 0a 2a 2a 20 53 51 4c 49   VM from.** SQLI
81a0: 54 45 5f 4d 41 47 49 43 5f 52 55 4e 20 74 6f 20  TE_MAGIC_RUN to 
81b0: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 48 41 4c  SQLITE_MAGIC_HAL
81c0: 54 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  T..**.** Return 
81d0: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 20  an error code.  
81e0: 49 66 20 74 68 65 20 63 6f 6d 6d 69 74 20 63 6f  If the commit co
81f0: 75 6c 64 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65  uld not complete
8200: 20 62 65 63 61 75 73 65 20 6f 66 0a 2a 2a 20 6c   because of.** l
8210: 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e 2c 20  ock contention, 
8220: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55  return SQLITE_BU
8230: 53 59 2e 20 20 49 66 20 53 51 4c 49 54 45 5f 42  SY.  If SQLITE_B
8240: 55 53 59 20 69 73 20 72 65 74 75 72 6e 65 64 2c  USY is returned,
8250: 20 69 74 0a 2a 2a 20 6d 65 61 6e 73 20 74 68 65   it.** means the
8260: 20 63 6c 6f 73 65 20 64 69 64 20 6e 6f 74 20 68   close did not h
8270: 61 70 70 65 6e 20 61 6e 64 20 6e 65 65 64 73 20  appen and needs 
8280: 74 6f 20 62 65 20 72 65 70 65 61 74 65 64 2e 0a  to be repeated..
8290: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
82a0: 62 65 48 61 6c 74 28 56 64 62 65 20 2a 70 29 7b  beHalt(Vdbe *p){
82b0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d  .  sqlite3 *db =
82c0: 20 70 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 3b   p->db;.  int i;
82d0: 0a 20 20 69 6e 74 20 28 2a 78 46 75 6e 63 29 28  .  int (*xFunc)(
82e0: 42 74 72 65 65 20 2a 70 42 74 29 20 3d 20 30 3b  Btree *pBt) = 0;
82f0: 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f    /* Function to
8300: 20 63 61 6c 6c 20 6f 6e 20 65 61 63 68 20 62 74   call on each bt
8310: 72 65 65 20 62 61 63 6b 65 6e 64 20 2a 2f 0a 0a  ree backend */..
8320: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d    if( p->magic!=
8330: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29  VDBE_MAGIC_RUN )
8340: 7b 0a 20 20 20 20 2f 2a 20 41 6c 72 65 61 64 79  {.    /* Already
8350: 20 68 61 6c 74 65 64 2e 20 20 4e 6f 74 68 69 6e   halted.  Nothin
8360: 67 20 74 6f 20 64 6f 2e 20 2a 2f 0a 20 20 20 20  g to do. */.    
8370: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
8380: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  ==VDBE_MAGIC_HAL
8390: 54 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  T );.    return 
83a0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20  SQLITE_OK;.  }. 
83b0: 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73   closeAllCursors
83c0: 28 70 29 3b 0a 20 20 63 68 65 63 6b 41 63 74 69  (p);.  checkActi
83d0: 76 65 56 64 62 65 43 6e 74 28 64 62 29 3b 0a 20  veVdbeCnt(db);. 
83e0: 20 69 66 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d   if( db->autoCom
83f0: 6d 69 74 20 26 26 20 64 62 2d 3e 61 63 74 69 76  mit && db->activ
8400: 65 56 64 62 65 43 6e 74 3d 3d 31 20 29 7b 0a 20  eVdbeCnt==1 ){. 
8410: 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51     if( p->rc==SQ
8420: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 65 72  LITE_OK || p->er
8430: 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61  rorAction==OE_Fa
8440: 69 6c 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54  il ){.      /* T
8450: 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66  he auto-commit f
8460: 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68 65  lag is true, the
8470: 72 65 20 61 72 65 20 6e 6f 20 6f 74 68 65 72 20  re are no other 
8480: 61 63 74 69 76 65 20 71 75 65 72 69 65 73 0a 20  active queries. 
8490: 20 20 20 20 20 2a 2a 20 75 73 69 6e 67 20 74 68       ** using th
84a0: 69 73 20 68 61 6e 64 6c 65 20 61 6e 64 20 74 68  is handle and th
84b0: 65 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20 77  e vdbe program w
84c0: 61 73 20 73 75 63 63 65 73 73 66 75 6c 20 6f 72  as successful or
84d0: 20 68 69 74 20 61 6e 0a 20 20 20 20 20 20 2a 2a   hit an.      **
84e0: 20 27 4f 52 20 46 41 49 4c 27 20 63 6f 6e 73 74   'OR FAIL' const
84f0: 72 61 69 6e 74 2e 20 54 68 69 73 20 6d 65 61 6e  raint. This mean
8500: 73 20 61 20 63 6f 6d 6d 69 74 20 69 73 20 72 65  s a commit is re
8510: 71 75 69 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f  quired..      */
8520: 0a 20 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20  .      int rc = 
8530: 76 64 62 65 43 6f 6d 6d 69 74 28 64 62 29 3b 0a  vdbeCommit(db);.
8540: 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51        if( rc==SQ
8550: 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20  LITE_BUSY ){.   
8560: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49       return SQLI
8570: 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 7d  TE_BUSY;.      }
8580: 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c  else if( rc!=SQL
8590: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
85a0: 20 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20    p->rc = rc;.  
85b0: 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71        xFunc = sq
85c0: 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61  lite3BtreeRollba
85d0: 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ck;.      }.    
85e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 78 46 75  }else{.      xFu
85f0: 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  nc = sqlite3Btre
8600: 65 52 6f 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 7d  eRollback;.    }
8610: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66  .  }else{.    if
8620: 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f  ( p->rc==SQLITE_
8630: 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72 6f 72 41 63  OK || p->errorAc
8640: 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20 29 7b  tion==OE_Fail ){
8650: 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73  .      xFunc = s
8660: 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69  qlite3BtreeCommi
8670: 74 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c 73 65  tStmt;.    }else
8680: 20 69 66 28 20 70 2d 3e 65 72 72 6f 72 41 63 74   if( p->errorAct
8690: 69 6f 6e 3d 3d 4f 45 5f 41 62 6f 72 74 20 29 7b  ion==OE_Abort ){
86a0: 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73  .      xFunc = s
86b0: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62  qlite3BtreeRollb
86c0: 61 63 6b 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c  ackStmt;.    }el
86d0: 73 65 7b 0a 20 20 20 20 20 20 78 46 75 6e 63 20  se{.      xFunc 
86e0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f  = sqlite3BtreeRo
86f0: 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 20 20 64 62  llback;.      db
8700: 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31  ->autoCommit = 1
8710: 3b 0a 20 20 20 20 20 20 61 62 6f 72 74 4f 74 68  ;.      abortOth
8720: 65 72 41 63 74 69 76 65 56 64 62 65 73 28 70 29  erActiveVdbes(p)
8730: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
8740: 2a 20 49 66 20 78 46 75 6e 63 20 69 73 20 6e 6f  * If xFunc is no
8750: 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 74 20  t NULL, then it 
8760: 69 73 20 6f 6e 65 20 6f 66 20 73 71 6c 69 74 65  is one of sqlite
8770: 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 2c 0a  3BtreeRollback,.
8780: 20 20 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65    ** sqlite3Btre
8790: 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 20 6f 72  eRollbackStmt or
87a0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
87b0: 6d 69 74 53 74 6d 74 2e 20 43 61 6c 6c 20 69 74  mitStmt. Call it
87c0: 20 6f 6e 63 65 20 6f 6e 0a 20 20 2a 2a 20 65 61   once on.  ** ea
87d0: 63 68 20 62 61 63 6b 65 6e 64 2e 20 49 66 20 61  ch backend. If a
87e0: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61  n error occurs a
87f0: 6e 64 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f  nd the return co
8800: 64 65 20 69 73 20 73 74 69 6c 6c 0a 20 20 2a 2a  de is still.  **
8810: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 73 65 74 20   SQLITE_OK, set 
8820: 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20  the return code 
8830: 74 6f 20 74 68 65 20 6e 65 77 20 65 72 72 6f 72  to the new error
8840: 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 66   value..  */.  f
8850: 6f 72 28 69 3d 30 3b 20 78 46 75 6e 63 20 26 26  or(i=0; xFunc &&
8860: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
8870: 7b 20 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20  { .    int rc;. 
8880: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
8890: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
88a0: 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20      if( pBt ){. 
88b0: 20 20 20 20 20 72 63 20 3d 20 78 46 75 6e 63 28       rc = xFunc(
88c0: 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20  pBt);.      if( 
88d0: 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  p->rc==SQLITE_OK
88e0: 20 29 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20   ) p->rc = rc;. 
88f0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49     }.  }..  /* I
8900: 66 20 74 68 69 73 20 77 61 73 20 61 6e 20 49 4e  f this was an IN
8910: 53 45 52 54 2c 20 55 50 44 41 54 45 20 6f 72 20  SERT, UPDATE or 
8920: 44 45 4c 45 54 45 2c 20 73 65 74 20 74 68 65 20  DELETE, set the 
8930: 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20  change counter. 
8940: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 63 68 61 6e  */.  if( p->chan
8950: 67 65 43 6e 74 4f 6e 20 29 7b 0a 20 20 20 20 69  geCntOn ){.    i
8960: 66 28 20 21 78 46 75 6e 63 20 7c 7c 20 78 46 75  f( !xFunc || xFu
8970: 6e 63 3d 3d 73 71 6c 69 74 65 33 42 74 72 65 65  nc==sqlite3Btree
8980: 43 6f 6d 6d 69 74 53 74 6d 74 20 29 7b 0a 20 20  CommitStmt ){.  
8990: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
89a0: 65 74 43 68 61 6e 67 65 73 28 64 62 2c 20 70 2d  etChanges(db, p-
89b0: 3e 6e 43 68 61 6e 67 65 29 3b 0a 20 20 20 20 7d  >nChange);.    }
89c0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69  else{.      sqli
89d0: 74 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 65  te3VdbeSetChange
89e0: 73 28 64 62 2c 20 30 29 3b 0a 20 20 20 20 7d 0a  s(db, 0);.    }.
89f0: 20 20 20 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d      p->nChange =
8a00: 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 6f   0;.  }..  /* Ro
8a10: 6c 6c 62 61 63 6b 20 6f 72 20 63 6f 6d 6d 69 74  llback or commit
8a20: 20 61 6e 79 20 73 63 68 65 6d 61 20 63 68 61 6e   any schema chan
8a30: 67 65 73 20 74 68 61 74 20 6f 63 63 75 72 72 65  ges that occurre
8a40: 64 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 72  d. */.  if( p->r
8a50: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
8a60: 20 20 20 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62      sqlite3Rollb
8a70: 61 63 6b 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67  ackInternalChang
8a80: 65 73 28 64 62 29 3b 0a 20 20 7d 65 6c 73 65 20  es(db);.  }else 
8a90: 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20  if( db->flags & 
8aa0: 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61  SQLITE_InternCha
8ab0: 6e 67 65 73 20 29 7b 0a 20 20 20 20 73 71 6c 69  nges ){.    sqli
8ac0: 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61  te3CommitInterna
8ad0: 6c 43 68 61 6e 67 65 73 28 64 62 29 3b 0a 20 20  lChanges(db);.  
8ae0: 7d 0a 0a 20 20 2f 2a 20 57 65 20 68 61 76 65 20  }..  /* We have 
8af0: 73 75 63 63 65 73 73 66 75 6c 6c 79 20 68 61 6c  successfully hal
8b00: 74 65 64 20 61 6e 64 20 63 6c 6f 73 65 64 20 74  ted and closed t
8b10: 68 65 20 56 4d 2e 20 20 52 65 63 6f 72 64 20 74  he VM.  Record t
8b20: 68 69 73 20 66 61 63 74 2e 20 2a 2f 0a 20 20 69  his fact. */.  i
8b30: 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20  f( p->pc>=0 ){. 
8b40: 20 20 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62     db->activeVdb
8b50: 65 43 6e 74 2d 2d 3b 0a 20 20 7d 0a 20 20 70 2d  eCnt--;.  }.  p-
8b60: 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41  >magic = VDBE_MA
8b70: 47 49 43 5f 48 41 4c 54 3b 0a 20 20 63 68 65 63  GIC_HALT;.  chec
8b80: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64  kActiveVdbeCnt(d
8b90: 62 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 53 51  b);..  return SQ
8ba0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
8bb0: 2a 20 43 6c 65 61 6e 20 75 70 20 61 20 56 44 42  * Clean up a VDB
8bc0: 45 20 61 66 74 65 72 20 65 78 65 63 75 74 69 6f  E after executio
8bd0: 6e 20 62 75 74 20 64 6f 20 6e 6f 74 20 64 65 6c  n but do not del
8be0: 65 74 65 20 74 68 65 20 56 44 42 45 20 6a 75 73  ete the VDBE jus
8bf0: 74 20 79 65 74 2e 0a 2a 2a 20 57 72 69 74 65 20  t yet..** Write 
8c00: 61 6e 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67  any error messag
8c10: 65 73 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73  es into *pzErrMs
8c20: 67 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 72  g.  Return the r
8c30: 65 73 75 6c 74 20 63 6f 64 65 2e 0a 2a 2a 0a 2a  esult code..**.*
8c40: 2a 20 41 66 74 65 72 20 74 68 69 73 20 72 6f 75  * After this rou
8c50: 74 69 6e 65 20 69 73 20 72 75 6e 2c 20 74 68 65  tine is run, the
8c60: 20 56 44 42 45 20 73 68 6f 75 6c 64 20 62 65 20   VDBE should be 
8c70: 72 65 61 64 79 20 74 6f 20 62 65 20 65 78 65 63  ready to be exec
8c80: 75 74 65 64 0a 2a 2a 20 61 67 61 69 6e 2e 0a 2a  uted.** again..*
8c90: 2a 0a 2a 2a 20 54 6f 20 6c 6f 6f 6b 20 61 74 20  *.** To look at 
8ca0: 69 74 20 61 6e 6f 74 68 65 72 20 77 61 79 2c 20  it another way, 
8cb0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 73  this routine res
8cc0: 65 74 73 20 74 68 65 20 73 74 61 74 65 20 6f 66  ets the state of
8cd0: 20 74 68 65 0a 2a 2a 20 76 69 72 74 75 61 6c 20   the.** virtual 
8ce0: 6d 61 63 68 69 6e 65 20 66 72 6f 6d 20 56 44 42  machine from VDB
8cf0: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 6f 72 20 56  E_MAGIC_RUN or V
8d00: 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 62  DBE_MAGIC_HALT b
8d10: 61 63 6b 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d  ack to.** VDBE_M
8d20: 41 47 49 43 5f 49 4e 49 54 2e 0a 2a 2f 0a 69 6e  AGIC_INIT..*/.in
8d30: 74 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73  t sqlite3VdbeRes
8d40: 65 74 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69  et(Vdbe *p){.  i
8d50: 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42  f( p->magic!=VDB
8d60: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 70  E_MAGIC_RUN && p
8d70: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
8d80: 47 49 43 5f 48 41 4c 54 20 29 7b 0a 20 20 20 20  GIC_HALT ){.    
8d90: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e  sqlite3Error(p->
8da0: 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  db, SQLITE_MISUS
8db0: 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72  E, 0);.    retur
8dc0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
8dd0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68  .  }..  /* If th
8de0: 65 20 56 4d 20 64 69 64 20 6e 6f 74 20 72 75 6e  e VM did not run
8df0: 20 74 6f 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f   to completion o
8e00: 72 20 69 66 20 69 74 20 65 6e 63 6f 75 6e 74 65  r if it encounte
8e10: 72 65 64 20 61 6e 0a 20 20 2a 2a 20 65 72 72 6f  red an.  ** erro
8e20: 72 2c 20 74 68 65 6e 20 69 74 20 6d 69 67 68 74  r, then it might
8e30: 20 6e 6f 74 20 68 61 76 65 20 62 65 65 6e 20 68   not have been h
8e40: 61 6c 74 65 64 20 70 72 6f 70 65 72 6c 79 2e 20  alted properly. 
8e50: 20 53 6f 20 68 61 6c 74 0a 20 20 2a 2a 20 69 74   So halt.  ** it
8e60: 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c   now..  */.  sql
8e70: 69 74 65 33 56 64 62 65 48 61 6c 74 28 70 29 3b  ite3VdbeHalt(p);
8e80: 0a 0a 20 20 2f 2a 20 54 72 61 6e 73 66 65 72 20  ..  /* Transfer 
8e90: 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 61  the error code a
8ea0: 6e 64 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  nd error message
8eb0: 20 66 72 6f 6d 20 74 68 65 20 56 44 42 45 20 69   from the VDBE i
8ec0: 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 6d 61 69  nto the.  ** mai
8ed0: 6e 20 64 61 74 61 62 61 73 65 20 73 74 72 75 63  n database struc
8ee0: 74 75 72 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ture..  */.  if(
8ef0: 20 70 2d 3e 7a 45 72 72 4d 73 67 20 29 7b 0a 20   p->zErrMsg ){. 
8f00: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
8f10: 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 2c 20 22 25  p->db, p->rc, "%
8f20: 73 22 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 29 3b  s", p->zErrMsg);
8f30: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28  .    sqliteFree(
8f40: 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  p->zErrMsg);.   
8f50: 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b   p->zErrMsg = 0;
8f60: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e  .  }else if( p->
8f70: 72 63 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  rc ){.    sqlite
8f80: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d  3Error(p->db, p-
8f90: 3e 72 63 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65  >rc, 0);.  }else
8fa0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72  {.    sqlite3Err
8fb0: 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45  or(p->db, SQLITE
8fc0: 5f 4f 4b 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20  _OK, 0);.  }..  
8fd0: 2f 2a 20 52 65 63 6c 61 69 6d 20 61 6c 6c 20 6d  /* Reclaim all m
8fe0: 65 6d 6f 72 79 20 75 73 65 64 20 62 79 20 74 68  emory used by th
8ff0: 65 20 56 44 42 45 0a 20 20 2a 2f 0a 20 20 43 6c  e VDBE.  */.  Cl
9000: 65 61 6e 75 70 28 70 29 3b 0a 0a 20 20 2f 2a 20  eanup(p);..  /* 
9010: 53 61 76 65 20 70 72 6f 66 69 6c 69 6e 67 20 69  Save profiling i
9020: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20  nformation from 
9030: 74 68 69 73 20 56 44 42 45 20 72 75 6e 2e 0a 20  this VDBE run.. 
9040: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d   */.  assert( p-
9050: 3e 70 54 6f 73 3c 26 70 2d 3e 61 53 74 61 63 6b  >pTos<&p->aStack
9060: 5b 70 2d 3e 70 63 3c 30 3f 30 3a 70 2d 3e 70 63  [p->pc<0?0:p->pc
9070: 5d 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 61 6c  ] || sqlite3_mal
9080: 6c 6f 63 5f 66 61 69 6c 65 64 3d 3d 31 20 29 3b  loc_failed==1 );
9090: 0a 23 69 66 64 65 66 20 56 44 42 45 5f 50 52 4f  .#ifdef VDBE_PRO
90a0: 46 49 4c 45 0a 20 20 7b 0a 20 20 20 20 46 49 4c  FILE.  {.    FIL
90b0: 45 20 2a 6f 75 74 20 3d 20 66 6f 70 65 6e 28 22  E *out = fopen("
90c0: 76 64 62 65 5f 70 72 6f 66 69 6c 65 2e 6f 75 74  vdbe_profile.out
90d0: 22 2c 20 22 61 22 29 3b 0a 20 20 20 20 69 66 28  ", "a");.    if(
90e0: 20 6f 75 74 20 29 7b 0a 20 20 20 20 20 20 69 6e   out ){.      in
90f0: 74 20 69 3b 0a 20 20 20 20 20 20 66 70 72 69 6e  t i;.      fprin
9100: 74 66 28 6f 75 74 2c 20 22 2d 2d 2d 2d 20 22 29  tf(out, "---- ")
9110: 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b  ;.      for(i=0;
9120: 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b   i<p->nOp; i++){
9130: 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74 66  .        fprintf
9140: 28 6f 75 74 2c 20 22 25 30 32 78 22 2c 20 70 2d  (out, "%02x", p-
9150: 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f 64 65 29 3b  >aOp[i].opcode);
9160: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66  .      }.      f
9170: 70 72 69 6e 74 66 28 6f 75 74 2c 20 22 5c 6e 22  printf(out, "\n"
9180: 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30  );.      for(i=0
9190: 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29  ; i<p->nOp; i++)
91a0: 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74  {.        fprint
91b0: 66 28 6f 75 74 2c 20 22 25 36 64 20 25 31 30 6c  f(out, "%6d %10l
91c0: 6c 64 20 25 38 6c 6c 64 20 22 2c 0a 20 20 20 20  ld %8lld ",.    
91d0: 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d         p->aOp[i]
91e0: 2e 63 6e 74 2c 0a 20 20 20 20 20 20 20 20 20 20  .cnt,.          
91f0: 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65   p->aOp[i].cycle
9200: 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 2d  s,.           p-
9210: 3e 61 4f 70 5b 69 5d 2e 63 6e 74 3e 30 20 3f 20  >aOp[i].cnt>0 ? 
9220: 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73  p->aOp[i].cycles
9230: 2f 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 20 3a  /p->aOp[i].cnt :
9240: 20 30 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20   0.        );.  
9250: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
9260: 65 50 72 69 6e 74 4f 70 28 6f 75 74 2c 20 69 2c  ePrintOp(out, i,
9270: 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20 20   &p->aOp[i]);.  
9280: 20 20 20 20 7d 0a 20 20 20 20 20 20 66 63 6c 6f      }.      fclo
9290: 73 65 28 6f 75 74 29 3b 0a 20 20 20 20 7d 0a 20  se(out);.    }. 
92a0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 2d 3e 6d   }.#endif.  p->m
92b0: 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49  agic = VDBE_MAGI
92c0: 43 5f 49 4e 49 54 3b 0a 20 20 70 2d 3e 61 62 6f  C_INIT;.  p->abo
92d0: 72 74 65 64 20 3d 20 30 3b 0a 20 20 72 65 74 75  rted = 0;.  retu
92e0: 72 6e 20 70 2d 3e 72 63 3b 0a 7d 0a 20 0a 2f 2a  rn p->rc;.}. ./*
92f0: 0a 2a 2a 20 43 6c 65 61 6e 20 75 70 20 61 6e 64  .** Clean up and
9300: 20 64 65 6c 65 74 65 20 61 20 56 44 42 45 20 61   delete a VDBE a
9310: 66 74 65 72 20 65 78 65 63 75 74 69 6f 6e 2e 20  fter execution. 
9320: 20 52 65 74 75 72 6e 20 61 6e 20 69 6e 74 65 67   Return an integ
9330: 65 72 20 77 68 69 63 68 20 69 73 0a 2a 2a 20 74  er which is.** t
9340: 68 65 20 72 65 73 75 6c 74 20 63 6f 64 65 2e 20  he result code. 
9350: 20 57 72 69 74 65 20 61 6e 79 20 65 72 72 6f 72   Write any error
9360: 20 6d 65 73 73 61 67 65 20 74 65 78 74 20 69 6e   message text in
9370: 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a 2a 2f  to *pzErrMsg..*/
9380: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
9390: 46 69 6e 61 6c 69 7a 65 28 56 64 62 65 20 2a 70  Finalize(Vdbe *p
93a0: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
93b0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74  LITE_OK;.  sqlit
93c0: 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 62 3b 0a  e3 *db = p->db;.
93d0: 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 3d  .  if( p->magic=
93e0: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20  =VDBE_MAGIC_RUN 
93f0: 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  || p->magic==VDB
9400: 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 7b 0a  E_MAGIC_HALT ){.
9410: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
9420: 56 64 62 65 52 65 73 65 74 28 70 29 3b 0a 20 20  VdbeReset(p);.  
9430: 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6d 61 67  }else if( p->mag
9440: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49  ic!=VDBE_MAGIC_I
9450: 4e 49 54 20 29 7b 0a 20 20 20 20 2f 2a 20 73 71  NIT ){.    /* sq
9460: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62  lite3Error(p->db
9470: 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c  , SQLITE_MISUSE,
9480: 20 30 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 75   0); */.    retu
9490: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
94a0: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56  ;.  }.  sqlite3V
94b0: 64 62 65 44 65 6c 65 74 65 28 70 29 3b 0a 20 20  dbeDelete(p);.  
94c0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 53  if( rc==SQLITE_S
94d0: 43 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c  CHEMA ){.    sql
94e0: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61  ite3ResetInterna
94f0: 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a  lSchema(db, 0);.
9500: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
9510: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 74  .}../*.** Call t
9520: 68 65 20 64 65 73 74 72 75 63 74 6f 72 20 66 6f  he destructor fo
9530: 72 20 65 61 63 68 20 61 75 78 64 61 74 61 20 65  r each auxdata e
9540: 6e 74 72 79 20 69 6e 20 70 56 64 62 65 46 75 6e  ntry in pVdbeFun
9550: 63 20 66 6f 72 20 77 68 69 63 68 0a 2a 2a 20 74  c for which.** t
9560: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  he corresponding
9570: 20 62 69 74 20 69 6e 20 6d 61 73 6b 20 69 73 20   bit in mask is 
9580: 63 6c 65 61 72 2e 20 20 41 75 78 64 61 74 61 20  clear.  Auxdata 
9590: 65 6e 74 72 69 65 73 20 62 65 79 6f 6e 64 20 33  entries beyond 3
95a0: 31 0a 2a 2a 20 61 72 65 20 61 6c 77 61 79 73 20  1.** are always 
95b0: 64 65 73 74 72 6f 79 65 64 2e 20 20 54 6f 20 64  destroyed.  To d
95c0: 65 73 74 72 6f 79 20 61 6c 6c 20 61 75 78 64 61  estroy all auxda
95d0: 74 61 20 65 6e 74 72 69 65 73 2c 20 63 61 6c 6c  ta entries, call
95e0: 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65   this.** routine
95f0: 20 77 69 74 68 20 6d 61 73 6b 3d 3d 30 2e 0a 2a   with mask==0..*
9600: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
9610: 62 65 44 65 6c 65 74 65 41 75 78 44 61 74 61 28  beDeleteAuxData(
9620: 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46  VdbeFunc *pVdbeF
9630: 75 6e 63 2c 20 69 6e 74 20 6d 61 73 6b 29 7b 0a  unc, int mask){.
9640: 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69    int i;.  for(i
9650: 3d 30 3b 20 69 3c 70 56 64 62 65 46 75 6e 63 2d  =0; i<pVdbeFunc-
9660: 3e 6e 41 75 78 3b 20 69 2b 2b 29 7b 0a 20 20 20  >nAux; i++){.   
9670: 20 73 74 72 75 63 74 20 41 75 78 44 61 74 61 20   struct AuxData 
9680: 2a 70 41 75 78 20 3d 20 26 70 56 64 62 65 46 75  *pAux = &pVdbeFu
9690: 6e 63 2d 3e 61 70 41 75 78 5b 69 5d 3b 0a 20 20  nc->apAux[i];.  
96a0: 20 20 69 66 28 20 28 69 3e 33 31 20 7c 7c 20 21    if( (i>31 || !
96b0: 28 6d 61 73 6b 26 28 31 3c 3c 69 29 29 29 20 26  (mask&(1<<i))) &
96c0: 26 20 70 41 75 78 2d 3e 70 41 75 78 20 29 7b 0a  & pAux->pAux ){.
96d0: 20 20 20 20 20 20 69 66 28 20 70 41 75 78 2d 3e        if( pAux->
96e0: 78 44 65 6c 65 74 65 20 29 7b 0a 20 20 20 20 20  xDelete ){.     
96f0: 20 20 20 70 41 75 78 2d 3e 78 44 65 6c 65 74 65     pAux->xDelete
9700: 28 70 41 75 78 2d 3e 70 41 75 78 29 3b 0a 20 20  (pAux->pAux);.  
9710: 20 20 20 20 7d 0a 20 20 20 20 20 20 70 41 75 78      }.      pAux
9720: 2d 3e 70 41 75 78 20 3d 20 30 3b 0a 20 20 20 20  ->pAux = 0;.    
9730: 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44  }.  }.}../*.** D
9740: 65 6c 65 74 65 20 61 6e 20 65 6e 74 69 72 65 20  elete an entire 
9750: 56 44 42 45 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  VDBE..*/.void sq
9760: 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74 65 28  lite3VdbeDelete(
9770: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20  Vdbe *p){.  int 
9780: 69 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20  i;.  if( p==0 ) 
9790: 72 65 74 75 72 6e 3b 0a 20 20 43 6c 65 61 6e 75  return;.  Cleanu
97a0: 70 28 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70  p(p);.  if( p->p
97b0: 50 72 65 76 20 29 7b 0a 20 20 20 20 70 2d 3e 70  Prev ){.    p->p
97c0: 50 72 65 76 2d 3e 70 4e 65 78 74 20 3d 20 70 2d  Prev->pNext = p-
97d0: 3e 70 4e 65 78 74 3b 0a 20 20 7d 65 6c 73 65 7b  >pNext;.  }else{
97e0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
97f0: 64 62 2d 3e 70 56 64 62 65 3d 3d 70 20 29 3b 0a  db->pVdbe==p );.
9800: 20 20 20 20 70 2d 3e 64 62 2d 3e 70 56 64 62 65      p->db->pVdbe
9810: 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d   = p->pNext;.  }
9820: 0a 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20  .  if( p->pNext 
9830: 29 7b 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 2d  ){.    p->pNext-
9840: 3e 70 50 72 65 76 20 3d 20 70 2d 3e 70 50 72 65  >pPrev = p->pPre
9850: 76 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e  v;.  }.  if( p->
9860: 61 4f 70 20 29 7b 0a 20 20 20 20 66 6f 72 28 69  aOp ){.    for(i
9870: 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b  =0; i<p->nOp; i+
9880: 2b 29 7b 0a 20 20 20 20 20 20 4f 70 20 2a 70 4f  +){.      Op *pO
9890: 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b 0a  p = &p->aOp[i];.
98a0: 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70        if( pOp->p
98b0: 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49  3type==P3_DYNAMI
98c0: 43 20 7c 7c 20 70 4f 70 2d 3e 70 33 74 79 70 65  C || pOp->p3type
98d0: 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 29 7b 0a  ==P3_KEYINFO ){.
98e0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72          sqliteFr
98f0: 65 65 28 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20  ee(pOp->p3);.   
9900: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70     }.      if( p
9910: 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 56  Op->p3type==P3_V
9920: 44 42 45 46 55 4e 43 20 29 7b 0a 20 20 20 20 20  DBEFUNC ){.     
9930: 20 20 20 56 64 62 65 46 75 6e 63 20 2a 70 56 64     VdbeFunc *pVd
9940: 62 65 46 75 6e 63 20 3d 20 28 56 64 62 65 46 75  beFunc = (VdbeFu
9950: 6e 63 20 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20  nc *)pOp->p3;.  
9960: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
9970: 65 44 65 6c 65 74 65 41 75 78 44 61 74 61 28 70  eDeleteAuxData(p
9980: 56 64 62 65 46 75 6e 63 2c 20 30 29 3b 0a 20 20  VdbeFunc, 0);.  
9990: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
99a0: 28 70 56 64 62 65 46 75 6e 63 29 3b 0a 20 20 20  (pVdbeFunc);.   
99b0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73     }.    }.    s
99c0: 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 4f 70  qliteFree(p->aOp
99d0: 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65  );.  }.  release
99e0: 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 56 61 72  MemArray(p->aVar
99f0: 2c 20 70 2d 3e 6e 56 61 72 29 3b 0a 20 20 73 71  , p->nVar);.  sq
9a00: 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 4c 61 62  liteFree(p->aLab
9a10: 65 6c 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65  el);.  sqliteFre
9a20: 65 28 70 2d 3e 61 53 74 61 63 6b 29 3b 0a 20 20  e(p->aStack);.  
9a30: 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28  releaseMemArray(
9a40: 70 2d 3e 61 43 6f 6c 4e 61 6d 65 2c 20 70 2d 3e  p->aColName, p->
9a50: 6e 52 65 73 43 6f 6c 75 6d 6e 2a 32 29 3b 0a 20  nResColumn*2);. 
9a60: 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61   sqliteFree(p->a
9a70: 43 6f 6c 4e 61 6d 65 29 3b 0a 20 20 70 2d 3e 6d  ColName);.  p->m
9a80: 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49  agic = VDBE_MAGI
9a90: 43 5f 44 45 41 44 3b 0a 20 20 73 71 6c 69 74 65  C_DEAD;.  sqlite
9aa0: 46 72 65 65 28 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  Free(p);.}../*.*
9ab0: 2a 20 49 66 20 61 20 4d 6f 76 65 54 6f 20 6f 70  * If a MoveTo op
9ac0: 65 72 61 74 69 6f 6e 20 69 73 20 70 65 6e 64 69  eration is pendi
9ad0: 6e 67 20 6f 6e 20 74 68 65 20 67 69 76 65 6e 20  ng on the given 
9ae0: 63 75 72 73 6f 72 2c 20 74 68 65 6e 20 64 6f 20  cursor, then do 
9af0: 74 68 61 74 0a 2a 2a 20 4d 6f 76 65 54 6f 20 6e  that.** MoveTo n
9b00: 6f 77 2e 20 20 52 65 74 75 72 6e 20 61 6e 20 65  ow.  Return an e
9b10: 72 72 6f 72 20 63 6f 64 65 2e 20 20 49 66 20 6e  rror code.  If n
9b20: 6f 20 4d 6f 76 65 54 6f 20 69 73 20 70 65 6e 64  o MoveTo is pend
9b30: 69 6e 67 2c 20 74 68 69 73 0a 2a 2a 20 72 6f 75  ing, this.** rou
9b40: 74 69 6e 65 20 64 6f 65 73 20 6e 6f 74 68 69 6e  tine does nothin
9b50: 67 20 61 6e 64 20 72 65 74 75 72 6e 73 20 53 51  g and returns SQ
9b60: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 69 6e 74 20  LITE_OK..*/.int 
9b70: 73 71 6c 69 74 65 33 56 64 62 65 43 75 72 73 6f  sqlite3VdbeCurso
9b80: 72 4d 6f 76 65 74 6f 28 43 75 72 73 6f 72 20 2a  rMoveto(Cursor *
9b90: 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e 64 65 66  p){.  if( p->def
9ba0: 65 72 72 65 64 4d 6f 76 65 74 6f 20 29 7b 0a 20  erredMoveto ){. 
9bb0: 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20 20 20     int res;.    
9bc0: 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74  extern int sqlit
9bd0: 65 33 5f 73 65 61 72 63 68 5f 63 6f 75 6e 74 3b  e3_search_count;
9be0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
9bf0: 69 6e 74 4b 65 79 20 29 3b 0a 20 20 20 20 69 66  intKey );.    if
9c00: 28 20 70 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20  ( p->intKey ){. 
9c10: 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65       sqlite3Btre
9c20: 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73  eMoveto(p->pCurs
9c30: 6f 72 2c 20 30 2c 20 70 2d 3e 6d 6f 76 65 74 6f  or, 0, p->moveto
9c40: 54 61 72 67 65 74 2c 20 26 72 65 73 29 3b 0a 20  Target, &res);. 
9c50: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
9c60: 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65  sqlite3BtreeMove
9c70: 74 6f 28 70 2d 3e 70 43 75 72 73 6f 72 2c 28 63  to(p->pCursor,(c
9c80: 68 61 72 2a 29 26 70 2d 3e 6d 6f 76 65 74 6f 54  har*)&p->movetoT
9c90: 61 72 67 65 74 2c 73 69 7a 65 6f 66 28 69 36 34  arget,sizeof(i64
9ca0: 29 2c 26 72 65 73 29 3b 0a 20 20 20 20 7d 0a 20  ),&res);.    }. 
9cb0: 20 20 20 2a 70 2d 3e 70 49 6e 63 72 4b 65 79 20     *p->pIncrKey 
9cc0: 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 6c 61 73 74  = 0;.    p->last
9cd0: 52 65 63 6e 6f 20 3d 20 6b 65 79 54 6f 49 6e 74  Recno = keyToInt
9ce0: 28 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74  (p->movetoTarget
9cf0: 29 3b 0a 20 20 20 20 70 2d 3e 72 65 63 6e 6f 49  );.    p->recnoI
9d00: 73 56 61 6c 69 64 20 3d 20 72 65 73 3d 3d 30 3b  sValid = res==0;
9d10: 0a 20 20 20 20 69 66 28 20 72 65 73 3c 30 20 29  .    if( res<0 )
9d20: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42  {.      sqlite3B
9d30: 74 72 65 65 4e 65 78 74 28 70 2d 3e 70 43 75 72  treeNext(p->pCur
9d40: 73 6f 72 2c 20 26 72 65 73 29 3b 0a 20 20 20 20  sor, &res);.    
9d50: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 65  }.    sqlite3_se
9d60: 61 72 63 68 5f 63 6f 75 6e 74 2b 2b 3b 0a 20 20  arch_count++;.  
9d70: 20 20 70 2d 3e 64 65 66 65 72 72 65 64 4d 6f 76    p->deferredMov
9d80: 65 74 6f 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e  eto = 0;.    p->
9d90: 63 61 63 68 65 56 61 6c 69 64 20 3d 20 30 3b 0a  cacheValid = 0;.
9da0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c    }.  return SQL
9db0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
9dc0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66   The following f
9dd0: 75 6e 63 74 69 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20  unctions:.**.** 
9de0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
9df0: 6c 54 79 70 65 28 29 0a 2a 2a 20 73 71 6c 69 74  lType().** sqlit
9e00: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
9e10: 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33  Len().** sqlite3
9e20: 56 64 62 65 53 65 72 69 61 6c 52 65 61 64 28 29  VdbeSerialRead()
9e30: 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53  .** sqlite3VdbeS
9e40: 65 72 69 61 6c 4c 65 6e 28 29 0a 2a 2a 20 73 71  erialLen().** sq
9e50: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 57  lite3VdbeSerialW
9e60: 72 69 74 65 28 29 0a 2a 2a 0a 2a 2a 20 65 6e 63  rite().**.** enc
9e70: 61 70 73 75 6c 61 74 65 20 74 68 65 20 63 6f 64  apsulate the cod
9e80: 65 20 74 68 61 74 20 73 65 72 69 61 6c 69 7a 65  e that serialize
9e90: 73 20 76 61 6c 75 65 73 20 66 6f 72 20 73 74 6f  s values for sto
9ea0: 72 61 67 65 20 69 6e 20 53 51 4c 69 74 65 0a 2a  rage in SQLite.*
9eb0: 2a 20 64 61 74 61 20 61 6e 64 20 69 6e 64 65 78  * data and index
9ec0: 20 72 65 63 6f 72 64 73 2e 20 45 61 63 68 20 73   records. Each s
9ed0: 65 72 69 61 6c 69 7a 65 64 20 76 61 6c 75 65 20  erialized value 
9ee0: 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 0a 2a 2a  consists of a.**
9ef0: 20 27 73 65 72 69 61 6c 2d 74 79 70 65 27 20 61   'serial-type' a
9f00: 6e 64 20 61 20 62 6c 6f 62 20 6f 66 20 64 61 74  nd a blob of dat
9f10: 61 2e 20 54 68 65 20 73 65 72 69 61 6c 20 74 79  a. The serial ty
9f20: 70 65 20 69 73 20 61 6e 20 38 2d 62 79 74 65 20  pe is an 8-byte 
9f30: 75 6e 73 69 67 6e 65 64 0a 2a 2a 20 69 6e 74 65  unsigned.** inte
9f40: 67 65 72 2c 20 73 74 6f 72 65 64 20 61 73 20 61  ger, stored as a
9f50: 20 76 61 72 69 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49   varint..**.** I
9f60: 6e 20 61 6e 20 53 51 4c 69 74 65 20 69 6e 64 65  n an SQLite inde
9f70: 78 20 72 65 63 6f 72 64 2c 20 74 68 65 20 73 65  x record, the se
9f80: 72 69 61 6c 20 74 79 70 65 20 69 73 20 73 74 6f  rial type is sto
9f90: 72 65 64 20 64 69 72 65 63 74 6c 79 20 62 65 66  red directly bef
9fa0: 6f 72 65 0a 2a 2a 20 74 68 65 20 62 6c 6f 62 20  ore.** the blob 
9fb0: 6f 66 20 64 61 74 61 20 74 68 61 74 20 69 74 20  of data that it 
9fc0: 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 2e 20  corresponds to. 
9fd0: 49 6e 20 61 20 74 61 62 6c 65 20 72 65 63 6f 72  In a table recor
9fe0: 64 2c 20 61 6c 6c 20 73 65 72 69 61 6c 0a 2a 2a  d, all serial.**
9ff0: 20 74 79 70 65 73 20 61 72 65 20 73 74 6f 72 65   types are store
a000: 64 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f  d at the start o
a010: 66 20 74 68 65 20 72 65 63 6f 72 64 2c 20 61 6e  f the record, an
a020: 64 20 74 68 65 20 62 6c 6f 62 73 20 6f 66 20 64  d the blobs of d
a030: 61 74 61 20 61 74 0a 2a 2a 20 74 68 65 20 65 6e  ata at.** the en
a040: 64 2e 20 48 65 6e 63 65 20 74 68 65 73 65 20 66  d. Hence these f
a050: 75 6e 63 74 69 6f 6e 73 20 61 6c 6c 6f 77 20 74  unctions allow t
a060: 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 68 61 6e  he caller to han
a070: 64 6c 65 20 74 68 65 0a 2a 2a 20 73 65 72 69 61  dle the.** seria
a080: 6c 2d 74 79 70 65 20 61 6e 64 20 64 61 74 61 20  l-type and data 
a090: 62 6c 6f 62 20 73 65 70 65 72 61 74 65 6c 79 2e  blob seperately.
a0a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f  .**.** The follo
a0b0: 77 69 6e 67 20 74 61 62 6c 65 20 64 65 73 63 72  wing table descr
a0c0: 69 62 65 73 20 74 68 65 20 76 61 72 69 6f 75 73  ibes the various
a0d0: 20 73 74 6f 72 61 67 65 20 63 6c 61 73 73 65 73   storage classes
a0e0: 20 66 6f 72 20 64 61 74 61 3a 0a 2a 2a 0a 2a 2a   for data:.**.**
a0f0: 20 20 20 73 65 72 69 61 6c 20 74 79 70 65 20 20     serial type  
a100: 20 20 20 20 20 20 62 79 74 65 73 20 6f 66 20 64        bytes of d
a110: 61 74 61 20 20 20 20 20 20 74 79 70 65 0a 2a 2a  ata      type.**
a120: 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d     -------------
a130: 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  -     ----------
a140: 2d 2d 2d 2d 2d 20 20 20 20 2d 2d 2d 2d 2d 2d 2d  -----    -------
a150: 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20  --------.**     
a160: 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20   0              
a170: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20         0        
a180: 20 20 20 20 4e 55 4c 4c 0a 2a 2a 20 20 20 20 20      NULL.**     
a190: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20   1              
a1a0: 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20         1        
a1b0: 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67      signed integ
a1c0: 65 72 0a 2a 2a 20 20 20 20 20 20 32 20 20 20 20  er.**      2    
a1d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a1e0: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 73 69   2            si
a1f0: 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20  gned integer.** 
a200: 20 20 20 20 20 33 20 20 20 20 20 20 20 20 20 20       3          
a210: 20 20 20 20 20 20 20 20 20 20 20 33 20 20 20 20             3    
a220: 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69          signed i
a230: 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 34  nteger.**      4
a240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a250: 20 20 20 20 20 34 20 20 20 20 20 20 20 20 20 20       4          
a260: 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72    signed integer
a270: 0a 2a 2a 20 20 20 20 20 20 35 20 20 20 20 20 20  .**      5      
a280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 36                 6
a290: 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67 6e              sign
a2a0: 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20  ed integer.**   
a2b0: 20 20 20 36 20 20 20 20 20 20 20 20 20 20 20 20     6            
a2c0: 20 20 20 20 20 20 20 20 20 38 20 20 20 20 20 20           8      
a2d0: 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74        signed int
a2e0: 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 37 20 20  eger.**      7  
a2f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a300: 20 20 20 38 20 20 20 20 20 20 20 20 20 20 20 20     8            
a310: 49 45 45 45 20 66 6c 6f 61 74 0a 2a 2a 20 20 20  IEEE float.**   
a320: 20 20 38 2d 31 31 20 20 20 20 20 20 20 20 20 20    8-11          
a330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a340: 20 20 20 20 20 20 72 65 73 65 72 76 65 64 20 66        reserved f
a350: 6f 72 20 65 78 70 61 6e 73 69 6f 6e 0a 2a 2a 20  or expansion.** 
a360: 20 20 20 4e 3e 3d 31 32 20 61 6e 64 20 65 76 65     N>=12 and eve
a370: 6e 20 20 20 20 20 20 20 28 4e 2d 31 32 29 2f 32  n       (N-12)/2
a380: 20 20 20 20 20 20 20 20 42 4c 4f 42 0a 2a 2a 20          BLOB.** 
a390: 20 20 20 4e 3e 3d 31 33 20 61 6e 64 20 6f 64 64     N>=13 and odd
a3a0: 20 20 20 20 20 20 20 20 28 4e 2d 31 33 29 2f 32          (N-13)/2
a3b0: 20 20 20 20 20 20 20 20 74 65 78 74 0a 2a 2a 0a          text.**.
a3c0: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  */../*.** Return
a3d0: 20 74 68 65 20 73 65 72 69 61 6c 2d 74 79 70 65   the serial-type
a3e0: 20 66 6f 72 20 74 68 65 20 76 61 6c 75 65 20 73   for the value s
a3f0: 74 6f 72 65 64 20 69 6e 20 70 4d 65 6d 2e 0a 2a  tored in pMem..*
a400: 2f 0a 75 33 32 20 73 71 6c 69 74 65 33 56 64 62  /.u32 sqlite3Vdb
a410: 65 53 65 72 69 61 6c 54 79 70 65 28 4d 65 6d 20  eSerialType(Mem 
a420: 2a 70 4d 65 6d 29 7b 0a 20 20 69 6e 74 20 66 6c  *pMem){.  int fl
a430: 61 67 73 20 3d 20 70 4d 65 6d 2d 3e 66 6c 61 67  ags = pMem->flag
a440: 73 3b 0a 0a 20 20 69 66 28 20 66 6c 61 67 73 26  s;..  if( flags&
a450: 4d 45 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20 20 20  MEM_Null ){.    
a460: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
a470: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 49 6e  if( flags&MEM_In
a480: 74 20 29 7b 0a 20 20 20 20 2f 2a 20 46 69 67 75  t ){.    /* Figu
a490: 72 65 20 6f 75 74 20 77 68 65 74 68 65 72 20 74  re out whether t
a4a0: 6f 20 75 73 65 20 31 2c 20 32 2c 20 34 20 6f 72  o use 1, 2, 4 or
a4b0: 20 38 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 20   8 bytes. */.   
a4c0: 20 69 36 34 20 69 20 3d 20 70 4d 65 6d 2d 3e 69   i64 i = pMem->i
a4d0: 3b 0a 20 20 20 20 69 66 28 20 69 3e 3d 2d 31 32  ;.    if( i>=-12
a4e0: 37 20 26 26 20 69 3c 3d 31 32 37 20 29 20 72 65  7 && i<=127 ) re
a4f0: 74 75 72 6e 20 31 3b 0a 20 20 20 20 69 66 28 20  turn 1;.    if( 
a500: 69 3e 3d 2d 33 32 37 36 37 20 26 26 20 69 3c 3d  i>=-32767 && i<=
a510: 33 32 37 36 37 20 29 20 72 65 74 75 72 6e 20 32  32767 ) return 2
a520: 3b 0a 20 20 20 20 69 66 28 20 69 3e 3d 2d 38 33  ;.    if( i>=-83
a530: 38 38 36 30 37 20 26 26 20 69 3c 3d 38 33 38 38  88607 && i<=8388
a540: 36 30 37 20 29 20 72 65 74 75 72 6e 20 33 3b 0a  607 ) return 3;.
a550: 20 20 20 20 69 66 28 20 69 3e 3d 2d 32 31 34 37      if( i>=-2147
a560: 34 38 33 36 34 37 20 26 26 20 69 3c 3d 32 31 34  483647 && i<=214
a570: 37 34 38 33 36 34 37 20 29 20 72 65 74 75 72 6e  7483647 ) return
a580: 20 34 3b 0a 20 20 20 20 69 66 28 20 69 3e 3d 2d   4;.    if( i>=-
a590: 31 34 30 37 33 37 34 38 38 33 35 35 33 32 38 4c  140737488355328L
a5a0: 20 26 26 20 69 3c 3d 31 34 30 37 33 37 34 38 38   && i<=140737488
a5b0: 33 35 35 33 32 38 4c 20 29 20 72 65 74 75 72 6e  355328L ) return
a5c0: 20 35 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 36   5;.    return 6
a5d0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67  ;.  }.  if( flag
a5e0: 73 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a 20 20  s&MEM_Real ){.  
a5f0: 20 20 72 65 74 75 72 6e 20 37 3b 0a 20 20 7d 0a    return 7;.  }.
a600: 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f    if( flags&MEM_
a610: 53 74 72 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e  Str ){.    int n
a620: 20 3d 20 70 4d 65 6d 2d 3e 6e 3b 0a 20 20 20 20   = pMem->n;.    
a630: 61 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b 0a  assert( n>=0 );.
a640: 20 20 20 20 72 65 74 75 72 6e 20 28 28 6e 2a 32      return ((n*2
a650: 29 20 2b 20 31 33 29 3b 0a 20 20 7d 0a 20 20 69  ) + 13);.  }.  i
a660: 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 42 6c 6f  f( flags&MEM_Blo
a670: 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  b ){.    return 
a680: 28 70 4d 65 6d 2d 3e 6e 2a 32 20 2b 20 31 32 29  (pMem->n*2 + 12)
a690: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30  ;.  }.  return 0
a6a0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
a6b0: 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66 20  n the length of 
a6c0: 74 68 65 20 64 61 74 61 20 63 6f 72 72 65 73 70  the data corresp
a6d0: 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 73 75  onding to the su
a6e0: 70 70 6c 69 65 64 20 73 65 72 69 61 6c 2d 74 79  pplied serial-ty
a6f0: 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  pe..*/.int sqlit
a700: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
a710: 4c 65 6e 28 75 33 32 20 73 65 72 69 61 6c 5f 74  Len(u32 serial_t
a720: 79 70 65 29 7b 0a 20 20 69 66 28 20 73 65 72 69  ype){.  if( seri
a730: 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b 0a 20  al_type>=12 ){. 
a740: 20 20 20 72 65 74 75 72 6e 20 28 73 65 72 69 61     return (seria
a750: 6c 5f 74 79 70 65 2d 31 32 29 2f 32 3b 0a 20 20  l_type-12)/2;.  
a760: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 61 74 69  }else{.    stati
a770: 63 20 63 6f 6e 73 74 20 75 38 20 61 53 69 7a 65  c const u8 aSize
a780: 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c 20 32 2c 20  [] = { 0, 1, 2, 
a790: 33 2c 20 34 2c 20 36 2c 20 38 2c 20 38 2c 20 30  3, 4, 6, 8, 8, 0
a7a0: 2c 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 20 20 20  , 0, 0, 0 };.   
a7b0: 20 72 65 74 75 72 6e 20 61 53 69 7a 65 5b 73 65   return aSize[se
a7c0: 72 69 61 6c 5f 74 79 70 65 5d 3b 0a 20 20 7d 0a  rial_type];.  }.
a7d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 74  }../*.** Write t
a7e0: 68 65 20 73 65 72 69 61 6c 69 7a 65 64 20 64 61  he serialized da
a7f0: 74 61 20 62 6c 6f 62 20 66 6f 72 20 74 68 65 20  ta blob for the 
a800: 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 20  value stored in 
a810: 70 4d 65 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62 75  pMem into .** bu
a820: 66 2e 20 49 74 20 69 73 20 61 73 73 75 6d 65 64  f. It is assumed
a830: 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72   that the caller
a840: 20 68 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 73   has allocated s
a850: 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65 2e  ufficient space.
a860: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
a870: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 77  umber of bytes w
a880: 72 69 74 74 65 6e 2e 0a 2a 2f 20 0a 69 6e 74 20  ritten..*/ .int 
a890: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
a8a0: 6c 50 75 74 28 75 6e 73 69 67 6e 65 64 20 63 68  lPut(unsigned ch
a8b0: 61 72 20 2a 62 75 66 2c 20 4d 65 6d 20 2a 70 4d  ar *buf, Mem *pM
a8c0: 65 6d 29 7b 0a 20 20 75 33 32 20 73 65 72 69 61  em){.  u32 seria
a8d0: 6c 5f 74 79 70 65 20 3d 20 73 71 6c 69 74 65 33  l_type = sqlite3
a8e0: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28 70  VdbeSerialType(p
a8f0: 4d 65 6d 29 3b 0a 20 20 69 6e 74 20 6c 65 6e 3b  Mem);.  int len;
a900: 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a 20  ..  /* NULL */. 
a910: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
a920: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ==0 ){.    retur
a930: 6e 20 30 3b 0a 20 20 7d 0a 20 0a 20 20 2f 2a 20  n 0;.  }. .  /* 
a940: 49 6e 74 65 67 65 72 20 61 6e 64 20 52 65 61 6c  Integer and Real
a950: 20 2a 2f 0a 20 20 69 66 28 20 73 65 72 69 61 6c   */.  if( serial
a960: 5f 74 79 70 65 3c 3d 37 20 29 7b 0a 20 20 20 20  _type<=7 ){.    
a970: 75 36 34 20 76 3b 0a 20 20 20 20 69 6e 74 20 69  u64 v;.    int i
a980: 3b 0a 20 20 20 20 69 66 28 20 73 65 72 69 61 6c  ;.    if( serial
a990: 5f 74 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20 20  _type==7 ){.    
a9a0: 20 20 76 20 3d 20 2a 28 75 36 34 2a 29 26 70 4d    v = *(u64*)&pM
a9b0: 65 6d 2d 3e 72 3b 0a 20 20 20 20 7d 65 6c 73 65  em->r;.    }else
a9c0: 7b 0a 20 20 20 20 20 20 76 20 3d 20 2a 28 75 36  {.      v = *(u6
a9d0: 34 2a 29 26 70 4d 65 6d 2d 3e 69 3b 0a 20 20 20  4*)&pMem->i;.   
a9e0: 20 7d 0a 20 20 20 20 6c 65 6e 20 3d 20 69 20 3d   }.    len = i =
a9f0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
aa00: 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c  alTypeLen(serial
aa10: 5f 74 79 70 65 29 3b 0a 20 20 20 20 77 68 69 6c  _type);.    whil
aa20: 65 28 20 69 2d 2d 20 29 7b 0a 20 20 20 20 20 20  e( i-- ){.      
aa30: 62 75 66 5b 69 5d 20 3d 20 28 76 26 30 78 46 46  buf[i] = (v&0xFF
aa40: 29 3b 0a 20 20 20 20 20 20 76 20 3e 3e 3d 20 38  );.      v >>= 8
aa50: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75  ;.    }.    retu
aa60: 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a 20 20 0a 20  rn len;.  }.  . 
aa70: 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72 20 62 6c   /* String or bl
aa80: 6f 62 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  ob */.  assert( 
aa90: 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20  serial_type>=12 
aaa0: 29 3b 0a 20 20 6c 65 6e 20 3d 20 73 71 6c 69 74  );.  len = sqlit
aab0: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
aac0: 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 29  Len(serial_type)
aad0: 3b 0a 20 20 6d 65 6d 63 70 79 28 62 75 66 2c 20  ;.  memcpy(buf, 
aae0: 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29 3b 0a 20  pMem->z, len);. 
aaf0: 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 7d 0a 0a   return len;.}..
ab00: 2f 2a 0a 2a 2a 20 44 65 73 65 72 69 61 6c 69 7a  /*.** Deserializ
ab10: 65 20 74 68 65 20 64 61 74 61 20 62 6c 6f 62 20  e the data blob 
ab20: 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 62 75  pointed to by bu
ab30: 66 20 61 73 20 73 65 72 69 61 6c 20 74 79 70 65  f as serial type
ab40: 20 73 65 72 69 61 6c 5f 74 79 70 65 0a 2a 2a 20   serial_type.** 
ab50: 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 72 65  and store the re
ab60: 73 75 6c 74 20 69 6e 20 70 4d 65 6d 2e 20 20 52  sult in pMem.  R
ab70: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
ab80: 20 6f 66 20 62 79 74 65 73 20 72 65 61 64 2e 0a   of bytes read..
ab90: 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  */ .int sqlite3V
aba0: 64 62 65 53 65 72 69 61 6c 47 65 74 28 0a 20 20  dbeSerialGet(.  
abb0: 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63  const unsigned c
abc0: 68 61 72 20 2a 62 75 66 2c 20 20 20 20 20 2f 2a  har *buf,     /*
abd0: 20 42 75 66 66 65 72 20 74 6f 20 64 65 73 65 72   Buffer to deser
abe0: 69 61 6c 69 7a 65 20 66 72 6f 6d 20 2a 2f 0a 20  ialize from */. 
abf0: 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65   u32 serial_type
ac00: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
ac10: 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 74 6f  * Serial type to
ac20: 20 64 65 73 65 72 69 61 6c 69 7a 65 20 2a 2f 0a   deserialize */.
ac30: 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 20 20 20 20    Mem *pMem     
ac40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ac50: 2f 2a 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20 74  /* Memory cell t
ac60: 6f 20 77 72 69 74 65 20 76 61 6c 75 65 20 69 6e  o write value in
ac70: 74 6f 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6c  to */.){.  int l
ac80: 65 6e 3b 0a 0a 20 20 69 66 28 20 73 65 72 69 61  en;..  if( seria
ac90: 6c 5f 74 79 70 65 3d 3d 30 20 29 7b 0a 20 20 20  l_type==0 ){.   
aca0: 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20 20   /* NULL */.    
acb0: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
acc0: 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 72 65 74 75  M_Null;.    retu
acd0: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 6c 65 6e 20  rn 0;.  }.  len 
ace0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
acf0: 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61  ialTypeLen(seria
ad00: 6c 5f 74 79 70 65 29 3b 0a 20 20 69 66 28 20 73  l_type);.  if( s
ad10: 65 72 69 61 6c 5f 74 79 70 65 3c 3d 37 20 29 7b  erial_type<=7 ){
ad20: 0a 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20  .    /* Integer 
ad30: 61 6e 64 20 52 65 61 6c 20 2a 2f 0a 20 20 20 20  and Real */.    
ad40: 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3c  if( serial_type<
ad50: 3d 34 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 33  =4 ){.      /* 3
ad60: 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 74 79  2-bit integer ty
ad70: 70 65 2e 20 20 54 68 69 73 20 69 73 20 68 61 6e  pe.  This is han
ad80: 64 6c 65 64 20 62 79 20 61 20 73 70 65 63 69 61  dled by a specia
ad90: 6c 20 63 61 73 65 20 66 6f 72 0a 20 20 20 20 20  l case for.     
ada0: 20 2a 2a 20 70 65 72 66 6f 72 6d 61 6e 63 65 20   ** performance 
adb0: 72 65 61 73 6f 6e 73 2e 20 2a 2f 0a 20 20 20 20  reasons. */.    
adc0: 20 20 69 6e 74 20 76 20 3d 20 62 75 66 5b 30 5d    int v = buf[0]
add0: 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 3b 0a 20  ;.      int n;. 
ade0: 20 20 20 20 20 69 66 28 20 76 26 30 78 38 30 20       if( v&0x80 
adf0: 29 7b 0a 20 20 20 20 20 20 20 20 76 20 7c 3d 20  ){.        v |= 
ae00: 2d 32 35 36 3b 0a 20 20 20 20 20 20 7d 0a 20 20  -256;.      }.  
ae10: 20 20 20 20 66 6f 72 28 6e 3d 31 3b 20 6e 3c 6c      for(n=1; n<l
ae20: 65 6e 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20 20 20  en; n++){.      
ae30: 20 20 76 20 3d 20 28 76 3c 3c 38 29 20 7c 20 62    v = (v<<8) | b
ae40: 75 66 5b 6e 5d 3b 0a 20 20 20 20 20 20 7d 0a 20  uf[n];.      }. 
ae50: 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73       pMem->flags
ae60: 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20   = MEM_Int;.    
ae70: 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 76 3b 0a 20    pMem->i = v;. 
ae80: 20 20 20 20 20 72 65 74 75 72 6e 20 6e 3b 0a 20       return n;. 
ae90: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
aea0: 75 36 34 20 76 20 3d 20 30 3b 0a 20 20 20 20 20  u64 v = 0;.     
aeb0: 20 69 6e 74 20 6e 3b 0a 0a 20 20 20 20 20 20 69   int n;..      i
aec0: 66 28 20 62 75 66 5b 30 5d 26 30 78 38 30 20 29  f( buf[0]&0x80 )
aed0: 7b 0a 20 20 20 20 20 20 20 20 76 20 3d 20 2d 31  {.        v = -1
aee0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
aef0: 66 6f 72 28 6e 3d 30 3b 20 6e 3c 6c 65 6e 3b 20  for(n=0; n<len; 
af00: 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 76 20  n++){.        v 
af10: 3d 20 28 76 3c 3c 38 29 20 7c 20 62 75 66 5b 6e  = (v<<8) | buf[n
af20: 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  ];.      }.     
af30: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
af40: 3d 3d 37 20 29 7b 0a 20 20 20 20 20 20 20 20 70  ==7 ){.        p
af50: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
af60: 5f 52 65 61 6c 3b 0a 20 20 20 20 20 20 20 20 70  _Real;.        p
af70: 4d 65 6d 2d 3e 72 20 3d 20 2a 28 64 6f 75 62 6c  Mem->r = *(doubl
af80: 65 2a 29 26 76 3b 0a 20 20 20 20 20 20 7d 65 6c  e*)&v;.      }el
af90: 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d  se{.        pMem
afa0: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
afb0: 74 3b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d 2d  t;.        pMem-
afc0: 3e 69 20 3d 20 2a 28 69 36 34 2a 29 26 76 3b 0a  >i = *(i64*)&v;.
afd0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
afe0: 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 53 74  }else{.    /* St
aff0: 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 2a 2f 0a  ring or blob */.
b000: 20 20 20 20 61 73 73 65 72 74 28 20 73 65 72 69      assert( seri
b010: 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 3b 0a 20  al_type>=12 );. 
b020: 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 28 63 68     pMem->z = (ch
b030: 61 72 20 2a 29 62 75 66 3b 0a 20 20 20 20 70 4d  ar *)buf;.    pM
b040: 65 6d 2d 3e 6e 20 3d 20 6c 65 6e 3b 0a 20 20 20  em->n = len;.   
b050: 20 70 4d 65 6d 2d 3e 78 44 65 6c 20 3d 20 30 3b   pMem->xDel = 0;
b060: 0a 20 20 20 20 69 66 28 20 73 65 72 69 61 6c 5f  .    if( serial_
b070: 74 79 70 65 26 30 78 30 31 20 29 7b 0a 20 20 20  type&0x01 ){.   
b080: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
b090: 20 4d 45 4d 5f 53 74 72 20 7c 20 4d 45 4d 5f 45   MEM_Str | MEM_E
b0a0: 70 68 65 6d 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  phem;.    }else{
b0b0: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61  .      pMem->fla
b0c0: 67 73 20 3d 20 4d 45 4d 5f 42 6c 6f 62 20 7c 20  gs = MEM_Blob | 
b0d0: 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20 20 7d  MEM_Ephem;.    }
b0e0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6c 65  .  }.  return le
b0f0: 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  n;.}../*.** This
b100: 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 70 61 72   function compar
b110: 65 73 20 74 68 65 20 74 77 6f 20 74 61 62 6c 65  es the two table
b120: 20 72 6f 77 73 20 6f 72 20 69 6e 64 65 78 20 72   rows or index r
b130: 65 63 6f 72 64 73 20 73 70 65 63 69 66 69 65 64  ecords specified
b140: 20 62 79 20 0a 2a 2a 20 7b 6e 4b 65 79 31 2c 20   by .** {nKey1, 
b150: 70 4b 65 79 31 7d 20 61 6e 64 20 7b 6e 4b 65 79  pKey1} and {nKey
b160: 32 2c 20 70 4b 65 79 32 7d 2c 20 72 65 74 75 72  2, pKey2}, retur
b170: 6e 69 6e 67 20 61 20 6e 65 67 61 74 69 76 65 2c  ning a negative,
b180: 20 7a 65 72 6f 0a 2a 2a 20 6f 72 20 70 6f 73 69   zero.** or posi
b190: 74 69 76 65 20 69 6e 74 65 67 65 72 20 69 66 20  tive integer if 
b1a0: 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20 69  {nKey1, pKey1} i
b1b0: 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65 71 75  s less than, equ
b1c0: 61 6c 20 74 6f 20 6f 72 20 0a 2a 2a 20 67 72 65  al to or .** gre
b1d0: 61 74 65 72 20 74 68 61 6e 20 7b 6e 4b 65 79 32  ater than {nKey2
b1e0: 2c 20 70 4b 65 79 32 7d 2e 20 20 42 6f 74 68 20  , pKey2}.  Both 
b1f0: 4b 65 79 31 20 61 6e 64 20 4b 65 79 32 20 6d 75  Key1 and Key2 mu
b200: 73 74 20 62 65 20 62 79 74 65 20 73 74 72 69 6e  st be byte strin
b210: 67 73 0a 2a 2a 20 63 6f 6d 70 6f 73 65 64 20 62  gs.** composed b
b220: 79 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63  y the OP_MakeRec
b230: 6f 72 64 20 6f 70 63 6f 64 65 20 6f 66 20 74 68  ord opcode of th
b240: 65 20 56 44 42 45 2e 0a 2a 2f 0a 69 6e 74 20 73  e VDBE..*/.int s
b250: 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64  qlite3VdbeRecord
b260: 43 6f 6d 70 61 72 65 28 0a 20 20 76 6f 69 64 20  Compare(.  void 
b270: 2a 75 73 65 72 44 61 74 61 2c 0a 20 20 69 6e 74  *userData,.  int
b280: 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f   nKey1, const vo
b290: 69 64 20 2a 70 4b 65 79 31 2c 20 0a 20 20 69 6e  id *pKey1, .  in
b2a0: 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76  t nKey2, const v
b2b0: 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20  oid *pKey2.){.  
b2c0: 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66  KeyInfo *pKeyInf
b2d0: 6f 20 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 75 73  o = (KeyInfo*)us
b2e0: 65 72 44 61 74 61 3b 0a 20 20 75 33 32 20 64 31  erData;.  u32 d1
b2f0: 2c 20 64 32 3b 20 20 20 20 20 20 20 20 20 20 2f  , d2;          /
b300: 2a 20 4f 66 66 73 65 74 20 69 6e 74 6f 20 61 4b  * Offset into aK
b310: 65 79 5b 5d 20 6f 66 20 6e 65 78 74 20 64 61 74  ey[] of next dat
b320: 61 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 75  a element */.  u
b330: 33 32 20 69 64 78 31 2c 20 69 64 78 32 3b 20 20  32 idx1, idx2;  
b340: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e      /* Offset in
b350: 74 6f 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65 78  to aKey[] of nex
b360: 74 20 68 65 61 64 65 72 20 65 6c 65 6d 65 6e 74  t header element
b370: 20 2a 2f 0a 20 20 75 33 32 20 73 7a 48 64 72 31   */.  u32 szHdr1
b380: 2c 20 73 7a 48 64 72 32 3b 20 20 2f 2a 20 4e 75  , szHdr2;  /* Nu
b390: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e  mber of bytes in
b3a0: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e 74   header */.  int
b3b0: 20 69 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 46   i = 0;.  int nF
b3c0: 69 65 6c 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d  ield;.  int rc =
b3d0: 20 30 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69   0;.  const unsi
b3e0: 67 6e 65 64 20 63 68 61 72 20 2a 61 4b 65 79 31  gned char *aKey1
b3f0: 20 3d 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e   = (const unsign
b400: 65 64 20 63 68 61 72 20 2a 29 70 4b 65 79 31 3b  ed char *)pKey1;
b410: 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  .  const unsigne
b420: 64 20 63 68 61 72 20 2a 61 4b 65 79 32 20 3d 20  d char *aKey2 = 
b430: 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20  (const unsigned 
b440: 63 68 61 72 20 2a 29 70 4b 65 79 32 3b 0a 0a 20  char *)pKey2;.. 
b450: 20 4d 65 6d 20 6d 65 6d 31 3b 0a 20 20 4d 65 6d   Mem mem1;.  Mem
b460: 20 6d 65 6d 32 3b 0a 20 20 6d 65 6d 31 2e 65 6e   mem2;.  mem1.en
b470: 63 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e  c = pKeyInfo->en
b480: 63 3b 0a 20 20 6d 65 6d 32 2e 65 6e 63 20 3d 20  c;.  mem2.enc = 
b490: 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20  pKeyInfo->enc;. 
b4a0: 20 0a 20 20 69 64 78 31 20 3d 20 73 71 6c 69 74   .  idx1 = sqlit
b4b0: 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 70 4b  e3GetVarint32(pK
b4c0: 65 79 31 2c 20 26 73 7a 48 64 72 31 29 3b 0a 20  ey1, &szHdr1);. 
b4d0: 20 64 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20 20   d1 = szHdr1;.  
b4e0: 69 64 78 32 20 3d 20 73 71 6c 69 74 65 33 47 65  idx2 = sqlite3Ge
b4f0: 74 56 61 72 69 6e 74 33 32 28 70 4b 65 79 32 2c  tVarint32(pKey2,
b500: 20 26 73 7a 48 64 72 32 29 3b 0a 20 20 64 32 20   &szHdr2);.  d2 
b510: 3d 20 73 7a 48 64 72 32 3b 0a 20 20 6e 46 69 65  = szHdr2;.  nFie
b520: 6c 64 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e  ld = pKeyInfo->n
b530: 46 69 65 6c 64 3b 0a 20 20 77 68 69 6c 65 28 20  Field;.  while( 
b540: 69 64 78 31 3c 73 7a 48 64 72 31 20 26 26 20 69  idx1<szHdr1 && i
b550: 64 78 32 3c 73 7a 48 64 72 32 20 29 7b 0a 20 20  dx2<szHdr2 ){.  
b560: 20 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70    u32 serial_typ
b570: 65 31 3b 0a 20 20 20 20 75 33 32 20 73 65 72 69  e1;.    u32 seri
b580: 61 6c 5f 74 79 70 65 32 3b 0a 0a 20 20 20 20 2f  al_type2;..    /
b590: 2a 20 52 65 61 64 20 74 68 65 20 73 65 72 69 61  * Read the seria
b5a0: 6c 20 74 79 70 65 73 20 66 6f 72 20 74 68 65 20  l types for the 
b5b0: 6e 65 78 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20  next element in 
b5c0: 65 61 63 68 20 6b 65 79 2e 20 2a 2f 0a 20 20 20  each key. */.   
b5d0: 20 69 64 78 31 20 2b 3d 20 73 71 6c 69 74 65 33   idx1 += sqlite3
b5e0: 47 65 74 56 61 72 69 6e 74 33 32 28 26 61 4b 65  GetVarint32(&aKe
b5f0: 79 31 5b 69 64 78 31 5d 2c 20 26 73 65 72 69 61  y1[idx1], &seria
b600: 6c 5f 74 79 70 65 31 29 3b 0a 20 20 20 20 69 66  l_type1);.    if
b610: 28 20 64 31 3e 3d 6e 4b 65 79 31 20 26 26 20 73  ( d1>=nKey1 && s
b620: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
b630: 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74  TypeLen(serial_t
b640: 79 70 65 31 29 3e 30 20 29 20 62 72 65 61 6b 3b  ype1)>0 ) break;
b650: 0a 20 20 20 20 69 64 78 32 20 2b 3d 20 73 71 6c  .    idx2 += sql
b660: 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28  ite3GetVarint32(
b670: 26 61 4b 65 79 32 5b 69 64 78 32 5d 2c 20 26 73  &aKey2[idx2], &s
b680: 65 72 69 61 6c 5f 74 79 70 65 32 29 3b 0a 20 20  erial_type2);.  
b690: 20 20 69 66 28 20 64 32 3e 3d 6e 4b 65 79 32 20    if( d2>=nKey2 
b6a0: 26 26 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  && sqlite3VdbeSe
b6b0: 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69  rialTypeLen(seri
b6c0: 61 6c 5f 74 79 70 65 32 29 3e 30 20 29 20 62 72  al_type2)>0 ) br
b6d0: 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20 41 73 73  eak;..    /* Ass
b6e0: 65 72 74 20 74 68 61 74 20 74 68 65 72 65 20 69  ert that there i
b6f0: 73 20 65 6e 6f 75 67 68 20 73 70 61 63 65 20 6c  s enough space l
b700: 65 66 74 20 69 6e 20 65 61 63 68 20 6b 65 79 20  eft in each key 
b710: 66 6f 72 20 74 68 65 20 62 6c 6f 62 20 6f 66 0a  for the blob of.
b720: 20 20 20 20 2a 2a 20 64 61 74 61 20 74 6f 20 67      ** data to g
b730: 6f 20 77 69 74 68 20 74 68 65 20 73 65 72 69 61  o with the seria
b740: 6c 20 74 79 70 65 20 6a 75 73 74 20 72 65 61 64  l type just read
b750: 2e 20 54 68 69 73 20 61 73 73 65 72 74 20 6d 61  . This assert ma
b760: 79 20 66 61 69 6c 20 69 66 0a 20 20 20 20 2a 2a  y fail if.    **
b770: 20 74 68 65 20 66 69 6c 65 20 69 73 20 63 6f 72   the file is cor
b780: 72 75 70 74 65 64 2e 20 20 54 68 65 6e 20 72 65  rupted.  Then re
b790: 61 64 20 74 68 65 20 76 61 6c 75 65 20 66 72 6f  ad the value fro
b7a0: 6d 20 65 61 63 68 20 6b 65 79 20 69 6e 74 6f 20  m each key into 
b7b0: 6d 65 6d 31 0a 20 20 20 20 2a 2a 20 61 6e 64 20  mem1.    ** and 
b7c0: 6d 65 6d 32 20 72 65 73 70 65 63 74 69 76 65 6c  mem2 respectivel
b7d0: 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64 31  y..    */.    d1
b7e0: 20 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53   += sqlite3VdbeS
b7f0: 65 72 69 61 6c 47 65 74 28 26 61 4b 65 79 31 5b  erialGet(&aKey1[
b800: 64 31 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65  d1], serial_type
b810: 31 2c 20 26 6d 65 6d 31 29 3b 0a 20 20 20 20 64  1, &mem1);.    d
b820: 32 20 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65  2 += sqlite3Vdbe
b830: 53 65 72 69 61 6c 47 65 74 28 26 61 4b 65 79 32  SerialGet(&aKey2
b840: 5b 64 32 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70  [d2], serial_typ
b850: 65 32 2c 20 26 6d 65 6d 32 29 3b 0a 0a 20 20 20  e2, &mem2);..   
b860: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4d 65 6d   rc = sqlite3Mem
b870: 43 6f 6d 70 61 72 65 28 26 6d 65 6d 31 2c 20 26  Compare(&mem1, &
b880: 6d 65 6d 32 2c 20 69 3c 6e 46 69 65 6c 64 20 3f  mem2, i<nField ?
b890: 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c   pKeyInfo->aColl
b8a0: 5b 69 5d 20 3a 20 30 29 3b 0a 20 20 20 20 73 71  [i] : 0);.    sq
b8b0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65  lite3VdbeMemRele
b8c0: 61 73 65 28 26 6d 65 6d 31 29 3b 0a 20 20 20 20  ase(&mem1);.    
b8d0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
b8e0: 6c 65 61 73 65 28 26 6d 65 6d 32 29 3b 0a 20 20  lease(&mem2);.  
b8f0: 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20    if( rc!=0 ){. 
b900: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
b910: 7d 0a 20 20 20 20 69 2b 2b 3b 0a 20 20 7d 0a 0a  }.    i++;.  }..
b920: 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20    /* One of the 
b930: 6b 65 79 73 20 72 61 6e 20 6f 75 74 20 6f 66 20  keys ran out of 
b940: 66 69 65 6c 64 73 2c 20 62 75 74 20 61 6c 6c 20  fields, but all 
b950: 74 68 65 20 66 69 65 6c 64 73 20 75 70 20 74 6f  the fields up to
b960: 20 74 68 61 74 20 70 6f 69 6e 74 0a 20 20 2a 2a   that point.  **
b970: 20 77 65 72 65 20 65 71 75 61 6c 2e 20 49 66 20   were equal. If 
b980: 74 68 65 20 69 6e 63 72 4b 65 79 20 66 6c 61 67  the incrKey flag
b990: 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74   is true, then t
b9a0: 68 65 20 73 65 63 6f 6e 64 20 6b 65 79 20 69 73  he second key is
b9b0: 0a 20 20 2a 2a 20 74 72 65 61 74 65 64 20 61 73  .  ** treated as
b9c0: 20 6c 61 72 67 65 72 2e 0a 20 20 2a 2f 0a 20 20   larger..  */.  
b9d0: 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20  if( rc==0 ){.   
b9e0: 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e 69   if( pKeyInfo->i
b9f0: 6e 63 72 4b 65 79 20 29 7b 0a 20 20 20 20 20 20  ncrKey ){.      
ba00: 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 65 6c  rc = -1;.    }el
ba10: 73 65 20 69 66 28 20 64 31 3c 6e 4b 65 79 31 20  se if( d1<nKey1 
ba20: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 31 3b  ){.      rc = 1;
ba30: 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 64  .    }else if( d
ba40: 32 3c 6e 4b 65 79 32 20 29 7b 0a 20 20 20 20 20  2<nKey2 ){.     
ba50: 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 0a   rc = -1;.    }.
ba60: 20 20 7d 0a 0a 20 20 69 66 28 20 70 4b 65 79 49    }..  if( pKeyI
ba70: 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20  nfo->aSortOrder 
ba80: 26 26 20 69 3c 70 4b 65 79 49 6e 66 6f 2d 3e 6e  && i<pKeyInfo->n
ba90: 46 69 65 6c 64 20 26 26 20 70 4b 65 79 49 6e 66  Field && pKeyInf
baa0: 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b 69 5d  o->aSortOrder[i]
bab0: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 2d 72 63   ){.    rc = -rc
bac0: 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20  ;.  }..  return 
bad0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65  rc;.}../*.** The
bae0: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e 20   argument is an 
baf0: 69 6e 64 65 78 20 65 6e 74 72 79 20 63 6f 6d 70  index entry comp
bb00: 6f 73 65 64 20 75 73 69 6e 67 20 74 68 65 20 4f  osed using the O
bb10: 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63  P_MakeRecord opc
bb20: 6f 64 65 2e 0a 2a 2a 20 54 68 65 20 6c 61 73 74  ode..** The last
bb30: 20 65 6e 74 72 79 20 69 6e 20 74 68 69 73 20 72   entry in this r
bb40: 65 63 6f 72 64 20 73 68 6f 75 6c 64 20 62 65 20  ecord should be 
bb50: 61 6e 20 69 6e 74 65 67 65 72 20 28 73 70 65 63  an integer (spec
bb60: 69 66 69 63 61 6c 6c 79 0a 2a 2a 20 61 6e 20 69  ifically.** an i
bb70: 6e 74 65 67 65 72 20 72 6f 77 69 64 29 2e 20 20  nteger rowid).  
bb80: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74  This routine ret
bb90: 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20  urns the number 
bba0: 6f 66 20 62 79 74 65 73 20 69 6e 0a 2a 2a 20 74  of bytes in.** t
bbb0: 68 61 74 20 69 6e 74 65 67 65 72 2e 0a 2a 2f 0a  hat integer..*/.
bbc0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 49  int sqlite3VdbeI
bbd0: 64 78 52 6f 77 69 64 4c 65 6e 28 69 6e 74 20 6e  dxRowidLen(int n
bbe0: 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38 20 2a 61  Key, const u8 *a
bbf0: 4b 65 79 29 7b 0a 20 20 75 33 32 20 73 7a 48 64  Key){.  u32 szHd
bc00: 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a  r;        /* Siz
bc10: 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20  e of the header 
bc20: 2a 2f 0a 20 20 75 33 32 20 74 79 70 65 52 6f 77  */.  u32 typeRow
bc30: 69 64 3b 20 20 20 20 2f 2a 20 53 65 72 69 61 6c  id;    /* Serial
bc40: 20 74 79 70 65 20 6f 66 20 74 68 65 20 72 6f 77   type of the row
bc50: 69 64 20 2a 2f 0a 0a 20 20 73 71 6c 69 74 65 33  id */..  sqlite3
bc60: 47 65 74 56 61 72 69 6e 74 33 32 28 61 4b 65 79  GetVarint32(aKey
bc70: 2c 20 26 73 7a 48 64 72 29 3b 0a 20 20 73 71 6c  , &szHdr);.  sql
bc80: 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28  ite3GetVarint32(
bc90: 26 61 4b 65 79 5b 73 7a 48 64 72 2d 31 5d 2c 20  &aKey[szHdr-1], 
bca0: 26 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20 72  &typeRowid);.  r
bcb0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62  eturn sqlite3Vdb
bcc0: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 74  eSerialTypeLen(t
bcd0: 79 70 65 52 6f 77 69 64 29 3b 0a 7d 0a 20 20 0a  ypeRowid);.}.  .
bce0: 0a 2f 2a 0a 2a 2a 20 70 43 75 72 20 70 6f 69 6e  ./*.** pCur poin
bcf0: 74 73 20 61 74 20 61 6e 20 69 6e 64 65 78 20 65  ts at an index e
bd00: 6e 74 72 79 20 63 72 65 61 74 65 64 20 75 73 69  ntry created usi
bd10: 6e 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65  ng the OP_MakeRe
bd20: 63 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20  cord opcode..** 
bd30: 52 65 61 64 20 74 68 65 20 72 6f 77 69 64 20 28  Read the rowid (
bd40: 74 68 65 20 6c 61 73 74 20 66 69 65 6c 64 20 69  the last field i
bd50: 6e 20 74 68 65 20 72 65 63 6f 72 64 29 20 61 6e  n the record) an
bd60: 64 20 73 74 6f 72 65 20 69 74 20 69 6e 20 2a 72  d store it in *r
bd70: 6f 77 69 64 2e 0a 2a 2a 20 52 65 74 75 72 6e 20  owid..** Return 
bd80: 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 65  SQLITE_OK if eve
bd90: 72 79 74 68 69 6e 67 20 77 6f 72 6b 73 2c 20 6f  rything works, o
bda0: 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20  r an error code 
bdb0: 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e  otherwise..*/.in
bdc0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78  t sqlite3VdbeIdx
bdd0: 52 6f 77 69 64 28 42 74 43 75 72 73 6f 72 20 2a  Rowid(BtCursor *
bde0: 70 43 75 72 2c 20 69 36 34 20 2a 72 6f 77 69 64  pCur, i64 *rowid
bdf0: 29 7b 0a 20 20 69 36 34 20 6e 43 65 6c 6c 4b 65  ){.  i64 nCellKe
be00: 79 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75  y;.  int rc;.  u
be10: 33 32 20 73 7a 48 64 72 3b 20 20 20 20 20 20 20  32 szHdr;       
be20: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20   /* Size of the 
be30: 68 65 61 64 65 72 20 2a 2f 0a 20 20 75 33 32 20  header */.  u32 
be40: 74 79 70 65 52 6f 77 69 64 3b 20 20 20 20 2f 2a  typeRowid;    /*
be50: 20 53 65 72 69 61 6c 20 74 79 70 65 20 6f 66 20   Serial type of 
be60: 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20 75  the rowid */.  u
be70: 33 32 20 6c 65 6e 52 6f 77 69 64 3b 20 20 20 20  32 lenRowid;    
be80: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20   /* Size of the 
be90: 72 6f 77 69 64 20 2a 2f 0a 20 20 4d 65 6d 20 6d  rowid */.  Mem m
bea0: 2c 20 76 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42  , v;..  sqlite3B
beb0: 74 72 65 65 4b 65 79 53 69 7a 65 28 70 43 75 72  treeKeySize(pCur
bec0: 2c 20 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20  , &nCellKey);.  
bed0: 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30 20  if( nCellKey<=0 
bee0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
bef0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 20 20  LITE_CORRUPT;.  
bf00: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  }.  rc = sqlite3
bf10: 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65 65  VdbeMemFromBtree
bf20: 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 6c 6c 4b  (pCur, 0, nCellK
bf30: 65 79 2c 20 31 2c 20 26 6d 29 3b 0a 20 20 69 66  ey, 1, &m);.  if
bf40: 28 20 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75  ( rc ){.    retu
bf50: 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 73 71 6c  rn rc;.  }.  sql
bf60: 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28  ite3GetVarint32(
bf70: 6d 2e 7a 2c 20 26 73 7a 48 64 72 29 3b 0a 20 20  m.z, &szHdr);.  
bf80: 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74  sqlite3GetVarint
bf90: 33 32 28 26 6d 2e 7a 5b 73 7a 48 64 72 2d 31 5d  32(&m.z[szHdr-1]
bfa0: 2c 20 26 74 79 70 65 52 6f 77 69 64 29 3b 0a 20  , &typeRowid);. 
bfb0: 20 6c 65 6e 52 6f 77 69 64 20 3d 20 73 71 6c 69   lenRowid = sqli
bfc0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
bfd0: 65 4c 65 6e 28 74 79 70 65 52 6f 77 69 64 29 3b  eLen(typeRowid);
bfe0: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  .  sqlite3VdbeSe
bff0: 72 69 61 6c 47 65 74 28 26 6d 2e 7a 5b 6d 2e 6e  rialGet(&m.z[m.n
c000: 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20 74 79 70 65  -lenRowid], type
c010: 52 6f 77 69 64 2c 20 26 76 29 3b 0a 20 20 2a 72  Rowid, &v);.  *r
c020: 6f 77 69 64 20 3d 20 76 2e 69 3b 0a 20 20 73 71  owid = v.i;.  sq
c030: 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65  lite3VdbeMemRele
c040: 61 73 65 28 26 6d 29 3b 0a 20 20 72 65 74 75 72  ase(&m);.  retur
c050: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
c060: 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72 65 20 74 68  /*.** Compare th
c070: 65 20 6b 65 79 20 6f 66 20 74 68 65 20 69 6e 64  e key of the ind
c080: 65 78 20 65 6e 74 72 79 20 74 68 61 74 20 63 75  ex entry that cu
c090: 72 73 6f 72 20 70 43 20 69 73 20 70 6f 69 6e 74  rsor pC is point
c0a0: 20 74 6f 20 61 67 61 69 6e 73 74 0a 2a 2a 20 74   to against.** t
c0b0: 68 65 20 6b 65 79 20 73 74 72 69 6e 67 20 69 6e  he key string in
c0c0: 20 70 4b 65 79 20 28 6f 66 20 6c 65 6e 67 74 68   pKey (of length
c0d0: 20 6e 4b 65 79 29 2e 20 20 57 72 69 74 65 20 69   nKey).  Write i
c0e0: 6e 74 6f 20 2a 70 52 65 73 20 61 20 6e 75 6d 62  nto *pRes a numb
c0f0: 65 72 0a 2a 2a 20 74 68 61 74 20 69 73 20 6e 65  er.** that is ne
c100: 67 61 74 69 76 65 2c 20 7a 65 72 6f 2c 20 6f 72  gative, zero, or
c110: 20 70 6f 73 69 74 69 76 65 20 69 66 20 70 43 20   positive if pC 
c120: 69 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65 71  is less than, eq
c130: 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f 72 20 67 72  ual to,.** or gr
c140: 65 61 74 65 72 20 74 68 61 6e 20 70 4b 65 79 2e  eater than pKey.
c150: 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    Return SQLITE_
c160: 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 2e 0a 2a  OK on success..*
c170: 2a 0a 2a 2a 20 70 4b 65 79 20 69 73 20 65 69 74  *.** pKey is eit
c180: 68 65 72 20 63 72 65 61 74 65 64 20 77 69 74 68  her created with
c190: 6f 75 74 20 61 20 72 6f 77 69 64 20 6f 72 20 69  out a rowid or i
c1a0: 73 20 74 72 75 6e 63 61 74 65 64 20 73 6f 20 74  s truncated so t
c1b0: 68 61 74 20 69 74 0a 2a 2a 20 6f 6d 69 74 73 20  hat it.** omits 
c1c0: 74 68 65 20 72 6f 77 69 64 20 61 74 20 74 68 65  the rowid at the
c1d0: 20 65 6e 64 2e 20 20 54 68 65 20 72 6f 77 69 64   end.  The rowid
c1e0: 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74   at the end of t
c1f0: 68 65 20 69 6e 64 65 78 20 65 6e 74 72 79 0a 2a  he index entry.*
c200: 2a 20 69 73 20 69 67 6e 6f 72 65 64 20 61 73 20  * is ignored as 
c210: 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  well..*/.int sql
c220: 69 74 65 33 56 64 62 65 49 64 78 4b 65 79 43 6f  ite3VdbeIdxKeyCo
c230: 6d 70 61 72 65 28 0a 20 20 43 75 72 73 6f 72 20  mpare(.  Cursor 
c240: 2a 70 43 2c 20 20 20 20 20 20 20 20 20 20 20 20  *pC,            
c250: 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72 73       /* The curs
c260: 6f 72 20 74 6f 20 63 6f 6d 70 61 72 65 20 61 67  or to compare ag
c270: 61 69 6e 73 74 20 2a 2f 0a 20 20 69 6e 74 20 6e  ainst */.  int n
c280: 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38 20 2a 70  Key, const u8 *p
c290: 4b 65 79 2c 20 20 20 2f 2a 20 54 68 65 20 6b 65  Key,   /* The ke
c2a0: 79 20 74 6f 20 63 6f 6d 70 61 72 65 20 2a 2f 0a  y to compare */.
c2b0: 20 20 69 6e 74 20 2a 72 65 73 20 20 20 20 20 20    int *res      
c2c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
c2d0: 20 57 72 69 74 65 20 74 68 65 20 63 6f 6d 70 61   Write the compa
c2e0: 72 69 73 6f 6e 20 72 65 73 75 6c 74 20 68 65 72  rison result her
c2f0: 65 20 2a 2f 0a 29 7b 0a 20 20 69 36 34 20 6e 43  e */.){.  i64 nC
c300: 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74 20 72 63  ellKey;.  int rc
c310: 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43  ;.  BtCursor *pC
c320: 75 72 20 3d 20 70 43 2d 3e 70 43 75 72 73 6f 72  ur = pC->pCursor
c330: 3b 0a 20 20 69 6e 74 20 6c 65 6e 52 6f 77 69 64  ;.  int lenRowid
c340: 3b 0a 20 20 4d 65 6d 20 6d 3b 0a 0a 20 20 73 71  ;.  Mem m;..  sq
c350: 6c 69 74 65 33 42 74 72 65 65 4b 65 79 53 69 7a  lite3BtreeKeySiz
c360: 65 28 70 43 75 72 2c 20 26 6e 43 65 6c 6c 4b 65  e(pCur, &nCellKe
c370: 79 29 3b 0a 20 20 69 66 28 20 6e 43 65 6c 6c 4b  y);.  if( nCellK
c380: 65 79 3c 3d 30 20 29 7b 0a 20 20 20 20 2a 72 65  ey<=0 ){.    *re
c390: 73 20 3d 20 30 3b 0a 20 20 20 20 72 65 74 75 72  s = 0;.    retur
c3a0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  n SQLITE_OK;.  }
c3b0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56  .  rc = sqlite3V
c3c0: 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65 65 28  dbeMemFromBtree(
c3d0: 70 43 2d 3e 70 43 75 72 73 6f 72 2c 20 30 2c 20  pC->pCursor, 0, 
c3e0: 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29  nCellKey, 1, &m)
c3f0: 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20  ;.  if( rc ){.  
c400: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d    return rc;.  }
c410: 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20 73 71  .  lenRowid = sq
c420: 6c 69 74 65 33 56 64 62 65 49 64 78 52 6f 77 69  lite3VdbeIdxRowi
c430: 64 4c 65 6e 28 6d 2e 6e 2c 20 6d 2e 7a 29 3b 0a  dLen(m.n, m.z);.
c440: 20 20 2a 72 65 73 20 3d 20 73 71 6c 69 74 65 33    *res = sqlite3
c450: 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72  VdbeRecordCompar
c460: 65 28 70 43 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20  e(pC->pKeyInfo, 
c470: 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 2c 20 6d 2e  m.n-lenRowid, m.
c480: 7a 2c 20 6e 4b 65 79 2c 20 70 4b 65 79 29 3b 0a  z, nKey, pKey);.
c490: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
c4a0: 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20 72  Release(&m);.  r
c4b0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
c4c0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
c4d0: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
c4e0: 76 61 6c 75 65 20 74 6f 20 62 65 20 72 65 74 75  value to be retu
c4f0: 72 6e 65 64 20 62 79 20 73 75 62 73 65 71 75 65  rned by subseque
c500: 6e 74 20 63 61 6c 6c 73 20 74 6f 0a 2a 2a 20 73  nt calls to.** s
c510: 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 28 29  qlite3_changes()
c520: 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65   on the database
c530: 20 68 61 6e 64 6c 65 20 27 64 62 27 2e 20 0a 2a   handle 'db'. .*
c540: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
c550: 62 65 53 65 74 43 68 61 6e 67 65 73 28 73 71 6c  beSetChanges(sql
c560: 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6e 43  ite3 *db, int nC
c570: 68 61 6e 67 65 29 7b 0a 20 20 64 62 2d 3e 6e 43  hange){.  db->nC
c580: 68 61 6e 67 65 20 3d 20 6e 43 68 61 6e 67 65 3b  hange = nChange;
c590: 0a 20 20 64 62 2d 3e 6e 54 6f 74 61 6c 43 68 61  .  db->nTotalCha
c5a0: 6e 67 65 20 2b 3d 20 6e 43 68 61 6e 67 65 3b 0a  nge += nChange;.
c5b0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 61 20 66  }../*.** Set a f
c5c0: 6c 61 67 20 69 6e 20 74 68 65 20 76 64 62 65 20  lag in the vdbe 
c5d0: 74 6f 20 75 70 64 61 74 65 20 74 68 65 20 63 68  to update the ch
c5e0: 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 77 68 65  ange counter whe
c5f0: 6e 20 69 74 20 69 73 20 66 69 6e 61 6c 69 73 65  n it is finalise
c600: 64 0a 2a 2a 20 6f 72 20 72 65 73 65 74 2e 0a 2a  d.** or reset..*
c610: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
c620: 62 65 43 6f 75 6e 74 43 68 61 6e 67 65 73 28 56  beCountChanges(V
c630: 64 62 65 20 2a 70 29 7b 0a 20 20 70 2d 3e 63 68  dbe *p){.  p->ch
c640: 61 6e 67 65 43 6e 74 4f 6e 20 3d 20 31 3b 0a 7d  angeCntOn = 1;.}
c650: 0a                                               .