/ Hex Artifact Content
Login

Artifact b52887278cb173e66188da84dfab216bea61119d:


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 2f 0a 23 69 66 6e 64 65 66 20  ase..*/.#ifndef 
0280: 5f 53 51 4c 49 54 45 5f 56 44 42 45 5f 48 5f 0a  _SQLITE_VDBE_H_.
0290: 23 64 65 66 69 6e 65 20 5f 53 51 4c 49 54 45 5f  #define _SQLITE_
02a0: 56 44 42 45 5f 48 5f 0a 23 69 6e 63 6c 75 64 65  VDBE_H_.#include
02b0: 20 3c 73 74 64 69 6f 2e 68 3e 0a 0a 2f 2a 0a 2a   <stdio.h>../*.*
02c0: 2a 20 41 20 73 69 6e 67 6c 65 20 56 44 42 45 20  * A single VDBE 
02d0: 69 73 20 61 6e 20 6f 70 61 71 75 65 20 73 74 72  is an opaque str
02e0: 75 63 74 75 72 65 20 6e 61 6d 65 64 20 22 56 64  ucture named "Vd
02f0: 62 65 22 2e 20 20 4f 6e 6c 79 20 72 6f 75 74 69  be".  Only routi
0300: 6e 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 73 6f  nes.** in the so
0310: 75 72 63 65 20 66 69 6c 65 20 73 71 6c 69 74 65  urce file sqlite
0320: 56 64 62 65 2e 63 20 61 72 65 20 61 6c 6c 6f 77  Vdbe.c are allow
0330: 65 64 20 74 6f 20 73 65 65 20 74 68 65 20 69 6e  ed to see the in
0340: 73 69 64 65 73 0a 2a 2a 20 6f 66 20 74 68 69 73  sides.** of this
0350: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 74   structure..*/.t
0360: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 56 64  ypedef struct Vd
0370: 62 65 20 56 64 62 65 3b 0a 0a 2f 2a 0a 2a 2a 20  be Vdbe;../*.** 
0380: 54 68 65 20 6e 61 6d 65 73 20 6f 66 20 74 68 65  The names of the
0390: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 79 70 65 73   following types
03a0: 20 64 65 63 6c 61 72 65 64 20 69 6e 20 76 64 62   declared in vdb
03b0: 65 49 6e 74 2e 68 20 61 72 65 20 72 65 71 75 69  eInt.h are requi
03c0: 72 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 20 56  red.** for the V
03d0: 64 62 65 4f 70 20 64 65 66 69 6e 69 74 69 6f 6e  dbeOp definition
03e0: 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72  ..*/.typedef str
03f0: 75 63 74 20 56 64 62 65 46 75 6e 63 20 56 64 62  uct VdbeFunc Vdb
0400: 65 46 75 6e 63 3b 0a 74 79 70 65 64 65 66 20 73  eFunc;.typedef s
0410: 74 72 75 63 74 20 4d 65 6d 20 4d 65 6d 3b 0a 74  truct Mem Mem;.t
0420: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 75  ypedef struct Su
0430: 62 50 72 6f 67 72 61 6d 20 53 75 62 50 72 6f 67  bProgram SubProg
0440: 72 61 6d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 69  ram;../*.** A si
0450: 6e 67 6c 65 20 69 6e 73 74 72 75 63 74 69 6f 6e  ngle instruction
0460: 20 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20   of the virtual 
0470: 6d 61 63 68 69 6e 65 20 68 61 73 20 61 6e 20 6f  machine has an o
0480: 70 63 6f 64 65 0a 2a 2a 20 61 6e 64 20 61 73 20  pcode.** and as 
0490: 6d 61 6e 79 20 61 73 20 74 68 72 65 65 20 6f 70  many as three op
04a0: 65 72 61 6e 64 73 2e 20 20 54 68 65 20 69 6e 73  erands.  The ins
04b0: 74 72 75 63 74 69 6f 6e 20 69 73 20 72 65 63 6f  truction is reco
04c0: 72 64 65 64 0a 2a 2a 20 61 73 20 61 6e 20 69 6e  rded.** as an in
04d0: 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f  stance of the fo
04e0: 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72  llowing structur
04f0: 65 3a 0a 2a 2f 0a 73 74 72 75 63 74 20 56 64 62  e:.*/.struct Vdb
0500: 65 4f 70 20 7b 0a 20 20 75 38 20 6f 70 63 6f 64  eOp {.  u8 opcod
0510: 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57  e;          /* W
0520: 68 61 74 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f  hat operation to
0530: 20 70 65 72 66 6f 72 6d 20 2a 2f 0a 20 20 73 69   perform */.  si
0540: 67 6e 65 64 20 63 68 61 72 20 70 34 74 79 70 65  gned char p4type
0550: 3b 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20  ; /* One of the 
0560: 50 34 5f 78 78 78 20 63 6f 6e 73 74 61 6e 74 73  P4_xxx constants
0570: 20 66 6f 72 20 70 34 20 2a 2f 0a 20 20 75 38 20   for p4 */.  u8 
0580: 6f 70 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20  opflags;        
0590: 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 74 68 65 20   /* Mask of the 
05a0: 4f 50 46 4c 47 5f 2a 20 66 6c 61 67 73 20 69 6e  OPFLG_* flags in
05b0: 20 6f 70 63 6f 64 65 73 2e 68 20 2a 2f 0a 20 20   opcodes.h */.  
05c0: 75 38 20 70 35 3b 20 20 20 20 20 20 20 20 20 20  u8 p5;          
05d0: 20 20 20 20 2f 2a 20 46 69 66 74 68 20 70 61 72      /* Fifth par
05e0: 61 6d 65 74 65 72 20 69 73 20 61 6e 20 75 6e 73  ameter is an uns
05f0: 69 67 6e 65 64 20 63 68 61 72 61 63 74 65 72 20  igned character 
0600: 2a 2f 0a 20 20 69 6e 74 20 70 31 3b 20 20 20 20  */.  int p1;    
0610: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73           /* Firs
0620: 74 20 6f 70 65 72 61 6e 64 20 2a 2f 0a 20 20 69  t operand */.  i
0630: 6e 74 20 70 32 3b 20 20 20 20 20 20 20 20 20 20  nt p2;          
0640: 20 20 20 2f 2a 20 53 65 63 6f 6e 64 20 70 61 72     /* Second par
0650: 61 6d 65 74 65 72 20 28 6f 66 74 65 6e 20 74 68  ameter (often th
0660: 65 20 6a 75 6d 70 20 64 65 73 74 69 6e 61 74 69  e jump destinati
0670: 6f 6e 29 20 2a 2f 0a 20 20 69 6e 74 20 70 33 3b  on) */.  int p3;
0680: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
0690: 54 68 65 20 74 68 69 72 64 20 70 61 72 61 6d 65  The third parame
06a0: 74 65 72 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b  ter */.  union {
06b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
06c0: 66 6f 75 72 74 68 20 70 61 72 61 6d 65 74 65 72  fourth parameter
06d0: 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 3b 20 20   */.    int i;  
06e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
06f0: 2a 20 49 6e 74 65 67 65 72 20 76 61 6c 75 65 20  * Integer value 
0700: 69 66 20 70 34 74 79 70 65 3d 3d 50 34 5f 49 4e  if p4type==P4_IN
0710: 54 33 32 20 2a 2f 0a 20 20 20 20 76 6f 69 64 20  T32 */.    void 
0720: 2a 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  *p;             
0730: 20 20 2f 2a 20 47 65 6e 65 72 69 63 20 70 6f 69    /* Generic poi
0740: 6e 74 65 72 20 2a 2f 0a 20 20 20 20 63 68 61 72  nter */.    char
0750: 20 2a 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20   *z;            
0760: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f     /* Pointer to
0770: 20 64 61 74 61 20 66 6f 72 20 73 74 72 69 6e 67   data for string
0780: 20 28 63 68 61 72 20 61 72 72 61 79 29 20 74 79   (char array) ty
0790: 70 65 73 20 2a 2f 0a 20 20 20 20 69 36 34 20 2a  pes */.    i64 *
07a0: 70 49 36 34 3b 20 20 20 20 20 20 20 20 20 20 20  pI64;           
07b0: 20 20 2f 2a 20 55 73 65 64 20 77 68 65 6e 20 70    /* Used when p
07c0: 34 74 79 70 65 20 69 73 20 50 34 5f 49 4e 54 36  4type is P4_INT6
07d0: 34 20 2a 2f 0a 20 20 20 20 64 6f 75 62 6c 65 20  4 */.    double 
07e0: 2a 70 52 65 61 6c 3b 20 20 20 20 20 20 20 20 20  *pReal;         
07f0: 2f 2a 20 55 73 65 64 20 77 68 65 6e 20 70 34 74  /* Used when p4t
0800: 79 70 65 20 69 73 20 50 34 5f 52 45 41 4c 20 2a  ype is P4_REAL *
0810: 2f 0a 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70  /.    FuncDef *p
0820: 46 75 6e 63 3b 20 20 20 20 20 20 20 20 2f 2a 20  Func;        /* 
0830: 55 73 65 64 20 77 68 65 6e 20 70 34 74 79 70 65  Used when p4type
0840: 20 69 73 20 50 34 5f 46 55 4e 43 44 45 46 20 2a   is P4_FUNCDEF *
0850: 2f 0a 20 20 20 20 56 64 62 65 46 75 6e 63 20 2a  /.    VdbeFunc *
0860: 70 56 64 62 65 46 75 6e 63 3b 20 20 20 2f 2a 20  pVdbeFunc;   /* 
0870: 55 73 65 64 20 77 68 65 6e 20 70 34 74 79 70 65  Used when p4type
0880: 20 69 73 20 50 34 5f 56 44 42 45 46 55 4e 43 20   is P4_VDBEFUNC 
0890: 2a 2f 0a 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a  */.    CollSeq *
08a0: 70 43 6f 6c 6c 3b 20 20 20 20 20 20 20 20 2f 2a  pColl;        /*
08b0: 20 55 73 65 64 20 77 68 65 6e 20 70 34 74 79 70   Used when p4typ
08c0: 65 20 69 73 20 50 34 5f 43 4f 4c 4c 53 45 51 20  e is P4_COLLSEQ 
08d0: 2a 2f 0a 20 20 20 20 4d 65 6d 20 2a 70 4d 65 6d  */.    Mem *pMem
08e0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
08f0: 20 55 73 65 64 20 77 68 65 6e 20 70 34 74 79 70   Used when p4typ
0900: 65 20 69 73 20 50 34 5f 4d 45 4d 20 2a 2f 0a 20  e is P4_MEM */. 
0910: 20 20 20 56 54 61 62 6c 65 20 2a 70 56 74 61 62     VTable *pVtab
0920: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65  ;         /* Use
0930: 64 20 77 68 65 6e 20 70 34 74 79 70 65 20 69 73  d when p4type is
0940: 20 50 34 5f 56 54 41 42 20 2a 2f 0a 20 20 20 20   P4_VTAB */.    
0950: 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66  KeyInfo *pKeyInf
0960: 6f 3b 20 20 20 20 20 2f 2a 20 55 73 65 64 20 77  o;     /* Used w
0970: 68 65 6e 20 70 34 74 79 70 65 20 69 73 20 50 34  hen p4type is P4
0980: 5f 4b 45 59 49 4e 46 4f 20 2a 2f 0a 20 20 20 20  _KEYINFO */.    
0990: 69 6e 74 20 2a 61 69 3b 20 20 20 20 20 20 20 20  int *ai;        
09a0: 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 77         /* Used w
09b0: 68 65 6e 20 70 34 74 79 70 65 20 69 73 20 50 34  hen p4type is P4
09c0: 5f 49 4e 54 41 52 52 41 59 20 2a 2f 0a 20 20 20  _INTARRAY */.   
09d0: 20 53 75 62 50 72 6f 67 72 61 6d 20 2a 70 50 72   SubProgram *pPr
09e0: 6f 67 72 61 6d 3b 20 20 2f 2a 20 55 73 65 64 20  ogram;  /* Used 
09f0: 77 68 65 6e 20 70 34 74 79 70 65 20 69 73 20 50  when p4type is P
0a00: 34 5f 53 55 42 50 52 4f 47 52 41 4d 20 2a 2f 0a  4_SUBPROGRAM */.
0a10: 20 20 20 20 69 6e 74 20 28 2a 78 41 64 76 61 6e      int (*xAdvan
0a20: 63 65 29 28 42 74 43 75 72 73 6f 72 20 2a 2c 20  ce)(BtCursor *, 
0a30: 69 6e 74 20 2a 29 3b 0a 20 20 7d 20 70 34 3b 0a  int *);.  } p4;.
0a40: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
0a50: 42 55 47 0a 20 20 63 68 61 72 20 2a 7a 43 6f 6d  BUG.  char *zCom
0a60: 6d 65 6e 74 3b 20 20 20 20 20 20 20 20 20 20 2f  ment;          /
0a70: 2a 20 43 6f 6d 6d 65 6e 74 20 74 6f 20 69 6d 70  * Comment to imp
0a80: 72 6f 76 65 20 72 65 61 64 61 62 69 6c 69 74 79  rove readability
0a90: 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 64 65   */.#endif.#ifde
0aa0: 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45 0a 20  f VDBE_PROFILE. 
0ab0: 20 69 6e 74 20 63 6e 74 3b 20 20 20 20 20 20 20   int cnt;       
0ac0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
0ad0: 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 68 69  ber of times thi
0ae0: 73 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 77 61  s instruction wa
0af0: 73 20 65 78 65 63 75 74 65 64 20 2a 2f 0a 20 20  s executed */.  
0b00: 75 36 34 20 63 79 63 6c 65 73 3b 20 20 20 20 20  u64 cycles;     
0b10: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61           /* Tota
0b20: 6c 20 74 69 6d 65 20 73 70 65 6e 74 20 65 78 65  l time spent exe
0b30: 63 75 74 69 6e 67 20 74 68 69 73 20 69 6e 73 74  cuting this inst
0b40: 72 75 63 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 69  ruction */.#endi
0b50: 66 0a 7d 3b 0a 74 79 70 65 64 65 66 20 73 74 72  f.};.typedef str
0b60: 75 63 74 20 56 64 62 65 4f 70 20 56 64 62 65 4f  uct VdbeOp VdbeO
0b70: 70 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 75 62  p;.../*.** A sub
0b80: 2d 72 6f 75 74 69 6e 65 20 75 73 65 64 20 74 6f  -routine used to
0b90: 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 74 72 69   implement a tri
0ba0: 67 67 65 72 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f  gger program..*/
0bb0: 0a 73 74 72 75 63 74 20 53 75 62 50 72 6f 67 72  .struct SubProgr
0bc0: 61 6d 20 7b 0a 20 20 56 64 62 65 4f 70 20 2a 61  am {.  VdbeOp *a
0bd0: 4f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  Op;             
0be0: 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66       /* Array of
0bf0: 20 6f 70 63 6f 64 65 73 20 66 6f 72 20 73 75 62   opcodes for sub
0c00: 2d 70 72 6f 67 72 61 6d 20 2a 2f 0a 20 20 69 6e  -program */.  in
0c10: 74 20 6e 4f 70 3b 20 20 20 20 20 20 20 20 20 20  t nOp;          
0c20: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45              /* E
0c30: 6c 65 6d 65 6e 74 73 20 69 6e 20 61 4f 70 5b 5d  lements in aOp[]
0c40: 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 3b 20   */.  int nMem; 
0c50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0c60: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
0c70: 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73 20 72 65   memory cells re
0c80: 71 75 69 72 65 64 20 2a 2f 0a 20 20 69 6e 74 20  quired */.  int 
0c90: 6e 43 73 72 3b 20 20 20 20 20 20 20 20 20 20 20  nCsr;           
0ca0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
0cb0: 62 65 72 20 6f 66 20 63 75 72 73 6f 72 73 20 72  ber of cursors r
0cc0: 65 71 75 69 72 65 64 20 2a 2f 0a 20 20 69 6e 74  equired */.  int
0cd0: 20 6e 4f 6e 63 65 3b 20 20 20 20 20 20 20 20 20   nOnce;         
0ce0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
0cf0: 6d 62 65 72 20 6f 66 20 4f 50 5f 4f 6e 63 65 20  mber of OP_Once 
0d00: 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 2a 2f 0a  instructions */.
0d10: 20 20 76 6f 69 64 20 2a 74 6f 6b 65 6e 3b 20 20    void *token;  
0d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d30: 2f 2a 20 69 64 20 74 68 61 74 20 6d 61 79 20 62  /* id that may b
0d40: 65 20 75 73 65 64 20 74 6f 20 72 65 63 75 72 73  e used to recurs
0d50: 69 76 65 20 74 72 69 67 67 65 72 73 20 2a 2f 0a  ive triggers */.
0d60: 20 20 53 75 62 50 72 6f 67 72 61 6d 20 2a 70 4e    SubProgram *pN
0d70: 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20  ext;            
0d80: 2f 2a 20 4e 65 78 74 20 73 75 62 2d 70 72 6f 67  /* Next sub-prog
0d90: 72 61 6d 20 61 6c 72 65 61 64 79 20 76 69 73 69  ram already visi
0da0: 74 65 64 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  ted */.};../*.**
0db0: 20 41 20 73 6d 61 6c 6c 65 72 20 76 65 72 73 69   A smaller versi
0dc0: 6f 6e 20 6f 66 20 56 64 62 65 4f 70 20 75 73 65  on of VdbeOp use
0dd0: 64 20 66 6f 72 20 74 68 65 20 56 64 62 65 41 64  d for the VdbeAd
0de0: 64 4f 70 4c 69 73 74 28 29 20 66 75 6e 63 74 69  dOpList() functi
0df0: 6f 6e 20 62 65 63 61 75 73 65 0a 2a 2a 20 69 74  on because.** it
0e00: 20 74 61 6b 65 73 20 75 70 20 6c 65 73 73 20 73   takes up less s
0e10: 70 61 63 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20  pace..*/.struct 
0e20: 56 64 62 65 4f 70 4c 69 73 74 20 7b 0a 20 20 75  VdbeOpList {.  u
0e30: 38 20 6f 70 63 6f 64 65 3b 20 20 20 20 20 20 20  8 opcode;       
0e40: 20 20 20 2f 2a 20 57 68 61 74 20 6f 70 65 72 61     /* What opera
0e50: 74 69 6f 6e 20 74 6f 20 70 65 72 66 6f 72 6d 20  tion to perform 
0e60: 2a 2f 0a 20 20 73 69 67 6e 65 64 20 63 68 61 72  */.  signed char
0e70: 20 70 31 3b 20 20 20 20 20 2f 2a 20 46 69 72 73   p1;     /* Firs
0e80: 74 20 6f 70 65 72 61 6e 64 20 2a 2f 0a 20 20 73  t operand */.  s
0e90: 69 67 6e 65 64 20 63 68 61 72 20 70 32 3b 20 20  igned char p2;  
0ea0: 20 20 20 2f 2a 20 53 65 63 6f 6e 64 20 70 61 72     /* Second par
0eb0: 61 6d 65 74 65 72 20 28 6f 66 74 65 6e 20 74 68  ameter (often th
0ec0: 65 20 6a 75 6d 70 20 64 65 73 74 69 6e 61 74 69  e jump destinati
0ed0: 6f 6e 29 20 2a 2f 0a 20 20 73 69 67 6e 65 64 20  on) */.  signed 
0ee0: 63 68 61 72 20 70 33 3b 20 20 20 20 20 2f 2a 20  char p3;     /* 
0ef0: 54 68 69 72 64 20 70 61 72 61 6d 65 74 65 72 20  Third parameter 
0f00: 2a 2f 0a 7d 3b 0a 74 79 70 65 64 65 66 20 73 74  */.};.typedef st
0f10: 72 75 63 74 20 56 64 62 65 4f 70 4c 69 73 74 20  ruct VdbeOpList 
0f20: 56 64 62 65 4f 70 4c 69 73 74 3b 0a 0a 2f 2a 0a  VdbeOpList;../*.
0f30: 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65  ** Allowed value
0f40: 73 20 6f 66 20 56 64 62 65 4f 70 2e 70 34 74 79  s of VdbeOp.p4ty
0f50: 70 65 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34  pe.*/.#define P4
0f60: 5f 4e 4f 54 55 53 45 44 20 20 20 20 30 20 20 20  _NOTUSED    0   
0f70: 2f 2a 20 54 68 65 20 50 34 20 70 61 72 61 6d 65  /* The P4 parame
0f80: 74 65 72 20 69 73 20 6e 6f 74 20 75 73 65 64 20  ter is not used 
0f90: 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34 5f 44 59  */.#define P4_DY
0fa0: 4e 41 4d 49 43 20 20 28 2d 31 29 20 20 2f 2a 20  NAMIC  (-1)  /* 
0fb0: 50 6f 69 6e 74 65 72 20 74 6f 20 61 20 73 74 72  Pointer to a str
0fc0: 69 6e 67 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  ing obtained fro
0fd0: 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29  m sqliteMalloc()
0fe0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34 5f 53   */.#define P4_S
0ff0: 54 41 54 49 43 20 20 20 28 2d 32 29 20 20 2f 2a  TATIC   (-2)  /*
1000: 20 50 6f 69 6e 74 65 72 20 74 6f 20 61 20 73 74   Pointer to a st
1010: 61 74 69 63 20 73 74 72 69 6e 67 20 2a 2f 0a 23  atic string */.#
1020: 64 65 66 69 6e 65 20 50 34 5f 43 4f 4c 4c 53 45  define P4_COLLSE
1030: 51 20 20 28 2d 34 29 20 20 2f 2a 20 50 34 20 69  Q  (-4)  /* P4 i
1040: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61  s a pointer to a
1050: 20 43 6f 6c 6c 53 65 71 20 73 74 72 75 63 74 75   CollSeq structu
1060: 72 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34  re */.#define P4
1070: 5f 46 55 4e 43 44 45 46 20 20 28 2d 35 29 20 20  _FUNCDEF  (-5)  
1080: 2f 2a 20 50 34 20 69 73 20 61 20 70 6f 69 6e 74  /* P4 is a point
1090: 65 72 20 74 6f 20 61 20 46 75 6e 63 44 65 66 20  er to a FuncDef 
10a0: 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 23 64 65  structure */.#de
10b0: 66 69 6e 65 20 50 34 5f 4b 45 59 49 4e 46 4f 20  fine P4_KEYINFO 
10c0: 20 28 2d 36 29 20 20 2f 2a 20 50 34 20 69 73 20   (-6)  /* P4 is 
10d0: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 4b  a pointer to a K
10e0: 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65  eyInfo structure
10f0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34 5f 56   */.#define P4_V
1100: 44 42 45 46 55 4e 43 20 28 2d 37 29 20 20 2f 2a  DBEFUNC (-7)  /*
1110: 20 50 34 20 69 73 20 61 20 70 6f 69 6e 74 65 72   P4 is a pointer
1120: 20 74 6f 20 61 20 56 64 62 65 46 75 6e 63 20 73   to a VdbeFunc s
1130: 74 72 75 63 74 75 72 65 20 2a 2f 0a 23 64 65 66  tructure */.#def
1140: 69 6e 65 20 50 34 5f 4d 45 4d 20 20 20 20 20 20  ine P4_MEM      
1150: 28 2d 38 29 20 20 2f 2a 20 50 34 20 69 73 20 61  (-8)  /* P4 is a
1160: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65   pointer to a Me
1170: 6d 2a 20 20 20 20 73 74 72 75 63 74 75 72 65 20  m*    structure 
1180: 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34 5f 54 52  */.#define P4_TR
1190: 41 4e 53 49 45 4e 54 20 20 30 20 20 20 2f 2a 20  ANSIENT  0   /* 
11a0: 50 34 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20  P4 is a pointer 
11b0: 74 6f 20 61 20 74 72 61 6e 73 69 65 6e 74 20 73  to a transient s
11c0: 74 72 69 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65  tring */.#define
11d0: 20 50 34 5f 56 54 41 42 20 20 20 20 20 28 2d 31   P4_VTAB     (-1
11e0: 30 29 20 2f 2a 20 50 34 20 69 73 20 61 20 70 6f  0) /* P4 is a po
11f0: 69 6e 74 65 72 20 74 6f 20 61 6e 20 73 71 6c 69  inter to an sqli
1200: 74 65 33 5f 76 74 61 62 20 73 74 72 75 63 74 75  te3_vtab structu
1210: 72 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34  re */.#define P4
1220: 5f 4d 50 52 49 4e 54 46 20 20 28 2d 31 31 29 20  _MPRINTF  (-11) 
1230: 2f 2a 20 50 34 20 69 73 20 61 20 73 74 72 69 6e  /* P4 is a strin
1240: 67 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20  g obtained from 
1250: 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28  sqlite3_mprintf(
1260: 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34 5f  ) */.#define P4_
1270: 52 45 41 4c 20 20 20 20 20 28 2d 31 32 29 20 2f  REAL     (-12) /
1280: 2a 20 50 34 20 69 73 20 61 20 36 34 2d 62 69 74  * P4 is a 64-bit
1290: 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20   floating point 
12a0: 76 61 6c 75 65 20 2a 2f 0a 23 64 65 66 69 6e 65  value */.#define
12b0: 20 50 34 5f 49 4e 54 36 34 20 20 20 20 28 2d 31   P4_INT64    (-1
12c0: 33 29 20 2f 2a 20 50 34 20 69 73 20 61 20 36 34  3) /* P4 is a 64
12d0: 2d 62 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65  -bit signed inte
12e0: 67 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50  ger */.#define P
12f0: 34 5f 49 4e 54 33 32 20 20 20 20 28 2d 31 34 29  4_INT32    (-14)
1300: 20 2f 2a 20 50 34 20 69 73 20 61 20 33 32 2d 62   /* P4 is a 32-b
1310: 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65  it signed intege
1320: 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34 5f  r */.#define P4_
1330: 49 4e 54 41 52 52 41 59 20 28 2d 31 35 29 20 2f  INTARRAY (-15) /
1340: 2a 20 50 34 20 69 73 20 61 20 76 65 63 74 6f 72  * P4 is a vector
1350: 20 6f 66 20 33 32 2d 62 69 74 20 69 6e 74 65 67   of 32-bit integ
1360: 65 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50  ers */.#define P
1370: 34 5f 53 55 42 50 52 4f 47 52 41 4d 20 20 28 2d  4_SUBPROGRAM  (-
1380: 31 38 29 20 2f 2a 20 50 34 20 69 73 20 61 20 70  18) /* P4 is a p
1390: 6f 69 6e 74 65 72 20 74 6f 20 61 20 53 75 62 50  ointer to a SubP
13a0: 72 6f 67 72 61 6d 20 73 74 72 75 63 74 75 72 65  rogram structure
13b0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 34 5f 41   */.#define P4_A
13c0: 44 56 41 4e 43 45 20 20 28 2d 31 39 29 20 2f 2a  DVANCE  (-19) /*
13d0: 20 50 34 20 69 73 20 61 20 70 6f 69 6e 74 65 72   P4 is a pointer
13e0: 20 74 6f 20 42 74 72 65 65 4e 65 78 74 28 29 20   to BtreeNext() 
13f0: 6f 72 20 42 74 72 65 65 50 72 65 76 28 29 20 2a  or BtreePrev() *
1400: 2f 0a 0a 2f 2a 20 57 68 65 6e 20 61 64 64 69 6e  /../* When addin
1410: 67 20 61 20 50 34 20 61 72 67 75 6d 65 6e 74 20  g a P4 argument 
1420: 75 73 69 6e 67 20 50 34 5f 4b 45 59 49 4e 46 4f  using P4_KEYINFO
1430: 2c 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20  , a copy of the 
1440: 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72  KeyInfo structur
1450: 65 0a 2a 2a 20 69 73 20 6d 61 64 65 2e 20 20 54  e.** is made.  T
1460: 68 61 74 20 63 6f 70 79 20 69 73 20 66 72 65 65  hat copy is free
1470: 64 20 77 68 65 6e 20 74 68 65 20 56 64 62 65 20  d when the Vdbe 
1480: 69 73 20 66 69 6e 61 6c 69 7a 65 64 2e 20 20 42  is finalized.  B
1490: 75 74 20 69 66 20 74 68 65 0a 2a 2a 20 61 72 67  ut if the.** arg
14a0: 75 6d 65 6e 74 20 69 73 20 50 34 5f 4b 45 59 49  ument is P4_KEYI
14b0: 4e 46 4f 5f 48 41 4e 44 4f 46 46 2c 20 74 68 65  NFO_HANDOFF, the
14c0: 20 70 61 73 73 65 64 20 69 6e 20 70 6f 69 6e 74   passed in point
14d0: 65 72 20 69 73 20 75 73 65 64 2e 20 20 49 74 20  er is used.  It 
14e0: 73 74 69 6c 6c 0a 2a 2a 20 67 65 74 73 20 66 72  still.** gets fr
14f0: 65 65 64 20 77 68 65 6e 20 74 68 65 20 56 64 62  eed when the Vdb
1500: 65 20 69 73 20 66 69 6e 61 6c 69 7a 65 64 20 73  e is finalized s
1510: 6f 20 69 74 20 73 74 69 6c 6c 20 73 68 6f 75 6c  o it still shoul
1520: 64 20 62 65 20 6f 62 74 61 69 6e 65 64 0a 2a 2a  d be obtained.**
1530: 20 66 72 6f 6d 20 61 20 73 69 6e 67 6c 65 20 73   from a single s
1540: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 2e 20 20  qliteMalloc().  
1550: 42 75 74 20 6e 6f 20 63 6f 70 79 20 69 73 20 6d  But no copy is m
1560: 61 64 65 20 61 6e 64 20 74 68 65 20 63 61 6c 6c  ade and the call
1570: 69 6e 67 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20  ing.** function 
1580: 73 68 6f 75 6c 64 20 2a 6e 6f 74 2a 20 74 72 79  should *not* try
1590: 20 74 6f 20 66 72 65 65 20 74 68 65 20 4b 65 79   to free the Key
15a0: 49 6e 66 6f 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65  Info..*/.#define
15b0: 20 50 34 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44   P4_KEYINFO_HAND
15c0: 4f 46 46 20 28 2d 31 36 29 0a 23 64 65 66 69 6e  OFF (-16).#defin
15d0: 65 20 50 34 5f 4b 45 59 49 4e 46 4f 5f 53 54 41  e P4_KEYINFO_STA
15e0: 54 49 43 20 20 28 2d 31 37 29 0a 0a 2f 2a 0a 2a  TIC  (-17)../*.*
15f0: 2a 20 54 68 65 20 56 64 62 65 2e 61 43 6f 6c 4e  * The Vdbe.aColN
1600: 61 6d 65 20 61 72 72 61 79 20 63 6f 6e 74 61 69  ame array contai
1610: 6e 73 20 35 6e 20 4d 65 6d 20 73 74 72 75 63 74  ns 5n Mem struct
1620: 75 72 65 73 2c 20 77 68 65 72 65 20 6e 20 69 73  ures, where n is
1630: 20 74 68 65 20 0a 2a 2a 20 6e 75 6d 62 65 72 20   the .** number 
1640: 6f 66 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 64 61  of columns of da
1650: 74 61 20 72 65 74 75 72 6e 65 64 20 62 79 20 74  ta returned by t
1660: 68 65 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f  he statement..*/
1670: 0a 23 64 65 66 69 6e 65 20 43 4f 4c 4e 41 4d 45  .#define COLNAME
1680: 5f 4e 41 4d 45 20 20 20 20 20 30 0a 23 64 65 66  _NAME     0.#def
1690: 69 6e 65 20 43 4f 4c 4e 41 4d 45 5f 44 45 43 4c  ine COLNAME_DECL
16a0: 54 59 50 45 20 31 0a 23 64 65 66 69 6e 65 20 43  TYPE 1.#define C
16b0: 4f 4c 4e 41 4d 45 5f 44 41 54 41 42 41 53 45 20  OLNAME_DATABASE 
16c0: 32 0a 23 64 65 66 69 6e 65 20 43 4f 4c 4e 41 4d  2.#define COLNAM
16d0: 45 5f 54 41 42 4c 45 20 20 20 20 33 0a 23 64 65  E_TABLE    3.#de
16e0: 66 69 6e 65 20 43 4f 4c 4e 41 4d 45 5f 43 4f 4c  fine COLNAME_COL
16f0: 55 4d 4e 20 20 20 34 0a 23 69 66 64 65 66 20 53  UMN   4.#ifdef S
1700: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c  QLITE_ENABLE_COL
1710: 55 4d 4e 5f 4d 45 54 41 44 41 54 41 0a 23 20 64  UMN_METADATA.# d
1720: 65 66 69 6e 65 20 43 4f 4c 4e 41 4d 45 5f 4e 20  efine COLNAME_N 
1730: 20 20 20 20 20 20 20 35 20 20 20 20 20 20 2f 2a         5      /*
1740: 20 4e 75 6d 62 65 72 20 6f 66 20 43 4f 4c 4e 41   Number of COLNA
1750: 4d 45 5f 78 78 78 20 73 79 6d 62 6f 6c 73 20 2a  ME_xxx symbols *
1760: 2f 0a 23 65 6c 73 65 0a 23 20 69 66 64 65 66 20  /.#else.# ifdef 
1770: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c  SQLITE_OMIT_DECL
1780: 54 59 50 45 0a 23 20 20 20 64 65 66 69 6e 65 20  TYPE.#   define 
1790: 43 4f 4c 4e 41 4d 45 5f 4e 20 20 20 20 20 20 31  COLNAME_N      1
17a0: 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 6f        /* Store o
17b0: 6e 6c 79 20 74 68 65 20 6e 61 6d 65 20 2a 2f 0a  nly the name */.
17c0: 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69 6e  # else.#   defin
17d0: 65 20 43 4f 4c 4e 41 4d 45 5f 4e 20 20 20 20 20  e COLNAME_N     
17e0: 20 32 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 65   2      /* Store
17f0: 20 74 68 65 20 6e 61 6d 65 20 61 6e 64 20 64 65   the name and de
1800: 63 6c 74 79 70 65 20 2a 2f 0a 23 20 65 6e 64 69  cltype */.# endi
1810: 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  f.#endif../*.** 
1820: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61  The following ma
1830: 63 72 6f 20 63 6f 6e 76 65 72 74 73 20 61 20 72  cro converts a r
1840: 65 6c 61 74 69 76 65 20 61 64 64 72 65 73 73 20  elative address 
1850: 69 6e 20 74 68 65 20 70 32 20 66 69 65 6c 64 0a  in the p2 field.
1860: 2a 2a 20 6f 66 20 61 20 56 64 62 65 4f 70 20 73  ** of a VdbeOp s
1870: 74 72 75 63 74 75 72 65 20 69 6e 74 6f 20 61 20  tructure into a 
1880: 6e 65 67 61 74 69 76 65 20 6e 75 6d 62 65 72 20  negative number 
1890: 73 6f 20 74 68 61 74 20 0a 2a 2a 20 73 71 6c 69  so that .** sqli
18a0: 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74  te3VdbeAddOpList
18b0: 28 29 20 6b 6e 6f 77 73 20 74 68 61 74 20 74 68  () knows that th
18c0: 65 20 61 64 64 72 65 73 73 20 69 73 20 72 65 6c  e address is rel
18d0: 61 74 69 76 65 2e 20 20 43 61 6c 6c 69 6e 67 0a  ative.  Calling.
18e0: 2a 2a 20 74 68 65 20 6d 61 63 72 6f 20 61 67 61  ** the macro aga
18f0: 69 6e 20 72 65 73 74 6f 72 65 73 20 74 68 65 20  in restores the 
1900: 61 64 64 72 65 73 73 2e 0a 2a 2f 0a 23 64 65 66  address..*/.#def
1910: 69 6e 65 20 41 44 44 52 28 58 29 20 20 28 2d 31  ine ADDR(X)  (-1
1920: 2d 28 58 29 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65  -(X))../*.** The
1930: 20 6d 61 6b 65 66 69 6c 65 20 73 63 61 6e 73 20   makefile scans 
1940: 74 68 65 20 76 64 62 65 2e 63 20 73 6f 75 72 63  the vdbe.c sourc
1950: 65 20 66 69 6c 65 20 61 6e 64 20 63 72 65 61 74  e file and creat
1960: 65 73 20 74 68 65 20 22 6f 70 63 6f 64 65 73 2e  es the "opcodes.
1970: 68 22 0a 2a 2a 20 68 65 61 64 65 72 20 66 69 6c  h".** header fil
1980: 65 20 74 68 61 74 20 64 65 66 69 6e 65 73 20 61  e that defines a
1990: 20 6e 75 6d 62 65 72 20 66 6f 72 20 65 61 63 68   number for each
19a0: 20 6f 70 63 6f 64 65 20 75 73 65 64 20 62 79 20   opcode used by 
19b0: 74 68 65 20 56 44 42 45 2e 0a 2a 2f 0a 23 69 6e  the VDBE..*/.#in
19c0: 63 6c 75 64 65 20 22 6f 70 63 6f 64 65 73 2e 68  clude "opcodes.h
19d0: 22 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 74 6f 74 79  "../*.** Prototy
19e0: 70 65 73 20 66 6f 72 20 74 68 65 20 56 44 42 45  pes for the VDBE
19f0: 20 69 6e 74 65 72 66 61 63 65 2e 20 20 53 65 65   interface.  See
1a00: 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 74 68 65   comments on the
1a10: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 0a   implementation.
1a20: 2a 2a 20 66 6f 72 20 61 20 64 65 73 63 72 69 70  ** for a descrip
1a30: 74 69 6f 6e 20 6f 66 20 77 68 61 74 20 65 61 63  tion of what eac
1a40: 68 20 6f 66 20 74 68 65 73 65 20 72 6f 75 74 69  h of these routi
1a50: 6e 65 73 20 64 6f 65 73 2e 0a 2a 2f 0a 56 64 62  nes does..*/.Vdb
1a60: 65 20 2a 73 71 6c 69 74 65 33 56 64 62 65 43 72  e *sqlite3VdbeCr
1a70: 65 61 74 65 28 73 71 6c 69 74 65 33 2a 29 3b 0a  eate(sqlite3*);.
1a80: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 41  int sqlite3VdbeA
1a90: 64 64 4f 70 30 28 56 64 62 65 2a 2c 69 6e 74 29  ddOp0(Vdbe*,int)
1aa0: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  ;.int sqlite3Vdb
1ab0: 65 41 64 64 4f 70 31 28 56 64 62 65 2a 2c 69 6e  eAddOp1(Vdbe*,in
1ac0: 74 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69  t,int);.int sqli
1ad0: 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 56 64  te3VdbeAddOp2(Vd
1ae0: 62 65 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 29  be*,int,int,int)
1af0: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  ;.int sqlite3Vdb
1b00: 65 41 64 64 4f 70 33 28 56 64 62 65 2a 2c 69 6e  eAddOp3(Vdbe*,in
1b10: 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a  t,int,int,int);.
1b20: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 41  int sqlite3VdbeA
1b30: 64 64 4f 70 34 28 56 64 62 65 2a 2c 69 6e 74 2c  ddOp4(Vdbe*,int,
1b40: 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 63 6f 6e 73  int,int,int,cons
1b50: 74 20 63 68 61 72 20 2a 7a 50 34 2c 69 6e 74 29  t char *zP4,int)
1b60: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  ;.int sqlite3Vdb
1b70: 65 41 64 64 4f 70 34 49 6e 74 28 56 64 62 65 2a  eAddOp4Int(Vdbe*
1b80: 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74  ,int,int,int,int
1b90: 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74  ,int);.int sqlit
1ba0: 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28  e3VdbeAddOpList(
1bb0: 56 64 62 65 2a 2c 20 69 6e 74 20 6e 4f 70 2c 20  Vdbe*, int nOp, 
1bc0: 56 64 62 65 4f 70 4c 69 73 74 20 63 6f 6e 73 74  VdbeOpList const
1bd0: 20 2a 61 4f 70 29 3b 0a 76 6f 69 64 20 73 71 6c   *aOp);.void sql
1be0: 69 74 65 33 56 64 62 65 41 64 64 50 61 72 73 65  ite3VdbeAddParse
1bf0: 53 63 68 65 6d 61 4f 70 28 56 64 62 65 2a 2c 69  SchemaOp(Vdbe*,i
1c00: 6e 74 2c 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20  nt,char*);.void 
1c10: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
1c20: 65 50 31 28 56 64 62 65 2a 2c 20 75 33 32 20 61  eP1(Vdbe*, u32 a
1c30: 64 64 72 2c 20 69 6e 74 20 50 31 29 3b 0a 76 6f  ddr, int P1);.vo
1c40: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 43 68  id sqlite3VdbeCh
1c50: 61 6e 67 65 50 32 28 56 64 62 65 2a 2c 20 75 33  angeP2(Vdbe*, u3
1c60: 32 20 61 64 64 72 2c 20 69 6e 74 20 50 32 29 3b  2 addr, int P2);
1c70: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
1c80: 65 43 68 61 6e 67 65 50 33 28 56 64 62 65 2a 2c  eChangeP3(Vdbe*,
1c90: 20 75 33 32 20 61 64 64 72 2c 20 69 6e 74 20 50   u32 addr, int P
1ca0: 33 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  3);.void sqlite3
1cb0: 56 64 62 65 43 68 61 6e 67 65 50 35 28 56 64 62  VdbeChangeP5(Vdb
1cc0: 65 2a 2c 20 75 38 20 50 35 29 3b 0a 76 6f 69 64  e*, u8 P5);.void
1cd0: 20 73 71 6c 69 74 65 33 56 64 62 65 4a 75 6d 70   sqlite3VdbeJump
1ce0: 48 65 72 65 28 56 64 62 65 2a 2c 20 69 6e 74 20  Here(Vdbe*, int 
1cf0: 61 64 64 72 29 3b 0a 76 6f 69 64 20 73 71 6c 69  addr);.void sqli
1d00: 74 65 33 56 64 62 65 43 68 61 6e 67 65 54 6f 4e  te3VdbeChangeToN
1d10: 6f 6f 70 28 56 64 62 65 2a 2c 20 69 6e 74 20 61  oop(Vdbe*, int a
1d20: 64 64 72 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74  ddr);.void sqlit
1d30: 65 33 56 64 62 65 43 68 61 6e 67 65 50 34 28 56  e3VdbeChangeP4(V
1d40: 64 62 65 2a 2c 20 69 6e 74 20 61 64 64 72 2c 20  dbe*, int addr, 
1d50: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 34 2c  const char *zP4,
1d60: 20 69 6e 74 20 4e 29 3b 0a 76 6f 69 64 20 73 71   int N);.void sq
1d70: 6c 69 74 65 33 56 64 62 65 55 73 65 73 42 74 72  lite3VdbeUsesBtr
1d80: 65 65 28 56 64 62 65 2a 2c 20 69 6e 74 29 3b 0a  ee(Vdbe*, int);.
1d90: 56 64 62 65 4f 70 20 2a 73 71 6c 69 74 65 33 56  VdbeOp *sqlite3V
1da0: 64 62 65 47 65 74 4f 70 28 56 64 62 65 2a 2c 20  dbeGetOp(Vdbe*, 
1db0: 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  int);.int sqlite
1dc0: 33 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 56  3VdbeMakeLabel(V
1dd0: 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69  dbe*);.void sqli
1de0: 74 65 33 56 64 62 65 52 75 6e 4f 6e 6c 79 4f 6e  te3VdbeRunOnlyOn
1df0: 63 65 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20  ce(Vdbe*);.void 
1e00: 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74  sqlite3VdbeDelet
1e10: 65 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73  e(Vdbe*);.void s
1e20: 71 6c 69 74 65 33 56 64 62 65 43 6c 65 61 72 4f  qlite3VdbeClearO
1e30: 62 6a 65 63 74 28 73 71 6c 69 74 65 33 2a 2c 56  bject(sqlite3*,V
1e40: 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69  dbe*);.void sqli
1e50: 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61 64 79  te3VdbeMakeReady
1e60: 28 56 64 62 65 2a 2c 50 61 72 73 65 2a 29 3b 0a  (Vdbe*,Parse*);.
1e70: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 46  int sqlite3VdbeF
1e80: 69 6e 61 6c 69 7a 65 28 56 64 62 65 2a 29 3b 0a  inalize(Vdbe*);.
1e90: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
1ea0: 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62  ResolveLabel(Vdb
1eb0: 65 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71  e*, int);.int sq
1ec0: 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74  lite3VdbeCurrent
1ed0: 41 64 64 72 28 56 64 62 65 2a 29 3b 0a 23 69 66  Addr(Vdbe*);.#if
1ee0: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47  def SQLITE_DEBUG
1ef0: 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 56 64  .  int sqlite3Vd
1f00: 62 65 41 73 73 65 72 74 4d 61 79 41 62 6f 72 74  beAssertMayAbort
1f10: 28 56 64 62 65 20 2a 2c 20 69 6e 74 29 3b 0a 20  (Vdbe *, int);. 
1f20: 20 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62   void sqlite3Vdb
1f30: 65 54 72 61 63 65 28 56 64 62 65 2a 2c 46 49 4c  eTrace(Vdbe*,FIL
1f40: 45 2a 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 64  E*);.#endif.void
1f50: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73 65   sqlite3VdbeRese
1f60: 74 53 74 65 70 52 65 73 75 6c 74 28 56 64 62 65  tStepResult(Vdbe
1f70: 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  *);.void sqlite3
1f80: 56 64 62 65 52 65 77 69 6e 64 28 56 64 62 65 2a  VdbeRewind(Vdbe*
1f90: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  );.int sqlite3Vd
1fa0: 62 65 52 65 73 65 74 28 56 64 62 65 2a 29 3b 0a  beReset(Vdbe*);.
1fb0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
1fc0: 53 65 74 4e 75 6d 43 6f 6c 73 28 56 64 62 65 2a  SetNumCols(Vdbe*
1fd0: 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74  ,int);.int sqlit
1fe0: 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65  e3VdbeSetColName
1ff0: 28 56 64 62 65 2a 2c 20 69 6e 74 2c 20 69 6e 74  (Vdbe*, int, int
2000: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20  , const char *, 
2010: 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b  void(*)(void*));
2020: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
2030: 65 43 6f 75 6e 74 43 68 61 6e 67 65 73 28 56 64  eCountChanges(Vd
2040: 62 65 2a 29 3b 0a 73 71 6c 69 74 65 33 20 2a 73  be*);.sqlite3 *s
2050: 71 6c 69 74 65 33 56 64 62 65 44 62 28 56 64 62  qlite3VdbeDb(Vdb
2060: 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65  e*);.void sqlite
2070: 33 56 64 62 65 53 65 74 53 71 6c 28 56 64 62 65  3VdbeSetSql(Vdbe
2080: 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  *, const char *z
2090: 2c 20 69 6e 74 20 6e 2c 20 69 6e 74 29 3b 0a 76  , int n, int);.v
20a0: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 53  oid sqlite3VdbeS
20b0: 77 61 70 28 56 64 62 65 2a 2c 56 64 62 65 2a 29  wap(Vdbe*,Vdbe*)
20c0: 3b 0a 56 64 62 65 4f 70 20 2a 73 71 6c 69 74 65  ;.VdbeOp *sqlite
20d0: 33 56 64 62 65 54 61 6b 65 4f 70 41 72 72 61 79  3VdbeTakeOpArray
20e0: 28 56 64 62 65 2a 2c 20 69 6e 74 2a 2c 20 69 6e  (Vdbe*, int*, in
20f0: 74 2a 29 3b 0a 73 71 6c 69 74 65 33 5f 76 61 6c  t*);.sqlite3_val
2100: 75 65 20 2a 73 71 6c 69 74 65 33 56 64 62 65 47  ue *sqlite3VdbeG
2110: 65 74 56 61 6c 75 65 28 56 64 62 65 2a 2c 20 69  etValue(Vdbe*, i
2120: 6e 74 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 71  nt, u8);.void sq
2130: 6c 69 74 65 33 56 64 62 65 53 65 74 56 61 72 6d  lite3VdbeSetVarm
2140: 61 73 6b 28 56 64 62 65 2a 2c 20 69 6e 74 29 3b  ask(Vdbe*, int);
2150: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
2160: 4f 4d 49 54 5f 54 52 41 43 45 0a 20 20 63 68 61  OMIT_TRACE.  cha
2170: 72 20 2a 73 71 6c 69 74 65 33 56 64 62 65 45 78  r *sqlite3VdbeEx
2180: 70 61 6e 64 53 71 6c 28 56 64 62 65 2a 2c 20 63  pandSql(Vdbe*, c
2190: 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e  onst char*);.#en
21a0: 64 69 66 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65  dif..void sqlite
21b0: 33 56 64 62 65 52 65 63 6f 72 64 55 6e 70 61 63  3VdbeRecordUnpac
21c0: 6b 28 4b 65 79 49 6e 66 6f 2a 2c 69 6e 74 2c 63  k(KeyInfo*,int,c
21d0: 6f 6e 73 74 20 76 6f 69 64 2a 2c 55 6e 70 61 63  onst void*,Unpac
21e0: 6b 65 64 52 65 63 6f 72 64 2a 29 3b 0a 69 6e 74  kedRecord*);.int
21f0: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
2200: 72 64 43 6f 6d 70 61 72 65 28 69 6e 74 2c 63 6f  rdCompare(int,co
2210: 6e 73 74 20 76 6f 69 64 2a 2c 55 6e 70 61 63 6b  nst void*,Unpack
2220: 65 64 52 65 63 6f 72 64 2a 29 3b 0a 55 6e 70 61  edRecord*);.Unpa
2230: 63 6b 65 64 52 65 63 6f 72 64 20 2a 73 71 6c 69  ckedRecord *sqli
2240: 74 65 33 56 64 62 65 41 6c 6c 6f 63 55 6e 70 61  te3VdbeAllocUnpa
2250: 63 6b 65 64 52 65 63 6f 72 64 28 4b 65 79 49 6e  ckedRecord(KeyIn
2260: 66 6f 20 2a 2c 20 63 68 61 72 20 2a 2c 20 69 6e  fo *, char *, in
2270: 74 2c 20 63 68 61 72 20 2a 2a 29 3b 0a 0a 23 69  t, char **);..#i
2280: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
2290: 54 5f 54 52 49 47 47 45 52 0a 76 6f 69 64 20 73  T_TRIGGER.void s
22a0: 71 6c 69 74 65 33 56 64 62 65 4c 69 6e 6b 53 75  qlite3VdbeLinkSu
22b0: 62 50 72 6f 67 72 61 6d 28 56 64 62 65 20 2a 2c  bProgram(Vdbe *,
22c0: 20 53 75 62 50 72 6f 67 72 61 6d 20 2a 29 3b 0a   SubProgram *);.
22d0: 23 65 6e 64 69 66 0a 0a 0a 23 69 66 6e 64 65 66  #endif...#ifndef
22e0: 20 4e 44 45 42 55 47 0a 20 20 76 6f 69 64 20 73   NDEBUG.  void s
22f0: 71 6c 69 74 65 33 56 64 62 65 43 6f 6d 6d 65 6e  qlite3VdbeCommen
2300: 74 28 56 64 62 65 2a 2c 20 63 6f 6e 73 74 20 63  t(Vdbe*, const c
2310: 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 23 20 64 65  har*, ...);.# de
2320: 66 69 6e 65 20 56 64 62 65 43 6f 6d 6d 65 6e 74  fine VdbeComment
2330: 28 58 29 20 20 73 71 6c 69 74 65 33 56 64 62 65  (X)  sqlite3Vdbe
2340: 43 6f 6d 6d 65 6e 74 20 58 0a 20 20 76 6f 69 64  Comment X.  void
2350: 20 73 71 6c 69 74 65 33 56 64 62 65 4e 6f 6f 70   sqlite3VdbeNoop
2360: 43 6f 6d 6d 65 6e 74 28 56 64 62 65 2a 2c 20 63  Comment(Vdbe*, c
2370: 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29  onst char*, ...)
2380: 3b 0a 23 20 64 65 66 69 6e 65 20 56 64 62 65 4e  ;.# define VdbeN
2390: 6f 6f 70 43 6f 6d 6d 65 6e 74 28 58 29 20 20 73  oopComment(X)  s
23a0: 71 6c 69 74 65 33 56 64 62 65 4e 6f 6f 70 43 6f  qlite3VdbeNoopCo
23b0: 6d 6d 65 6e 74 20 58 0a 23 65 6c 73 65 0a 23 20  mment X.#else.# 
23c0: 64 65 66 69 6e 65 20 56 64 62 65 43 6f 6d 6d 65  define VdbeComme
23d0: 6e 74 28 58 29 0a 23 20 64 65 66 69 6e 65 20 56  nt(X).# define V
23e0: 64 62 65 4e 6f 6f 70 43 6f 6d 6d 65 6e 74 28 58  dbeNoopComment(X
23f0: 29 0a 23 65 6e 64 69 66 0a 0a 23 65 6e 64 69 66  ).#endif..#endif
2400: 0a                                               .