/ Hex Artifact Content
Login

Artifact 77dc2e0f8e846269c51342134f3c9720f51707e6:


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 4b 45 59 49  ** If n==P3_KEYI
25b0: 4e 46 4f 20 69 74 20 6d 65 61 6e 73 20 74 68 61  NFO 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 4b 65 79 49 6e 66 6f 20  er to a KeyInfo 
25e0: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 20 41 20  structure..** A 
25f0: 63 6f 70 79 20 69 73 20 6d 61 64 65 20 6f 66 20  copy is made of 
2600: 74 68 65 20 4b 65 79 49 6e 66 6f 20 73 74 72 75  the KeyInfo stru
2610: 63 74 75 72 65 20 69 6e 74 6f 20 6d 65 6d 6f 72  cture into memor
2620: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a  y obtained from.
2630: 2a 2a 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 2c  ** sqliteMalloc,
2640: 20 74 6f 20 62 65 20 66 72 65 65 64 20 77 68 65   to be freed whe
2650: 6e 20 74 68 65 20 56 64 62 65 20 69 73 20 66 69  n the Vdbe is fi
2660: 6e 61 6c 69 7a 65 64 2e 0a 2a 2a 20 6e 3d 3d 50  nalized..** n==P
2670: 33 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46  3_KEYINFO_HANDOF
2680: 46 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74  F indicates that
2690: 20 7a 50 33 20 70 6f 69 6e 74 73 20 74 6f 20 61   zP3 points to a
26a0: 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75   KeyInfo structu
26b0: 72 65 0a 2a 2a 20 73 74 6f 72 65 64 20 69 6e 20  re.** stored in 
26c0: 6d 65 6d 6f 72 79 20 74 68 61 74 20 74 68 65 20  memory that the 
26d0: 63 61 6c 6c 65 72 20 68 61 73 20 6f 62 74 61 69  caller has obtai
26e0: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  ned from sqliteM
26f0: 61 6c 6c 6f 63 2e 20 54 68 65 20 0a 2a 2a 20 63  alloc. The .** c
2700: 61 6c 6c 65 72 20 73 68 6f 75 6c 64 20 6e 6f 74  aller should not
2710: 20 66 72 65 65 20 74 68 65 20 61 6c 6c 6f 63 61   free the alloca
2720: 74 69 6f 6e 2c 20 69 74 20 77 69 6c 6c 20 62 65  tion, it will be
2730: 20 66 72 65 65 64 20 77 68 65 6e 20 74 68 65 20   freed when the 
2740: 56 64 62 65 20 69 73 0a 2a 2a 20 66 69 6e 61 6c  Vdbe is.** final
2750: 69 7a 65 64 2e 0a 2a 2a 20 0a 2a 2a 20 4f 74 68  ized..** .** Oth
2760: 65 72 20 76 61 6c 75 65 73 20 6f 66 20 6e 20 28  er values of n (
2770: 50 33 5f 53 54 41 54 49 43 2c 20 50 33 5f 43 4f  P3_STATIC, P3_CO
2780: 4c 4c 53 45 51 20 65 74 63 2e 29 20 69 6e 64 69  LLSEQ etc.) indi
2790: 63 61 74 65 20 74 68 61 74 20 7a 50 33 20 70 6f  cate that zP3 po
27a0: 69 6e 74 73 0a 2a 2a 20 74 6f 20 61 20 73 74 72  ints.** to a str
27b0: 69 6e 67 20 6f 72 20 73 74 72 75 63 74 75 72 65  ing or structure
27c0: 20 74 68 61 74 20 69 73 20 67 75 61 72 61 6e 74   that is guarant
27d0: 65 65 64 20 74 6f 20 65 78 69 73 74 20 66 6f 72  eed to exist for
27e0: 20 74 68 65 20 6c 69 66 65 74 69 6d 65 20 6f 66   the lifetime of
27f0: 0a 2a 2a 20 74 68 65 20 56 64 62 65 2e 20 49 6e  .** the Vdbe. In
2800: 20 74 68 65 73 65 20 63 61 73 65 73 20 77 65 20   these cases we 
2810: 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74 68  can just copy th
2820: 65 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a  e pointer..**.**
2830: 20 49 66 20 61 64 64 72 3c 30 20 74 68 65 6e 20   If addr<0 then 
2840: 63 68 61 6e 67 65 20 50 33 20 6f 6e 20 74 68 65  change P3 on the
2850: 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 69   most recently i
2860: 6e 73 65 72 74 65 64 20 69 6e 73 74 72 75 63 74  nserted instruct
2870: 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ion..*/.void sql
2880: 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 33  ite3VdbeChangeP3
2890: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64  (Vdbe *p, int ad
28a0: 64 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  dr, const char *
28b0: 7a 50 33 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 4f  zP3, int n){.  O
28c0: 70 20 2a 70 4f 70 3b 0a 20 20 61 73 73 65 72 74  p *pOp;.  assert
28d0: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
28e0: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
28f0: 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e   if( p==0 || p->
2900: 61 4f 70 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66  aOp==0 ){.    if
2910: 28 20 6e 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20  ( n==P3_DYNAMIC 
2920: 7c 7c 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f  || n==P3_KEYINFO
2930: 5f 48 41 4e 44 4f 46 46 20 29 7b 0a 20 20 20 20  _HANDOFF ){.    
2940: 20 20 73 71 6c 69 74 65 46 72 65 65 28 28 76 6f    sqliteFree((vo
2950: 69 64 2a 29 7a 50 33 29 3b 0a 20 20 20 20 7d 0a  id*)zP3);.    }.
2960: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a      return;.  }.
2970: 20 20 69 66 28 20 61 64 64 72 3c 30 20 7c 7c 20    if( addr<0 || 
2980: 61 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a  addr>=p->nOp ){.
2990: 20 20 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f      addr = p->nO
29a0: 70 20 2d 20 31 3b 0a 20 20 20 20 69 66 28 20 61  p - 1;.    if( a
29b0: 64 64 72 3c 30 20 29 20 72 65 74 75 72 6e 3b 0a  ddr<0 ) return;.
29c0: 20 20 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e    }.  pOp = &p->
29d0: 61 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 69 66 28  aOp[addr];.  if(
29e0: 20 70 4f 70 2d 3e 70 33 20 26 26 20 70 4f 70 2d   pOp->p3 && pOp-
29f0: 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e 41  >p3type==P3_DYNA
2a00: 4d 49 43 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  MIC ){.    sqlit
2a10: 65 46 72 65 65 28 70 4f 70 2d 3e 70 33 29 3b 0a  eFree(pOp->p3);.
2a20: 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 30 3b      pOp->p3 = 0;
2a30: 0a 20 20 7d 0a 20 20 69 66 28 20 7a 50 33 3d 3d  .  }.  if( zP3==
2a40: 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70 33  0 ){.    pOp->p3
2a50: 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70 2d 3e 70   = 0;.    pOp->p
2a60: 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53  3type = P3_NOTUS
2a70: 45 44 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  ED;.  }else if( 
2a80: 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 29 7b  n==P3_KEYINFO ){
2a90: 0a 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b  .    KeyInfo *pK
2aa0: 65 79 49 6e 66 6f 3b 0a 20 20 20 20 69 6e 74 20  eyInfo;.    int 
2ab0: 6e 46 69 65 6c 64 2c 20 6e 42 79 74 65 3b 0a 20  nField, nByte;. 
2ac0: 20 20 20 6e 46 69 65 6c 64 20 3d 20 28 28 4b 65     nField = ((Ke
2ad0: 79 49 6e 66 6f 2a 29 7a 50 33 29 2d 3e 6e 46 69  yInfo*)zP3)->nFi
2ae0: 65 6c 64 3b 0a 20 20 20 20 6e 42 79 74 65 20 3d  eld;.    nByte =
2af0: 20 73 69 7a 65 6f 66 28 2a 70 4b 65 79 49 6e 66   sizeof(*pKeyInf
2b00: 6f 29 20 2b 20 28 6e 46 69 65 6c 64 2d 31 29 2a  o) + (nField-1)*
2b10: 73 69 7a 65 6f 66 28 70 4b 65 79 49 6e 66 6f 2d  sizeof(pKeyInfo-
2b20: 3e 61 43 6f 6c 6c 5b 30 5d 29 3b 0a 20 20 20 20  >aColl[0]);.    
2b30: 70 4b 65 79 49 6e 66 6f 20 3d 20 73 71 6c 69 74  pKeyInfo = sqlit
2b40: 65 4d 61 6c 6c 6f 63 52 61 77 28 20 6e 42 79 74  eMallocRaw( nByt
2b50: 65 20 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33  e );.    pOp->p3
2b60: 20 3d 20 28 63 68 61 72 2a 29 70 4b 65 79 49 6e   = (char*)pKeyIn
2b70: 66 6f 3b 0a 20 20 20 20 69 66 28 20 70 4b 65 79  fo;.    if( pKey
2b80: 49 6e 66 6f 20 29 7b 0a 20 20 20 20 20 20 6d 65  Info ){.      me
2b90: 6d 63 70 79 28 70 4b 65 79 49 6e 66 6f 2c 20 7a  mcpy(pKeyInfo, z
2ba0: 50 33 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20  P3, nByte);.    
2bb0: 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20    pOp->p3type = 
2bc0: 50 33 5f 4b 45 59 49 4e 46 4f 3b 0a 20 20 20 20  P3_KEYINFO;.    
2bd0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4f 70  }else{.      pOp
2be0: 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f  ->p3type = P3_NO
2bf0: 54 55 53 45 44 3b 0a 20 20 20 20 7d 0a 20 20 7d  TUSED;.    }.  }
2c00: 65 6c 73 65 20 69 66 28 20 6e 3d 3d 50 33 5f 4b  else if( n==P3_K
2c10: 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46 46 20 29  EYINFO_HANDOFF )
2c20: 7b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20  {.    pOp->p3 = 
2c30: 28 63 68 61 72 2a 29 7a 50 33 3b 0a 20 20 20 20  (char*)zP3;.    
2c40: 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33  pOp->p3type = P3
2c50: 5f 4b 45 59 49 4e 46 4f 3b 0a 20 20 7d 65 6c 73  _KEYINFO;.  }els
2c60: 65 20 69 66 28 20 6e 3c 30 20 29 7b 0a 20 20 20  e if( n<0 ){.   
2c70: 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63 68 61 72   pOp->p3 = (char
2c80: 2a 29 7a 50 33 3b 0a 20 20 20 20 70 4f 70 2d 3e  *)zP3;.    pOp->
2c90: 70 33 74 79 70 65 20 3d 20 6e 3b 0a 20 20 7d 65  p3type = n;.  }e
2ca0: 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 6e 3d 3d  lse{.    if( n==
2cb0: 30 20 29 20 6e 20 3d 20 73 74 72 6c 65 6e 28 7a  0 ) n = strlen(z
2cc0: 50 33 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33  P3);.    pOp->p3
2cd0: 20 3d 20 73 71 6c 69 74 65 53 74 72 4e 44 75 70   = sqliteStrNDup
2ce0: 28 7a 50 33 2c 20 6e 29 3b 0a 20 20 20 20 70 4f  (zP3, n);.    pO
2cf0: 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 44  p->p3type = P3_D
2d00: 59 4e 41 4d 49 43 3b 0a 20 20 7d 0a 7d 0a 0a 23  YNAMIC;.  }.}..#
2d10: 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 2f 2a  ifndef NDEBUG./*
2d20: 0a 2a 2a 20 52 65 70 6c 61 63 65 20 74 68 65 20  .** Replace the 
2d30: 50 33 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20  P3 field of the 
2d40: 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 63 6f  most recently co
2d50: 64 65 64 20 69 6e 73 74 72 75 63 74 69 6f 6e 20  ded instruction 
2d60: 77 69 74 68 0a 2a 2a 20 63 6f 6d 6d 65 6e 74 20  with.** comment 
2d70: 74 65 78 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  text..*/.void sq
2d80: 6c 69 74 65 33 56 64 62 65 43 6f 6d 6d 65 6e 74  lite3VdbeComment
2d90: 28 56 64 62 65 20 2a 70 2c 20 63 6f 6e 73 74 20  (Vdbe *p, const 
2da0: 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74 2c 20 2e  char *zFormat, .
2db0: 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61  ..){.  va_list a
2dc0: 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  p;.  assert( p->
2dd0: 6e 4f 70 3e 30 20 29 3b 0a 20 20 61 73 73 65 72  nOp>0 );.  asser
2de0: 74 28 20 70 2d 3e 61 4f 70 3d 3d 30 20 7c 7c 20  t( p->aOp==0 || 
2df0: 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d  p->aOp[p->nOp-1]
2e00: 2e 70 33 3d 3d 30 20 29 3b 0a 20 20 76 61 5f 73  .p3==0 );.  va_s
2e10: 74 61 72 74 28 61 70 2c 20 7a 46 6f 72 6d 61 74  tart(ap, zFormat
2e20: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
2e30: 43 68 61 6e 67 65 50 33 28 70 2c 20 2d 31 2c 20  ChangeP3(p, -1, 
2e40: 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74 66 28  sqlite3VMPrintf(
2e50: 7a 46 6f 72 6d 61 74 2c 20 61 70 29 2c 20 50 33  zFormat, ap), P3
2e60: 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20 76 61 5f  _DYNAMIC);.  va_
2e70: 65 6e 64 28 61 70 29 3b 0a 7d 0a 23 65 6e 64 69  end(ap);.}.#endi
2e80: 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20  f../*.** If the 
2e90: 50 33 20 6f 70 65 72 61 6e 64 20 74 6f 20 74 68  P3 operand to th
2ea0: 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 73 74  e specified inst
2eb0: 72 75 63 74 69 6f 6e 20 61 70 70 65 61 72 73 0a  ruction appears.
2ec0: 2a 2a 20 74 6f 20 62 65 20 61 20 71 75 6f 74 65  ** to be a quote
2ed0: 64 20 73 74 72 69 6e 67 20 74 6f 6b 65 6e 2c 20  d string token, 
2ee0: 74 68 65 6e 20 74 68 69 73 20 70 72 6f 63 65 64  then this proced
2ef0: 75 72 65 20 72 65 6d 6f 76 65 73 20 0a 2a 2a 20  ure removes .** 
2f00: 74 68 65 20 71 75 6f 74 65 73 2e 0a 2a 2a 0a 2a  the quotes..**.*
2f10: 2a 20 54 68 65 20 71 75 6f 74 69 6e 67 20 6f 70  * The quoting op
2f20: 65 72 61 74 6f 72 20 63 61 6e 20 62 65 20 65 69  erator can be ei
2f30: 74 68 65 72 20 61 20 67 72 61 76 65 20 61 73 63  ther a grave asc
2f40: 65 6e 74 20 28 41 53 43 49 49 20 30 78 32 37 29  ent (ASCII 0x27)
2f50: 0a 2a 2a 20 6f 72 20 61 20 64 6f 75 62 6c 65 20  .** or a double 
2f60: 71 75 6f 74 65 20 63 68 61 72 61 63 74 65 72 20  quote character 
2f70: 28 41 53 43 49 49 20 30 78 32 32 29 2e 20 20 54  (ASCII 0x22).  T
2f80: 77 6f 20 71 75 6f 74 65 73 20 69 6e 20 61 20 72  wo quotes in a r
2f90: 6f 77 0a 2a 2a 20 72 65 73 6f 6c 76 65 20 74 6f  ow.** resolve to
2fa0: 20 62 65 20 61 20 73 69 6e 67 6c 65 20 61 63 74   be a single act
2fb0: 75 61 6c 20 71 75 6f 74 65 20 63 68 61 72 61 63  ual quote charac
2fc0: 74 65 72 20 77 69 74 68 69 6e 20 74 68 65 20 73  ter within the s
2fd0: 74 72 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73  tring..*/.void s
2fe0: 71 6c 69 74 65 33 56 64 62 65 44 65 71 75 6f 74  qlite3VdbeDequot
2ff0: 65 50 33 28 56 64 62 65 20 2a 70 2c 20 69 6e 74  eP3(Vdbe *p, int
3000: 20 61 64 64 72 29 7b 0a 20 20 4f 70 20 2a 70 4f   addr){.  Op *pO
3010: 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  p;.  assert( p->
3020: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
3030: 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66 28 20  C_INIT );.  if( 
3040: 70 2d 3e 61 4f 70 3d 3d 30 20 29 20 72 65 74 75  p->aOp==0 ) retu
3050: 72 6e 3b 0a 20 20 69 66 28 20 61 64 64 72 3c 30  rn;.  if( addr<0
3060: 20 7c 7c 20 61 64 64 72 3e 3d 70 2d 3e 6e 4f 70   || addr>=p->nOp
3070: 20 29 7b 0a 20 20 20 20 61 64 64 72 20 3d 20 70   ){.    addr = p
3080: 2d 3e 6e 4f 70 20 2d 20 31 3b 0a 20 20 20 20 69  ->nOp - 1;.    i
3090: 66 28 20 61 64 64 72 3c 30 20 29 20 72 65 74 75  f( addr<0 ) retu
30a0: 72 6e 3b 0a 20 20 7d 0a 20 20 70 4f 70 20 3d 20  rn;.  }.  pOp = 
30b0: 26 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 20  &p->aOp[addr];. 
30c0: 20 69 66 28 20 70 4f 70 2d 3e 70 33 3d 3d 30 20   if( pOp->p3==0 
30d0: 7c 7c 20 70 4f 70 2d 3e 70 33 5b 30 5d 3d 3d 30  || pOp->p3[0]==0
30e0: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 69 66 28   ) return;.  if(
30f0: 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33   pOp->p3type==P3
3100: 5f 53 54 41 54 49 43 20 29 7b 0a 20 20 20 20 70  _STATIC ){.    p
3110: 4f 70 2d 3e 70 33 20 3d 20 73 71 6c 69 74 65 53  Op->p3 = sqliteS
3120: 74 72 44 75 70 28 70 4f 70 2d 3e 70 33 29 3b 0a  trDup(pOp->p3);.
3130: 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20      pOp->p3type 
3140: 3d 20 50 33 5f 44 59 4e 41 4d 49 43 3b 0a 20 20  = P3_DYNAMIC;.  
3150: 7d 0a 20 20 61 73 73 65 72 74 28 20 70 4f 70 2d  }.  assert( pOp-
3160: 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e 41  >p3type==P3_DYNA
3170: 4d 49 43 20 29 3b 0a 20 20 73 71 6c 69 74 65 33  MIC );.  sqlite3
3180: 44 65 71 75 6f 74 65 28 70 4f 70 2d 3e 70 33 29  Dequote(pOp->p3)
3190: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 61 72 63  ;.}../*.** Searc
31a0: 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72  h the current pr
31b0: 6f 67 72 61 6d 20 73 74 61 72 74 69 6e 67 20 61  ogram starting a
31c0: 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 61 64  t instruction ad
31d0: 64 72 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e  dr for the given
31e0: 0a 2a 2a 20 6f 70 63 6f 64 65 20 61 6e 64 20 50  .** opcode and P
31f0: 32 20 76 61 6c 75 65 2e 20 20 52 65 74 75 72 6e  2 value.  Return
3200: 20 74 68 65 20 61 64 64 72 65 73 73 20 70 6c 75   the address plu
3210: 73 20 31 20 69 66 20 66 6f 75 6e 64 20 61 6e 64  s 1 if found and
3220: 20 30 20 69 66 20 6e 6f 74 0a 2a 2a 20 66 6f 75   0 if not.** fou
3230: 6e 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  nd..*/.int sqlit
3240: 65 33 56 64 62 65 46 69 6e 64 4f 70 28 56 64 62  e3VdbeFindOp(Vdb
3250: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20  e *p, int addr, 
3260: 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70 32 29 7b  int op, int p2){
3270: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 61 73 73 65  .  int i;.  asse
3280: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
3290: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
32a0: 0a 20 20 66 6f 72 28 69 3d 61 64 64 72 3b 20 69  .  for(i=addr; i
32b0: 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20  <p->nOp; i++){. 
32c0: 20 20 20 69 66 28 20 70 2d 3e 61 4f 70 5b 69 5d     if( p->aOp[i]
32d0: 2e 6f 70 63 6f 64 65 3d 3d 6f 70 20 26 26 20 70  .opcode==op && p
32e0: 2d 3e 61 4f 70 5b 69 5d 2e 70 32 3d 3d 70 32 20  ->aOp[i].p2==p2 
32f0: 29 20 72 65 74 75 72 6e 20 69 2b 31 3b 0a 20 20  ) return i+1;.  
3300: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
3310: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
3320: 65 20 6f 70 63 6f 64 65 20 66 6f 72 20 61 20 67  e opcode for a g
3330: 69 76 65 6e 20 61 64 64 72 65 73 73 2e 0a 2a 2f  iven address..*/
3340: 0a 56 64 62 65 4f 70 20 2a 73 71 6c 69 74 65 33  .VdbeOp *sqlite3
3350: 56 64 62 65 47 65 74 4f 70 28 56 64 62 65 20 2a  VdbeGetOp(Vdbe *
3360: 70 2c 20 69 6e 74 20 61 64 64 72 29 7b 0a 20 20  p, int addr){.  
3370: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
3380: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
3390: 54 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61  T );.  assert( a
33a0: 64 64 72 3e 3d 30 20 26 26 20 61 64 64 72 3c 70  ddr>=0 && addr<p
33b0: 2d 3e 6e 4f 70 20 29 3b 0a 20 20 72 65 74 75 72  ->nOp );.  retur
33c0: 6e 20 26 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 3b  n &p->aOp[addr];
33d0: 0a 7d 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64  .}..#if !defined
33e0: 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50  (SQLITE_OMIT_EXP
33f0: 4c 41 49 4e 29 20 7c 7c 20 21 64 65 66 69 6e 65  LAIN) || !define
3400: 64 28 4e 44 45 42 55 47 29 20 5c 0a 20 20 20 20  d(NDEBUG) \.    
3410: 20 7c 7c 20 64 65 66 69 6e 65 64 28 56 44 42 45   || defined(VDBE
3420: 5f 50 52 4f 46 49 4c 45 29 20 7c 7c 20 64 65 66  _PROFILE) || def
3430: 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55  ined(SQLITE_DEBU
3440: 47 29 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65  G)./*.** Compute
3450: 20 61 20 73 74 72 69 6e 67 20 74 68 61 74 20 64   a string that d
3460: 65 73 63 72 69 62 65 73 20 74 68 65 20 50 33 20  escribes the P3 
3470: 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 61 6e  parameter for an
3480: 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 55 73 65 20   opcode..** Use 
3490: 7a 54 65 6d 70 20 66 6f 72 20 61 6e 79 20 72 65  zTemp for any re
34a0: 71 75 69 72 65 64 20 74 65 6d 70 6f 72 61 72 79  quired temporary
34b0: 20 62 75 66 66 65 72 20 73 70 61 63 65 2e 0a 2a   buffer space..*
34c0: 2f 0a 73 74 61 74 69 63 20 63 68 61 72 20 2a 64  /.static char *d
34d0: 69 73 70 6c 61 79 50 33 28 4f 70 20 2a 70 4f 70  isplayP3(Op *pOp
34e0: 2c 20 63 68 61 72 20 2a 7a 54 65 6d 70 2c 20 69  , char *zTemp, i
34f0: 6e 74 20 6e 54 65 6d 70 29 7b 0a 20 20 63 68 61  nt nTemp){.  cha
3500: 72 20 2a 7a 50 33 3b 0a 20 20 61 73 73 65 72 74  r *zP3;.  assert
3510: 28 20 6e 54 65 6d 70 3e 3d 32 30 20 29 3b 0a 20  ( nTemp>=20 );. 
3520: 20 73 77 69 74 63 68 28 20 70 4f 70 2d 3e 70 33   switch( pOp->p3
3530: 74 79 70 65 20 29 7b 0a 20 20 20 20 63 61 73 65  type ){.    case
3540: 20 50 33 5f 4b 45 59 49 4e 46 4f 3a 20 7b 0a 20   P3_KEYINFO: {. 
3550: 20 20 20 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20       int i, j;. 
3560: 20 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b       KeyInfo *pK
3570: 65 79 49 6e 66 6f 20 3d 20 28 4b 65 79 49 6e 66  eyInfo = (KeyInf
3580: 6f 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20  o*)pOp->p3;.    
3590: 20 20 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c    sprintf(zTemp,
35a0: 20 22 6b 65 79 69 6e 66 6f 28 25 64 22 2c 20 70   "keyinfo(%d", p
35b0: 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 29  KeyInfo->nField)
35c0: 3b 0a 20 20 20 20 20 20 69 20 3d 20 73 74 72 6c  ;.      i = strl
35d0: 65 6e 28 7a 54 65 6d 70 29 3b 0a 20 20 20 20 20  en(zTemp);.     
35e0: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 4b 65 79   for(j=0; j<pKey
35f0: 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 3b 20 6a 2b  Info->nField; j+
3600: 2b 29 7b 0a 20 20 20 20 20 20 20 20 43 6f 6c 6c  +){.        Coll
3610: 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 70 4b 65  Seq *pColl = pKe
3620: 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 6a 5d 3b  yInfo->aColl[j];
3630: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 43 6f  .        if( pCo
3640: 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  ll ){.          
3650: 69 6e 74 20 6e 20 3d 20 73 74 72 6c 65 6e 28 70  int n = strlen(p
3660: 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20  Coll->zName);.  
3670: 20 20 20 20 20 20 20 20 69 66 28 20 69 2b 6e 3e          if( i+n>
3680: 6e 54 65 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20  nTemp-6 ){.     
3690: 20 20 20 20 20 20 20 73 74 72 63 70 79 28 26 7a         strcpy(&z
36a0: 54 65 6d 70 5b 69 5d 2c 22 2c 2e 2e 2e 22 29 3b  Temp[i],",...");
36b0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65  .            bre
36c0: 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  ak;.          }.
36d0: 20 20 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b            zTemp[
36e0: 69 2b 2b 5d 20 3d 20 27 2c 27 3b 0a 20 20 20 20  i++] = ',';.    
36f0: 20 20 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e        if( pKeyIn
3700: 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20 26  fo->aSortOrder &
3710: 26 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72  & pKeyInfo->aSor
3720: 74 4f 72 64 65 72 5b 6a 5d 20 29 7b 0a 20 20 20  tOrder[j] ){.   
3730: 20 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b 69           zTemp[i
3740: 2b 2b 5d 20 3d 20 27 2d 27 3b 0a 20 20 20 20 20  ++] = '-';.     
3750: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
3760: 20 73 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69   strcpy(&zTemp[i
3770: 5d 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29  ], pColl->zName)
3780: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 20 2b 3d  ;.          i +=
3790: 20 6e 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73   n;.        }els
37a0: 65 20 69 66 28 20 69 2b 34 3c 6e 54 65 6d 70 2d  e if( i+4<nTemp-
37b0: 36 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73  6 ){.          s
37c0: 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d 2c  trcpy(&zTemp[i],
37d0: 22 2c 6e 69 6c 22 29 3b 0a 20 20 20 20 20 20 20  ",nil");.       
37e0: 20 20 20 69 20 2b 3d 20 34 3b 0a 20 20 20 20 20     i += 4;.     
37f0: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
3800: 20 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20     zTemp[i++] = 
3810: 27 29 27 3b 0a 20 20 20 20 20 20 7a 54 65 6d 70  ')';.      zTemp
3820: 5b 69 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 61  [i] = 0;.      a
3830: 73 73 65 72 74 28 20 69 3c 6e 54 65 6d 70 20 29  ssert( i<nTemp )
3840: 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54  ;.      zP3 = zT
3850: 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  emp;.      break
3860: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
3870: 20 50 33 5f 43 4f 4c 4c 53 45 51 3a 20 7b 0a 20   P3_COLLSEQ: {. 
3880: 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43       CollSeq *pC
3890: 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 2a 29  oll = (CollSeq*)
38a0: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 73  pOp->p3;.      s
38b0: 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22 63  printf(zTemp, "c
38c0: 6f 6c 6c 73 65 71 28 25 2e 32 30 73 29 22 2c 20  ollseq(%.20s)", 
38d0: 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20  pColl->zName);. 
38e0: 20 20 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70       zP3 = zTemp
38f0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;.      break;. 
3900: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 50 33     }.    case P3
3910: 5f 46 55 4e 43 44 45 46 3a 20 7b 0a 20 20 20 20  _FUNCDEF: {.    
3920: 20 20 46 75 6e 63 44 65 66 20 2a 70 44 65 66 20    FuncDef *pDef 
3930: 3d 20 28 46 75 6e 63 44 65 66 2a 29 70 4f 70 2d  = (FuncDef*)pOp-
3940: 3e 70 33 3b 0a 20 20 20 20 20 20 63 68 61 72 20  >p3;.      char 
3950: 7a 4e 75 6d 5b 33 30 5d 3b 0a 20 20 20 20 20 20  zNum[30];.      
3960: 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22  sprintf(zTemp, "
3970: 25 2e 2a 73 22 2c 20 6e 54 65 6d 70 2c 20 70 44  %.*s", nTemp, pD
3980: 65 66 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20  ef->zName);.    
3990: 20 20 73 70 72 69 6e 74 66 28 7a 4e 75 6d 2c 22    sprintf(zNum,"
39a0: 28 25 64 29 22 2c 20 70 44 65 66 2d 3e 6e 41 72  (%d)", pDef->nAr
39b0: 67 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 74  g);.      if( st
39c0: 72 6c 65 6e 28 7a 54 65 6d 70 29 2b 73 74 72 6c  rlen(zTemp)+strl
39d0: 65 6e 28 7a 4e 75 6d 29 2b 31 3c 3d 6e 54 65 6d  en(zNum)+1<=nTem
39e0: 70 20 29 7b 0a 20 20 20 20 20 20 20 20 73 74 72  p ){.        str
39f0: 63 61 74 28 7a 54 65 6d 70 2c 20 7a 4e 75 6d 29  cat(zTemp, zNum)
3a00: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
3a10: 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20  zP3 = zTemp;.   
3a20: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
3a30: 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20      default: {. 
3a40: 20 20 20 20 20 7a 50 33 20 3d 20 70 4f 70 2d 3e       zP3 = pOp->
3a50: 70 33 3b 0a 20 20 20 20 20 20 69 66 28 20 7a 50  p3;.      if( zP
3a60: 33 3d 3d 30 20 7c 7c 20 70 4f 70 2d 3e 6f 70 63  3==0 || pOp->opc
3a70: 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a  ode==OP_Noop ){.
3a80: 20 20 20 20 20 20 20 20 7a 50 33 20 3d 20 22 22          zP3 = ""
3a90: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
3aa0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 50 33    }.  return zP3
3ab0: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66  ;.}.#endif...#if
3ac0: 20 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52   defined(VDBE_PR
3ad0: 4f 46 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e 65  OFILE) || define
3ae0: 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a  d(SQLITE_DEBUG).
3af0: 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 61 20 73 69  /*.** Print a si
3b00: 6e 67 6c 65 20 6f 70 63 6f 64 65 2e 20 20 54 68  ngle opcode.  Th
3b10: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73  is routine is us
3b20: 65 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67  ed for debugging
3b30: 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73   only..*/.void s
3b40: 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f  qlite3VdbePrintO
3b50: 70 28 46 49 4c 45 20 2a 70 4f 75 74 2c 20 69 6e  p(FILE *pOut, in
3b60: 74 20 70 63 2c 20 4f 70 20 2a 70 4f 70 29 7b 0a  t pc, Op *pOp){.
3b70: 20 20 63 68 61 72 20 2a 7a 50 33 3b 0a 20 20 63    char *zP3;.  c
3b80: 68 61 72 20 7a 50 74 72 5b 35 30 5d 3b 0a 20 20  har zPtr[50];.  
3b90: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61  static const cha
3ba0: 72 20 2a 7a 46 6f 72 6d 61 74 31 20 3d 20 22 25  r *zFormat1 = "%
3bb0: 34 64 20 25 2d 31 33 73 20 25 34 64 20 25 34 64  4d %-13s %4d %4d
3bc0: 20 25 73 5c 6e 22 3b 0a 20 20 69 66 28 20 70 4f   %s\n";.  if( pO
3bd0: 75 74 3d 3d 30 20 29 20 70 4f 75 74 20 3d 20 73  ut==0 ) pOut = s
3be0: 74 64 6f 75 74 3b 0a 20 20 7a 50 33 20 3d 20 64  tdout;.  zP3 = d
3bf0: 69 73 70 6c 61 79 50 33 28 70 4f 70 2c 20 7a 50  isplayP3(pOp, zP
3c00: 74 72 2c 20 73 69 7a 65 6f 66 28 7a 50 74 72 29  tr, sizeof(zPtr)
3c10: 29 3b 0a 20 20 66 70 72 69 6e 74 66 28 70 4f 75  );.  fprintf(pOu
3c20: 74 2c 20 7a 46 6f 72 6d 61 74 31 2c 0a 20 20 20  t, zFormat1,.   
3c30: 20 20 20 70 63 2c 20 73 71 6c 69 74 65 33 4f 70     pc, sqlite3Op
3c40: 63 6f 64 65 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f  codeNames[pOp->o
3c50: 70 63 6f 64 65 5d 2c 20 70 4f 70 2d 3e 70 31 2c  pcode], pOp->p1,
3c60: 20 70 4f 70 2d 3e 70 32 2c 20 7a 50 33 29 3b 0a   pOp->p2, zP3);.
3c70: 20 20 66 66 6c 75 73 68 28 70 4f 75 74 29 3b 0a    fflush(pOut);.
3c80: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  }.#endif../*.** 
3c90: 52 65 6c 65 61 73 65 20 61 6e 20 61 72 72 61 79  Release an array
3ca0: 20 6f 66 20 4e 20 4d 65 6d 20 65 6c 65 6d 65 6e   of N Mem elemen
3cb0: 74 73 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  ts.*/.static voi
3cc0: 64 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61  d releaseMemArra
3cd0: 79 28 4d 65 6d 20 2a 70 2c 20 69 6e 74 20 4e 29  y(Mem *p, int N)
3ce0: 7b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20  {.  if( p ){.   
3cf0: 20 77 68 69 6c 65 28 20 4e 2d 2d 3e 30 20 29 7b   while( N-->0 ){
3d00: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
3d10: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 70 2b 2b  beMemRelease(p++
3d20: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a  );.    }.  }.}..
3d30: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
3d40: 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 2f 2a 0a 2a  MIT_EXPLAIN./*.*
3d50: 2a 20 47 69 76 65 20 61 20 6c 69 73 74 69 6e 67  * Give a listing
3d60: 20 6f 66 20 74 68 65 20 70 72 6f 67 72 61 6d 20   of the program 
3d70: 69 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d  in the virtual m
3d80: 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  achine..**.** Th
3d90: 65 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 74  e interface is t
3da0: 68 65 20 73 61 6d 65 20 61 73 20 73 71 6c 69 74  he same as sqlit
3db0: 65 33 56 64 62 65 45 78 65 63 28 29 2e 20 20 42  e3VdbeExec().  B
3dc0: 75 74 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a  ut instead of.**
3dd0: 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 63 6f 64   running the cod
3de0: 65 2c 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68  e, it invokes th
3df0: 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20  e callback once 
3e00: 66 6f 72 20 65 61 63 68 20 69 6e 73 74 72 75 63  for each instruc
3e10: 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 66 65  tion..** This fe
3e20: 61 74 75 72 65 20 69 73 20 75 73 65 64 20 74 6f  ature is used to
3e30: 20 69 6d 70 6c 65 6d 65 6e 74 20 22 45 58 50 4c   implement "EXPL
3e40: 41 49 4e 22 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  AIN"..*/.int sql
3e50: 69 74 65 33 56 64 62 65 4c 69 73 74 28 0a 20 20  ite3VdbeList(.  
3e60: 56 64 62 65 20 2a 70 20 20 20 20 20 20 20 20 20  Vdbe *p         
3e70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
3e80: 20 56 44 42 45 20 2a 2f 0a 29 7b 0a 20 20 73 71   VDBE */.){.  sq
3e90: 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64  lite3 *db = p->d
3ea0: 62 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e  b;.  int i;.  in
3eb0: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
3ec0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  ;..  assert( p->
3ed0: 65 78 70 6c 61 69 6e 20 29 3b 0a 20 20 69 66 28  explain );.  if(
3ee0: 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f   p->magic!=VDBE_
3ef0: 4d 41 47 49 43 5f 52 55 4e 20 29 20 72 65 74 75  MAGIC_RUN ) retu
3f00: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
3f10: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e  ;.  assert( db->
3f20: 6d 61 67 69 63 3d 3d 53 51 4c 49 54 45 5f 4d 41  magic==SQLITE_MA
3f30: 47 49 43 5f 42 55 53 59 20 29 3b 0a 20 20 61 73  GIC_BUSY );.  as
3f40: 73 65 72 74 28 20 70 2d 3e 72 63 3d 3d 53 51 4c  sert( p->rc==SQL
3f50: 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 72 63 3d  ITE_OK || p->rc=
3f60: 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29 3b 0a  =SQLITE_BUSY );.
3f70: 0a 20 20 2f 2a 20 45 76 65 6e 20 74 68 6f 75 67  .  /* Even thoug
3f80: 68 20 74 68 69 73 20 6f 70 63 6f 64 65 20 64 6f  h this opcode do
3f90: 65 73 20 6e 6f 74 20 70 75 74 20 64 79 6e 61 6d  es not put dynam
3fa0: 69 63 20 73 74 72 69 6e 67 73 20 6f 6e 74 6f 20  ic strings onto 
3fb0: 74 68 65 0a 20 20 2a 2a 20 74 68 65 20 73 74 61  the.  ** the sta
3fc0: 63 6b 2c 20 74 68 65 79 20 6d 61 79 20 62 65 63  ck, they may bec
3fd0: 6f 6d 65 20 64 79 6e 61 6d 69 63 20 69 66 20 74  ome dynamic if t
3fe0: 68 65 20 75 73 65 72 20 63 61 6c 6c 73 0a 20 20  he user calls.  
3ff0: 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  ** sqlite3_colum
4000: 6e 5f 74 65 78 74 31 36 28 29 2c 20 63 61 75 73  n_text16(), caus
4010: 69 6e 67 20 61 20 74 72 61 6e 73 6c 61 74 69 6f  ing a translatio
4020: 6e 20 74 6f 20 55 54 46 2d 31 36 20 65 6e 63 6f  n to UTF-16 enco
4030: 64 69 6e 67 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ding..  */.  if(
4040: 20 70 2d 3e 70 54 6f 73 3d 3d 26 70 2d 3e 61 53   p->pTos==&p->aS
4050: 74 61 63 6b 5b 34 5d 20 29 7b 0a 20 20 20 20 72  tack[4] ){.    r
4060: 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70  eleaseMemArray(p
4070: 2d 3e 61 53 74 61 63 6b 2c 20 35 29 3b 0a 20 20  ->aStack, 5);.  
4080: 7d 0a 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61 63  }.  p->resOnStac
4090: 6b 20 3d 20 30 3b 0a 0a 0a 20 20 69 20 3d 20 70  k = 0;...  i = p
40a0: 2d 3e 70 63 2b 2b 3b 0a 20 20 69 66 28 20 69 3e  ->pc++;.  if( i>
40b0: 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20 20 20 70  =p->nOp ){.    p
40c0: 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  ->rc = SQLITE_OK
40d0: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ;.    rc = SQLIT
40e0: 45 5f 44 4f 4e 45 3b 0a 20 20 7d 65 6c 73 65 20  E_DONE;.  }else 
40f0: 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20  if( db->flags & 
4100: 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74  SQLITE_Interrupt
4110: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67   ){.    db->flag
4120: 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e 74  s &= ~SQLITE_Int
4130: 65 72 72 75 70 74 3b 0a 20 20 20 20 70 2d 3e 72  errupt;.    p->r
4140: 63 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45 52  c = SQLITE_INTER
4150: 52 55 50 54 3b 0a 20 20 20 20 72 63 20 3d 20 53  RUPT;.    rc = S
4160: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20  QLITE_ERROR;.   
4170: 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e   sqlite3SetStrin
4180: 67 28 26 70 2d 3e 7a 45 72 72 4d 73 67 2c 20 73  g(&p->zErrMsg, s
4190: 71 6c 69 74 65 33 45 72 72 53 74 72 28 70 2d 3e  qlite3ErrStr(p->
41a0: 72 63 29 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a  rc), (char*)0);.
41b0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 4f 70 20    }else{.    Op 
41c0: 2a 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69  *pOp = &p->aOp[i
41d0: 5d 3b 0a 20 20 20 20 4d 65 6d 20 2a 70 4d 65 6d  ];.    Mem *pMem
41e0: 20 3d 20 70 2d 3e 61 53 74 61 63 6b 3b 0a 20 20   = p->aStack;.  
41f0: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
4200: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70 4d 65  MEM_Int;.    pMe
4210: 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45  m->type = SQLITE
4220: 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70 4d  _INTEGER;.    pM
4230: 65 6d 2d 3e 69 20 3d 20 69 3b 20 20 20 20 20 20  em->i = i;      
4240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4250: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 6f            /* Pro
4260: 67 72 61 6d 20 63 6f 75 6e 74 65 72 20 2a 2f 0a  gram counter */.
4270: 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20      pMem++;..   
4280: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
4290: 45 4d 5f 53 74 61 74 69 63 7c 4d 45 4d 5f 53 74  EM_Static|MEM_St
42a0: 72 7c 4d 45 4d 5f 54 65 72 6d 3b 0a 20 20 20 20  r|MEM_Term;.    
42b0: 70 4d 65 6d 2d 3e 7a 20 3d 20 73 71 6c 69 74 65  pMem->z = sqlite
42c0: 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70 4f 70  3OpcodeNames[pOp
42d0: 2d 3e 6f 70 63 6f 64 65 5d 3b 20 20 2f 2a 20 4f  ->opcode];  /* O
42e0: 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 70 4d 65  pcode */.    pMe
42f0: 6d 2d 3e 6e 20 3d 20 73 74 72 6c 65 6e 28 70 4d  m->n = strlen(pM
4300: 65 6d 2d 3e 7a 29 3b 0a 20 20 20 20 70 4d 65 6d  em->z);.    pMem
4310: 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f  ->type = SQLITE_
4320: 54 45 58 54 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  TEXT;.    pMem->
4330: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46  enc = SQLITE_UTF
4340: 38 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a  8;.    pMem++;..
4350: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
4360: 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70  = MEM_Int;.    p
4370: 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70 2d 3e 70 31  Mem->i = pOp->p1
4380: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
4390: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 31             /* P1
43a0: 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79   */.    pMem->ty
43b0: 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45  pe = SQLITE_INTE
43c0: 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b  GER;.    pMem++;
43d0: 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67  ..    pMem->flag
43e0: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
43f0: 20 70 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70 2d 3e   pMem->i = pOp->
4400: 70 32 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  p2;             
4410: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4420: 50 32 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e  P2 */.    pMem->
4430: 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e  type = SQLITE_IN
4440: 54 45 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2b  TEGER;.    pMem+
4450: 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  +;..    pMem->fl
4460: 61 67 73 20 3d 20 4d 45 4d 5f 53 68 6f 72 74 7c  ags = MEM_Short|
4470: 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 54 65 72 6d  MEM_Str|MEM_Term
4480: 3b 20 20 20 2f 2a 20 50 33 20 2a 2f 0a 20 20 20  ;   /* P3 */.   
4490: 20 70 4d 65 6d 2d 3e 7a 20 3d 20 64 69 73 70 6c   pMem->z = displ
44a0: 61 79 50 33 28 70 4f 70 2c 20 70 4d 65 6d 2d 3e  ayP3(pOp, pMem->
44b0: 7a 53 68 6f 72 74 2c 20 73 69 7a 65 6f 66 28 70  zShort, sizeof(p
44c0: 4d 65 6d 2d 3e 7a 53 68 6f 72 74 29 29 3b 0a 20  Mem->zShort));. 
44d0: 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20     pMem->type = 
44e0: 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20 20 20  SQLITE_TEXT;.   
44f0: 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20 53 51 4c   pMem->enc = SQL
4500: 49 54 45 5f 55 54 46 38 3b 0a 0a 20 20 20 20 70  ITE_UTF8;..    p
4510: 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3d 20 35  ->nResColumn = 5
4520: 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d 20  ;.    p->pTos = 
4530: 70 4d 65 6d 3b 0a 20 20 20 20 70 2d 3e 72 63 20  pMem;.    p->rc 
4540: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20  = SQLITE_OK;.   
4550: 20 70 2d 3e 72 65 73 4f 6e 53 74 61 63 6b 20 3d   p->resOnStack =
4560: 20 31 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c   1;.    rc = SQL
4570: 49 54 45 5f 52 4f 57 3b 0a 20 20 7d 0a 20 20 72  ITE_ROW;.  }.  r
4580: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64  eturn rc;.}.#end
4590: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
45a0: 54 5f 45 58 50 4c 41 49 4e 20 2a 2f 0a 0a 2f 2a  T_EXPLAIN */../*
45b0: 0a 2a 2a 20 50 72 69 6e 74 20 74 68 65 20 53 51  .** Print the SQ
45c0: 4c 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20  L that was used 
45d0: 74 6f 20 67 65 6e 65 72 61 74 65 20 61 20 56 44  to generate a VD
45e0: 42 45 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 76  BE program..*/.v
45f0: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 50  oid sqlite3VdbeP
4600: 72 69 6e 74 53 71 6c 28 56 64 62 65 20 2a 70 29  rintSql(Vdbe *p)
4610: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  {.#ifdef SQLITE_
4620: 44 45 42 55 47 0a 20 20 69 6e 74 20 6e 4f 70 20  DEBUG.  int nOp 
4630: 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 56 64 62 65  = p->nOp;.  Vdbe
4640: 4f 70 20 2a 70 4f 70 3b 0a 20 20 69 66 28 20 6e  Op *pOp;.  if( n
4650: 4f 70 3c 31 20 29 20 72 65 74 75 72 6e 3b 0a 20  Op<1 ) return;. 
4660: 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 6e   pOp = &p->aOp[n
4670: 4f 70 2d 31 5d 3b 0a 20 20 69 66 28 20 70 4f 70  Op-1];.  if( pOp
4680: 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f  ->opcode==OP_Noo
4690: 70 20 26 26 20 70 4f 70 2d 3e 70 33 21 3d 30 20  p && pOp->p3!=0 
46a0: 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61  ){.    const cha
46b0: 72 20 2a 7a 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a  r *z = pOp->p3;.
46c0: 20 20 20 20 77 68 69 6c 65 28 20 69 73 73 70 61      while( isspa
46d0: 63 65 28 2a 28 75 38 2a 29 7a 29 20 29 20 7a 2b  ce(*(u8*)z) ) z+
46e0: 2b 3b 0a 20 20 20 20 70 72 69 6e 74 66 28 22 53  +;.    printf("S
46f0: 51 4c 3a 20 5b 25 73 5d 5c 6e 22 2c 20 7a 29 3b  QL: [%s]\n", z);
4700: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f  .  }.#endif.}../
4710: 2a 0a 2a 2a 20 50 72 65 70 61 72 65 20 61 20 76  *.** Prepare a v
4720: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 66  irtual machine f
4730: 6f 72 20 65 78 65 63 75 74 69 6f 6e 2e 20 20 54  or execution.  T
4740: 68 69 73 20 69 6e 76 6f 6c 76 65 73 20 74 68 69  his involves thi
4750: 6e 67 73 20 73 75 63 68 0a 2a 2a 20 61 73 20 61  ngs such.** as a
4760: 6c 6c 6f 63 61 74 69 6e 67 20 73 74 61 63 6b 20  llocating stack 
4770: 73 70 61 63 65 20 61 6e 64 20 69 6e 69 74 69 61  space and initia
4780: 6c 69 7a 69 6e 67 20 74 68 65 20 70 72 6f 67 72  lizing the progr
4790: 61 6d 20 63 6f 75 6e 74 65 72 2e 0a 2a 2a 20 41  am counter..** A
47a0: 66 74 65 72 20 74 68 65 20 56 44 42 45 20 68 61  fter the VDBE ha
47b0: 73 20 62 65 20 70 72 65 70 70 65 64 2c 20 69 74  s be prepped, it
47c0: 20 63 61 6e 20 62 65 20 65 78 65 63 75 74 65 64   can be executed
47d0: 20 62 79 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 0a   by one or more.
47e0: 2a 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69  ** calls to sqli
47f0: 74 65 33 56 64 62 65 45 78 65 63 28 29 2e 20 20  te3VdbeExec().  
4800: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74  .**.** This is t
4810: 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 6d  he only way to m
4820: 6f 76 65 20 61 20 56 44 42 45 20 66 72 6f 6d 20  ove a VDBE from 
4830: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
4840: 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43  to.** VDBE_MAGIC
4850: 5f 52 55 4e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  _RUN..*/.void sq
4860: 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61  lite3VdbeMakeRea
4870: 64 79 28 0a 20 20 56 64 62 65 20 2a 70 2c 20 20  dy(.  Vdbe *p,  
4880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4890: 20 20 20 20 20 2f 2a 20 54 68 65 20 56 44 42 45       /* The VDBE
48a0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 61 72 2c 20   */.  int nVar, 
48b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
48c0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
48d0: 66 20 27 3f 27 20 73 65 65 20 69 6e 20 74 68 65  f '?' see in the
48e0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 2a   SQL statement *
48f0: 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 2c 20 20 20  /.  int nMem,   
4900: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4910: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
4920: 6d 65 6d 6f 72 79 20 63 65 6c 6c 73 20 74 6f 20  memory cells to 
4930: 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a 20 20 69 6e  allocate */.  in
4940: 74 20 6e 43 75 72 73 6f 72 2c 20 20 20 20 20 20  t nCursor,      
4950: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4960: 4e 75 6d 62 65 72 20 6f 66 20 63 75 72 73 6f 72  Number of cursor
4970: 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f  s to allocate */
4980: 0a 20 20 69 6e 74 20 6e 41 67 67 2c 20 20 20 20  .  int nAgg,    
4990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
49a0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61    /* Number of a
49b0: 67 67 72 65 67 61 74 65 20 63 6f 6e 74 65 78 74  ggregate context
49c0: 73 20 72 65 71 75 69 72 65 64 20 2a 2f 0a 20 20  s required */.  
49d0: 69 6e 74 20 69 73 45 78 70 6c 61 69 6e 20 20 20  int isExplain   
49e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
49f0: 2a 20 54 72 75 65 20 69 66 20 74 68 65 20 45 58  * True if the EX
4a00: 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64 73 20 69  PLAIN keywords i
4a10: 73 20 70 72 65 73 65 6e 74 20 2a 2f 0a 29 7b 0a  s present */.){.
4a20: 20 20 69 6e 74 20 6e 3b 0a 0a 20 20 61 73 73 65    int n;..  asse
4a30: 72 74 28 20 70 21 3d 30 20 29 3b 0a 20 20 61 73  rt( p!=0 );.  as
4a40: 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d  sert( p->magic==
4a50: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
4a60: 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 72 65 20 73  );..  /* There s
4a70: 68 6f 75 6c 64 20 62 65 20 61 74 20 6c 65 61 73  hould be at leas
4a80: 74 20 6f 6e 65 20 6f 70 63 6f 64 65 2e 0a 20 20  t one opcode..  
4a90: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  */.  assert( p->
4aa0: 6e 4f 70 3e 30 20 29 3b 0a 0a 20 20 2f 2a 20 53  nOp>0 );..  /* S
4ab0: 65 74 20 74 68 65 20 6d 61 67 69 63 20 74 6f 20  et the magic to 
4ac0: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 73  VDBE_MAGIC_RUN s
4ad0: 6f 6f 6e 65 72 20 72 61 74 68 65 72 20 74 68 61  ooner rather tha
4ae0: 6e 20 6c 61 74 65 72 2e 20 54 68 69 73 0a 20 20  n later. This.  
4af0: 20 2a 20 69 73 20 62 65 63 61 75 73 65 20 74 68   * is because th
4b00: 65 20 63 61 6c 6c 20 74 6f 20 72 65 73 69 7a 65  e call to resize
4b10: 4f 70 41 72 72 61 79 28 29 20 62 65 6c 6f 77 20  OpArray() below 
4b20: 6d 61 79 20 73 68 72 69 6e 6b 20 74 68 65 0a 20  may shrink the. 
4b30: 20 20 2a 20 70 2d 3e 61 4f 70 5b 5d 20 61 72 72    * p->aOp[] arr
4b40: 61 79 20 74 6f 20 73 61 76 65 20 6d 65 6d 6f 72  ay to save memor
4b50: 79 20 69 66 20 63 61 6c 6c 65 64 20 77 68 65 6e  y if called when
4b60: 20 69 6e 20 56 44 42 45 5f 4d 41 47 49 43 5f 52   in VDBE_MAGIC_R
4b70: 55 4e 20 0a 20 20 20 2a 20 73 74 61 74 65 2e 0a  UN .   * state..
4b80: 20 20 20 2a 2f 0a 20 20 70 2d 3e 6d 61 67 69 63     */.  p->magic
4b90: 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 52 55   = VDBE_MAGIC_RU
4ba0: 4e 3b 0a 0a 20 20 2f 2a 20 4e 6f 20 69 6e 73 74  N;..  /* No inst
4bb0: 72 75 63 74 69 6f 6e 20 65 76 65 72 20 70 75 73  ruction ever pus
4bc0: 68 65 73 20 6d 6f 72 65 20 74 68 61 6e 20 61 20  hes more than a 
4bd0: 73 69 6e 67 6c 65 20 65 6c 65 6d 65 6e 74 20 6f  single element o
4be0: 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 73 74 61  nto the.  ** sta
4bf0: 63 6b 2e 20 20 41 6e 64 20 74 68 65 20 73 74 61  ck.  And the sta
4c00: 63 6b 20 6e 65 76 65 72 20 67 72 6f 77 73 20 6f  ck never grows o
4c10: 6e 20 73 75 63 63 65 73 73 69 76 65 20 65 78 65  n successive exe
4c20: 63 75 74 69 6f 6e 73 20 6f 66 20 74 68 65 0a 20  cutions of the. 
4c30: 20 2a 2a 20 73 61 6d 65 20 6c 6f 6f 70 2e 20 20   ** same loop.  
4c40: 53 6f 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d  So the total num
4c50: 62 65 72 20 6f 66 20 69 6e 73 74 72 75 63 74 69  ber of instructi
4c60: 6f 6e 73 20 69 73 20 61 6e 20 75 70 70 65 72 20  ons is an upper 
4c70: 62 6f 75 6e 64 0a 20 20 2a 2a 20 6f 6e 20 74 68  bound.  ** on th
4c80: 65 20 6d 61 78 69 6d 75 6d 20 73 74 61 63 6b 20  e maximum stack 
4c90: 64 65 70 74 68 20 72 65 71 75 69 72 65 64 2e 0a  depth required..
4ca0: 20 20 2a 2a 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61    **.  ** Alloca
4cb0: 74 69 6f 6e 20 61 6c 6c 20 74 68 65 20 73 74 61  tion all the sta
4cc0: 63 6b 20 73 70 61 63 65 20 77 65 20 77 69 6c 6c  ck space we will
4cd0: 20 65 76 65 72 20 6e 65 65 64 2e 0a 20 20 2a 2f   ever need..  */
4ce0: 0a 20 20 69 66 28 20 70 2d 3e 61 53 74 61 63 6b  .  if( p->aStack
4cf0: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e  ==0 ){.    int n
4d00: 41 72 67 3b 20 20 20 20 20 20 20 2f 2a 20 4d 61  Arg;       /* Ma
4d10: 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20  ximum number of 
4d20: 61 72 67 73 20 70 61 73 73 65 64 20 74 6f 20 61  args passed to a
4d30: 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20   user function. 
4d40: 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 53 74 61 63  */.    int nStac
4d50: 6b 3b 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75  k;     /* Maximu
4d60: 6d 20 6e 75 6d 62 65 72 20 6f 66 20 73 74 61 63  m number of stac
4d70: 6b 20 65 6e 74 72 69 65 73 20 72 65 71 75 69 72  k entries requir
4d80: 65 64 20 2a 2f 0a 20 20 20 20 72 65 73 6f 6c 76  ed */.    resolv
4d90: 65 50 32 56 61 6c 75 65 73 28 70 2c 20 26 6e 41  eP2Values(p, &nA
4da0: 72 67 2c 20 26 6e 53 74 61 63 6b 29 3b 0a 20 20  rg, &nStack);.  
4db0: 20 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28    resizeOpArray(
4dc0: 70 2c 20 70 2d 3e 6e 4f 70 29 3b 0a 20 20 20 20  p, p->nOp);.    
4dd0: 61 73 73 65 72 74 28 20 6e 56 61 72 3e 3d 30 20  assert( nVar>=0 
4de0: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e  );.    assert( n
4df0: 53 74 61 63 6b 3c 70 2d 3e 6e 4f 70 20 29 3b 0a  Stack<p->nOp );.
4e00: 20 20 20 20 6e 53 74 61 63 6b 20 3d 20 69 73 45      nStack = isE
4e10: 78 70 6c 61 69 6e 20 3f 20 31 30 20 3a 20 6e 53  xplain ? 10 : nS
4e20: 74 61 63 6b 3b 0a 20 20 20 20 70 2d 3e 61 53 74  tack;.    p->aSt
4e30: 61 63 6b 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c  ack = sqliteMall
4e40: 6f 63 28 0a 20 20 20 20 20 20 20 20 6e 53 74 61  oc(.        nSta
4e50: 63 6b 2a 73 69 7a 65 6f 66 28 70 2d 3e 61 53 74  ck*sizeof(p->aSt
4e60: 61 63 6b 5b 30 5d 29 20 20 20 20 2f 2a 20 61 53  ack[0])    /* aS
4e70: 74 61 63 6b 20 2a 2f 0a 20 20 20 20 20 20 2b 20  tack */.      + 
4e80: 6e 41 72 67 2a 73 69 7a 65 6f 66 28 4d 65 6d 2a  nArg*sizeof(Mem*
4e90: 29 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  )              /
4ea0: 2a 20 61 70 41 72 67 20 2a 2f 0a 20 20 20 20 20  * apArg */.     
4eb0: 20 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66 28 4d   + nVar*sizeof(M
4ec0: 65 6d 29 20 20 20 20 20 20 20 20 20 20 20 20 20  em)             
4ed0: 20 20 2f 2a 20 61 56 61 72 20 2a 2f 0a 20 20 20    /* aVar */.   
4ee0: 20 20 20 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66     + nVar*sizeof
4ef0: 28 63 68 61 72 2a 29 20 20 20 20 20 20 20 20 20  (char*)         
4f00: 20 20 20 20 2f 2a 20 61 7a 56 61 72 20 2a 2f 0a      /* azVar */.
4f10: 20 20 20 20 20 20 2b 20 6e 4d 65 6d 2a 73 69 7a        + nMem*siz
4f20: 65 6f 66 28 4d 65 6d 29 20 20 20 20 20 20 20 20  eof(Mem)        
4f30: 20 20 20 20 20 20 20 2f 2a 20 61 4d 65 6d 20 2a         /* aMem *
4f40: 2f 0a 20 20 20 20 20 20 2b 20 6e 43 75 72 73 6f  /.      + nCurso
4f50: 72 2a 73 69 7a 65 6f 66 28 43 75 72 73 6f 72 2a  r*sizeof(Cursor*
4f60: 29 20 20 20 20 20 20 20 20 2f 2a 20 61 70 43 73  )        /* apCs
4f70: 72 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 41 67  r */.      + nAg
4f80: 67 2a 73 69 7a 65 6f 66 28 41 67 67 29 20 20 20  g*sizeof(Agg)   
4f90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41              /* A
4fa0: 67 67 72 65 67 61 74 65 20 63 6f 6e 74 65 78 74  ggregate context
4fb0: 73 20 2a 2f 0a 20 20 20 20 29 3b 0a 20 20 20 20  s */.    );.    
4fc0: 69 66 28 20 21 73 71 6c 69 74 65 33 5f 6d 61 6c  if( !sqlite3_mal
4fd0: 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20  loc_failed ){.  
4fe0: 20 20 20 20 70 2d 3e 61 4d 65 6d 20 3d 20 26 70      p->aMem = &p
4ff0: 2d 3e 61 53 74 61 63 6b 5b 6e 53 74 61 63 6b 5d  ->aStack[nStack]
5000: 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 4d 65 6d 20  ;.      p->nMem 
5010: 3d 20 6e 4d 65 6d 3b 0a 20 20 20 20 20 20 70 2d  = nMem;.      p-
5020: 3e 61 56 61 72 20 3d 20 26 70 2d 3e 61 4d 65 6d  >aVar = &p->aMem
5030: 5b 6e 4d 65 6d 5d 3b 0a 20 20 20 20 20 20 70 2d  [nMem];.      p-
5040: 3e 6e 56 61 72 20 3d 20 6e 56 61 72 3b 0a 20 20  >nVar = nVar;.  
5050: 20 20 20 20 70 2d 3e 6f 6b 56 61 72 20 3d 20 30      p->okVar = 0
5060: 3b 0a 20 20 20 20 20 20 70 2d 3e 61 70 41 72 67  ;.      p->apArg
5070: 20 3d 20 28 4d 65 6d 2a 2a 29 26 70 2d 3e 61 56   = (Mem**)&p->aV
5080: 61 72 5b 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20  ar[nVar];.      
5090: 70 2d 3e 61 7a 56 61 72 20 3d 20 28 63 68 61 72  p->azVar = (char
50a0: 2a 2a 29 26 70 2d 3e 61 70 41 72 67 5b 6e 41 72  **)&p->apArg[nAr
50b0: 67 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 61 70 43  g];.      p->apC
50c0: 73 72 20 3d 20 28 43 75 72 73 6f 72 2a 2a 29 26  sr = (Cursor**)&
50d0: 70 2d 3e 61 7a 56 61 72 5b 6e 56 61 72 5d 3b 0a  p->azVar[nVar];.
50e0: 20 20 20 20 20 20 69 66 28 20 6e 41 67 67 3e 30        if( nAgg>0
50f0: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 6e   ){.        p->n
5100: 41 67 67 20 3d 20 6e 41 67 67 3b 0a 20 20 20 20  Agg = nAgg;.    
5110: 20 20 20 20 70 2d 3e 61 70 41 67 67 20 3d 20 28      p->apAgg = (
5120: 41 67 67 2a 29 26 70 2d 3e 61 70 43 73 72 5b 6e  Agg*)&p->apCsr[n
5130: 43 75 72 73 6f 72 5d 3b 0a 20 20 20 20 20 20 7d  Cursor];.      }
5140: 0a 20 20 20 20 20 20 70 2d 3e 6e 43 75 72 73 6f  .      p->nCurso
5150: 72 20 3d 20 6e 43 75 72 73 6f 72 3b 0a 20 20 20  r = nCursor;.   
5160: 20 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c 6e 56     for(n=0; n<nV
5170: 61 72 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20 20 20  ar; n++){.      
5180: 20 20 70 2d 3e 61 56 61 72 5b 6e 5d 2e 66 6c 61    p->aVar[n].fla
5190: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20  gs = MEM_Null;. 
51a0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
51b0: 0a 20 20 70 2d 3e 70 41 67 67 20 3d 20 70 2d 3e  .  p->pAgg = p->
51c0: 61 70 41 67 67 3b 0a 20 20 66 6f 72 28 6e 3d 30  apAgg;.  for(n=0
51d0: 3b 20 6e 3c 70 2d 3e 6e 4d 65 6d 3b 20 6e 2b 2b  ; n<p->nMem; n++
51e0: 29 7b 0a 20 20 20 20 70 2d 3e 61 4d 65 6d 5b 6e  ){.    p->aMem[n
51f0: 5d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75  ].flags = MEM_Nu
5200: 6c 6c 3b 0a 20 20 7d 0a 0a 23 69 66 64 65 66 20  ll;.  }..#ifdef 
5210: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 69  SQLITE_DEBUG.  i
5220: 66 28 20 28 70 2d 3e 64 62 2d 3e 66 6c 61 67 73  f( (p->db->flags
5230: 20 26 20 53 51 4c 49 54 45 5f 56 64 62 65 4c 69   & SQLITE_VdbeLi
5240: 73 74 69 6e 67 29 21 3d 30 0a 20 20 20 20 7c 7c  sting)!=0.    ||
5250: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78   sqlite3OsFileEx
5260: 69 73 74 73 28 22 76 64 62 65 5f 65 78 70 6c 61  ists("vdbe_expla
5270: 69 6e 22 29 0a 20 20 29 7b 0a 20 20 20 20 69 6e  in").  ){.    in
5280: 74 20 69 3b 0a 20 20 20 20 70 72 69 6e 74 66 28  t i;.    printf(
5290: 22 56 44 42 45 20 50 72 6f 67 72 61 6d 20 4c 69  "VDBE Program Li
52a0: 73 74 69 6e 67 3a 5c 6e 22 29 3b 0a 20 20 20 20  sting:\n");.    
52b0: 73 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74  sqlite3VdbePrint
52c0: 53 71 6c 28 70 29 3b 0a 20 20 20 20 66 6f 72 28  Sql(p);.    for(
52d0: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69  i=0; i<p->nOp; i
52e0: 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ++){.      sqlit
52f0: 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28 73 74  e3VdbePrintOp(st
5300: 64 6f 75 74 2c 20 69 2c 20 26 70 2d 3e 61 4f 70  dout, i, &p->aOp
5310: 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  [i]);.    }.  }.
5320: 20 20 69 66 28 20 73 71 6c 69 74 65 33 4f 73 46    if( sqlite3OsF
5330: 69 6c 65 45 78 69 73 74 73 28 22 76 64 62 65 5f  ileExists("vdbe_
5340: 74 72 61 63 65 22 29 20 29 7b 0a 20 20 20 20 70  trace") ){.    p
5350: 2d 3e 74 72 61 63 65 20 3d 20 73 74 64 6f 75 74  ->trace = stdout
5360: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70  ;.  }.#endif.  p
5370: 2d 3e 70 54 6f 73 20 3d 20 26 70 2d 3e 61 53 74  ->pTos = &p->aSt
5380: 61 63 6b 5b 2d 31 5d 3b 0a 20 20 70 2d 3e 70 63  ack[-1];.  p->pc
5390: 20 3d 20 2d 31 3b 0a 20 20 70 2d 3e 72 63 20 3d   = -1;.  p->rc =
53a0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 70 2d   SQLITE_OK;.  p-
53b0: 3e 75 6e 69 71 75 65 43 6e 74 20 3d 20 30 3b 0a  >uniqueCnt = 0;.
53c0: 20 20 70 2d 3e 72 65 74 75 72 6e 44 65 70 74 68    p->returnDepth
53d0: 20 3d 20 30 3b 0a 20 20 70 2d 3e 65 72 72 6f 72   = 0;.  p->error
53e0: 41 63 74 69 6f 6e 20 3d 20 4f 45 5f 41 62 6f 72  Action = OE_Abor
53f0: 74 3b 0a 20 20 70 2d 3e 70 6f 70 53 74 61 63 6b  t;.  p->popStack
5400: 20 3d 20 20 30 3b 0a 20 20 70 2d 3e 65 78 70 6c   =  0;.  p->expl
5410: 61 69 6e 20 7c 3d 20 69 73 45 78 70 6c 61 69 6e  ain |= isExplain
5420: 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56  ;.  p->magic = V
5430: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 3b 0a 20  DBE_MAGIC_RUN;. 
5440: 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b   p->nChange = 0;
5450: 0a 23 69 66 64 65 66 20 56 44 42 45 5f 50 52 4f  .#ifdef VDBE_PRO
5460: 46 49 4c 45 0a 20 20 7b 0a 20 20 20 20 69 6e 74  FILE.  {.    int
5470: 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b   i;.    for(i=0;
5480: 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b   i<p->nOp; i++){
5490: 0a 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d  .      p->aOp[i]
54a0: 2e 63 6e 74 20 3d 20 30 3b 0a 20 20 20 20 20 20  .cnt = 0;.      
54b0: 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73  p->aOp[i].cycles
54c0: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
54d0: 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  #endif.}.../*.**
54e0: 20 52 65 6d 6f 76 65 20 61 6e 79 20 65 6c 65 6d   Remove any elem
54f0: 65 6e 74 73 20 74 68 61 74 20 72 65 6d 61 69 6e  ents that remain
5500: 20 6f 6e 20 74 68 65 20 73 6f 72 74 65 72 20 66   on the sorter f
5510: 6f 72 20 74 68 65 20 56 44 42 45 20 67 69 76 65  or the VDBE give
5520: 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  n..*/.void sqlit
5530: 65 33 56 64 62 65 53 6f 72 74 65 72 52 65 73 65  e3VdbeSorterRese
5540: 74 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 77 68  t(Vdbe *p){.  wh
5550: 69 6c 65 28 20 70 2d 3e 70 53 6f 72 74 20 29 7b  ile( p->pSort ){
5560: 0a 20 20 20 20 53 6f 72 74 65 72 20 2a 70 53 6f  .    Sorter *pSo
5570: 72 74 65 72 20 3d 20 70 2d 3e 70 53 6f 72 74 3b  rter = p->pSort;
5580: 0a 20 20 20 20 70 2d 3e 70 53 6f 72 74 20 3d 20  .    p->pSort = 
5590: 70 53 6f 72 74 65 72 2d 3e 70 4e 65 78 74 3b 0a  pSorter->pNext;.
55a0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
55b0: 53 6f 72 74 65 72 2d 3e 7a 4b 65 79 29 3b 0a 20  Sorter->zKey);. 
55c0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
55d0: 6d 52 65 6c 65 61 73 65 28 26 70 53 6f 72 74 65  mRelease(&pSorte
55e0: 72 2d 3e 64 61 74 61 29 3b 0a 20 20 20 20 73 71  r->data);.    sq
55f0: 6c 69 74 65 46 72 65 65 28 70 53 6f 72 74 65 72  liteFree(pSorter
5600: 29 3b 0a 20 20 7d 0a 20 20 70 2d 3e 70 53 6f 72  );.  }.  p->pSor
5610: 74 54 61 69 6c 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a  tTail = 0;.}../*
5620: 0a 2a 2a 20 46 72 65 65 20 61 6c 6c 20 72 65 73  .** Free all res
5630: 6f 75 72 63 65 73 20 61 6c 6c 6f 63 69 61 74 65  ources allociate
5640: 64 20 77 69 74 68 20 41 67 67 45 6c 65 6d 20 70  d with AggElem p
5650: 45 6c 65 6d 2c 20 61 6e 20 65 6c 65 6d 65 6e 74  Elem, an element
5660: 20 6f 66 0a 2a 2a 20 61 67 67 72 65 67 61 74 65   of.** aggregate
5670: 20 70 41 67 67 2e 0a 2a 2f 0a 73 74 61 74 69 63   pAgg..*/.static
5680: 20 76 6f 69 64 20 66 72 65 65 41 67 67 45 6c 65   void freeAggEle
5690: 6d 28 41 67 67 45 6c 65 6d 20 2a 70 45 6c 65 6d  m(AggElem *pElem
56a0: 2c 20 41 67 67 20 2a 70 41 67 67 29 7b 0a 20 20  , Agg *pAgg){.  
56b0: 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30  int i;.  for(i=0
56c0: 3b 20 69 3c 70 41 67 67 2d 3e 6e 4d 65 6d 3b 20  ; i<pAgg->nMem; 
56d0: 69 2b 2b 29 7b 0a 20 20 20 20 4d 65 6d 20 2a 70  i++){.    Mem *p
56e0: 4d 65 6d 20 3d 20 26 70 45 6c 65 6d 2d 3e 61 4d  Mem = &pElem->aM
56f0: 65 6d 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20 70  em[i];.    if( p
5700: 41 67 67 2d 3e 61 70 46 75 6e 63 20 26 26 20 70  Agg->apFunc && p
5710: 41 67 67 2d 3e 61 70 46 75 6e 63 5b 69 5d 20 26  Agg->apFunc[i] &
5720: 26 20 28 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26  & (pMem->flags &
5730: 20 4d 45 4d 5f 41 67 67 43 74 78 29 21 3d 30 20   MEM_AggCtx)!=0 
5740: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
5750: 5f 63 6f 6e 74 65 78 74 20 63 74 78 3b 0a 20 20  _context ctx;.  
5760: 20 20 20 20 63 74 78 2e 70 46 75 6e 63 20 3d 20      ctx.pFunc = 
5770: 70 41 67 67 2d 3e 61 70 46 75 6e 63 5b 69 5d 3b  pAgg->apFunc[i];
5780: 0a 20 20 20 20 20 20 63 74 78 2e 73 2e 66 6c 61  .      ctx.s.fla
5790: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20  gs = MEM_Null;. 
57a0: 20 20 20 20 20 63 74 78 2e 70 41 67 67 20 3d 20       ctx.pAgg = 
57b0: 70 4d 65 6d 2d 3e 7a 3b 0a 20 20 20 20 20 20 63  pMem->z;.      c
57c0: 74 78 2e 63 6e 74 20 3d 20 70 4d 65 6d 2d 3e 69  tx.cnt = pMem->i
57d0: 3b 0a 20 20 20 20 20 20 63 74 78 2e 69 73 45 72  ;.      ctx.isEr
57e0: 72 6f 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 28  ror = 0;.      (
57f0: 2a 63 74 78 2e 70 46 75 6e 63 2d 3e 78 46 69 6e  *ctx.pFunc->xFin
5800: 61 6c 69 7a 65 29 28 26 63 74 78 29 3b 0a 20 20  alize)(&ctx);.  
5810: 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 63 74      pMem->z = ct
5820: 78 2e 70 41 67 67 3b 0a 20 20 20 20 20 20 69 66  x.pAgg;.      if
5830: 28 20 70 4d 65 6d 2d 3e 7a 21 3d 30 20 26 26 20  ( pMem->z!=0 && 
5840: 70 4d 65 6d 2d 3e 7a 21 3d 70 4d 65 6d 2d 3e 7a  pMem->z!=pMem->z
5850: 53 68 6f 72 74 20 29 7b 0a 20 20 20 20 20 20 20  Short ){.       
5860: 20 73 71 6c 69 74 65 46 72 65 65 28 70 4d 65 6d   sqliteFree(pMem
5870: 2d 3e 7a 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  ->z);.      }.  
5880: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d      sqlite3VdbeM
5890: 65 6d 52 65 6c 65 61 73 65 28 26 63 74 78 2e 73  emRelease(&ctx.s
58a0: 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  );.    }else{.  
58b0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d      sqlite3VdbeM
58c0: 65 6d 52 65 6c 65 61 73 65 28 70 4d 65 6d 29 3b  emRelease(pMem);
58d0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c  .    }.  }.  sql
58e0: 69 74 65 46 72 65 65 28 70 45 6c 65 6d 29 3b 0a  iteFree(pElem);.
58f0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 65 74 20 61  }../*.** Reset a
5900: 6e 20 41 67 67 20 73 74 72 75 63 74 75 72 65 2e  n Agg structure.
5910: 20 20 44 65 6c 65 74 65 20 61 6c 6c 20 69 74 73    Delete all its
5920: 20 63 6f 6e 74 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a   contents..**.**
5930: 20 46 6f 72 20 69 6e 73 74 61 6c 6c 61 62 6c 65   For installable
5940: 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74   aggregate funct
5950: 69 6f 6e 73 2c 20 69 66 20 74 68 65 20 73 74 65  ions, if the ste
5960: 70 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 62  p function has b
5970: 65 65 6e 0a 2a 2a 20 63 61 6c 6c 65 64 2c 20 6d  een.** called, m
5980: 61 6b 65 20 73 75 72 65 20 74 68 65 20 66 69 6e  ake sure the fin
5990: 61 6c 69 7a 65 72 20 66 75 6e 63 74 69 6f 6e 20  alizer function 
59a0: 68 61 73 20 61 6c 73 6f 20 62 65 65 6e 20 63 61  has also been ca
59b0: 6c 6c 65 64 2e 20 20 54 68 65 0a 2a 2a 20 66 69  lled.  The.** fi
59c0: 6e 61 6c 69 7a 65 72 20 6d 69 67 68 74 20 6e 65  nalizer might ne
59d0: 65 64 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f 72  ed to free memor
59e0: 79 20 74 68 61 74 20 77 61 73 20 61 6c 6c 6f 63  y that was alloc
59f0: 61 74 65 64 20 61 73 20 70 61 72 74 20 6f 66 20  ated as part of 
5a00: 69 74 73 0a 2a 2a 20 70 72 69 76 61 74 65 20 63  its.** private c
5a10: 6f 6e 74 65 78 74 2e 20 20 49 66 20 74 68 65 20  ontext.  If the 
5a20: 66 69 6e 61 6c 69 7a 65 72 20 68 61 73 20 6e 6f  finalizer has no
5a30: 74 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 79 65  t been called ye
5a40: 74 2c 20 63 61 6c 6c 20 69 74 0a 2a 2a 20 6e 6f  t, call it.** no
5a50: 77 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 62 20 69  w..**.** If db i
5a60: 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68 69  s NULL, then thi
5a70: 73 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c 65  s is being calle
5a80: 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 56 64 62  d from sqliteVdb
5a90: 65 52 65 73 65 74 28 29 2e 20 49 6e 0a 2a 2a 20  eReset(). In.** 
5aa0: 74 68 69 73 20 63 61 73 65 20 63 6c 65 61 6e 20  this case clean 
5ab0: 75 70 20 61 6c 6c 20 72 65 66 65 72 65 6e 63 65  up all reference
5ac0: 73 20 74 6f 20 74 68 65 20 74 65 6d 70 2d 74 61  s to the temp-ta
5ad0: 62 6c 65 20 75 73 65 64 20 66 6f 72 0a 2a 2a 20  ble used for.** 
5ae0: 61 67 67 72 65 67 61 74 65 73 20 28 69 66 20 69  aggregates (if i
5af0: 74 20 77 61 73 20 65 76 65 72 20 6f 70 65 6e 65  t was ever opene
5b00: 64 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 62 20  d)..**.** If db 
5b10: 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65  is not NULL, the
5b20: 6e 20 74 68 69 73 20 69 73 20 62 65 69 6e 67 20  n this is being 
5b30: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77 69 74 68  called from with
5b40: 20 61 6e 20 4f 50 5f 41 67 67 52 65 73 65 74 0a   an OP_AggReset.
5b50: 2a 2a 20 6f 70 63 6f 64 65 2e 20 4f 70 65 6e 20  ** opcode. Open 
5b60: 74 68 65 20 74 65 6d 70 2d 74 61 62 6c 65 2c 20  the temp-table, 
5b70: 69 66 20 69 74 20 68 61 73 20 6e 6f 74 20 61 6c  if it has not al
5b80: 72 65 61 64 79 20 62 65 65 6e 20 6f 70 65 6e 65  ready been opene
5b90: 64 20 61 6e 64 0a 2a 2a 20 64 65 6c 65 74 65 20  d and.** delete 
5ba0: 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20  the contents of 
5bb0: 74 68 65 20 74 61 62 6c 65 20 75 73 65 64 20 66  the table used f
5bc0: 6f 72 20 61 67 67 72 65 67 61 74 65 20 69 6e 66  or aggregate inf
5bd0: 6f 72 6d 61 74 69 6f 6e 2c 20 72 65 61 64 79 0a  ormation, ready.
5be0: 2a 2a 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20  ** for the next 
5bf0: 72 6f 75 6e 64 20 6f 66 20 61 67 67 72 65 67 61  round of aggrega
5c00: 74 65 20 70 72 6f 63 65 73 73 69 6e 67 2e 0a 2a  te processing..*
5c10: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
5c20: 65 41 67 67 52 65 73 65 74 28 73 71 6c 69 74 65  eAggReset(sqlite
5c30: 33 20 2a 64 62 2c 20 41 67 67 20 2a 70 41 67 67  3 *db, Agg *pAgg
5c40: 2c 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49  , KeyInfo *pKeyI
5c50: 6e 66 6f 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  nfo){.  int rc =
5c60: 20 30 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a   0;.  BtCursor *
5c70: 70 43 73 72 3b 0a 0a 20 20 69 66 28 20 21 70 41  pCsr;..  if( !pA
5c80: 67 67 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49  gg ) return SQLI
5c90: 54 45 5f 4f 4b 3b 0a 20 20 70 43 73 72 20 3d 20  TE_OK;.  pCsr = 
5ca0: 70 41 67 67 2d 3e 70 43 73 72 3b 0a 20 20 61 73  pAgg->pCsr;.  as
5cb0: 73 65 72 74 28 20 28 70 43 73 72 20 26 26 20 70  sert( (pCsr && p
5cc0: 41 67 67 2d 3e 6e 54 61 62 3e 30 29 20 7c 7c 20  Agg->nTab>0) || 
5cd0: 28 21 70 43 73 72 20 26 26 20 70 41 67 67 2d 3e  (!pCsr && pAgg->
5ce0: 6e 54 61 62 3d 3d 30 29 0a 20 20 20 20 20 20 20  nTab==0).       
5cf0: 20 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 61 6c    || sqlite3_mal
5d00: 6c 6f 63 5f 66 61 69 6c 65 64 20 29 3b 0a 0a 20  loc_failed );.. 
5d10: 20 2f 2a 20 49 66 20 70 43 73 72 20 69 73 20 6e   /* If pCsr is n
5d20: 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68  ot NULL, then th
5d30: 65 20 74 61 62 6c 65 20 75 73 65 64 20 66 6f 72  e table used for
5d40: 20 61 67 67 72 65 67 61 74 65 20 69 6e 66 6f 72   aggregate infor
5d50: 6d 61 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 6f  mation.  ** is o
5d60: 70 65 6e 2e 20 4c 6f 6f 70 20 74 68 72 6f 75 67  pen. Loop throug
5d70: 68 20 69 74 20 61 6e 64 20 66 72 65 65 20 74 68  h it and free th
5d80: 65 20 41 67 67 45 6c 65 6d 2a 20 73 74 72 75 63  e AggElem* struc
5d90: 74 75 72 65 20 70 6f 69 6e 74 65 64 20 61 74 0a  ture pointed at.
5da0: 20 20 2a 2a 20 62 79 20 65 61 63 68 20 65 6e 74    ** by each ent
5db0: 72 79 2e 20 49 66 20 74 68 65 20 66 69 6e 61 6c  ry. If the final
5dc0: 69 7a 65 72 20 68 61 73 20 6e 6f 74 20 62 65 65  izer has not bee
5dd0: 6e 20 63 61 6c 6c 65 64 20 66 6f 72 20 61 6e 20  n called for an 
5de0: 41 67 67 45 6c 65 6d 2c 0a 20 20 2a 2a 20 64 6f  AggElem,.  ** do
5df0: 20 74 68 61 74 20 74 6f 6f 2e 20 46 69 6e 61 6c   that too. Final
5e00: 6c 79 2c 20 63 6c 65 61 72 20 74 68 65 20 62 74  ly, clear the bt
5e10: 72 65 65 20 74 61 62 6c 65 20 69 74 73 65 6c 66  ree table itself
5e20: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 43 73  ..  */.  if( pCs
5e30: 72 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 65 73  r ){.    int res
5e40: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 41  ;.    assert( pA
5e50: 67 67 2d 3e 70 42 74 72 65 65 20 29 3b 0a 20 20  gg->pBtree );.  
5e60: 20 20 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e    assert( pAgg->
5e70: 6e 54 61 62 3e 30 20 29 3b 0a 0a 20 20 20 20 72  nTab>0 );..    r
5e80: 63 3d 73 71 6c 69 74 65 33 42 74 72 65 65 46 69  c=sqlite3BtreeFi
5e90: 72 73 74 28 70 43 73 72 2c 20 26 72 65 73 29 3b  rst(pCsr, &res);
5ea0: 0a 20 20 20 20 77 68 69 6c 65 28 20 72 65 73 3d  .    while( res=
5eb0: 3d 30 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45  =0 && rc==SQLITE
5ec0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 41 67 67  _OK ){.      Agg
5ed0: 45 6c 65 6d 20 2a 70 45 6c 65 6d 3b 0a 20 20 20  Elem *pElem;.   
5ee0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
5ef0: 74 72 65 65 44 61 74 61 28 70 43 73 72 2c 20 30  treeData(pCsr, 0
5f00: 2c 20 73 69 7a 65 6f 66 28 41 67 67 45 6c 65 6d  , sizeof(AggElem
5f10: 2a 29 2c 20 28 63 68 61 72 20 2a 29 26 70 45 6c  *), (char *)&pEl
5f20: 65 6d 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  em);.      if( r
5f30: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
5f40: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72          return r
5f50: 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  c;.      }.     
5f60: 20 61 73 73 65 72 74 28 20 70 41 67 67 2d 3e 61   assert( pAgg->a
5f70: 70 46 75 6e 63 21 3d 30 20 29 3b 0a 20 20 20 20  pFunc!=0 );.    
5f80: 20 20 66 72 65 65 41 67 67 45 6c 65 6d 28 70 45    freeAggElem(pE
5f90: 6c 65 6d 2c 20 70 41 67 67 29 3b 0a 20 20 20 20  lem, pAgg);.    
5fa0: 20 20 72 63 3d 73 71 6c 69 74 65 33 42 74 72 65    rc=sqlite3Btre
5fb0: 65 4e 65 78 74 28 70 43 73 72 2c 20 26 72 65 73  eNext(pCsr, &res
5fc0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28  );.    }.    if(
5fd0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
5fe0: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  {.      return r
5ff0: 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73 71  c;.    }..    sq
6000: 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43  lite3BtreeCloseC
6010: 75 72 73 6f 72 28 70 43 73 72 29 3b 0a 20 20 20  ursor(pCsr);.   
6020: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65   sqlite3BtreeCle
6030: 61 72 54 61 62 6c 65 28 70 41 67 67 2d 3e 70 42  arTable(pAgg->pB
6040: 74 72 65 65 2c 20 70 41 67 67 2d 3e 6e 54 61 62  tree, pAgg->nTab
6050: 29 3b 0a 20 20 7d 65 6c 73 65 7b 20 0a 20 20 20  );.  }else{ .   
6060: 20 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 20 6d   /* The cursor m
6070: 61 79 20 6e 6f 74 20 62 65 20 6f 70 65 6e 20 62  ay not be open b
6080: 65 63 61 75 73 65 20 74 68 65 20 61 67 67 72 65  ecause the aggre
6090: 67 61 74 6f 72 20 77 61 73 20 6e 65 76 65 72 20  gator was never 
60a0: 75 73 65 64 2c 0a 20 20 20 20 2a 2a 20 6f 72 20  used,.    ** or 
60b0: 69 74 20 63 6f 75 6c 64 20 62 65 20 74 68 61 74  it could be that
60c0: 20 69 74 20 77 61 73 20 75 73 65 64 20 62 75 74   it was used but
60d0: 20 74 68 65 72 65 20 77 61 73 20 6e 6f 20 47 52   there was no GR
60e0: 4f 55 50 20 42 59 20 63 6c 61 75 73 65 2e 0a 20  OUP BY clause.. 
60f0: 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 41     */.    if( pA
6100: 67 67 2d 3e 70 43 75 72 72 65 6e 74 20 29 7b 0a  gg->pCurrent ){.
6110: 20 20 20 20 20 20 66 72 65 65 41 67 67 45 6c 65        freeAggEle
6120: 6d 28 70 41 67 67 2d 3e 70 43 75 72 72 65 6e 74  m(pAgg->pCurrent
6130: 2c 20 70 41 67 67 29 3b 0a 20 20 20 20 7d 0a 20  , pAgg);.    }. 
6140: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 64 62 20 69   }..  /* If db i
6150: 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 77  s not NULL and w
6160: 65 20 68 61 76 65 20 6e 6f 74 20 79 65 74 20 61  e have not yet a
6170: 6e 64 20 77 65 20 68 61 76 65 20 6e 6f 74 20 79  nd we have not y
6180: 65 74 20 6f 70 65 6e 65 64 0a 20 20 2a 2a 20 74  et opened.  ** t
6190: 68 65 20 74 65 6d 70 6f 72 61 72 79 20 62 74 72  he temporary btr
61a0: 65 65 20 74 68 65 6e 20 64 6f 20 73 6f 20 61 6e  ee then do so an
61b0: 64 20 63 72 65 61 74 65 20 74 68 65 20 74 61 62  d create the tab
61c0: 6c 65 20 74 6f 20 73 74 6f 72 65 20 61 67 67 72  le to store aggr
61d0: 65 67 61 74 65 0a 20 20 2a 2a 20 69 6e 66 6f 72  egate.  ** infor
61e0: 6d 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a  mation..  **.  *
61f0: 2a 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c  * If db is NULL,
6200: 20 74 68 65 6e 20 63 6c 6f 73 65 20 74 68 65 20   then close the 
6210: 74 65 6d 70 6f 72 61 72 79 20 62 74 72 65 65 20  temporary btree 
6220: 69 66 20 69 74 20 69 73 20 6f 70 65 6e 2e 0a 20  if it is open.. 
6230: 20 2a 2f 0a 20 20 69 66 28 20 64 62 20 29 7b 0a   */.  if( db ){.
6240: 20 20 20 20 69 66 28 20 21 70 41 67 67 2d 3e 70      if( !pAgg->p
6250: 42 74 72 65 65 20 29 7b 0a 20 20 20 20 20 20 61  Btree ){.      a
6260: 73 73 65 72 74 28 20 70 41 67 67 2d 3e 6e 54 61  ssert( pAgg->nTa
6270: 62 3d 3d 30 20 29 3b 0a 23 69 66 6e 64 65 66 20  b==0 );.#ifndef 
6280: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f  SQLITE_OMIT_MEMO
6290: 52 59 44 42 0a 20 20 20 20 20 20 72 63 20 3d 20  RYDB.      rc = 
62a0: 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74  sqlite3BtreeFact
62b0: 6f 72 79 28 64 62 2c 20 22 3a 6d 65 6d 6f 72 79  ory(db, ":memory
62c0: 3a 22 2c 20 30 2c 20 54 45 4d 50 5f 50 41 47 45  :", 0, TEMP_PAGE
62d0: 53 2c 20 26 70 41 67 67 2d 3e 70 42 74 72 65 65  S, &pAgg->pBtree
62e0: 29 3b 0a 23 65 6c 73 65 0a 20 20 20 20 20 20 72  );.#else.      r
62f0: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
6300: 46 61 63 74 6f 72 79 28 64 62 2c 20 30 2c 20 30  Factory(db, 0, 0
6310: 2c 20 54 45 4d 50 5f 50 41 47 45 53 2c 20 26 70  , TEMP_PAGES, &p
6320: 41 67 67 2d 3e 70 42 74 72 65 65 29 3b 0a 23 65  Agg->pBtree);.#e
6330: 6e 64 69 66 0a 20 20 20 20 20 20 69 66 28 20 72  ndif.      if( r
6340: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
6350: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
6360: 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 69  sqlite3BtreeBegi
6370: 6e 54 72 61 6e 73 28 70 41 67 67 2d 3e 70 42 74  nTrans(pAgg->pBt
6380: 72 65 65 2c 20 31 29 3b 0a 20 20 20 20 20 20 72  ree, 1);.      r
6390: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
63a0: 43 72 65 61 74 65 54 61 62 6c 65 28 70 41 67 67  CreateTable(pAgg
63b0: 2d 3e 70 42 74 72 65 65 2c 20 26 70 41 67 67 2d  ->pBtree, &pAgg-
63c0: 3e 6e 54 61 62 2c 20 30 29 3b 0a 20 20 20 20 20  >nTab, 0);.     
63d0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
63e0: 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  OK ) return rc;.
63f0: 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74      }.    assert
6400: 28 20 70 41 67 67 2d 3e 6e 54 61 62 21 3d 30 20  ( pAgg->nTab!=0 
6410: 29 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  );..    rc = sql
6420: 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 28  ite3BtreeCursor(
6430: 70 41 67 67 2d 3e 70 42 74 72 65 65 2c 20 70 41  pAgg->pBtree, pA
6440: 67 67 2d 3e 6e 54 61 62 2c 20 31 2c 0a 20 20 20  gg->nTab, 1,.   
6450: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
6460: 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 2c 20 70  RecordCompare, p
6470: 4b 65 79 49 6e 66 6f 2c 20 26 70 41 67 67 2d 3e  KeyInfo, &pAgg->
6480: 70 43 73 72 29 3b 0a 20 20 20 20 69 66 28 20 72  pCsr);.    if( r
6490: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
64a0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 65 6c 73  eturn rc;.  }els
64b0: 65 7b 0a 20 20 20 20 69 66 28 20 70 41 67 67 2d  e{.    if( pAgg-
64c0: 3e 70 42 74 72 65 65 20 29 7b 0a 20 20 20 20 20  >pBtree ){.     
64d0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
64e0: 73 65 28 70 41 67 67 2d 3e 70 42 74 72 65 65 29  se(pAgg->pBtree)
64f0: 3b 0a 20 20 20 20 20 20 70 41 67 67 2d 3e 70 42  ;.      pAgg->pB
6500: 74 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 20 20  tree = 0;.      
6510: 70 41 67 67 2d 3e 6e 54 61 62 20 3d 20 30 3b 0a  pAgg->nTab = 0;.
6520: 20 20 20 20 7d 0a 20 20 20 20 70 41 67 67 2d 3e      }.    pAgg->
6530: 70 43 73 72 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20  pCsr = 0;.  }.. 
6540: 20 69 66 28 20 70 41 67 67 2d 3e 61 70 46 75 6e   if( pAgg->apFun
6550: 63 20 29 7b 20 0a 20 20 20 20 73 71 6c 69 74 65  c ){ .    sqlite
6560: 46 72 65 65 28 70 41 67 67 2d 3e 61 70 46 75 6e  Free(pAgg->apFun
6570: 63 29 3b 0a 20 20 20 20 70 41 67 67 2d 3e 61 70  c);.    pAgg->ap
6580: 46 75 6e 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  Func = 0;.  }.  
6590: 70 41 67 67 2d 3e 70 43 75 72 72 65 6e 74 20 3d  pAgg->pCurrent =
65a0: 20 30 3b 0a 20 20 70 41 67 67 2d 3e 6e 4d 65 6d   0;.  pAgg->nMem
65b0: 20 3d 20 30 3b 0a 20 20 70 41 67 67 2d 3e 73 65   = 0;.  pAgg->se
65c0: 61 72 63 68 69 6e 67 20 3d 20 30 3b 0a 20 20 72  arching = 0;.  r
65d0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
65e0: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74  .}.../*.** Delet
65f0: 65 20 61 20 6b 65 79 6c 69 73 74 0a 2a 2f 0a 76  e a keylist.*/.v
6600: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 4b  oid sqlite3VdbeK
6610: 65 79 6c 69 73 74 46 72 65 65 28 4b 65 79 6c 69  eylistFree(Keyli
6620: 73 74 20 2a 70 29 7b 0a 20 20 77 68 69 6c 65 28  st *p){.  while(
6630: 20 70 20 29 7b 0a 20 20 20 20 4b 65 79 6c 69 73   p ){.    Keylis
6640: 74 20 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e  t *pNext = p->pN
6650: 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 46  ext;.    sqliteF
6660: 72 65 65 28 70 29 3b 0a 20 20 20 20 70 20 3d 20  ree(p);.    p = 
6670: 70 4e 65 78 74 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  pNext;.  }.}../*
6680: 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 75 72 73  .** Close a curs
6690: 6f 72 20 61 6e 64 20 72 65 6c 65 61 73 65 20 61  or and release a
66a0: 6c 6c 20 74 68 65 20 72 65 73 6f 75 72 63 65 73  ll the resources
66b0: 20 74 68 61 74 20 63 75 72 73 6f 72 20 68 61 70   that cursor hap
66c0: 70 65 6e 73 0a 2a 2a 20 74 6f 20 68 6f 6c 64 2e  pens.** to hold.
66d0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
66e0: 56 64 62 65 46 72 65 65 43 75 72 73 6f 72 28 43  VdbeFreeCursor(C
66f0: 75 72 73 6f 72 20 2a 70 43 78 29 7b 0a 20 20 69  ursor *pCx){.  i
6700: 66 28 20 70 43 78 3d 3d 30 20 29 7b 0a 20 20 20  f( pCx==0 ){.   
6710: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69   return;.  }.  i
6720: 66 28 20 70 43 78 2d 3e 70 43 75 72 73 6f 72 20  f( pCx->pCursor 
6730: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74  ){.    sqlite3Bt
6740: 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70  reeCloseCursor(p
6750: 43 78 2d 3e 70 43 75 72 73 6f 72 29 3b 0a 20 20  Cx->pCursor);.  
6760: 7d 0a 20 20 69 66 28 20 70 43 78 2d 3e 70 42 74  }.  if( pCx->pBt
6770: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42   ){.    sqlite3B
6780: 74 72 65 65 43 6c 6f 73 65 28 70 43 78 2d 3e 70  treeClose(pCx->p
6790: 42 74 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  Bt);.  }.  sqlit
67a0: 65 46 72 65 65 28 70 43 78 2d 3e 70 44 61 74 61  eFree(pCx->pData
67b0: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
67c0: 70 43 78 2d 3e 61 54 79 70 65 29 3b 0a 20 20 73  pCx->aType);.  s
67d0: 71 6c 69 74 65 46 72 65 65 28 70 43 78 29 3b 0a  qliteFree(pCx);.
67e0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61  }../*.** Close a
67f0: 6c 6c 20 63 75 72 73 6f 72 73 0a 2a 2f 0a 73 74  ll cursors.*/.st
6800: 61 74 69 63 20 76 6f 69 64 20 63 6c 6f 73 65 41  atic void closeA
6810: 6c 6c 43 75 72 73 6f 72 73 28 56 64 62 65 20 2a  llCursors(Vdbe *
6820: 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  p){.  int i;.  i
6830: 66 28 20 70 2d 3e 61 70 43 73 72 3d 3d 30 20 29  f( p->apCsr==0 )
6840: 20 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 69   return;.  for(i
6850: 3d 30 3b 20 69 3c 70 2d 3e 6e 43 75 72 73 6f 72  =0; i<p->nCursor
6860: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69  ; i++){.    sqli
6870: 74 65 33 56 64 62 65 46 72 65 65 43 75 72 73 6f  te3VdbeFreeCurso
6880: 72 28 70 2d 3e 61 70 43 73 72 5b 69 5d 29 3b 0a  r(p->apCsr[i]);.
6890: 20 20 20 20 70 2d 3e 61 70 43 73 72 5b 69 5d 20      p->apCsr[i] 
68a0: 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  = 0;.  }.}../*.*
68b0: 2a 20 43 6c 65 61 6e 20 75 70 20 74 68 65 20 56  * Clean up the V
68c0: 4d 20 61 66 74 65 72 20 65 78 65 63 75 74 69 6f  M after executio
68d0: 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  n..**.** This ro
68e0: 75 74 69 6e 65 20 77 69 6c 6c 20 61 75 74 6f 6d  utine will autom
68f0: 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 20 61  atically close a
6900: 6e 79 20 63 75 72 73 6f 72 73 2c 20 6c 69 73 74  ny cursors, list
6910: 73 2c 20 61 6e 64 2f 6f 72 0a 2a 2a 20 73 6f 72  s, and/or.** sor
6920: 74 65 72 73 20 74 68 61 74 20 77 65 72 65 20 6c  ters that were l
6930: 65 66 74 20 6f 70 65 6e 2e 20 20 49 74 20 61 6c  eft open.  It al
6940: 73 6f 20 64 65 6c 65 74 65 73 20 74 68 65 20 76  so deletes the v
6950: 61 6c 75 65 73 20 6f 66 0a 2a 2a 20 76 61 72 69  alues of.** vari
6960: 61 62 6c 65 73 20 69 6e 20 74 68 65 20 61 56 61  ables in the aVa
6970: 72 5b 5d 20 61 72 72 61 79 2e 0a 2a 2f 0a 73 74  r[] array..*/.st
6980: 61 74 69 63 20 76 6f 69 64 20 43 6c 65 61 6e 75  atic void Cleanu
6990: 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  p(Vdbe *p){.  in
69a0: 74 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61 53  t i;.  if( p->aS
69b0: 74 61 63 6b 20 29 7b 0a 20 20 20 20 72 65 6c 65  tack ){.    rele
69c0: 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61  aseMemArray(p->a
69d0: 53 74 61 63 6b 2c 20 31 20 2b 20 28 70 2d 3e 70  Stack, 1 + (p->p
69e0: 54 6f 73 20 2d 20 70 2d 3e 61 53 74 61 63 6b 29  Tos - p->aStack)
69f0: 29 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d  );.    p->pTos =
6a00: 20 26 70 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d 3b   &p->aStack[-1];
6a10: 0a 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43  .  }.  closeAllC
6a20: 75 72 73 6f 72 73 28 70 29 3b 0a 20 20 72 65 6c  ursors(p);.  rel
6a30: 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e  easeMemArray(p->
6a40: 61 4d 65 6d 2c 20 70 2d 3e 6e 4d 65 6d 29 3b 0a  aMem, p->nMem);.
6a50: 20 20 69 66 28 20 70 2d 3e 70 4c 69 73 74 20 29    if( p->pList )
6a60: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
6a70: 65 4b 65 79 6c 69 73 74 46 72 65 65 28 70 2d 3e  eKeylistFree(p->
6a80: 70 4c 69 73 74 29 3b 0a 20 20 20 20 70 2d 3e 70  pList);.    p->p
6a90: 4c 69 73 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  List = 0;.  }.  
6aa0: 69 66 28 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74  if( p->contextSt
6ab0: 61 63 6b 20 29 7b 0a 20 20 20 20 66 6f 72 28 69  ack ){.    for(i
6ac0: 3d 30 3b 20 69 3c 70 2d 3e 63 6f 6e 74 65 78 74  =0; i<p->context
6ad0: 53 74 61 63 6b 54 6f 70 3b 20 69 2b 2b 29 7b 0a  StackTop; i++){.
6ae0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
6af0: 65 4b 65 79 6c 69 73 74 46 72 65 65 28 70 2d 3e  eKeylistFree(p->
6b00: 63 6f 6e 74 65 78 74 53 74 61 63 6b 5b 69 5d 2e  contextStack[i].
6b10: 70 4c 69 73 74 29 3b 0a 20 20 20 20 7d 0a 20 20  pList);.    }.  
6b20: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
6b30: 63 6f 6e 74 65 78 74 53 74 61 63 6b 29 3b 0a 20  contextStack);. 
6b40: 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65   }.  sqlite3Vdbe
6b50: 53 6f 72 74 65 72 52 65 73 65 74 28 70 29 3b 0a  SorterReset(p);.
6b60: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e    for(i=0; i<p->
6b70: 6e 41 67 67 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nAgg; i++){.    
6b80: 73 71 6c 69 74 65 33 56 64 62 65 41 67 67 52 65  sqlite3VdbeAggRe
6b90: 73 65 74 28 30 2c 20 26 70 2d 3e 61 70 41 67 67  set(0, &p->apAgg
6ba0: 5b 69 5d 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 70  [i], 0);.  }.  p
6bb0: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 20 3d  ->contextStack =
6bc0: 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65 78 74   0;.  p->context
6bd0: 53 74 61 63 6b 44 65 70 74 68 20 3d 20 30 3b 0a  StackDepth = 0;.
6be0: 20 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63    p->contextStac
6bf0: 6b 54 6f 70 20 3d 20 30 3b 0a 20 20 73 71 6c 69  kTop = 0;.  sqli
6c00: 74 65 46 72 65 65 28 70 2d 3e 7a 45 72 72 4d 73  teFree(p->zErrMs
6c10: 67 29 3b 0a 20 20 70 2d 3e 7a 45 72 72 4d 73 67  g);.  p->zErrMsg
6c20: 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53   = 0;.}../*.** S
6c30: 65 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  et the number of
6c40: 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 20   result columns 
6c50: 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72 65 74  that will be ret
6c60: 75 72 6e 65 64 20 62 79 20 74 68 69 73 20 53 51  urned by this SQ
6c70: 4c 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 2e 20  L.** statement. 
6c80: 54 68 69 73 20 69 73 20 6e 6f 77 20 73 65 74 20  This is now set 
6c90: 61 74 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 2c  at compile time,
6ca0: 20 72 61 74 68 65 72 20 74 68 61 6e 20 64 75 72   rather than dur
6cb0: 69 6e 67 0a 2a 2a 20 65 78 65 63 75 74 69 6f 6e  ing.** execution
6cc0: 20 6f 66 20 74 68 65 20 76 64 62 65 20 70 72 6f   of the vdbe pro
6cd0: 67 72 61 6d 20 73 6f 20 74 68 61 74 20 73 71 6c  gram so that sql
6ce0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e  ite3_column_coun
6cf0: 74 28 29 20 63 61 6e 0a 2a 2a 20 62 65 20 63 61  t() can.** be ca
6d00: 6c 6c 65 64 20 6f 6e 20 61 6e 20 53 51 4c 20 73  lled on an SQL s
6d10: 74 61 74 65 6d 65 6e 74 20 62 65 66 6f 72 65 20  tatement before 
6d20: 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e 0a  sqlite3_step()..
6d30: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
6d40: 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 56 64  dbeSetNumCols(Vd
6d50: 62 65 20 2a 70 2c 20 69 6e 74 20 6e 52 65 73 43  be *p, int nResC
6d60: 6f 6c 75 6d 6e 29 7b 0a 20 20 4d 65 6d 20 2a 70  olumn){.  Mem *p
6d70: 43 6f 6c 4e 61 6d 65 3b 0a 20 20 69 6e 74 20 6e  ColName;.  int n
6d80: 3b 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 70  ;.  assert( 0==p
6d90: 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 29 3b 0a  ->nResColumn );.
6da0: 20 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20    p->nResColumn 
6db0: 3d 20 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 20 20  = nResColumn;.  
6dc0: 6e 20 3d 20 6e 52 65 73 43 6f 6c 75 6d 6e 2a 32  n = nResColumn*2
6dd0: 3b 0a 20 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 20  ;.  p->aColName 
6de0: 3d 20 70 43 6f 6c 4e 61 6d 65 20 3d 20 28 4d 65  = pColName = (Me
6df0: 6d 2a 29 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28  m*)sqliteMalloc(
6e00: 20 73 69 7a 65 6f 66 28 4d 65 6d 29 2a 6e 20 29   sizeof(Mem)*n )
6e10: 3b 0a 20 20 69 66 28 20 70 2d 3e 61 43 6f 6c 4e  ;.  if( p->aColN
6e20: 61 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  ame==0 ) return;
6e30: 0a 20 20 77 68 69 6c 65 28 20 6e 2d 2d 20 3e 20  .  while( n-- > 
6e40: 30 20 29 7b 0a 20 20 20 20 28 70 43 6f 6c 4e 61  0 ){.    (pColNa
6e50: 6d 65 2b 2b 29 2d 3e 66 6c 61 67 73 20 3d 20 4d  me++)->flags = M
6e60: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 7d 0a 7d 0a 0a  EM_Null;.  }.}..
6e70: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 6e 61  /*.** Set the na
6e80: 6d 65 20 6f 66 20 74 68 65 20 69 64 78 27 74 68  me of the idx'th
6e90: 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 72 65   column to be re
6ea0: 74 75 72 6e 65 64 20 62 79 20 74 68 65 20 53 51  turned by the SQ
6eb0: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20  L statement..** 
6ec0: 7a 4e 61 6d 65 20 6d 75 73 74 20 62 65 20 61 20  zName must be a 
6ed0: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 6e 75 6c  pointer to a nul
6ee0: 20 74 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69   terminated stri
6ef0: 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63  ng..**.** This c
6f00: 61 6c 6c 20 6d 75 73 74 20 62 65 20 6d 61 64 65  all must be made
6f10: 20 61 66 74 65 72 20 61 20 63 61 6c 6c 20 74 6f   after a call to
6f20: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e   sqlite3VdbeSetN
6f30: 75 6d 43 6f 6c 73 28 29 2e 0a 2a 2a 0a 2a 2a 20  umCols()..**.** 
6f40: 49 66 20 4e 3d 3d 50 33 5f 53 54 41 54 49 43 20  If N==P3_STATIC 
6f50: 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 7a   it means that z
6f60: 4e 61 6d 65 20 69 73 20 61 20 70 6f 69 6e 74 65  Name is a pointe
6f70: 72 20 74 6f 20 61 20 63 6f 6e 73 74 61 6e 74 20  r to a constant 
6f80: 73 74 61 74 69 63 0a 2a 2a 20 73 74 72 69 6e 67  static.** string
6f90: 20 61 6e 64 20 77 65 20 63 61 6e 20 6a 75 73 74   and we can just
6fa0: 20 63 6f 70 79 20 74 68 65 20 70 6f 69 6e 74 65   copy the pointe
6fb0: 72 2e 20 49 66 20 69 74 20 69 73 20 50 33 5f 44  r. If it is P3_D
6fc0: 59 4e 41 4d 49 43 2c 20 74 68 65 6e 20 0a 2a 2a  YNAMIC, then .**
6fd0: 20 74 68 65 20 73 74 72 69 6e 67 20 69 73 20 66   the string is f
6fe0: 72 65 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74  reed using sqlit
6ff0: 65 46 72 65 65 28 29 20 77 68 65 6e 20 74 68 65  eFree() when the
7000: 20 76 64 62 65 20 69 73 20 66 69 6e 69 73 68 65   vdbe is finishe
7010: 64 20 77 69 74 68 0a 2a 2a 20 69 74 2e 20 4f 74  d with.** it. Ot
7020: 68 65 72 77 69 73 65 2c 20 4e 20 62 79 74 65 73  herwise, N bytes
7030: 20 6f 66 20 7a 4e 61 6d 65 20 61 72 65 20 63 6f   of zName are co
7040: 70 69 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  pied..*/.int sql
7050: 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61  ite3VdbeSetColNa
7060: 6d 65 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20  me(Vdbe *p, int 
7070: 69 64 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 20  idx, const char 
7080: 2a 7a 4e 61 6d 65 2c 20 69 6e 74 20 4e 29 7b 0a  *zName, int N){.
7090: 20 20 69 6e 74 20 72 63 3b 0a 20 20 4d 65 6d 20    int rc;.  Mem 
70a0: 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 20 20 61 73 73  *pColName;.  ass
70b0: 65 72 74 28 20 69 64 78 3c 28 32 2a 70 2d 3e 6e  ert( idx<(2*p->n
70c0: 52 65 73 43 6f 6c 75 6d 6e 29 20 29 3b 0a 20 20  ResColumn) );.  
70d0: 69 66 28 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  if( sqlite3_mall
70e0: 6f 63 5f 66 61 69 6c 65 64 20 29 20 72 65 74 75  oc_failed ) retu
70f0: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b  rn SQLITE_NOMEM;
7100: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 43  .  assert( p->aC
7110: 6f 6c 4e 61 6d 65 21 3d 30 20 29 3b 0a 20 20 70  olName!=0 );.  p
7120: 43 6f 6c 4e 61 6d 65 20 3d 20 26 28 70 2d 3e 61  ColName = &(p->a
7130: 43 6f 6c 4e 61 6d 65 5b 69 64 78 5d 29 3b 0a 20  ColName[idx]);. 
7140: 20 69 66 28 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d   if( N==P3_DYNAM
7150: 49 43 20 7c 7c 20 4e 3d 3d 50 33 5f 53 54 41 54  IC || N==P3_STAT
7160: 49 43 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73  IC ){.    rc = s
7170: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
7180: 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20 7a 4e  Str(pColName, zN
7190: 61 6d 65 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f  ame, -1, SQLITE_
71a0: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 41  UTF8, SQLITE_STA
71b0: 54 49 43 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  TIC);.  }else{. 
71c0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
71d0: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 6f  dbeMemSetStr(pCo
71e0: 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 4e 2c  lName, zName, N,
71f0: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 53 51 4c   SQLITE_UTF8,SQL
7200: 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a  ITE_TRANSIENT);.
7210: 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51    }.  if( rc==SQ
7220: 4c 49 54 45 5f 4f 4b 20 26 26 20 4e 3d 3d 50 33  LITE_OK && N==P3
7230: 5f 44 59 4e 41 4d 49 43 20 29 7b 0a 20 20 20 20  _DYNAMIC ){.    
7240: 70 43 6f 6c 4e 61 6d 65 2d 3e 66 6c 61 67 73 20  pColName->flags 
7250: 3d 20 28 70 43 6f 6c 4e 61 6d 65 2d 3e 66 6c 61  = (pColName->fla
7260: 67 73 26 28 7e 4d 45 4d 5f 53 74 61 74 69 63 29  gs&(~MEM_Static)
7270: 29 7c 4d 45 4d 5f 44 79 6e 3b 0a 20 20 20 20 70  )|MEM_Dyn;.    p
7280: 43 6f 6c 4e 61 6d 65 2d 3e 78 44 65 6c 20 3d 20  ColName->xDel = 
7290: 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  0;.  }.  return 
72a0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 72  rc;.}../*.** A r
72b0: 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 72 61  ead or write tra
72c0: 6e 73 61 63 74 69 6f 6e 20 6d 61 79 20 6f 72 20  nsaction may or 
72d0: 6d 61 79 20 6e 6f 74 20 62 65 20 61 63 74 69 76  may not be activ
72e0: 65 20 6f 6e 20 64 61 74 61 62 61 73 65 20 68 61  e on database ha
72f0: 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 49 66 20 61  ndle.** db. If a
7300: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
7310: 61 63 74 69 76 65 2c 20 63 6f 6d 6d 69 74 20 69  active, commit i
7320: 74 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 61  t. If there is a
7330: 0a 2a 2a 20 77 72 69 74 65 2d 74 72 61 6e 73 61  .** write-transa
7340: 63 74 69 6f 6e 20 73 70 61 6e 6e 69 6e 67 20 6d  ction spanning m
7350: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 64 61 74  ore than one dat
7360: 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68 69 73  abase file, this
7370: 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 74 61 6b 65   routine.** take
7380: 73 20 63 61 72 65 20 6f 66 20 74 68 65 20 6d 61  s care of the ma
7390: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 74 72 69  ster journal tri
73a0: 63 6b 65 72 79 2e 0a 2a 2f 0a 73 74 61 74 69 63  ckery..*/.static
73b0: 20 69 6e 74 20 76 64 62 65 43 6f 6d 6d 69 74 28   int vdbeCommit(
73c0: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20  sqlite3 *db){.  
73d0: 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 6e 54 72  int i;.  int nTr
73e0: 61 6e 73 20 3d 20 30 3b 20 20 2f 2a 20 4e 75 6d  ans = 0;  /* Num
73f0: 62 65 72 20 6f 66 20 64 61 74 61 62 61 73 65 73  ber of databases
7400: 20 77 69 74 68 20 61 6e 20 61 63 74 69 76 65 20   with an active 
7410: 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f  write-transactio
7420: 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20  n */.  int rc = 
7430: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74  SQLITE_OK;.  int
7440: 20 6e 65 65 64 58 63 6f 6d 6d 69 74 20 3d 20 30   needXcommit = 0
7450: 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  ;..  for(i=0; i<
7460: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a  db->nDb; i++){ .
7470: 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d      Btree *pBt =
7480: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b   db->aDb[i].pBt;
7490: 0a 20 20 20 20 69 66 28 20 70 42 74 20 26 26 20  .    if( pBt && 
74a0: 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e  sqlite3BtreeIsIn
74b0: 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20 20  Trans(pBt) ){.  
74c0: 20 20 20 20 6e 65 65 64 58 63 6f 6d 6d 69 74 20      needXcommit 
74d0: 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28 20 69  = 1;.      if( i
74e0: 21 3d 31 20 29 20 6e 54 72 61 6e 73 2b 2b 3b 0a  !=1 ) nTrans++;.
74f0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
7500: 49 66 20 74 68 65 72 65 20 61 72 65 20 61 6e 79  If there are any
7510: 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69   write-transacti
7520: 6f 6e 73 20 61 74 20 61 6c 6c 2c 20 69 6e 76 6f  ons at all, invo
7530: 6b 65 20 74 68 65 20 63 6f 6d 6d 69 74 20 68 6f  ke the commit ho
7540: 6f 6b 20 2a 2f 0a 20 20 69 66 28 20 6e 65 65 64  ok */.  if( need
7550: 58 63 6f 6d 6d 69 74 20 26 26 20 64 62 2d 3e 78  Xcommit && db->x
7560: 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 20 29  CommitCallback )
7570: 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20  {.    int rc;.  
7580: 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f    sqlite3SafetyO
7590: 66 66 28 64 62 29 3b 0a 20 20 20 20 72 63 20 3d  ff(db);.    rc =
75a0: 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c   db->xCommitCall
75b0: 62 61 63 6b 28 64 62 2d 3e 70 43 6f 6d 6d 69 74  back(db->pCommit
75c0: 41 72 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Arg);.    sqlite
75d0: 33 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20  3SafetyOn(db);. 
75e0: 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20     if( rc ){.   
75f0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
7600: 5f 43 4f 4e 53 54 52 41 49 4e 54 3b 0a 20 20 20  _CONSTRAINT;.   
7610: 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65   }.  }..  /* The
7620: 20 73 69 6d 70 6c 65 20 63 61 73 65 20 2d 20 6e   simple case - n
7630: 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20  o more than one 
7640: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 6e  database file (n
7650: 6f 74 20 63 6f 75 6e 74 69 6e 67 20 74 68 65 0a  ot counting the.
7660: 20 20 2a 2a 20 54 45 4d 50 20 64 61 74 61 62 61    ** TEMP databa
7670: 73 65 29 20 68 61 73 20 61 20 74 72 61 6e 73 61  se) has a transa
7680: 63 74 69 6f 6e 20 61 63 74 69 76 65 2e 20 20 20  ction active.   
7690: 54 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64  There is no need
76a0: 20 66 6f 72 20 74 68 65 0a 20 20 2a 2a 20 6d 61   for the.  ** ma
76b0: 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20  ster-journal..  
76c0: 2a 2a 0a 20 20 2a 2a 20 49 66 20 74 68 65 20 72  **.  ** If the r
76d0: 65 74 75 72 6e 20 76 61 6c 75 65 20 6f 66 20 73  eturn value of s
76e0: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 46 69  qlite3BtreeGetFi
76f0: 6c 65 6e 61 6d 65 28 29 20 69 73 20 61 20 7a 65  lename() is a ze
7700: 72 6f 20 6c 65 6e 67 74 68 0a 20 20 2a 2a 20 73  ro length.  ** s
7710: 74 72 69 6e 67 2c 20 69 74 20 6d 65 61 6e 73 20  tring, it means 
7720: 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73  the main databas
7730: 65 20 69 73 20 3a 6d 65 6d 6f 72 79 3a 2e 20 20  e is :memory:.  
7740: 49 6e 20 74 68 61 74 20 63 61 73 65 20 77 65 20  In that case we 
7750: 64 6f 0a 20 20 2a 2a 20 6e 6f 74 20 73 75 70 70  do.  ** not supp
7760: 6f 72 74 20 61 74 6f 6d 69 63 20 6d 75 6c 74 69  ort atomic multi
7770: 2d 66 69 6c 65 20 63 6f 6d 6d 69 74 73 2c 20 73  -file commits, s
7780: 6f 20 75 73 65 20 74 68 65 20 73 69 6d 70 6c 65  o use the simple
7790: 20 63 61 73 65 20 74 68 65 6e 0a 20 20 2a 2a 20   case then.  ** 
77a0: 74 6f 6f 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  too..  */.  if( 
77b0: 30 3d 3d 73 74 72 6c 65 6e 28 73 71 6c 69 74 65  0==strlen(sqlite
77c0: 33 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d  3BtreeGetFilenam
77d0: 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74  e(db->aDb[0].pBt
77e0: 29 29 20 7c 7c 20 6e 54 72 61 6e 73 3c 3d 31 20  )) || nTrans<=1 
77f0: 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  ){.    for(i=0; 
7800: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
7810: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
7820: 7b 20 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a  { .      Btree *
7830: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d  pBt = db->aDb[i]
7840: 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20  .pBt;.      if( 
7850: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 72  pBt ){.        r
7860: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
7870: 53 79 6e 63 28 70 42 74 2c 20 30 29 3b 0a 20 20  Sync(pBt, 0);.  
7880: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20      }.    }..   
7890: 20 2f 2a 20 44 6f 20 74 68 65 20 63 6f 6d 6d 69   /* Do the commi
78a0: 74 20 6f 6e 6c 79 20 69 66 20 61 6c 6c 20 64 61  t only if all da
78b0: 74 61 62 61 73 65 73 20 73 75 63 63 65 73 73 66  tabases successf
78c0: 75 6c 6c 79 20 73 79 6e 63 65 64 20 2a 2f 0a 20  ully synced */. 
78d0: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
78e0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 66 6f  E_OK ){.      fo
78f0: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62  r(i=0; i<db->nDb
7900: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20  ; i++){.        
7910: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d  Btree *pBt = db-
7920: 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20  >aDb[i].pBt;.   
7930: 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a       if( pBt ){.
7940: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
7950: 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 70 42 74  3BtreeCommit(pBt
7960: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
7970: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a     }.    }.  }..
7980: 20 20 2f 2a 20 54 68 65 20 63 6f 6d 70 6c 65 78    /* The complex
7990: 20 63 61 73 65 20 2d 20 54 68 65 72 65 20 69 73   case - There is
79a0: 20 61 20 6d 75 6c 74 69 2d 66 69 6c 65 20 77 72   a multi-file wr
79b0: 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20  ite-transaction 
79c0: 61 63 74 69 76 65 2e 0a 20 20 2a 2a 20 54 68 69  active..  ** Thi
79d0: 73 20 72 65 71 75 69 72 65 73 20 61 20 6d 61 73  s requires a mas
79e0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
79f0: 20 74 6f 20 65 6e 73 75 72 65 20 74 68 65 20 74   to ensure the t
7a00: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 0a 20 20  ransaction is.  
7a10: 2a 2a 20 63 6f 6d 6d 69 74 74 65 64 20 61 74 6f  ** committed ato
7a20: 6d 69 63 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 6c  micly..  */.  el
7a30: 73 65 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4d  se{.    char *zM
7a40: 61 73 74 65 72 20 3d 20 30 3b 20 20 20 2f 2a 20  aster = 0;   /* 
7a50: 46 69 6c 65 2d 6e 61 6d 65 20 66 6f 72 20 74 68  File-name for th
7a60: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
7a70: 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 63 6f 6e   */.    char con
7a80: 73 74 20 2a 7a 4d 61 69 6e 46 69 6c 65 20 3d 20  st *zMainFile = 
7a90: 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 46  sqlite3BtreeGetF
7aa0: 69 6c 65 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b  ilename(db->aDb[
7ab0: 30 5d 2e 70 42 74 29 3b 0a 20 20 20 20 4f 73 46  0].pBt);.    OsF
7ac0: 69 6c 65 20 6d 61 73 74 65 72 3b 0a 0a 20 20 20  ile master;..   
7ad0: 20 2f 2a 20 53 65 6c 65 63 74 20 61 20 6d 61 73   /* Select a mas
7ae0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
7af0: 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 64 6f 20   name */.    do 
7b00: 7b 0a 20 20 20 20 20 20 75 33 32 20 72 61 6e 64  {.      u32 rand
7b10: 6f 6d 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  om;.      sqlite
7b20: 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20  Free(zMaster);. 
7b30: 20 20 20 20 20 73 71 6c 69 74 65 33 52 61 6e 64       sqlite3Rand
7b40: 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66 28 72 61  omness(sizeof(ra
7b50: 6e 64 6f 6d 29 2c 20 26 72 61 6e 64 6f 6d 29 3b  ndom), &random);
7b60: 0a 20 20 20 20 20 20 7a 4d 61 73 74 65 72 20 3d  .      zMaster =
7b70: 20 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28   sqlite3MPrintf(
7b80: 22 25 73 2d 6d 6a 25 30 38 58 22 2c 20 7a 4d 61  "%s-mj%08X", zMa
7b90: 69 6e 46 69 6c 65 2c 20 72 61 6e 64 6f 6d 26 30  inFile, random&0
7ba0: 78 37 66 66 66 66 66 66 66 29 3b 0a 20 20 20 20  x7fffffff);.    
7bb0: 20 20 69 66 28 20 21 7a 4d 61 73 74 65 72 20 29    if( !zMaster )
7bc0: 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  {.        return
7bd0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
7be0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 77 68 69 6c       }.    }whil
7bf0: 65 28 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65  e( sqlite3OsFile
7c00: 45 78 69 73 74 73 28 7a 4d 61 73 74 65 72 29 20  Exists(zMaster) 
7c10: 29 3b 0a 0a 20 20 20 20 2f 2a 20 4f 70 65 6e 20  );..    /* Open 
7c20: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  the master journ
7c30: 61 6c 2e 20 2a 2f 0a 20 20 20 20 6d 65 6d 73 65  al. */.    memse
7c40: 74 28 26 6d 61 73 74 65 72 2c 20 30 2c 20 73 69  t(&master, 0, si
7c50: 7a 65 6f 66 28 6d 61 73 74 65 72 29 29 3b 0a 20  zeof(master));. 
7c60: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f     rc = sqlite3O
7c70: 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 28 7a  sOpenExclusive(z
7c80: 4d 61 73 74 65 72 2c 20 26 6d 61 73 74 65 72 2c  Master, &master,
7c90: 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21   0);.    if( rc!
7ca0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
7cb0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a      sqliteFree(z
7cc0: 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 72  Master);.      r
7cd0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a  eturn rc;.    }.
7ce0: 20 0a 20 20 20 20 2f 2a 20 57 72 69 74 65 20 74   .    /* Write t
7cf0: 68 65 20 6e 61 6d 65 20 6f 66 20 65 61 63 68 20  he name of each 
7d00: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e  database file in
7d10: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
7d20: 20 69 6e 74 6f 20 74 68 65 20 6e 65 77 0a 20 20   into the new.  
7d30: 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72    ** master jour
7d40: 6e 61 6c 20 66 69 6c 65 2e 20 49 66 20 61 6e 20  nal file. If an 
7d50: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61 74 20  error occurs at 
7d60: 74 68 69 73 20 70 6f 69 6e 74 20 63 6c 6f 73 65  this point close
7d70: 0a 20 20 20 20 2a 2a 20 61 6e 64 20 64 65 6c 65  .    ** and dele
7d80: 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  te the master jo
7d90: 75 72 6e 61 6c 20 66 69 6c 65 2e 20 41 6c 6c 20  urnal file. All 
7da0: 74 68 65 20 69 6e 64 69 76 69 64 75 61 6c 20 6a  the individual j
7db0: 6f 75 72 6e 61 6c 20 66 69 6c 65 73 0a 20 20 20  ournal files.   
7dc0: 20 2a 2a 20 73 74 69 6c 6c 20 68 61 76 65 20 27   ** still have '
7dd0: 6e 75 6c 6c 27 20 61 73 20 74 68 65 20 6d 61 73  null' as the mas
7de0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e  ter journal poin
7df0: 74 65 72 2c 20 73 6f 20 74 68 65 79 20 77 69 6c  ter, so they wil
7e00: 6c 20 72 6f 6c 6c 0a 20 20 20 20 2a 2a 20 62 61  l roll.    ** ba
7e10: 63 6b 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79  ck independently
7e20: 20 69 66 20 61 20 66 61 69 6c 75 72 65 20 6f 63   if a failure oc
7e30: 63 75 72 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  curs..    */.   
7e40: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e   for(i=0; i<db->
7e50: 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20  nDb; i++){ .    
7e60: 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64    Btree *pBt = d
7e70: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20  b->aDb[i].pBt;. 
7e80: 20 20 20 20 20 69 66 28 20 69 3d 3d 31 20 29 20       if( i==1 ) 
7e90: 63 6f 6e 74 69 6e 75 65 3b 20 20 20 2f 2a 20 49  continue;   /* I
7ea0: 67 6e 6f 72 65 20 74 68 65 20 54 45 4d 50 20 64  gnore the TEMP d
7eb0: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 20 20 20  atabase */.     
7ec0: 20 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69   if( pBt && sqli
7ed0: 74 65 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e  te3BtreeIsInTran
7ee0: 73 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20  s(pBt) ){.      
7ef0: 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46    char const *zF
7f00: 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 42 74 72  ile = sqlite3Btr
7f10: 65 65 47 65 74 4a 6f 75 72 6e 61 6c 6e 61 6d 65  eeGetJournalname
7f20: 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20 20 69  (pBt);.        i
7f30: 66 28 20 7a 46 69 6c 65 5b 30 5d 3d 3d 30 20 29  f( zFile[0]==0 )
7f40: 20 63 6f 6e 74 69 6e 75 65 3b 20 20 2f 2a 20 49   continue;  /* I
7f50: 67 6e 6f 72 65 20 3a 6d 65 6d 6f 72 79 3a 20 64  gnore :memory: d
7f60: 61 74 61 62 61 73 65 73 20 2a 2f 0a 20 20 20 20  atabases */.    
7f70: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
7f80: 4f 73 57 72 69 74 65 28 26 6d 61 73 74 65 72 2c  OsWrite(&master,
7f90: 20 7a 46 69 6c 65 2c 20 73 74 72 6c 65 6e 28 7a   zFile, strlen(z
7fa0: 46 69 6c 65 29 2b 31 29 3b 0a 20 20 20 20 20 20  File)+1);.      
7fb0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
7fc0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20  _OK ){.         
7fd0: 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28   sqlite3OsClose(
7fe0: 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  &master);.      
7ff0: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 6c      sqlite3OsDel
8000: 65 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ete(zMaster);.  
8010: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72          sqliteFr
8020: 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20  ee(zMaster);.   
8030: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63         return rc
8040: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
8050: 20 20 7d 0a 20 20 20 20 7d 0a 0a 0a 20 20 20 20    }.    }...    
8060: 2f 2a 20 53 79 6e 63 20 74 68 65 20 6d 61 73 74  /* Sync the mast
8070: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e  er journal file.
8080: 20 42 65 66 6f 72 65 20 64 6f 69 6e 67 20 74 68   Before doing th
8090: 69 73 2c 20 6f 70 65 6e 20 74 68 65 20 64 69 72  is, open the dir
80a0: 65 63 74 6f 72 79 0a 20 20 20 20 2a 2a 20 74 68  ectory.    ** th
80b0: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
80c0: 20 66 69 6c 65 20 69 73 20 73 74 6f 72 65 20 69   file is store i
80d0: 6e 20 73 6f 20 74 68 61 74 20 69 74 20 67 65 74  n so that it get
80e0: 73 20 73 79 6e 63 65 64 20 74 6f 6f 2e 0a 20 20  s synced too..  
80f0: 20 20 2a 2f 0a 20 20 20 20 7a 4d 61 69 6e 46 69    */.    zMainFi
8100: 6c 65 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  le = sqlite3Btre
8110: 65 47 65 74 44 69 72 6e 61 6d 65 28 64 62 2d 3e  eGetDirname(db->
8120: 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 20  aDb[0].pBt);.   
8130: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f   rc = sqlite3OsO
8140: 70 65 6e 44 69 72 65 63 74 6f 72 79 28 7a 4d 61  penDirectory(zMa
8150: 69 6e 46 69 6c 65 2c 20 26 6d 61 73 74 65 72 29  inFile, &master)
8160: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
8170: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 72 63 20 3d  LITE_OK || (rc =
8180: 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 26   sqlite3OsSync(&
8190: 6d 61 73 74 65 72 29 29 21 3d 53 51 4c 49 54 45  master))!=SQLITE
81a0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  _OK ){.      sql
81b0: 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73  ite3OsClose(&mas
81c0: 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  ter);.      sqli
81d0: 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73  te3OsDelete(zMas
81e0: 74 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  ter);.      sqli
81f0: 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b  teFree(zMaster);
8200: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63  .      return rc
8210: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20  ;.    }..    /* 
8220: 53 79 6e 63 20 61 6c 6c 20 74 68 65 20 64 62 20  Sync all the db 
8230: 66 69 6c 65 73 20 69 6e 76 6f 6c 76 65 64 20 69  files involved i
8240: 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  n the transactio
8250: 6e 2e 20 54 68 65 20 73 61 6d 65 20 63 61 6c 6c  n. The same call
8260: 0a 20 20 20 20 2a 2a 20 73 65 74 73 20 74 68 65  .    ** sets the
8270: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
8280: 70 6f 69 6e 74 65 72 20 69 6e 20 65 61 63 68 20  pointer in each 
8290: 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e  individual journ
82a0: 61 6c 2e 20 49 66 0a 20 20 20 20 2a 2a 20 61 6e  al. If.    ** an
82b0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 68 65   error occurs he
82c0: 72 65 2c 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74  re, do not delet
82d0: 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  e the master jou
82e0: 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 20 20 2a  rnal file..    *
82f0: 2a 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20  *.    ** If the 
8300: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72  error occurs dur
8310: 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 63 61  ing the first ca
8320: 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72  ll to sqlite3Btr
8330: 65 65 53 79 6e 63 28 29 2c 0a 20 20 20 20 2a 2a  eeSync(),.    **
8340: 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 20 61   then there is a
8350: 20 63 68 61 6e 63 65 20 74 68 61 74 20 74 68 65   chance that the
8360: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
8370: 66 69 6c 65 20 77 69 6c 6c 20 62 65 0a 20 20 20  file will be.   
8380: 20 2a 2a 20 6f 72 70 68 61 6e 65 64 2e 20 42 75   ** orphaned. Bu
8390: 74 20 77 65 20 63 61 6e 6e 6f 74 20 64 65 6c 65  t we cannot dele
83a0: 74 65 20 69 74 2c 20 69 6e 20 63 61 73 65 20 74  te it, in case t
83b0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
83c0: 6c 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 6e 61  l.    ** file na
83d0: 6d 65 20 77 61 73 20 77 72 69 74 74 65 6e 20 69  me was written i
83e0: 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  nto the journal 
83f0: 66 69 6c 65 20 62 65 66 6f 72 65 20 74 68 65 20  file before the 
8400: 66 61 69 6c 75 72 65 0a 20 20 20 20 2a 2a 20 6f  failure.    ** o
8410: 63 63 75 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20  ccured..    */. 
8420: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62     for(i=0; i<db
8430: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20  ->nDb; i++){ .  
8440: 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d      Btree *pBt =
8450: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b   db->aDb[i].pBt;
8460: 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 20 26  .      if( pBt &
8470: 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73  & sqlite3BtreeIs
8480: 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a  InTrans(pBt) ){.
8490: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
84a0: 69 74 65 33 42 74 72 65 65 53 79 6e 63 28 70 42  ite3BtreeSync(pB
84b0: 74 2c 20 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20  t, zMaster);.   
84c0: 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c       if( rc!=SQL
84d0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
84e0: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f      sqlite3OsClo
84f0: 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20 20  se(&master);.   
8500: 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65         sqliteFre
8510: 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20  e(zMaster);.    
8520: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
8530: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
8540: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c   }.    }.    sql
8550: 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73  ite3OsClose(&mas
8560: 74 65 72 29 3b 0a 0a 20 20 20 20 2f 2a 20 44 65  ter);..    /* De
8570: 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65 72 20  lete the master 
8580: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68  journal file. Th
8590: 69 73 20 63 6f 6d 6d 69 74 73 20 74 68 65 20 74  is commits the t
85a0: 72 61 6e 73 61 63 74 69 6f 6e 2e 20 41 66 74 65  ransaction. Afte
85b0: 72 0a 20 20 20 20 2a 2a 20 64 6f 69 6e 67 20 74  r.    ** doing t
85c0: 68 69 73 20 74 68 65 20 64 69 72 65 63 74 6f 72  his the director
85d0: 79 20 69 73 20 73 79 6e 63 65 64 20 61 67 61 69  y is synced agai
85e0: 6e 20 62 65 66 6f 72 65 20 61 6e 79 20 69 6e 64  n before any ind
85f0: 69 76 69 64 75 61 6c 0a 20 20 20 20 2a 2a 20 74  ividual.    ** t
8600: 72 61 6e 73 61 63 74 69 6f 6e 20 66 69 6c 65 73  ransaction files
8610: 20 61 72 65 20 64 65 6c 65 74 65 64 2e 0a 20 20   are deleted..  
8620: 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71    */.    rc = sq
8630: 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d  lite3OsDelete(zM
8640: 61 73 74 65 72 29 3b 0a 20 20 20 20 61 73 73 65  aster);.    asse
8650: 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  rt( rc==SQLITE_O
8660: 4b 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46  K );.    sqliteF
8670: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
8680: 20 20 7a 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20    zMaster = 0;. 
8690: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f     rc = sqlite3O
86a0: 73 53 79 6e 63 44 69 72 65 63 74 6f 72 79 28 7a  sSyncDirectory(z
86b0: 4d 61 69 6e 46 69 6c 65 29 3b 0a 20 20 20 20 69  MainFile);.    i
86c0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
86d0: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69   ){.      /* Thi
86e0: 73 20 69 73 20 6e 6f 74 20 67 6f 6f 64 2e 20 54  s is not good. T
86f0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
8700: 6c 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20  l file has been 
8710: 64 65 6c 65 74 65 64 2c 20 62 75 74 0a 20 20 20  deleted, but.   
8720: 20 20 20 2a 2a 20 74 68 65 20 64 69 72 65 63 74     ** the direct
8730: 6f 72 79 20 73 79 6e 63 20 66 61 69 6c 65 64 2e  ory sync failed.
8740: 20 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f 6d   There is no com
8750: 70 6c 65 74 65 6c 79 20 73 61 66 65 20 63 6f 75  pletely safe cou
8760: 72 73 65 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20  rse of.      ** 
8770: 61 63 74 69 6f 6e 20 66 72 6f 6d 20 68 65 72 65  action from here
8780: 2e 20 54 68 65 20 69 6e 64 69 76 69 64 75 61 6c  . The individual
8790: 20 6a 6f 75 72 6e 61 6c 73 20 63 6f 6e 74 61 69   journals contai
87a0: 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  n the name of th
87b0: 65 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73 74 65  e.      ** maste
87c0: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20  r journal file, 
87d0: 62 75 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20  but there is no 
87e0: 77 61 79 20 6f 66 20 6b 6e 6f 77 69 6e 67 20 69  way of knowing i
87f0: 66 20 74 68 61 74 0a 20 20 20 20 20 20 2a 2a 20  f that.      ** 
8800: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 65  master journal e
8810: 78 69 73 74 73 20 6e 6f 77 20 6f 72 20 69 66 20  xists now or if 
8820: 69 74 20 77 69 6c 6c 20 65 78 69 73 74 20 61 66  it will exist af
8830: 74 65 72 20 74 68 65 20 6f 70 65 72 61 74 69 6e  ter the operatin
8840: 67 0a 20 20 20 20 20 20 2a 2a 20 73 79 73 74 65  g.      ** syste
8850: 6d 20 63 72 61 73 68 20 74 68 61 74 20 6d 61 79  m crash that may
8860: 20 66 6f 6c 6c 6f 77 20 74 68 65 20 66 73 79 6e   follow the fsyn
8870: 63 28 29 20 66 61 69 6c 75 72 65 2e 0a 20 20 20  c() failure..   
8880: 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75     */.      retu
8890: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20  rn rc;.    }..  
88a0: 20 20 2f 2a 20 41 6c 6c 20 66 69 6c 65 73 20 61    /* All files a
88b0: 6e 64 20 64 69 72 65 63 74 6f 72 69 65 73 20 68  nd directories h
88c0: 61 76 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e  ave already been
88d0: 20 73 79 6e 63 65 64 2c 20 73 6f 20 74 68 65 20   synced, so the 
88e0: 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 2a 2a  following.    **
88f0: 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74 65   calls to sqlite
8900: 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 29 20 61  3BtreeCommit() a
8910: 72 65 20 6f 6e 6c 79 20 63 6c 6f 73 69 6e 67 20  re only closing 
8920: 66 69 6c 65 73 20 61 6e 64 20 64 65 6c 65 74 69  files and deleti
8930: 6e 67 0a 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61  ng.    ** journa
8940: 6c 73 2e 20 49 66 20 73 6f 6d 65 74 68 69 6e 67  ls. If something
8950: 20 67 6f 65 73 20 77 72 6f 6e 67 20 77 68 69 6c   goes wrong whil
8960: 65 20 74 68 69 73 20 69 73 20 68 61 70 70 65 6e  e this is happen
8970: 69 6e 67 20 77 65 20 64 6f 6e 27 74 0a 20 20 20  ing we don't.   
8980: 20 2a 2a 20 72 65 61 6c 6c 79 20 63 61 72 65 2e   ** really care.
8990: 20 54 68 65 20 69 6e 74 65 67 72 69 74 79 20 6f   The integrity o
89a0: 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  f the transactio
89b0: 6e 20 69 73 20 61 6c 72 65 61 64 79 20 67 75 61  n is already gua
89c0: 72 61 6e 74 65 65 64 2c 0a 20 20 20 20 2a 2a 20  ranteed,.    ** 
89d0: 62 75 74 20 73 6f 6d 65 20 73 74 72 61 79 20 27  but some stray '
89e0: 63 6f 6c 64 27 20 6a 6f 75 72 6e 61 6c 73 20 6d  cold' journals m
89f0: 61 79 20 62 65 20 6c 79 69 6e 67 20 61 72 6f 75  ay be lying arou
8a00: 6e 64 2e 20 52 65 74 75 72 6e 69 6e 67 20 61 6e  nd. Returning an
8a10: 0a 20 20 20 20 2a 2a 20 65 72 72 6f 72 20 63 6f  .    ** error co
8a20: 64 65 20 77 6f 6e 27 74 20 68 65 6c 70 20 6d 61  de won't help ma
8a30: 74 74 65 72 73 2e 0a 20 20 20 20 2a 2f 0a 20 20  tters..    */.  
8a40: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d    for(i=0; i<db-
8a50: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20  >nDb; i++){ .   
8a60: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
8a70: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
8a80: 20 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b        if( pBt ){
8a90: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
8aa0: 42 74 72 65 65 43 6f 6d 6d 69 74 28 70 42 74 29  BtreeCommit(pBt)
8ab0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
8ac0: 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63    }..  return rc
8ad0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20  ;.}../*.** Find 
8ae0: 65 76 65 72 79 20 61 63 74 69 76 65 20 56 4d 20  every active VM 
8af0: 6f 74 68 65 72 20 74 68 61 6e 20 70 56 64 62 65  other than pVdbe
8b00: 20 61 6e 64 20 63 68 61 6e 67 65 20 69 74 73 20   and change its 
8b10: 73 74 61 74 75 73 20 74 6f 0a 2a 2a 20 61 62 6f  status to.** abo
8b20: 72 74 65 64 2e 20 20 54 68 69 73 20 68 61 70 70  rted.  This happ
8b30: 65 6e 73 20 77 68 65 6e 20 6f 6e 65 20 56 4d 20  ens when one VM 
8b40: 63 61 75 73 65 73 20 61 20 72 6f 6c 6c 62 61 63  causes a rollbac
8b50: 6b 20 64 75 65 20 74 6f 20 61 6e 0a 2a 2a 20 4f  k due to an.** O
8b60: 4e 20 43 4f 4e 46 4c 49 43 54 20 52 4f 4c 4c 42  N CONFLICT ROLLB
8b70: 41 43 4b 20 63 6c 61 75 73 65 20 28 66 6f 72 20  ACK clause (for 
8b80: 65 78 61 6d 70 6c 65 29 2e 20 20 54 68 65 20 6f  example).  The o
8b90: 74 68 65 72 20 56 4d 73 20 6d 75 73 74 20 62 65  ther VMs must be
8ba0: 0a 2a 2a 20 61 62 6f 72 74 65 64 20 73 6f 20 74  .** aborted so t
8bb0: 68 61 74 20 74 68 65 79 20 64 6f 20 6e 6f 74 20  hat they do not 
8bc0: 68 61 76 65 20 64 61 74 61 20 72 6f 6c 6c 65 64  have data rolled
8bd0: 20 6f 75 74 20 66 72 6f 6d 20 75 6e 64 65 72 6e   out from undern
8be0: 65 61 74 68 0a 2a 2a 20 74 68 65 6d 20 6c 65 61  eath.** them lea
8bf0: 64 69 6e 67 20 74 6f 20 61 20 73 65 67 66 61 75  ding to a segfau
8c00: 6c 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  lt..*/.static vo
8c10: 69 64 20 61 62 6f 72 74 4f 74 68 65 72 41 63 74  id abortOtherAct
8c20: 69 76 65 56 64 62 65 73 28 56 64 62 65 20 2a 70  iveVdbes(Vdbe *p
8c30: 56 64 62 65 29 7b 0a 20 20 56 64 62 65 20 2a 70  Vdbe){.  Vdbe *p
8c40: 4f 74 68 65 72 3b 0a 20 20 66 6f 72 28 70 4f 74  Other;.  for(pOt
8c50: 68 65 72 3d 70 56 64 62 65 2d 3e 64 62 2d 3e 70  her=pVdbe->db->p
8c60: 56 64 62 65 3b 20 70 4f 74 68 65 72 3b 20 70 4f  Vdbe; pOther; pO
8c70: 74 68 65 72 3d 70 4f 74 68 65 72 2d 3e 70 4e 65  ther=pOther->pNe
8c80: 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 4f 74  xt){.    if( pOt
8c90: 68 65 72 3d 3d 70 56 64 62 65 20 29 20 63 6f 6e  her==pVdbe ) con
8ca0: 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 70  tinue;.    if( p
8cb0: 4f 74 68 65 72 2d 3e 6d 61 67 69 63 21 3d 56 44  Other->magic!=VD
8cc0: 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 7c 7c 20  BE_MAGIC_RUN || 
8cd0: 70 4f 74 68 65 72 2d 3e 70 63 3c 30 20 29 20 63  pOther->pc<0 ) c
8ce0: 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 63 6c 6f  ontinue;.    clo
8cf0: 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 4f 74  seAllCursors(pOt
8d00: 68 65 72 29 3b 0a 20 20 20 20 70 4f 74 68 65 72  her);.    pOther
8d10: 2d 3e 61 62 6f 72 74 65 64 20 3d 20 31 3b 0a 20  ->aborted = 1;. 
8d20: 20 7d 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 69   }.}../* .** Thi
8d30: 73 20 72 6f 75 74 69 6e 65 20 63 68 65 63 6b 73  s routine checks
8d40: 20 74 68 61 74 20 74 68 65 20 73 71 6c 69 74 65   that the sqlite
8d50: 33 2e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20  3.activeVdbeCnt 
8d60: 63 6f 75 6e 74 20 76 61 72 69 61 62 6c 65 0a 2a  count variable.*
8d70: 2a 20 6d 61 74 63 68 65 73 20 74 68 65 20 6e 75  * matches the nu
8d80: 6d 62 65 72 20 6f 66 20 76 64 62 65 27 73 20 69  mber of vdbe's i
8d90: 6e 20 74 68 65 20 6c 69 73 74 20 73 71 6c 69 74  n the list sqlit
8da0: 65 33 2e 70 56 64 62 65 20 74 68 61 74 20 61 72  e3.pVdbe that ar
8db0: 65 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 61  e.** currently a
8dc0: 63 74 69 76 65 2e 20 41 6e 20 61 73 73 65 72 74  ctive. An assert
8dd0: 69 6f 6e 20 66 61 69 6c 73 20 69 66 20 74 68 65  ion fails if the
8de0: 20 74 77 6f 20 63 6f 75 6e 74 73 20 64 6f 20 6e   two counts do n
8df0: 6f 74 20 6d 61 74 63 68 2e 0a 2a 2a 20 54 68 69  ot match..** Thi
8e00: 73 20 69 73 20 61 6e 20 69 6e 74 65 72 6e 61 6c  s is an internal
8e10: 20 73 65 6c 66 2d 63 68 65 63 6b 20 6f 6e 6c 79   self-check only
8e20: 20 2d 20 69 74 20 69 73 20 6e 6f 74 20 61 6e 20   - it is not an 
8e30: 65 73 73 65 6e 74 69 61 6c 20 70 72 6f 63 65 73  essential proces
8e40: 73 69 6e 67 0a 2a 2a 20 73 74 65 70 2e 0a 2a 2a  sing.** step..**
8e50: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 6e 6f  .** This is a no
8e60: 2d 6f 70 20 69 66 20 4e 44 45 42 55 47 20 69 73  -op if NDEBUG is
8e70: 20 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 23 69 66   defined..*/.#if
8e80: 6e 64 65 66 20 4e 44 45 42 55 47 0a 73 74 61 74  ndef NDEBUG.stat
8e90: 69 63 20 76 6f 69 64 20 63 68 65 63 6b 41 63 74  ic void checkAct
8ea0: 69 76 65 56 64 62 65 43 6e 74 28 73 71 6c 69 74  iveVdbeCnt(sqlit
8eb0: 65 33 20 2a 64 62 29 7b 0a 20 20 56 64 62 65 20  e3 *db){.  Vdbe 
8ec0: 2a 70 3b 0a 20 20 69 6e 74 20 63 6e 74 20 3d 20  *p;.  int cnt = 
8ed0: 30 3b 0a 20 20 70 20 3d 20 64 62 2d 3e 70 56 64  0;.  p = db->pVd
8ee0: 62 65 3b 0a 20 20 77 68 69 6c 65 28 20 70 20 29  be;.  while( p )
8ef0: 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 6d 61 67  {.    if( p->mag
8f00: 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52  ic==VDBE_MAGIC_R
8f10: 55 4e 20 26 26 20 70 2d 3e 70 63 3e 3d 30 20 29  UN && p->pc>=0 )
8f20: 7b 0a 20 20 20 20 20 20 63 6e 74 2b 2b 3b 0a 20  {.      cnt++;. 
8f30: 20 20 20 7d 0a 20 20 20 20 70 20 3d 20 70 2d 3e     }.    p = p->
8f40: 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 61 73 73  pNext;.  }.  ass
8f50: 65 72 74 28 20 63 6e 74 3d 3d 64 62 2d 3e 61 63  ert( cnt==db->ac
8f60: 74 69 76 65 56 64 62 65 43 6e 74 20 29 3b 0a 7d  tiveVdbeCnt );.}
8f70: 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 63  .#else.#define c
8f80: 68 65 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e  heckActiveVdbeCn
8f90: 74 28 78 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  t(x).#endif../*.
8fa0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
8fb0: 69 73 20 63 61 6c 6c 65 64 20 74 68 65 20 77 68  is called the wh
8fc0: 65 6e 20 61 20 56 44 42 45 20 74 72 69 65 73 20  en a VDBE tries 
8fd0: 74 6f 20 68 61 6c 74 2e 20 20 49 66 20 74 68 65  to halt.  If the
8fe0: 20 56 44 42 45 0a 2a 2a 20 68 61 73 20 6d 61 64   VDBE.** has mad
8ff0: 65 20 63 68 61 6e 67 65 73 20 61 6e 64 20 69 73  e changes and is
9000: 20 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 20 6d   in autocommit m
9010: 6f 64 65 2c 20 74 68 65 6e 20 63 6f 6d 6d 69 74  ode, then commit
9020: 20 74 68 6f 73 65 0a 2a 2a 20 63 68 61 6e 67 65   those.** change
9030: 73 2e 20 20 49 66 20 61 20 72 6f 6c 6c 62 61 63  s.  If a rollbac
9040: 6b 20 69 73 20 6e 65 65 64 65 64 2c 20 74 68 65  k is needed, the
9050: 6e 20 64 6f 20 74 68 65 20 72 6f 6c 6c 62 61 63  n do the rollbac
9060: 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  k..**.** This ro
9070: 75 74 69 6e 65 20 69 73 20 74 68 65 20 6f 6e 6c  utine is the onl
9080: 79 20 77 61 79 20 74 6f 20 6d 6f 76 65 20 74 68  y way to move th
9090: 65 20 73 74 61 74 65 20 6f 66 20 61 20 56 4d 20  e state of a VM 
90a0: 66 72 6f 6d 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d  from.** SQLITE_M
90b0: 41 47 49 43 5f 52 55 4e 20 74 6f 20 53 51 4c 49  AGIC_RUN to SQLI
90c0: 54 45 5f 4d 41 47 49 43 5f 48 41 4c 54 2e 0a 2a  TE_MAGIC_HALT..*
90d0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 6e 20 65  *.** Return an e
90e0: 72 72 6f 72 20 63 6f 64 65 2e 20 20 49 66 20 74  rror code.  If t
90f0: 68 65 20 63 6f 6d 6d 69 74 20 63 6f 75 6c 64 20  he commit could 
9100: 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 20 62 65 63  not complete bec
9110: 61 75 73 65 20 6f 66 0a 2a 2a 20 6c 6f 63 6b 20  ause of.** lock 
9120: 63 6f 6e 74 65 6e 74 69 6f 6e 2c 20 72 65 74 75  contention, retu
9130: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20  rn SQLITE_BUSY. 
9140: 20 49 66 20 53 51 4c 49 54 45 5f 42 55 53 59 20   If SQLITE_BUSY 
9150: 69 73 20 72 65 74 75 72 6e 65 64 2c 20 69 74 0a  is returned, it.
9160: 2a 2a 20 6d 65 61 6e 73 20 74 68 65 20 63 6c 6f  ** means the clo
9170: 73 65 20 64 69 64 20 6e 6f 74 20 68 61 70 70 65  se did not happe
9180: 6e 20 61 6e 64 20 6e 65 65 64 73 20 74 6f 20 62  n and needs to b
9190: 65 20 72 65 70 65 61 74 65 64 2e 0a 2a 2f 0a 69  e repeated..*/.i
91a0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 48 61  nt sqlite3VdbeHa
91b0: 6c 74 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73  lt(Vdbe *p){.  s
91c0: 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e  qlite3 *db = p->
91d0: 64 62 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  db;.  int i;.  i
91e0: 6e 74 20 28 2a 78 46 75 6e 63 29 28 42 74 72 65  nt (*xFunc)(Btre
91f0: 65 20 2a 70 42 74 29 20 3d 20 30 3b 20 20 2f 2a  e *pBt) = 0;  /*
9200: 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 63 61 6c   Function to cal
9210: 6c 20 6f 6e 20 65 61 63 68 20 62 74 72 65 65 20  l on each btree 
9220: 62 61 63 6b 65 6e 64 20 2a 2f 0a 0a 20 20 69 66  backend */..  if
9230: 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45  ( p->magic!=VDBE
9240: 5f 4d 41 47 49 43 5f 52 55 4e 20 29 7b 0a 20 20  _MAGIC_RUN ){.  
9250: 20 20 2f 2a 20 41 6c 72 65 61 64 79 20 68 61 6c    /* Already hal
9260: 74 65 64 2e 20 20 4e 6f 74 68 69 6e 67 20 74 6f  ted.  Nothing to
9270: 20 64 6f 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65   do. */.    asse
9280: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
9290: 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 3b  BE_MAGIC_HALT );
92a0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
92b0: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 63 6c 6f  TE_OK;.  }.  clo
92c0: 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 29 3b  seAllCursors(p);
92d0: 0a 20 20 63 68 65 63 6b 41 63 74 69 76 65 56 64  .  checkActiveVd
92e0: 62 65 43 6e 74 28 64 62 29 3b 0a 20 20 69 66 28  beCnt(db);.  if(
92f0: 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 20 20 20 20   p->pc<0 ){.    
9300: 2f 2a 20 4e 6f 20 63 6f 6d 6d 69 74 20 6f 72 20  /* No commit or 
9310: 72 6f 6c 6c 62 61 63 6b 20 6e 65 65 64 65 64 20  rollback needed 
9320: 69 66 20 74 68 65 20 70 72 6f 67 72 61 6d 20 6e  if the program n
9330: 65 76 65 72 20 73 74 61 72 74 65 64 20 2a 2f 0a  ever started */.
9340: 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e    }else if( db->
9350: 61 75 74 6f 43 6f 6d 6d 69 74 20 26 26 20 64 62  autoCommit && db
9360: 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 3d  ->activeVdbeCnt=
9370: 3d 31 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d  =1 ){.    if( p-
9380: 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c  >rc==SQLITE_OK |
9390: 7c 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f 6e  | p->errorAction
93a0: 3d 3d 4f 45 5f 46 61 69 6c 20 29 7b 0a 20 20 20  ==OE_Fail ){.   
93b0: 20 20 20 2f 2a 20 54 68 65 20 61 75 74 6f 2d 63     /* The auto-c
93c0: 6f 6d 6d 69 74 20 66 6c 61 67 20 69 73 20 74 72  ommit flag is tr
93d0: 75 65 2c 20 74 68 65 72 65 20 61 72 65 20 6e 6f  ue, there are no
93e0: 20 6f 74 68 65 72 20 61 63 74 69 76 65 20 71 75   other active qu
93f0: 65 72 69 65 73 0a 20 20 20 20 20 20 2a 2a 20 75  eries.      ** u
9400: 73 69 6e 67 20 74 68 69 73 20 68 61 6e 64 6c 65  sing this handle
9410: 20 61 6e 64 20 74 68 65 20 76 64 62 65 20 70 72   and the vdbe pr
9420: 6f 67 72 61 6d 20 77 61 73 20 73 75 63 63 65 73  ogram was succes
9430: 73 66 75 6c 20 6f 72 20 68 69 74 20 61 6e 0a 20  sful or hit an. 
9440: 20 20 20 20 20 2a 2a 20 27 4f 52 20 46 41 49 4c       ** 'OR FAIL
9450: 27 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20 54 68  ' constraint. Th
9460: 69 73 20 6d 65 61 6e 73 20 61 20 63 6f 6d 6d 69  is means a commi
9470: 74 20 69 73 20 72 65 71 75 69 72 65 64 2e 0a 20  t is required.. 
9480: 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 6e       */.      in
9490: 74 20 72 63 20 3d 20 76 64 62 65 43 6f 6d 6d 69  t rc = vdbeCommi
94a0: 74 28 64 62 29 3b 0a 20 20 20 20 20 20 69 66 28  t(db);.      if(
94b0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59   rc==SQLITE_BUSY
94c0: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75   ){.        retu
94d0: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a  rn SQLITE_BUSY;.
94e0: 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20        }else if( 
94f0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
9500: 0a 20 20 20 20 20 20 20 20 70 2d 3e 72 63 20 3d  .        p->rc =
9510: 20 72 63 3b 0a 20 20 20 20 20 20 20 20 78 46 75   rc;.        xFu
9520: 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  nc = sqlite3Btre
9530: 65 52 6f 6c 6c 62 61 63 6b 3b 0a 20 20 20 20 20  eRollback;.     
9540: 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20   }.    }else{.  
9550: 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c 69      xFunc = sqli
9560: 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  te3BtreeRollback
9570: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  ;.    }.  }else{
9580: 0a 20 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d  .    if( p->rc==
9590: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e  SQLITE_OK || p->
95a0: 65 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f  errorAction==OE_
95b0: 46 61 69 6c 20 29 7b 0a 20 20 20 20 20 20 78 46  Fail ){.      xF
95c0: 75 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72  unc = sqlite3Btr
95d0: 65 65 43 6f 6d 6d 69 74 53 74 6d 74 3b 0a 20 20  eeCommitStmt;.  
95e0: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 65    }else if( p->e
95f0: 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 41  rrorAction==OE_A
9600: 62 6f 72 74 20 29 7b 0a 20 20 20 20 20 20 78 46  bort ){.      xF
9610: 75 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72  unc = sqlite3Btr
9620: 65 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 3b 0a  eeRollbackStmt;.
9630: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
9640: 20 78 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 33   xFunc = sqlite3
9650: 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 3b 0a 20  BtreeRollback;. 
9660: 20 20 20 20 20 64 62 2d 3e 61 75 74 6f 43 6f 6d       db->autoCom
9670: 6d 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 61  mit = 1;.      a
9680: 62 6f 72 74 4f 74 68 65 72 41 63 74 69 76 65 56  bortOtherActiveV
9690: 64 62 65 73 28 70 29 3b 0a 20 20 20 20 7d 0a 20  dbes(p);.    }. 
96a0: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 78 46 75 6e   }..  /* If xFun
96b0: 63 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74  c is not NULL, t
96c0: 68 65 6e 20 69 74 20 69 73 20 6f 6e 65 20 6f 66  hen it is one of
96d0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c   sqlite3BtreeRol
96e0: 6c 62 61 63 6b 2c 0a 20 20 2a 2a 20 73 71 6c 69  lback,.  ** sqli
96f0: 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  te3BtreeRollback
9700: 53 74 6d 74 20 6f 72 20 73 71 6c 69 74 65 33 42  Stmt or sqlite3B
9710: 74 72 65 65 43 6f 6d 6d 69 74 53 74 6d 74 2e 20  treeCommitStmt. 
9720: 43 61 6c 6c 20 69 74 20 6f 6e 63 65 20 6f 6e 0a  Call it once on.
9730: 20 20 2a 2a 20 65 61 63 68 20 62 61 63 6b 65 6e    ** each backen
9740: 64 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f  d. If an error o
9750: 63 63 75 72 73 20 61 6e 64 20 74 68 65 20 72 65  ccurs and the re
9760: 74 75 72 6e 20 63 6f 64 65 20 69 73 20 73 74 69  turn code is sti
9770: 6c 6c 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 4f  ll.  ** SQLITE_O
9780: 4b 2c 20 73 65 74 20 74 68 65 20 72 65 74 75 72  K, set the retur
9790: 6e 20 63 6f 64 65 20 74 6f 20 74 68 65 20 6e 65  n code to the ne
97a0: 77 20 65 72 72 6f 72 20 76 61 6c 75 65 2e 0a 20  w error value.. 
97b0: 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 78   */.  for(i=0; x
97c0: 46 75 6e 63 20 26 26 20 69 3c 64 62 2d 3e 6e 44  Func && i<db->nD
97d0: 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 69 6e  b; i++){ .    in
97e0: 74 20 72 63 3b 0a 20 20 20 20 42 74 72 65 65 20  t rc;.    Btree 
97f0: 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69  *pBt = db->aDb[i
9800: 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70  ].pBt;.    if( p
9810: 42 74 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d  Bt ){.      rc =
9820: 20 78 46 75 6e 63 28 70 42 74 29 3b 0a 20 20 20   xFunc(pBt);.   
9830: 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51     if( p->rc==SQ
9840: 4c 49 54 45 5f 4f 4b 20 29 20 70 2d 3e 72 63 20  LITE_OK ) p->rc 
9850: 3d 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  = rc;.    }.  }.
9860: 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 77 61  .  /* If this wa
9870: 73 20 61 6e 20 49 4e 53 45 52 54 2c 20 55 50 44  s an INSERT, UPD
9880: 41 54 45 20 6f 72 20 44 45 4c 45 54 45 2c 20 73  ATE or DELETE, s
9890: 65 74 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f  et the change co
98a0: 75 6e 74 65 72 2e 20 2a 2f 0a 20 20 69 66 28 20  unter. */.  if( 
98b0: 70 2d 3e 63 68 61 6e 67 65 43 6e 74 4f 6e 20 26  p->changeCntOn &
98c0: 26 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20  & p->pc>=0 ){.  
98d0: 20 20 69 66 28 20 21 78 46 75 6e 63 20 7c 7c 20    if( !xFunc || 
98e0: 78 46 75 6e 63 3d 3d 73 71 6c 69 74 65 33 42 74  xFunc==sqlite3Bt
98f0: 72 65 65 43 6f 6d 6d 69 74 53 74 6d 74 20 29 7b  reeCommitStmt ){
9900: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
9910: 62 65 53 65 74 43 68 61 6e 67 65 73 28 64 62 2c  beSetChanges(db,
9920: 20 70 2d 3e 6e 43 68 61 6e 67 65 29 3b 0a 20 20   p->nChange);.  
9930: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73    }else{.      s
9940: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61  qlite3VdbeSetCha
9950: 6e 67 65 73 28 64 62 2c 20 30 29 3b 0a 20 20 20  nges(db, 0);.   
9960: 20 7d 0a 20 20 20 20 70 2d 3e 6e 43 68 61 6e 67   }.    p->nChang
9970: 65 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  e = 0;.  }..  /*
9980: 20 52 6f 6c 6c 62 61 63 6b 20 6f 72 20 63 6f 6d   Rollback or com
9990: 6d 69 74 20 61 6e 79 20 73 63 68 65 6d 61 20 63  mit any schema c
99a0: 68 61 6e 67 65 73 20 74 68 61 74 20 6f 63 63 75  hanges that occu
99b0: 72 72 65 64 2e 20 2a 2f 0a 20 20 69 66 28 20 70  rred. */.  if( p
99c0: 2d 3e 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ->rc!=SQLITE_OK 
99d0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 6f  ){.    sqlite3Ro
99e0: 6c 6c 62 61 63 6b 49 6e 74 65 72 6e 61 6c 43 68  llbackInternalCh
99f0: 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d 65 6c  anges(db);.  }el
9a00: 73 65 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73  se if( db->flags
9a10: 20 26 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e   & SQLITE_Intern
9a20: 43 68 61 6e 67 65 73 20 29 7b 0a 20 20 20 20 73  Changes ){.    s
9a30: 71 6c 69 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65  qlite3CommitInte
9a40: 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29 3b  rnalChanges(db);
9a50: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 65 20 68 61  .  }..  /* We ha
9a60: 76 65 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20  ve successfully 
9a70: 68 61 6c 74 65 64 20 61 6e 64 20 63 6c 6f 73 65  halted and close
9a80: 64 20 74 68 65 20 56 4d 2e 20 20 52 65 63 6f 72  d the VM.  Recor
9a90: 64 20 74 68 69 73 20 66 61 63 74 2e 20 2a 2f 0a  d this fact. */.
9aa0: 20 20 69 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29    if( p->pc>=0 )
9ab0: 7b 0a 20 20 20 20 64 62 2d 3e 61 63 74 69 76 65  {.    db->active
9ac0: 56 64 62 65 43 6e 74 2d 2d 3b 0a 20 20 7d 0a 20  VdbeCnt--;.  }. 
9ad0: 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45   p->magic = VDBE
9ae0: 5f 4d 41 47 49 43 5f 48 41 4c 54 3b 0a 20 20 63  _MAGIC_HALT;.  c
9af0: 68 65 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e  heckActiveVdbeCn
9b00: 74 28 64 62 29 3b 0a 0a 20 20 72 65 74 75 72 6e  t(db);..  return
9b10: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
9b20: 2a 0a 2a 2a 20 43 6c 65 61 6e 20 75 70 20 61 20  *.** Clean up a 
9b30: 56 44 42 45 20 61 66 74 65 72 20 65 78 65 63 75  VDBE after execu
9b40: 74 69 6f 6e 20 62 75 74 20 64 6f 20 6e 6f 74 20  tion but do not 
9b50: 64 65 6c 65 74 65 20 74 68 65 20 56 44 42 45 20  delete the VDBE 
9b60: 6a 75 73 74 20 79 65 74 2e 0a 2a 2a 20 57 72 69  just yet..** Wri
9b70: 74 65 20 61 6e 79 20 65 72 72 6f 72 20 6d 65 73  te any error mes
9b80: 73 61 67 65 73 20 69 6e 74 6f 20 2a 70 7a 45 72  sages into *pzEr
9b90: 72 4d 73 67 2e 20 20 52 65 74 75 72 6e 20 74 68  rMsg.  Return th
9ba0: 65 20 72 65 73 75 6c 74 20 63 6f 64 65 2e 0a 2a  e result code..*
9bb0: 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 69 73 20  *.** After this 
9bc0: 72 6f 75 74 69 6e 65 20 69 73 20 72 75 6e 2c 20  routine is run, 
9bd0: 74 68 65 20 56 44 42 45 20 73 68 6f 75 6c 64 20  the VDBE should 
9be0: 62 65 20 72 65 61 64 79 20 74 6f 20 62 65 20 65  be ready to be e
9bf0: 78 65 63 75 74 65 64 0a 2a 2a 20 61 67 61 69 6e  xecuted.** again
9c00: 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 6c 6f 6f 6b 20  ..**.** To look 
9c10: 61 74 20 69 74 20 61 6e 6f 74 68 65 72 20 77 61  at it another wa
9c20: 79 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  y, this routine 
9c30: 72 65 73 65 74 73 20 74 68 65 20 73 74 61 74 65  resets the state
9c40: 20 6f 66 20 74 68 65 0a 2a 2a 20 76 69 72 74 75   of the.** virtu
9c50: 61 6c 20 6d 61 63 68 69 6e 65 20 66 72 6f 6d 20  al machine from 
9c60: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 6f  VDBE_MAGIC_RUN o
9c70: 72 20 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  r VDBE_MAGIC_HAL
9c80: 54 20 62 61 63 6b 20 74 6f 0a 2a 2a 20 56 44 42  T back to.** VDB
9c90: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 2e 0a 2a 2f  E_MAGIC_INIT..*/
9ca0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
9cb0: 52 65 73 65 74 28 56 64 62 65 20 2a 70 29 7b 0a  Reset(Vdbe *p){.
9cc0: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d    if( p->magic!=
9cd0: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26  VDBE_MAGIC_RUN &
9ce0: 26 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45  & p->magic!=VDBE
9cf0: 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 7b 0a 20  _MAGIC_HALT ){. 
9d00: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
9d10: 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49  p->db, SQLITE_MI
9d20: 53 55 53 45 2c 20 30 29 3b 0a 20 20 20 20 72 65  SUSE, 0);.    re
9d30: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  turn SQLITE_MISU
9d40: 53 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66  SE;.  }..  /* If
9d50: 20 74 68 65 20 56 4d 20 64 69 64 20 6e 6f 74 20   the VM did not 
9d60: 72 75 6e 20 74 6f 20 63 6f 6d 70 6c 65 74 69 6f  run to completio
9d70: 6e 20 6f 72 20 69 66 20 69 74 20 65 6e 63 6f 75  n or if it encou
9d80: 6e 74 65 72 65 64 20 61 6e 0a 20 20 2a 2a 20 65  ntered an.  ** e
9d90: 72 72 6f 72 2c 20 74 68 65 6e 20 69 74 20 6d 69  rror, then it mi
9da0: 67 68 74 20 6e 6f 74 20 68 61 76 65 20 62 65 65  ght not have bee
9db0: 6e 20 68 61 6c 74 65 64 20 70 72 6f 70 65 72 6c  n halted properl
9dc0: 79 2e 20 20 53 6f 20 68 61 6c 74 0a 20 20 2a 2a  y.  So halt.  **
9dd0: 20 69 74 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20   it now..  */.  
9de0: 73 71 6c 69 74 65 33 56 64 62 65 48 61 6c 74 28  sqlite3VdbeHalt(
9df0: 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65  p);..  /* If the
9e00: 20 56 44 42 45 20 68 61 73 20 62 65 20 72 75 6e   VDBE has be run
9e10: 20 65 76 65 6e 20 70 61 72 74 69 61 6c 6c 79 2c   even partially,
9e20: 20 74 68 65 6e 20 74 72 61 6e 73 66 65 72 20 74   then transfer t
9e30: 68 65 20 65 72 72 6f 72 20 63 6f 64 65 0a 20 20  he error code.  
9e40: 2a 2a 20 61 6e 64 20 65 72 72 6f 72 20 6d 65 73  ** and error mes
9e50: 73 61 67 65 20 66 72 6f 6d 20 74 68 65 20 56 44  sage from the VD
9e60: 42 45 20 69 6e 74 6f 20 74 68 65 20 6d 61 69 6e  BE into the main
9e70: 20 64 61 74 61 62 61 73 65 20 73 74 72 75 63 74   database struct
9e80: 75 72 65 2e 20 20 42 75 74 0a 20 20 2a 2a 20 69  ure.  But.  ** i
9e90: 66 20 74 68 65 20 56 44 42 45 20 68 61 73 20 6a  f the VDBE has j
9ea0: 75 73 74 20 62 65 65 6e 20 73 65 74 20 74 6f 20  ust been set to 
9eb0: 72 75 6e 20 62 75 74 20 68 61 73 20 6e 6f 74 20  run but has not 
9ec0: 61 63 74 75 61 6c 6c 79 20 65 78 65 63 75 74 65  actually execute
9ed0: 64 20 61 6e 79 0a 20 20 2a 2a 20 69 6e 73 74 72  d any.  ** instr
9ee0: 75 63 74 69 6f 6e 73 20 79 65 74 2c 20 6c 65 61  uctions yet, lea
9ef0: 76 65 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61  ve the main data
9f00: 62 61 73 65 20 65 72 72 6f 72 20 69 6e 66 6f 72  base error infor
9f10: 6d 61 74 69 6f 6e 20 75 6e 63 68 61 6e 67 65 64  mation unchanged
9f20: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e  ..  */.  if( p->
9f30: 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 69 66 28  pc>=0 ){.    if(
9f40: 20 70 2d 3e 7a 45 72 72 4d 73 67 20 29 7b 0a 20   p->zErrMsg ){. 
9f50: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f       sqlite3Erro
9f60: 72 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 2c 20  r(p->db, p->rc, 
9f70: 22 25 73 22 2c 20 70 2d 3e 7a 45 72 72 4d 73 67  "%s", p->zErrMsg
9f80: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46  );.      sqliteF
9f90: 72 65 65 28 70 2d 3e 7a 45 72 72 4d 73 67 29 3b  ree(p->zErrMsg);
9fa0: 0a 20 20 20 20 20 20 70 2d 3e 7a 45 72 72 4d 73  .      p->zErrMs
9fb0: 67 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65  g = 0;.    }else
9fc0: 20 69 66 28 20 70 2d 3e 72 63 20 29 7b 0a 20 20   if( p->rc ){.  
9fd0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
9fe0: 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 2c 20 30  (p->db, p->rc, 0
9ff0: 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  );.    }else{.  
a000: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
a010: 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4f  (p->db, SQLITE_O
a020: 4b 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  K, 0);.    }.  }
a030: 65 6c 73 65 20 69 66 28 20 70 2d 3e 72 63 20 26  else if( p->rc &
a040: 26 20 70 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a  & p->expired ){.
a050: 20 20 20 20 2f 2a 20 54 68 65 20 65 78 70 69 72      /* The expir
a060: 65 64 20 66 6c 61 67 20 77 61 73 20 73 65 74 20  ed flag was set 
a070: 6f 6e 20 74 68 65 20 56 44 42 45 20 62 65 66 6f  on the VDBE befo
a080: 72 65 20 74 68 65 20 66 69 72 73 74 20 63 61 6c  re the first cal
a090: 6c 0a 20 20 20 20 2a 2a 20 74 6f 20 73 71 6c 69  l.    ** to sqli
a0a0: 74 65 33 5f 73 74 65 70 28 29 2e 20 46 6f 72 20  te3_step(). For 
a0b0: 63 6f 6e 73 69 73 74 65 6e 63 79 20 28 73 69 6e  consistency (sin
a0c0: 63 65 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28  ce sqlite3_step(
a0d0: 29 20 77 61 73 0a 20 20 20 20 2a 2a 20 63 61 6c  ) was.    ** cal
a0e0: 6c 65 64 29 2c 20 73 65 74 20 74 68 65 20 64 61  led), set the da
a0f0: 74 61 62 61 73 65 20 65 72 72 6f 72 20 69 6e 20  tabase error in 
a100: 74 68 69 73 20 63 61 73 65 20 61 73 20 77 65 6c  this case as wel
a110: 6c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 73 71  l..    */.    sq
a120: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62  lite3Error(p->db
a130: 2c 20 70 2d 3e 72 63 2c 20 30 29 3b 0a 20 20 7d  , p->rc, 0);.  }
a140: 0a 0a 20 20 2f 2a 20 52 65 63 6c 61 69 6d 20 61  ..  /* Reclaim a
a150: 6c 6c 20 6d 65 6d 6f 72 79 20 75 73 65 64 20 62  ll memory used b
a160: 79 20 74 68 65 20 56 44 42 45 0a 20 20 2a 2f 0a  y the VDBE.  */.
a170: 20 20 43 6c 65 61 6e 75 70 28 70 29 3b 0a 0a 20    Cleanup(p);.. 
a180: 20 2f 2a 20 53 61 76 65 20 70 72 6f 66 69 6c 69   /* Save profili
a190: 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66  ng information f
a1a0: 72 6f 6d 20 74 68 69 73 20 56 44 42 45 20 72 75  rom this VDBE ru
a1b0: 6e 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74  n..  */.  assert
a1c0: 28 20 70 2d 3e 70 54 6f 73 3c 26 70 2d 3e 61 53  ( p->pTos<&p->aS
a1d0: 74 61 63 6b 5b 70 2d 3e 70 63 3c 30 3f 30 3a 70  tack[p->pc<0?0:p
a1e0: 2d 3e 70 63 5d 20 7c 7c 20 73 71 6c 69 74 65 33  ->pc] || sqlite3
a1f0: 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 3d 3d  _malloc_failed==
a200: 31 20 29 3b 0a 23 69 66 64 65 66 20 56 44 42 45  1 );.#ifdef VDBE
a210: 5f 50 52 4f 46 49 4c 45 0a 20 20 7b 0a 20 20 20  _PROFILE.  {.   
a220: 20 46 49 4c 45 20 2a 6f 75 74 20 3d 20 66 6f 70   FILE *out = fop
a230: 65 6e 28 22 76 64 62 65 5f 70 72 6f 66 69 6c 65  en("vdbe_profile
a240: 2e 6f 75 74 22 2c 20 22 61 22 29 3b 0a 20 20 20  .out", "a");.   
a250: 20 69 66 28 20 6f 75 74 20 29 7b 0a 20 20 20 20   if( out ){.    
a260: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 66    int i;.      f
a270: 70 72 69 6e 74 66 28 6f 75 74 2c 20 22 2d 2d 2d  printf(out, "---
a280: 2d 20 22 29 3b 0a 20 20 20 20 20 20 66 6f 72 28  - ");.      for(
a290: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69  i=0; i<p->nOp; i
a2a0: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 66 70 72  ++){.        fpr
a2b0: 69 6e 74 66 28 6f 75 74 2c 20 22 25 30 32 78 22  intf(out, "%02x"
a2c0: 2c 20 70 2d 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f  , p->aOp[i].opco
a2d0: 64 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  de);.      }.   
a2e0: 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c 20     fprintf(out, 
a2f0: 22 5c 6e 22 29 3b 0a 20 20 20 20 20 20 66 6f 72  "\n");.      for
a300: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20  (i=0; i<p->nOp; 
a310: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 66 70  i++){.        fp
a320: 72 69 6e 74 66 28 6f 75 74 2c 20 22 25 36 64 20  rintf(out, "%6d 
a330: 25 31 30 6c 6c 64 20 25 38 6c 6c 64 20 22 2c 0a  %10lld %8lld ",.
a340: 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f             p->aO
a350: 70 5b 69 5d 2e 63 6e 74 2c 0a 20 20 20 20 20 20  p[i].cnt,.      
a360: 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63       p->aOp[i].c
a370: 79 63 6c 65 73 2c 0a 20 20 20 20 20 20 20 20 20  ycles,.         
a380: 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 3e    p->aOp[i].cnt>
a390: 30 20 3f 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79  0 ? p->aOp[i].cy
a3a0: 63 6c 65 73 2f 70 2d 3e 61 4f 70 5b 69 5d 2e 63  cles/p->aOp[i].c
a3b0: 6e 74 20 3a 20 30 0a 20 20 20 20 20 20 20 20 29  nt : 0.        )
a3c0: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
a3d0: 33 56 64 62 65 50 72 69 6e 74 4f 70 28 6f 75 74  3VdbePrintOp(out
a3e0: 2c 20 69 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29  , i, &p->aOp[i])
a3f0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
a400: 66 63 6c 6f 73 65 28 6f 75 74 29 3b 0a 20 20 20  fclose(out);.   
a410: 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20   }.  }.#endif.  
a420: 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f  p->magic = VDBE_
a430: 4d 41 47 49 43 5f 49 4e 49 54 3b 0a 20 20 70 2d  MAGIC_INIT;.  p-
a440: 3e 61 62 6f 72 74 65 64 20 3d 20 30 3b 0a 20 20  >aborted = 0;.  
a450: 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54  if( p->rc==SQLIT
a460: 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20 20 20 20  E_SCHEMA ){.    
a470: 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65  sqlite3ResetInte
a480: 72 6e 61 6c 53 63 68 65 6d 61 28 70 2d 3e 64 62  rnalSchema(p->db
a490: 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  , 0);.  }.  retu
a4a0: 72 6e 20 70 2d 3e 72 63 3b 0a 7d 0a 20 0a 2f 2a  rn p->rc;.}. ./*
a4b0: 0a 2a 2a 20 43 6c 65 61 6e 20 75 70 20 61 6e 64  .** Clean up and
a4c0: 20 64 65 6c 65 74 65 20 61 20 56 44 42 45 20 61   delete a VDBE a
a4d0: 66 74 65 72 20 65 78 65 63 75 74 69 6f 6e 2e 20  fter execution. 
a4e0: 20 52 65 74 75 72 6e 20 61 6e 20 69 6e 74 65 67   Return an integ
a4f0: 65 72 20 77 68 69 63 68 20 69 73 0a 2a 2a 20 74  er which is.** t
a500: 68 65 20 72 65 73 75 6c 74 20 63 6f 64 65 2e 20  he result code. 
a510: 20 57 72 69 74 65 20 61 6e 79 20 65 72 72 6f 72   Write any error
a520: 20 6d 65 73 73 61 67 65 20 74 65 78 74 20 69 6e   message text in
a530: 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a 2a 2f  to *pzErrMsg..*/
a540: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
a550: 46 69 6e 61 6c 69 7a 65 28 56 64 62 65 20 2a 70  Finalize(Vdbe *p
a560: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
a570: 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20  LITE_OK;..  if( 
a580: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
a590: 41 47 49 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e 6d  AGIC_RUN || p->m
a5a0: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
a5b0: 5f 48 41 4c 54 20 29 7b 0a 20 20 20 20 72 63 20  _HALT ){.    rc 
a5c0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73  = sqlite3VdbeRes
a5d0: 65 74 28 70 29 3b 0a 20 20 7d 65 6c 73 65 20 69  et(p);.  }else i
a5e0: 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42  f( p->magic!=VDB
a5f0: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 7b 0a  E_MAGIC_INIT ){.
a600: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
a610: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
a620: 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74  sqlite3VdbeDelet
a630: 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  e(p);.  return r
a640: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c  c;.}../*.** Call
a650: 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 72 20   the destructor 
a660: 66 6f 72 20 65 61 63 68 20 61 75 78 64 61 74 61  for each auxdata
a670: 20 65 6e 74 72 79 20 69 6e 20 70 56 64 62 65 46   entry in pVdbeF
a680: 75 6e 63 20 66 6f 72 20 77 68 69 63 68 0a 2a 2a  unc for which.**
a690: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69   the correspondi
a6a0: 6e 67 20 62 69 74 20 69 6e 20 6d 61 73 6b 20 69  ng bit in mask i
a6b0: 73 20 63 6c 65 61 72 2e 20 20 41 75 78 64 61 74  s clear.  Auxdat
a6c0: 61 20 65 6e 74 72 69 65 73 20 62 65 79 6f 6e 64  a entries beyond
a6d0: 20 33 31 0a 2a 2a 20 61 72 65 20 61 6c 77 61 79   31.** are alway
a6e0: 73 20 64 65 73 74 72 6f 79 65 64 2e 20 20 54 6f  s destroyed.  To
a6f0: 20 64 65 73 74 72 6f 79 20 61 6c 6c 20 61 75 78   destroy all aux
a700: 64 61 74 61 20 65 6e 74 72 69 65 73 2c 20 63 61  data entries, ca
a710: 6c 6c 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69  ll this.** routi
a720: 6e 65 20 77 69 74 68 20 6d 61 73 6b 3d 3d 30 2e  ne with mask==0.
a730: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
a740: 56 64 62 65 44 65 6c 65 74 65 41 75 78 44 61 74  VdbeDeleteAuxDat
a750: 61 28 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62  a(VdbeFunc *pVdb
a760: 65 46 75 6e 63 2c 20 69 6e 74 20 6d 61 73 6b 29  eFunc, int mask)
a770: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72  {.  int i;.  for
a780: 28 69 3d 30 3b 20 69 3c 70 56 64 62 65 46 75 6e  (i=0; i<pVdbeFun
a790: 63 2d 3e 6e 41 75 78 3b 20 69 2b 2b 29 7b 0a 20  c->nAux; i++){. 
a7a0: 20 20 20 73 74 72 75 63 74 20 41 75 78 44 61 74     struct AuxDat
a7b0: 61 20 2a 70 41 75 78 20 3d 20 26 70 56 64 62 65  a *pAux = &pVdbe
a7c0: 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 5d 3b 0a  Func->apAux[i];.
a7d0: 20 20 20 20 69 66 28 20 28 69 3e 33 31 20 7c 7c      if( (i>31 ||
a7e0: 20 21 28 6d 61 73 6b 26 28 31 3c 3c 69 29 29 29   !(mask&(1<<i)))
a7f0: 20 26 26 20 70 41 75 78 2d 3e 70 41 75 78 20 29   && pAux->pAux )
a800: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 41 75 78  {.      if( pAux
a810: 2d 3e 78 44 65 6c 65 74 65 20 29 7b 0a 20 20 20  ->xDelete ){.   
a820: 20 20 20 20 20 70 41 75 78 2d 3e 78 44 65 6c 65       pAux->xDele
a830: 74 65 28 70 41 75 78 2d 3e 70 41 75 78 29 3b 0a  te(pAux->pAux);.
a840: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 41        }.      pA
a850: 75 78 2d 3e 70 41 75 78 20 3d 20 30 3b 0a 20 20  ux->pAux = 0;.  
a860: 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a    }.  }.}../*.**
a870: 20 44 65 6c 65 74 65 20 61 6e 20 65 6e 74 69 72   Delete an entir
a880: 65 20 56 44 42 45 2e 0a 2a 2f 0a 76 6f 69 64 20  e VDBE..*/.void 
a890: 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74  sqlite3VdbeDelet
a8a0: 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  e(Vdbe *p){.  in
a8b0: 74 20 69 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20  t i;.  if( p==0 
a8c0: 29 20 72 65 74 75 72 6e 3b 0a 20 20 43 6c 65 61  ) return;.  Clea
a8d0: 6e 75 70 28 70 29 3b 0a 20 20 69 66 28 20 70 2d  nup(p);.  if( p-
a8e0: 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 20 70 2d  >pPrev ){.    p-
a8f0: 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 20 3d 20  >pPrev->pNext = 
a900: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 65 6c 73  p->pNext;.  }els
a910: 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  e{.    assert( p
a920: 2d 3e 64 62 2d 3e 70 56 64 62 65 3d 3d 70 20 29  ->db->pVdbe==p )
a930: 3b 0a 20 20 20 20 70 2d 3e 64 62 2d 3e 70 56 64  ;.    p->db->pVd
a940: 62 65 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20  be = p->pNext;. 
a950: 20 7d 0a 20 20 69 66 28 20 70 2d 3e 70 4e 65 78   }.  if( p->pNex
a960: 74 20 29 7b 0a 20 20 20 20 70 2d 3e 70 4e 65 78  t ){.    p->pNex
a970: 74 2d 3e 70 50 72 65 76 20 3d 20 70 2d 3e 70 50  t->pPrev = p->pP
a980: 72 65 76 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  rev;.  }.  if( p
a990: 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 66 6f 72  ->aOp ){.    for
a9a0: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20  (i=0; i<p->nOp; 
a9b0: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 4f 70 20 2a  i++){.      Op *
a9c0: 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d  pOp = &p->aOp[i]
a9d0: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d  ;.      if( pOp-
a9e0: 3e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e 41  >p3type==P3_DYNA
a9f0: 4d 49 43 20 7c 7c 20 70 4f 70 2d 3e 70 33 74 79  MIC || pOp->p3ty
aa00: 70 65 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 29  pe==P3_KEYINFO )
aa10: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
aa20: 46 72 65 65 28 70 4f 70 2d 3e 70 33 29 3b 0a 20  Free(pOp->p3);. 
aa30: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28       }.      if(
aa40: 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33   pOp->p3type==P3
aa50: 5f 56 44 42 45 46 55 4e 43 20 29 7b 0a 20 20 20  _VDBEFUNC ){.   
aa60: 20 20 20 20 20 56 64 62 65 46 75 6e 63 20 2a 70       VdbeFunc *p
aa70: 56 64 62 65 46 75 6e 63 20 3d 20 28 56 64 62 65  VdbeFunc = (Vdbe
aa80: 46 75 6e 63 20 2a 29 70 4f 70 2d 3e 70 33 3b 0a  Func *)pOp->p3;.
aa90: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56          sqlite3V
aaa0: 64 62 65 44 65 6c 65 74 65 41 75 78 44 61 74 61  dbeDeleteAuxData
aab0: 28 70 56 64 62 65 46 75 6e 63 2c 20 30 29 3b 0a  (pVdbeFunc, 0);.
aac0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72          sqliteFr
aad0: 65 65 28 70 56 64 62 65 46 75 6e 63 29 3b 0a 20  ee(pVdbeFunc);. 
aae0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28       }.      if(
aaf0: 20 70 4f 70 2d 3e 70 33 74 79 70 65 3d 3d 50 33   pOp->p3type==P3
ab00: 5f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 20 20  _MEM ){.        
ab10: 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65  sqlite3ValueFree
ab20: 28 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a  ((sqlite3_value*
ab30: 29 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20 20  )pOp->p3);.     
ab40: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c   }.    }.    sql
ab50: 69 74 65 46 72 65 65 28 70 2d 3e 61 4f 70 29 3b  iteFree(p->aOp);
ab60: 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65 4d 65  .  }.  releaseMe
ab70: 6d 41 72 72 61 79 28 70 2d 3e 61 56 61 72 2c 20  mArray(p->aVar, 
ab80: 70 2d 3e 6e 56 61 72 29 3b 0a 20 20 73 71 6c 69  p->nVar);.  sqli
ab90: 74 65 46 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c  teFree(p->aLabel
aba0: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
abb0: 70 2d 3e 61 53 74 61 63 6b 29 3b 0a 20 20 72 65  p->aStack);.  re
abc0: 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d  leaseMemArray(p-
abd0: 3e 61 43 6f 6c 4e 61 6d 65 2c 20 70 2d 3e 6e 52  >aColName, p->nR
abe0: 65 73 43 6f 6c 75 6d 6e 2a 32 29 3b 0a 20 20 73  esColumn*2);.  s
abf0: 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 43 6f  qliteFree(p->aCo
ac00: 6c 4e 61 6d 65 29 3b 0a 20 20 70 2d 3e 6d 61 67  lName);.  p->mag
ac10: 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f  ic = VDBE_MAGIC_
ac20: 44 45 41 44 3b 0a 20 20 73 71 6c 69 74 65 46 72  DEAD;.  sqliteFr
ac30: 65 65 28 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ee(p);.}../*.** 
ac40: 49 66 20 61 20 4d 6f 76 65 54 6f 20 6f 70 65 72  If a MoveTo oper
ac50: 61 74 69 6f 6e 20 69 73 20 70 65 6e 64 69 6e 67  ation is pending
ac60: 20 6f 6e 20 74 68 65 20 67 69 76 65 6e 20 63 75   on the given cu
ac70: 72 73 6f 72 2c 20 74 68 65 6e 20 64 6f 20 74 68  rsor, then do th
ac80: 61 74 0a 2a 2a 20 4d 6f 76 65 54 6f 20 6e 6f 77  at.** MoveTo now
ac90: 2e 20 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72  .  Return an err
aca0: 6f 72 20 63 6f 64 65 2e 20 20 49 66 20 6e 6f 20  or code.  If no 
acb0: 4d 6f 76 65 54 6f 20 69 73 20 70 65 6e 64 69 6e  MoveTo is pendin
acc0: 67 2c 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69  g, this.** routi
acd0: 6e 65 20 64 6f 65 73 20 6e 6f 74 68 69 6e 67 20  ne does nothing 
ace0: 61 6e 64 20 72 65 74 75 72 6e 73 20 53 51 4c 49  and returns SQLI
acf0: 54 45 5f 4f 4b 2e 0a 2a 2f 0a 69 6e 74 20 73 71  TE_OK..*/.int sq
ad00: 6c 69 74 65 33 56 64 62 65 43 75 72 73 6f 72 4d  lite3VdbeCursorM
ad10: 6f 76 65 74 6f 28 43 75 72 73 6f 72 20 2a 70 29  oveto(Cursor *p)
ad20: 7b 0a 20 20 69 66 28 20 70 2d 3e 64 65 66 65 72  {.  if( p->defer
ad30: 72 65 64 4d 6f 76 65 74 6f 20 29 7b 0a 20 20 20  redMoveto ){.   
ad40: 20 69 6e 74 20 72 65 73 2c 20 72 63 3b 0a 20 20   int res, rc;.  
ad50: 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c    extern int sql
ad60: 69 74 65 33 5f 73 65 61 72 63 68 5f 63 6f 75 6e  ite3_search_coun
ad70: 74 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  t;.    assert( p
ad80: 2d 3e 69 6e 74 4b 65 79 20 29 3b 0a 20 20 20 20  ->intKey );.    
ad90: 69 66 28 20 70 2d 3e 69 6e 74 4b 65 79 20 29 7b  if( p->intKey ){
ada0: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
adb0: 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 28 70  te3BtreeMoveto(p
adc0: 2d 3e 70 43 75 72 73 6f 72 2c 20 30 2c 20 70 2d  ->pCursor, 0, p-
add0: 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74 2c 20 26  >movetoTarget, &
ade0: 72 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  res);.    }else{
adf0: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
ae00: 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 28 70  te3BtreeMoveto(p
ae10: 2d 3e 70 43 75 72 73 6f 72 2c 28 63 68 61 72 2a  ->pCursor,(char*
ae20: 29 26 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65  )&p->movetoTarge
ae30: 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  t,.             
ae40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ae50: 20 73 69 7a 65 6f 66 28 69 36 34 29 2c 26 72 65   sizeof(i64),&re
ae60: 73 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  s);.    }.    if
ae70: 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63  ( rc ) return rc
ae80: 3b 0a 20 20 20 20 2a 70 2d 3e 70 49 6e 63 72 4b  ;.    *p->pIncrK
ae90: 65 79 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 6c  ey = 0;.    p->l
aea0: 61 73 74 52 65 63 6e 6f 20 3d 20 6b 65 79 54 6f  astRecno = keyTo
aeb0: 49 6e 74 28 70 2d 3e 6d 6f 76 65 74 6f 54 61 72  Int(p->movetoTar
aec0: 67 65 74 29 3b 0a 20 20 20 20 70 2d 3e 72 65 63  get);.    p->rec
aed0: 6e 6f 49 73 56 61 6c 69 64 20 3d 20 72 65 73 3d  noIsValid = res=
aee0: 3d 30 3b 0a 20 20 20 20 69 66 28 20 72 65 73 3c  =0;.    if( res<
aef0: 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  0 ){.      rc = 
af00: 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74  sqlite3BtreeNext
af10: 28 70 2d 3e 70 43 75 72 73 6f 72 2c 20 26 72 65  (p->pCursor, &re
af20: 73 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  s);.      if( rc
af30: 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20   ) return rc;.  
af40: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f    }.    sqlite3_
af50: 73 65 61 72 63 68 5f 63 6f 75 6e 74 2b 2b 3b 0a  search_count++;.
af60: 20 20 20 20 70 2d 3e 64 65 66 65 72 72 65 64 4d      p->deferredM
af70: 6f 76 65 74 6f 20 3d 20 30 3b 0a 20 20 20 20 70  oveto = 0;.    p
af80: 2d 3e 63 61 63 68 65 56 61 6c 69 64 20 3d 20 30  ->cacheValid = 0
af90: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53  ;.  }.  return S
afa0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
afb0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
afc0: 20 66 75 6e 63 74 69 6f 6e 73 3a 0a 2a 2a 0a 2a   functions:.**.*
afd0: 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  * sqlite3VdbeSer
afe0: 69 61 6c 54 79 70 65 28 29 0a 2a 2a 20 73 71 6c  ialType().** sql
aff0: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
b000: 70 65 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74  peLen().** sqlit
b010: 65 33 56 64 62 65 53 65 72 69 61 6c 52 65 61 64  e3VdbeSerialRead
b020: 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62  ().** sqlite3Vdb
b030: 65 53 65 72 69 61 6c 4c 65 6e 28 29 0a 2a 2a 20  eSerialLen().** 
b040: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
b050: 6c 57 72 69 74 65 28 29 0a 2a 2a 0a 2a 2a 20 65  lWrite().**.** e
b060: 6e 63 61 70 73 75 6c 61 74 65 20 74 68 65 20 63  ncapsulate the c
b070: 6f 64 65 20 74 68 61 74 20 73 65 72 69 61 6c 69  ode that seriali
b080: 7a 65 73 20 76 61 6c 75 65 73 20 66 6f 72 20 73  zes values for s
b090: 74 6f 72 61 67 65 20 69 6e 20 53 51 4c 69 74 65  torage in SQLite
b0a0: 0a 2a 2a 20 64 61 74 61 20 61 6e 64 20 69 6e 64  .** data and ind
b0b0: 65 78 20 72 65 63 6f 72 64 73 2e 20 45 61 63 68  ex records. Each
b0c0: 20 73 65 72 69 61 6c 69 7a 65 64 20 76 61 6c 75   serialized valu
b0d0: 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 0a  e consists of a.
b0e0: 2a 2a 20 27 73 65 72 69 61 6c 2d 74 79 70 65 27  ** 'serial-type'
b0f0: 20 61 6e 64 20 61 20 62 6c 6f 62 20 6f 66 20 64   and a blob of d
b100: 61 74 61 2e 20 54 68 65 20 73 65 72 69 61 6c 20  ata. The serial 
b110: 74 79 70 65 20 69 73 20 61 6e 20 38 2d 62 79 74  type is an 8-byt
b120: 65 20 75 6e 73 69 67 6e 65 64 0a 2a 2a 20 69 6e  e unsigned.** in
b130: 74 65 67 65 72 2c 20 73 74 6f 72 65 64 20 61 73  teger, stored as
b140: 20 61 20 76 61 72 69 6e 74 2e 0a 2a 2a 0a 2a 2a   a varint..**.**
b150: 20 49 6e 20 61 6e 20 53 51 4c 69 74 65 20 69 6e   In an SQLite in
b160: 64 65 78 20 72 65 63 6f 72 64 2c 20 74 68 65 20  dex record, the 
b170: 73 65 72 69 61 6c 20 74 79 70 65 20 69 73 20 73  serial type is s
b180: 74 6f 72 65 64 20 64 69 72 65 63 74 6c 79 20 62  tored directly b
b190: 65 66 6f 72 65 0a 2a 2a 20 74 68 65 20 62 6c 6f  efore.** the blo
b1a0: 62 20 6f 66 20 64 61 74 61 20 74 68 61 74 20 69  b of data that i
b1b0: 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f  t corresponds to
b1c0: 2e 20 49 6e 20 61 20 74 61 62 6c 65 20 72 65 63  . In a table rec
b1d0: 6f 72 64 2c 20 61 6c 6c 20 73 65 72 69 61 6c 0a  ord, all serial.
b1e0: 2a 2a 20 74 79 70 65 73 20 61 72 65 20 73 74 6f  ** types are sto
b1f0: 72 65 64 20 61 74 20 74 68 65 20 73 74 61 72 74  red at the start
b200: 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64 2c 20   of the record, 
b210: 61 6e 64 20 74 68 65 20 62 6c 6f 62 73 20 6f 66  and the blobs of
b220: 20 64 61 74 61 20 61 74 0a 2a 2a 20 74 68 65 20   data at.** the 
b230: 65 6e 64 2e 20 48 65 6e 63 65 20 74 68 65 73 65  end. Hence these
b240: 20 66 75 6e 63 74 69 6f 6e 73 20 61 6c 6c 6f 77   functions allow
b250: 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 68   the caller to h
b260: 61 6e 64 6c 65 20 74 68 65 0a 2a 2a 20 73 65 72  andle the.** ser
b270: 69 61 6c 2d 74 79 70 65 20 61 6e 64 20 64 61 74  ial-type and dat
b280: 61 20 62 6c 6f 62 20 73 65 70 65 72 61 74 65 6c  a blob seperatel
b290: 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c  y..**.** The fol
b2a0: 6c 6f 77 69 6e 67 20 74 61 62 6c 65 20 64 65 73  lowing table des
b2b0: 63 72 69 62 65 73 20 74 68 65 20 76 61 72 69 6f  cribes the vario
b2c0: 75 73 20 73 74 6f 72 61 67 65 20 63 6c 61 73 73  us storage class
b2d0: 65 73 20 66 6f 72 20 64 61 74 61 3a 0a 2a 2a 0a  es for data:.**.
b2e0: 2a 2a 20 20 20 73 65 72 69 61 6c 20 74 79 70 65  **   serial type
b2f0: 20 20 20 20 20 20 20 20 62 79 74 65 73 20 6f 66          bytes of
b300: 20 64 61 74 61 20 20 20 20 20 20 74 79 70 65 0a   data      type.
b310: 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  **   -----------
b320: 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d  ---     --------
b330: 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 2d 2d 2d 2d 2d  -------    -----
b340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20  ----------.**   
b350: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20     0            
b360: 20 20 20 20 20 20 20 20 20 30 20 20 20 20 20 20           0      
b370: 20 20 20 20 20 20 4e 55 4c 4c 0a 2a 2a 20 20 20        NULL.**   
b380: 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20     1            
b390: 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20           1      
b3a0: 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74        signed int
b3b0: 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 32 20 20  eger.**      2  
b3c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b3d0: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20     2            
b3e0: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a  signed integer.*
b3f0: 2a 20 20 20 20 20 20 33 20 20 20 20 20 20 20 20  *      3        
b400: 20 20 20 20 20 20 20 20 20 20 20 20 20 33 20 20               3  
b410: 20 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64            signed
b420: 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20   integer.**     
b430: 20 34 20 20 20 20 20 20 20 20 20 20 20 20 20 20   4              
b440: 20 20 20 20 20 20 20 34 20 20 20 20 20 20 20 20         4        
b450: 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67      signed integ
b460: 65 72 0a 2a 2a 20 20 20 20 20 20 35 20 20 20 20  er.**      5    
b470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b480: 20 36 20 20 20 20 20 20 20 20 20 20 20 20 73 69   6            si
b490: 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20  gned integer.** 
b4a0: 20 20 20 20 20 36 20 20 20 20 20 20 20 20 20 20       6          
b4b0: 20 20 20 20 20 20 20 20 20 20 20 38 20 20 20 20             8    
b4c0: 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69          signed i
b4d0: 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 37  nteger.**      7
b4e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b4f0: 20 20 20 20 20 38 20 20 20 20 20 20 20 20 20 20       8          
b500: 20 20 49 45 45 45 20 66 6c 6f 61 74 0a 2a 2a 20    IEEE float.** 
b510: 20 20 20 20 38 2d 31 31 20 20 20 20 20 20 20 20      8-11        
b520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b530: 20 20 20 20 20 20 20 20 72 65 73 65 72 76 65 64          reserved
b540: 20 66 6f 72 20 65 78 70 61 6e 73 69 6f 6e 0a 2a   for expansion.*
b550: 2a 20 20 20 20 4e 3e 3d 31 32 20 61 6e 64 20 65  *    N>=12 and e
b560: 76 65 6e 20 20 20 20 20 20 20 28 4e 2d 31 32 29  ven       (N-12)
b570: 2f 32 20 20 20 20 20 20 20 20 42 4c 4f 42 0a 2a  /2        BLOB.*
b580: 2a 20 20 20 20 4e 3e 3d 31 33 20 61 6e 64 20 6f  *    N>=13 and o
b590: 64 64 20 20 20 20 20 20 20 20 28 4e 2d 31 33 29  dd        (N-13)
b5a0: 2f 32 20 20 20 20 20 20 20 20 74 65 78 74 0a 2a  /2        text.*
b5b0: 2a 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  *.*/../*.** Retu
b5c0: 72 6e 20 74 68 65 20 73 65 72 69 61 6c 2d 74 79  rn the serial-ty
b5d0: 70 65 20 66 6f 72 20 74 68 65 20 76 61 6c 75 65  pe for the value
b5e0: 20 73 74 6f 72 65 64 20 69 6e 20 70 4d 65 6d 2e   stored in pMem.
b5f0: 0a 2a 2f 0a 75 33 32 20 73 71 6c 69 74 65 33 56  .*/.u32 sqlite3V
b600: 64 62 65 53 65 72 69 61 6c 54 79 70 65 28 4d 65  dbeSerialType(Me
b610: 6d 20 2a 70 4d 65 6d 29 7b 0a 20 20 69 6e 74 20  m *pMem){.  int 
b620: 66 6c 61 67 73 20 3d 20 70 4d 65 6d 2d 3e 66 6c  flags = pMem->fl
b630: 61 67 73 3b 0a 0a 20 20 69 66 28 20 66 6c 61 67  ags;..  if( flag
b640: 73 26 4d 45 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20  s&MEM_Null ){.  
b650: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
b660: 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f    if( flags&MEM_
b670: 49 6e 74 20 29 7b 0a 20 20 20 20 2f 2a 20 46 69  Int ){.    /* Fi
b680: 67 75 72 65 20 6f 75 74 20 77 68 65 74 68 65 72  gure out whether
b690: 20 74 6f 20 75 73 65 20 31 2c 20 32 2c 20 34 2c   to use 1, 2, 4,
b6a0: 20 36 20 6f 72 20 38 20 62 79 74 65 73 2e 20 2a   6 or 8 bytes. *
b6b0: 2f 0a 23 20 20 20 64 65 66 69 6e 65 20 4d 41 58  /.#   define MAX
b6c0: 5f 36 42 59 54 45 20 28 28 28 28 69 36 34 29 30  _6BYTE ((((i64)0
b6d0: 78 30 30 30 30 31 30 30 30 29 3c 3c 33 32 29 2d  x00001000)<<32)-
b6e0: 31 29 0a 20 20 20 20 69 36 34 20 69 20 3d 20 70  1).    i64 i = p
b6f0: 4d 65 6d 2d 3e 69 3b 0a 20 20 20 20 75 36 34 20  Mem->i;.    u64 
b700: 75 20 3d 20 69 3c 30 20 3f 20 2d 69 20 3a 20 69  u = i<0 ? -i : i
b710: 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 31 32 37  ;.    if( u<=127
b720: 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20   ) return 1;.   
b730: 20 69 66 28 20 75 3c 3d 33 32 37 36 37 20 29 20   if( u<=32767 ) 
b740: 72 65 74 75 72 6e 20 32 3b 0a 20 20 20 20 69 66  return 2;.    if
b750: 28 20 75 3c 3d 38 33 38 38 36 30 37 20 29 20 72  ( u<=8388607 ) r
b760: 65 74 75 72 6e 20 33 3b 0a 20 20 20 20 69 66 28  eturn 3;.    if(
b770: 20 75 3c 3d 32 31 34 37 34 38 33 36 34 37 20 29   u<=2147483647 )
b780: 20 72 65 74 75 72 6e 20 34 3b 0a 20 20 20 20 69   return 4;.    i
b790: 66 28 20 75 3c 3d 4d 41 58 5f 36 42 59 54 45 20  f( u<=MAX_6BYTE 
b7a0: 29 20 72 65 74 75 72 6e 20 35 3b 0a 20 20 20 20  ) return 5;.    
b7b0: 72 65 74 75 72 6e 20 36 3b 0a 20 20 7d 0a 20 20  return 6;.  }.  
b7c0: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 52 65  if( flags&MEM_Re
b7d0: 61 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  al ){.    return
b7e0: 20 37 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c   7;.  }.  if( fl
b7f0: 61 67 73 26 4d 45 4d 5f 53 74 72 20 29 7b 0a 20  ags&MEM_Str ){. 
b800: 20 20 20 69 6e 74 20 6e 20 3d 20 70 4d 65 6d 2d     int n = pMem-
b810: 3e 6e 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  >n;.    assert( 
b820: 6e 3e 3d 30 20 29 3b 0a 20 20 20 20 72 65 74 75  n>=0 );.    retu
b830: 72 6e 20 28 28 6e 2a 32 29 20 2b 20 31 33 29 3b  rn ((n*2) + 13);
b840: 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 73  .  }.  if( flags
b850: 26 4d 45 4d 5f 42 6c 6f 62 20 29 7b 0a 20 20 20  &MEM_Blob ){.   
b860: 20 72 65 74 75 72 6e 20 28 70 4d 65 6d 2d 3e 6e   return (pMem->n
b870: 2a 32 20 2b 20 31 32 29 3b 0a 20 20 7d 0a 20 20  *2 + 12);.  }.  
b880: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a  return 0;.}../*.
b890: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6c 65  ** Return the le
b8a0: 6e 67 74 68 20 6f 66 20 74 68 65 20 64 61 74 61  ngth of the data
b8b0: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74   corresponding t
b8c0: 6f 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 73  o the supplied s
b8d0: 65 72 69 61 6c 2d 74 79 70 65 2e 0a 2a 2f 0a 69  erial-type..*/.i
b8e0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  nt sqlite3VdbeSe
b8f0: 72 69 61 6c 54 79 70 65 4c 65 6e 28 75 33 32 20  rialTypeLen(u32 
b900: 73 65 72 69 61 6c 5f 74 79 70 65 29 7b 0a 20 20  serial_type){.  
b910: 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3e  if( serial_type>
b920: 3d 31 32 20 29 7b 0a 20 20 20 20 72 65 74 75 72  =12 ){.    retur
b930: 6e 20 28 73 65 72 69 61 6c 5f 74 79 70 65 2d 31  n (serial_type-1
b940: 32 29 2f 32 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  2)/2;.  }else{. 
b950: 20 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20     static const 
b960: 75 38 20 61 53 69 7a 65 5b 5d 20 3d 20 7b 20 30  u8 aSize[] = { 0
b970: 2c 20 31 2c 20 32 2c 20 33 2c 20 34 2c 20 36 2c  , 1, 2, 3, 4, 6,
b980: 20 38 2c 20 38 2c 20 30 2c 20 30 2c 20 30 2c 20   8, 8, 0, 0, 0, 
b990: 30 20 7d 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 };.    return 
b9a0: 61 53 69 7a 65 5b 73 65 72 69 61 6c 5f 74 79 70  aSize[serial_typ
b9b0: 65 5d 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  e];.  }.}../*.**
b9c0: 20 57 72 69 74 65 20 74 68 65 20 73 65 72 69 61   Write the seria
b9d0: 6c 69 7a 65 64 20 64 61 74 61 20 62 6c 6f 62 20  lized data blob 
b9e0: 66 6f 72 20 74 68 65 20 76 61 6c 75 65 20 73 74  for the value st
b9f0: 6f 72 65 64 20 69 6e 20 70 4d 65 6d 20 69 6e 74  ored in pMem int
ba00: 6f 20 0a 2a 2a 20 62 75 66 2e 20 49 74 20 69 73  o .** buf. It is
ba10: 20 61 73 73 75 6d 65 64 20 74 68 61 74 20 74 68   assumed that th
ba20: 65 20 63 61 6c 6c 65 72 20 68 61 73 20 61 6c 6c  e caller has all
ba30: 6f 63 61 74 65 64 20 73 75 66 66 69 63 69 65 6e  ocated sufficien
ba40: 74 20 73 70 61 63 65 2e 0a 2a 2a 20 52 65 74 75  t space..** Retu
ba50: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  rn the number of
ba60: 20 62 79 74 65 73 20 77 72 69 74 74 65 6e 2e 0a   bytes written..
ba70: 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  */ .int sqlite3V
ba80: 64 62 65 53 65 72 69 61 6c 50 75 74 28 75 6e 73  dbeSerialPut(uns
ba90: 69 67 6e 65 64 20 63 68 61 72 20 2a 62 75 66 2c  igned char *buf,
baa0: 20 4d 65 6d 20 2a 70 4d 65 6d 29 7b 0a 20 20 75   Mem *pMem){.  u
bab0: 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65 20 3d  32 serial_type =
bac0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
bad0: 61 6c 54 79 70 65 28 70 4d 65 6d 29 3b 0a 20 20  alType(pMem);.  
bae0: 69 6e 74 20 6c 65 6e 3b 0a 0a 20 20 2f 2a 20 4e  int len;..  /* N
baf0: 55 4c 4c 20 2a 2f 0a 20 20 69 66 28 20 73 65 72  ULL */.  if( ser
bb00: 69 61 6c 5f 74 79 70 65 3d 3d 30 20 29 7b 0a 20  ial_type==0 ){. 
bb10: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
bb20: 0a 20 0a 20 20 2f 2a 20 49 6e 74 65 67 65 72 20  . .  /* Integer 
bb30: 61 6e 64 20 52 65 61 6c 20 2a 2f 0a 20 20 69 66  and Real */.  if
bb40: 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3c 3d 37  ( serial_type<=7
bb50: 20 29 7b 0a 20 20 20 20 75 36 34 20 76 3b 0a 20   ){.    u64 v;. 
bb60: 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 66     int i;.    if
bb70: 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3d 3d 37  ( serial_type==7
bb80: 20 29 7b 0a 20 20 20 20 20 20 76 20 3d 20 2a 28   ){.      v = *(
bb90: 75 36 34 2a 29 26 70 4d 65 6d 2d 3e 72 3b 0a 20  u64*)&pMem->r;. 
bba0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
bbb0: 76 20 3d 20 2a 28 75 36 34 2a 29 26 70 4d 65 6d  v = *(u64*)&pMem
bbc0: 2d 3e 69 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6c  ->i;.    }.    l
bbd0: 65 6e 20 3d 20 69 20 3d 20 73 71 6c 69 74 65 33  en = i = sqlite3
bbe0: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
bbf0: 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 29 3b 0a  n(serial_type);.
bc00: 20 20 20 20 77 68 69 6c 65 28 20 69 2d 2d 20 29      while( i-- )
bc10: 7b 0a 20 20 20 20 20 20 62 75 66 5b 69 5d 20 3d  {.      buf[i] =
bc20: 20 28 76 26 30 78 46 46 29 3b 0a 20 20 20 20 20   (v&0xFF);.     
bc30: 20 76 20 3e 3e 3d 20 38 3b 0a 20 20 20 20 7d 0a   v >>= 8;.    }.
bc40: 20 20 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a      return len;.
bc50: 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 53 74 72 69    }.  .  /* Stri
bc60: 6e 67 20 6f 72 20 62 6c 6f 62 20 2a 2f 0a 20 20  ng or blob */.  
bc70: 61 73 73 65 72 74 28 20 73 65 72 69 61 6c 5f 74  assert( serial_t
bc80: 79 70 65 3e 3d 31 32 20 29 3b 0a 20 20 6c 65 6e  ype>=12 );.  len
bc90: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65   = sqlite3VdbeSe
bca0: 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69  rialTypeLen(seri
bcb0: 61 6c 5f 74 79 70 65 29 3b 0a 20 20 6d 65 6d 63  al_type);.  memc
bcc0: 70 79 28 62 75 66 2c 20 70 4d 65 6d 2d 3e 7a 2c  py(buf, pMem->z,
bcd0: 20 6c 65 6e 29 3b 0a 20 20 72 65 74 75 72 6e 20   len);.  return 
bce0: 6c 65 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65  len;.}../*.** De
bcf0: 73 65 72 69 61 6c 69 7a 65 20 74 68 65 20 64 61  serialize the da
bd00: 74 61 20 62 6c 6f 62 20 70 6f 69 6e 74 65 64 20  ta blob pointed 
bd10: 74 6f 20 62 79 20 62 75 66 20 61 73 20 73 65 72  to by buf as ser
bd20: 69 61 6c 20 74 79 70 65 20 73 65 72 69 61 6c 5f  ial type serial_
bd30: 74 79 70 65 0a 2a 2a 20 61 6e 64 20 73 74 6f 72  type.** and stor
bd40: 65 20 74 68 65 20 72 65 73 75 6c 74 20 69 6e 20  e the result in 
bd50: 70 4d 65 6d 2e 20 20 52 65 74 75 72 6e 20 74 68  pMem.  Return th
bd60: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  e number of byte
bd70: 73 20 72 65 61 64 2e 0a 2a 2f 20 0a 69 6e 74 20  s read..*/ .int 
bd80: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
bd90: 6c 47 65 74 28 0a 20 20 63 6f 6e 73 74 20 75 6e  lGet(.  const un
bda0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 62 75 66  signed char *buf
bdb0: 2c 20 20 20 20 20 2f 2a 20 42 75 66 66 65 72 20  ,     /* Buffer 
bdc0: 74 6f 20 64 65 73 65 72 69 61 6c 69 7a 65 20 66  to deserialize f
bdd0: 72 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 73 65 72  rom */.  u32 ser
bde0: 69 61 6c 5f 74 79 70 65 2c 20 20 20 20 20 20 20  ial_type,       
bdf0: 20 20 20 20 20 20 20 2f 2a 20 53 65 72 69 61 6c         /* Serial
be00: 20 74 79 70 65 20 74 6f 20 64 65 73 65 72 69 61   type to deseria
be10: 6c 69 7a 65 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70  lize */.  Mem *p
be20: 4d 65 6d 20 20 20 20 20 20 20 20 20 20 20 20 20  Mem             
be30: 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72          /* Memor
be40: 79 20 63 65 6c 6c 20 74 6f 20 77 72 69 74 65 20  y cell to write 
be50: 76 61 6c 75 65 20 69 6e 74 6f 20 2a 2f 0a 29 7b  value into */.){
be60: 0a 20 20 69 6e 74 20 6c 65 6e 3b 0a 0a 20 20 69  .  int len;..  i
be70: 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3d 3d  f( serial_type==
be80: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4e 55 4c 4c  0 ){.    /* NULL
be90: 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c   */.    pMem->fl
bea0: 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a  ags = MEM_Null;.
beb0: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
bec0: 7d 0a 20 20 6c 65 6e 20 3d 20 73 71 6c 69 74 65  }.  len = sqlite
bed0: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
bee0: 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 29 3b  en(serial_type);
bef0: 0a 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79  .  if( serial_ty
bf00: 70 65 3c 3d 37 20 29 7b 0a 20 20 20 20 2f 2a 20  pe<=7 ){.    /* 
bf10: 49 6e 74 65 67 65 72 20 61 6e 64 20 52 65 61 6c  Integer and Real
bf20: 20 2a 2f 0a 20 20 20 20 69 66 28 20 73 65 72 69   */.    if( seri
bf30: 61 6c 5f 74 79 70 65 3c 3d 34 20 29 7b 0a 20 20  al_type<=4 ){.  
bf40: 20 20 20 20 2f 2a 20 33 32 2d 62 69 74 20 69 6e      /* 32-bit in
bf50: 74 65 67 65 72 20 74 79 70 65 2e 20 20 54 68 69  teger type.  Thi
bf60: 73 20 69 73 20 68 61 6e 64 6c 65 64 20 62 79 20  s is handled by 
bf70: 61 20 73 70 65 63 69 61 6c 20 63 61 73 65 20 66  a special case f
bf80: 6f 72 0a 20 20 20 20 20 20 2a 2a 20 70 65 72 66  or.      ** perf
bf90: 6f 72 6d 61 6e 63 65 20 72 65 61 73 6f 6e 73 2e  ormance reasons.
bfa0: 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 76 20   */.      int v 
bfb0: 3d 20 62 75 66 5b 30 5d 3b 0a 20 20 20 20 20 20  = buf[0];.      
bfc0: 69 6e 74 20 6e 3b 0a 20 20 20 20 20 20 69 66 28  int n;.      if(
bfd0: 20 76 26 30 78 38 30 20 29 7b 0a 20 20 20 20 20   v&0x80 ){.     
bfe0: 20 20 20 76 20 7c 3d 20 2d 32 35 36 3b 0a 20 20     v |= -256;.  
bff0: 20 20 20 20 7d 0a 20 20 20 20 20 20 66 6f 72 28      }.      for(
c000: 6e 3d 31 3b 20 6e 3c 6c 65 6e 3b 20 6e 2b 2b 29  n=1; n<len; n++)
c010: 7b 0a 20 20 20 20 20 20 20 20 76 20 3d 20 28 76  {.        v = (v
c020: 3c 3c 38 29 20 7c 20 62 75 66 5b 6e 5d 3b 0a 20  <<8) | buf[n];. 
c030: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 4d 65       }.      pMe
c040: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49  m->flags = MEM_I
c050: 6e 74 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e  nt;.      pMem->
c060: 69 20 3d 20 76 3b 0a 20 20 20 20 20 20 72 65 74  i = v;.      ret
c070: 75 72 6e 20 6e 3b 0a 20 20 20 20 7d 65 6c 73 65  urn n;.    }else
c080: 7b 0a 20 20 20 20 20 20 75 36 34 20 76 20 3d 20  {.      u64 v = 
c090: 30 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 3b 0a  0;.      int n;.
c0a0: 0a 20 20 20 20 20 20 69 66 28 20 62 75 66 5b 30  .      if( buf[0
c0b0: 5d 26 30 78 38 30 20 29 7b 0a 20 20 20 20 20 20  ]&0x80 ){.      
c0c0: 20 20 76 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20    v = -1;.      
c0d0: 7d 0a 20 20 20 20 20 20 66 6f 72 28 6e 3d 30 3b  }.      for(n=0;
c0e0: 20 6e 3c 6c 65 6e 3b 20 6e 2b 2b 29 7b 0a 20 20   n<len; n++){.  
c0f0: 20 20 20 20 20 20 76 20 3d 20 28 76 3c 3c 38 29        v = (v<<8)
c100: 20 7c 20 62 75 66 5b 6e 5d 3b 0a 20 20 20 20 20   | buf[n];.     
c110: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 73 65 72   }.      if( ser
c120: 69 61 6c 5f 74 79 70 65 3d 3d 37 20 29 7b 0a 20  ial_type==7 ){. 
c130: 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61         pMem->fla
c140: 67 73 20 3d 20 4d 45 4d 5f 52 65 61 6c 3b 0a 20  gs = MEM_Real;. 
c150: 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 72 20 3d         pMem->r =
c160: 20 2a 28 64 6f 75 62 6c 65 2a 29 26 76 3b 0a 20   *(double*)&v;. 
c170: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
c180: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
c190: 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20  = MEM_Int;.     
c1a0: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 2a 28 69     pMem->i = *(i
c1b0: 36 34 2a 29 26 76 3b 0a 20 20 20 20 20 20 7d 0a  64*)&v;.      }.
c1c0: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20      }.  }else{. 
c1d0: 20 20 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72 20     /* String or 
c1e0: 62 6c 6f 62 20 2a 2f 0a 20 20 20 20 61 73 73 65  blob */.    asse
c1f0: 72 74 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3e  rt( serial_type>
c200: 3d 31 32 20 29 3b 0a 20 20 20 20 70 4d 65 6d 2d  =12 );.    pMem-
c210: 3e 7a 20 3d 20 28 63 68 61 72 20 2a 29 62 75 66  >z = (char *)buf
c220: 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 6e 20 3d 20  ;.    pMem->n = 
c230: 6c 65 6e 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 78  len;.    pMem->x
c240: 44 65 6c 20 3d 20 30 3b 0a 20 20 20 20 69 66 28  Del = 0;.    if(
c250: 20 73 65 72 69 61 6c 5f 74 79 70 65 26 30 78 30   serial_type&0x0
c260: 31 20 29 7b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  1 ){.      pMem-
c270: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 74 72  >flags = MEM_Str
c280: 20 7c 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20   | MEM_Ephem;.  
c290: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70    }else{.      p
c2a0: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
c2b0: 5f 42 6c 6f 62 20 7c 20 4d 45 4d 5f 45 70 68 65  _Blob | MEM_Ephe
c2c0: 6d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  m;.    }.  }.  r
c2d0: 65 74 75 72 6e 20 6c 65 6e 3b 0a 7d 0a 0a 2f 2a  eturn len;.}../*
c2e0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
c2f0: 6e 20 63 6f 6d 70 61 72 65 73 20 74 68 65 20 74  n compares the t
c300: 77 6f 20 74 61 62 6c 65 20 72 6f 77 73 20 6f 72  wo table rows or
c310: 20 69 6e 64 65 78 20 72 65 63 6f 72 64 73 20 73   index records s
c320: 70 65 63 69 66 69 65 64 20 62 79 20 0a 2a 2a 20  pecified by .** 
c330: 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20 61  {nKey1, pKey1} a
c340: 6e 64 20 7b 6e 4b 65 79 32 2c 20 70 4b 65 79 32  nd {nKey2, pKey2
c350: 7d 2c 20 72 65 74 75 72 6e 69 6e 67 20 61 20 6e  }, returning a n
c360: 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 0a 2a 2a  egative, zero.**
c370: 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 6e 74   or positive int
c380: 65 67 65 72 20 69 66 20 7b 6e 4b 65 79 31 2c 20  eger if {nKey1, 
c390: 70 4b 65 79 31 7d 20 69 73 20 6c 65 73 73 20 74  pKey1} is less t
c3a0: 68 61 6e 2c 20 65 71 75 61 6c 20 74 6f 20 6f 72  han, equal to or
c3b0: 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61   .** greater tha
c3c0: 6e 20 7b 6e 4b 65 79 32 2c 20 70 4b 65 79 32 7d  n {nKey2, pKey2}
c3d0: 2e 20 20 42 6f 74 68 20 4b 65 79 31 20 61 6e 64  .  Both Key1 and
c3e0: 20 4b 65 79 32 20 6d 75 73 74 20 62 65 20 62 79   Key2 must be by
c3f0: 74 65 20 73 74 72 69 6e 67 73 0a 2a 2a 20 63 6f  te strings.** co
c400: 6d 70 6f 73 65 64 20 62 79 20 74 68 65 20 4f 50  mposed by the OP
c410: 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f  _MakeRecord opco
c420: 64 65 20 6f 66 20 74 68 65 20 56 44 42 45 2e 0a  de of the VDBE..
c430: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
c440: 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28  beRecordCompare(
c450: 0a 20 20 76 6f 69 64 20 2a 75 73 65 72 44 61 74  .  void *userDat
c460: 61 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20  a,.  int nKey1, 
c470: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79  const void *pKey
c480: 31 2c 20 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c  1, .  int nKey2,
c490: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65   const void *pKe
c4a0: 79 32 0a 29 7b 0a 20 20 4b 65 79 49 6e 66 6f 20  y2.){.  KeyInfo 
c4b0: 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 28 4b 65 79  *pKeyInfo = (Key
c4c0: 49 6e 66 6f 2a 29 75 73 65 72 44 61 74 61 3b 0a  Info*)userData;.
c4d0: 20 20 75 33 32 20 64 31 2c 20 64 32 3b 20 20 20    u32 d1, d2;   
c4e0: 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74         /* Offset
c4f0: 20 69 6e 74 6f 20 61 4b 65 79 5b 5d 20 6f 66 20   into aKey[] of 
c500: 6e 65 78 74 20 64 61 74 61 20 65 6c 65 6d 65 6e  next data elemen
c510: 74 20 2a 2f 0a 20 20 75 33 32 20 69 64 78 31 2c  t */.  u32 idx1,
c520: 20 69 64 78 32 3b 20 20 20 20 20 20 2f 2a 20 4f   idx2;      /* O
c530: 66 66 73 65 74 20 69 6e 74 6f 20 61 4b 65 79 5b  ffset into aKey[
c540: 5d 20 6f 66 20 6e 65 78 74 20 68 65 61 64 65 72  ] of next header
c550: 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 75 33   element */.  u3
c560: 32 20 73 7a 48 64 72 31 2c 20 73 7a 48 64 72 32  2 szHdr1, szHdr2
c570: 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20  ;  /* Number of 
c580: 62 79 74 65 73 20 69 6e 20 68 65 61 64 65 72 20  bytes in header 
c590: 2a 2f 0a 20 20 69 6e 74 20 69 20 3d 20 30 3b 0a  */.  int i = 0;.
c5a0: 20 20 69 6e 74 20 6e 46 69 65 6c 64 3b 0a 20 20    int nField;.  
c5b0: 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20 20 63 6f  int rc = 0;.  co
c5c0: 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61  nst unsigned cha
c5d0: 72 20 2a 61 4b 65 79 31 20 3d 20 28 63 6f 6e 73  r *aKey1 = (cons
c5e0: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20  t unsigned char 
c5f0: 2a 29 70 4b 65 79 31 3b 0a 20 20 63 6f 6e 73 74  *)pKey1;.  const
c600: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
c610: 61 4b 65 79 32 20 3d 20 28 63 6f 6e 73 74 20 75  aKey2 = (const u
c620: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29 70  nsigned char *)p
c630: 4b 65 79 32 3b 0a 0a 20 20 4d 65 6d 20 6d 65 6d  Key2;..  Mem mem
c640: 31 3b 0a 20 20 4d 65 6d 20 6d 65 6d 32 3b 0a 20  1;.  Mem mem2;. 
c650: 20 6d 65 6d 31 2e 65 6e 63 20 3d 20 70 4b 65 79   mem1.enc = pKey
c660: 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20 6d 65 6d  Info->enc;.  mem
c670: 32 2e 65 6e 63 20 3d 20 70 4b 65 79 49 6e 66 6f  2.enc = pKeyInfo
c680: 2d 3e 65 6e 63 3b 0a 20 20 0a 20 20 69 64 78 31  ->enc;.  .  idx1
c690: 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56 61 72   = sqlite3GetVar
c6a0: 69 6e 74 33 32 28 70 4b 65 79 31 2c 20 26 73 7a  int32(pKey1, &sz
c6b0: 48 64 72 31 29 3b 0a 20 20 64 31 20 3d 20 73 7a  Hdr1);.  d1 = sz
c6c0: 48 64 72 31 3b 0a 20 20 69 64 78 32 20 3d 20 73  Hdr1;.  idx2 = s
c6d0: 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33  qlite3GetVarint3
c6e0: 32 28 70 4b 65 79 32 2c 20 26 73 7a 48 64 72 32  2(pKey2, &szHdr2
c6f0: 29 3b 0a 20 20 64 32 20 3d 20 73 7a 48 64 72 32  );.  d2 = szHdr2
c700: 3b 0a 20 20 6e 46 69 65 6c 64 20 3d 20 70 4b 65  ;.  nField = pKe
c710: 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 3b 0a 20  yInfo->nField;. 
c720: 20 77 68 69 6c 65 28 20 69 64 78 31 3c 73 7a 48   while( idx1<szH
c730: 64 72 31 20 26 26 20 69 64 78 32 3c 73 7a 48 64  dr1 && idx2<szHd
c740: 72 32 20 29 7b 0a 20 20 20 20 75 33 32 20 73 65  r2 ){.    u32 se
c750: 72 69 61 6c 5f 74 79 70 65 31 3b 0a 20 20 20 20  rial_type1;.    
c760: 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65 32  u32 serial_type2
c770: 3b 0a 0a 20 20 20 20 2f 2a 20 52 65 61 64 20 74  ;..    /* Read t
c780: 68 65 20 73 65 72 69 61 6c 20 74 79 70 65 73 20  he serial types 
c790: 66 6f 72 20 74 68 65 20 6e 65 78 74 20 65 6c 65  for the next ele
c7a0: 6d 65 6e 74 20 69 6e 20 65 61 63 68 20 6b 65 79  ment in each key
c7b0: 2e 20 2a 2f 0a 20 20 20 20 69 64 78 31 20 2b 3d  . */.    idx1 +=
c7c0: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
c7d0: 74 33 32 28 26 61 4b 65 79 31 5b 69 64 78 31 5d  t32(&aKey1[idx1]
c7e0: 2c 20 26 73 65 72 69 61 6c 5f 74 79 70 65 31 29  , &serial_type1)
c7f0: 3b 0a 20 20 20 20 69 66 28 20 64 31 3e 3d 6e 4b  ;.    if( d1>=nK
c800: 65 79 31 20 26 26 20 73 71 6c 69 74 65 33 56 64  ey1 && sqlite3Vd
c810: 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28  beSerialTypeLen(
c820: 73 65 72 69 61 6c 5f 74 79 70 65 31 29 3e 30 20  serial_type1)>0 
c830: 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 69 64 78  ) break;.    idx
c840: 32 20 2b 3d 20 73 71 6c 69 74 65 33 47 65 74 56  2 += sqlite3GetV
c850: 61 72 69 6e 74 33 32 28 26 61 4b 65 79 32 5b 69  arint32(&aKey2[i
c860: 64 78 32 5d 2c 20 26 73 65 72 69 61 6c 5f 74 79  dx2], &serial_ty
c870: 70 65 32 29 3b 0a 20 20 20 20 69 66 28 20 64 32  pe2);.    if( d2
c880: 3e 3d 6e 4b 65 79 32 20 26 26 20 73 71 6c 69 74  >=nKey2 && sqlit
c890: 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65  e3VdbeSerialType
c8a0: 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 32  Len(serial_type2
c8b0: 29 3e 30 20 29 20 62 72 65 61 6b 3b 0a 0a 20 20  )>0 ) break;..  
c8c0: 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74    /* Assert that
c8d0: 20 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67 68   there is enough
c8e0: 20 73 70 61 63 65 20 6c 65 66 74 20 69 6e 20 65   space left in e
c8f0: 61 63 68 20 6b 65 79 20 66 6f 72 20 74 68 65 20  ach key for the 
c900: 62 6c 6f 62 20 6f 66 0a 20 20 20 20 2a 2a 20 64  blob of.    ** d
c910: 61 74 61 20 74 6f 20 67 6f 20 77 69 74 68 20 74  ata to go with t
c920: 68 65 20 73 65 72 69 61 6c 20 74 79 70 65 20 6a  he serial type j
c930: 75 73 74 20 72 65 61 64 2e 20 54 68 69 73 20 61  ust read. This a
c940: 73 73 65 72 74 20 6d 61 79 20 66 61 69 6c 20 69  ssert may fail i
c950: 66 0a 20 20 20 20 2a 2a 20 74 68 65 20 66 69 6c  f.    ** the fil
c960: 65 20 69 73 20 63 6f 72 72 75 70 74 65 64 2e 20  e is corrupted. 
c970: 20 54 68 65 6e 20 72 65 61 64 20 74 68 65 20 76   Then read the v
c980: 61 6c 75 65 20 66 72 6f 6d 20 65 61 63 68 20 6b  alue from each k
c990: 65 79 20 69 6e 74 6f 20 6d 65 6d 31 0a 20 20 20  ey into mem1.   
c9a0: 20 2a 2a 20 61 6e 64 20 6d 65 6d 32 20 72 65 73   ** and mem2 res
c9b0: 70 65 63 74 69 76 65 6c 79 2e 0a 20 20 20 20 2a  pectively..    *
c9c0: 2f 0a 20 20 20 20 64 31 20 2b 3d 20 73 71 6c 69  /.    d1 += sqli
c9d0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65 74  te3VdbeSerialGet
c9e0: 28 26 61 4b 65 79 31 5b 64 31 5d 2c 20 73 65 72  (&aKey1[d1], ser
c9f0: 69 61 6c 5f 74 79 70 65 31 2c 20 26 6d 65 6d 31  ial_type1, &mem1
ca00: 29 3b 0a 20 20 20 20 64 32 20 2b 3d 20 73 71 6c  );.    d2 += sql
ca10: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65  ite3VdbeSerialGe
ca20: 74 28 26 61 4b 65 79 32 5b 64 32 5d 2c 20 73 65  t(&aKey2[d2], se
ca30: 72 69 61 6c 5f 74 79 70 65 32 2c 20 26 6d 65 6d  rial_type2, &mem
ca40: 32 29 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73 71  2);..    rc = sq
ca50: 6c 69 74 65 33 4d 65 6d 43 6f 6d 70 61 72 65 28  lite3MemCompare(
ca60: 26 6d 65 6d 31 2c 20 26 6d 65 6d 32 2c 20 69 3c  &mem1, &mem2, i<
ca70: 6e 46 69 65 6c 64 20 3f 20 70 4b 65 79 49 6e 66  nField ? pKeyInf
ca80: 6f 2d 3e 61 43 6f 6c 6c 5b 69 5d 20 3a 20 30 29  o->aColl[i] : 0)
ca90: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
caa0: 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 65 6d  eMemRelease(&mem
cab0: 31 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56  1);.    sqlite3V
cac0: 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d  dbeMemRelease(&m
cad0: 65 6d 32 29 3b 0a 20 20 20 20 69 66 28 20 72 63  em2);.    if( rc
cae0: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 62 72 65  !=0 ){.      bre
caf0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 2b  ak;.    }.    i+
cb00: 2b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 6e 65  +;.  }..  /* One
cb10: 20 6f 66 20 74 68 65 20 6b 65 79 73 20 72 61 6e   of the keys ran
cb20: 20 6f 75 74 20 6f 66 20 66 69 65 6c 64 73 2c 20   out of fields, 
cb30: 62 75 74 20 61 6c 6c 20 74 68 65 20 66 69 65 6c  but all the fiel
cb40: 64 73 20 75 70 20 74 6f 20 74 68 61 74 20 70 6f  ds up to that po
cb50: 69 6e 74 0a 20 20 2a 2a 20 77 65 72 65 20 65 71  int.  ** were eq
cb60: 75 61 6c 2e 20 49 66 20 74 68 65 20 69 6e 63 72  ual. If the incr
cb70: 4b 65 79 20 66 6c 61 67 20 69 73 20 74 72 75 65  Key flag is true
cb80: 2c 20 74 68 65 6e 20 74 68 65 20 73 65 63 6f 6e  , then the secon
cb90: 64 20 6b 65 79 20 69 73 0a 20 20 2a 2a 20 74 72  d key is.  ** tr
cba0: 65 61 74 65 64 20 61 73 20 6c 61 72 67 65 72 2e  eated as larger.
cbb0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d  .  */.  if( rc==
cbc0: 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 4b 65  0 ){.    if( pKe
cbd0: 79 49 6e 66 6f 2d 3e 69 6e 63 72 4b 65 79 20 29  yInfo->incrKey )
cbe0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 2d 31 3b  {.      rc = -1;
cbf0: 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 64  .    }else if( d
cc00: 31 3c 6e 4b 65 79 31 20 29 7b 0a 20 20 20 20 20  1<nKey1 ){.     
cc10: 20 72 63 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c   rc = 1;.    }el
cc20: 73 65 20 69 66 28 20 64 32 3c 6e 4b 65 79 32 20  se if( d2<nKey2 
cc30: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 2d 31  ){.      rc = -1
cc40: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69  ;.    }.  }..  i
cc50: 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f  f( pKeyInfo->aSo
cc60: 72 74 4f 72 64 65 72 20 26 26 20 69 3c 70 4b 65  rtOrder && i<pKe
cc70: 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 20 26 26  yInfo->nField &&
cc80: 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74   pKeyInfo->aSort
cc90: 4f 72 64 65 72 5b 69 5d 20 29 7b 0a 20 20 20 20  Order[i] ){.    
cca0: 72 63 20 3d 20 2d 72 63 3b 0a 20 20 7d 0a 0a 20  rc = -rc;.  }.. 
ccb0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
ccc0: 2a 0a 2a 2a 20 54 68 65 20 61 72 67 75 6d 65 6e  *.** The argumen
ccd0: 74 20 69 73 20 61 6e 20 69 6e 64 65 78 20 65 6e  t is an index en
cce0: 74 72 79 20 63 6f 6d 70 6f 73 65 64 20 75 73 69  try composed usi
ccf0: 6e 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65  ng the OP_MakeRe
cd00: 63 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20  cord opcode..** 
cd10: 54 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 69  The last entry i
cd20: 6e 20 74 68 69 73 20 72 65 63 6f 72 64 20 73 68  n this record sh
cd30: 6f 75 6c 64 20 62 65 20 61 6e 20 69 6e 74 65 67  ould be an integ
cd40: 65 72 20 28 73 70 65 63 69 66 69 63 61 6c 6c 79  er (specifically
cd50: 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 20 72  .** an integer r
cd60: 6f 77 69 64 29 2e 20 20 54 68 69 73 20 72 6f 75  owid).  This rou
cd70: 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68 65  tine returns the
cd80: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
cd90: 20 69 6e 0a 2a 2a 20 74 68 61 74 20 69 6e 74 65   in.** that inte
cda0: 67 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ger..*/.int sqli
cdb0: 74 65 33 56 64 62 65 49 64 78 52 6f 77 69 64 4c  te3VdbeIdxRowidL
cdc0: 65 6e 28 69 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e  en(int nKey, con
cdd0: 73 74 20 75 38 20 2a 61 4b 65 79 29 7b 0a 20 20  st u8 *aKey){.  
cde0: 75 33 32 20 73 7a 48 64 72 3b 20 20 20 20 20 20  u32 szHdr;      
cdf0: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65    /* Size of the
ce00: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75 33 32   header */.  u32
ce10: 20 74 79 70 65 52 6f 77 69 64 3b 20 20 20 20 2f   typeRowid;    /
ce20: 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 6f 66  * Serial type of
ce30: 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 0a 20   the rowid */.. 
ce40: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
ce50: 74 33 32 28 61 4b 65 79 2c 20 26 73 7a 48 64 72  t32(aKey, &szHdr
ce60: 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56  );.  sqlite3GetV
ce70: 61 72 69 6e 74 33 32 28 26 61 4b 65 79 5b 73 7a  arint32(&aKey[sz
ce80: 48 64 72 2d 31 5d 2c 20 26 74 79 70 65 52 6f 77  Hdr-1], &typeRow
ce90: 69 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 73 71  id);.  return sq
cea0: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54  lite3VdbeSerialT
ceb0: 79 70 65 4c 65 6e 28 74 79 70 65 52 6f 77 69 64  ypeLen(typeRowid
cec0: 29 3b 0a 7d 0a 20 20 0a 0a 2f 2a 0a 2a 2a 20 70  );.}.  ../*.** p
ced0: 43 75 72 20 70 6f 69 6e 74 73 20 61 74 20 61 6e  Cur points at an
cee0: 20 69 6e 64 65 78 20 65 6e 74 72 79 20 63 72 65   index entry cre
cef0: 61 74 65 64 20 75 73 69 6e 67 20 74 68 65 20 4f  ated using the O
cf00: 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63  P_MakeRecord opc
cf10: 6f 64 65 2e 0a 2a 2a 20 52 65 61 64 20 74 68 65  ode..** Read the
cf20: 20 72 6f 77 69 64 20 28 74 68 65 20 6c 61 73 74   rowid (the last
cf30: 20 66 69 65 6c 64 20 69 6e 20 74 68 65 20 72 65   field in the re
cf40: 63 6f 72 64 29 20 61 6e 64 20 73 74 6f 72 65 20  cord) and store 
cf50: 69 74 20 69 6e 20 2a 72 6f 77 69 64 2e 0a 2a 2a  it in *rowid..**
cf60: 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   Return SQLITE_O
cf70: 4b 20 69 66 20 65 76 65 72 79 74 68 69 6e 67 20  K if everything 
cf80: 77 6f 72 6b 73 2c 20 6f 72 20 61 6e 20 65 72 72  works, or an err
cf90: 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 77 69 73  or code otherwis
cfa0: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
cfb0: 33 56 64 62 65 49 64 78 52 6f 77 69 64 28 42 74  3VdbeIdxRowid(Bt
cfc0: 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 36  Cursor *pCur, i6
cfd0: 34 20 2a 72 6f 77 69 64 29 7b 0a 20 20 69 36 34  4 *rowid){.  i64
cfe0: 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74   nCellKey;.  int
cff0: 20 72 63 3b 0a 20 20 75 33 32 20 73 7a 48 64 72   rc;.  u32 szHdr
d000: 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65  ;        /* Size
d010: 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20 2a   of the header *
d020: 2f 0a 20 20 75 33 32 20 74 79 70 65 52 6f 77 69  /.  u32 typeRowi
d030: 64 3b 20 20 20 20 2f 2a 20 53 65 72 69 61 6c 20  d;    /* Serial 
d040: 74 79 70 65 20 6f 66 20 74 68 65 20 72 6f 77 69  type of the rowi
d050: 64 20 2a 2f 0a 20 20 75 33 32 20 6c 65 6e 52 6f  d */.  u32 lenRo
d060: 77 69 64 3b 20 20 20 20 20 2f 2a 20 53 69 7a 65  wid;     /* Size
d070: 20 6f 66 20 74 68 65 20 72 6f 77 69 64 20 2a 2f   of the rowid */
d080: 0a 20 20 4d 65 6d 20 6d 2c 20 76 3b 0a 0a 20 20  .  Mem m, v;..  
d090: 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79 53  sqlite3BtreeKeyS
d0a0: 69 7a 65 28 70 43 75 72 2c 20 26 6e 43 65 6c 6c  ize(pCur, &nCell
d0b0: 4b 65 79 29 3b 0a 20 20 69 66 28 20 6e 43 65 6c  Key);.  if( nCel
d0c0: 6c 4b 65 79 3c 3d 30 20 29 7b 0a 20 20 20 20 72  lKey<=0 ){.    r
d0d0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52  eturn SQLITE_COR
d0e0: 52 55 50 54 3b 0a 20 20 7d 0a 20 20 72 63 20 3d  RUPT;.  }.  rc =
d0f0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 46   sqlite3VdbeMemF
d100: 72 6f 6d 42 74 72 65 65 28 70 43 75 72 2c 20 30  romBtree(pCur, 0
d110: 2c 20 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c 20 26  , nCellKey, 1, &
d120: 6d 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a  m);.  if( rc ){.
d130: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
d140: 20 7d 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56   }.  sqlite3GetV
d150: 61 72 69 6e 74 33 32 28 6d 2e 7a 2c 20 26 73 7a  arint32(m.z, &sz
d160: 48 64 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47  Hdr);.  sqlite3G
d170: 65 74 56 61 72 69 6e 74 33 32 28 26 6d 2e 7a 5b  etVarint32(&m.z[
d180: 73 7a 48 64 72 2d 31 5d 2c 20 26 74 79 70 65 52  szHdr-1], &typeR
d190: 6f 77 69 64 29 3b 0a 20 20 6c 65 6e 52 6f 77 69  owid);.  lenRowi
d1a0: 64 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53  d = sqlite3VdbeS
d1b0: 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 74 79 70  erialTypeLen(typ
d1c0: 65 52 6f 77 69 64 29 3b 0a 20 20 73 71 6c 69 74  eRowid);.  sqlit
d1d0: 65 33 56 64 62 65 53 65 72 69 61 6c 47 65 74 28  e3VdbeSerialGet(
d1e0: 26 6d 2e 7a 5b 6d 2e 6e 2d 6c 65 6e 52 6f 77 69  &m.z[m.n-lenRowi
d1f0: 64 5d 2c 20 74 79 70 65 52 6f 77 69 64 2c 20 26  d], typeRowid, &
d200: 76 29 3b 0a 20 20 2a 72 6f 77 69 64 20 3d 20 76  v);.  *rowid = v
d210: 2e 69 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  .i;.  sqlite3Vdb
d220: 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 29 3b  eMemRelease(&m);
d230: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
d240: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f  _OK;.}../*.** Co
d250: 6d 70 61 72 65 20 74 68 65 20 6b 65 79 20 6f 66  mpare the key of
d260: 20 74 68 65 20 69 6e 64 65 78 20 65 6e 74 72 79   the index entry
d270: 20 74 68 61 74 20 63 75 72 73 6f 72 20 70 43 20   that cursor pC 
d280: 69 73 20 70 6f 69 6e 74 20 74 6f 20 61 67 61 69  is point to agai
d290: 6e 73 74 0a 2a 2a 20 74 68 65 20 6b 65 79 20 73  nst.** the key s
d2a0: 74 72 69 6e 67 20 69 6e 20 70 4b 65 79 20 28 6f  tring in pKey (o
d2b0: 66 20 6c 65 6e 67 74 68 20 6e 4b 65 79 29 2e 20  f length nKey). 
d2c0: 20 57 72 69 74 65 20 69 6e 74 6f 20 2a 70 52 65   Write into *pRe
d2d0: 73 20 61 20 6e 75 6d 62 65 72 0a 2a 2a 20 74 68  s a number.** th
d2e0: 61 74 20 69 73 20 6e 65 67 61 74 69 76 65 2c 20  at is negative, 
d2f0: 7a 65 72 6f 2c 20 6f 72 20 70 6f 73 69 74 69 76  zero, or positiv
d300: 65 20 69 66 20 70 43 20 69 73 20 6c 65 73 73 20  e if pC is less 
d310: 74 68 61 6e 2c 20 65 71 75 61 6c 20 74 6f 2c 0a  than, equal to,.
d320: 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 20 74 68  ** or greater th
d330: 61 6e 20 70 4b 65 79 2e 20 20 52 65 74 75 72 6e  an pKey.  Return
d340: 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75   SQLITE_OK on su
d350: 63 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 70 4b 65  ccess..**.** pKe
d360: 79 20 69 73 20 65 69 74 68 65 72 20 63 72 65 61  y is either crea
d370: 74 65 64 20 77 69 74 68 6f 75 74 20 61 20 72 6f  ted without a ro
d380: 77 69 64 20 6f 72 20 69 73 20 74 72 75 6e 63 61  wid or is trunca
d390: 74 65 64 20 73 6f 20 74 68 61 74 20 69 74 0a 2a  ted so that it.*
d3a0: 2a 20 6f 6d 69 74 73 20 74 68 65 20 72 6f 77 69  * omits the rowi
d3b0: 64 20 61 74 20 74 68 65 20 65 6e 64 2e 20 20 54  d at the end.  T
d3c0: 68 65 20 72 6f 77 69 64 20 61 74 20 74 68 65 20  he rowid at the 
d3d0: 65 6e 64 20 6f 66 20 74 68 65 20 69 6e 64 65 78  end of the index
d3e0: 20 65 6e 74 72 79 0a 2a 2a 20 69 73 20 69 67 6e   entry.** is ign
d3f0: 6f 72 65 64 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f  ored as well..*/
d400: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
d410: 49 64 78 4b 65 79 43 6f 6d 70 61 72 65 28 0a 20  IdxKeyCompare(. 
d420: 20 43 75 72 73 6f 72 20 2a 70 43 2c 20 20 20 20   Cursor *pC,    
d430: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
d440: 54 68 65 20 63 75 72 73 6f 72 20 74 6f 20 63 6f  The cursor to co
d450: 6d 70 61 72 65 20 61 67 61 69 6e 73 74 20 2a 2f  mpare against */
d460: 0a 20 20 69 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e  .  int nKey, con
d470: 73 74 20 75 38 20 2a 70 4b 65 79 2c 20 20 20 2f  st u8 *pKey,   /
d480: 2a 20 54 68 65 20 6b 65 79 20 74 6f 20 63 6f 6d  * The key to com
d490: 70 61 72 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 72  pare */.  int *r
d4a0: 65 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20  es              
d4b0: 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 74        /* Write t
d4c0: 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e 20 72 65  he comparison re
d4d0: 73 75 6c 74 20 68 65 72 65 20 2a 2f 0a 29 7b 0a  sult here */.){.
d4e0: 20 20 69 36 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a    i64 nCellKey;.
d4f0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 43 75    int rc;.  BtCu
d500: 72 73 6f 72 20 2a 70 43 75 72 20 3d 20 70 43 2d  rsor *pCur = pC-
d510: 3e 70 43 75 72 73 6f 72 3b 0a 20 20 69 6e 74 20  >pCursor;.  int 
d520: 6c 65 6e 52 6f 77 69 64 3b 0a 20 20 4d 65 6d 20  lenRowid;.  Mem 
d530: 6d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72  m;..  sqlite3Btr
d540: 65 65 4b 65 79 53 69 7a 65 28 70 43 75 72 2c 20  eeKeySize(pCur, 
d550: 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 69 66  &nCellKey);.  if
d560: 28 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b  ( nCellKey<=0 ){
d570: 0a 20 20 20 20 2a 72 65 73 20 3d 20 30 3b 0a 20  .    *res = 0;. 
d580: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
d590: 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20  _OK;.  }.  rc = 
d5a0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 46 72  sqlite3VdbeMemFr
d5b0: 6f 6d 42 74 72 65 65 28 70 43 2d 3e 70 43 75 72  omBtree(pC->pCur
d5c0: 73 6f 72 2c 20 30 2c 20 6e 43 65 6c 6c 4b 65 79  sor, 0, nCellKey
d5d0: 2c 20 31 2c 20 26 6d 29 3b 0a 20 20 69 66 28 20  , 1, &m);.  if( 
d5e0: 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  rc ){.    return
d5f0: 20 72 63 3b 0a 20 20 7d 0a 20 20 6c 65 6e 52 6f   rc;.  }.  lenRo
d600: 77 69 64 20 3d 20 73 71 6c 69 74 65 33 56 64 62  wid = sqlite3Vdb
d610: 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 6d 2e 6e  eIdxRowidLen(m.n
d620: 2c 20 6d 2e 7a 29 3b 0a 20 20 2a 72 65 73 20 3d  , m.z);.  *res =
d630: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
d640: 72 64 43 6f 6d 70 61 72 65 28 70 43 2d 3e 70 4b  rdCompare(pC->pK
d650: 65 79 49 6e 66 6f 2c 20 6d 2e 6e 2d 6c 65 6e 52  eyInfo, m.n-lenR
d660: 6f 77 69 64 2c 20 6d 2e 7a 2c 20 6e 4b 65 79 2c  owid, m.z, nKey,
d670: 20 70 4b 65 79 29 3b 0a 20 20 73 71 6c 69 74 65   pKey);.  sqlite
d680: 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28  3VdbeMemRelease(
d690: 26 6d 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  &m);.  return SQ
d6a0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
d6b0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
d6c0: 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 74 6f  ets the value to
d6d0: 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20   be returned by 
d6e0: 73 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73  subsequent calls
d6f0: 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63   to.** sqlite3_c
d700: 68 61 6e 67 65 73 28 29 20 6f 6e 20 74 68 65 20  hanges() on the 
d710: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  database handle 
d720: 27 64 62 27 2e 20 0a 2a 2f 0a 76 6f 69 64 20 73  'db'. .*/.void s
d730: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61  qlite3VdbeSetCha
d740: 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62  nges(sqlite3 *db
d750: 2c 20 69 6e 74 20 6e 43 68 61 6e 67 65 29 7b 0a  , int nChange){.
d760: 20 20 64 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20    db->nChange = 
d770: 6e 43 68 61 6e 67 65 3b 0a 20 20 64 62 2d 3e 6e  nChange;.  db->n
d780: 54 6f 74 61 6c 43 68 61 6e 67 65 20 2b 3d 20 6e  TotalChange += n
d790: 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Change;.}../*.**
d7a0: 20 53 65 74 20 61 20 66 6c 61 67 20 69 6e 20 74   Set a flag in t
d7b0: 68 65 20 76 64 62 65 20 74 6f 20 75 70 64 61 74  he vdbe to updat
d7c0: 65 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f 75  e the change cou
d7d0: 6e 74 65 72 20 77 68 65 6e 20 69 74 20 69 73 20  nter when it is 
d7e0: 66 69 6e 61 6c 69 73 65 64 0a 2a 2a 20 6f 72 20  finalised.** or 
d7f0: 72 65 73 65 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73  reset..*/.void s
d800: 71 6c 69 74 65 33 56 64 62 65 43 6f 75 6e 74 43  qlite3VdbeCountC
d810: 68 61 6e 67 65 73 28 56 64 62 65 20 2a 76 29 7b  hanges(Vdbe *v){
d820: 0a 20 20 76 2d 3e 63 68 61 6e 67 65 43 6e 74 4f  .  v->changeCntO
d830: 6e 20 3d 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  n = 1;.}../*.** 
d840: 4d 61 72 6b 20 65 76 65 72 79 20 70 72 65 70 61  Mark every prepa
d850: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 73  red statement as
d860: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20  sociated with a 
d870: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
d880: 69 6f 6e 0a 2a 2a 20 61 73 20 65 78 70 69 72 65  ion.** as expire
d890: 64 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 69  d..**.** An expi
d8a0: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 6d 65  red statement me
d8b0: 61 6e 73 20 74 68 61 74 20 72 65 63 6f 6d 70 69  ans that recompi
d8c0: 6c 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 74  lation of the st
d8d0: 61 74 65 6d 65 6e 74 20 69 73 0a 2a 2a 20 72 65  atement is.** re
d8e0: 63 6f 6d 6d 65 6e 64 2e 20 20 53 74 61 74 65 6d  commend.  Statem
d8f0: 65 6e 74 73 20 65 78 70 69 72 65 20 77 68 65 6e  ents expire when
d900: 20 74 68 69 6e 67 73 20 68 61 70 70 65 6e 20 74   things happen t
d910: 68 61 74 20 6d 61 6b 65 20 74 68 65 69 72 0a 2a  hat make their.*
d920: 2a 20 70 72 6f 67 72 61 6d 73 20 6f 62 73 6f 6c  * programs obsol
d930: 65 74 65 2e 20 20 52 65 6d 6f 76 69 6e 67 20 75  ete.  Removing u
d940: 73 65 72 2d 64 65 66 69 6e 65 64 20 66 75 6e 63  ser-defined func
d950: 74 69 6f 6e 73 20 6f 72 20 63 6f 6c 6c 61 74 69  tions or collati
d960: 6e 67 0a 2a 2a 20 73 65 71 75 65 6e 63 65 73 2c  ng.** sequences,
d970: 20 6f 72 20 63 68 61 6e 67 69 6e 67 20 61 6e 20   or changing an 
d980: 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 66 75  authorization fu
d990: 6e 63 74 69 6f 6e 20 61 72 65 20 74 68 65 20 74  nction are the t
d9a0: 79 70 65 73 20 6f 66 0a 2a 2a 20 74 68 69 6e 67  ypes of.** thing
d9b0: 73 20 74 68 61 74 20 6d 61 6b 65 20 70 72 65 70  s that make prep
d9c0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 20  ared statements 
d9d0: 6f 62 73 6f 6c 65 74 65 2e 0a 2a 2f 0a 76 6f 69  obsolete..*/.voi
d9e0: 64 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 50  d sqlite3ExpireP
d9f0: 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74  reparedStatement
da00: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  s(sqlite3 *db){.
da10: 20 20 56 64 62 65 20 2a 70 3b 0a 20 20 66 6f 72    Vdbe *p;.  for
da20: 28 70 20 3d 20 64 62 2d 3e 70 56 64 62 65 3b 20  (p = db->pVdbe; 
da30: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a  p; p=p->pNext){.
da40: 20 20 20 20 70 2d 3e 65 78 70 69 72 65 64 20 3d      p->expired =
da50: 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a   1;.  }.}../*.**
da60: 20 52 65 74 75 72 6e 20 74 68 65 20 64 61 74 61   Return the data
da70: 62 61 73 65 20 61 73 73 6f 63 69 61 74 65 64 20  base associated 
da80: 77 69 74 68 20 74 68 65 20 56 64 62 65 2e 0a 2a  with the Vdbe..*
da90: 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74  /.sqlite3 *sqlit
daa0: 65 33 56 64 62 65 44 62 28 56 64 62 65 20 2a 76  e3VdbeDb(Vdbe *v
dab0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 76 2d 3e 64  ){.  return v->d
dac0: 62 3b 0a 7d 0a                                   b;.}.