xref: /sqlite-3.40.0/src/vdbeInt.h (revision 48864df9)
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 */
18 #ifndef _VDBEINT_H_
19 #define _VDBEINT_H_
20 
21 /*
22 ** SQL is translated into a sequence of instructions to be
23 ** executed by a virtual machine.  Each instruction is an instance
24 ** of the following structure.
25 */
26 typedef struct VdbeOp Op;
27 
28 /*
29 ** Boolean values
30 */
31 typedef unsigned char Bool;
32 
33 /* Opaque type used by code in vdbesort.c */
34 typedef struct VdbeSorter VdbeSorter;
35 
36 /* Opaque type used by the explainer */
37 typedef struct Explain Explain;
38 
39 /*
40 ** A cursor is a pointer into a single BTree within a database file.
41 ** The cursor can seek to a BTree entry with a particular key, or
42 ** loop over all entries of the Btree.  You can also insert new BTree
43 ** entries or retrieve the key or data from the entry that the cursor
44 ** is currently pointing to.
45 **
46 ** Every cursor that the virtual machine has open is represented by an
47 ** instance of the following structure.
48 */
49 struct VdbeCursor {
50   BtCursor *pCursor;    /* The cursor structure of the backend */
51   Btree *pBt;           /* Separate file holding temporary table */
52   KeyInfo *pKeyInfo;    /* Info about index keys needed by index cursors */
53   int iDb;              /* Index of cursor database in db->aDb[] (or -1) */
54   int pseudoTableReg;   /* Register holding pseudotable content. */
55   int nField;           /* Number of fields in the header */
56   Bool zeroed;          /* True if zeroed out and ready for reuse */
57   Bool rowidIsValid;    /* True if lastRowid is valid */
58   Bool atFirst;         /* True if pointing to first entry */
59   Bool useRandomRowid;  /* Generate new record numbers semi-randomly */
60   Bool nullRow;         /* True if pointing to a row with no data */
61   Bool deferredMoveto;  /* A call to sqlite3BtreeMoveto() is needed */
62   Bool isTable;         /* True if a table requiring integer keys */
63   Bool isIndex;         /* True if an index containing keys only - no data */
64   Bool isOrdered;       /* True if the underlying table is BTREE_UNORDERED */
65   Bool isSorter;        /* True if a new-style sorter */
66   Bool multiPseudo;     /* Multi-register pseudo-cursor */
67   sqlite3_vtab_cursor *pVtabCursor;  /* The cursor for a virtual table */
68   const sqlite3_module *pModule;     /* Module for cursor pVtabCursor */
69   i64 seqCount;         /* Sequence counter */
70   i64 movetoTarget;     /* Argument to the deferred sqlite3BtreeMoveto() */
71   i64 lastRowid;        /* Last rowid from a Next or NextIdx operation */
72   VdbeSorter *pSorter;  /* Sorter object for OP_SorterOpen cursors */
73 
74   /* Result of last sqlite3BtreeMoveto() done by an OP_NotExists or
75   ** OP_IsUnique opcode on this cursor. */
76   int seekResult;
77 
78   /* Cached information about the header for the data record that the
79   ** cursor is currently pointing to.  Only valid if cacheStatus matches
80   ** Vdbe.cacheCtr.  Vdbe.cacheCtr will never take on the value of
81   ** CACHE_STALE and so setting cacheStatus=CACHE_STALE guarantees that
82   ** the cache is out of date.
83   **
84   ** aRow might point to (ephemeral) data for the current row, or it might
85   ** be NULL.
86   */
87   u32 cacheStatus;      /* Cache is valid if this matches Vdbe.cacheCtr */
88   int payloadSize;      /* Total number of bytes in the record */
89   u32 *aType;           /* Type values for all entries in the record */
90   u32 *aOffset;         /* Cached offsets to the start of each columns data */
91   u8 *aRow;             /* Data for the current row, if all on one page */
92 };
93 typedef struct VdbeCursor VdbeCursor;
94 
95 /*
96 ** When a sub-program is executed (OP_Program), a structure of this type
97 ** is allocated to store the current value of the program counter, as
98 ** well as the current memory cell array and various other frame specific
99 ** values stored in the Vdbe struct. When the sub-program is finished,
100 ** these values are copied back to the Vdbe from the VdbeFrame structure,
101 ** restoring the state of the VM to as it was before the sub-program
102 ** began executing.
103 **
104 ** The memory for a VdbeFrame object is allocated and managed by a memory
105 ** cell in the parent (calling) frame. When the memory cell is deleted or
106 ** overwritten, the VdbeFrame object is not freed immediately. Instead, it
107 ** is linked into the Vdbe.pDelFrame list. The contents of the Vdbe.pDelFrame
108 ** list is deleted when the VM is reset in VdbeHalt(). The reason for doing
109 ** this instead of deleting the VdbeFrame immediately is to avoid recursive
110 ** calls to sqlite3VdbeMemRelease() when the memory cells belonging to the
111 ** child frame are released.
112 **
113 ** The currently executing frame is stored in Vdbe.pFrame. Vdbe.pFrame is
114 ** set to NULL if the currently executing frame is the main program.
115 */
116 typedef struct VdbeFrame VdbeFrame;
117 struct VdbeFrame {
118   Vdbe *v;                /* VM this frame belongs to */
119   VdbeFrame *pParent;     /* Parent of this frame, or NULL if parent is main */
120   Op *aOp;                /* Program instructions for parent frame */
121   Mem *aMem;              /* Array of memory cells for parent frame */
122   u8 *aOnceFlag;          /* Array of OP_Once flags for parent frame */
123   VdbeCursor **apCsr;     /* Array of Vdbe cursors for parent frame */
124   void *token;            /* Copy of SubProgram.token */
125   i64 lastRowid;          /* Last insert rowid (sqlite3.lastRowid) */
126   int nCursor;            /* Number of entries in apCsr */
127   int pc;                 /* Program Counter in parent (calling) frame */
128   int nOp;                /* Size of aOp array */
129   int nMem;               /* Number of entries in aMem */
130   int nOnceFlag;          /* Number of entries in aOnceFlag */
131   int nChildMem;          /* Number of memory cells for child frame */
132   int nChildCsr;          /* Number of cursors for child frame */
133   int nChange;            /* Statement changes (Vdbe.nChanges)     */
134 };
135 
136 #define VdbeFrameMem(p) ((Mem *)&((u8 *)p)[ROUND8(sizeof(VdbeFrame))])
137 
138 /*
139 ** A value for VdbeCursor.cacheValid that means the cache is always invalid.
140 */
141 #define CACHE_STALE 0
142 
143 /*
144 ** Internally, the vdbe manipulates nearly all SQL values as Mem
145 ** structures. Each Mem struct may cache multiple representations (string,
146 ** integer etc.) of the same value.
147 */
148 struct Mem {
149   sqlite3 *db;        /* The associated database connection */
150   char *z;            /* String or BLOB value */
151   double r;           /* Real value */
152   union {
153     i64 i;              /* Integer value used when MEM_Int is set in flags */
154     int nZero;          /* Used when bit MEM_Zero is set in flags */
155     FuncDef *pDef;      /* Used only when flags==MEM_Agg */
156     RowSet *pRowSet;    /* Used only when flags==MEM_RowSet */
157     VdbeFrame *pFrame;  /* Used when flags==MEM_Frame */
158   } u;
159   int n;              /* Number of characters in string value, excluding '\0' */
160   u16 flags;          /* Some combination of MEM_Null, MEM_Str, MEM_Dyn, etc. */
161   u8  type;           /* One of SQLITE_NULL, SQLITE_TEXT, SQLITE_INTEGER, etc */
162   u8  enc;            /* SQLITE_UTF8, SQLITE_UTF16BE, SQLITE_UTF16LE */
163 #ifdef SQLITE_DEBUG
164   Mem *pScopyFrom;    /* This Mem is a shallow copy of pScopyFrom */
165   void *pFiller;      /* So that sizeof(Mem) is a multiple of 8 */
166 #endif
167   void (*xDel)(void *);  /* If not null, call this function to delete Mem.z */
168   char *zMalloc;      /* Dynamic buffer allocated by sqlite3_malloc() */
169 };
170 
171 /* One or more of the following flags are set to indicate the validOK
172 ** representations of the value stored in the Mem struct.
173 **
174 ** If the MEM_Null flag is set, then the value is an SQL NULL value.
175 ** No other flags may be set in this case.
176 **
177 ** If the MEM_Str flag is set then Mem.z points at a string representation.
178 ** Usually this is encoded in the same unicode encoding as the main
179 ** database (see below for exceptions). If the MEM_Term flag is also
180 ** set, then the string is nul terminated. The MEM_Int and MEM_Real
181 ** flags may coexist with the MEM_Str flag.
182 */
183 #define MEM_Null      0x0001   /* Value is NULL */
184 #define MEM_Str       0x0002   /* Value is a string */
185 #define MEM_Int       0x0004   /* Value is an integer */
186 #define MEM_Real      0x0008   /* Value is a real number */
187 #define MEM_Blob      0x0010   /* Value is a BLOB */
188 #define MEM_RowSet    0x0020   /* Value is a RowSet object */
189 #define MEM_Frame     0x0040   /* Value is a VdbeFrame object */
190 #define MEM_Invalid   0x0080   /* Value is undefined */
191 #define MEM_Cleared   0x0100   /* NULL set by OP_Null, not from data */
192 #define MEM_TypeMask  0x01ff   /* Mask of type bits */
193 
194 
195 /* Whenever Mem contains a valid string or blob representation, one of
196 ** the following flags must be set to determine the memory management
197 ** policy for Mem.z.  The MEM_Term flag tells us whether or not the
198 ** string is \000 or \u0000 terminated
199 */
200 #define MEM_Term      0x0200   /* String rep is nul terminated */
201 #define MEM_Dyn       0x0400   /* Need to call sqliteFree() on Mem.z */
202 #define MEM_Static    0x0800   /* Mem.z points to a static string */
203 #define MEM_Ephem     0x1000   /* Mem.z points to an ephemeral string */
204 #define MEM_Agg       0x2000   /* Mem.z points to an agg function context */
205 #define MEM_Zero      0x4000   /* Mem.i contains count of 0s appended to blob */
206 #ifdef SQLITE_OMIT_INCRBLOB
207   #undef MEM_Zero
208   #define MEM_Zero 0x0000
209 #endif
210 
211 /*
212 ** Clear any existing type flags from a Mem and replace them with f
213 */
214 #define MemSetTypeFlag(p, f) \
215    ((p)->flags = ((p)->flags&~(MEM_TypeMask|MEM_Zero))|f)
216 
217 /*
218 ** Return true if a memory cell is not marked as invalid.  This macro
219 ** is for use inside assert() statements only.
220 */
221 #ifdef SQLITE_DEBUG
222 #define memIsValid(M)  ((M)->flags & MEM_Invalid)==0
223 #endif
224 
225 
226 /* A VdbeFunc is just a FuncDef (defined in sqliteInt.h) that contains
227 ** additional information about auxiliary information bound to arguments
228 ** of the function.  This is used to implement the sqlite3_get_auxdata()
229 ** and sqlite3_set_auxdata() APIs.  The "auxdata" is some auxiliary data
230 ** that can be associated with a constant argument to a function.  This
231 ** allows functions such as "regexp" to compile their constant regular
232 ** expression argument once and reused the compiled code for multiple
233 ** invocations.
234 */
235 struct VdbeFunc {
236   FuncDef *pFunc;               /* The definition of the function */
237   int nAux;                     /* Number of entries allocated for apAux[] */
238   struct AuxData {
239     void *pAux;                   /* Aux data for the i-th argument */
240     void (*xDelete)(void *);      /* Destructor for the aux data */
241   } apAux[1];                   /* One slot for each function argument */
242 };
243 
244 /*
245 ** The "context" argument for a installable function.  A pointer to an
246 ** instance of this structure is the first argument to the routines used
247 ** implement the SQL functions.
248 **
249 ** There is a typedef for this structure in sqlite.h.  So all routines,
250 ** even the public interface to SQLite, can use a pointer to this structure.
251 ** But this file is the only place where the internal details of this
252 ** structure are known.
253 **
254 ** This structure is defined inside of vdbeInt.h because it uses substructures
255 ** (Mem) which are only defined there.
256 */
257 struct sqlite3_context {
258   FuncDef *pFunc;       /* Pointer to function information.  MUST BE FIRST */
259   VdbeFunc *pVdbeFunc;  /* Auxilary data, if created. */
260   Mem s;                /* The return value is stored here */
261   Mem *pMem;            /* Memory cell used to store aggregate context */
262   CollSeq *pColl;       /* Collating sequence */
263   int isError;          /* Error code returned by the function. */
264   int skipFlag;         /* Skip skip accumulator loading if true */
265 };
266 
267 /*
268 ** An Explain object accumulates indented output which is helpful
269 ** in describing recursive data structures.
270 */
271 struct Explain {
272   Vdbe *pVdbe;       /* Attach the explanation to this Vdbe */
273   StrAccum str;      /* The string being accumulated */
274   int nIndent;       /* Number of elements in aIndent */
275   u16 aIndent[100];  /* Levels of indentation */
276   char zBase[100];   /* Initial space */
277 };
278 
279 /* A bitfield type for use inside of structures.  Always follow with :N where
280 ** N is the number of bits.
281 */
282 typedef unsigned bft;  /* Bit Field Type */
283 
284 /*
285 ** An instance of the virtual machine.  This structure contains the complete
286 ** state of the virtual machine.
287 **
288 ** The "sqlite3_stmt" structure pointer that is returned by sqlite3_prepare()
289 ** is really a pointer to an instance of this structure.
290 **
291 ** The Vdbe.inVtabMethod variable is set to non-zero for the duration of
292 ** any virtual table method invocations made by the vdbe program. It is
293 ** set to 2 for xDestroy method calls and 1 for all other methods. This
294 ** variable is used for two purposes: to allow xDestroy methods to execute
295 ** "DROP TABLE" statements and to prevent some nasty side effects of
296 ** malloc failure when SQLite is invoked recursively by a virtual table
297 ** method function.
298 */
299 struct Vdbe {
300   sqlite3 *db;            /* The database connection that owns this statement */
301   Op *aOp;                /* Space to hold the virtual machine's program */
302   Mem *aMem;              /* The memory locations */
303   Mem **apArg;            /* Arguments to currently executing user function */
304   Mem *aColName;          /* Column names to return */
305   Mem *pResultSet;        /* Pointer to an array of results */
306   int nMem;               /* Number of memory locations currently allocated */
307   int nOp;                /* Number of instructions in the program */
308   int nOpAlloc;           /* Number of slots allocated for aOp[] */
309   int nLabel;             /* Number of labels used */
310   int *aLabel;            /* Space to hold the labels */
311   u16 nResColumn;         /* Number of columns in one row of the result set */
312   int nCursor;            /* Number of slots in apCsr[] */
313   u32 magic;              /* Magic number for sanity checking */
314   char *zErrMsg;          /* Error message written here */
315   Vdbe *pPrev,*pNext;     /* Linked list of VDBEs with the same Vdbe.db */
316   VdbeCursor **apCsr;     /* One element of this array for each open cursor */
317   Mem *aVar;              /* Values for the OP_Variable opcode. */
318   char **azVar;           /* Name of variables */
319   ynVar nVar;             /* Number of entries in aVar[] */
320   ynVar nzVar;            /* Number of entries in azVar[] */
321   u32 cacheCtr;           /* VdbeCursor row cache generation counter */
322   int pc;                 /* The program counter */
323   int rc;                 /* Value to return */
324   u8 errorAction;         /* Recovery action to do in case of an error */
325   u8 minWriteFileFormat;  /* Minimum file format for writable database files */
326   bft explain:2;          /* True if EXPLAIN present on SQL command */
327   bft inVtabMethod:2;     /* See comments above */
328   bft changeCntOn:1;      /* True to update the change-counter */
329   bft expired:1;          /* True if the VM needs to be recompiled */
330   bft runOnlyOnce:1;      /* Automatically expire on reset */
331   bft usesStmtJournal:1;  /* True if uses a statement journal */
332   bft readOnly:1;         /* True for read-only statements */
333   bft isPrepareV2:1;      /* True if prepared with prepare_v2() */
334   bft doingRerun:1;       /* True if rerunning after an auto-reprepare */
335   int nChange;            /* Number of db changes made since last reset */
336   yDbMask btreeMask;      /* Bitmask of db->aDb[] entries referenced */
337   yDbMask lockMask;       /* Subset of btreeMask that requires a lock */
338   int iStatement;         /* Statement number (or 0 if has not opened stmt) */
339   int aCounter[3];        /* Counters used by sqlite3_stmt_status() */
340 #ifndef SQLITE_OMIT_TRACE
341   i64 startTime;          /* Time when query started - used for profiling */
342 #endif
343   i64 nFkConstraint;      /* Number of imm. FK constraints this VM */
344   i64 nStmtDefCons;       /* Number of def. constraints when stmt started */
345   char *zSql;             /* Text of the SQL statement that generated this */
346   void *pFree;            /* Free this when deleting the vdbe */
347 #ifdef SQLITE_DEBUG
348   FILE *trace;            /* Write an execution trace here, if not NULL */
349 #endif
350 #ifdef SQLITE_ENABLE_TREE_EXPLAIN
351   Explain *pExplain;      /* The explainer */
352   char *zExplain;         /* Explanation of data structures */
353 #endif
354   VdbeFrame *pFrame;      /* Parent frame */
355   VdbeFrame *pDelFrame;   /* List of frame objects to free on VM reset */
356   int nFrame;             /* Number of frames in pFrame list */
357   u32 expmask;            /* Binding to these vars invalidates VM */
358   SubProgram *pProgram;   /* Linked list of all sub-programs used by VM */
359   int nOnceFlag;          /* Size of array aOnceFlag[] */
360   u8 *aOnceFlag;          /* Flags for OP_Once */
361 };
362 
363 /*
364 ** The following are allowed values for Vdbe.magic
365 */
366 #define VDBE_MAGIC_INIT     0x26bceaa5    /* Building a VDBE program */
367 #define VDBE_MAGIC_RUN      0xbdf20da3    /* VDBE is ready to execute */
368 #define VDBE_MAGIC_HALT     0x519c2973    /* VDBE has completed execution */
369 #define VDBE_MAGIC_DEAD     0xb606c3c8    /* The VDBE has been deallocated */
370 
371 /*
372 ** Function prototypes
373 */
374 void sqlite3VdbeFreeCursor(Vdbe *, VdbeCursor*);
375 void sqliteVdbePopStack(Vdbe*,int);
376 int sqlite3VdbeCursorMoveto(VdbeCursor*);
377 #if defined(SQLITE_DEBUG) || defined(VDBE_PROFILE)
378 void sqlite3VdbePrintOp(FILE*, int, Op*);
379 #endif
380 u32 sqlite3VdbeSerialTypeLen(u32);
381 u32 sqlite3VdbeSerialType(Mem*, int);
382 u32 sqlite3VdbeSerialPut(unsigned char*, int, Mem*, int);
383 u32 sqlite3VdbeSerialGet(const unsigned char*, u32, Mem*);
384 void sqlite3VdbeDeleteAuxData(VdbeFunc*, int);
385 
386 int sqlite2BtreeKeyCompare(BtCursor *, const void *, int, int, int *);
387 int sqlite3VdbeIdxKeyCompare(VdbeCursor*,UnpackedRecord*,int*);
388 int sqlite3VdbeIdxRowid(sqlite3*, BtCursor *, i64 *);
389 int sqlite3MemCompare(const Mem*, const Mem*, const CollSeq*);
390 int sqlite3VdbeExec(Vdbe*);
391 int sqlite3VdbeList(Vdbe*);
392 int sqlite3VdbeHalt(Vdbe*);
393 int sqlite3VdbeChangeEncoding(Mem *, int);
394 int sqlite3VdbeMemTooBig(Mem*);
395 int sqlite3VdbeMemCopy(Mem*, const Mem*);
396 void sqlite3VdbeMemShallowCopy(Mem*, const Mem*, int);
397 void sqlite3VdbeMemMove(Mem*, Mem*);
398 int sqlite3VdbeMemNulTerminate(Mem*);
399 int sqlite3VdbeMemSetStr(Mem*, const char*, int, u8, void(*)(void*));
400 void sqlite3VdbeMemSetInt64(Mem*, i64);
401 #ifdef SQLITE_OMIT_FLOATING_POINT
402 # define sqlite3VdbeMemSetDouble sqlite3VdbeMemSetInt64
403 #else
404   void sqlite3VdbeMemSetDouble(Mem*, double);
405 #endif
406 void sqlite3VdbeMemSetNull(Mem*);
407 void sqlite3VdbeMemSetZeroBlob(Mem*,int);
408 void sqlite3VdbeMemSetRowSet(Mem*);
409 int sqlite3VdbeMemMakeWriteable(Mem*);
410 int sqlite3VdbeMemStringify(Mem*, int);
411 i64 sqlite3VdbeIntValue(Mem*);
412 int sqlite3VdbeMemIntegerify(Mem*);
413 double sqlite3VdbeRealValue(Mem*);
414 void sqlite3VdbeIntegerAffinity(Mem*);
415 int sqlite3VdbeMemRealify(Mem*);
416 int sqlite3VdbeMemNumerify(Mem*);
417 int sqlite3VdbeMemFromBtree(BtCursor*,int,int,int,Mem*);
418 void sqlite3VdbeMemRelease(Mem *p);
419 void sqlite3VdbeMemReleaseExternal(Mem *p);
420 #define VdbeMemRelease(X)  \
421   if((X)->flags&(MEM_Agg|MEM_Dyn|MEM_RowSet|MEM_Frame)) \
422     sqlite3VdbeMemReleaseExternal(X);
423 int sqlite3VdbeMemFinalize(Mem*, FuncDef*);
424 const char *sqlite3OpcodeName(int);
425 int sqlite3VdbeMemGrow(Mem *pMem, int n, int preserve);
426 int sqlite3VdbeCloseStatement(Vdbe *, int);
427 void sqlite3VdbeFrameDelete(VdbeFrame*);
428 int sqlite3VdbeFrameRestore(VdbeFrame *);
429 void sqlite3VdbeMemStoreType(Mem *pMem);
430 int sqlite3VdbeTransferError(Vdbe *p);
431 
432 #ifdef SQLITE_OMIT_MERGE_SORT
433 # define sqlite3VdbeSorterInit(Y,Z)      SQLITE_OK
434 # define sqlite3VdbeSorterWrite(X,Y,Z)   SQLITE_OK
435 # define sqlite3VdbeSorterClose(Y,Z)
436 # define sqlite3VdbeSorterRowkey(Y,Z)    SQLITE_OK
437 # define sqlite3VdbeSorterRewind(X,Y,Z)  SQLITE_OK
438 # define sqlite3VdbeSorterNext(X,Y,Z)    SQLITE_OK
439 # define sqlite3VdbeSorterCompare(X,Y,Z) SQLITE_OK
440 #else
441 int sqlite3VdbeSorterInit(sqlite3 *, VdbeCursor *);
442 void sqlite3VdbeSorterClose(sqlite3 *, VdbeCursor *);
443 int sqlite3VdbeSorterRowkey(const VdbeCursor *, Mem *);
444 int sqlite3VdbeSorterNext(sqlite3 *, const VdbeCursor *, int *);
445 int sqlite3VdbeSorterRewind(sqlite3 *, const VdbeCursor *, int *);
446 int sqlite3VdbeSorterWrite(sqlite3 *, const VdbeCursor *, Mem *);
447 int sqlite3VdbeSorterCompare(const VdbeCursor *, Mem *, int *);
448 #endif
449 
450 #if !defined(SQLITE_OMIT_SHARED_CACHE) && SQLITE_THREADSAFE>0
451   void sqlite3VdbeEnter(Vdbe*);
452   void sqlite3VdbeLeave(Vdbe*);
453 #else
454 # define sqlite3VdbeEnter(X)
455 # define sqlite3VdbeLeave(X)
456 #endif
457 
458 #ifdef SQLITE_DEBUG
459 void sqlite3VdbeMemAboutToChange(Vdbe*,Mem*);
460 #endif
461 
462 #ifndef SQLITE_OMIT_FOREIGN_KEY
463 int sqlite3VdbeCheckFk(Vdbe *, int);
464 #else
465 # define sqlite3VdbeCheckFk(p,i) 0
466 #endif
467 
468 int sqlite3VdbeMemTranslate(Mem*, u8);
469 #ifdef SQLITE_DEBUG
470   void sqlite3VdbePrintSql(Vdbe*);
471   void sqlite3VdbeMemPrettyPrint(Mem *pMem, char *zBuf);
472 #endif
473 int sqlite3VdbeMemHandleBom(Mem *pMem);
474 
475 #ifndef SQLITE_OMIT_INCRBLOB
476   int sqlite3VdbeMemExpandBlob(Mem *);
477   #define ExpandBlob(P) (((P)->flags&MEM_Zero)?sqlite3VdbeMemExpandBlob(P):0)
478 #else
479   #define sqlite3VdbeMemExpandBlob(x) SQLITE_OK
480   #define ExpandBlob(P) SQLITE_OK
481 #endif
482 
483 #endif /* !defined(_VDBEINT_H_) */
484