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 37 34 20 32 30 30 37 2f 30 35 ,v 1.374 2007/05
0280: 2f 30 38 20 30 31 3a 30 38 3a 34 39 20 64 72 68 /08 01:08:49 drh
0290: 20 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 Exp $.*/.#inclu
02a0: 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 de "sqliteInt.h"
02b0: 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 .#include "os.h"
02c0: 0a 23 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65 .#include <ctype
02d0: 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76 .h>../*.** The v
02e0: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 6c 69 ersion of the li
02f0: 62 72 61 72 79 0a 2a 2f 0a 63 6f 6e 73 74 20 63 brary.*/.const c
0300: 68 61 72 20 73 71 6c 69 74 65 33 5f 76 65 72 73 har sqlite3_vers
0310: 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 54 45 5f 56 ion[] = SQLITE_V
0320: 45 52 53 49 4f 4e 3b 0a 63 6f 6e 73 74 20 63 68 ERSION;.const ch
0330: 61 72 20 2a 73 71 6c 69 74 65 33 5f 6c 69 62 76 ar *sqlite3_libv
0340: 65 72 73 69 6f 6e 28 76 6f 69 64 29 7b 20 72 65 ersion(void){ re
0350: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 65 72 turn sqlite3_ver
0360: 73 69 6f 6e 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 sion; }.int sqli
0370: 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e te3_libversion_n
0380: 75 6d 62 65 72 28 76 6f 69 64 29 7b 20 72 65 74 umber(void){ ret
0390: 75 72 6e 20 53 51 4c 49 54 45 5f 56 45 52 53 49 urn SQLITE_VERSI
03a0: 4f 4e 5f 4e 55 4d 42 45 52 3b 20 7d 0a 0a 2f 2a ON_NUMBER; }../*
03b0: 0a 2a 2a 20 49 66 20 74 68 65 20 66 6f 6c 6c 6f .** If the follo
03c0: 77 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 70 6f wing function po
03d0: 69 6e 74 65 72 20 69 73 20 6e 6f 74 20 4e 55 4c inter is not NUL
03e0: 4c 20 61 6e 64 20 69 66 0a 2a 2a 20 53 51 4c 49 L and if.** SQLI
03f0: 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43 TE_ENABLE_IOTRAC
0400: 45 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 E is enabled, th
0410: 65 6e 20 6d 65 73 73 61 67 65 73 20 64 65 73 63 en messages desc
0420: 72 69 62 69 6e 67 0a 2a 2a 20 49 2f 4f 20 61 63 ribing.** I/O ac
0430: 74 69 76 65 20 61 72 65 20 77 72 69 74 74 65 6e tive are written
0440: 20 75 73 69 6e 67 20 74 68 69 73 20 66 75 6e 63 using this func
0450: 74 69 6f 6e 2e 20 20 54 68 65 73 65 20 6d 65 73 tion. These mes
0460: 73 61 67 65 73 0a 2a 2a 20 61 72 65 20 69 6e 74 sages.** are int
0470: 65 6e 64 65 64 20 66 6f 72 20 64 65 62 75 67 67 ended for debugg
0480: 69 6e 67 20 61 63 74 69 76 69 74 79 20 6f 6e 6c ing activity onl
0490: 79 2e 0a 2a 2f 0a 76 6f 69 64 20 28 2a 73 71 6c y..*/.void (*sql
04a0: 69 74 65 33 5f 69 6f 5f 74 72 61 63 65 29 28 63 ite3_io_trace)(c
04b0: 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 onst char*, ...)
04c0: 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 = 0;../*.** If
04d0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c the following gl
04e0: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 70 6f obal variable po
04f0: 69 6e 74 73 20 74 6f 20 61 20 73 74 72 69 6e 67 ints to a string
0500: 20 77 68 69 63 68 20 69 73 20 74 68 65 0a 2a 2a which is the.**
0510: 20 6e 61 6d 65 20 6f 66 20 61 20 64 69 72 65 63 name of a direc
0520: 74 6f 72 79 2c 20 74 68 65 6e 20 74 68 61 74 20 tory, then that
0530: 64 69 72 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 directory will b
0540: 65 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 0a e used to store.
0550: 2a 2a 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c ** temporary fil
0560: 65 73 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c es..**.** See al
0570: 73 6f 20 74 68 65 20 22 50 52 41 47 4d 41 20 74 so the "PRAGMA t
0580: 65 6d 70 5f 73 74 6f 72 65 5f 64 69 72 65 63 74 emp_store_direct
0590: 6f 72 79 22 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 ory" SQL command
05a0: 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 6c 69 74 ..*/.char *sqlit
05b0: 65 33 5f 74 65 6d 70 5f 64 69 72 65 63 74 6f 72 e3_temp_director
05c0: 79 20 3d 20 30 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 54 y = 0;.../*.** T
05d0: 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75 his is the defau
05e0: 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e lt collating fun
05f0: 63 74 69 6f 6e 20 6e 61 6d 65 64 20 22 42 49 4e ction named "BIN
0600: 41 52 59 22 20 77 68 69 63 68 20 69 73 20 61 6c ARY" which is al
0610: 77 61 79 73 0a 2a 2a 20 61 76 61 69 6c 61 62 6c ways.** availabl
0620: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
0630: 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 28 0a 20 20 binCollFunc(.
0640: 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a 20 void *NotUsed,.
0650: 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 int nKey1, cons
0660: 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 t void *pKey1,.
0670: 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 int nKey2, cons
0680: 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b t void *pKey2.){
0690: 0a 20 20 69 6e 74 20 72 63 2c 20 6e 3b 0a 20 20 . int rc, n;.
06a0: 6e 20 3d 20 6e 4b 65 79 31 3c 6e 4b 65 79 32 20 n = nKey1<nKey2
06b0: 3f 20 6e 4b 65 79 31 20 3a 20 6e 4b 65 79 32 3b ? nKey1 : nKey2;
06c0: 0a 20 20 72 63 20 3d 20 6d 65 6d 63 6d 70 28 70 . rc = memcmp(p
06d0: 4b 65 79 31 2c 20 70 4b 65 79 32 2c 20 6e 29 3b Key1, pKey2, n);
06e0: 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a . if( rc==0 ){.
06f0: 20 20 20 20 72 63 20 3d 20 6e 4b 65 79 31 20 2d rc = nKey1 -
0700: 20 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 20 72 65 nKey2;. }. re
0710: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
0720: 2a 20 41 6e 6f 74 68 65 72 20 62 75 69 6c 74 2d * Another built-
0730: 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 in collating seq
0740: 75 65 6e 63 65 3a 20 4e 4f 43 41 53 45 2e 20 0a uence: NOCASE. .
0750: 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 6f 6c 6c 61 **.** This colla
0760: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 ting sequence is
0770: 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 intended to be
0780: 75 73 65 64 20 66 6f 72 20 22 63 61 73 65 20 69 used for "case i
0790: 6e 64 65 70 65 6e 64 61 6e 74 0a 2a 2a 20 63 6f ndependant.** co
07a0: 6d 70 61 72 69 73 6f 6e 22 2e 20 53 51 4c 69 74 mparison". SQLit
07b0: 65 27 73 20 6b 6e 6f 77 6c 65 64 67 65 20 6f 66 e's knowledge of
07c0: 20 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 65 72 upper and lower
07d0: 20 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e 74 case equivalent
07e0: 73 0a 2a 2a 20 65 78 74 65 6e 64 73 20 6f 6e 6c s.** extends onl
07f0: 79 20 74 6f 20 74 68 65 20 32 36 20 63 68 61 72 y to the 26 char
0800: 61 63 74 65 72 73 20 75 73 65 64 20 69 6e 20 74 acters used in t
0810: 68 65 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 he English langu
0820: 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 68 age..**.** At th
0830: 65 20 6d 6f 6d 65 6e 74 20 74 68 65 72 65 20 69 e moment there i
0840: 73 20 6f 6e 6c 79 20 61 20 55 54 46 2d 38 20 69 s only a UTF-8 i
0850: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a mplementation..*
0860: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f 63 /.static int noc
0870: 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 aseCollatingFunc
0880: 28 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 (. void *NotUse
0890: 64 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 d,. int nKey1,
08a0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 const void *pKey
08b0: 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 1,. int nKey2,
08c0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 const void *pKey
08d0: 32 0a 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 73 2.){. int r = s
08e0: 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 28 0a qlite3StrNICmp(.
08f0: 20 20 20 20 20 20 28 63 6f 6e 73 74 20 63 68 61 (const cha
0900: 72 20 2a 29 70 4b 65 79 31 2c 20 28 63 6f 6e 73 r *)pKey1, (cons
0910: 74 20 63 68 61 72 20 2a 29 70 4b 65 79 32 2c 20 t char *)pKey2,
0920: 28 6e 4b 65 79 31 3c 6e 4b 65 79 32 29 3f 6e 4b (nKey1<nKey2)?nK
0930: 65 79 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 69 66 ey1:nKey2);. if
0940: 28 20 30 3d 3d 72 20 29 7b 0a 20 20 20 20 72 20 ( 0==r ){. r
0950: 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 = nKey1-nKey2;.
0960: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d }. return r;.}
0970: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
0980: 68 65 20 52 4f 57 49 44 20 6f 66 20 74 68 65 20 he ROWID of the
0990: 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73 65 most recent inse
09a0: 72 74 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e 74 rt.*/.sqlite_int
09b0: 36 34 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 64 sqlite3_last_
09c0: 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c insert_rowid(sql
09d0: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 ite3 *db){. ret
09e0: 75 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 urn db->lastRowi
09f0: 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 d;.}../*.** Retu
0a00: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
0a10: 20 63 68 61 6e 67 65 73 20 69 6e 20 74 68 65 20 changes in the
0a20: 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 61 6c 6c most recent call
0a30: 20 74 6f 20 73 71 6c 69 74 65 33 5f 65 78 65 63 to sqlite3_exec
0a40: 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ()..*/.int sqlit
0a50: 65 33 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 e3_changes(sqlit
0a60: 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 e3 *db){. retur
0a70: 6e 20 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d n db->nChange;.}
0a80: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
0a90: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 he number of cha
0aa0: 6e 67 65 73 20 73 69 6e 63 65 20 74 68 65 20 64 nges since the d
0ab0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 77 atabase handle w
0ac0: 61 73 20 6f 70 65 6e 65 64 2e 0a 2a 2f 0a 69 6e as opened..*/.in
0ad0: 74 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c 5f t sqlite3_total_
0ae0: 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 changes(sqlite3
0af0: 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 *db){. return d
0b00: 62 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e 67 65 3b b->nTotalChange;
0b10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 .}../*.** Close
0b20: 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69 an existing SQLi
0b30: 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 69 te database.*/.i
0b40: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 nt sqlite3_close
0b50: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 (sqlite3 *db){.
0b60: 20 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 HashElem *i;.
0b70: 69 6e 74 20 6a 3b 0a 0a 20 20 69 66 28 20 21 64 int j;.. if( !d
0b80: 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 b ){. return
0b90: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 SQLITE_OK;. }.
0ba0: 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 if( sqlite3Safe
0bb0: 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a 20 tyCheck(db) ){.
0bc0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
0bd0: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 23 69 _MISUSE;. }..#i
0be0: 66 64 65 66 20 53 51 4c 49 54 45 5f 53 53 45 0a fdef SQLITE_SSE.
0bf0: 20 20 7b 0a 20 20 20 20 65 78 74 65 72 6e 20 76 {. extern v
0c00: 6f 69 64 20 73 71 6c 69 74 65 33 53 73 65 43 6c oid sqlite3SseCl
0c10: 65 61 6e 75 70 28 73 71 6c 69 74 65 33 2a 29 3b eanup(sqlite3*);
0c20: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 73 65 43 . sqlite3SseC
0c30: 6c 65 61 6e 75 70 28 64 62 29 3b 0a 20 20 7d 0a leanup(db);. }.
0c40: 23 65 6e 64 69 66 20 0a 0a 20 20 73 71 6c 69 74 #endif .. sqlit
0c50: 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 e3ResetInternalS
0c60: 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 0a 20 chema(db, 0);..
0c70: 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63 /* If a transac
0c80: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 74 68 tion is open, th
0c90: 65 20 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 e ResetInternalS
0ca0: 63 68 65 6d 61 28 29 20 63 61 6c 6c 20 61 62 6f chema() call abo
0cb0: 76 65 0a 20 20 2a 2a 20 77 69 6c 6c 20 6e 6f 74 ve. ** will not
0cc0: 20 68 61 76 65 20 63 61 6c 6c 65 64 20 74 68 65 have called the
0cd0: 20 78 44 69 73 63 6f 6e 6e 65 63 74 28 29 20 6d xDisconnect() m
0ce0: 65 74 68 6f 64 20 6f 6e 20 61 6e 79 20 76 69 72 ethod on any vir
0cf0: 74 75 61 6c 0a 20 20 2a 2a 20 74 61 62 6c 65 73 tual. ** tables
0d00: 20 69 6e 20 74 68 65 20 64 62 2d 3e 61 56 54 72 in the db->aVTr
0d10: 61 6e 73 5b 5d 20 61 72 72 61 79 2e 20 54 68 65 ans[] array. The
0d20: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 71 6c 69 74 following sqlit
0d30: 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 29 e3VtabRollback()
0d40: 0a 20 20 2a 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 . ** call will
0d50: 64 6f 20 73 6f 2e 20 57 65 20 6e 65 65 64 20 74 do so. We need t
0d60: 6f 20 64 6f 20 74 68 69 73 20 62 65 66 6f 72 65 o do this before
0d70: 20 74 68 65 20 63 68 65 63 6b 20 66 6f 72 20 61 the check for a
0d80: 63 74 69 76 65 0a 20 20 2a 2a 20 53 51 4c 20 73 ctive. ** SQL s
0d90: 74 61 74 65 6d 65 6e 74 73 20 62 65 6c 6f 77 2c tatements below,
0da0: 20 61 73 20 74 68 65 20 76 2d 74 61 62 6c 65 20 as the v-table
0db0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d implementation m
0dc0: 61 79 20 62 65 20 73 74 6f 72 69 6e 67 0a 20 20 ay be storing.
0dd0: 2a 2a 20 73 6f 6d 65 20 70 72 65 70 61 72 65 64 ** some prepared
0de0: 20 73 74 61 74 65 6d 65 6e 74 73 20 69 6e 74 65 statements inte
0df0: 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 73 rnally.. */. s
0e00: 71 6c 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 qlite3VtabRollba
0e10: 63 6b 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 49 66 ck(db);.. /* If
0e20: 20 74 68 65 72 65 20 61 72 65 20 61 6e 79 20 6f there are any o
0e30: 75 74 73 74 61 6e 64 69 6e 67 20 56 4d 73 2c 20 utstanding VMs,
0e40: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 return SQLITE_BU
0e50: 53 59 2e 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d SY. */. if( db-
0e60: 3e 70 56 64 62 65 20 29 7b 0a 20 20 20 20 73 71 >pVdbe ){. sq
0e70: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 lite3Error(db, S
0e80: 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 QLITE_BUSY, .
0e90: 20 20 20 20 20 22 55 6e 61 62 6c 65 20 74 6f 20 "Unable to
0ea0: 63 6c 6f 73 65 20 64 75 65 20 74 6f 20 75 6e 66 close due to unf
0eb0: 69 6e 61 6c 69 73 65 64 20 73 74 61 74 65 6d 65 inalised stateme
0ec0: 6e 74 73 22 29 3b 0a 20 20 20 20 72 65 74 75 72 nts");. retur
0ed0: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
0ee0: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 }. assert( !sq
0ef0: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
0f00: 28 64 62 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 49 (db) );.. /* FI
0f10: 58 20 4d 45 3a 20 64 62 2d 3e 6d 61 67 69 63 20 X ME: db->magic
0f20: 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 53 51 may be set to SQ
0f30: 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 LITE_MAGIC_CLOSE
0f40: 44 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 D if the databas
0f50: 65 0a 20 20 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 e. ** cannot be
0f60: 20 6f 70 65 6e 65 64 20 66 6f 72 20 73 6f 6d 65 opened for some
0f70: 20 72 65 61 73 6f 6e 2e 20 53 6f 20 74 68 69 73 reason. So this
0f80: 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 74 routine needs t
0f90: 6f 20 72 75 6e 20 69 6e 0a 20 20 2a 2a 20 74 68 o run in. ** th
0fa0: 61 74 20 63 61 73 65 2e 20 42 75 74 20 6d 61 79 at case. But may
0fb0: 62 65 20 74 68 65 72 65 20 73 68 6f 75 6c 64 20 be there should
0fc0: 62 65 20 61 6e 20 65 78 74 72 61 20 6d 61 67 69 be an extra magi
0fd0: 63 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65 0a c value for the.
0fe0: 20 20 2a 2a 20 22 66 61 69 6c 65 64 20 74 6f 20 ** "failed to
0ff0: 6f 70 65 6e 22 20 73 74 61 74 65 2e 0a 20 20 2a open" state.. *
1000: 2a 0a 20 20 2a 2a 20 54 4f 44 4f 3a 20 43 6f 76 *. ** TODO: Cov
1010: 65 72 61 67 65 20 74 65 73 74 73 20 64 6f 20 6e erage tests do n
1020: 6f 74 20 74 65 73 74 20 74 68 65 20 63 61 73 65 ot test the case
1030: 20 77 68 65 72 65 20 74 68 69 73 20 63 6f 6e 64 where this cond
1040: 69 74 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 74 72 ition is. ** tr
1050: 75 65 2e 20 49 74 27 73 20 68 61 72 64 20 74 6f ue. It's hard to
1060: 20 73 65 65 20 68 6f 77 20 74 6f 20 63 61 75 73 see how to caus
1070: 65 20 69 74 20 77 69 74 68 6f 75 74 20 6d 65 73 e it without mes
1080: 73 69 6e 67 20 77 69 74 68 20 74 68 72 65 61 64 sing with thread
1090: 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 s.. */. if( db
10a0: 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f ->magic!=SQLITE_
10b0: 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 26 26 20 MAGIC_CLOSED &&
10c0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 sqlite3SafetyOn(
10d0: 64 62 29 20 29 7b 0a 20 20 20 20 2f 2a 20 70 72 db) ){. /* pr
10e0: 69 6e 74 66 28 22 44 49 44 20 4e 4f 54 20 43 4c intf("DID NOT CL
10f0: 4f 53 45 5c 6e 22 29 3b 20 66 66 6c 75 73 68 28 OSE\n"); fflush(
1100: 73 74 64 6f 75 74 29 3b 20 2a 2f 0a 20 20 20 20 stdout); */.
1110: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 return SQLITE_ER
1120: 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 ROR;. }.. for(
1130: 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 j=0; j<db->nDb;
1140: 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 j++){. struct
1150: 20 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e Db *pDb = &db->
1160: 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 aDb[j];. if(
1170: 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 pDb->pBt ){.
1180: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c sqlite3BtreeCl
1190: 6f 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 ose(pDb->pBt);.
11a0: 20 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 pDb->pBt =
11b0: 30 3b 0a 20 20 20 20 20 20 69 66 28 20 6a 21 3d 0;. if( j!=
11c0: 31 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44 62 1 ){. pDb
11d0: 2d 3e 70 53 63 68 65 6d 61 20 3d 20 30 3b 0a 20 ->pSchema = 0;.
11e0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
11f0: 0a 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 . sqlite3ResetI
1200: 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 nternalSchema(db
1210: 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 , 0);. assert(
1220: 64 62 2d 3e 6e 44 62 3c 3d 32 20 29 3b 0a 20 20 db->nDb<=2 );.
1230: 61 73 73 65 72 74 28 20 64 62 2d 3e 61 44 62 3d assert( db->aDb=
1240: 3d 64 62 2d 3e 61 44 62 53 74 61 74 69 63 20 29 =db->aDbStatic )
1250: 3b 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 ;. for(i=sqlite
1260: 48 61 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 HashFirst(&db->a
1270: 46 75 6e 63 29 3b 20 69 3b 20 69 3d 73 71 6c 69 Func); i; i=sqli
1280: 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b 0a teHashNext(i)){.
1290: 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75 FuncDef *pFu
12a0: 6e 63 2c 20 2a 70 4e 65 78 74 3b 0a 20 20 20 20 nc, *pNext;.
12b0: 66 6f 72 28 70 46 75 6e 63 20 3d 20 28 46 75 6e for(pFunc = (Fun
12c0: 63 44 65 66 2a 29 73 71 6c 69 74 65 48 61 73 68 cDef*)sqliteHash
12d0: 44 61 74 61 28 69 29 3b 20 70 46 75 6e 63 3b 20 Data(i); pFunc;
12e0: 70 46 75 6e 63 3d 70 4e 65 78 74 29 7b 0a 20 20 pFunc=pNext){.
12f0: 20 20 20 20 70 4e 65 78 74 20 3d 20 70 46 75 6e pNext = pFun
1300: 63 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 c->pNext;.
1310: 73 71 6c 69 74 65 46 72 65 65 28 70 46 75 6e 63 sqliteFree(pFunc
1320: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 );. }. }..
1330: 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 for(i=sqliteHash
1340: 46 69 72 73 74 28 26 64 62 2d 3e 61 43 6f 6c 6c First(&db->aColl
1350: 53 65 71 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 Seq); i; i=sqlit
1360: 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 eHashNext(i)){.
1370: 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c CollSeq *pCol
1380: 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 20 2a 29 73 l = (CollSeq *)s
1390: 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 69 29 qliteHashData(i)
13a0: 3b 0a 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 ;. /* Invoke
13b0: 61 6e 79 20 64 65 73 74 72 75 63 74 6f 72 73 20 any destructors
13c0: 72 65 67 69 73 74 65 72 65 64 20 66 6f 72 20 63 registered for c
13d0: 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
13e0: 65 20 75 73 65 72 20 64 61 74 61 2e 20 2a 2f 0a e user data. */.
13f0: 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 33 for(j=0; j<3
1400: 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 ; j++){. if
1410: 28 20 70 43 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c 20 ( pColl[j].xDel
1420: 29 7b 0a 20 20 20 20 20 20 20 20 70 43 6f 6c 6c ){. pColl
1430: 5b 6a 5d 2e 78 44 65 6c 28 70 43 6f 6c 6c 5b 6a [j].xDel(pColl[j
1440: 5d 2e 70 55 73 65 72 29 3b 0a 20 20 20 20 20 20 ].pUser);.
1450: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 }. }. sqli
1460: 74 65 46 72 65 65 28 70 43 6f 6c 6c 29 3b 0a 20 teFree(pColl);.
1470: 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 }. sqlite3Hash
1480: 43 6c 65 61 72 28 26 64 62 2d 3e 61 43 6f 6c 6c Clear(&db->aColl
1490: 53 65 71 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 Seq);.#ifndef SQ
14a0: 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
14b0: 4c 54 41 42 4c 45 0a 20 20 66 6f 72 28 69 3d 73 LTABLE. for(i=s
14c0: 71 6c 69 74 65 48 61 73 68 46 69 72 73 74 28 26 qliteHashFirst(&
14d0: 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b 20 69 3b db->aModule); i;
14e0: 20 69 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 i=sqliteHashNex
14f0: 74 28 69 29 29 7b 0a 20 20 20 20 4d 6f 64 75 6c t(i)){. Modul
1500: 65 20 2a 70 4d 6f 64 20 3d 20 28 4d 6f 64 75 6c e *pMod = (Modul
1510: 65 20 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 e *)sqliteHashDa
1520: 74 61 28 69 29 3b 0a 20 20 20 20 73 71 6c 69 74 ta(i);. sqlit
1530: 65 46 72 65 65 28 70 4d 6f 64 29 3b 0a 20 20 7d eFree(pMod);. }
1540: 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 43 6c . sqlite3HashCl
1550: 65 61 72 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 ear(&db->aModule
1560: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c );.#endif.. sql
1570: 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 64 ite3HashClear(&d
1580: 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 73 71 6c b->aFunc);. sql
1590: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 ite3Error(db, SQ
15a0: 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 2f 2a 20 LITE_OK, 0); /*
15b0: 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 6e 79 20 Deallocates any
15c0: 63 61 63 68 65 64 20 65 72 72 6f 72 20 73 74 72 cached error str
15d0: 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 28 20 64 ings. */. if( d
15e0: 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20 73 b->pErr ){. s
15f0: 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 qlite3ValueFree(
1600: 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 7d 0a 20 db->pErr);. }.
1610: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 74 sqlite3CloseExt
1620: 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a 0a 20 20 ensions(db);..
1630: 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 db->magic = SQLI
1640: 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a TE_MAGIC_ERROR;.
1650: 0a 20 20 2f 2a 20 54 68 65 20 74 65 6d 70 2d 64 . /* The temp-d
1660: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 atabase schema i
1670: 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 66 66 s allocated diff
1680: 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 74 68 65 erently from the
1690: 20 6f 74 68 65 72 20 73 63 68 65 6d 61 0a 20 20 other schema.
16a0: 2a 2a 20 6f 62 6a 65 63 74 73 20 28 75 73 69 6e ** objects (usin
16b0: 67 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 g sqliteMalloc()
16c0: 20 64 69 72 65 63 74 6c 79 2c 20 69 6e 73 74 65 directly, inste
16d0: 61 64 20 6f 66 20 73 71 6c 69 74 65 33 42 74 72 ad of sqlite3Btr
16e0: 65 65 53 63 68 65 6d 61 28 29 29 2e 0a 20 20 2a eeSchema()).. *
16f0: 2a 20 53 6f 20 69 74 20 6e 65 65 64 73 20 74 6f * So it needs to
1700: 20 62 65 20 66 72 65 65 64 20 68 65 72 65 2e 20 be freed here.
1710: 54 6f 64 6f 3a 20 57 68 79 20 6e 6f 74 20 72 6f Todo: Why not ro
1720: 6c 6c 20 74 68 65 20 74 65 6d 70 20 73 63 68 65 ll the temp sche
1730: 6d 61 20 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 65 ma into. ** the
1740: 20 73 61 6d 65 20 73 71 6c 69 74 65 4d 61 6c 6c same sqliteMall
1750: 6f 63 28 29 20 61 73 20 74 68 65 20 6f 6e 65 20 oc() as the one
1760: 74 68 61 74 20 61 6c 6c 6f 63 61 74 65 73 20 74 that allocates t
1770: 68 65 20 64 61 74 61 62 61 73 65 20 0a 20 20 2a he database . *
1780: 2a 20 73 74 72 75 63 74 75 72 65 3f 0a 20 20 2a * structure?. *
1790: 2f 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 64 /. sqliteFree(d
17a0: 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 6d b->aDb[1].pSchem
17b0: 61 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 a);. sqliteFree
17c0: 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 52 (db);. sqlite3R
17d0: 65 6c 65 61 73 65 54 68 72 65 61 64 44 61 74 61 eleaseThreadData
17e0: 28 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c ();. return SQL
17f0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
1800: 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 64 61 Rollback all da
1810: 74 61 62 61 73 65 20 66 69 6c 65 73 2e 0a 2a 2f tabase files..*/
1820: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f 6c .void sqlite3Rol
1830: 6c 62 61 63 6b 41 6c 6c 28 73 71 6c 69 74 65 33 lbackAll(sqlite3
1840: 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a *db){. int i;.
1850: 20 20 69 6e 74 20 69 6e 54 72 61 6e 73 20 3d 20 int inTrans =
1860: 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 0;. for(i=0; i<
1870: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 db->nDb; i++){.
1880: 20 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 if( db->aDb[i
1890: 5d 2e 70 42 74 20 29 7b 0a 20 20 20 20 20 20 69 ].pBt ){. i
18a0: 66 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 f( sqlite3BtreeI
18b0: 73 49 6e 54 72 61 6e 73 28 64 62 2d 3e 61 44 62 sInTrans(db->aDb
18c0: 5b 69 5d 2e 70 42 74 29 20 29 7b 0a 20 20 20 20 [i].pBt) ){.
18d0: 20 20 20 20 69 6e 54 72 61 6e 73 20 3d 20 31 3b inTrans = 1;
18e0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 . }. s
18f0: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 qlite3BtreeRollb
1900: 61 63 6b 28 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 ack(db->aDb[i].p
1910: 42 74 29 3b 0a 20 20 20 20 20 20 64 62 2d 3e 61 Bt);. db->a
1920: 44 62 5b 69 5d 2e 69 6e 54 72 61 6e 73 20 3d 20 Db[i].inTrans =
1930: 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 0;. }. }. s
1940: 71 6c 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 qlite3VtabRollba
1950: 63 6b 28 64 62 29 3b 0a 20 20 69 66 28 20 64 62 ck(db);. if( db
1960: 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 49 ->flags&SQLITE_I
1970: 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 29 7b 0a nternChanges ){.
1980: 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 sqlite3Reset
1990: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 InternalSchema(d
19a0: 62 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a b, 0);. }.. /*
19b0: 20 49 66 20 6f 6e 65 20 68 61 73 20 62 65 65 6e If one has been
19c0: 20 63 6f 6e 66 69 67 75 72 65 64 2c 20 69 6e 76 configured, inv
19d0: 6f 6b 65 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b oke the rollback
19e0: 2d 68 6f 6f 6b 20 63 61 6c 6c 62 61 63 6b 20 2a -hook callback *
19f0: 2f 0a 20 20 69 66 28 20 64 62 2d 3e 78 52 6f 6c /. if( db->xRol
1a00: 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 20 26 26 lbackCallback &&
1a10: 20 28 69 6e 54 72 61 6e 73 20 7c 7c 20 21 64 62 (inTrans || !db
1a20: 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 29 20 29 7b ->autoCommit) ){
1a30: 0a 20 20 20 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 . db->xRollba
1a40: 63 6b 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 ckCallback(db->p
1a50: 52 6f 6c 6c 62 61 63 6b 41 72 67 29 3b 0a 20 20 RollbackArg);.
1a60: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 }.}../*.** Retur
1a70: 6e 20 61 20 73 74 61 74 69 63 20 73 74 72 69 6e n a static strin
1a80: 67 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 g that describes
1a90: 20 74 68 65 20 6b 69 6e 64 20 6f 66 20 65 72 72 the kind of err
1aa0: 6f 72 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 or specified in
1ab0: 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e the.** argument.
1ac0: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
1ad0: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 69 6e sqlite3ErrStr(in
1ae0: 74 20 72 63 29 7b 0a 20 20 63 6f 6e 73 74 20 63 t rc){. const c
1af0: 68 61 72 20 2a 7a 3b 0a 20 20 73 77 69 74 63 68 har *z;. switch
1b00: 28 20 72 63 20 26 20 30 78 66 66 20 29 7b 0a 20 ( rc & 0xff ){.
1b10: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 case SQLITE_R
1b20: 4f 57 3a 0a 20 20 20 20 63 61 73 65 20 53 51 4c OW:. case SQL
1b30: 49 54 45 5f 44 4f 4e 45 3a 0a 20 20 20 20 63 61 ITE_DONE:. ca
1b40: 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a 20 20 20 se SQLITE_OK:
1b50: 20 20 20 20 20 20 7a 20 3d 20 22 6e 6f 74 20 61 z = "not a
1b60: 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20 20 20 n error";
1b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b80: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1b90: 73 65 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3a se SQLITE_ERROR:
1ba0: 20 20 20 20 20 20 7a 20 3d 20 22 53 51 4c 20 6c z = "SQL l
1bb0: 6f 67 69 63 20 65 72 72 6f 72 20 6f 72 20 6d 69 ogic error or mi
1bc0: 73 73 69 6e 67 20 64 61 74 61 62 61 73 65 22 3b ssing database";
1bd0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1be0: 73 65 20 53 51 4c 49 54 45 5f 50 45 52 4d 3a 20 se SQLITE_PERM:
1bf0: 20 20 20 20 20 20 7a 20 3d 20 22 61 63 63 65 73 z = "acces
1c00: 73 20 70 65 72 6d 69 73 73 69 6f 6e 20 64 65 6e s permission den
1c10: 69 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 ied";
1c20: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1c30: 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 3a se SQLITE_ABORT:
1c40: 20 20 20 20 20 20 7a 20 3d 20 22 63 61 6c 6c 62 z = "callb
1c50: 61 63 6b 20 72 65 71 75 65 73 74 65 64 20 71 75 ack requested qu
1c60: 65 72 79 20 61 62 6f 72 74 22 3b 20 20 20 20 20 ery abort";
1c70: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1c80: 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 3a 20 se SQLITE_BUSY:
1c90: 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 62 z = "datab
1ca0: 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 3b 20 ase is locked";
1cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cc0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1cd0: 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 se SQLITE_LOCKED
1ce0: 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 62 : z = "datab
1cf0: 61 73 65 20 74 61 62 6c 65 20 69 73 20 6c 6f 63 ase table is loc
1d00: 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 ked";
1d10: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1d20: 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3a se SQLITE_NOMEM:
1d30: 20 20 20 20 20 20 7a 20 3d 20 22 6f 75 74 20 6f z = "out o
1d40: 66 20 6d 65 6d 6f 72 79 22 3b 20 20 20 20 20 20 f memory";
1d50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d60: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1d70: 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e se SQLITE_READON
1d80: 4c 59 3a 20 20 20 7a 20 3d 20 22 61 74 74 65 6d LY: z = "attem
1d90: 70 74 20 74 6f 20 77 72 69 74 65 20 61 20 72 65 pt to write a re
1da0: 61 64 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 22 adonly database"
1db0: 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 ; break;. ca
1dc0: 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 se SQLITE_INTERR
1dd0: 55 50 54 3a 20 20 7a 20 3d 20 22 69 6e 74 65 72 UPT: z = "inter
1de0: 72 75 70 74 65 64 22 3b 20 20 20 20 20 20 20 20 rupted";
1df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e00: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1e10: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3a se SQLITE_IOERR:
1e20: 20 20 20 20 20 20 7a 20 3d 20 22 64 69 73 6b 20 z = "disk
1e30: 49 2f 4f 20 65 72 72 6f 72 22 3b 20 20 20 20 20 I/O error";
1e40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e50: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1e60: 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 se SQLITE_CORRUP
1e70: 54 3a 20 20 20 20 7a 20 3d 20 22 64 61 74 61 62 T: z = "datab
1e80: 61 73 65 20 64 69 73 6b 20 69 6d 61 67 65 20 69 ase disk image i
1e90: 73 20 6d 61 6c 66 6f 72 6d 65 64 22 3b 20 20 20 s malformed";
1ea0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1eb0: 73 65 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3a 20 se SQLITE_FULL:
1ec0: 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 62 z = "datab
1ed0: 61 73 65 20 6f 72 20 64 69 73 6b 20 69 73 20 66 ase or disk is f
1ee0: 75 6c 6c 22 3b 20 20 20 20 20 20 20 20 20 20 20 ull";
1ef0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1f00: 73 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 se SQLITE_CANTOP
1f10: 45 4e 3a 20 20 20 7a 20 3d 20 22 75 6e 61 62 6c EN: z = "unabl
1f20: 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62 61 e to open databa
1f30: 73 65 20 66 69 6c 65 22 3b 20 20 20 20 20 20 20 se file";
1f40: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1f50: 73 65 20 53 51 4c 49 54 45 5f 45 4d 50 54 59 3a se SQLITE_EMPTY:
1f60: 20 20 20 20 20 20 7a 20 3d 20 22 74 61 62 6c 65 z = "table
1f70: 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 64 61 74 contains no dat
1f80: 61 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 a";
1f90: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1fa0: 73 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 se SQLITE_SCHEMA
1fb0: 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61 62 : z = "datab
1fc0: 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 63 ase schema has c
1fd0: 68 61 6e 67 65 64 22 3b 20 20 20 20 20 20 20 20 hanged";
1fe0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
1ff0: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 se SQLITE_CONSTR
2000: 41 49 4e 54 3a 20 7a 20 3d 20 22 63 6f 6e 73 74 AINT: z = "const
2010: 72 61 69 6e 74 20 66 61 69 6c 65 64 22 3b 20 20 raint failed";
2020: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2030: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
2040: 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 se SQLITE_MISMAT
2050: 43 48 3a 20 20 20 7a 20 3d 20 22 64 61 74 61 74 CH: z = "datat
2060: 79 70 65 20 6d 69 73 6d 61 74 63 68 22 3b 20 20 ype mismatch";
2070: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2080: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
2090: 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 se SQLITE_MISUSE
20a0: 3a 20 20 20 20 20 7a 20 3d 20 22 6c 69 62 72 61 : z = "libra
20b0: 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c 65 ry routine calle
20c0: 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e 63 d out of sequenc
20d0: 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 e";break;. ca
20e0: 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 3a se SQLITE_NOLFS:
20f0: 20 20 20 20 20 20 7a 20 3d 20 22 6b 65 72 6e 65 z = "kerne
2100: 6c 20 6c 61 63 6b 73 20 6c 61 72 67 65 20 66 69 l lacks large fi
2110: 6c 65 20 73 75 70 70 6f 72 74 22 3b 20 20 20 20 le support";
2120: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
2130: 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48 3a 20 se SQLITE_AUTH:
2140: 20 20 20 20 20 20 7a 20 3d 20 22 61 75 74 68 6f z = "autho
2150: 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69 65 64 22 rization denied"
2160: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2170: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
2180: 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 se SQLITE_FORMAT
2190: 3a 20 20 20 20 20 7a 20 3d 20 22 61 75 78 69 6c : z = "auxil
21a0: 69 61 72 79 20 64 61 74 61 62 61 73 65 20 66 6f iary database fo
21b0: 72 6d 61 74 20 65 72 72 6f 72 22 3b 20 20 20 20 rmat error";
21c0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
21d0: 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 3a se SQLITE_RANGE:
21e0: 20 20 20 20 20 20 7a 20 3d 20 22 62 69 6e 64 20 z = "bind
21f0: 6f 72 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 20 or column index
2200: 6f 75 74 20 6f 66 20 72 61 6e 67 65 22 3b 20 20 out of range";
2210: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 break;. ca
2220: 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 se SQLITE_NOTADB
2230: 3a 20 20 20 20 20 7a 20 3d 20 22 66 69 6c 65 20 : z = "file
2240: 69 73 20 65 6e 63 72 79 70 74 65 64 20 6f 72 20 is encrypted or
2250: 69 73 20 6e 6f 74 20 61 20 64 61 74 61 62 61 73 is not a databas
2260: 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 64 65 e";break;. de
2270: 66 61 75 6c 74 3a 20 20 20 20 20 20 20 20 20 20 fault:
2280: 20 20 20 20 20 20 7a 20 3d 20 22 75 6e 6b 6e 6f z = "unkno
2290: 77 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20 20 wn error";
22a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 break;. }.
22c0: 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f 2a 0a return z;.}../*.
22d0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
22e0: 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62 75 73 implements a bus
22f0: 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61 74 20 y callback that
2300: 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69 65 73 sleeps and tries
2310: 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69 6c 20 .** again until
2320: 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20 a timeout value
2330: 69 73 20 72 65 61 63 68 65 64 2e 20 20 54 68 65 is reached. The
2340: 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20 69 timeout value i
2350: 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 20 s.** an integer
2360: 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 number of millis
2370: 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20 69 6e econds passed in
2380: 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a 2a as the first.**
2390: 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 argument..*/.st
23a0: 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 44 atic int sqliteD
23b0: 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 efaultBusyCallba
23c0: 63 6b 28 0a 20 76 6f 69 64 20 2a 70 74 72 2c 20 ck(. void *ptr,
23d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
23e0: 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 Database connec
23f0: 74 69 6f 6e 20 2a 2f 0a 20 69 6e 74 20 63 6f 75 tion */. int cou
2400: 6e 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nt
2410: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 /* Number of t
2420: 69 6d 65 73 20 74 61 62 6c 65 20 68 61 73 20 62 imes table has b
2430: 65 65 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a 23 een busy */.){.#
2440: 69 66 20 4f 53 5f 57 49 4e 20 7c 7c 20 28 64 65 if OS_WIN || (de
2450: 66 69 6e 65 64 28 48 41 56 45 5f 55 53 4c 45 45 fined(HAVE_USLEE
2460: 50 29 20 26 26 20 48 41 56 45 5f 55 53 4c 45 45 P) && HAVE_USLEE
2470: 50 29 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 P). static cons
2480: 74 20 75 38 20 64 65 6c 61 79 73 5b 5d 20 3d 0a t u8 delays[] =.
2490: 20 20 20 20 20 7b 20 31 2c 20 32 2c 20 35 2c 20 { 1, 2, 5,
24a0: 31 30 2c 20 31 35 2c 20 32 30 2c 20 32 35 2c 20 10, 15, 20, 25,
24b0: 32 35 2c 20 20 32 35 2c 20 20 35 30 2c 20 20 35 25, 25, 50, 5
24c0: 30 2c 20 31 30 30 20 7d 3b 0a 20 20 73 74 61 74 0, 100 };. stat
24d0: 69 63 20 63 6f 6e 73 74 20 75 38 20 74 6f 74 61 ic const u8 tota
24e0: 6c 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 30 2c ls[] =. { 0,
24f0: 20 31 2c 20 33 2c 20 20 38 2c 20 31 38 2c 20 33 1, 3, 8, 18, 3
2500: 33 2c 20 35 33 2c 20 37 38 2c 20 31 30 33 2c 20 3, 53, 78, 103,
2510: 31 32 38 2c 20 31 37 38 2c 20 32 32 38 20 7d 3b 128, 178, 228 };
2520: 0a 23 20 64 65 66 69 6e 65 20 4e 44 45 4c 41 59 .# define NDELAY
2530: 20 28 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 29 (sizeof(delays)
2540: 2f 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 5b 30 /sizeof(delays[0
2550: 5d 29 29 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 ])). int timeou
2560: 74 20 3d 20 28 28 73 71 6c 69 74 65 33 20 2a 29 t = ((sqlite3 *)
2570: 70 74 72 29 2d 3e 62 75 73 79 54 69 6d 65 6f 75 ptr)->busyTimeou
2580: 74 3b 0a 20 20 69 6e 74 20 64 65 6c 61 79 2c 20 t;. int delay,
2590: 70 72 69 6f 72 3b 0a 0a 20 20 61 73 73 65 72 74 prior;.. assert
25a0: 28 20 63 6f 75 6e 74 3e 3d 30 20 29 3b 0a 20 20 ( count>=0 );.
25b0: 69 66 28 20 63 6f 75 6e 74 20 3c 20 4e 44 45 4c if( count < NDEL
25c0: 41 59 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 AY ){. delay
25d0: 3d 20 64 65 6c 61 79 73 5b 63 6f 75 6e 74 5d 3b = delays[count];
25e0: 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 . prior = tot
25f0: 61 6c 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 7d 65 als[count];. }e
2600: 6c 73 65 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d lse{. delay =
2610: 20 64 65 6c 61 79 73 5b 4e 44 45 4c 41 59 2d 31 delays[NDELAY-1
2620: 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 ];. prior = t
2630: 6f 74 61 6c 73 5b 4e 44 45 4c 41 59 2d 31 5d 20 otals[NDELAY-1]
2640: 2b 20 64 65 6c 61 79 2a 28 63 6f 75 6e 74 2d 28 + delay*(count-(
2650: 4e 44 45 4c 41 59 2d 31 29 29 3b 0a 20 20 7d 0a NDELAY-1));. }.
2660: 20 20 69 66 28 20 70 72 69 6f 72 20 2b 20 64 65 if( prior + de
2670: 6c 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b lay > timeout ){
2680: 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 74 69 6d . delay = tim
2690: 65 6f 75 74 20 2d 20 70 72 69 6f 72 3b 0a 20 20 eout - prior;.
26a0: 20 20 69 66 28 20 64 65 6c 61 79 3c 3d 30 20 29 if( delay<=0 )
26b0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 return 0;. }.
26c0: 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 sqlite3OsSleep(
26d0: 64 65 6c 61 79 29 3b 0a 20 20 72 65 74 75 72 6e delay);. return
26e0: 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 1;.#else. int
26f0: 74 69 6d 65 6f 75 74 20 3d 20 28 28 73 71 6c 69 timeout = ((sqli
2700: 74 65 33 20 2a 29 70 74 72 29 2d 3e 62 75 73 79 te3 *)ptr)->busy
2710: 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20 28 Timeout;. if( (
2720: 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20 count+1)*1000 >
2730: 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 72 timeout ){. r
2740: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 eturn 0;. }. s
2750: 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 31 30 qlite3OsSleep(10
2760: 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 00);. return 1;
2770: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
2780: 20 49 6e 76 6f 6b 65 20 74 68 65 20 67 69 76 65 Invoke the give
2790: 6e 20 62 75 73 79 20 68 61 6e 64 6c 65 72 2e 0a n busy handler..
27a0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
27b0: 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 ne is called whe
27c0: 6e 20 61 6e 20 6f 70 65 72 61 74 69 6f 6e 20 66 n an operation f
27d0: 61 69 6c 65 64 20 77 69 74 68 20 61 20 6c 6f 63 ailed with a loc
27e0: 6b 2e 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 6f k..** If this ro
27f0: 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20 6e 6f utine returns no
2800: 6e 2d 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b n-zero, the lock
2810: 20 69 73 20 72 65 74 72 69 65 64 2e 20 20 49 66 is retried. If
2820: 20 69 74 0a 2a 2a 20 72 65 74 75 72 6e 73 20 30 it.** returns 0
2830: 2c 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 , the operation
2840: 61 62 6f 72 74 73 20 77 69 74 68 20 61 6e 20 53 aborts with an S
2850: 51 4c 49 54 45 5f 42 55 53 59 20 65 72 72 6f 72 QLITE_BUSY error
2860: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
2870: 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
2880: 72 28 42 75 73 79 48 61 6e 64 6c 65 72 20 2a 70 r(BusyHandler *p
2890: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 ){. int rc;. i
28a0: 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 78 46 f( p==0 || p->xF
28b0: 75 6e 63 3d 3d 30 20 7c 7c 20 70 2d 3e 6e 42 75 unc==0 || p->nBu
28c0: 73 79 3c 30 20 29 20 72 65 74 75 72 6e 20 30 3b sy<0 ) return 0;
28d0: 0a 20 20 72 63 20 3d 20 70 2d 3e 78 46 75 6e 63 . rc = p->xFunc
28e0: 28 70 2d 3e 70 41 72 67 2c 20 70 2d 3e 6e 42 75 (p->pArg, p->nBu
28f0: 73 79 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30 sy);. if( rc==0
2900: 20 29 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 79 ){. p->nBusy
2910: 20 3d 20 2d 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a = -1;. }else{.
2920: 20 20 20 20 70 2d 3e 6e 42 75 73 79 2b 2b 3b 0a p->nBusy++;.
2930: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
2940: 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .}../*.** This
2950: 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 routine sets the
2960: 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 66 busy callback f
2970: 6f 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 or an Sqlite dat
2980: 61 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 abase to the.**
2990: 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 given callback f
29a0: 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 unction with the
29b0: 20 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e given argument.
29c0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
29d0: 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20 20 busy_handler(.
29e0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 69 sqlite3 *db,. i
29f0: 6e 74 20 28 2a 78 42 75 73 79 29 28 76 6f 69 64 nt (*xBusy)(void
2a00: 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a *,int),. void *
2a10: 70 41 72 67 0a 29 7b 0a 20 20 69 66 28 20 73 71 pArg.){. if( sq
2a20: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
2a30: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 (db) ){. retu
2a40: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
2a50: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 62 75 73 79 ;. }. db->busy
2a60: 48 61 6e 64 6c 65 72 2e 78 46 75 6e 63 20 3d 20 Handler.xFunc =
2a70: 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e 62 75 73 xBusy;. db->bus
2a80: 79 48 61 6e 64 6c 65 72 2e 70 41 72 67 20 3d 20 yHandler.pArg =
2a90: 70 41 72 67 3b 0a 20 20 64 62 2d 3e 62 75 73 79 pArg;. db->busy
2aa0: 48 61 6e 64 6c 65 72 2e 6e 42 75 73 79 20 3d 20 Handler.nBusy =
2ab0: 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 0;. return SQLI
2ac0: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 TE_OK;.}..#ifnde
2ad0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 f SQLITE_OMIT_PR
2ae0: 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a OGRESS_CALLBACK.
2af0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 /*.** This routi
2b00: 6e 65 20 73 65 74 73 20 74 68 65 20 70 72 6f 67 ne sets the prog
2b10: 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 66 6f ress callback fo
2b20: 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61 r an Sqlite data
2b30: 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 base to the.** g
2b40: 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 iven callback fu
2b50: 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 nction with the
2b60: 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 20 given argument.
2b70: 54 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c The progress cal
2b80: 6c 62 61 63 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 lback will.** be
2b90: 20 69 6e 76 6f 6b 65 64 20 65 76 65 72 79 20 6e invoked every n
2ba0: 4f 70 73 20 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a Ops opcodes..*/.
2bb0: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 70 72 6f void sqlite3_pro
2bc0: 67 72 65 73 73 5f 68 61 6e 64 6c 65 72 28 0a 20 gress_handler(.
2bd0: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 sqlite3 *db, .
2be0: 20 69 6e 74 20 6e 4f 70 73 2c 0a 20 20 69 6e 74 int nOps,. int
2bf0: 20 28 2a 78 50 72 6f 67 72 65 73 73 29 28 76 6f (*xProgress)(vo
2c00: 69 64 2a 29 2c 20 0a 20 20 76 6f 69 64 20 2a 70 id*), . void *p
2c10: 41 72 67 0a 29 7b 0a 20 20 69 66 28 20 21 73 71 Arg.){. if( !sq
2c20: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
2c30: 28 64 62 29 20 29 7b 0a 20 20 20 20 69 66 28 20 (db) ){. if(
2c40: 6e 4f 70 73 3e 30 20 29 7b 0a 20 20 20 20 20 20 nOps>0 ){.
2c50: 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d 20 db->xProgress =
2c60: 78 50 72 6f 67 72 65 73 73 3b 0a 20 20 20 20 20 xProgress;.
2c70: 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 db->nProgressOp
2c80: 73 20 3d 20 6e 4f 70 73 3b 0a 20 20 20 20 20 20 s = nOps;.
2c90: 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 67 db->pProgressArg
2ca0: 20 3d 20 70 41 72 67 3b 0a 20 20 20 20 7d 65 6c = pArg;. }el
2cb0: 73 65 7b 0a 20 20 20 20 20 20 64 62 2d 3e 78 50 se{. db->xP
2cc0: 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 rogress = 0;.
2cd0: 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 db->nProgress
2ce0: 4f 70 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 64 Ops = 0;. d
2cf0: 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 67 20 b->pProgressArg
2d00: 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d = 0;. }. }.}
2d10: 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 .#endif.../*.**
2d20: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6e 73 This routine ins
2d30: 74 61 6c 6c 73 20 61 20 64 65 66 61 75 6c 74 20 talls a default
2d40: 62 75 73 79 20 68 61 6e 64 6c 65 72 20 74 68 61 busy handler tha
2d50: 74 20 77 61 69 74 73 20 66 6f 72 20 74 68 65 0a t waits for the.
2d60: 2a 2a 20 73 70 65 63 69 66 69 65 64 20 6e 75 6d ** specified num
2d70: 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f ber of milliseco
2d80: 6e 64 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 nds before retur
2d90: 6e 69 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 ning 0..*/.int s
2da0: 71 6c 69 74 65 33 5f 62 75 73 79 5f 74 69 6d 65 qlite3_busy_time
2db0: 6f 75 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c out(sqlite3 *db,
2dc0: 20 69 6e 74 20 6d 73 29 7b 0a 20 20 69 66 28 20 int ms){. if(
2dd0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
2de0: 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 ck(db) ){. re
2df0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
2e00: 53 45 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6d 73 SE;. }. if( ms
2e10: 3e 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 62 75 >0 ){. db->bu
2e20: 73 79 54 69 6d 65 6f 75 74 20 3d 20 6d 73 3b 0a syTimeout = ms;.
2e30: 20 20 20 20 73 71 6c 69 74 65 33 5f 62 75 73 79 sqlite3_busy
2e40: 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 73 71 6c _handler(db, sql
2e50: 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 43 61 iteDefaultBusyCa
2e60: 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 2a 29 64 llback, (void*)d
2e70: 62 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 b);. }else{.
2e80: 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 sqlite3_busy_ha
2e90: 6e 64 6c 65 72 28 64 62 2c 20 30 2c 20 30 29 3b ndler(db, 0, 0);
2ea0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 . }. return SQ
2eb0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
2ec0: 2a 20 43 61 75 73 65 20 61 6e 79 20 70 65 6e 64 * Cause any pend
2ed0: 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f ing operation to
2ee0: 20 73 74 6f 70 20 61 74 20 69 74 73 20 65 61 72 stop at its ear
2ef0: 6c 69 65 73 74 20 6f 70 70 6f 72 74 75 6e 69 74 liest opportunit
2f00: 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 y..*/.void sqlit
2f10: 65 33 5f 69 6e 74 65 72 72 75 70 74 28 73 71 6c e3_interrupt(sql
2f20: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66 28 ite3 *db){. if(
2f30: 20 64 62 20 26 26 20 28 64 62 2d 3e 6d 61 67 69 db && (db->magi
2f40: 63 3d 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f c==SQLITE_MAGIC_
2f50: 4f 50 45 4e 20 7c 7c 20 64 62 2d 3e 6d 61 67 69 OPEN || db->magi
2f60: 63 3d 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f c==SQLITE_MAGIC_
2f70: 42 55 53 59 29 20 29 7b 0a 20 20 20 20 64 62 2d BUSY) ){. db-
2f80: 3e 75 31 2e 69 73 49 6e 74 65 72 72 75 70 74 65 >u1.isInterrupte
2f90: 64 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a d = 1;. }.}../*
2fa0: 0a 2a 2a 20 4d 65 6d 6f 72 79 20 61 6c 6c 6f 63 .** Memory alloc
2fb0: 61 74 69 6f 6e 20 72 6f 75 74 69 6e 65 73 20 74 ation routines t
2fc0: 68 61 74 20 75 73 65 20 53 51 4c 69 74 65 73 20 hat use SQLites
2fd0: 69 6e 74 65 72 6e 61 6c 20 6d 65 6d 6f 72 79 0a internal memory.
2fe0: 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 ** memory alloca
2ff0: 74 6f 72 2e 20 20 44 65 70 65 6e 64 69 6e 67 20 tor. Depending
3000: 6f 6e 20 68 6f 77 20 53 51 4c 69 74 65 20 69 73 on how SQLite is
3010: 20 63 6f 6d 70 69 6c 65 64 2c 20 74 68 65 0a 2a compiled, the.*
3020: 2a 20 69 6e 74 65 72 6e 61 6c 20 6d 65 6d 6f 72 * internal memor
3030: 79 20 61 6c 6c 6f 63 61 74 6f 72 20 6d 69 67 68 y allocator migh
3040: 74 20 62 65 20 6a 75 73 74 20 61 6e 20 61 6c 69 t be just an ali
3050: 61 73 20 66 6f 72 20 74 68 65 0a 2a 2a 20 73 79 as for the.** sy
3060: 73 74 65 6d 20 64 65 66 61 75 6c 74 20 6d 61 6c stem default mal
3070: 6c 6f 63 2f 72 65 61 6c 6c 6f 63 2f 66 72 65 65 loc/realloc/free
3080: 2e 20 20 4f 72 20 74 68 65 20 62 75 69 6c 74 2d . Or the built-
3090: 69 6e 20 61 6c 6c 6f 63 61 74 6f 72 0a 2a 2a 20 in allocator.**
30a0: 6d 69 67 68 74 20 64 6f 20 65 78 74 72 61 20 73 might do extra s
30b0: 74 75 66 66 20 6c 69 6b 65 20 70 75 74 20 73 65 tuff like put se
30c0: 6e 74 69 6e 61 6c 73 20 61 72 6f 75 6e 64 20 62 ntinals around b
30d0: 75 66 66 65 72 73 20 74 6f 20 0a 2a 2a 20 63 68 uffers to .** ch
30e0: 65 63 6b 20 66 6f 72 20 6f 76 65 72 72 75 6e 73 eck for overruns
30f0: 20 6f 72 20 6c 6f 6f 6b 20 66 6f 72 20 6d 65 6d or look for mem
3100: 6f 72 79 20 6c 65 61 6b 73 2e 0a 2a 2a 0a 2a 2a ory leaks..**.**
3110: 20 55 73 65 20 73 71 6c 69 74 65 33 5f 66 72 65 Use sqlite3_fre
3120: 65 28 29 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f e() to free memo
3130: 72 79 20 72 65 74 75 72 6e 65 64 20 62 79 20 73 ry returned by s
3140: 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 29 qlite3_mprintf()
3150: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 ..*/.void sqlite
3160: 33 5f 66 72 65 65 28 76 6f 69 64 20 2a 70 29 7b 3_free(void *p){
3170: 20 69 66 28 20 70 20 29 20 73 71 6c 69 74 65 33 if( p ) sqlite3
3180: 4f 73 46 72 65 65 28 70 29 3b 20 7d 0a 76 6f 69 OsFree(p); }.voi
3190: 64 20 2a 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f d *sqlite3_mallo
31a0: 63 28 69 6e 74 20 6e 42 79 74 65 29 7b 20 72 65 c(int nByte){ re
31b0: 74 75 72 6e 20 6e 42 79 74 65 3e 30 20 3f 20 73 turn nByte>0 ? s
31c0: 71 6c 69 74 65 33 4f 73 4d 61 6c 6c 6f 63 28 6e qlite3OsMalloc(n
31d0: 42 79 74 65 29 20 3a 20 30 3b 20 7d 0a 76 6f 69 Byte) : 0; }.voi
31e0: 64 20 2a 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c d *sqlite3_reall
31f0: 6f 63 28 76 6f 69 64 20 2a 70 4f 6c 64 2c 20 69 oc(void *pOld, i
3200: 6e 74 20 6e 42 79 74 65 29 7b 20 0a 20 20 69 66 nt nByte){ . if
3210: 28 20 70 4f 6c 64 20 29 7b 0a 20 20 20 20 69 66 ( pOld ){. if
3220: 28 20 6e 42 79 74 65 3e 30 20 29 7b 0a 20 20 20 ( nByte>0 ){.
3230: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 return sqlite
3240: 33 4f 73 52 65 61 6c 6c 6f 63 28 70 4f 6c 64 2c 3OsRealloc(pOld,
3250: 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 7d 65 6c nByte);. }el
3260: 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 se{. sqlite
3270: 33 4f 73 46 72 65 65 28 70 4f 6c 64 29 3b 0a 20 3OsFree(pOld);.
3280: 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 return 0;.
3290: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 }. }else{.
32a0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
32b0: 5f 6d 61 6c 6c 6f 63 28 6e 42 79 74 65 29 3b 0a _malloc(nByte);.
32c0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 }.}../*.** Thi
32d0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 65 78 s function is ex
32e0: 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 20 61 actly the same a
32f0: 73 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 s sqlite3_create
3300: 5f 66 75 6e 63 74 69 6f 6e 28 29 2c 20 65 78 63 _function(), exc
3310: 65 70 74 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 ept.** that it i
3320: 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 62 65 s designed to be
3330: 20 63 61 6c 6c 65 64 20 62 79 20 69 6e 74 65 72 called by inter
3340: 6e 61 6c 20 63 6f 64 65 2e 20 54 68 65 20 64 69 nal code. The di
3350: 66 66 65 72 65 6e 63 65 20 69 73 0a 2a 2a 20 74 fference is.** t
3360: 68 61 74 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 hat if a malloc(
3370: 29 20 66 61 69 6c 73 20 69 6e 20 73 71 6c 69 74 ) fails in sqlit
3380: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 e3_create_functi
3390: 6f 6e 28 29 2c 20 61 6e 20 65 72 72 6f 72 20 63 on(), an error c
33a0: 6f 64 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e ode.** is return
33b0: 65 64 20 61 6e 64 20 74 68 65 20 6d 61 6c 6c 6f ed and the mallo
33c0: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 63 6c 65 cFailed flag cle
33d0: 61 72 65 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 ared. .*/.int sq
33e0: 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 lite3CreateFunc(
33f0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a . sqlite3 *db,.
3400: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
3410: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 unctionName,. i
3420: 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 nt nArg,. int e
3430: 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 nc,. void *pUse
3440: 72 44 61 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a rData,. void (*
3450: 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 xFunc)(sqlite3_c
3460: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
3470: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 te3_value **),.
3480: 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 void (*xStep)(s
3490: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
34a0: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
34b0: 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a e **),. void (*
34c0: 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f xFinal)(sqlite3_
34d0: 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 46 context*).){. F
34e0: 75 6e 63 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 uncDef *p;. int
34f0: 20 6e 4e 61 6d 65 3b 0a 0a 20 20 69 66 28 20 73 nName;.. if( s
3500: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
3510: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 k(db) ){. ret
3520: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
3530: 45 3b 0a 20 20 7d 0a 20 20 69 66 28 20 7a 46 75 E;. }. if( zFu
3540: 6e 63 74 69 6f 6e 4e 61 6d 65 3d 3d 30 20 7c 7c nctionName==0 ||
3550: 0a 20 20 20 20 20 20 28 78 46 75 6e 63 20 26 26 . (xFunc &&
3560: 20 28 78 46 69 6e 61 6c 20 7c 7c 20 78 53 74 65 (xFinal || xSte
3570: 70 29 29 20 7c 7c 20 0a 20 20 20 20 20 20 28 21 p)) || . (!
3580: 78 46 75 6e 63 20 26 26 20 28 78 46 69 6e 61 6c xFunc && (xFinal
3590: 20 26 26 20 21 78 53 74 65 70 29 29 20 7c 7c 0a && !xStep)) ||.
35a0: 20 20 20 20 20 20 28 21 78 46 75 6e 63 20 26 26 (!xFunc &&
35b0: 20 28 21 78 46 69 6e 61 6c 20 26 26 20 78 53 74 (!xFinal && xSt
35c0: 65 70 29 29 20 7c 7c 0a 20 20 20 20 20 20 28 6e ep)) ||. (n
35d0: 41 72 67 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 31 Arg<-1 || nArg>1
35e0: 32 37 29 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 27) ||. (25
35f0: 35 3c 28 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 5<(nName = strle
3600: 6e 28 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 29 n(zFunctionName)
3610: 29 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 )) ){. sqlite
3620: 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 3Error(db, SQLIT
3630: 45 5f 45 52 52 4f 52 2c 20 22 62 61 64 20 70 61 E_ERROR, "bad pa
3640: 72 61 6d 65 74 65 72 73 22 29 3b 0a 20 20 20 20 rameters");.
3650: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 return SQLITE_ER
3660: 52 4f 52 3b 0a 20 20 7d 0a 20 20 0a 23 69 66 6e ROR;. }. .#ifn
3670: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
3680: 55 54 46 31 36 0a 20 20 2f 2a 20 49 66 20 53 51 UTF16. /* If SQ
3690: 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 73 70 LITE_UTF16 is sp
36a0: 65 63 69 66 69 65 64 20 61 73 20 74 68 65 20 65 ecified as the e
36b0: 6e 63 6f 64 69 6e 67 20 74 79 70 65 2c 20 74 72 ncoding type, tr
36c0: 61 6e 73 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a ansform this. *
36d0: 2a 20 74 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 * to one of SQLI
36e0: 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53 51 TE_UTF16LE or SQ
36f0: 4c 49 54 45 5f 55 54 46 31 36 42 45 20 75 73 69 LITE_UTF16BE usi
3700: 6e 67 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 ng the. ** SQLI
3710: 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 6d TE_UTF16NATIVE m
3720: 61 63 72 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 acro. SQLITE_UTF
3730: 31 36 20 69 73 20 6e 6f 74 20 75 73 65 64 20 69 16 is not used i
3740: 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2a 0a nternally.. **.
3750: 20 20 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f 41 ** If SQLITE_A
3760: 4e 59 20 69 73 20 73 70 65 63 69 66 69 65 64 2c NY is specified,
3770: 20 61 64 64 20 74 68 72 65 65 20 76 65 72 73 69 add three versi
3780: 6f 6e 73 20 6f 66 20 74 68 65 20 66 75 6e 63 74 ons of the funct
3790: 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 ion. ** to the
37a0: 68 61 73 68 20 74 61 62 6c 65 2e 0a 20 20 2a 2f hash table.. */
37b0: 0a 20 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 . if( enc==SQLI
37c0: 54 45 5f 55 54 46 31 36 20 29 7b 0a 20 20 20 20 TE_UTF16 ){.
37d0: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 enc = SQLITE_UTF
37e0: 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d 65 6c 73 16NATIVE;. }els
37f0: 65 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 e if( enc==SQLIT
3800: 45 5f 41 4e 59 20 29 7b 0a 20 20 20 20 69 6e 74 E_ANY ){. int
3810: 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 rc;. rc = sq
3820: 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 lite3CreateFunc(
3830: 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d db, zFunctionNam
3840: 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f e, nArg, SQLITE_
3850: 55 54 46 38 2c 0a 20 20 20 20 20 20 20 20 20 70 UTF8,. p
3860: 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c UserData, xFunc,
3870: 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b xStep, xFinal);
3880: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
3890: 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
38a0: 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c rc;. rc = sql
38b0: 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 ite3CreateFunc(d
38c0: 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 b, zFunctionName
38d0: 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 , nArg, SQLITE_U
38e0: 54 46 31 36 4c 45 2c 0a 20 20 20 20 20 20 20 20 TF16LE,.
38f0: 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63 pUserData, xFunc
3900: 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 , xStep, xFinal)
3910: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
3920: 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e LITE_OK ) return
3930: 20 72 63 3b 0a 20 20 20 20 65 6e 63 20 3d 20 53 rc;. enc = S
3940: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b 0a 20 QLITE_UTF16BE;.
3950: 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 20 3d }.#else. enc =
3960: 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 23 65 SQLITE_UTF8;.#e
3970: 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 68 65 ndif. . /* Che
3980: 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 69 6e ck if an existin
3990: 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 62 65 g function is be
39a0: 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e 20 6f ing overridden o
39b0: 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 73 6f r deleted. If so
39c0: 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 72 65 ,. ** and there
39d0: 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73 2c are active VMs,
39e0: 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 51 4c then return SQL
39f0: 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 20 66 ITE_BUSY. If a f
3a00: 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 unction. ** is
3a10: 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e being overridden
3a20: 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 68 65 /deleted but the
3a30: 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 re are no active
3a40: 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 65 0a VMs, allow the.
3a50: 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 74 ** operation t
3a60: 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 20 69 o continue but i
3a70: 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 70 72 nvalidate all pr
3a80: 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 6d ecompiled statem
3a90: 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 20 3d ents.. */. p =
3aa0: 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e 63 sqlite3FindFunc
3ab0: 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 69 tion(db, zFuncti
3ac0: 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e onName, nName, n
3ad0: 41 72 67 2c 20 65 6e 63 2c 20 30 29 3b 0a 20 20 Arg, enc, 0);.
3ae0: 69 66 28 20 70 20 26 26 20 70 2d 3e 69 50 72 65 if( p && p->iPre
3af0: 66 45 6e 63 3d 3d 65 6e 63 20 26 26 20 70 2d 3e fEnc==enc && p->
3b00: 6e 41 72 67 3d 3d 6e 41 72 67 20 29 7b 0a 20 20 nArg==nArg ){.
3b10: 20 20 69 66 28 20 64 62 2d 3e 61 63 74 69 76 65 if( db->active
3b20: 56 64 62 65 43 6e 74 20 29 7b 0a 20 20 20 20 20 VdbeCnt ){.
3b30: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
3b40: 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a , SQLITE_BUSY, .
3b50: 20 20 20 20 20 20 20 20 22 55 6e 61 62 6c 65 20 "Unable
3b60: 74 6f 20 64 65 6c 65 74 65 2f 6d 6f 64 69 66 79 to delete/modify
3b70: 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 user-function d
3b80: 75 65 20 74 6f 20 61 63 74 69 76 65 20 73 74 61 ue to active sta
3b90: 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20 20 tements");.
3ba0: 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 74 65 assert( !sqlite
3bb0: 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20 3MallocFailed()
3bc0: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 );. return
3bd0: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 SQLITE_BUSY;.
3be0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 }else{. sq
3bf0: 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 lite3ExpirePrepa
3c00: 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 redStatements(db
3c10: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 );. }. }..
3c20: 70 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 p = sqlite3FindF
3c30: 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e unction(db, zFun
3c40: 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 ctionName, nName
3c50: 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20 31 29 3b , nArg, enc, 1);
3c60: 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 . if( p ){.
3c70: 70 2d 3e 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20 p->flags = 0;.
3c80: 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20 78 46 75 p->xFunc = xFu
3c90: 6e 63 3b 0a 20 20 20 20 70 2d 3e 78 53 74 65 70 nc;. p->xStep
3ca0: 20 3d 20 78 53 74 65 70 3b 0a 20 20 20 20 70 2d = xStep;. p-
3cb0: 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 78 46 69 >xFinalize = xFi
3cc0: 6e 61 6c 3b 0a 20 20 20 20 70 2d 3e 70 55 73 65 nal;. p->pUse
3cd0: 72 44 61 74 61 20 3d 20 70 55 73 65 72 44 61 74 rData = pUserDat
3ce0: 61 3b 0a 20 20 20 20 70 2d 3e 6e 41 72 67 20 3d a;. p->nArg =
3cf0: 20 6e 41 72 67 3b 0a 20 20 7d 0a 20 20 72 65 74 nArg;. }. ret
3d00: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
3d10: 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 6e ../*.** Create n
3d20: 65 77 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e ew user function
3d30: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
3d40: 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 3_create_functio
3d50: 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 n(. sqlite3 *db
3d60: 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ,. const char *
3d70: 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 zFunctionName,.
3d80: 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 int nArg,. int
3d90: 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 2c enc,. void *p,
3da0: 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 . void (*xFunc)
3db0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
3dc0: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
3dd0: 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 lue **),. void
3de0: 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 (*xStep)(sqlite3
3df0: 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
3e00: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c lite3_value **),
3e10: 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c . void (*xFinal
3e20: 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 )(sqlite3_contex
3e30: 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b t*).){. int rc;
3e40: 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 . assert( !sqli
3e50: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 te3MallocFailed(
3e60: 29 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ) );. rc = sqli
3e70: 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 te3CreateFunc(db
3e80: 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c , zFunctionName,
3e90: 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70 2c 20 78 nArg, enc, p, x
3ea0: 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 Func, xStep, xFi
3eb0: 6e 61 6c 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 nal);.. return
3ec0: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 sqlite3ApiExit(d
3ed0: 62 2c 20 72 63 29 3b 0a 7d 0a 0a 23 69 66 6e 64 b, rc);.}..#ifnd
3ee0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 ef SQLITE_OMIT_U
3ef0: 54 46 31 36 0a 69 6e 74 20 73 71 6c 69 74 65 33 TF16.int sqlite3
3f00: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e _create_function
3f10: 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 16(. sqlite3 *d
3f20: 62 2c 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 b,. const void
3f30: 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a *zFunctionName,.
3f40: 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e int nArg,. in
3f50: 74 20 65 54 65 78 74 52 65 70 2c 0a 20 20 76 6f t eTextRep,. vo
3f60: 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a id *p,. void (*
3f70: 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 xFunc)(sqlite3_c
3f80: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
3f90: 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 te3_value**),.
3fa0: 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 void (*xStep)(sq
3fb0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 lite3_context*,i
3fc0: 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt,sqlite3_value
3fd0: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 **),. void (*xF
3fe0: 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f inal)(sqlite3_co
3ff0: 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 ntext*).){. int
4000: 20 72 63 3b 0a 20 20 63 68 61 72 20 2a 7a 46 75 rc;. char *zFu
4010: 6e 63 38 3b 0a 20 20 61 73 73 65 72 74 28 20 21 nc8;. assert( !
4020: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 sqlite3MallocFai
4030: 6c 65 64 28 29 20 29 3b 0a 0a 20 20 7a 46 75 6e led() );.. zFun
4040: 63 38 20 3d 20 73 71 6c 69 74 65 33 75 74 66 31 c8 = sqlite3utf1
4050: 36 74 6f 38 28 7a 46 75 6e 63 74 69 6f 6e 4e 61 6to8(zFunctionNa
4060: 6d 65 2c 20 2d 31 29 3b 0a 20 20 72 63 20 3d 20 me, -1);. rc =
4070: 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e sqlite3CreateFun
4080: 63 28 64 62 2c 20 7a 46 75 6e 63 38 2c 20 6e 41 c(db, zFunc8, nA
4090: 72 67 2c 20 65 54 65 78 74 52 65 70 2c 20 70 2c rg, eTextRep, p,
40a0: 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 xFunc, xStep, x
40b0: 46 69 6e 61 6c 29 3b 0a 20 20 73 71 6c 69 74 65 Final);. sqlite
40c0: 46 72 65 65 28 7a 46 75 6e 63 38 29 3b 0a 0a 20 Free(zFunc8);..
40d0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 return sqlite3A
40e0: 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
40f0: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a }.#endif.../*.**
4100: 20 44 65 63 6c 61 72 65 20 74 68 61 74 20 61 20 Declare that a
4110: 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 65 function has bee
4120: 6e 20 6f 76 65 72 6c 6f 61 64 65 64 20 62 79 20 n overloaded by
4130: 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e a virtual table.
4140: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 75 .**.** If the fu
4150: 6e 63 74 69 6f 6e 20 61 6c 72 65 61 64 79 20 65 nction already e
4160: 78 69 73 74 73 20 61 73 20 61 20 72 65 67 75 6c xists as a regul
4170: 61 72 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 ar global functi
4180: 6f 6e 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 73 on, then.** this
4190: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f routine is a no
41a0: 2d 6f 70 2e 20 20 49 66 20 74 68 65 20 66 75 6e -op. If the fun
41b0: 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 65 ction does not e
41c0: 78 69 73 74 2c 20 74 68 65 6e 20 63 72 65 61 74 xist, then creat
41d0: 65 0a 2a 2a 20 61 20 6e 65 77 20 6f 6e 65 20 74 e.** a new one t
41e0: 68 61 74 20 61 6c 77 61 79 73 20 74 68 72 6f 77 hat always throw
41f0: 73 20 61 20 72 75 6e 2d 74 69 6d 65 20 65 72 72 s a run-time err
4200: 6f 72 2e 20 20 0a 2a 2a 0a 2a 2a 20 57 68 65 6e or. .**.** When
4210: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 virtual tables
4220: 69 6e 74 65 6e 64 20 74 6f 20 70 72 6f 76 69 64 intend to provid
4230: 65 20 61 6e 20 6f 76 65 72 6c 6f 61 64 65 64 20 e an overloaded
4240: 66 75 6e 63 74 69 6f 6e 2c 20 74 68 65 79 0a 2a function, they.*
4250: 2a 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74 68 * should call th
4260: 69 73 20 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 is routine to ma
4270: 6b 65 20 73 75 72 65 20 74 68 65 20 67 6c 6f 62 ke sure the glob
4280: 61 6c 20 66 75 6e 63 74 69 6f 6e 20 65 78 69 73 al function exis
4290: 74 73 2e 0a 2a 2a 20 41 20 67 6c 6f 62 61 6c 20 ts..** A global
42a0: 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 65 78 function must ex
42b0: 69 73 74 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 ist in order for
42c0: 20 6e 61 6d 65 20 72 65 73 6f 6c 75 74 69 6f 6e name resolution
42d0: 20 74 6f 20 77 6f 72 6b 0a 2a 2a 20 70 72 6f 70 to work.** prop
42e0: 65 72 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c erly..*/.int sql
42f0: 69 74 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75 ite3_overload_fu
4300: 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 nction(. sqlite
4310: 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 3 *db,. const c
4320: 68 61 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20 69 6e har *zName,. in
4330: 74 20 6e 41 72 67 0a 29 7b 0a 20 20 69 6e 74 20 t nArg.){. int
4340: 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a nName = strlen(z
4350: 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 73 71 6c Name);. if( sql
4360: 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e ite3FindFunction
4370: 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d (db, zName, nNam
4380: 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f e, nArg, SQLITE_
4390: 55 54 46 38 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 UTF8, 0)==0 ){.
43a0: 20 20 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 sqlite3Create
43b0: 46 75 6e 63 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 Func(db, zName,
43c0: 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 nArg, SQLITE_UTF
43d0: 38 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 8,.
43e0: 20 20 20 20 20 20 20 20 20 30 2c 20 73 71 6c 69 0, sqli
43f0: 74 65 33 49 6e 76 61 6c 69 64 46 75 6e 63 74 69 te3InvalidFuncti
4400: 6f 6e 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 on, 0, 0);. }.
4410: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 return sqlite3A
4420: 70 69 45 78 69 74 28 64 62 2c 20 53 51 4c 49 54 piExit(db, SQLIT
4430: 45 5f 4f 4b 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65 E_OK);.}..#ifnde
4440: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 f SQLITE_OMIT_TR
4450: 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 ACE./*.** Regist
4460: 65 72 20 61 20 74 72 61 63 65 20 66 75 6e 63 74 er a trace funct
4470: 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 ion. The pArg f
4480: 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 rom the previous
4490: 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 74 72 ly registered tr
44a0: 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e ace.** is return
44b0: 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 ed. .**.** A NU
44c0: 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f LL trace functio
44d0: 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 n means that no
44e0: 74 72 61 63 69 6e 67 20 69 73 20 65 78 65 63 75 tracing is execu
44f0: 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c tes. A non-NULL
4500: 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 61 20 70 .** trace is a p
4510: 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 ointer to a func
4520: 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76 tion that is inv
4530: 6f 6b 65 64 20 61 74 20 74 68 65 20 73 74 61 72 oked at the star
4540: 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 53 51 4c t of each.** SQL
4550: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 76 statement..*/.v
4560: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 74 72 61 oid *sqlite3_tra
4570: 63 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 ce(sqlite3 *db,
4580: 76 6f 69 64 20 28 2a 78 54 72 61 63 65 29 28 76 void (*xTrace)(v
4590: 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a oid*,const char*
45a0: 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a ), void *pArg){.
45b0: 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64 void *pOld = d
45c0: 62 2d 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20 b->pTraceArg;.
45d0: 64 62 2d 3e 78 54 72 61 63 65 20 3d 20 78 54 72 db->xTrace = xTr
45e0: 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 ace;. db->pTrac
45f0: 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 eArg = pArg;. r
4600: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 2f 2a eturn pOld;.}./*
4610: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 70 .** Register a p
4620: 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 2e rofile function.
4630: 20 20 54 68 65 20 70 41 72 67 20 66 72 6f 6d 20 The pArg from
4640: 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 72 the previously r
4650: 65 67 69 73 74 65 72 65 64 20 0a 2a 2a 20 70 72 egistered .** pr
4660: 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 69 ofile function i
4670: 73 20 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a s returned. .**
4680: 0a 2a 2a 20 41 20 4e 55 4c 4c 20 70 72 6f 66 69 .** A NULL profi
4690: 6c 65 20 66 75 6e 63 74 69 6f 6e 20 6d 65 61 6e le function mean
46a0: 73 20 74 68 61 74 20 6e 6f 20 70 72 6f 66 69 6c s that no profil
46b0: 69 6e 67 20 69 73 20 65 78 65 63 75 74 65 73 2e ing is executes.
46c0: 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 A non-NULL.**
46d0: 70 72 6f 66 69 6c 65 20 69 73 20 61 20 70 6f 69 profile is a poi
46e0: 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 nter to a functi
46f0: 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b on that is invok
4700: 65 64 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 ed at the conclu
4710: 73 69 6f 6e 20 6f 66 0a 2a 2a 20 65 61 63 68 20 sion of.** each
4720: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 68 SQL statement th
4730: 61 74 20 69 73 20 72 75 6e 2e 0a 2a 2f 0a 76 6f at is run..*/.vo
4740: 69 64 20 2a 73 71 6c 69 74 65 33 5f 70 72 6f 66 id *sqlite3_prof
4750: 69 6c 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a ile(. sqlite3 *
4760: 64 62 2c 0a 20 20 76 6f 69 64 20 28 2a 78 50 72 db,. void (*xPr
4770: 6f 66 69 6c 65 29 28 76 6f 69 64 2a 2c 63 6f 6e ofile)(void*,con
4780: 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 74 65 5f st char*,sqlite_
4790: 75 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 64 20 uint64),. void
47a0: 2a 70 41 72 67 0a 29 7b 0a 20 20 76 6f 69 64 20 *pArg.){. void
47b0: 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 50 72 6f *pOld = db->pPro
47c0: 66 69 6c 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 fileArg;. db->x
47d0: 50 72 6f 66 69 6c 65 20 3d 20 78 50 72 6f 66 69 Profile = xProfi
47e0: 6c 65 3b 0a 20 20 64 62 2d 3e 70 50 72 6f 66 69 le;. db->pProfi
47f0: 6c 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 leArg = pArg;.
4800: 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 23 return pOld;.}.#
4810: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
4820: 4f 4d 49 54 5f 54 52 41 43 45 20 2a 2f 0a 0a 2f OMIT_TRACE */../
4830: 2a 2a 2a 20 45 58 50 45 52 49 4d 45 4e 54 41 4c *** EXPERIMENTAL
4840: 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 67 69 73 ***.**.** Regis
4850: 74 65 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 ter a function t
4860: 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 77 68 65 o be invoked whe
4870: 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 n a transaction
4880: 63 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a 20 49 66 20 comments..** If
4890: 74 68 65 20 69 6e 76 6f 6b 65 64 20 66 75 6e 63 the invoked func
48a0: 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 6e 6f 6e tion returns non
48b0: 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 -zero, then the
48c0: 63 6f 6d 6d 69 74 20 62 65 63 6f 6d 65 73 20 61 commit becomes a
48d0: 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f .** rollback..*/
48e0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 .void *sqlite3_c
48f0: 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a 20 20 73 71 ommit_hook(. sq
4900: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
4910: 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 /* Attac
4920: 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 h the hook to th
4930: 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 is database */.
4940: 20 69 6e 74 20 28 2a 78 43 61 6c 6c 62 61 63 6b int (*xCallback
4950: 29 28 76 6f 69 64 2a 29 2c 20 20 2f 2a 20 46 75 )(void*), /* Fu
4960: 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b 65 nction to invoke
4970: 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d 69 74 20 on each commit
4980: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 */. void *pArg
4990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
49a0: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 * Argument to th
49b0: 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b e function */.){
49c0: 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 . void *pOld =
49d0: 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 3b 0a db->pCommitArg;.
49e0: 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c db->xCommitCal
49f0: 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 lback = xCallbac
4a00: 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 k;. db->pCommit
4a10: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 65 Arg = pArg;. re
4a20: 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a turn pOld;.}../*
4a30: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 .** Register a c
4a40: 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 6e allback to be in
4a50: 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65 20 voked each time
4a60: 61 20 72 6f 77 20 69 73 20 75 70 64 61 74 65 64 a row is updated
4a70: 2c 0a 2a 2a 20 69 6e 73 65 72 74 65 64 20 6f 72 ,.** inserted or
4a80: 20 64 65 6c 65 74 65 64 20 75 73 69 6e 67 20 74 deleted using t
4a90: 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e his database con
4aa0: 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 nection..*/.void
4ab0: 20 2a 73 71 6c 69 74 65 33 5f 75 70 64 61 74 65 *sqlite3_update
4ac0: 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 _hook(. sqlite3
4ad0: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
4ae0: 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 /* Attach the
4af0: 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 hook to this da
4b00: 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 6f 69 64 tabase */. void
4b10: 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f (*xCallback)(vo
4b20: 69 64 2a 2c 69 6e 74 2c 63 68 61 72 20 63 6f 6e id*,int,char con
4b30: 73 74 20 2a 2c 63 68 61 72 20 63 6f 6e 73 74 20 st *,char const
4b40: 2a 2c 73 71 6c 69 74 65 5f 69 6e 74 36 34 29 2c *,sqlite_int64),
4b50: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 . void *pArg
4b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
4b70: 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 Argument to the
4b80: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 function */.){.
4b90: 20 76 6f 69 64 20 2a 70 52 65 74 20 3d 20 64 62 void *pRet = db
4ba0: 2d 3e 70 55 70 64 61 74 65 41 72 67 3b 0a 20 20 ->pUpdateArg;.
4bb0: 64 62 2d 3e 78 55 70 64 61 74 65 43 61 6c 6c 62 db->xUpdateCallb
4bc0: 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b ack = xCallback;
4bd0: 0a 20 20 64 62 2d 3e 70 55 70 64 61 74 65 41 72 . db->pUpdateAr
4be0: 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 65 74 75 g = pArg;. retu
4bf0: 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a rn pRet;.}../*.*
4c00: 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 61 6c * Register a cal
4c10: 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f lback to be invo
4c20: 6b 65 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 ked each time a
4c30: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 transaction is r
4c40: 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 62 79 olled.** back by
4c50: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63 this database c
4c60: 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f onnection..*/.vo
4c70: 69 64 20 2a 73 71 6c 69 74 65 33 5f 72 6f 6c 6c id *sqlite3_roll
4c80: 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c back_hook(. sql
4c90: 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 ite3 *db,
4ca0: 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 /* Attach
4cb0: 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 the hook to thi
4cc0: 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 s database */.
4cd0: 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b void (*xCallback
4ce0: 29 28 76 6f 69 64 2a 29 2c 20 2f 2a 20 43 61 6c )(void*), /* Cal
4cf0: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 2a lback function *
4d00: 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 /. void *pArg
4d10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
4d20: 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 Argument to the
4d30: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a function */.){.
4d40: 20 20 76 6f 69 64 20 2a 70 52 65 74 20 3d 20 64 void *pRet = d
4d50: 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 3b b->pRollbackArg;
4d60: 0a 20 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b . db->xRollback
4d70: 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c Callback = xCall
4d80: 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 52 6f 6c back;. db->pRol
4d90: 6c 62 61 63 6b 41 72 67 20 3d 20 70 41 72 67 3b lbackArg = pArg;
4da0: 0a 20 20 72 65 74 75 72 6e 20 70 52 65 74 3b 0a . return pRet;.
4db0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
4dc0: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 utine is called
4dd0: 74 6f 20 63 72 65 61 74 65 20 61 20 63 6f 6e 6e to create a conn
4de0: 65 63 74 69 6f 6e 20 74 6f 20 61 20 64 61 74 61 ection to a data
4df0: 62 61 73 65 20 42 54 72 65 65 0a 2a 2a 20 64 72 base BTree.** dr
4e00: 69 76 65 72 2e 20 20 49 66 20 7a 46 69 6c 65 6e iver. If zFilen
4e10: 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20 ame is the name
4e20: 6f 66 20 61 20 66 69 6c 65 2c 20 74 68 65 6e 20 of a file, then
4e30: 74 68 61 74 20 66 69 6c 65 20 69 73 0a 2a 2a 20 that file is.**
4e40: 6f 70 65 6e 65 64 20 61 6e 64 20 75 73 65 64 2e opened and used.
4e50: 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 If zFilename i
4e60: 73 20 74 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 s the magic name
4e70: 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 68 65 6e ":memory:" then
4e80: 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 .** the database
4e90: 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 6d 65 is stored in me
4ea0: 6d 6f 72 79 20 28 61 6e 64 20 69 73 20 74 68 75 mory (and is thu
4eb0: 73 20 66 6f 72 67 6f 74 74 65 6e 20 61 73 20 73 s forgotten as s
4ec0: 6f 6f 6e 20 61 73 0a 2a 2a 20 74 68 65 20 63 6f oon as.** the co
4ed0: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 nnection is clos
4ee0: 65 64 2e 29 20 20 49 66 20 7a 46 69 6c 65 6e 61 ed.) If zFilena
4ef0: 6d 65 20 69 73 20 4e 55 4c 4c 20 74 68 65 6e 20 me is NULL then
4f00: 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 the database.**
4f10: 69 73 20 61 20 22 76 69 72 74 75 61 6c 22 20 64 is a "virtual" d
4f20: 61 74 61 62 61 73 65 20 66 6f 72 20 74 72 61 6e atabase for tran
4f30: 73 69 65 6e 74 20 75 73 65 20 6f 6e 6c 79 20 61 sient use only a
4f40: 6e 64 20 69 73 20 64 65 6c 65 74 65 64 20 61 73 nd is deleted as
4f50: 0a 2a 2a 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 .** soon as the
4f60: 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63 6c connection is cl
4f70: 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 76 69 osed..**.** A vi
4f80: 72 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 63 rtual database c
4f90: 61 6e 20 62 65 20 65 69 74 68 65 72 20 61 20 64 an be either a d
4fa0: 69 73 6b 20 66 69 6c 65 20 28 74 68 61 74 20 69 isk file (that i
4fb0: 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a s automatically.
4fc0: 2a 2a 20 64 65 6c 65 74 65 64 20 77 68 65 6e 20 ** deleted when
4fd0: 74 68 65 20 66 69 6c 65 20 69 73 20 63 6c 6f 73 the file is clos
4fe0: 65 64 29 20 6f 72 20 69 74 20 61 6e 20 62 65 20 ed) or it an be
4ff0: 68 65 6c 64 20 65 6e 74 69 72 65 6c 79 20 69 6e held entirely in
5000: 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 64 65 70 65 memory,.** depe
5010: 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c nding on the val
5020: 75 65 73 20 6f 66 20 74 68 65 20 54 45 4d 50 5f ues of the TEMP_
5030: 53 54 4f 52 45 20 63 6f 6d 70 69 6c 65 2d 74 69 STORE compile-ti
5040: 6d 65 20 6d 61 63 72 6f 20 61 6e 64 20 74 68 65 me macro and the
5050: 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f .** db->temp_sto
5060: 72 65 20 76 61 72 69 61 62 6c 65 2c 20 61 63 63 re variable, acc
5070: 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 66 6f ording to the fo
5080: 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 3a 0a 2a llowing chart:.*
5090: 2a 0a 2a 2a 20 20 20 20 20 20 20 54 45 4d 50 5f *.** TEMP_
50a0: 53 54 4f 52 45 20 20 20 20 20 64 62 2d 3e 74 65 STORE db->te
50b0: 6d 70 5f 73 74 6f 72 65 20 20 20 20 20 4c 6f 63 mp_store Loc
50c0: 61 74 69 6f 6e 20 6f 66 20 74 65 6d 70 6f 72 61 ation of tempora
50d0: 72 79 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 ry database.**
50e0: 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 ----------
50f0: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ------------
5100: 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d -- ---------
5110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5120: 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 20 20 -----.**
5130: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 0
5140: 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 any
5150: 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 file.**
5160: 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20 1
5170: 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 1
5180: 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20 20 file.**
5190: 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 1
51a0: 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20 2
51b0: 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a memory.**
51c0: 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 1
51d0: 20 20 20 20 20 20 20 20 20 20 20 20 30 20 20 20 0
51e0: 20 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 0a file.
51f0: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 32 20 20 ** 2
5200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 20 1
5210: 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c fil
5220: 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 32 e.** 2
5230: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5240: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 2 m
5250: 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20 20 20 20 emory.**
5260: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 2
5270: 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 0
5280: 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 memory.**
5290: 20 20 20 20 20 20 20 33 20 20 20 20 20 20 20 20 3
52a0: 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20 any
52b0: 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2f memory.*/
52c0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
52d0: 65 46 61 63 74 6f 72 79 28 0a 20 20 63 6f 6e 73 eFactory(. cons
52e0: 74 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 t sqlite3 *db,
52f0: 20 20 20 20 20 20 2f 2a 20 4d 61 69 6e 20 64 61 /* Main da
5300: 74 61 62 61 73 65 20 77 68 65 6e 20 6f 70 65 6e tabase when open
5310: 69 6e 67 20 61 75 78 20 6f 74 68 65 72 77 69 73 ing aux otherwis
5320: 65 20 30 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 e 0 */. const c
5330: 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 har *zFilename,
5340: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
5350: 65 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e e file containin
5360: 67 20 74 68 65 20 42 54 72 65 65 20 64 61 74 61 g the BTree data
5370: 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6f 6d base */. int om
5380: 69 74 4a 6f 75 72 6e 61 6c 2c 20 20 20 20 20 20 itJournal,
5390: 20 20 20 20 2f 2a 20 69 66 20 54 52 55 45 20 74 /* if TRUE t
53a0: 68 65 6e 20 64 6f 20 6e 6f 74 20 6a 6f 75 72 6e hen do not journ
53b0: 61 6c 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a al this file */.
53c0: 20 20 69 6e 74 20 6e 43 61 63 68 65 2c 20 20 20 int nCache,
53d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 /* H
53e0: 6f 77 20 6d 61 6e 79 20 70 61 67 65 73 20 69 6e ow many pages in
53f0: 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20 the page cache
5400: 2a 2f 0a 20 20 42 74 72 65 65 20 2a 2a 70 70 42 */. Btree **ppB
5410: 74 72 65 65 20 20 20 20 20 20 20 20 20 20 20 2f tree /
5420: 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 * Pointer to new
5430: 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 77 72 Btree object wr
5440: 69 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a 29 7b itten here */.){
5450: 0a 20 20 69 6e 74 20 62 74 72 65 65 5f 66 6c 61 . int btree_fla
5460: 67 73 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 gs = 0;. int rc
5470: 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 70 ;. . assert( p
5480: 70 42 74 72 65 65 20 21 3d 20 30 29 3b 0a 20 20 pBtree != 0);.
5490: 69 66 28 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 20 if( omitJournal
54a0: 29 7b 0a 20 20 20 20 62 74 72 65 65 5f 66 6c 61 ){. btree_fla
54b0: 67 73 20 7c 3d 20 42 54 52 45 45 5f 4f 4d 49 54 gs |= BTREE_OMIT
54c0: 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 7d 0a 20 20 _JOURNAL;. }.
54d0: 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20 if( db->flags &
54e0: 53 51 4c 49 54 45 5f 4e 6f 52 65 61 64 6c 6f 63 SQLITE_NoReadloc
54f0: 6b 20 29 7b 0a 20 20 20 20 62 74 72 65 65 5f 66 k ){. btree_f
5500: 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f 4e 4f lags |= BTREE_NO
5510: 5f 52 45 41 44 4c 4f 43 4b 3b 0a 20 20 7d 0a 20 _READLOCK;. }.
5520: 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d if( zFilename==
5530: 30 20 29 7b 0a 23 69 66 20 54 45 4d 50 5f 53 54 0 ){.#if TEMP_ST
5540: 4f 52 45 3d 3d 30 0a 20 20 20 20 2f 2a 20 44 6f ORE==0. /* Do
5550: 20 6e 6f 74 68 69 6e 67 20 2a 2f 0a 23 65 6e 64 nothing */.#end
5560: 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
5570: 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a E_OMIT_MEMORYDB.
5580: 23 69 66 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d #if TEMP_STORE==
5590: 31 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 74 65 1. if( db->te
55a0: 6d 70 5f 73 74 6f 72 65 3d 3d 32 20 29 20 7a 46 mp_store==2 ) zF
55b0: 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f ilename = ":memo
55c0: 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 69 66 ry:";.#endif.#if
55d0: 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 32 0a 20 TEMP_STORE==2.
55e0: 20 20 20 69 66 28 20 64 62 2d 3e 74 65 6d 70 5f if( db->temp_
55f0: 73 74 6f 72 65 21 3d 31 20 29 20 7a 46 69 6c 65 store!=1 ) zFile
5600: 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f 72 79 3a name = ":memory:
5610: 22 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 54 45 ";.#endif.#if TE
5620: 4d 50 5f 53 54 4f 52 45 3d 3d 33 0a 20 20 20 20 MP_STORE==3.
5630: 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 zFilename = ":me
5640: 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 mory:";.#endif.#
5650: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
5660: 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 20 2a 2f OMIT_MEMORYDB */
5670: 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 73 71 6c . }.. rc = sql
5680: 69 74 65 33 42 74 72 65 65 4f 70 65 6e 28 7a 46 ite3BtreeOpen(zF
5690: 69 6c 65 6e 61 6d 65 2c 20 28 73 71 6c 69 74 65 ilename, (sqlite
56a0: 33 20 2a 29 64 62 2c 20 70 70 42 74 72 65 65 2c 3 *)db, ppBtree,
56b0: 20 62 74 72 65 65 5f 66 6c 61 67 73 29 3b 0a 20 btree_flags);.
56c0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
56d0: 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 OK ){. sqlite
56e0: 33 42 74 72 65 65 53 65 74 42 75 73 79 48 61 6e 3BtreeSetBusyHan
56f0: 64 6c 65 72 28 2a 70 70 42 74 72 65 65 2c 20 28 dler(*ppBtree, (
5700: 76 6f 69 64 2a 29 26 64 62 2d 3e 62 75 73 79 48 void*)&db->busyH
5710: 61 6e 64 6c 65 72 29 3b 0a 20 20 20 20 73 71 6c andler);. sql
5720: 69 74 65 33 42 74 72 65 65 53 65 74 43 61 63 68 ite3BtreeSetCach
5730: 65 53 69 7a 65 28 2a 70 70 42 74 72 65 65 2c 20 eSize(*ppBtree,
5740: 6e 43 61 63 68 65 29 3b 0a 20 20 7d 0a 20 20 72 nCache);. }. r
5750: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
5760: 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 2d 38 20 ** Return UTF-8
5770: 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 encoded English
5780: 6c 61 6e 67 75 61 67 65 20 65 78 70 6c 61 6e 61 language explana
5790: 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 tion of the most
57a0: 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 recent.** error
57b0: 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 ..*/.const char
57c0: 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 *sqlite3_errmsg(
57d0: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 sqlite3 *db){.
57e0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 const char *z;.
57f0: 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 74 65 assert( !sqlite
5800: 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20 3MallocFailed()
5810: 29 3b 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a );. if( !db ){.
5820: 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 return sqlit
5830: 65 33 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f e3ErrStr(SQLITE_
5840: 4e 4f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 69 66 NOMEM);. }. if
5850: 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 ( sqlite3SafetyC
5860: 68 65 63 6b 28 64 62 29 20 7c 7c 20 64 62 2d 3e heck(db) || db->
5870: 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f errCode==SQLITE_
5880: 4d 49 53 55 53 45 20 29 7b 0a 20 20 20 20 72 65 MISUSE ){. re
5890: 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 turn sqlite3ErrS
58a0: 74 72 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 tr(SQLITE_MISUSE
58b0: 29 3b 0a 20 20 7d 0a 20 20 7a 20 3d 20 28 63 68 );. }. z = (ch
58c0: 61 72 2a 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 ar*)sqlite3_valu
58d0: 65 5f 74 65 78 74 28 64 62 2d 3e 70 45 72 72 29 e_text(db->pErr)
58e0: 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a ;. if( z==0 ){.
58f0: 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 45 z = sqlite3E
5900: 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43 6f 64 rrStr(db->errCod
5910: 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e e);. }. return
5920: 20 7a 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 z;.}..#ifndef S
5930: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
5940: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 ./*.** Return UT
5950: 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 45 6e 67 F-16 encoded Eng
5960: 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 lish language ex
5970: 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 planation of the
5980: 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 most recent.**
5990: 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 error..*/.const
59a0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 65 72 void *sqlite3_er
59b0: 72 6d 73 67 31 36 28 73 71 6c 69 74 65 33 20 2a rmsg16(sqlite3 *
59c0: 64 62 29 7b 0a 20 20 2f 2a 20 42 65 63 61 75 73 db){. /* Becaus
59d0: 65 20 61 6c 6c 20 74 68 65 20 63 68 61 72 61 63 e all the charac
59e0: 74 65 72 73 20 69 6e 20 74 68 65 20 73 74 72 69 ters in the stri
59f0: 6e 67 20 61 72 65 20 69 6e 20 74 68 65 20 75 6e ng are in the un
5a00: 69 63 6f 64 65 0a 20 20 2a 2a 20 72 61 6e 67 65 icode. ** range
5a10: 20 30 78 30 30 2d 30 78 46 46 2c 20 69 66 20 77 0x00-0xFF, if w
5a20: 65 20 70 61 64 20 74 68 65 20 62 69 67 2d 65 6e e pad the big-en
5a30: 64 69 61 6e 20 73 74 72 69 6e 67 20 77 69 74 68 dian string with
5a40: 20 61 20 0a 20 20 2a 2a 20 7a 65 72 6f 20 62 79 a . ** zero by
5a50: 74 65 2c 20 77 65 20 63 61 6e 20 6f 62 74 61 69 te, we can obtai
5a60: 6e 20 74 68 65 20 6c 69 74 74 6c 65 2d 65 6e 64 n the little-end
5a70: 69 61 6e 20 73 74 72 69 6e 67 20 77 69 74 68 0a ian string with.
5a80: 20 20 2a 2a 20 26 62 69 67 5f 65 6e 64 69 61 6e ** &big_endian
5a90: 5b 31 5d 2e 0a 20 20 2a 2f 0a 20 20 73 74 61 74 [1].. */. stat
5aa0: 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 6f 75 ic const char ou
5ab0: 74 4f 66 4d 65 6d 42 65 5b 5d 20 3d 20 7b 0a 20 tOfMemBe[] = {.
5ac0: 20 20 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27 75 0, 'o', 0, 'u
5ad0: 27 2c 20 30 2c 20 27 74 27 2c 20 30 2c 20 27 20 ', 0, 't', 0, '
5ae0: 27 2c 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20 ', . 0, 'o',
5af0: 30 2c 20 27 66 27 2c 20 30 2c 20 27 20 27 2c 20 0, 'f', 0, ' ',
5b00: 0a 20 20 20 20 30 2c 20 27 6d 27 2c 20 30 2c 20 . 0, 'm', 0,
5b10: 27 65 27 2c 20 30 2c 20 27 6d 27 2c 20 30 2c 20 'e', 0, 'm', 0,
5b20: 27 6f 27 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 'o', 0, 'r', 0,
5b30: 27 79 27 2c 20 30 2c 20 30 2c 20 30 0a 20 20 7d 'y', 0, 0, 0. }
5b40: 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 ;. static const
5b50: 20 63 68 61 72 20 6d 69 73 75 73 65 42 65 20 5b char misuseBe [
5b60: 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6c 27 ] = {. 0, 'l'
5b70: 2c 20 30 2c 20 27 69 27 2c 20 30 2c 20 27 62 27 , 0, 'i', 0, 'b'
5b80: 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 27 61 27 , 0, 'r', 0, 'a'
5b90: 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 27 79 27 , 0, 'r', 0, 'y'
5ba0: 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 , 0, ' ', . 0
5bb0: 2c 20 27 72 27 2c 20 30 2c 20 27 6f 27 2c 20 30 , 'r', 0, 'o', 0
5bc0: 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c 20 30 , 'u', 0, 't', 0
5bd0: 2c 20 27 69 27 2c 20 30 2c 20 27 6e 27 2c 20 30 , 'i', 0, 'n', 0
5be0: 2c 20 27 65 27 2c 20 30 2c 20 27 20 27 2c 20 0a , 'e', 0, ' ', .
5bf0: 20 20 20 20 30 2c 20 27 63 27 2c 20 30 2c 20 27 0, 'c', 0, '
5c00: 61 27 2c 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 a', 0, 'l', 0, '
5c10: 6c 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 l', 0, 'e', 0, '
5c20: 64 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 d', 0, ' ', .
5c30: 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27 75 27 2c 0, 'o', 0, 'u',
5c40: 20 30 2c 20 27 74 27 2c 20 30 2c 20 27 20 27 2c 0, 't', 0, ' ',
5c50: 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20 30 2c . 0, 'o', 0,
5c60: 20 27 66 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 'f', 0, ' ', .
5c70: 20 20 20 30 2c 20 27 73 27 2c 20 30 2c 20 27 65 0, 's', 0, 'e
5c80: 27 2c 20 30 2c 20 27 71 27 2c 20 30 2c 20 27 75 ', 0, 'q', 0, 'u
5c90: 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 6e ', 0, 'e', 0, 'n
5ca0: 27 2c 20 30 2c 20 27 63 27 2c 20 30 2c 20 27 65 ', 0, 'c', 0, 'e
5cb0: 27 2c 20 30 2c 20 30 2c 20 30 0a 20 20 7d 3b 0a ', 0, 0, 0. };.
5cc0: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a . const void *z
5cd0: 3b 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c ;. assert( !sql
5ce0: 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 ite3MallocFailed
5cf0: 28 29 20 29 3b 0a 20 20 69 66 28 20 21 64 62 20 () );. if( !db
5d00: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 76 ){. return (v
5d10: 6f 69 64 20 2a 29 28 26 6f 75 74 4f 66 4d 65 6d oid *)(&outOfMem
5d20: 42 65 5b 53 51 4c 49 54 45 5f 55 54 46 31 36 4e Be[SQLITE_UTF16N
5d30: 41 54 49 56 45 3d 3d 53 51 4c 49 54 45 5f 55 54 ATIVE==SQLITE_UT
5d40: 46 31 36 4c 45 3f 31 3a 30 5d 29 3b 0a 20 20 7d F16LE?1:0]);. }
5d50: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 . if( sqlite3Sa
5d60: 66 65 74 79 43 68 65 63 6b 28 64 62 29 20 7c 7c fetyCheck(db) ||
5d70: 20 64 62 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 db->errCode==SQ
5d80: 4c 49 54 45 5f 4d 49 53 55 53 45 20 29 7b 0a 20 LITE_MISUSE ){.
5d90: 20 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 return (void
5da0: 2a 29 28 26 6d 69 73 75 73 65 42 65 5b 53 51 4c *)(&misuseBe[SQL
5db0: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3d ITE_UTF16NATIVE=
5dc0: 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 3f =SQLITE_UTF16LE?
5dd0: 31 3a 30 5d 29 3b 0a 20 20 7d 0a 20 20 7a 20 3d 1:0]);. }. z =
5de0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 sqlite3_value_t
5df0: 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72 29 3b ext16(db->pErr);
5e00: 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a 20 . if( z==0 ){.
5e10: 20 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 sqlite3ValueS
5e20: 65 74 53 74 72 28 64 62 2d 3e 70 45 72 72 2c 20 etStr(db->pErr,
5e30: 2d 31 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 -1, sqlite3ErrSt
5e40: 72 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 2c 0a r(db->errCode),.
5e50: 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
5e60: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 41 UTF8, SQLITE_STA
5e70: 54 49 43 29 3b 0a 20 20 20 20 7a 20 3d 20 73 71 TIC);. z = sq
5e80: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 lite3_value_text
5e90: 31 36 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 16(db->pErr);.
5ea0: 7d 0a 20 20 73 71 6c 69 74 65 33 41 70 69 45 78 }. sqlite3ApiEx
5eb0: 69 74 28 30 2c 20 30 29 3b 0a 20 20 72 65 74 75 it(0, 0);. retu
5ec0: 72 6e 20 7a 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f rn z;.}.#endif /
5ed0: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 * SQLITE_OMIT_UT
5ee0: 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 F16 */../*.** Re
5ef0: 74 75 72 6e 20 74 68 65 20 6d 6f 73 74 20 72 65 turn the most re
5f00: 63 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 65 20 cent error code
5f10: 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e 20 generated by an
5f20: 53 51 4c 69 74 65 20 72 6f 75 74 69 6e 65 2e 20 SQLite routine.
5f30: 49 66 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20 70 61 If NULL is.** pa
5f40: 73 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 6e ssed to this fun
5f50: 63 74 69 6f 6e 2c 20 77 65 20 61 73 73 75 6d 65 ction, we assume
5f60: 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c a malloc() fail
5f70: 65 64 20 64 75 72 69 6e 67 20 73 71 6c 69 74 65 ed during sqlite
5f80: 33 5f 6f 70 65 6e 28 29 2e 0a 2a 2f 0a 69 6e 74 3_open()..*/.int
5f90: 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 sqlite3_errcode
5fa0: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 (sqlite3 *db){.
5fb0: 20 69 66 28 20 21 64 62 20 7c 7c 20 73 71 6c 69 if( !db || sqli
5fc0: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 te3MallocFailed(
5fd0: 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
5fe0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
5ff0: 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 }. if( sqlite3S
6000: 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 afetyCheck(db) )
6010: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
6020: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a ITE_MISUSE;. }.
6030: 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 65 72 72 return db->err
6040: 43 6f 64 65 20 26 20 64 62 2d 3e 65 72 72 4d 61 Code & db->errMa
6050: 73 6b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 sk;.}../*.** Cre
6060: 61 74 65 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 ate a new collat
6070: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 ing function for
6080: 20 64 61 74 61 62 61 73 65 20 22 64 62 22 2e 20 database "db".
6090: 20 54 68 65 20 6e 61 6d 65 20 69 73 20 7a 4e 61 The name is zNa
60a0: 6d 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 65 6e me.** and the en
60b0: 63 6f 64 69 6e 67 20 69 73 20 65 6e 63 2e 0a 2a coding is enc..*
60c0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 72 65 /.static int cre
60d0: 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 ateCollation(.
60e0: 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 sqlite3* db, .
60f0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d const char *zNam
6100: 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a e, . int enc, .
6110: 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 void* pCtx,.
6120: 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 int(*xCompare)(v
6130: 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 oid*,int,const v
6140: 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 oid*,int,const v
6150: 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 64 28 2a 78 oid*),. void(*x
6160: 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 Del)(void*).){.
6170: 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 3b CollSeq *pColl;
6180: 0a 20 20 69 6e 74 20 65 6e 63 32 3b 0a 20 20 0a . int enc2;. .
6190: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 if( sqlite3Saf
61a0: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a etyCheck(db) ){.
61b0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
61c0: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 E_MISUSE;. }..
61d0: 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 /* If SQLITE_UT
61e0: 46 31 36 20 69 73 20 73 70 65 63 69 66 69 65 64 F16 is specified
61f0: 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 as the encoding
6200: 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d type, transform
6210: 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e this. ** to on
6220: 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 e of SQLITE_UTF1
6230: 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 6LE or SQLITE_UT
6240: 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a F16BE using the.
6250: 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 ** SQLITE_UTF1
6260: 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 6NATIVE macro. S
6270: 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e QLITE_UTF16 is n
6280: 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c ot used internal
6290: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 6e 63 32 20 ly.. */. enc2
62a0: 3d 20 65 6e 63 20 26 20 7e 53 51 4c 49 54 45 5f = enc & ~SQLITE_
62b0: 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 3b 0a 20 UTF16_ALIGNED;.
62c0: 20 69 66 28 20 65 6e 63 32 3d 3d 53 51 4c 49 54 if( enc2==SQLIT
62d0: 45 5f 55 54 46 31 36 20 29 7b 0a 20 20 20 20 65 E_UTF16 ){. e
62e0: 6e 63 32 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 nc2 = SQLITE_UTF
62f0: 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d 0a 0a 20 16NATIVE;. }..
6300: 20 69 66 28 20 28 65 6e 63 32 26 7e 33 29 21 3d if( (enc2&~3)!=
6310: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 0 ){. sqlite3
6320: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
6330: 5f 45 52 52 4f 52 2c 20 22 75 6e 6b 6e 6f 77 6e _ERROR, "unknown
6340: 20 65 6e 63 6f 64 69 6e 67 22 29 3b 0a 20 20 20 encoding");.
6350: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 return SQLITE_E
6360: 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 RROR;. }.. /*
6370: 43 68 65 63 6b 20 69 66 20 74 68 69 73 20 63 61 Check if this ca
6380: 6c 6c 20 69 73 20 72 65 6d 6f 76 69 6e 67 20 6f ll is removing o
6390: 72 20 72 65 70 6c 61 63 69 6e 67 20 61 6e 20 65 r replacing an e
63a0: 78 69 73 74 69 6e 67 20 63 6f 6c 6c 61 74 69 6f xisting collatio
63b0: 6e 20 0a 20 20 2a 2a 20 73 65 71 75 65 6e 63 65 n . ** sequence
63c0: 2e 20 49 66 20 73 6f 2c 20 61 6e 64 20 74 68 65 . If so, and the
63d0: 72 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d re are active VM
63e0: 73 2c 20 72 65 74 75 72 6e 20 62 75 73 79 2e 20 s, return busy.
63f0: 49 66 20 74 68 65 72 65 0a 20 20 2a 2a 20 61 72 If there. ** ar
6400: 65 20 6e 6f 20 61 63 74 69 76 65 20 56 4d 73 2c e no active VMs,
6410: 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 79 20 invalidate any
6420: 70 72 65 2d 63 6f 6d 70 69 6c 65 64 20 73 74 61 pre-compiled sta
6430: 74 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 tements.. */.
6440: 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 pColl = sqlite3F
6450: 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 indCollSeq(db, (
6460: 75 38 29 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 u8)enc2, zName,
6470: 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 30 strlen(zName), 0
6480: 29 3b 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 26 );. if( pColl &
6490: 26 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 7b & pColl->xCmp ){
64a0: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 63 74 . if( db->act
64b0: 69 76 65 56 64 62 65 43 6e 74 20 29 7b 0a 20 20 iveVdbeCnt ){.
64c0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 sqlite3Error
64d0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 (db, SQLITE_BUSY
64e0: 2c 20 0a 20 20 20 20 20 20 20 20 22 55 6e 61 62 , . "Unab
64f0: 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f 64 le to delete/mod
6500: 69 66 79 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 ify collation se
6510: 71 75 65 6e 63 65 20 64 75 65 20 74 6f 20 61 63 quence due to ac
6520: 74 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 tive statements"
6530: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 );. return
6540: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 SQLITE_BUSY;.
6550: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 }. sqlite3Ex
6560: 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 pirePreparedStat
6570: 65 6d 65 6e 74 73 28 64 62 29 3b 0a 0a 20 20 20 ements(db);..
6580: 20 2f 2a 20 49 66 20 63 6f 6c 6c 61 74 69 6f 6e /* If collation
6590: 20 73 65 71 75 65 6e 63 65 20 70 43 6f 6c 6c 20 sequence pColl
65a0: 77 61 73 20 63 72 65 61 74 65 64 20 64 69 72 65 was created dire
65b0: 63 74 6c 79 20 62 79 20 61 20 63 61 6c 6c 20 74 ctly by a call t
65c0: 6f 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 o. ** sqlite3
65d0: 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f _create_collatio
65e0: 6e 2c 20 61 6e 64 20 6e 6f 74 20 67 65 6e 65 72 n, and not gener
65f0: 61 74 65 64 20 62 79 20 73 79 6e 74 68 43 6f 6c ated by synthCol
6600: 6c 53 65 71 28 29 2c 0a 20 20 20 20 2a 2a 20 74 lSeq(),. ** t
6610: 68 65 6e 20 61 6e 79 20 63 6f 70 69 65 73 20 6d hen any copies m
6620: 61 64 65 20 62 79 20 73 79 6e 74 68 43 6f 6c 6c ade by synthColl
6630: 53 65 71 28 29 20 6e 65 65 64 20 74 6f 20 62 65 Seq() need to be
6640: 20 69 6e 76 61 6c 69 64 61 74 65 64 2e 0a 20 20 invalidated..
6650: 20 20 2a 2a 20 41 6c 73 6f 2c 20 63 6f 6c 6c 61 ** Also, colla
6660: 74 69 6f 6e 20 64 65 73 74 72 75 63 74 6f 72 20 tion destructor
6670: 2d 20 43 6f 6c 6c 53 65 71 2e 78 44 65 6c 28 29 - CollSeq.xDel()
6680: 20 2d 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 - function may
6690: 6e 65 65 64 0a 20 20 20 20 2a 2a 20 74 6f 20 62 need. ** to b
66a0: 65 20 63 61 6c 6c 65 64 2e 0a 20 20 20 20 2a 2f e called.. */
66b0: 20 0a 20 20 20 20 69 66 28 20 28 70 43 6f 6c 6c . if( (pColl
66c0: 2d 3e 65 6e 63 20 26 20 7e 53 51 4c 49 54 45 5f ->enc & ~SQLITE_
66d0: 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 29 3d 3d UTF16_ALIGNED)==
66e0: 65 6e 63 32 20 29 7b 0a 20 20 20 20 20 20 43 6f enc2 ){. Co
66f0: 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 20 3d 20 73 llSeq *aColl = s
6700: 71 6c 69 74 65 33 48 61 73 68 46 69 6e 64 28 26 qlite3HashFind(&
6710: 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c 20 7a 4e db->aCollSeq, zN
6720: 61 6d 65 2c 20 73 74 72 6c 65 6e 28 7a 4e 61 6d ame, strlen(zNam
6730: 65 29 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 6a e));. int j
6740: 3b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b ;. for(j=0;
6750: 20 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 j<3; j++){.
6760: 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 20 3d CollSeq *p =
6770: 20 26 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 &aColl[j];.
6780: 20 20 20 20 69 66 28 20 70 2d 3e 65 6e 63 3d 3d if( p->enc==
6790: 70 43 6f 6c 6c 2d 3e 65 6e 63 20 29 7b 0a 20 20 pColl->enc ){.
67a0: 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 78 if( p->x
67b0: 44 65 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 Del ){.
67c0: 20 20 20 70 2d 3e 78 44 65 6c 28 70 2d 3e 70 55 p->xDel(p->pU
67d0: 73 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 ser);.
67e0: 7d 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 78 }. p->x
67f0: 43 6d 70 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 Cmp = 0;.
6800: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
6810: 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 6c 20 3d 20 . }.. pColl =
6820: 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 sqlite3FindCollS
6830: 65 71 28 64 62 2c 20 28 75 38 29 65 6e 63 32 2c eq(db, (u8)enc2,
6840: 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65 6e 28 7a zName, strlen(z
6850: 4e 61 6d 65 29 2c 20 31 29 3b 0a 20 20 69 66 28 Name), 1);. if(
6860: 20 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 70 43 pColl ){. pC
6870: 6f 6c 6c 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d oll->xCmp = xCom
6880: 70 61 72 65 3b 0a 20 20 20 20 70 43 6f 6c 6c 2d pare;. pColl-
6890: 3e 70 55 73 65 72 20 3d 20 70 43 74 78 3b 0a 20 >pUser = pCtx;.
68a0: 20 20 20 70 43 6f 6c 6c 2d 3e 78 44 65 6c 20 3d pColl->xDel =
68b0: 20 78 44 65 6c 3b 0a 20 20 20 20 70 43 6f 6c 6c xDel;. pColl
68c0: 2d 3e 65 6e 63 20 3d 20 65 6e 63 32 20 7c 20 28 ->enc = enc2 | (
68d0: 65 6e 63 20 26 20 53 51 4c 49 54 45 5f 55 54 46 enc & SQLITE_UTF
68e0: 31 36 5f 41 4c 49 47 4e 45 44 29 3b 0a 20 20 7d 16_ALIGNED);. }
68f0: 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 . sqlite3Error(
6900: 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 db, SQLITE_OK, 0
6910: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 );. return SQLI
6920: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a TE_OK;.}.../*.**
6930: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64 6f This routine do
6940: 65 73 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 6f es the work of o
6950: 70 65 6e 69 6e 67 20 61 20 64 61 74 61 62 61 73 pening a databas
6960: 65 20 6f 6e 20 62 65 68 61 6c 66 20 6f 66 0a 2a e on behalf of.*
6970: 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 * sqlite3_open()
6980: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 6f 70 65 and sqlite3_ope
6990: 6e 31 36 28 29 2e 20 54 68 65 20 64 61 74 61 62 n16(). The datab
69a0: 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 22 7a 46 ase filename "zF
69b0: 69 6c 65 6e 61 6d 65 22 20 20 0a 2a 2a 20 69 73 ilename" .** is
69c0: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 2e 0a UTF-8 encoded..
69d0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6f 70 */.static int op
69e0: 65 6e 44 61 74 61 62 61 73 65 28 0a 20 20 63 6f enDatabase(. co
69f0: 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e nst char *zFilen
6a00: 61 6d 65 2c 20 2f 2a 20 44 61 74 61 62 61 73 65 ame, /* Database
6a10: 20 66 69 6c 65 6e 61 6d 65 20 55 54 46 2d 38 20 filename UTF-8
6a20: 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 73 71 6c encoded */. sql
6a30: 69 74 65 33 20 2a 2a 70 70 44 62 20 20 20 20 20 ite3 **ppDb
6a40: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 65 74 75 /* OUT: Retu
6a50: 72 6e 65 64 20 64 61 74 61 62 61 73 65 20 68 61 rned database ha
6a60: 6e 64 6c 65 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c ndle */.){. sql
6a70: 69 74 65 33 20 2a 64 62 3b 0a 20 20 69 6e 74 20 ite3 *db;. int
6a80: 72 63 3b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 rc;. CollSeq *p
6a90: 43 6f 6c 6c 3b 0a 0a 20 20 61 73 73 65 72 74 28 Coll;.. assert(
6aa0: 20 21 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 !sqlite3MallocF
6ab0: 61 69 6c 65 64 28 29 20 29 3b 0a 0a 20 20 2f 2a ailed() );.. /*
6ac0: 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 Allocate the sq
6ad0: 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63 74 lite data struct
6ae0: 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 ure */. db = sq
6af0: 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 liteMalloc( size
6b00: 6f 66 28 73 71 6c 69 74 65 33 29 20 29 3b 0a 20 of(sqlite3) );.
6b10: 20 69 66 28 20 64 62 3d 3d 30 20 29 20 67 6f 74 if( db==0 ) got
6b20: 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 o opendb_out;.
6b30: 64 62 2d 3e 65 72 72 4d 61 73 6b 20 3d 20 30 78 db->errMask = 0x
6b40: 66 66 3b 0a 20 20 64 62 2d 3e 70 72 69 6f 72 4e ff;. db->priorN
6b50: 65 77 52 6f 77 69 64 20 3d 20 30 3b 0a 20 20 64 ewRowid = 0;. d
6b60: 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 b->magic = SQLIT
6b70: 45 5f 4d 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 E_MAGIC_BUSY;.
6b80: 64 62 2d 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 db->nDb = 2;. d
6b90: 62 2d 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 b->aDb = db->aDb
6ba0: 53 74 61 74 69 63 3b 0a 20 20 64 62 2d 3e 61 75 Static;. db->au
6bb0: 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 toCommit = 1;.
6bc0: 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c db->flags |= SQL
6bd0: 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 ITE_ShortColName
6be0: 73 0a 23 69 66 20 53 51 4c 49 54 45 5f 44 45 46 s.#if SQLITE_DEF
6bf0: 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 AULT_FILE_FORMAT
6c00: 3c 34 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 <4.
6c10: 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 4c 65 67 | SQLITE_Leg
6c20: 61 63 79 46 69 6c 65 46 6d 74 0a 23 65 6e 64 69 acyFileFmt.#endi
6c30: 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f f.#ifdef SQLITE_
6c40: 45 4e 41 42 4c 45 5f 4c 4f 41 44 5f 45 58 54 45 ENABLE_LOAD_EXTE
6c50: 4e 53 49 4f 4e 0a 20 20 20 20 20 20 20 20 20 20 NSION.
6c60: 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f | SQLITE_
6c70: 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 0a 23 65 LoadExtension.#e
6c80: 6e 64 69 66 0a 20 20 20 20 20 20 3b 0a 20 20 73 ndif. ;. s
6c90: 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 qlite3HashInit(&
6ca0: 64 62 2d 3e 61 46 75 6e 63 2c 20 53 51 4c 49 54 db->aFunc, SQLIT
6cb0: 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 E_HASH_STRING, 0
6cc0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 );. sqlite3Hash
6cd0: 49 6e 69 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 Init(&db->aCollS
6ce0: 65 71 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f eq, SQLITE_HASH_
6cf0: 53 54 52 49 4e 47 2c 20 30 29 3b 0a 23 69 66 6e STRING, 0);.#ifn
6d00: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
6d10: 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 73 VIRTUALTABLE. s
6d20: 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 qlite3HashInit(&
6d30: 64 62 2d 3e 61 4d 6f 64 75 6c 65 2c 20 53 51 4c db->aModule, SQL
6d40: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c ITE_HASH_STRING,
6d50: 20 30 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 0);.#endif.. /
6d60: 2a 20 41 64 64 20 74 68 65 20 64 65 66 61 75 6c * Add the defaul
6d70: 74 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 t collation sequ
6d80: 65 6e 63 65 20 42 49 4e 41 52 59 2e 20 42 49 4e ence BINARY. BIN
6d90: 41 52 59 20 77 6f 72 6b 73 20 66 6f 72 20 62 6f ARY works for bo
6da0: 74 68 20 55 54 46 2d 38 0a 20 20 2a 2a 20 61 6e th UTF-8. ** an
6db0: 64 20 55 54 46 2d 31 36 2c 20 73 6f 20 61 64 64 d UTF-16, so add
6dc0: 20 61 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 65 a version for e
6dd0: 61 63 68 20 74 6f 20 61 76 6f 69 64 20 61 6e 79 ach to avoid any
6de0: 20 75 6e 6e 65 63 65 73 73 61 72 79 0a 20 20 2a unnecessary. *
6df0: 2a 20 63 6f 6e 76 65 72 73 69 6f 6e 73 2e 20 54 * conversions. T
6e00: 68 65 20 6f 6e 6c 79 20 65 72 72 6f 72 20 74 68 he only error th
6e10: 61 74 20 63 61 6e 20 6f 63 63 75 72 20 68 65 72 at can occur her
6e20: 65 20 69 73 20 61 20 6d 61 6c 6c 6f 63 28 29 20 e is a malloc()
6e30: 66 61 69 6c 75 72 65 2e 0a 20 20 2a 2f 0a 20 20 failure.. */.
6e40: 69 66 28 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 if( createCollat
6e50: 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 ion(db, "BINARY"
6e60: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 , SQLITE_UTF8, 0
6e70: 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 , binCollFunc, 0
6e80: 29 20 7c 7c 0a 20 20 20 20 20 20 63 72 65 61 74 ) ||. creat
6e90: 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 eCollation(db, "
6ea0: 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 5f BINARY", SQLITE_
6eb0: 55 54 46 31 36 42 45 2c 20 30 2c 20 62 69 6e 43 UTF16BE, 0, binC
6ec0: 6f 6c 6c 46 75 6e 63 2c 20 30 29 20 7c 7c 0a 20 ollFunc, 0) ||.
6ed0: 20 20 20 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 createColla
6ee0: 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 tion(db, "BINARY
6ef0: 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c ", SQLITE_UTF16L
6f00: 45 2c 20 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e E, 0, binCollFun
6f10: 63 2c 20 30 29 20 7c 7c 0a 20 20 20 20 20 20 28 c, 0) ||. (
6f20: 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d 20 db->pDfltColl =
6f30: 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 sqlite3FindCollS
6f40: 65 71 28 64 62 2c 20 53 51 4c 49 54 45 5f 55 54 eq(db, SQLITE_UT
6f50: 46 38 2c 20 22 42 49 4e 41 52 59 22 2c 20 36 2c F8, "BINARY", 6,
6f60: 20 30 29 29 3d 3d 30 20 0a 20 20 29 7b 0a 20 20 0))==0 . ){.
6f70: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
6f80: 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20 3MallocFailed()
6f90: 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 );. db->magic
6fa0: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f = SQLITE_MAGIC_
6fb0: 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f 74 6f CLOSED;. goto
6fc0: 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d opendb_out;. }
6fd0: 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64 20 .. /* Also add
6fe0: 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69 6e 73 a UTF-8 case-ins
6ff0: 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 74 69 ensitive collati
7000: 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f 0a on sequence. */.
7010: 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
7020: 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c 20 n(db, "NOCASE",
7030: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 20 SQLITE_UTF8, 0,
7040: 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 nocaseCollatingF
7050: 75 6e 63 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 53 unc, 0);.. /* S
7060: 65 74 20 66 6c 61 67 73 20 6f 6e 20 74 68 65 20 et flags on the
7070: 62 75 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 built-in collati
7080: 6e 67 20 73 65 71 75 65 6e 63 65 73 20 2a 2f 0a ng sequences */.
7090: 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 2d db->pDfltColl-
70a0: 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 43 >type = SQLITE_C
70b0: 4f 4c 4c 5f 42 49 4e 41 52 59 3b 0a 20 20 70 43 OLL_BINARY;. pC
70c0: 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e oll = sqlite3Fin
70d0: 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c dCollSeq(db, SQL
70e0: 49 54 45 5f 55 54 46 38 2c 20 22 4e 4f 43 41 53 ITE_UTF8, "NOCAS
70f0: 45 22 2c 20 36 2c 20 30 29 3b 0a 20 20 69 66 28 E", 6, 0);. if(
7100: 20 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 70 43 pColl ){. pC
7110: 6f 6c 6c 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 oll->type = SQLI
7120: 54 45 5f 43 4f 4c 4c 5f 4e 4f 43 41 53 45 3b 0a TE_COLL_NOCASE;.
7130: 20 20 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 }.. /* Open t
7140: 68 65 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 he backend datab
7150: 61 73 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 ase driver */.
7160: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 rc = sqlite3Btre
7170: 65 46 61 63 74 6f 72 79 28 64 62 2c 20 7a 46 69 eFactory(db, zFi
7180: 6c 65 6e 61 6d 65 2c 20 30 2c 20 53 51 4c 49 54 lename, 0, SQLIT
7190: 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 45 5f E_DEFAULT_CACHE_
71a0: 53 49 5a 45 2c 0a 20 20 20 20 20 20 20 20 20 20 SIZE,.
71b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
71c0: 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 &db->aDb[0].pBt
71d0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
71e0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 ITE_OK ){. sq
71f0: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 lite3Error(db, r
7200: 63 2c 20 30 29 3b 0a 20 20 20 20 64 62 2d 3e 6d c, 0);. db->m
7210: 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 agic = SQLITE_MA
7220: 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 20 20 GIC_CLOSED;.
7230: 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b goto opendb_out;
7240: 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 30 . }. db->aDb[0
7250: 5d 2e 70 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 ].pSchema = sqli
7260: 74 65 33 53 63 68 65 6d 61 47 65 74 28 64 62 2d te3SchemaGet(db-
7270: 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 >aDb[0].pBt);.
7280: 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 db->aDb[1].pSche
7290: 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 ma = sqlite3Sche
72a0: 6d 61 47 65 74 28 30 29 3b 0a 0a 0a 20 20 2f 2a maGet(0);... /*
72b0: 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 61 66 The default saf
72c0: 65 74 79 5f 6c 65 76 65 6c 20 66 6f 72 20 74 68 ety_level for th
72d0: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 e main database
72e0: 69 73 20 27 66 75 6c 6c 27 3b 20 66 6f 72 20 74 is 'full'; for t
72f0: 68 65 20 74 65 6d 70 0a 20 20 2a 2a 20 64 61 74 he temp. ** dat
7300: 61 62 61 73 65 20 69 74 20 69 73 20 27 4e 4f 4e abase it is 'NON
7310: 45 27 2e 20 54 68 69 73 20 6d 61 74 63 68 65 73 E'. This matches
7320: 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 the pager layer
7330: 20 64 65 66 61 75 6c 74 73 2e 20 20 0a 20 20 2a defaults. . *
7340: 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a /. db->aDb[0].z
7350: 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b 0a 20 Name = "main";.
7360: 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 73 61 66 65 db->aDb[0].safe
7370: 74 79 5f 6c 65 76 65 6c 20 3d 20 33 3b 0a 23 69 ty_level = 3;.#i
7380: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
7390: 54 5f 54 45 4d 50 44 42 0a 20 20 64 62 2d 3e 61 T_TEMPDB. db->a
73a0: 44 62 5b 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22 74 Db[1].zName = "t
73b0: 65 6d 70 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b emp";. db->aDb[
73c0: 31 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 1].safety_level
73d0: 3d 20 31 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f = 1;.#endif.. /
73e0: 2a 20 52 65 67 69 73 74 65 72 20 61 6c 6c 20 62 * Register all b
73f0: 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e uilt-in function
7400: 73 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20 61 74 s, but do not at
7410: 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 tempt to read th
7420: 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 e. ** database
7430: 73 63 68 65 6d 61 20 79 65 74 2e 20 54 68 69 73 schema yet. This
7440: 20 69 73 20 64 65 6c 61 79 65 64 20 75 6e 74 69 is delayed unti
7450: 6c 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 l the first time
7460: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 the database.
7470: 2a 2a 20 69 73 20 61 63 63 65 73 73 65 64 2e 0a ** is accessed..
7480: 20 20 2a 2f 0a 20 20 69 66 28 20 21 73 71 6c 69 */. if( !sqli
7490: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 te3MallocFailed(
74a0: 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) ){. sqlite3
74b0: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
74c0: 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c _OK, 0);. sql
74d0: 69 74 65 33 52 65 67 69 73 74 65 72 42 75 69 6c ite3RegisterBuil
74e0: 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 64 62 29 tinFunctions(db)
74f0: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6d 61 67 69 ;. }. db->magi
7500: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 c = SQLITE_MAGIC
7510: 5f 4f 50 45 4e 3b 0a 0a 20 20 2f 2a 20 4c 6f 61 _OPEN;.. /* Loa
7520: 64 20 61 75 74 6f 6d 61 74 69 63 20 65 78 74 65 d automatic exte
7530: 6e 73 69 6f 6e 73 20 2d 20 65 78 74 65 6e 73 69 nsions - extensi
7540: 6f 6e 73 20 74 68 61 74 20 68 61 76 65 20 62 65 ons that have be
7550: 65 6e 20 72 65 67 69 73 74 65 72 65 64 0a 20 20 en registered.
7560: 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c ** using the sql
7570: 69 74 65 33 5f 61 75 74 6f 6d 61 74 69 63 5f 65 ite3_automatic_e
7580: 78 74 65 6e 73 69 6f 6e 28 29 20 41 50 49 2e 0a xtension() API..
7590: 20 20 2a 2f 0a 20 20 28 76 6f 69 64 29 73 71 6c */. (void)sql
75a0: 69 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 74 65 ite3AutoLoadExte
75b0: 6e 73 69 6f 6e 73 28 64 62 29 3b 0a 0a 23 69 66 nsions(db);..#if
75c0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
75d0: 45 5f 46 54 53 31 0a 20 20 7b 0a 20 20 20 20 65 E_FTS1. {. e
75e0: 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 xtern int sqlite
75f0: 33 46 74 73 31 49 6e 69 74 28 73 71 6c 69 74 65 3Fts1Init(sqlite
7600: 33 2a 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 3*);. sqlite3
7610: 46 74 73 31 49 6e 69 74 28 64 62 29 3b 0a 20 20 Fts1Init(db);.
7620: 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 }.#endif..#ifdef
7630: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
7640: 54 53 32 0a 20 20 7b 0a 20 20 20 20 65 78 74 65 TS2. {. exte
7650: 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 46 74 rn int sqlite3Ft
7660: 73 32 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 s2Init(sqlite3*)
7670: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 46 74 73 ;. sqlite3Fts
7680: 32 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 2Init(db);. }.#
7690: 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 endif..#ifdef SQ
76a0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a LITE_ENABLE_ICU.
76b0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 4d 61 if( !sqlite3Ma
76c0: 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20 29 7b 0a llocFailed() ){.
76d0: 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 extern int s
76e0: 71 6c 69 74 65 33 49 63 75 49 6e 69 74 28 73 71 qlite3IcuInit(sq
76f0: 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 73 71 6c lite3*);. sql
7700: 69 74 65 33 49 63 75 49 6e 69 74 28 64 62 29 3b ite3IcuInit(db);
7710: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f . }.#endif.. /
7720: 2a 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 55 * -DSQLITE_DEFAU
7730: 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d LT_LOCKING_MODE=
7740: 31 20 6d 61 6b 65 73 20 45 58 43 4c 55 53 49 56 1 makes EXCLUSIV
7750: 45 20 74 68 65 20 64 65 66 61 75 6c 74 20 6c 6f E the default lo
7760: 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e cking. ** mode.
7770: 20 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 55 -DSQLITE_DEFAU
7780: 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d LT_LOCKING_MODE=
7790: 30 20 6d 61 6b 65 20 4e 4f 52 4d 41 4c 20 74 68 0 make NORMAL th
77a0: 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e e default lockin
77b0: 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 20 44 6f g. ** mode. Do
77c0: 69 6e 67 20 6e 6f 74 68 69 6e 67 20 61 74 20 61 ing nothing at a
77d0: 6c 6c 20 61 6c 73 6f 20 6d 61 6b 65 73 20 4e 4f ll also makes NO
77e0: 52 4d 41 4c 20 74 68 65 20 64 65 66 61 75 6c 74 RMAL the default
77f0: 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 .. */.#ifdef SQ
7800: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 LITE_DEFAULT_LOC
7810: 4b 49 4e 47 5f 4d 4f 44 45 0a 20 20 64 62 2d 3e KING_MODE. db->
7820: 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 20 3d 20 53 dfltLockMode = S
7830: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f QLITE_DEFAULT_LO
7840: 43 4b 49 4e 47 5f 4d 4f 44 45 3b 0a 20 20 73 71 CKING_MODE;. sq
7850: 6c 69 74 65 33 50 61 67 65 72 4c 6f 63 6b 69 6e lite3PagerLockin
7860: 67 4d 6f 64 65 28 73 71 6c 69 74 65 33 42 74 72 gMode(sqlite3Btr
7870: 65 65 50 61 67 65 72 28 64 62 2d 3e 61 44 62 5b eePager(db->aDb[
7880: 30 5d 2e 70 42 74 29 2c 0a 20 20 20 20 20 20 20 0].pBt),.
7890: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
78a0: 20 20 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c SQLITE_DEFAUL
78b0: 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 29 3b T_LOCKING_MODE);
78c0: 0a 23 65 6e 64 69 66 0a 0a 6f 70 65 6e 64 62 5f .#endif..opendb_
78d0: 6f 75 74 3a 0a 20 20 69 66 28 20 53 51 4c 49 54 out:. if( SQLIT
78e0: 45 5f 4e 4f 4d 45 4d 3d 3d 28 72 63 20 3d 20 73 E_NOMEM==(rc = s
78f0: 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 64 qlite3_errcode(d
7900: 62 29 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 b)) ){. sqlit
7910: 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 e3_close(db);.
7920: 20 20 64 62 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 db = 0;. }.
7930: 2a 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 72 65 *ppDb = db;. re
7940: 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 turn sqlite3ApiE
7950: 78 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a 0a 2f xit(0, rc);.}../
7960: 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 *.** Open a new
7970: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e database handle.
7980: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
7990: 6f 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 open(. const ch
79a0: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a ar *zFilename, .
79b0: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 sqlite3 **ppDb
79c0: 20 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 .){. return op
79d0: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 enDatabase(zFile
79e0: 6e 61 6d 65 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a name, ppDb);.}..
79f0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
7a00: 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 MIT_UTF16./*.**
7a10: 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 74 61 62 Open a new datab
7a20: 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 ase handle..*/.i
7a30: 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 nt sqlite3_open1
7a40: 36 28 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 6(. const void
7a50: 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 *zFilename, . s
7a60: 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 0a 29 7b qlite3 **ppDb.){
7a70: 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a . char const *z
7a80: 46 69 6c 65 6e 61 6d 65 38 3b 20 20 20 2f 2a 20 Filename8; /*
7a90: 7a 46 69 6c 65 6e 61 6d 65 20 65 6e 63 6f 64 65 zFilename encode
7aa0: 64 20 69 6e 20 55 54 46 2d 38 20 69 6e 73 74 65 d in UTF-8 inste
7ab0: 61 64 20 6f 66 20 55 54 46 2d 31 36 20 2a 2f 0a ad of UTF-16 */.
7ac0: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
7ad0: 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 5f E_OK;. sqlite3_
7ae0: 76 61 6c 75 65 20 2a 70 56 61 6c 3b 0a 0a 20 20 value *pVal;..
7af0: 61 73 73 65 72 74 28 20 7a 46 69 6c 65 6e 61 6d assert( zFilenam
7b00: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 e );. assert( p
7b10: 70 44 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 3d pDb );. *ppDb =
7b20: 20 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 0;. pVal = sql
7b30: 69 74 65 33 56 61 6c 75 65 4e 65 77 28 29 3b 0a ite3ValueNew();.
7b40: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 sqlite3ValueSe
7b50: 74 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a tStr(pVal, -1, z
7b60: 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 Filename, SQLITE
7b70: 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 _UTF16NATIVE, SQ
7b80: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 LITE_STATIC);.
7b90: 7a 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c zFilename8 = sql
7ba0: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 ite3ValueText(pV
7bb0: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 al, SQLITE_UTF8)
7bc0: 3b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d ;. if( zFilenam
7bd0: 65 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f e8 ){. rc = o
7be0: 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c penDatabase(zFil
7bf0: 65 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b 0a 20 ename8, ppDb);.
7c00: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
7c10: 45 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20 29 7b E_OK && *ppDb ){
7c20: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
7c30: 74 65 33 5f 65 78 65 63 28 2a 70 70 44 62 2c 20 te3_exec(*ppDb,
7c40: 22 50 52 41 47 4d 41 20 65 6e 63 6f 64 69 6e 67 "PRAGMA encoding
7c50: 20 3d 20 27 55 54 46 2d 31 36 27 22 2c 20 30 2c = 'UTF-16'", 0,
7c60: 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 0, 0);. if
7c70: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
7c80: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 ){. sqlit
7c90: 65 33 5f 63 6c 6f 73 65 28 2a 70 70 44 62 29 3b e3_close(*ppDb);
7ca0: 0a 20 20 20 20 20 20 20 20 2a 70 70 44 62 20 3d . *ppDb =
7cb0: 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 0;. }.
7cc0: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 }. }. sqlite3V
7cd0: 61 6c 75 65 46 72 65 65 28 70 56 61 6c 29 3b 0a alueFree(pVal);.
7ce0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
7cf0: 33 41 70 69 45 78 69 74 28 30 2c 20 72 63 29 3b 3ApiExit(0, rc);
7d00: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
7d10: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a ITE_OMIT_UTF16 *
7d20: 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c /../*.** The fol
7d30: 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 20 64 lowing routine d
7d40: 65 73 74 72 6f 79 73 20 61 20 76 69 72 74 75 61 estroys a virtua
7d50: 6c 20 6d 61 63 68 69 6e 65 20 74 68 61 74 20 69 l machine that i
7d60: 73 20 63 72 65 61 74 65 64 20 62 79 0a 2a 2a 20 s created by.**
7d70: 74 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70 the sqlite3_comp
7d80: 69 6c 65 28 29 20 72 6f 75 74 69 6e 65 2e 20 54 ile() routine. T
7d90: 68 65 20 69 6e 74 65 67 65 72 20 72 65 74 75 72 he integer retur
7da0: 6e 65 64 20 69 73 20 61 6e 20 53 51 4c 49 54 45 ned is an SQLITE
7db0: 5f 0a 2a 2a 20 73 75 63 63 65 73 73 2f 66 61 69 _.** success/fai
7dc0: 6c 75 72 65 20 63 6f 64 65 20 74 68 61 74 20 64 lure code that d
7dd0: 65 73 63 72 69 62 65 73 20 74 68 65 20 72 65 73 escribes the res
7de0: 75 6c 74 20 6f 66 20 65 78 65 63 75 74 69 6e 67 ult of executing
7df0: 20 74 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20 the virtual.**
7e00: 6d 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 machine..**.** T
7e10: 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 his routine sets
7e20: 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 the error code
7e30: 61 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 72 and string retur
7e40: 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 ned by.** sqlite
7e50: 33 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 6c 3_errcode(), sql
7e60: 69 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e ite3_errmsg() an
7e70: 64 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 d sqlite3_errmsg
7e80: 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 16()..*/.int sql
7e90: 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 73 71 ite3_finalize(sq
7ea0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d lite3_stmt *pStm
7eb0: 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 t){. int rc;.
7ec0: 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a if( pStmt==0 ){.
7ed0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
7ee0: 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 OK;. }else{.
7ef0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 rc = sqlite3Vdb
7f00: 65 46 69 6e 61 6c 69 7a 65 28 28 56 64 62 65 2a eFinalize((Vdbe*
7f10: 29 70 53 74 6d 74 29 3b 0a 20 20 7d 0a 20 20 72 )pStmt);. }. r
7f20: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
7f30: 2a 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68 65 ** Terminate the
7f40: 20 63 75 72 72 65 6e 74 20 65 78 65 63 75 74 69 current executi
7f50: 6f 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 74 61 on of an SQL sta
7f60: 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 65 74 tement and reset
7f70: 20 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 69 it.** back to i
7f80: 74 73 20 73 74 61 72 74 69 6e 67 20 73 74 61 74 ts starting stat
7f90: 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e e so that it can
7fa0: 20 62 65 20 72 65 75 73 65 64 2e 20 41 20 73 75 be reused. A su
7fb0: 63 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d 0a ccess code from.
7fc0: 2a 2a 20 74 68 65 20 70 72 69 6f 72 20 65 78 65 ** the prior exe
7fd0: 63 75 74 69 6f 6e 20 69 73 20 72 65 74 75 72 6e cution is return
7fe0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ed..**.** This r
7ff0: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 outine sets the
8000: 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 error code and s
8010: 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62 tring returned b
8020: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 y.** sqlite3_err
8030: 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f code(), sqlite3_
8040: 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c errmsg() and sql
8050: 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e ite3_errmsg16().
8060: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
8070: 72 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73 74 reset(sqlite3_st
8080: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e mt *pStmt){. in
8090: 74 20 72 63 3b 0a 20 20 69 66 28 20 70 53 74 6d t rc;. if( pStm
80a0: 74 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d t==0 ){. rc =
80b0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
80c0: 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 lse{. rc = sq
80d0: 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28 28 lite3VdbeReset((
80e0: 56 64 62 65 2a 29 70 53 74 6d 74 29 3b 0a 20 20 Vdbe*)pStmt);.
80f0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b sqlite3VdbeMak
8100: 65 52 65 61 64 79 28 28 56 64 62 65 2a 29 70 53 eReady((Vdbe*)pS
8110: 74 6d 74 2c 20 2d 31 2c 20 30 2c 20 30 2c 20 30 tmt, -1, 0, 0, 0
8120: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 );. assert( (
8130: 72 63 20 26 20 28 73 71 6c 69 74 65 33 5f 64 62 rc & (sqlite3_db
8140: 5f 68 61 6e 64 6c 65 28 70 53 74 6d 74 29 2d 3e _handle(pStmt)->
8150: 65 72 72 4d 61 73 6b 29 29 3d 3d 72 63 20 29 3b errMask))==rc );
8160: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
8170: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 ;.}../*.** Regis
8180: 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 ter a new collat
8190: 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 ion sequence wit
81a0: 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 h the database h
81b0: 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 andle db..*/.int
81c0: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f sqlite3_create_
81d0: 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c collation(. sql
81e0: 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e ite3* db, . con
81f0: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 st char *zName,
8200: 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 . int enc, . v
8210: 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 oid* pCtx,. int
8220: 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 (*xCompare)(void
8230: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
8240: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
8250: 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a *).){. int rc;.
8260: 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 74 assert( !sqlit
8270: 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 e3MallocFailed()
8280: 20 29 3b 0a 20 20 72 63 20 3d 20 63 72 65 61 74 );. rc = creat
8290: 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a eCollation(db, z
82a0: 4e 61 6d 65 2c 20 65 6e 63 2c 20 70 43 74 78 2c Name, enc, pCtx,
82b0: 20 78 43 6f 6d 70 61 72 65 2c 20 30 29 3b 0a 20 xCompare, 0);.
82c0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 return sqlite3A
82d0: 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
82e0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 }../*.** Registe
82f0: 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f r a new collatio
8300: 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 n sequence with
8310: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e the database han
8320: 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 dle db..*/.int s
8330: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f qlite3_create_co
8340: 6c 6c 61 74 69 6f 6e 5f 76 32 28 0a 20 20 73 71 llation_v2(. sq
8350: 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f lite3* db, . co
8360: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c nst char *zName,
8370: 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 . int enc, .
8380: 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e void* pCtx,. in
8390: 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 t(*xCompare)(voi
83a0: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 d*,int,const voi
83b0: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 d*,int,const voi
83c0: 64 2a 29 2c 0a 20 20 76 6f 69 64 28 2a 78 44 65 d*),. void(*xDe
83d0: 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 l)(void*).){. i
83e0: 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 74 28 nt rc;. assert(
83f0: 20 21 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 !sqlite3MallocF
8400: 61 69 6c 65 64 28 29 20 29 3b 0a 20 20 72 63 20 ailed() );. rc
8410: 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f = createCollatio
8420: 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 65 6e 63 n(db, zName, enc
8430: 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 , pCtx, xCompare
8440: 2c 20 78 44 65 6c 29 3b 0a 20 20 72 65 74 75 72 , xDel);. retur
8450: 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 n sqlite3ApiExit
8460: 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 0a 23 69 66 (db, rc);.}..#if
8470: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
8480: 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67 _UTF16./*.** Reg
8490: 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c ister a new coll
84a0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 ation sequence w
84b0: 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 ith the database
84c0: 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 handle db..*/.i
84d0: 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 nt sqlite3_creat
84e0: 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31 36 28 0a 20 e_collation16(.
84f0: 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 sqlite3* db, .
8500: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
8510: 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 me, . int enc,
8520: 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 . void* pCtx,.
8530: 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 int(*xCompare)(
8540: 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
8550: 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
8560: 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 void*).){. int
8570: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
8580: 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 38 3b 20 char *zName8;
8590: 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 . assert( !sqli
85a0: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 te3MallocFailed(
85b0: 29 20 29 3b 0a 20 20 7a 4e 61 6d 65 38 20 3d 20 ) );. zName8 =
85c0: 73 71 6c 69 74 65 33 75 74 66 31 36 74 6f 38 28 sqlite3utf16to8(
85d0: 7a 4e 61 6d 65 2c 20 2d 31 29 3b 0a 20 20 69 66 zName, -1);. if
85e0: 28 20 7a 4e 61 6d 65 38 20 29 7b 0a 20 20 20 20 ( zName8 ){.
85f0: 72 63 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 rc = createColla
8600: 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 38 2c tion(db, zName8,
8610: 20 65 6e 63 2c 20 70 43 74 78 2c 20 78 43 6f 6d enc, pCtx, xCom
8620: 70 61 72 65 2c 20 30 29 3b 0a 20 20 20 20 73 71 pare, 0);. sq
8630: 6c 69 74 65 46 72 65 65 28 7a 4e 61 6d 65 38 29 liteFree(zName8)
8640: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 73 ;. }. return s
8650: 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 qlite3ApiExit(db
8660: 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 , rc);.}.#endif
8670: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 /* SQLITE_OMIT_U
8680: 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 TF16 */../*.** R
8690: 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 egister a collat
86a0: 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 ion sequence fac
86b0: 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 tory callback wi
86c0: 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 th the database
86d0: 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 handle.** db. Re
86e0: 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 69 6f place any previo
86f0: 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 usly installed c
8700: 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
8710: 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e e factory..*/.in
8720: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 t sqlite3_collat
8730: 69 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 20 73 71 ion_needed(. sq
8740: 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f lite3 *db, . vo
8750: 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 id *pCollNeededA
8760: 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f rg, . void(*xCo
8770: 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 2a 2c llNeeded)(void*,
8780: 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 sqlite3*,int eTe
8790: 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 61 72 xtRep,const char
87a0: 2a 29 0a 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 *).){. if( sqli
87b0: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 te3SafetyCheck(d
87c0: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e b) ){. return
87d0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a SQLITE_MISUSE;.
87e0: 20 20 7d 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e }. db->xCollN
87f0: 65 65 64 65 64 20 3d 20 78 43 6f 6c 6c 4e 65 65 eeded = xCollNee
8800: 64 65 64 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c ded;. db->xColl
8810: 4e 65 65 64 65 64 31 36 20 3d 20 30 3b 0a 20 20 Needed16 = 0;.
8820: 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 db->pCollNeededA
8830: 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 rg = pCollNeeded
8840: 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 Arg;. return SQ
8850: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e LITE_OK;.}..#ifn
8860: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
8870: 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67 69 UTF16./*.** Regi
8880: 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f 6e ster a collation
8890: 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 sequence factor
88a0: 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 20 y callback with
88b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e the database han
88c0: 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c 61 dle.** db. Repla
88d0: 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c ce any previousl
88e0: 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c 6c y installed coll
88f0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 ation sequence f
8900: 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 actory..*/.int s
8910: 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e qlite3_collation
8920: 5f 6e 65 65 64 65 64 31 36 28 0a 20 20 73 71 6c _needed16(. sql
8930: 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69 ite3 *db, . voi
8940: 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 d *pCollNeededAr
8950: 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c g, . void(*xCol
8960: 6c 4e 65 65 64 65 64 31 36 29 28 76 6f 69 64 2a lNeeded16)(void*
8970: 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 ,sqlite3*,int eT
8980: 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 76 6f 69 extRep,const voi
8990: 64 2a 29 0a 29 7b 0a 20 20 69 66 28 20 73 71 6c d*).){. if( sql
89a0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 ite3SafetyCheck(
89b0: 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 db) ){. retur
89c0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b n SQLITE_MISUSE;
89d0: 0a 20 20 7d 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c . }. db->xColl
89e0: 4e 65 65 64 65 64 20 3d 20 30 3b 0a 20 20 64 62 Needed = 0;. db
89f0: 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 ->xCollNeeded16
8a00: 3d 20 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 3b = xCollNeeded16;
8a10: 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 . db->pCollNeed
8a20: 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 edArg = pCollNee
8a30: 64 65 64 41 72 67 3b 0a 20 20 72 65 74 75 72 6e dedArg;. return
8a40: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 SQLITE_OK;.}.#e
8a50: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
8a60: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 MIT_UTF16 */..#i
8a70: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
8a80: 54 5f 47 4c 4f 42 41 4c 52 45 43 4f 56 45 52 0a T_GLOBALRECOVER.
8a90: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
8aa0: 69 6f 6e 20 69 73 20 6e 6f 77 20 61 6e 20 61 6e ion is now an an
8ab0: 61 63 68 72 6f 6e 69 73 6d 2e 20 49 74 20 75 73 achronism. It us
8ac0: 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f ed to be used to
8ad0: 20 72 65 63 6f 76 65 72 20 66 72 6f 6d 20 61 0a recover from a.
8ae0: 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c ** malloc() fail
8af0: 75 72 65 2c 20 62 75 74 20 53 51 4c 69 74 65 20 ure, but SQLite
8b00: 6e 6f 77 20 64 6f 65 73 20 74 68 69 73 20 61 75 now does this au
8b10: 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 2a 2f 0a tomatically..*/.
8b20: 69 6e 74 20 73 71 6c 69 74 65 33 5f 67 6c 6f 62 int sqlite3_glob
8b30: 61 6c 5f 72 65 63 6f 76 65 72 28 29 7b 0a 20 20 al_recover(){.
8b40: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
8b50: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a ;.}.#endif../*.*
8b60: 2a 20 54 65 73 74 20 74 6f 20 73 65 65 20 77 68 * Test to see wh
8b70: 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 ether or not the
8b80: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
8b90: 74 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 6f 63 tion is in autoc
8ba0: 6f 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e 20 20 ommit.** mode.
8bb0: 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 69 Return TRUE if i
8bc0: 74 20 69 73 20 61 6e 64 20 46 41 4c 53 45 20 69 t is and FALSE i
8bd0: 66 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f 6d 6d f not. Autocomm
8be0: 69 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a 2a 2a it mode is on.**
8bf0: 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41 75 by default. Au
8c00: 74 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 73 61 tocommit is disa
8c10: 62 6c 65 64 20 62 79 20 61 20 42 45 47 49 4e 20 bled by a BEGIN
8c20: 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 statement and re
8c30: 65 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 74 68 enabled.** by th
8c40: 65 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 6f 72 e next COMMIT or
8c50: 20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2a 0a 2a 2a ROLLBACK..**.**
8c60: 2a 2a 2a 2a 2a 20 54 48 49 53 20 49 53 20 41 4e ***** THIS IS AN
8c70: 20 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 41 50 EXPERIMENTAL AP
8c80: 49 20 41 4e 44 20 49 53 20 53 55 42 4a 45 43 54 I AND IS SUBJECT
8c90: 20 54 4f 20 43 48 41 4e 47 45 20 2a 2a 2a 2a 2a TO CHANGE *****
8ca0: 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 *.*/.int sqlite3
8cb0: 5f 67 65 74 5f 61 75 74 6f 63 6f 6d 6d 69 74 28 _get_autocommit(
8cc0: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 sqlite3 *db){.
8cd0: 72 65 74 75 72 6e 20 64 62 2d 3e 61 75 74 6f 43 return db->autoC
8ce0: 6f 6d 6d 69 74 3b 0a 7d 0a 0a 23 69 66 64 65 66 ommit;.}..#ifdef
8cf0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a SQLITE_DEBUG./*
8d00: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
8d10: 67 20 72 6f 75 74 69 6e 65 20 69 73 20 73 75 62 g routine is sub
8d20: 74 69 74 75 74 65 64 20 66 6f 72 20 63 6f 6e 73 tituted for cons
8d30: 74 61 6e 74 20 53 51 4c 49 54 45 5f 43 4f 52 52 tant SQLITE_CORR
8d40: 55 50 54 20 69 6e 0a 2a 2a 20 64 65 62 75 67 67 UPT in.** debugg
8d50: 69 6e 67 20 62 75 69 6c 64 73 2e 20 20 54 68 69 ing builds. Thi
8d60: 73 20 70 72 6f 76 69 64 65 73 20 61 20 77 61 79 s provides a way
8d70: 20 74 6f 20 73 65 74 20 61 20 62 72 65 61 6b 70 to set a breakp
8d80: 6f 69 6e 74 20 66 6f 72 20 77 68 65 6e 0a 2a 2a oint for when.**
8d90: 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 73 20 66 corruption is f
8da0: 69 72 73 74 20 64 65 74 65 63 74 65 64 2e 0a 2a irst detected..*
8db0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 72 /.int sqlite3Cor
8dc0: 72 75 70 74 28 76 6f 69 64 29 7b 0a 20 20 72 65 rupt(void){. re
8dd0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
8de0: 55 50 54 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a UPT;.}.#endif...
8df0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
8e00: 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
8e10: 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 ./*.** Enable or
8e20: 20 64 69 73 61 62 6c 65 20 74 68 65 20 73 68 61 disable the sha
8e30: 72 65 64 20 70 61 67 65 72 20 61 6e 64 20 73 63 red pager and sc
8e40: 68 65 6d 61 20 66 65 61 74 75 72 65 73 20 66 6f hema features fo
8e50: 72 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 r the.** current
8e60: 20 74 68 72 65 61 64 2e 0a 2a 2a 0a 2a 2a 20 54 thread..**.** T
8e70: 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 6f 75 his routine shou
8e80: 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 ld only be calle
8e90: 64 20 77 68 65 6e 20 74 68 65 72 65 20 61 72 65 d when there are
8ea0: 20 6e 6f 20 6f 70 65 6e 0a 2a 2a 20 64 61 74 61 no open.** data
8eb0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 base connections
8ec0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
8ed0: 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63 _enable_shared_c
8ee0: 61 63 68 65 28 69 6e 74 20 65 6e 61 62 6c 65 29 ache(int enable)
8ef0: 7b 0a 20 20 54 68 72 65 61 64 44 61 74 61 20 2a {. ThreadData *
8f00: 70 54 64 20 3d 20 73 71 6c 69 74 65 33 54 68 72 pTd = sqlite3Thr
8f10: 65 61 64 44 61 74 61 28 29 3b 0a 20 20 69 66 28 eadData();. if(
8f20: 20 70 54 64 20 29 7b 0a 20 20 20 20 2f 2a 20 49 pTd ){. /* I
8f30: 74 20 69 73 20 6f 6e 6c 79 20 6c 65 67 61 6c 20 t is only legal
8f40: 74 6f 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f to call sqlite3_
8f50: 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63 61 enable_shared_ca
8f60: 63 68 65 28 29 20 77 68 65 6e 20 74 68 65 72 65 che() when there
8f70: 0a 20 20 20 20 2a 2a 20 61 72 65 20 6e 6f 20 63 . ** are no c
8f80: 75 72 72 65 6e 74 6c 79 20 6f 70 65 6e 20 62 2d urrently open b-
8f90: 74 72 65 65 73 20 74 68 61 74 20 77 65 72 65 20 trees that were
8fa0: 6f 70 65 6e 65 64 20 62 79 20 74 68 65 20 63 61 opened by the ca
8fb0: 6c 6c 69 6e 67 20 74 68 72 65 61 64 2e 0a 20 20 lling thread..
8fc0: 20 20 2a 2a 20 54 68 69 73 20 63 6f 6e 64 69 74 ** This condit
8fd0: 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 65 61 73 79 ion is only easy
8fe0: 20 74 6f 20 64 65 74 65 63 74 20 69 66 20 74 68 to detect if th
8ff0: 65 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 77 e shared-cache w
9000: 65 72 65 20 0a 20 20 20 20 2a 2a 20 70 72 65 76 ere . ** prev
9010: 69 6f 75 73 6c 79 20 65 6e 61 62 6c 65 64 20 28 iously enabled (
9020: 61 6e 64 20 69 73 20 62 65 69 6e 67 20 64 69 73 and is being dis
9030: 61 62 6c 65 64 29 2e 20 0a 20 20 20 20 2a 2f 0a abled). . */.
9040: 20 20 20 20 69 66 28 20 70 54 64 2d 3e 70 42 74 if( pTd->pBt
9050: 72 65 65 20 26 26 20 21 65 6e 61 62 6c 65 20 29 ree && !enable )
9060: 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
9070: 70 54 64 2d 3e 75 73 65 53 68 61 72 65 64 44 61 pTd->useSharedDa
9080: 74 61 20 29 3b 0a 20 20 20 20 20 20 72 65 74 75 ta );. retu
9090: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
90a0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 54 64 ;. }.. pTd
90b0: 2d 3e 75 73 65 53 68 61 72 65 64 44 61 74 61 20 ->useSharedData
90c0: 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 20 20 73 71 = enable;. sq
90d0: 6c 69 74 65 33 52 65 6c 65 61 73 65 54 68 72 65 lite3ReleaseThre
90e0: 61 64 44 61 74 61 28 29 3b 0a 20 20 7d 0a 20 20 adData();. }.
90f0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 return sqlite3Ap
9100: 69 45 78 69 74 28 30 2c 20 53 51 4c 49 54 45 5f iExit(0, SQLITE_
9110: 4f 4b 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f OK);.}.#endif../
9120: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 *.** This is a c
9130: 6f 6e 76 65 6e 69 65 6e 63 65 20 72 6f 75 74 69 onvenience routi
9140: 6e 65 20 74 68 61 74 20 6d 61 6b 65 73 20 73 75 ne that makes su
9150: 72 65 20 74 68 61 74 20 61 6c 6c 20 74 68 72 65 re that all thre
9160: 61 64 2d 73 70 65 63 69 66 69 63 0a 2a 2a 20 64 ad-specific.** d
9170: 61 74 61 20 66 6f 72 20 74 68 69 73 20 74 68 72 ata for this thr
9180: 65 61 64 20 68 61 73 20 62 65 65 6e 20 64 65 61 ead has been dea
9190: 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f 0a 76 6f 69 llocated..*/.voi
91a0: 64 20 73 71 6c 69 74 65 33 5f 74 68 72 65 61 64 d sqlite3_thread
91b0: 5f 63 6c 65 61 6e 75 70 28 76 6f 69 64 29 7b 0a _cleanup(void){.
91c0: 20 20 54 68 72 65 61 64 44 61 74 61 20 2a 70 54 ThreadData *pT
91d0: 64 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 68 72 d = sqlite3OsThr
91e0: 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61 28 eadSpecificData(
91f0: 30 29 3b 0a 20 20 69 66 28 20 70 54 64 20 29 7b 0);. if( pTd ){
9200: 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 54 64 2c . memset(pTd,
9210: 20 30 2c 20 73 69 7a 65 6f 66 28 2a 70 54 64 29 0, sizeof(*pTd)
9220: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 );. sqlite3Os
9230: 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 61 ThreadSpecificDa
9240: 74 61 28 2d 31 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f ta(-1);. }.}../
9250: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 6d 65 74 61 *.** Return meta
9260: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f information abo
9270: 75 74 20 61 20 73 70 65 63 69 66 69 63 20 63 6f ut a specific co
9280: 6c 75 6d 6e 20 6f 66 20 61 20 64 61 74 61 62 61 lumn of a databa
9290: 73 65 20 74 61 62 6c 65 2e 0a 2a 2a 20 53 65 65 se table..** See
92a0: 20 63 6f 6d 6d 65 6e 74 20 69 6e 20 73 71 6c 69 comment in sqli
92b0: 74 65 33 2e 68 20 28 73 71 6c 69 74 65 2e 68 2e te3.h (sqlite.h.
92c0: 69 6e 29 20 66 6f 72 20 64 65 74 61 69 6c 73 2e in) for details.
92d0: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
92e0: 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f E_ENABLE_COLUMN_
92f0: 4d 45 54 41 44 41 54 41 0a 69 6e 74 20 73 71 6c METADATA.int sql
9300: 69 74 65 33 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d ite3_table_colum
9310: 6e 5f 6d 65 74 61 64 61 74 61 28 0a 20 20 73 71 n_metadata(. sq
9320: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
9330: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e /* Con
9340: 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 2a nection handle *
9350: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
9360: 7a 44 62 4e 61 6d 65 2c 20 20 20 20 20 20 20 20 zDbName,
9370: 2f 2a 20 44 61 74 61 62 61 73 65 20 6e 61 6d 65 /* Database name
9380: 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63 6f or NULL */. co
9390: 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62 6c 65 nst char *zTable
93a0: 4e 61 6d 65 2c 20 20 20 20 20 2f 2a 20 54 61 62 Name, /* Tab
93b0: 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 6f 6e le name */. con
93c0: 73 74 20 63 68 61 72 20 2a 7a 43 6f 6c 75 6d 6e st char *zColumn
93d0: 4e 61 6d 65 2c 20 20 20 20 2f 2a 20 43 6f 6c 75 Name, /* Colu
93e0: 6d 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 68 61 mn name */. cha
93f0: 72 20 63 6f 6e 73 74 20 2a 2a 70 7a 44 61 74 61 r const **pzData
9400: 54 79 70 65 2c 20 20 20 20 2f 2a 20 4f 55 54 50 Type, /* OUTP
9410: 55 54 3a 20 44 65 63 6c 61 72 65 64 20 64 61 74 UT: Declared dat
9420: 61 20 74 79 70 65 20 2a 2f 0a 20 20 63 68 61 72 a type */. char
9430: 20 63 6f 6e 73 74 20 2a 2a 70 7a 43 6f 6c 6c 53 const **pzCollS
9440: 65 71 2c 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 eq, /* OUTPU
9450: 54 3a 20 43 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 T: Collation seq
9460: 75 65 6e 63 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 uence name */.
9470: 69 6e 74 20 2a 70 4e 6f 74 4e 75 6c 6c 2c 20 20 int *pNotNull,
9480: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
9490: 55 54 50 55 54 3a 20 54 72 75 65 20 69 66 20 4e UTPUT: True if N
94a0: 4f 54 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 OT NULL constrai
94b0: 6e 74 20 65 78 69 73 74 73 20 2a 2f 0a 20 20 69 nt exists */. i
94c0: 6e 74 20 2a 70 50 72 69 6d 61 72 79 4b 65 79 2c nt *pPrimaryKey,
94d0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
94e0: 54 50 55 54 3a 20 54 72 75 65 20 69 66 20 63 6f TPUT: True if co
94f0: 6c 75 6d 6e 20 70 61 72 74 20 6f 66 20 50 4b 20 lumn part of PK
9500: 2a 2f 0a 20 20 69 6e 74 20 2a 70 41 75 74 6f 69 */. int *pAutoi
9510: 6e 63 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nc
9520: 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 /* OUTPUT: True
9530: 20 69 66 20 63 6f 6c 75 6d 73 20 69 73 20 61 75 if colums is au
9540: 74 6f 2d 69 6e 63 72 65 6d 65 6e 74 20 2a 2f 0a to-increment */.
9550: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 ){. int rc;. c
9560: 68 61 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 har *zErrMsg = 0
9570: 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 20 ;. Table *pTab
9580: 3d 20 30 3b 0a 20 20 43 6f 6c 75 6d 6e 20 2a 70 = 0;. Column *p
9590: 43 6f 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 69 Col = 0;. int i
95a0: 43 6f 6c 3b 0a 0a 20 20 63 68 61 72 20 63 6f 6e Col;.. char con
95b0: 73 74 20 2a 7a 44 61 74 61 54 79 70 65 20 3d 20 st *zDataType =
95c0: 30 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 0;. char const
95d0: 2a 7a 43 6f 6c 6c 53 65 71 20 3d 20 30 3b 0a 20 *zCollSeq = 0;.
95e0: 20 69 6e 74 20 6e 6f 74 6e 75 6c 6c 20 3d 20 30 int notnull = 0
95f0: 3b 0a 20 20 69 6e 74 20 70 72 69 6d 61 72 79 6b ;. int primaryk
9600: 65 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 61 75 ey = 0;. int au
9610: 74 6f 69 6e 63 20 3d 20 30 3b 0a 0a 20 20 2f 2a toinc = 0;.. /*
9620: 20 45 6e 73 75 72 65 20 74 68 65 20 64 61 74 61 Ensure the data
9630: 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 base schema has
9640: 62 65 65 6e 20 6c 6f 61 64 65 64 20 2a 2f 0a 20 been loaded */.
9650: 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 if( sqlite3Safe
9660: 74 79 4f 6e 28 64 62 29 20 29 7b 0a 20 20 20 20 tyOn(db) ){.
9670: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
9680: 53 55 53 45 3b 0a 20 20 7d 0a 20 20 72 63 20 3d SUSE;. }. rc =
9690: 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64 62 2c sqlite3Init(db,
96a0: 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 &zErrMsg);. if
96b0: 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 ( SQLITE_OK!=rc
96c0: 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f ){. goto erro
96d0: 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a r_out;. }.. /*
96e0: 20 4c 6f 63 61 74 65 20 74 68 65 20 74 61 62 6c Locate the tabl
96f0: 65 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 2a 2f e in question */
9700: 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65 . pTab = sqlite
9710: 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a 3FindTable(db, z
9720: 54 61 62 6c 65 4e 61 6d 65 2c 20 7a 44 62 4e 61 TableName, zDbNa
9730: 6d 65 29 3b 0a 20 20 69 66 28 20 21 70 54 61 62 me);. if( !pTab
9740: 20 7c 7c 20 70 54 61 62 2d 3e 70 53 65 6c 65 63 || pTab->pSelec
9750: 74 20 29 7b 0a 20 20 20 20 70 54 61 62 20 3d 20 t ){. pTab =
9760: 30 3b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 0;. goto erro
9770: 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a r_out;. }.. /*
9780: 20 46 69 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e Find the column
9790: 20 66 6f 72 20 77 68 69 63 68 20 69 6e 66 6f 20 for which info
97a0: 69 73 20 72 65 71 75 65 73 74 65 64 20 2a 2f 0a is requested */.
97b0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 73 52 if( sqlite3IsR
97c0: 6f 77 69 64 28 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 owid(zColumnName
97d0: 29 20 29 7b 0a 20 20 20 20 69 43 6f 6c 20 3d 20 ) ){. iCol =
97e0: 70 54 61 62 2d 3e 69 50 4b 65 79 3b 0a 20 20 20 pTab->iPKey;.
97f0: 20 69 66 28 20 69 43 6f 6c 3e 3d 30 20 29 7b 0a if( iCol>=0 ){.
9800: 20 20 20 20 20 20 70 43 6f 6c 20 3d 20 26 70 54 pCol = &pT
9810: 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b 0a ab->aCol[iCol];.
9820: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
9830: 20 20 20 66 6f 72 28 69 43 6f 6c 3d 30 3b 20 69 for(iCol=0; i
9840: 43 6f 6c 3c 70 54 61 62 2d 3e 6e 43 6f 6c 3b 20 Col<pTab->nCol;
9850: 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 20 70 iCol++){. p
9860: 43 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43 6f Col = &pTab->aCo
9870: 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 20 20 20 20 69 l[iCol];. i
9880: 66 28 20 30 3d 3d 73 71 6c 69 74 65 33 53 74 72 f( 0==sqlite3Str
9890: 49 43 6d 70 28 70 43 6f 6c 2d 3e 7a 4e 61 6d 65 ICmp(pCol->zName
98a0: 2c 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 29 , zColumnName) )
98b0: 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b {. break;
98c0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
98d0: 20 20 20 69 66 28 20 69 43 6f 6c 3d 3d 70 54 61 if( iCol==pTa
98e0: 62 2d 3e 6e 43 6f 6c 20 29 7b 0a 20 20 20 20 20 b->nCol ){.
98f0: 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 20 pTab = 0;.
9900: 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b goto error_out;
9910: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
9920: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 The following b
9930: 6c 6f 63 6b 20 73 74 6f 72 65 73 20 74 68 65 20 lock stores the
9940: 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e meta information
9950: 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72 65 that will be re
9960: 74 75 72 6e 65 64 0a 20 20 2a 2a 20 74 6f 20 74 turned. ** to t
9970: 68 65 20 63 61 6c 6c 65 72 20 69 6e 20 6c 6f 63 he caller in loc
9980: 61 6c 20 76 61 72 69 61 62 6c 65 73 20 7a 44 61 al variables zDa
9990: 74 61 54 79 70 65 2c 20 7a 43 6f 6c 6c 53 65 71 taType, zCollSeq
99a0: 2c 20 6e 6f 74 6e 75 6c 6c 2c 20 70 72 69 6d 61 , notnull, prima
99b0: 72 79 6b 65 79 0a 20 20 2a 2a 20 61 6e 64 20 61 rykey. ** and a
99c0: 75 74 6f 69 6e 63 2e 20 41 74 20 74 68 69 73 20 utoinc. At this
99d0: 70 6f 69 6e 74 20 74 68 65 72 65 20 61 72 65 20 point there are
99e0: 74 77 6f 20 70 6f 73 73 69 62 69 6c 69 74 69 65 two possibilitie
99f0: 73 3a 0a 20 20 2a 2a 20 0a 20 20 2a 2a 20 20 20 s:. ** . **
9a00: 20 20 31 2e 20 54 68 65 20 73 70 65 63 69 66 69 1. The specifi
9a10: 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 77 ed column name w
9a20: 61 73 20 72 6f 77 69 64 22 2c 20 22 6f 69 64 22 as rowid", "oid"
9a30: 20 6f 72 20 22 5f 72 6f 77 69 64 5f 22 20 0a 20 or "_rowid_" .
9a40: 20 2a 2a 20 20 20 20 20 20 20 20 61 6e 64 20 74 ** and t
9a50: 68 65 72 65 20 69 73 20 6e 6f 20 65 78 70 6c 69 here is no expli
9a60: 63 69 74 6c 79 20 64 65 63 6c 61 72 65 64 20 49 citly declared I
9a70: 50 4b 20 63 6f 6c 75 6d 6e 2e 20 0a 20 20 2a 2a PK column. . **
9a80: 0a 20 20 2a 2a 20 20 20 20 20 32 2e 20 54 68 65 . ** 2. The
9a90: 20 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 61 20 table is not a
9aa0: 76 69 65 77 20 61 6e 64 20 74 68 65 20 63 6f 6c view and the col
9ab0: 75 6d 6e 20 6e 61 6d 65 20 69 64 65 6e 74 69 66 umn name identif
9ac0: 69 65 64 20 61 6e 20 0a 20 20 2a 2a 20 20 20 20 ied an . **
9ad0: 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 20 64 explicitly d
9ae0: 65 63 6c 61 72 65 64 20 63 6f 6c 75 6d 6e 2e 20 eclared column.
9af0: 43 6f 70 79 20 6d 65 74 61 20 69 6e 66 6f 72 6d Copy meta inform
9b00: 61 74 69 6f 6e 20 66 72 6f 6d 20 2a 70 43 6f 6c ation from *pCol
9b10: 2e 0a 20 20 2a 2f 20 0a 20 20 69 66 28 20 70 43 .. */ . if( pC
9b20: 6f 6c 20 29 7b 0a 20 20 20 20 7a 44 61 74 61 54 ol ){. zDataT
9b30: 79 70 65 20 3d 20 70 43 6f 6c 2d 3e 7a 54 79 70 ype = pCol->zTyp
9b40: 65 3b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 20 e;. zCollSeq
9b50: 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a 20 = pCol->zColl;.
9b60: 20 20 20 6e 6f 74 6e 75 6c 6c 20 3d 20 28 70 43 notnull = (pC
9b70: 6f 6c 2d 3e 6e 6f 74 4e 75 6c 6c 3f 31 3a 30 29 ol->notNull?1:0)
9b80: 3b 0a 20 20 20 20 70 72 69 6d 61 72 79 6b 65 79 ;. primarykey
9b90: 20 20 3d 20 28 70 43 6f 6c 2d 3e 69 73 50 72 69 = (pCol->isPri
9ba0: 6d 4b 65 79 3f 31 3a 30 29 3b 0a 20 20 20 20 61 mKey?1:0);. a
9bb0: 75 74 6f 69 6e 63 20 3d 20 28 28 70 54 61 62 2d utoinc = ((pTab-
9bc0: 3e 69 50 4b 65 79 3d 3d 69 43 6f 6c 20 26 26 20 >iPKey==iCol &&
9bd0: 70 54 61 62 2d 3e 61 75 74 6f 49 6e 63 29 3f 31 pTab->autoInc)?1
9be0: 3a 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 :0);. }else{.
9bf0: 20 20 7a 44 61 74 61 54 79 70 65 20 3d 20 22 49 zDataType = "I
9c00: 4e 54 45 47 45 52 22 3b 0a 20 20 20 20 70 72 69 NTEGER";. pri
9c10: 6d 61 72 79 6b 65 79 20 3d 20 31 3b 0a 20 20 7d marykey = 1;. }
9c20: 0a 20 20 69 66 28 20 21 7a 43 6f 6c 6c 53 65 71 . if( !zCollSeq
9c30: 20 29 7b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 ){. zCollSeq
9c40: 20 3d 20 22 42 49 4e 41 52 59 22 3b 0a 20 20 7d = "BINARY";. }
9c50: 0a 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 69 ..error_out:. i
9c60: 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 f( sqlite3Safety
9c70: 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20 72 Off(db) ){. r
9c80: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 c = SQLITE_MISUS
9c90: 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 68 65 E;. }.. /* Whe
9ca0: 74 68 65 72 20 74 68 65 20 66 75 6e 63 74 69 6f ther the functio
9cb0: 6e 20 63 61 6c 6c 20 73 75 63 63 65 65 64 65 64 n call succeeded
9cc0: 20 6f 72 20 66 61 69 6c 65 64 2c 20 73 65 74 20 or failed, set
9cd0: 74 68 65 20 6f 75 74 70 75 74 20 70 61 72 61 6d the output param
9ce0: 65 74 65 72 73 0a 20 20 2a 2a 20 74 6f 20 77 68 eters. ** to wh
9cf0: 61 74 65 76 65 72 20 74 68 65 69 72 20 6c 6f 63 atever their loc
9d00: 61 6c 20 63 6f 75 6e 74 65 72 70 61 72 74 73 20 al counterparts
9d10: 63 6f 6e 74 61 69 6e 2e 20 49 66 20 61 6e 20 65 contain. If an e
9d20: 72 72 6f 72 20 64 69 64 20 6f 63 63 75 72 2c 0a rror did occur,.
9d30: 20 20 2a 2a 20 74 68 69 73 20 68 61 73 20 74 68 ** this has th
9d40: 65 20 65 66 66 65 63 74 20 6f 66 20 7a 65 72 6f e effect of zero
9d50: 69 6e 67 20 61 6c 6c 20 6f 75 74 70 75 74 20 70 ing all output p
9d60: 61 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f 0a arameters.. */.
9d70: 20 20 69 66 28 20 70 7a 44 61 74 61 54 79 70 65 if( pzDataType
9d80: 20 29 20 2a 70 7a 44 61 74 61 54 79 70 65 20 3d ) *pzDataType =
9d90: 20 7a 44 61 74 61 54 79 70 65 3b 0a 20 20 69 66 zDataType;. if
9da0: 28 20 70 7a 43 6f 6c 6c 53 65 71 20 29 20 2a 70 ( pzCollSeq ) *p
9db0: 7a 43 6f 6c 6c 53 65 71 20 3d 20 7a 43 6f 6c 6c zCollSeq = zColl
9dc0: 53 65 71 3b 0a 20 20 69 66 28 20 70 4e 6f 74 4e Seq;. if( pNotN
9dd0: 75 6c 6c 20 29 20 2a 70 4e 6f 74 4e 75 6c 6c 20 ull ) *pNotNull
9de0: 3d 20 6e 6f 74 6e 75 6c 6c 3b 0a 20 20 69 66 28 = notnull;. if(
9df0: 20 70 50 72 69 6d 61 72 79 4b 65 79 20 29 20 2a pPrimaryKey ) *
9e00: 70 50 72 69 6d 61 72 79 4b 65 79 20 3d 20 70 72 pPrimaryKey = pr
9e10: 69 6d 61 72 79 6b 65 79 3b 0a 20 20 69 66 28 20 imarykey;. if(
9e20: 70 41 75 74 6f 69 6e 63 20 29 20 2a 70 41 75 74 pAutoinc ) *pAut
9e30: 6f 69 6e 63 20 3d 20 61 75 74 6f 69 6e 63 3b 0a oinc = autoinc;.
9e40: 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b . if( SQLITE_OK
9e50: 3d 3d 72 63 20 26 26 20 21 70 54 61 62 20 29 7b ==rc && !pTab ){
9e60: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 . sqlite3SetS
9e70: 74 72 69 6e 67 28 26 7a 45 72 72 4d 73 67 2c 20 tring(&zErrMsg,
9e80: 22 6e 6f 20 73 75 63 68 20 74 61 62 6c 65 20 63 "no such table c
9e90: 6f 6c 75 6d 6e 3a 20 22 2c 20 7a 54 61 62 6c 65 olumn: ", zTable
9ea0: 4e 61 6d 65 2c 20 22 2e 22 2c 20 0a 20 20 20 20 Name, ".", .
9eb0: 20 20 20 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 2c zColumnName,
9ec0: 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 0);. rc = SQ
9ed0: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a LITE_ERROR;. }.
9ee0: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 sqlite3Error(d
9ef0: 62 2c 20 72 63 2c 20 28 7a 45 72 72 4d 73 67 3f b, rc, (zErrMsg?
9f00: 22 25 73 22 3a 30 29 2c 20 7a 45 72 72 4d 73 67 "%s":0), zErrMsg
9f10: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 );. sqliteFree(
9f20: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 zErrMsg);. retu
9f30: 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 rn sqlite3ApiExi
9f40: 74 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e t(db, rc);.}.#en
9f50: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 61 dif../*.** Set a
9f60: 6c 6c 20 74 68 65 20 70 61 72 61 6d 65 74 65 72 ll the parameter
9f70: 73 20 69 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65 s in the compile
9f80: 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 d SQL statement
9f90: 74 6f 20 4e 55 4c 4c 2e 0a 2a 2f 0a 69 6e 74 20 to NULL..*/.int
9fa0: 73 71 6c 69 74 65 33 5f 63 6c 65 61 72 5f 62 69 sqlite3_clear_bi
9fb0: 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73 ndings(sqlite3_s
9fc0: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 tmt *pStmt){. i
9fd0: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 72 63 20 3d nt i;. int rc =
9fe0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 66 6f SQLITE_OK;. fo
9ff0: 72 28 69 3d 31 3b 20 72 63 3d 3d 53 51 4c 49 54 r(i=1; rc==SQLIT
a000: 45 5f 4f 4b 20 26 26 20 69 3c 3d 73 71 6c 69 74 E_OK && i<=sqlit
a010: 65 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 e3_bind_paramete
a020: 72 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 3b 20 r_count(pStmt);
a030: 69 2b 2b 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 i++){. rc = s
a040: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c qlite3_bind_null
a050: 28 70 53 74 6d 74 2c 20 69 29 3b 0a 20 20 7d 0a (pStmt, i);. }.
a060: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
a070: 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f 72 20 /*.** Sleep for
a080: 61 20 6c 69 74 74 6c 65 20 77 68 69 6c 65 2e 20 a little while.
a090: 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f 75 Return the amou
a0a0: 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c 65 70 74 nt of time slept
a0b0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
a0c0: 5f 73 6c 65 65 70 28 69 6e 74 20 6d 73 29 7b 0a _sleep(int ms){.
a0d0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
a0e0: 4f 73 53 6c 65 65 70 28 6d 73 29 3b 0a 7d 0a 0a OsSleep(ms);.}..
a0f0: 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 20 /*.** Enable or
a100: 64 69 73 61 62 6c 65 20 74 68 65 20 65 78 74 65 disable the exte
a110: 6e 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65 nded result code
a120: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
a130: 33 5f 65 78 74 65 6e 64 65 64 5f 72 65 73 75 6c 3_extended_resul
a140: 74 5f 63 6f 64 65 73 28 73 71 6c 69 74 65 33 20 t_codes(sqlite3
a150: 2a 64 62 2c 20 69 6e 74 20 6f 6e 6f 66 66 29 7b *db, int onoff){
a160: 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 6b 20 3d . db->errMask =
a170: 20 6f 6e 6f 66 66 20 3f 20 30 78 66 66 66 66 66 onoff ? 0xfffff
a180: 66 66 66 20 3a 20 30 78 66 66 3b 0a 20 20 72 65 fff : 0xff;. re
a190: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
a1a0: 7d 0a }.