contrib/sqlite3/sqlite3.c

520 ** with the [sqlite3] object prior to attempting to close the object.  ^If
1068 ** is not changed but instead the prior value of that setting is written
1548 ** other SQLite resources must be deallocated prior to invoking
1568 ** prior to using any other SQLite interface.  For maximum portability,
1570 ** directly prior to using any other SQLite interface.  Future releases
1617 ** may only be invoked prior to library initialization using
1683 ** xRealloc is always a value returned by a prior call to xRoundup.
1721   void (*xFree)(void*);          /* Free a prior allocation */
1885 ** undoing any prior invocation of [SQLITE_CONFIG_MALLOC].  ^If the
2335 ** running prior to the sqlite3_interrupt() call.  ^New SQL statements
2368 ** ^(If SQLite has not been initialized using [sqlite3_initialize()] prior
2460 ** was defined  (using [sqlite3_busy_handler()]) prior to calling
2690 ** prior memory allocation X to be at least N bytes.
2699 ** ^If M is the size of the prior allocation, then min(N,M) bytes
2700 ** of the prior allocation are copied into the beginning of buffer returned
2701 ** by sqlite3_realloc(X,N) and the prior allocation is freed.
2703 ** prior allocation is not freed.
2739 ** must be either NULL or else pointers obtained from a prior
2775 ** prior to the reset.
3245 ** characters must be converted to UTF-8 prior to passing them into
3249 ** prior to calling sqlite3_open() or sqlite3_open_v2().  Otherwise, various
3407 ** [sqlite3_limit()] interface returns the prior value of the limit.
3507 ** prior successful call to [sqlite3_open()], [sqlite3_open_v2()] or
4286 ** Note that when type conversions occur, pointers returned by prior
4305 ** not invalidate a prior pointer, though of course the content of the buffer
4306 ** that the prior pointer references will have been modified.  Other kinds
4308 ** are not possible and in those cases prior pointers are invalidated.
5225 ** prior to calling [sqlite3_open] or [sqlite3_open_v2].  Otherwise, various
5472 ** This is a change as of SQLite version 3.5.0. In prior versions of SQLite,
5543 ** the soft heap limit prior to the call, or negative in the case of an
5702 ** [sqlite3_enable_load_extension()] prior to calling this API,
5772 ** initialization routine X that was registered using a prior call to
6058 ** take care that any prior string is freed by a call to [sqlite3_free()]
6059 ** prior to assigning a new string to zErrMsg.  ^After the error message
6202 ** ^(Changes written into a BLOB prior to the BLOB expiring are not
6286 ** by a prior successful call to [sqlite3_blob_open()] and which has not
6313 ** by a prior successful call to [sqlite3_blob_open()] and which has not
6355 ** by a prior successful call to [sqlite3_blob_open()] and which has not
6577 ** called, but only if the prior call to xMutexInit returned SQLITE_OK.
6579 ** prior to returning.
7226 ** will only use a createFlag of 2 after a prior call with a createFlag of 1
7241 ** call to xUnpin() unpins the page regardless of the number of prior calls
7248 ** discarded. ^Any prior cache entry associated with newKey is guaranteed not
7453 ** ^If an out-of-memory condition or IO error occurred during any prior
7746 ** overwrite any prior [sqlite3_wal_hook()] settings.
7844 **   addition that it also truncates the log file to zero bytes just prior
8034 ** product of this value for all prior loops with the same SELECTID will
11717 ** OS's standard temporary file directory, and are deleted prior to exit.
12802 ** fails and any prior changes from that one operation are backed out,
12804 ** the operation in progress stops and returns an error code.  But prior
12825 #define OE_Fail     3   /* Stop the operation but leave all prior changes */
13604 **                     a record of all prior results and ignore any duplicate
13613 **                     index at pDest->iSDParm+1 hold all prior stores.
16753 ** use the julian calendar for dates prior to 1582-10-15 and for some
18624 ** Report the allocated size of a prior return from xMalloc()
20190 ** The caller has obtained a mutex prior to invoking this
20359 ** nBytes is always a value obtained from a prior call to
20589     ** install a mutex implementation via sqlite3_config() prior to
22539   ** argument to xRealloc is always a value returned by a prior call to
22571 ** subsystem is initialized prior to invoking sqliteRealloc.
22630 ** If db!=0 and db->mallocFailed is true (indicating a prior malloc
22642 ** that all prior mallocs (ex: "a") worked too.
22779 ** Free any prior content in *pz and replace it with a copy of zNew.
23390         /* Digits prior to the decimal point */
25526 ** Set the current error code to err_code and clear any prior error message.
26959 ** if the new size is the same as the prior size.
28479 ** sets or clears a lock, that operation overrides any prior locks set
28793   ** prior to accessing the inode number.  The one byte written is
30625   int prior = 0;
30651       prior = 0;
30657       prior += got;
30663             id->h, got+prior, offset-prior, TIMER_ELAPSED));
30664   return got+prior;
34646 ** pFile is a file that has been opened by a prior xOpen call.  dbPath
39739       ** prior to using it.
41720   sqlite3_pcache_page *pPage  /* Page obtained by prior PcacheFetch() call */
41746   sqlite3_pcache_page *pPage  /* Page obtained by prior PcacheFetch() call */
43383 ** a non-zero batch number, it will see all prior INSERTs.
43540   struct RowSetEntry *pLast;   /* The last prior entry */
43779 ** part of any insert batch prior to iBatch.  Return 1 or 0.
44066 ** (5) All writes to the database file are synced prior to the rollback journal
44070 **     are synced prior to the master journal being deleted.
44090 **     of bytes from 24 through 39 inclusive will be changed prior to releasing
45554     /* Versions of SQLite prior to 3.5.8 set the page-size field of the
46150 ** prior to returning.
46268   ** This occurs when a page is changed prior to the start of a statement
46684 ** If the journal really is hot, reset the pager cache prior rolling
46697   int needPagerReset;      /* True to reset page prior to first page rollback */
46808           ** not completely written and synced prior to a crash.  In that
46829   ** state prior to the start of the transaction, so invoke the
47472 ** prior to the start of checkpoint and that the database file is synced
48852     ** has not been moved.  That is the historical behavior of SQLite: prior to
48875 ** exists, that is probably an old journal left over from a prior
48929         ** journal is a remnant from a prior database with the same name where
50169   /* If a prior error occurred, report that error again. */
50331   /* This routine should not be called if a prior error has occurred.
51270 ** This function is called to close the connection to the log file prior
51395 ** are leftovers from prior checkpoints.
51510 ** NULL if there are no frames for page P in the WAL prior to M.
51552 ** prior to finding a match is 1.  Each entry of the hash table is an
51679   u32 aCksum[2];                  /* Checksum over all prior fields */
52111   ** all prior frams, the first 16 bytes of this frame-header,
52722 ** has not been returned by any prior invocation of this method on the
53240           ** truncates the log file to zero bytes just prior to a
53507 ** The caller must set the cnt parameter to the number of prior calls to
53987 ** A read transaction must have already been started by a prior call
54470   ** boundary is crossed.  Only the part of the WAL prior to the last
54689 ** should acquire the database exclusive lock prior to invoking
54698   ** prior error while attempting to acquire are read-lock. This cannot
55675 ** connection.  This is needed (for example) prior to parsing
56448 ** prior to calling this routine.
57828 ** Release a MemPage.  This should be called once for each prior
59433 ** This routine is called prior to sqlite3PagerCommit when a transaction
59588 ** be invoked prior to calling this routine.  The sqlite3BtreeCommitPhaseOne()
59886 ** on pCur to initialize the memory space prior to invoking this routine.
60073 ** The caller must position the cursor prior to invoking this routine.
60541 ** Hence, a mutex on the BtShared should be held prior to calling
61727       ** coded.  But due to a coding error in versions of SQLite prior to
62577   /* This error condition is now caught prior to reaching this function */
62995     ** cells into a parent on a prior balance, and divider cells are always
63756   int seekResult                 /* Result of prior MovetoUnpacked() call */
66424 ** blob if bPreserve is true.  If bPreserve is false, any prior content
66476 ** Any prior string or blob content in the pMem object may be discarded.
66716 ** Use this routine prior to clean up prior to abandoning a Mem, or to
66720 ** prior to inserting new content into the Mem.
66843 ** Convert pMem to type integer.  Invalidate any prior representations.
66857 ** Invalidate any prior representations.
66870 ** Invalidate any prior representations.
66958 ** Use this routine to reset the Mem prior to insert a new value.
66960 ** Use sqlite3VdbeMemRelease() to complete erase the Mem prior to abandoning it.
66988 ** The pMem is known to contain content that needs to be destroyed prior
68399 ** a prior call to sqlite3VdbeMakeLabel().
69054 ** If a memory allocation error has occurred prior to the calling of this
69785 ** been allocated by a prior call to this routine, so just return a copy
69794   void *pBuf,               /* Pointer to a prior allocation */
71230 ** GCC might have just copying the problem from a prior compiler.
72385 ** of the keys prior to the final rowid, not the entire key.
72629 ** the prior execution is returned.
73299 ** same context that was returned on prior calls.
74410 ** Invoke this macro on memory cells just prior to changing the
76553 ** occur immediately prior to the OP_Compare.
76838 ** then the cache of the cursor is reset prior to extracting the column.
77752 ** open cursor.  If the database was unlocked prior to this instruction
77861     /* The p2 value always comes from a prior OP_CreateTable opcode and
78716 ** currently pointing to.  Presumably, the prior OP_NotExists opcode
78751   int seekResult;   /* Result of prior seek or 0 if no USESEEKRESULT flag */
78838 ** using OP_NotFound prior to invoking this opcode.
78857   /* The seek operation that positioned the cursor prior to OP_Delete will
79252 ** been opened prior to this opcode or the program will segfault.
82264 ** held in memory and prior to being written out as part of a PMA.
85429             /* If there has been exactly one prior match and this match
86289   ** prior call to sqlite3SelectExpand().  When that happens, let
86602 ** sqlite3SelectExpand() prior to invoking this routine.
86865 ** be applied to both operands prior to doing the comparison.
87343       ** number as the prior appearance of the same name, or if the name
88781   assert( v!=0 );       /* OOM detected prior to this routine */
89087 ** the cache to the state it was in prior the most recent Push.
92538 ** the Stat4Accum object by prior calls to stat_push().  The P parameter
93577   /* Clear any prior statistics */
94051 ** Initialize a DbFixer structure.  This routine must be called prior
94077 ** must have been initialized by a prior call to sqlite3FixInit().
95083   ** prior to doing any free() operations.  Since schema Tables do not use
95933 ** set back to prior value.  But schema changes are infrequent
96634   ** Actually, the error above is now caught prior to reaching this point.
97934   assert( pParse->nErr==0 );   /* Never called with prior errors */
98160 ** a new one.  If an OOM error does occurs, then the prior value of pList
98565 ** possible to abort a statement prior to completion.  In order to
99275   ** functions even if a prior app-defined function was found.  And give
100274 ** If a prior call to sqlite3GenerateIndexKey() generated a jump-over label
100467 ** the number of bytes in haystack prior to the first occurrence of needle,
104650 ** Generate code to do constraint checks prior to an INSERT or an UPDATE
104662 ** the data prior to an UPDATE rather than afterwards.  regOldData is zero
104711 **                                changes to prior rows are retained.
105157 ** that was started by a prior call to sqlite3GenerateConstraintChecks.
107092 ** Cancel a prior call to sqlite3_auto_extension.  Remove xInit from the
111013   int nPrefixReg         /* No. of reg prior to regData available for use */
112323 ** prior to calling this routine.
112709   /* Make sure there is no ORDER BY or LIMIT clause on prior SELECTs.  Only
112816       int priorOp;     /* The SRT_ operation to apply to prior selects */
115674     /* If sorting index that was created by a prior OP_OpenEphemeral
118387 ** database content must be written into the rollback journal prior to
121151     /* If we survive all prior tests, that means this term is worth hinting */
121333         ** was loaded into the same register prior to the OP_VFilter, but
121956           ** duplicate rows from prior sub-WHERE clauses, and record the
122010           ** current sub-WHERE row is a duplicate from prior sub-WHEREs. */
123067 ** is a commuted copy of a prior term.)  The original term has nChild=1
126807   u8 isOrderDistinct;   /* All prior WhereLoops are order-distinct */
127313             /* New path replaces the prior worst to keep count below mxChoice */
133336 ** VFS, and mutex subsystems prior to doing any serious work with
133402   ** MutexAlloc() is called for a static mutex prior to initializing the
133749         ** (the system malloc() implementation), undoing any prior invocation of
134317 ** has been a prior call to sqlite3_close(db) or sqlite3_close_v2(db)) and
134667   int delay, prior;
134672     prior = totals[count];
134675     prior = totals[NDELAY-1] + delay*(count-(NDELAY-1));
134677   if( prior + delay > timeout ){
134678     delay = timeout - prior;
137341 ** Each call to this routine overrides any prior callbacks registered
137342 ** on the same "db".  If xNotify==0 then any prior callbacks are immediately
137625 ** than the difference from the prior position, or the just the position plus
147204 ** have been opened by a prior call to porterOpen().
147311 ** has been activated via a prior call to sqlite3_db_config(db,
147947 ** have been opened by a prior call to simpleOpen().
156185 ** have been opened by a prior call to simpleOpen().