Artifact 8f79f57c66ce1030f6371ff067b326d627a52c6d:
- File src/vdbe.h — part of check-in [f4d9089c] at 2000-06-06 21:56:08 on branch trunk — :-) (CVS 62) (user: drh size: 6198)
/* ** Copyright (c) 1999, 2000 D. Richard Hipp ** ** This program is free software; you can redistribute it and/or ** modify it under the terms of the GNU General Public ** License as published by the Free Software Foundation; either ** version 2 of the License, or (at your option) any later version. ** ** This program is distributed in the hope that it will be useful, ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU ** General Public License for more details. ** ** You should have received a copy of the GNU General Public ** License along with this library; if not, write to the ** Free Software Foundation, Inc., 59 Temple Place - Suite 330, ** Boston, MA 02111-1307, USA. ** ** Author contact information: ** drh@hwaci.com ** http://www.hwaci.com/drh/ ** ************************************************************************* ** Header file for the Virtual DataBase Engine (VDBE) ** ** This header defines the interface to the virtual database engine ** or VDBE. The VDBE implements an abstract machine that runs a ** simple program to access and modify the underlying database. ** ** $Id: vdbe.h,v 1.9 2000/06/06 21:56:08 drh Exp $ */ #ifndef _SQLITE_VDBE_H_ #define _SQLITE_VDBE_H_ #include <stdio.h> /* ** A single VDBE is an opaque structure named "Vdbe". Only routines ** in the source file sqliteVdbe.c are allowed to see the insides ** of this structure. */ typedef struct Vdbe Vdbe; /* ** A single instruction of the virtual machine has an opcode ** and as many as three operands. The instruction is recorded ** as an instance of the following structure: */ struct VdbeOp { int opcode; /* What operation to perform */ int p1; /* First operand */ int p2; /* Second parameter (often the jump destination) */ char *p3; /* Third parameter */ }; typedef struct VdbeOp VdbeOp; /* ** The following macro converts a relative address in the p2 field ** of a VdbeOp structure into a negative number so that ** sqliteVdbeAddOpList() knows that the address is relative. Calling ** the macro again restores the address. */ #define ADDR(X) (-1-(X)) /* ** These are the available opcodes. ** ** If any of the values changes or if opcodes are added or removed, ** be sure to also update the zOpName[] array in sqliteVdbe.c to ** mirror the change. ** ** The source tree contains an AWK script named renumberOps.awk that ** can be used to renumber these opcodes when new opcodes are inserted. */ #define OP_Open 1 #define OP_Close 2 #define OP_Fetch 3 #define OP_New 4 #define OP_Put 5 #define OP_Distinct 6 #define OP_Found 7 #define OP_NotFound 8 #define OP_Delete 9 #define OP_Field 10 #define OP_KeyAsData 11 #define OP_Key 12 #define OP_Rewind 13 #define OP_Next 14 #define OP_Destroy 15 #define OP_Reorganize 16 #define OP_ResetIdx 17 #define OP_NextIdx 18 #define OP_PutIdx 19 #define OP_DeleteIdx 20 #define OP_MemLoad 21 #define OP_MemStore 22 #define OP_ListOpen 23 #define OP_ListWrite 24 #define OP_ListRewind 25 #define OP_ListRead 26 #define OP_ListClose 27 #define OP_SortOpen 28 #define OP_SortPut 29 #define OP_SortMakeRec 30 #define OP_SortMakeKey 31 #define OP_Sort 32 #define OP_SortNext 33 #define OP_SortKey 34 #define OP_SortCallback 35 #define OP_SortClose 36 #define OP_FileOpen 37 #define OP_FileRead 38 #define OP_FileField 39 #define OP_FileClose 40 #define OP_AggReset 41 #define OP_AggFocus 42 #define OP_AggIncr 43 #define OP_AggNext 44 #define OP_AggSet 45 #define OP_AggGet 46 #define OP_SetInsert 47 #define OP_SetFound 48 #define OP_SetNotFound 49 #define OP_SetClear 50 #define OP_MakeRecord 51 #define OP_MakeKey 52 #define OP_Goto 53 #define OP_If 54 #define OP_Halt 55 #define OP_ColumnCount 56 #define OP_ColumnName 57 #define OP_Callback 58 #define OP_Integer 59 #define OP_String 60 #define OP_Null 61 #define OP_Pop 62 #define OP_Dup 63 #define OP_Pull 64 #define OP_Add 65 #define OP_AddImm 66 #define OP_Subtract 67 #define OP_Multiply 68 #define OP_Divide 69 #define OP_Min 70 #define OP_Max 71 #define OP_Like 72 #define OP_Glob 73 #define OP_Eq 74 #define OP_Ne 75 #define OP_Lt 76 #define OP_Le 77 #define OP_Gt 78 #define OP_Ge 79 #define OP_IsNull 80 #define OP_NotNull 81 #define OP_Negative 82 #define OP_And 83 #define OP_Or 84 #define OP_Not 85 #define OP_Concat 86 #define OP_Noop 87 #define OP_MAX 87 /* ** Prototypes for the VDBE interface. See comments on the implementation ** for a description of what each of these routines does. */ Vdbe *sqliteVdbeCreate(Dbbe*); int sqliteVdbeAddOp(Vdbe*,int,int,int,const char*,int); int sqliteVdbeAddOpList(Vdbe*, int nOp, VdbeOp const *aOp); void sqliteVdbeChangeP3(Vdbe*, int addr, const char *zP1, int N); void sqliteVdbeDequoteP3(Vdbe*, int addr); int sqliteVdbeMakeLabel(Vdbe*); void sqliteVdbeDelete(Vdbe*); int sqliteVdbeOpcode(const char *zName); int sqliteVdbeExec(Vdbe*,sqlite_callback,void*,char**); int sqliteVdbeList(Vdbe*,sqlite_callback,void*,char**); void sqliteVdbeResolveLabel(Vdbe*, int); int sqliteVdbeCurrentAddr(Vdbe*); void sqliteVdbeTrace(Vdbe*,FILE*); #endif