/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact 8f79f57c66ce1030f6371ff067b326d627a52c6d:


0000: 2f 2a 0a 2a 2a 20 43 6f 70 79 72 69 67 68 74 20  /*.** Copyright 
0010: 28 63 29 20 31 39 39 39 2c 20 32 30 30 30 20 44  (c) 1999, 2000 D
0020: 2e 20 52 69 63 68 61 72 64 20 48 69 70 70 0a 2a  . Richard Hipp.*
0030: 2a 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61  *.** This progra
0040: 6d 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61  m is free softwa
0050: 72 65 3b 20 79 6f 75 20 63 61 6e 20 72 65 64 69  re; you can redi
0060: 73 74 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f  stribute it and/
0070: 6f 72 0a 2a 2a 20 6d 6f 64 69 66 79 20 69 74 20  or.** modify it 
0080: 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20  under the terms 
0090: 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72  of the GNU Gener
00a0: 61 6c 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63  al Public.** Lic
00b0: 65 6e 73 65 20 61 73 20 70 75 62 6c 69 73 68 65  ense as publishe
00c0: 64 20 62 79 20 74 68 65 20 46 72 65 65 20 53 6f  d by the Free So
00d0: 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f  ftware Foundatio
00e0: 6e 3b 20 65 69 74 68 65 72 0a 2a 2a 20 76 65 72  n; either.** ver
00f0: 73 69 6f 6e 20 32 20 6f 66 20 74 68 65 20 4c 69  sion 2 of the Li
0100: 63 65 6e 73 65 2c 20 6f 72 20 28 61 74 20 79 6f  cense, or (at yo
0110: 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 6c  ur option) any l
0120: 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 2a 2a  ater version..**
0130: 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61 6d  .** This program
0140: 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20   is distributed 
0150: 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 74  in the hope that
0160: 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 66   it will be usef
0170: 75 6c 2c 0a 2a 2a 20 62 75 74 20 57 49 54 48 4f  ul,.** but WITHO
0180: 55 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 3b  UT ANY WARRANTY;
0190: 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68   without even th
01a0: 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 6e  e implied warran
01b0: 74 79 20 6f 66 0a 2a 2a 20 4d 45 52 43 48 41 4e  ty of.** MERCHAN
01c0: 54 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e  TABILITY or FITN
01d0: 45 53 53 20 46 4f 52 20 41 20 50 41 52 54 49 43  ESS FOR A PARTIC
01e0: 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 53  ULAR PURPOSE.  S
01f0: 65 65 20 74 68 65 20 47 4e 55 0a 2a 2a 20 47 65  ee the GNU.** Ge
0200: 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63  neral Public Lic
0210: 65 6e 73 65 20 66 6f 72 20 6d 6f 72 65 20 64 65  ense for more de
0220: 74 61 69 6c 73 2e 0a 2a 2a 20 0a 2a 2a 20 59 6f  tails..** .** Yo
0230: 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65  u should have re
0240: 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 6f 66  ceived a copy of
0250: 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c   the GNU General
0260: 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63 65 6e   Public.** Licen
0270: 73 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68  se along with th
0280: 69 73 20 6c 69 62 72 61 72 79 3b 20 69 66 20 6e  is library; if n
0290: 6f 74 2c 20 77 72 69 74 65 20 74 6f 20 74 68 65  ot, write to the
02a0: 0a 2a 2a 20 46 72 65 65 20 53 6f 66 74 77 61 72  .** Free Softwar
02b0: 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 49 6e  e Foundation, In
02c0: 63 2e 2c 20 35 39 20 54 65 6d 70 6c 65 20 50 6c  c., 59 Temple Pl
02d0: 61 63 65 20 2d 20 53 75 69 74 65 20 33 33 30 2c  ace - Suite 330,
02e0: 0a 2a 2a 20 42 6f 73 74 6f 6e 2c 20 4d 41 20 20  .** Boston, MA  
02f0: 30 32 31 31 31 2d 31 33 30 37 2c 20 55 53 41 2e  02111-1307, USA.
0300: 0a 2a 2a 0a 2a 2a 20 41 75 74 68 6f 72 20 63 6f  .**.** Author co
0310: 6e 74 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f  ntact informatio
0320: 6e 3a 0a 2a 2a 20 20 20 64 72 68 40 68 77 61 63  n:.**   drh@hwac
0330: 69 2e 63 6f 6d 0a 2a 2a 20 20 20 68 74 74 70 3a  i.com.**   http:
0340: 2f 2f 77 77 77 2e 68 77 61 63 69 2e 63 6f 6d 2f  //www.hwaci.com/
0350: 64 72 68 2f 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  drh/.**.********
0360: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0370: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0390: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
03a0: 2a 0a 2a 2a 20 48 65 61 64 65 72 20 66 69 6c 65  *.** Header file
03b0: 20 66 6f 72 20 74 68 65 20 56 69 72 74 75 61 6c   for the Virtual
03c0: 20 44 61 74 61 42 61 73 65 20 45 6e 67 69 6e 65   DataBase Engine
03d0: 20 28 56 44 42 45 29 0a 2a 2a 0a 2a 2a 20 54 68   (VDBE).**.** Th
03e0: 69 73 20 68 65 61 64 65 72 20 64 65 66 69 6e 65  is header define
03f0: 73 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 20  s the interface 
0400: 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 64  to the virtual d
0410: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 0a 2a  atabase engine.*
0420: 2a 20 6f 72 20 56 44 42 45 2e 20 20 54 68 65 20  * or VDBE.  The 
0430: 56 44 42 45 20 69 6d 70 6c 65 6d 65 6e 74 73 20  VDBE implements 
0440: 61 6e 20 61 62 73 74 72 61 63 74 20 6d 61 63 68  an abstract mach
0450: 69 6e 65 20 74 68 61 74 20 72 75 6e 73 20 61 0a  ine that runs a.
0460: 2a 2a 20 73 69 6d 70 6c 65 20 70 72 6f 67 72 61  ** simple progra
0470: 6d 20 74 6f 20 61 63 63 65 73 73 20 61 6e 64 20  m to access and 
0480: 6d 6f 64 69 66 79 20 74 68 65 20 75 6e 64 65 72  modify the under
0490: 6c 79 69 6e 67 20 64 61 74 61 62 61 73 65 2e 0a  lying database..
04a0: 2a 2a 0a 2a 2a 20 24 49 64 3a 20 76 64 62 65 2e  **.** $Id: vdbe.
04b0: 68 2c 76 20 31 2e 39 20 32 30 30 30 2f 30 36 2f  h,v 1.9 2000/06/
04c0: 30 36 20 32 31 3a 35 36 3a 30 38 20 64 72 68 20  06 21:56:08 drh 
04d0: 45 78 70 20 24 0a 2a 2f 0a 23 69 66 6e 64 65 66  Exp $.*/.#ifndef
04e0: 20 5f 53 51 4c 49 54 45 5f 56 44 42 45 5f 48 5f   _SQLITE_VDBE_H_
04f0: 0a 23 64 65 66 69 6e 65 20 5f 53 51 4c 49 54 45  .#define _SQLITE
0500: 5f 56 44 42 45 5f 48 5f 0a 23 69 6e 63 6c 75 64  _VDBE_H_.#includ
0510: 65 20 3c 73 74 64 69 6f 2e 68 3e 0a 0a 2f 2a 0a  e <stdio.h>../*.
0520: 2a 2a 20 41 20 73 69 6e 67 6c 65 20 56 44 42 45  ** A single VDBE
0530: 20 69 73 20 61 6e 20 6f 70 61 71 75 65 20 73 74   is an opaque st
0540: 72 75 63 74 75 72 65 20 6e 61 6d 65 64 20 22 56  ructure named "V
0550: 64 62 65 22 2e 20 20 4f 6e 6c 79 20 72 6f 75 74  dbe".  Only rout
0560: 69 6e 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 73  ines.** in the s
0570: 6f 75 72 63 65 20 66 69 6c 65 20 73 71 6c 69 74  ource file sqlit
0580: 65 56 64 62 65 2e 63 20 61 72 65 20 61 6c 6c 6f  eVdbe.c are allo
0590: 77 65 64 20 74 6f 20 73 65 65 20 74 68 65 20 69  wed to see the i
05a0: 6e 73 69 64 65 73 0a 2a 2a 20 6f 66 20 74 68 69  nsides.** of thi
05b0: 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a  s structure..*/.
05c0: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 56  typedef struct V
05d0: 64 62 65 20 56 64 62 65 3b 0a 0a 2f 2a 0a 2a 2a  dbe Vdbe;../*.**
05e0: 20 41 20 73 69 6e 67 6c 65 20 69 6e 73 74 72 75   A single instru
05f0: 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 69 72  ction of the vir
0600: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 68 61 73  tual machine has
0610: 20 61 6e 20 6f 70 63 6f 64 65 0a 2a 2a 20 61 6e   an opcode.** an
0620: 64 20 61 73 20 6d 61 6e 79 20 61 73 20 74 68 72  d as many as thr
0630: 65 65 20 6f 70 65 72 61 6e 64 73 2e 20 20 54 68  ee operands.  Th
0640: 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 73  e instruction is
0650: 20 72 65 63 6f 72 64 65 64 0a 2a 2a 20 61 73 20   recorded.** as 
0660: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  an instance of t
0670: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72  he following str
0680: 75 63 74 75 72 65 3a 0a 2a 2f 0a 73 74 72 75 63  ucture:.*/.struc
0690: 74 20 56 64 62 65 4f 70 20 7b 0a 20 20 69 6e 74  t VdbeOp {.  int
06a0: 20 6f 70 63 6f 64 65 3b 20 20 20 20 20 20 20 20   opcode;        
06b0: 20 2f 2a 20 57 68 61 74 20 6f 70 65 72 61 74 69   /* What operati
06c0: 6f 6e 20 74 6f 20 70 65 72 66 6f 72 6d 20 2a 2f  on to perform */
06d0: 0a 20 20 69 6e 74 20 70 31 3b 20 20 20 20 20 20  .  int p1;      
06e0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20         /* First 
06f0: 6f 70 65 72 61 6e 64 20 2a 2f 0a 20 20 69 6e 74  operand */.  int
0700: 20 70 32 3b 20 20 20 20 20 20 20 20 20 20 20 20   p2;            
0710: 20 2f 2a 20 53 65 63 6f 6e 64 20 70 61 72 61 6d   /* Second param
0720: 65 74 65 72 20 28 6f 66 74 65 6e 20 74 68 65 20  eter (often the 
0730: 6a 75 6d 70 20 64 65 73 74 69 6e 61 74 69 6f 6e  jump destination
0740: 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 70 33 3b  ) */.  char *p3;
0750: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
0760: 69 72 64 20 70 61 72 61 6d 65 74 65 72 20 2a 2f  ird parameter */
0770: 0a 7d 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75  .};.typedef stru
0780: 63 74 20 56 64 62 65 4f 70 20 56 64 62 65 4f 70  ct VdbeOp VdbeOp
0790: 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c  ;../*.** The fol
07a0: 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 20 63 6f 6e  lowing macro con
07b0: 76 65 72 74 73 20 61 20 72 65 6c 61 74 69 76 65  verts a relative
07c0: 20 61 64 64 72 65 73 73 20 69 6e 20 74 68 65 20   address in the 
07d0: 70 32 20 66 69 65 6c 64 0a 2a 2a 20 6f 66 20 61  p2 field.** of a
07e0: 20 56 64 62 65 4f 70 20 73 74 72 75 63 74 75 72   VdbeOp structur
07f0: 65 20 69 6e 74 6f 20 61 20 6e 65 67 61 74 69 76  e into a negativ
0800: 65 20 6e 75 6d 62 65 72 20 73 6f 20 74 68 61 74  e number so that
0810: 20 0a 2a 2a 20 73 71 6c 69 74 65 56 64 62 65 41   .** sqliteVdbeA
0820: 64 64 4f 70 4c 69 73 74 28 29 20 6b 6e 6f 77 73  ddOpList() knows
0830: 20 74 68 61 74 20 74 68 65 20 61 64 64 72 65 73   that the addres
0840: 73 20 69 73 20 72 65 6c 61 74 69 76 65 2e 20 20  s is relative.  
0850: 43 61 6c 6c 69 6e 67 0a 2a 2a 20 74 68 65 20 6d  Calling.** the m
0860: 61 63 72 6f 20 61 67 61 69 6e 20 72 65 73 74 6f  acro again resto
0870: 72 65 73 20 74 68 65 20 61 64 64 72 65 73 73 2e  res the address.
0880: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 41 44 44 52  .*/.#define ADDR
0890: 28 58 29 20 20 28 2d 31 2d 28 58 29 29 0a 0a 2f  (X)  (-1-(X))../
08a0: 2a 0a 2a 2a 20 54 68 65 73 65 20 61 72 65 20 74  *.** These are t
08b0: 68 65 20 61 76 61 69 6c 61 62 6c 65 20 6f 70 63  he available opc
08c0: 6f 64 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61  odes..**.** If a
08d0: 6e 79 20 6f 66 20 74 68 65 20 76 61 6c 75 65 73  ny of the values
08e0: 20 63 68 61 6e 67 65 73 20 6f 72 20 69 66 20 6f   changes or if o
08f0: 70 63 6f 64 65 73 20 61 72 65 20 61 64 64 65 64  pcodes are added
0900: 20 6f 72 20 72 65 6d 6f 76 65 64 2c 0a 2a 2a 20   or removed,.** 
0910: 62 65 20 73 75 72 65 20 74 6f 20 61 6c 73 6f 20  be sure to also 
0920: 75 70 64 61 74 65 20 74 68 65 20 7a 4f 70 4e 61  update the zOpNa
0930: 6d 65 5b 5d 20 61 72 72 61 79 20 69 6e 20 73 71  me[] array in sq
0940: 6c 69 74 65 56 64 62 65 2e 63 20 74 6f 0a 2a 2a  liteVdbe.c to.**
0950: 20 6d 69 72 72 6f 72 20 74 68 65 20 63 68 61 6e   mirror the chan
0960: 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 6f  ge..**.** The so
0970: 75 72 63 65 20 74 72 65 65 20 63 6f 6e 74 61 69  urce tree contai
0980: 6e 73 20 61 6e 20 41 57 4b 20 73 63 72 69 70 74  ns an AWK script
0990: 20 6e 61 6d 65 64 20 72 65 6e 75 6d 62 65 72 4f   named renumberO
09a0: 70 73 2e 61 77 6b 20 74 68 61 74 0a 2a 2a 20 63  ps.awk that.** c
09b0: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 72 65  an be used to re
09c0: 6e 75 6d 62 65 72 20 74 68 65 73 65 20 6f 70 63  number these opc
09d0: 6f 64 65 73 20 77 68 65 6e 20 6e 65 77 20 6f 70  odes when new op
09e0: 63 6f 64 65 73 20 61 72 65 20 69 6e 73 65 72 74  codes are insert
09f0: 65 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f  ed..*/.#define O
0a00: 50 5f 4f 70 65 6e 20 20 20 20 20 20 20 20 20 20  P_Open          
0a10: 20 20 20 20 20 20 31 0a 23 64 65 66 69 6e 65 20        1.#define 
0a20: 4f 50 5f 43 6c 6f 73 65 20 20 20 20 20 20 20 20  OP_Close        
0a30: 20 20 20 20 20 20 20 32 0a 23 64 65 66 69 6e 65         2.#define
0a40: 20 4f 50 5f 46 65 74 63 68 20 20 20 20 20 20 20   OP_Fetch       
0a50: 20 20 20 20 20 20 20 20 33 0a 23 64 65 66 69 6e          3.#defin
0a60: 65 20 4f 50 5f 4e 65 77 20 20 20 20 20 20 20 20  e OP_New        
0a70: 20 20 20 20 20 20 20 20 20 34 0a 23 64 65 66 69           4.#defi
0a80: 6e 65 20 4f 50 5f 50 75 74 20 20 20 20 20 20 20  ne OP_Put       
0a90: 20 20 20 20 20 20 20 20 20 20 35 0a 23 64 65 66            5.#def
0aa0: 69 6e 65 20 4f 50 5f 44 69 73 74 69 6e 63 74 20  ine OP_Distinct 
0ab0: 20 20 20 20 20 20 20 20 20 20 20 36 0a 23 64 65             6.#de
0ac0: 66 69 6e 65 20 4f 50 5f 46 6f 75 6e 64 20 20 20  fine OP_Found   
0ad0: 20 20 20 20 20 20 20 20 20 20 20 20 37 0a 23 64              7.#d
0ae0: 65 66 69 6e 65 20 4f 50 5f 4e 6f 74 46 6f 75 6e  efine OP_NotFoun
0af0: 64 20 20 20 20 20 20 20 20 20 20 20 20 38 0a 23  d            8.#
0b00: 64 65 66 69 6e 65 20 4f 50 5f 44 65 6c 65 74 65  define OP_Delete
0b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 39 0a                9.
0b20: 23 64 65 66 69 6e 65 20 4f 50 5f 46 69 65 6c 64  #define OP_Field
0b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 30                10
0b40: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4b 65 79 41  .#define OP_KeyA
0b50: 73 44 61 74 61 20 20 20 20 20 20 20 20 20 20 31  sData          1
0b60: 31 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4b 65 79  1.#define OP_Key
0b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0b80: 31 32 0a 23 64 65 66 69 6e 65 20 4f 50 5f 52 65  12.#define OP_Re
0b90: 77 69 6e 64 20 20 20 20 20 20 20 20 20 20 20 20  wind            
0ba0: 20 31 33 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4e   13.#define OP_N
0bb0: 65 78 74 20 20 20 20 20 20 20 20 20 20 20 20 20  ext             
0bc0: 20 20 31 34 0a 0a 23 64 65 66 69 6e 65 20 4f 50    14..#define OP
0bd0: 5f 44 65 73 74 72 6f 79 20 20 20 20 20 20 20 20  _Destroy        
0be0: 20 20 20 20 31 35 0a 23 64 65 66 69 6e 65 20 4f      15.#define O
0bf0: 50 5f 52 65 6f 72 67 61 6e 69 7a 65 20 20 20 20  P_Reorganize    
0c00: 20 20 20 20 20 31 36 0a 0a 23 64 65 66 69 6e 65       16..#define
0c10: 20 4f 50 5f 52 65 73 65 74 49 64 78 20 20 20 20   OP_ResetIdx    
0c20: 20 20 20 20 20 20 20 31 37 0a 23 64 65 66 69 6e         17.#defin
0c30: 65 20 4f 50 5f 4e 65 78 74 49 64 78 20 20 20 20  e OP_NextIdx    
0c40: 20 20 20 20 20 20 20 20 31 38 0a 23 64 65 66 69          18.#defi
0c50: 6e 65 20 4f 50 5f 50 75 74 49 64 78 20 20 20 20  ne OP_PutIdx    
0c60: 20 20 20 20 20 20 20 20 20 31 39 0a 23 64 65 66           19.#def
0c70: 69 6e 65 20 4f 50 5f 44 65 6c 65 74 65 49 64 78  ine OP_DeleteIdx
0c80: 20 20 20 20 20 20 20 20 20 20 32 30 0a 0a 23 64            20..#d
0c90: 65 66 69 6e 65 20 4f 50 5f 4d 65 6d 4c 6f 61 64  efine OP_MemLoad
0ca0: 20 20 20 20 20 20 20 20 20 20 20 20 32 31 0a 23              21.#
0cb0: 64 65 66 69 6e 65 20 4f 50 5f 4d 65 6d 53 74 6f  define OP_MemSto
0cc0: 72 65 20 20 20 20 20 20 20 20 20 20 20 32 32 0a  re           22.
0cd0: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4c 69 73 74  .#define OP_List
0ce0: 4f 70 65 6e 20 20 20 20 20 20 20 20 20 20 20 32  Open           2
0cf0: 33 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4c 69 73  3.#define OP_Lis
0d00: 74 57 72 69 74 65 20 20 20 20 20 20 20 20 20 20  tWrite          
0d10: 32 34 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4c 69  24.#define OP_Li
0d20: 73 74 52 65 77 69 6e 64 20 20 20 20 20 20 20 20  stRewind        
0d30: 20 32 35 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4c   25.#define OP_L
0d40: 69 73 74 52 65 61 64 20 20 20 20 20 20 20 20 20  istRead         
0d50: 20 20 32 36 0a 23 64 65 66 69 6e 65 20 4f 50 5f    26.#define OP_
0d60: 4c 69 73 74 43 6c 6f 73 65 20 20 20 20 20 20 20  ListClose       
0d70: 20 20 20 32 37 0a 0a 23 64 65 66 69 6e 65 20 4f     27..#define O
0d80: 50 5f 53 6f 72 74 4f 70 65 6e 20 20 20 20 20 20  P_SortOpen      
0d90: 20 20 20 20 20 32 38 0a 23 64 65 66 69 6e 65 20       28.#define 
0da0: 4f 50 5f 53 6f 72 74 50 75 74 20 20 20 20 20 20  OP_SortPut      
0db0: 20 20 20 20 20 20 32 39 0a 23 64 65 66 69 6e 65        29.#define
0dc0: 20 4f 50 5f 53 6f 72 74 4d 61 6b 65 52 65 63 20   OP_SortMakeRec 
0dd0: 20 20 20 20 20 20 20 33 30 0a 23 64 65 66 69 6e         30.#defin
0de0: 65 20 4f 50 5f 53 6f 72 74 4d 61 6b 65 4b 65 79  e OP_SortMakeKey
0df0: 20 20 20 20 20 20 20 20 33 31 0a 23 64 65 66 69          31.#defi
0e00: 6e 65 20 4f 50 5f 53 6f 72 74 20 20 20 20 20 20  ne OP_Sort      
0e10: 20 20 20 20 20 20 20 20 20 33 32 0a 23 64 65 66           32.#def
0e20: 69 6e 65 20 4f 50 5f 53 6f 72 74 4e 65 78 74 20  ine OP_SortNext 
0e30: 20 20 20 20 20 20 20 20 20 20 33 33 0a 23 64 65            33.#de
0e40: 66 69 6e 65 20 4f 50 5f 53 6f 72 74 4b 65 79 20  fine OP_SortKey 
0e50: 20 20 20 20 20 20 20 20 20 20 20 33 34 0a 23 64             34.#d
0e60: 65 66 69 6e 65 20 4f 50 5f 53 6f 72 74 43 61 6c  efine OP_SortCal
0e70: 6c 62 61 63 6b 20 20 20 20 20 20 20 33 35 0a 23  lback       35.#
0e80: 64 65 66 69 6e 65 20 4f 50 5f 53 6f 72 74 43 6c  define OP_SortCl
0e90: 6f 73 65 20 20 20 20 20 20 20 20 20 20 33 36 0a  ose          36.
0ea0: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 46 69 6c 65  .#define OP_File
0eb0: 4f 70 65 6e 20 20 20 20 20 20 20 20 20 20 20 33  Open           3
0ec0: 37 0a 23 64 65 66 69 6e 65 20 4f 50 5f 46 69 6c  7.#define OP_Fil
0ed0: 65 52 65 61 64 20 20 20 20 20 20 20 20 20 20 20  eRead           
0ee0: 33 38 0a 23 64 65 66 69 6e 65 20 4f 50 5f 46 69  38.#define OP_Fi
0ef0: 6c 65 46 69 65 6c 64 20 20 20 20 20 20 20 20 20  leField         
0f00: 20 33 39 0a 23 64 65 66 69 6e 65 20 4f 50 5f 46   39.#define OP_F
0f10: 69 6c 65 43 6c 6f 73 65 20 20 20 20 20 20 20 20  ileClose        
0f20: 20 20 34 30 0a 0a 23 64 65 66 69 6e 65 20 4f 50    40..#define OP
0f30: 5f 41 67 67 52 65 73 65 74 20 20 20 20 20 20 20  _AggReset       
0f40: 20 20 20 20 34 31 0a 23 64 65 66 69 6e 65 20 4f      41.#define O
0f50: 50 5f 41 67 67 46 6f 63 75 73 20 20 20 20 20 20  P_AggFocus      
0f60: 20 20 20 20 20 34 32 0a 23 64 65 66 69 6e 65 20       42.#define 
0f70: 4f 50 5f 41 67 67 49 6e 63 72 20 20 20 20 20 20  OP_AggIncr      
0f80: 20 20 20 20 20 20 34 33 0a 23 64 65 66 69 6e 65        43.#define
0f90: 20 4f 50 5f 41 67 67 4e 65 78 74 20 20 20 20 20   OP_AggNext     
0fa0: 20 20 20 20 20 20 20 34 34 0a 23 64 65 66 69 6e         44.#defin
0fb0: 65 20 4f 50 5f 41 67 67 53 65 74 20 20 20 20 20  e OP_AggSet     
0fc0: 20 20 20 20 20 20 20 20 34 35 0a 23 64 65 66 69          45.#defi
0fd0: 6e 65 20 4f 50 5f 41 67 67 47 65 74 20 20 20 20  ne OP_AggGet    
0fe0: 20 20 20 20 20 20 20 20 20 34 36 0a 0a 23 64 65           46..#de
0ff0: 66 69 6e 65 20 4f 50 5f 53 65 74 49 6e 73 65 72  fine OP_SetInser
1000: 74 20 20 20 20 20 20 20 20 20 20 34 37 0a 23 64  t          47.#d
1010: 65 66 69 6e 65 20 4f 50 5f 53 65 74 46 6f 75 6e  efine OP_SetFoun
1020: 64 20 20 20 20 20 20 20 20 20 20 20 34 38 0a 23  d           48.#
1030: 64 65 66 69 6e 65 20 4f 50 5f 53 65 74 4e 6f 74  define OP_SetNot
1040: 46 6f 75 6e 64 20 20 20 20 20 20 20 20 34 39 0a  Found        49.
1050: 23 64 65 66 69 6e 65 20 4f 50 5f 53 65 74 43 6c  #define OP_SetCl
1060: 65 61 72 20 20 20 20 20 20 20 20 20 20 20 35 30  ear           50
1070: 0a 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4d 61 6b  ..#define OP_Mak
1080: 65 52 65 63 6f 72 64 20 20 20 20 20 20 20 20 20  eRecord         
1090: 35 31 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4d 61  51.#define OP_Ma
10a0: 6b 65 4b 65 79 20 20 20 20 20 20 20 20 20 20 20  keKey           
10b0: 20 35 32 0a 0a 23 64 65 66 69 6e 65 20 4f 50 5f   52..#define OP_
10c0: 47 6f 74 6f 20 20 20 20 20 20 20 20 20 20 20 20  Goto            
10d0: 20 20 20 35 33 0a 23 64 65 66 69 6e 65 20 4f 50     53.#define OP
10e0: 5f 49 66 20 20 20 20 20 20 20 20 20 20 20 20 20  _If             
10f0: 20 20 20 20 35 34 0a 23 64 65 66 69 6e 65 20 4f      54.#define O
1100: 50 5f 48 61 6c 74 20 20 20 20 20 20 20 20 20 20  P_Halt          
1110: 20 20 20 20 20 35 35 0a 0a 23 64 65 66 69 6e 65       55..#define
1120: 20 4f 50 5f 43 6f 6c 75 6d 6e 43 6f 75 6e 74 20   OP_ColumnCount 
1130: 20 20 20 20 20 20 20 35 36 0a 23 64 65 66 69 6e         56.#defin
1140: 65 20 4f 50 5f 43 6f 6c 75 6d 6e 4e 61 6d 65 20  e OP_ColumnName 
1150: 20 20 20 20 20 20 20 20 35 37 0a 23 64 65 66 69          57.#defi
1160: 6e 65 20 4f 50 5f 43 61 6c 6c 62 61 63 6b 20 20  ne OP_Callback  
1170: 20 20 20 20 20 20 20 20 20 35 38 0a 0a 23 64 65           58..#de
1180: 66 69 6e 65 20 4f 50 5f 49 6e 74 65 67 65 72 20  fine OP_Integer 
1190: 20 20 20 20 20 20 20 20 20 20 20 35 39 0a 23 64             59.#d
11a0: 65 66 69 6e 65 20 4f 50 5f 53 74 72 69 6e 67 20  efine OP_String 
11b0: 20 20 20 20 20 20 20 20 20 20 20 20 36 30 0a 23              60.#
11c0: 64 65 66 69 6e 65 20 4f 50 5f 4e 75 6c 6c 20 20  define OP_Null  
11d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 36 31 0a               61.
11e0: 23 64 65 66 69 6e 65 20 4f 50 5f 50 6f 70 20 20  #define OP_Pop  
11f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 36 32                62
1200: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 44 75 70 20  .#define OP_Dup 
1210: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 36                 6
1220: 33 0a 23 64 65 66 69 6e 65 20 4f 50 5f 50 75 6c  3.#define OP_Pul
1230: 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  l               
1240: 36 34 0a 0a 23 64 65 66 69 6e 65 20 4f 50 5f 41  64..#define OP_A
1250: 64 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20  dd              
1260: 20 20 36 35 0a 23 64 65 66 69 6e 65 20 4f 50 5f    65.#define OP_
1270: 41 64 64 49 6d 6d 20 20 20 20 20 20 20 20 20 20  AddImm          
1280: 20 20 20 36 36 0a 23 64 65 66 69 6e 65 20 4f 50     66.#define OP
1290: 5f 53 75 62 74 72 61 63 74 20 20 20 20 20 20 20  _Subtract       
12a0: 20 20 20 20 36 37 0a 23 64 65 66 69 6e 65 20 4f      67.#define O
12b0: 50 5f 4d 75 6c 74 69 70 6c 79 20 20 20 20 20 20  P_Multiply      
12c0: 20 20 20 20 20 36 38 0a 23 64 65 66 69 6e 65 20       68.#define 
12d0: 4f 50 5f 44 69 76 69 64 65 20 20 20 20 20 20 20  OP_Divide       
12e0: 20 20 20 20 20 20 36 39 0a 23 64 65 66 69 6e 65        69.#define
12f0: 20 4f 50 5f 4d 69 6e 20 20 20 20 20 20 20 20 20   OP_Min         
1300: 20 20 20 20 20 20 20 37 30 0a 23 64 65 66 69 6e         70.#defin
1310: 65 20 4f 50 5f 4d 61 78 20 20 20 20 20 20 20 20  e OP_Max        
1320: 20 20 20 20 20 20 20 20 37 31 0a 23 64 65 66 69          71.#defi
1330: 6e 65 20 4f 50 5f 4c 69 6b 65 20 20 20 20 20 20  ne OP_Like      
1340: 20 20 20 20 20 20 20 20 20 37 32 0a 23 64 65 66           72.#def
1350: 69 6e 65 20 4f 50 5f 47 6c 6f 62 20 20 20 20 20  ine OP_Glob     
1360: 20 20 20 20 20 20 20 20 20 20 37 33 0a 23 64 65            73.#de
1370: 66 69 6e 65 20 4f 50 5f 45 71 20 20 20 20 20 20  fine OP_Eq      
1380: 20 20 20 20 20 20 20 20 20 20 20 37 34 0a 23 64             74.#d
1390: 65 66 69 6e 65 20 4f 50 5f 4e 65 20 20 20 20 20  efine OP_Ne     
13a0: 20 20 20 20 20 20 20 20 20 20 20 20 37 35 0a 23              75.#
13b0: 64 65 66 69 6e 65 20 4f 50 5f 4c 74 20 20 20 20  define OP_Lt    
13c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 37 36 0a               76.
13d0: 23 64 65 66 69 6e 65 20 4f 50 5f 4c 65 20 20 20  #define OP_Le   
13e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 37 37                77
13f0: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 47 74 20 20  .#define OP_Gt  
1400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 37                 7
1410: 38 0a 23 64 65 66 69 6e 65 20 4f 50 5f 47 65 20  8.#define OP_Ge 
1420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1430: 37 39 0a 23 64 65 66 69 6e 65 20 4f 50 5f 49 73  79.#define OP_Is
1440: 4e 75 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20  Null            
1450: 20 38 30 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4e   80.#define OP_N
1460: 6f 74 4e 75 6c 6c 20 20 20 20 20 20 20 20 20 20  otNull          
1470: 20 20 38 31 0a 23 64 65 66 69 6e 65 20 4f 50 5f    81.#define OP_
1480: 4e 65 67 61 74 69 76 65 20 20 20 20 20 20 20 20  Negative        
1490: 20 20 20 38 32 0a 23 64 65 66 69 6e 65 20 4f 50     82.#define OP
14a0: 5f 41 6e 64 20 20 20 20 20 20 20 20 20 20 20 20  _And            
14b0: 20 20 20 20 38 33 0a 23 64 65 66 69 6e 65 20 4f      83.#define O
14c0: 50 5f 4f 72 20 20 20 20 20 20 20 20 20 20 20 20  P_Or            
14d0: 20 20 20 20 20 38 34 0a 23 64 65 66 69 6e 65 20       84.#define 
14e0: 4f 50 5f 4e 6f 74 20 20 20 20 20 20 20 20 20 20  OP_Not          
14f0: 20 20 20 20 20 20 38 35 0a 23 64 65 66 69 6e 65        85.#define
1500: 20 4f 50 5f 43 6f 6e 63 61 74 20 20 20 20 20 20   OP_Concat      
1510: 20 20 20 20 20 20 20 38 36 0a 23 64 65 66 69 6e         86.#defin
1520: 65 20 4f 50 5f 4e 6f 6f 70 20 20 20 20 20 20 20  e OP_Noop       
1530: 20 20 20 20 20 20 20 20 38 37 0a 0a 23 64 65 66          87..#def
1540: 69 6e 65 20 4f 50 5f 4d 41 58 20 20 20 20 20 20  ine OP_MAX      
1550: 20 20 20 20 20 20 20 20 20 20 38 37 0a 0a 2f 2a            87../*
1560: 0a 2a 2a 20 50 72 6f 74 6f 74 79 70 65 73 20 66  .** Prototypes f
1570: 6f 72 20 74 68 65 20 56 44 42 45 20 69 6e 74 65  or the VDBE inte
1580: 72 66 61 63 65 2e 20 20 53 65 65 20 63 6f 6d 6d  rface.  See comm
1590: 65 6e 74 73 20 6f 6e 20 74 68 65 20 69 6d 70 6c  ents on the impl
15a0: 65 6d 65 6e 74 61 74 69 6f 6e 0a 2a 2a 20 66 6f  ementation.** fo
15b0: 72 20 61 20 64 65 73 63 72 69 70 74 69 6f 6e 20  r a description 
15c0: 6f 66 20 77 68 61 74 20 65 61 63 68 20 6f 66 20  of what each of 
15d0: 74 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 64  these routines d
15e0: 6f 65 73 2e 0a 2a 2f 0a 56 64 62 65 20 2a 73 71  oes..*/.Vdbe *sq
15f0: 6c 69 74 65 56 64 62 65 43 72 65 61 74 65 28 44  liteVdbeCreate(D
1600: 62 62 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  bbe*);.int sqlit
1610: 65 56 64 62 65 41 64 64 4f 70 28 56 64 62 65 2a  eVdbeAddOp(Vdbe*
1620: 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 63 6f 6e  ,int,int,int,con
1630: 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 69  st char*,int);.i
1640: 6e 74 20 73 71 6c 69 74 65 56 64 62 65 41 64 64  nt sqliteVdbeAdd
1650: 4f 70 4c 69 73 74 28 56 64 62 65 2a 2c 20 69 6e  OpList(Vdbe*, in
1660: 74 20 6e 4f 70 2c 20 56 64 62 65 4f 70 20 63 6f  t nOp, VdbeOp co
1670: 6e 73 74 20 2a 61 4f 70 29 3b 0a 76 6f 69 64 20  nst *aOp);.void 
1680: 73 71 6c 69 74 65 56 64 62 65 43 68 61 6e 67 65  sqliteVdbeChange
1690: 50 33 28 56 64 62 65 2a 2c 20 69 6e 74 20 61 64  P3(Vdbe*, int ad
16a0: 64 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  dr, const char *
16b0: 7a 50 31 2c 20 69 6e 74 20 4e 29 3b 0a 76 6f 69  zP1, int N);.voi
16c0: 64 20 73 71 6c 69 74 65 56 64 62 65 44 65 71 75  d sqliteVdbeDequ
16d0: 6f 74 65 50 33 28 56 64 62 65 2a 2c 20 69 6e 74  oteP3(Vdbe*, int
16e0: 20 61 64 64 72 29 3b 0a 69 6e 74 20 73 71 6c 69   addr);.int sqli
16f0: 74 65 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28  teVdbeMakeLabel(
1700: 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c  Vdbe*);.void sql
1710: 69 74 65 56 64 62 65 44 65 6c 65 74 65 28 56 64  iteVdbeDelete(Vd
1720: 62 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  be*);.int sqlite
1730: 56 64 62 65 4f 70 63 6f 64 65 28 63 6f 6e 73 74  VdbeOpcode(const
1740: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 29 3b 0a 69   char *zName);.i
1750: 6e 74 20 73 71 6c 69 74 65 56 64 62 65 45 78 65  nt sqliteVdbeExe
1760: 63 28 56 64 62 65 2a 2c 73 71 6c 69 74 65 5f 63  c(Vdbe*,sqlite_c
1770: 61 6c 6c 62 61 63 6b 2c 76 6f 69 64 2a 2c 63 68  allback,void*,ch
1780: 61 72 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  ar**);.int sqlit
1790: 65 56 64 62 65 4c 69 73 74 28 56 64 62 65 2a 2c  eVdbeList(Vdbe*,
17a0: 73 71 6c 69 74 65 5f 63 61 6c 6c 62 61 63 6b 2c  sqlite_callback,
17b0: 76 6f 69 64 2a 2c 63 68 61 72 2a 2a 29 3b 0a 76  void*,char**);.v
17c0: 6f 69 64 20 73 71 6c 69 74 65 56 64 62 65 52 65  oid sqliteVdbeRe
17d0: 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62 65 2a  solveLabel(Vdbe*
17e0: 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69  , int);.int sqli
17f0: 74 65 56 64 62 65 43 75 72 72 65 6e 74 41 64 64  teVdbeCurrentAdd
1800: 72 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73  r(Vdbe*);.void s
1810: 71 6c 69 74 65 56 64 62 65 54 72 61 63 65 28 56  qliteVdbeTrace(V
1820: 64 62 65 2a 2c 46 49 4c 45 2a 29 3b 0a 0a 0a 23  dbe*,FILE*);...#
1830: 65 6e 64 69 66 0a                                endif.