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

Artifact dc1205da434c6a9da03b5d6b089270bbc8e6d437:


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 31 37 20 32 30 30 31 2f 30 34  h,v 1.17 2001/04
04c0: 2f 30 34 20 31 31 3a 34 38 3a 35 38 20 64 72 68  /04 11:48:58 drh
04d0: 20 45 78 70 20 24 0a 2a 2f 0a 23 69 66 6e 64 65   Exp $.*/.#ifnde
04e0: 66 20 5f 53 51 4c 49 54 45 5f 56 44 42 45 5f 48  f _SQLITE_VDBE_H
04f0: 5f 0a 23 64 65 66 69 6e 65 20 5f 53 51 4c 49 54  _.#define _SQLIT
0500: 45 5f 56 44 42 45 5f 48 5f 0a 23 69 6e 63 6c 75  E_VDBE_H_.#inclu
0510: 64 65 20 3c 73 74 64 69 6f 2e 68 3e 0a 0a 2f 2a  de <stdio.h>../*
0520: 0a 2a 2a 20 41 20 73 69 6e 67 6c 65 20 56 44 42  .** A single VDB
0530: 45 20 69 73 20 61 6e 20 6f 70 61 71 75 65 20 73  E is an opaque s
0540: 74 72 75 63 74 75 72 65 20 6e 61 6d 65 64 20 22  tructure named "
0550: 56 64 62 65 22 2e 20 20 4f 6e 6c 79 20 72 6f 75  Vdbe".  Only rou
0560: 74 69 6e 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20  tines.** in the 
0570: 73 6f 75 72 63 65 20 66 69 6c 65 20 73 71 6c 69  source file sqli
0580: 74 65 56 64 62 65 2e 63 20 61 72 65 20 61 6c 6c  teVdbe.c are all
0590: 6f 77 65 64 20 74 6f 20 73 65 65 20 74 68 65 20  owed to see the 
05a0: 69 6e 73 69 64 65 73 0a 2a 2a 20 6f 66 20 74 68  insides.** of th
05b0: 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f  is structure..*/
05c0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
05d0: 56 64 62 65 20 56 64 62 65 3b 0a 0a 2f 2a 0a 2a  Vdbe Vdbe;../*.*
05e0: 2a 20 41 20 73 69 6e 67 6c 65 20 69 6e 73 74 72  * A single instr
05f0: 75 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 69  uction of the vi
0600: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 68 61  rtual machine ha
0610: 73 20 61 6e 20 6f 70 63 6f 64 65 0a 2a 2a 20 61  s an opcode.** a
0620: 6e 64 20 61 73 20 6d 61 6e 79 20 61 73 20 74 68  nd as many as th
0630: 72 65 65 20 6f 70 65 72 61 6e 64 73 2e 20 20 54  ree operands.  T
0640: 68 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69  he instruction i
0650: 73 20 72 65 63 6f 72 64 65 64 0a 2a 2a 20 61 73  s recorded.** as
0660: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   an instance of 
0670: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74  the following st
0680: 72 75 63 74 75 72 65 3a 0a 2a 2f 0a 73 74 72 75  ructure:.*/.stru
0690: 63 74 20 56 64 62 65 4f 70 20 7b 0a 20 20 69 6e  ct VdbeOp {.  in
06a0: 74 20 6f 70 63 6f 64 65 3b 20 20 20 20 20 20 20  t opcode;       
06b0: 20 20 2f 2a 20 57 68 61 74 20 6f 70 65 72 61 74    /* What operat
06c0: 69 6f 6e 20 74 6f 20 70 65 72 66 6f 72 6d 20 2a  ion to perform *
06d0: 2f 0a 20 20 69 6e 74 20 70 31 3b 20 20 20 20 20  /.  int p1;     
06e0: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74          /* First
06f0: 20 6f 70 65 72 61 6e 64 20 2a 2f 0a 20 20 69 6e   operand */.  in
0700: 74 20 70 32 3b 20 20 20 20 20 20 20 20 20 20 20  t p2;           
0710: 20 20 2f 2a 20 53 65 63 6f 6e 64 20 70 61 72 61    /* Second para
0720: 6d 65 74 65 72 20 28 6f 66 74 65 6e 20 74 68 65  meter (often the
0730: 20 6a 75 6d 70 20 64 65 73 74 69 6e 61 74 69 6f   jump destinatio
0740: 6e 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 70 33  n) */.  char *p3
0750: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54  ;           /* T
0760: 68 69 72 64 20 70 61 72 61 6d 65 74 65 72 20 2a  hird parameter *
0770: 2f 0a 7d 3b 0a 74 79 70 65 64 65 66 20 73 74 72  /.};.typedef str
0780: 75 63 74 20 56 64 62 65 4f 70 20 56 64 62 65 4f  uct VdbeOp VdbeO
0790: 70 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  p;../*.** The fo
07a0: 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 20 63 6f  llowing macro co
07b0: 6e 76 65 72 74 73 20 61 20 72 65 6c 61 74 69 76  nverts a relativ
07c0: 65 20 61 64 64 72 65 73 73 20 69 6e 20 74 68 65  e address in the
07d0: 20 70 32 20 66 69 65 6c 64 0a 2a 2a 20 6f 66 20   p2 field.** of 
07e0: 61 20 56 64 62 65 4f 70 20 73 74 72 75 63 74 75  a VdbeOp structu
07f0: 72 65 20 69 6e 74 6f 20 61 20 6e 65 67 61 74 69  re into a negati
0800: 76 65 20 6e 75 6d 62 65 72 20 73 6f 20 74 68 61  ve number so tha
0810: 74 20 0a 2a 2a 20 73 71 6c 69 74 65 56 64 62 65  t .** sqliteVdbe
0820: 41 64 64 4f 70 4c 69 73 74 28 29 20 6b 6e 6f 77  AddOpList() know
0830: 73 20 74 68 61 74 20 74 68 65 20 61 64 64 72 65  s that the addre
0840: 73 73 20 69 73 20 72 65 6c 61 74 69 76 65 2e 20  ss is relative. 
0850: 20 43 61 6c 6c 69 6e 67 0a 2a 2a 20 74 68 65 20   Calling.** the 
0860: 6d 61 63 72 6f 20 61 67 61 69 6e 20 72 65 73 74  macro again rest
0870: 6f 72 65 73 20 74 68 65 20 61 64 64 72 65 73 73  ores the address
0880: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 41 44 44  ..*/.#define ADD
0890: 52 28 58 29 20 20 28 2d 31 2d 28 58 29 29 0a 0a  R(X)  (-1-(X))..
08a0: 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 61 72 65 20  /*.** These are 
08b0: 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 6f 70  the available op
08c0: 63 6f 64 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  codes..**.** If 
08d0: 61 6e 79 20 6f 66 20 74 68 65 20 76 61 6c 75 65  any of the value
08e0: 73 20 63 68 61 6e 67 65 73 20 6f 72 20 69 66 20  s changes or if 
08f0: 6f 70 63 6f 64 65 73 20 61 72 65 20 61 64 64 65  opcodes are adde
0900: 64 20 6f 72 20 72 65 6d 6f 76 65 64 2c 0a 2a 2a  d or removed,.**
0910: 20 62 65 20 73 75 72 65 20 74 6f 20 61 6c 73 6f   be sure to also
0920: 20 75 70 64 61 74 65 20 74 68 65 20 7a 4f 70 4e   update the zOpN
0930: 61 6d 65 5b 5d 20 61 72 72 61 79 20 69 6e 20 73  ame[] array in s
0940: 71 6c 69 74 65 56 64 62 65 2e 63 20 74 6f 0a 2a  qliteVdbe.c to.*
0950: 2a 20 6d 69 72 72 6f 72 20 74 68 65 20 63 68 61  * mirror the cha
0960: 6e 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73  nge..**.** The s
0970: 6f 75 72 63 65 20 74 72 65 65 20 63 6f 6e 74 61  ource tree conta
0980: 69 6e 73 20 61 6e 20 41 57 4b 20 73 63 72 69 70  ins an AWK scrip
0990: 74 20 6e 61 6d 65 64 20 72 65 6e 75 6d 62 65 72  t named renumber
09a0: 4f 70 73 2e 61 77 6b 20 74 68 61 74 0a 2a 2a 20  Ops.awk that.** 
09b0: 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 72  can be used to r
09c0: 65 6e 75 6d 62 65 72 20 74 68 65 73 65 20 6f 70  enumber these op
09d0: 63 6f 64 65 73 20 77 68 65 6e 20 6e 65 77 20 6f  codes when new o
09e0: 70 63 6f 64 65 73 20 61 72 65 20 69 6e 73 65 72  pcodes are inser
09f0: 74 65 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20  ted..*/.#define 
0a00: 4f 50 5f 4f 70 65 6e 49 64 78 20 20 20 20 20 20  OP_OpenIdx      
0a10: 20 20 20 20 20 20 20 31 0a 23 64 65 66 69 6e 65         1.#define
0a20: 20 4f 50 5f 4f 70 65 6e 54 62 6c 20 20 20 20 20   OP_OpenTbl     
0a30: 20 20 20 20 20 20 20 20 32 0a 23 64 65 66 69 6e          2.#defin
0a40: 65 20 4f 50 5f 43 6c 6f 73 65 20 20 20 20 20 20  e OP_Close      
0a50: 20 20 20 20 20 20 20 20 20 33 0a 23 64 65 66 69           3.#defi
0a60: 6e 65 20 4f 50 5f 46 65 74 63 68 20 20 20 20 20  ne OP_Fetch     
0a70: 20 20 20 20 20 20 20 20 20 20 34 0a 23 64 65 66            4.#def
0a80: 69 6e 65 20 4f 50 5f 46 63 6e 74 20 20 20 20 20  ine OP_Fcnt     
0a90: 20 20 20 20 20 20 20 20 20 20 20 35 0a 23 64 65             5.#de
0aa0: 66 69 6e 65 20 4f 50 5f 4e 65 77 20 20 20 20 20  fine OP_New     
0ab0: 20 20 20 20 20 20 20 20 20 20 20 20 36 0a 23 64              6.#d
0ac0: 65 66 69 6e 65 20 4f 50 5f 50 75 74 20 20 20 20  efine OP_Put    
0ad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 37 0a 23               7.#
0ae0: 64 65 66 69 6e 65 20 4f 50 5f 44 69 73 74 69 6e  define OP_Distin
0af0: 63 74 20 20 20 20 20 20 20 20 20 20 20 20 38 0a  ct            8.
0b00: 23 64 65 66 69 6e 65 20 4f 50 5f 46 6f 75 6e 64  #define OP_Found
0b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 39                 9
0b20: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4e 6f 74 46  .#define OP_NotF
0b30: 6f 75 6e 64 20 20 20 20 20 20 20 20 20 20 20 31  ound           1
0b40: 30 0a 23 64 65 66 69 6e 65 20 4f 50 5f 44 65 6c  0.#define OP_Del
0b50: 65 74 65 20 20 20 20 20 20 20 20 20 20 20 20 20  ete             
0b60: 31 31 0a 23 64 65 66 69 6e 65 20 4f 50 5f 46 69  11.#define OP_Fi
0b70: 65 6c 64 20 20 20 20 20 20 20 20 20 20 20 20 20  eld             
0b80: 20 31 32 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4b   12.#define OP_K
0b90: 65 79 41 73 44 61 74 61 20 20 20 20 20 20 20 20  eyAsData        
0ba0: 20 20 31 33 0a 23 64 65 66 69 6e 65 20 4f 50 5f    13.#define OP_
0bb0: 4b 65 79 20 20 20 20 20 20 20 20 20 20 20 20 20  Key             
0bc0: 20 20 20 31 34 0a 23 64 65 66 69 6e 65 20 4f 50     14.#define OP
0bd0: 5f 46 75 6c 6c 4b 65 79 20 20 20 20 20 20 20 20  _FullKey        
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 77 69 6e 64 20 20 20 20 20 20 20 20  P_Rewind        
0c00: 20 20 20 20 20 31 36 0a 23 64 65 66 69 6e 65 20       16.#define 
0c10: 4f 50 5f 4e 65 78 74 20 20 20 20 20 20 20 20 20  OP_Next         
0c20: 20 20 20 20 20 20 31 37 0a 0a 23 64 65 66 69 6e        17..#defin
0c30: 65 20 4f 50 5f 44 65 73 74 72 6f 79 20 20 20 20  e OP_Destroy    
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 52 65 6f 72 67 61 6e 69 7a 65  ne OP_Reorganize
0c60: 20 20 20 20 20 20 20 20 20 31 39 0a 0a 23 64 65           19..#de
0c70: 66 69 6e 65 20 4f 50 5f 52 65 73 65 74 49 64 78  fine OP_ResetIdx
0c80: 20 20 20 20 20 20 20 20 20 20 20 32 30 0a 23 64             20.#d
0c90: 65 66 69 6e 65 20 4f 50 5f 4e 65 78 74 49 64 78  efine OP_NextIdx
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 50 75 74 49 64 78  define OP_PutIdx
0cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 32 32 0a               22.
0cd0: 23 64 65 66 69 6e 65 20 4f 50 5f 44 65 6c 65 74  #define OP_Delet
0ce0: 65 49 64 78 20 20 20 20 20 20 20 20 20 20 32 33  eIdx          23
0cf0: 0a 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4d 65 6d  ..#define OP_Mem
0d00: 4c 6f 61 64 20 20 20 20 20 20 20 20 20 20 20 20  Load            
0d10: 32 34 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4d 65  24.#define OP_Me
0d20: 6d 53 74 6f 72 65 20 20 20 20 20 20 20 20 20 20  mStore          
0d30: 20 32 35 0a 0a 23 64 65 66 69 6e 65 20 4f 50 5f   25..#define OP_
0d40: 4c 69 73 74 4f 70 65 6e 20 20 20 20 20 20 20 20  ListOpen        
0d50: 20 20 20 32 36 0a 23 64 65 66 69 6e 65 20 4f 50     26.#define OP
0d60: 5f 4c 69 73 74 57 72 69 74 65 20 20 20 20 20 20  _ListWrite      
0d70: 20 20 20 20 32 37 0a 23 64 65 66 69 6e 65 20 4f      27.#define O
0d80: 50 5f 4c 69 73 74 52 65 77 69 6e 64 20 20 20 20  P_ListRewind    
0d90: 20 20 20 20 20 32 38 0a 23 64 65 66 69 6e 65 20       28.#define 
0da0: 4f 50 5f 4c 69 73 74 52 65 61 64 20 20 20 20 20  OP_ListRead     
0db0: 20 20 20 20 20 20 32 39 0a 23 64 65 66 69 6e 65        29.#define
0dc0: 20 4f 50 5f 4c 69 73 74 43 6c 6f 73 65 20 20 20   OP_ListClose   
0dd0: 20 20 20 20 20 20 20 33 30 0a 0a 23 64 65 66 69         30..#defi
0de0: 6e 65 20 4f 50 5f 53 6f 72 74 4f 70 65 6e 20 20  ne OP_SortOpen  
0df0: 20 20 20 20 20 20 20 20 20 33 31 0a 23 64 65 66           31.#def
0e00: 69 6e 65 20 4f 50 5f 53 6f 72 74 50 75 74 20 20  ine OP_SortPut  
0e10: 20 20 20 20 20 20 20 20 20 20 33 32 0a 23 64 65            32.#de
0e20: 66 69 6e 65 20 4f 50 5f 53 6f 72 74 4d 61 6b 65  fine OP_SortMake
0e30: 52 65 63 20 20 20 20 20 20 20 20 33 33 0a 23 64  Rec        33.#d
0e40: 65 66 69 6e 65 20 4f 50 5f 53 6f 72 74 4d 61 6b  efine OP_SortMak
0e50: 65 4b 65 79 20 20 20 20 20 20 20 20 33 34 0a 23  eKey        34.#
0e60: 64 65 66 69 6e 65 20 4f 50 5f 53 6f 72 74 20 20  define OP_Sort  
0e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 33 35 0a               35.
0e80: 23 64 65 66 69 6e 65 20 4f 50 5f 53 6f 72 74 4e  #define OP_SortN
0e90: 65 78 74 20 20 20 20 20 20 20 20 20 20 20 33 36  ext           36
0ea0: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 6f 72 74  .#define OP_Sort
0eb0: 4b 65 79 20 20 20 20 20 20 20 20 20 20 20 20 33  Key            3
0ec0: 37 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 6f 72  7.#define OP_Sor
0ed0: 74 43 61 6c 6c 62 61 63 6b 20 20 20 20 20 20 20  tCallback       
0ee0: 33 38 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 6f  38.#define OP_So
0ef0: 72 74 43 6c 6f 73 65 20 20 20 20 20 20 20 20 20  rtClose         
0f00: 20 33 39 0a 0a 23 64 65 66 69 6e 65 20 4f 50 5f   39..#define OP_
0f10: 46 69 6c 65 4f 70 65 6e 20 20 20 20 20 20 20 20  FileOpen        
0f20: 20 20 20 34 30 0a 23 64 65 66 69 6e 65 20 4f 50     40.#define OP
0f30: 5f 46 69 6c 65 52 65 61 64 20 20 20 20 20 20 20  _FileRead       
0f40: 20 20 20 20 34 31 0a 23 64 65 66 69 6e 65 20 4f      41.#define O
0f50: 50 5f 46 69 6c 65 46 69 65 6c 64 20 20 20 20 20  P_FileField     
0f60: 20 20 20 20 20 34 32 0a 23 64 65 66 69 6e 65 20       42.#define 
0f70: 4f 50 5f 46 69 6c 65 43 6c 6f 73 65 20 20 20 20  OP_FileClose    
0f80: 20 20 20 20 20 20 34 33 0a 0a 23 64 65 66 69 6e        43..#defin
0f90: 65 20 4f 50 5f 41 67 67 52 65 73 65 74 20 20 20  e OP_AggReset   
0fa0: 20 20 20 20 20 20 20 20 34 34 0a 23 64 65 66 69          44.#defi
0fb0: 6e 65 20 4f 50 5f 41 67 67 46 6f 63 75 73 20 20  ne OP_AggFocus  
0fc0: 20 20 20 20 20 20 20 20 20 34 35 0a 23 64 65 66           45.#def
0fd0: 69 6e 65 20 4f 50 5f 41 67 67 49 6e 63 72 20 20  ine OP_AggIncr  
0fe0: 20 20 20 20 20 20 20 20 20 20 34 36 0a 23 64 65            46.#de
0ff0: 66 69 6e 65 20 4f 50 5f 41 67 67 4e 65 78 74 20  fine OP_AggNext 
1000: 20 20 20 20 20 20 20 20 20 20 20 34 37 0a 23 64             47.#d
1010: 65 66 69 6e 65 20 4f 50 5f 41 67 67 53 65 74 20  efine OP_AggSet 
1020: 20 20 20 20 20 20 20 20 20 20 20 20 34 38 0a 23              48.#
1030: 64 65 66 69 6e 65 20 4f 50 5f 41 67 67 47 65 74  define OP_AggGet
1040: 20 20 20 20 20 20 20 20 20 20 20 20 20 34 39 0a               49.
1050: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 65 74 49  .#define OP_SetI
1060: 6e 73 65 72 74 20 20 20 20 20 20 20 20 20 20 35  nsert          5
1070: 30 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 65 74  0.#define OP_Set
1080: 46 6f 75 6e 64 20 20 20 20 20 20 20 20 20 20 20  Found           
1090: 35 31 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 65  51.#define OP_Se
10a0: 74 4e 6f 74 46 6f 75 6e 64 20 20 20 20 20 20 20  tNotFound       
10b0: 20 35 32 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53   52.#define OP_S
10c0: 65 74 43 6c 65 61 72 20 20 20 20 20 20 20 20 20  etClear         
10d0: 20 20 35 33 0a 0a 23 64 65 66 69 6e 65 20 4f 50    53..#define OP
10e0: 5f 4d 61 6b 65 52 65 63 6f 72 64 20 20 20 20 20  _MakeRecord     
10f0: 20 20 20 20 35 34 0a 23 64 65 66 69 6e 65 20 4f      54.#define O
1100: 50 5f 4d 61 6b 65 4b 65 79 20 20 20 20 20 20 20  P_MakeKey       
1110: 20 20 20 20 20 35 35 0a 0a 23 64 65 66 69 6e 65       55..#define
1120: 20 4f 50 5f 47 6f 74 6f 20 20 20 20 20 20 20 20   OP_Goto        
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 49 66 20 20 20 20 20 20 20 20 20  e OP_If         
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 48 61 6c 74 20 20 20 20 20 20  ne OP_Halt      
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 43 6f 6c 75 6d 6e 43 6f  fine OP_ColumnCo
1190: 75 6e 74 20 20 20 20 20 20 20 20 35 39 0a 23 64  unt        59.#d
11a0: 65 66 69 6e 65 20 4f 50 5f 43 6f 6c 75 6d 6e 4e  efine OP_ColumnN
11b0: 61 6d 65 20 20 20 20 20 20 20 20 20 36 30 0a 23  ame         60.#
11c0: 64 65 66 69 6e 65 20 4f 50 5f 43 61 6c 6c 62 61  define OP_Callba
11d0: 63 6b 20 20 20 20 20 20 20 20 20 20 20 36 31 0a  ck           61.
11e0: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 49 6e 74 65  .#define OP_Inte
11f0: 67 65 72 20 20 20 20 20 20 20 20 20 20 20 20 36  ger            6
1200: 32 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 74 72  2.#define OP_Str
1210: 69 6e 67 20 20 20 20 20 20 20 20 20 20 20 20 20  ing             
1220: 36 33 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4e 75  63.#define OP_Nu
1230: 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ll              
1240: 20 36 34 0a 23 64 65 66 69 6e 65 20 4f 50 5f 50   64.#define OP_P
1250: 6f 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20  op              
1260: 20 20 36 35 0a 23 64 65 66 69 6e 65 20 4f 50 5f    65.#define OP_
1270: 44 75 70 20 20 20 20 20 20 20 20 20 20 20 20 20  Dup             
1280: 20 20 20 36 36 0a 23 64 65 66 69 6e 65 20 4f 50     66.#define OP
1290: 5f 50 75 6c 6c 20 20 20 20 20 20 20 20 20 20 20  _Pull           
12a0: 20 20 20 20 36 37 0a 0a 23 64 65 66 69 6e 65 20      67..#define 
12b0: 4f 50 5f 41 64 64 20 20 20 20 20 20 20 20 20 20  OP_Add          
12c0: 20 20 20 20 20 20 36 38 0a 23 64 65 66 69 6e 65        68.#define
12d0: 20 4f 50 5f 41 64 64 49 6d 6d 20 20 20 20 20 20   OP_AddImm      
12e0: 20 20 20 20 20 20 20 36 39 0a 23 64 65 66 69 6e         69.#defin
12f0: 65 20 4f 50 5f 53 75 62 74 72 61 63 74 20 20 20  e OP_Subtract   
1300: 20 20 20 20 20 20 20 20 37 30 0a 23 64 65 66 69          70.#defi
1310: 6e 65 20 4f 50 5f 4d 75 6c 74 69 70 6c 79 20 20  ne OP_Multiply  
1320: 20 20 20 20 20 20 20 20 20 37 31 0a 23 64 65 66           71.#def
1330: 69 6e 65 20 4f 50 5f 44 69 76 69 64 65 20 20 20  ine OP_Divide   
1340: 20 20 20 20 20 20 20 20 20 20 37 32 0a 23 64 65            72.#de
1350: 66 69 6e 65 20 4f 50 5f 4d 69 6e 20 20 20 20 20  fine OP_Min     
1360: 20 20 20 20 20 20 20 20 20 20 20 37 33 0a 23 64             73.#d
1370: 65 66 69 6e 65 20 4f 50 5f 4d 61 78 20 20 20 20  efine OP_Max    
1380: 20 20 20 20 20 20 20 20 20 20 20 20 37 34 0a 23              74.#
1390: 64 65 66 69 6e 65 20 4f 50 5f 4c 69 6b 65 20 20  define OP_Like  
13a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 37 35 0a               75.
13b0: 23 64 65 66 69 6e 65 20 4f 50 5f 47 6c 6f 62 20  #define OP_Glob 
13c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 37 36                76
13d0: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 45 71 20 20  .#define OP_Eq  
13e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 37                 7
13f0: 37 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4e 65 20  7.#define OP_Ne 
1400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1410: 37 38 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4c 74  78.#define OP_Lt
1420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1430: 20 37 39 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4c   79.#define OP_L
1440: 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e               
1450: 20 20 38 30 0a 23 64 65 66 69 6e 65 20 4f 50 5f    80.#define OP_
1460: 47 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20  Gt              
1470: 20 20 20 38 31 0a 23 64 65 66 69 6e 65 20 4f 50     81.#define OP
1480: 5f 47 65 20 20 20 20 20 20 20 20 20 20 20 20 20  _Ge             
1490: 20 20 20 20 38 32 0a 23 64 65 66 69 6e 65 20 4f      82.#define O
14a0: 50 5f 49 73 4e 75 6c 6c 20 20 20 20 20 20 20 20  P_IsNull        
14b0: 20 20 20 20 20 38 33 0a 23 64 65 66 69 6e 65 20       83.#define 
14c0: 4f 50 5f 4e 6f 74 4e 75 6c 6c 20 20 20 20 20 20  OP_NotNull      
14d0: 20 20 20 20 20 20 38 34 0a 23 64 65 66 69 6e 65        84.#define
14e0: 20 4f 50 5f 4e 65 67 61 74 69 76 65 20 20 20 20   OP_Negative    
14f0: 20 20 20 20 20 20 20 38 35 0a 23 64 65 66 69 6e         85.#defin
1500: 65 20 4f 50 5f 41 6e 64 20 20 20 20 20 20 20 20  e OP_And        
1510: 20 20 20 20 20 20 20 20 38 36 0a 23 64 65 66 69          86.#defi
1520: 6e 65 20 4f 50 5f 4f 72 20 20 20 20 20 20 20 20  ne OP_Or        
1530: 20 20 20 20 20 20 20 20 20 38 37 0a 23 64 65 66           87.#def
1540: 69 6e 65 20 4f 50 5f 4e 6f 74 20 20 20 20 20 20  ine OP_Not      
1550: 20 20 20 20 20 20 20 20 20 20 38 38 0a 23 64 65            88.#de
1560: 66 69 6e 65 20 4f 50 5f 43 6f 6e 63 61 74 20 20  fine OP_Concat  
1570: 20 20 20 20 20 20 20 20 20 20 20 38 39 0a 23 64             89.#d
1580: 65 66 69 6e 65 20 4f 50 5f 4e 6f 6f 70 20 20 20  efine OP_Noop   
1590: 20 20 20 20 20 20 20 20 20 20 20 20 39 30 0a 0a              90..
15a0: 23 64 65 66 69 6e 65 20 4f 50 5f 53 74 72 6c 65  #define OP_Strle
15b0: 6e 20 20 20 20 20 20 20 20 20 20 20 20 20 39 31  n             91
15c0: 0a 23 64 65 66 69 6e 65 20 4f 50 5f 53 75 62 73  .#define OP_Subs
15d0: 74 72 20 20 20 20 20 20 20 20 20 20 20 20 20 39  tr             9
15e0: 32 0a 0a 23 64 65 66 69 6e 65 20 4f 50 5f 4d 41  2..#define OP_MA
15f0: 58 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  X               
1600: 20 39 33 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 74 6f   93../*.** Proto
1610: 74 79 70 65 73 20 66 6f 72 20 74 68 65 20 56 44  types for the VD
1620: 42 45 20 69 6e 74 65 72 66 61 63 65 2e 20 20 53  BE interface.  S
1630: 65 65 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 74  ee comments on t
1640: 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  he implementatio
1650: 6e 0a 2a 2a 20 66 6f 72 20 61 20 64 65 73 63 72  n.** for a descr
1660: 69 70 74 69 6f 6e 20 6f 66 20 77 68 61 74 20 65  iption of what e
1670: 61 63 68 20 6f 66 20 74 68 65 73 65 20 72 6f 75  ach of these rou
1680: 74 69 6e 65 73 20 64 6f 65 73 2e 0a 2a 2f 0a 56  tines does..*/.V
1690: 64 62 65 20 2a 73 71 6c 69 74 65 56 64 62 65 43  dbe *sqliteVdbeC
16a0: 72 65 61 74 65 28 73 71 6c 69 74 65 2a 29 3b 0a  reate(sqlite*);.
16b0: 69 6e 74 20 73 71 6c 69 74 65 56 64 62 65 41 64  int sqliteVdbeAd
16c0: 64 4f 70 28 56 64 62 65 2a 2c 69 6e 74 2c 69 6e  dOp(Vdbe*,int,in
16d0: 74 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72  t,int,const char
16e0: 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69  *,int);.int sqli
16f0: 74 65 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28  teVdbeAddOpList(
1700: 56 64 62 65 2a 2c 20 69 6e 74 20 6e 4f 70 2c 20  Vdbe*, int nOp, 
1710: 56 64 62 65 4f 70 20 63 6f 6e 73 74 20 2a 61 4f  VdbeOp const *aO
1720: 70 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 56  p);.void sqliteV
1730: 64 62 65 43 68 61 6e 67 65 50 33 28 56 64 62 65  dbeChangeP3(Vdbe
1740: 2a 2c 20 69 6e 74 20 61 64 64 72 2c 20 63 6f 6e  *, int addr, con
1750: 73 74 20 63 68 61 72 20 2a 7a 50 31 2c 20 69 6e  st char *zP1, in
1760: 74 20 4e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74  t N);.void sqlit
1770: 65 56 64 62 65 44 65 71 75 6f 74 65 50 33 28 56  eVdbeDequoteP3(V
1780: 64 62 65 2a 2c 20 69 6e 74 20 61 64 64 72 29 3b  dbe*, int addr);
1790: 0a 69 6e 74 20 73 71 6c 69 74 65 56 64 62 65 4d  .int sqliteVdbeM
17a0: 61 6b 65 4c 61 62 65 6c 28 56 64 62 65 2a 29 3b  akeLabel(Vdbe*);
17b0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 56 64 62 65  .void sqliteVdbe
17c0: 44 65 6c 65 74 65 28 56 64 62 65 2a 29 3b 0a 69  Delete(Vdbe*);.i
17d0: 6e 74 20 73 71 6c 69 74 65 56 64 62 65 4f 70 63  nt sqliteVdbeOpc
17e0: 6f 64 65 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  ode(const char *
17f0: 7a 4e 61 6d 65 29 3b 0a 69 6e 74 20 73 71 6c 69  zName);.int sqli
1800: 74 65 56 64 62 65 45 78 65 63 28 56 64 62 65 2a  teVdbeExec(Vdbe*
1810: 2c 73 71 6c 69 74 65 5f 63 61 6c 6c 62 61 63 6b  ,sqlite_callback
1820: 2c 76 6f 69 64 2a 2c 63 68 61 72 2a 2a 2c 76 6f  ,void*,char**,vo
1830: 69 64 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20  id*,.           
1840: 20 20 20 20 20 20 20 20 69 6e 74 28 2a 29 28 76          int(*)(v
1850: 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a  oid*,const char*
1860: 2c 69 6e 74 29 29 3b 0a 69 6e 74 20 73 71 6c 69  ,int));.int sqli
1870: 74 65 56 64 62 65 4c 69 73 74 28 56 64 62 65 2a  teVdbeList(Vdbe*
1880: 2c 73 71 6c 69 74 65 5f 63 61 6c 6c 62 61 63 6b  ,sqlite_callback
1890: 2c 76 6f 69 64 2a 2c 63 68 61 72 2a 2a 29 3b 0a  ,void*,char**);.
18a0: 76 6f 69 64 20 73 71 6c 69 74 65 56 64 62 65 52  void sqliteVdbeR
18b0: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62 65  esolveLabel(Vdbe
18c0: 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c  *, int);.int sql
18d0: 69 74 65 56 64 62 65 43 75 72 72 65 6e 74 41 64  iteVdbeCurrentAd
18e0: 64 72 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20  dr(Vdbe*);.void 
18f0: 73 71 6c 69 74 65 56 64 62 65 54 72 61 63 65 28  sqliteVdbeTrace(
1900: 56 64 62 65 2a 2c 46 49 4c 45 2a 29 3b 0a 76 6f  Vdbe*,FILE*);.vo
1910: 69 64 20 73 71 6c 69 74 65 56 64 62 65 43 6f 6d  id sqliteVdbeCom
1920: 70 72 65 73 73 53 70 61 63 65 28 56 64 62 65 2a  pressSpace(Vdbe*
1930: 2c 69 6e 74 29 3b 0a 0a 23 65 6e 64 69 66 0a     ,int);..#endif.