drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 1 | /* |
| 2 | ** 2003 September 6 |
| 3 | ** |
| 4 | ** The author disclaims copyright to this source code. In place of |
| 5 | ** a legal notice, here is a blessing: |
| 6 | ** |
| 7 | ** May you do good and not evil. |
| 8 | ** May you find forgiveness for yourself and forgive others. |
| 9 | ** May you share freely, never taking more than you give. |
| 10 | ** |
| 11 | ************************************************************************* |
| 12 | ** This is the header file for information that is private to the |
| 13 | ** VDBE. This information used to all be at the top of the single |
| 14 | ** source code file "vdbe.c". When that file became too big (over |
| 15 | ** 6000 lines long) it was split up into several smaller files and |
| 16 | ** this header information was factored out. |
| 17 | */ |
drh | 4e78be6 | 2007-01-26 21:08:04 +0000 | [diff] [blame] | 18 | #ifndef _VDBEINT_H_ |
| 19 | #define _VDBEINT_H_ |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 20 | |
| 21 | /* |
drh | 6062531 | 2013-04-06 18:06:51 +0000 | [diff] [blame] | 22 | ** The maximum number of times that a statement will try to reparse |
| 23 | ** itself before giving up and returning SQLITE_SCHEMA. |
| 24 | */ |
| 25 | #ifndef SQLITE_MAX_SCHEMA_RETRY |
| 26 | # define SQLITE_MAX_SCHEMA_RETRY 50 |
| 27 | #endif |
| 28 | |
| 29 | /* |
drh | f7e3690 | 2015-08-13 21:32:41 +0000 | [diff] [blame] | 30 | ** VDBE_DISPLAY_P4 is true or false depending on whether or not the |
| 31 | ** "explain" P4 display logic is enabled. |
| 32 | */ |
| 33 | #if !defined(SQLITE_OMIT_EXPLAIN) || !defined(NDEBUG) \ |
| 34 | || defined(VDBE_PROFILE) || defined(SQLITE_DEBUG) |
| 35 | # define VDBE_DISPLAY_P4 1 |
| 36 | #else |
| 37 | # define VDBE_DISPLAY_P4 0 |
| 38 | #endif |
| 39 | |
| 40 | /* |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 41 | ** SQL is translated into a sequence of instructions to be |
| 42 | ** executed by a virtual machine. Each instruction is an instance |
| 43 | ** of the following structure. |
| 44 | */ |
| 45 | typedef struct VdbeOp Op; |
| 46 | |
| 47 | /* |
| 48 | ** Boolean values |
| 49 | */ |
drh | 14da87f | 2013-11-20 21:51:33 +0000 | [diff] [blame] | 50 | typedef unsigned Bool; |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 51 | |
dan | a20fde6 | 2011-07-12 14:28:05 +0000 | [diff] [blame] | 52 | /* Opaque type used by code in vdbesort.c */ |
| 53 | typedef struct VdbeSorter VdbeSorter; |
| 54 | |
drh | 7e02e5e | 2011-12-06 19:44:51 +0000 | [diff] [blame] | 55 | /* Opaque type used by the explainer */ |
| 56 | typedef struct Explain Explain; |
| 57 | |
dan | 0c54779 | 2013-07-18 17:12:08 +0000 | [diff] [blame] | 58 | /* Elements of the linked list at Vdbe.pAuxData */ |
| 59 | typedef struct AuxData AuxData; |
| 60 | |
drh | c960dcb | 2015-11-20 19:22:01 +0000 | [diff] [blame] | 61 | /* Types of VDBE cursors */ |
| 62 | #define CURTYPE_BTREE 0 |
| 63 | #define CURTYPE_SORTER 1 |
| 64 | #define CURTYPE_VTAB 2 |
| 65 | #define CURTYPE_PSEUDO 3 |
| 66 | |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 67 | /* |
drh | c960dcb | 2015-11-20 19:22:01 +0000 | [diff] [blame] | 68 | ** A VdbeCursor is an superclass (a wrapper) for various cursor objects: |
drh | 5cc1023 | 2013-11-21 01:04:02 +0000 | [diff] [blame] | 69 | ** |
drh | c960dcb | 2015-11-20 19:22:01 +0000 | [diff] [blame] | 70 | ** * A b-tree cursor |
| 71 | ** - In the main database or in an ephemeral database |
| 72 | ** - On either an index or a table |
| 73 | ** * A sorter |
| 74 | ** * A virtual table |
| 75 | ** * A one-row "pseudotable" stored in a single register |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 76 | */ |
dan | de892d9 | 2016-01-29 19:29:45 +0000 | [diff] [blame] | 77 | typedef struct VdbeCursor VdbeCursor; |
drh | dfe88ec | 2008-11-03 20:55:06 +0000 | [diff] [blame] | 78 | struct VdbeCursor { |
drh | c960dcb | 2015-11-20 19:22:01 +0000 | [diff] [blame] | 79 | u8 eCurType; /* One of the CURTYPE_* values above */ |
drh | 79353db | 2013-11-20 02:53:58 +0000 | [diff] [blame] | 80 | i8 iDb; /* Index of cursor database in db->aDb[] (or -1) */ |
drh | 1fd522f | 2013-11-21 00:10:35 +0000 | [diff] [blame] | 81 | u8 nullRow; /* True if pointing to a row with no data */ |
drh | 1fd522f | 2013-11-21 00:10:35 +0000 | [diff] [blame] | 82 | u8 deferredMoveto; /* A call to sqlite3BtreeMoveto() is needed */ |
drh | c960dcb | 2015-11-20 19:22:01 +0000 | [diff] [blame] | 83 | u8 isTable; /* True for rowid tables. False for indexes */ |
| 84 | #ifdef SQLITE_DEBUG |
| 85 | u8 seekOp; /* Most recent seek operation on this cursor */ |
drh | b89aeb6 | 2016-01-27 15:49:32 +0000 | [diff] [blame] | 86 | u8 wrFlag; /* The wrFlag argument to sqlite3BtreeCursor() */ |
drh | c960dcb | 2015-11-20 19:22:01 +0000 | [diff] [blame] | 87 | #endif |
drh | 079a307 | 2014-03-19 14:10:55 +0000 | [diff] [blame] | 88 | Bool isEphemeral:1; /* True for an ephemeral table */ |
drh | 14da87f | 2013-11-20 21:51:33 +0000 | [diff] [blame] | 89 | Bool useRandomRowid:1;/* Generate new record numbers semi-randomly */ |
drh | 26bcc7c | 2016-02-26 04:13:39 +0000 | [diff] [blame] | 90 | Bool isOrdered:1; /* True if the table is not BTREE_UNORDERED */ |
drh | 3526319 | 2014-07-22 20:02:19 +0000 | [diff] [blame] | 91 | Pgno pgnoRoot; /* Root page of the open btree cursor */ |
drh | c960dcb | 2015-11-20 19:22:01 +0000 | [diff] [blame] | 92 | i16 nField; /* Number of fields in the header */ |
| 93 | u16 nHdrParsed; /* Number of header fields parsed so far */ |
| 94 | union { |
| 95 | BtCursor *pCursor; /* CURTYPE_BTREE. Btree cursor */ |
| 96 | sqlite3_vtab_cursor *pVCur; /* CURTYPE_VTAB. Vtab cursor */ |
| 97 | int pseudoTableReg; /* CURTYPE_PSEUDO. Reg holding content. */ |
| 98 | VdbeSorter *pSorter; /* CURTYPE_SORTER. Sorter object */ |
| 99 | } uc; |
| 100 | Btree *pBt; /* Separate file holding temporary table */ |
| 101 | KeyInfo *pKeyInfo; /* Info about index keys needed by index cursors */ |
| 102 | int seekResult; /* Result of previous sqlite3BtreeMoveto() */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 103 | i64 seqCount; /* Sequence counter */ |
| 104 | i64 movetoTarget; /* Argument to the deferred sqlite3BtreeMoveto() */ |
drh | 945d302 | 2016-01-29 20:58:40 +0000 | [diff] [blame] | 105 | VdbeCursor *pAltCursor; /* Associated index cursor from which to read */ |
| 106 | int *aAltMap; /* Mapping from table to index column numbers */ |
drh | 97bae79 | 2015-06-05 15:59:57 +0000 | [diff] [blame] | 107 | #ifdef SQLITE_ENABLE_COLUMN_USED_MASK |
| 108 | u64 maskUsed; /* Mask of columns used by this cursor */ |
| 109 | #endif |
drh | 9188b38 | 2004-05-14 21:12:22 +0000 | [diff] [blame] | 110 | |
| 111 | /* Cached information about the header for the data record that the |
drh | 3e9ca09 | 2009-09-08 01:14:48 +0000 | [diff] [blame] | 112 | ** cursor is currently pointing to. Only valid if cacheStatus matches |
| 113 | ** Vdbe.cacheCtr. Vdbe.cacheCtr will never take on the value of |
| 114 | ** CACHE_STALE and so setting cacheStatus=CACHE_STALE guarantees that |
| 115 | ** the cache is out of date. |
| 116 | ** |
drh | 76873ab | 2006-01-07 18:48:26 +0000 | [diff] [blame] | 117 | ** aRow might point to (ephemeral) data for the current row, or it might |
| 118 | ** be NULL. |
| 119 | */ |
drh | 3e9ca09 | 2009-09-08 01:14:48 +0000 | [diff] [blame] | 120 | u32 cacheStatus; /* Cache is valid if this matches Vdbe.cacheCtr */ |
drh | 399af1d | 2013-11-20 17:25:55 +0000 | [diff] [blame] | 121 | u32 payloadSize; /* Total number of bytes in the record */ |
drh | 399af1d | 2013-11-20 17:25:55 +0000 | [diff] [blame] | 122 | u32 szRow; /* Byte available in aRow */ |
| 123 | u32 iHdrOffset; /* Offset to next unparsed byte of the header */ |
drh | 399af1d | 2013-11-20 17:25:55 +0000 | [diff] [blame] | 124 | const u8 *aRow; /* Data for the current row, if all on one page */ |
drh | b53a5a9 | 2014-10-12 22:37:22 +0000 | [diff] [blame] | 125 | u32 *aOffset; /* Pointer to aType[nField] */ |
drh | 5cc1023 | 2013-11-21 01:04:02 +0000 | [diff] [blame] | 126 | u32 aType[1]; /* Type values for all entries in the record */ |
| 127 | /* 2*nField extra array elements allocated for aType[], beyond the one |
| 128 | ** static element declared in the structure. nField total array slots for |
| 129 | ** aType[] and nField+1 array slots for aOffset[] */ |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 130 | }; |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 131 | |
dan | 65a7cd1 | 2009-09-01 12:16:01 +0000 | [diff] [blame] | 132 | /* |
| 133 | ** When a sub-program is executed (OP_Program), a structure of this type |
| 134 | ** is allocated to store the current value of the program counter, as |
| 135 | ** well as the current memory cell array and various other frame specific |
| 136 | ** values stored in the Vdbe struct. When the sub-program is finished, |
| 137 | ** these values are copied back to the Vdbe from the VdbeFrame structure, |
| 138 | ** restoring the state of the VM to as it was before the sub-program |
| 139 | ** began executing. |
| 140 | ** |
dan | 2710657 | 2010-12-01 08:04:47 +0000 | [diff] [blame] | 141 | ** The memory for a VdbeFrame object is allocated and managed by a memory |
| 142 | ** cell in the parent (calling) frame. When the memory cell is deleted or |
| 143 | ** overwritten, the VdbeFrame object is not freed immediately. Instead, it |
| 144 | ** is linked into the Vdbe.pDelFrame list. The contents of the Vdbe.pDelFrame |
| 145 | ** list is deleted when the VM is reset in VdbeHalt(). The reason for doing |
| 146 | ** this instead of deleting the VdbeFrame immediately is to avoid recursive |
| 147 | ** calls to sqlite3VdbeMemRelease() when the memory cells belonging to the |
| 148 | ** child frame are released. |
| 149 | ** |
| 150 | ** The currently executing frame is stored in Vdbe.pFrame. Vdbe.pFrame is |
| 151 | ** set to NULL if the currently executing frame is the main program. |
dan | 65a7cd1 | 2009-09-01 12:16:01 +0000 | [diff] [blame] | 152 | */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 153 | typedef struct VdbeFrame VdbeFrame; |
| 154 | struct VdbeFrame { |
| 155 | Vdbe *v; /* VM this frame belongs to */ |
drh | 3fb757b | 2012-02-02 21:02:43 +0000 | [diff] [blame] | 156 | VdbeFrame *pParent; /* Parent of this frame, or NULL if parent is main */ |
dan | 2710657 | 2010-12-01 08:04:47 +0000 | [diff] [blame] | 157 | Op *aOp; /* Program instructions for parent frame */ |
dan | 43764a8 | 2014-11-01 21:00:04 +0000 | [diff] [blame] | 158 | i64 *anExec; /* Event counters from parent frame */ |
dan | 2710657 | 2010-12-01 08:04:47 +0000 | [diff] [blame] | 159 | Mem *aMem; /* Array of memory cells for parent frame */ |
dan | 1d8cb21 | 2011-12-09 13:24:16 +0000 | [diff] [blame] | 160 | u8 *aOnceFlag; /* Array of OP_Once flags for parent frame */ |
dan | 2710657 | 2010-12-01 08:04:47 +0000 | [diff] [blame] | 161 | VdbeCursor **apCsr; /* Array of Vdbe cursors for parent frame */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 162 | void *token; /* Copy of SubProgram.token */ |
drh | 3fb757b | 2012-02-02 21:02:43 +0000 | [diff] [blame] | 163 | i64 lastRowid; /* Last insert rowid (sqlite3.lastRowid) */ |
dan | 3200132 | 2016-02-19 18:54:29 +0000 | [diff] [blame] | 164 | AuxData *pAuxData; /* Linked list of auxdata allocations */ |
drh | 928d9c6 | 2013-02-07 09:33:56 +0000 | [diff] [blame] | 165 | int nCursor; /* Number of entries in apCsr */ |
drh | 3fb757b | 2012-02-02 21:02:43 +0000 | [diff] [blame] | 166 | int pc; /* Program Counter in parent (calling) frame */ |
| 167 | int nOp; /* Size of aOp array */ |
| 168 | int nMem; /* Number of entries in aMem */ |
| 169 | int nOnceFlag; /* Number of entries in aOnceFlag */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 170 | int nChildMem; /* Number of memory cells for child frame */ |
| 171 | int nChildCsr; /* Number of cursors for child frame */ |
dan | c3da667 | 2014-10-28 18:24:16 +0000 | [diff] [blame] | 172 | int nChange; /* Statement changes (Vdbe.nChange) */ |
| 173 | int nDbChange; /* Value of db->nChange */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 174 | }; |
| 175 | |
| 176 | #define VdbeFrameMem(p) ((Mem *)&((u8 *)p)[ROUND8(sizeof(VdbeFrame))]) |
| 177 | |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 178 | /* |
drh | dfe88ec | 2008-11-03 20:55:06 +0000 | [diff] [blame] | 179 | ** A value for VdbeCursor.cacheValid that means the cache is always invalid. |
drh | 76873ab | 2006-01-07 18:48:26 +0000 | [diff] [blame] | 180 | */ |
| 181 | #define CACHE_STALE 0 |
| 182 | |
| 183 | /* |
danielk1977 | 7e18c25 | 2004-05-25 11:47:24 +0000 | [diff] [blame] | 184 | ** Internally, the vdbe manipulates nearly all SQL values as Mem |
| 185 | ** structures. Each Mem struct may cache multiple representations (string, |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 186 | ** integer etc.) of the same value. |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 187 | */ |
| 188 | struct Mem { |
drh | 74eaba4 | 2014-09-18 17:52:15 +0000 | [diff] [blame] | 189 | union MemValue { |
mistachkin | 26c79a0 | 2014-09-18 18:55:47 +0000 | [diff] [blame] | 190 | double r; /* Real value used when MEM_Real is set in flags */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 191 | i64 i; /* Integer value used when MEM_Int is set in flags */ |
drh | 8df3284 | 2008-12-09 02:51:23 +0000 | [diff] [blame] | 192 | int nZero; /* Used when bit MEM_Zero is set in flags */ |
drh | 3c024d6 | 2007-03-30 11:23:45 +0000 | [diff] [blame] | 193 | FuncDef *pDef; /* Used only when flags==MEM_Agg */ |
drh | 3d4501e | 2008-12-04 20:40:10 +0000 | [diff] [blame] | 194 | RowSet *pRowSet; /* Used only when flags==MEM_RowSet */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 195 | VdbeFrame *pFrame; /* Used when flags==MEM_Frame */ |
drh | 3c024d6 | 2007-03-30 11:23:45 +0000 | [diff] [blame] | 196 | } u; |
drh | 69174eb | 2004-05-26 23:43:11 +0000 | [diff] [blame] | 197 | u16 flags; /* Some combination of MEM_Null, MEM_Str, MEM_Dyn, etc. */ |
drh | fdf972a | 2007-05-02 13:30:27 +0000 | [diff] [blame] | 198 | u8 enc; /* SQLITE_UTF8, SQLITE_UTF16BE, SQLITE_UTF16LE */ |
drh | bcdf78a | 2015-09-10 20:34:56 +0000 | [diff] [blame] | 199 | u8 eSubtype; /* Subtype for this value */ |
drh | 035e563 | 2014-09-16 14:16:31 +0000 | [diff] [blame] | 200 | int n; /* Number of characters in string value, excluding '\0' */ |
drh | 035e563 | 2014-09-16 14:16:31 +0000 | [diff] [blame] | 201 | char *z; /* String or BLOB value */ |
drh | 035e563 | 2014-09-16 14:16:31 +0000 | [diff] [blame] | 202 | /* ShallowCopy only needs to copy the information above */ |
drh | 17bcb10 | 2014-09-18 21:25:33 +0000 | [diff] [blame] | 203 | char *zMalloc; /* Space to hold MEM_Str or MEM_Blob if szMalloc>0 */ |
| 204 | int szMalloc; /* Size of the zMalloc allocation */ |
drh | facf47a | 2014-10-13 20:12:47 +0000 | [diff] [blame] | 205 | u32 uTemp; /* Transient storage for serial_type in OP_MakeRecord */ |
drh | 035e563 | 2014-09-16 14:16:31 +0000 | [diff] [blame] | 206 | sqlite3 *db; /* The associated database connection */ |
drh | d3b7420 | 2014-09-17 16:41:15 +0000 | [diff] [blame] | 207 | void (*xDel)(void*);/* Destructor for Mem.z - only valid if MEM_Dyn */ |
drh | 2b4ded9 | 2010-09-27 21:09:31 +0000 | [diff] [blame] | 208 | #ifdef SQLITE_DEBUG |
| 209 | Mem *pScopyFrom; /* This Mem is a shallow copy of pScopyFrom */ |
| 210 | void *pFiller; /* So that sizeof(Mem) is a multiple of 8 */ |
| 211 | #endif |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 212 | }; |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 213 | |
drh | 4f03f41 | 2015-05-20 21:28:32 +0000 | [diff] [blame] | 214 | /* |
| 215 | ** Size of struct Mem not including the Mem.zMalloc member or anything that |
| 216 | ** follows. |
| 217 | */ |
| 218 | #define MEMCELLSIZE offsetof(Mem,zMalloc) |
| 219 | |
drh | 69174eb | 2004-05-26 23:43:11 +0000 | [diff] [blame] | 220 | /* One or more of the following flags are set to indicate the validOK |
danielk1977 | b77f5da | 2004-05-26 13:27:00 +0000 | [diff] [blame] | 221 | ** representations of the value stored in the Mem struct. |
drh | 3dc0b8e | 2004-05-10 12:07:10 +0000 | [diff] [blame] | 222 | ** |
danielk1977 | b77f5da | 2004-05-26 13:27:00 +0000 | [diff] [blame] | 223 | ** If the MEM_Null flag is set, then the value is an SQL NULL value. |
| 224 | ** No other flags may be set in this case. |
drh | 3dc0b8e | 2004-05-10 12:07:10 +0000 | [diff] [blame] | 225 | ** |
danielk1977 | b77f5da | 2004-05-26 13:27:00 +0000 | [diff] [blame] | 226 | ** If the MEM_Str flag is set then Mem.z points at a string representation. |
| 227 | ** Usually this is encoded in the same unicode encoding as the main |
| 228 | ** database (see below for exceptions). If the MEM_Term flag is also |
| 229 | ** set, then the string is nul terminated. The MEM_Int and MEM_Real |
| 230 | ** flags may coexist with the MEM_Str flag. |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 231 | */ |
drh | 00706be | 2004-01-30 14:49:16 +0000 | [diff] [blame] | 232 | #define MEM_Null 0x0001 /* Value is NULL */ |
| 233 | #define MEM_Str 0x0002 /* Value is a string */ |
| 234 | #define MEM_Int 0x0004 /* Value is an integer */ |
| 235 | #define MEM_Real 0x0008 /* Value is a real number */ |
drh | 3dc0b8e | 2004-05-10 12:07:10 +0000 | [diff] [blame] | 236 | #define MEM_Blob 0x0010 /* Value is a BLOB */ |
mistachkin | afc14f7 | 2014-03-05 01:29:18 +0000 | [diff] [blame] | 237 | #define MEM_AffMask 0x001f /* Mask of affinity bits */ |
drh | 3d4501e | 2008-12-04 20:40:10 +0000 | [diff] [blame] | 238 | #define MEM_RowSet 0x0020 /* Value is a RowSet object */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 239 | #define MEM_Frame 0x0040 /* Value is a VdbeFrame object */ |
drh | a5750cf | 2014-02-07 13:20:31 +0000 | [diff] [blame] | 240 | #define MEM_Undefined 0x0080 /* Value is undefined */ |
drh | 053a128 | 2012-09-19 21:15:46 +0000 | [diff] [blame] | 241 | #define MEM_Cleared 0x0100 /* NULL set by OP_Null, not from data */ |
dan | 5b6c8e4 | 2016-01-30 15:46:03 +0000 | [diff] [blame] | 242 | #define MEM_TypeMask 0x81ff /* Mask of type bits */ |
drh | 053a128 | 2012-09-19 21:15:46 +0000 | [diff] [blame] | 243 | |
danielk1977 | a7a8e14 | 2008-02-13 18:25:27 +0000 | [diff] [blame] | 244 | |
danielk1977 | b77f5da | 2004-05-26 13:27:00 +0000 | [diff] [blame] | 245 | /* Whenever Mem contains a valid string or blob representation, one of |
| 246 | ** the following flags must be set to determine the memory management |
drh | 69174eb | 2004-05-26 23:43:11 +0000 | [diff] [blame] | 247 | ** policy for Mem.z. The MEM_Term flag tells us whether or not the |
| 248 | ** string is \000 or \u0000 terminated |
danielk1977 | b77f5da | 2004-05-26 13:27:00 +0000 | [diff] [blame] | 249 | */ |
drh | 3d4501e | 2008-12-04 20:40:10 +0000 | [diff] [blame] | 250 | #define MEM_Term 0x0200 /* String rep is nul terminated */ |
drh | c91b2fd | 2014-03-01 18:13:23 +0000 | [diff] [blame] | 251 | #define MEM_Dyn 0x0400 /* Need to call Mem.xDel() on Mem.z */ |
drh | 3d4501e | 2008-12-04 20:40:10 +0000 | [diff] [blame] | 252 | #define MEM_Static 0x0800 /* Mem.z points to a static string */ |
| 253 | #define MEM_Ephem 0x1000 /* Mem.z points to an ephemeral string */ |
| 254 | #define MEM_Agg 0x2000 /* Mem.z points to an agg function context */ |
| 255 | #define MEM_Zero 0x4000 /* Mem.i contains count of 0s appended to blob */ |
dan | 5b6c8e4 | 2016-01-30 15:46:03 +0000 | [diff] [blame] | 256 | #define MEM_Subtype 0x8000 /* Mem.eSubtype is valid */ |
danielk1977 | 246ad31 | 2007-05-16 14:23:00 +0000 | [diff] [blame] | 257 | #ifdef SQLITE_OMIT_INCRBLOB |
| 258 | #undef MEM_Zero |
| 259 | #define MEM_Zero 0x0000 |
| 260 | #endif |
| 261 | |
dan | 5b6c8e4 | 2016-01-30 15:46:03 +0000 | [diff] [blame] | 262 | /* Return TRUE if Mem X contains dynamically allocated content - anything |
| 263 | ** that needs to be deallocated to avoid a leak. |
| 264 | */ |
| 265 | #define VdbeMemDynamic(X) \ |
| 266 | (((X)->flags&(MEM_Agg|MEM_Dyn|MEM_RowSet|MEM_Frame))!=0) |
| 267 | |
drh | 3d4501e | 2008-12-04 20:40:10 +0000 | [diff] [blame] | 268 | /* |
| 269 | ** Clear any existing type flags from a Mem and replace them with f |
| 270 | */ |
drh | 68ac65e | 2009-01-05 18:02:27 +0000 | [diff] [blame] | 271 | #define MemSetTypeFlag(p, f) \ |
| 272 | ((p)->flags = ((p)->flags&~(MEM_TypeMask|MEM_Zero))|f) |
drh | 3d4501e | 2008-12-04 20:40:10 +0000 | [diff] [blame] | 273 | |
drh | 2b4ded9 | 2010-09-27 21:09:31 +0000 | [diff] [blame] | 274 | /* |
| 275 | ** Return true if a memory cell is not marked as invalid. This macro |
| 276 | ** is for use inside assert() statements only. |
| 277 | */ |
| 278 | #ifdef SQLITE_DEBUG |
drh | a5750cf | 2014-02-07 13:20:31 +0000 | [diff] [blame] | 279 | #define memIsValid(M) ((M)->flags & MEM_Undefined)==0 |
drh | 2b4ded9 | 2010-09-27 21:09:31 +0000 | [diff] [blame] | 280 | #endif |
| 281 | |
dan | 0c54779 | 2013-07-18 17:12:08 +0000 | [diff] [blame] | 282 | /* |
peter.d.reid | 60ec914 | 2014-09-06 16:39:46 +0000 | [diff] [blame] | 283 | ** Each auxiliary data pointer stored by a user defined function |
dan | 0c54779 | 2013-07-18 17:12:08 +0000 | [diff] [blame] | 284 | ** implementation calling sqlite3_set_auxdata() is stored in an instance |
| 285 | ** of this structure. All such structures associated with a single VM |
| 286 | ** are stored in a linked list headed at Vdbe.pAuxData. All are destroyed |
| 287 | ** when the VM is halted (if not before). |
drh | 998da3a | 2004-06-19 15:22:56 +0000 | [diff] [blame] | 288 | */ |
dan | 0c54779 | 2013-07-18 17:12:08 +0000 | [diff] [blame] | 289 | struct AuxData { |
| 290 | int iOp; /* Instruction number of OP_Function opcode */ |
| 291 | int iArg; /* Index of function argument. */ |
| 292 | void *pAux; /* Aux data pointer */ |
| 293 | void (*xDelete)(void *); /* Destructor for the aux data */ |
| 294 | AuxData *pNext; /* Next element in list */ |
danielk1977 | 682f68b | 2004-06-05 10:22:17 +0000 | [diff] [blame] | 295 | }; |
danielk1977 | 682f68b | 2004-06-05 10:22:17 +0000 | [diff] [blame] | 296 | |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 297 | /* |
peter.d.reid | 60ec914 | 2014-09-06 16:39:46 +0000 | [diff] [blame] | 298 | ** The "context" argument for an installable function. A pointer to an |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 299 | ** instance of this structure is the first argument to the routines used |
| 300 | ** implement the SQL functions. |
| 301 | ** |
| 302 | ** There is a typedef for this structure in sqlite.h. So all routines, |
| 303 | ** even the public interface to SQLite, can use a pointer to this structure. |
| 304 | ** But this file is the only place where the internal details of this |
| 305 | ** structure are known. |
| 306 | ** |
drh | abfcea2 | 2005-09-06 20:36:48 +0000 | [diff] [blame] | 307 | ** This structure is defined inside of vdbeInt.h because it uses substructures |
drh | 00706be | 2004-01-30 14:49:16 +0000 | [diff] [blame] | 308 | ** (Mem) which are only defined there. |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 309 | */ |
danielk1977 | 0ae8b83 | 2004-05-25 12:05:56 +0000 | [diff] [blame] | 310 | struct sqlite3_context { |
drh | 9c7c913 | 2015-06-26 18:16:52 +0000 | [diff] [blame] | 311 | Mem *pOut; /* The return value is stored here */ |
| 312 | FuncDef *pFunc; /* Pointer to function information */ |
| 313 | Mem *pMem; /* Memory cell used to store aggregate context */ |
| 314 | Vdbe *pVdbe; /* The VM that owns this context */ |
| 315 | int iOp; /* Instruction number of OP_Function */ |
| 316 | int isError; /* Error code returned by the function. */ |
| 317 | u8 skipFlag; /* Skip accumulator loading if true */ |
| 318 | u8 fErrorOrAux; /* isError!=0 or pVdbe->pAuxData modified */ |
| 319 | u8 argc; /* Number of arguments */ |
| 320 | sqlite3_value *argv[1]; /* Argument set */ |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 321 | }; |
| 322 | |
| 323 | /* |
drh | 7e02e5e | 2011-12-06 19:44:51 +0000 | [diff] [blame] | 324 | ** An Explain object accumulates indented output which is helpful |
| 325 | ** in describing recursive data structures. |
| 326 | */ |
| 327 | struct Explain { |
| 328 | Vdbe *pVdbe; /* Attach the explanation to this Vdbe */ |
| 329 | StrAccum str; /* The string being accumulated */ |
| 330 | int nIndent; /* Number of elements in aIndent */ |
| 331 | u16 aIndent[100]; /* Levels of indentation */ |
| 332 | char zBase[100]; /* Initial space */ |
| 333 | }; |
| 334 | |
drh | 37f58e9 | 2012-09-04 21:34:26 +0000 | [diff] [blame] | 335 | /* A bitfield type for use inside of structures. Always follow with :N where |
| 336 | ** N is the number of bits. |
| 337 | */ |
| 338 | typedef unsigned bft; /* Bit Field Type */ |
| 339 | |
dan | 037b532 | 2014-11-03 11:25:32 +0000 | [diff] [blame] | 340 | typedef struct ScanStatus ScanStatus; |
| 341 | struct ScanStatus { |
dan | 6f9702e | 2014-11-01 20:38:06 +0000 | [diff] [blame] | 342 | int addrExplain; /* OP_Explain for loop */ |
| 343 | int addrLoop; /* Address of "loops" counter */ |
| 344 | int addrVisit; /* Address of "rows visited" counter */ |
drh | c6652b1 | 2014-11-06 04:42:20 +0000 | [diff] [blame] | 345 | int iSelectID; /* The "Select-ID" for this loop */ |
drh | 518140e | 2014-11-06 03:55:10 +0000 | [diff] [blame] | 346 | LogEst nEst; /* Estimated output rows per loop */ |
dan | 6f9702e | 2014-11-01 20:38:06 +0000 | [diff] [blame] | 347 | char *zName; /* Name of table or index */ |
| 348 | }; |
| 349 | |
drh | 7e02e5e | 2011-12-06 19:44:51 +0000 | [diff] [blame] | 350 | /* |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 351 | ** An instance of the virtual machine. This structure contains the complete |
| 352 | ** state of the virtual machine. |
| 353 | ** |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 354 | ** The "sqlite3_stmt" structure pointer that is returned by sqlite3_prepare() |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 355 | ** is really a pointer to an instance of this structure. |
| 356 | */ |
| 357 | struct Vdbe { |
drh | 8bfdf72 | 2009-06-19 14:06:03 +0000 | [diff] [blame] | 358 | sqlite3 *db; /* The database connection that owns this statement */ |
drh | 8bfdf72 | 2009-06-19 14:06:03 +0000 | [diff] [blame] | 359 | Op *aOp; /* Space to hold the virtual machine's program */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 360 | Mem *aMem; /* The memory locations */ |
drh | 8bfdf72 | 2009-06-19 14:06:03 +0000 | [diff] [blame] | 361 | Mem **apArg; /* Arguments to currently executing user function */ |
| 362 | Mem *aColName; /* Column names to return */ |
| 363 | Mem *pResultSet; /* Pointer to an array of results */ |
drh | 9ac7962 | 2013-12-18 15:11:47 +0000 | [diff] [blame] | 364 | Parse *pParse; /* Parsing context used to create this Vdbe */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 365 | int nMem; /* Number of memory locations currently allocated */ |
| 366 | int nOp; /* Number of instructions in the program */ |
drh | 928d9c6 | 2013-02-07 09:33:56 +0000 | [diff] [blame] | 367 | int nCursor; /* Number of slots in apCsr[] */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 368 | u32 magic; /* Magic number for sanity checking */ |
| 369 | char *zErrMsg; /* Error message written here */ |
| 370 | Vdbe *pPrev,*pNext; /* Linked list of VDBEs with the same Vdbe.db */ |
drh | 8bfdf72 | 2009-06-19 14:06:03 +0000 | [diff] [blame] | 371 | VdbeCursor **apCsr; /* One element of this array for each open cursor */ |
drh | 8bfdf72 | 2009-06-19 14:06:03 +0000 | [diff] [blame] | 372 | Mem *aVar; /* Values for the OP_Variable opcode. */ |
| 373 | char **azVar; /* Name of variables */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 374 | ynVar nVar; /* Number of entries in aVar[] */ |
drh | 124c0b4 | 2011-06-01 18:15:55 +0000 | [diff] [blame] | 375 | ynVar nzVar; /* Number of entries in azVar[] */ |
drh | 3e9ca09 | 2009-09-08 01:14:48 +0000 | [diff] [blame] | 376 | u32 cacheCtr; /* VdbeCursor row cache generation counter */ |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 377 | int pc; /* The program counter */ |
| 378 | int rc; /* Value to return */ |
drh | 983b5ee | 2015-02-13 12:05:56 +0000 | [diff] [blame] | 379 | #ifdef SQLITE_DEBUG |
| 380 | int rcApp; /* errcode set by sqlite3_result_error_code() */ |
| 381 | #endif |
drh | 73d5b8f | 2013-12-23 19:09:07 +0000 | [diff] [blame] | 382 | u16 nResColumn; /* Number of columns in one row of the result set */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 383 | u8 errorAction; /* Recovery action to do in case of an error */ |
drh | d946db0 | 2005-12-29 19:23:06 +0000 | [diff] [blame] | 384 | u8 minWriteFileFormat; /* Minimum file format for writable database files */ |
drh | 37f58e9 | 2012-09-04 21:34:26 +0000 | [diff] [blame] | 385 | bft explain:2; /* True if EXPLAIN present on SQL command */ |
drh | 37f58e9 | 2012-09-04 21:34:26 +0000 | [diff] [blame] | 386 | bft changeCntOn:1; /* True to update the change-counter */ |
| 387 | bft expired:1; /* True if the VM needs to be recompiled */ |
| 388 | bft runOnlyOnce:1; /* Automatically expire on reset */ |
| 389 | bft usesStmtJournal:1; /* True if uses a statement journal */ |
drh | 9e92a47 | 2013-06-27 17:40:30 +0000 | [diff] [blame] | 390 | bft readOnly:1; /* True for statements that do not write */ |
drh | 1713afb | 2013-06-28 01:24:57 +0000 | [diff] [blame] | 391 | bft bIsReader:1; /* True for statements that read */ |
drh | 37f58e9 | 2012-09-04 21:34:26 +0000 | [diff] [blame] | 392 | bft isPrepareV2:1; /* True if prepared with prepare_v2() */ |
| 393 | bft doingRerun:1; /* True if rerunning after an auto-reprepare */ |
drh | 91b48aa | 2004-06-30 11:14:18 +0000 | [diff] [blame] | 394 | int nChange; /* Number of db changes made since last reset */ |
drh | 6412358 | 2011-04-02 20:01:02 +0000 | [diff] [blame] | 395 | yDbMask btreeMask; /* Bitmask of db->aDb[] entries referenced */ |
drh | dc5b047 | 2011-04-06 22:05:53 +0000 | [diff] [blame] | 396 | yDbMask lockMask; /* Subset of btreeMask that requires a lock */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 397 | int iStatement; /* Statement number (or 0 if has not opened stmt) */ |
drh | 9b47ee3 | 2013-08-20 03:13:51 +0000 | [diff] [blame] | 398 | u32 aCounter[5]; /* Counters used by sqlite3_stmt_status() */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 399 | #ifndef SQLITE_OMIT_TRACE |
| 400 | i64 startTime; /* Time when query started - used for profiling */ |
| 401 | #endif |
drh | 95a7b3e | 2013-09-16 12:57:19 +0000 | [diff] [blame] | 402 | i64 iCurrentTime; /* Value of julianday('now') for this statement */ |
dan | 32b09f2 | 2009-09-23 17:29:59 +0000 | [diff] [blame] | 403 | i64 nFkConstraint; /* Number of imm. FK constraints this VM */ |
dan | 1da40a3 | 2009-09-19 17:00:31 +0000 | [diff] [blame] | 404 | i64 nStmtDefCons; /* Number of def. constraints when stmt started */ |
drh | 648e264 | 2013-07-11 15:03:32 +0000 | [diff] [blame] | 405 | i64 nStmtDefImmCons; /* Number of def. imm constraints when stmt started */ |
drh | 2e5de2f | 2011-01-07 02:50:40 +0000 | [diff] [blame] | 406 | char *zSql; /* Text of the SQL statement that generated this */ |
| 407 | void *pFree; /* Free this when deleting the vdbe */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 408 | VdbeFrame *pFrame; /* Parent frame */ |
dan | 2710657 | 2010-12-01 08:04:47 +0000 | [diff] [blame] | 409 | VdbeFrame *pDelFrame; /* List of frame objects to free on VM reset */ |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 410 | int nFrame; /* Number of frames in pFrame list */ |
dan | 937d0de | 2009-10-15 18:35:38 +0000 | [diff] [blame] | 411 | u32 expmask; /* Binding to these vars invalidates VM */ |
dan | d19c933 | 2010-07-26 12:05:17 +0000 | [diff] [blame] | 412 | SubProgram *pProgram; /* Linked list of all sub-programs used by VM */ |
dan | 1d8cb21 | 2011-12-09 13:24:16 +0000 | [diff] [blame] | 413 | int nOnceFlag; /* Size of array aOnceFlag[] */ |
| 414 | u8 *aOnceFlag; /* Flags for OP_Once */ |
dan | 0c54779 | 2013-07-18 17:12:08 +0000 | [diff] [blame] | 415 | AuxData *pAuxData; /* Linked list of auxdata allocations */ |
dan | 6f9702e | 2014-11-01 20:38:06 +0000 | [diff] [blame] | 416 | #ifdef SQLITE_ENABLE_STMT_SCANSTATUS |
| 417 | i64 *anExec; /* Number of times each op has been executed */ |
| 418 | int nScan; /* Entries in aScan[] */ |
dan | 037b532 | 2014-11-03 11:25:32 +0000 | [diff] [blame] | 419 | ScanStatus *aScan; /* Scan definitions for sqlite3_stmt_scanstatus() */ |
dan | 6f9702e | 2014-11-01 20:38:06 +0000 | [diff] [blame] | 420 | #endif |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 421 | }; |
| 422 | |
| 423 | /* |
| 424 | ** The following are allowed values for Vdbe.magic |
| 425 | */ |
| 426 | #define VDBE_MAGIC_INIT 0x26bceaa5 /* Building a VDBE program */ |
| 427 | #define VDBE_MAGIC_RUN 0xbdf20da3 /* VDBE is ready to execute */ |
| 428 | #define VDBE_MAGIC_HALT 0x519c2973 /* VDBE has completed execution */ |
| 429 | #define VDBE_MAGIC_DEAD 0xb606c3c8 /* The VDBE has been deallocated */ |
| 430 | |
| 431 | /* |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 432 | ** Function prototypes |
| 433 | */ |
drh | 22c17b8 | 2015-05-15 04:13:15 +0000 | [diff] [blame] | 434 | void sqlite3VdbeError(Vdbe*, const char *, ...); |
drh | dfe88ec | 2008-11-03 20:55:06 +0000 | [diff] [blame] | 435 | void sqlite3VdbeFreeCursor(Vdbe *, VdbeCursor*); |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 436 | void sqliteVdbePopStack(Vdbe*,int); |
dan | de892d9 | 2016-01-29 19:29:45 +0000 | [diff] [blame] | 437 | int sqlite3VdbeCursorMoveto(VdbeCursor**, int*); |
drh | c22284f | 2014-10-13 16:02:20 +0000 | [diff] [blame] | 438 | int sqlite3VdbeCursorRestore(VdbeCursor*); |
danielk1977 | 8b60e0f | 2005-01-12 09:10:39 +0000 | [diff] [blame] | 439 | #if defined(SQLITE_DEBUG) || defined(VDBE_PROFILE) |
danielk1977 | 4adee20 | 2004-05-08 08:23:19 +0000 | [diff] [blame] | 440 | void sqlite3VdbePrintOp(FILE*, int, Op*); |
drh | 9a32464 | 2003-09-06 20:12:01 +0000 | [diff] [blame] | 441 | #endif |
drh | 35cd643 | 2009-06-05 14:17:21 +0000 | [diff] [blame] | 442 | u32 sqlite3VdbeSerialTypeLen(u32); |
drh | faf3727 | 2015-10-16 14:23:42 +0000 | [diff] [blame] | 443 | u8 sqlite3VdbeOneByteSerialTypeLen(u8); |
drh | be37c12 | 2015-10-16 14:54:17 +0000 | [diff] [blame] | 444 | u32 sqlite3VdbeSerialType(Mem*, int, u32*); |
drh | a9ab481 | 2013-12-11 11:00:44 +0000 | [diff] [blame] | 445 | u32 sqlite3VdbeSerialPut(unsigned char*, Mem*, u32); |
drh | 35cd643 | 2009-06-05 14:17:21 +0000 | [diff] [blame] | 446 | u32 sqlite3VdbeSerialGet(const unsigned char*, u32, Mem*); |
drh | b9626cf | 2016-02-22 16:04:31 +0000 | [diff] [blame] | 447 | void sqlite3VdbeDeleteAuxData(sqlite3*, AuxData**, int, int); |
danielk1977 | 4adee20 | 2004-05-08 08:23:19 +0000 | [diff] [blame] | 448 | |
danielk1977 | 189621d | 2004-05-09 23:23:56 +0000 | [diff] [blame] | 449 | int sqlite2BtreeKeyCompare(BtCursor *, const void *, int, int, int *); |
drh | d3b7420 | 2014-09-17 16:41:15 +0000 | [diff] [blame] | 450 | int sqlite3VdbeIdxKeyCompare(sqlite3*,VdbeCursor*,UnpackedRecord*,int*); |
| 451 | int sqlite3VdbeIdxRowid(sqlite3*, BtCursor*, i64*); |
danielk1977 | 106bb23 | 2004-05-21 10:08:53 +0000 | [diff] [blame] | 452 | int sqlite3VdbeExec(Vdbe*); |
| 453 | int sqlite3VdbeList(Vdbe*); |
drh | 92f02c3 | 2004-09-02 14:57:08 +0000 | [diff] [blame] | 454 | int sqlite3VdbeHalt(Vdbe*); |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 455 | int sqlite3VdbeChangeEncoding(Mem *, int); |
drh | 023ae03 | 2007-05-08 12:12:16 +0000 | [diff] [blame] | 456 | int sqlite3VdbeMemTooBig(Mem*); |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 457 | int sqlite3VdbeMemCopy(Mem*, const Mem*); |
drh | febe106 | 2004-08-28 18:17:48 +0000 | [diff] [blame] | 458 | void sqlite3VdbeMemShallowCopy(Mem*, const Mem*, int); |
drh | 643167f | 2008-01-22 21:30:53 +0000 | [diff] [blame] | 459 | void sqlite3VdbeMemMove(Mem*, Mem*); |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 460 | int sqlite3VdbeMemNulTerminate(Mem*); |
| 461 | int sqlite3VdbeMemSetStr(Mem*, const char*, int, u8, void(*)(void*)); |
drh | efad999 | 2004-06-22 12:13:55 +0000 | [diff] [blame] | 462 | void sqlite3VdbeMemSetInt64(Mem*, i64); |
drh | 7ec5ea9 | 2010-01-13 00:04:13 +0000 | [diff] [blame] | 463 | #ifdef SQLITE_OMIT_FLOATING_POINT |
| 464 | # define sqlite3VdbeMemSetDouble sqlite3VdbeMemSetInt64 |
| 465 | #else |
| 466 | void sqlite3VdbeMemSetDouble(Mem*, double); |
| 467 | #endif |
drh | d3b7420 | 2014-09-17 16:41:15 +0000 | [diff] [blame] | 468 | void sqlite3VdbeMemInit(Mem*,sqlite3*,u16); |
drh | f447950 | 2004-05-27 03:12:53 +0000 | [diff] [blame] | 469 | void sqlite3VdbeMemSetNull(Mem*); |
drh | b026e05 | 2007-05-02 01:34:31 +0000 | [diff] [blame] | 470 | void sqlite3VdbeMemSetZeroBlob(Mem*,int); |
drh | 3d4501e | 2008-12-04 20:40:10 +0000 | [diff] [blame] | 471 | void sqlite3VdbeMemSetRowSet(Mem*); |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 472 | int sqlite3VdbeMemMakeWriteable(Mem*); |
drh | bd9507c | 2014-08-23 17:21:37 +0000 | [diff] [blame] | 473 | int sqlite3VdbeMemStringify(Mem*, u8, u8); |
drh | 6a6124e | 2004-06-27 01:56:33 +0000 | [diff] [blame] | 474 | i64 sqlite3VdbeIntValue(Mem*); |
drh | eb2e176 | 2004-05-27 01:53:56 +0000 | [diff] [blame] | 475 | int sqlite3VdbeMemIntegerify(Mem*); |
drh | 6a6124e | 2004-06-27 01:56:33 +0000 | [diff] [blame] | 476 | double sqlite3VdbeRealValue(Mem*); |
drh | 8df447f | 2005-11-01 15:48:24 +0000 | [diff] [blame] | 477 | void sqlite3VdbeIntegerAffinity(Mem*); |
drh | eb2e176 | 2004-05-27 01:53:56 +0000 | [diff] [blame] | 478 | int sqlite3VdbeMemRealify(Mem*); |
drh | 8a51256 | 2005-11-14 22:29:05 +0000 | [diff] [blame] | 479 | int sqlite3VdbeMemNumerify(Mem*); |
drh | 4169e43 | 2014-08-25 20:11:52 +0000 | [diff] [blame] | 480 | void sqlite3VdbeMemCast(Mem*,u8,u8); |
drh | 501932c | 2013-11-21 21:59:53 +0000 | [diff] [blame] | 481 | int sqlite3VdbeMemFromBtree(BtCursor*,u32,u32,int,Mem*); |
danielk1977 | d812336 | 2004-06-12 09:25:12 +0000 | [diff] [blame] | 482 | void sqlite3VdbeMemRelease(Mem *p); |
drh | 90669c1 | 2006-01-20 15:45:36 +0000 | [diff] [blame] | 483 | int sqlite3VdbeMemFinalize(Mem*, FuncDef*); |
drh | 46c99e0 | 2007-08-27 23:26:59 +0000 | [diff] [blame] | 484 | const char *sqlite3OpcodeName(int); |
danielk1977 | a7a8e14 | 2008-02-13 18:25:27 +0000 | [diff] [blame] | 485 | int sqlite3VdbeMemGrow(Mem *pMem, int n, int preserve); |
drh | 322f285 | 2014-09-19 00:43:39 +0000 | [diff] [blame] | 486 | int sqlite3VdbeMemClearAndResize(Mem *pMem, int n); |
danielk1977 | bd43455 | 2009-03-18 10:33:00 +0000 | [diff] [blame] | 487 | int sqlite3VdbeCloseStatement(Vdbe *, int); |
dan | 165921a | 2009-08-28 18:53:45 +0000 | [diff] [blame] | 488 | void sqlite3VdbeFrameDelete(VdbeFrame*); |
| 489 | int sqlite3VdbeFrameRestore(VdbeFrame *); |
dan | 029ead6 | 2011-10-27 15:19:58 +0000 | [diff] [blame] | 490 | int sqlite3VdbeTransferError(Vdbe *p); |
drh | e54e051 | 2011-04-05 17:31:56 +0000 | [diff] [blame] | 491 | |
dan | fad9f9a | 2014-04-01 18:41:51 +0000 | [diff] [blame] | 492 | int sqlite3VdbeSorterInit(sqlite3 *, int, VdbeCursor *); |
drh | 65ea12c | 2014-03-19 17:41:36 +0000 | [diff] [blame] | 493 | void sqlite3VdbeSorterReset(sqlite3 *, VdbeSorter *); |
dan | a20fde6 | 2011-07-12 14:28:05 +0000 | [diff] [blame] | 494 | void sqlite3VdbeSorterClose(sqlite3 *, VdbeCursor *); |
drh | c041c16 | 2012-07-24 19:46:38 +0000 | [diff] [blame] | 495 | int sqlite3VdbeSorterRowkey(const VdbeCursor *, Mem *); |
| 496 | int sqlite3VdbeSorterNext(sqlite3 *, const VdbeCursor *, int *); |
drh | 958d261 | 2014-04-18 13:40:07 +0000 | [diff] [blame] | 497 | int sqlite3VdbeSorterRewind(const VdbeCursor *, int *); |
| 498 | int sqlite3VdbeSorterWrite(const VdbeCursor *, Mem *); |
drh | 1153c7b | 2013-11-01 22:02:56 +0000 | [diff] [blame] | 499 | int sqlite3VdbeSorterCompare(const VdbeCursor *, Mem *, int, int *); |
dan | 7fe6270 | 2011-08-02 10:56:22 +0000 | [diff] [blame] | 500 | |
dan | 20d876f | 2016-01-07 16:06:22 +0000 | [diff] [blame] | 501 | #if !defined(SQLITE_OMIT_SHARED_CACHE) |
drh | e54e051 | 2011-04-05 17:31:56 +0000 | [diff] [blame] | 502 | void sqlite3VdbeEnter(Vdbe*); |
drh | e54e051 | 2011-04-05 17:31:56 +0000 | [diff] [blame] | 503 | #else |
| 504 | # define sqlite3VdbeEnter(X) |
dan | 20d876f | 2016-01-07 16:06:22 +0000 | [diff] [blame] | 505 | #endif |
| 506 | |
| 507 | #if !defined(SQLITE_OMIT_SHARED_CACHE) && SQLITE_THREADSAFE>0 |
| 508 | void sqlite3VdbeLeave(Vdbe*); |
| 509 | #else |
drh | e54e051 | 2011-04-05 17:31:56 +0000 | [diff] [blame] | 510 | # define sqlite3VdbeLeave(X) |
| 511 | #endif |
drh | 46c99e0 | 2007-08-27 23:26:59 +0000 | [diff] [blame] | 512 | |
drh | 2b4ded9 | 2010-09-27 21:09:31 +0000 | [diff] [blame] | 513 | #ifdef SQLITE_DEBUG |
drh | e4c88c0 | 2012-01-04 12:57:45 +0000 | [diff] [blame] | 514 | void sqlite3VdbeMemAboutToChange(Vdbe*,Mem*); |
drh | 75fd054 | 2014-03-01 16:24:44 +0000 | [diff] [blame] | 515 | int sqlite3VdbeCheckMemInvariants(Mem*); |
drh | 2b4ded9 | 2010-09-27 21:09:31 +0000 | [diff] [blame] | 516 | #endif |
| 517 | |
dan | 1da40a3 | 2009-09-19 17:00:31 +0000 | [diff] [blame] | 518 | #ifndef SQLITE_OMIT_FOREIGN_KEY |
dan | 8a2fff7 | 2009-09-23 18:07:22 +0000 | [diff] [blame] | 519 | int sqlite3VdbeCheckFk(Vdbe *, int); |
dan | 1da40a3 | 2009-09-19 17:00:31 +0000 | [diff] [blame] | 520 | #else |
dan | 8a2fff7 | 2009-09-23 18:07:22 +0000 | [diff] [blame] | 521 | # define sqlite3VdbeCheckFk(p,i) 0 |
dan | 1da40a3 | 2009-09-19 17:00:31 +0000 | [diff] [blame] | 522 | #endif |
| 523 | |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 524 | int sqlite3VdbeMemTranslate(Mem*, u8); |
drh | 87cc3b3 | 2007-05-08 21:45:27 +0000 | [diff] [blame] | 525 | #ifdef SQLITE_DEBUG |
| 526 | void sqlite3VdbePrintSql(Vdbe*); |
| 527 | void sqlite3VdbeMemPrettyPrint(Mem *pMem, char *zBuf); |
| 528 | #endif |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 529 | int sqlite3VdbeMemHandleBom(Mem *pMem); |
drh | 4e78be6 | 2007-01-26 21:08:04 +0000 | [diff] [blame] | 530 | |
danielk1977 | 246ad31 | 2007-05-16 14:23:00 +0000 | [diff] [blame] | 531 | #ifndef SQLITE_OMIT_INCRBLOB |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 532 | int sqlite3VdbeMemExpandBlob(Mem *); |
drh | 45d2930 | 2012-01-08 22:18:33 +0000 | [diff] [blame] | 533 | #define ExpandBlob(P) (((P)->flags&MEM_Zero)?sqlite3VdbeMemExpandBlob(P):0) |
danielk1977 | 246ad31 | 2007-05-16 14:23:00 +0000 | [diff] [blame] | 534 | #else |
drh | b21c8cd | 2007-08-21 19:33:56 +0000 | [diff] [blame] | 535 | #define sqlite3VdbeMemExpandBlob(x) SQLITE_OK |
drh | 45d2930 | 2012-01-08 22:18:33 +0000 | [diff] [blame] | 536 | #define ExpandBlob(P) SQLITE_OK |
danielk1977 | 246ad31 | 2007-05-16 14:23:00 +0000 | [diff] [blame] | 537 | #endif |
| 538 | |
drh | 4e78be6 | 2007-01-26 21:08:04 +0000 | [diff] [blame] | 539 | #endif /* !defined(_VDBEINT_H_) */ |