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

Artifact d6f66896137af3e313d44553618228d882a2cf85:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you 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 2a 0a 2a 2a 20 48 65 61 64 65 72  ******.** Header
0180: 20 66 69 6c 65 20 66 6f 72 20 74 68 65 20 56 69   file for the Vi
0190: 72 74 75 61 6c 20 44 61 74 61 42 61 73 65 20 45  rtual DataBase E
01a0: 6e 67 69 6e 65 20 28 56 44 42 45 29 0a 2a 2a 0a  ngine (VDBE).**.
01b0: 2a 2a 20 54 68 69 73 20 68 65 61 64 65 72 20 64  ** This header d
01c0: 65 66 69 6e 65 73 20 74 68 65 20 69 6e 74 65 72  efines the inter
01d0: 66 61 63 65 20 74 6f 20 74 68 65 20 76 69 72 74  face to the virt
01e0: 75 61 6c 20 64 61 74 61 62 61 73 65 20 65 6e 67  ual database eng
01f0: 69 6e 65 0a 2a 2a 20 6f 72 20 56 44 42 45 2e 20  ine.** or VDBE. 
0200: 20 54 68 65 20 56 44 42 45 20 69 6d 70 6c 65 6d   The VDBE implem
0210: 65 6e 74 73 20 61 6e 20 61 62 73 74 72 61 63 74  ents an abstract
0220: 20 6d 61 63 68 69 6e 65 20 74 68 61 74 20 72 75   machine that ru
0230: 6e 73 20 61 0a 2a 2a 20 73 69 6d 70 6c 65 20 70  ns a.** simple p
0240: 72 6f 67 72 61 6d 20 74 6f 20 61 63 63 65 73 73  rogram to access
0250: 20 61 6e 64 20 6d 6f 64 69 66 79 20 74 68 65 20   and modify the 
0260: 75 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 61 62  underlying datab
0270: 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 24 49 64 3a 20  ase..**.** $Id: 
0280: 76 64 62 65 2e 68 2c 76 20 31 2e 38 30 20 32 30  vdbe.h,v 1.80 20
0290: 30 34 2f 30 35 2f 32 31 20 30 31 3a 32 39 3a 30  04/05/21 01:29:0
02a0: 36 20 64 72 68 20 45 78 70 20 24 0a 2a 2f 0a 23  6 drh Exp $.*/.#
02b0: 69 66 6e 64 65 66 20 5f 53 51 4c 49 54 45 5f 56  ifndef _SQLITE_V
02c0: 44 42 45 5f 48 5f 0a 23 64 65 66 69 6e 65 20 5f  DBE_H_.#define _
02d0: 53 51 4c 49 54 45 5f 56 44 42 45 5f 48 5f 0a 23  SQLITE_VDBE_H_.#
02e0: 69 6e 63 6c 75 64 65 20 3c 73 74 64 69 6f 2e 68  include <stdio.h
02f0: 3e 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 69 6e 67 6c  >../*.** A singl
0300: 65 20 56 44 42 45 20 69 73 20 61 6e 20 6f 70 61  e VDBE is an opa
0310: 71 75 65 20 73 74 72 75 63 74 75 72 65 20 6e 61  que structure na
0320: 6d 65 64 20 22 56 64 62 65 22 2e 20 20 4f 6e 6c  med "Vdbe".  Onl
0330: 79 20 72 6f 75 74 69 6e 65 73 0a 2a 2a 20 69 6e  y routines.** in
0340: 20 74 68 65 20 73 6f 75 72 63 65 20 66 69 6c 65   the source file
0350: 20 73 71 6c 69 74 65 56 64 62 65 2e 63 20 61 72   sqliteVdbe.c ar
0360: 65 20 61 6c 6c 6f 77 65 64 20 74 6f 20 73 65 65  e allowed to see
0370: 20 74 68 65 20 69 6e 73 69 64 65 73 0a 2a 2a 20   the insides.** 
0380: 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72  of this structur
0390: 65 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74  e..*/.typedef st
03a0: 72 75 63 74 20 56 64 62 65 20 56 64 62 65 3b 0a  ruct Vdbe Vdbe;.
03b0: 0a 2f 2a 0a 2a 2a 20 41 20 73 69 6e 67 6c 65 20  ./*.** A single 
03c0: 69 6e 73 74 72 75 63 74 69 6f 6e 20 6f 66 20 74  instruction of t
03d0: 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  he virtual machi
03e0: 6e 65 20 68 61 73 20 61 6e 20 6f 70 63 6f 64 65  ne has an opcode
03f0: 0a 2a 2a 20 61 6e 64 20 61 73 20 6d 61 6e 79 20  .** and as many 
0400: 61 73 20 74 68 72 65 65 20 6f 70 65 72 61 6e 64  as three operand
0410: 73 2e 20 20 54 68 65 20 69 6e 73 74 72 75 63 74  s.  The instruct
0420: 69 6f 6e 20 69 73 20 72 65 63 6f 72 64 65 64 0a  ion is recorded.
0430: 2a 2a 20 61 73 20 61 6e 20 69 6e 73 74 61 6e 63  ** as an instanc
0440: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  e of the followi
0450: 6e 67 20 73 74 72 75 63 74 75 72 65 3a 0a 2a 2f  ng structure:.*/
0460: 0a 73 74 72 75 63 74 20 56 64 62 65 4f 70 20 7b  .struct VdbeOp {
0470: 0a 20 20 75 38 20 6f 70 63 6f 64 65 3b 20 20 20  .  u8 opcode;   
0480: 20 20 20 20 20 20 20 2f 2a 20 57 68 61 74 20 6f         /* What o
0490: 70 65 72 61 74 69 6f 6e 20 74 6f 20 70 65 72 66  peration to perf
04a0: 6f 72 6d 20 2a 2f 0a 20 20 69 6e 74 20 70 31 3b  orm */.  int p1;
04b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
04c0: 46 69 72 73 74 20 6f 70 65 72 61 6e 64 20 2a 2f  First operand */
04d0: 0a 20 20 69 6e 74 20 70 32 3b 20 20 20 20 20 20  .  int p2;      
04e0: 20 20 20 20 20 20 20 2f 2a 20 53 65 63 6f 6e 64         /* Second
04f0: 20 70 61 72 61 6d 65 74 65 72 20 28 6f 66 74 65   parameter (ofte
0500: 6e 20 74 68 65 20 6a 75 6d 70 20 64 65 73 74 69  n the jump desti
0510: 6e 61 74 69 6f 6e 29 20 2a 2f 0a 20 20 63 68 61  nation) */.  cha
0520: 72 20 2a 70 33 3b 20 20 20 20 20 20 20 20 20 20  r *p3;          
0530: 20 2f 2a 20 54 68 69 72 64 20 70 61 72 61 6d 65   /* Third parame
0540: 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 70 33 74  ter */.  int p3t
0550: 79 70 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20  ype;         /* 
0560: 50 33 5f 53 54 41 54 49 43 2c 20 50 33 5f 44 59  P3_STATIC, P3_DY
0570: 4e 41 4d 49 43 20 6f 72 20 50 33 5f 50 4f 49 4e  NAMIC or P3_POIN
0580: 54 45 52 20 2a 2f 0a 23 69 66 6e 64 65 66 20 4e  TER */.#ifndef N
0590: 44 45 42 55 47 0a 20 20 63 68 61 72 20 2a 7a 43  DEBUG.  char *zC
05a0: 6f 6d 6d 65 6e 74 3b 20 20 20 20 20 2f 2a 20 43  omment;     /* C
05b0: 6f 6d 6d 65 6e 74 73 20 65 78 70 6c 61 69 6e 69  omments explaini
05c0: 6e 67 20 77 68 61 74 20 74 68 69 73 20 6f 70 63  ng what this opc
05d0: 6f 64 65 20 64 6f 65 73 20 2a 2f 0a 23 65 6e 64  ode does */.#end
05e0: 69 66 0a 23 69 66 64 65 66 20 56 44 42 45 5f 50  if.#ifdef VDBE_P
05f0: 52 4f 46 49 4c 45 0a 20 20 69 6e 74 20 63 6e 74  ROFILE.  int cnt
0600: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ;            /* 
0610: 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 20  Number of times 
0620: 74 68 69 73 20 69 6e 73 74 72 75 63 74 69 6f 6e  this instruction
0630: 20 77 61 73 20 65 78 65 63 75 74 65 64 20 2a 2f   was executed */
0640: 0a 20 20 6c 6f 6e 67 20 6c 6f 6e 67 20 63 79 63  .  long long cyc
0650: 6c 65 73 3b 20 20 20 2f 2a 20 54 6f 74 61 6c 20  les;   /* Total 
0660: 74 69 6d 65 20 73 70 65 6e 64 20 65 78 65 63 75  time spend execu
0670: 74 69 6e 67 20 74 68 69 73 20 69 6e 73 74 72 75  ting this instru
0680: 63 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a  ction */.#endif.
0690: 7d 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  };.typedef struc
06a0: 74 20 56 64 62 65 4f 70 20 56 64 62 65 4f 70 3b  t VdbeOp VdbeOp;
06b0: 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 6d 61 6c 6c 65  ../*.** A smalle
06c0: 72 20 76 65 72 73 69 6f 6e 20 6f 66 20 56 64 62  r version of Vdb
06d0: 65 4f 70 20 75 73 65 64 20 66 6f 72 20 74 68 65  eOp used for the
06e0: 20 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28 29   VdbeAddOpList()
06f0: 20 66 75 6e 63 74 69 6f 6e 20 62 65 63 61 75 73   function becaus
0700: 65 0a 2a 2a 20 69 74 20 74 61 6b 65 73 20 75 70  e.** it takes up
0710: 20 6c 65 73 73 20 73 70 61 63 65 2e 0a 2a 2f 0a   less space..*/.
0720: 73 74 72 75 63 74 20 56 64 62 65 4f 70 4c 69 73  struct VdbeOpLis
0730: 74 20 7b 0a 20 20 75 38 20 6f 70 63 6f 64 65 3b  t {.  u8 opcode;
0740: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68 61            /* Wha
0750: 74 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 70  t operation to p
0760: 65 72 66 6f 72 6d 20 2a 2f 0a 20 20 73 69 67 6e  erform */.  sign
0770: 65 64 20 63 68 61 72 20 70 31 3b 20 20 20 20 20  ed char p1;     
0780: 2f 2a 20 46 69 72 73 74 20 6f 70 65 72 61 6e 64  /* First operand
0790: 20 2a 2f 0a 20 20 73 68 6f 72 74 20 69 6e 74 20   */.  short int 
07a0: 70 32 3b 20 20 20 20 20 20 20 2f 2a 20 53 65 63  p2;       /* Sec
07b0: 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 28 6f  ond parameter (o
07c0: 66 74 65 6e 20 74 68 65 20 6a 75 6d 70 20 64 65  ften the jump de
07d0: 73 74 69 6e 61 74 69 6f 6e 29 20 2a 2f 0a 20 20  stination) */.  
07e0: 63 68 61 72 20 2a 70 33 3b 20 20 20 20 20 20 20  char *p3;       
07f0: 20 20 20 20 2f 2a 20 54 68 69 72 64 20 70 61 72      /* Third par
0800: 61 6d 65 74 65 72 20 2a 2f 0a 7d 3b 0a 74 79 70  ameter */.};.typ
0810: 65 64 65 66 20 73 74 72 75 63 74 20 56 64 62 65  edef struct Vdbe
0820: 4f 70 4c 69 73 74 20 56 64 62 65 4f 70 4c 69 73  OpList VdbeOpLis
0830: 74 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65  t;../*.** Allowe
0840: 64 20 76 61 6c 75 65 73 20 6f 66 20 56 64 62 65  d values of Vdbe
0850: 4f 70 2e 70 33 74 79 70 65 0a 2a 2f 0a 23 64 65  Op.p3type.*/.#de
0860: 66 69 6e 65 20 50 33 5f 4e 4f 54 55 53 45 44 20  fine P3_NOTUSED 
0870: 20 20 20 30 20 20 20 2f 2a 20 54 68 65 20 50 33     0   /* The P3
0880: 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f   parameter is no
0890: 74 20 75 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e  t used */.#defin
08a0: 65 20 50 33 5f 44 59 4e 41 4d 49 43 20 20 28 2d  e P3_DYNAMIC  (-
08b0: 31 29 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74  1)  /* Pointer t
08c0: 6f 20 61 20 73 74 72 69 6e 67 20 6f 62 74 61 69  o a string obtai
08d0: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  ned from sqliteM
08e0: 61 6c 6c 6f 63 28 29 20 2a 2f 0a 23 64 65 66 69  alloc() */.#defi
08f0: 6e 65 20 50 33 5f 53 54 41 54 49 43 20 20 20 28  ne P3_STATIC   (
0900: 2d 32 29 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20  -2)  /* Pointer 
0910: 74 6f 20 61 20 73 74 61 74 69 63 20 73 74 72 69  to a static stri
0920: 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 33  ng */.#define P3
0930: 5f 50 4f 49 4e 54 45 52 20 20 28 2d 33 29 20 20  _POINTER  (-3)  
0940: 2f 2a 20 50 33 20 69 73 20 61 20 70 6f 69 6e 74  /* P3 is a point
0950: 65 72 20 74 6f 20 73 6f 6d 65 20 73 74 72 75 63  er to some struc
0960: 74 75 72 65 20 6f 72 20 6f 62 6a 65 63 74 20 2a  ture or object *
0970: 2f 0a 23 64 65 66 69 6e 65 20 50 33 5f 43 4f 4c  /.#define P3_COL
0980: 4c 53 45 51 20 20 28 2d 34 29 20 20 2f 2a 20 50  LSEQ  (-4)  /* P
0990: 33 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74  3 is a pointer t
09a0: 6f 20 61 20 43 6f 6c 6c 53 65 71 20 73 74 72 75  o a CollSeq stru
09b0: 63 74 75 72 65 20 2a 2f 0a 23 64 65 66 69 6e 65  cture */.#define
09c0: 20 50 33 5f 4b 45 59 49 4e 46 4f 20 20 28 2d 35   P3_KEYINFO  (-5
09d0: 29 20 20 2f 2a 20 50 33 20 69 73 20 61 20 70 6f  )  /* P3 is a po
09e0: 69 6e 74 65 72 20 74 6f 20 61 20 4b 65 79 49 6e  inter to a KeyIn
09f0: 66 6f 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a  fo structure */.
0a00: 0a 2f 2a 20 57 68 65 6e 20 61 64 64 69 6e 67 20  ./* When adding 
0a10: 61 20 50 33 20 61 72 67 75 6d 65 6e 74 20 75 73  a P3 argument us
0a20: 69 6e 67 20 50 33 5f 4b 45 59 49 4e 46 4f 2c 20  ing P3_KEYINFO, 
0a30: 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 4b 65  a copy of the Ke
0a40: 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 0a  yInfo structure.
0a50: 2a 2a 20 69 73 20 6d 61 64 65 2e 20 20 54 68 61  ** is made.  Tha
0a60: 74 20 63 6f 70 79 20 69 73 20 66 72 65 65 64 20  t copy is freed 
0a70: 77 68 65 6e 20 74 68 65 20 56 64 62 65 20 69 73  when the Vdbe is
0a80: 20 66 69 6e 61 6c 69 7a 65 64 2e 20 20 42 75 74   finalized.  But
0a90: 20 69 66 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d   if the.** argum
0aa0: 65 6e 74 20 69 73 20 50 33 5f 4b 45 59 49 4e 46  ent is P3_KEYINF
0ab0: 4f 5f 48 41 4e 44 4f 46 46 2c 20 74 68 65 20 70  O_HANDOFF, the p
0ac0: 61 73 73 65 64 20 69 6e 20 70 6f 69 6e 74 65 72  assed in pointer
0ad0: 20 69 73 20 75 73 65 64 2e 20 20 49 74 20 73 74   is used.  It st
0ae0: 69 6c 6c 0a 2a 2a 20 67 65 74 73 20 66 72 65 65  ill.** gets free
0af0: 64 20 77 68 65 6e 20 74 68 65 20 56 64 62 65 20  d when the Vdbe 
0b00: 69 73 20 66 69 6e 61 6c 69 7a 65 64 20 73 6f 20  is finalized so 
0b10: 69 74 20 73 74 69 6c 6c 20 73 68 6f 75 6c 64 20  it still should 
0b20: 62 65 20 6f 62 74 61 69 6e 65 64 0a 2a 2a 20 66  be obtained.** f
0b30: 72 6f 6d 20 61 20 73 69 6e 67 6c 65 20 73 71 6c  rom a single sql
0b40: 69 74 65 4d 61 6c 6c 6f 63 28 29 2e 20 20 42 75  iteMalloc().  Bu
0b50: 74 20 6e 6f 20 63 6f 70 79 20 69 73 20 6d 61 64  t no copy is mad
0b60: 65 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 69 6e  e and the callin
0b70: 67 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 73 68  g.** function sh
0b80: 6f 75 6c 64 20 2a 6e 6f 74 2a 20 74 72 79 20 74  ould *not* try t
0b90: 6f 20 66 72 65 65 20 74 68 65 20 4b 65 79 49 6e  o free the KeyIn
0ba0: 66 6f 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 50  fo..*/.#define P
0bb0: 33 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46  3_KEYINFO_HANDOF
0bc0: 46 20 28 2d 36 29 0a 0a 2f 2a 0a 2a 2a 20 54 68  F (-6)../*.** Th
0bd0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72  e following macr
0be0: 6f 20 63 6f 6e 76 65 72 74 73 20 61 20 72 65 6c  o converts a rel
0bf0: 61 74 69 76 65 20 61 64 64 72 65 73 73 20 69 6e  ative address in
0c00: 20 74 68 65 20 70 32 20 66 69 65 6c 64 0a 2a 2a   the p2 field.**
0c10: 20 6f 66 20 61 20 56 64 62 65 4f 70 20 73 74 72   of a VdbeOp str
0c20: 75 63 74 75 72 65 20 69 6e 74 6f 20 61 20 6e 65  ucture into a ne
0c30: 67 61 74 69 76 65 20 6e 75 6d 62 65 72 20 73 6f  gative number so
0c40: 20 74 68 61 74 20 0a 2a 2a 20 73 71 6c 69 74 65   that .** sqlite
0c50: 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28 29  3VdbeAddOpList()
0c60: 20 6b 6e 6f 77 73 20 74 68 61 74 20 74 68 65 20   knows that the 
0c70: 61 64 64 72 65 73 73 20 69 73 20 72 65 6c 61 74  address is relat
0c80: 69 76 65 2e 20 20 43 61 6c 6c 69 6e 67 0a 2a 2a  ive.  Calling.**
0c90: 20 74 68 65 20 6d 61 63 72 6f 20 61 67 61 69 6e   the macro again
0ca0: 20 72 65 73 74 6f 72 65 73 20 74 68 65 20 61 64   restores the ad
0cb0: 64 72 65 73 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e  dress..*/.#defin
0cc0: 65 20 41 44 44 52 28 58 29 20 20 28 2d 31 2d 28  e ADDR(X)  (-1-(
0cd0: 58 29 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6d  X))../*.** The m
0ce0: 61 6b 65 66 69 6c 65 20 73 63 61 6e 73 20 74 68  akefile scans th
0cf0: 65 20 76 64 62 65 2e 63 20 73 6f 75 72 63 65 20  e vdbe.c source 
0d00: 66 69 6c 65 20 61 6e 64 20 63 72 65 61 74 65 73  file and creates
0d10: 20 74 68 65 20 22 6f 70 63 6f 64 65 73 2e 68 22   the "opcodes.h"
0d20: 0a 2a 2a 20 68 65 61 64 65 72 20 66 69 6c 65 20  .** header file 
0d30: 74 68 61 74 20 64 65 66 69 6e 65 73 20 61 20 6e  that defines a n
0d40: 75 6d 62 65 72 20 66 6f 72 20 65 61 63 68 20 6f  umber for each o
0d50: 70 63 6f 64 65 20 75 73 65 64 20 62 79 20 74 68  pcode used by th
0d60: 65 20 56 44 42 45 2e 0a 2a 2f 0a 23 69 6e 63 6c  e VDBE..*/.#incl
0d70: 75 64 65 20 22 6f 70 63 6f 64 65 73 2e 68 22 0a  ude "opcodes.h".
0d80: 0a 2f 2a 0a 2a 2a 20 50 72 6f 74 6f 74 79 70 65  ./*.** Prototype
0d90: 73 20 66 6f 72 20 74 68 65 20 56 44 42 45 20 69  s for the VDBE i
0da0: 6e 74 65 72 66 61 63 65 2e 20 20 53 65 65 20 63  nterface.  See c
0db0: 6f 6d 6d 65 6e 74 73 20 6f 6e 20 74 68 65 20 69  omments on the i
0dc0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 0a 2a 2a  mplementation.**
0dd0: 20 66 6f 72 20 61 20 64 65 73 63 72 69 70 74 69   for a descripti
0de0: 6f 6e 20 6f 66 20 77 68 61 74 20 65 61 63 68 20  on of what each 
0df0: 6f 66 20 74 68 65 73 65 20 72 6f 75 74 69 6e 65  of these routine
0e00: 73 20 64 6f 65 73 2e 0a 2a 2f 0a 56 64 62 65 20  s does..*/.Vdbe 
0e10: 2a 73 71 6c 69 74 65 33 56 64 62 65 43 72 65 61  *sqlite3VdbeCrea
0e20: 74 65 28 73 71 6c 69 74 65 2a 29 3b 0a 76 6f 69  te(sqlite*);.voi
0e30: 64 20 73 71 6c 69 74 65 33 56 64 62 65 43 72 65  d sqlite3VdbeCre
0e40: 61 74 65 43 61 6c 6c 62 61 63 6b 28 56 64 62 65  ateCallback(Vdbe
0e50: 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71  *, int*);.int sq
0e60: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 56  lite3VdbeAddOp(V
0e70: 64 62 65 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74  dbe*,int,int,int
0e80: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  );.int sqlite3Vd
0e90: 62 65 4f 70 33 28 56 64 62 65 2a 2c 69 6e 74 2c  beOp3(Vdbe*,int,
0ea0: 69 6e 74 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68  int,int,const ch
0eb0: 61 72 20 2a 7a 50 33 2c 69 6e 74 29 3b 0a 69 6e  ar *zP3,int);.in
0ec0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 43 6f 64  t sqlite3VdbeCod
0ed0: 65 28 56 64 62 65 2a 2c 2e 2e 2e 29 3b 0a 69 6e  e(Vdbe*,...);.in
0ee0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64  t sqlite3VdbeAdd
0ef0: 4f 70 4c 69 73 74 28 56 64 62 65 2a 2c 20 69 6e  OpList(Vdbe*, in
0f00: 74 20 6e 4f 70 2c 20 56 64 62 65 4f 70 4c 69 73  t nOp, VdbeOpLis
0f10: 74 20 63 6f 6e 73 74 20 2a 61 4f 70 29 3b 0a 76  t const *aOp);.v
0f20: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 43  oid sqlite3VdbeC
0f30: 68 61 6e 67 65 50 31 28 56 64 62 65 2a 2c 20 69  hangeP1(Vdbe*, i
0f40: 6e 74 20 61 64 64 72 2c 20 69 6e 74 20 50 31 29  nt addr, int P1)
0f50: 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  ;.void sqlite3Vd
0f60: 62 65 43 68 61 6e 67 65 50 32 28 56 64 62 65 2a  beChangeP2(Vdbe*
0f70: 2c 20 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20  , int addr, int 
0f80: 50 32 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65  P2);.void sqlite
0f90: 33 56 64 62 65 43 68 61 6e 67 65 50 33 28 56 64  3VdbeChangeP3(Vd
0fa0: 62 65 2a 2c 20 69 6e 74 20 61 64 64 72 2c 20 63  be*, int addr, c
0fb0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 31 2c 20  onst char *zP1, 
0fc0: 69 6e 74 20 4e 29 3b 0a 76 6f 69 64 20 73 71 6c  int N);.void sql
0fd0: 69 74 65 33 56 64 62 65 44 65 71 75 6f 74 65 50  ite3VdbeDequoteP
0fe0: 33 28 56 64 62 65 2a 2c 20 69 6e 74 20 61 64 64  3(Vdbe*, int add
0ff0: 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  r);.int sqlite3V
1000: 64 62 65 46 69 6e 64 4f 70 28 56 64 62 65 2a 2c  dbeFindOp(Vdbe*,
1010: 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b   int, int, int);
1020: 0a 56 64 62 65 4f 70 20 2a 73 71 6c 69 74 65 33  .VdbeOp *sqlite3
1030: 56 64 62 65 47 65 74 4f 70 28 56 64 62 65 2a 2c  VdbeGetOp(Vdbe*,
1040: 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74   int);.int sqlit
1050: 65 33 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28  e3VdbeMakeLabel(
1060: 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c  Vdbe*);.void sql
1070: 69 74 65 33 56 64 62 65 44 65 6c 65 74 65 28 56  ite3VdbeDelete(V
1080: 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69  dbe*);.void sqli
1090: 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61 64 79  te3VdbeMakeReady
10a0: 28 56 64 62 65 2a 2c 69 6e 74 2c 69 6e 74 29 3b  (Vdbe*,int,int);
10b0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
10c0: 45 78 65 63 28 56 64 62 65 2a 29 3b 0a 69 6e 74  Exec(Vdbe*);.int
10d0: 20 73 71 6c 69 74 65 33 56 64 62 65 4c 69 73 74   sqlite3VdbeList
10e0: 28 56 64 62 65 2a 29 3b 0a 69 6e 74 20 73 71 6c  (Vdbe*);.int sql
10f0: 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65  ite3VdbeFinalize
1100: 28 56 64 62 65 2a 2c 63 68 61 72 2a 2a 29 3b 0a  (Vdbe*,char**);.
1110: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
1120: 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62  ResolveLabel(Vdb
1130: 65 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71  e*, int);.int sq
1140: 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74  lite3VdbeCurrent
1150: 41 64 64 72 28 56 64 62 65 2a 29 3b 0a 76 6f 69  Addr(Vdbe*);.voi
1160: 64 20 73 71 6c 69 74 65 33 56 64 62 65 54 72 61  d sqlite3VdbeTra
1170: 63 65 28 56 64 62 65 2a 2c 46 49 4c 45 2a 29 3b  ce(Vdbe*,FILE*);
1180: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
1190: 65 43 6f 6d 70 72 65 73 73 53 70 61 63 65 28 56  eCompressSpace(V
11a0: 64 62 65 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73  dbe*,int);.int s
11b0: 71 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28  qlite3VdbeReset(
11c0: 56 64 62 65 2a 2c 63 68 61 72 20 2a 2a 29 3b 0a  Vdbe*,char **);.
11d0: 69 6e 74 20 73 71 6c 69 74 65 56 64 62 65 53 65  int sqliteVdbeSe
11e0: 74 56 61 72 69 61 62 6c 65 73 28 56 64 62 65 2a  tVariables(Vdbe*
11f0: 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a  ,int,const char*
1200: 2a 29 3b 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45  *);..#ifndef NDE
1210: 42 55 47 0a 20 20 76 6f 69 64 20 73 71 6c 69 74  BUG.  void sqlit
1220: 65 33 56 64 62 65 43 6f 6d 6d 65 6e 74 28 56 64  e3VdbeComment(Vd
1230: 62 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a  be*, const char*
1240: 2c 20 2e 2e 2e 29 3b 0a 23 20 64 65 66 69 6e 65  , ...);.# define
1250: 20 56 64 62 65 43 6f 6d 6d 65 6e 74 28 58 29 20   VdbeComment(X) 
1260: 20 73 71 6c 69 74 65 33 56 64 62 65 43 6f 6d 6d   sqlite3VdbeComm
1270: 65 6e 74 20 58 0a 23 65 6c 73 65 0a 23 20 64 65  ent X.#else.# de
1280: 66 69 6e 65 20 56 64 62 65 43 6f 6d 6d 65 6e 74  fine VdbeComment
1290: 28 58 29 0a 23 65 6e 64 69 66 0a 0a 23 65 6e 64  (X).#endif..#end
12a0: 69 66 0a                                         if.