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 4d 61 69 6e 20 66 ******.** Main f
0180: 69 6c 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69 ile for the SQLi
0190: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 54 68 65 te library. The
01a0: 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 69 routines in thi
01b0: 73 20 66 69 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d s file.** implem
01c0: 65 6e 74 20 74 68 65 20 70 72 6f 67 72 61 6d 6d ent the programm
01d0: 65 72 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 er interface to
01e0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 52 6f the library. Ro
01f0: 75 74 69 6e 65 73 20 69 6e 0a 2a 2a 20 6f 74 68 utines in.** oth
0200: 65 72 20 66 69 6c 65 73 20 61 72 65 20 66 6f 72 er files are for
0210: 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 20 62 79 internal use by
0220: 20 53 51 4c 69 74 65 20 61 6e 64 20 73 68 6f 75 SQLite and shou
0230: 6c 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 63 63 ld not be.** acc
0240: 65 73 73 65 64 20 62 79 20 75 73 65 72 73 20 6f essed by users o
0250: 66 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 2a f the library..*
0260: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 69 6e 2e 63 *.** $Id: main.c
0270: 2c 76 20 31 2e 33 33 34 20 32 30 30 36 2f 30 32 ,v 1.334 2006/02
0280: 2f 30 39 20 31 33 3a 34 33 3a 32 39 20 64 61 6e /09 13:43:29 dan
0290: 69 65 6c 6b 31 39 37 37 20 45 78 70 20 24 0a 2a ielk1977 Exp $.*
02a0: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 /.#include "sqli
02b0: 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 teInt.h".#includ
02c0: 65 20 22 6f 73 2e 68 22 0a 23 69 6e 63 6c 75 64 e "os.h".#includ
02d0: 65 20 3c 63 74 79 70 65 2e 68 3e 0a 0a 2f 2a 0a e <ctype.h>../*.
02e0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
02f0: 20 63 6f 6e 73 74 61 6e 74 20 76 61 6c 75 65 20 constant value
0300: 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20 53 is used by the S
0310: 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 QLITE_BIGENDIAN
0320: 61 6e 64 0a 2a 2a 20 53 51 4c 49 54 45 5f 4c 49 and.** SQLITE_LI
0330: 54 54 4c 45 45 4e 44 49 41 4e 20 6d 61 63 72 6f TTLEENDIAN macro
0340: 73 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 69 6e 74 20 s..*/.const int
0350: 73 71 6c 69 74 65 33 6f 6e 65 20 3d 20 31 3b 0a sqlite3one = 1;.
0360: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76 65 72 73 69 ./*.** The versi
0370: 6f 6e 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72 on of the librar
0380: 79 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 y.*/.const char
0390: 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 5b sqlite3_version[
03a0: 5d 20 3d 20 53 51 4c 49 54 45 5f 56 45 52 53 49 ] = SQLITE_VERSI
03b0: 4f 4e 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a ON;.const char *
03c0: 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 sqlite3_libversi
03d0: 6f 6e 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e on(void){ return
03e0: 20 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e sqlite3_version
03f0: 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f ; }.int sqlite3_
0400: 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 65 libversion_numbe
0410: 72 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 r(void){ return
0420: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f 4e SQLITE_VERSION_N
0430: 55 4d 42 45 52 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 UMBER; }../*.**
0440: 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 This is the defa
0450: 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 ult collating fu
0460: 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 20 22 42 49 nction named "BI
0470: 4e 41 52 59 22 20 77 68 69 63 68 20 69 73 20 61 NARY" which is a
0480: 6c 77 61 79 73 0a 2a 2a 20 61 76 61 69 6c 61 62 lways.** availab
0490: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e le..*/.static in
04a0: 74 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 28 0a 20 t binCollFunc(.
04b0: 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a void *NotUsed,.
04c0: 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e int nKey1, con
04d0: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a st void *pKey1,.
04e0: 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e int nKey2, con
04f0: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 st void *pKey2.)
0500: 7b 0a 20 20 69 6e 74 20 72 63 2c 20 6e 3b 0a 20 {. int rc, n;.
0510: 20 6e 20 3d 20 6e 4b 65 79 31 3c 6e 4b 65 79 32 n = nKey1<nKey2
0520: 20 3f 20 6e 4b 65 79 31 20 3a 20 6e 4b 65 79 32 ? nKey1 : nKey2
0530: 3b 0a 20 20 72 63 20 3d 20 6d 65 6d 63 6d 70 28 ;. rc = memcmp(
0540: 70 4b 65 79 31 2c 20 70 4b 65 79 32 2c 20 6e 29 pKey1, pKey2, n)
0550: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b ;. if( rc==0 ){
0560: 0a 20 20 20 20 72 63 20 3d 20 6e 4b 65 79 31 20 . rc = nKey1
0570: 2d 20 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 20 72 - nKey2;. }. r
0580: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
0590: 2a 2a 20 41 6e 6f 74 68 65 72 20 62 75 69 6c 74 ** Another built
05a0: 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 -in collating se
05b0: 71 75 65 6e 63 65 3a 20 4e 4f 43 41 53 45 2e 20 quence: NOCASE.
05c0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 6f 6c 6c .**.** This coll
05d0: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 ating sequence i
05e0: 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 s intended to be
05f0: 20 75 73 65 64 20 66 6f 72 20 22 63 61 73 65 20 used for "case
0600: 69 6e 64 65 70 65 6e 64 61 6e 74 0a 2a 2a 20 63 independant.** c
0610: 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 53 51 4c 69 omparison". SQLi
0620: 74 65 27 73 20 6b 6e 6f 77 6c 65 64 67 65 20 6f te's knowledge o
0630: 66 20 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 65 f upper and lowe
0640: 72 20 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e r case equivalen
0650: 74 73 0a 2a 2a 20 65 78 74 65 6e 64 73 20 6f 6e ts.** extends on
0660: 6c 79 20 74 6f 20 74 68 65 20 32 36 20 63 68 61 ly to the 26 cha
0670: 72 61 63 74 65 72 73 20 75 73 65 64 20 69 6e 20 racters used in
0680: 74 68 65 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 the English lang
0690: 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 uage..**.** At t
06a0: 68 65 20 6d 6f 6d 65 6e 74 20 74 68 65 72 65 20 he moment there
06b0: 69 73 20 6f 6e 6c 79 20 61 20 55 54 46 2d 38 20 is only a UTF-8
06c0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a implementation..
06d0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f */.static int no
06e0: 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e caseCollatingFun
06f0: 63 28 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 c(. void *NotUs
0700: 65 64 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c ed,. int nKey1,
0710: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
0720: 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c y1,. int nKey2,
0730: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
0740: 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 y2.){. int r =
0750: 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 28 sqlite3StrNICmp(
0760: 0a 20 20 20 20 20 20 28 63 6f 6e 73 74 20 63 68 . (const ch
0770: 61 72 20 2a 29 70 4b 65 79 31 2c 20 28 63 6f 6e ar *)pKey1, (con
0780: 73 74 20 63 68 61 72 20 2a 29 70 4b 65 79 32 2c st char *)pKey2,
0790: 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 32 29 3f 6e (nKey1<nKey2)?n
07a0: 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 69 Key1:nKey2);. i
07b0: 66 28 20 30 3d 3d 72 20 29 7b 0a 20 20 20 20 72 f( 0==r ){. r
07c0: 20 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a = nKey1-nKey2;.
07d0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a }. return r;.
07e0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
07f0: 74 68 65 20 52 4f 57 49 44 20 6f 66 20 74 68 65 the ROWID of the
0800: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73 most recent ins
0810: 65 72 74 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e ert.*/.sqlite_in
0820: 74 36 34 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 t64 sqlite3_last
0830: 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 _insert_rowid(sq
0840: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 lite3 *db){. re
0850: 74 75 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 turn db->lastRow
0860: 69 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 id;.}../*.** Ret
0870: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f urn the number o
0880: 66 20 63 68 61 6e 67 65 73 20 69 6e 20 74 68 65 f changes in the
0890: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 61 6c most recent cal
08a0: 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 65 78 65 l to sqlite3_exe
08b0: 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 c()..*/.int sqli
08c0: 74 65 33 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 te3_changes(sqli
08d0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 te3 *db){. retu
08e0: 72 6e 20 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a rn db->nChange;.
08f0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
0900: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 the number of ch
0910: 61 6e 67 65 73 20 73 69 6e 63 65 20 74 68 65 20 anges since the
0920: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
0930: 77 61 73 20 6f 70 65 6e 65 64 2e 0a 2a 2f 0a 69 was opened..*/.i
0940: 6e 74 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c nt sqlite3_total
0950: 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 _changes(sqlite3
0960: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 *db){. return
0970: 64 62 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e 67 65 db->nTotalChange
0980: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 ;.}../*.** Close
0990: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c an existing SQL
09a0: 69 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a ite database.*/.
09b0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 int sqlite3_clos
09c0: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a e(sqlite3 *db){.
09d0: 20 20 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 HashElem *i;.
09e0: 20 69 6e 74 20 6a 3b 0a 0a 20 20 69 66 28 20 21 int j;.. if( !
09f0: 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e db ){. return
0a00: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
0a10: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 if( sqlite3Saf
0a20: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a etyCheck(db) ){.
0a30: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
0a40: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 23 E_MISUSE;. }..#
0a50: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 53 53 45 ifdef SQLITE_SSE
0a60: 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c . sqlite3_final
0a70: 69 7a 65 28 64 62 2d 3e 70 46 65 74 63 68 29 3b ize(db->pFetch);
0a80: 0a 23 65 6e 64 69 66 20 0a 0a 20 20 2f 2a 20 49 .#endif .. /* I
0a90: 66 20 74 68 65 72 65 20 61 72 65 20 61 6e 79 20 f there are any
0aa0: 6f 75 74 73 74 61 6e 64 69 6e 67 20 56 4d 73 2c outstanding VMs,
0ab0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 return SQLITE_B
0ac0: 55 53 59 2e 20 2a 2f 0a 20 20 69 66 28 20 64 62 USY. */. if( db
0ad0: 2d 3e 70 56 64 62 65 20 29 7b 0a 20 20 20 20 73 ->pVdbe ){. s
0ae0: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
0af0: 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a 20 20 SQLITE_BUSY, .
0b00: 20 20 20 20 20 20 22 55 6e 61 62 6c 65 20 74 6f "Unable to
0b10: 20 63 6c 6f 73 65 20 64 75 65 20 74 6f 20 75 6e close due to un
0b20: 66 69 6e 61 6c 69 73 65 64 20 73 74 61 74 65 6d finalised statem
0b30: 65 6e 74 73 22 29 3b 0a 20 20 20 20 72 65 74 75 ents");. retu
0b40: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a rn SQLITE_BUSY;.
0b50: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 21 73 }. assert( !s
0b60: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
0b70: 6b 28 64 62 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 k(db) );.. /* F
0b80: 49 58 20 4d 45 3a 20 64 62 2d 3e 6d 61 67 69 63 IX ME: db->magic
0b90: 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 53 may be set to S
0ba0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 QLITE_MAGIC_CLOS
0bb0: 45 44 20 69 66 20 74 68 65 20 64 61 74 61 62 61 ED if the databa
0bc0: 73 65 0a 20 20 2a 2a 20 63 61 6e 6e 6f 74 20 62 se. ** cannot b
0bd0: 65 20 6f 70 65 6e 65 64 20 66 6f 72 20 73 6f 6d e opened for som
0be0: 65 20 72 65 61 73 6f 6e 2e 20 53 6f 20 74 68 69 e reason. So thi
0bf0: 73 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 s routine needs
0c00: 74 6f 20 72 75 6e 20 69 6e 0a 20 20 2a 2a 20 74 to run in. ** t
0c10: 68 61 74 20 63 61 73 65 2e 20 42 75 74 20 6d 61 hat case. But ma
0c20: 79 62 65 20 74 68 65 72 65 20 73 68 6f 75 6c 64 ybe there should
0c30: 20 62 65 20 61 6e 20 65 78 74 72 61 20 6d 61 67 be an extra mag
0c40: 69 63 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65 ic value for the
0c50: 0a 20 20 2a 2a 20 22 66 61 69 6c 65 64 20 74 6f . ** "failed to
0c60: 20 6f 70 65 6e 22 20 73 74 61 74 65 2e 0a 20 20 open" state..
0c70: 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 67 */. if( db->mag
0c80: 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 ic!=SQLITE_MAGIC
0c90: 5f 43 4c 4f 53 45 44 20 26 26 20 73 71 6c 69 74 _CLOSED && sqlit
0ca0: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29 e3SafetyOn(db) )
0cb0: 7b 0a 20 20 20 20 2f 2a 20 70 72 69 6e 74 66 28 {. /* printf(
0cc0: 22 44 49 44 20 4e 4f 54 20 43 4c 4f 53 45 5c 6e "DID NOT CLOSE\n
0cd0: 22 29 3b 20 66 66 6c 75 73 68 28 73 74 64 6f 75 "); fflush(stdou
0ce0: 74 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 t); */. retur
0cf0: 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a n SQLITE_ERROR;.
0d00: 20 20 7d 0a 0a 20 20 66 6f 72 28 6a 3d 30 3b 20 }.. for(j=0;
0d10: 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 7b j<db->nDb; j++){
0d20: 0a 20 20 20 20 73 74 72 75 63 74 20 44 62 20 2a . struct Db *
0d30: 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62 5b 6a pDb = &db->aDb[j
0d40: 5d 3b 0a 20 20 20 20 69 66 28 20 70 44 62 2d 3e ];. if( pDb->
0d50: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c pBt ){. sql
0d60: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70 ite3BtreeClose(p
0d70: 44 62 2d 3e 70 42 74 29 3b 0a 20 20 20 20 20 20 Db->pBt);.
0d80: 70 44 62 2d 3e 70 42 74 20 3d 20 30 3b 0a 20 20 pDb->pBt = 0;.
0d90: 20 20 20 20 69 66 28 20 6a 21 3d 31 20 29 7b 0a if( j!=1 ){.
0da0: 20 20 20 20 20 20 20 20 70 44 62 2d 3e 70 53 63 pDb->pSc
0db0: 68 65 6d 61 20 3d 20 30 3b 0a 20 20 20 20 20 20 hema = 0;.
0dc0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 }. }. }. sq
0dd0: 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e lite3ResetIntern
0de0: 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b alSchema(db, 0);
0df0: 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e . assert( db->n
0e00: 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72 Db<=2 );. asser
0e10: 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e t( db->aDb==db->
0e20: 61 44 62 53 74 61 74 69 63 20 29 3b 0a 20 20 66 aDbStatic );. f
0e30: 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 or(i=sqliteHashF
0e40: 69 72 73 74 28 26 64 62 2d 3e 61 46 75 6e 63 29 irst(&db->aFunc)
0e50: 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 ; i; i=sqliteHas
0e60: 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 46 hNext(i)){. F
0e70: 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c 20 2a uncDef *pFunc, *
0e80: 70 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72 28 70 pNext;. for(p
0e90: 46 75 6e 63 20 3d 20 28 46 75 6e 63 44 65 66 2a Func = (FuncDef*
0ea0: 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 )sqliteHashData(
0eb0: 69 29 3b 20 70 46 75 6e 63 3b 20 70 46 75 6e 63 i); pFunc; pFunc
0ec0: 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 70 =pNext){. p
0ed0: 4e 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e 70 4e Next = pFunc->pN
0ee0: 65 78 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 ext;. sqlit
0ef0: 65 46 72 65 65 28 70 46 75 6e 63 29 3b 0a 20 20 eFree(pFunc);.
0f00: 20 20 7d 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 69 }. }.. for(i
0f10: 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74 =sqliteHashFirst
0f20: 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b (&db->aCollSeq);
0f30: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 i; i=sqliteHash
0f40: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43 6f Next(i)){. Co
0f50: 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28 llSeq *pColl = (
0f60: 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74 65 CollSeq *)sqlite
0f70: 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 20 HashData(i);.
0f80: 20 73 71 6c 69 74 65 46 72 65 65 28 70 43 6f 6c sqliteFree(pCol
0f90: 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 l);. }. sqlite
0fa0: 33 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 3HashClear(&db->
0fb0: 61 43 6f 6c 6c 53 65 71 29 3b 0a 0a 20 20 73 71 aCollSeq);.. sq
0fc0: 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 lite3HashClear(&
0fd0: 64 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 73 71 db->aFunc);. sq
0fe0: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 lite3Error(db, S
0ff0: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 2f 2a QLITE_OK, 0); /*
1000: 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 6e 79 Deallocates any
1010: 20 63 61 63 68 65 64 20 65 72 72 6f 72 20 73 74 cached error st
1020: 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 28 20 rings. */. if(
1030: 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20 db->pErr ){.
1040: 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 sqlite3ValueFree
1050: 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 7d 0a (db->pErr);. }.
1060: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 . db->magic = S
1070: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f QLITE_MAGIC_ERRO
1080: 52 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 74 65 6d R;.. /* The tem
1090: 70 2d 64 61 74 61 62 61 73 65 20 73 63 68 65 6d p-database schem
10a0: 61 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 a is allocated d
10b0: 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 ifferently from
10c0: 74 68 65 20 6f 74 68 65 72 20 73 63 68 65 6d 61 the other schema
10d0: 0a 20 20 2a 2a 20 6f 62 6a 65 63 74 73 20 28 75 . ** objects (u
10e0: 73 69 6e 67 20 73 71 6c 69 74 65 4d 61 6c 6c 6f sing sqliteMallo
10f0: 63 28 29 20 64 69 72 65 63 74 6c 79 2c 20 69 6e c() directly, in
1100: 73 74 65 61 64 20 6f 66 20 73 71 6c 69 74 65 33 stead of sqlite3
1110: 42 74 72 65 65 53 63 68 65 6d 61 28 29 29 2e 0a BtreeSchema())..
1120: 20 20 2a 2a 20 53 6f 20 69 74 20 6e 65 65 64 73 ** So it needs
1130: 20 74 6f 20 62 65 20 66 72 65 65 64 20 68 65 72 to be freed her
1140: 65 2e 20 54 6f 64 6f 3a 20 57 68 79 20 6e 6f 74 e. Todo: Why not
1150: 20 72 6f 6c 6c 20 74 68 65 20 74 65 6d 70 20 73 roll the temp s
1160: 63 68 65 6d 61 20 69 6e 74 6f 0a 20 20 2a 2a 20 chema into. **
1170: 74 68 65 20 73 61 6d 65 20 73 71 6c 69 74 65 4d the same sqliteM
1180: 61 6c 6c 6f 63 28 29 20 61 73 20 74 68 65 20 6f alloc() as the o
1190: 6e 65 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 65 ne that allocate
11a0: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a s the database .
11b0: 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 3f 0a ** structure?.
11c0: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 46 72 65 */. sqliteFre
11d0: 65 28 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 e(db->aDb[1].pSc
11e0: 68 65 6d 61 29 3b 0a 20 20 73 71 6c 69 74 65 46 hema);. sqliteF
11f0: 72 65 65 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 ree(db);. sqlit
1200: 65 33 52 65 6c 65 61 73 65 54 68 72 65 61 64 44 e3ReleaseThreadD
1210: 61 74 61 28 29 3b 0a 20 20 72 65 74 75 72 6e 20 ata();. return
1220: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
1230: 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c .** Rollback all
1240: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e database files.
1250: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
1260: 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 6c 69 RollbackAll(sqli
1270: 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 te3 *db){. int
1280: 69 3b 0a 20 20 69 6e 74 20 69 6e 54 72 61 6e 73 i;. int inTrans
1290: 20 3d 20 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b = 0;. for(i=0;
12a0: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 i<db->nDb; i++)
12b0: 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 44 {. if( db->aD
12c0: 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20 20 20 20 b[i].pBt ){.
12d0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 74 72 if( sqlite3Btr
12e0: 65 65 49 73 49 6e 54 72 61 6e 73 28 64 62 2d 3e eeIsInTrans(db->
12f0: 61 44 62 5b 69 5d 2e 70 42 74 29 20 29 7b 0a 20 aDb[i].pBt) ){.
1300: 20 20 20 20 20 20 20 69 6e 54 72 61 6e 73 20 3d inTrans =
1310: 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 1;. }.
1320: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f sqlite3BtreeRo
1330: 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44 62 5b 69 llback(db->aDb[i
1340: 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20 20 64 62 ].pBt);. db
1350: 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72 61 6e 73 ->aDb[i].inTrans
1360: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a = 0;. }. }.
1370: 20 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 26 if( db->flags&
1380: 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 SQLITE_InternCha
1390: 6e 67 65 73 20 29 7b 0a 20 20 20 20 73 71 6c 69 nges ){. sqli
13a0: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c te3ResetInternal
13b0: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 Schema(db, 0);.
13c0: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 6f 6e 65 20 }.. /* If one
13d0: 68 61 73 20 62 65 65 6e 20 63 6f 6e 66 69 67 75 has been configu
13e0: 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 red, invoke the
13f0: 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b 20 63 61 rollback-hook ca
1400: 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 66 28 20 llback */. if(
1410: 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c db->xRollbackCal
1420: 6c 62 61 63 6b 20 26 26 20 28 69 6e 54 72 61 6e lback && (inTran
1430: 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74 6f 43 6f s || !db->autoCo
1440: 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20 64 62 2d mmit) ){. db-
1450: 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 >xRollbackCallba
1460: 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b ck(db->pRollback
1470: 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a Arg);. }.}../*.
1480: 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 74 ** Return a stat
1490: 69 63 20 73 74 72 69 6e 67 20 74 68 61 74 20 64 ic string that d
14a0: 65 73 63 72 69 62 65 73 20 74 68 65 20 6b 69 6e escribes the kin
14b0: 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 63 69 d of error speci
14c0: 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61 fied in the.** a
14d0: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 rgument..*/.cons
14e0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 45 t char *sqlite3E
14f0: 72 72 53 74 72 28 69 6e 74 20 72 63 29 7b 0a 20 rrStr(int rc){.
1500: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a const char *z;.
1510: 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a switch( rc ){.
1520: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1530: 52 4f 57 3a 0a 20 20 20 20 63 61 73 65 20 53 51 ROW:. case SQ
1540: 4c 49 54 45 5f 44 4f 4e 45 3a 0a 20 20 20 20 63 LITE_DONE:. c
1550: 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a 20 20 ase SQLITE_OK:
1560: 20 20 20 20 20 20 20 7a 20 3d 20 22 6e 6f 74 20 z = "not
1570: 61 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20 20 an error";
1580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1590: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
15a0: 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 ase SQLITE_ERROR
15b0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 53 51 4c 20 : z = "SQL
15c0: 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72 20 6d logic error or m
15d0: 69 73 73 69 6e 67 20 64 61 74 61 62 61 73 65 22 issing database"
15e0: 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 ; break;. c
15f0: 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52 4d 3a ase SQLITE_PERM:
1600: 20 20 20 20 20 20 20 7a 20 3d 20 22 61 63 63 65 z = "acce
1610: 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 20 64 65 ss permission de
1620: 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 nied";
1630: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1640: 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 ase SQLITE_ABORT
1650: 3a 20 20 20 20 20 20 7a 20 3d 20 22 63 61 6c 6c : z = "call
1660: 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 20 71 back requested q
1670: 75 65 72 79 20 61 62 6f 72 74 22 3b 20 20 20 20 uery abort";
1680: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1690: 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 3a ase SQLITE_BUSY:
16a0: 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 z = "data
16b0: 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 3b base is locked";
16c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
16e0: 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 ase SQLITE_LOCKE
16f0: 44 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 D: z = "data
1700: 62 61 73 65 20 74 61 62 6c 65 20 69 73 20 6c 6f base table is lo
1710: 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 cked";
1720: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1730: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d ase SQLITE_NOMEM
1740: 3a 20 20 20 20 20 20 7a 20 3d 20 22 6f 75 74 20 : z = "out
1750: 6f 66 20 6d 65 6d 6f 72 79 22 3b 20 20 20 20 20 of memory";
1760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1770: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1780: 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f ase SQLITE_READO
1790: 4e 4c 59 3a 20 20 20 7a 20 3d 20 22 61 74 74 65 NLY: z = "atte
17a0: 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61 20 72 mpt to write a r
17b0: 65 61 64 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 eadonly database
17c0: 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 "; break;. c
17d0: 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 ase SQLITE_INTER
17e0: 52 55 50 54 3a 20 20 7a 20 3d 20 22 69 6e 74 65 RUPT: z = "inte
17f0: 72 72 75 70 74 65 64 22 3b 20 20 20 20 20 20 20 rrupted";
1800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1810: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1820: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
1830: 3a 20 20 20 20 20 20 7a 20 3d 20 22 64 69 73 6b : z = "disk
1840: 20 49 2f 4f 20 65 72 72 6f 72 22 3b 20 20 20 20 I/O error";
1850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1860: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1870: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 ase SQLITE_CORRU
1880: 50 54 3a 20 20 20 20 7a 20 3d 20 22 64 61 74 61 PT: z = "data
1890: 62 61 73 65 20 64 69 73 6b 20 69 6d 61 67 65 20 base disk image
18a0: 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22 3b 20 20 is malformed";
18b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
18c0: 61 73 65 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3a ase SQLITE_FULL:
18d0: 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 z = "data
18e0: 62 61 73 65 20 6f 72 20 64 69 73 6b 20 69 73 20 base or disk is
18f0: 66 75 6c 6c 22 3b 20 20 20 20 20 20 20 20 20 20 full";
1900: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1910: 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f ase SQLITE_CANTO
1920: 50 45 4e 3a 20 20 20 7a 20 3d 20 22 75 6e 61 62 PEN: z = "unab
1930: 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62 le to open datab
1940: 61 73 65 20 66 69 6c 65 22 3b 20 20 20 20 20 20 ase file";
1950: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1960: 61 73 65 20 53 51 4c 49 54 45 5f 50 52 4f 54 4f ase SQLITE_PROTO
1970: 43 4f 4c 3a 20 20 20 7a 20 3d 20 22 64 61 74 61 COL: z = "data
1980: 62 61 73 65 20 6c 6f 63 6b 69 6e 67 20 70 72 6f base locking pro
1990: 74 6f 63 6f 6c 20 66 61 69 6c 75 72 65 22 3b 20 tocol failure";
19a0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
19b0: 61 73 65 20 53 51 4c 49 54 45 5f 45 4d 50 54 59 ase SQLITE_EMPTY
19c0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 74 61 62 6c : z = "tabl
19d0: 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 64 61 e contains no da
19e0: 74 61 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 ta";
19f0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1a00: 61 73 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d ase SQLITE_SCHEM
1a10: 41 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 A: z = "data
1a20: 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 base schema has
1a30: 63 68 61 6e 67 65 64 22 3b 20 20 20 20 20 20 20 changed";
1a40: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1a50: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 ase SQLITE_CONST
1a60: 52 41 49 4e 54 3a 20 7a 20 3d 20 22 63 6f 6e 73 RAINT: z = "cons
1a70: 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 3b 20 traint failed";
1a80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a90: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1aa0: 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41 ase SQLITE_MISMA
1ab0: 54 43 48 3a 20 20 20 7a 20 3d 20 22 64 61 74 61 TCH: z = "data
1ac0: 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22 3b 20 type mismatch";
1ad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ae0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1af0: 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 ase SQLITE_MISUS
1b00: 45 3a 20 20 20 20 20 7a 20 3d 20 22 6c 69 62 72 E: z = "libr
1b10: 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c ary routine call
1b20: 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e ed out of sequen
1b30: 63 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 63 ce";break;. c
1b40: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 ase SQLITE_NOLFS
1b50: 3a 20 20 20 20 20 20 7a 20 3d 20 22 6b 65 72 6e : z = "kern
1b60: 65 6c 20 6c 61 63 6b 73 20 6c 61 72 67 65 20 66 el lacks large f
1b70: 69 6c 65 20 73 75 70 70 6f 72 74 22 3b 20 20 20 ile support";
1b80: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1b90: 61 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48 3a ase SQLITE_AUTH:
1ba0: 20 20 20 20 20 20 20 7a 20 3d 20 22 61 75 74 68 z = "auth
1bb0: 6f 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69 65 64 orization denied
1bc0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ";
1bd0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1be0: 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 ase SQLITE_FORMA
1bf0: 54 3a 20 20 20 20 20 7a 20 3d 20 22 61 75 78 69 T: z = "auxi
1c00: 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 20 66 liary database f
1c10: 6f 72 6d 61 74 20 65 72 72 6f 72 22 3b 20 20 20 ormat error";
1c20: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1c30: 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 ase SQLITE_RANGE
1c40: 3a 20 20 20 20 20 20 7a 20 3d 20 22 62 69 6e 64 : z = "bind
1c50: 20 6f 72 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 or column index
1c60: 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 22 3b 20 out of range";
1c70: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
1c80: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 ase SQLITE_NOTAD
1c90: 42 3a 20 20 20 20 20 7a 20 3d 20 22 66 69 6c 65 B: z = "file
1ca0: 20 69 73 20 65 6e 63 72 79 70 74 65 64 20 6f 72 is encrypted or
1cb0: 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61 62 61 is not a databa
1cc0: 73 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 64 se";break;. d
1cd0: 65 66 61 75 6c 74 3a 20 20 20 20 20 20 20 20 20 efault:
1ce0: 20 20 20 20 20 20 20 7a 20 3d 20 22 75 6e 6b 6e z = "unkn
1cf0: 6f 77 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20 own error";
1d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d10: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 break;. }.
1d20: 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f 2a return z;.}../*
1d30: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
1d40: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62 75 implements a bu
1d50: 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61 74 sy callback that
1d60: 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69 65 sleeps and trie
1d70: 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69 6c s.** again until
1d80: 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 a timeout value
1d90: 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 54 68 is reached. Th
1da0: 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20 e timeout value
1db0: 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 is.** an integer
1dc0: 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 number of milli
1dd0: 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20 69 seconds passed i
1de0: 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a n as the first.*
1df0: 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 * argument..*/.s
1e00: 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 tatic int sqlite
1e10: 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 DefaultBusyCallb
1e20: 61 63 6b 28 0a 20 76 6f 69 64 20 2a 70 74 72 2c ack(. void *ptr,
1e30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1e40: 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 * Database conne
1e50: 63 74 69 6f 6e 20 2a 2f 0a 20 69 6e 74 20 63 6f ction */. int co
1e60: 75 6e 74 20 20 20 20 20 20 20 20 20 20 20 20 20 unt
1e70: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
1e80: 74 69 6d 65 73 20 74 61 62 6c 65 20 68 61 73 20 times table has
1e90: 62 65 65 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a been busy */.){.
1ea0: 23 69 66 20 53 51 4c 49 54 45 5f 4d 49 4e 5f 53 #if SQLITE_MIN_S
1eb0: 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20 20 73 74 61 LEEP_MS==1. sta
1ec0: 74 69 63 20 63 6f 6e 73 74 20 75 38 20 64 65 6c tic const u8 del
1ed0: 61 79 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 31 ays[] =. { 1
1ee0: 2c 20 32 2c 20 35 2c 20 31 30 2c 20 31 35 2c 20 , 2, 5, 10, 15,
1ef0: 32 30 2c 20 32 35 2c 20 32 35 2c 20 20 32 35 2c 20, 25, 25, 25,
1f00: 20 20 35 30 2c 20 20 35 30 2c 20 31 30 30 20 7d 50, 50, 100 }
1f10: 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 ;. static const
1f20: 20 75 38 20 74 6f 74 61 6c 73 5b 5d 20 3d 0a 20 u8 totals[] =.
1f30: 20 20 20 20 7b 20 30 2c 20 31 2c 20 33 2c 20 20 { 0, 1, 3,
1f40: 38 2c 20 31 38 2c 20 33 33 2c 20 35 33 2c 20 37 8, 18, 33, 53, 7
1f50: 38 2c 20 31 30 33 2c 20 31 32 38 2c 20 31 37 38 8, 103, 128, 178
1f60: 2c 20 32 32 38 20 7d 3b 0a 23 20 64 65 66 69 6e , 228 };.# defin
1f70: 65 20 4e 44 45 4c 41 59 20 28 73 69 7a 65 6f 66 e NDELAY (sizeof
1f80: 28 64 65 6c 61 79 73 29 2f 73 69 7a 65 6f 66 28 (delays)/sizeof(
1f90: 64 65 6c 61 79 73 5b 30 5d 29 29 0a 20 20 69 6e delays[0])). in
1fa0: 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 28 73 71 t timeout = ((sq
1fb0: 6c 69 74 65 33 20 2a 29 70 74 72 29 2d 3e 62 75 lite3 *)ptr)->bu
1fc0: 73 79 54 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 syTimeout;. int
1fd0: 20 64 65 6c 61 79 2c 20 70 72 69 6f 72 3b 0a 0a delay, prior;..
1fe0: 20 20 61 73 73 65 72 74 28 20 63 6f 75 6e 74 3e assert( count>
1ff0: 3d 30 20 29 3b 0a 20 20 69 66 28 20 63 6f 75 6e =0 );. if( coun
2000: 74 20 3c 20 4e 44 45 4c 41 59 20 29 7b 0a 20 20 t < NDELAY ){.
2010: 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 delay = delays
2020: 5b 63 6f 75 6e 74 5d 3b 0a 20 20 20 20 70 72 69 [count];. pri
2030: 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 63 6f 75 6e or = totals[coun
2040: 74 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 t];. }else{.
2050: 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b delay = delays[
2060: 4e 44 45 4c 41 59 2d 31 5d 3b 0a 20 20 20 20 70 NDELAY-1];. p
2070: 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 4e 44 rior = totals[ND
2080: 45 4c 41 59 2d 31 5d 20 2b 20 64 65 6c 61 79 2a ELAY-1] + delay*
2090: 28 63 6f 75 6e 74 2d 28 4e 44 45 4c 41 59 2d 31 (count-(NDELAY-1
20a0: 29 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 72 ));. }. if( pr
20b0: 69 6f 72 20 2b 20 64 65 6c 61 79 20 3e 20 74 69 ior + delay > ti
20c0: 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 64 65 6c meout ){. del
20d0: 61 79 20 3d 20 74 69 6d 65 6f 75 74 20 2d 20 70 ay = timeout - p
20e0: 72 69 6f 72 3b 0a 20 20 20 20 69 66 28 20 64 65 rior;. if( de
20f0: 6c 61 79 3c 3d 30 20 29 20 72 65 74 75 72 6e 20 lay<=0 ) return
2100: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 0;. }. sqlite3
2110: 4f 73 53 6c 65 65 70 28 64 65 6c 61 79 29 3b 0a OsSleep(delay);.
2120: 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6c 73 return 1;.#els
2130: 65 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 e. int timeout
2140: 3d 20 28 28 73 71 6c 69 74 65 33 20 2a 29 70 74 = ((sqlite3 *)pt
2150: 72 29 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b r)->busyTimeout;
2160: 0a 20 20 69 66 28 20 28 63 6f 75 6e 74 2b 31 29 . if( (count+1)
2170: 2a 31 30 30 30 20 3e 20 74 69 6d 65 6f 75 74 20 *1000 > timeout
2180: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b ){. return 0;
2190: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 . }. sqlite3Os
21a0: 53 6c 65 65 70 28 31 30 30 30 29 3b 0a 20 20 72 Sleep(1000);. r
21b0: 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a eturn 1;.#endif.
21c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 }../*.** Invoke
21d0: 74 68 65 20 67 69 76 65 6e 20 62 75 73 79 20 68 the given busy h
21e0: 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 andler..**.** Th
21f0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 is routine is ca
2200: 6c 6c 65 64 20 77 68 65 6e 20 61 6e 20 6f 70 65 lled when an ope
2210: 72 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 77 69 ration failed wi
2220: 74 68 20 61 20 6c 6f 63 6b 2e 0a 2a 2a 20 49 66 th a lock..** If
2230: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 this routine re
2240: 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 turns non-zero,
2250: 74 68 65 20 6c 6f 63 6b 20 69 73 20 72 65 74 72 the lock is retr
2260: 69 65 64 2e 20 20 49 66 20 69 74 0a 2a 2a 20 72 ied. If it.** r
2270: 65 74 75 72 6e 73 20 30 2c 20 74 68 65 20 6f 70 eturns 0, the op
2280: 65 72 61 74 69 6f 6e 20 61 62 6f 72 74 73 20 77 eration aborts w
2290: 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f 42 55 ith an SQLITE_BU
22a0: 53 59 20 65 72 72 6f 72 2e 0a 2a 2f 0a 69 6e 74 SY error..*/.int
22b0: 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 75 sqlite3InvokeBu
22c0: 73 79 48 61 6e 64 6c 65 72 28 42 75 73 79 48 61 syHandler(BusyHa
22d0: 6e 64 6c 65 72 20 2a 70 29 7b 0a 20 20 69 6e 74 ndler *p){. int
22e0: 20 72 63 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 rc;. if( p==0
22f0: 7c 7c 20 70 2d 3e 78 46 75 6e 63 3d 3d 30 20 7c || p->xFunc==0 |
2300: 7c 20 70 2d 3e 6e 42 75 73 79 3c 30 20 29 20 72 | p->nBusy<0 ) r
2310: 65 74 75 72 6e 20 30 3b 0a 20 20 72 63 20 3d 20 eturn 0;. rc =
2320: 70 2d 3e 78 46 75 6e 63 28 70 2d 3e 70 41 72 67 p->xFunc(p->pArg
2330: 2c 20 70 2d 3e 6e 42 75 73 79 29 3b 0a 20 20 69 , p->nBusy);. i
2340: 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 f( rc==0 ){.
2350: 70 2d 3e 6e 42 75 73 79 20 3d 20 2d 31 3b 0a 20 p->nBusy = -1;.
2360: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 6e }else{. p->n
2370: 42 75 73 79 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 Busy++;. }. re
2380: 74 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a 2f 2a 0a turn rc; .}../*.
2390: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
23a0: 73 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61 sets the busy ca
23b0: 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 llback for an Sq
23c0: 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f lite database to
23d0: 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 the.** given ca
23e0: 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 llback function
23f0: 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 with the given a
2400: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 rgument..*/.int
2410: 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e sqlite3_busy_han
2420: 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33 20 dler(. sqlite3
2430: 2a 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 *db,. int (*xBu
2440: 73 79 29 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a sy)(void*,int),.
2450: 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a void *pArg.){.
2460: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 if( sqlite3Saf
2470: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a etyCheck(db) ){.
2480: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2490: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 E_MISUSE;. }.
24a0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e db->busyHandler.
24b0: 78 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a 20 xFunc = xBusy;.
24c0: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 db->busyHandler
24d0: 2e 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 .pArg = pArg;.
24e0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e db->busyHandler.
24f0: 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 72 65 74 nBusy = 0;. ret
2500: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
2510: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
2520: 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 5f 43 _OMIT_PROGRESS_C
2530: 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 54 68 ALLBACK./*.** Th
2540: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 is routine sets
2550: 74 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c the progress cal
2560: 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c lback for an Sql
2570: 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 ite database to
2580: 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c the.** given cal
2590: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 lback function w
25a0: 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 ith the given ar
25b0: 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 72 6f 67 gument. The prog
25c0: 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 77 69 ress callback wi
25d0: 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64 ll.** be invoked
25e0: 20 65 76 65 72 79 20 6e 4f 70 73 20 6f 70 63 6f every nOps opco
25f0: 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c des..*/.void sql
2600: 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 ite3_progress_ha
2610: 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33 ndler(. sqlite3
2620: 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e 4f 70 *db, . int nOp
2630: 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72 6f 67 s,. int (*xProg
2640: 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20 0a 20 ress)(void*), .
2650: 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 void *pArg.){.
2660: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
2670: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a etyCheck(db) ){.
2680: 20 20 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 29 if( nOps>0 )
2690: 7b 0a 20 20 20 20 20 20 64 62 2d 3e 78 50 72 6f {. db->xPro
26a0: 67 72 65 73 73 20 3d 20 78 50 72 6f 67 72 65 73 gress = xProgres
26b0: 73 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6e 50 72 s;. db->nPr
26c0: 6f 67 72 65 73 73 4f 70 73 20 3d 20 6e 4f 70 73 ogressOps = nOps
26d0: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 70 50 72 6f ;. db->pPro
26e0: 67 72 65 73 73 41 72 67 20 3d 20 70 41 72 67 3b gressArg = pArg;
26f0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
2700: 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 db->xProgress
2710: 3d 20 30 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6e = 0;. db->n
2720: 50 72 6f 67 72 65 73 73 4f 70 73 20 3d 20 30 3b ProgressOps = 0;
2730: 0a 20 20 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 . db->pProg
2740: 72 65 73 73 41 72 67 20 3d 20 30 3b 0a 20 20 20 ressArg = 0;.
2750: 20 7d 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a }. }.}.#endif.
2760: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
2770: 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 tine installs a
2780: 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e default busy han
2790: 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20 dler that waits
27a0: 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 for the.** speci
27b0: 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d fied number of m
27c0: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f illiseconds befo
27d0: 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a re returning 0..
27e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 */.int sqlite3_b
27f0: 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 usy_timeout(sqli
2800: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 te3 *db, int ms)
2810: 7b 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a {. if( ms>0 ){.
2820: 20 20 20 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 db->busyTime
2830: 6f 75 74 20 3d 20 6d 73 3b 0a 20 20 20 20 73 71 out = ms;. sq
2840: 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c lite3_busy_handl
2850: 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65 66 er(db, sqliteDef
2860: 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b aultBusyCallback
2870: 2c 20 28 76 6f 69 64 2a 29 64 62 29 3b 0a 20 20 , (void*)db);.
2880: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 }else{. sqlit
2890: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 e3_busy_handler(
28a0: 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 db, 0, 0);. }.
28b0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
28c0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 K;.}../*.** Caus
28d0: 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 e any pending op
28e0: 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 eration to stop
28f0: 61 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20 at its earliest
2900: 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a opportunity..*/.
2910: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 6e 74 void sqlite3_int
2920: 65 72 72 75 70 74 28 73 71 6c 69 74 65 33 20 2a errupt(sqlite3 *
2930: 64 62 29 7b 0a 20 20 69 66 28 20 21 73 71 6c 69 db){. if( !sqli
2940: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 te3SafetyCheck(d
2950: 62 29 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c b) ){. db->fl
2960: 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 49 6e ags |= SQLITE_In
2970: 74 65 72 72 75 70 74 3b 0a 20 20 7d 0a 7d 0a 0a terrupt;. }.}..
2980: 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77 73 20 73 79 /*.** Windows sy
2990: 73 74 65 6d 73 20 73 68 6f 75 6c 64 20 63 61 6c stems should cal
29a0: 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74 l this routine t
29b0: 6f 20 66 72 65 65 20 6d 65 6d 6f 72 79 20 74 68 o free memory th
29c0: 61 74 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 at.** is returne
29d0: 64 20 69 6e 20 74 68 65 20 69 6e 20 74 68 65 20 d in the in the
29e0: 65 72 72 6d 73 67 20 70 61 72 61 6d 65 74 65 72 errmsg parameter
29f0: 20 6f 66 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e of sqlite3_open
2a00: 28 29 20 77 68 65 6e 0a 2a 2a 20 53 51 4c 69 74 () when.** SQLit
2a10: 65 20 69 73 20 61 20 44 4c 4c 2e 20 20 46 6f 72 e is a DLL. For
2a20: 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c 20 69 74 some reason, it
2a30: 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 74 does not work t
2a40: 6f 20 63 61 6c 6c 20 66 72 65 65 28 29 0a 2a 2a o call free().**
2a50: 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a directly..**.**
2a60: 20 4e 6f 74 65 20 74 68 61 74 20 77 65 20 6e 65 Note that we ne
2a70: 65 64 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28 ed to call free(
2a80: 29 20 6e 6f 74 20 73 71 6c 69 74 65 46 72 65 65 ) not sqliteFree
2a90: 28 29 20 68 65 72 65 2e 0a 2a 2f 0a 76 6f 69 64 () here..*/.void
2aa0: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 63 68 sqlite3_free(ch
2ab0: 61 72 20 2a 70 29 7b 20 66 72 65 65 28 70 29 3b ar *p){ free(p);
2ac0: 20 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 }../*.** This f
2ad0: 75 6e 63 74 69 6f 6e 20 69 73 20 65 78 61 63 74 unction is exact
2ae0: 6c 79 20 74 68 65 20 73 61 6d 65 20 61 73 20 73 ly the same as s
2af0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 qlite3_create_fu
2b00: 6e 63 74 69 6f 6e 28 29 2c 20 65 78 63 65 70 74 nction(), except
2b10: 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 73 20 64 .** that it is d
2b20: 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20 63 61 esigned to be ca
2b30: 6c 6c 65 64 20 62 79 20 69 6e 74 65 72 6e 61 6c lled by internal
2b40: 20 63 6f 64 65 2e 20 54 68 65 20 64 69 66 66 65 code. The diffe
2b50: 72 65 6e 63 65 20 69 73 0a 2a 2a 20 74 68 61 74 rence is.** that
2b60: 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 if a malloc() f
2b70: 61 69 6c 73 20 69 6e 20 73 71 6c 69 74 65 33 5f ails in sqlite3_
2b80: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 create_function(
2b90: 29 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 ), an error code
2ba0: 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20 .** is returned
2bb0: 61 6e 64 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 and the mallocFa
2bc0: 69 6c 65 64 20 66 6c 61 67 20 63 6c 65 61 72 65 iled flag cleare
2bd0: 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 d. .*/.int sqlit
2be0: 65 33 43 72 65 61 74 65 46 75 6e 63 28 0a 20 20 e3CreateFunc(.
2bf0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 sqlite3 *db,. c
2c00: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 onst char *zFunc
2c10: 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 tionName,. int
2c20: 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c nArg,. int enc,
2c30: 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 . void *pUserDa
2c40: 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 ta,. void (*xFu
2c50: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 nc)(sqlite3_cont
2c60: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
2c70: 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f _value **),. vo
2c80: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 id (*xStep)(sqli
2c90: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 te3_context*,int
2ca0: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a ,sqlite3_value *
2cb0: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 *),. void (*xFi
2cc0: 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e nal)(sqlite3_con
2cd0: 74 65 78 74 2a 29 0a 29 7b 0a 20 20 46 75 6e 63 text*).){. Func
2ce0: 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e Def *p;. int nN
2cf0: 61 6d 65 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69 ame;.. if( sqli
2d00: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 te3SafetyCheck(d
2d10: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e b) ){. return
2d20: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a SQLITE_MISUSE;.
2d30: 20 20 7d 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 }. if( zFunct
2d40: 69 6f 6e 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 ionName==0 ||.
2d50: 20 20 20 20 28 78 46 75 6e 63 20 26 26 20 28 78 (xFunc && (x
2d60: 46 69 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 Final || xStep))
2d70: 20 7c 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75 || . (!xFu
2d80: 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26 nc && (xFinal &&
2d90: 20 21 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 !xStep)) ||.
2da0: 20 20 20 28 21 78 46 75 6e 63 20 26 26 20 28 21 (!xFunc && (!
2db0: 78 46 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29 xFinal && xStep)
2dc0: 29 20 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67 ) ||. (nArg
2dd0: 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 31 32 37 29 <-1 || nArg>127)
2de0: 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 35 3c 28 ||. (255<(
2df0: 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a nName = strlen(z
2e00: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20 FunctionName)))
2e10: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
2e20: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a LITE_ERROR;. }.
2e30: 20 20 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 .#ifndef SQLIT
2e40: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 2f E_OMIT_UTF16. /
2e50: 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 46 31 * If SQLITE_UTF1
2e60: 36 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61 6 is specified a
2e70: 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 74 s the encoding t
2e80: 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74 ype, transform t
2e90: 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 his. ** to one
2ea0: 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c of SQLITE_UTF16L
2eb0: 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31 E or SQLITE_UTF1
2ec0: 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a 20 20 6BE using the.
2ed0: 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e ** SQLITE_UTF16N
2ee0: 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c ATIVE macro. SQL
2ef0: 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e 6f 74 ITE_UTF16 is not
2f00: 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 used internally
2f10: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 53 .. **. ** If S
2f20: 51 4c 49 54 45 5f 41 4e 59 20 69 73 20 73 70 65 QLITE_ANY is spe
2f30: 63 69 66 69 65 64 2c 20 61 64 64 20 74 68 72 65 cified, add thre
2f40: 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 e versions of th
2f50: 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 e function. **
2f60: 74 6f 20 74 68 65 20 68 61 73 68 20 74 61 62 6c to the hash tabl
2f70: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 6e e.. */. if( en
2f80: 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 c==SQLITE_UTF16
2f90: 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 4c ){. enc = SQL
2fa0: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b ITE_UTF16NATIVE;
2fb0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 65 6e 63 . }else if( enc
2fc0: 3d 3d 53 51 4c 49 54 45 5f 41 4e 59 20 29 7b 0a ==SQLITE_ANY ){.
2fd0: 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 int rc;.
2fe0: 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 rc = sqlite3Crea
2ff0: 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 teFunc(db, zFunc
3000: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 tionName, nArg,
3010: 53 51 4c 49 54 45 5f 55 54 46 38 2c 0a 20 20 20 SQLITE_UTF8,.
3020: 20 20 20 20 20 20 70 55 73 65 72 44 61 74 61 2c pUserData,
3030: 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 xFunc, xStep, x
3040: 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 66 28 20 Final);. if(
3050: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
3060: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 72 return rc;. r
3070: 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 c = sqlite3Creat
3080: 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 eFunc(db, zFunct
3090: 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 ionName, nArg, S
30a0: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 0a 20 QLITE_UTF16LE,.
30b0: 20 20 20 20 20 20 20 70 55 73 65 72 44 61 74 61 pUserData
30c0: 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 , xFunc, xStep,
30d0: 78 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 66 28 xFinal);. if(
30e0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
30f0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
3100: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 enc = SQLITE_UTF
3110: 31 36 42 45 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a 16BE;. }.#else.
3120: 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 enc = SQLITE_U
3130: 54 46 38 3b 0a 23 65 6e 64 69 66 0a 20 20 0a 20 TF8;.#endif. .
3140: 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 20 /* Check if an
3150: 65 78 69 73 74 69 6e 67 20 66 75 6e 63 74 69 6f existing functio
3160: 6e 20 69 73 20 62 65 69 6e 67 20 6f 76 65 72 72 n is being overr
3170: 69 64 64 65 6e 20 6f 72 20 64 65 6c 65 74 65 64 idden or deleted
3180: 2e 20 49 66 20 73 6f 2c 0a 20 20 2a 2a 20 61 6e . If so,. ** an
3190: 64 20 74 68 65 72 65 20 61 72 65 20 61 63 74 69 d there are acti
31a0: 76 65 20 56 4d 73 2c 20 74 68 65 6e 20 72 65 74 ve VMs, then ret
31b0: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e urn SQLITE_BUSY.
31c0: 20 49 66 20 61 20 66 75 6e 63 74 69 6f 6e 0a 20 If a function.
31d0: 20 2a 2a 20 69 73 20 62 65 69 6e 67 20 6f 76 65 ** is being ove
31e0: 72 72 69 64 64 65 6e 2f 64 65 6c 65 74 65 64 20 rridden/deleted
31f0: 62 75 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f but there are no
3200: 20 61 63 74 69 76 65 20 56 4d 73 2c 20 61 6c 6c active VMs, all
3210: 6f 77 20 74 68 65 0a 20 20 2a 2a 20 6f 70 65 72 ow the. ** oper
3220: 61 74 69 6f 6e 20 74 6f 20 63 6f 6e 74 69 6e 75 ation to continu
3230: 65 20 62 75 74 20 69 6e 76 61 6c 69 64 61 74 65 e but invalidate
3240: 20 61 6c 6c 20 70 72 65 63 6f 6d 70 69 6c 65 64 all precompiled
3250: 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20 2a statements.. *
3260: 2f 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46 /. p = sqlite3F
3270: 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 indFunction(db,
3280: 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e zFunctionName, n
3290: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63 2c Name, nArg, enc,
32a0: 20 30 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 0);. if( p &&
32b0: 70 2d 3e 69 50 72 65 66 45 6e 63 3d 3d 65 6e 63 p->iPrefEnc==enc
32c0: 20 26 26 20 70 2d 3e 6e 41 72 67 3d 3d 6e 41 72 && p->nArg==nAr
32d0: 67 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d g ){. if( db-
32e0: 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20 29 >activeVdbeCnt )
32f0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 {. sqlite3E
3300: 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f rror(db, SQLITE_
3310: 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 BUSY, . "
3320: 55 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 Unable to delete
3330: 2f 6d 6f 64 69 66 79 20 75 73 65 72 2d 66 75 6e /modify user-fun
3340: 63 74 69 6f 6e 20 64 75 65 20 74 6f 20 61 63 74 ction due to act
3350: 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29 ive statements")
3360: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
3370: 21 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 !sqlite3MallocFa
3380: 69 6c 65 64 28 29 20 29 3b 0a 20 20 20 20 20 20 iled() );.
3390: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 return SQLITE_BU
33a0: 53 59 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 SY;. }else{.
33b0: 20 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 69 sqlite3Expi
33c0: 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 6d rePreparedStatem
33d0: 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 7d 0a ents(db);. }.
33e0: 20 20 7d 0a 0a 20 20 70 20 3d 20 73 71 6c 69 74 }.. p = sqlit
33f0: 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 e3FindFunction(d
3400: 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 b, zFunctionName
3410: 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 65 , nName, nArg, e
3420: 6e 63 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 20 nc, 1);. if( p
3430: 29 7b 0a 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 ){. p->flags
3440: 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 78 46 75 6e = 0;. p->xFun
3450: 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 20 20 70 c = xFunc;. p
3460: 2d 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b ->xStep = xStep;
3470: 0a 20 20 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a . p->xFinaliz
3480: 65 20 3d 20 78 46 69 6e 61 6c 3b 0a 20 20 20 20 e = xFinal;.
3490: 70 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70 p->pUserData = p
34a0: 55 73 65 72 44 61 74 61 3b 0a 20 20 7d 0a 20 20 UserData;. }.
34b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
34c0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 ;.}../*.** Creat
34d0: 65 20 6e 65 77 20 75 73 65 72 20 66 75 6e 63 74 e new user funct
34e0: 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ions..*/.int sql
34f0: 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 ite3_create_func
3500: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 tion(. sqlite3
3510: 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 *db,. const cha
3520: 72 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 r *zFunctionName
3530: 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 ,. int nArg,.
3540: 69 6e 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 int enc,. void
3550: 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 *p,. void (*xFu
3560: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 nc)(sqlite3_cont
3570: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
3580: 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f _value **),. vo
3590: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 id (*xStep)(sqli
35a0: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 te3_context*,int
35b0: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a ,sqlite3_value *
35c0: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 *),. void (*xFi
35d0: 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e nal)(sqlite3_con
35e0: 74 65 78 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 text*).){. int
35f0: 72 63 3b 0a 20 20 61 73 73 65 72 74 28 20 21 73 rc;. assert( !s
3600: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c qlite3MallocFail
3610: 65 64 28 29 20 29 3b 0a 20 20 72 63 20 3d 20 73 ed() );. rc = s
3620: 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 qlite3CreateFunc
3630: 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 (db, zFunctionNa
3640: 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70 me, nArg, enc, p
3650: 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 , xFunc, xStep,
3660: 78 46 69 6e 61 6c 29 3b 0a 0a 20 20 72 65 74 75 xFinal);.. retu
3670: 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 rn sqlite3ApiExi
3680: 74 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 0a 23 69 t(db, rc);.}..#i
3690: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
36a0: 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71 6c 69 T_UTF16.int sqli
36b0: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 te3_create_funct
36c0: 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 65 33 ion16(. sqlite3
36d0: 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 76 6f *db,. const vo
36e0: 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d id *zFunctionNam
36f0: 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 e,. int nArg,.
3700: 20 69 6e 74 20 65 54 65 78 74 52 65 70 2c 0a 20 int eTextRep,.
3710: 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 void *p,. void
3720: 20 28 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 (*xFunc)(sqlite
3730: 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 3_context*,int,s
3740: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c qlite3_value**),
3750: 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 . void (*xStep)
3760: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
3770: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
3780: 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 lue**),. void (
3790: 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 *xFinal)(sqlite3
37a0: 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 _context*).){.
37b0: 69 6e 74 20 72 63 3b 0a 20 20 63 68 61 72 20 2a int rc;. char *
37c0: 7a 46 75 6e 63 38 3b 0a 20 20 61 73 73 65 72 74 zFunc8;. assert
37d0: 28 20 21 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 ( !sqlite3Malloc
37e0: 46 61 69 6c 65 64 28 29 20 29 3b 0a 0a 20 20 7a Failed() );.. z
37f0: 46 75 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 75 Func8 = sqlite3u
3800: 74 66 31 36 74 6f 38 28 7a 46 75 6e 63 74 69 6f tf16to8(zFunctio
3810: 6e 4e 61 6d 65 2c 20 2d 31 29 3b 0a 20 20 72 63 nName, -1);. rc
3820: 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 = sqlite3Create
3830: 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 38 2c Func(db, zFunc8,
3840: 20 6e 41 72 67 2c 20 65 54 65 78 74 52 65 70 2c nArg, eTextRep,
3850: 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 p, xFunc, xStep
3860: 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20 73 71 6c , xFinal);. sql
3870: 69 74 65 46 72 65 65 28 7a 46 75 6e 63 38 29 3b iteFree(zFunc8);
3880: 0a 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 .. return sqlit
3890: 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 e3ApiExit(db, rc
38a0: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 );.}.#endif..#if
38b0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
38c0: 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67 _TRACE./*.** Reg
38d0: 69 73 74 65 72 20 61 20 74 72 61 63 65 20 66 75 ister a trace fu
38e0: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 nction. The pAr
38f0: 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69 g from the previ
3900: 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64 ously registered
3910: 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 trace.** is ret
3920: 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 urned. .**.** A
3930: 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 NULL trace func
3940: 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 tion means that
3950: 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 78 no tracing is ex
3960: 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e ecutes. A non-N
3970: 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 ULL.** trace is
3980: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 a pointer to a f
3990: 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 unction that is
39a0: 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73 invoked at the s
39b0: 74 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 tart of each.**
39c0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a SQL statement..*
39d0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
39e0: 74 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a 64 trace(sqlite3 *d
39f0: 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65 b, void (*xTrace
3a00: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 )(void*,const ch
3a10: 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 ar*), void *pArg
3a20: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 ){. void *pOld
3a30: 3d 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 3b = db->pTraceArg;
3a40: 0a 20 20 64 62 2d 3e 78 54 72 61 63 65 20 3d 20 . db->xTrace =
3a50: 78 54 72 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54 xTrace;. db->pT
3a60: 72 61 63 65 41 72 67 20 3d 20 70 41 72 67 3b 0a raceArg = pArg;.
3a70: 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d return pOld;.}
3a80: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
3a90: 61 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 a profile functi
3aa0: 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 72 on. The pArg fr
3ab0: 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c om the previousl
3ac0: 79 20 72 65 67 69 73 74 65 72 65 64 20 0a 2a 2a y registered .**
3ad0: 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f profile functio
3ae0: 6e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 n is returned.
3af0: 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c 20 70 72 .**.** A NULL pr
3b00: 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 6d ofile function m
3b10: 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 70 72 6f eans that no pro
3b20: 66 69 6c 69 6e 67 20 69 73 20 65 78 65 63 75 74 filing is execut
3b30: 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a es. A non-NULL.
3b40: 2a 2a 20 70 72 6f 66 69 6c 65 20 69 73 20 61 20 ** profile is a
3b50: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e pointer to a fun
3b60: 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e ction that is in
3b70: 76 6f 6b 65 64 20 61 74 20 74 68 65 20 63 6f 6e voked at the con
3b80: 63 6c 75 73 69 6f 6e 20 6f 66 0a 2a 2a 20 65 61 clusion of.** ea
3b90: 63 68 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 ch SQL statement
3ba0: 20 74 68 61 74 20 69 73 20 72 75 6e 2e 0a 2a 2f that is run..*/
3bb0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 70 .void *sqlite3_p
3bc0: 72 6f 66 69 6c 65 28 0a 20 20 73 71 6c 69 74 65 rofile(. sqlite
3bd0: 33 20 2a 64 62 2c 0a 20 20 76 6f 69 64 20 28 2a 3 *db,. void (*
3be0: 78 50 72 6f 66 69 6c 65 29 28 76 6f 69 64 2a 2c xProfile)(void*,
3bf0: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 const char*,sqli
3c00: 74 65 5f 75 69 6e 74 36 34 29 2c 0a 20 20 76 6f te_uint64),. vo
3c10: 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 76 6f id *pArg.){. vo
3c20: 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 id *pOld = db->p
3c30: 50 72 6f 66 69 6c 65 41 72 67 3b 0a 20 20 64 62 ProfileArg;. db
3c40: 2d 3e 78 50 72 6f 66 69 6c 65 20 3d 20 78 50 72 ->xProfile = xPr
3c50: 6f 66 69 6c 65 3b 0a 20 20 64 62 2d 3e 70 50 72 ofile;. db->pPr
3c60: 6f 66 69 6c 65 41 72 67 20 3d 20 70 41 72 67 3b ofileArg = pArg;
3c70: 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a . return pOld;.
3c80: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 }.#endif /* SQLI
3c90: 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 20 2a 2f TE_OMIT_TRACE */
3ca0: 0a 0a 2f 2a 2a 2a 20 45 58 50 45 52 49 4d 45 4e ../*** EXPERIMEN
3cb0: 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 TAL ***.**.** Re
3cc0: 67 69 73 74 65 72 20 61 20 66 75 6e 63 74 69 6f gister a functio
3cd0: 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 n to be invoked
3ce0: 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74 69 when a transacti
3cf0: 6f 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a 20 on comments..**
3d00: 49 66 20 74 68 65 20 69 6e 76 6f 6b 65 64 20 66 If the invoked f
3d10: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
3d20: 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 74 non-zero, then t
3d30: 68 65 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d 65 he commit become
3d40: 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2e s a.** rollback.
3d50: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .*/.void *sqlite
3d60: 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a 20 3_commit_hook(.
3d70: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
3d80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 /* At
3d90: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f tach the hook to
3da0: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a this database *
3db0: 2f 0a 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c 62 /. int (*xCallb
3dc0: 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f 2a ack)(void*), /*
3dd0: 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76 Function to inv
3de0: 6f 6b 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d oke on each comm
3df0: 69 74 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 it */. void *pA
3e00: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rg
3e10: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f /* Argument to
3e20: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f the function */
3e30: 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 .){. void *pOld
3e40: 20 3d 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 = db->pCommitAr
3e50: 67 3b 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 g;. db->xCommit
3e60: 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c Callback = xCall
3e70: 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d back;. db->pCom
3e80: 6d 69 74 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 mitArg = pArg;.
3e90: 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a return pOld;.}.
3ea0: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
3eb0: 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 a callback to be
3ec0: 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 invoked each ti
3ed0: 6d 65 20 61 20 72 6f 77 20 69 73 20 75 70 64 61 me a row is upda
3ee0: 74 65 64 2c 0a 2a 2a 20 69 6e 73 65 72 74 65 64 ted,.** inserted
3ef0: 20 6f 72 20 64 65 6c 65 74 65 64 20 75 73 69 6e or deleted usin
3f00: 67 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 g this database
3f10: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 connection..*/.v
3f20: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 75 70 64 oid *sqlite3_upd
3f30: 61 74 65 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 ate_hook(. sqli
3f40: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 te3 *db,
3f50: 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 /* Attach
3f60: 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 the hook to this
3f70: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 database */. v
3f80: 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 oid (*xCallback)
3f90: 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 68 61 72 20 (void*,int,char
3fa0: 63 6f 6e 73 74 20 2a 2c 63 68 61 72 20 63 6f 6e const *,char con
3fb0: 73 74 20 2a 2c 73 71 6c 69 74 65 5f 69 6e 74 36 st *,sqlite_int6
3fc0: 34 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 4),. void *pArg
3fd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3fe0: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 /* Argument to t
3ff0: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 he function */.)
4000: 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 20 3d {. void *pRet =
4010: 20 64 62 2d 3e 70 55 70 64 61 74 65 41 72 67 3b db->pUpdateArg;
4020: 0a 20 20 64 62 2d 3e 78 55 70 64 61 74 65 43 61 . db->xUpdateCa
4030: 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 llback = xCallba
4040: 63 6b 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61 74 ck;. db->pUpdat
4050: 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 eArg = pArg;. r
4060: 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f eturn pRet;.}../
4070: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
4080: 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 callback to be i
4090: 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65 nvoked each time
40a0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
40b0: 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b s rolled.** back
40c0: 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 73 by this databas
40d0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f e connection..*/
40e0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72 .void *sqlite3_r
40f0: 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20 20 ollback_hook(.
4100: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
4110: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 /* Att
4120: 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 ach the hook to
4130: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f this database */
4140: 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62 . void (*xCallb
4150: 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 2f 2a 20 ack)(void*), /*
4160: 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f Callback functio
4170: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 n */. void *pAr
4180: 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g
4190: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 /* Argument to
41a0: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a the function */.
41b0: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 20 ){. void *pRet
41c0: 3d 20 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 = db->pRollbackA
41d0: 72 67 3b 0a 20 20 64 62 2d 3e 78 52 6f 6c 6c 62 rg;. db->xRollb
41e0: 61 63 6b 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 ackCallback = xC
41f0: 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 allback;. db->p
4200: 52 6f 6c 6c 62 61 63 6b 41 72 67 20 3d 20 70 41 RollbackArg = pA
4210: 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 70 52 65 rg;. return pRe
4220: 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 t;.}../*.** This
4230: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c routine is call
4240: 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 63 ed to create a c
4250: 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61 20 64 onnection to a d
4260: 61 74 61 62 61 73 65 20 42 54 72 65 65 0a 2a 2a atabase BTree.**
4270: 20 64 72 69 76 65 72 2e 20 20 49 66 20 7a 46 69 driver. If zFi
4280: 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 20 6e 61 lename is the na
4290: 6d 65 20 6f 66 20 61 20 66 69 6c 65 2c 20 74 68 me of a file, th
42a0: 65 6e 20 74 68 61 74 20 66 69 6c 65 20 69 73 0a en that file is.
42b0: 2a 2a 20 6f 70 65 6e 65 64 20 61 6e 64 20 75 73 ** opened and us
42c0: 65 64 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d ed. If zFilenam
42d0: 65 20 69 73 20 74 68 65 20 6d 61 67 69 63 20 6e e is the magic n
42e0: 61 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 ame ":memory:" t
42f0: 68 65 6e 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 hen.** the datab
4300: 61 73 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e ase is stored in
4310: 20 6d 65 6d 6f 72 79 20 28 61 6e 64 20 69 73 20 memory (and is
4320: 74 68 75 73 20 66 6f 72 67 6f 74 74 65 6e 20 61 thus forgotten a
4330: 73 20 73 6f 6f 6e 20 61 73 0a 2a 2a 20 74 68 65 s soon as.** the
4340: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63 connection is c
4350: 6c 6f 73 65 64 2e 29 20 20 49 66 20 7a 46 69 6c losed.) If zFil
4360: 65 6e 61 6d 65 20 69 73 20 4e 55 4c 4c 20 74 68 ename is NULL th
4370: 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a en the database.
4380: 2a 2a 20 69 73 20 61 20 22 76 69 72 74 75 61 6c ** is a "virtual
4390: 22 20 64 61 74 61 62 61 73 65 20 66 6f 72 20 74 " database for t
43a0: 72 61 6e 73 69 65 6e 74 20 75 73 65 20 6f 6e 6c ransient use onl
43b0: 79 20 61 6e 64 20 69 73 20 64 65 6c 65 74 65 64 y and is deleted
43c0: 20 61 73 0a 2a 2a 20 73 6f 6f 6e 20 61 73 20 74 as.** soon as t
43d0: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 he connection is
43e0: 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 closed..**.** A
43f0: 20 76 69 72 74 75 61 6c 20 64 61 74 61 62 61 73 virtual databas
4400: 65 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20 e can be either
4410: 61 20 64 69 73 6b 20 66 69 6c 65 20 28 74 68 61 a disk file (tha
4420: 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c t is automatical
4430: 6c 79 0a 2a 2a 20 64 65 6c 65 74 65 64 20 77 68 ly.** deleted wh
4440: 65 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20 63 en the file is c
4450: 6c 6f 73 65 64 29 20 6f 72 20 69 74 20 61 6e 20 losed) or it an
4460: 62 65 20 68 65 6c 64 20 65 6e 74 69 72 65 6c 79 be held entirely
4470: 20 69 6e 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 64 in memory,.** d
4480: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 epending on the
4490: 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 54 45 values of the TE
44a0: 4d 50 5f 53 54 4f 52 45 20 63 6f 6d 70 69 6c 65 MP_STORE compile
44b0: 2d 74 69 6d 65 20 6d 61 63 72 6f 20 61 6e 64 20 -time macro and
44c0: 74 68 65 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 5f the.** db->temp_
44d0: 73 74 6f 72 65 20 76 61 72 69 61 62 6c 65 2c 20 store variable,
44e0: 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 according to the
44f0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 following chart
4500: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 54 45 :.**.** TE
4510: 4d 50 5f 53 54 4f 52 45 20 20 20 20 20 64 62 2d MP_STORE db-
4520: 3e 74 65 6d 70 5f 73 74 6f 72 65 20 20 20 20 20 >temp_store
4530: 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 65 6d 70 Location of temp
4540: 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 0a 2a orary database.*
4550: 2a 20 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d * --------
4560: 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d -- ---------
4570: 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d ----- ------
4580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4590: 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 --------.**
45a0: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 0
45b0: 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20 20 any
45c0: 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20 file.**
45d0: 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 1
45e0: 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 1
45f0: 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 file.**
4600: 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 1
4610: 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 2
4620: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 memory
4630: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 31 20 .** 1
4640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 0
4650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 fi
4660: 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 le.**
4670: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
4680: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
4690: 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 file.**
46a0: 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 2
46b0: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 2
46c0: 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20 memory.**
46d0: 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20 2
46e0: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 0
46f0: 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 memory.**
4700: 20 20 20 20 20 20 20 20 20 20 33 20 20 20 20 20 3
4710: 20 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 20 any
4720: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 memory
4730: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
4740: 74 72 65 65 46 61 63 74 6f 72 79 28 0a 20 20 63 treeFactory(. c
4750: 6f 6e 73 74 20 73 71 6c 69 74 65 33 20 2a 64 62 onst sqlite3 *db
4760: 2c 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 69 6e , /* Main
4770: 20 64 61 74 61 62 61 73 65 20 77 68 65 6e 20 6f database when o
4780: 70 65 6e 69 6e 67 20 61 75 78 20 6f 74 68 65 72 pening aux other
4790: 77 69 73 65 20 30 20 2a 2f 0a 20 20 63 6f 6e 73 wise 0 */. cons
47a0: 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d t char *zFilenam
47b0: 65 2c 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 e, /* Name of
47c0: 20 74 68 65 20 66 69 6c 65 20 63 6f 6e 74 61 69 the file contai
47d0: 6e 69 6e 67 20 74 68 65 20 42 54 72 65 65 20 64 ning the BTree d
47e0: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 atabase */. int
47f0: 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 2c 20 20 20 omitJournal,
4800: 20 20 20 20 20 20 20 2f 2a 20 69 66 20 54 52 55 /* if TRU
4810: 45 20 74 68 65 6e 20 64 6f 20 6e 6f 74 20 6a 6f E then do not jo
4820: 75 72 6e 61 6c 20 74 68 69 73 20 66 69 6c 65 20 urnal this file
4830: 2a 2f 0a 20 20 69 6e 74 20 6e 43 61 63 68 65 2c */. int nCache,
4840: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
4850: 2a 20 48 6f 77 20 6d 61 6e 79 20 70 61 67 65 73 * How many pages
4860: 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61 63 in the page cac
4870: 68 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 2a he */. Btree **
4880: 70 70 42 74 72 65 65 20 20 20 20 20 20 20 20 20 ppBtree
4890: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
48a0: 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 63 74 new Btree object
48b0: 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 2a 2f written here */
48c0: 0a 29 7b 0a 20 20 69 6e 74 20 62 74 72 65 65 5f .){. int btree_
48d0: 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20 69 6e 74 flags = 0;. int
48e0: 20 72 63 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 rc;. . assert
48f0: 28 20 70 70 42 74 72 65 65 20 21 3d 20 30 29 3b ( ppBtree != 0);
4900: 0a 20 20 69 66 28 20 6f 6d 69 74 4a 6f 75 72 6e . if( omitJourn
4910: 61 6c 20 29 7b 0a 20 20 20 20 62 74 72 65 65 5f al ){. btree_
4920: 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f 4f flags |= BTREE_O
4930: 4d 49 54 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 7d MIT_JOURNAL;. }
4940: 0a 20 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 . if( db->flags
4950: 20 26 20 53 51 4c 49 54 45 5f 4e 6f 52 65 61 64 & SQLITE_NoRead
4960: 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 62 74 72 65 lock ){. btre
4970: 65 5f 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 e_flags |= BTREE
4980: 5f 4e 4f 5f 52 45 41 44 4c 4f 43 4b 3b 0a 20 20 _NO_READLOCK;.
4990: 7d 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d }. if( zFilenam
49a0: 65 3d 3d 30 20 29 7b 0a 23 69 66 20 54 45 4d 50 e==0 ){.#if TEMP
49b0: 5f 53 54 4f 52 45 3d 3d 30 0a 20 20 20 20 2f 2a _STORE==0. /*
49c0: 20 44 6f 20 6e 6f 74 68 69 6e 67 20 2a 2f 0a 23 Do nothing */.#
49d0: 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 endif.#ifndef SQ
49e0: 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 LITE_OMIT_MEMORY
49f0: 44 42 0a 23 69 66 20 54 45 4d 50 5f 53 54 4f 52 DB.#if TEMP_STOR
4a00: 45 3d 3d 31 0a 20 20 20 20 69 66 28 20 64 62 2d E==1. if( db-
4a10: 3e 74 65 6d 70 5f 73 74 6f 72 65 3d 3d 32 20 29 >temp_store==2 )
4a20: 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d zFilename = ":m
4a30: 65 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a emory:";.#endif.
4a40: 23 69 66 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d #if TEMP_STORE==
4a50: 32 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 74 65 2. if( db->te
4a60: 6d 70 5f 73 74 6f 72 65 21 3d 31 20 29 20 7a 46 mp_store!=1 ) zF
4a70: 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f ilename = ":memo
4a80: 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 69 66 ry:";.#endif.#if
4a90: 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 33 0a 20 TEMP_STORE==3.
4aa0: 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 zFilename = "
4ab0: 3a 6d 65 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64 69 :memory:";.#endi
4ac0: 66 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 f.#endif /* SQLI
4ad0: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 TE_OMIT_MEMORYDB
4ae0: 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 */. }.. rc =
4af0: 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 65 6e sqlite3BtreeOpen
4b00: 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 28 73 71 6c (zFilename, (sql
4b10: 69 74 65 33 20 2a 29 64 62 2c 20 70 70 42 74 72 ite3 *)db, ppBtr
4b20: 65 65 2c 20 62 74 72 65 65 5f 66 6c 61 67 73 29 ee, btree_flags)
4b30: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
4b40: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c TE_OK ){. sql
4b50: 69 74 65 33 42 74 72 65 65 53 65 74 42 75 73 79 ite3BtreeSetBusy
4b60: 48 61 6e 64 6c 65 72 28 2a 70 70 42 74 72 65 65 Handler(*ppBtree
4b70: 2c 20 28 76 6f 69 64 2a 29 26 64 62 2d 3e 62 75 , (void*)&db->bu
4b80: 73 79 48 61 6e 64 6c 65 72 29 3b 0a 20 20 20 20 syHandler);.
4b90: 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 sqlite3BtreeSetC
4ba0: 61 63 68 65 53 69 7a 65 28 2a 70 70 42 74 72 65 acheSize(*ppBtre
4bb0: 65 2c 20 6e 43 61 63 68 65 29 3b 0a 20 20 7d 0a e, nCache);. }.
4bc0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
4bd0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 /*.** Return UTF
4be0: 2d 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 -8 encoded Engli
4bf0: 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c sh language expl
4c00: 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d anation of the m
4c10: 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 ost recent.** er
4c20: 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 ror..*/.const ch
4c30: 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d ar *sqlite3_errm
4c40: 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b sg(sqlite3 *db){
4c50: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
4c60: 3b 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 73 ;. if( !db || s
4c70: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c qlite3MallocFail
4c80: 65 64 28 29 20 29 7b 0a 20 20 20 20 72 65 74 75 ed() ){. retu
4c90: 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 rn sqlite3ErrStr
4ca0: 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a (SQLITE_NOMEM);.
4cb0: 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 }. if( sqlite
4cc0: 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 3SafetyCheck(db)
4cd0: 20 7c 7c 20 64 62 2d 3e 65 72 72 43 6f 64 65 3d || db->errCode=
4ce0: 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 29 =SQLITE_MISUSE )
4cf0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c {. return sql
4d00: 69 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 54 ite3ErrStr(SQLIT
4d10: 45 5f 4d 49 53 55 53 45 29 3b 0a 20 20 7d 0a 20 E_MISUSE);. }.
4d20: 20 7a 20 3d 20 28 63 68 61 72 2a 29 73 71 6c 69 z = (char*)sqli
4d30: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 te3_value_text(d
4d40: 62 2d 3e 70 45 72 72 29 3b 0a 20 20 69 66 28 20 b->pErr);. if(
4d50: 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 7a 20 3d 20 z==0 ){. z =
4d60: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 sqlite3ErrStr(db
4d70: 2d 3e 65 72 72 43 6f 64 65 29 3b 0a 20 20 7d 0a ->errCode);. }.
4d80: 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 23 return z;.}..#
4d90: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
4da0: 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 IT_UTF16./*.** R
4db0: 65 74 75 72 6e 20 55 54 46 2d 31 36 20 65 6e 63 eturn UTF-16 enc
4dc0: 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 6e oded English lan
4dd0: 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69 6f guage explanatio
4de0: 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 n of the most re
4df0: 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a cent.** error..*
4e00: 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 /.const void *sq
4e10: 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 73 lite3_errmsg16(s
4e20: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 2f qlite3 *db){. /
4e30: 2a 20 42 65 63 61 75 73 65 20 61 6c 6c 20 74 68 * Because all th
4e40: 65 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 20 e characters in
4e50: 74 68 65 20 73 74 72 69 6e 67 20 61 72 65 20 69 the string are i
4e60: 6e 20 74 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 n the unicode.
4e70: 2a 2a 20 72 61 6e 67 65 20 30 78 30 30 2d 30 78 ** range 0x00-0x
4e80: 46 46 2c 20 69 66 20 77 65 20 70 61 64 20 74 68 FF, if we pad th
4e90: 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 73 74 72 e big-endian str
4ea0: 69 6e 67 20 77 69 74 68 20 61 20 0a 20 20 2a 2a ing with a . **
4eb0: 20 7a 65 72 6f 20 62 79 74 65 2c 20 77 65 20 63 zero byte, we c
4ec0: 61 6e 20 6f 62 74 61 69 6e 20 74 68 65 20 6c 69 an obtain the li
4ed0: 74 74 6c 65 2d 65 6e 64 69 61 6e 20 73 74 72 69 ttle-endian stri
4ee0: 6e 67 20 77 69 74 68 0a 20 20 2a 2a 20 26 62 69 ng with. ** &bi
4ef0: 67 5f 65 6e 64 69 61 6e 5b 31 5d 2e 0a 20 20 2a g_endian[1].. *
4f00: 2f 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 /. static const
4f10: 20 63 68 61 72 20 6f 75 74 4f 66 4d 65 6d 42 65 char outOfMemBe
4f20: 5b 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6f [] = {. 0, 'o
4f30: 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 ', 0, 'u', 0, 't
4f40: 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 ', 0, ' ', .
4f50: 30 2c 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 0, 'o', 0, 'f',
4f60: 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 0, ' ', . 0,
4f70: 27 6d 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 'm', 0, 'e', 0,
4f80: 27 6d 27 2c 20 30 2c 20 27 6f 27 2c 20 30 2c 20 'm', 0, 'o', 0,
4f90: 27 72 27 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20 'r', 0, 'y', 0,
4fa0: 30 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74 0, 0. };. stat
4fb0: 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 6d 69 ic const char mi
4fc0: 73 75 73 65 42 65 20 5b 5d 20 3d 20 7b 0a 20 20 suseBe [] = {.
4fd0: 20 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 69 27 0, 'l', 0, 'i'
4fe0: 2c 20 30 2c 20 27 62 27 2c 20 30 2c 20 27 72 27 , 0, 'b', 0, 'r'
4ff0: 2c 20 30 2c 20 27 61 27 2c 20 30 2c 20 27 72 27 , 0, 'a', 0, 'r'
5000: 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20 27 20 27 , 0, 'y', 0, ' '
5010: 2c 20 0a 20 20 20 20 30 2c 20 27 72 27 2c 20 30 , . 0, 'r', 0
5020: 2c 20 27 6f 27 2c 20 30 2c 20 27 75 27 2c 20 30 , 'o', 0, 'u', 0
5030: 2c 20 27 74 27 2c 20 30 2c 20 27 69 27 2c 20 30 , 't', 0, 'i', 0
5040: 2c 20 27 6e 27 2c 20 30 2c 20 27 65 27 2c 20 30 , 'n', 0, 'e', 0
5050: 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 , ' ', . 0, '
5060: 63 27 2c 20 30 2c 20 27 61 27 2c 20 30 2c 20 27 c', 0, 'a', 0, '
5070: 6c 27 2c 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 l', 0, 'l', 0, '
5080: 65 27 2c 20 30 2c 20 27 64 27 2c 20 30 2c 20 27 e', 0, 'd', 0, '
5090: 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c ', . 0, 'o',
50a0: 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c 0, 'u', 0, 't',
50b0: 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 0, ' ', . 0,
50c0: 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30 2c 'o', 0, 'f', 0,
50d0: 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 73 ' ', . 0, 's
50e0: 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 71 ', 0, 'e', 0, 'q
50f0: 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 65 ', 0, 'u', 0, 'e
5100: 27 2c 20 30 2c 20 27 6e 27 2c 20 30 2c 20 27 63 ', 0, 'n', 0, 'c
5110: 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 30 2c ', 0, 'e', 0, 0,
5120: 20 30 0a 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 0. };.. const
5130: 20 76 6f 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 void *z;. if(
5140: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 sqlite3MallocFai
5150: 6c 65 64 28 29 20 29 7b 0a 20 20 20 20 72 65 74 led() ){. ret
5160: 75 72 6e 20 28 76 6f 69 64 20 2a 29 28 26 6f 75 urn (void *)(&ou
5170: 74 4f 66 4d 65 6d 42 65 5b 53 51 4c 49 54 45 5f tOfMemBe[SQLITE_
5180: 55 54 46 31 36 4e 41 54 49 56 45 3d 3d 53 51 4c UTF16NATIVE==SQL
5190: 49 54 45 5f 55 54 46 31 36 4c 45 3f 31 3a 30 5d ITE_UTF16LE?1:0]
51a0: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c );. }. if( sql
51b0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 ite3SafetyCheck(
51c0: 64 62 29 20 7c 7c 20 64 62 2d 3e 65 72 72 43 6f db) || db->errCo
51d0: 64 65 3d 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53 de==SQLITE_MISUS
51e0: 45 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 E ){. return
51f0: 28 76 6f 69 64 20 2a 29 28 26 6d 69 73 75 73 65 (void *)(&misuse
5200: 42 65 5b 53 51 4c 49 54 45 5f 55 54 46 31 36 4e Be[SQLITE_UTF16N
5210: 41 54 49 56 45 3d 3d 53 51 4c 49 54 45 5f 55 54 ATIVE==SQLITE_UT
5220: 46 31 36 4c 45 3f 31 3a 30 5d 29 3b 0a 20 20 7d F16LE?1:0]);. }
5230: 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 . z = sqlite3_v
5240: 61 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d 3e alue_text16(db->
5250: 70 45 72 72 29 3b 0a 20 20 69 66 28 20 7a 3d 3d pErr);. if( z==
5260: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 0 ){. sqlite3
5270: 56 61 6c 75 65 53 65 74 53 74 72 28 64 62 2d 3e ValueSetStr(db->
5280: 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c 69 74 65 pErr, -1, sqlite
5290: 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43 3ErrStr(db->errC
52a0: 6f 64 65 29 2c 0a 20 20 20 20 20 20 20 20 20 53 ode),. S
52b0: 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 QLITE_UTF8, SQLI
52c0: 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 TE_STATIC);.
52d0: 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 z = sqlite3_valu
52e0: 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 e_text16(db->pEr
52f0: 72 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 r);. }. sqlite
5300: 33 41 70 69 45 78 69 74 28 30 2c 20 30 29 3b 0a 3ApiExit(0, 0);.
5310: 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 23 65 return z;.}.#e
5320: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
5330: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a MIT_UTF16 */../*
5340: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d .** Return the m
5350: 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 ost recent error
5360: 20 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 20 code generated
5370: 62 79 20 61 6e 20 53 51 4c 69 74 65 20 72 6f 75 by an SQLite rou
5380: 74 69 6e 65 2e 20 49 66 20 4e 55 4c 4c 20 69 73 tine. If NULL is
5390: 0a 2a 2a 20 70 61 73 73 65 64 20 74 6f 20 74 68 .** passed to th
53a0: 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 77 65 20 is function, we
53b0: 61 73 73 75 6d 65 20 61 20 6d 61 6c 6c 6f 63 28 assume a malloc(
53c0: 29 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20 ) failed during
53d0: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2e 0a sqlite3_open()..
53e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 */.int sqlite3_e
53f0: 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 2a rrcode(sqlite3 *
5400: 64 62 29 7b 0a 20 20 69 66 28 20 21 64 62 20 7c db){. if( !db |
5410: 7c 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 | sqlite3MallocF
5420: 61 69 6c 65 64 28 29 20 29 7b 0a 20 20 20 20 72 ailed() ){. r
5430: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
5440: 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 EM;. }. if( sq
5450: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
5460: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 (db) ){. retu
5470: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
5480: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64 ;. }. return d
5490: 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a 2f b->errCode;.}../
54a0: 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 *.** Create a ne
54b0: 77 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 w collating func
54c0: 74 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 61 73 tion for databas
54d0: 65 20 22 64 62 22 2e 20 20 54 68 65 20 6e 61 6d e "db". The nam
54e0: 65 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 61 6e e is zName.** an
54f0: 64 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 d the encoding i
5500: 73 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 69 63 s enc..*/.static
5510: 20 69 6e 74 20 63 72 65 61 74 65 43 6f 6c 6c 61 int createColla
5520: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a tion(. sqlite3*
5530: 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 db, . const ch
5540: 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e ar *zName, . in
5550: 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 t enc, . void*
5560: 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f pCtx,. int(*xCo
5570: 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 mpare)(void*,int
5580: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 ,const void*,int
5590: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b ,const void*).){
55a0: 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c . CollSeq *pCol
55b0: 6c 3b 0a 20 20 0a 20 20 69 66 28 20 73 71 6c 69 l;. . if( sqli
55c0: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 te3SafetyCheck(d
55d0: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e b) ){. return
55e0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a SQLITE_MISUSE;.
55f0: 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c }.. /* If SQL
5600: 49 54 45 5f 55 54 46 31 36 20 69 73 20 73 70 65 ITE_UTF16 is spe
5610: 63 69 66 69 65 64 20 61 73 20 74 68 65 20 65 6e cified as the en
5620: 63 6f 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61 coding type, tra
5630: 6e 73 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a nsform this. **
5640: 20 74 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 to one of SQLIT
5650: 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c E_UTF16LE or SQL
5660: 49 54 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e ITE_UTF16BE usin
5670: 67 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 g the. ** SQLIT
5680: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61 E_UTF16NATIVE ma
5690: 63 72 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 cro. SQLITE_UTF1
56a0: 36 20 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 6 is not used in
56b0: 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 ternally.. */.
56c0: 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 if( enc==SQLITE
56d0: 5f 55 54 46 31 36 20 29 7b 0a 20 20 20 20 65 6e _UTF16 ){. en
56e0: 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36 c = SQLITE_UTF16
56f0: 4e 41 54 49 56 45 3b 0a 20 20 7d 0a 0a 20 20 69 NATIVE;. }.. i
5700: 66 28 20 65 6e 63 21 3d 53 51 4c 49 54 45 5f 55 f( enc!=SQLITE_U
5710: 54 46 38 20 26 26 20 65 6e 63 21 3d 53 51 4c 49 TF8 && enc!=SQLI
5720: 54 45 5f 55 54 46 31 36 4c 45 20 26 26 20 65 6e TE_UTF16LE && en
5730: 63 21 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 42 c!=SQLITE_UTF16B
5740: 45 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 E ){. sqlite3
5750: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
5760: 5f 45 52 52 4f 52 2c 20 0a 20 20 20 20 20 20 20 _ERROR, .
5770: 20 22 50 61 72 61 6d 20 33 20 74 6f 20 73 71 6c "Param 3 to sql
5780: 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
5790: 61 74 69 6f 6e 28 29 20 6d 75 73 74 20 62 65 20 ation() must be
57a0: 6f 6e 65 20 6f 66 20 22 0a 20 20 20 20 20 20 20 one of ".
57b0: 20 22 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 "SQLITE_UTF8, S
57c0: 51 4c 49 54 45 5f 55 54 46 31 36 2c 20 53 51 4c QLITE_UTF16, SQL
57d0: 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53 ITE_UTF16LE or S
57e0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 22 0a 20 QLITE_UTF16BE".
57f0: 20 20 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e );. return
5800: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
5810: 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 }.. /* Check i
5820: 66 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 72 f this call is r
5830: 65 6d 6f 76 69 6e 67 20 6f 72 20 72 65 70 6c 61 emoving or repla
5840: 63 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 cing an existing
5850: 20 63 6f 6c 6c 61 74 69 6f 6e 20 0a 20 20 2a 2a collation . **
5860: 20 73 65 71 75 65 6e 63 65 2e 20 49 66 20 73 6f sequence. If so
5870: 2c 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20 , and there are
5880: 61 63 74 69 76 65 20 56 4d 73 2c 20 72 65 74 75 active VMs, retu
5890: 72 6e 20 62 75 73 79 2e 20 49 66 20 74 68 65 72 rn busy. If ther
58a0: 65 0a 20 20 2a 2a 20 61 72 65 20 6e 6f 20 61 63 e. ** are no ac
58b0: 74 69 76 65 20 56 4d 73 2c 20 69 6e 76 61 6c 69 tive VMs, invali
58c0: 64 61 74 65 20 61 6e 79 20 70 72 65 2d 63 6f 6d date any pre-com
58d0: 70 69 6c 65 64 20 73 74 61 74 65 6d 65 6e 74 73 piled statements
58e0: 2e 0a 20 20 2a 2f 0a 20 20 70 43 6f 6c 6c 20 3d .. */. pColl =
58f0: 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c sqlite3FindColl
5900: 53 65 71 28 64 62 2c 20 28 75 38 29 65 6e 63 2c Seq(db, (u8)enc,
5910: 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65 6e 28 7a zName, strlen(z
5920: 4e 61 6d 65 29 2c 20 30 29 3b 0a 20 20 69 66 28 Name), 0);. if(
5930: 20 70 43 6f 6c 6c 20 26 26 20 70 43 6f 6c 6c 2d pColl && pColl-
5940: 3e 78 43 6d 70 20 29 7b 0a 20 20 20 20 69 66 28 >xCmp ){. if(
5950: 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 db->activeVdbeC
5960: 6e 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 nt ){. sqli
5970: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c te3Error(db, SQL
5980: 49 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 20 ITE_BUSY, .
5990: 20 20 20 22 55 6e 61 62 6c 65 20 74 6f 20 64 65 "Unable to de
59a0: 6c 65 74 65 2f 6d 6f 64 69 66 79 20 63 6f 6c 6c lete/modify coll
59b0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 64 ation sequence d
59c0: 75 65 20 74 6f 20 61 63 74 69 76 65 20 73 74 61 ue to active sta
59d0: 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20 20 tements");.
59e0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 return SQLITE_B
59f0: 55 53 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 USY;. }. s
5a00: 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 qlite3ExpirePrep
5a10: 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 aredStatements(d
5a20: 62 29 3b 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 6c b);. }.. pColl
5a30: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f = sqlite3FindCo
5a40: 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 65 6e llSeq(db, (u8)en
5a50: 63 2c 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65 6e c, zName, strlen
5a60: 28 7a 4e 61 6d 65 29 2c 20 31 29 3b 0a 20 20 69 (zName), 1);. i
5a70: 66 28 20 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 f( pColl ){.
5a80: 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 3d 20 78 43 pColl->xCmp = xC
5a90: 6f 6d 70 61 72 65 3b 0a 20 20 20 20 70 43 6f 6c ompare;. pCol
5aa0: 6c 2d 3e 70 55 73 65 72 20 3d 20 70 43 74 78 3b l->pUser = pCtx;
5ab0: 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 65 6e 63 20 . pColl->enc
5ac0: 3d 20 65 6e 63 3b 0a 20 20 7d 0a 20 20 73 71 6c = enc;. }. sql
5ad0: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 ite3Error(db, SQ
5ae0: 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 72 LITE_OK, 0);. r
5af0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
5b00: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .}.../*.** This
5b10: 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 routine does the
5b20: 20 77 6f 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 work of opening
5b30: 20 61 20 64 61 74 61 62 61 73 65 20 6f 6e 20 62 a database on b
5b40: 65 68 61 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 ehalf of.** sqli
5b50: 74 65 33 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 te3_open() and s
5b60: 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e qlite3_open16().
5b70: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69 The database fi
5b80: 6c 65 6e 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d lename "zFilenam
5b90: 65 22 20 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 e" .** is UTF-8
5ba0: 20 65 6e 63 6f 64 65 64 2e 0a 2a 2f 0a 73 74 61 encoded..*/.sta
5bb0: 74 69 63 20 69 6e 74 20 6f 70 65 6e 44 61 74 61 tic int openData
5bc0: 62 61 73 65 28 0a 20 20 63 6f 6e 73 74 20 63 68 base(. const ch
5bd0: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 2f ar *zFilename, /
5be0: 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 6e * Database filen
5bf0: 61 6d 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 ame UTF-8 encode
5c00: 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a d */. sqlite3 *
5c10: 2a 70 70 44 62 20 20 20 20 20 20 20 20 20 2f 2a *ppDb /*
5c20: 20 4f 55 54 3a 20 52 65 74 75 72 6e 65 64 20 64 OUT: Returned d
5c30: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a atabase handle *
5c40: 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a /.){. sqlite3 *
5c50: 64 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 db;. int rc;.
5c60: 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 3b 0a CollSeq *pColl;.
5c70: 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 . assert( !sqli
5c80: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 te3MallocFailed(
5c90: 29 20 29 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 ) );.. /* Alloc
5ca0: 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 20 64 ate the sqlite d
5cb0: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 2a 2f ata structure */
5cc0: 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 65 4d 61 . db = sqliteMa
5cd0: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 73 71 6c lloc( sizeof(sql
5ce0: 69 74 65 33 29 20 29 3b 0a 20 20 69 66 28 20 64 ite3) );. if( d
5cf0: 62 3d 3d 30 20 29 20 67 6f 74 6f 20 6f 70 65 6e b==0 ) goto open
5d00: 64 62 5f 6f 75 74 3b 0a 20 20 64 62 2d 3e 70 72 db_out;. db->pr
5d10: 69 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b iorNewRowid = 0;
5d20: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 . db->magic = S
5d30: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 QLITE_MAGIC_BUSY
5d40: 3b 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b ;. db->nDb = 2;
5d50: 0a 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 2d . db->aDb = db-
5d60: 3e 61 44 62 53 74 61 74 69 63 3b 0a 20 20 64 62 >aDbStatic;. db
5d70: 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 ->autoCommit = 1
5d80: 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d ;. db->flags |=
5d90: 20 53 51 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c SQLITE_ShortCol
5da0: 4e 61 6d 65 73 3b 0a 20 20 73 71 6c 69 74 65 33 Names;. sqlite3
5db0: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 46 HashInit(&db->aF
5dc0: 75 6e 63 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 unc, SQLITE_HASH
5dd0: 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73 _STRING, 0);. s
5de0: 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 qlite3HashInit(&
5df0: 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c 20 53 51 db->aCollSeq, SQ
5e00: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 LITE_HASH_STRING
5e10: 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 41 64 64 20 , 0);.. /* Add
5e20: 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c the default coll
5e30: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 42 ation sequence B
5e40: 49 4e 41 52 59 2e 20 42 49 4e 41 52 59 20 77 6f INARY. BINARY wo
5e50: 72 6b 73 20 66 6f 72 20 62 6f 74 68 20 55 54 46 rks for both UTF
5e60: 2d 38 0a 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d -8. ** and UTF-
5e70: 31 36 2c 20 73 6f 20 61 64 64 20 61 20 76 65 72 16, so add a ver
5e80: 73 69 6f 6e 20 66 6f 72 20 65 61 63 68 20 74 6f sion for each to
5e90: 20 61 76 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63 avoid any unnec
5ea0: 65 73 73 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 essary. ** conv
5eb0: 65 72 73 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c ersions. The onl
5ec0: 79 20 65 72 72 6f 72 20 74 68 61 74 20 63 61 6e y error that can
5ed0: 20 6f 63 63 75 72 20 68 65 72 65 20 69 73 20 61 occur here is a
5ee0: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 malloc() failur
5ef0: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 63 72 e.. */. if( cr
5f00: 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 eateCollation(db
5f10: 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 , "BINARY", SQLI
5f20: 54 45 5f 55 54 46 38 2c 20 30 2c 20 62 69 6e 43 TE_UTF8, 0, binC
5f30: 6f 6c 6c 46 75 6e 63 29 20 7c 7c 0a 20 20 20 20 ollFunc) ||.
5f40: 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
5f50: 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 n(db, "BINARY",
5f60: 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 SQLITE_UTF16BE,
5f70: 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 29 20 0, binCollFunc)
5f80: 7c 7c 0a 20 20 20 20 20 20 63 72 65 61 74 65 43 ||. createC
5f90: 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 ollation(db, "BI
5fa0: 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 NARY", SQLITE_UT
5fb0: 46 31 36 4c 45 2c 20 30 2c 20 62 69 6e 43 6f 6c F16LE, 0, binCol
5fc0: 6c 46 75 6e 63 29 20 7c 7c 0a 20 20 20 20 20 20 lFunc) ||.
5fd0: 28 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d (db->pDfltColl =
5fe0: 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c sqlite3FindColl
5ff0: 53 65 71 28 64 62 2c 20 53 51 4c 49 54 45 5f 55 Seq(db, SQLITE_U
6000: 54 46 38 2c 20 22 42 49 4e 41 52 59 22 2c 20 36 TF8, "BINARY", 6
6010: 2c 20 30 29 29 3d 3d 30 20 0a 20 20 29 7b 0a 20 , 0))==0 . ){.
6020: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
6030: 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 e3MallocFailed()
6040: 20 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 );. db->magi
6050: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 c = SQLITE_MAGIC
6060: 5f 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f 74 _CLOSED;. got
6070: 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 o opendb_out;.
6080: 7d 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64 }.. /* Also add
6090: 20 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69 6e a UTF-8 case-in
60a0: 73 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 74 sensitive collat
60b0: 69 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f ion sequence. */
60c0: 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 . createCollati
60d0: 6f 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c on(db, "NOCASE",
60e0: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c SQLITE_UTF8, 0,
60f0: 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 nocaseCollating
6100: 46 75 6e 63 29 3b 0a 0a 20 20 2f 2a 20 53 65 74 Func);.. /* Set
6110: 20 66 6c 61 67 73 20 6f 6e 20 74 68 65 20 62 75 flags on the bu
6120: 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 ilt-in collating
6130: 20 73 65 71 75 65 6e 63 65 73 20 2a 2f 0a 20 20 sequences */.
6140: 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 2d 3e 74 db->pDfltColl->t
6150: 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 43 4f 4c ype = SQLITE_COL
6160: 4c 5f 42 49 4e 41 52 59 3b 0a 20 20 70 43 6f 6c L_BINARY;. pCol
6170: 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 l = sqlite3FindC
6180: 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c 49 54 ollSeq(db, SQLIT
6190: 45 5f 55 54 46 38 2c 20 22 4e 4f 43 41 53 45 22 E_UTF8, "NOCASE"
61a0: 2c 20 36 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 , 6, 0);. if( p
61b0: 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 70 43 6f 6c Coll ){. pCol
61c0: 6c 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 l->type = SQLITE
61d0: 5f 43 4f 4c 4c 5f 4e 4f 43 41 53 45 3b 0a 20 20 _COLL_NOCASE;.
61e0: 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 }.. /* Open the
61f0: 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 backend databas
6200: 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 e driver */. rc
6210: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 = sqlite3BtreeF
6220: 61 63 74 6f 72 79 28 64 62 2c 20 7a 46 69 6c 65 actory(db, zFile
6230: 6e 61 6d 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47 name, 0, MAX_PAG
6240: 45 53 2c 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e ES, &db->aDb[0].
6250: 70 42 74 29 3b 0a 20 20 69 66 28 20 72 63 21 3d pBt);. if( rc!=
6260: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
6270: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
6280: 2c 20 72 63 2c 20 30 29 3b 0a 20 20 20 20 64 62 , rc, 0);. db
6290: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 ->magic = SQLITE
62a0: 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 _MAGIC_CLOSED;.
62b0: 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f goto opendb_o
62c0: 75 74 3b 0a 20 20 7d 0a 23 69 66 6e 64 65 66 20 ut;. }.#ifndef
62d0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 52 53 SQLITE_OMIT_PARS
62e0: 45 52 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e ER. db->aDb[0].
62f0: 70 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 pSchema = sqlite
6300: 33 53 63 68 65 6d 61 47 65 74 28 64 62 2d 3e 61 3SchemaGet(db->a
6310: 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 64 62 Db[0].pBt);. db
6320: 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 6d 61 ->aDb[1].pSchema
6330: 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 = sqlite3Schema
6340: 47 65 74 28 30 29 3b 0a 23 65 6e 64 69 66 0a 0a Get(0);.#endif..
6350: 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 30 5d if( db->aDb[0]
6360: 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 .pSchema ){.
6370: 45 4e 43 28 64 62 29 20 3d 20 53 51 4c 49 54 45 ENC(db) = SQLITE
6380: 5f 55 54 46 38 3b 0a 20 20 7d 0a 0a 20 20 2f 2a _UTF8;. }.. /*
6390: 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 61 66 The default saf
63a0: 65 74 79 5f 6c 65 76 65 6c 20 66 6f 72 20 74 68 ety_level for th
63b0: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 e main database
63c0: 69 73 20 27 66 75 6c 6c 27 3b 20 66 6f 72 20 74 is 'full'; for t
63d0: 68 65 20 74 65 6d 70 0a 20 20 2a 2a 20 64 61 74 he temp. ** dat
63e0: 61 62 61 73 65 20 69 74 20 69 73 20 27 4e 4f 4e abase it is 'NON
63f0: 45 27 2e 20 54 68 69 73 20 6d 61 74 63 68 65 73 E'. This matches
6400: 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 the pager layer
6410: 20 64 65 66 61 75 6c 74 73 2e 20 20 0a 20 20 2a defaults. . *
6420: 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a /. db->aDb[0].z
6430: 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b 0a 20 Name = "main";.
6440: 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 73 61 66 65 db->aDb[0].safe
6450: 74 79 5f 6c 65 76 65 6c 20 3d 20 33 3b 0a 23 69 ty_level = 3;.#i
6460: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
6470: 54 5f 54 45 4d 50 44 42 0a 20 20 64 62 2d 3e 61 T_TEMPDB. db->a
6480: 44 62 5b 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22 74 Db[1].zName = "t
6490: 65 6d 70 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b emp";. db->aDb[
64a0: 31 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 1].safety_level
64b0: 3d 20 31 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f = 1;.#endif.. /
64c0: 2a 20 52 65 67 69 73 74 65 72 20 61 6c 6c 20 62 * Register all b
64d0: 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e uilt-in function
64e0: 73 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20 61 74 s, but do not at
64f0: 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 tempt to read th
6500: 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 e. ** database
6510: 73 63 68 65 6d 61 20 79 65 74 2e 20 54 68 69 73 schema yet. This
6520: 20 69 73 20 64 65 6c 61 79 65 64 20 75 6e 74 69 is delayed unti
6530: 6c 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 l the first time
6540: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 the database.
6550: 2a 2a 20 69 73 20 61 63 63 65 73 73 65 64 2e 0a ** is accessed..
6560: 20 20 2a 2f 0a 20 20 69 66 28 20 21 73 71 6c 69 */. if( !sqli
6570: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 te3MallocFailed(
6580: 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) ){. sqlite3
6590: 52 65 67 69 73 74 65 72 42 75 69 6c 74 69 6e 46 RegisterBuiltinF
65a0: 75 6e 63 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20 unctions(db);.
65b0: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 sqlite3Error(d
65c0: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 b, SQLITE_OK, 0)
65d0: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6d 61 67 69 ;. }. db->magi
65e0: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 c = SQLITE_MAGIC
65f0: 5f 4f 50 45 4e 3b 0a 0a 6f 70 65 6e 64 62 5f 6f _OPEN;..opendb_o
6600: 75 74 3a 0a 20 20 69 66 28 20 53 51 4c 49 54 45 ut:. if( SQLITE
6610: 5f 4e 4f 4d 45 4d 3d 3d 28 72 63 20 3d 20 73 71 _NOMEM==(rc = sq
6620: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 64 62 lite3_errcode(db
6630: 29 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 )) ){. sqlite
6640: 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 3_close(db);.
6650: 20 64 62 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 2a db = 0;. }. *
6660: 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 72 65 74 ppDb = db;. ret
6670: 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 urn sqlite3ApiEx
6680: 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a 0a 2f 2a it(0, rc);.}../*
6690: 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 .** Open a new d
66a0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a atabase handle..
66b0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f */.int sqlite3_o
66c0: 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 pen(. const cha
66d0: 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 r *zFilename, .
66e0: 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 sqlite3 **ppDb
66f0: 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 .){. return ope
6700: 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e nDatabase(zFilen
6710: 61 6d 65 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a 23 ame, ppDb);.}..#
6720: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
6730: 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 4f IT_UTF16./*.** O
6740: 70 65 6e 20 61 20 6e 65 77 20 64 61 74 61 62 61 pen a new databa
6750: 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e se handle..*/.in
6760: 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 t sqlite3_open16
6770: 28 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a (. const void *
6780: 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71 zFilename, . sq
6790: 6c 69 74 65 33 20 2a 2a 70 70 44 62 0a 29 7b 0a lite3 **ppDb.){.
67a0: 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46 char const *zF
67b0: 69 6c 65 6e 61 6d 65 38 3b 20 20 20 2f 2a 20 7a ilename8; /* z
67c0: 46 69 6c 65 6e 61 6d 65 20 65 6e 63 6f 64 65 64 Filename encoded
67d0: 20 69 6e 20 55 54 46 2d 38 20 69 6e 73 74 65 61 in UTF-8 instea
67e0: 64 20 6f 66 20 55 54 46 2d 31 36 20 2a 2f 0a 20 d of UTF-16 */.
67f0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
6800: 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 _OK;. sqlite3_v
6810: 61 6c 75 65 20 2a 70 56 61 6c 3b 0a 0a 20 20 61 alue *pVal;.. a
6820: 73 73 65 72 74 28 20 7a 46 69 6c 65 6e 61 6d 65 ssert( zFilename
6830: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 70 );. assert( pp
6840: 44 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 3d 20 Db );. *ppDb =
6850: 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69 0;. pVal = sqli
6860: 74 65 33 56 61 6c 75 65 4e 65 77 28 29 3b 0a 20 te3ValueNew();.
6870: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 sqlite3ValueSet
6880: 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a 46 Str(pVal, -1, zF
6890: 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f ilename, SQLITE_
68a0: 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c UTF16NATIVE, SQL
68b0: 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a ITE_STATIC);. z
68c0: 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c 69 Filename8 = sqli
68d0: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 te3ValueText(pVa
68e0: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b l, SQLITE_UTF8);
68f0: 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 . if( zFilename
6900: 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 70 8 ){. rc = op
6910: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 enDatabase(zFile
6920: 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b 0a 20 20 name8, ppDb);.
6930: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
6940: 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20 29 7b 0a _OK && *ppDb ){.
6950: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
6960: 65 33 5f 65 78 65 63 28 2a 70 70 44 62 2c 20 22 e3_exec(*ppDb, "
6970: 50 52 41 47 4d 41 20 65 6e 63 6f 64 69 6e 67 20 PRAGMA encoding
6980: 3d 20 27 55 54 46 2d 31 36 27 22 2c 20 30 2c 20 = 'UTF-16'", 0,
6990: 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 0, 0);. if(
69a0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
69b0: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
69c0: 33 5f 63 6c 6f 73 65 28 2a 70 70 44 62 29 3b 0a 3_close(*ppDb);.
69d0: 20 20 20 20 20 20 20 20 2a 70 70 44 62 20 3d 20 *ppDb =
69e0: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0;. }. }
69f0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 61 . }. sqlite3Va
6a00: 6c 75 65 46 72 65 65 28 70 56 61 6c 29 3b 0a 0a lueFree(pVal);..
6a10: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
6a20: 41 70 69 45 78 69 74 28 30 2c 20 72 63 29 3b 0a ApiExit(0, rc);.
6a30: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 }.#endif /* SQLI
6a40: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f TE_OMIT_UTF16 */
6a50: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c ../*.** The foll
6a60: 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 20 64 65 owing routine de
6a70: 73 74 72 6f 79 73 20 61 20 76 69 72 74 75 61 6c stroys a virtual
6a80: 20 6d 61 63 68 69 6e 65 20 74 68 61 74 20 69 73 machine that is
6a90: 20 63 72 65 61 74 65 64 20 62 79 0a 2a 2a 20 74 created by.** t
6aa0: 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70 69 he sqlite3_compi
6ab0: 6c 65 28 29 20 72 6f 75 74 69 6e 65 2e 20 54 68 le() routine. Th
6ac0: 65 20 69 6e 74 65 67 65 72 20 72 65 74 75 72 6e e integer return
6ad0: 65 64 20 69 73 20 61 6e 20 53 51 4c 49 54 45 5f ed is an SQLITE_
6ae0: 0a 2a 2a 20 73 75 63 63 65 73 73 2f 66 61 69 6c .** success/fail
6af0: 75 72 65 20 63 6f 64 65 20 74 68 61 74 20 64 65 ure code that de
6b00: 73 63 72 69 62 65 73 20 74 68 65 20 72 65 73 75 scribes the resu
6b10: 6c 74 20 6f 66 20 65 78 65 63 75 74 69 6e 67 20 lt of executing
6b20: 74 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20 6d the virtual.** m
6b30: 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 achine..**.** Th
6b40: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 is routine sets
6b50: 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 61 the error code a
6b60: 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 72 6e nd string return
6b70: 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 ed by.** sqlite3
6b80: 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 6c 69 _errcode(), sqli
6b90: 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e 64 te3_errmsg() and
6ba0: 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 sqlite3_errmsg1
6bb0: 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 6()..*/.int sqli
6bc0: 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 73 71 6c te3_finalize(sql
6bd0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 ite3_stmt *pStmt
6be0: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 ){. int rc;. i
6bf0: 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a 20 f( pStmt==0 ){.
6c00: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
6c10: 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 K;. }else{.
6c20: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 rc = sqlite3Vdbe
6c30: 46 69 6e 61 6c 69 7a 65 28 28 56 64 62 65 2a 29 Finalize((Vdbe*)
6c40: 70 53 74 6d 74 29 3b 0a 20 20 7d 0a 20 20 72 65 pStmt);. }. re
6c50: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
6c60: 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68 65 20 * Terminate the
6c70: 63 75 72 72 65 6e 74 20 65 78 65 63 75 74 69 6f current executio
6c80: 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 74 61 74 n of an SQL stat
6c90: 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 65 74 20 ement and reset
6ca0: 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 69 74 it.** back to it
6cb0: 73 20 73 74 61 72 74 69 6e 67 20 73 74 61 74 65 s starting state
6cc0: 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 so that it can
6cd0: 62 65 20 72 65 75 73 65 64 2e 20 41 20 73 75 63 be reused. A suc
6ce0: 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d 0a 2a cess code from.*
6cf0: 2a 20 74 68 65 20 70 72 69 6f 72 20 65 78 65 63 * the prior exec
6d00: 75 74 69 6f 6e 20 69 73 20 72 65 74 75 72 6e 65 ution is returne
6d10: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f d..**.** This ro
6d20: 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 65 utine sets the e
6d30: 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 74 rror code and st
6d40: 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62 79 ring returned by
6d50: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 63 .** sqlite3_errc
6d60: 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f 65 ode(), sqlite3_e
6d70: 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69 rrmsg() and sqli
6d80: 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e 0a te3_errmsg16()..
6d90: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 72 */.int sqlite3_r
6da0: 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73 74 6d eset(sqlite3_stm
6db0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 t *pStmt){. int
6dc0: 20 72 63 3b 0a 20 20 69 66 28 20 70 53 74 6d 74 rc;. if( pStmt
6dd0: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 ==0 ){. rc =
6de0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c SQLITE_OK;. }el
6df0: 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c se{. rc = sql
6e00: 69 74 65 33 56 64 62 65 52 65 73 65 74 28 28 56 ite3VdbeReset((V
6e10: 64 62 65 2a 29 70 53 74 6d 74 29 3b 0a 20 20 20 dbe*)pStmt);.
6e20: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 sqlite3VdbeMake
6e30: 52 65 61 64 79 28 28 56 64 62 65 2a 29 70 53 74 Ready((Vdbe*)pSt
6e40: 6d 74 2c 20 2d 31 2c 20 30 2c 20 30 2c 20 30 29 mt, -1, 0, 0, 0)
6e50: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
6e60: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 c;.}../*.** Regi
6e70: 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 ster a new colla
6e80: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 tion sequence wi
6e90: 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 th the database
6ea0: 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e handle db..*/.in
6eb0: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 t sqlite3_create
6ec0: 5f 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 _collation(. sq
6ed0: 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f lite3* db, . co
6ee0: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c nst char *zName,
6ef0: 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 . int enc, .
6f00: 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e void* pCtx,. in
6f10: 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 t(*xCompare)(voi
6f20: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 d*,int,const voi
6f30: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 d*,int,const voi
6f40: 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b d*).){. int rc;
6f50: 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 . assert( !sqli
6f60: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 te3MallocFailed(
6f70: 29 20 29 3b 0a 20 20 72 63 20 3d 20 63 72 65 61 ) );. rc = crea
6f80: 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 teCollation(db,
6f90: 7a 4e 61 6d 65 2c 20 65 6e 63 2c 20 70 43 74 78 zName, enc, pCtx
6fa0: 2c 20 78 43 6f 6d 70 61 72 65 29 3b 0a 20 20 72 , xCompare);. r
6fb0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 eturn sqlite3Api
6fc0: 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 7d 0a Exit(db, rc);.}.
6fd0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
6fe0: 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a OMIT_UTF16./*.**
6ff0: 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 Register a new
7000: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
7010: 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74 61 ce with the data
7020: 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a base handle db..
7030: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
7040: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31 reate_collation1
7050: 36 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 6(. sqlite3* db
7060: 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 , . const char
7070: 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 *zName, . int e
7080: 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 nc, . void* pCt
7090: 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 x,. int(*xCompa
70a0: 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f re)(void*,int,co
70b0: 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f nst void*,int,co
70c0: 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 nst void*).){.
70d0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
70e0: 4f 4b 3b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d OK;. char *zNam
70f0: 65 38 3b 20 0a 20 20 61 73 73 65 72 74 28 20 21 e8; . assert( !
7100: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 sqlite3MallocFai
7110: 6c 65 64 28 29 20 29 3b 0a 20 20 7a 4e 61 6d 65 led() );. zName
7120: 38 20 3d 20 73 71 6c 69 74 65 33 75 74 66 31 36 8 = sqlite3utf16
7130: 74 6f 38 28 7a 4e 61 6d 65 2c 20 2d 31 29 3b 0a to8(zName, -1);.
7140: 20 20 69 66 28 20 7a 4e 61 6d 65 38 20 29 7b 0a if( zName8 ){.
7150: 20 20 20 20 72 63 20 3d 20 63 72 65 61 74 65 43 rc = createC
7160: 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 ollation(db, zNa
7170: 6d 65 38 2c 20 65 6e 63 2c 20 70 43 74 78 2c 20 me8, enc, pCtx,
7180: 78 43 6f 6d 70 61 72 65 29 3b 0a 20 20 20 20 73 xCompare);. s
7190: 71 6c 69 74 65 46 72 65 65 28 7a 4e 61 6d 65 38 qliteFree(zName8
71a0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
71b0: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 sqlite3ApiExit(d
71c0: 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69 66 b, rc);.}.#endif
71d0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
71e0: 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 UTF16 */../*.**
71f0: 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 Register a colla
7200: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 tion sequence fa
7210: 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 ctory callback w
7220: 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 ith the database
7230: 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 handle.** db. R
7240: 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 69 eplace any previ
7250: 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 ously installed
7260: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
7270: 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 ce factory..*/.i
7280: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 nt sqlite3_colla
7290: 74 69 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 20 73 tion_needed(. s
72a0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 qlite3 *db, . v
72b0: 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 oid *pCollNeeded
72c0: 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 Arg, . void(*xC
72d0: 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 2a ollNeeded)(void*
72e0: 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 ,sqlite3*,int eT
72f0: 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 61 extRep,const cha
7300: 72 2a 29 0a 29 7b 0a 20 20 69 66 28 20 73 71 6c r*).){. if( sql
7310: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 ite3SafetyCheck(
7320: 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 db) ){. retur
7330: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b n SQLITE_MISUSE;
7340: 0a 20 20 7d 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c . }. db->xColl
7350: 4e 65 65 64 65 64 20 3d 20 78 43 6f 6c 6c 4e 65 Needed = xCollNe
7360: 65 64 65 64 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c eded;. db->xCol
7370: 6c 4e 65 65 64 65 64 31 36 20 3d 20 30 3b 0a 20 lNeeded16 = 0;.
7380: 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 db->pCollNeeded
7390: 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 Arg = pCollNeede
73a0: 64 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 dArg;. return S
73b0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 QLITE_OK;.}..#if
73c0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
73d0: 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67 _UTF16./*.** Reg
73e0: 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f ister a collatio
73f0: 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f n sequence facto
7400: 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 ry callback with
7410: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
7420: 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c ndle.** db. Repl
7430: 61 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 ace any previous
7440: 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c ly installed col
7450: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
7460: 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 factory..*/.int
7470: 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f sqlite3_collatio
7480: 6e 5f 6e 65 65 64 65 64 31 36 28 0a 20 20 73 71 n_needed16(. sq
7490: 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f lite3 *db, . vo
74a0: 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 id *pCollNeededA
74b0: 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f rg, . void(*xCo
74c0: 6c 6c 4e 65 65 64 65 64 31 36 29 28 76 6f 69 64 llNeeded16)(void
74d0: 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 *,sqlite3*,int e
74e0: 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 76 6f TextRep,const vo
74f0: 69 64 2a 29 0a 29 7b 0a 20 20 69 66 28 20 73 71 id*).){. if( sq
7500: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
7510: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 (db) ){. retu
7520: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
7530: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 78 43 6f 6c ;. }. db->xCol
7540: 6c 4e 65 65 64 65 64 20 3d 20 30 3b 0a 20 20 64 lNeeded = 0;. d
7550: 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 b->xCollNeeded16
7560: 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 = xCollNeeded16
7570: 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 ;. db->pCollNee
7580: 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 dedArg = pCollNe
7590: 65 64 65 64 41 72 67 3b 0a 20 20 72 65 74 75 72 ededArg;. retur
75a0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 n SQLITE_OK;.}.#
75b0: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
75c0: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 OMIT_UTF16 */..#
75d0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
75e0: 49 54 5f 47 4c 4f 42 41 4c 52 45 43 4f 56 45 52 IT_GLOBALRECOVER
75f0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
7600: 74 69 6f 6e 20 69 73 20 6e 6f 77 20 61 6e 20 61 tion is now an a
7610: 6e 61 63 68 72 6f 6e 69 73 6d 2e 20 49 74 20 75 nachronism. It u
7620: 73 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 74 sed to be used t
7630: 6f 20 72 65 63 6f 76 65 72 20 66 72 6f 6d 20 61 o recover from a
7640: 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 .** malloc() fai
7650: 6c 75 72 65 2c 20 62 75 74 20 53 51 4c 69 74 65 lure, but SQLite
7660: 20 6e 6f 77 20 64 6f 65 73 20 74 68 69 73 20 61 now does this a
7670: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 2a 2f utomatically..*/
7680: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 67 6c 6f .int sqlite3_glo
7690: 62 61 6c 5f 72 65 63 6f 76 65 72 28 29 7b 0a 20 bal_recover(){.
76a0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
76b0: 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a K;.}.#endif../*.
76c0: 2a 2a 20 54 65 73 74 20 74 6f 20 73 65 65 20 77 ** Test to see w
76d0: 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 hether or not th
76e0: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
76f0: 63 74 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 6f ction is in auto
7700: 63 6f 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e 20 commit.** mode.
7710: 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 Return TRUE if
7720: 69 74 20 69 73 20 61 6e 64 20 46 41 4c 53 45 20 it is and FALSE
7730: 69 66 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f 6d if not. Autocom
7740: 6d 69 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a 2a mit mode is on.*
7750: 2a 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41 * by default. A
7760: 75 74 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 73 utocommit is dis
7770: 61 62 6c 65 64 20 62 79 20 61 20 42 45 47 49 4e abled by a BEGIN
7780: 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 statement and r
7790: 65 65 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 74 eenabled.** by t
77a0: 68 65 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 6f he next COMMIT o
77b0: 72 20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2a 0a 2a r ROLLBACK..**.*
77c0: 2a 2a 2a 2a 2a 2a 20 54 48 49 53 20 49 53 20 41 ****** THIS IS A
77d0: 4e 20 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 41 N EXPERIMENTAL A
77e0: 50 49 20 41 4e 44 20 49 53 20 53 55 42 4a 45 43 PI AND IS SUBJEC
77f0: 54 20 54 4f 20 43 48 41 4e 47 45 20 2a 2a 2a 2a T TO CHANGE ****
7800: 2a 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 **.*/.int sqlite
7810: 33 5f 67 65 74 5f 61 75 74 6f 63 6f 6d 6d 69 74 3_get_autocommit
7820: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 (sqlite3 *db){.
7830: 20 72 65 74 75 72 6e 20 64 62 2d 3e 61 75 74 6f return db->auto
7840: 43 6f 6d 6d 69 74 3b 0a 7d 0a 0a 23 69 66 64 65 Commit;.}..#ifde
7850: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f f SQLITE_DEBUG./
7860: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
7870: 6e 67 20 72 6f 75 74 69 6e 65 20 69 73 20 73 75 ng routine is su
7880: 62 74 69 74 75 74 65 64 20 66 6f 72 20 63 6f 6e btituted for con
7890: 73 74 61 6e 74 20 53 51 4c 49 54 45 5f 43 4f 52 stant SQLITE_COR
78a0: 52 55 50 54 20 69 6e 0a 2a 2a 20 64 65 62 75 67 RUPT in.** debug
78b0: 67 69 6e 67 20 62 75 69 6c 64 73 2e 20 20 54 68 ging builds. Th
78c0: 69 73 20 70 72 6f 76 69 64 65 73 20 61 20 77 61 is provides a wa
78d0: 79 20 74 6f 20 73 65 74 20 61 20 62 72 65 61 6b y to set a break
78e0: 70 6f 69 6e 74 20 66 6f 72 20 77 68 65 6e 0a 2a point for when.*
78f0: 2a 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 73 20 * corruption is
7900: 66 69 72 73 74 20 64 65 74 65 63 74 65 64 2e 0a first detected..
7910: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f */.int sqlite3Co
7920: 72 72 75 70 74 28 76 6f 69 64 29 7b 0a 20 20 72 rrupt(void){. r
7930: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
7940: 52 55 50 54 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a RUPT;.}.#endif..
7950: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
7960: 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
7970: 45 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f E./*.** Enable o
7980: 72 20 64 69 73 61 62 6c 65 20 74 68 65 20 73 68 r disable the sh
7990: 61 72 65 64 20 70 61 67 65 72 20 61 6e 64 20 73 ared pager and s
79a0: 63 68 65 6d 61 20 66 65 61 74 75 72 65 73 20 66 chema features f
79b0: 6f 72 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e or the.** curren
79c0: 74 20 74 68 72 65 61 64 2e 0a 2a 2a 0a 2a 2a 20 t thread..**.**
79d0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 6f This routine sho
79e0: 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c uld only be call
79f0: 65 64 20 77 68 65 6e 20 74 68 65 72 65 20 61 72 ed when there ar
7a00: 65 20 6e 6f 20 6f 70 65 6e 0a 2a 2a 20 64 61 74 e no open.** dat
7a10: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
7a20: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
7a30: 33 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 3_enable_shared_
7a40: 63 61 63 68 65 28 69 6e 74 20 65 6e 61 62 6c 65 cache(int enable
7a50: 29 7b 0a 20 20 54 68 72 65 61 64 44 61 74 61 20 ){. ThreadData
7a60: 2a 70 54 64 20 3d 20 73 71 6c 69 74 65 33 54 68 *pTd = sqlite3Th
7a70: 72 65 61 64 44 61 74 61 28 29 3b 0a 20 20 69 66 readData();. if
7a80: 28 20 70 54 64 20 29 7b 0a 20 20 20 20 2f 2a 20 ( pTd ){. /*
7a90: 49 74 20 69 73 20 6f 6e 6c 79 20 6c 65 67 61 6c It is only legal
7aa0: 20 74 6f 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 to call sqlite3
7ab0: 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63 _enable_shared_c
7ac0: 61 63 68 65 28 29 20 77 68 65 6e 20 74 68 65 72 ache() when ther
7ad0: 65 0a 20 20 20 20 2a 2a 20 61 72 65 20 6e 6f 20 e. ** are no
7ae0: 63 75 72 72 65 6e 74 6c 79 20 6f 70 65 6e 20 62 currently open b
7af0: 2d 74 72 65 65 73 20 74 68 61 74 20 77 65 72 65 -trees that were
7b00: 20 6f 70 65 6e 65 64 20 62 79 20 74 68 65 20 63 opened by the c
7b10: 61 6c 6c 69 6e 67 20 74 68 72 65 61 64 2e 0a 20 alling thread..
7b20: 20 20 20 2a 2a 20 54 68 69 73 20 63 6f 6e 64 69 ** This condi
7b30: 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 65 61 73 tion is only eas
7b40: 79 20 74 6f 20 64 65 74 65 63 74 20 69 66 20 74 y to detect if t
7b50: 68 65 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 he shared-cache
7b60: 77 65 72 65 20 0a 20 20 20 20 2a 2a 20 70 72 65 were . ** pre
7b70: 76 69 6f 75 73 6c 79 20 65 6e 61 62 6c 65 64 20 viously enabled
7b80: 28 61 6e 64 20 69 73 20 62 65 69 6e 67 20 64 69 (and is being di
7b90: 73 61 62 6c 65 64 29 2e 20 0a 20 20 20 20 2a 2f sabled). . */
7ba0: 0a 20 20 20 20 69 66 28 20 70 54 64 2d 3e 70 42 . if( pTd->pB
7bb0: 74 72 65 65 20 26 26 20 21 65 6e 61 62 6c 65 20 tree && !enable
7bc0: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
7bd0: 20 70 54 64 2d 3e 75 73 65 53 68 61 72 65 64 44 pTd->useSharedD
7be0: 61 74 61 20 29 3b 0a 20 20 20 20 20 20 72 65 74 ata );. ret
7bf0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
7c00: 45 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 54 E;. }.. pT
7c10: 64 2d 3e 75 73 65 53 68 61 72 65 64 44 61 74 61 d->useSharedData
7c20: 20 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 20 20 73 = enable;. s
7c30: 71 6c 69 74 65 33 52 65 6c 65 61 73 65 54 68 72 qlite3ReleaseThr
7c40: 65 61 64 44 61 74 61 28 29 3b 0a 20 20 7d 0a 20 eadData();. }.
7c50: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 return sqlite3A
7c60: 70 69 45 78 69 74 28 30 2c 20 53 51 4c 49 54 45 piExit(0, SQLITE
7c70: 5f 4f 4b 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a _OK);.}.#endif..
7c80: 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 /*.** This is a
7c90: 63 6f 6e 76 65 6e 69 65 6e 63 65 20 72 6f 75 74 convenience rout
7ca0: 69 6e 65 20 74 68 61 74 20 6d 61 6b 65 73 20 73 ine that makes s
7cb0: 75 72 65 20 74 68 61 74 20 61 6c 6c 20 74 68 72 ure that all thr
7cc0: 65 61 64 2d 73 70 65 63 69 66 69 63 0a 2a 2a 20 ead-specific.**
7cd0: 64 61 74 61 20 66 6f 72 20 74 68 69 73 20 74 68 data for this th
7ce0: 72 65 61 64 20 68 61 73 20 62 65 65 6e 20 64 65 read has been de
7cf0: 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f 0a 76 6f allocated..*/.vo
7d00: 69 64 20 73 71 6c 69 74 65 33 5f 74 68 72 65 61 id sqlite3_threa
7d10: 64 5f 63 6c 65 61 6e 75 70 28 76 6f 69 64 29 7b d_cleanup(void){
7d20: 0a 20 20 54 68 72 65 61 64 44 61 74 61 20 2a 70 . ThreadData *p
7d30: 54 64 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 68 Td = sqlite3OsTh
7d40: 72 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61 readSpecificData
7d50: 28 30 29 3b 0a 20 20 69 66 28 20 70 54 64 20 29 (0);. if( pTd )
7d60: 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 54 64 {. memset(pTd
7d70: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 2a 70 54 64 , 0, sizeof(*pTd
7d80: 29 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f ));. sqlite3O
7d90: 73 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 sThreadSpecificD
7da0: 61 74 61 28 2d 31 29 3b 0a 20 20 7d 0a 7d 0a 0a ata(-1);. }.}..
7db0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 6d 65 74 /*.** Return met
7dc0: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 a information ab
7dd0: 6f 75 74 20 61 20 73 70 65 63 69 66 69 63 20 63 out a specific c
7de0: 6f 6c 75 6d 6e 20 6f 66 20 61 20 64 61 74 61 62 olumn of a datab
7df0: 61 73 65 20 74 61 62 6c 65 2e 0a 2a 2a 20 53 65 ase table..** Se
7e00: 65 20 63 6f 6d 6d 65 6e 74 20 69 6e 20 73 71 6c e comment in sql
7e10: 69 74 65 33 2e 68 20 28 73 71 6c 69 74 65 2e 68 ite3.h (sqlite.h
7e20: 2e 69 6e 29 20 66 6f 72 20 64 65 74 61 69 6c 73 .in) for details
7e30: 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
7e40: 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e TE_ENABLE_COLUMN
7e50: 5f 4d 45 54 41 44 41 54 41 0a 69 6e 74 20 73 71 _METADATA.int sq
7e60: 6c 69 74 65 33 5f 74 61 62 6c 65 5f 63 6f 6c 75 lite3_table_colu
7e70: 6d 6e 5f 6d 65 74 61 64 61 74 61 28 0a 20 20 73 mn_metadata(. s
7e80: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 qlite3 *db,
7e90: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f /* Co
7ea0: 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 nnection handle
7eb0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
7ec0: 2a 7a 44 62 4e 61 6d 65 2c 20 20 20 20 20 20 20 *zDbName,
7ed0: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 6e 61 6d /* Database nam
7ee0: 65 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63 e or NULL */. c
7ef0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62 6c onst char *zTabl
7f00: 65 4e 61 6d 65 2c 20 20 20 20 20 2f 2a 20 54 61 eName, /* Ta
7f10: 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 6f ble name */. co
7f20: 6e 73 74 20 63 68 61 72 20 2a 7a 43 6f 6c 75 6d nst char *zColum
7f30: 6e 4e 61 6d 65 2c 20 20 20 20 2f 2a 20 43 6f 6c nName, /* Col
7f40: 75 6d 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 68 umn name */. ch
7f50: 61 72 20 63 6f 6e 73 74 20 2a 2a 70 7a 44 61 74 ar const **pzDat
7f60: 61 54 79 70 65 2c 20 20 20 20 2f 2a 20 4f 55 54 aType, /* OUT
7f70: 50 55 54 3a 20 44 65 63 6c 61 72 65 64 20 64 61 PUT: Declared da
7f80: 74 61 20 74 79 70 65 20 2a 2f 0a 20 20 63 68 61 ta type */. cha
7f90: 72 20 63 6f 6e 73 74 20 2a 2a 70 7a 43 6f 6c 6c r const **pzColl
7fa0: 53 65 71 2c 20 20 20 20 20 2f 2a 20 4f 55 54 50 Seq, /* OUTP
7fb0: 55 54 3a 20 43 6f 6c 6c 61 74 69 6f 6e 20 73 65 UT: Collation se
7fc0: 71 75 65 6e 63 65 20 6e 61 6d 65 20 2a 2f 0a 20 quence name */.
7fd0: 20 69 6e 74 20 2a 70 4e 6f 74 4e 75 6c 6c 2c 20 int *pNotNull,
7fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7ff0: 4f 55 54 50 55 54 3a 20 54 72 75 65 20 69 66 20 OUTPUT: True if
8000: 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 NOT NULL constra
8010: 69 6e 74 20 65 78 69 73 74 73 20 2a 2f 0a 20 20 int exists */.
8020: 69 6e 74 20 2a 70 50 72 69 6d 61 72 79 4b 65 79 int *pPrimaryKey
8030: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f , /* O
8040: 55 54 50 55 54 3a 20 54 72 75 65 20 69 66 20 63 UTPUT: True if c
8050: 6f 6c 75 6d 6e 20 70 61 72 74 20 6f 66 20 50 4b olumn part of PK
8060: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 41 75 74 6f */. int *pAuto
8070: 69 6e 63 20 20 20 20 20 20 20 20 20 20 20 20 20 inc
8080: 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 /* OUTPUT: Tru
8090: 65 20 69 66 20 63 6f 6c 75 6d 73 20 69 73 20 61 e if colums is a
80a0: 75 74 6f 2d 69 6e 63 72 65 6d 65 6e 74 20 2a 2f uto-increment */
80b0: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 .){. int rc;.
80c0: 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 char *zErrMsg =
80d0: 30 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 0;. Table *pTab
80e0: 20 3d 20 30 3b 0a 20 20 43 6f 6c 75 6d 6e 20 2a = 0;. Column *
80f0: 70 43 6f 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 pCol = 0;. int
8100: 69 43 6f 6c 3b 0a 0a 20 20 63 68 61 72 20 63 6f iCol;.. char co
8110: 6e 73 74 20 2a 7a 44 61 74 61 54 79 70 65 20 3d nst *zDataType =
8120: 20 30 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 0;. char const
8130: 20 2a 7a 43 6f 6c 6c 53 65 71 20 3d 20 30 3b 0a *zCollSeq = 0;.
8140: 20 20 69 6e 74 20 6e 6f 74 6e 75 6c 6c 20 3d 20 int notnull =
8150: 30 3b 0a 20 20 69 6e 74 20 70 72 69 6d 61 72 79 0;. int primary
8160: 6b 65 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 61 key = 0;. int a
8170: 75 74 6f 69 6e 63 20 3d 20 30 3b 0a 0a 20 20 2f utoinc = 0;.. /
8180: 2a 20 45 6e 73 75 72 65 20 74 68 65 20 64 61 74 * Ensure the dat
8190: 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 abase schema has
81a0: 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 2a 2f 0a been loaded */.
81b0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 if( sqlite3Saf
81c0: 65 74 79 4f 6e 28 64 62 29 20 29 7b 0a 20 20 20 etyOn(db) ){.
81d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
81e0: 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 72 63 20 ISUSE;. }. rc
81f0: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64 62 = sqlite3Init(db
8200: 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 , &zErrMsg);. i
8210: 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 f( SQLITE_OK!=rc
8220: 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 ){. goto err
8230: 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f or_out;. }.. /
8240: 2a 20 4c 6f 63 61 74 65 20 74 68 65 20 74 61 62 * Locate the tab
8250: 6c 65 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 2a le in question *
8260: 2f 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 /. pTab = sqlit
8270: 65 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 e3FindTable(db,
8280: 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 7a 44 62 4e zTableName, zDbN
8290: 61 6d 65 29 3b 0a 20 20 69 66 28 20 21 70 54 61 ame);. if( !pTa
82a0: 62 20 7c 7c 20 70 54 61 62 2d 3e 70 53 65 6c 65 b || pTab->pSele
82b0: 63 74 20 29 7b 0a 20 20 20 20 70 54 61 62 20 3d ct ){. pTab =
82c0: 20 30 3b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 0;. goto err
82d0: 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f or_out;. }.. /
82e0: 2a 20 46 69 6e 64 20 74 68 65 20 63 6f 6c 75 6d * Find the colum
82f0: 6e 20 66 6f 72 20 77 68 69 63 68 20 69 6e 66 6f n for which info
8300: 20 69 73 20 72 65 71 75 65 73 74 65 64 20 2a 2f is requested */
8310: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 73 . if( sqlite3Is
8320: 52 6f 77 69 64 28 7a 43 6f 6c 75 6d 6e 4e 61 6d Rowid(zColumnNam
8330: 65 29 20 29 7b 0a 20 20 20 20 69 43 6f 6c 20 3d e) ){. iCol =
8340: 20 70 54 61 62 2d 3e 69 50 4b 65 79 3b 0a 20 20 pTab->iPKey;.
8350: 20 20 69 66 28 20 69 43 6f 6c 3e 3d 30 20 29 7b if( iCol>=0 ){
8360: 0a 20 20 20 20 20 20 70 43 6f 6c 20 3d 20 26 70 . pCol = &p
8370: 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b Tab->aCol[iCol];
8380: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a . }. }else{.
8390: 20 20 20 20 66 6f 72 28 69 43 6f 6c 3d 30 3b 20 for(iCol=0;
83a0: 69 43 6f 6c 3c 70 54 61 62 2d 3e 6e 43 6f 6c 3b iCol<pTab->nCol;
83b0: 20 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 20 iCol++){.
83c0: 70 43 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43 pCol = &pTab->aC
83d0: 6f 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 20 20 20 20 ol[iCol];.
83e0: 69 66 28 20 30 3d 3d 73 71 6c 69 74 65 33 53 74 if( 0==sqlite3St
83f0: 72 49 43 6d 70 28 70 43 6f 6c 2d 3e 7a 4e 61 6d rICmp(pCol->zNam
8400: 65 2c 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 e, zColumnName)
8410: 29 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b ){. break
8420: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
8430: 20 20 20 20 69 66 28 20 69 43 6f 6c 3d 3d 70 54 if( iCol==pT
8440: 61 62 2d 3e 6e 43 6f 6c 20 29 7b 0a 20 20 20 20 ab->nCol ){.
8450: 20 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 pTab = 0;.
8460: 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 goto error_out
8470: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f ;. }. }.. /
8480: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
8490: 62 6c 6f 63 6b 20 73 74 6f 72 65 73 20 74 68 65 block stores the
84a0: 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f meta informatio
84b0: 6e 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72 n that will be r
84c0: 65 74 75 72 6e 65 64 0a 20 20 2a 2a 20 74 6f 20 eturned. ** to
84d0: 74 68 65 20 63 61 6c 6c 65 72 20 69 6e 20 6c 6f the caller in lo
84e0: 63 61 6c 20 76 61 72 69 61 62 6c 65 73 20 7a 44 cal variables zD
84f0: 61 74 61 54 79 70 65 2c 20 7a 43 6f 6c 6c 53 65 ataType, zCollSe
8500: 71 2c 20 6e 6f 74 6e 75 6c 6c 2c 20 70 72 69 6d q, notnull, prim
8510: 61 72 79 6b 65 79 0a 20 20 2a 2a 20 61 6e 64 20 arykey. ** and
8520: 61 75 74 6f 69 6e 63 2e 20 41 74 20 74 68 69 73 autoinc. At this
8530: 20 70 6f 69 6e 74 20 74 68 65 72 65 20 61 72 65 point there are
8540: 20 74 77 6f 20 70 6f 73 73 69 62 69 6c 69 74 69 two possibiliti
8550: 65 73 3a 0a 20 20 2a 2a 20 0a 20 20 2a 2a 20 20 es:. ** . **
8560: 20 20 20 31 2e 20 54 68 65 20 73 70 65 63 69 66 1. The specif
8570: 69 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 ied column name
8580: 77 61 73 20 72 6f 77 69 64 22 2c 20 22 6f 69 64 was rowid", "oid
8590: 22 20 6f 72 20 22 5f 72 6f 77 69 64 5f 22 20 0a " or "_rowid_" .
85a0: 20 20 2a 2a 20 20 20 20 20 20 20 20 61 6e 64 20 ** and
85b0: 74 68 65 72 65 20 69 73 20 6e 6f 20 65 78 70 6c there is no expl
85c0: 69 63 69 74 6c 79 20 64 65 63 6c 61 72 65 64 20 icitly declared
85d0: 49 50 4b 20 63 6f 6c 75 6d 6e 2e 20 0a 20 20 2a IPK column. . *
85e0: 2a 0a 20 20 2a 2a 20 20 20 20 20 32 2e 20 54 68 *. ** 2. Th
85f0: 65 20 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 61 e table is not a
8600: 20 76 69 65 77 20 61 6e 64 20 74 68 65 20 63 6f view and the co
8610: 6c 75 6d 6e 20 6e 61 6d 65 20 69 64 65 6e 74 69 lumn name identi
8620: 66 69 65 64 20 61 6e 20 0a 20 20 2a 2a 20 20 20 fied an . **
8630: 20 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 20 explicitly
8640: 64 65 63 6c 61 72 65 64 20 63 6f 6c 75 6d 6e 2e declared column.
8650: 20 43 6f 70 79 20 6d 65 74 61 20 69 6e 66 6f 72 Copy meta infor
8660: 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 2a 70 43 6f mation from *pCo
8670: 6c 2e 0a 20 20 2a 2f 20 0a 20 20 69 66 28 20 70 l.. */ . if( p
8680: 43 6f 6c 20 29 7b 0a 20 20 20 20 7a 44 61 74 61 Col ){. zData
8690: 54 79 70 65 20 3d 20 70 43 6f 6c 2d 3e 7a 54 79 Type = pCol->zTy
86a0: 70 65 3b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 pe;. zCollSeq
86b0: 20 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a = pCol->zColl;.
86c0: 20 20 20 20 6e 6f 74 6e 75 6c 6c 20 3d 20 28 70 notnull = (p
86d0: 43 6f 6c 2d 3e 6e 6f 74 4e 75 6c 6c 3f 31 3a 30 Col->notNull?1:0
86e0: 29 3b 0a 20 20 20 20 70 72 69 6d 61 72 79 6b 65 );. primaryke
86f0: 79 20 20 3d 20 28 70 43 6f 6c 2d 3e 69 73 50 72 y = (pCol->isPr
8700: 69 6d 4b 65 79 3f 31 3a 30 29 3b 0a 20 20 20 20 imKey?1:0);.
8710: 61 75 74 6f 69 6e 63 20 3d 20 28 28 70 54 61 62 autoinc = ((pTab
8720: 2d 3e 69 50 4b 65 79 3d 3d 69 43 6f 6c 20 26 26 ->iPKey==iCol &&
8730: 20 70 54 61 62 2d 3e 61 75 74 6f 49 6e 63 29 3f pTab->autoInc)?
8740: 31 3a 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 1:0);. }else{.
8750: 20 20 20 7a 44 61 74 61 54 79 70 65 20 3d 20 22 zDataType = "
8760: 49 4e 54 45 47 45 52 22 3b 0a 20 20 20 20 70 72 INTEGER";. pr
8770: 69 6d 61 72 79 6b 65 79 20 3d 20 31 3b 0a 20 20 imarykey = 1;.
8780: 7d 0a 20 20 69 66 28 20 21 7a 43 6f 6c 6c 53 65 }. if( !zCollSe
8790: 71 20 29 7b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 q ){. zCollSe
87a0: 71 20 3d 20 22 42 49 4e 41 52 59 22 3b 0a 20 20 q = "BINARY";.
87b0: 7d 0a 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 }..error_out:.
87c0: 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 if( sqlite3Safet
87d0: 79 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20 yOff(db) ){.
87e0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 rc = SQLITE_MISU
87f0: 53 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 68 SE;. }.. /* Wh
8800: 65 74 68 65 72 20 74 68 65 20 66 75 6e 63 74 69 ether the functi
8810: 6f 6e 20 63 61 6c 6c 20 73 75 63 63 65 65 64 65 on call succeede
8820: 64 20 6f 72 20 66 61 69 6c 65 64 2c 20 73 65 74 d or failed, set
8830: 20 74 68 65 20 6f 75 74 70 75 74 20 70 61 72 61 the output para
8840: 6d 65 74 65 72 73 0a 20 20 2a 2a 20 74 6f 20 77 meters. ** to w
8850: 68 61 74 65 76 65 72 20 74 68 65 69 72 20 6c 6f hatever their lo
8860: 63 61 6c 20 63 6f 75 6e 74 65 72 70 61 72 74 73 cal counterparts
8870: 20 63 6f 6e 74 61 69 6e 2e 20 49 66 20 61 6e 20 contain. If an
8880: 65 72 72 6f 72 20 64 69 64 20 6f 63 63 75 72 2c error did occur,
8890: 0a 20 20 2a 2a 20 74 68 69 73 20 68 61 73 20 74 . ** this has t
88a0: 68 65 20 65 66 66 65 63 74 20 6f 66 20 7a 65 72 he effect of zer
88b0: 6f 69 6e 67 20 61 6c 6c 20 6f 75 74 70 75 74 20 oing all output
88c0: 70 61 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f parameters.. */
88d0: 0a 20 20 69 66 28 20 70 7a 44 61 74 61 54 79 70 . if( pzDataTyp
88e0: 65 20 29 20 2a 70 7a 44 61 74 61 54 79 70 65 20 e ) *pzDataType
88f0: 3d 20 7a 44 61 74 61 54 79 70 65 3b 0a 20 20 69 = zDataType;. i
8900: 66 28 20 70 7a 43 6f 6c 6c 53 65 71 20 29 20 2a f( pzCollSeq ) *
8910: 70 7a 43 6f 6c 6c 53 65 71 20 3d 20 7a 43 6f 6c pzCollSeq = zCol
8920: 6c 53 65 71 3b 0a 20 20 69 66 28 20 70 4e 6f 74 lSeq;. if( pNot
8930: 4e 75 6c 6c 20 29 20 2a 70 4e 6f 74 4e 75 6c 6c Null ) *pNotNull
8940: 20 3d 20 6e 6f 74 6e 75 6c 6c 3b 0a 20 20 69 66 = notnull;. if
8950: 28 20 70 50 72 69 6d 61 72 79 4b 65 79 20 29 20 ( pPrimaryKey )
8960: 2a 70 50 72 69 6d 61 72 79 4b 65 79 20 3d 20 70 *pPrimaryKey = p
8970: 72 69 6d 61 72 79 6b 65 79 3b 0a 20 20 69 66 28 rimarykey;. if(
8980: 20 70 41 75 74 6f 69 6e 63 20 29 20 2a 70 41 75 pAutoinc ) *pAu
8990: 74 6f 69 6e 63 20 3d 20 61 75 74 6f 69 6e 63 3b toinc = autoinc;
89a0: 0a 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f .. if( SQLITE_O
89b0: 4b 3d 3d 72 63 20 26 26 20 21 70 54 61 62 20 29 K==rc && !pTab )
89c0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 {. sqlite3Set
89d0: 53 74 72 69 6e 67 28 26 7a 45 72 72 4d 73 67 2c String(&zErrMsg,
89e0: 20 22 6e 6f 20 73 75 63 68 20 74 61 62 6c 65 20 "no such table
89f0: 63 6f 6c 75 6d 6e 3a 20 22 2c 20 7a 54 61 62 6c column: ", zTabl
8a00: 65 4e 61 6d 65 2c 20 22 2e 22 2c 20 0a 20 20 20 eName, ".", .
8a10: 20 20 20 20 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 zColumnName
8a20: 2c 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 , 0);. rc = S
8a30: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d QLITE_ERROR;. }
8a40: 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 . sqlite3Error(
8a50: 64 62 2c 20 72 63 2c 20 28 7a 45 72 72 4d 73 67 db, rc, (zErrMsg
8a60: 3f 22 25 73 22 3a 30 29 2c 20 7a 45 72 72 4d 73 ?"%s":0), zErrMs
8a70: 67 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 g);. sqliteFree
8a80: 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 (zErrMsg);. ret
8a90: 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 urn sqlite3ApiEx
8aa0: 69 74 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 it(db, rc);.}.#e
8ab0: 6e 64 69 66 0a 0a ndif..