/ Hex Artifact Content
Login

Artifact b4d9b9a9d87254a279a88e3f91d0db048071c856:


0000: 2f 2a 0a 2a 2a 20 32 30 30 33 20 53 65 70 74 65  /*.** 2003 Septe
0010: 6d 62 65 72 20 36 0a 2a 2a 0a 2a 2a 20 54 68 65  mber 6.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69  *****.** This fi
0180: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65  le contains code
0190: 20 75 73 65 64 20 66 6f 72 20 63 72 65 61 74 69   used for creati
01a0: 6e 67 2c 20 64 65 73 74 72 6f 79 69 6e 67 2c 20  ng, destroying, 
01b0: 61 6e 64 20 70 6f 70 75 6c 61 74 69 6e 67 0a 2a  and populating.*
01c0: 2a 20 61 20 56 44 42 45 20 28 6f 72 20 61 6e 20  * a VDBE (or an 
01d0: 22 73 71 6c 69 74 65 33 5f 73 74 6d 74 22 20 61  "sqlite3_stmt" a
01e0: 73 20 69 74 20 69 73 20 6b 6e 6f 77 6e 20 74 6f  s it is known to
01f0: 20 74 68 65 20 6f 75 74 73 69 64 65 20 77 6f 72   the outside wor
0200: 6c 64 2e 29 20 20 50 72 69 6f 72 0a 2a 2a 20 74  ld.)  Prior.** t
0210: 6f 20 76 65 72 73 69 6f 6e 20 32 2e 38 2e 37 2c  o version 2.8.7,
0220: 20 61 6c 6c 20 74 68 69 73 20 63 6f 64 65 20 77   all this code w
0230: 61 73 20 63 6f 6d 62 69 6e 65 64 20 69 6e 74 6f  as combined into
0240: 20 74 68 65 20 76 64 62 65 2e 63 20 73 6f 75 72   the vdbe.c sour
0250: 63 65 20 66 69 6c 65 2e 0a 2a 2a 20 42 75 74 20  ce file..** But 
0260: 74 68 61 74 20 66 69 6c 65 20 77 61 73 20 67 65  that file was ge
0270: 74 74 69 6e 67 20 74 6f 6f 20 62 69 67 20 73 6f  tting too big so
0280: 20 74 68 69 73 20 73 75 62 72 6f 75 74 69 6e 65   this subroutine
0290: 73 20 77 65 72 65 20 73 70 6c 69 74 20 6f 75 74  s were split out
02a0: 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73  ..*/.#include "s
02b0: 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63  qliteInt.h".#inc
02c0: 6c 75 64 65 20 22 6f 73 2e 68 22 0a 23 69 6e 63  lude "os.h".#inc
02d0: 6c 75 64 65 20 3c 63 74 79 70 65 2e 68 3e 0a 23  lude <ctype.h>.#
02e0: 69 6e 63 6c 75 64 65 20 22 76 64 62 65 49 6e 74  include "vdbeInt
02f0: 2e 68 22 0a 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e  .h".../*.** When
0300: 20 64 65 62 75 67 67 69 6e 67 20 74 68 65 20 63   debugging the c
0310: 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 20 69 6e  ode generator in
0320: 20 61 20 73 79 6d 62 6f 6c 69 63 20 64 65 62 75   a symbolic debu
0330: 67 67 65 72 2c 20 6f 6e 65 20 63 61 6e 0a 2a 2a  gger, one can.**
0340: 20 73 65 74 20 74 68 65 20 73 71 6c 69 74 65 33   set the sqlite3
0350: 5f 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63  _vdbe_addop_trac
0360: 65 20 74 6f 20 31 20 61 6e 64 20 61 6c 6c 20 6f  e to 1 and all o
0370: 70 63 6f 64 65 73 20 77 69 6c 6c 20 62 65 20 70  pcodes will be p
0380: 72 69 6e 74 65 64 0a 2a 2a 20 61 73 20 74 68 65  rinted.** as the
0390: 79 20 61 72 65 20 61 64 64 65 64 20 74 6f 20 74  y are added to t
03a0: 68 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 73  he instruction s
03b0: 74 72 65 61 6d 2e 0a 2a 2f 0a 23 69 66 6e 64 65  tream..*/.#ifnde
03c0: 66 20 4e 44 45 42 55 47 0a 69 6e 74 20 73 71 6c  f NDEBUG.int sql
03d0: 69 74 65 33 5f 76 64 62 65 5f 61 64 64 6f 70 5f  ite3_vdbe_addop_
03e0: 74 72 61 63 65 20 3d 20 30 3b 0a 23 65 6e 64 69  trace = 0;.#endi
03f0: 66 0a 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65  f.../*.** Create
0400: 20 61 20 6e 65 77 20 76 69 72 74 75 61 6c 20 64   a new virtual d
0410: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 2e 0a  atabase engine..
0420: 2a 2f 0a 56 64 62 65 20 2a 73 71 6c 69 74 65 33  */.Vdbe *sqlite3
0430: 56 64 62 65 43 72 65 61 74 65 28 73 71 6c 69 74  VdbeCreate(sqlit
0440: 65 33 20 2a 64 62 29 7b 0a 20 20 56 64 62 65 20  e3 *db){.  Vdbe 
0450: 2a 70 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65  *p;.  p = sqlite
0460: 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 56  Malloc( sizeof(V
0470: 64 62 65 29 20 29 3b 0a 20 20 69 66 28 20 70 3d  dbe) );.  if( p=
0480: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
0490: 20 70 2d 3e 64 62 20 3d 20 64 62 3b 0a 20 20 69   p->db = db;.  i
04a0: 66 28 20 64 62 2d 3e 70 56 64 62 65 20 29 7b 0a  f( db->pVdbe ){.
04b0: 20 20 20 20 64 62 2d 3e 70 56 64 62 65 2d 3e 70      db->pVdbe->p
04c0: 50 72 65 76 20 3d 20 70 3b 0a 20 20 7d 0a 20 20  Prev = p;.  }.  
04d0: 70 2d 3e 70 4e 65 78 74 20 3d 20 64 62 2d 3e 70  p->pNext = db->p
04e0: 56 64 62 65 3b 0a 20 20 70 2d 3e 70 50 72 65 76  Vdbe;.  p->pPrev
04f0: 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 70 56 64 62   = 0;.  db->pVdb
0500: 65 20 3d 20 70 3b 0a 20 20 70 2d 3e 6d 61 67 69  e = p;.  p->magi
0510: 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  c = VDBE_MAGIC_I
0520: 4e 49 54 3b 0a 20 20 72 65 74 75 72 6e 20 70 3b  NIT;.  return p;
0530: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 75 72 6e 20 74  .}../*.** Turn t
0540: 72 61 63 69 6e 67 20 6f 6e 20 6f 72 20 6f 66 66  racing on or off
0550: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
0560: 56 64 62 65 54 72 61 63 65 28 56 64 62 65 20 2a  VdbeTrace(Vdbe *
0570: 70 2c 20 46 49 4c 45 20 2a 74 72 61 63 65 29 7b  p, FILE *trace){
0580: 0a 20 20 70 2d 3e 74 72 61 63 65 20 3d 20 74 72  .  p->trace = tr
0590: 61 63 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  ace;.}../*.** Re
05a0: 73 69 7a 65 20 74 68 65 20 56 64 62 65 2e 61 4f  size the Vdbe.aO
05b0: 70 20 61 72 72 61 79 20 73 6f 20 74 68 61 74 20  p array so that 
05c0: 69 74 20 63 6f 6e 74 61 69 6e 73 20 61 74 20 6c  it contains at l
05d0: 65 61 73 74 20 4e 0a 2a 2a 20 65 6c 65 6d 65 6e  east N.** elemen
05e0: 74 73 2e 20 49 66 20 74 68 65 20 56 64 62 65 20  ts. If the Vdbe 
05f0: 69 73 20 69 6e 20 56 44 42 45 5f 4d 41 47 49 43  is in VDBE_MAGIC
0600: 5f 52 55 4e 20 73 74 61 74 65 2c 20 74 68 65 6e  _RUN state, then
0610: 0a 2a 2a 20 74 68 65 20 56 64 62 65 2e 61 4f 70  .** the Vdbe.aOp
0620: 20 61 72 72 61 79 20 77 69 6c 6c 20 62 65 20 73   array will be s
0630: 69 7a 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20  ized to contain 
0640: 65 78 61 63 74 6c 79 20 4e 20 0a 2a 2a 20 65 6c  exactly N .** el
0650: 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 73 74 61 74 69  ements..*/.stati
0660: 63 20 76 6f 69 64 20 72 65 73 69 7a 65 4f 70 41  c void resizeOpA
0670: 72 72 61 79 28 56 64 62 65 20 2a 70 2c 20 69 6e  rray(Vdbe *p, in
0680: 74 20 4e 29 7b 0a 20 20 69 66 28 20 70 2d 3e 6d  t N){.  if( p->m
0690: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
06a0: 5f 52 55 4e 20 29 7b 0a 20 20 20 20 61 73 73 65  _RUN ){.    asse
06b0: 72 74 28 20 4e 3d 3d 70 2d 3e 6e 4f 70 20 29 3b  rt( N==p->nOp );
06c0: 0a 20 20 20 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63  .    p->nOpAlloc
06d0: 20 3d 20 4e 3b 0a 20 20 20 20 70 2d 3e 61 4f 70   = N;.    p->aOp
06e0: 20 3d 20 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63   = sqliteRealloc
06f0: 28 70 2d 3e 61 4f 70 2c 20 4e 2a 73 69 7a 65 6f  (p->aOp, N*sizeo
0700: 66 28 4f 70 29 29 3b 0a 20 20 7d 65 6c 73 65 20  f(Op));.  }else 
0710: 69 66 28 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 3c  if( p->nOpAlloc<
0720: 4e 20 29 7b 0a 20 20 20 20 69 6e 74 20 6f 6c 64  N ){.    int old
0730: 53 69 7a 65 20 3d 20 70 2d 3e 6e 4f 70 41 6c 6c  Size = p->nOpAll
0740: 6f 63 3b 0a 20 20 20 20 70 2d 3e 6e 4f 70 41 6c  oc;.    p->nOpAl
0750: 6c 6f 63 20 3d 20 4e 2b 31 30 30 3b 0a 20 20 20  loc = N+100;.   
0760: 20 70 2d 3e 61 4f 70 20 3d 20 73 71 6c 69 74 65   p->aOp = sqlite
0770: 52 65 61 6c 6c 6f 63 28 70 2d 3e 61 4f 70 2c 20  Realloc(p->aOp, 
0780: 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 2a 73 69 7a 65  p->nOpAlloc*size
0790: 6f 66 28 4f 70 29 29 3b 0a 20 20 20 20 69 66 28  of(Op));.    if(
07a0: 20 70 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 20   p->aOp ){.     
07b0: 20 6d 65 6d 73 65 74 28 26 70 2d 3e 61 4f 70 5b   memset(&p->aOp[
07c0: 6f 6c 64 53 69 7a 65 5d 2c 20 30 2c 20 28 70 2d  oldSize], 0, (p-
07d0: 3e 6e 4f 70 41 6c 6c 6f 63 2d 6f 6c 64 53 69 7a  >nOpAlloc-oldSiz
07e0: 65 29 2a 73 69 7a 65 6f 66 28 4f 70 29 29 3b 0a  e)*sizeof(Op));.
07f0: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a      }.  }.}../*.
0800: 2a 2a 20 41 64 64 20 61 20 6e 65 77 20 69 6e 73  ** Add a new ins
0810: 74 72 75 63 74 69 6f 6e 20 74 6f 20 74 68 65 20  truction to the 
0820: 6c 69 73 74 20 6f 66 20 69 6e 73 74 72 75 63 74  list of instruct
0830: 69 6f 6e 73 20 63 75 72 72 65 6e 74 20 69 6e 20  ions current in 
0840: 74 68 65 0a 2a 2a 20 56 44 42 45 2e 20 20 52 65  the.** VDBE.  Re
0850: 74 75 72 6e 20 74 68 65 20 61 64 64 72 65 73 73  turn the address
0860: 20 6f 66 20 74 68 65 20 6e 65 77 20 69 6e 73 74   of the new inst
0870: 72 75 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50  ruction..**.** P
0880: 61 72 61 6d 65 74 65 72 73 3a 0a 2a 2a 0a 2a 2a  arameters:.**.**
0890: 20 20 20 20 70 20 20 20 20 20 20 20 20 20 20 20      p           
08a0: 20 20 20 20 50 6f 69 6e 74 65 72 20 74 6f 20 74      Pointer to t
08b0: 68 65 20 56 44 42 45 0a 2a 2a 0a 2a 2a 20 20 20  he VDBE.**.**   
08c0: 20 6f 70 20 20 20 20 20 20 20 20 20 20 20 20 20   op             
08d0: 20 54 68 65 20 6f 70 63 6f 64 65 20 66 6f 72 20   The opcode for 
08e0: 74 68 69 73 20 69 6e 73 74 72 75 63 74 69 6f 6e  this instruction
08f0: 0a 2a 2a 0a 2a 2a 20 20 20 20 70 31 2c 20 70 32  .**.**    p1, p2
0900: 20 20 20 20 20 20 20 20 20 20 46 69 72 73 74 20            First 
0910: 74 77 6f 20 6f 66 20 74 68 65 20 74 68 72 65 65  two of the three
0920: 20 70 6f 73 73 69 62 6c 65 20 6f 70 65 72 61 6e   possible operan
0930: 64 73 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68  ds..**.** Use th
0940: 65 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73  e sqlite3VdbeRes
0950: 6f 6c 76 65 4c 61 62 65 6c 28 29 20 66 75 6e 63  olveLabel() func
0960: 74 69 6f 6e 20 74 6f 20 66 69 78 20 61 6e 20 61  tion to fix an a
0970: 64 64 72 65 73 73 20 61 6e 64 0a 2a 2a 20 74 68  ddress and.** th
0980: 65 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61  e sqlite3VdbeCha
0990: 6e 67 65 50 33 28 29 20 66 75 6e 63 74 69 6f 6e  ngeP3() function
09a0: 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 76   to change the v
09b0: 61 6c 75 65 20 6f 66 20 74 68 65 20 50 33 0a 2a  alue of the P3.*
09c0: 2a 20 6f 70 65 72 61 6e 64 2e 0a 2a 2f 0a 69 6e  * operand..*/.in
09d0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64  t sqlite3VdbeAdd
09e0: 4f 70 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20  Op(Vdbe *p, int 
09f0: 6f 70 2c 20 69 6e 74 20 70 31 2c 20 69 6e 74 20  op, int p1, int 
0a00: 70 32 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  p2){.  int i;.  
0a10: 56 64 62 65 4f 70 20 2a 70 4f 70 3b 0a 0a 20 20  VdbeOp *pOp;..  
0a20: 69 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 70 2d  i = p->nOp;.  p-
0a30: 3e 6e 4f 70 2b 2b 3b 0a 20 20 61 73 73 65 72 74  >nOp++;.  assert
0a40: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
0a50: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
0a60: 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70   resizeOpArray(p
0a70: 2c 20 69 2b 31 29 3b 0a 20 20 69 66 28 20 70 2d  , i+1);.  if( p-
0a80: 3e 61 4f 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72  >aOp==0 ){.    r
0a90: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 70  eturn 0;.  }.  p
0aa0: 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b  Op = &p->aOp[i];
0ab0: 0a 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d  .  pOp->opcode =
0ac0: 20 6f 70 3b 0a 20 20 70 4f 70 2d 3e 70 31 20 3d   op;.  pOp->p1 =
0ad0: 20 70 31 3b 0a 20 20 70 4f 70 2d 3e 70 32 20 3d   p1;.  pOp->p2 =
0ae0: 20 70 32 3b 0a 20 20 70 4f 70 2d 3e 70 33 20 3d   p2;.  pOp->p3 =
0af0: 20 30 3b 0a 20 20 70 4f 70 2d 3e 70 33 74 79 70   0;.  pOp->p3typ
0b00: 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a  e = P3_NOTUSED;.
0b10: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
0b20: 42 55 47 0a 20 20 69 66 28 20 73 71 6c 69 74 65  BUG.  if( sqlite
0b30: 33 5f 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61  3_vdbe_addop_tra
0b40: 63 65 20 29 20 73 71 6c 69 74 65 33 56 64 62 65  ce ) sqlite3Vdbe
0b50: 50 72 69 6e 74 4f 70 28 30 2c 20 69 2c 20 26 70  PrintOp(0, i, &p
0b60: 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 23 65 6e 64 69  ->aOp[i]);.#endi
0b70: 66 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d 0a  f.  return i;.}.
0b80: 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 6e 20 6f 70  ./*.** Add an op
0b90: 63 6f 64 65 20 74 68 61 74 20 69 6e 63 6c 75 64  code that includ
0ba0: 65 73 20 74 68 65 20 70 33 20 76 61 6c 75 65 2e  es the p3 value.
0bb0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
0bc0: 64 62 65 4f 70 33 28 56 64 62 65 20 2a 70 2c 20  dbeOp3(Vdbe *p, 
0bd0: 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c 20  int op, int p1, 
0be0: 69 6e 74 20 70 32 2c 20 63 6f 6e 73 74 20 63 68  int p2, const ch
0bf0: 61 72 20 2a 7a 50 33 2c 69 6e 74 20 70 33 74 79  ar *zP3,int p3ty
0c00: 70 65 29 7b 0a 20 20 69 6e 74 20 61 64 64 72 20  pe){.  int addr 
0c10: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64  = sqlite3VdbeAdd
0c20: 4f 70 28 70 2c 20 6f 70 2c 20 70 31 2c 20 70 32  Op(p, op, p1, p2
0c30: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
0c40: 43 68 61 6e 67 65 50 33 28 70 2c 20 61 64 64 72  ChangeP3(p, addr
0c50: 2c 20 7a 50 33 2c 20 70 33 74 79 70 65 29 3b 0a  , zP3, p3type);.
0c60: 20 20 72 65 74 75 72 6e 20 61 64 64 72 3b 0a 7d    return addr;.}
0c70: 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61  ../*.** Create a
0c80: 20 6e 65 77 20 73 79 6d 62 6f 6c 69 63 20 6c 61   new symbolic la
0c90: 62 65 6c 20 66 6f 72 20 61 6e 20 69 6e 73 74 72  bel for an instr
0ca0: 75 63 74 69 6f 6e 20 74 68 61 74 20 68 61 73 20  uction that has 
0cb0: 79 65 74 20 74 6f 20 62 65 0a 2a 2a 20 63 6f 64  yet to be.** cod
0cc0: 65 64 2e 20 20 54 68 65 20 73 79 6d 62 6f 6c 69  ed.  The symboli
0cd0: 63 20 6c 61 62 65 6c 20 69 73 20 72 65 61 6c 6c  c label is reall
0ce0: 79 20 6a 75 73 74 20 61 20 6e 65 67 61 74 69 76  y just a negativ
0cf0: 65 20 6e 75 6d 62 65 72 2e 20 20 54 68 65 0a 2a  e number.  The.*
0d00: 2a 20 6c 61 62 65 6c 20 63 61 6e 20 62 65 20 75  * label can be u
0d10: 73 65 64 20 61 73 20 74 68 65 20 50 32 20 76 61  sed as the P2 va
0d20: 6c 75 65 20 6f 66 20 61 6e 20 6f 70 65 72 61 74  lue of an operat
0d30: 69 6f 6e 2e 20 20 4c 61 74 65 72 2c 20 77 68 65  ion.  Later, whe
0d40: 6e 0a 2a 2a 20 74 68 65 20 6c 61 62 65 6c 20 69  n.** the label i
0d50: 73 20 72 65 73 6f 6c 76 65 64 20 74 6f 20 61 20  s resolved to a 
0d60: 73 70 65 63 69 66 69 63 20 61 64 64 72 65 73 73  specific address
0d70: 2c 20 74 68 65 20 56 44 42 45 20 77 69 6c 6c 20  , the VDBE will 
0d80: 73 63 61 6e 0a 2a 2a 20 74 68 72 6f 75 67 68 20  scan.** through 
0d90: 69 74 73 20 6f 70 65 72 61 74 69 6f 6e 20 6c 69  its operation li
0da0: 73 74 20 61 6e 64 20 63 68 61 6e 67 65 20 61 6c  st and change al
0db0: 6c 20 76 61 6c 75 65 73 20 6f 66 20 50 32 20 77  l values of P2 w
0dc0: 68 69 63 68 20 6d 61 74 63 68 0a 2a 2a 20 74 68  hich match.** th
0dd0: 65 20 6c 61 62 65 6c 20 69 6e 74 6f 20 74 68 65  e label into the
0de0: 20 72 65 73 6f 6c 76 65 64 20 61 64 64 72 65 73   resolved addres
0df0: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 56 44 42  s..**.** The VDB
0e00: 45 20 6b 6e 6f 77 73 20 74 68 61 74 20 61 20 50  E knows that a P
0e10: 32 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62  2 value is a lab
0e20: 65 6c 20 62 65 63 61 75 73 65 20 6c 61 62 65 6c  el because label
0e30: 73 20 61 72 65 0a 2a 2a 20 61 6c 77 61 79 73 20  s are.** always 
0e40: 6e 65 67 61 74 69 76 65 20 61 6e 64 20 50 32 20  negative and P2 
0e50: 76 61 6c 75 65 73 20 61 72 65 20 73 75 70 70 6f  values are suppo
0e60: 73 65 20 74 6f 20 62 65 20 6e 6f 6e 2d 6e 65 67  se to be non-neg
0e70: 61 74 69 76 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c  ative..** Hence,
0e80: 20 61 20 6e 65 67 61 74 69 76 65 20 50 32 20 76   a negative P2 v
0e90: 61 6c 75 65 20 69 73 20 61 20 6c 61 62 65 6c 20  alue is a label 
0ea0: 74 68 61 74 20 68 61 73 20 79 65 74 20 74 6f 20  that has yet to 
0eb0: 62 65 20 72 65 73 6f 6c 76 65 64 2e 0a 2a 2a 0a  be resolved..**.
0ec0: 2a 2a 20 5a 65 72 6f 20 69 73 20 72 65 74 75 72  ** Zero is retur
0ed0: 6e 65 64 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28  ned if a malloc(
0ee0: 29 20 66 61 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20  ) fails..*/.int 
0ef0: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c  sqlite3VdbeMakeL
0f00: 61 62 65 6c 28 56 64 62 65 20 2a 70 29 7b 0a 20  abel(Vdbe *p){. 
0f10: 20 69 6e 74 20 69 3b 0a 20 20 69 20 3d 20 70 2d   int i;.  i = p-
0f20: 3e 6e 4c 61 62 65 6c 2b 2b 3b 0a 20 20 61 73 73  >nLabel++;.  ass
0f30: 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  ert( p->magic==V
0f40: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29  DBE_MAGIC_INIT )
0f50: 3b 0a 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4c  ;.  if( i>=p->nL
0f60: 61 62 65 6c 41 6c 6c 6f 63 20 29 7b 0a 20 20 20  abelAlloc ){.   
0f70: 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20   p->nLabelAlloc 
0f80: 3d 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63  = p->nLabelAlloc
0f90: 2a 32 20 2b 20 31 30 3b 0a 20 20 20 20 70 2d 3e  *2 + 10;.    p->
0fa0: 61 4c 61 62 65 6c 20 3d 20 73 71 6c 69 74 65 52  aLabel = sqliteR
0fb0: 65 61 6c 6c 6f 63 28 20 70 2d 3e 61 4c 61 62 65  ealloc( p->aLabe
0fc0: 6c 2c 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f  l, p->nLabelAllo
0fd0: 63 2a 73 69 7a 65 6f 66 28 70 2d 3e 61 4c 61 62  c*sizeof(p->aLab
0fe0: 65 6c 5b 30 5d 29 29 3b 0a 20 20 7d 0a 20 20 69  el[0]));.  }.  i
0ff0: 66 28 20 70 2d 3e 61 4c 61 62 65 6c 20 29 7b 0a  f( p->aLabel ){.
1000: 20 20 20 20 70 2d 3e 61 4c 61 62 65 6c 5b 69 5d      p->aLabel[i]
1010: 20 3d 20 2d 31 3b 0a 20 20 7d 0a 20 20 72 65 74   = -1;.  }.  ret
1020: 75 72 6e 20 2d 31 2d 69 3b 0a 7d 0a 0a 2f 2a 0a  urn -1-i;.}../*.
1030: 2a 2a 20 52 65 73 6f 6c 76 65 20 6c 61 62 65 6c  ** Resolve label
1040: 20 22 78 22 20 74 6f 20 62 65 20 74 68 65 20 61   "x" to be the a
1050: 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65  ddress of the ne
1060: 78 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74  xt instruction t
1070: 6f 0a 2a 2a 20 62 65 20 69 6e 73 65 72 74 65 64  o.** be inserted
1080: 2e 20 20 54 68 65 20 70 61 72 61 6d 65 74 65 72  .  The parameter
1090: 20 22 78 22 20 6d 75 73 74 20 68 61 76 65 20 62   "x" must have b
10a0: 65 65 6e 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  een obtained fro
10b0: 6d 0a 2a 2a 20 61 20 70 72 69 6f 72 20 63 61 6c  m.** a prior cal
10c0: 6c 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65  l to sqlite3Vdbe
10d0: 4d 61 6b 65 4c 61 62 65 6c 28 29 2e 0a 2a 2f 0a  MakeLabel()..*/.
10e0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
10f0: 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62  ResolveLabel(Vdb
1100: 65 20 2a 70 2c 20 69 6e 74 20 78 29 7b 0a 20 20  e *p, int x){.  
1110: 69 6e 74 20 6a 20 3d 20 2d 31 2d 78 3b 0a 20 20  int j = -1-x;.  
1120: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
1130: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
1140: 54 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6a  T );.  assert( j
1150: 3e 3d 30 20 26 26 20 6a 3c 70 2d 3e 6e 4c 61 62  >=0 && j<p->nLab
1160: 65 6c 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61  el );.  if( p->a
1170: 4c 61 62 65 6c 20 29 7b 0a 20 20 20 20 70 2d 3e  Label ){.    p->
1180: 61 4c 61 62 65 6c 5b 6a 5d 20 3d 20 70 2d 3e 6e  aLabel[j] = p->n
1190: 4f 70 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  Op;.  }.}../*.**
11a0: 20 52 65 74 75 72 6e 20 6e 6f 6e 2d 7a 65 72 6f   Return non-zero
11b0: 20 69 66 20 6f 70 63 6f 64 65 20 27 6f 70 27 20   if opcode 'op' 
11c0: 69 73 20 67 75 61 72 65 6e 74 65 65 64 20 6e 6f  is guarenteed no
11d0: 74 20 74 6f 20 70 75 73 68 20 6d 6f 72 65 20 76  t to push more v
11e0: 61 6c 75 65 73 0a 2a 2a 20 6f 6e 74 6f 20 74 68  alues.** onto th
11f0: 65 20 56 44 42 45 20 73 74 61 63 6b 20 74 68 61  e VDBE stack tha
1200: 6e 20 69 74 20 70 6f 70 73 20 6f 66 66 2e 0a 2a  n it pops off..*
1210: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6f 70 63  /.static int opc
1220: 6f 64 65 4e 6f 50 75 73 68 28 75 38 20 6f 70 29  odeNoPush(u8 op)
1230: 7b 0a 20 20 2f 2a 20 54 68 65 20 31 30 20 4e 4f  {.  /* The 10 NO
1240: 50 55 53 48 5f 4d 41 53 4b 5f 6e 20 63 6f 6e 73  PUSH_MASK_n cons
1250: 74 61 6e 74 73 20 61 72 65 20 64 65 66 69 6e 65  tants are define
1260: 64 20 69 6e 20 74 68 65 20 61 75 74 6f 6d 61 74  d in the automat
1270: 69 63 61 6c 6c 79 0a 20 20 2a 2a 20 67 65 6e 65  ically.  ** gene
1280: 72 61 74 65 64 20 68 65 61 64 65 72 20 66 69 6c  rated header fil
1290: 65 20 6f 70 63 6f 64 65 73 2e 68 2e 20 45 61 63  e opcodes.h. Eac
12a0: 68 20 69 73 20 61 20 31 36 2d 62 69 74 20 62 69  h is a 16-bit bi
12b0: 74 6d 61 73 6b 2c 20 6f 6e 65 0a 20 20 2a 2a 20  tmask, one.  ** 
12c0: 62 69 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  bit correspondin
12d0: 67 20 74 6f 20 65 61 63 68 20 6f 70 63 6f 64 65  g to each opcode
12e0: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20   implemented by 
12f0: 74 68 65 20 76 69 72 74 75 61 6c 0a 20 20 2a 2a  the virtual.  **
1300: 20 6d 61 63 68 69 6e 65 20 69 6e 20 76 64 62 65   machine in vdbe
1310: 2e 63 2e 20 54 68 65 20 62 69 74 20 69 73 20 74  .c. The bit is t
1320: 72 75 65 20 69 66 20 74 68 65 20 77 6f 72 64 20  rue if the word 
1330: 22 6e 6f 2d 70 75 73 68 22 20 61 70 70 65 61 72  "no-push" appear
1340: 73 0a 20 20 2a 2a 20 69 6e 20 61 20 63 6f 6d 6d  s.  ** in a comm
1350: 65 6e 74 20 6f 6e 20 74 68 65 20 73 61 6d 65 20  ent on the same 
1360: 6c 69 6e 65 20 61 73 20 74 68 65 20 22 63 61 73  line as the "cas
1370: 65 20 4f 50 5f 58 58 58 3a 22 20 69 6e 20 0a 20  e OP_XXX:" in . 
1380: 20 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 45   ** sqlite3VdbeE
1390: 78 65 63 28 29 20 69 6e 20 76 64 62 65 2e 63 2e  xec() in vdbe.c.
13a0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 74 68  .  **.  ** If th
13b0: 65 20 62 69 74 20 69 73 20 74 72 75 65 2c 20 74  e bit is true, t
13c0: 68 65 6e 20 74 68 65 20 63 6f 72 72 65 73 70 6f  hen the correspo
13d0: 6e 64 69 6e 67 20 6f 70 63 6f 64 65 20 69 73 20  nding opcode is 
13e0: 67 75 61 72 65 6e 74 65 65 64 20 6e 6f 74 0a 20  guarenteed not. 
13f0: 20 2a 2a 20 74 6f 20 67 72 6f 77 20 74 68 65 20   ** to grow the 
1400: 73 74 61 63 6b 20 77 68 65 6e 20 69 74 20 69 73  stack when it is
1410: 20 65 78 65 63 75 74 65 64 2e 20 4f 74 68 65 72   executed. Other
1420: 77 69 73 65 2c 20 69 74 20 6d 61 79 20 67 72 6f  wise, it may gro
1430: 77 20 74 68 65 0a 20 20 2a 2a 20 73 74 61 63 6b  w the.  ** stack
1440: 20 62 79 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20   by at most one 
1450: 65 6e 74 72 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  entry..  **.  **
1460: 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 30 20 63   NOPUSH_MASK_0 c
1470: 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 6f 70  orresponds to op
1480: 63 6f 64 65 73 20 30 20 74 6f 20 31 35 2e 20 4e  codes 0 to 15. N
1490: 4f 50 55 53 48 5f 4d 41 53 4b 5f 31 20 63 6f 6e  OPUSH_MASK_1 con
14a0: 74 61 69 6e 73 0a 20 20 2a 2a 20 6f 6e 65 20 62  tains.  ** one b
14b0: 69 74 20 66 6f 72 20 6f 70 63 6f 64 65 73 20 31  it for opcodes 1
14c0: 36 20 74 6f 20 33 31 2c 20 61 6e 64 20 73 6f 20  6 to 31, and so 
14d0: 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 31 36  on..  **.  ** 16
14e0: 2d 62 69 74 20 62 69 74 6d 61 73 6b 73 20 28 72  -bit bitmasks (r
14f0: 61 74 68 65 72 20 74 68 61 6e 20 33 32 2d 62 69  ather than 32-bi
1500: 74 29 20 61 72 65 20 73 70 65 63 69 66 69 65 64  t) are specified
1510: 20 69 6e 20 6f 70 63 6f 64 65 73 2e 68 20 0a 20   in opcodes.h . 
1520: 20 2a 2a 20 62 65 63 61 75 73 65 20 74 68 65 20   ** because the 
1530: 66 69 6c 65 20 69 73 20 67 65 6e 65 72 61 74 65  file is generate
1540: 64 20 62 79 20 61 6e 20 61 77 6b 20 70 72 6f 67  d by an awk prog
1550: 72 61 6d 2e 20 41 77 6b 20 6d 61 6e 69 70 75 6c  ram. Awk manipul
1560: 61 74 65 73 0a 20 20 2a 2a 20 61 6c 6c 20 6e 75  ates.  ** all nu
1570: 6d 62 65 72 73 20 61 73 20 66 6c 6f 61 74 69 6e  mbers as floatin
1580: 67 2d 70 6f 69 6e 74 20 61 6e 64 20 77 65 20 64  g-point and we d
1590: 6f 6e 27 74 20 77 61 6e 74 20 74 6f 20 72 69 73  on't want to ris
15a0: 6b 20 61 20 72 6f 75 6e 64 69 6e 67 0a 20 20 2a  k a rounding.  *
15b0: 2a 20 65 72 72 6f 72 20 69 66 20 73 6f 6d 65 6f  * error if someo
15c0: 6e 65 20 62 75 69 6c 64 73 20 77 69 74 68 20 61  ne builds with a
15d0: 6e 20 61 77 6b 20 74 68 61 74 20 75 73 65 73 20  n awk that uses 
15e0: 28 66 6f 72 20 65 78 61 6d 70 6c 65 29 20 33 32  (for example) 32
15f0: 2d 62 69 74 20 0a 20 20 2a 2a 20 49 45 45 45 20  -bit .  ** IEEE 
1600: 66 6c 6f 61 74 73 2e 0a 20 20 2a 2f 20 0a 20 20  floats..  */ .  
1610: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 33 32  static const u32
1620: 20 6d 61 73 6b 73 5b 35 5d 20 3d 20 7b 0a 20 20   masks[5] = {.  
1630: 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 30 20    NOPUSH_MASK_0 
1640: 2b 20 28 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 31  + (NOPUSH_MASK_1
1650: 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f 50 55 53  <<16),.    NOPUS
1660: 48 5f 4d 41 53 4b 5f 32 20 2b 20 28 4e 4f 50 55  H_MASK_2 + (NOPU
1670: 53 48 5f 4d 41 53 4b 5f 33 3c 3c 31 36 29 2c 0a  SH_MASK_3<<16),.
1680: 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f      NOPUSH_MASK_
1690: 34 20 2b 20 28 4e 4f 50 55 53 48 5f 4d 41 53 4b  4 + (NOPUSH_MASK
16a0: 5f 35 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f 50  _5<<16),.    NOP
16b0: 55 53 48 5f 4d 41 53 4b 5f 36 20 2b 20 28 4e 4f  USH_MASK_6 + (NO
16c0: 50 55 53 48 5f 4d 41 53 4b 5f 37 3c 3c 31 36 29  PUSH_MASK_7<<16)
16d0: 2c 0a 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53  ,.    NOPUSH_MAS
16e0: 4b 5f 38 20 2b 20 28 4e 4f 50 55 53 48 5f 4d 41  K_8 + (NOPUSH_MA
16f0: 53 4b 5f 39 3c 3c 31 36 29 0a 20 20 7d 3b 0a 20  SK_9<<16).  };. 
1700: 20 72 65 74 75 72 6e 20 28 6d 61 73 6b 73 5b 6f   return (masks[o
1710: 70 3e 3e 35 5d 20 26 20 28 31 3c 3c 28 6f 70 26  p>>5] & (1<<(op&
1720: 30 78 31 46 29 29 29 3b 0a 7d 0a 0a 23 69 66 6e  0x1F)));.}..#ifn
1730: 64 65 66 20 4e 44 45 42 55 47 0a 69 6e 74 20 73  def NDEBUG.int s
1740: 71 6c 69 74 65 33 56 64 62 65 4f 70 63 6f 64 65  qlite3VdbeOpcode
1750: 4e 6f 50 75 73 68 28 75 38 20 6f 70 29 7b 0a 20  NoPush(u8 op){. 
1760: 20 72 65 74 75 72 6e 20 6f 70 63 6f 64 65 4e 6f   return opcodeNo
1770: 50 75 73 68 28 6f 70 29 3b 0a 7d 0a 23 65 6e 64  Push(op);.}.#end
1780: 69 66 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 70 20 74  if../*.** Loop t
1790: 68 72 6f 75 67 68 20 74 68 65 20 70 72 6f 67 72  hrough the progr
17a0: 61 6d 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 50  am looking for P
17b0: 32 20 76 61 6c 75 65 73 20 74 68 61 74 20 61 72  2 values that ar
17c0: 65 20 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 45  e negative..** E
17d0: 61 63 68 20 73 75 63 68 20 76 61 6c 75 65 20 69  ach such value i
17e0: 73 20 61 20 6c 61 62 65 6c 2e 20 20 52 65 73 6f  s a label.  Reso
17f0: 6c 76 65 20 74 68 65 20 6c 61 62 65 6c 20 62 79  lve the label by
1800: 20 73 65 74 74 69 6e 67 20 74 68 65 20 50 32 0a   setting the P2.
1810: 2a 2a 20 76 61 6c 75 65 20 74 6f 20 69 74 73 20  ** value to its 
1820: 63 6f 72 72 65 63 74 20 6e 6f 6e 2d 7a 65 72 6f  correct non-zero
1830: 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68   value..**.** Th
1840: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61  is routine is ca
1850: 6c 6c 65 64 20 6f 6e 63 65 20 61 66 74 65 72 20  lled once after 
1860: 61 6c 6c 20 6f 70 63 6f 64 65 73 20 68 61 76 65  all opcodes have
1870: 20 62 65 65 6e 20 69 6e 73 65 72 74 65 64 2e 0a   been inserted..
1880: 2a 2a 0a 2a 2a 20 56 61 72 69 61 62 6c 65 20 2a  **.** Variable *
1890: 70 4d 61 78 46 75 6e 63 41 72 67 73 20 69 73 20  pMaxFuncArgs is 
18a0: 73 65 74 20 74 6f 20 74 68 65 20 6d 61 78 69 6d  set to the maxim
18b0: 75 6d 20 76 61 6c 75 65 20 6f 66 20 61 6e 79 20  um value of any 
18c0: 50 31 20 61 72 67 75 6d 65 6e 74 20 0a 2a 2a 20  P1 argument .** 
18d0: 74 6f 20 61 6e 20 4f 50 5f 46 75 6e 63 74 69 6f  to an OP_Functio
18e0: 6e 20 6f 72 20 50 32 20 74 6f 20 61 6e 20 4f 50  n or P2 to an OP
18f0: 5f 41 67 67 46 75 6e 63 20 6f 70 63 6f 64 65 2e  _AggFunc opcode.
1900: 20 54 68 69 73 20 69 73 20 75 73 65 64 20 62 79   This is used by
1910: 20 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65   .** sqlite3Vdbe
1920: 4d 61 6b 65 52 65 61 64 79 28 29 20 74 6f 20 73  MakeReady() to s
1930: 69 7a 65 20 74 68 65 20 56 64 62 65 2e 61 70 41  ize the Vdbe.apA
1940: 72 67 5b 5d 20 61 72 72 61 79 2e 0a 2a 2a 0a 2a  rg[] array..**.*
1950: 2a 20 54 68 65 20 69 6e 74 65 67 65 72 20 2a 70  * The integer *p
1960: 4d 61 78 53 74 61 63 6b 20 69 73 20 73 65 74 20  MaxStack is set 
1970: 74 6f 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e  to the maximum n
1980: 75 6d 62 65 72 20 6f 66 20 76 64 62 65 20 73 74  umber of vdbe st
1990: 61 63 6b 0a 2a 2a 20 65 6e 74 72 69 65 73 20 74  ack.** entries t
19a0: 68 61 74 20 73 74 61 74 69 63 20 61 6e 61 6c 79  hat static analy
19b0: 73 69 73 20 72 65 76 65 61 6c 73 20 74 68 69 73  sis reveals this
19c0: 20 70 72 6f 67 72 61 6d 20 6d 69 67 68 74 20 6e   program might n
19d0: 65 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  eed..*/.static v
19e0: 6f 69 64 20 72 65 73 6f 6c 76 65 50 32 56 61 6c  oid resolveP2Val
19f0: 75 65 73 28 56 64 62 65 20 2a 70 2c 20 69 6e 74  ues(Vdbe *p, int
1a00: 20 2a 70 4d 61 78 46 75 6e 63 41 72 67 73 2c 20   *pMaxFuncArgs, 
1a10: 69 6e 74 20 2a 70 4d 61 78 53 74 61 63 6b 29 7b  int *pMaxStack){
1a20: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20  .  int i;.  int 
1a30: 6e 4d 61 78 41 72 67 73 20 3d 20 30 3b 0a 20 20  nMaxArgs = 0;.  
1a40: 69 6e 74 20 6e 4d 61 78 53 74 61 63 6b 20 3d 20  int nMaxStack = 
1a50: 70 2d 3e 6e 4f 70 3b 0a 20 20 4f 70 20 2a 70 4f  p->nOp;.  Op *pO
1a60: 70 3b 0a 20 20 69 6e 74 20 2a 61 4c 61 62 65 6c  p;.  int *aLabel
1a70: 20 3d 20 70 2d 3e 61 4c 61 62 65 6c 3b 0a 20 20   = p->aLabel;.  
1a80: 66 6f 72 28 70 4f 70 3d 70 2d 3e 61 4f 70 2c 20  for(pOp=p->aOp, 
1a90: 69 3d 70 2d 3e 6e 4f 70 2d 31 3b 20 69 3e 3d 30  i=p->nOp-1; i>=0
1aa0: 3b 20 69 2d 2d 2c 20 70 4f 70 2b 2b 29 7b 0a 20  ; i--, pOp++){. 
1ab0: 20 20 20 75 38 20 6f 70 63 6f 64 65 20 3d 20 70     u8 opcode = p
1ac0: 4f 70 2d 3e 6f 70 63 6f 64 65 3b 0a 0a 20 20 20  Op->opcode;..   
1ad0: 20 2f 2a 20 54 6f 64 6f 3a 20 4d 61 79 62 65 20   /* Todo: Maybe 
1ae0: 4f 50 5f 41 67 67 46 75 6e 63 20 73 68 6f 75 6c  OP_AggFunc shoul
1af0: 64 20 63 68 61 6e 67 65 20 74 6f 20 75 73 65 20  d change to use 
1b00: 50 31 20 69 6e 20 74 68 65 20 73 61 6d 65 0a 20  P1 in the same. 
1b10: 20 20 20 20 2a 20 77 61 79 20 61 73 20 4f 50 5f      * way as OP_
1b20: 46 75 6e 63 74 69 6f 6e 2e 20 0a 20 20 20 20 20  Function. .     
1b30: 2a 2f 0a 20 20 20 20 69 66 28 20 6f 70 63 6f 64  */.    if( opcod
1b40: 65 3d 3d 4f 50 5f 46 75 6e 63 74 69 6f 6e 20 29  e==OP_Function )
1b50: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d  {.      if( pOp-
1b60: 3e 70 31 3e 6e 4d 61 78 41 72 67 73 20 29 20 6e  >p1>nMaxArgs ) n
1b70: 4d 61 78 41 72 67 73 20 3d 20 70 4f 70 2d 3e 70  MaxArgs = pOp->p
1b80: 31 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28  1;.    }else if(
1b90: 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 41 67 67 46   opcode==OP_AggF
1ba0: 75 6e 63 20 29 7b 0a 20 20 20 20 20 20 69 66 28  unc ){.      if(
1bb0: 20 70 4f 70 2d 3e 70 32 3e 6e 4d 61 78 41 72 67   pOp->p2>nMaxArg
1bc0: 73 20 29 20 6e 4d 61 78 41 72 67 73 20 3d 20 70  s ) nMaxArgs = p
1bd0: 4f 70 2d 3e 70 32 3b 0a 20 20 20 20 7d 0a 0a 20  Op->p2;.    }.. 
1be0: 20 20 20 69 66 28 20 6f 70 63 6f 64 65 4e 6f 50     if( opcodeNoP
1bf0: 75 73 68 28 6f 70 63 6f 64 65 29 20 29 7b 0a 20  ush(opcode) ){. 
1c00: 20 20 20 20 20 6e 4d 61 78 53 74 61 63 6b 2d 2d       nMaxStack--
1c10: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28  ;.    }..    if(
1c20: 20 70 4f 70 2d 3e 70 32 3e 3d 30 20 29 20 63 6f   pOp->p2>=0 ) co
1c30: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 61 73 73 65  ntinue;.    asse
1c40: 72 74 28 20 2d 31 2d 70 4f 70 2d 3e 70 32 3c 70  rt( -1-pOp->p2<p
1c50: 2d 3e 6e 4c 61 62 65 6c 20 29 3b 0a 20 20 20 20  ->nLabel );.    
1c60: 70 4f 70 2d 3e 70 32 20 3d 20 61 4c 61 62 65 6c  pOp->p2 = aLabel
1c70: 5b 2d 31 2d 70 4f 70 2d 3e 70 32 5d 3b 0a 20 20  [-1-pOp->p2];.  
1c80: 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  }.  sqliteFree(p
1c90: 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20 20 70 2d 3e  ->aLabel);.  p->
1ca0: 61 4c 61 62 65 6c 20 3d 20 30 3b 0a 0a 20 20 2a  aLabel = 0;..  *
1cb0: 70 4d 61 78 46 75 6e 63 41 72 67 73 20 3d 20 6e  pMaxFuncArgs = n
1cc0: 4d 61 78 41 72 67 73 3b 0a 20 20 2a 70 4d 61 78  MaxArgs;.  *pMax
1cd0: 53 74 61 63 6b 20 3d 20 6e 4d 61 78 53 74 61 63  Stack = nMaxStac
1ce0: 6b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  k;.}../*.** Retu
1cf0: 72 6e 20 74 68 65 20 61 64 64 72 65 73 73 20 6f  rn the address o
1d00: 66 20 74 68 65 20 6e 65 78 74 20 69 6e 73 74 72  f the next instr
1d10: 75 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 73  uction to be ins
1d20: 65 72 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71  erted..*/.int sq
1d30: 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74  lite3VdbeCurrent
1d40: 41 64 64 72 28 56 64 62 65 20 2a 70 29 7b 0a 20  Addr(Vdbe *p){. 
1d50: 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69   assert( p->magi
1d60: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  c==VDBE_MAGIC_IN
1d70: 49 54 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70  IT );.  return p
1d80: 2d 3e 6e 4f 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ->nOp;.}../*.** 
1d90: 41 64 64 20 61 20 77 68 6f 6c 65 20 6c 69 73 74  Add a whole list
1da0: 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 73 20 74   of operations t
1db0: 6f 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20  o the operation 
1dc0: 73 74 61 63 6b 2e 20 20 52 65 74 75 72 6e 20 74  stack.  Return t
1dd0: 68 65 0a 2a 2a 20 61 64 64 72 65 73 73 20 6f 66  he.** address of
1de0: 20 74 68 65 20 66 69 72 73 74 20 6f 70 65 72 61   the first opera
1df0: 74 69 6f 6e 20 61 64 64 65 64 2e 0a 2a 2f 0a 69  tion added..*/.i
1e00: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 41 64  nt sqlite3VdbeAd
1e10: 64 4f 70 4c 69 73 74 28 56 64 62 65 20 2a 70 2c  dOpList(Vdbe *p,
1e20: 20 69 6e 74 20 6e 4f 70 2c 20 56 64 62 65 4f 70   int nOp, VdbeOp
1e30: 4c 69 73 74 20 63 6f 6e 73 74 20 2a 61 4f 70 29  List const *aOp)
1e40: 7b 0a 20 20 69 6e 74 20 61 64 64 72 3b 0a 20 20  {.  int addr;.  
1e50: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
1e60: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
1e70: 54 20 29 3b 0a 20 20 72 65 73 69 7a 65 4f 70 41  T );.  resizeOpA
1e80: 72 72 61 79 28 70 2c 20 70 2d 3e 6e 4f 70 20 2b  rray(p, p->nOp +
1e90: 20 6e 4f 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e   nOp);.  if( p->
1ea0: 61 4f 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65  aOp==0 ){.    re
1eb0: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 61 64  turn 0;.  }.  ad
1ec0: 64 72 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 69  dr = p->nOp;.  i
1ed0: 66 28 20 6e 4f 70 3e 30 20 29 7b 0a 20 20 20 20  f( nOp>0 ){.    
1ee0: 69 6e 74 20 69 3b 0a 20 20 20 20 56 64 62 65 4f  int i;.    VdbeO
1ef0: 70 4c 69 73 74 20 63 6f 6e 73 74 20 2a 70 49 6e  pList const *pIn
1f00: 20 3d 20 61 4f 70 3b 0a 20 20 20 20 66 6f 72 28   = aOp;.    for(
1f10: 69 3d 30 3b 20 69 3c 6e 4f 70 3b 20 69 2b 2b 2c  i=0; i<nOp; i++,
1f20: 20 70 49 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 69   pIn++){.      i
1f30: 6e 74 20 70 32 20 3d 20 70 49 6e 2d 3e 70 32 3b  nt p2 = pIn->p2;
1f40: 0a 20 20 20 20 20 20 56 64 62 65 4f 70 20 2a 70  .      VdbeOp *p
1f50: 4f 75 74 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 2b  Out = &p->aOp[i+
1f60: 61 64 64 72 5d 3b 0a 20 20 20 20 20 20 70 4f 75  addr];.      pOu
1f70: 74 2d 3e 6f 70 63 6f 64 65 20 3d 20 70 49 6e 2d  t->opcode = pIn-
1f80: 3e 6f 70 63 6f 64 65 3b 0a 20 20 20 20 20 20 70  >opcode;.      p
1f90: 4f 75 74 2d 3e 70 31 20 3d 20 70 49 6e 2d 3e 70  Out->p1 = pIn->p
1fa0: 31 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70  1;.      pOut->p
1fb0: 32 20 3d 20 70 32 3c 30 20 3f 20 61 64 64 72 20  2 = p2<0 ? addr 
1fc0: 2b 20 41 44 44 52 28 70 32 29 20 3a 20 70 32 3b  + ADDR(p2) : p2;
1fd0: 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 33 20  .      pOut->p3 
1fe0: 3d 20 70 49 6e 2d 3e 70 33 3b 0a 20 20 20 20 20  = pIn->p3;.     
1ff0: 20 70 4f 75 74 2d 3e 70 33 74 79 70 65 20 3d 20   pOut->p3type = 
2000: 70 49 6e 2d 3e 70 33 20 3f 20 50 33 5f 53 54 41  pIn->p3 ? P3_STA
2010: 54 49 43 20 3a 20 50 33 5f 4e 4f 54 55 53 45 44  TIC : P3_NOTUSED
2020: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
2030: 44 45 42 55 47 0a 20 20 20 20 20 20 69 66 28 20  DEBUG.      if( 
2040: 73 71 6c 69 74 65 33 5f 76 64 62 65 5f 61 64 64  sqlite3_vdbe_add
2050: 6f 70 5f 74 72 61 63 65 20 29 7b 0a 20 20 20 20  op_trace ){.    
2060: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 50      sqlite3VdbeP
2070: 72 69 6e 74 4f 70 28 30 2c 20 69 2b 61 64 64 72  rintOp(0, i+addr
2080: 2c 20 26 70 2d 3e 61 4f 70 5b 69 2b 61 64 64 72  , &p->aOp[i+addr
2090: 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64  ]);.      }.#end
20a0: 69 66 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e  if.    }.    p->
20b0: 6e 4f 70 20 2b 3d 20 6e 4f 70 3b 0a 20 20 7d 0a  nOp += nOp;.  }.
20c0: 20 20 72 65 74 75 72 6e 20 61 64 64 72 3b 0a 7d    return addr;.}
20d0: 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74  ../*.** Change t
20e0: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20  he value of the 
20f0: 50 31 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61  P1 operand for a
2100: 20 73 70 65 63 69 66 69 63 20 69 6e 73 74 72 75   specific instru
2110: 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72  ction..** This r
2120: 6f 75 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c  outine is useful
2130: 20 77 68 65 6e 20 61 20 6c 61 72 67 65 20 70 72   when a large pr
2140: 6f 67 72 61 6d 20 69 73 20 6c 6f 61 64 65 64 20  ogram is loaded 
2150: 66 72 6f 6d 20 61 0a 2a 2a 20 73 74 61 74 69 63  from a.** static
2160: 20 61 72 72 61 79 20 75 73 69 6e 67 20 73 71 6c   array using sql
2170: 69 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73  ite3VdbeAddOpLis
2180: 74 20 62 75 74 20 77 65 20 77 61 6e 74 20 74 6f  t but we want to
2190: 20 6d 61 6b 65 20 61 0a 2a 2a 20 66 65 77 20 6d   make a.** few m
21a0: 69 6e 6f 72 20 63 68 61 6e 67 65 73 20 74 6f 20  inor changes to 
21b0: 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a  the program..*/.
21c0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
21d0: 43 68 61 6e 67 65 50 31 28 56 64 62 65 20 2a 70  ChangeP1(Vdbe *p
21e0: 2c 20 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20  , int addr, int 
21f0: 76 61 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20  val){.  assert( 
2200: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
2210: 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69  AGIC_INIT );.  i
2220: 66 28 20 70 20 26 26 20 61 64 64 72 3e 3d 30 20  f( p && addr>=0 
2230: 26 26 20 70 2d 3e 6e 4f 70 3e 61 64 64 72 20 26  && p->nOp>addr &
2240: 26 20 70 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20  & p->aOp ){.    
2250: 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 2e 70 31 20  p->aOp[addr].p1 
2260: 3d 20 76 61 6c 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  = val;.  }.}../*
2270: 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 76  .** Change the v
2280: 61 6c 75 65 20 6f 66 20 74 68 65 20 50 32 20 6f  alue of the P2 o
2290: 70 65 72 61 6e 64 20 66 6f 72 20 61 20 73 70 65  perand for a spe
22a0: 63 69 66 69 63 20 69 6e 73 74 72 75 63 74 69 6f  cific instructio
22b0: 6e 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  n..** This routi
22c0: 6e 65 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72  ne is useful for
22d0: 20 73 65 74 74 69 6e 67 20 61 20 6a 75 6d 70 20   setting a jump 
22e0: 64 65 73 74 69 6e 61 74 69 6f 6e 2e 0a 2a 2f 0a  destination..*/.
22f0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
2300: 43 68 61 6e 67 65 50 32 28 56 64 62 65 20 2a 70  ChangeP2(Vdbe *p
2310: 2c 20 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20  , int addr, int 
2320: 76 61 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20  val){.  assert( 
2330: 76 61 6c 3e 3d 30 20 29 3b 0a 20 20 61 73 73 65  val>=0 );.  asse
2340: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
2350: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
2360: 0a 20 20 69 66 28 20 70 20 26 26 20 61 64 64 72  .  if( p && addr
2370: 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f 70 3e 61 64  >=0 && p->nOp>ad
2380: 64 72 20 26 26 20 70 2d 3e 61 4f 70 20 29 7b 0a  dr && p->aOp ){.
2390: 20 20 20 20 70 2d 3e 61 4f 70 5b 61 64 64 72 5d      p->aOp[addr]
23a0: 2e 70 32 20 3d 20 76 61 6c 3b 0a 20 20 7d 0a 7d  .p2 = val;.  }.}
23b0: 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74  ../*.** Change t
23c0: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20  he value of the 
23d0: 50 33 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61  P3 operand for a
23e0: 20 73 70 65 63 69 66 69 63 20 69 6e 73 74 72 75   specific instru
23f0: 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72  ction..** This r
2400: 6f 75 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c  outine is useful
2410: 20 77 68 65 6e 20 61 20 6c 61 72 67 65 20 70 72   when a large pr
2420: 6f 67 72 61 6d 20 69 73 20 6c 6f 61 64 65 64 20  ogram is loaded 
2430: 66 72 6f 6d 20 61 0a 2a 2a 20 73 74 61 74 69 63  from a.** static
2440: 20 61 72 72 61 79 20 75 73 69 6e 67 20 73 71 6c   array using sql
2450: 69 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73  ite3VdbeAddOpLis
2460: 74 20 62 75 74 20 77 65 20 77 61 6e 74 20 74 6f  t but we want to
2470: 20 6d 61 6b 65 20 61 0a 2a 2a 20 66 65 77 20 6d   make a.** few m
2480: 69 6e 6f 72 20 63 68 61 6e 67 65 73 20 74 6f 20  inor changes to 
2490: 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a 2a 2a 0a  the program..**.
24a0: 2a 2a 20 49 66 20 6e 3e 3d 30 20 74 68 65 6e 20  ** If n>=0 then 
24b0: 74 68 65 20 50 33 20 6f 70 65 72 61 6e 64 20 69  the P3 operand i
24c0: 73 20 64 79 6e 61 6d 69 63 2c 20 6d 65 61 6e 69  s dynamic, meani
24d0: 6e 67 20 74 68 61 74 20 61 20 63 6f 70 79 20 6f  ng that a copy o
24e0: 66 0a 2a 2a 20 74 68 65 20 73 74 72 69 6e 67 20  f.** the string 
24f0: 69 73 20 6d 61 64 65 20 69 6e 74 6f 20 6d 65 6d  is made into mem
2500: 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  ory obtained fro
2510: 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29  m sqliteMalloc()
2520: 2e 0a 2a 2a 20 41 20 76 61 6c 75 65 20 6f 66 20  ..** A value of 
2530: 6e 3d 3d 30 20 6d 65 61 6e 73 20 63 6f 70 79 20  n==0 means copy 
2540: 62 79 74 65 73 20 6f 66 20 7a 50 33 20 75 70 20  bytes of zP3 up 
2550: 74 6f 20 61 6e 64 20 69 6e 63 6c 75 64 69 6e 67  to and including
2560: 20 74 68 65 0a 2a 2a 20 66 69 72 73 74 20 6e 75   the.** first nu
2570: 6c 6c 20 62 79 74 65 2e 20 20 49 66 20 6e 3e 30  ll byte.  If n>0
2580: 20 74 68 65 6e 20 63 6f 70 79 20 6e 2b 31 20 62   then copy n+1 b
2590: 79 74 65 73 20 6f 66 20 7a 50 33 2e 0a 2a 2a 0a  ytes of zP3..**.
25a0: 2a 2a 20 49 66 20 6e 3d 3d 50 33 5f 53 54 41 54  ** If n==P3_STAT
25b0: 49 43 20 20 69 74 20 6d 65 61 6e 73 20 74 68 61  IC  it means tha
25c0: 74 20 7a 50 33 20 69 73 20 61 20 70 6f 69 6e 74  t zP3 is a point
25d0: 65 72 20 74 6f 20 61 20 63 6f 6e 73 74 61 6e 74  er to a constant
25e0: 20 73 74 61 74 69 63 0a 2a 2a 20 73 74 72 69 6e   static.** strin
25f0: 67 20 61 6e 64 20 77 65 20 63 61 6e 20 6a 75 73  g and we can jus
2600: 74 20 63 6f 70 79 20 74 68 65 20 70 6f 69 6e 74  t copy the point
2610: 65 72 2e 20 20 6e 3d 3d 50 33 5f 50 4f 49 4e 54  er.  n==P3_POINT
2620: 45 52 20 6d 65 61 6e 73 20 7a 50 33 20 69 73 0a  ER means zP3 is.
2630: 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  ** a pointer to 
2640: 73 6f 6d 65 20 6f 62 6a 65 63 74 20 6f 74 68 65  some object othe
2650: 72 20 74 68 61 6e 20 61 20 73 74 72 69 6e 67 2e  r than a string.
2660: 20 20 6e 3d 3d 50 33 5f 43 4f 4c 4c 53 45 51 20    n==P3_COLLSEQ 
2670: 61 6e 64 0a 2a 2a 20 6e 3d 3d 50 33 5f 4b 45 59  and.** n==P3_KEY
2680: 49 4e 46 4f 20 6d 65 61 6e 20 74 68 61 74 20 7a  INFO mean that z
2690: 50 33 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20  P3 is a pointer 
26a0: 74 6f 20 61 20 43 6f 6c 6c 53 65 71 20 6f 72 20  to a CollSeq or 
26b0: 4b 65 79 49 6e 66 6f 0a 2a 2a 20 73 74 72 75 63  KeyInfo.** struc
26c0: 74 75 72 65 2e 20 20 41 20 63 6f 70 79 20 69 73  ture.  A copy is
26d0: 20 6d 61 64 65 20 6f 66 20 4b 65 79 49 6e 66 6f   made of KeyInfo
26e0: 20 73 74 72 75 63 74 75 72 65 73 20 69 6e 74 6f   structures into
26f0: 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64   memory obtained
2700: 0a 2a 2a 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  .** from sqliteM
2710: 61 6c 6c 6f 63 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  alloc..**.** If 
2720: 61 64 64 72 3c 30 20 74 68 65 6e 20 63 68 61 6e  addr<0 then chan
2730: 67 65 20 50 33 20 6f 6e 20 74 68 65 20 6d 6f 73  ge P3 on the mos
2740: 74 20 72 65 63 65 6e 74 6c 79 20 69 6e 73 65 72  t recently inser
2750: 74 65 64 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e  ted instruction.
2760: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
2770: 56 64 62 65 43 68 61 6e 67 65 50 33 28 56 64 62  VdbeChangeP3(Vdb
2780: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20  e *p, int addr, 
2790: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 33 2c  const char *zP3,
27a0: 20 69 6e 74 20 6e 29 7b 0a 20 20 4f 70 20 2a 70   int n){.  Op *p
27b0: 4f 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d  Op;.  assert( p-
27c0: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
27d0: 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66 28  IC_INIT );.  if(
27e0: 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 61 4f 70 3d   p==0 || p->aOp=
27f0: 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 6e 3d  =0 ){.    if( n=
2800: 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 6e  =P3_DYNAMIC || n
2810: 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e  ==P3_KEYINFO_HAN
2820: 44 4f 46 46 20 29 7b 0a 20 20 20 20 20 20 73 71  DOFF ){.      sq
2830: 6c 69 74 65 46 72 65 65 28 28 76 6f 69 64 2a 29  liteFree((void*)
2840: 7a 50 33 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  zP3);.    }.    
2850: 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66  return;.  }.  if
2860: 28 20 61 64 64 72 3c 30 20 7c 7c 20 61 64 64 72  ( addr<0 || addr
2870: 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20 20 20  >=p->nOp ){.    
2880: 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70 20 2d 20  addr = p->nOp - 
2890: 31 3b 0a 20 20 20 20 69 66 28 20 61 64 64 72 3c  1;.    if( addr<
28a0: 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a  0 ) return;.  }.
28b0: 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b    pOp = &p->aOp[
28c0: 61 64 64 72 5d 3b 0a 20 20 69 66 28 20 70 4f 70  addr];.  if( pOp
28d0: 2d 3e 70 33 20 26 26 20 70 4f 70 2d 3e 70 33 74  ->p3 && pOp->p3t
28e0: 79 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20  ype==P3_DYNAMIC 
28f0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65  ){.    sqliteFre
2900: 65 28 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20  e(pOp->p3);.    
2910: 70 4f 70 2d 3e 70 33 20 3d 20 30 3b 0a 20 20 7d  pOp->p3 = 0;.  }
2920: 0a 20 20 69 66 28 20 7a 50 33 3d 3d 30 20 29 7b  .  if( zP3==0 ){
2930: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 30  .    pOp->p3 = 0
2940: 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70  ;.    pOp->p3typ
2950: 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a  e = P3_NOTUSED;.
2960: 20 20 7d 65 6c 73 65 20 69 66 28 20 6e 3d 3d 50    }else if( n==P
2970: 33 5f 4b 45 59 49 4e 46 4f 20 29 7b 0a 20 20 20  3_KEYINFO ){.   
2980: 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e   KeyInfo *pKeyIn
2990: 66 6f 3b 0a 20 20 20 20 69 6e 74 20 6e 46 69 65  fo;.    int nFie
29a0: 6c 64 2c 20 6e 42 79 74 65 3b 0a 20 20 20 20 6e  ld, nByte;.    n
29b0: 46 69 65 6c 64 20 3d 20 28 28 4b 65 79 49 6e 66  Field = ((KeyInf
29c0: 6f 2a 29 7a 50 33 29 2d 3e 6e 46 69 65 6c 64 3b  o*)zP3)->nField;
29d0: 0a 20 20 20 20 6e 42 79 74 65 20 3d 20 73 69 7a  .    nByte = siz
29e0: 65 6f 66 28 2a 70 4b 65 79 49 6e 66 6f 29 20 2b  eof(*pKeyInfo) +
29f0: 20 28 6e 46 69 65 6c 64 2d 31 29 2a 73 69 7a 65   (nField-1)*size
2a00: 6f 66 28 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f  of(pKeyInfo->aCo
2a10: 6c 6c 5b 30 5d 29 3b 0a 20 20 20 20 70 4b 65 79  ll[0]);.    pKey
2a20: 49 6e 66 6f 20 3d 20 73 71 6c 69 74 65 4d 61 6c  Info = sqliteMal
2a30: 6c 6f 63 52 61 77 28 20 6e 42 79 74 65 20 29 3b  locRaw( nByte );
2a40: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28  .    pOp->p3 = (
2a50: 63 68 61 72 2a 29 70 4b 65 79 49 6e 66 6f 3b 0a  char*)pKeyInfo;.
2a60: 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f      if( pKeyInfo
2a70: 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79   ){.      memcpy
2a80: 28 70 4b 65 79 49 6e 66 6f 2c 20 7a 50 33 2c 20  (pKeyInfo, zP3, 
2a90: 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 70 4f  nByte);.      pO
2aa0: 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4b  p->p3type = P3_K
2ab0: 45 59 49 4e 46 4f 3b 0a 20 20 20 20 7d 65 6c 73  EYINFO;.    }els
2ac0: 65 7b 0a 20 20 20 20 20 20 70 4f 70 2d 3e 70 33  e{.      pOp->p3
2ad0: 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45  type = P3_NOTUSE
2ae0: 44 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  D;.    }.  }else
2af0: 20 69 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e   if( n==P3_KEYIN
2b00: 46 4f 5f 48 41 4e 44 4f 46 46 20 29 7b 0a 20 20  FO_HANDOFF ){.  
2b10: 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63 68 61    pOp->p3 = (cha
2b20: 72 2a 29 7a 50 33 3b 0a 20 20 20 20 70 4f 70 2d  r*)zP3;.    pOp-
2b30: 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4b 45 59  >p3type = P3_KEY
2b40: 49 4e 46 4f 3b 0a 20 20 7d 65 6c 73 65 20 69 66  INFO;.  }else if
2b50: 28 20 6e 3c 30 20 29 7b 0a 20 20 20 20 70 4f 70  ( n<0 ){.    pOp
2b60: 2d 3e 70 33 20 3d 20 28 63 68 61 72 2a 29 7a 50  ->p3 = (char*)zP
2b70: 33 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79  3;.    pOp->p3ty
2b80: 70 65 20 3d 20 6e 3b 0a 20 20 7d 65 6c 73 65 7b  pe = n;.  }else{
2b90: 0a 20 20 20 20 69 66 28 20 6e 3d 3d 30 20 29 20  .    if( n==0 ) 
2ba0: 6e 20 3d 20 73 74 72 6c 65 6e 28 7a 50 33 29 3b  n = strlen(zP3);
2bb0: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 73  .    pOp->p3 = s
2bc0: 71 6c 69 74 65 53 74 72 4e 44 75 70 28 7a 50 33  qliteStrNDup(zP3
2bd0: 2c 20 6e 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70  , n);.    pOp->p
2be0: 33 74 79 70 65 20 3d 20 50 33 5f 44 59 4e 41 4d  3type = P3_DYNAM
2bf0: 49 43 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64  IC;.  }.}..#ifnd
2c00: 65 66 20 4e 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20  ef NDEBUG./*.** 
2c10: 52 65 70 6c 61 63 65 20 74 68 65 20 50 33 20 66  Replace the P3 f
2c20: 69 65 6c 64 20 6f 66 20 74 68 65 20 6d 6f 73 74  ield of the most
2c30: 20 72 65 63 65 6e 74 6c 79 20 63 6f 64 65 64 20   recently coded 
2c40: 69 6e 73 74 72 75 63 74 69 6f 6e 20 77 69 74 68  instruction with
2c50: 0a 2a 2a 20 63 6f 6d 6d 65 6e 74 20 74 65 78 74  .** comment text
2c60: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
2c70: 33 56 64 62 65 43 6f 6d 6d 65 6e 74 28 56 64 62  3VdbeComment(Vdb
2c80: 65 20 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72  e *p, const char
2c90: 20 2a 7a 46 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b   *zFormat, ...){
2ca0: 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20  .  va_list ap;. 
2cb0: 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e   assert( p->nOp>
2cc0: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
2cd0: 2d 3e 61 4f 70 3d 3d 30 20 7c 7c 20 70 2d 3e 61  ->aOp==0 || p->a
2ce0: 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 3d  Op[p->nOp-1].p3=
2cf0: 3d 30 20 29 3b 0a 20 20 76 61 5f 73 74 61 72 74  =0 );.  va_start
2d00: 28 61 70 2c 20 7a 46 6f 72 6d 61 74 29 3b 0a 20  (ap, zFormat);. 
2d10: 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e   sqlite3VdbeChan
2d20: 67 65 50 33 28 70 2c 20 2d 31 2c 20 73 71 6c 69  geP3(p, -1, sqli
2d30: 74 65 33 56 4d 50 72 69 6e 74 66 28 7a 46 6f 72  te3VMPrintf(zFor
2d40: 6d 61 74 2c 20 61 70 29 2c 20 50 33 5f 44 59 4e  mat, ap), P3_DYN
2d50: 41 4d 49 43 29 3b 0a 20 20 76 61 5f 65 6e 64 28  AMIC);.  va_end(
2d60: 61 70 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f  ap);.}.#endif../
2d70: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 50 33 20 6f  *.** If the P3 o
2d80: 70 65 72 61 6e 64 20 74 6f 20 74 68 65 20 73 70  perand to the sp
2d90: 65 63 69 66 69 65 64 20 69 6e 73 74 72 75 63 74  ecified instruct
2da0: 69 6f 6e 20 61 70 70 65 61 72 73 0a 2a 2a 20 74  ion appears.** t
2db0: 6f 20 62 65 20 61 20 71 75 6f 74 65 64 20 73 74  o be a quoted st
2dc0: 72 69 6e 67 20 74 6f 6b 65 6e 2c 20 74 68 65 6e  ring token, then
2dd0: 20 74 68 69 73 20 70 72 6f 63 65 64 75 72 65 20   this procedure 
2de0: 72 65 6d 6f 76 65 73 20 0a 2a 2a 20 74 68 65 20  removes .** the 
2df0: 71 75 6f 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68  quotes..**.** Th
2e00: 65 20 71 75 6f 74 69 6e 67 20 6f 70 65 72 61 74  e quoting operat
2e10: 6f 72 20 63 61 6e 20 62 65 20 65 69 74 68 65 72  or can be either
2e20: 20 61 20 67 72 61 76 65 20 61 73 63 65 6e 74 20   a grave ascent 
2e30: 28 41 53 43 49 49 20 30 78 32 37 29 0a 2a 2a 20  (ASCII 0x27).** 
2e40: 6f 72 20 61 20 64 6f 75 62 6c 65 20 71 75 6f 74  or a double quot
2e50: 65 20 63 68 61 72 61 63 74 65 72 20 28 41 53 43  e character (ASC
2e60: 49 49 20 30 78 32 32 29 2e 20 20 54 77 6f 20 71  II 0x22).  Two q
2e70: 75 6f 74 65 73 20 69 6e 20 61 20 72 6f 77 0a 2a  uotes in a row.*
2e80: 2a 20 72 65 73 6f 6c 76 65 20 74 6f 20 62 65 20  * resolve to be 
2e90: 61 20 73 69 6e 67 6c 65 20 61 63 74 75 61 6c 20  a single actual 
2ea0: 71 75 6f 74 65 20 63 68 61 72 61 63 74 65 72 20  quote character 
2eb0: 77 69 74 68 69 6e 20 74 68 65 20 73 74 72 69 6e  within the strin
2ec0: 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  g..*/.void sqlit
2ed0: 65 33 56 64 62 65 44 65 71 75 6f 74 65 50 33 28  e3VdbeDequoteP3(
2ee0: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64  Vdbe *p, int add
2ef0: 72 29 7b 0a 20 20 4f 70 20 2a 70 4f 70 3b 0a 20  r){.  Op *pOp;. 
2f00: 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69   assert( p->magi
2f10: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  c==VDBE_MAGIC_IN
2f20: 49 54 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61  IT );.  if( p->a
2f30: 4f 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a  Op==0 ) return;.
2f40: 20 20 69 66 28 20 61 64 64 72 3c 30 20 7c 7c 20    if( addr<0 || 
2f50: 61 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a  addr>=p->nOp ){.
2f60: 20 20 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f      addr = p->nO
2f70: 70 20 2d 20 31 3b 0a 20 20 20 20 69 66 28 20 61  p - 1;.    if( a
2f80: 64 64 72 3c 30 20 29 20 72 65 74 75 72 6e 3b 0a  ddr<0 ) return;.
2f90: 20 20 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e    }.  pOp = &p->
2fa0: 61 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 69 66 28  aOp[addr];.  if(
2fb0: 20 70 4f 70 2d 3e 70 33 3d 3d 30 20 7c 7c 20 70   pOp->p3==0 || p
2fc0: 4f 70 2d 3e 70 33 5b 30 5d 3d 3d 30 20 29 20 72  Op->p3[0]==0 ) r
2fd0: 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 70 4f 70  eturn;.  if( pOp
2fe0: 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f 53 54 41  ->p3type==P3_STA
2ff0: 54 49 43 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e  TIC ){.    pOp->
3000: 70 33 20 3d 20 73 71 6c 69 74 65 53 74 72 44 75  p3 = sqliteStrDu
3010: 70 28 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20  p(pOp->p3);.    
3020: 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33  pOp->p3type = P3
3030: 5f 44 59 4e 41 4d 49 43 3b 0a 20 20 7d 0a 20 20  _DYNAMIC;.  }.  
3040: 61 73 73 65 72 74 28 20 70 4f 70 2d 3e 70 33 74  assert( pOp->p3t
3050: 79 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20  ype==P3_DYNAMIC 
3060: 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 65 71 75  );.  sqlite3Dequ
3070: 6f 74 65 28 70 4f 70 2d 3e 70 33 29 3b 0a 7d 0a  ote(pOp->p3);.}.
3080: 0a 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 20 74 68  ./*.** Search th
3090: 65 20 63 75 72 72 65 6e 74 20 70 72 6f 67 72 61  e current progra
30a0: 6d 20 73 74 61 72 74 69 6e 67 20 61 74 20 69 6e  m starting at in
30b0: 73 74 72 75 63 74 69 6f 6e 20 61 64 64 72 20 66  struction addr f
30c0: 6f 72 20 74 68 65 20 67 69 76 65 6e 0a 2a 2a 20  or the given.** 
30d0: 6f 70 63 6f 64 65 20 61 6e 64 20 50 32 20 76 61  opcode and P2 va
30e0: 6c 75 65 2e 20 20 52 65 74 75 72 6e 20 74 68 65  lue.  Return the
30f0: 20 61 64 64 72 65 73 73 20 70 6c 75 73 20 31 20   address plus 1 
3100: 69 66 20 66 6f 75 6e 64 20 61 6e 64 20 30 20 69  if found and 0 i
3110: 66 20 6e 6f 74 0a 2a 2a 20 66 6f 75 6e 64 2e 0a  f not.** found..
3120: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
3130: 62 65 46 69 6e 64 4f 70 28 56 64 62 65 20 2a 70  beFindOp(Vdbe *p
3140: 2c 20 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20  , int addr, int 
3150: 6f 70 2c 20 69 6e 74 20 70 32 29 7b 0a 20 20 69  op, int p2){.  i
3160: 6e 74 20 69 3b 0a 20 20 61 73 73 65 72 74 28 20  nt i;.  assert( 
3170: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
3180: 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 66  AGIC_INIT );.  f
3190: 6f 72 28 69 3d 61 64 64 72 3b 20 69 3c 70 2d 3e  or(i=addr; i<p->
31a0: 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69  nOp; i++){.    i
31b0: 66 28 20 70 2d 3e 61 4f 70 5b 69 5d 2e 6f 70 63  f( p->aOp[i].opc
31c0: 6f 64 65 3d 3d 6f 70 20 26 26 20 70 2d 3e 61 4f  ode==op && p->aO
31d0: 70 5b 69 5d 2e 70 32 3d 3d 70 32 20 29 20 72 65  p[i].p2==p2 ) re
31e0: 74 75 72 6e 20 69 2b 31 3b 0a 20 20 7d 0a 20 20  turn i+1;.  }.  
31f0: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a  return 0;.}../*.
3200: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6f 70  ** Return the op
3210: 63 6f 64 65 20 66 6f 72 20 61 20 67 69 76 65 6e  code for a given
3220: 20 61 64 64 72 65 73 73 2e 0a 2a 2f 0a 56 64 62   address..*/.Vdb
3230: 65 4f 70 20 2a 73 71 6c 69 74 65 33 56 64 62 65  eOp *sqlite3Vdbe
3240: 47 65 74 4f 70 28 56 64 62 65 20 2a 70 2c 20 69  GetOp(Vdbe *p, i
3250: 6e 74 20 61 64 64 72 29 7b 0a 20 20 61 73 73 65  nt addr){.  asse
3260: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
3270: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
3280: 0a 20 20 61 73 73 65 72 74 28 20 61 64 64 72 3e  .  assert( addr>
3290: 3d 30 20 26 26 20 61 64 64 72 3c 70 2d 3e 6e 4f  =0 && addr<p->nO
32a0: 70 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 26 70  p );.  return &p
32b0: 2d 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 7d 0a 0a  ->aOp[addr];.}..
32c0: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c  #if !defined(SQL
32d0: 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e  ITE_OMIT_EXPLAIN
32e0: 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 28 4e 44  ) || !defined(ND
32f0: 45 42 55 47 29 20 5c 0a 20 20 20 20 20 7c 7c 20  EBUG) \.     || 
3300: 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52 4f  defined(VDBE_PRO
3310: 46 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e 65 64  FILE) || defined
3320: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 2f  (SQLITE_DEBUG)./
3330: 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 61 20 73  *.** Compute a s
3340: 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72  tring that descr
3350: 69 62 65 73 20 74 68 65 20 50 33 20 70 61 72 61  ibes the P3 para
3360: 6d 65 74 65 72 20 66 6f 72 20 61 6e 20 6f 70 63  meter for an opc
3370: 6f 64 65 2e 0a 2a 2a 20 55 73 65 20 7a 54 65 6d  ode..** Use zTem
3380: 70 20 66 6f 72 20 61 6e 79 20 72 65 71 75 69 72  p for any requir
3390: 65 64 20 74 65 6d 70 6f 72 61 72 79 20 62 75 66  ed temporary buf
33a0: 66 65 72 20 73 70 61 63 65 2e 0a 2a 2f 0a 73 74  fer space..*/.st
33b0: 61 74 69 63 20 63 68 61 72 20 2a 64 69 73 70 6c  atic char *displ
33c0: 61 79 50 33 28 4f 70 20 2a 70 4f 70 2c 20 63 68  ayP3(Op *pOp, ch
33d0: 61 72 20 2a 7a 54 65 6d 70 2c 20 69 6e 74 20 6e  ar *zTemp, int n
33e0: 54 65 6d 70 29 7b 0a 20 20 63 68 61 72 20 2a 7a  Temp){.  char *z
33f0: 50 33 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 54  P3;.  assert( nT
3400: 65 6d 70 3e 3d 32 30 20 29 3b 0a 20 20 73 77 69  emp>=20 );.  swi
3410: 74 63 68 28 20 70 4f 70 2d 3e 70 33 74 79 70 65  tch( pOp->p3type
3420: 20 29 7b 0a 20 20 20 20 63 61 73 65 20 50 33 5f   ){.    case P3_
3430: 50 4f 49 4e 54 45 52 3a 20 7b 0a 20 20 20 20 20  POINTER: {.     
3440: 20 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20   sprintf(zTemp, 
3450: 22 70 74 72 28 25 23 78 29 22 2c 20 28 69 6e 74  "ptr(%#x)", (int
3460: 29 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20 20  )pOp->p3);.     
3470: 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20   zP3 = zTemp;.  
3480: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
3490: 0a 20 20 20 20 63 61 73 65 20 50 33 5f 4b 45 59  .    case P3_KEY
34a0: 49 4e 46 4f 3a 20 7b 0a 20 20 20 20 20 20 69 6e  INFO: {.      in
34b0: 74 20 69 2c 20 6a 3b 0a 20 20 20 20 20 20 4b 65  t i, j;.      Ke
34c0: 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20  yInfo *pKeyInfo 
34d0: 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 70 4f 70 2d  = (KeyInfo*)pOp-
34e0: 3e 70 33 3b 0a 20 20 20 20 20 20 73 70 72 69 6e  >p3;.      sprin
34f0: 74 66 28 7a 54 65 6d 70 2c 20 22 6b 65 79 69 6e  tf(zTemp, "keyin
3500: 66 6f 28 25 64 22 2c 20 70 4b 65 79 49 6e 66 6f  fo(%d", pKeyInfo
3510: 2d 3e 6e 46 69 65 6c 64 29 3b 0a 20 20 20 20 20  ->nField);.     
3520: 20 69 20 3d 20 73 74 72 6c 65 6e 28 7a 54 65 6d   i = strlen(zTem
3530: 70 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d  p);.      for(j=
3540: 30 3b 20 6a 3c 70 4b 65 79 49 6e 66 6f 2d 3e 6e  0; j<pKeyInfo->n
3550: 46 69 65 6c 64 3b 20 6a 2b 2b 29 7b 0a 20 20 20  Field; j++){.   
3560: 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43       CollSeq *pC
3570: 6f 6c 6c 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e  oll = pKeyInfo->
3580: 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 20 20  aColl[j];.      
3590: 20 20 69 66 28 20 70 43 6f 6c 6c 20 29 7b 0a 20    if( pColl ){. 
35a0: 20 20 20 20 20 20 20 20 20 69 6e 74 20 6e 20 3d           int n =
35b0: 20 73 74 72 6c 65 6e 28 70 43 6f 6c 6c 2d 3e 7a   strlen(pColl->z
35c0: 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20  Name);.         
35d0: 20 69 66 28 20 69 2b 6e 3e 6e 54 65 6d 70 2d 36   if( i+n>nTemp-6
35e0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
35f0: 73 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d  strcpy(&zTemp[i]
3600: 2c 22 2c 2e 2e 2e 22 29 3b 0a 20 20 20 20 20 20  ,",...");.      
3610: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3620: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
3630: 20 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20     zTemp[i++] = 
3640: 27 2c 27 3b 0a 20 20 20 20 20 20 20 20 20 20 69  ',';.          i
3650: 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f  f( pKeyInfo->aSo
3660: 72 74 4f 72 64 65 72 20 26 26 20 70 4b 65 79 49  rtOrder && pKeyI
3670: 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b  nfo->aSortOrder[
3680: 6a 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  j] ){.          
3690: 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20 27    zTemp[i++] = '
36a0: 2d 27 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  -';.          }.
36b0: 20 20 20 20 20 20 20 20 20 20 73 74 72 63 70 79            strcpy
36c0: 28 26 7a 54 65 6d 70 5b 69 5d 2c 20 70 43 6f 6c  (&zTemp[i], pCol
36d0: 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20  l->zName);.     
36e0: 20 20 20 20 20 69 20 2b 3d 20 6e 3b 0a 20 20 20       i += n;.   
36f0: 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 69       }else if( i
3700: 2b 34 3c 6e 54 65 6d 70 2d 36 20 29 7b 0a 20 20  +4<nTemp-6 ){.  
3710: 20 20 20 20 20 20 20 20 73 74 72 63 70 79 28 26          strcpy(&
3720: 7a 54 65 6d 70 5b 69 5d 2c 22 2c 6e 69 6c 22 29  zTemp[i],",nil")
3730: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 20 2b 3d  ;.          i +=
3740: 20 34 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20   4;.        }.  
3750: 20 20 20 20 7d 0a 20 20 20 20 20 20 7a 54 65 6d      }.      zTem
3760: 70 5b 69 2b 2b 5d 20 3d 20 27 29 27 3b 0a 20 20  p[i++] = ')';.  
3770: 20 20 20 20 7a 54 65 6d 70 5b 69 5d 20 3d 20 30      zTemp[i] = 0
3780: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  ;.      assert( 
3790: 69 3c 6e 54 65 6d 70 20 29 3b 0a 20 20 20 20 20  i<nTemp );.     
37a0: 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20   zP3 = zTemp;.  
37b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
37c0: 0a 20 20 20 20 63 61 73 65 20 50 33 5f 43 4f 4c  .    case P3_COL
37d0: 4c 53 45 51 3a 20 7b 0a 20 20 20 20 20 20 43 6f  LSEQ: {.      Co
37e0: 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28  llSeq *pColl = (
37f0: 43 6f 6c 6c 53 65 71 2a 29 70 4f 70 2d 3e 70 33  CollSeq*)pOp->p3
3800: 3b 0a 20 20 20 20 20 20 73 70 72 69 6e 74 66 28  ;.      sprintf(
3810: 7a 54 65 6d 70 2c 20 22 63 6f 6c 6c 73 65 71 28  zTemp, "collseq(
3820: 25 2e 32 30 73 29 22 2c 20 70 43 6f 6c 6c 2d 3e  %.20s)", pColl->
3830: 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 7a 50  zName);.      zP
3840: 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20 20 20  3 = zTemp;.     
3850: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
3860: 20 20 63 61 73 65 20 50 33 5f 46 55 4e 43 44 45    case P3_FUNCDE
3870: 46 3a 20 7b 0a 20 20 20 20 20 20 46 75 6e 63 44  F: {.      FuncD
3880: 65 66 20 2a 70 44 65 66 20 3d 20 28 46 75 6e 63  ef *pDef = (Func
3890: 44 65 66 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20  Def*)pOp->p3;.  
38a0: 20 20 20 20 63 68 61 72 20 7a 4e 75 6d 5b 33 30      char zNum[30
38b0: 5d 3b 0a 20 20 20 20 20 20 73 70 72 69 6e 74 66  ];.      sprintf
38c0: 28 7a 54 65 6d 70 2c 20 22 25 2e 2a 73 22 2c 20  (zTemp, "%.*s", 
38d0: 6e 54 65 6d 70 2c 20 70 44 65 66 2d 3e 7a 4e 61  nTemp, pDef->zNa
38e0: 6d 65 29 3b 0a 20 20 20 20 20 20 73 70 72 69 6e  me);.      sprin
38f0: 74 66 28 7a 4e 75 6d 2c 22 28 25 64 29 22 2c 20  tf(zNum,"(%d)", 
3900: 70 44 65 66 2d 3e 6e 41 72 67 29 3b 0a 20 20 20  pDef->nArg);.   
3910: 20 20 20 69 66 28 20 73 74 72 6c 65 6e 28 7a 54     if( strlen(zT
3920: 65 6d 70 29 2b 73 74 72 6c 65 6e 28 7a 4e 75 6d  emp)+strlen(zNum
3930: 29 2b 31 3c 3d 6e 54 65 6d 70 20 29 7b 0a 20 20  )+1<=nTemp ){.  
3940: 20 20 20 20 20 20 73 74 72 63 61 74 28 7a 54 65        strcat(zTe
3950: 6d 70 2c 20 7a 4e 75 6d 29 3b 0a 20 20 20 20 20  mp, zNum);.     
3960: 20 7d 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a   }.      zP3 = z
3970: 54 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61  Temp;.      brea
3980: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66  k;.    }.    def
3990: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 7a 50  ault: {.      zP
39a0: 33 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a 20 20 20  3 = pOp->p3;.   
39b0: 20 20 20 69 66 28 20 7a 50 33 3d 3d 30 20 7c 7c     if( zP3==0 ||
39c0: 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50   pOp->opcode==OP
39d0: 5f 4e 6f 6f 70 20 29 7b 0a 20 20 20 20 20 20 20  _Noop ){.       
39e0: 20 7a 50 33 20 3d 20 22 22 3b 0a 20 20 20 20 20   zP3 = "";.     
39f0: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72   }.    }.  }.  r
3a00: 65 74 75 72 6e 20 7a 50 33 3b 0a 7d 0a 23 65 6e  eturn zP3;.}.#en
3a10: 64 69 66 0a 0a 0a 23 69 66 20 64 65 66 69 6e 65  dif...#if define
3a20: 64 28 56 44 42 45 5f 50 52 4f 46 49 4c 45 29 20  d(VDBE_PROFILE) 
3a30: 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54  || defined(SQLIT
3a40: 45 5f 44 45 42 55 47 29 0a 2f 2a 0a 2a 2a 20 50  E_DEBUG)./*.** P
3a50: 72 69 6e 74 20 61 20 73 69 6e 67 6c 65 20 6f 70  rint a single op
3a60: 63 6f 64 65 2e 20 20 54 68 69 73 20 72 6f 75 74  code.  This rout
3a70: 69 6e 65 20 69 73 20 75 73 65 64 20 66 6f 72 20  ine is used for 
3a80: 64 65 62 75 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a  debugging only..
3a90: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
3aa0: 64 62 65 50 72 69 6e 74 4f 70 28 46 49 4c 45 20  dbePrintOp(FILE 
3ab0: 2a 70 4f 75 74 2c 20 69 6e 74 20 70 63 2c 20 4f  *pOut, int pc, O
3ac0: 70 20 2a 70 4f 70 29 7b 0a 20 20 63 68 61 72 20  p *pOp){.  char 
3ad0: 2a 7a 50 33 3b 0a 20 20 63 68 61 72 20 7a 50 74  *zP3;.  char zPt
3ae0: 72 5b 35 30 5d 3b 0a 20 20 73 74 61 74 69 63 20  r[50];.  static 
3af0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 6f 72  const char *zFor
3b00: 6d 61 74 31 20 3d 20 22 25 34 64 20 25 2d 31 33  mat1 = "%4d %-13
3b10: 73 20 25 34 64 20 25 34 64 20 25 73 5c 6e 22 3b  s %4d %4d %s\n";
3b20: 0a 20 20 69 66 28 20 70 4f 75 74 3d 3d 30 20 29  .  if( pOut==0 )
3b30: 20 70 4f 75 74 20 3d 20 73 74 64 6f 75 74 3b 0a   pOut = stdout;.
3b40: 20 20 7a 50 33 20 3d 20 64 69 73 70 6c 61 79 50    zP3 = displayP
3b50: 33 28 70 4f 70 2c 20 7a 50 74 72 2c 20 73 69 7a  3(pOp, zPtr, siz
3b60: 65 6f 66 28 7a 50 74 72 29 29 3b 0a 20 20 66 70  eof(zPtr));.  fp
3b70: 72 69 6e 74 66 28 70 4f 75 74 2c 20 7a 46 6f 72  rintf(pOut, zFor
3b80: 6d 61 74 31 2c 0a 20 20 20 20 20 20 70 63 2c 20  mat1,.      pc, 
3b90: 73 71 6c 69 74 65 33 4f 70 63 6f 64 65 4e 61 6d  sqlite3OpcodeNam
3ba0: 65 73 5b 70 4f 70 2d 3e 6f 70 63 6f 64 65 5d 2c  es[pOp->opcode],
3bb0: 20 70 4f 70 2d 3e 70 31 2c 20 70 4f 70 2d 3e 70   pOp->p1, pOp->p
3bc0: 32 2c 20 7a 50 33 29 3b 0a 20 20 66 66 6c 75 73  2, zP3);.  fflus
3bd0: 68 28 70 4f 75 74 29 3b 0a 7d 0a 23 65 6e 64 69  h(pOut);.}.#endi
3be0: 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65  f../*.** Release
3bf0: 20 61 6e 20 61 72 72 61 79 20 6f 66 20 4e 20 4d   an array of N M
3c00: 65 6d 20 65 6c 65 6d 65 6e 74 73 0a 2a 2f 0a 73  em elements.*/.s
3c10: 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61  tatic void relea
3c20: 73 65 4d 65 6d 41 72 72 61 79 28 4d 65 6d 20 2a  seMemArray(Mem *
3c30: 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 69 66 28  p, int N){.  if(
3c40: 20 70 20 29 7b 0a 20 20 20 20 77 68 69 6c 65 28   p ){.    while(
3c50: 20 4e 2d 2d 3e 30 20 29 7b 0a 20 20 20 20 20 20   N-->0 ){.      
3c60: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
3c70: 6c 65 61 73 65 28 70 2b 2b 29 3b 0a 20 20 20 20  lease(p++);.    
3c80: 7d 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66  }.  }.}..#ifndef
3c90: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50   SQLITE_OMIT_EXP
3ca0: 4c 41 49 4e 0a 2f 2a 0a 2a 2a 20 47 69 76 65 20  LAIN./*.** Give 
3cb0: 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 74 68 65  a listing of the
3cc0: 20 70 72 6f 67 72 61 6d 20 69 6e 20 74 68 65 20   program in the 
3cd0: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e  virtual machine.
3ce0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 72  .**.** The inter
3cf0: 66 61 63 65 20 69 73 20 74 68 65 20 73 61 6d 65  face is the same
3d00: 20 61 73 20 73 71 6c 69 74 65 33 56 64 62 65 45   as sqlite3VdbeE
3d10: 78 65 63 28 29 2e 20 20 42 75 74 20 69 6e 73 74  xec().  But inst
3d20: 65 61 64 20 6f 66 0a 2a 2a 20 72 75 6e 6e 69 6e  ead of.** runnin
3d30: 67 20 74 68 65 20 63 6f 64 65 2c 20 69 74 20 69  g the code, it i
3d40: 6e 76 6f 6b 65 73 20 74 68 65 20 63 61 6c 6c 62  nvokes the callb
3d50: 61 63 6b 20 6f 6e 63 65 20 66 6f 72 20 65 61 63  ack once for eac
3d60: 68 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a  h instruction..*
3d70: 2a 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69  * This feature i
3d80: 73 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d  s used to implem
3d90: 65 6e 74 20 22 45 58 50 4c 41 49 4e 22 2e 0a 2a  ent "EXPLAIN"..*
3da0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
3db0: 65 4c 69 73 74 28 0a 20 20 56 64 62 65 20 2a 70  eList(.  Vdbe *p
3dc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3dd0: 20 20 20 2f 2a 20 54 68 65 20 56 44 42 45 20 2a     /* The VDBE *
3de0: 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a  /.){.  sqlite3 *
3df0: 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69 6e  db = p->db;.  in
3e00: 74 20 69 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  t i;.  int rc = 
3e10: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73  SQLITE_OK;..  as
3e20: 73 65 72 74 28 20 70 2d 3e 65 78 70 6c 61 69 6e  sert( p->explain
3e30: 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67   );.  if( p->mag
3e40: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52  ic!=VDBE_MAGIC_R
3e50: 55 4e 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49  UN ) return SQLI
3e60: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 61 73 73  TE_MISUSE;.  ass
3e70: 65 72 74 28 20 64 62 2d 3e 6d 61 67 69 63 3d 3d  ert( db->magic==
3e80: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53  SQLITE_MAGIC_BUS
3e90: 59 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  Y );.  assert( p
3ea0: 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ->rc==SQLITE_OK 
3eb0: 7c 7c 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45  || p->rc==SQLITE
3ec0: 5f 42 55 53 59 20 29 3b 0a 0a 20 20 2f 2a 20 45  _BUSY );..  /* E
3ed0: 76 65 6e 20 74 68 6f 75 67 68 20 74 68 69 73 20  ven though this 
3ee0: 6f 70 63 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20  opcode does not 
3ef0: 70 75 74 20 64 79 6e 61 6d 69 63 20 73 74 72 69  put dynamic stri
3f00: 6e 67 73 20 6f 6e 74 6f 20 74 68 65 0a 20 20 2a  ngs onto the.  *
3f10: 2a 20 74 68 65 20 73 74 61 63 6b 2c 20 74 68 65  * the stack, the
3f20: 79 20 6d 61 79 20 62 65 63 6f 6d 65 20 64 79 6e  y may become dyn
3f30: 61 6d 69 63 20 69 66 20 74 68 65 20 75 73 65 72  amic if the user
3f40: 20 63 61 6c 6c 73 0a 20 20 2a 2a 20 73 71 6c 69   calls.  ** sqli
3f50: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31  te3_column_text1
3f60: 36 28 29 2c 20 63 61 75 73 69 6e 67 20 61 20 74  6(), causing a t
3f70: 72 61 6e 73 6c 61 74 69 6f 6e 20 74 6f 20 55 54  ranslation to UT
3f80: 46 2d 31 36 20 65 6e 63 6f 64 69 6e 67 2e 0a 20  F-16 encoding.. 
3f90: 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 54 6f   */.  if( p->pTo
3fa0: 73 3d 3d 26 70 2d 3e 61 53 74 61 63 6b 5b 34 5d  s==&p->aStack[4]
3fb0: 20 29 7b 0a 20 20 20 20 72 65 6c 65 61 73 65 4d   ){.    releaseM
3fc0: 65 6d 41 72 72 61 79 28 70 2d 3e 61 53 74 61 63  emArray(p->aStac
3fd0: 6b 2c 20 35 29 3b 0a 20 20 7d 0a 20 20 70 2d 3e  k, 5);.  }.  p->
3fe0: 72 65 73 4f 6e 53 74 61 63 6b 20 3d 20 30 3b 0a  resOnStack = 0;.
3ff0: 0a 0a 20 20 69 20 3d 20 70 2d 3e 70 63 2b 2b 3b  ..  i = p->pc++;
4000: 0a 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4f 70  .  if( i>=p->nOp
4010: 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20   ){.    p->rc = 
4020: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 72  SQLITE_OK;.    r
4030: 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b  c = SQLITE_DONE;
4040: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d  .  }else if( db-
4050: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
4060: 49 6e 74 65 72 72 75 70 74 20 29 7b 0a 20 20 20  Interrupt ){.   
4070: 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53   db->flags &= ~S
4080: 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b  QLITE_Interrupt;
4090: 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c  .    p->rc = SQL
40a0: 49 54 45 5f 49 4e 54 45 52 52 55 50 54 3b 0a 20  ITE_INTERRUPT;. 
40b0: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45     rc = SQLITE_E
40c0: 52 52 4f 52 3b 0a 20 20 20 20 73 71 6c 69 74 65  RROR;.    sqlite
40d0: 33 53 65 74 53 74 72 69 6e 67 28 26 70 2d 3e 7a  3SetString(&p->z
40e0: 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 33 45  ErrMsg, sqlite3E
40f0: 72 72 53 74 72 28 70 2d 3e 72 63 29 2c 20 28 63  rrStr(p->rc), (c
4100: 68 61 72 2a 29 30 29 3b 0a 20 20 7d 65 6c 73 65  har*)0);.  }else
4110: 7b 0a 20 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20  {.    Op *pOp = 
4120: 26 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20  &p->aOp[i];.    
4130: 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 70 2d 3e 61  Mem *pMem = p->a
4140: 53 74 61 63 6b 3b 0a 20 20 20 20 70 4d 65 6d 2d  Stack;.    pMem-
4150: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74  >flags = MEM_Int
4160: 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65  ;.    pMem->type
4170: 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45   = SQLITE_INTEGE
4180: 52 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d  R;.    pMem->i =
4190: 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20   i;             
41a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
41b0: 20 20 20 2f 2a 20 50 72 6f 67 72 61 6d 20 63 6f     /* Program co
41c0: 75 6e 74 65 72 20 2a 2f 0a 20 20 20 20 70 4d 65  unter */.    pMe
41d0: 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e  m++;..    pMem->
41e0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 74 61 74  flags = MEM_Stat
41f0: 69 63 7c 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 54  ic|MEM_Str|MEM_T
4200: 65 72 6d 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a  erm;.    pMem->z
4210: 20 3d 20 73 71 6c 69 74 65 33 4f 70 63 6f 64 65   = sqlite3Opcode
4220: 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f 70 63 6f 64  Names[pOp->opcod
4230: 65 5d 3b 20 20 2f 2a 20 4f 70 63 6f 64 65 20 2a  e];  /* Opcode *
4240: 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 6e 20 3d 20  /.    pMem->n = 
4250: 73 74 72 6c 65 6e 28 70 4d 65 6d 2d 3e 7a 29 3b  strlen(pMem->z);
4260: 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20  .    pMem->type 
4270: 3d 20 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20  = SQLITE_TEXT;. 
4280: 20 20 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20 53     pMem->enc = S
4290: 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20 20 20  QLITE_UTF8;.    
42a0: 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65  pMem++;..    pMe
42b0: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49  m->flags = MEM_I
42c0: 6e 74 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 69 20  nt;.    pMem->i 
42d0: 3d 20 70 4f 70 2d 3e 70 31 3b 20 20 20 20 20 20  = pOp->p1;      
42e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
42f0: 20 20 20 20 2f 2a 20 50 31 20 2a 2f 0a 20 20 20      /* P1 */.   
4300: 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51   pMem->type = SQ
4310: 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20  LITE_INTEGER;.  
4320: 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70    pMem++;..    p
4330: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
4340: 5f 49 6e 74 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  _Int;.    pMem->
4350: 69 20 3d 20 70 4f 70 2d 3e 70 32 3b 20 20 20 20  i = pOp->p2;    
4360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4370: 20 20 20 20 20 20 2f 2a 20 50 32 20 2a 2f 0a 20        /* P2 */. 
4380: 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20     pMem->type = 
4390: 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b 0a  SQLITE_INTEGER;.
43a0: 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20      pMem++;..   
43b0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
43c0: 45 4d 5f 53 68 6f 72 74 7c 4d 45 4d 5f 53 74 72  EM_Short|MEM_Str
43d0: 7c 4d 45 4d 5f 54 65 72 6d 3b 20 20 20 2f 2a 20  |MEM_Term;   /* 
43e0: 50 33 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e  P3 */.    pMem->
43f0: 7a 20 3d 20 64 69 73 70 6c 61 79 50 33 28 70 4f  z = displayP3(pO
4400: 70 2c 20 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 2c  p, pMem->zShort,
4410: 20 73 69 7a 65 6f 66 28 70 4d 65 6d 2d 3e 7a 53   sizeof(pMem->zS
4420: 68 6f 72 74 29 29 3b 0a 20 20 20 20 70 4d 65 6d  hort));.    pMem
4430: 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f  ->type = SQLITE_
4440: 54 45 58 54 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  TEXT;.    pMem->
4450: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46  enc = SQLITE_UTF
4460: 38 3b 0a 0a 20 20 20 20 70 2d 3e 6e 52 65 73 43  8;..    p->nResC
4470: 6f 6c 75 6d 6e 20 3d 20 35 3b 0a 20 20 20 20 70  olumn = 5;.    p
4480: 2d 3e 70 54 6f 73 20 3d 20 70 4d 65 6d 3b 0a 20  ->pTos = pMem;. 
4490: 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54     p->rc = SQLIT
44a0: 45 5f 4f 4b 3b 0a 20 20 20 20 70 2d 3e 72 65 73  E_OK;.    p->res
44b0: 4f 6e 53 74 61 63 6b 20 3d 20 31 3b 0a 20 20 20  OnStack = 1;.   
44c0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 4f 57   rc = SQLITE_ROW
44d0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
44e0: 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53  c;.}.#endif /* S
44f0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41  QLITE_OMIT_EXPLA
4500: 49 4e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 50 72 69  IN */../*.** Pri
4510: 6e 74 20 74 68 65 20 53 51 4c 20 74 68 61 74 20  nt the SQL that 
4520: 77 61 73 20 75 73 65 64 20 74 6f 20 67 65 6e 65  was used to gene
4530: 72 61 74 65 20 61 20 56 44 42 45 20 70 72 6f 67  rate a VDBE prog
4540: 72 61 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ram..*/.void sql
4550: 69 74 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c  ite3VdbePrintSql
4560: 28 56 64 62 65 20 2a 70 29 7b 0a 23 69 66 64 65  (Vdbe *p){.#ifde
4570: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20  f SQLITE_DEBUG. 
4580: 20 69 6e 74 20 6e 4f 70 20 3d 20 70 2d 3e 6e 4f   int nOp = p->nO
4590: 70 3b 0a 20 20 56 64 62 65 4f 70 20 2a 70 4f 70  p;.  VdbeOp *pOp
45a0: 3b 0a 20 20 69 66 28 20 6e 4f 70 3c 31 20 29 20  ;.  if( nOp<1 ) 
45b0: 72 65 74 75 72 6e 3b 0a 20 20 70 4f 70 20 3d 20  return;.  pOp = 
45c0: 26 70 2d 3e 61 4f 70 5b 6e 4f 70 2d 31 5d 3b 0a  &p->aOp[nOp-1];.
45d0: 20 20 69 66 28 20 70 4f 70 2d 3e 6f 70 63 6f 64    if( pOp->opcod
45e0: 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 26 26 20 70 4f  e==OP_Noop && pO
45f0: 70 2d 3e 70 33 21 3d 30 20 29 7b 0a 20 20 20 20  p->p3!=0 ){.    
4600: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20  const char *z = 
4610: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 77 68 69  pOp->p3;.    whi
4620: 6c 65 28 20 69 73 73 70 61 63 65 28 2a 28 75 38  le( isspace(*(u8
4630: 2a 29 7a 29 20 29 20 7a 2b 2b 3b 0a 20 20 20 20  *)z) ) z++;.    
4640: 70 72 69 6e 74 66 28 22 53 51 4c 3a 20 5b 25 73  printf("SQL: [%s
4650: 5d 5c 6e 22 2c 20 7a 29 3b 0a 20 20 7d 0a 23 65  ]\n", z);.  }.#e
4660: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 72  ndif.}../*.** Pr
4670: 65 70 61 72 65 20 61 20 76 69 72 74 75 61 6c 20  epare a virtual 
4680: 6d 61 63 68 69 6e 65 20 66 6f 72 20 65 78 65 63  machine for exec
4690: 75 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 6e 76  ution.  This inv
46a0: 6f 6c 76 65 73 20 74 68 69 6e 67 73 20 73 75 63  olves things suc
46b0: 68 0a 2a 2a 20 61 73 20 61 6c 6c 6f 63 61 74 69  h.** as allocati
46c0: 6e 67 20 73 74 61 63 6b 20 73 70 61 63 65 20 61  ng stack space a
46d0: 6e 64 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20  nd initializing 
46e0: 74 68 65 20 70 72 6f 67 72 61 6d 20 63 6f 75 6e  the program coun
46f0: 74 65 72 2e 0a 2a 2a 20 41 66 74 65 72 20 74 68  ter..** After th
4700: 65 20 56 44 42 45 20 68 61 73 20 62 65 20 70 72  e VDBE has be pr
4710: 65 70 70 65 64 2c 20 69 74 20 63 61 6e 20 62 65  epped, it can be
4720: 20 65 78 65 63 75 74 65 64 20 62 79 20 6f 6e 65   executed by one
4730: 20 6f 72 20 6d 6f 72 65 0a 2a 2a 20 63 61 6c 6c   or more.** call
4740: 73 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65  s to sqlite3Vdbe
4750: 45 78 65 63 28 29 2e 20 20 0a 2a 2a 0a 2a 2a 20  Exec().  .**.** 
4760: 54 68 69 73 20 69 73 20 74 68 65 20 6f 6e 6c 79  This is the only
4770: 20 77 61 79 20 74 6f 20 6d 6f 76 65 20 61 20 56   way to move a V
4780: 44 42 45 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41  DBE from VDBE_MA
4790: 47 49 43 5f 49 4e 49 54 20 74 6f 0a 2a 2a 20 56  GIC_INIT to.** V
47a0: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 2e 0a 2a  DBE_MAGIC_RUN..*
47b0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
47c0: 62 65 4d 61 6b 65 52 65 61 64 79 28 0a 20 20 56  beMakeReady(.  V
47d0: 64 62 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20  dbe *p,         
47e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
47f0: 20 54 68 65 20 56 44 42 45 20 2a 2f 0a 20 20 69   The VDBE */.  i
4800: 6e 74 20 6e 56 61 72 2c 20 20 20 20 20 20 20 20  nt nVar,        
4810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4820: 20 4e 75 6d 62 65 72 20 6f 66 20 27 3f 27 20 73   Number of '?' s
4830: 65 65 20 69 6e 20 74 68 65 20 53 51 4c 20 73 74  ee in the SQL st
4840: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 6e 74  atement */.  int
4850: 20 6e 4d 65 6d 2c 20 20 20 20 20 20 20 20 20 20   nMem,          
4860: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
4870: 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79 20  umber of memory 
4880: 63 65 6c 6c 73 20 74 6f 20 61 6c 6c 6f 63 61 74  cells to allocat
4890: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 75 72 73  e */.  int nCurs
48a0: 6f 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  or,             
48b0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
48c0: 6f 66 20 63 75 72 73 6f 72 73 20 74 6f 20 61 6c  of cursors to al
48d0: 6c 6f 63 61 74 65 20 2a 2f 0a 20 20 69 6e 74 20  locate */.  int 
48e0: 6e 41 67 67 2c 20 20 20 20 20 20 20 20 20 20 20  nAgg,           
48f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
4900: 6d 62 65 72 20 6f 66 20 61 67 67 72 65 67 61 74  mber of aggregat
4910: 65 20 63 6f 6e 74 65 78 74 73 20 72 65 71 75 69  e contexts requi
4920: 72 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 45  red */.  int isE
4930: 78 70 6c 61 69 6e 20 20 20 20 20 20 20 20 20 20  xplain          
4940: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20          /* True 
4950: 69 66 20 74 68 65 20 45 58 50 4c 41 49 4e 20 6b  if the EXPLAIN k
4960: 65 79 77 6f 72 64 73 20 69 73 20 70 72 65 73 65  eywords is prese
4970: 6e 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e  nt */.){.  int n
4980: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 21 3d  ;..  assert( p!=
4990: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
49a0: 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41  ->magic==VDBE_MA
49b0: 47 49 43 5f 49 4e 49 54 20 29 3b 0a 0a 20 20 2f  GIC_INIT );..  /
49c0: 2a 20 54 68 65 72 65 20 73 68 6f 75 6c 64 20 62  * There should b
49d0: 65 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 6f  e at least one o
49e0: 70 63 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20 61 73  pcode..  */.  as
49f0: 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29  sert( p->nOp>0 )
4a00: 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20  ;..  /* Set the 
4a10: 6d 61 67 69 63 20 74 6f 20 56 44 42 45 5f 4d 41  magic to VDBE_MA
4a20: 47 49 43 5f 52 55 4e 20 73 6f 6f 6e 65 72 20 72  GIC_RUN sooner r
4a30: 61 74 68 65 72 20 74 68 61 6e 20 6c 61 74 65 72  ather than later
4a40: 2e 20 54 68 69 73 0a 20 20 20 2a 20 69 73 20 62  . This.   * is b
4a50: 65 63 61 75 73 65 20 74 68 65 20 63 61 6c 6c 20  ecause the call 
4a60: 74 6f 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79  to resizeOpArray
4a70: 28 29 20 62 65 6c 6f 77 20 6d 61 79 20 73 68 72  () below may shr
4a80: 69 6e 6b 20 74 68 65 0a 20 20 20 2a 20 70 2d 3e  ink the.   * p->
4a90: 61 4f 70 5b 5d 20 61 72 72 61 79 20 74 6f 20 73  aOp[] array to s
4aa0: 61 76 65 20 6d 65 6d 6f 72 79 20 69 66 20 63 61  ave memory if ca
4ab0: 6c 6c 65 64 20 77 68 65 6e 20 69 6e 20 56 44 42  lled when in VDB
4ac0: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 0a 20 20 20  E_MAGIC_RUN .   
4ad0: 2a 20 73 74 61 74 65 2e 0a 20 20 20 2a 2f 0a 20  * state..   */. 
4ae0: 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45   p->magic = VDBE
4af0: 5f 4d 41 47 49 43 5f 52 55 4e 3b 0a 0a 20 20 2f  _MAGIC_RUN;..  /
4b00: 2a 20 4e 6f 20 69 6e 73 74 72 75 63 74 69 6f 6e  * No instruction
4b10: 20 65 76 65 72 20 70 75 73 68 65 73 20 6d 6f 72   ever pushes mor
4b20: 65 20 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 20  e than a single 
4b30: 65 6c 65 6d 65 6e 74 20 6f 6e 74 6f 20 74 68 65  element onto the
4b40: 0a 20 20 2a 2a 20 73 74 61 63 6b 2e 20 20 41 6e  .  ** stack.  An
4b50: 64 20 74 68 65 20 73 74 61 63 6b 20 6e 65 76 65  d the stack neve
4b60: 72 20 67 72 6f 77 73 20 6f 6e 20 73 75 63 63 65  r grows on succe
4b70: 73 73 69 76 65 20 65 78 65 63 75 74 69 6f 6e 73  ssive executions
4b80: 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 73 61 6d   of the.  ** sam
4b90: 65 20 6c 6f 6f 70 2e 20 20 53 6f 20 74 68 65 20  e loop.  So the 
4ba0: 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20  total number of 
4bb0: 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 73 20  instructions is 
4bc0: 61 6e 20 75 70 70 65 72 20 62 6f 75 6e 64 0a 20  an upper bound. 
4bd0: 20 2a 2a 20 6f 6e 20 74 68 65 20 6d 61 78 69 6d   ** on the maxim
4be0: 75 6d 20 73 74 61 63 6b 20 64 65 70 74 68 20 72  um stack depth r
4bf0: 65 71 75 69 72 65 64 2e 0a 20 20 2a 2a 0a 20 20  equired..  **.  
4c00: 2a 2a 20 41 6c 6c 6f 63 61 74 69 6f 6e 20 61 6c  ** Allocation al
4c10: 6c 20 74 68 65 20 73 74 61 63 6b 20 73 70 61 63  l the stack spac
4c20: 65 20 77 65 20 77 69 6c 6c 20 65 76 65 72 20 6e  e we will ever n
4c30: 65 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  eed..  */.  if( 
4c40: 70 2d 3e 61 53 74 61 63 6b 3d 3d 30 20 29 7b 0a  p->aStack==0 ){.
4c50: 20 20 20 20 69 6e 74 20 6e 41 72 67 3b 20 20 20      int nArg;   
4c60: 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e      /* Maximum n
4c70: 75 6d 62 65 72 20 6f 66 20 61 72 67 73 20 70 61  umber of args pa
4c80: 73 73 65 64 20 74 6f 20 61 20 75 73 65 72 20 66  ssed to a user f
4c90: 75 6e 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 20 20  unction. */.    
4ca0: 69 6e 74 20 6e 53 74 61 63 6b 3b 20 20 20 20 20  int nStack;     
4cb0: 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e 75 6d 62 65  /* Maximum numbe
4cc0: 72 20 6f 66 20 73 74 61 63 6b 20 65 6e 74 72 69  r of stack entri
4cd0: 65 73 20 72 65 71 75 69 72 65 64 20 2a 2f 0a 20  es required */. 
4ce0: 20 20 20 72 65 73 6f 6c 76 65 50 32 56 61 6c 75     resolveP2Valu
4cf0: 65 73 28 70 2c 20 26 6e 41 72 67 2c 20 26 6e 53  es(p, &nArg, &nS
4d00: 74 61 63 6b 29 3b 0a 20 20 20 20 72 65 73 69 7a  tack);.    resiz
4d10: 65 4f 70 41 72 72 61 79 28 70 2c 20 70 2d 3e 6e  eOpArray(p, p->n
4d20: 4f 70 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  Op);.    assert(
4d30: 20 6e 56 61 72 3e 3d 30 20 29 3b 0a 20 20 20 20   nVar>=0 );.    
4d40: 61 73 73 65 72 74 28 20 6e 53 74 61 63 6b 3c 70  assert( nStack<p
4d50: 2d 3e 6e 4f 70 20 29 3b 0a 20 20 20 20 6e 53 74  ->nOp );.    nSt
4d60: 61 63 6b 20 3d 20 69 73 45 78 70 6c 61 69 6e 20  ack = isExplain 
4d70: 3f 20 31 30 20 3a 20 6e 53 74 61 63 6b 3b 0a 20  ? 10 : nStack;. 
4d80: 20 20 20 70 2d 3e 61 53 74 61 63 6b 20 3d 20 73     p->aStack = s
4d90: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 0a 20 20 20  qliteMalloc(.   
4da0: 20 20 20 20 20 6e 53 74 61 63 6b 2a 73 69 7a 65       nStack*size
4db0: 6f 66 28 70 2d 3e 61 53 74 61 63 6b 5b 30 5d 29  of(p->aStack[0])
4dc0: 20 20 20 20 2f 2a 20 61 53 74 61 63 6b 20 2a 2f      /* aStack */
4dd0: 0a 20 20 20 20 20 20 2b 20 6e 41 72 67 2a 73 69  .      + nArg*si
4de0: 7a 65 6f 66 28 4d 65 6d 2a 29 20 20 20 20 20 20  zeof(Mem*)      
4df0: 20 20 20 20 20 20 20 20 2f 2a 20 61 70 41 72 67          /* apArg
4e00: 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 56 61 72   */.      + nVar
4e10: 2a 73 69 7a 65 6f 66 28 4d 65 6d 29 20 20 20 20  *sizeof(Mem)    
4e20: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 61 56             /* aV
4e30: 61 72 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 56  ar */.      + nV
4e40: 61 72 2a 73 69 7a 65 6f 66 28 63 68 61 72 2a 29  ar*sizeof(char*)
4e50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4e60: 61 7a 56 61 72 20 2a 2f 0a 20 20 20 20 20 20 2b  azVar */.      +
4e70: 20 6e 4d 65 6d 2a 73 69 7a 65 6f 66 28 4d 65 6d   nMem*sizeof(Mem
4e80: 29 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  )               
4e90: 2f 2a 20 61 4d 65 6d 20 2a 2f 0a 20 20 20 20 20  /* aMem */.     
4ea0: 20 2b 20 6e 43 75 72 73 6f 72 2a 73 69 7a 65 6f   + nCursor*sizeo
4eb0: 66 28 43 75 72 73 6f 72 2a 29 20 20 20 20 20 20  f(Cursor*)      
4ec0: 20 20 2f 2a 20 61 70 43 73 72 20 2a 2f 0a 20 20    /* apCsr */.  
4ed0: 20 20 20 20 2b 20 6e 41 67 67 2a 73 69 7a 65 6f      + nAgg*sizeo
4ee0: 66 28 41 67 67 29 20 20 20 20 20 20 20 20 20 20  f(Agg)          
4ef0: 20 20 20 20 20 2f 2a 20 41 67 67 72 65 67 61 74       /* Aggregat
4f00: 65 20 63 6f 6e 74 65 78 74 73 20 2a 2f 0a 20 20  e contexts */.  
4f10: 20 20 29 3b 0a 20 20 20 20 69 66 28 20 21 73 71    );.    if( !sq
4f20: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69  lite3_malloc_fai
4f30: 6c 65 64 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e  led ){.      p->
4f40: 61 4d 65 6d 20 3d 20 26 70 2d 3e 61 53 74 61 63  aMem = &p->aStac
4f50: 6b 5b 6e 53 74 61 63 6b 5d 3b 0a 20 20 20 20 20  k[nStack];.     
4f60: 20 70 2d 3e 6e 4d 65 6d 20 3d 20 6e 4d 65 6d 3b   p->nMem = nMem;
4f70: 0a 20 20 20 20 20 20 70 2d 3e 61 56 61 72 20 3d  .      p->aVar =
4f80: 20 26 70 2d 3e 61 4d 65 6d 5b 6e 4d 65 6d 5d 3b   &p->aMem[nMem];
4f90: 0a 20 20 20 20 20 20 70 2d 3e 6e 56 61 72 20 3d  .      p->nVar =
4fa0: 20 6e 56 61 72 3b 0a 20 20 20 20 20 20 70 2d 3e   nVar;.      p->
4fb0: 6f 6b 56 61 72 20 3d 20 30 3b 0a 20 20 20 20 20  okVar = 0;.     
4fc0: 20 70 2d 3e 61 70 41 72 67 20 3d 20 28 4d 65 6d   p->apArg = (Mem
4fd0: 2a 2a 29 26 70 2d 3e 61 56 61 72 5b 6e 56 61 72  **)&p->aVar[nVar
4fe0: 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 61 7a 56 61  ];.      p->azVa
4ff0: 72 20 3d 20 28 63 68 61 72 2a 2a 29 26 70 2d 3e  r = (char**)&p->
5000: 61 70 41 72 67 5b 6e 41 72 67 5d 3b 0a 20 20 20  apArg[nArg];.   
5010: 20 20 20 70 2d 3e 61 70 43 73 72 20 3d 20 28 43     p->apCsr = (C
5020: 75 72 73 6f 72 2a 2a 29 26 70 2d 3e 61 7a 56 61  ursor**)&p->azVa
5030: 72 5b 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20 69  r[nVar];.      i
5040: 66 28 20 6e 41 67 67 3e 30 20 29 7b 0a 20 20 20  f( nAgg>0 ){.   
5050: 20 20 20 20 20 70 2d 3e 6e 41 67 67 20 3d 20 6e       p->nAgg = n
5060: 41 67 67 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e  Agg;.        p->
5070: 61 70 41 67 67 20 3d 20 28 41 67 67 2a 29 26 70  apAgg = (Agg*)&p
5080: 2d 3e 61 70 43 73 72 5b 6e 43 75 72 73 6f 72 5d  ->apCsr[nCursor]
5090: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
50a0: 70 2d 3e 6e 43 75 72 73 6f 72 20 3d 20 6e 43 75  p->nCursor = nCu
50b0: 72 73 6f 72 3b 0a 20 20 20 20 20 20 66 6f 72 28  rsor;.      for(
50c0: 6e 3d 30 3b 20 6e 3c 6e 56 61 72 3b 20 6e 2b 2b  n=0; n<nVar; n++
50d0: 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 61 56  ){.        p->aV
50e0: 61 72 5b 6e 5d 2e 66 6c 61 67 73 20 3d 20 4d 45  ar[n].flags = ME
50f0: 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 7d 0a  M_Null;.      }.
5100: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 70 2d 3e 70      }.  }.  p->p
5110: 41 67 67 20 3d 20 70 2d 3e 61 70 41 67 67 3b 0a  Agg = p->apAgg;.
5120: 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c 70 2d 3e    for(n=0; n<p->
5130: 6e 4d 65 6d 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20  nMem; n++){.    
5140: 70 2d 3e 61 4d 65 6d 5b 6e 5d 2e 66 6c 61 67 73  p->aMem[n].flags
5150: 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 7d   = MEM_Null;.  }
5160: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
5170: 44 45 42 55 47 0a 20 20 69 66 28 20 28 70 2d 3e  DEBUG.  if( (p->
5180: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
5190: 54 45 5f 56 64 62 65 4c 69 73 74 69 6e 67 29 21  TE_VdbeListing)!
51a0: 3d 30 0a 20 20 20 20 7c 7c 20 73 71 6c 69 74 65  =0.    || sqlite
51b0: 33 4f 73 46 69 6c 65 45 78 69 73 74 73 28 22 76  3OsFileExists("v
51c0: 64 62 65 5f 65 78 70 6c 61 69 6e 22 29 0a 20 20  dbe_explain").  
51d0: 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20  ){.    int i;.  
51e0: 20 20 70 72 69 6e 74 66 28 22 56 44 42 45 20 50    printf("VDBE P
51f0: 72 6f 67 72 61 6d 20 4c 69 73 74 69 6e 67 3a 5c  rogram Listing:\
5200: 6e 22 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  n");.    sqlite3
5210: 56 64 62 65 50 72 69 6e 74 53 71 6c 28 70 29 3b  VdbePrintSql(p);
5220: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
5230: 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20  p->nOp; i++){.  
5240: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 50      sqlite3VdbeP
5250: 72 69 6e 74 4f 70 28 73 74 64 6f 75 74 2c 20 69  rintOp(stdout, i
5260: 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20  , &p->aOp[i]);. 
5270: 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 73     }.  }.  if( s
5280: 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73  qlite3OsFileExis
5290: 74 73 28 22 76 64 62 65 5f 74 72 61 63 65 22 29  ts("vdbe_trace")
52a0: 20 29 7b 0a 20 20 20 20 70 2d 3e 74 72 61 63 65   ){.    p->trace
52b0: 20 3d 20 73 74 64 6f 75 74 3b 0a 20 20 7d 0a 23   = stdout;.  }.#
52c0: 65 6e 64 69 66 0a 20 20 70 2d 3e 70 54 6f 73 20  endif.  p->pTos 
52d0: 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d  = &p->aStack[-1]
52e0: 3b 0a 20 20 70 2d 3e 70 63 20 3d 20 2d 31 3b 0a  ;.  p->pc = -1;.
52f0: 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45    p->rc = SQLITE
5300: 5f 4f 4b 3b 0a 20 20 70 2d 3e 75 6e 69 71 75 65  _OK;.  p->unique
5310: 43 6e 74 20 3d 20 30 3b 0a 20 20 70 2d 3e 72 65  Cnt = 0;.  p->re
5320: 74 75 72 6e 44 65 70 74 68 20 3d 20 30 3b 0a 20  turnDepth = 0;. 
5330: 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f 6e 20   p->errorAction 
5340: 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20 20 70 2d  = OE_Abort;.  p-
5350: 3e 70 6f 70 53 74 61 63 6b 20 3d 20 20 30 3b 0a  >popStack =  0;.
5360: 20 20 70 2d 3e 65 78 70 6c 61 69 6e 20 7c 3d 20    p->explain |= 
5370: 69 73 45 78 70 6c 61 69 6e 3b 0a 20 20 70 2d 3e  isExplain;.  p->
5380: 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47  magic = VDBE_MAG
5390: 49 43 5f 52 55 4e 3b 0a 20 20 70 2d 3e 6e 43 68  IC_RUN;.  p->nCh
53a0: 61 6e 67 65 20 3d 20 30 3b 0a 23 69 66 64 65 66  ange = 0;.#ifdef
53b0: 20 56 44 42 45 5f 50 52 4f 46 49 4c 45 0a 20 20   VDBE_PROFILE.  
53c0: 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20  {.    int i;.   
53d0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e   for(i=0; i<p->n
53e0: 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  Op; i++){.      
53f0: 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 20 3d 20  p->aOp[i].cnt = 
5400: 30 3b 0a 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b  0;.      p->aOp[
5410: 69 5d 2e 63 79 63 6c 65 73 20 3d 20 30 3b 0a 20  i].cycles = 0;. 
5420: 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a     }.  }.#endif.
5430: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65  }.../*.** Remove
5440: 20 61 6e 79 20 65 6c 65 6d 65 6e 74 73 20 74 68   any elements th
5450: 61 74 20 72 65 6d 61 69 6e 20 6f 6e 20 74 68 65  at remain on the
5460: 20 73 6f 72 74 65 72 20 66 6f 72 20 74 68 65 20   sorter for the 
5470: 56 44 42 45 20 67 69 76 65 6e 2e 0a 2a 2f 0a 76  VDBE given..*/.v
5480: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 53  oid sqlite3VdbeS
5490: 6f 72 74 65 72 52 65 73 65 74 28 56 64 62 65 20  orterReset(Vdbe 
54a0: 2a 70 29 7b 0a 20 20 77 68 69 6c 65 28 20 70 2d  *p){.  while( p-
54b0: 3e 70 53 6f 72 74 20 29 7b 0a 20 20 20 20 53 6f  >pSort ){.    So
54c0: 72 74 65 72 20 2a 70 53 6f 72 74 65 72 20 3d 20  rter *pSorter = 
54d0: 70 2d 3e 70 53 6f 72 74 3b 0a 20 20 20 20 70 2d  p->pSort;.    p-
54e0: 3e 70 53 6f 72 74 20 3d 20 70 53 6f 72 74 65 72  >pSort = pSorter
54f0: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c  ->pNext;.    sql
5500: 69 74 65 46 72 65 65 28 70 53 6f 72 74 65 72 2d  iteFree(pSorter-
5510: 3e 7a 4b 65 79 29 3b 0a 20 20 20 20 73 71 6c 69  >zKey);.    sqli
5520: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
5530: 65 28 26 70 53 6f 72 74 65 72 2d 3e 64 61 74 61  e(&pSorter->data
5540: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65  );.    sqliteFre
5550: 65 28 70 53 6f 72 74 65 72 29 3b 0a 20 20 7d 0a  e(pSorter);.  }.
5560: 20 20 70 2d 3e 70 53 6f 72 74 54 61 69 6c 20 3d    p->pSortTail =
5570: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65   0;.}../*.** Fre
5580: 65 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 20  e all resources 
5590: 61 6c 6c 6f 63 69 61 74 65 64 20 77 69 74 68 20  allociated with 
55a0: 41 67 67 45 6c 65 6d 20 70 45 6c 65 6d 2c 20 61  AggElem pElem, a
55b0: 6e 20 65 6c 65 6d 65 6e 74 20 6f 66 0a 2a 2a 20  n element of.** 
55c0: 61 67 67 72 65 67 61 74 65 20 70 41 67 67 2e 0a  aggregate pAgg..
55d0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66  */.static void f
55e0: 72 65 65 41 67 67 45 6c 65 6d 28 41 67 67 45 6c  reeAggElem(AggEl
55f0: 65 6d 20 2a 70 45 6c 65 6d 2c 20 41 67 67 20 2a  em *pElem, Agg *
5600: 70 41 67 67 29 7b 0a 20 20 69 6e 74 20 69 3b 0a  pAgg){.  int i;.
5610: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 41 67    for(i=0; i<pAg
5620: 67 2d 3e 6e 4d 65 6d 3b 20 69 2b 2b 29 7b 0a 20  g->nMem; i++){. 
5630: 20 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 26     Mem *pMem = &
5640: 70 45 6c 65 6d 2d 3e 61 4d 65 6d 5b 69 5d 3b 0a  pElem->aMem[i];.
5650: 20 20 20 20 69 66 28 20 70 41 67 67 2d 3e 61 70      if( pAgg->ap
5660: 46 75 6e 63 20 26 26 20 70 41 67 67 2d 3e 61 70  Func && pAgg->ap
5670: 46 75 6e 63 5b 69 5d 20 26 26 20 28 70 4d 65 6d  Func[i] && (pMem
5680: 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41 67  ->flags & MEM_Ag
5690: 67 43 74 78 29 21 3d 30 20 29 7b 0a 20 20 20 20  gCtx)!=0 ){.    
56a0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
56b0: 74 20 63 74 78 3b 0a 20 20 20 20 20 20 63 74 78  t ctx;.      ctx
56c0: 2e 70 46 75 6e 63 20 3d 20 70 41 67 67 2d 3e 61  .pFunc = pAgg->a
56d0: 70 46 75 6e 63 5b 69 5d 3b 0a 20 20 20 20 20 20  pFunc[i];.      
56e0: 63 74 78 2e 73 2e 66 6c 61 67 73 20 3d 20 4d 45  ctx.s.flags = ME
56f0: 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 63 74  M_Null;.      ct
5700: 78 2e 70 41 67 67 20 3d 20 70 4d 65 6d 2d 3e 7a  x.pAgg = pMem->z
5710: 3b 0a 20 20 20 20 20 20 63 74 78 2e 63 6e 74 20  ;.      ctx.cnt 
5720: 3d 20 70 4d 65 6d 2d 3e 69 3b 0a 20 20 20 20 20  = pMem->i;.     
5730: 20 63 74 78 2e 69 73 45 72 72 6f 72 20 3d 20 30   ctx.isError = 0
5740: 3b 0a 20 20 20 20 20 20 28 2a 63 74 78 2e 70 46  ;.      (*ctx.pF
5750: 75 6e 63 2d 3e 78 46 69 6e 61 6c 69 7a 65 29 28  unc->xFinalize)(
5760: 26 63 74 78 29 3b 0a 20 20 20 20 20 20 70 4d 65  &ctx);.      pMe
5770: 6d 2d 3e 7a 20 3d 20 63 74 78 2e 70 41 67 67 3b  m->z = ctx.pAgg;
5780: 0a 20 20 20 20 20 20 69 66 28 20 70 4d 65 6d 2d  .      if( pMem-
5790: 3e 7a 21 3d 30 20 26 26 20 70 4d 65 6d 2d 3e 7a  >z!=0 && pMem->z
57a0: 21 3d 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 20 29  !=pMem->zShort )
57b0: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
57c0: 46 72 65 65 28 70 4d 65 6d 2d 3e 7a 29 3b 0a 20  Free(pMem->z);. 
57d0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c       }.      sql
57e0: 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61  ite3VdbeMemRelea
57f0: 73 65 28 26 63 74 78 2e 73 29 3b 0a 20 20 20 20  se(&ctx.s);.    
5800: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
5810: 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61  ite3VdbeMemRelea
5820: 73 65 28 70 4d 65 6d 29 3b 0a 20 20 20 20 7d 0a  se(pMem);.    }.
5830: 20 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65    }.  sqliteFree
5840: 28 70 45 6c 65 6d 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  (pElem);.}../*.*
5850: 2a 20 52 65 73 65 74 20 61 6e 20 41 67 67 20 73  * Reset an Agg s
5860: 74 72 75 63 74 75 72 65 2e 20 20 44 65 6c 65 74  tructure.  Delet
5870: 65 20 61 6c 6c 20 69 74 73 20 63 6f 6e 74 65 6e  e all its conten
5880: 74 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 69 6e  ts..**.** For in
5890: 73 74 61 6c 6c 61 62 6c 65 20 61 67 67 72 65 67  stallable aggreg
58a0: 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20 69  ate functions, i
58b0: 66 20 74 68 65 20 73 74 65 70 20 66 75 6e 63 74  f the step funct
58c0: 69 6f 6e 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20  ion has been.** 
58d0: 63 61 6c 6c 65 64 2c 20 6d 61 6b 65 20 73 75 72  called, make sur
58e0: 65 20 74 68 65 20 66 69 6e 61 6c 69 7a 65 72 20  e the finalizer 
58f0: 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 61 6c 73  function has als
5900: 6f 20 62 65 65 6e 20 63 61 6c 6c 65 64 2e 20 20  o been called.  
5910: 54 68 65 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 72  The.** finalizer
5920: 20 6d 69 67 68 74 20 6e 65 65 64 20 74 6f 20 66   might need to f
5930: 72 65 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 20  ree memory that 
5940: 77 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 73  was allocated as
5950: 20 70 61 72 74 20 6f 66 20 69 74 73 0a 2a 2a 20   part of its.** 
5960: 70 72 69 76 61 74 65 20 63 6f 6e 74 65 78 74 2e  private context.
5970: 20 20 49 66 20 74 68 65 20 66 69 6e 61 6c 69 7a    If the finaliz
5980: 65 72 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20  er has not been 
5990: 63 61 6c 6c 65 64 20 79 65 74 2c 20 63 61 6c 6c  called yet, call
59a0: 20 69 74 0a 2a 2a 20 6e 6f 77 2e 0a 2a 2a 0a 2a   it.** now..**.*
59b0: 2a 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c  * If db is NULL,
59c0: 20 74 68 65 6e 20 74 68 69 73 20 69 73 20 62 65   then this is be
59d0: 69 6e 67 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20  ing called from 
59e0: 73 71 6c 69 74 65 56 64 62 65 52 65 73 65 74 28  sqliteVdbeReset(
59f0: 29 2e 20 49 6e 0a 2a 2a 20 74 68 69 73 20 63 61  ). In.** this ca
5a00: 73 65 20 63 6c 65 61 6e 20 75 70 20 61 6c 6c 20  se clean up all 
5a10: 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68  references to th
5a20: 65 20 74 65 6d 70 2d 74 61 62 6c 65 20 75 73 65  e temp-table use
5a30: 64 20 66 6f 72 0a 2a 2a 20 61 67 67 72 65 67 61  d for.** aggrega
5a40: 74 65 73 20 28 69 66 20 69 74 20 77 61 73 20 65  tes (if it was e
5a50: 76 65 72 20 6f 70 65 6e 65 64 29 2e 0a 2a 2a 0a  ver opened)..**.
5a60: 2a 2a 20 49 66 20 64 62 20 69 73 20 6e 6f 74 20  ** If db is not 
5a70: 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68 69 73 20  NULL, then this 
5a80: 69 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 20  is being called 
5a90: 66 72 6f 6d 20 77 69 74 68 20 61 6e 20 4f 50 5f  from with an OP_
5aa0: 41 67 67 52 65 73 65 74 0a 2a 2a 20 6f 70 63 6f  AggReset.** opco
5ab0: 64 65 2e 20 4f 70 65 6e 20 74 68 65 20 74 65 6d  de. Open the tem
5ac0: 70 2d 74 61 62 6c 65 2c 20 69 66 20 69 74 20 68  p-table, if it h
5ad0: 61 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 62  as not already b
5ae0: 65 65 6e 20 6f 70 65 6e 65 64 20 61 6e 64 0a 2a  een opened and.*
5af0: 2a 20 64 65 6c 65 74 65 20 74 68 65 20 63 6f 6e  * delete the con
5b00: 74 65 6e 74 73 20 6f 66 20 74 68 65 20 74 61 62  tents of the tab
5b10: 6c 65 20 75 73 65 64 20 66 6f 72 20 61 67 67 72  le used for aggr
5b20: 65 67 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f  egate informatio
5b30: 6e 2c 20 72 65 61 64 79 0a 2a 2a 20 66 6f 72 20  n, ready.** for 
5b40: 74 68 65 20 6e 65 78 74 20 72 6f 75 6e 64 20 6f  the next round o
5b50: 66 20 61 67 67 72 65 67 61 74 65 20 70 72 6f 63  f aggregate proc
5b60: 65 73 73 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73  essing..*/.int s
5b70: 71 6c 69 74 65 33 56 64 62 65 41 67 67 52 65 73  qlite3VdbeAggRes
5b80: 65 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  et(sqlite3 *db, 
5b90: 41 67 67 20 2a 70 41 67 67 2c 20 4b 65 79 49 6e  Agg *pAgg, KeyIn
5ba0: 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 29 7b 0a 20  fo *pKeyInfo){. 
5bb0: 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20 20 42   int rc = 0;.  B
5bc0: 74 43 75 72 73 6f 72 20 2a 70 43 73 72 3b 0a 0a  tCursor *pCsr;..
5bd0: 20 20 69 66 28 20 21 70 41 67 67 20 29 20 72 65    if( !pAgg ) re
5be0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
5bf0: 20 20 70 43 73 72 20 3d 20 70 41 67 67 2d 3e 70    pCsr = pAgg->p
5c00: 43 73 72 3b 0a 20 20 61 73 73 65 72 74 28 20 28  Csr;.  assert( (
5c10: 70 43 73 72 20 26 26 20 70 41 67 67 2d 3e 6e 54  pCsr && pAgg->nT
5c20: 61 62 3e 30 29 20 7c 7c 20 28 21 70 43 73 72 20  ab>0) || (!pCsr 
5c30: 26 26 20 70 41 67 67 2d 3e 6e 54 61 62 3d 3d 30  && pAgg->nTab==0
5c40: 29 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71  ).         || sq
5c50: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69  lite3_malloc_fai
5c60: 6c 65 64 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20  led );..  /* If 
5c70: 70 43 73 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c  pCsr is not NULL
5c80: 2c 20 74 68 65 6e 20 74 68 65 20 74 61 62 6c 65  , then the table
5c90: 20 75 73 65 64 20 66 6f 72 20 61 67 67 72 65 67   used for aggreg
5ca0: 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a  ate information.
5cb0: 20 20 2a 2a 20 69 73 20 6f 70 65 6e 2e 20 4c 6f    ** is open. Lo
5cc0: 6f 70 20 74 68 72 6f 75 67 68 20 69 74 20 61 6e  op through it an
5cd0: 64 20 66 72 65 65 20 74 68 65 20 41 67 67 45 6c  d free the AggEl
5ce0: 65 6d 2a 20 73 74 72 75 63 74 75 72 65 20 70 6f  em* structure po
5cf0: 69 6e 74 65 64 20 61 74 0a 20 20 2a 2a 20 62 79  inted at.  ** by
5d00: 20 65 61 63 68 20 65 6e 74 72 79 2e 20 49 66 20   each entry. If 
5d10: 74 68 65 20 66 69 6e 61 6c 69 7a 65 72 20 68 61  the finalizer ha
5d20: 73 20 6e 6f 74 20 62 65 65 6e 20 63 61 6c 6c 65  s not been calle
5d30: 64 20 66 6f 72 20 61 6e 20 41 67 67 45 6c 65 6d  d for an AggElem
5d40: 2c 0a 20 20 2a 2a 20 64 6f 20 74 68 61 74 20 74  ,.  ** do that t
5d50: 6f 6f 2e 20 46 69 6e 61 6c 6c 79 2c 20 63 6c 65  oo. Finally, cle
5d60: 61 72 20 74 68 65 20 62 74 72 65 65 20 74 61 62  ar the btree tab
5d70: 6c 65 20 69 74 73 65 6c 66 2e 0a 20 20 2a 2f 0a  le itself..  */.
5d80: 20 20 69 66 28 20 70 43 73 72 20 29 7b 0a 20 20    if( pCsr ){.  
5d90: 20 20 69 6e 74 20 72 65 73 3b 0a 20 20 20 20 61    int res;.    a
5da0: 73 73 65 72 74 28 20 70 41 67 67 2d 3e 70 42 74  ssert( pAgg->pBt
5db0: 72 65 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72  ree );.    asser
5dc0: 74 28 20 70 41 67 67 2d 3e 6e 54 61 62 3e 30 20  t( pAgg->nTab>0 
5dd0: 29 3b 0a 0a 20 20 20 20 72 63 3d 73 71 6c 69 74  );..    rc=sqlit
5de0: 65 33 42 74 72 65 65 46 69 72 73 74 28 70 43 73  e3BtreeFirst(pCs
5df0: 72 2c 20 26 72 65 73 29 3b 0a 20 20 20 20 77 68  r, &res);.    wh
5e00: 69 6c 65 28 20 72 65 73 3d 3d 30 20 26 26 20 72  ile( res==0 && r
5e10: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
5e20: 20 20 20 20 20 20 41 67 67 45 6c 65 6d 20 2a 70        AggElem *p
5e30: 45 6c 65 6d 3b 0a 20 20 20 20 20 20 72 63 20 3d  Elem;.      rc =
5e40: 20 73 71 6c 69 74 65 33 42 74 72 65 65 44 61 74   sqlite3BtreeDat
5e50: 61 28 70 43 73 72 2c 20 30 2c 20 73 69 7a 65 6f  a(pCsr, 0, sizeo
5e60: 66 28 41 67 67 45 6c 65 6d 2a 29 2c 20 28 63 68  f(AggElem*), (ch
5e70: 61 72 20 2a 29 26 70 45 6c 65 6d 29 3b 0a 20 20  ar *)&pElem);.  
5e80: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
5e90: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20  TE_OK ){.       
5ea0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
5eb0: 20 20 7d 0a 20 20 20 20 20 20 61 73 73 65 72 74    }.      assert
5ec0: 28 20 70 41 67 67 2d 3e 61 70 46 75 6e 63 21 3d  ( pAgg->apFunc!=
5ed0: 30 20 29 3b 0a 20 20 20 20 20 20 66 72 65 65 41  0 );.      freeA
5ee0: 67 67 45 6c 65 6d 28 70 45 6c 65 6d 2c 20 70 41  ggElem(pElem, pA
5ef0: 67 67 29 3b 0a 20 20 20 20 20 20 72 63 3d 73 71  gg);.      rc=sq
5f00: 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 70  lite3BtreeNext(p
5f10: 43 73 72 2c 20 26 72 65 73 29 3b 0a 20 20 20 20  Csr, &res);.    
5f20: 7d 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  }.    if( rc!=SQ
5f30: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
5f40: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
5f50: 7d 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74  }..    sqlite3Bt
5f60: 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70  reeCloseCursor(p
5f70: 43 73 72 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Csr);.    sqlite
5f80: 33 42 74 72 65 65 43 6c 65 61 72 54 61 62 6c 65  3BtreeClearTable
5f90: 28 70 41 67 67 2d 3e 70 42 74 72 65 65 2c 20 70  (pAgg->pBtree, p
5fa0: 41 67 67 2d 3e 6e 54 61 62 29 3b 0a 20 20 7d 65  Agg->nTab);.  }e
5fb0: 6c 73 65 7b 20 0a 20 20 20 20 2f 2a 20 54 68 65  lse{ .    /* The
5fc0: 20 63 75 72 73 6f 72 20 6d 61 79 20 6e 6f 74 20   cursor may not 
5fd0: 62 65 20 6f 70 65 6e 20 62 65 63 61 75 73 65 20  be open because 
5fe0: 74 68 65 20 61 67 67 72 65 67 61 74 6f 72 20 77  the aggregator w
5ff0: 61 73 20 6e 65 76 65 72 20 75 73 65 64 2c 0a 20  as never used,. 
6000: 20 20 20 2a 2a 20 6f 72 20 69 74 20 63 6f 75 6c     ** or it coul
6010: 64 20 62 65 20 74 68 61 74 20 69 74 20 77 61 73  d be that it was
6020: 20 75 73 65 64 20 62 75 74 20 74 68 65 72 65 20   used but there 
6030: 77 61 73 20 6e 6f 20 47 52 4f 55 50 20 42 59 20  was no GROUP BY 
6040: 63 6c 61 75 73 65 2e 0a 20 20 20 20 2a 2f 0a 20  clause..    */. 
6050: 20 20 20 69 66 28 20 70 41 67 67 2d 3e 70 43 75     if( pAgg->pCu
6060: 72 72 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 66  rrent ){.      f
6070: 72 65 65 41 67 67 45 6c 65 6d 28 70 41 67 67 2d  reeAggElem(pAgg-
6080: 3e 70 43 75 72 72 65 6e 74 2c 20 70 41 67 67 29  >pCurrent, pAgg)
6090: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
60a0: 2a 20 49 66 20 64 62 20 69 73 20 6e 6f 74 20 4e  * If db is not N
60b0: 55 4c 4c 20 61 6e 64 20 77 65 20 68 61 76 65 20  ULL and we have 
60c0: 6e 6f 74 20 79 65 74 20 61 6e 64 20 77 65 20 68  not yet and we h
60d0: 61 76 65 20 6e 6f 74 20 79 65 74 20 6f 70 65 6e  ave not yet open
60e0: 65 64 0a 20 20 2a 2a 20 74 68 65 20 74 65 6d 70  ed.  ** the temp
60f0: 6f 72 61 72 79 20 62 74 72 65 65 20 74 68 65 6e  orary btree then
6100: 20 64 6f 20 73 6f 20 61 6e 64 20 63 72 65 61 74   do so and creat
6110: 65 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 73  e the table to s
6120: 74 6f 72 65 20 61 67 67 72 65 67 61 74 65 0a 20  tore aggregate. 
6130: 20 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e   ** information.
6140: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 64 62  .  **.  ** If db
6150: 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 63   is NULL, then c
6160: 6c 6f 73 65 20 74 68 65 20 74 65 6d 70 6f 72 61  lose the tempora
6170: 72 79 20 62 74 72 65 65 20 69 66 20 69 74 20 69  ry btree if it i
6180: 73 20 6f 70 65 6e 2e 0a 20 20 2a 2f 0a 20 20 69  s open..  */.  i
6190: 66 28 20 64 62 20 29 7b 0a 20 20 20 20 69 66 28  f( db ){.    if(
61a0: 20 21 70 41 67 67 2d 3e 70 42 74 72 65 65 20 29   !pAgg->pBtree )
61b0: 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  {.      assert( 
61c0: 70 41 67 67 2d 3e 6e 54 61 62 3d 3d 30 20 29 3b  pAgg->nTab==0 );
61d0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
61e0: 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a 20 20  OMIT_MEMORYDB.  
61f0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
6200: 42 74 72 65 65 46 61 63 74 6f 72 79 28 64 62 2c  BtreeFactory(db,
6210: 20 22 3a 6d 65 6d 6f 72 79 3a 22 2c 20 30 2c 20   ":memory:", 0, 
6220: 54 45 4d 50 5f 50 41 47 45 53 2c 20 26 70 41 67  TEMP_PAGES, &pAg
6230: 67 2d 3e 70 42 74 72 65 65 29 3b 0a 23 65 6c 73  g->pBtree);.#els
6240: 65 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  e.      rc = sql
6250: 69 74 65 33 42 74 72 65 65 46 61 63 74 6f 72 79  ite3BtreeFactory
6260: 28 64 62 2c 20 30 2c 20 30 2c 20 54 45 4d 50 5f  (db, 0, 0, TEMP_
6270: 50 41 47 45 53 2c 20 26 70 41 67 67 2d 3e 70 42  PAGES, &pAgg->pB
6280: 74 72 65 65 29 3b 0a 23 65 6e 64 69 66 0a 20 20  tree);.#endif.  
6290: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
62a0: 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72  TE_OK ) return r
62b0: 63 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  c;.      sqlite3
62c0: 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73 28  BtreeBeginTrans(
62d0: 70 41 67 67 2d 3e 70 42 74 72 65 65 2c 20 31 29  pAgg->pBtree, 1)
62e0: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  ;.      rc = sql
62f0: 69 74 65 33 42 74 72 65 65 43 72 65 61 74 65 54  ite3BtreeCreateT
6300: 61 62 6c 65 28 70 41 67 67 2d 3e 70 42 74 72 65  able(pAgg->pBtre
6310: 65 2c 20 26 70 41 67 67 2d 3e 6e 54 61 62 2c 20  e, &pAgg->nTab, 
6320: 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  0);.      if( rc
6330: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65  !=SQLITE_OK ) re
6340: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20  turn rc;.    }. 
6350: 20 20 20 61 73 73 65 72 74 28 20 70 41 67 67 2d     assert( pAgg-
6360: 3e 6e 54 61 62 21 3d 30 20 29 3b 0a 0a 20 20 20  >nTab!=0 );..   
6370: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
6380: 65 65 43 75 72 73 6f 72 28 70 41 67 67 2d 3e 70  eeCursor(pAgg->p
6390: 42 74 72 65 65 2c 20 70 41 67 67 2d 3e 6e 54 61  Btree, pAgg->nTa
63a0: 62 2c 20 31 2c 0a 20 20 20 20 20 20 20 20 73 71  b, 1,.        sq
63b0: 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43  lite3VdbeRecordC
63c0: 6f 6d 70 61 72 65 2c 20 70 4b 65 79 49 6e 66 6f  ompare, pKeyInfo
63d0: 2c 20 26 70 41 67 67 2d 3e 70 43 73 72 29 3b 0a  , &pAgg->pCsr);.
63e0: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
63f0: 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72  TE_OK ) return r
6400: 63 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  c;.  }else{.    
6410: 69 66 28 20 70 41 67 67 2d 3e 70 42 74 72 65 65  if( pAgg->pBtree
6420: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
6430: 33 42 74 72 65 65 43 6c 6f 73 65 28 70 41 67 67  3BtreeClose(pAgg
6440: 2d 3e 70 42 74 72 65 65 29 3b 0a 20 20 20 20 20  ->pBtree);.     
6450: 20 70 41 67 67 2d 3e 70 42 74 72 65 65 20 3d 20   pAgg->pBtree = 
6460: 30 3b 0a 20 20 20 20 20 20 70 41 67 67 2d 3e 6e  0;.      pAgg->n
6470: 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20  Tab = 0;.    }. 
6480: 20 20 20 70 41 67 67 2d 3e 70 43 73 72 20 3d 20     pAgg->pCsr = 
6490: 30 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 41  0;.  }..  if( pA
64a0: 67 67 2d 3e 61 70 46 75 6e 63 20 29 7b 20 0a 20  gg->apFunc ){ . 
64b0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 41     sqliteFree(pA
64c0: 67 67 2d 3e 61 70 46 75 6e 63 29 3b 0a 20 20 20  gg->apFunc);.   
64d0: 20 70 41 67 67 2d 3e 61 70 46 75 6e 63 20 3d 20   pAgg->apFunc = 
64e0: 30 3b 0a 20 20 7d 0a 20 20 70 41 67 67 2d 3e 70  0;.  }.  pAgg->p
64f0: 43 75 72 72 65 6e 74 20 3d 20 30 3b 0a 20 20 70  Current = 0;.  p
6500: 41 67 67 2d 3e 6e 4d 65 6d 20 3d 20 30 3b 0a 20  Agg->nMem = 0;. 
6510: 20 70 41 67 67 2d 3e 73 65 61 72 63 68 69 6e 67   pAgg->searching
6520: 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 53   = 0;.  return S
6530: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a  QLITE_OK;.}.../*
6540: 0a 2a 2a 20 44 65 6c 65 74 65 20 61 20 6b 65 79  .** Delete a key
6550: 6c 69 73 74 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  list.*/.void sql
6560: 69 74 65 33 56 64 62 65 4b 65 79 6c 69 73 74 46  ite3VdbeKeylistF
6570: 72 65 65 28 4b 65 79 6c 69 73 74 20 2a 70 29 7b  ree(Keylist *p){
6580: 0a 20 20 77 68 69 6c 65 28 20 70 20 29 7b 0a 20  .  while( p ){. 
6590: 20 20 20 4b 65 79 6c 69 73 74 20 2a 70 4e 65 78     Keylist *pNex
65a0: 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20  t = p->pNext;.  
65b0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 29 3b    sqliteFree(p);
65c0: 0a 20 20 20 20 70 20 3d 20 70 4e 65 78 74 3b 0a  .    p = pNext;.
65d0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f    }.}../*.** Clo
65e0: 73 65 20 61 20 63 75 72 73 6f 72 20 61 6e 64 20  se a cursor and 
65f0: 72 65 6c 65 61 73 65 20 61 6c 6c 20 74 68 65 20  release all the 
6600: 72 65 73 6f 75 72 63 65 73 20 74 68 61 74 20 63  resources that c
6610: 75 72 73 6f 72 20 68 61 70 70 65 6e 73 0a 2a 2a  ursor happens.**
6620: 20 74 6f 20 68 6f 6c 64 2e 0a 2a 2f 0a 76 6f 69   to hold..*/.voi
6630: 64 20 73 71 6c 69 74 65 33 56 64 62 65 46 72 65  d sqlite3VdbeFre
6640: 65 43 75 72 73 6f 72 28 43 75 72 73 6f 72 20 2a  eCursor(Cursor *
6650: 70 43 78 29 7b 0a 20 20 69 66 28 20 70 43 78 3d  pCx){.  if( pCx=
6660: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  =0 ){.    return
6670: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 78 2d  ;.  }.  if( pCx-
6680: 3e 70 43 75 72 73 6f 72 20 29 7b 0a 20 20 20 20  >pCursor ){.    
6690: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73  sqlite3BtreeClos
66a0: 65 43 75 72 73 6f 72 28 70 43 78 2d 3e 70 43 75  eCursor(pCx->pCu
66b0: 72 73 6f 72 29 3b 0a 20 20 7d 0a 20 20 69 66 28  rsor);.  }.  if(
66c0: 20 70 43 78 2d 3e 70 42 74 20 29 7b 0a 20 20 20   pCx->pBt ){.   
66d0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
66e0: 73 65 28 70 43 78 2d 3e 70 42 74 29 3b 0a 20 20  se(pCx->pBt);.  
66f0: 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  }.  sqliteFree(p
6700: 43 78 2d 3e 70 44 61 74 61 29 3b 0a 20 20 73 71  Cx->pData);.  sq
6710: 6c 69 74 65 46 72 65 65 28 70 43 78 2d 3e 61 54  liteFree(pCx->aT
6720: 79 70 65 29 3b 0a 20 20 73 71 6c 69 74 65 46 72  ype);.  sqliteFr
6730: 65 65 28 70 43 78 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  ee(pCx);.}../*.*
6740: 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 63 75 72 73  * Close all curs
6750: 6f 72 73 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ors.*/.static vo
6760: 69 64 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f  id closeAllCurso
6770: 72 73 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69  rs(Vdbe *p){.  i
6780: 6e 74 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61  nt i;.  if( p->a
6790: 70 43 73 72 3d 3d 30 20 29 20 72 65 74 75 72 6e  pCsr==0 ) return
67a0: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70  ;.  for(i=0; i<p
67b0: 2d 3e 6e 43 75 72 73 6f 72 3b 20 69 2b 2b 29 7b  ->nCursor; i++){
67c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
67d0: 46 72 65 65 43 75 72 73 6f 72 28 70 2d 3e 61 70  FreeCursor(p->ap
67e0: 43 73 72 5b 69 5d 29 3b 0a 20 20 20 20 70 2d 3e  Csr[i]);.    p->
67f0: 61 70 43 73 72 5b 69 5d 20 3d 20 30 3b 0a 20 20  apCsr[i] = 0;.  
6800: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e  }.}../*.** Clean
6810: 20 75 70 20 74 68 65 20 56 4d 20 61 66 74 65 72   up the VM after
6820: 20 65 78 65 63 75 74 69 6f 6e 2e 0a 2a 2a 0a 2a   execution..**.*
6830: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77  * This routine w
6840: 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  ill automaticall
6850: 79 20 63 6c 6f 73 65 20 61 6e 79 20 63 75 72 73  y close any curs
6860: 6f 72 73 2c 20 6c 69 73 74 73 2c 20 61 6e 64 2f  ors, lists, and/
6870: 6f 72 0a 2a 2a 20 73 6f 72 74 65 72 73 20 74 68  or.** sorters th
6880: 61 74 20 77 65 72 65 20 6c 65 66 74 20 6f 70 65  at were left ope
6890: 6e 2e 20 20 49 74 20 61 6c 73 6f 20 64 65 6c 65  n.  It also dele
68a0: 74 65 73 20 74 68 65 20 76 61 6c 75 65 73 20 6f  tes the values o
68b0: 66 0a 2a 2a 20 76 61 72 69 61 62 6c 65 73 20 69  f.** variables i
68c0: 6e 20 74 68 65 20 61 56 61 72 5b 5d 20 61 72 72  n the aVar[] arr
68d0: 61 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ay..*/.static vo
68e0: 69 64 20 43 6c 65 61 6e 75 70 28 56 64 62 65 20  id Cleanup(Vdbe 
68f0: 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  *p){.  int i;.  
6900: 69 66 28 20 70 2d 3e 61 53 74 61 63 6b 20 29 7b  if( p->aStack ){
6910: 0a 20 20 20 20 72 65 6c 65 61 73 65 4d 65 6d 41  .    releaseMemA
6920: 72 72 61 79 28 70 2d 3e 61 53 74 61 63 6b 2c 20  rray(p->aStack, 
6930: 31 20 2b 20 28 70 2d 3e 70 54 6f 73 20 2d 20 70  1 + (p->pTos - p
6940: 2d 3e 61 53 74 61 63 6b 29 29 3b 0a 20 20 20 20  ->aStack));.    
6950: 70 2d 3e 70 54 6f 73 20 3d 20 26 70 2d 3e 61 53  p->pTos = &p->aS
6960: 74 61 63 6b 5b 2d 31 5d 3b 0a 20 20 7d 0a 20 20  tack[-1];.  }.  
6970: 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73 28  closeAllCursors(
6980: 70 29 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d  p);.  releaseMem
6990: 41 72 72 61 79 28 70 2d 3e 61 4d 65 6d 2c 20 70  Array(p->aMem, p
69a0: 2d 3e 6e 4d 65 6d 29 3b 0a 20 20 69 66 28 20 70  ->nMem);.  if( p
69b0: 2d 3e 70 4c 69 73 74 20 29 7b 0a 20 20 20 20 73  ->pList ){.    s
69c0: 71 6c 69 74 65 33 56 64 62 65 4b 65 79 6c 69 73  qlite3VdbeKeylis
69d0: 74 46 72 65 65 28 70 2d 3e 70 4c 69 73 74 29 3b  tFree(p->pList);
69e0: 0a 20 20 20 20 70 2d 3e 70 4c 69 73 74 20 3d 20  .    p->pList = 
69f0: 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e  0;.  }.  if( p->
6a00: 63 6f 6e 74 65 78 74 53 74 61 63 6b 20 29 7b 0a  contextStack ){.
6a10: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
6a20: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 54 6f  ->contextStackTo
6a30: 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 73  p; i++){.      s
6a40: 71 6c 69 74 65 33 56 64 62 65 4b 65 79 6c 69 73  qlite3VdbeKeylis
6a50: 74 46 72 65 65 28 70 2d 3e 63 6f 6e 74 65 78 74  tFree(p->context
6a60: 53 74 61 63 6b 5b 69 5d 2e 70 4c 69 73 74 29 3b  Stack[i].pList);
6a70: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
6a80: 65 46 72 65 65 28 70 2d 3e 63 6f 6e 74 65 78 74  eFree(p->context
6a90: 53 74 61 63 6b 29 3b 0a 20 20 7d 0a 20 20 73 71  Stack);.  }.  sq
6aa0: 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65 72 52  lite3VdbeSorterR
6ab0: 65 73 65 74 28 70 29 3b 0a 20 20 66 6f 72 28 69  eset(p);.  for(i
6ac0: 3d 30 3b 20 69 3c 70 2d 3e 6e 41 67 67 3b 20 69  =0; i<p->nAgg; i
6ad0: 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ++){.    sqlite3
6ae0: 56 64 62 65 41 67 67 52 65 73 65 74 28 30 2c 20  VdbeAggReset(0, 
6af0: 26 70 2d 3e 61 70 41 67 67 5b 69 5d 2c 20 30 29  &p->apAgg[i], 0)
6b00: 3b 0a 20 20 7d 0a 20 20 70 2d 3e 63 6f 6e 74 65  ;.  }.  p->conte
6b10: 78 74 53 74 61 63 6b 20 3d 20 30 3b 0a 20 20 70  xtStack = 0;.  p
6b20: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 44 65  ->contextStackDe
6b30: 70 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f  pth = 0;.  p->co
6b40: 6e 74 65 78 74 53 74 61 63 6b 54 6f 70 20 3d 20  ntextStackTop = 
6b50: 30 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  0;.  sqliteFree(
6b60: 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 70  p->zErrMsg);.  p
6b70: 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 7d  ->zErrMsg = 0;.}
6b80: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
6b90: 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74  number of result
6ba0: 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 77 69   columns that wi
6bb0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 62  ll be returned b
6bc0: 79 20 74 68 69 73 20 53 51 4c 0a 2a 2a 20 73 74  y this SQL.** st
6bd0: 61 74 65 6d 65 6e 74 2e 20 54 68 69 73 20 69 73  atement. This is
6be0: 20 6e 6f 77 20 73 65 74 20 61 74 20 63 6f 6d 70   now set at comp
6bf0: 69 6c 65 20 74 69 6d 65 2c 20 72 61 74 68 65 72  ile time, rather
6c00: 20 74 68 61 6e 20 64 75 72 69 6e 67 0a 2a 2a 20   than during.** 
6c10: 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65  execution of the
6c20: 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20 73 6f   vdbe program so
6c30: 20 74 68 61 74 20 73 71 6c 69 74 65 33 5f 63 6f   that sqlite3_co
6c40: 6c 75 6d 6e 5f 63 6f 75 6e 74 28 29 20 63 61 6e  lumn_count() can
6c50: 0a 2a 2a 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e  .** be called on
6c60: 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e   an SQL statemen
6c70: 74 20 62 65 66 6f 72 65 20 73 71 6c 69 74 65 33  t before sqlite3
6c80: 5f 73 74 65 70 28 29 2e 0a 2a 2f 0a 76 6f 69 64  _step()..*/.void
6c90: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e   sqlite3VdbeSetN
6ca0: 75 6d 43 6f 6c 73 28 56 64 62 65 20 2a 70 2c 20  umCols(Vdbe *p, 
6cb0: 69 6e 74 20 6e 52 65 73 43 6f 6c 75 6d 6e 29 7b  int nResColumn){
6cc0: 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65  .  Mem *pColName
6cd0: 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 61 73 73  ;.  int n;.  ass
6ce0: 65 72 74 28 20 30 3d 3d 70 2d 3e 6e 52 65 73 43  ert( 0==p->nResC
6cf0: 6f 6c 75 6d 6e 20 29 3b 0a 20 20 70 2d 3e 6e 52  olumn );.  p->nR
6d00: 65 73 43 6f 6c 75 6d 6e 20 3d 20 6e 52 65 73 43  esColumn = nResC
6d10: 6f 6c 75 6d 6e 3b 0a 20 20 6e 20 3d 20 6e 52 65  olumn;.  n = nRe
6d20: 73 43 6f 6c 75 6d 6e 2a 32 3b 0a 20 20 70 2d 3e  sColumn*2;.  p->
6d30: 61 43 6f 6c 4e 61 6d 65 20 3d 20 70 43 6f 6c 4e  aColName = pColN
6d40: 61 6d 65 20 3d 20 28 4d 65 6d 2a 29 73 71 6c 69  ame = (Mem*)sqli
6d50: 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66  teMalloc( sizeof
6d60: 28 4d 65 6d 29 2a 6e 20 29 3b 0a 20 20 69 66 28  (Mem)*n );.  if(
6d70: 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 3d 3d 30 20   p->aColName==0 
6d80: 29 20 72 65 74 75 72 6e 3b 0a 20 20 77 68 69 6c  ) return;.  whil
6d90: 65 28 20 6e 2d 2d 20 3e 20 30 20 29 7b 0a 20 20  e( n-- > 0 ){.  
6da0: 20 20 28 70 43 6f 6c 4e 61 6d 65 2b 2b 29 2d 3e    (pColName++)->
6db0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
6dc0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  ;.  }.}../*.** S
6dd0: 65 74 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  et the name of t
6de0: 68 65 20 69 64 78 27 74 68 20 63 6f 6c 75 6d 6e  he idx'th column
6df0: 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 20   to be returned 
6e00: 62 79 20 74 68 65 20 53 51 4c 20 73 74 61 74 65  by the SQL state
6e10: 6d 65 6e 74 2e 0a 2a 2a 20 7a 4e 61 6d 65 20 6d  ment..** zName m
6e20: 75 73 74 20 62 65 20 61 20 70 6f 69 6e 74 65 72  ust be a pointer
6e30: 20 74 6f 20 61 20 6e 75 6c 20 74 65 72 6d 69 6e   to a nul termin
6e40: 61 74 65 64 20 73 74 72 69 6e 67 2e 0a 2a 2a 0a  ated string..**.
6e50: 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 75 73  ** This call mus
6e60: 74 20 62 65 20 6d 61 64 65 20 61 66 74 65 72 20  t be made after 
6e70: 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65  a call to sqlite
6e80: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
6e90: 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e 3d 3d 50  )..**.** If N==P
6ea0: 33 5f 53 54 41 54 49 43 20 20 69 74 20 6d 65 61  3_STATIC  it mea
6eb0: 6e 73 20 74 68 61 74 20 7a 4e 61 6d 65 20 69 73  ns that zName is
6ec0: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20   a pointer to a 
6ed0: 63 6f 6e 73 74 61 6e 74 20 73 74 61 74 69 63 0a  constant static.
6ee0: 2a 2a 20 73 74 72 69 6e 67 20 61 6e 64 20 77 65  ** string and we
6ef0: 20 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74   can just copy t
6f00: 68 65 20 70 6f 69 6e 74 65 72 2e 20 49 66 20 69  he pointer. If i
6f10: 74 20 69 73 20 50 33 5f 44 59 4e 41 4d 49 43 2c  t is P3_DYNAMIC,
6f20: 20 74 68 65 6e 20 0a 2a 2a 20 74 68 65 20 73 74   then .** the st
6f30: 72 69 6e 67 20 69 73 20 66 72 65 65 64 20 75 73  ring is freed us
6f40: 69 6e 67 20 73 71 6c 69 74 65 46 72 65 65 28 29  ing sqliteFree()
6f50: 20 77 68 65 6e 20 74 68 65 20 76 64 62 65 20 69   when the vdbe i
6f60: 73 20 66 69 6e 69 73 68 65 64 20 77 69 74 68 0a  s finished with.
6f70: 2a 2a 20 69 74 2e 20 4f 74 68 65 72 77 69 73 65  ** it. Otherwise
6f80: 2c 20 4e 20 62 79 74 65 73 20 6f 66 20 7a 4e 61  , N bytes of zNa
6f90: 6d 65 20 61 72 65 20 63 6f 70 69 65 64 2e 0a 2a  me are copied..*
6fa0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
6fb0: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 56 64 62 65  eSetColName(Vdbe
6fc0: 20 2a 70 2c 20 69 6e 74 20 69 64 78 2c 20 63 6f   *p, int idx, co
6fd0: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
6fe0: 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72   int N){.  int r
6ff0: 63 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61  c;.  Mem *pColNa
7000: 6d 65 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64  me;.  assert( id
7010: 78 3c 28 32 2a 70 2d 3e 6e 52 65 73 43 6f 6c 75  x<(2*p->nResColu
7020: 6d 6e 29 20 29 3b 0a 20 20 69 66 28 20 73 71 6c  mn) );.  if( sql
7030: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
7040: 65 64 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49  ed ) return SQLI
7050: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 61 73 73 65  TE_NOMEM;.  asse
7060: 72 74 28 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21  rt( p->aColName!
7070: 3d 30 20 29 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65  =0 );.  pColName
7080: 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65   = &(p->aColName
7090: 5b 69 64 78 5d 29 3b 0a 20 20 69 66 28 20 4e 3d  [idx]);.  if( N=
70a0: 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 4e  =P3_DYNAMIC || N
70b0: 3d 3d 50 33 5f 53 54 41 54 49 43 20 29 7b 0a 20  ==P3_STATIC ){. 
70c0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
70d0: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 6f  dbeMemSetStr(pCo
70e0: 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31  lName, zName, -1
70f0: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53  , SQLITE_UTF8, S
7100: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
7110: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d   }else{.    rc =
7120: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
7130: 65 74 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20  etStr(pColName, 
7140: 7a 4e 61 6d 65 2c 20 4e 2c 20 53 51 4c 49 54 45  zName, N, SQLITE
7150: 5f 55 54 46 38 2c 53 51 4c 49 54 45 5f 54 52 41  _UTF8,SQLITE_TRA
7160: 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 0a 20 20 69  NSIENT);.  }.  i
7170: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
7180: 20 26 26 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49   && N==P3_DYNAMI
7190: 43 20 29 7b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d  C ){.    pColNam
71a0: 65 2d 3e 66 6c 61 67 73 20 3d 20 28 70 43 6f 6c  e->flags = (pCol
71b0: 4e 61 6d 65 2d 3e 66 6c 61 67 73 26 28 7e 4d 45  Name->flags&(~ME
71c0: 4d 5f 53 74 61 74 69 63 29 29 7c 4d 45 4d 5f 44  M_Static))|MEM_D
71d0: 79 6e 3b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65  yn;.    pColName
71e0: 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a  ->xDel = 0;.  }.
71f0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
7200: 2f 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6f 72 20  /*.** A read or 
7210: 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f  write transactio
7220: 6e 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74  n may or may not
7230: 20 62 65 20 61 63 74 69 76 65 20 6f 6e 20 64 61   be active on da
7240: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a  tabase handle.**
7250: 20 64 62 2e 20 49 66 20 61 20 74 72 61 6e 73 61   db. If a transa
7260: 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2c  ction is active,
7270: 20 63 6f 6d 6d 69 74 20 69 74 2e 20 49 66 20 74   commit it. If t
7280: 68 65 72 65 20 69 73 20 61 0a 2a 2a 20 77 72 69  here is a.** wri
7290: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73  te-transaction s
72a0: 70 61 6e 6e 69 6e 67 20 6d 6f 72 65 20 74 68 61  panning more tha
72b0: 6e 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66  n one database f
72c0: 69 6c 65 2c 20 74 68 69 73 20 72 6f 75 74 69 6e  ile, this routin
72d0: 65 0a 2a 2a 20 74 61 6b 65 73 20 63 61 72 65 20  e.** takes care 
72e0: 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  of the master jo
72f0: 75 72 6e 61 6c 20 74 72 69 63 6b 65 72 79 2e 0a  urnal trickery..
7300: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64  */.static int vd
7310: 62 65 43 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33  beCommit(sqlite3
7320: 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a   *db){.  int i;.
7330: 20 20 69 6e 74 20 6e 54 72 61 6e 73 20 3d 20 30    int nTrans = 0
7340: 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20  ;  /* Number of 
7350: 64 61 74 61 62 61 73 65 73 20 77 69 74 68 20 61  databases with a
7360: 6e 20 61 63 74 69 76 65 20 77 72 69 74 65 2d 74  n active write-t
7370: 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20  ransaction */.  
7380: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
7390: 4f 4b 3b 0a 20 20 69 6e 74 20 6e 65 65 64 58 63  OK;.  int needXc
73a0: 6f 6d 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 66 6f  ommit = 0;..  fo
73b0: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62  r(i=0; i<db->nDb
73c0: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 42 74 72  ; i++){ .    Btr
73d0: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
73e0: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66  b[i].pBt;.    if
73f0: 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65 33  ( pBt && sqlite3
7400: 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70  BtreeIsInTrans(p
7410: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 6e 65 65  Bt) ){.      nee
7420: 64 58 63 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20  dXcommit = 1;.  
7430: 20 20 20 20 69 66 28 20 69 21 3d 31 20 29 20 6e      if( i!=1 ) n
7440: 54 72 61 6e 73 2b 2b 3b 0a 20 20 20 20 7d 0a 20  Trans++;.    }. 
7450: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72   }..  /* If ther
7460: 65 20 61 72 65 20 61 6e 79 20 77 72 69 74 65 2d  e are any write-
7470: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 74 20  transactions at 
7480: 61 6c 6c 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20  all, invoke the 
7490: 63 6f 6d 6d 69 74 20 68 6f 6f 6b 20 2a 2f 0a 20  commit hook */. 
74a0: 20 69 66 28 20 6e 65 65 64 58 63 6f 6d 6d 69 74   if( needXcommit
74b0: 20 26 26 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43   && db->xCommitC
74c0: 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 69  allback ){.    i
74d0: 6e 74 20 72 63 3b 0a 20 20 20 20 73 71 6c 69 74  nt rc;.    sqlit
74e0: 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b  e3SafetyOff(db);
74f0: 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 78 43  .    rc = db->xC
7500: 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 28 64 62  ommitCallback(db
7510: 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 29 3b 0a 20  ->pCommitArg);. 
7520: 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79     sqlite3Safety
7530: 4f 6e 28 64 62 29 3b 0a 20 20 20 20 69 66 28 20  On(db);.    if( 
7540: 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75  rc ){.      retu
7550: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52  rn SQLITE_CONSTR
7560: 41 49 4e 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  AINT;.    }.  }.
7570: 0a 20 20 2f 2a 20 54 68 65 20 73 69 6d 70 6c 65  .  /* The simple
7580: 20 63 61 73 65 20 2d 20 6e 6f 20 6d 6f 72 65 20   case - no more 
7590: 74 68 61 6e 20 6f 6e 65 20 64 61 74 61 62 61 73  than one databas
75a0: 65 20 66 69 6c 65 20 28 6e 6f 74 20 63 6f 75 6e  e file (not coun
75b0: 74 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 54 45  ting the.  ** TE
75c0: 4d 50 20 64 61 74 61 62 61 73 65 29 20 68 61 73  MP database) has
75d0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61   a transaction a
75e0: 63 74 69 76 65 2e 20 20 20 54 68 65 72 65 20 69  ctive.   There i
75f0: 73 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 74 68  s no need for th
7600: 65 0a 20 20 2a 2a 20 6d 61 73 74 65 72 2d 6a 6f  e.  ** master-jo
7610: 75 72 6e 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  urnal..  **.  **
7620: 20 49 66 20 74 68 65 20 72 65 74 75 72 6e 20 76   If the return v
7630: 61 6c 75 65 20 6f 66 20 73 71 6c 69 74 65 33 42  alue of sqlite3B
7640: 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28  treeGetFilename(
7650: 29 20 69 73 20 61 20 7a 65 72 6f 20 6c 65 6e 67  ) is a zero leng
7660: 74 68 0a 20 20 2a 2a 20 73 74 72 69 6e 67 2c 20  th.  ** string, 
7670: 69 74 20 6d 65 61 6e 73 20 74 68 65 20 6d 61 69  it means the mai
7680: 6e 20 64 61 74 61 62 61 73 65 20 69 73 20 3a 6d  n database is :m
7690: 65 6d 6f 72 79 3a 2e 20 20 49 6e 20 74 68 61 74  emory:.  In that
76a0: 20 63 61 73 65 20 77 65 20 64 6f 0a 20 20 2a 2a   case we do.  **
76b0: 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 74 6f   not support ato
76c0: 6d 69 63 20 6d 75 6c 74 69 2d 66 69 6c 65 20 63  mic multi-file c
76d0: 6f 6d 6d 69 74 73 2c 20 73 6f 20 75 73 65 20 74  ommits, so use t
76e0: 68 65 20 73 69 6d 70 6c 65 20 63 61 73 65 20 74  he simple case t
76f0: 68 65 6e 0a 20 20 2a 2a 20 74 6f 6f 2e 0a 20 20  hen.  ** too..  
7700: 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 73 74 72 6c  */.  if( 0==strl
7710: 65 6e 28 73 71 6c 69 74 65 33 42 74 72 65 65 47  en(sqlite3BtreeG
7720: 65 74 46 69 6c 65 6e 61 6d 65 28 64 62 2d 3e 61  etFilename(db->a
7730: 44 62 5b 30 5d 2e 70 42 74 29 29 20 7c 7c 20 6e  Db[0].pBt)) || n
7740: 54 72 61 6e 73 3c 3d 31 20 29 7b 0a 20 20 20 20  Trans<=1 ){.    
7750: 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c  for(i=0; rc==SQL
7760: 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e  ITE_OK && i<db->
7770: 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20  nDb; i++){ .    
7780: 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64    Btree *pBt = d
7790: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20  b->aDb[i].pBt;. 
77a0: 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a       if( pBt ){.
77b0: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
77c0: 69 74 65 33 42 74 72 65 65 53 79 6e 63 28 70 42  ite3BtreeSync(pB
77d0: 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20  t, 0);.      }. 
77e0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 6f 20     }..    /* Do 
77f0: 74 68 65 20 63 6f 6d 6d 69 74 20 6f 6e 6c 79 20  the commit only 
7800: 69 66 20 61 6c 6c 20 64 61 74 61 62 61 73 65 73  if all databases
7810: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 73 79   successfully sy
7820: 6e 63 65 64 20 2a 2f 0a 20 20 20 20 69 66 28 20  nced */.    if( 
7830: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
7840: 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  .      for(i=0; 
7850: 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b  i<db->nDb; i++){
7860: 0a 20 20 20 20 20 20 20 20 42 74 72 65 65 20 2a  .        Btree *
7870: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d  pBt = db->aDb[i]
7880: 2e 70 42 74 3b 0a 20 20 20 20 20 20 20 20 69 66  .pBt;.        if
7890: 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20  ( pBt ){.       
78a0: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
78b0: 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20  ommit(pBt);.    
78c0: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20      }.      }.  
78d0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68    }.  }..  /* Th
78e0: 65 20 63 6f 6d 70 6c 65 78 20 63 61 73 65 20 2d  e complex case -
78f0: 20 54 68 65 72 65 20 69 73 20 61 20 6d 75 6c 74   There is a mult
7900: 69 2d 66 69 6c 65 20 77 72 69 74 65 2d 74 72 61  i-file write-tra
7910: 6e 73 61 63 74 69 6f 6e 20 61 63 74 69 76 65 2e  nsaction active.
7920: 0a 20 20 2a 2a 20 54 68 69 73 20 72 65 71 75 69  .  ** This requi
7930: 72 65 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  res a master jou
7940: 72 6e 61 6c 20 66 69 6c 65 20 74 6f 20 65 6e 73  rnal file to ens
7950: 75 72 65 20 74 68 65 20 74 72 61 6e 73 61 63 74  ure the transact
7960: 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 63 6f 6d 6d  ion is.  ** comm
7970: 69 74 74 65 64 20 61 74 6f 6d 69 63 6c 79 2e 0a  itted atomicly..
7980: 20 20 2a 2f 0a 20 20 65 6c 73 65 7b 0a 20 20 20    */.  else{.   
7990: 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d   char *zMaster =
79a0: 20 30 3b 20 20 20 2f 2a 20 46 69 6c 65 2d 6e 61   0;   /* File-na
79b0: 6d 65 20 66 6f 72 20 74 68 65 20 6d 61 73 74 65  me for the maste
79c0: 72 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20  r journal */.   
79d0: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61   char const *zMa
79e0: 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33  inFile = sqlite3
79f0: 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65  BtreeGetFilename
7a00: 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29  (db->aDb[0].pBt)
7a10: 3b 0a 20 20 20 20 4f 73 46 69 6c 65 20 6d 61 73  ;.    OsFile mas
7a20: 74 65 72 3b 0a 0a 20 20 20 20 2f 2a 20 53 65 6c  ter;..    /* Sel
7a30: 65 63 74 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  ect a master jou
7a40: 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 2a  rnal file name *
7a50: 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20  /.    do {.     
7a60: 20 75 33 32 20 72 61 6e 64 6f 6d 3b 0a 20 20 20   u32 random;.   
7a70: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
7a80: 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71  aster);.      sq
7a90: 6c 69 74 65 33 52 61 6e 64 6f 6d 6e 65 73 73 28  lite3Randomness(
7aa0: 73 69 7a 65 6f 66 28 72 61 6e 64 6f 6d 29 2c 20  sizeof(random), 
7ab0: 26 72 61 6e 64 6f 6d 29 3b 0a 20 20 20 20 20 20  &random);.      
7ac0: 7a 4d 61 73 74 65 72 20 3d 20 73 71 6c 69 74 65  zMaster = sqlite
7ad0: 33 4d 50 72 69 6e 74 66 28 22 25 73 2d 6d 6a 25  3MPrintf("%s-mj%
7ae0: 30 38 58 22 2c 20 7a 4d 61 69 6e 46 69 6c 65 2c  08X", zMainFile,
7af0: 20 72 61 6e 64 6f 6d 26 30 78 37 66 66 66 66 66   random&0x7fffff
7b00: 66 66 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21  ff);.      if( !
7b10: 7a 4d 61 73 74 65 72 20 29 7b 0a 20 20 20 20 20  zMaster ){.     
7b20: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
7b30: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a  _NOMEM;.      }.
7b40: 20 20 20 20 7d 77 68 69 6c 65 28 20 73 71 6c 69      }while( sqli
7b50: 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73 28  te3OsFileExists(
7b60: 7a 4d 61 73 74 65 72 29 20 29 3b 0a 0a 20 20 20  zMaster) );..   
7b70: 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 6d 61 73   /* Open the mas
7b80: 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a  ter journal. */.
7b90: 20 20 20 20 6d 65 6d 73 65 74 28 26 6d 61 73 74      memset(&mast
7ba0: 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 61  er, 0, sizeof(ma
7bb0: 73 74 65 72 29 29 3b 0a 20 20 20 20 72 63 20 3d  ster));.    rc =
7bc0: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78   sqlite3OsOpenEx
7bd0: 63 6c 75 73 69 76 65 28 7a 4d 61 73 74 65 72 2c  clusive(zMaster,
7be0: 20 26 6d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20   &master, 0);.  
7bf0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
7c00: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  _OK ){.      sql
7c10: 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29  iteFree(zMaster)
7c20: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  ;.      return r
7c30: 63 3b 0a 20 20 20 20 7d 0a 20 0a 20 20 20 20 2f  c;.    }. .    /
7c40: 2a 20 57 72 69 74 65 20 74 68 65 20 6e 61 6d 65  * Write the name
7c50: 20 6f 66 20 65 61 63 68 20 64 61 74 61 62 61 73   of each databas
7c60: 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20 74 72  e file in the tr
7c70: 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74 6f 20 74  ansaction into t
7c80: 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20 6d 61  he new.    ** ma
7c90: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
7ca0: 65 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f  e. If an error o
7cb0: 63 63 75 72 73 20 61 74 20 74 68 69 73 20 70 6f  ccurs at this po
7cc0: 69 6e 74 20 63 6c 6f 73 65 0a 20 20 20 20 2a 2a  int close.    **
7cd0: 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20   and delete the 
7ce0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
7cf0: 69 6c 65 2e 20 41 6c 6c 20 74 68 65 20 69 6e 64  ile. All the ind
7d00: 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20  ividual journal 
7d10: 66 69 6c 65 73 0a 20 20 20 20 2a 2a 20 73 74 69  files.    ** sti
7d20: 6c 6c 20 68 61 76 65 20 27 6e 75 6c 6c 27 20 61  ll have 'null' a
7d30: 73 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  s the master jou
7d40: 72 6e 61 6c 20 70 6f 69 6e 74 65 72 2c 20 73 6f  rnal pointer, so
7d50: 20 74 68 65 79 20 77 69 6c 6c 20 72 6f 6c 6c 0a   they will roll.
7d60: 20 20 20 20 2a 2a 20 62 61 63 6b 20 69 6e 64 65      ** back inde
7d70: 70 65 6e 64 65 6e 74 6c 79 20 69 66 20 61 20 66  pendently if a f
7d80: 61 69 6c 75 72 65 20 6f 63 63 75 72 73 2e 0a 20  ailure occurs.. 
7d90: 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d     */.    for(i=
7da0: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  0; i<db->nDb; i+
7db0: 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65 65  +){ .      Btree
7dc0: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b   *pBt = db->aDb[
7dd0: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66  i].pBt;.      if
7de0: 28 20 69 3d 3d 31 20 29 20 63 6f 6e 74 69 6e 75  ( i==1 ) continu
7df0: 65 3b 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74  e;   /* Ignore t
7e00: 68 65 20 54 45 4d 50 20 64 61 74 61 62 61 73 65  he TEMP database
7e10: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42   */.      if( pB
7e20: 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 72 65  t && sqlite3Btre
7e30: 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20  eIsInTrans(pBt) 
7e40: 29 7b 0a 20 20 20 20 20 20 20 20 63 68 61 72 20  ){.        char 
7e50: 63 6f 6e 73 74 20 2a 7a 46 69 6c 65 20 3d 20 73  const *zFile = s
7e60: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 4a 6f  qlite3BtreeGetJo
7e70: 75 72 6e 61 6c 6e 61 6d 65 28 70 42 74 29 3b 0a  urnalname(pBt);.
7e80: 20 20 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c          if( zFil
7e90: 65 5b 30 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e  e[0]==0 ) contin
7ea0: 75 65 3b 20 20 2f 2a 20 49 67 6e 6f 72 65 20 3a  ue;  /* Ignore :
7eb0: 6d 65 6d 6f 72 79 3a 20 64 61 74 61 62 61 73 65  memory: database
7ec0: 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20  s */.        rc 
7ed0: 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65  = sqlite3OsWrite
7ee0: 28 26 6d 61 73 74 65 72 2c 20 7a 46 69 6c 65 2c  (&master, zFile,
7ef0: 20 73 74 72 6c 65 6e 28 7a 46 69 6c 65 29 2b 31   strlen(zFile)+1
7f00: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72  );.        if( r
7f10: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
7f20: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
7f30: 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72  3OsClose(&master
7f40: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  );.          sql
7f50: 69 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61  ite3OsDelete(zMa
7f60: 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20  ster);.         
7f70: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
7f80: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ter);.          
7f90: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20  return rc;.     
7fa0: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
7fb0: 20 7d 0a 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63   }...    /* Sync
7fc0: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72   the master jour
7fd0: 6e 61 6c 20 66 69 6c 65 2e 20 42 65 66 6f 72 65  nal file. Before
7fe0: 20 64 6f 69 6e 67 20 74 68 69 73 2c 20 6f 70 65   doing this, ope
7ff0: 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a  n the directory.
8000: 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 73 74 65      ** the maste
8010: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69  r journal file i
8020: 73 20 73 74 6f 72 65 20 69 6e 20 73 6f 20 74 68  s store in so th
8030: 61 74 20 69 74 20 67 65 74 73 20 73 79 6e 63 65  at it gets synce
8040: 64 20 74 6f 6f 2e 0a 20 20 20 20 2a 2f 0a 20 20  d too..    */.  
8050: 20 20 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71    zMainFile = sq
8060: 6c 69 74 65 33 42 74 72 65 65 47 65 74 44 69 72  lite3BtreeGetDir
8070: 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e  name(db->aDb[0].
8080: 70 42 74 29 3b 0a 20 20 20 20 72 63 20 3d 20 73  pBt);.    rc = s
8090: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 44 69 72 65  qlite3OsOpenDire
80a0: 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69 6c 65 2c  ctory(zMainFile,
80b0: 20 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 69   &master);.    i
80c0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
80d0: 20 7c 7c 20 28 72 63 20 3d 20 73 71 6c 69 74 65   || (rc = sqlite
80e0: 33 4f 73 53 79 6e 63 28 26 6d 61 73 74 65 72 29  3OsSync(&master)
80f0: 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  )!=SQLITE_OK ){.
8100: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43        sqlite3OsC
8110: 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20  lose(&master);. 
8120: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65       sqlite3OsDe
8130: 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20  lete(zMaster);. 
8140: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
8150: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  zMaster);.      
8160: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d  return rc;.    }
8170: 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63 20 61 6c  ..    /* Sync al
8180: 6c 20 74 68 65 20 64 62 20 66 69 6c 65 73 20 69  l the db files i
8190: 6e 76 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 74  nvolved in the t
81a0: 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20  ransaction. The 
81b0: 73 61 6d 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a  same call.    **
81c0: 20 73 65 74 73 20 74 68 65 20 6d 61 73 74 65 72   sets the master
81d0: 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72   journal pointer
81e0: 20 69 6e 20 65 61 63 68 20 69 6e 64 69 76 69 64   in each individ
81f0: 75 61 6c 20 6a 6f 75 72 6e 61 6c 2e 20 49 66 0a  ual journal. If.
8200: 20 20 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 20      ** an error 
8210: 6f 63 63 75 72 73 20 68 65 72 65 2c 20 64 6f 20  occurs here, do 
8220: 6e 6f 74 20 64 65 6c 65 74 65 20 74 68 65 20 6d  not delete the m
8230: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
8240: 6c 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a  le..    **.    *
8250: 2a 20 49 66 20 74 68 65 20 65 72 72 6f 72 20 6f  * If the error o
8260: 63 63 75 72 73 20 64 75 72 69 6e 67 20 74 68 65  ccurs during the
8270: 20 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 20 73   first call to s
8280: 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63 28  qlite3BtreeSync(
8290: 29 2c 0a 20 20 20 20 2a 2a 20 74 68 65 6e 20 74  ),.    ** then t
82a0: 68 65 72 65 20 69 73 20 61 20 63 68 61 6e 63 65  here is a chance
82b0: 20 74 68 61 74 20 74 68 65 20 6d 61 73 74 65 72   that the master
82c0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 69   journal file wi
82d0: 6c 6c 20 62 65 0a 20 20 20 20 2a 2a 20 6f 72 70  ll be.    ** orp
82e0: 68 61 6e 65 64 2e 20 42 75 74 20 77 65 20 63 61  haned. But we ca
82f0: 6e 6e 6f 74 20 64 65 6c 65 74 65 20 69 74 2c 20  nnot delete it, 
8300: 69 6e 20 63 61 73 65 20 74 68 65 20 6d 61 73 74  in case the mast
8310: 65 72 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a  er journal.    *
8320: 2a 20 66 69 6c 65 20 6e 61 6d 65 20 77 61 73 20  * file name was 
8330: 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65  written into the
8340: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 62 65   journal file be
8350: 66 6f 72 65 20 74 68 65 20 66 61 69 6c 75 72 65  fore the failure
8360: 0a 20 20 20 20 2a 2a 20 6f 63 63 75 72 65 64 2e  .    ** occured.
8370: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28  .    */.    for(
8380: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
8390: 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72  i++){ .      Btr
83a0: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
83b0: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20  b[i].pBt;.      
83c0: 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 74  if( pBt && sqlit
83d0: 65 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73  e3BtreeIsInTrans
83e0: 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 20  (pBt) ){.       
83f0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
8400: 65 65 53 79 6e 63 28 70 42 74 2c 20 7a 4d 61 73  eeSync(pBt, zMas
8410: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69 66  ter);.        if
8420: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
8430: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  ){.          sql
8440: 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73  ite3OsClose(&mas
8450: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ter);.          
8460: 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74  sqliteFree(zMast
8470: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72  er);.          r
8480: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
8490: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20    }.      }.    
84a0: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43  }.    sqlite3OsC
84b0: 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 0a  lose(&master);..
84c0: 20 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 74 68      /* Delete th
84d0: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
84e0: 20 66 69 6c 65 2e 20 54 68 69 73 20 63 6f 6d 6d   file. This comm
84f0: 69 74 73 20 74 68 65 20 74 72 61 6e 73 61 63 74  its the transact
8500: 69 6f 6e 2e 20 41 66 74 65 72 0a 20 20 20 20 2a  ion. After.    *
8510: 2a 20 64 6f 69 6e 67 20 74 68 69 73 20 74 68 65  * doing this the
8520: 20 64 69 72 65 63 74 6f 72 79 20 69 73 20 73 79   directory is sy
8530: 6e 63 65 64 20 61 67 61 69 6e 20 62 65 66 6f 72  nced again befor
8540: 65 20 61 6e 79 20 69 6e 64 69 76 69 64 75 61 6c  e any individual
8550: 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74  .    ** transact
8560: 69 6f 6e 20 66 69 6c 65 73 20 61 72 65 20 64 65  ion files are de
8570: 6c 65 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  leted..    */.  
8580: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
8590: 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b  Delete(zMaster);
85a0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d  .    assert( rc=
85b0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20  =SQLITE_OK );.  
85c0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61    sqliteFree(zMa
85d0: 73 74 65 72 29 3b 0a 20 20 20 20 7a 4d 61 73 74  ster);.    zMast
85e0: 65 72 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d  er = 0;.    rc =
85f0: 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69   sqlite3OsSyncDi
8600: 72 65 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69 6c  rectory(zMainFil
8610: 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d  e);.    if( rc!=
8620: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
8630: 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 6e 6f     /* This is no
8640: 74 20 67 6f 6f 64 2e 20 54 68 65 20 6d 61 73 74  t good. The mast
8650: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  er journal file 
8660: 68 61 73 20 62 65 65 6e 20 64 65 6c 65 74 65 64  has been deleted
8670: 2c 20 62 75 74 0a 20 20 20 20 20 20 2a 2a 20 74  , but.      ** t
8680: 68 65 20 64 69 72 65 63 74 6f 72 79 20 73 79 6e  he directory syn
8690: 63 20 66 61 69 6c 65 64 2e 20 54 68 65 72 65 20  c failed. There 
86a0: 69 73 20 6e 6f 20 63 6f 6d 70 6c 65 74 65 6c 79  is no completely
86b0: 20 73 61 66 65 20 63 6f 75 72 73 65 20 6f 66 0a   safe course of.
86c0: 20 20 20 20 20 20 2a 2a 20 61 63 74 69 6f 6e 20        ** action 
86d0: 66 72 6f 6d 20 68 65 72 65 2e 20 54 68 65 20 69  from here. The i
86e0: 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61  ndividual journa
86f0: 6c 73 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 6e  ls contain the n
8700: 61 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20  ame of the.     
8710: 20 2a 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e   ** master journ
8720: 61 6c 20 66 69 6c 65 2c 20 62 75 74 20 74 68 65  al file, but the
8730: 72 65 20 69 73 20 6e 6f 20 77 61 79 20 6f 66 20  re is no way of 
8740: 6b 6e 6f 77 69 6e 67 20 69 66 20 74 68 61 74 0a  knowing if that.
8750: 20 20 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20        ** master 
8760: 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74 73 20 6e  journal exists n
8770: 6f 77 20 6f 72 20 69 66 20 69 74 20 77 69 6c 6c  ow or if it will
8780: 20 65 78 69 73 74 20 61 66 74 65 72 20 74 68 65   exist after the
8790: 20 6f 70 65 72 61 74 69 6e 67 0a 20 20 20 20 20   operating.     
87a0: 20 2a 2a 20 73 79 73 74 65 6d 20 63 72 61 73 68   ** system crash
87b0: 20 74 68 61 74 20 6d 61 79 20 66 6f 6c 6c 6f 77   that may follow
87c0: 20 74 68 65 20 66 73 79 6e 63 28 29 20 66 61 69   the fsync() fai
87d0: 6c 75 72 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  lure..      */. 
87e0: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
87f0: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 41 6c      }..    /* Al
8800: 6c 20 66 69 6c 65 73 20 61 6e 64 20 64 69 72 65  l files and dire
8810: 63 74 6f 72 69 65 73 20 68 61 76 65 20 61 6c 72  ctories have alr
8820: 65 61 64 79 20 62 65 65 6e 20 73 79 6e 63 65 64  eady been synced
8830: 2c 20 73 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69  , so the followi
8840: 6e 67 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 73 20  ng.    ** calls 
8850: 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 43  to sqlite3BtreeC
8860: 6f 6d 6d 69 74 28 29 20 61 72 65 20 6f 6e 6c 79  ommit() are only
8870: 20 63 6c 6f 73 69 6e 67 20 66 69 6c 65 73 20 61   closing files a
8880: 6e 64 20 64 65 6c 65 74 69 6e 67 0a 20 20 20 20  nd deleting.    
8890: 2a 2a 20 6a 6f 75 72 6e 61 6c 73 2e 20 49 66 20  ** journals. If 
88a0: 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77  something goes w
88b0: 72 6f 6e 67 20 77 68 69 6c 65 20 74 68 69 73 20  rong while this 
88c0: 69 73 20 68 61 70 70 65 6e 69 6e 67 20 77 65 20  is happening we 
88d0: 64 6f 6e 27 74 0a 20 20 20 20 2a 2a 20 72 65 61  don't.    ** rea
88e0: 6c 6c 79 20 63 61 72 65 2e 20 54 68 65 20 69 6e  lly care. The in
88f0: 74 65 67 72 69 74 79 20 6f 66 20 74 68 65 20 74  tegrity of the t
8900: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 6c  ransaction is al
8910: 72 65 61 64 79 20 67 75 61 72 61 6e 74 65 65 64  ready guaranteed
8920: 2c 0a 20 20 20 20 2a 2a 20 62 75 74 20 73 6f 6d  ,.    ** but som
8930: 65 20 73 74 72 61 79 20 27 63 6f 6c 64 27 20 6a  e stray 'cold' j
8940: 6f 75 72 6e 61 6c 73 20 6d 61 79 20 62 65 20 6c  ournals may be l
8950: 79 69 6e 67 20 61 72 6f 75 6e 64 2e 20 52 65 74  ying around. Ret
8960: 75 72 6e 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a  urning an.    **
8970: 20 65 72 72 6f 72 20 63 6f 64 65 20 77 6f 6e 27   error code won'
8980: 74 20 68 65 6c 70 20 6d 61 74 74 65 72 73 2e 0a  t help matters..
8990: 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69      */.    for(i
89a0: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
89b0: 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65  ++){ .      Btre
89c0: 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62  e *pBt = db->aDb
89d0: 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69  [i].pBt;.      i
89e0: 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20  f( pBt ){.      
89f0: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f    sqlite3BtreeCo
8a00: 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20 20  mmit(pBt);.     
8a10: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20   }.    }.  }..  
8a20: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
8a30: 0a 2a 2a 20 46 69 6e 64 20 65 76 65 72 79 20 61  .** Find every a
8a40: 63 74 69 76 65 20 56 4d 20 6f 74 68 65 72 20 74  ctive VM other t
8a50: 68 61 6e 20 70 56 64 62 65 20 61 6e 64 20 63 68  han pVdbe and ch
8a60: 61 6e 67 65 20 69 74 73 20 73 74 61 74 75 73 20  ange its status 
8a70: 74 6f 0a 2a 2a 20 61 62 6f 72 74 65 64 2e 20 20  to.** aborted.  
8a80: 54 68 69 73 20 68 61 70 70 65 6e 73 20 77 68 65  This happens whe
8a90: 6e 20 6f 6e 65 20 56 4d 20 63 61 75 73 65 73 20  n one VM causes 
8aa0: 61 20 72 6f 6c 6c 62 61 63 6b 20 64 75 65 20 74  a rollback due t
8ab0: 6f 20 61 6e 0a 2a 2a 20 4f 4e 20 43 4f 4e 46 4c  o an.** ON CONFL
8ac0: 49 43 54 20 52 4f 4c 4c 42 41 43 4b 20 63 6c 61  ICT ROLLBACK cla
8ad0: 75 73 65 20 28 66 6f 72 20 65 78 61 6d 70 6c 65  use (for example
8ae0: 29 2e 20 20 54 68 65 20 6f 74 68 65 72 20 56 4d  ).  The other VM
8af0: 73 20 6d 75 73 74 20 62 65 0a 2a 2a 20 61 62 6f  s must be.** abo
8b00: 72 74 65 64 20 73 6f 20 74 68 61 74 20 74 68 65  rted so that the
8b10: 79 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 64 61  y do not have da
8b20: 74 61 20 72 6f 6c 6c 65 64 20 6f 75 74 20 66 72  ta rolled out fr
8b30: 6f 6d 20 75 6e 64 65 72 6e 65 61 74 68 0a 2a 2a  om underneath.**
8b40: 20 74 68 65 6d 20 6c 65 61 64 69 6e 67 20 74 6f   them leading to
8b50: 20 61 20 73 65 67 66 61 75 6c 74 2e 0a 2a 2f 0a   a segfault..*/.
8b60: 73 74 61 74 69 63 20 76 6f 69 64 20 61 62 6f 72  static void abor
8b70: 74 4f 74 68 65 72 41 63 74 69 76 65 56 64 62 65  tOtherActiveVdbe
8b80: 73 28 56 64 62 65 20 2a 70 56 64 62 65 29 7b 0a  s(Vdbe *pVdbe){.
8b90: 20 20 56 64 62 65 20 2a 70 4f 74 68 65 72 3b 0a    Vdbe *pOther;.
8ba0: 20 20 66 6f 72 28 70 4f 74 68 65 72 3d 70 56 64    for(pOther=pVd
8bb0: 62 65 2d 3e 64 62 2d 3e 70 56 64 62 65 3b 20 70  be->db->pVdbe; p
8bc0: 4f 74 68 65 72 3b 20 70 4f 74 68 65 72 3d 70 4f  Other; pOther=pO
8bd0: 74 68 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20  ther->pNext){.  
8be0: 20 20 69 66 28 20 70 4f 74 68 65 72 3d 3d 70 56    if( pOther==pV
8bf0: 64 62 65 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a  dbe ) continue;.
8c00: 20 20 20 20 69 66 28 20 70 4f 74 68 65 72 2d 3e      if( pOther->
8c10: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
8c20: 43 5f 52 55 4e 20 7c 7c 20 70 4f 74 68 65 72 2d  C_RUN || pOther-
8c30: 3e 70 63 3c 30 20 29 20 63 6f 6e 74 69 6e 75 65  >pc<0 ) continue
8c40: 3b 0a 20 20 20 20 63 6c 6f 73 65 41 6c 6c 43 75  ;.    closeAllCu
8c50: 72 73 6f 72 73 28 70 4f 74 68 65 72 29 3b 0a 20  rsors(pOther);. 
8c60: 20 20 20 70 4f 74 68 65 72 2d 3e 61 62 6f 72 74     pOther->abort
8c70: 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f  ed = 1;.  }.}../
8c80: 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  * .** This routi
8c90: 6e 65 20 63 68 65 63 6b 73 20 74 68 61 74 20 74  ne checks that t
8ca0: 68 65 20 73 71 6c 69 74 65 33 2e 61 63 74 69 76  he sqlite3.activ
8cb0: 65 56 64 62 65 43 6e 74 20 63 6f 75 6e 74 20 76  eVdbeCnt count v
8cc0: 61 72 69 61 62 6c 65 0a 2a 2a 20 6d 61 74 63 68  ariable.** match
8cd0: 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  es the number of
8ce0: 20 76 64 62 65 27 73 20 69 6e 20 74 68 65 20 6c   vdbe's in the l
8cf0: 69 73 74 20 73 71 6c 69 74 65 33 2e 70 56 64 62  ist sqlite3.pVdb
8d00: 65 20 74 68 61 74 20 61 72 65 0a 2a 2a 20 63 75  e that are.** cu
8d10: 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 2e 20  rrently active. 
8d20: 41 6e 20 61 73 73 65 72 74 69 6f 6e 20 66 61 69  An assertion fai
8d30: 6c 73 20 69 66 20 74 68 65 20 74 77 6f 20 63 6f  ls if the two co
8d40: 75 6e 74 73 20 64 6f 20 6e 6f 74 20 6d 61 74 63  unts do not matc
8d50: 68 2e 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 6e  h..** This is an
8d60: 20 69 6e 74 65 72 6e 61 6c 20 73 65 6c 66 2d 63   internal self-c
8d70: 68 65 63 6b 20 6f 6e 6c 79 20 2d 20 69 74 20 69  heck only - it i
8d80: 73 20 6e 6f 74 20 61 6e 20 65 73 73 65 6e 74 69  s not an essenti
8d90: 61 6c 20 70 72 6f 63 65 73 73 69 6e 67 0a 2a 2a  al processing.**
8da0: 20 73 74 65 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69   step..**.** Thi
8db0: 73 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20  s is a no-op if 
8dc0: 4e 44 45 42 55 47 20 69 73 20 64 65 66 69 6e 65  NDEBUG is define
8dd0: 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44  d..*/.#ifndef ND
8de0: 45 42 55 47 0a 73 74 61 74 69 63 20 76 6f 69 64  EBUG.static void
8df0: 20 63 68 65 63 6b 41 63 74 69 76 65 56 64 62 65   checkActiveVdbe
8e00: 43 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29  Cnt(sqlite3 *db)
8e10: 7b 0a 20 20 56 64 62 65 20 2a 70 3b 0a 20 20 69  {.  Vdbe *p;.  i
8e20: 6e 74 20 63 6e 74 20 3d 20 30 3b 0a 20 20 70 20  nt cnt = 0;.  p 
8e30: 3d 20 64 62 2d 3e 70 56 64 62 65 3b 0a 20 20 77  = db->pVdbe;.  w
8e40: 68 69 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 69  hile( p ){.    i
8e50: 66 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  f( p->magic==VDB
8e60: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 70  E_MAGIC_RUN && p
8e70: 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 20  ->pc>=0 ){.     
8e80: 20 63 6e 74 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20   cnt++;.    }.  
8e90: 20 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a    p = p->pNext;.
8ea0: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 63 6e    }.  assert( cn
8eb0: 74 3d 3d 64 62 2d 3e 61 63 74 69 76 65 56 64 62  t==db->activeVdb
8ec0: 65 43 6e 74 20 29 3b 0a 7d 0a 23 65 6c 73 65 0a  eCnt );.}.#else.
8ed0: 23 64 65 66 69 6e 65 20 63 68 65 63 6b 41 63 74  #define checkAct
8ee0: 69 76 65 56 64 62 65 43 6e 74 28 78 29 0a 23 65  iveVdbeCnt(x).#e
8ef0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  ndif../*.** This
8f00: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c   routine is call
8f10: 65 64 20 74 68 65 20 77 68 65 6e 20 61 20 56 44  ed the when a VD
8f20: 42 45 20 74 72 69 65 73 20 74 6f 20 68 61 6c 74  BE tries to halt
8f30: 2e 20 20 49 66 20 74 68 65 20 56 44 42 45 0a 2a  .  If the VDBE.*
8f40: 2a 20 68 61 73 20 6d 61 64 65 20 63 68 61 6e 67  * has made chang
8f50: 65 73 20 61 6e 64 20 69 73 20 69 6e 20 61 75 74  es and is in aut
8f60: 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 2c 20 74 68  ocommit mode, th
8f70: 65 6e 20 63 6f 6d 6d 69 74 20 74 68 6f 73 65 0a  en commit those.
8f80: 2a 2a 20 63 68 61 6e 67 65 73 2e 20 20 49 66 20  ** changes.  If 
8f90: 61 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6e 65  a rollback is ne
8fa0: 65 64 65 64 2c 20 74 68 65 6e 20 64 6f 20 74 68  eded, then do th
8fb0: 65 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a  e rollback..**.*
8fc0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
8fd0: 73 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74  s the only way t
8fe0: 6f 20 6d 6f 76 65 20 74 68 65 20 73 74 61 74 65  o move the state
8ff0: 20 6f 66 20 61 20 56 4d 20 66 72 6f 6d 0a 2a 2a   of a VM from.**
9000: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 52 55   SQLITE_MAGIC_RU
9010: 4e 20 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49  N to SQLITE_MAGI
9020: 43 5f 48 41 4c 54 2e 0a 2a 2a 0a 2a 2a 20 52 65  C_HALT..**.** Re
9030: 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f  turn an error co
9040: 64 65 2e 20 20 49 66 20 74 68 65 20 63 6f 6d 6d  de.  If the comm
9050: 69 74 20 63 6f 75 6c 64 20 6e 6f 74 20 63 6f 6d  it could not com
9060: 70 6c 65 74 65 20 62 65 63 61 75 73 65 20 6f 66  plete because of
9070: 0a 2a 2a 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74  .** lock content
9080: 69 6f 6e 2c 20 72 65 74 75 72 6e 20 53 51 4c 49  ion, return SQLI
9090: 54 45 5f 42 55 53 59 2e 20 20 49 66 20 53 51 4c  TE_BUSY.  If SQL
90a0: 49 54 45 5f 42 55 53 59 20 69 73 20 72 65 74 75  ITE_BUSY is retu
90b0: 72 6e 65 64 2c 20 69 74 0a 2a 2a 20 6d 65 61 6e  rned, it.** mean
90c0: 73 20 74 68 65 20 63 6c 6f 73 65 20 64 69 64 20  s the close did 
90d0: 6e 6f 74 20 68 61 70 70 65 6e 20 61 6e 64 20 6e  not happen and n
90e0: 65 65 64 73 20 74 6f 20 62 65 20 72 65 70 65 61  eeds to be repea
90f0: 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ted..*/.int sqli
9100: 74 65 33 56 64 62 65 48 61 6c 74 28 56 64 62 65  te3VdbeHalt(Vdbe
9110: 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 65 33 20   *p){.  sqlite3 
9120: 2a 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69  *db = p->db;.  i
9130: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 28 2a 78 46  nt i;.  int (*xF
9140: 75 6e 63 29 28 42 74 72 65 65 20 2a 70 42 74 29  unc)(Btree *pBt)
9150: 20 3d 20 30 3b 20 20 2f 2a 20 46 75 6e 63 74 69   = 0;  /* Functi
9160: 6f 6e 20 74 6f 20 63 61 6c 6c 20 6f 6e 20 65 61  on to call on ea
9170: 63 68 20 62 74 72 65 65 20 62 61 63 6b 65 6e 64  ch btree backend
9180: 20 2a 2f 0a 0a 20 20 69 66 28 20 70 2d 3e 6d 61   */..  if( p->ma
9190: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
91a0: 52 55 4e 20 29 7b 0a 20 20 20 20 2f 2a 20 41 6c  RUN ){.    /* Al
91b0: 72 65 61 64 79 20 68 61 6c 74 65 64 2e 20 20 4e  ready halted.  N
91c0: 6f 74 68 69 6e 67 20 74 6f 20 64 6f 2e 20 2a 2f  othing to do. */
91d0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
91e0: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
91f0: 43 5f 48 41 4c 54 20 29 3b 0a 20 20 20 20 72 65  C_HALT );.    re
9200: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
9210: 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75    }.  closeAllCu
9220: 72 73 6f 72 73 28 70 29 3b 0a 20 20 63 68 65 63  rsors(p);.  chec
9230: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64  kActiveVdbeCnt(d
9240: 62 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70 63 3c  b);.  if( p->pc<
9250: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4e 6f 20 63  0 ){.    /* No c
9260: 6f 6d 6d 69 74 20 6f 72 20 72 6f 6c 6c 62 61 63  ommit or rollbac
9270: 6b 20 6e 65 65 64 65 64 20 69 66 20 74 68 65 20  k needed if the 
9280: 70 72 6f 67 72 61 6d 20 6e 65 76 65 72 20 73 74  program never st
9290: 61 72 74 65 64 20 2a 2f 0a 20 20 7d 65 6c 73 65  arted */.  }else
92a0: 20 69 66 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d   if( db->autoCom
92b0: 6d 69 74 20 26 26 20 64 62 2d 3e 61 63 74 69 76  mit && db->activ
92c0: 65 56 64 62 65 43 6e 74 3d 3d 31 20 29 7b 0a 20  eVdbeCnt==1 ){. 
92d0: 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51     if( p->rc==SQ
92e0: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 65 72  LITE_OK || p->er
92f0: 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61  rorAction==OE_Fa
9300: 69 6c 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54  il ){.      /* T
9310: 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66  he auto-commit f
9320: 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68 65  lag is true, the
9330: 72 65 20 61 72 65 20 6e 6f 20 6f 74 68 65 72 20  re are no other 
9340: 61 63 74 69 76 65 20 71 75 65 72 69 65 73 0a 20  active queries. 
9350: 20 20 20 20 20 2a 2a 20 75 73 69 6e 67 20 74 68       ** using th
9360: 69 73 20 68 61 6e 64 6c 65 20 61 6e 64 20 74 68  is handle and th
9370: 65 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20 77  e vdbe program w
9380: 61 73 20 73 75 63 63 65 73 73 66 75 6c 20 6f 72  as successful or
9390: 20 68 69 74 20 61 6e 0a 20 20 20 20 20 20 2a 2a   hit an.      **
93a0: 20 27 4f 52 20 46 41 49 4c 27 20 63 6f 6e 73 74   'OR FAIL' const
93b0: 72 61 69 6e 74 2e 20 54 68 69 73 20 6d 65 61 6e  raint. This mean
93c0: 73 20 61 20 63 6f 6d 6d 69 74 20 69 73 20 72 65  s a commit is re
93d0: 71 75 69 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f  quired..      */
93e0: 0a 20 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20  .      int rc = 
93f0: 76 64 62 65 43 6f 6d 6d 69 74 28 64 62 29 3b 0a  vdbeCommit(db);.
9400: 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51        if( rc==SQ
9410: 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20  LITE_BUSY ){.   
9420: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49       return SQLI
9430: 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 7d  TE_BUSY;.      }
9440: 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c  else if( rc!=SQL
9450: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
9460: 20 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20    p->rc = rc;.  
9470: 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71        xFunc = sq
9480: 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61  lite3BtreeRollba
9490: 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ck;.      }.    
94a0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 78 46 75  }else{.      xFu
94b0: 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  nc = sqlite3Btre
94c0: 65 52 6f 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 7d  eRollback;.    }
94d0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66  .  }else{.    if
94e0: 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f  ( p->rc==SQLITE_
94f0: 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72 6f 72 41 63  OK || p->errorAc
9500: 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20 29 7b  tion==OE_Fail ){
9510: 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73  .      xFunc = s
9520: 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69  qlite3BtreeCommi
9530: 74 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c 73 65  tStmt;.    }else
9540: 20 69 66 28 20 70 2d 3e 65 72 72 6f 72 41 63 74   if( p->errorAct
9550: 69 6f 6e 3d 3d 4f 45 5f 41 62 6f 72 74 20 29 7b  ion==OE_Abort ){
9560: 0a 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73  .      xFunc = s
9570: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62  qlite3BtreeRollb
9580: 61 63 6b 53 74 6d 74 3b 0a 20 20 20 20 7d 65 6c  ackStmt;.    }el
9590: 73 65 7b 0a 20 20 20 20 20 20 78 46 75 6e 63 20  se{.      xFunc 
95a0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f  = sqlite3BtreeRo
95b0: 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 20 20 64 62  llback;.      db
95c0: 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31  ->autoCommit = 1
95d0: 3b 0a 20 20 20 20 20 20 61 62 6f 72 74 4f 74 68  ;.      abortOth
95e0: 65 72 41 63 74 69 76 65 56 64 62 65 73 28 70 29  erActiveVdbes(p)
95f0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
9600: 2a 20 49 66 20 78 46 75 6e 63 20 69 73 20 6e 6f  * If xFunc is no
9610: 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 74 20  t NULL, then it 
9620: 69 73 20 6f 6e 65 20 6f 66 20 73 71 6c 69 74 65  is one of sqlite
9630: 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 2c 0a  3BtreeRollback,.
9640: 20 20 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65    ** sqlite3Btre
9650: 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 20 6f 72  eRollbackStmt or
9660: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
9670: 6d 69 74 53 74 6d 74 2e 20 43 61 6c 6c 20 69 74  mitStmt. Call it
9680: 20 6f 6e 63 65 20 6f 6e 0a 20 20 2a 2a 20 65 61   once on.  ** ea
9690: 63 68 20 62 61 63 6b 65 6e 64 2e 20 49 66 20 61  ch backend. If a
96a0: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61  n error occurs a
96b0: 6e 64 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f  nd the return co
96c0: 64 65 20 69 73 20 73 74 69 6c 6c 0a 20 20 2a 2a  de is still.  **
96d0: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 73 65 74 20   SQLITE_OK, set 
96e0: 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20  the return code 
96f0: 74 6f 20 74 68 65 20 6e 65 77 20 65 72 72 6f 72  to the new error
9700: 20 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 66   value..  */.  f
9710: 6f 72 28 69 3d 30 3b 20 78 46 75 6e 63 20 26 26  or(i=0; xFunc &&
9720: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
9730: 7b 20 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20  { .    int rc;. 
9740: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
9750: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
9760: 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20      if( pBt ){. 
9770: 20 20 20 20 20 72 63 20 3d 20 78 46 75 6e 63 28       rc = xFunc(
9780: 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20  pBt);.      if( 
9790: 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  p->rc==SQLITE_OK
97a0: 20 29 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20   ) p->rc = rc;. 
97b0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49     }.  }..  /* I
97c0: 66 20 74 68 69 73 20 77 61 73 20 61 6e 20 49 4e  f this was an IN
97d0: 53 45 52 54 2c 20 55 50 44 41 54 45 20 6f 72 20  SERT, UPDATE or 
97e0: 44 45 4c 45 54 45 2c 20 73 65 74 20 74 68 65 20  DELETE, set the 
97f0: 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20  change counter. 
9800: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 63 68 61 6e  */.  if( p->chan
9810: 67 65 43 6e 74 4f 6e 20 26 26 20 70 2d 3e 70 63  geCntOn && p->pc
9820: 3e 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 21  >=0 ){.    if( !
9830: 78 46 75 6e 63 20 7c 7c 20 78 46 75 6e 63 3d 3d  xFunc || xFunc==
9840: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
9850: 69 74 53 74 6d 74 20 29 7b 0a 20 20 20 20 20 20  itStmt ){.      
9860: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 68  sqlite3VdbeSetCh
9870: 61 6e 67 65 73 28 64 62 2c 20 70 2d 3e 6e 43 68  anges(db, p->nCh
9880: 61 6e 67 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65  ange);.    }else
9890: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  {.      sqlite3V
98a0: 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 64 62  dbeSetChanges(db
98b0: 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  , 0);.    }.    
98c0: 70 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a  p->nChange = 0;.
98d0: 20 20 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61    }..  /* Rollba
98e0: 63 6b 20 6f 72 20 63 6f 6d 6d 69 74 20 61 6e 79  ck or commit any
98f0: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 20   schema changes 
9900: 74 68 61 74 20 6f 63 63 75 72 72 65 64 2e 20 2a  that occurred. *
9910: 2f 0a 20 20 69 66 28 20 70 2d 3e 72 63 21 3d 53  /.  if( p->rc!=S
9920: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
9930: 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 49  sqlite3RollbackI
9940: 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64  nternalChanges(d
9950: 62 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  b);.  }else if( 
9960: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
9970: 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73  TE_InternChanges
9980: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43   ){.    sqlite3C
9990: 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61  ommitInternalCha
99a0: 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20  nges(db);.  }.. 
99b0: 20 2f 2a 20 57 65 20 68 61 76 65 20 73 75 63 63   /* We have succ
99c0: 65 73 73 66 75 6c 6c 79 20 68 61 6c 74 65 64 20  essfully halted 
99d0: 61 6e 64 20 63 6c 6f 73 65 64 20 74 68 65 20 56  and closed the V
99e0: 4d 2e 20 20 52 65 63 6f 72 64 20 74 68 69 73 20  M.  Record this 
99f0: 66 61 63 74 2e 20 2a 2f 0a 20 20 69 66 28 20 70  fact. */.  if( p
9a00: 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 64  ->pc>=0 ){.    d
9a10: 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74  b->activeVdbeCnt
9a20: 2d 2d 3b 0a 20 20 7d 0a 20 20 70 2d 3e 6d 61 67  --;.  }.  p->mag
9a30: 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f  ic = VDBE_MAGIC_
9a40: 48 41 4c 54 3b 0a 20 20 63 68 65 63 6b 41 63 74  HALT;.  checkAct
9a50: 69 76 65 56 64 62 65 43 6e 74 28 64 62 29 3b 0a  iveVdbeCnt(db);.
9a60: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
9a70: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c  _OK;.}../*.** Cl
9a80: 65 61 6e 20 75 70 20 61 20 56 44 42 45 20 61 66  ean up a VDBE af
9a90: 74 65 72 20 65 78 65 63 75 74 69 6f 6e 20 62 75  ter execution bu
9aa0: 74 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20  t do not delete 
9ab0: 74 68 65 20 56 44 42 45 20 6a 75 73 74 20 79 65  the VDBE just ye
9ac0: 74 2e 0a 2a 2a 20 57 72 69 74 65 20 61 6e 79 20  t..** Write any 
9ad0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 69  error messages i
9ae0: 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 20 20  nto *pzErrMsg.  
9af0: 52 65 74 75 72 6e 20 74 68 65 20 72 65 73 75 6c  Return the resul
9b00: 74 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 66  t code..**.** Af
9b10: 74 65 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65  ter this routine
9b20: 20 69 73 20 72 75 6e 2c 20 74 68 65 20 56 44 42   is run, the VDB
9b30: 45 20 73 68 6f 75 6c 64 20 62 65 20 72 65 61 64  E should be read
9b40: 79 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64  y to be executed
9b50: 0a 2a 2a 20 61 67 61 69 6e 2e 0a 2a 2a 0a 2a 2a  .** again..**.**
9b60: 20 54 6f 20 6c 6f 6f 6b 20 61 74 20 69 74 20 61   To look at it a
9b70: 6e 6f 74 68 65 72 20 77 61 79 2c 20 74 68 69 73  nother way, this
9b80: 20 72 6f 75 74 69 6e 65 20 72 65 73 65 74 73 20   routine resets 
9b90: 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65  the state of the
9ba0: 0a 2a 2a 20 76 69 72 74 75 61 6c 20 6d 61 63 68  .** virtual mach
9bb0: 69 6e 65 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41  ine from VDBE_MA
9bc0: 47 49 43 5f 52 55 4e 20 6f 72 20 56 44 42 45 5f  GIC_RUN or VDBE_
9bd0: 4d 41 47 49 43 5f 48 41 4c 54 20 62 61 63 6b 20  MAGIC_HALT back 
9be0: 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43  to.** VDBE_MAGIC
9bf0: 5f 49 4e 49 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71  _INIT..*/.int sq
9c00: 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28 56  lite3VdbeReset(V
9c10: 64 62 65 20 2a 70 29 7b 0a 20 20 69 66 28 20 70  dbe *p){.  if( p
9c20: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
9c30: 47 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 6d 61  GIC_RUN && p->ma
9c40: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
9c50: 48 41 4c 54 20 29 7b 0a 20 20 20 20 73 71 6c 69  HALT ){.    sqli
9c60: 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20  te3Error(p->db, 
9c70: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 30  SQLITE_MISUSE, 0
9c80: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
9c90: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d  LITE_MISUSE;.  }
9ca0: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 56 4d  ..  /* If the VM
9cb0: 20 64 69 64 20 6e 6f 74 20 72 75 6e 20 74 6f 20   did not run to 
9cc0: 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 72 20 69 66  completion or if
9cd0: 20 69 74 20 65 6e 63 6f 75 6e 74 65 72 65 64 20   it encountered 
9ce0: 61 6e 0a 20 20 2a 2a 20 65 72 72 6f 72 2c 20 74  an.  ** error, t
9cf0: 68 65 6e 20 69 74 20 6d 69 67 68 74 20 6e 6f 74  hen it might not
9d00: 20 68 61 76 65 20 62 65 65 6e 20 68 61 6c 74 65   have been halte
9d10: 64 20 70 72 6f 70 65 72 6c 79 2e 20 20 53 6f 20  d properly.  So 
9d20: 68 61 6c 74 0a 20 20 2a 2a 20 69 74 20 6e 6f 77  halt.  ** it now
9d30: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ..  */.  sqlite3
9d40: 56 64 62 65 48 61 6c 74 28 70 29 3b 0a 0a 20 20  VdbeHalt(p);..  
9d50: 2f 2a 20 49 66 20 74 68 65 20 56 44 42 45 20 68  /* If the VDBE h
9d60: 61 73 20 62 65 20 72 75 6e 20 65 76 65 6e 20 70  as be run even p
9d70: 61 72 74 69 61 6c 6c 79 2c 20 74 68 65 6e 20 74  artially, then t
9d80: 72 61 6e 73 66 65 72 20 74 68 65 20 65 72 72 6f  ransfer the erro
9d90: 72 20 63 6f 64 65 0a 20 20 2a 2a 20 61 6e 64 20  r code.  ** and 
9da0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 72  error message fr
9db0: 6f 6d 20 74 68 65 20 56 44 42 45 20 69 6e 74 6f  om the VDBE into
9dc0: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61   the main databa
9dd0: 73 65 20 73 74 72 75 63 74 75 72 65 2e 20 20 42  se structure.  B
9de0: 75 74 0a 20 20 2a 2a 20 69 66 20 74 68 65 20 56  ut.  ** if the V
9df0: 44 42 45 20 68 61 73 20 6a 75 73 74 20 62 65 65  DBE has just bee
9e00: 6e 20 73 65 74 20 74 6f 20 72 75 6e 20 62 75 74  n set to run but
9e10: 20 68 61 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c   has not actuall
9e20: 79 20 65 78 65 63 75 74 65 64 20 61 6e 79 0a 20  y executed any. 
9e30: 20 2a 2a 20 69 6e 73 74 72 75 63 74 69 6f 6e 73   ** instructions
9e40: 20 79 65 74 2c 20 6c 65 61 76 65 20 74 68 65 20   yet, leave the 
9e50: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 65 72  main database er
9e60: 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ror information 
9e70: 75 6e 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2f 0a  unchanged..  */.
9e80: 20 20 69 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29    if( p->pc>=0 )
9e90: 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 7a 45 72  {.    if( p->zEr
9ea0: 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 73 71  rMsg ){.      sq
9eb0: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62  lite3Error(p->db
9ec0: 2c 20 70 2d 3e 72 63 2c 20 22 25 73 22 2c 20 70  , p->rc, "%s", p
9ed0: 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  ->zErrMsg);.    
9ee0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
9ef0: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20  zErrMsg);.      
9f00: 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a  p->zErrMsg = 0;.
9f10: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d      }else if( p-
9f20: 3e 72 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  >rc ){.      sql
9f30: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c  ite3Error(p->db,
9f40: 20 70 2d 3e 72 63 2c 20 30 29 3b 0a 20 20 20 20   p->rc, 0);.    
9f50: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
9f60: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c  ite3Error(p->db,
9f70: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a   SQLITE_OK, 0);.
9f80: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66      }.  }else if
9f90: 28 20 70 2d 3e 72 63 20 26 26 20 70 2d 3e 65 78  ( p->rc && p->ex
9fa0: 70 69 72 65 64 20 29 7b 0a 20 20 20 20 2f 2a 20  pired ){.    /* 
9fb0: 54 68 65 20 65 78 70 69 72 65 64 20 66 6c 61 67  The expired flag
9fc0: 20 77 61 73 20 73 65 74 20 6f 6e 20 74 68 65 20   was set on the 
9fd0: 56 44 42 45 20 62 65 66 6f 72 65 20 74 68 65 20  VDBE before the 
9fe0: 66 69 72 73 74 20 63 61 6c 6c 0a 20 20 20 20 2a  first call.    *
9ff0: 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f 73 74 65  * to sqlite3_ste
a000: 70 28 29 2e 20 46 6f 72 20 63 6f 6e 73 69 73 74  p(). For consist
a010: 65 6e 63 79 20 28 73 69 6e 63 65 20 73 71 6c 69  ency (since sqli
a020: 74 65 33 5f 73 74 65 70 28 29 20 77 61 73 0a 20  te3_step() was. 
a030: 20 20 20 2a 2a 20 63 61 6c 6c 65 64 29 2c 20 73     ** called), s
a040: 65 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20  et the database 
a050: 65 72 72 6f 72 20 69 6e 20 74 68 69 73 20 63 61  error in this ca
a060: 73 65 20 61 73 20 77 65 6c 6c 2e 0a 20 20 20 20  se as well..    
a070: 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72  */.    sqlite3Er
a080: 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63  ror(p->db, p->rc
a090: 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  , 0);.  }..  /* 
a0a0: 52 65 63 6c 61 69 6d 20 61 6c 6c 20 6d 65 6d 6f  Reclaim all memo
a0b0: 72 79 20 75 73 65 64 20 62 79 20 74 68 65 20 56  ry used by the V
a0c0: 44 42 45 0a 20 20 2a 2f 0a 20 20 43 6c 65 61 6e  DBE.  */.  Clean
a0d0: 75 70 28 70 29 3b 0a 0a 20 20 2f 2a 20 53 61 76  up(p);..  /* Sav
a0e0: 65 20 70 72 6f 66 69 6c 69 6e 67 20 69 6e 66 6f  e profiling info
a0f0: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 69  rmation from thi
a100: 73 20 56 44 42 45 20 72 75 6e 2e 0a 20 20 2a 2f  s VDBE run..  */
a110: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 54  .  assert( p->pT
a120: 6f 73 3c 26 70 2d 3e 61 53 74 61 63 6b 5b 70 2d  os<&p->aStack[p-
a130: 3e 70 63 3c 30 3f 30 3a 70 2d 3e 70 63 5d 20 7c  >pc<0?0:p->pc] |
a140: 7c 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  | sqlite3_malloc
a150: 5f 66 61 69 6c 65 64 3d 3d 31 20 29 3b 0a 23 69  _failed==1 );.#i
a160: 66 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c  fdef VDBE_PROFIL
a170: 45 0a 20 20 7b 0a 20 20 20 20 46 49 4c 45 20 2a  E.  {.    FILE *
a180: 6f 75 74 20 3d 20 66 6f 70 65 6e 28 22 76 64 62  out = fopen("vdb
a190: 65 5f 70 72 6f 66 69 6c 65 2e 6f 75 74 22 2c 20  e_profile.out", 
a1a0: 22 61 22 29 3b 0a 20 20 20 20 69 66 28 20 6f 75  "a");.    if( ou
a1b0: 74 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69  t ){.      int i
a1c0: 3b 0a 20 20 20 20 20 20 66 70 72 69 6e 74 66 28  ;.      fprintf(
a1d0: 6f 75 74 2c 20 22 2d 2d 2d 2d 20 22 29 3b 0a 20  out, "---- ");. 
a1e0: 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c       for(i=0; i<
a1f0: 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20  p->nOp; i++){.  
a200: 20 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75        fprintf(ou
a210: 74 2c 20 22 25 30 32 78 22 2c 20 70 2d 3e 61 4f  t, "%02x", p->aO
a220: 70 5b 69 5d 2e 6f 70 63 6f 64 65 29 3b 0a 20 20  p[i].opcode);.  
a230: 20 20 20 20 7d 0a 20 20 20 20 20 20 66 70 72 69      }.      fpri
a240: 6e 74 66 28 6f 75 74 2c 20 22 5c 6e 22 29 3b 0a  ntf(out, "\n");.
a250: 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69        for(i=0; i
a260: 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20  <p->nOp; i++){. 
a270: 20 20 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f         fprintf(o
a280: 75 74 2c 20 22 25 36 64 20 25 31 30 6c 6c 64 20  ut, "%6d %10lld 
a290: 25 38 6c 6c 64 20 22 2c 0a 20 20 20 20 20 20 20  %8lld ",.       
a2a0: 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e      p->aOp[i].cn
a2b0: 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 2d  t,.           p-
a2c0: 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 2c 0a  >aOp[i].cycles,.
a2d0: 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f             p->aO
a2e0: 70 5b 69 5d 2e 63 6e 74 3e 30 20 3f 20 70 2d 3e  p[i].cnt>0 ? p->
a2f0: 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 2f 70 2d  aOp[i].cycles/p-
a300: 3e 61 4f 70 5b 69 5d 2e 63 6e 74 20 3a 20 30 0a  >aOp[i].cnt : 0.
a310: 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20          );.     
a320: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 50 72     sqlite3VdbePr
a330: 69 6e 74 4f 70 28 6f 75 74 2c 20 69 2c 20 26 70  intOp(out, i, &p
a340: 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20 20 20 20 20  ->aOp[i]);.     
a350: 20 7d 0a 20 20 20 20 20 20 66 63 6c 6f 73 65 28   }.      fclose(
a360: 6f 75 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  out);.    }.  }.
a370: 23 65 6e 64 69 66 0a 20 20 70 2d 3e 6d 61 67 69  #endif.  p->magi
a380: 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  c = VDBE_MAGIC_I
a390: 4e 49 54 3b 0a 20 20 70 2d 3e 61 62 6f 72 74 65  NIT;.  p->aborte
a3a0: 64 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 2d 3e  d = 0;.  if( p->
a3b0: 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d  rc==SQLITE_SCHEM
a3c0: 41 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  A ){.    sqlite3
a3d0: 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68  ResetInternalSch
a3e0: 65 6d 61 28 70 2d 3e 64 62 2c 20 30 29 3b 0a 20  ema(p->db, 0);. 
a3f0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 72   }.  return p->r
a400: 63 3b 0a 7d 0a 20 0a 2f 2a 0a 2a 2a 20 43 6c 65  c;.}. ./*.** Cle
a410: 61 6e 20 75 70 20 61 6e 64 20 64 65 6c 65 74 65  an up and delete
a420: 20 61 20 56 44 42 45 20 61 66 74 65 72 20 65 78   a VDBE after ex
a430: 65 63 75 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e  ecution.  Return
a440: 20 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63   an integer whic
a450: 68 20 69 73 0a 2a 2a 20 74 68 65 20 72 65 73 75  h is.** the resu
a460: 6c 74 20 63 6f 64 65 2e 20 20 57 72 69 74 65 20  lt code.  Write 
a470: 61 6e 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67  any error messag
a480: 65 20 74 65 78 74 20 69 6e 74 6f 20 2a 70 7a 45  e text into *pzE
a490: 72 72 4d 73 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71  rrMsg..*/.int sq
a4a0: 6c 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a  lite3VdbeFinaliz
a4b0: 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  e(Vdbe *p){.  in
a4c0: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
a4d0: 3b 0a 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69  ;..  if( p->magi
a4e0: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c==VDBE_MAGIC_RU
a4f0: 4e 20 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  N || p->magic==V
a500: 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29  DBE_MAGIC_HALT )
a510: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
a520: 65 33 56 64 62 65 52 65 73 65 74 28 70 29 3b 0a  e3VdbeReset(p);.
a530: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6d    }else if( p->m
a540: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43  agic!=VDBE_MAGIC
a550: 5f 49 4e 49 54 20 29 7b 0a 20 20 20 20 72 65 74  _INIT ){.    ret
a560: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
a570: 45 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  E;.  }.  sqlite3
a580: 56 64 62 65 44 65 6c 65 74 65 28 70 29 3b 0a 20  VdbeDelete(p);. 
a590: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
a5a0: 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 65 20 64 65  *.** Call the de
a5b0: 73 74 72 75 63 74 6f 72 20 66 6f 72 20 65 61 63  structor for eac
a5c0: 68 20 61 75 78 64 61 74 61 20 65 6e 74 72 79 20  h auxdata entry 
a5d0: 69 6e 20 70 56 64 62 65 46 75 6e 63 20 66 6f 72  in pVdbeFunc for
a5e0: 20 77 68 69 63 68 0a 2a 2a 20 74 68 65 20 63 6f   which.** the co
a5f0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20  rresponding bit 
a600: 69 6e 20 6d 61 73 6b 20 69 73 20 63 6c 65 61 72  in mask is clear
a610: 2e 20 20 41 75 78 64 61 74 61 20 65 6e 74 72 69  .  Auxdata entri
a620: 65 73 20 62 65 79 6f 6e 64 20 33 31 0a 2a 2a 20  es beyond 31.** 
a630: 61 72 65 20 61 6c 77 61 79 73 20 64 65 73 74 72  are always destr
a640: 6f 79 65 64 2e 20 20 54 6f 20 64 65 73 74 72 6f  oyed.  To destro
a650: 79 20 61 6c 6c 20 61 75 78 64 61 74 61 20 65 6e  y all auxdata en
a660: 74 72 69 65 73 2c 20 63 61 6c 6c 20 74 68 69 73  tries, call this
a670: 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 77 69 74 68  .** routine with
a680: 20 6d 61 73 6b 3d 3d 30 2e 0a 2a 2f 0a 76 6f 69   mask==0..*/.voi
a690: 64 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c  d sqlite3VdbeDel
a6a0: 65 74 65 41 75 78 44 61 74 61 28 56 64 62 65 46  eteAuxData(VdbeF
a6b0: 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 2c 20  unc *pVdbeFunc, 
a6c0: 69 6e 74 20 6d 61 73 6b 29 7b 0a 20 20 69 6e 74  int mask){.  int
a6d0: 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69   i;.  for(i=0; i
a6e0: 3c 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78  <pVdbeFunc->nAux
a6f0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75  ; i++){.    stru
a700: 63 74 20 41 75 78 44 61 74 61 20 2a 70 41 75 78  ct AuxData *pAux
a710: 20 3d 20 26 70 56 64 62 65 46 75 6e 63 2d 3e 61   = &pVdbeFunc->a
a720: 70 41 75 78 5b 69 5d 3b 0a 20 20 20 20 69 66 28  pAux[i];.    if(
a730: 20 28 69 3e 33 31 20 7c 7c 20 21 28 6d 61 73 6b   (i>31 || !(mask
a740: 26 28 31 3c 3c 69 29 29 29 20 26 26 20 70 41 75  &(1<<i))) && pAu
a750: 78 2d 3e 70 41 75 78 20 29 7b 0a 20 20 20 20 20  x->pAux ){.     
a760: 20 69 66 28 20 70 41 75 78 2d 3e 78 44 65 6c 65   if( pAux->xDele
a770: 74 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70 41  te ){.        pA
a780: 75 78 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78  ux->xDelete(pAux
a790: 2d 3e 70 41 75 78 29 3b 0a 20 20 20 20 20 20 7d  ->pAux);.      }
a7a0: 0a 20 20 20 20 20 20 70 41 75 78 2d 3e 70 41 75  .      pAux->pAu
a7b0: 78 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d  x = 0;.    }.  }
a7c0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65  .}../*.** Delete
a7d0: 20 61 6e 20 65 6e 74 69 72 65 20 56 44 42 45 2e   an entire VDBE.
a7e0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
a7f0: 56 64 62 65 44 65 6c 65 74 65 28 56 64 62 65 20  VdbeDelete(Vdbe 
a800: 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  *p){.  int i;.  
a810: 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72  if( p==0 ) retur
a820: 6e 3b 0a 20 20 43 6c 65 61 6e 75 70 28 70 29 3b  n;.  Cleanup(p);
a830: 0a 20 20 69 66 28 20 70 2d 3e 70 50 72 65 76 20  .  if( p->pPrev 
a840: 29 7b 0a 20 20 20 20 70 2d 3e 70 50 72 65 76 2d  ){.    p->pPrev-
a850: 3e 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78  >pNext = p->pNex
a860: 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  t;.  }else{.    
a870: 61 73 73 65 72 74 28 20 70 2d 3e 64 62 2d 3e 70  assert( p->db->p
a880: 56 64 62 65 3d 3d 70 20 29 3b 0a 20 20 20 20 70  Vdbe==p );.    p
a890: 2d 3e 64 62 2d 3e 70 56 64 62 65 20 3d 20 70 2d  ->db->pVdbe = p-
a8a0: 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66  >pNext;.  }.  if
a8b0: 28 20 70 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20  ( p->pNext ){.  
a8c0: 20 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65    p->pNext->pPre
a8d0: 76 20 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 20 20  v = p->pPrev;.  
a8e0: 7d 0a 20 20 69 66 28 20 70 2d 3e 61 4f 70 20 29  }.  if( p->aOp )
a8f0: 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  {.    for(i=0; i
a900: 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20  <p->nOp; i++){. 
a910: 20 20 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26       Op *pOp = &
a920: 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 20  p->aOp[i];.     
a930: 20 69 66 28 20 70 4f 70 2d 3e 70 33 74 79 70 65   if( pOp->p3type
a940: 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20  ==P3_DYNAMIC || 
a950: 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33 5f  pOp->p3type==P3_
a960: 4b 45 59 49 4e 46 4f 20 29 7b 0a 20 20 20 20 20  KEYINFO ){.     
a970: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 4f     sqliteFree(pO
a980: 70 2d 3e 70 33 29 3b 0a 20 20 20 20 20 20 7d 0a  p->p3);.      }.
a990: 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70        if( pOp->p
a9a0: 33 74 79 70 65 3d 3d 50 33 5f 56 44 42 45 46 55  3type==P3_VDBEFU
a9b0: 4e 43 20 29 7b 0a 20 20 20 20 20 20 20 20 56 64  NC ){.        Vd
a9c0: 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e  beFunc *pVdbeFun
a9d0: 63 20 3d 20 28 56 64 62 65 46 75 6e 63 20 2a 29  c = (VdbeFunc *)
a9e0: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 20  pOp->p3;.       
a9f0: 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65   sqlite3VdbeDele
aa00: 74 65 41 75 78 44 61 74 61 28 70 56 64 62 65 46  teAuxData(pVdbeF
aa10: 75 6e 63 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  unc, 0);.       
aa20: 20 73 71 6c 69 74 65 46 72 65 65 28 70 56 64 62   sqliteFree(pVdb
aa30: 65 46 75 6e 63 29 3b 0a 20 20 20 20 20 20 7d 0a  eFunc);.      }.
aa40: 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70        if( pOp->p
aa50: 33 74 79 70 65 3d 3d 50 33 5f 4d 45 4d 20 29 7b  3type==P3_MEM ){
aa60: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
aa70: 56 61 6c 75 65 46 72 65 65 28 28 73 71 6c 69 74  ValueFree((sqlit
aa80: 65 33 5f 76 61 6c 75 65 2a 29 70 4f 70 2d 3e 70  e3_value*)pOp->p
aa90: 33 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  3);.      }.    
aaa0: 7d 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65  }.    sqliteFree
aab0: 28 70 2d 3e 61 4f 70 29 3b 0a 20 20 7d 0a 20 20  (p->aOp);.  }.  
aac0: 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28  releaseMemArray(
aad0: 70 2d 3e 61 56 61 72 2c 20 70 2d 3e 6e 56 61 72  p->aVar, p->nVar
aae0: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
aaf0: 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20 20 73 71  p->aLabel);.  sq
ab00: 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 53 74 61  liteFree(p->aSta
ab10: 63 6b 29 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65  ck);.  releaseMe
ab20: 6d 41 72 72 61 79 28 70 2d 3e 61 43 6f 6c 4e 61  mArray(p->aColNa
ab30: 6d 65 2c 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d  me, p->nResColum
ab40: 6e 2a 32 29 3b 0a 20 20 73 71 6c 69 74 65 46 72  n*2);.  sqliteFr
ab50: 65 65 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 29 3b  ee(p->aColName);
ab60: 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44  .  p->magic = VD
ab70: 42 45 5f 4d 41 47 49 43 5f 44 45 41 44 3b 0a 20  BE_MAGIC_DEAD;. 
ab80: 20 73 71 6c 69 74 65 46 72 65 65 28 70 29 3b 0a   sqliteFree(p);.
ab90: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 61 20 4d 6f  }../*.** If a Mo
aba0: 76 65 54 6f 20 6f 70 65 72 61 74 69 6f 6e 20 69  veTo operation i
abb0: 73 20 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65  s pending on the
abc0: 20 67 69 76 65 6e 20 63 75 72 73 6f 72 2c 20 74   given cursor, t
abd0: 68 65 6e 20 64 6f 20 74 68 61 74 0a 2a 2a 20 4d  hen do that.** M
abe0: 6f 76 65 54 6f 20 6e 6f 77 2e 20 20 52 65 74 75  oveTo now.  Retu
abf0: 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65  rn an error code
ac00: 2e 20 20 49 66 20 6e 6f 20 4d 6f 76 65 54 6f 20  .  If no MoveTo 
ac10: 69 73 20 70 65 6e 64 69 6e 67 2c 20 74 68 69 73  is pending, this
ac20: 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 64 6f 65 73  .** routine does
ac30: 20 6e 6f 74 68 69 6e 67 20 61 6e 64 20 72 65 74   nothing and ret
ac40: 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a  urns SQLITE_OK..
ac50: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
ac60: 62 65 43 75 72 73 6f 72 4d 6f 76 65 74 6f 28 43  beCursorMoveto(C
ac70: 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 69 66 28  ursor *p){.  if(
ac80: 20 70 2d 3e 64 65 66 65 72 72 65 64 4d 6f 76 65   p->deferredMove
ac90: 74 6f 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 65  to ){.    int re
aca0: 73 2c 20 72 63 3b 0a 20 20 20 20 65 78 74 65 72  s, rc;.    exter
acb0: 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 65  n int sqlite3_se
acc0: 61 72 63 68 5f 63 6f 75 6e 74 3b 0a 20 20 20 20  arch_count;.    
acd0: 61 73 73 65 72 74 28 20 70 2d 3e 69 6e 74 4b 65  assert( p->intKe
ace0: 79 20 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e  y );.    if( p->
acf0: 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20  intKey ){.      
ad00: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
ad10: 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73  eMoveto(p->pCurs
ad20: 6f 72 2c 20 30 2c 20 70 2d 3e 6d 6f 76 65 74 6f  or, 0, p->moveto
ad30: 54 61 72 67 65 74 2c 20 26 72 65 73 29 3b 0a 20  Target, &res);. 
ad40: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
ad50: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
ad60: 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73  eMoveto(p->pCurs
ad70: 6f 72 2c 28 63 68 61 72 2a 29 26 70 2d 3e 6d 6f  or,(char*)&p->mo
ad80: 76 65 74 6f 54 61 72 67 65 74 2c 0a 20 20 20 20  vetoTarget,.    
ad90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ada0: 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66            sizeof
adb0: 28 69 36 34 29 2c 26 72 65 73 29 3b 0a 20 20 20  (i64),&res);.   
adc0: 20 7d 0a 20 20 20 20 69 66 28 20 72 63 20 29 20   }.    if( rc ) 
add0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 2a  return rc;.    *
ade0: 70 2d 3e 70 49 6e 63 72 4b 65 79 20 3d 20 30 3b  p->pIncrKey = 0;
adf0: 0a 20 20 20 20 70 2d 3e 6c 61 73 74 52 65 63 6e  .    p->lastRecn
ae00: 6f 20 3d 20 6b 65 79 54 6f 49 6e 74 28 70 2d 3e  o = keyToInt(p->
ae10: 6d 6f 76 65 74 6f 54 61 72 67 65 74 29 3b 0a 20  movetoTarget);. 
ae20: 20 20 20 70 2d 3e 72 65 63 6e 6f 49 73 56 61 6c     p->recnoIsVal
ae30: 69 64 20 3d 20 72 65 73 3d 3d 30 3b 0a 20 20 20  id = res==0;.   
ae40: 20 69 66 28 20 72 65 73 3c 30 20 29 7b 0a 20 20   if( res<0 ){.  
ae50: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
ae60: 42 74 72 65 65 4e 65 78 74 28 70 2d 3e 70 43 75  BtreeNext(p->pCu
ae70: 72 73 6f 72 2c 20 26 72 65 73 29 3b 0a 20 20 20  rsor, &res);.   
ae80: 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75     if( rc ) retu
ae90: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20  rn rc;.    }.   
aea0: 20 73 71 6c 69 74 65 33 5f 73 65 61 72 63 68 5f   sqlite3_search_
aeb0: 63 6f 75 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e  count++;.    p->
aec0: 64 65 66 65 72 72 65 64 4d 6f 76 65 74 6f 20 3d  deferredMoveto =
aed0: 20 30 3b 0a 20 20 20 20 70 2d 3e 63 61 63 68 65   0;.    p->cache
aee0: 56 61 6c 69 64 20 3d 20 30 3b 0a 20 20 7d 0a 20  Valid = 0;.  }. 
aef0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
af00: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  K;.}../*.** The 
af10: 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69  following functi
af20: 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74  ons:.**.** sqlit
af30: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
af40: 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62  ().** sqlite3Vdb
af50: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 29  eSerialTypeLen()
af60: 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53  .** sqlite3VdbeS
af70: 65 72 69 61 6c 52 65 61 64 28 29 0a 2a 2a 20 73  erialRead().** s
af80: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
af90: 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33  Len().** sqlite3
afa0: 56 64 62 65 53 65 72 69 61 6c 57 72 69 74 65 28  VdbeSerialWrite(
afb0: 29 0a 2a 2a 0a 2a 2a 20 65 6e 63 61 70 73 75 6c  ).**.** encapsul
afc0: 61 74 65 20 74 68 65 20 63 6f 64 65 20 74 68 61  ate the code tha
afd0: 74 20 73 65 72 69 61 6c 69 7a 65 73 20 76 61 6c  t serializes val
afe0: 75 65 73 20 66 6f 72 20 73 74 6f 72 61 67 65 20  ues for storage 
aff0: 69 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 64 61 74  in SQLite.** dat
b000: 61 20 61 6e 64 20 69 6e 64 65 78 20 72 65 63 6f  a and index reco
b010: 72 64 73 2e 20 45 61 63 68 20 73 65 72 69 61 6c  rds. Each serial
b020: 69 7a 65 64 20 76 61 6c 75 65 20 63 6f 6e 73 69  ized value consi
b030: 73 74 73 20 6f 66 20 61 0a 2a 2a 20 27 73 65 72  sts of a.** 'ser
b040: 69 61 6c 2d 74 79 70 65 27 20 61 6e 64 20 61 20  ial-type' and a 
b050: 62 6c 6f 62 20 6f 66 20 64 61 74 61 2e 20 54 68  blob of data. Th
b060: 65 20 73 65 72 69 61 6c 20 74 79 70 65 20 69 73  e serial type is
b070: 20 61 6e 20 38 2d 62 79 74 65 20 75 6e 73 69 67   an 8-byte unsig
b080: 6e 65 64 0a 2a 2a 20 69 6e 74 65 67 65 72 2c 20  ned.** integer, 
b090: 73 74 6f 72 65 64 20 61 73 20 61 20 76 61 72 69  stored as a vari
b0a0: 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 61 6e 20  nt..**.** In an 
b0b0: 53 51 4c 69 74 65 20 69 6e 64 65 78 20 72 65 63  SQLite index rec
b0c0: 6f 72 64 2c 20 74 68 65 20 73 65 72 69 61 6c 20  ord, the serial 
b0d0: 74 79 70 65 20 69 73 20 73 74 6f 72 65 64 20 64  type is stored d
b0e0: 69 72 65 63 74 6c 79 20 62 65 66 6f 72 65 0a 2a  irectly before.*
b0f0: 2a 20 74 68 65 20 62 6c 6f 62 20 6f 66 20 64 61  * the blob of da
b100: 74 61 20 74 68 61 74 20 69 74 20 63 6f 72 72 65  ta that it corre
b110: 73 70 6f 6e 64 73 20 74 6f 2e 20 49 6e 20 61 20  sponds to. In a 
b120: 74 61 62 6c 65 20 72 65 63 6f 72 64 2c 20 61 6c  table record, al
b130: 6c 20 73 65 72 69 61 6c 0a 2a 2a 20 74 79 70 65  l serial.** type
b140: 73 20 61 72 65 20 73 74 6f 72 65 64 20 61 74 20  s are stored at 
b150: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65  the start of the
b160: 20 72 65 63 6f 72 64 2c 20 61 6e 64 20 74 68 65   record, and the
b170: 20 62 6c 6f 62 73 20 6f 66 20 64 61 74 61 20 61   blobs of data a
b180: 74 0a 2a 2a 20 74 68 65 20 65 6e 64 2e 20 48 65  t.** the end. He
b190: 6e 63 65 20 74 68 65 73 65 20 66 75 6e 63 74 69  nce these functi
b1a0: 6f 6e 73 20 61 6c 6c 6f 77 20 74 68 65 20 63 61  ons allow the ca
b1b0: 6c 6c 65 72 20 74 6f 20 68 61 6e 64 6c 65 20 74  ller to handle t
b1c0: 68 65 0a 2a 2a 20 73 65 72 69 61 6c 2d 74 79 70  he.** serial-typ
b1d0: 65 20 61 6e 64 20 64 61 74 61 20 62 6c 6f 62 20  e and data blob 
b1e0: 73 65 70 65 72 61 74 65 6c 79 2e 0a 2a 2a 0a 2a  seperately..**.*
b1f0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
b200: 74 61 62 6c 65 20 64 65 73 63 72 69 62 65 73 20  table describes 
b210: 74 68 65 20 76 61 72 69 6f 75 73 20 73 74 6f 72  the various stor
b220: 61 67 65 20 63 6c 61 73 73 65 73 20 66 6f 72 20  age classes for 
b230: 64 61 74 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 73 65  data:.**.**   se
b240: 72 69 61 6c 20 74 79 70 65 20 20 20 20 20 20 20  rial type       
b250: 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 20   bytes of data  
b260: 20 20 20 20 74 79 70 65 0a 2a 2a 20 20 20 2d 2d      type.**   --
b270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20  ------------    
b280: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d   ---------------
b290: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d      ------------
b2a0: 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 30 20 20 20  ---.**      0   
b2b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b2c0: 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 4e    0            N
b2d0: 55 4c 4c 0a 2a 2a 20 20 20 20 20 20 31 20 20 20  ULL.**      1   
b2e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b2f0: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 73    1            s
b300: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a  igned integer.**
b310: 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20        2         
b320: 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20              2   
b330: 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20           signed 
b340: 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20  integer.**      
b350: 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  3               
b360: 20 20 20 20 20 20 33 20 20 20 20 20 20 20 20 20        3         
b370: 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65     signed intege
b380: 72 0a 2a 2a 20 20 20 20 20 20 34 20 20 20 20 20  r.**      4     
b390: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b3a0: 34 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67  4            sig
b3b0: 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20  ned integer.**  
b3c0: 20 20 20 20 35 20 20 20 20 20 20 20 20 20 20 20      5           
b3d0: 20 20 20 20 20 20 20 20 20 20 36 20 20 20 20 20            6     
b3e0: 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e         signed in
b3f0: 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 36 20  teger.**      6 
b400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b410: 20 20 20 20 38 20 20 20 20 20 20 20 20 20 20 20      8           
b420: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a   signed integer.
b430: 2a 2a 20 20 20 20 20 20 37 20 20 20 20 20 20 20  **      7       
b440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 38 20                8 
b450: 20 20 20 20 20 20 20 20 20 20 20 49 45 45 45 20             IEEE 
b460: 66 6c 6f 61 74 0a 2a 2a 20 20 20 20 20 38 2d 31  float.**     8-1
b470: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1               
b480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b490: 20 72 65 73 65 72 76 65 64 20 66 6f 72 20 65 78   reserved for ex
b4a0: 70 61 6e 73 69 6f 6e 0a 2a 2a 20 20 20 20 4e 3e  pansion.**    N>
b4b0: 3d 31 32 20 61 6e 64 20 65 76 65 6e 20 20 20 20  =12 and even    
b4c0: 20 20 20 28 4e 2d 31 32 29 2f 32 20 20 20 20 20     (N-12)/2     
b4d0: 20 20 20 42 4c 4f 42 0a 2a 2a 20 20 20 20 4e 3e     BLOB.**    N>
b4e0: 3d 31 33 20 61 6e 64 20 6f 64 64 20 20 20 20 20  =13 and odd     
b4f0: 20 20 20 28 4e 2d 31 33 29 2f 32 20 20 20 20 20     (N-13)/2     
b500: 20 20 20 74 65 78 74 0a 2a 2a 0a 2a 2f 0a 0a 2f     text.**.*/../
b510: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
b520: 73 65 72 69 61 6c 2d 74 79 70 65 20 66 6f 72 20  serial-type for 
b530: 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64  the value stored
b540: 20 69 6e 20 70 4d 65 6d 2e 0a 2a 2f 0a 75 33 32   in pMem..*/.u32
b550: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
b560: 61 6c 54 79 70 65 28 4d 65 6d 20 2a 70 4d 65 6d  alType(Mem *pMem
b570: 29 7b 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 3d  ){.  int flags =
b580: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 3b 0a 0a 20   pMem->flags;.. 
b590: 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 4e   if( flags&MEM_N
b5a0: 75 6c 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ull ){.    retur
b5b0: 6e 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66  n 0;.  }.  if( f
b5c0: 6c 61 67 73 26 4d 45 4d 5f 49 6e 74 20 29 7b 0a  lags&MEM_Int ){.
b5d0: 20 20 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75      /* Figure ou
b5e0: 74 20 77 68 65 74 68 65 72 20 74 6f 20 75 73 65  t whether to use
b5f0: 20 31 2c 20 32 2c 20 34 2c 20 36 20 6f 72 20 38   1, 2, 4, 6 or 8
b600: 20 62 79 74 65 73 2e 20 2a 2f 0a 23 20 20 20 64   bytes. */.#   d
b610: 65 66 69 6e 65 20 4d 41 58 5f 36 42 59 54 45 20  efine MAX_6BYTE 
b620: 28 28 28 28 69 36 34 29 30 78 30 30 30 30 31 30  ((((i64)0x000010
b630: 30 30 29 3c 3c 33 32 29 2d 31 29 0a 20 20 20 20  00)<<32)-1).    
b640: 69 36 34 20 69 20 3d 20 70 4d 65 6d 2d 3e 69 3b  i64 i = pMem->i;
b650: 0a 20 20 20 20 75 36 34 20 75 20 3d 20 69 3c 30  .    u64 u = i<0
b660: 20 3f 20 2d 69 20 3a 20 69 3b 0a 20 20 20 20 69   ? -i : i;.    i
b670: 66 28 20 75 3c 3d 31 32 37 20 29 20 72 65 74 75  f( u<=127 ) retu
b680: 72 6e 20 31 3b 0a 20 20 20 20 69 66 28 20 75 3c  rn 1;.    if( u<
b690: 3d 33 32 37 36 37 20 29 20 72 65 74 75 72 6e 20  =32767 ) return 
b6a0: 32 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 38 33  2;.    if( u<=83
b6b0: 38 38 36 30 37 20 29 20 72 65 74 75 72 6e 20 33  88607 ) return 3
b6c0: 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 32 31 34  ;.    if( u<=214
b6d0: 37 34 38 33 36 34 37 20 29 20 72 65 74 75 72 6e  7483647 ) return
b6e0: 20 34 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 4d   4;.    if( u<=M
b6f0: 41 58 5f 36 42 59 54 45 20 29 20 72 65 74 75 72  AX_6BYTE ) retur
b700: 6e 20 35 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  n 5;.    return 
b710: 36 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61  6;.  }.  if( fla
b720: 67 73 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a 20  gs&MEM_Real ){. 
b730: 20 20 20 72 65 74 75 72 6e 20 37 3b 0a 20 20 7d     return 7;.  }
b740: 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d  .  if( flags&MEM
b750: 5f 53 74 72 20 29 7b 0a 20 20 20 20 69 6e 74 20  _Str ){.    int 
b760: 6e 20 3d 20 70 4d 65 6d 2d 3e 6e 3b 0a 20 20 20  n = pMem->n;.   
b770: 20 61 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b   assert( n>=0 );
b780: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 28 6e 2a  .    return ((n*
b790: 32 29 20 2b 20 31 33 29 3b 0a 20 20 7d 0a 20 20  2) + 13);.  }.  
b7a0: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 42 6c  if( flags&MEM_Bl
b7b0: 6f 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ob ){.    return
b7c0: 20 28 70 4d 65 6d 2d 3e 6e 2a 32 20 2b 20 31 32   (pMem->n*2 + 12
b7d0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
b7e0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  0;.}../*.** Retu
b7f0: 72 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66  rn the length of
b800: 20 74 68 65 20 64 61 74 61 20 63 6f 72 72 65 73   the data corres
b810: 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 73  ponding to the s
b820: 75 70 70 6c 69 65 64 20 73 65 72 69 61 6c 2d 74  upplied serial-t
b830: 79 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ype..*/.int sqli
b840: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
b850: 65 4c 65 6e 28 75 33 32 20 73 65 72 69 61 6c 5f  eLen(u32 serial_
b860: 74 79 70 65 29 7b 0a 20 20 69 66 28 20 73 65 72  type){.  if( ser
b870: 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b 0a  ial_type>=12 ){.
b880: 20 20 20 20 72 65 74 75 72 6e 20 28 73 65 72 69      return (seri
b890: 61 6c 5f 74 79 70 65 2d 31 32 29 2f 32 3b 0a 20  al_type-12)/2;. 
b8a0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 61 74   }else{.    stat
b8b0: 69 63 20 63 6f 6e 73 74 20 75 38 20 61 53 69 7a  ic const u8 aSiz
b8c0: 65 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c 20 32 2c  e[] = { 0, 1, 2,
b8d0: 20 33 2c 20 34 2c 20 36 2c 20 38 2c 20 38 2c 20   3, 4, 6, 8, 8, 
b8e0: 30 2c 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 20 20  0, 0, 0, 0 };.  
b8f0: 20 20 72 65 74 75 72 6e 20 61 53 69 7a 65 5b 73    return aSize[s
b900: 65 72 69 61 6c 5f 74 79 70 65 5d 3b 0a 20 20 7d  erial_type];.  }
b910: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20  .}../*.** Write 
b920: 74 68 65 20 73 65 72 69 61 6c 69 7a 65 64 20 64  the serialized d
b930: 61 74 61 20 62 6c 6f 62 20 66 6f 72 20 74 68 65  ata blob for the
b940: 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e   value stored in
b950: 20 70 4d 65 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62   pMem into .** b
b960: 75 66 2e 20 49 74 20 69 73 20 61 73 73 75 6d 65  uf. It is assume
b970: 64 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65  d that the calle
b980: 72 20 68 61 73 20 61 6c 6c 6f 63 61 74 65 64 20  r has allocated 
b990: 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65  sufficient space
b9a0: 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  ..** Return the 
b9b0: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  number of bytes 
b9c0: 77 72 69 74 74 65 6e 2e 0a 2a 2f 20 0a 69 6e 74  written..*/ .int
b9d0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
b9e0: 61 6c 50 75 74 28 75 6e 73 69 67 6e 65 64 20 63  alPut(unsigned c
b9f0: 68 61 72 20 2a 62 75 66 2c 20 4d 65 6d 20 2a 70  har *buf, Mem *p
ba00: 4d 65 6d 29 7b 0a 20 20 75 33 32 20 73 65 72 69  Mem){.  u32 seri
ba10: 61 6c 5f 74 79 70 65 20 3d 20 73 71 6c 69 74 65  al_type = sqlite
ba20: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28  3VdbeSerialType(
ba30: 70 4d 65 6d 29 3b 0a 20 20 69 6e 74 20 6c 65 6e  pMem);.  int len
ba40: 3b 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a  ;..  /* NULL */.
ba50: 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70    if( serial_typ
ba60: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  e==0 ){.    retu
ba70: 72 6e 20 30 3b 0a 20 20 7d 0a 20 0a 20 20 2f 2a  rn 0;.  }. .  /*
ba80: 20 49 6e 74 65 67 65 72 20 61 6e 64 20 52 65 61   Integer and Rea
ba90: 6c 20 2a 2f 0a 20 20 69 66 28 20 73 65 72 69 61  l */.  if( seria
baa0: 6c 5f 74 79 70 65 3c 3d 37 20 29 7b 0a 20 20 20  l_type<=7 ){.   
bab0: 20 75 36 34 20 76 3b 0a 20 20 20 20 69 6e 74 20   u64 v;.    int 
bac0: 69 3b 0a 20 20 20 20 69 66 28 20 73 65 72 69 61  i;.    if( seria
bad0: 6c 5f 74 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20  l_type==7 ){.   
bae0: 20 20 20 76 20 3d 20 2a 28 75 36 34 2a 29 26 70     v = *(u64*)&p
baf0: 4d 65 6d 2d 3e 72 3b 0a 20 20 20 20 7d 65 6c 73  Mem->r;.    }els
bb00: 65 7b 0a 20 20 20 20 20 20 76 20 3d 20 2a 28 75  e{.      v = *(u
bb10: 36 34 2a 29 26 70 4d 65 6d 2d 3e 69 3b 0a 20 20  64*)&pMem->i;.  
bb20: 20 20 7d 0a 20 20 20 20 6c 65 6e 20 3d 20 69 20    }.    len = i 
bb30: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
bb40: 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61  ialTypeLen(seria
bb50: 6c 5f 74 79 70 65 29 3b 0a 20 20 20 20 77 68 69  l_type);.    whi
bb60: 6c 65 28 20 69 2d 2d 20 29 7b 0a 20 20 20 20 20  le( i-- ){.     
bb70: 20 62 75 66 5b 69 5d 20 3d 20 28 76 26 30 78 46   buf[i] = (v&0xF
bb80: 46 29 3b 0a 20 20 20 20 20 20 76 20 3e 3e 3d 20  F);.      v >>= 
bb90: 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74  8;.    }.    ret
bba0: 75 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a 20 20 0a  urn len;.  }.  .
bbb0: 20 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72 20 62    /* String or b
bbc0: 6c 6f 62 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  lob */.  assert(
bbd0: 20 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32   serial_type>=12
bbe0: 20 29 3b 0a 20 20 6c 65 6e 20 3d 20 73 71 6c 69   );.  len = sqli
bbf0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
bc00: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
bc10: 29 3b 0a 20 20 6d 65 6d 63 70 79 28 62 75 66 2c  );.  memcpy(buf,
bc20: 20 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29 3b 0a   pMem->z, len);.
bc30: 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 7d 0a    return len;.}.
bc40: 0a 2f 2a 0a 2a 2a 20 44 65 73 65 72 69 61 6c 69  ./*.** Deseriali
bc50: 7a 65 20 74 68 65 20 64 61 74 61 20 62 6c 6f 62  ze the data blob
bc60: 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 62   pointed to by b
bc70: 75 66 20 61 73 20 73 65 72 69 61 6c 20 74 79 70  uf as serial typ
bc80: 65 20 73 65 72 69 61 6c 5f 74 79 70 65 0a 2a 2a  e serial_type.**
bc90: 20 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 72   and store the r
bca0: 65 73 75 6c 74 20 69 6e 20 70 4d 65 6d 2e 20 20  esult in pMem.  
bcb0: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
bcc0: 72 20 6f 66 20 62 79 74 65 73 20 72 65 61 64 2e  r of bytes read.
bcd0: 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33  .*/ .int sqlite3
bce0: 56 64 62 65 53 65 72 69 61 6c 47 65 74 28 0a 20  VdbeSerialGet(. 
bcf0: 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20   const unsigned 
bd00: 63 68 61 72 20 2a 62 75 66 2c 20 20 20 20 20 2f  char *buf,     /
bd10: 2a 20 42 75 66 66 65 72 20 74 6f 20 64 65 73 65  * Buffer to dese
bd20: 72 69 61 6c 69 7a 65 20 66 72 6f 6d 20 2a 2f 0a  rialize from */.
bd30: 20 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70    u32 serial_typ
bd40: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
bd50: 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 74  /* Serial type t
bd60: 6f 20 64 65 73 65 72 69 61 6c 69 7a 65 20 2a 2f  o deserialize */
bd70: 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 20 20 20  .  Mem *pMem    
bd80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bd90: 20 2f 2a 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20   /* Memory cell 
bda0: 74 6f 20 77 72 69 74 65 20 76 61 6c 75 65 20 69  to write value i
bdb0: 6e 74 6f 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20  nto */.){.  int 
bdc0: 6c 65 6e 3b 0a 0a 20 20 69 66 28 20 73 65 72 69  len;..  if( seri
bdd0: 61 6c 5f 74 79 70 65 3d 3d 30 20 29 7b 0a 20 20  al_type==0 ){.  
bde0: 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20    /* NULL */.   
bdf0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
be00: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 72 65 74  EM_Null;.    ret
be10: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 6c 65 6e  urn 0;.  }.  len
be20: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65   = sqlite3VdbeSe
be30: 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69  rialTypeLen(seri
be40: 61 6c 5f 74 79 70 65 29 3b 0a 20 20 69 66 28 20  al_type);.  if( 
be50: 73 65 72 69 61 6c 5f 74 79 70 65 3c 3d 37 20 29  serial_type<=7 )
be60: 7b 0a 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72  {.    /* Integer
be70: 20 61 6e 64 20 52 65 61 6c 20 2a 2f 0a 20 20 20   and Real */.   
be80: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
be90: 3c 3d 34 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  <=4 ){.      /* 
bea0: 33 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 74  32-bit integer t
beb0: 79 70 65 2e 20 20 54 68 69 73 20 69 73 20 68 61  ype.  This is ha
bec0: 6e 64 6c 65 64 20 62 79 20 61 20 73 70 65 63 69  ndled by a speci
bed0: 61 6c 20 63 61 73 65 20 66 6f 72 0a 20 20 20 20  al case for.    
bee0: 20 20 2a 2a 20 70 65 72 66 6f 72 6d 61 6e 63 65    ** performance
bef0: 20 72 65 61 73 6f 6e 73 2e 20 2a 2f 0a 20 20 20   reasons. */.   
bf00: 20 20 20 69 6e 74 20 76 20 3d 20 62 75 66 5b 30     int v = buf[0
bf10: 5d 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 3b 0a  ];.      int n;.
bf20: 20 20 20 20 20 20 69 66 28 20 76 26 30 78 38 30        if( v&0x80
bf30: 20 29 7b 0a 20 20 20 20 20 20 20 20 76 20 7c 3d   ){.        v |=
bf40: 20 2d 32 35 36 3b 0a 20 20 20 20 20 20 7d 0a 20   -256;.      }. 
bf50: 20 20 20 20 20 66 6f 72 28 6e 3d 31 3b 20 6e 3c       for(n=1; n<
bf60: 6c 65 6e 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20 20  len; n++){.     
bf70: 20 20 20 76 20 3d 20 28 76 3c 3c 38 29 20 7c 20     v = (v<<8) | 
bf80: 62 75 66 5b 6e 5d 3b 0a 20 20 20 20 20 20 7d 0a  buf[n];.      }.
bf90: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
bfa0: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
bfb0: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 76 3b 0a     pMem->i = v;.
bfc0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 6e 3b 0a        return n;.
bfd0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
bfe0: 20 75 36 34 20 76 20 3d 20 30 3b 0a 20 20 20 20   u64 v = 0;.    
bff0: 20 20 69 6e 74 20 6e 3b 0a 0a 20 20 20 20 20 20    int n;..      
c000: 69 66 28 20 62 75 66 5b 30 5d 26 30 78 38 30 20  if( buf[0]&0x80 
c010: 29 7b 0a 20 20 20 20 20 20 20 20 76 20 3d 20 2d  ){.        v = -
c020: 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  1;.      }.     
c030: 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c 6c 65 6e 3b   for(n=0; n<len;
c040: 20 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 76   n++){.        v
c050: 20 3d 20 28 76 3c 3c 38 29 20 7c 20 62 75 66 5b   = (v<<8) | buf[
c060: 6e 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  n];.      }.    
c070: 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70    if( serial_typ
c080: 65 3d 3d 37 20 29 7b 0a 20 20 20 20 20 20 20 20  e==7 ){.        
c090: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
c0a0: 4d 5f 52 65 61 6c 3b 0a 20 20 20 20 20 20 20 20  M_Real;.        
c0b0: 70 4d 65 6d 2d 3e 72 20 3d 20 2a 28 64 6f 75 62  pMem->r = *(doub
c0c0: 6c 65 2a 29 26 76 3b 0a 20 20 20 20 20 20 7d 65  le*)&v;.      }e
c0d0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65  lse{.        pMe
c0e0: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49  m->flags = MEM_I
c0f0: 6e 74 3b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d  nt;.        pMem
c100: 2d 3e 69 20 3d 20 2a 28 69 36 34 2a 29 26 76 3b  ->i = *(i64*)&v;
c110: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
c120: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 53   }else{.    /* S
c130: 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 2a 2f  tring or blob */
c140: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 65 72  .    assert( ser
c150: 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 3b 0a  ial_type>=12 );.
c160: 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 28 63      pMem->z = (c
c170: 68 61 72 20 2a 29 62 75 66 3b 0a 20 20 20 20 70  har *)buf;.    p
c180: 4d 65 6d 2d 3e 6e 20 3d 20 6c 65 6e 3b 0a 20 20  Mem->n = len;.  
c190: 20 20 70 4d 65 6d 2d 3e 78 44 65 6c 20 3d 20 30    pMem->xDel = 0
c1a0: 3b 0a 20 20 20 20 69 66 28 20 73 65 72 69 61 6c  ;.    if( serial
c1b0: 5f 74 79 70 65 26 30 78 30 31 20 29 7b 0a 20 20  _type&0x01 ){.  
c1c0: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
c1d0: 3d 20 4d 45 4d 5f 53 74 72 20 7c 20 4d 45 4d 5f  = MEM_Str | MEM_
c1e0: 45 70 68 65 6d 3b 0a 20 20 20 20 7d 65 6c 73 65  Ephem;.    }else
c1f0: 7b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  {.      pMem->fl
c200: 61 67 73 20 3d 20 4d 45 4d 5f 42 6c 6f 62 20 7c  ags = MEM_Blob |
c210: 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20 20   MEM_Ephem;.    
c220: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6c  }.  }.  return l
c230: 65 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  en;.}../*.** Thi
c240: 73 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 70 61  s function compa
c250: 72 65 73 20 74 68 65 20 74 77 6f 20 74 61 62 6c  res the two tabl
c260: 65 20 72 6f 77 73 20 6f 72 20 69 6e 64 65 78 20  e rows or index 
c270: 72 65 63 6f 72 64 73 20 73 70 65 63 69 66 69 65  records specifie
c280: 64 20 62 79 20 0a 2a 2a 20 7b 6e 4b 65 79 31 2c  d by .** {nKey1,
c290: 20 70 4b 65 79 31 7d 20 61 6e 64 20 7b 6e 4b 65   pKey1} and {nKe
c2a0: 79 32 2c 20 70 4b 65 79 32 7d 2c 20 72 65 74 75  y2, pKey2}, retu
c2b0: 72 6e 69 6e 67 20 61 20 6e 65 67 61 74 69 76 65  rning a negative
c2c0: 2c 20 7a 65 72 6f 0a 2a 2a 20 6f 72 20 70 6f 73  , zero.** or pos
c2d0: 69 74 69 76 65 20 69 6e 74 65 67 65 72 20 69 66  itive integer if
c2e0: 20 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20   {nKey1, pKey1} 
c2f0: 69 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65 71  is less than, eq
c300: 75 61 6c 20 74 6f 20 6f 72 20 0a 2a 2a 20 67 72  ual to or .** gr
c310: 65 61 74 65 72 20 74 68 61 6e 20 7b 6e 4b 65 79  eater than {nKey
c320: 32 2c 20 70 4b 65 79 32 7d 2e 20 20 42 6f 74 68  2, pKey2}.  Both
c330: 20 4b 65 79 31 20 61 6e 64 20 4b 65 79 32 20 6d   Key1 and Key2 m
c340: 75 73 74 20 62 65 20 62 79 74 65 20 73 74 72 69  ust be byte stri
c350: 6e 67 73 0a 2a 2a 20 63 6f 6d 70 6f 73 65 64 20  ngs.** composed 
c360: 62 79 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65  by the OP_MakeRe
c370: 63 6f 72 64 20 6f 70 63 6f 64 65 20 6f 66 20 74  cord opcode of t
c380: 68 65 20 56 44 42 45 2e 0a 2a 2f 0a 69 6e 74 20  he VDBE..*/.int 
c390: 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72  sqlite3VdbeRecor
c3a0: 64 43 6f 6d 70 61 72 65 28 0a 20 20 76 6f 69 64  dCompare(.  void
c3b0: 20 2a 75 73 65 72 44 61 74 61 2c 0a 20 20 69 6e   *userData,.  in
c3c0: 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76  t nKey1, const v
c3d0: 6f 69 64 20 2a 70 4b 65 79 31 2c 20 0a 20 20 69  oid *pKey1, .  i
c3e0: 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20  nt nKey2, const 
c3f0: 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20  void *pKey2.){. 
c400: 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e   KeyInfo *pKeyIn
c410: 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 75  fo = (KeyInfo*)u
c420: 73 65 72 44 61 74 61 3b 0a 20 20 75 33 32 20 64  serData;.  u32 d
c430: 31 2c 20 64 32 3b 20 20 20 20 20 20 20 20 20 20  1, d2;          
c440: 2f 2a 20 4f 66 66 73 65 74 20 69 6e 74 6f 20 61  /* Offset into a
c450: 4b 65 79 5b 5d 20 6f 66 20 6e 65 78 74 20 64 61  Key[] of next da
c460: 74 61 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20  ta element */.  
c470: 75 33 32 20 69 64 78 31 2c 20 69 64 78 32 3b 20  u32 idx1, idx2; 
c480: 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69       /* Offset i
c490: 6e 74 6f 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65  nto aKey[] of ne
c4a0: 78 74 20 68 65 61 64 65 72 20 65 6c 65 6d 65 6e  xt header elemen
c4b0: 74 20 2a 2f 0a 20 20 75 33 32 20 73 7a 48 64 72  t */.  u32 szHdr
c4c0: 31 2c 20 73 7a 48 64 72 32 3b 20 20 2f 2a 20 4e  1, szHdr2;  /* N
c4d0: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69  umber of bytes i
c4e0: 6e 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e  n header */.  in
c4f0: 74 20 69 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e  t i = 0;.  int n
c500: 46 69 65 6c 64 3b 0a 20 20 69 6e 74 20 72 63 20  Field;.  int rc 
c510: 3d 20 30 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73  = 0;.  const uns
c520: 69 67 6e 65 64 20 63 68 61 72 20 2a 61 4b 65 79  igned char *aKey
c530: 31 20 3d 20 28 63 6f 6e 73 74 20 75 6e 73 69 67  1 = (const unsig
c540: 6e 65 64 20 63 68 61 72 20 2a 29 70 4b 65 79 31  ned char *)pKey1
c550: 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  ;.  const unsign
c560: 65 64 20 63 68 61 72 20 2a 61 4b 65 79 32 20 3d  ed char *aKey2 =
c570: 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64   (const unsigned
c580: 20 63 68 61 72 20 2a 29 70 4b 65 79 32 3b 0a 0a   char *)pKey2;..
c590: 20 20 4d 65 6d 20 6d 65 6d 31 3b 0a 20 20 4d 65    Mem mem1;.  Me
c5a0: 6d 20 6d 65 6d 32 3b 0a 20 20 6d 65 6d 31 2e 65  m mem2;.  mem1.e
c5b0: 6e 63 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65  nc = pKeyInfo->e
c5c0: 6e 63 3b 0a 20 20 6d 65 6d 32 2e 65 6e 63 20 3d  nc;.  mem2.enc =
c5d0: 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a   pKeyInfo->enc;.
c5e0: 20 20 0a 20 20 69 64 78 31 20 3d 20 73 71 6c 69    .  idx1 = sqli
c5f0: 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 70  te3GetVarint32(p
c600: 4b 65 79 31 2c 20 26 73 7a 48 64 72 31 29 3b 0a  Key1, &szHdr1);.
c610: 20 20 64 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20    d1 = szHdr1;. 
c620: 20 69 64 78 32 20 3d 20 73 71 6c 69 74 65 33 47   idx2 = sqlite3G
c630: 65 74 56 61 72 69 6e 74 33 32 28 70 4b 65 79 32  etVarint32(pKey2
c640: 2c 20 26 73 7a 48 64 72 32 29 3b 0a 20 20 64 32  , &szHdr2);.  d2
c650: 20 3d 20 73 7a 48 64 72 32 3b 0a 20 20 6e 46 69   = szHdr2;.  nFi
c660: 65 6c 64 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e  eld = pKeyInfo->
c670: 6e 46 69 65 6c 64 3b 0a 20 20 77 68 69 6c 65 28  nField;.  while(
c680: 20 69 64 78 31 3c 73 7a 48 64 72 31 20 26 26 20   idx1<szHdr1 && 
c690: 69 64 78 32 3c 73 7a 48 64 72 32 20 29 7b 0a 20  idx2<szHdr2 ){. 
c6a0: 20 20 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79     u32 serial_ty
c6b0: 70 65 31 3b 0a 20 20 20 20 75 33 32 20 73 65 72  pe1;.    u32 ser
c6c0: 69 61 6c 5f 74 79 70 65 32 3b 0a 0a 20 20 20 20  ial_type2;..    
c6d0: 2f 2a 20 52 65 61 64 20 74 68 65 20 73 65 72 69  /* Read the seri
c6e0: 61 6c 20 74 79 70 65 73 20 66 6f 72 20 74 68 65  al types for the
c6f0: 20 6e 65 78 74 20 65 6c 65 6d 65 6e 74 20 69 6e   next element in
c700: 20 65 61 63 68 20 6b 65 79 2e 20 2a 2f 0a 20 20   each key. */.  
c710: 20 20 69 64 78 31 20 2b 3d 20 73 71 6c 69 74 65    idx1 += sqlite
c720: 33 47 65 74 56 61 72 69 6e 74 33 32 28 26 61 4b  3GetVarint32(&aK
c730: 65 79 31 5b 69 64 78 31 5d 2c 20 26 73 65 72 69  ey1[idx1], &seri
c740: 61 6c 5f 74 79 70 65 31 29 3b 0a 20 20 20 20 69  al_type1);.    i
c750: 66 28 20 64 31 3e 3d 6e 4b 65 79 31 20 26 26 20  f( d1>=nKey1 && 
c760: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
c770: 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f  lTypeLen(serial_
c780: 74 79 70 65 31 29 3e 30 20 29 20 62 72 65 61 6b  type1)>0 ) break
c790: 3b 0a 20 20 20 20 69 64 78 32 20 2b 3d 20 73 71  ;.    idx2 += sq
c7a0: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
c7b0: 28 26 61 4b 65 79 32 5b 69 64 78 32 5d 2c 20 26  (&aKey2[idx2], &
c7c0: 73 65 72 69 61 6c 5f 74 79 70 65 32 29 3b 0a 20  serial_type2);. 
c7d0: 20 20 20 69 66 28 20 64 32 3e 3d 6e 4b 65 79 32     if( d2>=nKey2
c7e0: 20 26 26 20 73 71 6c 69 74 65 33 56 64 62 65 53   && sqlite3VdbeS
c7f0: 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72  erialTypeLen(ser
c800: 69 61 6c 5f 74 79 70 65 32 29 3e 30 20 29 20 62  ial_type2)>0 ) b
c810: 72 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20 41 73  reak;..    /* As
c820: 73 65 72 74 20 74 68 61 74 20 74 68 65 72 65 20  sert that there 
c830: 69 73 20 65 6e 6f 75 67 68 20 73 70 61 63 65 20  is enough space 
c840: 6c 65 66 74 20 69 6e 20 65 61 63 68 20 6b 65 79  left in each key
c850: 20 66 6f 72 20 74 68 65 20 62 6c 6f 62 20 6f 66   for the blob of
c860: 0a 20 20 20 20 2a 2a 20 64 61 74 61 20 74 6f 20  .    ** data to 
c870: 67 6f 20 77 69 74 68 20 74 68 65 20 73 65 72 69  go with the seri
c880: 61 6c 20 74 79 70 65 20 6a 75 73 74 20 72 65 61  al type just rea
c890: 64 2e 20 54 68 69 73 20 61 73 73 65 72 74 20 6d  d. This assert m
c8a0: 61 79 20 66 61 69 6c 20 69 66 0a 20 20 20 20 2a  ay fail if.    *
c8b0: 2a 20 74 68 65 20 66 69 6c 65 20 69 73 20 63 6f  * the file is co
c8c0: 72 72 75 70 74 65 64 2e 20 20 54 68 65 6e 20 72  rrupted.  Then r
c8d0: 65 61 64 20 74 68 65 20 76 61 6c 75 65 20 66 72  ead the value fr
c8e0: 6f 6d 20 65 61 63 68 20 6b 65 79 20 69 6e 74 6f  om each key into
c8f0: 20 6d 65 6d 31 0a 20 20 20 20 2a 2a 20 61 6e 64   mem1.    ** and
c900: 20 6d 65 6d 32 20 72 65 73 70 65 63 74 69 76 65   mem2 respective
c910: 6c 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64  ly..    */.    d
c920: 31 20 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65  1 += sqlite3Vdbe
c930: 53 65 72 69 61 6c 47 65 74 28 26 61 4b 65 79 31  SerialGet(&aKey1
c940: 5b 64 31 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70  [d1], serial_typ
c950: 65 31 2c 20 26 6d 65 6d 31 29 3b 0a 20 20 20 20  e1, &mem1);.    
c960: 64 32 20 2b 3d 20 73 71 6c 69 74 65 33 56 64 62  d2 += sqlite3Vdb
c970: 65 53 65 72 69 61 6c 47 65 74 28 26 61 4b 65 79  eSerialGet(&aKey
c980: 32 5b 64 32 5d 2c 20 73 65 72 69 61 6c 5f 74 79  2[d2], serial_ty
c990: 70 65 32 2c 20 26 6d 65 6d 32 29 3b 0a 0a 20 20  pe2, &mem2);..  
c9a0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4d 65    rc = sqlite3Me
c9b0: 6d 43 6f 6d 70 61 72 65 28 26 6d 65 6d 31 2c 20  mCompare(&mem1, 
c9c0: 26 6d 65 6d 32 2c 20 69 3c 6e 46 69 65 6c 64 20  &mem2, i<nField 
c9d0: 3f 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c  ? pKeyInfo->aCol
c9e0: 6c 5b 69 5d 20 3a 20 30 29 3b 0a 20 20 20 20 73  l[i] : 0);.    s
c9f0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
ca00: 65 61 73 65 28 26 6d 65 6d 31 29 3b 0a 20 20 20  ease(&mem1);.   
ca10: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52   sqlite3VdbeMemR
ca20: 65 6c 65 61 73 65 28 26 6d 65 6d 32 29 3b 0a 20  elease(&mem2);. 
ca30: 20 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a     if( rc!=0 ){.
ca40: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
ca50: 20 7d 0a 20 20 20 20 69 2b 2b 3b 0a 20 20 7d 0a   }.    i++;.  }.
ca60: 0a 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65  .  /* One of the
ca70: 20 6b 65 79 73 20 72 61 6e 20 6f 75 74 20 6f 66   keys ran out of
ca80: 20 66 69 65 6c 64 73 2c 20 62 75 74 20 61 6c 6c   fields, but all
ca90: 20 74 68 65 20 66 69 65 6c 64 73 20 75 70 20 74   the fields up t
caa0: 6f 20 74 68 61 74 20 70 6f 69 6e 74 0a 20 20 2a  o that point.  *
cab0: 2a 20 77 65 72 65 20 65 71 75 61 6c 2e 20 49 66  * were equal. If
cac0: 20 74 68 65 20 69 6e 63 72 4b 65 79 20 66 6c 61   the incrKey fla
cad0: 67 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20  g is true, then 
cae0: 74 68 65 20 73 65 63 6f 6e 64 20 6b 65 79 20 69  the second key i
caf0: 73 0a 20 20 2a 2a 20 74 72 65 61 74 65 64 20 61  s.  ** treated a
cb00: 73 20 6c 61 72 67 65 72 2e 0a 20 20 2a 2f 0a 20  s larger..  */. 
cb10: 20 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20   if( rc==0 ){.  
cb20: 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e    if( pKeyInfo->
cb30: 69 6e 63 72 4b 65 79 20 29 7b 0a 20 20 20 20 20  incrKey ){.     
cb40: 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 65   rc = -1;.    }e
cb50: 6c 73 65 20 69 66 28 20 64 31 3c 6e 4b 65 79 31  lse if( d1<nKey1
cb60: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 31   ){.      rc = 1
cb70: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20  ;.    }else if( 
cb80: 64 32 3c 6e 4b 65 79 32 20 29 7b 0a 20 20 20 20  d2<nKey2 ){.    
cb90: 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d    rc = -1;.    }
cba0: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 4b 65 79  .  }..  if( pKey
cbb0: 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72  Info->aSortOrder
cbc0: 20 26 26 20 69 3c 70 4b 65 79 49 6e 66 6f 2d 3e   && i<pKeyInfo->
cbd0: 6e 46 69 65 6c 64 20 26 26 20 70 4b 65 79 49 6e  nField && pKeyIn
cbe0: 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b 69  fo->aSortOrder[i
cbf0: 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 2d 72  ] ){.    rc = -r
cc00: 63 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e  c;.  }..  return
cc10: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68   rc;.}../*.** Th
cc20: 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e  e argument is an
cc30: 20 69 6e 64 65 78 20 65 6e 74 72 79 20 63 6f 6d   index entry com
cc40: 70 6f 73 65 64 20 75 73 69 6e 67 20 74 68 65 20  posed using the 
cc50: 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70  OP_MakeRecord op
cc60: 63 6f 64 65 2e 0a 2a 2a 20 54 68 65 20 6c 61 73  code..** The las
cc70: 74 20 65 6e 74 72 79 20 69 6e 20 74 68 69 73 20  t entry in this 
cc80: 72 65 63 6f 72 64 20 73 68 6f 75 6c 64 20 62 65  record should be
cc90: 20 61 6e 20 69 6e 74 65 67 65 72 20 28 73 70 65   an integer (spe
cca0: 63 69 66 69 63 61 6c 6c 79 0a 2a 2a 20 61 6e 20  cifically.** an 
ccb0: 69 6e 74 65 67 65 72 20 72 6f 77 69 64 29 2e 20  integer rowid). 
ccc0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65   This routine re
ccd0: 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72  turns the number
cce0: 20 6f 66 20 62 79 74 65 73 20 69 6e 0a 2a 2a 20   of bytes in.** 
ccf0: 74 68 61 74 20 69 6e 74 65 67 65 72 2e 0a 2a 2f  that integer..*/
cd00: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
cd10: 49 64 78 52 6f 77 69 64 4c 65 6e 28 69 6e 74 20  IdxRowidLen(int 
cd20: 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38 20 2a  nKey, const u8 *
cd30: 61 4b 65 79 29 7b 0a 20 20 75 33 32 20 73 7a 48  aKey){.  u32 szH
cd40: 64 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 69  dr;        /* Si
cd50: 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72  ze of the header
cd60: 20 2a 2f 0a 20 20 75 33 32 20 74 79 70 65 52 6f   */.  u32 typeRo
cd70: 77 69 64 3b 20 20 20 20 2f 2a 20 53 65 72 69 61  wid;    /* Seria
cd80: 6c 20 74 79 70 65 20 6f 66 20 74 68 65 20 72 6f  l type of the ro
cd90: 77 69 64 20 2a 2f 0a 0a 20 20 73 71 6c 69 74 65  wid */..  sqlite
cda0: 33 47 65 74 56 61 72 69 6e 74 33 32 28 61 4b 65  3GetVarint32(aKe
cdb0: 79 2c 20 26 73 7a 48 64 72 29 3b 0a 20 20 73 71  y, &szHdr);.  sq
cdc0: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
cdd0: 28 26 61 4b 65 79 5b 73 7a 48 64 72 2d 31 5d 2c  (&aKey[szHdr-1],
cde0: 20 26 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20   &typeRowid);.  
cdf0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64  return sqlite3Vd
ce00: 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28  beSerialTypeLen(
ce10: 74 79 70 65 52 6f 77 69 64 29 3b 0a 7d 0a 20 20  typeRowid);.}.  
ce20: 0a 0a 2f 2a 0a 2a 2a 20 70 43 75 72 20 70 6f 69  ../*.** pCur poi
ce30: 6e 74 73 20 61 74 20 61 6e 20 69 6e 64 65 78 20  nts at an index 
ce40: 65 6e 74 72 79 20 63 72 65 61 74 65 64 20 75 73  entry created us
ce50: 69 6e 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52  ing the OP_MakeR
ce60: 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a  ecord opcode..**
ce70: 20 52 65 61 64 20 74 68 65 20 72 6f 77 69 64 20   Read the rowid 
ce80: 28 74 68 65 20 6c 61 73 74 20 66 69 65 6c 64 20  (the last field 
ce90: 69 6e 20 74 68 65 20 72 65 63 6f 72 64 29 20 61  in the record) a
cea0: 6e 64 20 73 74 6f 72 65 20 69 74 20 69 6e 20 2a  nd store it in *
ceb0: 72 6f 77 69 64 2e 0a 2a 2a 20 52 65 74 75 72 6e  rowid..** Return
cec0: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76   SQLITE_OK if ev
ced0: 65 72 79 74 68 69 6e 67 20 77 6f 72 6b 73 2c 20  erything works, 
cee0: 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65  or an error code
cef0: 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69   otherwise..*/.i
cf00: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 49 64  nt sqlite3VdbeId
cf10: 78 52 6f 77 69 64 28 42 74 43 75 72 73 6f 72 20  xRowid(BtCursor 
cf20: 2a 70 43 75 72 2c 20 69 36 34 20 2a 72 6f 77 69  *pCur, i64 *rowi
cf30: 64 29 7b 0a 20 20 69 36 34 20 6e 43 65 6c 6c 4b  d){.  i64 nCellK
cf40: 65 79 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  ey;.  int rc;.  
cf50: 75 33 32 20 73 7a 48 64 72 3b 20 20 20 20 20 20  u32 szHdr;      
cf60: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65    /* Size of the
cf70: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75 33 32   header */.  u32
cf80: 20 74 79 70 65 52 6f 77 69 64 3b 20 20 20 20 2f   typeRowid;    /
cf90: 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 6f 66  * Serial type of
cfa0: 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20   the rowid */.  
cfb0: 75 33 32 20 6c 65 6e 52 6f 77 69 64 3b 20 20 20  u32 lenRowid;   
cfc0: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65    /* Size of the
cfd0: 20 72 6f 77 69 64 20 2a 2f 0a 20 20 4d 65 6d 20   rowid */.  Mem 
cfe0: 6d 2c 20 76 3b 0a 0a 20 20 73 71 6c 69 74 65 33  m, v;..  sqlite3
cff0: 42 74 72 65 65 4b 65 79 53 69 7a 65 28 70 43 75  BtreeKeySize(pCu
d000: 72 2c 20 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20  r, &nCellKey);. 
d010: 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30   if( nCellKey<=0
d020: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
d030: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 20  QLITE_CORRUPT;. 
d040: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65   }.  rc = sqlite
d050: 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65  3VdbeMemFromBtre
d060: 65 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 6c 6c  e(pCur, 0, nCell
d070: 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a 20 20 69  Key, 1, &m);.  i
d080: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72 65 74  f( rc ){.    ret
d090: 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 73 71  urn rc;.  }.  sq
d0a0: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
d0b0: 28 6d 2e 7a 2c 20 26 73 7a 48 64 72 29 3b 0a 20  (m.z, &szHdr);. 
d0c0: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
d0d0: 74 33 32 28 26 6d 2e 7a 5b 73 7a 48 64 72 2d 31  t32(&m.z[szHdr-1
d0e0: 5d 2c 20 26 74 79 70 65 52 6f 77 69 64 29 3b 0a  ], &typeRowid);.
d0f0: 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20 73 71 6c    lenRowid = sql
d100: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
d110: 70 65 4c 65 6e 28 74 79 70 65 52 6f 77 69 64 29  peLen(typeRowid)
d120: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 53  ;.  sqlite3VdbeS
d130: 65 72 69 61 6c 47 65 74 28 26 6d 2e 7a 5b 6d 2e  erialGet(&m.z[m.
d140: 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20 74 79 70  n-lenRowid], typ
d150: 65 52 6f 77 69 64 2c 20 26 76 29 3b 0a 20 20 2a  eRowid, &v);.  *
d160: 72 6f 77 69 64 20 3d 20 76 2e 69 3b 0a 20 20 73  rowid = v.i;.  s
d170: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
d180: 65 61 73 65 28 26 6d 29 3b 0a 20 20 72 65 74 75  ease(&m);.  retu
d190: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
d1a0: 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72 65 20 74  ./*.** Compare t
d1b0: 68 65 20 6b 65 79 20 6f 66 20 74 68 65 20 69 6e  he key of the in
d1c0: 64 65 78 20 65 6e 74 72 79 20 74 68 61 74 20 63  dex entry that c
d1d0: 75 72 73 6f 72 20 70 43 20 69 73 20 70 6f 69 6e  ursor pC is poin
d1e0: 74 20 74 6f 20 61 67 61 69 6e 73 74 0a 2a 2a 20  t to against.** 
d1f0: 74 68 65 20 6b 65 79 20 73 74 72 69 6e 67 20 69  the key string i
d200: 6e 20 70 4b 65 79 20 28 6f 66 20 6c 65 6e 67 74  n pKey (of lengt
d210: 68 20 6e 4b 65 79 29 2e 20 20 57 72 69 74 65 20  h nKey).  Write 
d220: 69 6e 74 6f 20 2a 70 52 65 73 20 61 20 6e 75 6d  into *pRes a num
d230: 62 65 72 0a 2a 2a 20 74 68 61 74 20 69 73 20 6e  ber.** that is n
d240: 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 2c 20 6f  egative, zero, o
d250: 72 20 70 6f 73 69 74 69 76 65 20 69 66 20 70 43  r positive if pC
d260: 20 69 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65   is less than, e
d270: 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f 72 20 67  qual to,.** or g
d280: 72 65 61 74 65 72 20 74 68 61 6e 20 70 4b 65 79  reater than pKey
d290: 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45  .  Return SQLITE
d2a0: 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 2e 0a  _OK on success..
d2b0: 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69 73 20 65 69  **.** pKey is ei
d2c0: 74 68 65 72 20 63 72 65 61 74 65 64 20 77 69 74  ther created wit
d2d0: 68 6f 75 74 20 61 20 72 6f 77 69 64 20 6f 72 20  hout a rowid or 
d2e0: 69 73 20 74 72 75 6e 63 61 74 65 64 20 73 6f 20  is truncated so 
d2f0: 74 68 61 74 20 69 74 0a 2a 2a 20 6f 6d 69 74 73  that it.** omits
d300: 20 74 68 65 20 72 6f 77 69 64 20 61 74 20 74 68   the rowid at th
d310: 65 20 65 6e 64 2e 20 20 54 68 65 20 72 6f 77 69  e end.  The rowi
d320: 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20  d at the end of 
d330: 74 68 65 20 69 6e 64 65 78 20 65 6e 74 72 79 0a  the index entry.
d340: 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64 20 61 73  ** is ignored as
d350: 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71   well..*/.int sq
d360: 6c 69 74 65 33 56 64 62 65 49 64 78 4b 65 79 43  lite3VdbeIdxKeyC
d370: 6f 6d 70 61 72 65 28 0a 20 20 43 75 72 73 6f 72  ompare(.  Cursor
d380: 20 2a 70 43 2c 20 20 20 20 20 20 20 20 20 20 20   *pC,           
d390: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72        /* The cur
d3a0: 73 6f 72 20 74 6f 20 63 6f 6d 70 61 72 65 20 61  sor to compare a
d3b0: 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69 6e 74 20  gainst */.  int 
d3c0: 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38 20 2a  nKey, const u8 *
d3d0: 70 4b 65 79 2c 20 20 20 2f 2a 20 54 68 65 20 6b  pKey,   /* The k
d3e0: 65 79 20 74 6f 20 63 6f 6d 70 61 72 65 20 2a 2f  ey to compare */
d3f0: 0a 20 20 69 6e 74 20 2a 72 65 73 20 20 20 20 20  .  int *res     
d400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
d410: 2a 20 57 72 69 74 65 20 74 68 65 20 63 6f 6d 70  * Write the comp
d420: 61 72 69 73 6f 6e 20 72 65 73 75 6c 74 20 68 65  arison result he
d430: 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 36 34 20 6e  re */.){.  i64 n
d440: 43 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74 20 72  CellKey;.  int r
d450: 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70  c;.  BtCursor *p
d460: 43 75 72 20 3d 20 70 43 2d 3e 70 43 75 72 73 6f  Cur = pC->pCurso
d470: 72 3b 0a 20 20 69 6e 74 20 6c 65 6e 52 6f 77 69  r;.  int lenRowi
d480: 64 3b 0a 20 20 4d 65 6d 20 6d 3b 0a 0a 20 20 73  d;.  Mem m;..  s
d490: 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79 53 69  qlite3BtreeKeySi
d4a0: 7a 65 28 70 43 75 72 2c 20 26 6e 43 65 6c 6c 4b  ze(pCur, &nCellK
d4b0: 65 79 29 3b 0a 20 20 69 66 28 20 6e 43 65 6c 6c  ey);.  if( nCell
d4c0: 4b 65 79 3c 3d 30 20 29 7b 0a 20 20 20 20 2a 72  Key<=0 ){.    *r
d4d0: 65 73 20 3d 20 30 3b 0a 20 20 20 20 72 65 74 75  es = 0;.    retu
d4e0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
d4f0: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  }.  rc = sqlite3
d500: 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65 65  VdbeMemFromBtree
d510: 28 70 43 2d 3e 70 43 75 72 73 6f 72 2c 20 30 2c  (pC->pCursor, 0,
d520: 20 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d   nCellKey, 1, &m
d530: 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20  );.  if( rc ){. 
d540: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
d550: 7d 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20 73  }.  lenRowid = s
d560: 71 6c 69 74 65 33 56 64 62 65 49 64 78 52 6f 77  qlite3VdbeIdxRow
d570: 69 64 4c 65 6e 28 6d 2e 6e 2c 20 6d 2e 7a 29 3b  idLen(m.n, m.z);
d580: 0a 20 20 2a 72 65 73 20 3d 20 73 71 6c 69 74 65  .  *res = sqlite
d590: 33 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61  3VdbeRecordCompa
d5a0: 72 65 28 70 43 2d 3e 70 4b 65 79 49 6e 66 6f 2c  re(pC->pKeyInfo,
d5b0: 20 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 2c 20 6d   m.n-lenRowid, m
d5c0: 2e 7a 2c 20 6e 4b 65 79 2c 20 70 4b 65 79 29 3b  .z, nKey, pKey);
d5d0: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
d5e0: 6d 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20  mRelease(&m);.  
d5f0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
d600: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
d610: 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65  routine sets the
d620: 20 76 61 6c 75 65 20 74 6f 20 62 65 20 72 65 74   value to be ret
d630: 75 72 6e 65 64 20 62 79 20 73 75 62 73 65 71 75  urned by subsequ
d640: 65 6e 74 20 63 61 6c 6c 73 20 74 6f 0a 2a 2a 20  ent calls to.** 
d650: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 28  sqlite3_changes(
d660: 29 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73  ) on the databas
d670: 65 20 68 61 6e 64 6c 65 20 27 64 62 27 2e 20 0a  e handle 'db'. .
d680: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
d690: 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 73 71  dbeSetChanges(sq
d6a0: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6e  lite3 *db, int n
d6b0: 43 68 61 6e 67 65 29 7b 0a 20 20 64 62 2d 3e 6e  Change){.  db->n
d6c0: 43 68 61 6e 67 65 20 3d 20 6e 43 68 61 6e 67 65  Change = nChange
d6d0: 3b 0a 20 20 64 62 2d 3e 6e 54 6f 74 61 6c 43 68  ;.  db->nTotalCh
d6e0: 61 6e 67 65 20 2b 3d 20 6e 43 68 61 6e 67 65 3b  ange += nChange;
d6f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 61 20  .}../*.** Set a 
d700: 66 6c 61 67 20 69 6e 20 74 68 65 20 76 64 62 65  flag in the vdbe
d710: 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 20 63   to update the c
d720: 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 77 68  hange counter wh
d730: 65 6e 20 69 74 20 69 73 20 66 69 6e 61 6c 69 73  en it is finalis
d740: 65 64 0a 2a 2a 20 6f 72 20 72 65 73 65 74 2e 0a  ed.** or reset..
d750: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
d760: 64 62 65 43 6f 75 6e 74 43 68 61 6e 67 65 73 28  dbeCountChanges(
d770: 56 64 62 65 20 2a 76 29 7b 0a 20 20 76 2d 3e 63  Vdbe *v){.  v->c
d780: 68 61 6e 67 65 43 6e 74 4f 6e 20 3d 20 31 3b 0a  hangeCntOn = 1;.
d790: 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 72 6b 20 65 76  }../*.** Mark ev
d7a0: 65 72 79 20 70 72 65 70 61 72 65 64 20 73 74 61  ery prepared sta
d7b0: 74 65 6d 65 6e 74 20 61 73 73 6f 63 69 61 74 65  tement associate
d7c0: 64 20 77 69 74 68 20 61 20 64 61 74 61 62 61 73  d with a databas
d7d0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20  e connection.** 
d7e0: 61 73 20 65 78 70 69 72 65 64 2e 0a 2a 2a 0a 2a  as expired..**.*
d7f0: 2a 20 41 6e 20 65 78 70 69 72 65 64 20 73 74 61  * An expired sta
d800: 74 65 6d 65 6e 74 20 6d 65 61 6e 73 20 74 68 61  tement means tha
d810: 74 20 72 65 63 6f 6d 70 69 6c 61 74 69 6f 6e 20  t recompilation 
d820: 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  of the statement
d830: 20 69 73 0a 2a 2a 20 72 65 63 6f 6d 6d 65 6e 64   is.** recommend
d840: 2e 20 20 53 74 61 74 65 6d 65 6e 74 73 20 65 78  .  Statements ex
d850: 70 69 72 65 20 77 68 65 6e 20 74 68 69 6e 67 73  pire when things
d860: 20 68 61 70 70 65 6e 20 74 68 61 74 20 6d 61 6b   happen that mak
d870: 65 20 74 68 65 69 72 0a 2a 2a 20 70 72 6f 67 72  e their.** progr
d880: 61 6d 73 20 6f 62 73 6f 6c 65 74 65 2e 20 20 52  ams obsolete.  R
d890: 65 6d 6f 76 69 6e 67 20 75 73 65 72 2d 64 65 66  emoving user-def
d8a0: 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 6f  ined functions o
d8b0: 72 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a 2a 20 73  r collating.** s
d8c0: 65 71 75 65 6e 63 65 73 2c 20 6f 72 20 63 68 61  equences, or cha
d8d0: 6e 67 69 6e 67 20 61 6e 20 61 75 74 68 6f 72 69  nging an authori
d8e0: 7a 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 20  zation function 
d8f0: 61 72 65 20 74 68 65 20 74 79 70 65 73 20 6f 66  are the types of
d900: 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 74 20  .** things that 
d910: 6d 61 6b 65 20 70 72 65 70 61 72 65 64 20 73 74  make prepared st
d920: 61 74 65 6d 65 6e 74 73 20 6f 62 73 6f 6c 65 74  atements obsolet
d930: 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  e..*/.void sqlit
d940: 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 64  e3ExpirePrepared
d950: 53 74 61 74 65 6d 65 6e 74 73 28 73 71 6c 69 74  Statements(sqlit
d960: 65 33 20 2a 64 62 29 7b 0a 20 20 56 64 62 65 20  e3 *db){.  Vdbe 
d970: 2a 70 3b 0a 20 20 66 6f 72 28 70 20 3d 20 64 62  *p;.  for(p = db
d980: 2d 3e 70 56 64 62 65 3b 20 70 3b 20 70 3d 70 2d  ->pVdbe; p; p=p-
d990: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 2d 3e  >pNext){.    p->
d9a0: 65 78 70 69 72 65 64 20 3d 20 31 3b 0a 20 20 7d  expired = 1;.  }
d9b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
d9c0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61 73   the database as
d9d0: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68  sociated with th
d9e0: 65 20 56 64 62 65 2e 0a 2a 2f 0a 73 71 6c 69 74  e Vdbe..*/.sqlit
d9f0: 65 33 20 2a 73 71 6c 69 74 65 33 56 64 62 65 44  e3 *sqlite3VdbeD
da00: 62 28 56 64 62 65 20 2a 76 29 7b 0a 20 20 72 65  b(Vdbe *v){.  re
da10: 74 75 72 6e 20 76 2d 3e 64 62 3b 0a 7d 0a        turn v->db;.}.