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 31 36 32 20 32 30 30 34 2f 30 33 ,v 1.162 2004/03
0280: 2f 30 34 20 31 39 3a 30 39 3a 32 30 20 72 64 63 /04 19:09:20 rdc
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 41 20 70 6f 69 .h>../*.** A poi
02e0: 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 72 nter to this str
02f0: 75 63 74 75 72 65 20 69 73 20 75 73 65 64 20 74 ucture is used t
0300: 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 69 6e o communicate in
0310: 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 6f formation.** fro
0320: 6d 20 73 71 6c 69 74 65 49 6e 69 74 20 69 6e 74 m sqliteInit int
0330: 6f 20 74 68 65 20 73 71 6c 69 74 65 49 6e 69 74 o the sqliteInit
0340: 43 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 74 79 70 Callback..*/.typ
0350: 65 64 65 66 20 73 74 72 75 63 74 20 7b 0a 20 20 edef struct {.
0360: 73 71 6c 69 74 65 20 2a 64 62 3b 20 20 20 20 20 sqlite *db;
0370: 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 /* The datab
0380: 61 73 65 20 62 65 69 6e 67 20 69 6e 69 74 69 61 ase being initia
0390: 6c 69 7a 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 lized */. char
03a0: 2a 2a 70 7a 45 72 72 4d 73 67 3b 20 20 20 20 2f **pzErrMsg; /
03b0: 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 * Error message
03c0: 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f 0a 7d stored here */.}
03d0: 20 49 6e 69 74 44 61 74 61 3b 0a 0a 2f 2a 0a 2a InitData;../*.*
03e0: 2a 20 46 69 6c 6c 20 74 68 65 20 49 6e 69 74 44 * Fill the InitD
03f0: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 77 69 ata structure wi
0400: 74 68 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 th an error mess
0410: 61 67 65 20 74 68 61 74 20 69 6e 64 69 63 61 74 age that indicat
0420: 65 73 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 64 es.** that the d
0430: 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 72 75 atabase is corru
0440: 70 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f pt..*/.static vo
0450: 69 64 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 id corruptSchema
0460: 28 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61 (InitData *pData
0470: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 , const char *zE
0480: 78 74 72 61 29 7b 0a 20 20 73 71 6c 69 74 65 53 xtra){. sqliteS
0490: 65 74 53 74 72 69 6e 67 28 70 44 61 74 61 2d 3e etString(pData->
04a0: 70 7a 45 72 72 4d 73 67 2c 20 22 6d 61 6c 66 6f pzErrMsg, "malfo
04b0: 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 73 63 rmed database sc
04c0: 68 65 6d 61 22 2c 0a 20 20 20 20 20 7a 45 78 74 hema",. zExt
04d0: 72 61 21 3d 30 20 26 26 20 7a 45 78 74 72 61 5b ra!=0 && zExtra[
04e0: 30 5d 21 3d 30 20 3f 20 22 20 2d 20 22 20 3a 20 0]!=0 ? " - " :
04f0: 28 63 68 61 72 2a 29 30 2c 20 7a 45 78 74 72 61 (char*)0, zExtra
0500: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 7d 0a 0a , (char*)0);.}..
0510: 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 /*.** This is th
0520: 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 e callback routi
0530: 6e 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65 20 ne for the code
0540: 74 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 that initializes
0550: 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 the.** database
0560: 2e 20 20 53 65 65 20 73 71 6c 69 74 65 49 6e 69 . See sqliteIni
0570: 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20 61 64 t() below for ad
0580: 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 ditional informa
0590: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 tion..**.** Each
05a0: 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69 callback contai
05b0: 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ns the following
05c0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a information:.**
05d0: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 30 5d 20 .** argv[0]
05e0: 3d 20 22 66 69 6c 65 2d 66 6f 72 6d 61 74 22 20 = "file-format"
05f0: 6f 72 20 22 73 63 68 65 6d 61 2d 63 6f 6f 6b 69 or "schema-cooki
0600: 65 22 20 6f 72 20 22 74 61 62 6c 65 22 20 6f 72 e" or "table" or
0610: 20 22 69 6e 64 65 78 22 0a 2a 2a 20 20 20 20 20 "index".**
0620: 61 72 67 76 5b 31 5d 20 3d 20 74 61 62 6c 65 20 argv[1] = table
0630: 6f 72 20 69 6e 64 65 78 20 6e 61 6d 65 20 6f 72 or index name or
0640: 20 6d 65 74 61 20 73 74 61 74 65 6d 65 6e 74 20 meta statement
0650: 74 79 70 65 2e 0a 2a 2a 20 20 20 20 20 61 72 67 type..** arg
0660: 76 5b 32 5d 20 3d 20 72 6f 6f 74 20 70 61 67 65 v[2] = root page
0670: 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 61 62 6c number for tabl
0680: 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 4e 55 4c e or index. NUL
0690: 4c 20 66 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20 20 L for meta..**
06a0: 20 20 20 61 72 67 76 5b 33 5d 20 3d 20 53 51 4c argv[3] = SQL
06b0: 20 74 65 78 74 20 66 6f 72 20 61 20 43 52 45 41 text for a CREA
06c0: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 TE TABLE or CREA
06d0: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 TE INDEX stateme
06e0: 6e 74 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b nt..** argv[
06f0: 34 5d 20 3d 20 22 31 22 20 66 6f 72 20 74 65 6d 4] = "1" for tem
0700: 70 6f 72 61 72 79 20 66 69 6c 65 73 2c 20 22 30 porary files, "0
0710: 22 20 66 6f 72 20 6d 61 69 6e 20 64 61 74 61 62 " for main datab
0720: 61 73 65 2c 20 22 32 22 20 6f 72 20 6d 6f 72 65 ase, "2" or more
0730: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
0740: 20 20 66 6f 72 20 61 75 78 69 6c 69 61 72 79 20 for auxiliary
0750: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e 0a database files..
0760: 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63 0a 69 6e 74 **.*/.static.int
0770: 20 73 71 6c 69 74 65 49 6e 69 74 43 61 6c 6c 62 sqliteInitCallb
0780: 61 63 6b 28 76 6f 69 64 20 2a 70 49 6e 69 74 2c ack(void *pInit,
0790: 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61 72 20 int argc, char
07a0: 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a 2a 61 **argv, char **a
07b0: 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20 20 49 6e 69 zColName){. Ini
07c0: 74 44 61 74 61 20 2a 70 44 61 74 61 20 3d 20 28 tData *pData = (
07d0: 49 6e 69 74 44 61 74 61 2a 29 70 49 6e 69 74 3b InitData*)pInit;
07e0: 0a 20 20 69 6e 74 20 6e 45 72 72 20 3d 20 30 3b . int nErr = 0;
07f0: 0a 0a 20 20 61 73 73 65 72 74 28 20 61 72 67 63 .. assert( argc
0800: 3d 3d 35 20 29 3b 0a 20 20 69 66 28 20 61 72 67 ==5 );. if( arg
0810: 76 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b v==0 ) return 0;
0820: 20 20 20 2f 2a 20 4d 69 67 68 74 20 68 61 70 70 /* Might happ
0830: 65 6e 20 69 66 20 45 4d 50 54 59 5f 52 45 53 55 en if EMPTY_RESU
0840: 4c 54 5f 43 41 4c 4c 42 41 43 4b 53 20 61 72 65 LT_CALLBACKS are
0850: 20 6f 6e 20 2a 2f 0a 20 20 69 66 28 20 61 72 67 on */. if( arg
0860: 76 5b 30 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 63 v[0]==0 ){. c
0870: 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61 orruptSchema(pDa
0880: 74 61 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 ta, 0);. retu
0890: 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 73 77 69 74 rn 1;. }. swit
08a0: 63 68 28 20 61 72 67 76 5b 30 5d 5b 30 5d 20 29 ch( argv[0][0] )
08b0: 7b 0a 20 20 20 20 63 61 73 65 20 27 76 27 3a 0a {. case 'v':.
08c0: 20 20 20 20 63 61 73 65 20 27 69 27 3a 0a 20 20 case 'i':.
08d0: 20 20 63 61 73 65 20 27 74 27 3a 20 7b 20 20 2f case 't': { /
08e0: 2a 20 43 52 45 41 54 45 20 54 41 42 4c 45 2c 20 * CREATE TABLE,
08f0: 43 52 45 41 54 45 20 49 4e 44 45 58 2c 20 6f 72 CREATE INDEX, or
0900: 20 43 52 45 41 54 45 20 56 49 45 57 20 73 74 61 CREATE VIEW sta
0910: 74 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 20 20 20 tements */.
0920: 20 73 71 6c 69 74 65 20 2a 64 62 20 3d 20 70 44 sqlite *db = pD
0930: 61 74 61 2d 3e 64 62 3b 0a 20 20 20 20 20 20 69 ata->db;. i
0940: 66 28 20 61 72 67 76 5b 32 5d 3d 3d 30 20 7c 7c f( argv[2]==0 ||
0950: 20 61 72 67 76 5b 34 5d 3d 3d 30 20 29 7b 0a 20 argv[4]==0 ){.
0960: 20 20 20 20 20 20 20 63 6f 72 72 75 70 74 53 63 corruptSc
0970: 68 65 6d 61 28 70 44 61 74 61 2c 20 30 29 3b 0a hema(pData, 0);.
0980: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 31 return 1
0990: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
09a0: 69 66 28 20 61 72 67 76 5b 33 5d 20 26 26 20 61 if( argv[3] && a
09b0: 72 67 76 5b 33 5d 5b 30 5d 20 29 7b 0a 20 20 20 rgv[3][0] ){.
09c0: 20 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65 /* Call the
09d0: 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 65 parser to proce
09e0: 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42 4c ss a CREATE TABL
09f0: 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 45 57 E, INDEX or VIEW
0a00: 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 42 75 74 .. ** But
0a10: 20 62 65 63 61 75 73 65 20 64 62 2d 3e 69 6e 69 because db->ini
0a20: 74 2e 62 75 73 79 20 69 73 20 73 65 74 20 74 6f t.busy is set to
0a30: 20 31 2c 20 6e 6f 20 56 44 42 45 20 63 6f 64 65 1, no VDBE code
0a40: 20 69 73 20 67 65 6e 65 72 61 74 65 64 0a 20 20 is generated.
0a50: 20 20 20 20 20 20 2a 2a 20 6f 72 20 65 78 65 63 ** or exec
0a60: 75 74 65 64 2e 20 20 41 6c 6c 20 74 68 65 20 70 uted. All the p
0a70: 61 72 73 65 72 20 64 6f 65 73 20 69 73 20 62 75 arser does is bu
0a80: 69 6c 64 20 74 68 65 20 69 6e 74 65 72 6e 61 6c ild the internal
0a90: 20 64 61 74 61 0a 20 20 20 20 20 20 20 20 2a 2a data. **
0aa0: 20 73 74 72 75 63 74 75 72 65 73 20 74 68 61 74 structures that
0ab0: 20 64 65 73 63 72 69 62 65 20 74 68 65 20 74 61 describe the ta
0ac0: 62 6c 65 2c 20 69 6e 64 65 78 2c 20 6f 72 20 76 ble, index, or v
0ad0: 69 65 77 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a iew.. */.
0ae0: 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 7a 45 char *zE
0af0: 72 72 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 rr;. asse
0b00: 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 rt( db->init.bus
0b10: 79 20 29 3b 0a 20 20 20 20 20 20 20 20 64 62 2d y );. db-
0b20: 3e 69 6e 69 74 2e 69 44 62 20 3d 20 61 74 6f 69 >init.iDb = atoi
0b30: 28 61 72 67 76 5b 34 5d 29 3b 0a 20 20 20 20 20 (argv[4]);.
0b40: 20 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 assert( db->i
0b50: 6e 69 74 2e 69 44 62 3e 3d 30 20 26 26 20 64 62 nit.iDb>=0 && db
0b60: 2d 3e 69 6e 69 74 2e 69 44 62 3c 64 62 2d 3e 6e ->init.iDb<db->n
0b70: 44 62 20 29 3b 0a 20 20 20 20 20 20 20 20 64 62 Db );. db
0b80: 2d 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d ->init.newTnum =
0b90: 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a atoi(argv[2]);.
0ba0: 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 if( sqli
0bb0: 74 65 5f 65 78 65 63 28 64 62 2c 20 61 72 67 76 te_exec(db, argv
0bc0: 5b 33 5d 2c 20 30 2c 20 30 2c 20 26 7a 45 72 72 [3], 0, 0, &zErr
0bd0: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 63 ) ){. c
0be0: 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61 orruptSchema(pDa
0bf0: 74 61 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20 20 ta, zErr);.
0c00: 20 20 20 20 20 73 71 6c 69 74 65 5f 66 72 65 65 sqlite_free
0c10: 6d 65 6d 28 7a 45 72 72 29 3b 0a 20 20 20 20 20 mem(zErr);.
0c20: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 64 62 2d }. db-
0c30: 3e 69 6e 69 74 2e 69 44 62 20 3d 20 30 3b 0a 20 >init.iDb = 0;.
0c40: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
0c50: 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51 /* If the SQ
0c60: 4c 20 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e L column is blan
0c70: 6b 20 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 k it means this
0c80: 69 73 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 is an index that
0c90: 0a 20 20 20 20 20 20 20 20 2a 2a 20 77 61 73 20 . ** was
0ca0: 63 72 65 61 74 65 64 20 74 6f 20 62 65 20 74 68 created to be th
0cb0: 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 e PRIMARY KEY or
0cc0: 20 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e to fulfill a UN
0cd0: 49 51 55 45 0a 20 20 20 20 20 20 20 20 2a 2a 20 IQUE. **
0ce0: 63 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 61 constraint for a
0cf0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20 CREATE TABLE.
0d00: 54 68 65 20 69 6e 64 65 78 20 73 68 6f 75 6c 64 The index should
0d10: 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20 have already.
0d20: 20 20 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72 ** been cr
0d30: 65 61 74 65 64 20 77 68 65 6e 20 77 65 20 70 72 eated when we pr
0d40: 6f 63 65 73 73 65 64 20 74 68 65 20 43 52 45 41 ocessed the CREA
0d50: 54 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77 TE TABLE. All w
0d60: 65 20 68 61 76 65 0a 20 20 20 20 20 20 20 20 2a e have. *
0d70: 2a 20 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20 * to do here is
0d80: 72 65 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20 record the root
0d90: 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 page number for
0da0: 74 68 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20 that index..
0db0: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 */. i
0dc0: 6e 74 20 69 44 62 3b 0a 20 20 20 20 20 20 20 20 nt iDb;.
0dd0: 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 0a 0a Index *pIndex;..
0de0: 20 20 20 20 20 20 20 20 69 44 62 20 3d 20 61 74 iDb = at
0df0: 6f 69 28 61 72 67 76 5b 34 5d 29 3b 0a 20 20 20 oi(argv[4]);.
0e00: 20 20 20 20 20 61 73 73 65 72 74 28 20 69 44 62 assert( iDb
0e10: 3e 3d 30 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e >=0 && iDb<db->n
0e20: 44 62 20 29 3b 0a 20 20 20 20 20 20 20 20 70 49 Db );. pI
0e30: 6e 64 65 78 20 3d 20 73 71 6c 69 74 65 46 69 6e ndex = sqliteFin
0e40: 64 49 6e 64 65 78 28 64 62 2c 20 61 72 67 76 5b dIndex(db, argv[
0e50: 31 5d 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 1], db->aDb[iDb]
0e60: 2e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 .zName);.
0e70: 20 69 66 28 20 70 49 6e 64 65 78 3d 3d 30 20 7c if( pIndex==0 |
0e80: 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 21 3d | pIndex->tnum!=
0e90: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 0 ){. /
0ea0: 2a 20 54 68 69 73 20 63 61 6e 20 6f 63 63 75 72 * This can occur
0eb0: 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73 if there exists
0ec0: 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 61 20 54 an index on a T
0ed0: 45 4d 50 20 74 61 62 6c 65 20 77 68 69 63 68 0a EMP table which.
0ee0: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 68 61 73 ** has
0ef0: 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 the same name a
0f00: 73 20 61 6e 6f 74 68 65 72 20 69 6e 64 65 78 20 s another index
0f10: 6f 6e 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 69 on a permanent i
0f20: 6e 64 65 78 2e 20 20 53 69 6e 63 65 0a 20 20 20 ndex. Since.
0f30: 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 70 65 ** the pe
0f40: 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 20 69 73 rmanent table is
0f50: 20 68 69 64 64 65 6e 20 62 79 20 74 68 65 20 54 hidden by the T
0f60: 45 4d 50 20 74 61 62 6c 65 2c 20 77 65 20 63 61 EMP table, we ca
0f70: 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20 20 20 20 n also.
0f80: 20 2a 2a 20 73 61 66 65 6c 79 20 69 67 6e 6f 72 ** safely ignor
0f90: 65 20 74 68 65 20 69 6e 64 65 78 20 6f 6e 20 74 e the index on t
0fa0: 68 65 20 70 65 72 6d 61 6e 65 6e 74 20 74 61 62 he permanent tab
0fb0: 6c 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f le.. */
0fc0: 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f . /* Do
0fd0: 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b 0a 20 20 20 Nothing */;.
0fe0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
0ff0: 20 20 20 20 20 20 70 49 6e 64 65 78 2d 3e 74 6e pIndex->tn
1000: 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 32 um = atoi(argv[2
1010: 5d 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ]);. }.
1020: 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61 }. brea
1030: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 k;. }. def
1040: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f 2a ault: {. /*
1050: 20 54 68 69 73 20 63 61 6e 20 6e 6f 74 20 68 61 This can not ha
1060: 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20 20 20 6e ppen! */. n
1070: 45 72 72 20 3d 20 31 3b 0a 20 20 20 20 20 20 61 Err = 1;. a
1080: 73 73 65 72 74 28 20 6e 45 72 72 3d 3d 30 20 29 ssert( nErr==0 )
1090: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
10a0: 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a 0a 2f 2a turn nErr;.}../*
10b0: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 61 .** This is a ca
10c0: 6c 6c 62 61 63 6b 20 70 72 6f 63 65 64 75 72 65 llback procedure
10d0: 20 75 73 65 64 20 74 6f 20 72 65 63 6f 6e 73 74 used to reconst
10e0: 72 75 63 74 20 61 20 74 61 62 6c 65 2e 20 20 54 ruct a table. T
10f0: 68 65 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 74 68 he.** name of th
1100: 65 20 74 61 62 6c 65 20 74 6f 20 62 65 20 72 65 e table to be re
1110: 63 6f 6e 73 74 72 75 63 74 65 64 20 69 73 20 70 constructed is p
1120: 61 73 73 65 64 20 69 6e 20 61 73 20 61 72 67 76 assed in as argv
1130: 5b 30 5d 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 [0]..**.** This
1140: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 routine is used
1150: 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 to automatically
1160: 20 75 70 67 72 61 64 65 20 61 20 64 61 74 61 62 upgrade a datab
1170: 61 73 65 20 66 72 6f 6d 0a 2a 2a 20 66 6f 72 6d ase from.** form
1180: 61 74 20 76 65 72 73 69 6f 6e 20 31 20 6f 72 20 at version 1 or
1190: 32 20 74 6f 20 76 65 72 73 69 6f 6e 20 33 2e 20 2 to version 3.
11a0: 20 54 68 65 20 63 6f 72 72 65 63 74 20 6f 70 65 The correct ope
11b0: 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 69 ration of.** thi
11c0: 73 20 72 6f 75 74 69 6e 65 20 72 65 6c 79 73 20 s routine relys
11d0: 6f 6e 20 74 68 65 20 66 61 63 74 20 74 68 61 74 on the fact that
11e0: 20 6e 6f 20 69 6e 64 69 63 65 73 20 61 72 65 20 no indices are
11f0: 75 73 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 70 used when.** cop
1200: 79 69 6e 67 20 61 20 74 61 62 6c 65 20 6f 75 74 ying a table out
1210: 20 74 6f 20 61 20 74 65 6d 70 6f 72 61 72 79 20 to a temporary
1220: 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 file..**.** The
1230: 63 68 61 6e 67 65 20 66 72 6f 6d 20 76 65 72 73 change from vers
1240: 69 6f 6e 20 32 20 74 6f 20 76 65 72 73 69 6f 6e ion 2 to version
1250: 20 33 20 6f 63 63 75 72 72 65 64 20 62 65 74 77 3 occurred betw
1260: 65 65 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 76 65 een SQLite.** ve
1270: 72 73 69 6f 6e 20 32 2e 35 2e 36 20 61 6e 64 20 rsion 2.5.6 and
1280: 32 2e 36 2e 30 20 6f 6e 20 32 30 30 32 2d 4a 75 2.6.0 on 2002-Ju
1290: 6c 79 2d 31 38 2e 20 20 0a 2a 2f 0a 73 74 61 74 ly-18. .*/.stat
12a0: 69 63 0a 69 6e 74 20 75 70 67 72 61 64 65 5f 33 ic.int upgrade_3
12b0: 5f 63 61 6c 6c 62 61 63 6b 28 76 6f 69 64 20 2a _callback(void *
12c0: 70 49 6e 69 74 2c 20 69 6e 74 20 61 72 67 63 2c pInit, int argc,
12d0: 20 63 68 61 72 20 2a 2a 61 72 67 76 2c 20 63 68 char **argv, ch
12e0: 61 72 20 2a 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 ar **NotUsed){.
12f0: 20 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61 InitData *pData
1300: 20 3d 20 28 49 6e 69 74 44 61 74 61 2a 29 70 49 = (InitData*)pI
1310: 6e 69 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 nit;. int rc;.
1320: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20 Table *pTab;.
1330: 54 72 69 67 67 65 72 20 2a 70 54 72 69 67 3b 0a Trigger *pTrig;.
1340: 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30 char *zErr = 0
1350: 3b 0a 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 ;.. pTab = sqli
1360: 74 65 46 69 6e 64 54 61 62 6c 65 28 70 44 61 74 teFindTable(pDat
1370: 61 2d 3e 64 62 2c 20 61 72 67 76 5b 30 5d 2c 20 a->db, argv[0],
1380: 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 54 0);. assert( pT
1390: 61 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 ab!=0 );. asser
13a0: 74 28 20 73 71 6c 69 74 65 53 74 72 49 43 6d 70 t( sqliteStrICmp
13b0: 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 61 72 (pTab->zName, ar
13c0: 67 76 5b 30 5d 29 3d 3d 30 20 29 3b 0a 20 20 69 gv[0])==0 );. i
13d0: 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20 70 f( pTab ){. p
13e0: 54 72 69 67 20 3d 20 70 54 61 62 2d 3e 70 54 72 Trig = pTab->pTr
13f0: 69 67 67 65 72 3b 0a 20 20 20 20 70 54 61 62 2d igger;. pTab-
1400: 3e 70 54 72 69 67 67 65 72 20 3d 20 30 3b 20 20 >pTrigger = 0;
1410: 2f 2a 20 44 69 73 61 62 6c 65 20 61 6c 6c 20 74 /* Disable all t
1420: 72 69 67 67 65 72 73 20 62 65 66 6f 72 65 20 72 riggers before r
1430: 65 62 75 69 6c 64 69 6e 67 20 74 68 65 20 74 61 ebuilding the ta
1440: 62 6c 65 20 2a 2f 0a 20 20 7d 0a 20 20 72 63 20 ble */. }. rc
1450: 3d 20 73 71 6c 69 74 65 5f 65 78 65 63 5f 70 72 = sqlite_exec_pr
1460: 69 6e 74 66 28 70 44 61 74 61 2d 3e 64 62 2c 0a intf(pData->db,.
1470: 20 20 20 20 22 43 52 45 41 54 45 20 54 45 4d 50 "CREATE TEMP
1480: 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 78 20 TABLE sqlite_x
1490: 41 53 20 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d AS SELECT * FROM
14a0: 20 27 25 71 27 3b 20 22 0a 20 20 20 20 22 44 45 '%q'; ". "DE
14b0: 4c 45 54 45 20 46 52 4f 4d 20 27 25 71 27 3b 20 LETE FROM '%q';
14c0: 22 0a 20 20 20 20 22 49 4e 53 45 52 54 20 49 4e ". "INSERT IN
14d0: 54 4f 20 27 25 71 27 20 53 45 4c 45 43 54 20 2a TO '%q' SELECT *
14e0: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 78 3b 20 FROM sqlite_x;
14f0: 22 0a 20 20 20 20 22 44 52 4f 50 20 54 41 42 4c ". "DROP TABL
1500: 45 20 73 71 6c 69 74 65 5f 78 3b 22 2c 0a 20 20 E sqlite_x;",.
1510: 20 20 30 2c 20 30 2c 20 26 7a 45 72 72 2c 20 61 0, 0, &zErr, a
1520: 72 67 76 5b 30 5d 2c 20 61 72 67 76 5b 30 5d 2c rgv[0], argv[0],
1530: 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20 69 66 28 argv[0]);. if(
1540: 20 7a 45 72 72 20 29 7b 0a 20 20 20 20 69 66 28 zErr ){. if(
1550: 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73 *pData->pzErrMs
1560: 67 20 29 20 73 71 6c 69 74 65 5f 66 72 65 65 6d g ) sqlite_freem
1570: 65 6d 28 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72 em(*pData->pzErr
1580: 4d 73 67 29 3b 0a 20 20 20 20 2a 70 44 61 74 61 Msg);. *pData
1590: 2d 3e 70 7a 45 72 72 4d 73 67 20 3d 20 7a 45 72 ->pzErrMsg = zEr
15a0: 72 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 r;. }.. /* If
15b0: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 an error occurre
15c0: 64 20 69 6e 20 74 68 65 20 53 51 4c 20 61 62 6f d in the SQL abo
15d0: 76 65 2c 20 74 68 65 6e 20 74 68 65 20 74 72 61 ve, then the tra
15e0: 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 0a 20 20 nsaction will.
15f0: 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 77 68 69 63 ** rollback whic
1600: 68 20 77 69 6c 6c 20 64 65 6c 65 74 65 20 74 68 h will delete th
1610: 65 20 69 6e 74 65 72 6e 61 6c 20 73 79 6d 62 6f e internal symbo
1620: 6c 20 74 61 62 6c 65 73 2e 20 20 54 68 69 73 20 l tables. This
1630: 77 69 6c 6c 0a 20 20 2a 2a 20 63 61 75 73 65 20 will. ** cause
1640: 74 68 65 20 73 74 72 75 63 74 75 72 65 20 74 68 the structure th
1650: 61 74 20 70 54 61 62 20 70 6f 69 6e 74 73 20 74 at pTab points t
1660: 6f 20 62 65 20 64 65 6c 65 74 65 64 2e 20 20 49 o be deleted. I
1670: 6e 20 63 61 73 65 20 74 68 61 74 0a 20 20 2a 2a n case that. **
1680: 20 68 61 70 70 65 6e 65 64 2c 20 77 65 20 6e 65 happened, we ne
1690: 65 64 20 74 6f 20 72 65 66 65 74 63 68 20 70 54 ed to refetch pT
16a0: 61 62 2e 0a 20 20 2a 2f 0a 20 20 70 54 61 62 20 ab.. */. pTab
16b0: 3d 20 73 71 6c 69 74 65 46 69 6e 64 54 61 62 6c = sqliteFindTabl
16c0: 65 28 70 44 61 74 61 2d 3e 64 62 2c 20 61 72 67 e(pData->db, arg
16d0: 76 5b 30 5d 2c 20 30 29 3b 0a 20 20 69 66 28 20 v[0], 0);. if(
16e0: 70 54 61 62 20 29 7b 0a 20 20 20 20 61 73 73 65 pTab ){. asse
16f0: 72 74 28 20 73 71 6c 69 74 65 53 74 72 49 43 6d rt( sqliteStrICm
1700: 70 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 61 p(pTab->zName, a
1710: 72 67 76 5b 30 5d 29 3d 3d 30 20 29 3b 0a 20 20 rgv[0])==0 );.
1720: 20 20 70 54 61 62 2d 3e 70 54 72 69 67 67 65 72 pTab->pTrigger
1730: 20 3d 20 70 54 72 69 67 3b 20 20 2f 2a 20 52 65 = pTrig; /* Re
1740: 2d 65 6e 61 62 6c 65 20 74 72 69 67 67 65 72 73 -enable triggers
1750: 20 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e */. }. return
1760: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc!=SQLITE_OK;.
1770: 7d 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d }..../*.** Attem
1780: 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 20 64 pt to read the d
1790: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 61 atabase schema a
17a0: 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 69 6e nd initialize in
17b0: 74 65 72 6e 61 6c 0a 2a 2a 20 64 61 74 61 20 73 ternal.** data s
17c0: 74 72 75 63 74 75 72 65 73 20 66 6f 72 20 61 20 tructures for a
17d0: 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65 20 single database
17e0: 66 69 6c 65 2e 20 20 54 68 65 20 69 6e 64 65 78 file. The index
17f0: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 of the.** datab
1800: 61 73 65 20 66 69 6c 65 20 69 73 20 67 69 76 65 ase file is give
1810: 6e 20 62 79 20 69 44 62 2e 20 20 69 44 62 3d 3d n by iDb. iDb==
1820: 30 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 0 is used for th
1830: 65 20 6d 61 69 6e 0a 2a 2a 20 64 61 74 61 62 61 e main.** databa
1840: 73 65 2e 20 20 69 44 62 3d 3d 31 20 73 68 6f 75 se. iDb==1 shou
1850: 6c 64 20 6e 65 76 65 72 20 62 65 20 75 73 65 64 ld never be used
1860: 2e 20 20 69 44 62 3e 3d 32 20 69 73 20 75 73 65 . iDb>=2 is use
1870: 64 20 66 6f 72 0a 2a 2a 20 61 75 78 69 6c 69 61 d for.** auxilia
1880: 72 79 20 64 61 74 61 62 61 73 65 73 2e 20 20 52 ry databases. R
1890: 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74 68 65 eturn one of the
18a0: 20 53 51 4c 49 54 45 5f 20 65 72 72 6f 72 20 63 SQLITE_ error c
18b0: 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e 64 69 63 odes to.** indic
18c0: 61 74 65 20 73 75 63 63 65 73 73 20 6f 72 20 66 ate success or f
18d0: 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 ailure..*/.stati
18e0: 63 20 69 6e 74 20 73 71 6c 69 74 65 49 6e 69 74 c int sqliteInit
18f0: 4f 6e 65 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 One(sqlite *db,
1900: 69 6e 74 20 69 44 62 2c 20 63 68 61 72 20 2a 2a int iDb, char **
1910: 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 pzErrMsg){. int
1920: 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 rc;. BtCursor
1930: 2a 63 75 72 4d 61 69 6e 3b 0a 20 20 69 6e 74 20 *curMain;. int
1940: 73 69 7a 65 3b 0a 20 20 54 61 62 6c 65 20 2a 70 size;. Table *p
1950: 54 61 62 3b 0a 20 20 63 68 61 72 20 2a 61 7a 41 Tab;. char *azA
1960: 72 67 5b 36 5d 3b 0a 20 20 63 68 61 72 20 7a 44 rg[6];. char zD
1970: 62 4e 75 6d 5b 33 30 5d 3b 0a 20 20 69 6e 74 20 bNum[30];. int
1980: 6d 65 74 61 5b 53 51 4c 49 54 45 5f 4e 5f 42 54 meta[SQLITE_N_BT
1990: 52 45 45 5f 4d 45 54 41 5d 3b 0a 20 20 49 6e 69 REE_META];. Ini
19a0: 74 44 61 74 61 20 69 6e 69 74 44 61 74 61 3b 0a tData initData;.
19b0: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 6d . /*. ** The m
19c0: 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 74 aster database t
19d0: 61 62 6c 65 20 68 61 73 20 61 20 73 74 72 75 63 able has a struc
19e0: 74 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a 20 ture like this.
19f0: 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68 61 */. static cha
1a00: 72 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b r master_schema[
1a10: 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 ] = . "CREAT
1a20: 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d E TABLE sqlite_m
1a30: 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20 22 aster(\n". "
1a40: 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a type text,\n".
1a50: 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65 78 " name tex
1a60: 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 62 t,\n". " tb
1a70: 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a l_name text,\n".
1a80: 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67 65 " rootpage
1a90: 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20 integer,\n".
1aa0: 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22 " sql text\n"
1ab0: 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 20 20 . ")". ;.
1ac0: 73 74 61 74 69 63 20 63 68 61 72 20 74 65 6d 70 static char temp
1ad0: 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d _master_schema[]
1ae0: 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 45 = . "CREATE
1af0: 20 54 45 4d 50 20 54 41 42 4c 45 20 73 71 6c 69 TEMP TABLE sqli
1b00: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 28 5c te_temp_master(\
1b10: 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 n". " type
1b20: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 text,\n". "
1b30: 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 name text,\n".
1b40: 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 " tbl_name
1b50: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 text,\n". "
1b60: 20 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 rootpage intege
1b70: 72 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 r,\n". " sq
1b80: 6c 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 l text\n". "
1b90: 29 22 0a 20 20 3b 0a 0a 20 20 2f 2a 20 54 68 65 )". ;.. /* The
1ba0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 53 51 4c 20 77 following SQL w
1bb0: 69 6c 6c 20 72 65 61 64 20 74 68 65 20 73 63 68 ill read the sch
1bc0: 65 6d 61 20 66 72 6f 6d 20 74 68 65 20 6d 61 73 ema from the mas
1bd0: 74 65 72 20 74 61 62 6c 65 73 2e 0a 20 20 2a 2a ter tables.. **
1be0: 20 54 68 65 20 66 69 72 73 74 20 76 65 72 73 69 The first versi
1bf0: 6f 6e 20 77 6f 72 6b 73 20 77 69 74 68 20 53 51 on works with SQ
1c00: 4c 69 74 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 Lite file format
1c10: 73 20 32 20 6f 72 20 67 72 65 61 74 65 72 2e 0a s 2 or greater..
1c20: 20 20 2a 2a 20 54 68 65 20 73 65 63 6f 6e 64 20 ** The second
1c30: 76 65 72 73 69 6f 6e 20 69 73 20 66 6f 72 20 66 version is for f
1c40: 6f 72 6d 61 74 20 31 20 66 69 6c 65 73 2e 0a 20 ormat 1 files..
1c50: 20 2a 2a 0a 20 20 2a 2a 20 42 65 67 69 6e 6e 69 **. ** Beginni
1c60: 6e 67 20 77 69 74 68 20 66 69 6c 65 20 66 6f 72 ng with file for
1c70: 6d 61 74 20 32 2c 20 74 68 65 20 72 6f 77 69 64 mat 2, the rowid
1c80: 20 66 6f 72 20 6e 65 77 20 74 61 62 6c 65 20 65 for new table e
1c90: 6e 74 72 69 65 73 0a 20 20 2a 2a 20 28 69 6e 63 ntries. ** (inc
1ca0: 6c 75 64 69 6e 67 20 65 6e 74 72 69 65 73 20 69 luding entries i
1cb0: 6e 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 29 n sqlite_master)
1cc0: 20 69 73 20 61 6e 20 69 6e 63 72 65 61 73 69 6e is an increasin
1cd0: 67 20 69 6e 74 65 67 65 72 2e 0a 20 20 2a 2a 20 g integer.. **
1ce0: 53 6f 20 66 6f 72 20 66 69 6c 65 20 66 6f 72 6d So for file form
1cf0: 61 74 20 32 20 61 6e 64 20 6c 61 74 65 72 2c 20 at 2 and later,
1d00: 77 65 20 63 61 6e 20 70 6c 61 79 20 62 61 63 6b we can play back
1d10: 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 0a 20 sqlite_master.
1d20: 20 2a 2a 20 61 6e 64 20 61 6c 6c 20 74 68 65 20 ** and all the
1d30: 43 52 45 41 54 45 20 73 74 61 74 65 6d 65 6e 74 CREATE statement
1d40: 73 20 77 69 6c 6c 20 61 70 70 65 61 72 20 69 6e s will appear in
1d50: 20 74 68 65 20 72 69 67 68 74 20 6f 72 64 65 72 the right order
1d60: 2e 0a 20 20 2a 2a 20 42 75 74 20 77 69 74 68 20 .. ** But with
1d70: 66 69 6c 65 20 66 6f 72 6d 61 74 20 31 2c 20 74 file format 1, t
1d80: 61 62 6c 65 20 65 6e 74 72 69 65 73 20 77 65 72 able entries wer
1d90: 65 20 72 61 6e 64 6f 6d 20 61 6e 64 20 73 6f 20 e random and so
1da0: 77 65 0a 20 20 2a 2a 20 68 61 76 65 20 74 6f 20 we. ** have to
1db0: 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 43 52 make sure the CR
1dc0: 45 41 54 45 20 54 41 42 4c 45 73 20 6f 63 63 75 EATE TABLEs occu
1dd0: 72 20 62 65 66 6f 72 65 20 74 68 65 69 72 20 63 r before their c
1de0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 20 20 2a orresponding. *
1df0: 2a 20 43 52 45 41 54 45 20 49 4e 44 45 58 73 2e * CREATE INDEXs.
1e00: 20 20 28 57 65 20 64 6f 6e 27 74 20 68 61 76 65 (We don't have
1e10: 20 74 6f 20 64 65 61 6c 20 77 69 74 68 20 43 52 to deal with CR
1e20: 45 41 54 45 20 56 49 45 57 20 6f 72 0a 20 20 2a EATE VIEW or. *
1e30: 2a 20 43 52 45 41 54 45 20 54 52 49 47 47 45 52 * CREATE TRIGGER
1e40: 20 69 6e 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 in file format
1e50: 31 20 62 65 63 61 75 73 65 20 74 68 6f 73 65 20 1 because those
1e60: 63 6f 6e 73 74 72 75 63 74 73 20 64 69 64 0a 20 constructs did.
1e70: 20 2a 2a 20 6e 6f 74 20 65 78 69 73 74 20 74 68 ** not exist th
1e80: 65 6e 2e 29 20 0a 20 20 2a 2f 0a 20 20 73 74 61 en.) . */. sta
1e90: 74 69 63 20 63 68 61 72 20 69 6e 69 74 5f 73 63 tic char init_sc
1ea0: 72 69 70 74 5b 5d 20 3d 20 0a 20 20 20 20 20 22 ript[] = . "
1eb0: 53 45 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d SELECT type, nam
1ec0: 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c e, rootpage, sql
1ed0: 2c 20 31 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f , 1 FROM sqlite_
1ee0: 74 65 6d 70 5f 6d 61 73 74 65 72 20 22 0a 20 20 temp_master ".
1ef0: 20 20 20 22 55 4e 49 4f 4e 20 41 4c 4c 20 22 0a "UNION ALL ".
1f00: 20 20 20 20 20 22 53 45 4c 45 43 54 20 74 79 70 "SELECT typ
1f10: 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67 e, name, rootpag
1f20: 65 2c 20 73 71 6c 2c 20 30 20 46 52 4f 4d 20 73 e, sql, 0 FROM s
1f30: 71 6c 69 74 65 5f 6d 61 73 74 65 72 22 3b 0a 20 qlite_master";.
1f40: 20 73 74 61 74 69 63 20 63 68 61 72 20 6f 6c 64 static char old
1f50: 65 72 5f 69 6e 69 74 5f 73 63 72 69 70 74 5b 5d er_init_script[]
1f60: 20 3d 20 0a 20 20 20 20 20 22 53 45 4c 45 43 54 = . "SELECT
1f70: 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f type, name, roo
1f80: 74 70 61 67 65 2c 20 73 71 6c 2c 20 31 20 46 52 tpage, sql, 1 FR
1f90: 4f 4d 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d OM sqlite_temp_m
1fa0: 61 73 74 65 72 20 22 0a 20 20 20 20 20 22 55 4e aster ". "UN
1fb0: 49 4f 4e 20 41 4c 4c 20 22 0a 20 20 20 20 20 22 ION ALL ". "
1fc0: 53 45 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d SELECT type, nam
1fd0: 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c e, rootpage, sql
1fe0: 2c 20 30 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f , 0 FROM sqlite_
1ff0: 6d 61 73 74 65 72 20 22 0a 20 20 20 20 20 22 57 master ". "W
2000: 48 45 52 45 20 74 79 70 65 3d 27 74 61 62 6c 65 HERE type='table
2010: 27 20 22 0a 20 20 20 20 20 22 55 4e 49 4f 4e 20 ' ". "UNION
2020: 41 4c 4c 20 22 0a 20 20 20 20 20 22 53 45 4c 45 ALL ". "SELE
2030: 43 54 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20 72 CT type, name, r
2040: 6f 6f 74 70 61 67 65 2c 20 73 71 6c 2c 20 30 20 ootpage, sql, 0
2050: 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 FROM sqlite_mast
2060: 65 72 20 22 0a 20 20 20 20 20 22 57 48 45 52 45 er ". "WHERE
2070: 20 74 79 70 65 3d 27 69 6e 64 65 78 27 22 3b 0a type='index'";.
2080: 0a 0a 20 20 61 73 73 65 72 74 28 20 69 44 62 3e .. assert( iDb>
2090: 3d 30 20 26 26 20 69 44 62 21 3d 31 20 26 26 20 =0 && iDb!=1 &&
20a0: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 0a iDb<db->nDb );..
20b0: 20 20 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74 /* Construct t
20c0: 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 he schema tables
20d0: 3a 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 : sqlite_master
20e0: 61 6e 64 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f and sqlite_temp_
20f0: 6d 61 73 74 65 72 0a 20 20 2a 2f 0a 20 20 73 71 master. */. sq
2100: 6c 69 74 65 53 61 66 65 74 79 4f 66 66 28 64 62 liteSafetyOff(db
2110: 29 3b 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d 20 );. azArg[0] =
2120: 22 74 61 62 6c 65 22 3b 0a 20 20 61 7a 41 72 67 "table";. azArg
2130: 5b 31 5d 20 3d 20 4d 41 53 54 45 52 5f 4e 41 4d [1] = MASTER_NAM
2140: 45 3b 0a 20 20 61 7a 41 72 67 5b 32 5d 20 3d 20 E;. azArg[2] =
2150: 22 32 22 3b 0a 20 20 61 7a 41 72 67 5b 33 5d 20 "2";. azArg[3]
2160: 3d 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 3b = master_schema;
2170: 0a 20 20 73 70 72 69 6e 74 66 28 7a 44 62 4e 75 . sprintf(zDbNu
2180: 6d 2c 20 22 25 64 22 2c 20 69 44 62 29 3b 0a 20 m, "%d", iDb);.
2190: 20 61 7a 41 72 67 5b 34 5d 20 3d 20 7a 44 62 4e azArg[4] = zDbN
21a0: 75 6d 3b 0a 20 20 61 7a 41 72 67 5b 35 5d 20 3d um;. azArg[5] =
21b0: 20 30 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 64 0;. initData.d
21c0: 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69 74 44 61 b = db;. initDa
21d0: 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d 20 70 7a ta.pzErrMsg = pz
21e0: 45 72 72 4d 73 67 3b 0a 20 20 73 71 6c 69 74 65 ErrMsg;. sqlite
21f0: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 26 69 6e InitCallback(&in
2200: 69 74 44 61 74 61 2c 20 35 2c 20 61 7a 41 72 67 itData, 5, azArg
2210: 2c 20 30 29 3b 0a 20 20 70 54 61 62 20 3d 20 73 , 0);. pTab = s
2220: 71 6c 69 74 65 46 69 6e 64 54 61 62 6c 65 28 64 qliteFindTable(d
2230: 62 2c 20 4d 41 53 54 45 52 5f 4e 41 4d 45 2c 20 b, MASTER_NAME,
2240: 22 6d 61 69 6e 22 29 3b 0a 20 20 69 66 28 20 70 "main");. if( p
2250: 54 61 62 20 29 7b 0a 20 20 20 20 70 54 61 62 2d Tab ){. pTab-
2260: 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20 >readOnly = 1;.
2270: 20 7d 0a 20 20 69 66 28 20 69 44 62 3d 3d 30 20 }. if( iDb==0
2280: 29 7b 0a 20 20 20 20 61 7a 41 72 67 5b 31 5d 20 ){. azArg[1]
2290: 3d 20 54 45 4d 50 5f 4d 41 53 54 45 52 5f 4e 41 = TEMP_MASTER_NA
22a0: 4d 45 3b 0a 20 20 20 20 61 7a 41 72 67 5b 33 5d ME;. azArg[3]
22b0: 20 3d 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f 73 = temp_master_s
22c0: 63 68 65 6d 61 3b 0a 20 20 20 20 61 7a 41 72 67 chema;. azArg
22d0: 5b 34 5d 20 3d 20 22 31 22 3b 0a 20 20 20 20 73 [4] = "1";. s
22e0: 71 6c 69 74 65 49 6e 69 74 43 61 6c 6c 62 61 63 qliteInitCallbac
22f0: 6b 28 26 69 6e 69 74 44 61 74 61 2c 20 35 2c 20 k(&initData, 5,
2300: 61 7a 41 72 67 2c 20 30 29 3b 0a 20 20 20 20 70 azArg, 0);. p
2310: 54 61 62 20 3d 20 73 71 6c 69 74 65 46 69 6e 64 Tab = sqliteFind
2320: 54 61 62 6c 65 28 64 62 2c 20 54 45 4d 50 5f 4d Table(db, TEMP_M
2330: 41 53 54 45 52 5f 4e 41 4d 45 2c 20 22 74 65 6d ASTER_NAME, "tem
2340: 70 22 29 3b 0a 20 20 20 20 69 66 28 20 70 54 61 p");. if( pTa
2350: 62 20 29 7b 0a 20 20 20 20 20 20 70 54 61 62 2d b ){. pTab-
2360: 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20 >readOnly = 1;.
2370: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 }. }. sqlit
2380: 65 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 0a eSafetyOn(db);..
2390: 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 63 75 /* Create a cu
23a0: 72 73 6f 72 20 74 6f 20 68 6f 6c 64 20 74 68 65 rsor to hold the
23b0: 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e 0a 20 database open.
23c0: 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 61 44 */. if( db->aD
23d0: 62 5b 69 44 62 5d 2e 70 42 74 3d 3d 30 20 29 20 b[iDb].pBt==0 )
23e0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
23f0: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 42 ;. rc = sqliteB
2400: 74 72 65 65 43 75 72 73 6f 72 28 64 62 2d 3e 61 treeCursor(db->a
2410: 44 62 5b 69 44 62 5d 2e 70 42 74 2c 20 32 2c 20 Db[iDb].pBt, 2,
2420: 30 2c 20 26 63 75 72 4d 61 69 6e 29 3b 0a 20 20 0, &curMain);.
2430: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 73 71 if( rc ){. sq
2440: 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a liteSetString(pz
2450: 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f 65 ErrMsg, sqlite_e
2460: 72 72 6f 72 5f 73 74 72 69 6e 67 28 72 63 29 2c rror_string(rc),
2470: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 (char*)0);.
2480: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a return rc;. }..
2490: 20 20 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74 /* Get the dat
24a0: 61 62 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72 abase meta infor
24b0: 6d 61 74 69 6f 6e 0a 20 20 2a 2f 0a 20 20 72 63 mation. */. rc
24c0: 20 3d 20 73 71 6c 69 74 65 42 74 72 65 65 47 65 = sqliteBtreeGe
24d0: 74 4d 65 74 61 28 64 62 2d 3e 61 44 62 5b 69 44 tMeta(db->aDb[iD
24e0: 62 5d 2e 70 42 74 2c 20 6d 65 74 61 29 3b 0a 20 b].pBt, meta);.
24f0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 73 if( rc ){. s
2500: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 qliteSetString(p
2510: 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f zErrMsg, sqlite_
2520: 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 72 63 29 error_string(rc)
2530: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 , (char*)0);.
2540: 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 sqliteBtreeClos
2550: 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29 eCursor(curMain)
2560: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b ;. return rc;
2570: 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 69 . }. db->aDb[i
2580: 44 62 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 Db].schema_cooki
2590: 65 20 3d 20 6d 65 74 61 5b 31 5d 3b 0a 20 20 69 e = meta[1];. i
25a0: 66 28 20 69 44 62 3d 3d 30 20 29 7b 0a 20 20 20 f( iDb==0 ){.
25b0: 20 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b 69 65 db->next_cookie
25c0: 20 3d 20 6d 65 74 61 5b 31 5d 3b 0a 20 20 20 20 = meta[1];.
25d0: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 db->file_format
25e0: 3d 20 6d 65 74 61 5b 32 5d 3b 0a 20 20 20 20 73 = meta[2];. s
25f0: 69 7a 65 20 3d 20 6d 65 74 61 5b 33 5d 3b 0a 20 ize = meta[3];.
2600: 20 20 20 69 66 28 20 73 69 7a 65 3d 3d 30 20 29 if( size==0 )
2610: 7b 20 73 69 7a 65 20 3d 20 4d 41 58 5f 50 41 47 { size = MAX_PAG
2620: 45 53 3b 20 7d 0a 20 20 20 20 64 62 2d 3e 63 61 ES; }. db->ca
2630: 63 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b che_size = size;
2640: 0a 20 20 20 20 64 62 2d 3e 73 61 66 65 74 79 5f . db->safety_
2650: 6c 65 76 65 6c 20 3d 20 6d 65 74 61 5b 34 5d 3b level = meta[4];
2660: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 73 61 66 . if( db->saf
2670: 65 74 79 5f 6c 65 76 65 6c 3d 3d 30 20 29 20 64 ety_level==0 ) d
2680: 62 2d 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 b->safety_level
2690: 3d 20 32 3b 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 = 2;.. /*.
26a0: 20 2a 2a 20 20 66 69 6c 65 5f 66 6f 72 6d 61 74 ** file_format
26b0: 3d 3d 31 20 20 20 20 56 65 72 73 69 6f 6e 20 32 ==1 Version 2
26c0: 2e 31 2e 30 2e 0a 20 20 20 20 2a 2a 20 20 66 69 .1.0.. ** fi
26d0: 6c 65 5f 66 6f 72 6d 61 74 3d 3d 32 20 20 20 20 le_format==2
26e0: 56 65 72 73 69 6f 6e 20 32 2e 32 2e 30 2e 20 41 Version 2.2.0. A
26f0: 64 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 49 dd support for I
2700: 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b NTEGER PRIMARY K
2710: 45 59 2e 0a 20 20 20 20 2a 2a 20 20 66 69 6c 65 EY.. ** file
2720: 5f 66 6f 72 6d 61 74 3d 3d 33 20 20 20 20 56 65 _format==3 Ve
2730: 72 73 69 6f 6e 20 32 2e 36 2e 30 2e 20 46 69 78 rsion 2.6.0. Fix
2740: 20 65 6d 70 74 79 2d 73 74 72 69 6e 67 20 69 6e empty-string in
2750: 64 65 78 20 62 75 67 2e 0a 20 20 20 20 2a 2a 20 dex bug.. **
2760: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 34 20 file_format==4
2770: 20 20 20 56 65 72 73 69 6f 6e 20 32 2e 37 2e 30 Version 2.7.0
2780: 2e 20 41 64 64 20 73 75 70 70 6f 72 74 20 66 6f . Add support fo
2790: 72 20 73 65 70 61 72 61 74 65 20 6e 75 6d 65 72 r separate numer
27a0: 69 63 20 61 6e 64 0a 20 20 20 20 2a 2a 20 20 20 ic and. **
27b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27c0: 20 74 65 78 74 20 64 61 74 61 74 79 70 65 73 2e text datatypes.
27d0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 . */. if(
27e0: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3d db->file_format=
27f0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 =0 ){. /* T
2800: 68 69 73 20 68 61 70 70 65 6e 73 20 69 66 20 74 his happens if t
2810: 68 65 20 64 61 74 61 62 61 73 65 20 77 61 73 20 he database was
2820: 69 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74 79 20 initially empty
2830: 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 66 69 6c */. db->fil
2840: 65 5f 66 6f 72 6d 61 74 20 3d 20 34 3b 0a 20 20 e_format = 4;.
2850: 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e }else if( db->
2860: 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 34 20 29 7b file_format>4 ){
2870: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 42 74 72 . sqliteBtr
2880: 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75 eeCloseCursor(cu
2890: 72 4d 61 69 6e 29 3b 0a 20 20 20 20 20 20 73 71 rMain);. sq
28a0: 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a liteSetString(pz
28b0: 45 72 72 4d 73 67 2c 20 22 75 6e 73 75 70 70 6f ErrMsg, "unsuppo
28c0: 72 74 65 64 20 66 69 6c 65 20 66 6f 72 6d 61 74 rted file format
28d0: 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 ", (char*)0);.
28e0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
28f0: 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20 E_ERROR;. }.
2900: 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e 66 }else if( db->f
2910: 69 6c 65 5f 66 6f 72 6d 61 74 21 3d 6d 65 74 61 ile_format!=meta
2920: 5b 32 5d 20 7c 7c 20 64 62 2d 3e 66 69 6c 65 5f [2] || db->file_
2930: 66 6f 72 6d 61 74 3c 34 20 29 7b 0a 20 20 20 20 format<4 ){.
2940: 61 73 73 65 72 74 28 20 64 62 2d 3e 66 69 6c 65 assert( db->file
2950: 5f 66 6f 72 6d 61 74 3e 3d 34 20 29 3b 0a 20 20 _format>=4 );.
2960: 20 20 69 66 28 20 6d 65 74 61 5b 32 5d 3d 3d 30 if( meta[2]==0
2970: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
2980: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d SetString(pzErrM
2990: 73 67 2c 20 22 63 61 6e 6e 6f 74 20 61 74 74 61 sg, "cannot atta
29a0: 63 68 20 65 6d 70 74 79 20 64 61 74 61 62 61 73 ch empty databas
29b0: 65 3a 20 22 2c 0a 20 20 20 20 20 20 20 20 20 64 e: ",. d
29c0: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d b->aDb[iDb].zNam
29d0: 65 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 e, (char*)0);.
29e0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 }else{. s
29f0: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 qliteSetString(p
2a00: 7a 45 72 72 4d 73 67 2c 20 22 69 6e 63 6f 6d 70 zErrMsg, "incomp
2a10: 61 74 69 62 6c 65 20 66 69 6c 65 20 66 6f 72 6d atible file form
2a20: 61 74 20 69 6e 20 61 75 78 69 6c 69 61 72 79 20 at in auxiliary
2a30: 22 0a 20 20 20 20 20 20 20 20 20 22 64 61 74 61 ". "data
2a40: 62 61 73 65 3a 20 22 2c 20 64 62 2d 3e 61 44 62 base: ", db->aDb
2a50: 5b 69 44 62 5d 2e 7a 4e 61 6d 65 2c 20 28 63 68 [iDb].zName, (ch
2a60: 61 72 2a 29 30 29 3b 0a 20 20 20 20 7d 0a 20 20 ar*)0);. }.
2a70: 20 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f sqliteBtreeClo
2a80: 73 65 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e se(db->aDb[iDb].
2a90: 70 42 74 29 3b 0a 20 20 20 20 64 62 2d 3e 61 44 pBt);. db->aD
2aa0: 62 5b 69 44 62 5d 2e 70 42 74 20 3d 20 30 3b 0a b[iDb].pBt = 0;.
2ab0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2ac0: 45 5f 46 4f 52 4d 41 54 3b 0a 20 20 7d 0a 20 20 E_FORMAT;. }.
2ad0: 73 71 6c 69 74 65 42 74 72 65 65 53 65 74 43 61 sqliteBtreeSetCa
2ae0: 63 68 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 5b cheSize(db->aDb[
2af0: 69 44 62 5d 2e 70 42 74 2c 20 64 62 2d 3e 63 61 iDb].pBt, db->ca
2b00: 63 68 65 5f 73 69 7a 65 29 3b 0a 20 20 73 71 6c che_size);. sql
2b10: 69 74 65 42 74 72 65 65 53 65 74 53 61 66 65 74 iteBtreeSetSafet
2b20: 79 4c 65 76 65 6c 28 64 62 2d 3e 61 44 62 5b 69 yLevel(db->aDb[i
2b30: 44 62 5d 2e 70 42 74 2c 20 6d 65 74 61 5b 34 5d Db].pBt, meta[4]
2b40: 3d 3d 30 20 3f 20 32 20 3a 20 6d 65 74 61 5b 34 ==0 ? 2 : meta[4
2b50: 5d 29 3b 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74 ]);.. /* Read t
2b60: 68 65 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d he schema inform
2b70: 61 74 69 6f 6e 20 6f 75 74 20 6f 66 20 74 68 65 ation out of the
2b80: 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 0a 20 schema tables.
2b90: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 64 62 */. assert( db
2ba0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20 ->init.busy );.
2bb0: 20 73 71 6c 69 74 65 53 61 66 65 74 79 4f 66 66 sqliteSafetyOff
2bc0: 28 64 62 29 3b 0a 20 20 69 66 28 20 69 44 62 3d (db);. if( iDb=
2bd0: 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 =0 ){. rc = s
2be0: 71 6c 69 74 65 5f 65 78 65 63 28 64 62 2c 20 0a qlite_exec(db, .
2bf0: 20 20 20 20 20 20 20 20 64 62 2d 3e 66 69 6c 65 db->file
2c00: 5f 66 6f 72 6d 61 74 3e 3d 32 20 3f 20 69 6e 69 _format>=2 ? ini
2c10: 74 5f 73 63 72 69 70 74 20 3a 20 6f 6c 64 65 72 t_script : older
2c20: 5f 69 6e 69 74 5f 73 63 72 69 70 74 2c 0a 20 20 _init_script,.
2c30: 20 20 20 20 20 20 73 71 6c 69 74 65 49 6e 69 74 sqliteInit
2c40: 43 61 6c 6c 62 61 63 6b 2c 20 26 69 6e 69 74 44 Callback, &initD
2c50: 61 74 61 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65 ata, 0);. }else
2c60: 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53 71 6c {. char *zSql
2c70: 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 = 0;. sqlite
2c80: 53 65 74 53 74 72 69 6e 67 28 26 7a 53 71 6c 2c SetString(&zSql,
2c90: 20 0a 20 20 20 20 20 20 20 22 53 45 4c 45 43 54 . "SELECT
2ca0: 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f type, name, roo
2cb0: 74 70 61 67 65 2c 20 73 71 6c 2c 20 22 2c 20 7a tpage, sql, ", z
2cc0: 44 62 4e 75 6d 2c 20 22 20 46 52 4f 4d 20 5c 22 DbNum, " FROM \"
2cd0: 22 2c 0a 20 20 20 20 20 20 20 64 62 2d 3e 61 44 ",. db->aD
2ce0: 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 2c 20 22 5c b[iDb].zName, "\
2cf0: 22 2e 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 22 ".sqlite_master"
2d00: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 , (char*)0);.
2d10: 20 72 63 20 3d 20 73 71 6c 69 74 65 5f 65 78 65 rc = sqlite_exe
2d20: 63 28 64 62 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 c(db, zSql, sqli
2d30: 74 65 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 teInitCallback,
2d40: 26 69 6e 69 74 44 61 74 61 2c 20 30 29 3b 0a 20 &initData, 0);.
2d50: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 53 sqliteFree(zS
2d60: 71 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 ql);. }. sqlit
2d70: 65 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 eSafetyOn(db);.
2d80: 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 sqliteBtreeClos
2d90: 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29 eCursor(curMain)
2da0: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 5f 6d ;. if( sqlite_m
2db0: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a alloc_failed ){.
2dc0: 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 sqliteSetStr
2dd0: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f ing(pzErrMsg, "o
2de0: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 28 ut of memory", (
2df0: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 63 char*)0);. rc
2e00: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b = SQLITE_NOMEM;
2e10: 0a 20 20 20 20 73 71 6c 69 74 65 52 65 73 65 74 . sqliteReset
2e20: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 InternalSchema(d
2e30: 62 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66 28 b, 0);. }. if(
2e40: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
2e50: 7b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70 65 {. DbSetPrope
2e60: 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f rty(db, iDb, DB_
2e70: 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 SchemaLoaded);.
2e80: 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29 7b if( iDb==0 ){
2e90: 0a 20 20 20 20 20 20 44 62 53 65 74 50 72 6f 70 . DbSetProp
2ea0: 65 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53 erty(db, 1, DB_S
2eb0: 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 chemaLoaded);.
2ec0: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
2ed0: 20 73 71 6c 69 74 65 52 65 73 65 74 49 6e 74 65 sqliteResetInte
2ee0: 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 69 rnalSchema(db, i
2ef0: 44 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 Db);. }. retur
2f00: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 n rc;.}../*.** I
2f10: 6e 69 74 69 61 6c 69 7a 65 20 61 6c 6c 20 64 61 nitialize all da
2f20: 74 61 62 61 73 65 20 66 69 6c 65 73 20 2d 20 74 tabase files - t
2f30: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 he main database
2f40: 20 66 69 6c 65 2c 20 74 68 65 20 66 69 6c 65 0a file, the file.
2f50: 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 ** used to store
2f60: 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 temporary table
2f70: 73 2c 20 61 6e 64 20 61 6e 79 20 61 64 64 69 74 s, and any addit
2f80: 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66 ional database f
2f90: 69 6c 65 73 0a 2a 2a 20 63 72 65 61 74 65 64 20 iles.** created
2fa0: 75 73 69 6e 67 20 41 54 54 41 43 48 20 73 74 61 using ATTACH sta
2fb0: 74 65 6d 65 6e 74 73 2e 20 20 52 65 74 75 72 6e tements. Return
2fc0: 20 61 20 73 75 63 63 65 73 73 20 63 6f 64 65 2e a success code.
2fd0: 20 20 49 66 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 If an.** error
2fe0: 20 6f 63 63 75 72 73 2c 20 77 72 69 74 65 20 61 occurs, write a
2ff0: 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 n error message
3000: 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a into *pzErrMsg..
3010: 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20 **.** After the
3020: 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 69 74 database is init
3030: 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 53 51 4c ialized, the SQL
3040: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 0a ITE_Initialized.
3050: 2a 2a 20 62 69 74 20 69 73 20 73 65 74 20 69 6e ** bit is set in
3060: 20 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 the flags field
3070: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20 73 of the sqlite s
3080: 74 72 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a 2a tructure. An.**
3090: 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 attempt is made
30a0: 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 to initialize t
30b0: 68 65 20 64 61 74 61 62 61 73 65 20 61 73 20 73 he database as s
30c0: 6f 6f 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73 20 oon as it.** is
30d0: 6f 70 65 6e 65 64 2e 20 20 49 66 20 74 68 61 74 opened. If that
30e0: 20 66 61 69 6c 73 20 28 70 65 72 68 61 70 73 20 fails (perhaps
30f0: 62 65 63 61 75 73 65 20 61 6e 6f 74 68 65 72 20 because another
3100: 70 72 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20 74 process.** has t
3110: 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 he sqlite_master
3120: 20 74 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20 74 table locked) t
3130: 68 61 6e 20 61 6e 6f 74 68 65 72 20 61 74 74 65 han another atte
3140: 6d 70 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20 74 mpt.** is made t
3150: 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 he first time th
3160: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 63 e database is ac
3170: 63 65 73 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 cessed..*/.int s
3180: 71 6c 69 74 65 49 6e 69 74 28 73 71 6c 69 74 65 qliteInit(sqlite
3190: 20 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45 *db, char **pzE
31a0: 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20 69 2c rrMsg){. int i,
31b0: 20 72 63 3b 0a 20 20 0a 20 20 69 66 28 20 64 62 rc;. . if( db
31c0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 20 72 65 ->init.busy ) re
31d0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
31e0: 20 20 61 73 73 65 72 74 28 20 28 64 62 2d 3e 66 assert( (db->f
31f0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49 6e lags & SQLITE_In
3200: 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29 3b itialized)==0 );
3210: 0a 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f . rc = SQLITE_O
3220: 4b 3b 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75 K;. db->init.bu
3230: 73 79 20 3d 20 31 3b 0a 20 20 66 6f 72 28 69 3d sy = 1;. for(i=
3240: 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 0; rc==SQLITE_OK
3250: 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 && i<db->nDb; i
3260: 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 44 62 48 ++){. if( DbH
3270: 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20 69 asProperty(db, i
3280: 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 , DB_SchemaLoade
3290: 64 29 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 d) ) continue;.
32a0: 20 20 20 61 73 73 65 72 74 28 20 69 21 3d 31 20 assert( i!=1
32b0: 29 3b 20 20 2f 2a 20 53 68 6f 75 6c 64 20 68 61 ); /* Should ha
32c0: 76 65 20 62 65 65 6e 20 69 6e 69 74 69 61 6c 69 ve been initiali
32d0: 7a 65 64 20 74 6f 67 65 74 68 65 72 20 77 69 74 zed together wit
32e0: 68 20 30 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 h 0 */. rc =
32f0: 73 71 6c 69 74 65 49 6e 69 74 4f 6e 65 28 64 62 sqliteInitOne(db
3300: 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a , i, pzErrMsg);.
3310: 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
3320: 20 20 20 20 73 71 6c 69 74 65 52 65 73 65 74 49 sqliteResetI
3330: 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 nternalSchema(db
3340: 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a , i);. }. }.
3350: 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 db->init.busy
3360: 3d 20 30 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 = 0;. if( rc==S
3370: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
3380: 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c db->flags |= SQL
3390: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b ITE_Initialized;
33a0: 0a 20 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d 69 . sqliteCommi
33b0: 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 tInternalChanges
33c0: 28 64 62 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 (db);. }.. /*
33d0: 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 If the database
33e0: 69 73 20 69 6e 20 66 6f 72 6d 61 74 73 20 31 20 is in formats 1
33f0: 6f 72 20 32 2c 20 74 68 65 6e 20 75 70 67 72 61 or 2, then upgra
3400: 64 65 20 69 74 20 74 6f 0a 20 20 2a 2a 20 76 65 de it to. ** ve
3410: 72 73 69 6f 6e 20 33 2e 20 20 54 68 69 73 20 77 rsion 3. This w
3420: 69 6c 6c 20 72 65 63 6f 6e 73 74 72 75 63 74 20 ill reconstruct
3430: 61 6c 6c 20 69 6e 64 69 63 65 73 2e 20 20 49 66 all indices. If
3440: 20 74 68 65 0a 20 20 2a 2a 20 75 70 67 72 61 64 the. ** upgrad
3450: 65 20 66 61 69 6c 73 20 66 6f 72 20 61 6e 79 20 e fails for any
3460: 72 65 61 73 6f 6e 20 28 65 78 3a 20 6f 75 74 20 reason (ex: out
3470: 6f 66 20 64 69 73 6b 20 73 70 61 63 65 2c 20 64 of disk space, d
3480: 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 69 73 20 atabase. ** is
3490: 72 65 61 64 20 6f 6e 6c 79 2c 20 69 6e 74 65 72 read only, inter
34a0: 72 75 70 74 20 72 65 63 65 69 76 65 64 2c 20 65 rupt received, e
34b0: 74 63 2e 29 20 74 68 65 6e 20 66 61 69 6c 20 74 tc.) then fail t
34c0: 68 65 20 69 6e 69 74 2e 0a 20 20 2a 2f 0a 20 20 he init.. */.
34d0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
34e0: 4b 20 26 26 20 64 62 2d 3e 66 69 6c 65 5f 66 6f K && db->file_fo
34f0: 72 6d 61 74 3c 33 20 29 7b 0a 20 20 20 20 63 68 rmat<3 ){. ch
3500: 61 72 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 20 20 ar *zErr = 0;.
3510: 20 20 49 6e 69 74 44 61 74 61 20 69 6e 69 74 44 InitData initD
3520: 61 74 61 3b 0a 20 20 20 20 69 6e 74 20 6d 65 74 ata;. int met
3530: 61 5b 53 51 4c 49 54 45 5f 4e 5f 42 54 52 45 45 a[SQLITE_N_BTREE
3540: 5f 4d 45 54 41 5d 3b 0a 0a 20 20 20 20 64 62 2d _META];.. db-
3550: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f >magic = SQLITE_
3560: 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 20 20 MAGIC_OPEN;.
3570: 69 6e 69 74 44 61 74 61 2e 64 62 20 3d 20 64 62 initData.db = db
3580: 3b 0a 20 20 20 20 69 6e 69 74 44 61 74 61 2e 70 ;. initData.p
3590: 7a 45 72 72 4d 73 67 20 3d 20 26 7a 45 72 72 3b zErrMsg = &zErr;
35a0: 0a 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f 66 6f . db->file_fo
35b0: 72 6d 61 74 20 3d 20 33 3b 0a 20 20 20 20 72 63 rmat = 3;. rc
35c0: 20 3d 20 73 71 6c 69 74 65 5f 65 78 65 63 28 64 = sqlite_exec(d
35d0: 62 2c 0a 20 20 20 20 20 20 22 42 45 47 49 4e 3b b,. "BEGIN;
35e0: 20 53 45 4c 45 43 54 20 6e 61 6d 65 20 46 52 4f SELECT name FRO
35f0: 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 M sqlite_master
3600: 57 48 45 52 45 20 74 79 70 65 3d 27 74 61 62 6c WHERE type='tabl
3610: 65 27 3b 22 2c 0a 20 20 20 20 20 20 75 70 67 72 e';",. upgr
3620: 61 64 65 5f 33 5f 63 61 6c 6c 62 61 63 6b 2c 0a ade_3_callback,.
3630: 20 20 20 20 20 20 26 69 6e 69 74 44 61 74 61 2c &initData,
3640: 0a 20 20 20 20 20 20 26 7a 45 72 72 29 3b 0a 20 . &zErr);.
3650: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
3660: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 E_OK ){. sq
3670: 6c 69 74 65 42 74 72 65 65 47 65 74 4d 65 74 61 liteBtreeGetMeta
3680: 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c (db->aDb[0].pBt,
3690: 20 6d 65 74 61 29 3b 0a 20 20 20 20 20 20 6d 65 meta);. me
36a0: 74 61 5b 32 5d 20 3d 20 34 3b 0a 20 20 20 20 20 ta[2] = 4;.
36b0: 20 73 71 6c 69 74 65 42 74 72 65 65 55 70 64 61 sqliteBtreeUpda
36c0: 74 65 4d 65 74 61 28 64 62 2d 3e 61 44 62 5b 30 teMeta(db->aDb[0
36d0: 5d 2e 70 42 74 2c 20 6d 65 74 61 29 3b 0a 20 20 ].pBt, meta);.
36e0: 20 20 20 20 73 71 6c 69 74 65 5f 65 78 65 63 28 sqlite_exec(
36f0: 64 62 2c 20 22 43 4f 4d 4d 49 54 22 2c 20 30 2c db, "COMMIT", 0,
3700: 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 0, 0);. }.
3710: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
3720: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c _OK ){. sql
3730: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 iteSetString(pzE
3740: 72 72 4d 73 67 2c 20 0a 20 20 20 20 20 20 20 20 rrMsg, .
3750: 22 75 6e 61 62 6c 65 20 74 6f 20 75 70 67 72 61 "unable to upgra
3760: 64 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 de database to t
3770: 68 65 20 76 65 72 73 69 6f 6e 20 32 2e 36 20 66 he version 2.6 f
3780: 6f 72 6d 61 74 22 2c 0a 20 20 20 20 20 20 20 20 ormat",.
3790: 7a 45 72 72 20 3f 20 22 3a 20 22 20 3a 20 30 2c zErr ? ": " : 0,
37a0: 20 7a 45 72 72 2c 20 28 63 68 61 72 2a 29 30 29 zErr, (char*)0)
37b0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 ;. }. sqli
37c0: 74 65 5f 66 72 65 65 6d 65 6d 28 7a 45 72 72 29 te_freemem(zErr)
37d0: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 21 ;. }.. if( rc!
37e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
37f0: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e db->flags &= ~
3800: 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a SQLITE_Initializ
3810: 65 64 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e ed;. }. return
3820: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}../*.** Th
3830: 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 e version of the
3840: 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63 6f 6e 73 library.*/.cons
3850: 74 20 63 68 61 72 20 72 63 73 69 64 5b 5d 20 3d t char rcsid[] =
3860: 20 22 40 28 23 29 20 5c 30 34 34 49 64 3a 20 53 "@(#) \044Id: S
3870: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 22 20 QLite version "
3880: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 20 22 SQLITE_VERSION "
3890: 20 24 22 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 $";.const char
38a0: 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 5b 5d sqlite_version[]
38b0: 20 3d 20 53 51 4c 49 54 45 5f 56 45 52 53 49 4f = SQLITE_VERSIO
38c0: 4e 3b 0a 0a 2f 2a 0a 2a 2a 20 44 6f 65 73 20 74 N;../*.** Does t
38d0: 68 65 20 6c 69 62 72 61 72 79 20 65 78 70 65 63 he library expec
38e0: 74 20 64 61 74 61 20 74 6f 20 62 65 20 65 6e 63 t data to be enc
38f0: 6f 64 65 64 20 61 73 20 55 54 46 2d 38 20 6f 72 oded as UTF-8 or
3900: 20 69 73 6f 38 38 35 39 3f 20 20 54 68 65 0a 2a iso8859? The.*
3910: 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 * following glob
3920: 61 6c 20 63 6f 6e 73 74 61 6e 74 20 61 6c 77 61 al constant alwa
3930: 79 73 20 6c 65 74 73 20 75 73 20 6b 6e 6f 77 2e ys lets us know.
3940: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
3950: 45 5f 55 54 46 38 0a 63 6f 6e 73 74 20 63 68 61 E_UTF8.const cha
3960: 72 20 73 71 6c 69 74 65 5f 65 6e 63 6f 64 69 6e r sqlite_encodin
3970: 67 5b 5d 20 3d 20 22 55 54 46 2d 38 22 3b 0a 23 g[] = "UTF-8";.#
3980: 65 6c 73 65 0a 63 6f 6e 73 74 20 63 68 61 72 20 else.const char
3990: 73 71 6c 69 74 65 5f 65 6e 63 6f 64 69 6e 67 5b sqlite_encoding[
39a0: 5d 20 3d 20 22 69 73 6f 38 38 35 39 22 3b 0a 23 ] = "iso8859";.#
39b0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 endif../*.** Ope
39c0: 6e 20 61 20 6e 65 77 20 53 51 4c 69 74 65 20 64 n a new SQLite d
39d0: 61 74 61 62 61 73 65 2e 20 20 43 6f 6e 73 74 72 atabase. Constr
39e0: 75 63 74 20 61 6e 20 22 73 71 6c 69 74 65 22 20 uct an "sqlite"
39f0: 73 74 72 75 63 74 75 72 65 20 74 6f 20 64 65 66 structure to def
3a00: 69 6e 65 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 ine.** the state
3a10: 20 6f 66 20 74 68 69 73 20 64 61 74 61 62 61 73 of this databas
3a20: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 70 e and return a p
3a30: 6f 69 6e 74 65 72 20 74 6f 20 74 68 61 74 20 73 ointer to that s
3a40: 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 tructure..**.**
3a50: 41 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 An attempt is ma
3a60: 64 65 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 de to initialize
3a70: 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 the in-memory d
3a80: 61 74 61 20 73 74 72 75 63 74 75 72 65 73 20 74 ata structures t
3a90: 68 61 74 0a 2a 2a 20 68 6f 6c 64 20 74 68 65 20 hat.** hold the
3aa0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e database schema.
3ab0: 20 20 42 75 74 20 69 66 20 74 68 69 73 20 66 61 But if this fa
3ac0: 69 6c 73 20 28 62 65 63 61 75 73 65 20 74 68 65 ils (because the
3ad0: 20 73 63 68 65 6d 61 20 66 69 6c 65 0a 2a 2a 20 schema file.**
3ae0: 69 73 20 6c 6f 63 6b 65 64 29 20 74 68 65 6e 20 is locked) then
3af0: 74 68 61 74 20 73 74 65 70 20 69 73 20 64 65 66 that step is def
3b00: 65 72 72 65 64 20 75 6e 74 69 6c 20 74 68 65 20 erred until the
3b10: 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 0a 2a 2a first call to.**
3b20: 20 73 71 6c 69 74 65 5f 65 78 65 63 28 29 2e 0a sqlite_exec()..
3b30: 2a 2f 0a 73 71 6c 69 74 65 20 2a 73 71 6c 69 74 */.sqlite *sqlit
3b40: 65 5f 6f 70 65 6e 28 63 6f 6e 73 74 20 63 68 61 e_open(const cha
3b50: 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 69 6e r *zFilename, in
3b60: 74 20 6d 6f 64 65 2c 20 63 68 61 72 20 2a 2a 70 t mode, char **p
3b70: 7a 45 72 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69 zErrMsg){. sqli
3b80: 74 65 20 2a 64 62 3b 0a 20 20 69 6e 74 20 72 63 te *db;. int rc
3b90: 2c 20 69 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 , i;.. /* Alloc
3ba0: 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 20 64 ate the sqlite d
3bb0: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 2a 2f ata structure */
3bc0: 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 65 4d 61 . db = sqliteMa
3bd0: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 73 71 6c lloc( sizeof(sql
3be0: 69 74 65 29 20 29 3b 0a 20 20 69 66 28 20 70 7a ite) );. if( pz
3bf0: 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72 72 4d ErrMsg ) *pzErrM
3c00: 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20 64 62 sg = 0;. if( db
3c10: 3d 3d 30 20 29 20 67 6f 74 6f 20 6e 6f 5f 6d 65 ==0 ) goto no_me
3c20: 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20 20 64 62 2d m_on_open;. db-
3c30: 3e 6f 6e 45 72 72 6f 72 20 3d 20 4f 45 5f 44 65 >onError = OE_De
3c40: 66 61 75 6c 74 3b 0a 20 20 64 62 2d 3e 70 72 69 fault;. db->pri
3c50: 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b 0a orNewRowid = 0;.
3c60: 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 db->magic = SQ
3c70: 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 3b LITE_MAGIC_BUSY;
3c80: 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b 0a . db->nDb = 2;.
3c90: 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 2d 3e db->aDb = db->
3ca0: 61 44 62 53 74 61 74 69 63 3b 0a 20 20 2f 2a 20 aDbStatic;. /*
3cb0: 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c db->flags |= SQL
3cc0: 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 ITE_ShortColName
3cd0: 73 3b 20 2a 2f 0a 20 20 73 71 6c 69 74 65 48 61 s; */. sqliteHa
3ce0: 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 46 75 6e shInit(&db->aFun
3cf0: 63 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 c, SQLITE_HASH_S
3d00: 54 52 49 4e 47 2c 20 31 29 3b 0a 20 20 66 6f 72 TRING, 1);. for
3d10: 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b (i=0; i<db->nDb;
3d20: 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 i++){. sqlit
3d30: 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 eHashInit(&db->a
3d40: 44 62 5b 69 5d 2e 74 62 6c 48 61 73 68 2c 20 53 Db[i].tblHash, S
3d50: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e QLITE_HASH_STRIN
3d60: 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 G, 0);. sqlit
3d70: 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 eHashInit(&db->a
3d80: 44 62 5b 69 5d 2e 69 64 78 48 61 73 68 2c 20 53 Db[i].idxHash, S
3d90: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e QLITE_HASH_STRIN
3da0: 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 G, 0);. sqlit
3db0: 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 eHashInit(&db->a
3dc0: 44 62 5b 69 5d 2e 74 72 69 67 48 61 73 68 2c 20 Db[i].trigHash,
3dd0: 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 SQLITE_HASH_STRI
3de0: 4e 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 NG, 0);. sqli
3df0: 74 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e teHashInit(&db->
3e00: 61 44 62 5b 69 5d 2e 61 46 4b 65 79 2c 20 53 51 aDb[i].aFKey, SQ
3e10: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 LITE_HASH_STRING
3e20: 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f , 1);. }. . /
3e30: 2a 20 4f 70 65 6e 20 74 68 65 20 62 61 63 6b 65 * Open the backe
3e40: 6e 64 20 64 61 74 61 62 61 73 65 20 64 72 69 76 nd database driv
3e50: 65 72 20 2a 2f 0a 20 20 69 66 28 20 7a 46 69 6c er */. if( zFil
3e60: 65 6e 61 6d 65 5b 30 5d 3d 3d 27 3a 27 20 26 26 ename[0]==':' &&
3e70: 20 73 74 72 63 6d 70 28 7a 46 69 6c 65 6e 61 6d strcmp(zFilenam
3e80: 65 2c 22 3a 6d 65 6d 6f 72 79 3a 22 29 3d 3d 30 e,":memory:")==0
3e90: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 74 65 6d 70 ){. db->temp
3ea0: 5f 73 74 6f 72 65 20 3d 20 32 3b 0a 20 20 7d 0a _store = 2;. }.
3eb0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 42 74 72 rc = sqliteBtr
3ec0: 65 65 46 61 63 74 6f 72 79 28 64 62 2c 20 7a 46 eeFactory(db, zF
3ed0: 69 6c 65 6e 61 6d 65 2c 20 30 2c 20 4d 41 58 5f ilename, 0, MAX_
3ee0: 50 41 47 45 53 2c 20 26 64 62 2d 3e 61 44 62 5b PAGES, &db->aDb[
3ef0: 30 5d 2e 70 42 74 29 3b 0a 20 20 69 66 28 20 72 0].pBt);. if( r
3f00: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
3f10: 20 20 20 20 73 77 69 74 63 68 28 20 72 63 20 29 switch( rc )
3f20: 7b 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a {. default:
3f30: 20 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 {. sqlit
3f40: 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 eSetString(pzErr
3f50: 4d 73 67 2c 20 22 75 6e 61 62 6c 65 20 74 6f 20 Msg, "unable to
3f60: 6f 70 65 6e 20 64 61 74 61 62 61 73 65 3a 20 22 open database: "
3f70: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 7a 46 69 ,. zFi
3f80: 6c 65 6e 61 6d 65 2c 20 28 63 68 61 72 2a 29 30 lename, (char*)0
3f90: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d );. }. }
3fa0: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 . sqliteFree(
3fb0: 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 db);. sqliteS
3fc0: 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d trRealloc(pzErrM
3fd0: 73 67 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 sg);. return
3fe0: 30 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 0;. }. db->aDb
3ff0: 5b 30 5d 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69 [0].zName = "mai
4000: 6e 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d n";. db->aDb[1]
4010: 2e 7a 4e 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b .zName = "temp";
4020: 0a 0a 20 20 2f 2a 20 41 74 74 65 6d 70 74 20 74 .. /* Attempt t
4030: 6f 20 72 65 61 64 20 74 68 65 20 73 63 68 65 6d o read the schem
4040: 61 20 2a 2f 0a 20 20 73 71 6c 69 74 65 52 65 67 a */. sqliteReg
4050: 69 73 74 65 72 42 75 69 6c 74 69 6e 46 75 6e 63 isterBuiltinFunc
4060: 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20 72 63 20 tions(db);. rc
4070: 3d 20 73 71 6c 69 74 65 49 6e 69 74 28 64 62 2c = sqliteInit(db,
4080: 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 64 62 pzErrMsg);. db
4090: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 ->magic = SQLITE
40a0: 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 69 _MAGIC_OPEN;. i
40b0: 66 28 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 f( sqlite_malloc
40c0: 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 _failed ){. s
40d0: 71 6c 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b qlite_close(db);
40e0: 0a 20 20 20 20 67 6f 74 6f 20 6e 6f 5f 6d 65 6d . goto no_mem
40f0: 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20 20 7d 65 6c 73 _on_open;. }els
4100: 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 e if( rc!=SQLITE
4110: 5f 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54 _OK && rc!=SQLIT
4120: 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 73 71 E_BUSY ){. sq
4130: 6c 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a lite_close(db);.
4140: 20 20 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 sqliteStrRea
4150: 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a lloc(pzErrMsg);.
4160: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
4170: 7d 65 6c 73 65 20 69 66 28 20 70 7a 45 72 72 4d }else if( pzErrM
4180: 73 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 sg ){. sqlite
4190: 46 72 65 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b Free(*pzErrMsg);
41a0: 0a 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d . *pzErrMsg =
41b0: 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 0;. }.. /* Re
41c0: 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 turn a pointer t
41d0: 6f 20 74 68 65 20 6e 65 77 6c 79 20 6f 70 65 6e o the newly open
41e0: 65 64 20 64 61 74 61 62 61 73 65 20 73 74 72 75 ed database stru
41f0: 63 74 75 72 65 20 2a 2f 0a 20 20 72 65 74 75 72 cture */. retur
4200: 6e 20 64 62 3b 0a 0a 6e 6f 5f 6d 65 6d 5f 6f 6e n db;..no_mem_on
4210: 5f 6f 70 65 6e 3a 0a 20 20 73 71 6c 69 74 65 53 _open:. sqliteS
4220: 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 etString(pzErrMs
4230: 67 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 g, "out of memor
4240: 79 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 y", (char*)0);.
4250: 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f sqliteStrReallo
4260: 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 c(pzErrMsg);. r
4270: 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a eturn 0;.}../*.*
4280: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 52 4f 57 * Return the ROW
4290: 49 44 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 ID of the most r
42a0: 65 63 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f 0a ecent insert.*/.
42b0: 69 6e 74 20 73 71 6c 69 74 65 5f 6c 61 73 74 5f int sqlite_last_
42c0: 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c insert_rowid(sql
42d0: 69 74 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 ite *db){. retu
42e0: 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 rn db->lastRowid
42f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
4300: 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
4310: 63 68 61 6e 67 65 73 20 69 6e 20 74 68 65 20 6d changes in the m
4320: 6f 73 74 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 ost recent call
4330: 74 6f 20 73 71 6c 69 74 65 5f 65 78 65 63 28 29 to sqlite_exec()
4340: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f ..*/.int sqlite_
4350: 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 20 2a changes(sqlite *
4360: 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 db){. return db
4370: 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a ->nChange;.}../*
4380: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e .** Return the n
4390: 75 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 umber of changes
43a0: 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 produced by the
43b0: 20 6c 61 73 74 20 49 4e 53 45 52 54 2c 20 55 50 last INSERT, UP
43c0: 44 41 54 45 2c 20 6f 72 0a 2a 2a 20 44 45 4c 45 DATE, or.** DELE
43d0: 54 45 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 TE statement to
43e0: 63 6f 6d 70 6c 65 74 65 20 65 78 65 63 75 74 69 complete executi
43f0: 6f 6e 2e 20 54 68 65 20 63 6f 75 6e 74 20 64 6f on. The count do
4400: 65 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 0a 2a es not include.*
4410: 2a 20 63 68 61 6e 67 65 73 20 64 75 65 20 74 6f * changes due to
4420: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 SQL statements
4430: 65 78 65 63 75 74 65 64 20 69 6e 20 74 72 69 67 executed in trig
4440: 67 65 72 20 70 72 6f 67 72 61 6d 73 20 74 68 61 ger programs tha
4450: 74 20 77 65 72 65 0a 2a 2a 20 74 72 69 67 67 65 t were.** trigge
4460: 72 65 64 20 62 79 20 74 68 61 74 20 73 74 61 74 red by that stat
4470: 65 6d 65 6e 74 0a 2a 2f 0a 69 6e 74 20 73 71 6c ement.*/.int sql
4480: 69 74 65 5f 6c 61 73 74 5f 73 74 61 74 65 6d 65 ite_last_stateme
4490: 6e 74 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 nt_changes(sqlit
44a0: 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e e *db){. return
44b0: 20 64 62 2d 3e 6c 73 43 68 61 6e 67 65 3b 0a 7d db->lsChange;.}
44c0: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e ../*.** Close an
44d0: 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 existing SQLite
44e0: 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 76 6f 69 database.*/.voi
44f0: 64 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28 73 d sqlite_close(s
4500: 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 48 61 qlite *db){. Ha
4510: 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 69 6e 74 shElem *i;. int
4520: 20 6a 3b 0a 20 20 64 62 2d 3e 77 61 6e 74 5f 74 j;. db->want_t
4530: 6f 5f 63 6c 6f 73 65 20 3d 20 31 3b 0a 20 20 69 o_close = 1;. i
4540: 66 28 20 73 71 6c 69 74 65 53 61 66 65 74 79 43 f( sqliteSafetyC
4550: 68 65 63 6b 28 64 62 29 20 7c 7c 20 73 71 6c 69 heck(db) || sqli
4560: 74 65 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29 teSafetyOn(db) )
4570: 7b 0a 20 20 20 20 2f 2a 20 70 72 69 6e 74 66 28 {. /* printf(
4580: 22 44 49 44 20 4e 4f 54 20 43 4c 4f 53 45 5c 6e "DID NOT CLOSE\n
4590: 22 29 3b 20 66 66 6c 75 73 68 28 73 74 64 6f 75 "); fflush(stdou
45a0: 74 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 t); */. retur
45b0: 6e 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6d 61 67 n;. }. db->mag
45c0: 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 ic = SQLITE_MAGI
45d0: 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 66 6f 72 28 C_CLOSED;. for(
45e0: 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 j=0; j<db->nDb;
45f0: 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 j++){. struct
4600: 20 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e Db *pDb = &db->
4610: 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 aDb[j];. if(
4620: 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 pDb->pBt ){.
4630: 20 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f sqliteBtreeClo
4640: 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20 se(pDb->pBt);.
4650: 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 30 pDb->pBt = 0
4660: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 ;. }. }. sq
4670: 6c 69 74 65 52 65 73 65 74 49 6e 74 65 72 6e 61 liteResetInterna
4680: 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a lSchema(db, 0);.
4690: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e 44 assert( db->nD
46a0: 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72 74 b<=2 );. assert
46b0: 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 ( db->aDb==db->a
46c0: 44 62 53 74 61 74 69 63 20 29 3b 0a 20 20 66 6f DbStatic );. fo
46d0: 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 r(i=sqliteHashFi
46e0: 72 73 74 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b rst(&db->aFunc);
46f0: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 i; i=sqliteHash
4700: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 46 75 Next(i)){. Fu
4710: 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c 20 2a 70 ncDef *pFunc, *p
4720: 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72 28 70 46 Next;. for(pF
4730: 75 6e 63 20 3d 20 28 46 75 6e 63 44 65 66 2a 29 unc = (FuncDef*)
4740: 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 69 sqliteHashData(i
4750: 29 3b 20 70 46 75 6e 63 3b 20 70 46 75 6e 63 3d ); pFunc; pFunc=
4760: 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 70 4e pNext){. pN
4770: 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e 70 4e 65 ext = pFunc->pNe
4780: 78 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 xt;. sqlite
4790: 46 72 65 65 28 70 46 75 6e 63 29 3b 0a 20 20 20 Free(pFunc);.
47a0: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 48 }. }. sqliteH
47b0: 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 46 ashClear(&db->aF
47c0: 75 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 unc);. sqliteFr
47d0: 65 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ee(db);.}../*.**
47e0: 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 64 61 Rollback all da
47f0: 74 61 62 61 73 65 20 66 69 6c 65 73 2e 0a 2a 2f tabase files..*/
4800: 0a 76 6f 69 64 20 73 71 6c 69 74 65 52 6f 6c 6c .void sqliteRoll
4810: 62 61 63 6b 41 6c 6c 28 73 71 6c 69 74 65 20 2a backAll(sqlite *
4820: 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 db){. int i;.
4830: 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e for(i=0; i<db->n
4840: 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 Db; i++){. if
4850: 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 ( db->aDb[i].pBt
4860: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
4870: 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 BtreeRollback(db
4880: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 29 3b 0a 20 ->aDb[i].pBt);.
4890: 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69 5d 2e db->aDb[i].
48a0: 69 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 20 inTrans = 0;.
48b0: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 52 }. }. sqliteR
48c0: 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 esetInternalSche
48d0: 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 2f 2a 20 ma(db, 0);. /*
48e0: 73 71 6c 69 74 65 52 6f 6c 6c 62 61 63 6b 49 6e sqliteRollbackIn
48f0: 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 ternalChanges(db
4900: 29 3b 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 ); */.}../*.** E
4910: 78 65 63 75 74 65 20 53 51 4c 20 63 6f 64 65 2e xecute SQL code.
4920: 20 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 Return one of
4930: 74 68 65 20 53 51 4c 49 54 45 5f 20 73 75 63 63 the SQLITE_ succ
4940: 65 73 73 2f 66 61 69 6c 75 72 65 0a 2a 2a 20 63 ess/failure.** c
4950: 6f 64 65 73 2e 20 20 41 6c 73 6f 20 77 72 69 74 odes. Also writ
4960: 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 e an error messa
4970: 67 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f ge into memory o
4980: 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 btained from.**
4990: 6d 61 6c 6c 6f 63 28 29 20 61 6e 64 20 6d 61 6b malloc() and mak
49a0: 65 20 2a 70 7a 45 72 72 4d 73 67 20 70 6f 69 6e e *pzErrMsg poin
49b0: 74 20 74 6f 20 74 68 61 74 20 6d 65 73 73 61 67 t to that messag
49c0: 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 e..**.** If the
49d0: 53 51 4c 20 69 73 20 61 20 71 75 65 72 79 2c 20 SQL is a query,
49e0: 74 68 65 6e 20 66 6f 72 20 65 61 63 68 20 72 6f then for each ro
49f0: 77 20 69 6e 20 74 68 65 20 71 75 65 72 79 20 72 w in the query r
4a00: 65 73 75 6c 74 0a 2a 2a 20 74 68 65 20 78 43 61 esult.** the xCa
4a10: 6c 6c 62 61 63 6b 28 29 20 66 75 6e 63 74 69 6f llback() functio
4a20: 6e 20 69 73 20 63 61 6c 6c 65 64 2e 20 20 70 41 n is called. pA
4a30: 72 67 20 62 65 63 6f 6d 65 73 20 74 68 65 20 66 rg becomes the f
4a40: 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 irst.** argument
4a50: 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 2e to xCallback().
4a60: 20 20 49 66 20 78 43 61 6c 6c 62 61 63 6b 3d 4e If xCallback=N
4a70: 55 4c 4c 20 74 68 65 6e 20 6e 6f 20 63 61 6c 6c ULL then no call
4a80: 62 61 63 6b 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b back.** is invok
4a90: 65 64 2c 20 65 76 65 6e 20 66 6f 72 20 71 75 65 ed, even for que
4aa0: 72 69 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ries..*/.int sql
4ab0: 69 74 65 5f 65 78 65 63 28 0a 20 20 73 71 6c 69 ite_exec(. sqli
4ac0: 74 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 te *db,
4ad0: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 /* The d
4ae0: 61 74 61 62 61 73 65 20 6f 6e 20 77 68 69 63 68 atabase on which
4af0: 20 74 68 65 20 53 51 4c 20 65 78 65 63 75 74 65 the SQL execute
4b00: 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 s */. const cha
4b10: 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 r *zSql,
4b20: 20 20 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 6f /* The SQL to
4b30: 20 62 65 20 65 78 65 63 75 74 65 64 20 2a 2f 0a be executed */.
4b40: 20 20 73 71 6c 69 74 65 5f 63 61 6c 6c 62 61 63 sqlite_callbac
4b50: 6b 20 78 43 61 6c 6c 62 61 63 6b 2c 20 20 2f 2a k xCallback, /*
4b60: 20 49 6e 76 6f 6b 65 20 74 68 69 73 20 63 61 6c Invoke this cal
4b70: 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20 2a 2f lback routine */
4b80: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 20 20 . void *pArg,
4b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
4ba0: 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 * First argument
4bb0: 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 to xCallback()
4bc0: 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 */. char **pzEr
4bd0: 72 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 rMsg
4be0: 20 2f 2a 20 57 72 69 74 65 20 65 72 72 6f 72 20 /* Write error
4bf0: 6d 65 73 73 61 67 65 73 20 68 65 72 65 20 2a 2f messages here */
4c00: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 .){. int rc = S
4c10: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 6f 6e 73 QLITE_OK;. cons
4c20: 74 20 63 68 61 72 20 2a 7a 4c 65 66 74 6f 76 65 t char *zLeftove
4c30: 72 3b 0a 20 20 73 71 6c 69 74 65 5f 76 6d 20 2a r;. sqlite_vm *
4c40: 70 56 6d 3b 0a 20 20 69 6e 74 20 6e 52 65 74 72 pVm;. int nRetr
4c50: 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 43 68 y = 0;. int nCh
4c60: 61 6e 67 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20 ange = 0;. int
4c70: 6e 43 61 6c 6c 62 61 63 6b 3b 0a 0a 20 20 69 66 nCallback;.. if
4c80: 28 20 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 ( zSql==0 ) retu
4c90: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
4ca0: 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 while( rc==SQLIT
4cb0: 45 5f 4f 4b 20 26 26 20 7a 53 71 6c 5b 30 5d 20 E_OK && zSql[0]
4cc0: 29 7b 0a 20 20 20 20 70 56 6d 20 3d 20 30 3b 0a ){. pVm = 0;.
4cd0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 5f rc = sqlite_
4ce0: 63 6f 6d 70 69 6c 65 28 64 62 2c 20 7a 53 71 6c compile(db, zSql
4cf0: 2c 20 26 7a 4c 65 66 74 6f 76 65 72 2c 20 26 70 , &zLeftover, &p
4d00: 56 6d 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 Vm, pzErrMsg);.
4d10: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
4d20: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 73 E_OK ){. as
4d30: 73 65 72 74 28 20 70 56 6d 3d 3d 30 20 7c 7c 20 sert( pVm==0 ||
4d40: 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 sqlite_malloc_fa
4d50: 69 6c 65 64 20 29 3b 0a 20 20 20 20 20 20 72 65 iled );. re
4d60: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
4d70: 20 20 20 69 66 28 20 70 56 6d 3d 3d 30 20 29 7b if( pVm==0 ){
4d80: 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 68 . /* This h
4d90: 61 70 70 65 6e 73 20 69 66 20 74 68 65 20 7a 53 appens if the zS
4da0: 71 6c 20 69 6e 70 75 74 20 63 6f 6e 74 61 69 6e ql input contain
4db0: 65 64 20 6f 6e 6c 79 20 77 68 69 74 65 73 70 61 ed only whitespa
4dc0: 63 65 20 2a 2f 0a 20 20 20 20 20 20 62 72 65 61 ce */. brea
4dd0: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 2d k;. }. db-
4de0: 3e 6e 43 68 61 6e 67 65 20 2b 3d 20 6e 43 68 61 >nChange += nCha
4df0: 6e 67 65 3b 0a 20 20 20 20 6e 43 61 6c 6c 62 61 nge;. nCallba
4e00: 63 6b 20 3d 20 30 3b 0a 20 20 20 20 77 68 69 6c ck = 0;. whil
4e10: 65 28 31 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 e(1){. int
4e20: 6e 41 72 67 3b 0a 20 20 20 20 20 20 63 68 61 72 nArg;. char
4e30: 20 2a 2a 61 7a 41 72 67 2c 20 2a 2a 61 7a 43 6f **azArg, **azCo
4e40: 6c 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 l;. rc = sq
4e50: 6c 69 74 65 5f 73 74 65 70 28 70 56 6d 2c 20 26 lite_step(pVm, &
4e60: 6e 41 72 67 2c 20 28 63 6f 6e 73 74 20 63 68 61 nArg, (const cha
4e70: 72 2a 2a 2a 29 26 61 7a 41 72 67 2c 28 63 6f 6e r***)&azArg,(con
4e80: 73 74 20 63 68 61 72 2a 2a 2a 29 26 61 7a 43 6f st char***)&azCo
4e90: 6c 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 l);. if( rc
4ea0: 3d 3d 53 51 4c 49 54 45 5f 52 4f 57 20 29 7b 0a ==SQLITE_ROW ){.
4eb0: 20 20 20 20 20 20 20 20 69 66 28 20 78 43 61 6c if( xCal
4ec0: 6c 62 61 63 6b 21 3d 30 20 26 26 20 78 43 61 6c lback!=0 && xCal
4ed0: 6c 62 61 63 6b 28 70 41 72 67 2c 20 6e 41 72 67 lback(pArg, nArg
4ee0: 2c 20 61 7a 41 72 67 2c 20 61 7a 43 6f 6c 29 20 , azArg, azCol)
4ef0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c ){. sql
4f00: 69 74 65 5f 66 69 6e 61 6c 69 7a 65 28 70 56 6d ite_finalize(pVm
4f10: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 , 0);.
4f20: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 41 42 return SQLITE_AB
4f30: 4f 52 54 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ORT;. }.
4f40: 20 20 20 20 20 20 20 6e 43 61 6c 6c 62 61 63 6b nCallback
4f50: 2b 2b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b ++;. }else{
4f60: 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d . if( rc=
4f70: 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 26 26 20 =SQLITE_DONE &&
4f80: 6e 43 61 6c 6c 62 61 63 6b 3d 3d 30 0a 20 20 20 nCallback==0.
4f90: 20 20 20 20 20 20 20 26 26 20 28 64 62 2d 3e 66 && (db->f
4fa0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4e 75 lags & SQLITE_Nu
4fb0: 6c 6c 43 61 6c 6c 62 61 63 6b 29 21 3d 30 20 26 llCallback)!=0 &
4fc0: 26 20 78 43 61 6c 6c 62 61 63 6b 21 3d 30 20 29 & xCallback!=0 )
4fd0: 7b 0a 20 20 20 20 20 20 20 20 20 20 78 43 61 6c {. xCal
4fe0: 6c 62 61 63 6b 28 70 41 72 67 2c 20 6e 41 72 67 lback(pArg, nArg
4ff0: 2c 20 61 7a 41 72 67 2c 20 61 7a 43 6f 6c 29 3b , azArg, azCol);
5000: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
5010: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 5f 66 rc = sqlite_f
5020: 69 6e 61 6c 69 7a 65 28 70 56 6d 2c 20 70 7a 45 inalize(pVm, pzE
5030: 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 20 20 rrMsg);.
5040: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 53 if( rc==SQLITE_S
5050: 43 48 45 4d 41 20 26 26 20 6e 52 65 74 72 79 3c CHEMA && nRetry<
5060: 32 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 2 ){. n
5070: 52 65 74 72 79 2b 2b 3b 0a 20 20 20 20 20 20 20 Retry++;.
5080: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
5090: 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 K;. bre
50a0: 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ak;. }.
50b0: 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 70 56 if( db->pV
50c0: 64 62 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 dbe==0 ){.
50d0: 20 20 20 20 6e 43 68 61 6e 67 65 20 3d 20 64 62 nChange = db
50e0: 2d 3e 6e 43 68 61 6e 67 65 3b 0a 20 20 20 20 20 ->nChange;.
50f0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 6e 52 65 }. nRe
5100: 74 72 79 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 try = 0;.
5110: 20 7a 53 71 6c 20 3d 20 7a 4c 65 66 74 6f 76 65 zSql = zLeftove
5120: 72 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 r;. while
5130: 28 20 69 73 73 70 61 63 65 28 7a 53 71 6c 5b 30 ( isspace(zSql[0
5140: 5d 29 20 29 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 ]) ) zSql++;.
5150: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
5160: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 }. }. }.
5170: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f return rc;.}.../
5180: 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 61 20 73 *.** Compile a s
5190: 69 6e 67 6c 65 20 73 74 61 74 65 6d 65 6e 74 20 ingle statement
51a0: 6f 66 20 53 51 4c 20 69 6e 74 6f 20 61 20 76 69 of SQL into a vi
51b0: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 20 rtual machine.
51c0: 52 65 74 75 72 6e 20 6f 6e 65 0a 2a 2a 20 6f 66 Return one.** of
51d0: 20 74 68 65 20 53 51 4c 49 54 45 5f 20 73 75 63 the SQLITE_ suc
51e0: 63 65 73 73 2f 66 61 69 6c 75 72 65 20 63 6f 64 cess/failure cod
51f0: 65 73 2e 20 20 41 6c 73 6f 20 77 72 69 74 65 20 es. Also write
5200: 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 an error message
5210: 20 69 6e 74 6f 0a 2a 2a 20 6d 65 6d 6f 72 79 20 into.** memory
5220: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 6d 61 obtained from ma
5230: 6c 6c 6f 63 28 29 20 61 6e 64 20 6d 61 6b 65 20 lloc() and make
5240: 2a 70 7a 45 72 72 4d 73 67 20 70 6f 69 6e 74 20 *pzErrMsg point
5250: 74 6f 20 74 68 61 74 20 6d 65 73 73 61 67 65 2e to that message.
5260: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 .*/.int sqlite_c
5270: 6f 6d 70 69 6c 65 28 0a 20 20 73 71 6c 69 74 65 ompile(. sqlite
5280: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
5290: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
52a0: 61 62 61 73 65 20 6f 6e 20 77 68 69 63 68 20 74 abase on which t
52b0: 68 65 20 53 51 4c 20 65 78 65 63 75 74 65 73 20 he SQL executes
52c0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
52d0: 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 20 *zSql,
52e0: 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 6f 20 62 /* The SQL to b
52f0: 65 20 65 78 65 63 75 74 65 64 20 2a 2f 0a 20 20 e executed */.
5300: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 const char **pzT
5310: 61 69 6c 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f ail, /* O
5320: 55 54 3a 20 4e 65 78 74 20 73 74 61 74 65 6d 65 UT: Next stateme
5330: 6e 74 20 61 66 74 65 72 20 74 68 65 20 66 69 72 nt after the fir
5340: 73 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 76 st */. sqlite_v
5350: 6d 20 2a 2a 70 70 56 6d 2c 20 20 20 20 20 20 20 m **ppVm,
5360: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 68 65 20 /* OUT: The
5370: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 virtual machine
5380: 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 */. char **pzEr
5390: 72 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 rMsg
53a0: 20 2f 2a 20 4f 55 54 3a 20 57 72 69 74 65 20 65 /* OUT: Write e
53b0: 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 rror messages he
53c0: 72 65 20 2a 2f 0a 29 7b 0a 20 20 50 61 72 73 65 re */.){. Parse
53d0: 20 73 50 61 72 73 65 3b 0a 0a 20 20 69 66 28 20 sParse;.. if(
53e0: 70 7a 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72 pzErrMsg ) *pzEr
53f0: 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20 rMsg = 0;. if(
5400: 73 71 6c 69 74 65 53 61 66 65 74 79 4f 6e 28 64 sqliteSafetyOn(d
5410: 62 29 20 29 20 67 6f 74 6f 20 65 78 65 63 5f 6d b) ) goto exec_m
5420: 69 73 75 73 65 3b 0a 20 20 69 66 28 20 21 64 62 isuse;. if( !db
5430: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 ->init.busy ){.
5440: 20 20 20 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 if( (db->flag
5450: 73 20 26 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 s & SQLITE_Initi
5460: 61 6c 69 7a 65 64 29 3d 3d 30 20 29 7b 0a 20 20 alized)==0 ){.
5470: 20 20 20 20 69 6e 74 20 72 63 2c 20 63 6e 74 20 int rc, cnt
5480: 3d 20 31 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 = 1;. while
5490: 28 20 28 72 63 20 3d 20 73 71 6c 69 74 65 49 6e ( (rc = sqliteIn
54a0: 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29 it(db, pzErrMsg)
54b0: 29 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 0a 20 )==SQLITE_BUSY.
54c0: 20 20 20 20 20 20 20 20 26 26 20 64 62 2d 3e 78 && db->x
54d0: 42 75 73 79 43 61 6c 6c 62 61 63 6b 0a 20 20 20 BusyCallback.
54e0: 20 20 20 20 20 20 26 26 20 64 62 2d 3e 78 42 75 && db->xBu
54f0: 73 79 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 syCallback(db->p
5500: 42 75 73 79 41 72 67 2c 20 22 22 2c 20 63 6e 74 BusyArg, "", cnt
5510: 2b 2b 29 21 3d 30 20 29 7b 7d 0a 20 20 20 20 20 ++)!=0 ){}.
5520: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
5530: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 OK ){. sq
5540: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 liteStrRealloc(p
5550: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 zErrMsg);.
5560: 20 20 73 71 6c 69 74 65 53 61 66 65 74 79 4f 66 sqliteSafetyOf
5570: 66 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 72 f(db);. r
5580: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
5590: 7d 0a 20 20 20 20 20 20 69 66 28 20 70 7a 45 72 }. if( pzEr
55a0: 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 20 20 rMsg ){.
55b0: 73 71 6c 69 74 65 46 72 65 65 28 2a 70 7a 45 72 sqliteFree(*pzEr
55c0: 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 20 20 2a rMsg);. *
55d0: 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 pzErrMsg = 0;.
55e0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 }. }.
55f0: 69 66 28 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 if( db->file_for
5600: 6d 61 74 3c 33 20 29 7b 0a 20 20 20 20 20 20 73 mat<3 ){. s
5610: 71 6c 69 74 65 53 61 66 65 74 79 4f 66 66 28 64 qliteSafetyOff(d
5620: 62 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 b);. sqlite
5630: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d SetString(pzErrM
5640: 73 67 2c 20 22 6f 62 73 6f 6c 65 74 65 20 64 61 sg, "obsolete da
5650: 74 61 62 61 73 65 20 66 69 6c 65 20 66 6f 72 6d tabase file form
5660: 61 74 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a at", (char*)0);.
5670: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
5680: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d ITE_ERROR;. }
5690: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 28 . }. assert( (
56a0: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 db->flags & SQLI
56b0: 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 21 TE_Initialized)!
56c0: 3d 30 20 7c 7c 20 64 62 2d 3e 69 6e 69 74 2e 62 =0 || db->init.b
56d0: 75 73 79 20 29 3b 0a 20 20 69 66 28 20 64 62 2d usy );. if( db-
56e0: 3e 70 56 64 62 65 3d 3d 30 20 29 7b 20 64 62 2d >pVdbe==0 ){ db-
56f0: 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b 20 7d 0a >nChange = 0; }.
5700: 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65 memset(&sParse
5710: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 , 0, sizeof(sPar
5720: 73 65 29 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 se));. sParse.d
5730: 62 20 3d 20 64 62 3b 0a 20 20 73 71 6c 69 74 65 b = db;. sqlite
5740: 52 75 6e 50 61 72 73 65 72 28 26 73 50 61 72 73 RunParser(&sPars
5750: 65 2c 20 7a 53 71 6c 2c 20 70 7a 45 72 72 4d 73 e, zSql, pzErrMs
5760: 67 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 78 54 g);. if( db->xT
5770: 72 61 63 65 20 29 7b 0a 20 20 20 20 2f 2a 20 54 race ){. /* T
5780: 72 61 63 65 20 6f 6e 6c 79 20 74 68 65 20 73 74 race only the st
5790: 61 74 6d 65 6e 74 20 74 68 61 74 20 77 61 73 20 atment that was
57a0: 63 6f 6d 70 69 6c 65 64 2e 0a 20 20 20 20 2a 2a compiled.. **
57b0: 20 4d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 20 Make a copy of
57c0: 74 68 61 74 20 70 61 72 74 20 6f 66 20 74 68 65 that part of the
57d0: 20 53 51 4c 20 73 74 72 69 6e 67 20 73 69 6e 63 SQL string sinc
57e0: 65 20 7a 53 51 4c 20 69 73 20 63 6f 6e 73 74 0a e zSQL is const.
57f0: 20 20 20 20 2a 2a 20 61 6e 64 20 77 65 20 6d 75 ** and we mu
5800: 73 74 20 70 61 73 73 20 61 20 7a 65 72 6f 20 74 st pass a zero t
5810: 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69 6e 67 erminated string
5820: 20 74 6f 20 74 68 65 20 74 72 61 63 65 20 66 75 to the trace fu
5830: 6e 63 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 54 68 nction. ** Th
5840: 65 20 63 6f 70 79 20 69 73 20 75 6e 6e 65 63 65 e copy is unnece
5850: 73 73 61 72 79 20 69 66 20 74 68 65 20 74 61 69 ssary if the tai
5860: 6c 20 70 6f 69 6e 74 65 72 20 69 73 20 70 6f 69 l pointer is poi
5870: 6e 74 69 6e 67 20 61 74 20 74 68 65 0a 20 20 20 nting at the.
5880: 20 2a 2a 20 62 65 67 69 6e 6e 69 67 20 6f 72 20 ** beginnig or
5890: 65 6e 64 20 6f 66 20 74 68 65 20 53 51 4c 20 73 end of the SQL s
58a0: 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 tring.. */.
58b0: 20 20 69 66 28 20 73 50 61 72 73 65 2e 7a 54 61 if( sParse.zTa
58c0: 69 6c 20 26 26 20 73 50 61 72 73 65 2e 7a 54 61 il && sParse.zTa
58d0: 69 6c 21 3d 7a 53 71 6c 20 26 26 20 2a 73 50 61 il!=zSql && *sPa
58e0: 72 73 65 2e 7a 54 61 69 6c 20 29 7b 0a 20 20 20 rse.zTail ){.
58f0: 20 20 20 63 68 61 72 20 2a 74 6d 70 53 71 6c 20 char *tmpSql
5900: 3d 20 73 71 6c 69 74 65 53 74 72 4e 44 75 70 28 = sqliteStrNDup(
5910: 7a 53 71 6c 2c 20 73 50 61 72 73 65 2e 7a 54 61 zSql, sParse.zTa
5920: 69 6c 20 2d 20 7a 53 71 6c 29 3b 0a 20 20 20 20 il - zSql);.
5930: 20 20 69 66 28 20 74 6d 70 53 71 6c 20 29 7b 0a if( tmpSql ){.
5940: 20 20 20 20 20 20 20 20 64 62 2d 3e 78 54 72 61 db->xTra
5950: 63 65 28 64 62 2d 3e 70 54 72 61 63 65 41 72 67 ce(db->pTraceArg
5960: 2c 20 74 6d 70 53 71 6c 29 3b 0a 20 20 20 20 20 , tmpSql);.
5970: 20 20 20 66 72 65 65 28 74 6d 70 53 71 6c 29 3b free(tmpSql);
5980: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
5990: 20 20 20 20 20 20 2f 2a 20 49 66 20 61 20 6d 65 /* If a me
59a0: 6d 6f 72 79 20 65 72 72 6f 72 20 6f 63 63 75 72 mory error occur
59b0: 72 65 64 20 64 75 72 69 6e 67 20 74 68 65 20 63 red during the c
59c0: 6f 70 79 2c 0a 20 20 20 20 20 20 20 20 2a 2a 20 opy,. **
59d0: 74 72 61 63 65 20 65 6e 74 69 72 65 20 53 51 4c trace entire SQL
59e0: 20 73 74 72 69 6e 67 20 61 6e 64 20 66 61 6c 6c string and fall
59f0: 20 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65 0a through to the.
5a00: 20 20 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 ** sqlit
5a10: 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 e_malloc_failed
5a20: 74 65 73 74 20 74 6f 20 72 65 70 6f 72 74 20 74 test to report t
5a30: 68 65 20 65 72 72 6f 72 2e 0a 20 20 20 20 20 20 he error..
5a40: 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 64 62 2d */. db-
5a50: 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54 72 61 >xTrace(db->pTra
5a60: 63 65 41 72 67 2c 20 7a 53 71 6c 29 3b 20 0a 20 ceArg, zSql); .
5a70: 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 }. }else
5a80: 7b 0a 20 20 20 20 20 20 64 62 2d 3e 78 54 72 61 {. db->xTra
5a90: 63 65 28 64 62 2d 3e 70 54 72 61 63 65 41 72 67 ce(db->pTraceArg
5aa0: 2c 20 7a 53 71 6c 29 3b 20 0a 20 20 20 20 7d 0a , zSql); . }.
5ab0: 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 }. if( sqlite
5ac0: 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 _malloc_failed )
5ad0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 {. sqliteSetS
5ae0: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 tring(pzErrMsg,
5af0: 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c "out of memory",
5b00: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 (char*)0);.
5b10: 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 sParse.rc = SQLI
5b20: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 73 71 TE_NOMEM;. sq
5b30: 6c 69 74 65 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 liteRollbackAll(
5b40: 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 52 db);. sqliteR
5b50: 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 esetInternalSche
5b60: 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 20 20 64 ma(db, 0);. d
5b70: 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c b->flags &= ~SQL
5b80: 49 54 45 5f 49 6e 54 72 61 6e 73 3b 0a 20 20 7d ITE_InTrans;. }
5b90: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 72 63 . if( sParse.rc
5ba0: 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 20 ==SQLITE_DONE )
5bb0: 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 sParse.rc = SQLI
5bc0: 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 73 50 61 TE_OK;. if( sPa
5bd0: 72 73 65 2e 72 63 21 3d 53 51 4c 49 54 45 5f 4f rse.rc!=SQLITE_O
5be0: 4b 20 26 26 20 70 7a 45 72 72 4d 73 67 20 26 26 K && pzErrMsg &&
5bf0: 20 2a 70 7a 45 72 72 4d 73 67 3d 3d 30 20 29 7b *pzErrMsg==0 ){
5c00: 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 . sqliteSetSt
5c10: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 73 ring(pzErrMsg, s
5c20: 71 6c 69 74 65 5f 65 72 72 6f 72 5f 73 74 72 69 qlite_error_stri
5c30: 6e 67 28 73 50 61 72 73 65 2e 72 63 29 2c 20 28 ng(sParse.rc), (
5c40: 63 68 61 72 2a 29 30 29 3b 0a 20 20 7d 0a 20 20 char*)0);. }.
5c50: 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 sqliteStrRealloc
5c60: 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 (pzErrMsg);. if
5c70: 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c ( sParse.rc==SQL
5c80: 49 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20 20 ITE_SCHEMA ){.
5c90: 20 20 73 71 6c 69 74 65 52 65 73 65 74 49 6e 74 sqliteResetInt
5ca0: 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 ernalSchema(db,
5cb0: 30 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 0);. }. assert
5cc0: 28 20 70 70 56 6d 20 29 3b 0a 20 20 2a 70 70 56 ( ppVm );. *ppV
5cd0: 6d 20 3d 20 28 73 71 6c 69 74 65 5f 76 6d 2a 29 m = (sqlite_vm*)
5ce0: 73 50 61 72 73 65 2e 70 56 64 62 65 3b 0a 20 20 sParse.pVdbe;.
5cf0: 69 66 28 20 70 7a 54 61 69 6c 20 29 20 2a 70 7a if( pzTail ) *pz
5d00: 54 61 69 6c 20 3d 20 73 50 61 72 73 65 2e 7a 54 Tail = sParse.zT
5d10: 61 69 6c 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 ail;. if( sqlit
5d20: 65 53 61 66 65 74 79 4f 66 66 28 64 62 29 20 29 eSafetyOff(db) )
5d30: 20 67 6f 74 6f 20 65 78 65 63 5f 6d 69 73 75 73 goto exec_misus
5d40: 65 3b 0a 20 20 72 65 74 75 72 6e 20 73 50 61 72 e;. return sPar
5d50: 73 65 2e 72 63 3b 0a 0a 65 78 65 63 5f 6d 69 73 se.rc;..exec_mis
5d60: 75 73 65 3a 0a 20 20 69 66 28 20 70 7a 45 72 72 use:. if( pzErr
5d70: 4d 73 67 20 29 7b 0a 20 20 20 20 2a 70 7a 45 72 Msg ){. *pzEr
5d80: 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20 20 73 71 rMsg = 0;. sq
5d90: 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a liteSetString(pz
5da0: 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f 65 ErrMsg, sqlite_e
5db0: 72 72 6f 72 5f 73 74 72 69 6e 67 28 53 51 4c 49 rror_string(SQLI
5dc0: 54 45 5f 4d 49 53 55 53 45 29 2c 20 28 63 68 61 TE_MISUSE), (cha
5dd0: 72 2a 29 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 r*)0);. sqlit
5de0: 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 eStrRealloc(pzEr
5df0: 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 72 65 74 rMsg);. }. ret
5e00: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
5e10: 45 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 E;.}.../*.** The
5e20: 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 following routi
5e30: 6e 65 20 64 65 73 74 72 6f 79 73 20 61 20 76 69 ne destroys a vi
5e40: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 68 rtual machine th
5e50: 61 74 20 69 73 20 63 72 65 61 74 65 64 20 62 79 at is created by
5e60: 0a 2a 2a 20 74 68 65 20 73 71 6c 69 74 65 5f 63 .** the sqlite_c
5e70: 6f 6d 70 69 6c 65 28 29 20 72 6f 75 74 69 6e 65 ompile() routine
5e80: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 ..**.** The inte
5e90: 67 65 72 20 72 65 74 75 72 6e 65 64 20 69 73 20 ger returned is
5ea0: 61 6e 20 53 51 4c 49 54 45 5f 20 73 75 63 63 65 an SQLITE_ succe
5eb0: 73 73 2f 66 61 69 6c 75 72 65 20 63 6f 64 65 20 ss/failure code
5ec0: 74 68 61 74 20 64 65 73 63 72 69 62 65 73 0a 2a that describes.*
5ed0: 2a 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 * the result of
5ee0: 65 78 65 63 75 74 69 6e 67 20 74 68 65 20 76 69 executing the vi
5ef0: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 20 rtual machine.
5f00: 41 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 An error message
5f10: 20 69 73 0a 2a 2a 20 77 72 69 74 74 65 6e 20 69 is.** written i
5f20: 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 nto memory obtai
5f30: 6e 65 64 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 20 ned from malloc
5f40: 61 6e 64 20 2a 70 7a 45 72 72 4d 73 67 20 69 73 and *pzErrMsg is
5f50: 20 6d 61 64 65 20 74 6f 0a 2a 2a 20 70 6f 69 6e made to.** poin
5f60: 74 20 74 6f 20 74 68 61 74 20 65 72 72 6f 72 20 t to that error
5f70: 69 66 20 70 7a 45 72 72 4d 73 67 20 69 73 20 6e if pzErrMsg is n
5f80: 6f 74 20 4e 55 4c 4c 2e 20 20 54 68 65 20 63 61 ot NULL. The ca
5f90: 6c 6c 69 6e 67 20 72 6f 75 74 69 6e 65 0a 2a 2a lling routine.**
5fa0: 20 73 68 6f 75 6c 64 20 75 73 65 20 73 71 6c 69 should use sqli
5fb0: 74 65 5f 66 72 65 65 6d 65 6d 28 29 20 74 6f 20 te_freemem() to
5fc0: 64 65 6c 65 74 65 20 74 68 65 20 6d 65 73 73 61 delete the messa
5fd0: 67 65 20 77 68 65 6e 20 69 74 20 68 61 73 20 66 ge when it has f
5fe0: 69 6e 69 73 68 65 64 0a 2a 2a 20 77 69 74 68 20 inished.** with
5ff0: 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 it..*/.int sqlit
6000: 65 5f 66 69 6e 61 6c 69 7a 65 28 0a 20 20 73 71 e_finalize(. sq
6010: 6c 69 74 65 5f 76 6d 20 2a 70 56 6d 2c 20 20 20 lite_vm *pVm,
6020: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
6030: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 virtual machine
6040: 74 6f 20 62 65 20 64 65 73 74 72 6f 79 65 64 20 to be destroyed
6050: 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 */. char **pzEr
6060: 72 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 rMsg
6070: 2f 2a 20 4f 55 54 3a 20 57 72 69 74 65 20 65 72 /* OUT: Write er
6080: 72 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 72 ror messages her
6090: 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 e */.){. int rc
60a0: 20 3d 20 73 71 6c 69 74 65 56 64 62 65 46 69 6e = sqliteVdbeFin
60b0: 61 6c 69 7a 65 28 28 56 64 62 65 2a 29 70 56 6d alize((Vdbe*)pVm
60c0: 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 73 , pzErrMsg);. s
60d0: 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 qliteStrRealloc(
60e0: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 pzErrMsg);. ret
60f0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
6100: 20 54 65 72 6d 69 6e 61 74 65 20 74 68 65 20 63 Terminate the c
6110: 75 72 72 65 6e 74 20 65 78 65 63 75 74 69 6f 6e urrent execution
6120: 20 6f 66 20 61 20 76 69 72 74 75 61 6c 20 6d 61 of a virtual ma
6130: 63 68 69 6e 65 20 74 68 65 6e 0a 2a 2a 20 72 65 chine then.** re
6140: 73 65 74 20 74 68 65 20 76 69 72 74 75 61 6c 20 set the virtual
6150: 6d 61 63 68 69 6e 65 20 62 61 63 6b 20 74 6f 20 machine back to
6160: 69 74 73 20 73 74 61 72 74 69 6e 67 20 73 74 61 its starting sta
6170: 74 65 20 73 6f 20 74 68 61 74 20 69 74 0a 2a 2a te so that it.**
6180: 20 63 61 6e 20 62 65 20 72 65 75 73 65 64 2e 20 can be reused.
6190: 20 41 6e 79 20 65 72 72 6f 72 20 6d 65 73 73 61 Any error messa
61a0: 67 65 20 72 65 73 75 6c 74 69 6e 67 20 66 72 6f ge resulting fro
61b0: 6d 20 74 68 65 20 70 72 69 6f 72 20 65 78 65 63 m the prior exec
61c0: 75 74 69 6f 6e 0a 2a 2a 20 69 73 20 77 72 69 74 ution.** is writ
61d0: 74 65 6e 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d ten into *pzErrM
61e0: 73 67 2e 20 20 41 20 73 75 63 63 65 73 73 20 63 sg. A success c
61f0: 6f 64 65 20 66 72 6f 6d 20 74 68 65 20 70 72 69 ode from the pri
6200: 6f 72 20 65 78 65 63 75 74 69 6f 6e 0a 2a 2a 20 or execution.**
6210: 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a is returned..*/.
6220: 69 6e 74 20 73 71 6c 69 74 65 5f 72 65 73 65 74 int sqlite_reset
6230: 28 0a 20 20 73 71 6c 69 74 65 5f 76 6d 20 2a 70 (. sqlite_vm *p
6240: 56 6d 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f Vm, /
6250: 2a 20 54 68 65 20 76 69 72 74 75 61 6c 20 6d 61 * The virtual ma
6260: 63 68 69 6e 65 20 74 6f 20 62 65 20 64 65 73 74 chine to be dest
6270: 72 6f 79 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 royed */. char
6280: 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 **pzErrMsg
6290: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 57 72 /* OUT: Wr
62a0: 69 74 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 ite error messag
62b0: 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 es here */.){.
62c0: 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 56 int rc = sqliteV
62d0: 64 62 65 52 65 73 65 74 28 28 56 64 62 65 2a 29 dbeReset((Vdbe*)
62e0: 70 56 6d 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a pVm, pzErrMsg);.
62f0: 20 20 73 71 6c 69 74 65 56 64 62 65 4d 61 6b 65 sqliteVdbeMake
6300: 52 65 61 64 79 28 28 56 64 62 65 2a 29 70 56 6d Ready((Vdbe*)pVm
6310: 2c 20 2d 31 2c 20 30 29 3b 0a 20 20 73 71 6c 69 , -1, 0);. sqli
6320: 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 teStrRealloc(pzE
6330: 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e rrMsg);. return
6340: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}../*.** Re
6350: 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 74 turn a static st
6360: 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 69 ring that descri
6370: 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 20 bes the kind of
6380: 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 20 error specified
6390: 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65 in the.** argume
63a0: 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 nt..*/.const cha
63b0: 72 20 2a 73 71 6c 69 74 65 5f 65 72 72 6f 72 5f r *sqlite_error_
63c0: 73 74 72 69 6e 67 28 69 6e 74 20 72 63 29 7b 0a string(int rc){.
63d0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b const char *z;
63e0: 0a 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b . switch( rc ){
63f0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6400: 5f 4f 4b 3a 20 20 20 20 20 20 20 20 20 7a 20 3d _OK: z =
6410: 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 3b "not an error";
6420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6430: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6440: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6450: 5f 45 52 52 4f 52 3a 20 20 20 20 20 20 7a 20 3d _ERROR: z =
6460: 20 22 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f "SQL logic erro
6470: 72 20 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74 r or missing dat
6480: 61 62 61 73 65 22 3b 20 20 20 62 72 65 61 6b 3b abase"; break;
6490: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
64a0: 5f 49 4e 54 45 52 4e 41 4c 3a 20 20 20 7a 20 3d _INTERNAL: z =
64b0: 20 22 69 6e 74 65 72 6e 61 6c 20 53 51 4c 69 74 "internal SQLit
64c0: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e e implementation
64d0: 20 66 6c 61 77 22 3b 20 20 20 62 72 65 61 6b 3b flaw"; break;
64e0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
64f0: 5f 50 45 52 4d 3a 20 20 20 20 20 20 20 7a 20 3d _PERM: z =
6500: 20 22 61 63 63 65 73 73 20 70 65 72 6d 69 73 73 "access permiss
6510: 69 6f 6e 20 64 65 6e 69 65 64 22 3b 20 20 20 20 ion denied";
6520: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6530: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6540: 5f 41 42 4f 52 54 3a 20 20 20 20 20 20 7a 20 3d _ABORT: z =
6550: 20 22 63 61 6c 6c 62 61 63 6b 20 72 65 71 75 65 "callback reque
6560: 73 74 65 64 20 71 75 65 72 79 20 61 62 6f 72 74 sted query abort
6570: 22 3b 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b "; break;
6580: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6590: 5f 42 55 53 59 3a 20 20 20 20 20 20 20 7a 20 3d _BUSY: z =
65a0: 20 22 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f "database is lo
65b0: 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 cked";
65c0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
65d0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
65e0: 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 20 7a 20 3d _LOCKED: z =
65f0: 20 22 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 "database table
6600: 20 69 73 20 6c 6f 63 6b 65 64 22 3b 20 20 20 20 is locked";
6610: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6620: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6630: 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 20 7a 20 3d _NOMEM: z =
6640: 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 "out of memory"
6650: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
6660: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6670: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6680: 5f 52 45 41 44 4f 4e 4c 59 3a 20 20 20 7a 20 3d _READONLY: z =
6690: 20 22 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69 "attempt to wri
66a0: 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 20 64 61 te a readonly da
66b0: 74 61 62 61 73 65 22 3b 20 20 62 72 65 61 6b 3b tabase"; break;
66c0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
66d0: 5f 49 4e 54 45 52 52 55 50 54 3a 20 20 7a 20 3d _INTERRUPT: z =
66e0: 20 22 69 6e 74 65 72 72 75 70 74 65 64 22 3b 20 "interrupted";
66f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6700: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6710: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6720: 5f 49 4f 45 52 52 3a 20 20 20 20 20 20 7a 20 3d _IOERR: z =
6730: 20 22 64 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72 "disk I/O error
6740: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ";
6750: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6760: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6770: 5f 43 4f 52 52 55 50 54 3a 20 20 20 20 7a 20 3d _CORRUPT: z =
6780: 20 22 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 "database disk
6790: 69 6d 61 67 65 20 69 73 20 6d 61 6c 66 6f 72 6d image is malform
67a0: 65 64 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b ed"; break;
67b0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
67c0: 5f 4e 4f 54 46 4f 55 4e 44 3a 20 20 20 7a 20 3d _NOTFOUND: z =
67d0: 20 22 74 61 62 6c 65 20 6f 72 20 72 65 63 6f 72 "table or recor
67e0: 64 20 6e 6f 74 20 66 6f 75 6e 64 22 3b 20 20 20 d not found";
67f0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6800: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6810: 5f 46 55 4c 4c 3a 20 20 20 20 20 20 20 7a 20 3d _FULL: z =
6820: 20 22 64 61 74 61 62 61 73 65 20 69 73 20 66 75 "database is fu
6830: 6c 6c 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 ll";
6840: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6850: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6860: 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20 7a 20 3d _CANTOPEN: z =
6870: 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e "unable to open
6880: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 22 3b database file";
6890: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
68a0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
68b0: 5f 50 52 4f 54 4f 43 4f 4c 3a 20 20 20 7a 20 3d _PROTOCOL: z =
68c0: 20 22 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 69 "database locki
68d0: 6e 67 20 70 72 6f 74 6f 63 6f 6c 20 66 61 69 6c ng protocol fail
68e0: 75 72 65 22 3b 20 20 20 20 20 62 72 65 61 6b 3b ure"; break;
68f0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6900: 5f 45 4d 50 54 59 3a 20 20 20 20 20 20 7a 20 3d _EMPTY: z =
6910: 20 22 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73 "table contains
6920: 20 6e 6f 20 64 61 74 61 22 3b 20 20 20 20 20 20 no data";
6930: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6940: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6950: 5f 53 43 48 45 4d 41 3a 20 20 20 20 20 7a 20 3d _SCHEMA: z =
6960: 20 22 64 61 74 61 62 61 73 65 20 73 63 68 65 6d "database schem
6970: 61 20 68 61 73 20 63 68 61 6e 67 65 64 22 3b 20 a has changed";
6980: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6990: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
69a0: 5f 54 4f 4f 42 49 47 3a 20 20 20 20 20 7a 20 3d _TOOBIG: z =
69b0: 20 22 74 6f 6f 20 6d 75 63 68 20 64 61 74 61 20 "too much data
69c0: 66 6f 72 20 6f 6e 65 20 74 61 62 6c 65 20 72 6f for one table ro
69d0: 77 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b w"; break;
69e0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
69f0: 5f 43 4f 4e 53 54 52 41 49 4e 54 3a 20 7a 20 3d _CONSTRAINT: z =
6a00: 20 22 63 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 "constraint fai
6a10: 6c 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 led";
6a20: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6a30: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6a40: 5f 4d 49 53 4d 41 54 43 48 3a 20 20 20 7a 20 3d _MISMATCH: z =
6a50: 20 22 64 61 74 61 74 79 70 65 20 6d 69 73 6d 61 "datatype misma
6a60: 74 63 68 22 3b 20 20 20 20 20 20 20 20 20 20 20 tch";
6a70: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6a80: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6a90: 5f 4d 49 53 55 53 45 3a 20 20 20 20 20 7a 20 3d _MISUSE: z =
6aa0: 20 22 6c 69 62 72 61 72 79 20 72 6f 75 74 69 6e "library routin
6ab0: 65 20 63 61 6c 6c 65 64 20 6f 75 74 20 6f 66 20 e called out of
6ac0: 73 65 71 75 65 6e 63 65 22 3b 62 72 65 61 6b 3b sequence";break;
6ad0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6ae0: 5f 4e 4f 4c 46 53 3a 20 20 20 20 20 20 7a 20 3d _NOLFS: z =
6af0: 20 22 6b 65 72 6e 65 6c 20 6c 61 63 6b 73 20 6c "kernel lacks l
6b00: 61 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 arge file suppor
6b10: 74 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b t"; break;
6b20: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6b30: 5f 41 55 54 48 3a 20 20 20 20 20 20 20 7a 20 3d _AUTH: z =
6b40: 20 22 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 "authorization
6b50: 64 65 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20 denied";
6b60: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6b70: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6b80: 5f 46 4f 52 4d 41 54 3a 20 20 20 20 20 7a 20 3d _FORMAT: z =
6b90: 20 22 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 "auxiliary data
6ba0: 62 61 73 65 20 66 6f 72 6d 61 74 20 65 72 72 6f base format erro
6bb0: 72 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b r"; break;
6bc0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6bd0: 5f 52 41 4e 47 45 3a 20 20 20 20 20 20 7a 20 3d _RANGE: z =
6be0: 20 22 62 69 6e 64 20 69 6e 64 65 78 20 6f 75 74 "bind index out
6bf0: 20 6f 66 20 72 61 6e 67 65 22 3b 20 20 20 20 20 of range";
6c00: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6c10: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
6c20: 5f 4e 4f 54 41 44 42 3a 20 20 20 20 20 7a 20 3d _NOTADB: z =
6c30: 20 22 66 69 6c 65 20 69 73 20 65 6e 63 72 79 70 "file is encryp
6c40: 74 65 64 20 6f 72 20 69 73 20 6e 6f 74 20 61 20 ted or is not a
6c50: 64 61 74 61 62 61 73 65 22 3b 62 72 65 61 6b 3b database";break;
6c60: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 20 20 . default:
6c70: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 20 3d z =
6c80: 20 22 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 "unknown error"
6c90: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
6ca0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
6cb0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b . }. return z;
6cc0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 .}../*.** This r
6cd0: 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 outine implement
6ce0: 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 61 63 s a busy callbac
6cf0: 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 61 6e k that sleeps an
6d00: 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e d tries.** again
6d10: 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 74 until a timeout
6d20: 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 68 65 value is reache
6d30: 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 74 20 d. The timeout
6d40: 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69 value is.** an i
6d50: 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 nteger number of
6d60: 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61 milliseconds pa
6d70: 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 66 ssed in as the f
6d80: 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 irst.** argument
6d90: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
6da0: 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 sqliteDefaultBus
6db0: 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64 yCallback(. void
6dc0: 20 2a 54 69 6d 65 6f 75 74 2c 20 20 20 20 20 20 *Timeout,
6dd0: 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 /* Maximum
6de0: 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 74 amount of time t
6df0: 6f 20 77 61 69 74 20 2a 2f 0a 20 63 6f 6e 73 74 o wait */. const
6e00: 20 63 68 61 72 20 2a 4e 6f 74 55 73 65 64 2c 20 char *NotUsed,
6e10: 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 6d 65 20 /* The name
6e20: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 of the table tha
6e30: 74 20 69 73 20 62 75 73 79 20 2a 2f 0a 20 69 6e t is busy */. in
6e40: 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20 20 t count
6e50: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
6e60: 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65 20 of times table
6e70: 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a 2f has been busy */
6e80: 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d .){.#if SQLITE_M
6e90: 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20 IN_SLEEP_MS==1.
6ea0: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 static const ch
6eb0: 61 72 20 64 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 ar delays[] =.
6ec0: 20 20 20 7b 20 31 2c 20 32 2c 20 35 2c 20 31 30 { 1, 2, 5, 10
6ed0: 2c 20 31 35 2c 20 32 30 2c 20 32 35 2c 20 32 35 , 15, 20, 25, 25
6ee0: 2c 20 20 32 35 2c 20 20 35 30 2c 20 20 35 30 2c , 25, 50, 50,
6ef0: 20 20 35 30 2c 20 31 30 30 7d 3b 0a 20 20 73 74 50, 100};. st
6f00: 61 74 69 63 20 63 6f 6e 73 74 20 73 68 6f 72 74 atic const short
6f10: 20 69 6e 74 20 74 6f 74 61 6c 73 5b 5d 20 3d 0a int totals[] =.
6f20: 20 20 20 20 20 7b 20 30 2c 20 31 2c 20 33 2c 20 { 0, 1, 3,
6f30: 20 38 2c 20 31 38 2c 20 33 33 2c 20 35 33 2c 20 8, 18, 33, 53,
6f40: 37 38 2c 20 31 30 33 2c 20 31 32 38 2c 20 31 37 78, 103, 128, 17
6f50: 38 2c 20 32 32 38 2c 20 32 38 37 7d 3b 0a 23 20 8, 228, 287};.#
6f60: 64 65 66 69 6e 65 20 4e 44 45 4c 41 59 20 28 73 define NDELAY (s
6f70: 69 7a 65 6f 66 28 64 65 6c 61 79 73 29 2f 73 69 izeof(delays)/si
6f80: 7a 65 6f 66 28 64 65 6c 61 79 73 5b 30 5d 29 29 zeof(delays[0]))
6f90: 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d . int timeout =
6fa0: 20 28 69 6e 74 29 54 69 6d 65 6f 75 74 3b 0a 20 (int)Timeout;.
6fb0: 20 69 6e 74 20 64 65 6c 61 79 2c 20 70 72 69 6f int delay, prio
6fc0: 72 3b 0a 0a 20 20 69 66 28 20 63 6f 75 6e 74 20 r;.. if( count
6fd0: 3c 3d 20 4e 44 45 4c 41 59 20 29 7b 0a 20 20 20 <= NDELAY ){.
6fe0: 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b delay = delays[
6ff0: 63 6f 75 6e 74 2d 31 5d 3b 0a 20 20 20 20 70 72 count-1];. pr
7000: 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 63 6f 75 ior = totals[cou
7010: 6e 74 2d 31 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a nt-1];. }else{.
7020: 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 delay = dela
7030: 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b 0a 20 20 ys[NDELAY-1];.
7040: 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 prior = totals
7050: 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20 64 65 6c [NDELAY-1] + del
7060: 61 79 2a 28 63 6f 75 6e 74 2d 4e 44 45 4c 41 59 ay*(count-NDELAY
7070: 2d 31 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 -1);. }. if( p
7080: 72 69 6f 72 20 2b 20 64 65 6c 61 79 20 3e 20 74 rior + delay > t
7090: 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 64 65 imeout ){. de
70a0: 6c 61 79 20 3d 20 74 69 6d 65 6f 75 74 20 2d 20 lay = timeout -
70b0: 70 72 69 6f 72 3b 0a 20 20 20 20 69 66 28 20 64 prior;. if( d
70c0: 65 6c 61 79 3c 3d 30 20 29 20 72 65 74 75 72 6e elay<=0 ) return
70d0: 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 0;. }. sqlite
70e0: 4f 73 53 6c 65 65 70 28 64 65 6c 61 79 29 3b 0a OsSleep(delay);.
70f0: 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6c 73 return 1;.#els
7100: 65 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 e. int timeout
7110: 3d 20 28 69 6e 74 29 54 69 6d 65 6f 75 74 3b 0a = (int)Timeout;.
7120: 20 20 69 66 28 20 28 63 6f 75 6e 74 2b 31 29 2a if( (count+1)*
7130: 31 30 30 30 20 3e 20 74 69 6d 65 6f 75 74 20 29 1000 > timeout )
7140: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a {. return 0;.
7150: 20 20 7d 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c }. sqliteOsSl
7160: 65 65 70 28 31 30 30 30 29 3b 0a 20 20 72 65 74 eep(1000);. ret
7170: 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a urn 1;.#endif.}.
7180: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 ./*.** This rout
7190: 69 6e 65 20 73 65 74 73 20 74 68 65 20 62 75 73 ine sets the bus
71a0: 79 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 y callback for a
71b0: 6e 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 n Sqlite databas
71c0: 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 e to the.** give
71d0: 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 n callback funct
71e0: 69 6f 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 ion with the giv
71f0: 65 6e 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a en argument..*/.
7200: 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 75 73 79 void sqlite_busy
7210: 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 _handler(. sqli
7220: 74 65 20 2a 64 62 2c 0a 20 20 69 6e 74 20 28 2a te *db,. int (*
7230: 78 42 75 73 79 29 28 76 6f 69 64 2a 2c 63 6f 6e xBusy)(void*,con
7240: 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 2c 0a 20 st char*,int),.
7250: 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 void *pArg.){.
7260: 20 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c 62 61 db->xBusyCallba
7270: 63 6b 20 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 ck = xBusy;. db
7280: 2d 3e 70 42 75 73 79 41 72 67 20 3d 20 70 41 72 ->pBusyArg = pAr
7290: 67 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 g;.}..#ifndef SQ
72a0: 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 LITE_OMIT_PROGRE
72b0: 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a SS_CALLBACK./*.*
72c0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 * This routine s
72d0: 65 74 73 20 74 68 65 20 70 72 6f 67 72 65 73 73 ets the progress
72e0: 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e callback for an
72f0: 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 Sqlite database
7300: 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e to the.** given
7310: 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 callback functi
7320: 6f 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65 on with the give
7330: 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 n argument. The
7340: 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 progress callbac
7350: 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 k will.** be inv
7360: 6f 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20 oked every nOps
7370: 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 opcodes..*/.void
7380: 20 73 71 6c 69 74 65 5f 70 72 6f 67 72 65 73 73 sqlite_progress
7390: 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 _handler(. sqli
73a0: 74 65 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e te *db, . int n
73b0: 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72 Ops,. int (*xPr
73c0: 6f 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20 ogress)(void*),
73d0: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b . void *pArg.){
73e0: 0a 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 29 7b . if( nOps>0 ){
73f0: 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 . db->xProgre
7400: 73 73 20 3d 20 78 50 72 6f 67 72 65 73 73 3b 0a ss = xProgress;.
7410: 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 db->nProgres
7420: 73 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a 20 20 20 sOps = nOps;.
7430: 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 db->pProgressAr
7440: 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d 65 6c 73 g = pArg;. }els
7450: 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 e{. db->xProg
7460: 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 ress = 0;. db
7470: 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20 3d ->nProgressOps =
7480: 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72 6f 0;. db->pPro
7490: 67 72 65 73 73 41 72 67 20 3d 20 30 3b 0a 20 20 gressArg = 0;.
74a0: 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a }.}.#endif.../*.
74b0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
74c0: 69 6e 73 74 61 6c 6c 73 20 61 20 64 65 66 61 75 installs a defau
74d0: 6c 74 20 62 75 73 79 20 68 61 6e 64 6c 65 72 20 lt busy handler
74e0: 74 68 61 74 20 77 61 69 74 73 20 66 6f 72 20 74 that waits for t
74f0: 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 65 64 20 he.** specified
7500: 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 number of millis
7510: 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20 72 65 econds before re
7520: 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f 0a 76 6f turning 0..*/.vo
7530: 69 64 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 74 id sqlite_busy_t
7540: 69 6d 65 6f 75 74 28 73 71 6c 69 74 65 20 2a 64 imeout(sqlite *d
7550: 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20 20 69 66 b, int ms){. if
7560: 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20 20 73 71 ( ms>0 ){. sq
7570: 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65 lite_busy_handle
7580: 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65 66 61 r(db, sqliteDefa
7590: 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 2c ultBusyCallback,
75a0: 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a 20 20 7d (void*)ms);. }
75b0: 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 else{. sqlite
75c0: 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 _busy_handler(db
75d0: 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 7d 0a 0a , 0, 0);. }.}..
75e0: 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61 6e 79 20 /*.** Cause any
75f0: 70 65 6e 64 69 6e 67 20 6f 70 65 72 61 74 69 6f pending operatio
7600: 6e 20 74 6f 20 73 74 6f 70 20 61 74 20 69 74 73 n to stop at its
7610: 20 65 61 72 6c 69 65 73 74 20 6f 70 70 6f 72 74 earliest opport
7620: 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 unity..*/.void s
7630: 71 6c 69 74 65 5f 69 6e 74 65 72 72 75 70 74 28 qlite_interrupt(
7640: 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 64 sqlite *db){. d
7650: 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 b->flags |= SQLI
7660: 54 45 5f 49 6e 74 65 72 72 75 70 74 3b 0a 7d 0a TE_Interrupt;.}.
7670: 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77 73 20 73 ./*.** Windows s
7680: 79 73 74 65 6d 73 20 73 68 6f 75 6c 64 20 63 61 ystems should ca
7690: 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ll this routine
76a0: 74 6f 20 66 72 65 65 20 6d 65 6d 6f 72 79 20 74 to free memory t
76b0: 68 61 74 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e hat.** is return
76c0: 65 64 20 69 6e 20 74 68 65 20 69 6e 20 74 68 65 ed in the in the
76d0: 20 65 72 72 6d 73 67 20 70 61 72 61 6d 65 74 65 errmsg paramete
76e0: 72 20 6f 66 20 73 71 6c 69 74 65 5f 6f 70 65 6e r of sqlite_open
76f0: 28 29 20 77 68 65 6e 0a 2a 2a 20 53 51 4c 69 74 () when.** SQLit
7700: 65 20 69 73 20 61 20 44 4c 4c 2e 20 20 46 6f 72 e is a DLL. For
7710: 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c 20 69 74 some reason, it
7720: 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 74 does not work t
7730: 6f 20 63 61 6c 6c 20 66 72 65 65 28 29 0a 2a 2a o call free().**
7740: 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a directly..**.**
7750: 20 4e 6f 74 65 20 74 68 61 74 20 77 65 20 6e 65 Note that we ne
7760: 65 64 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28 ed to call free(
7770: 29 20 6e 6f 74 20 73 71 6c 69 74 65 46 72 65 65 ) not sqliteFree
7780: 28 29 20 68 65 72 65 2c 20 73 69 6e 63 65 20 65 () here, since e
7790: 76 65 72 79 0a 2a 2a 20 73 74 72 69 6e 67 20 74 very.** string t
77a0: 68 61 74 20 69 73 20 65 78 70 6f 72 74 65 64 20 hat is exported
77b0: 66 72 6f 6d 20 53 51 4c 69 74 65 20 73 68 6f 75 from SQLite shou
77c0: 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 ld have already
77d0: 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 0a 2a passed through.*
77e0: 2a 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c * sqliteStrReall
77f0: 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 oc()..*/.void sq
7800: 6c 69 74 65 5f 66 72 65 65 6d 65 6d 28 76 6f 69 lite_freemem(voi
7810: 64 20 2a 70 29 7b 20 66 72 65 65 28 70 29 3b 20 d *p){ free(p);
7820: 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77 73 }../*.** Windows
7830: 20 73 79 73 74 65 6d 73 20 6e 65 65 64 20 66 75 systems need fu
7840: 6e 63 74 69 6f 6e 73 20 74 6f 20 63 61 6c 6c 20 nctions to call
7850: 74 6f 20 72 65 74 75 72 6e 20 74 68 65 20 73 71 to return the sq
7860: 6c 69 74 65 5f 76 65 72 73 69 6f 6e 0a 2a 2a 20 lite_version.**
7870: 61 6e 64 20 73 71 6c 69 74 65 5f 65 6e 63 6f 64 and sqlite_encod
7880: 69 6e 67 20 73 74 72 69 6e 67 73 20 73 69 6e 63 ing strings sinc
7890: 65 20 74 68 65 79 20 61 72 65 20 75 6e 61 62 6c e they are unabl
78a0: 65 20 74 6f 20 61 63 63 65 73 73 20 63 6f 6e 73 e to access cons
78b0: 74 61 6e 74 73 0a 2a 2a 20 77 69 74 68 69 6e 20 tants.** within
78c0: 44 4c 4c 73 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 DLLs..*/.const c
78d0: 68 61 72 20 2a 73 71 6c 69 74 65 5f 6c 69 62 76 har *sqlite_libv
78e0: 65 72 73 69 6f 6e 28 76 6f 69 64 29 7b 20 72 65 ersion(void){ re
78f0: 74 75 72 6e 20 73 71 6c 69 74 65 5f 76 65 72 73 turn sqlite_vers
7900: 69 6f 6e 3b 20 7d 0a 63 6f 6e 73 74 20 63 68 61 ion; }.const cha
7910: 72 20 2a 73 71 6c 69 74 65 5f 6c 69 62 65 6e 63 r *sqlite_libenc
7920: 6f 64 69 6e 67 28 76 6f 69 64 29 7b 20 72 65 74 oding(void){ ret
7930: 75 72 6e 20 73 71 6c 69 74 65 5f 65 6e 63 6f 64 urn sqlite_encod
7940: 69 6e 67 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 ing; }../*.** Cr
7950: 65 61 74 65 20 6e 65 77 20 75 73 65 72 2d 64 65 eate new user-de
7960: 66 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 2e fined functions.
7970: 20 20 54 68 65 20 73 71 6c 69 74 65 5f 63 72 65 The sqlite_cre
7980: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 0a 2a ate_function().*
7990: 2a 20 72 6f 75 74 69 6e 65 20 63 72 65 61 74 65 * routine create
79a0: 73 20 61 20 72 65 67 75 6c 61 72 20 66 75 6e 63 s a regular func
79b0: 74 69 6f 6e 20 61 6e 64 20 73 71 6c 69 74 65 5f tion and sqlite_
79c0: 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74 65 create_aggregate
79d0: 28 29 0a 2a 2a 20 63 72 65 61 74 65 73 20 61 6e ().** creates an
79e0: 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 aggregate funct
79f0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50 61 73 73 69 ion..**.** Passi
7a00: 6e 67 20 61 20 4e 55 4c 4c 20 78 46 75 6e 63 20 ng a NULL xFunc
7a10: 61 72 67 75 6d 65 6e 74 20 6f 72 20 4e 55 4c 4c argument or NULL
7a20: 20 78 53 74 65 70 20 61 6e 64 20 78 46 69 6e 61 xStep and xFina
7a30: 6c 69 7a 65 20 61 72 67 75 6d 65 6e 74 73 0a 2a lize arguments.*
7a40: 2a 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 66 * disables the f
7a50: 75 6e 63 74 69 6f 6e 2e 20 20 43 61 6c 6c 69 6e unction. Callin
7a60: 67 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f g sqlite_create_
7a70: 66 75 6e 63 74 69 6f 6e 28 29 20 77 69 74 68 20 function() with
7a80: 74 68 65 0a 2a 2a 20 73 61 6d 65 20 6e 61 6d 65 the.** same name
7a90: 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f 66 20 61 and number of a
7aa0: 72 67 75 6d 65 6e 74 73 20 61 73 20 61 20 70 72 rguments as a pr
7ab0: 69 6f 72 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 ior call to.** s
7ac0: 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 61 67 67 qlite_create_agg
7ad0: 72 65 67 61 74 65 28 29 20 64 69 73 61 62 6c 65 regate() disable
7ae0: 73 20 74 68 65 20 70 72 69 6f 72 20 63 61 6c 6c s the prior call
7af0: 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 5f 63 72 to.** sqlite_cr
7b00: 65 61 74 65 5f 61 67 67 72 65 67 61 74 65 28 29 eate_aggregate()
7b10: 2c 20 61 6e 64 20 76 69 63 65 20 76 65 72 73 61 , and vice versa
7b20: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 41 72 67 20 ..**.** If nArg
7b30: 69 73 20 2d 31 20 69 74 20 6d 65 61 6e 73 20 74 is -1 it means t
7b40: 68 61 74 20 74 68 69 73 20 66 75 6e 63 74 69 6f hat this functio
7b50: 6e 20 77 69 6c 6c 20 61 63 63 65 70 74 20 61 6e n will accept an
7b60: 79 20 6e 75 6d 62 65 72 0a 2a 2a 20 6f 66 20 61 y number.** of a
7b70: 72 67 75 6d 65 6e 74 73 2c 20 69 6e 63 6c 75 64 rguments, includ
7b80: 69 6e 67 20 30 2e 20 20 54 68 65 20 6d 61 78 69 ing 0. The maxi
7b90: 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 76 61 6c 75 mum allowed valu
7ba0: 65 20 6f 66 20 6e 41 72 67 20 69 73 20 31 32 37 e of nArg is 127
7bb0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f ..*/.int sqlite_
7bc0: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 create_function(
7bd0: 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 . sqlite *db,
7be0: 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74 /* Add t
7bf0: 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74 he function to t
7c00: 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e his database con
7c10: 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e nection */. con
7c20: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 st char *zName,
7c30: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
7c40: 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 61 64 64 function to add
7c50: 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 72 67 2c 20 */. int nArg,
7c60: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
7c70: 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 mber of argument
7c80: 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46 s */. void (*xF
7c90: 75 6e 63 29 28 73 71 6c 69 74 65 5f 66 75 6e 63 unc)(sqlite_func
7ca0: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 *,int,const char
7cb0: 2a 2a 29 2c 20 20 2f 2a 20 54 68 65 20 69 6d 70 **), /* The imp
7cc0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 lementation */.
7cd0: 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 void *pUserData
7ce0: 20 20 20 20 20 20 2f 2a 20 55 73 65 72 20 64 61 /* User da
7cf0: 74 61 20 2a 2f 0a 29 7b 0a 20 20 46 75 6e 63 44 ta */.){. FuncD
7d00: 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e 61 ef *p;. int nNa
7d10: 6d 65 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 me;. if( db==0
7d20: 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 7c 7c 20 73 || zName==0 || s
7d30: 71 6c 69 74 65 53 61 66 65 74 79 43 68 65 63 6b qliteSafetyCheck
7d40: 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 31 3b (db) ) return 1;
7d50: 0a 20 20 69 66 28 20 6e 41 72 67 3c 2d 31 20 7c . if( nArg<-1 |
7d60: 7c 20 6e 41 72 67 3e 31 32 37 20 29 20 72 65 74 | nArg>127 ) ret
7d70: 75 72 6e 20 31 3b 0a 20 20 6e 4e 61 6d 65 20 3d urn 1;. nName =
7d80: 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 3b 0a strlen(zName);.
7d90: 20 20 69 66 28 20 6e 4e 61 6d 65 3e 32 35 35 20 if( nName>255
7da0: 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 20 ) return 1;. p
7db0: 3d 20 73 71 6c 69 74 65 46 69 6e 64 46 75 6e 63 = sqliteFindFunc
7dc0: 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 tion(db, zName,
7dd0: 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 31 29 3b nName, nArg, 1);
7de0: 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65 . if( p==0 ) re
7df0: 74 75 72 6e 20 31 3b 0a 20 20 70 2d 3e 78 46 75 turn 1;. p->xFu
7e00: 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 2d nc = xFunc;. p-
7e10: 3e 78 53 74 65 70 20 3d 20 30 3b 0a 20 20 70 2d >xStep = 0;. p-
7e20: 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 30 3b 0a >xFinalize = 0;.
7e30: 20 20 70 2d 3e 70 55 73 65 72 44 61 74 61 20 3d p->pUserData =
7e40: 20 70 55 73 65 72 44 61 74 61 3b 0a 20 20 72 65 pUserData;. re
7e50: 74 75 72 6e 20 30 3b 0a 7d 0a 69 6e 74 20 73 71 turn 0;.}.int sq
7e60: 6c 69 74 65 5f 63 72 65 61 74 65 5f 61 67 67 72 lite_create_aggr
7e70: 65 67 61 74 65 28 0a 20 20 73 71 6c 69 74 65 20 egate(. sqlite
7e80: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 2f 2a *db, /*
7e90: 20 41 64 64 20 74 68 65 20 66 75 6e 63 74 69 6f Add the functio
7ea0: 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 n to this databa
7eb0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f se connection */
7ec0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
7ed0: 4e 61 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d 65 20 Name, /* Name
7ee0: 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 of the function
7ef0: 74 6f 20 61 64 64 20 2a 2f 0a 20 20 69 6e 74 20 to add */. int
7f00: 6e 41 72 67 2c 20 20 20 20 20 20 20 20 20 20 20 nArg,
7f10: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 /* Number of ar
7f20: 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 76 6f 69 guments */. voi
7f30: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 d (*xStep)(sqlit
7f40: 65 5f 66 75 6e 63 2a 2c 69 6e 74 2c 63 6f 6e 73 e_func*,int,cons
7f50: 74 20 63 68 61 72 2a 2a 29 2c 20 2f 2a 20 54 68 t char**), /* Th
7f60: 65 20 73 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 e step function
7f70: 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e */. void (*xFin
7f80: 61 6c 69 7a 65 29 28 73 71 6c 69 74 65 5f 66 75 alize)(sqlite_fu
7f90: 6e 63 2a 29 2c 20 20 20 20 20 20 20 20 20 20 20 nc*),
7fa0: 20 20 20 2f 2a 20 54 68 65 20 66 69 6e 61 6c 69 /* The finali
7fb0: 7a 65 72 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 zer */. void *p
7fc0: 55 73 65 72 44 61 74 61 20 20 20 20 20 20 2f 2a UserData /*
7fd0: 20 55 73 65 72 20 64 61 74 61 20 2a 2f 0a 29 7b User data */.){
7fe0: 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 3b 0a 20 . FuncDef *p;.
7ff0: 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 20 20 69 66 int nName;. if
8000: 28 20 64 62 3d 3d 30 20 7c 7c 20 7a 4e 61 6d 65 ( db==0 || zName
8010: 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 53 61 66 ==0 || sqliteSaf
8020: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 20 72 etyCheck(db) ) r
8030: 65 74 75 72 6e 20 31 3b 0a 20 20 69 66 28 20 6e eturn 1;. if( n
8040: 41 72 67 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 31 Arg<-1 || nArg>1
8050: 32 37 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 27 ) return 1;.
8060: 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 nName = strlen(
8070: 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 6e 4e zName);. if( nN
8080: 61 6d 65 3e 32 35 35 20 29 20 72 65 74 75 72 6e ame>255 ) return
8090: 20 31 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 1;. p = sqlite
80a0: 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c FindFunction(db,
80b0: 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e zName, nName, n
80c0: 41 72 67 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 Arg, 1);. if( p
80d0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a ==0 ) return 1;.
80e0: 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20 30 3b 0a p->xFunc = 0;.
80f0: 20 20 70 2d 3e 78 53 74 65 70 20 3d 20 78 53 74 p->xStep = xSt
8100: 65 70 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 ep;. p->xFinali
8110: 7a 65 20 3d 20 78 46 69 6e 61 6c 69 7a 65 3b 0a ze = xFinalize;.
8120: 20 20 70 2d 3e 70 55 73 65 72 44 61 74 61 20 3d p->pUserData =
8130: 20 70 55 73 65 72 44 61 74 61 3b 0a 20 20 72 65 pUserData;. re
8140: 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a turn 0;.}../*.**
8150: 20 43 68 61 6e 67 65 20 74 68 65 20 64 61 74 61 Change the data
8160: 74 79 70 65 20 66 6f 72 20 61 6c 6c 20 66 75 6e type for all fun
8170: 63 74 69 6f 6e 73 20 77 69 74 68 20 61 20 67 69 ctions with a gi
8180: 76 65 6e 20 6e 61 6d 65 2e 20 20 53 65 65 20 74 ven name. See t
8190: 68 65 0a 2a 2a 20 68 65 61 64 65 72 20 63 6f 6d he.** header com
81a0: 6d 65 6e 74 20 66 6f 72 20 74 68 65 20 70 72 6f ment for the pro
81b0: 74 6f 74 79 70 65 20 6f 66 20 74 68 69 73 20 66 totype of this f
81c0: 75 6e 63 74 69 6f 6e 20 69 6e 20 73 71 6c 69 74 unction in sqlit
81d0: 65 2e 68 20 66 6f 72 0a 2a 2a 20 61 64 64 69 74 e.h for.** addit
81e0: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f ional informatio
81f0: 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 n..*/.int sqlite
8200: 5f 66 75 6e 63 74 69 6f 6e 5f 74 79 70 65 28 73 _function_type(s
8210: 71 6c 69 74 65 20 2a 64 62 2c 20 63 6f 6e 73 74 qlite *db, const
8220: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e char *zName, in
8230: 74 20 64 61 74 61 54 79 70 65 29 7b 0a 20 20 46 t dataType){. F
8240: 75 6e 63 44 65 66 20 2a 70 20 3d 20 28 46 75 6e uncDef *p = (Fun
8250: 63 44 65 66 2a 29 73 71 6c 69 74 65 48 61 73 68 cDef*)sqliteHash
8260: 46 69 6e 64 28 26 64 62 2d 3e 61 46 75 6e 63 2c Find(&db->aFunc,
8270: 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65 6e 28 7a zName, strlen(z
8280: 4e 61 6d 65 29 29 3b 0a 20 20 77 68 69 6c 65 28 Name));. while(
8290: 20 70 20 29 7b 0a 20 20 20 20 70 2d 3e 64 61 74 p ){. p->dat
82a0: 61 54 79 70 65 20 3d 20 64 61 74 61 54 79 70 65 aType = dataType
82b0: 3b 20 0a 20 20 20 20 70 20 3d 20 70 2d 3e 70 4e ; . p = p->pN
82c0: 65 78 74 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ext;. }. retur
82d0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
82e0: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
82f0: 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 2e trace function.
8300: 20 20 54 68 65 20 70 41 72 67 20 66 72 6f 6d 20 The pArg from
8310: 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 72 the previously r
8320: 65 67 69 73 74 65 72 65 64 20 74 72 61 63 65 0a egistered trace.
8330: 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 ** is returned.
8340: 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c 20 74 .**.** A NULL t
8350: 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 20 6d 65 race function me
8360: 61 6e 73 20 74 68 61 74 20 6e 6f 20 74 72 61 63 ans that no trac
8370: 69 6e 67 20 69 73 20 65 78 65 63 75 74 65 73 2e ing is executes.
8380: 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 A non-NULL.**
8390: 74 72 61 63 65 20 69 73 20 61 20 70 6f 69 6e 74 trace is a point
83a0: 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e er to a function
83b0: 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 64 that is invoked
83c0: 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 at the start of
83d0: 20 65 61 63 68 0a 2a 2a 20 73 71 6c 69 74 65 5f each.** sqlite_
83e0: 65 78 65 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 exec()..*/.void
83f0: 2a 73 71 6c 69 74 65 5f 74 72 61 63 65 28 73 71 *sqlite_trace(sq
8400: 6c 69 74 65 20 2a 64 62 2c 20 76 6f 69 64 20 28 lite *db, void (
8410: 2a 78 54 72 61 63 65 29 28 76 6f 69 64 2a 2c 63 *xTrace)(void*,c
8420: 6f 6e 73 74 20 63 68 61 72 2a 29 2c 20 76 6f 69 onst char*), voi
8430: 64 20 2a 70 41 72 67 29 7b 0a 20 20 76 6f 69 64 d *pArg){. void
8440: 20 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 54 72 *pOld = db->pTr
8450: 61 63 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 54 aceArg;. db->xT
8460: 72 61 63 65 20 3d 20 78 54 72 61 63 65 3b 0a 20 race = xTrace;.
8470: 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 20 3d db->pTraceArg =
8480: 20 70 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 pArg;. return
8490: 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a 2a 2a 20 45 58 pOld;.}../*** EX
84a0: 50 45 52 49 4d 45 4e 54 41 4c 20 2a 2a 2a 0a 2a PERIMENTAL ***.*
84b0: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
84c0: 66 75 6e 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 function to be i
84d0: 6e 76 6f 6b 65 64 20 77 68 65 6e 20 61 20 74 72 nvoked when a tr
84e0: 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 65 6e ansaction commen
84f0: 74 73 2e 0a 2a 2a 20 49 66 20 65 69 74 68 65 72 ts..** If either
8500: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
8510: 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e s non-zero, then
8520: 20 74 68 65 20 63 6f 6d 6d 69 74 20 62 65 63 6f the commit beco
8530: 6d 65 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 mes a.** rollbac
8540: 6b 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 k..*/.void *sqli
8550: 74 65 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a te_commit_hook(.
8560: 20 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 sqlite *db,
8570: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
8580: 74 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 ttach the hook t
8590: 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 o this database
85a0: 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c */. int (*xCall
85b0: 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f back)(void*), /
85c0: 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e * Function to in
85d0: 76 6f 6b 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d voke on each com
85e0: 6d 69 74 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 mit */. void *p
85f0: 41 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 Arg
8600: 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 /* Argument t
8610: 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a o the function *
8620: 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c /.){. void *pOl
8630: 64 20 3d 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 d = db->pCommitA
8640: 72 67 3b 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 rg;. db->xCommi
8650: 74 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c tCallback = xCal
8660: 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f lback;. db->pCo
8670: 6d 6d 69 74 41 72 67 20 3d 20 70 41 72 67 3b 0a mmitArg = pArg;.
8680: 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d return pOld;.}
8690: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f .../*.** This ro
86a0: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 utine is called
86b0: 74 6f 20 63 72 65 61 74 65 20 61 20 63 6f 6e 6e to create a conn
86c0: 65 63 74 69 6f 6e 20 74 6f 20 61 20 64 61 74 61 ection to a data
86d0: 62 61 73 65 20 42 54 72 65 65 0a 2a 2a 20 64 72 base BTree.** dr
86e0: 69 76 65 72 2e 20 20 49 66 20 7a 46 69 6c 65 6e iver. If zFilen
86f0: 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20 ame is the name
8700: 6f 66 20 61 20 66 69 6c 65 2c 20 74 68 65 6e 20 of a file, then
8710: 74 68 61 74 20 66 69 6c 65 20 69 73 0a 2a 2a 20 that file is.**
8720: 6f 70 65 6e 65 64 20 61 6e 64 20 75 73 65 64 2e opened and used.
8730: 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 If zFilename i
8740: 73 20 74 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 s the magic name
8750: 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 68 65 6e ":memory:" then
8760: 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 .** the database
8770: 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 6d 65 is stored in me
8780: 6d 6f 72 79 20 28 61 6e 64 20 69 73 20 74 68 75 mory (and is thu
8790: 73 20 66 6f 72 67 6f 74 74 65 6e 20 61 73 20 73 s forgotten as s
87a0: 6f 6f 6e 20 61 73 0a 2a 2a 20 74 68 65 20 63 6f oon as.** the co
87b0: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 nnection is clos
87c0: 65 64 2e 29 20 20 49 66 20 7a 46 69 6c 65 6e 61 ed.) If zFilena
87d0: 6d 65 20 69 73 20 4e 55 4c 4c 20 74 68 65 6e 20 me is NULL then
87e0: 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 the database.**
87f0: 69 73 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 is for temporary
8800: 20 75 73 65 20 6f 6e 6c 79 20 61 6e 64 20 69 73 use only and is
8810: 20 64 65 6c 65 74 65 64 20 61 73 20 73 6f 6f 6e deleted as soon
8820: 20 61 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 as the connecti
8830: 6f 6e 0a 2a 2a 20 69 73 20 63 6c 6f 73 65 64 2e on.** is closed.
8840: 0a 2a 2a 0a 2a 2a 20 41 20 74 65 6d 70 6f 72 61 .**.** A tempora
8850: 72 79 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 ry database can
8860: 62 65 20 65 69 74 68 65 72 20 61 20 64 69 73 6b be either a disk
8870: 20 66 69 6c 65 20 28 74 68 61 74 20 69 73 20 61 file (that is a
8880: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 2a 2a 20 utomatically.**
8890: 64 65 6c 65 74 65 64 20 77 68 65 6e 20 74 68 65 deleted when the
88a0: 20 66 69 6c 65 20 69 73 20 63 6c 6f 73 65 64 29 file is closed)
88b0: 20 6f 72 20 61 20 73 65 74 20 6f 66 20 72 65 64 or a set of red
88c0: 2d 62 6c 61 63 6b 20 74 72 65 65 73 20 68 65 6c -black trees hel
88d0: 64 20 69 6e 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 d in memory,.**
88e0: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 depending on the
88f0: 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 54 values of the T
8900: 45 4d 50 5f 53 54 4f 52 45 20 63 6f 6d 70 69 6c EMP_STORE compil
8910: 65 2d 74 69 6d 65 20 6d 61 63 72 6f 20 61 6e 64 e-time macro and
8920: 20 74 68 65 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 the.** db->temp
8930: 5f 73 74 6f 72 65 20 76 61 72 69 61 62 6c 65 2c _store variable,
8940: 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 according to th
8950: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 e following char
8960: 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 54 t:.**.** T
8970: 45 4d 50 5f 53 54 4f 52 45 20 20 20 20 20 64 62 EMP_STORE db
8980: 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 20 20 20 ->temp_store
8990: 20 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 65 6d Location of tem
89a0: 70 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 0a porary database.
89b0: 2a 2a 20 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d ** -------
89c0: 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d --- --------
89d0: 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d ------ -----
89e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
89f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 ---------.**
8a00: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 0
8a10: 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20 any
8a20: 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 file.**
8a30: 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 1
8a40: 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 1
8a50: 20 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a file.**
8a60: 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 1
8a70: 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20 2
8a80: 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 memor
8a90: 79 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 31 y.** 1
8aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8ab0: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 0 f
8ac0: 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ile.**
8ad0: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
8ae0: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 1
8af0: 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 file.**
8b00: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 2
8b10: 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 2
8b20: 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 memory.**
8b30: 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 2
8b40: 20 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 0
8b50: 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a memory.**
8b60: 20 20 20 20 20 20 20 20 20 20 20 33 20 20 20 20 3
8b70: 20 20 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 any
8b80: 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 memor
8b90: 79 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 42 y.*/.int sqliteB
8ba0: 74 72 65 65 46 61 63 74 6f 72 79 28 0a 20 20 63 treeFactory(. c
8bb0: 6f 6e 73 74 20 73 71 6c 69 74 65 20 2a 64 62 2c onst sqlite *db,
8bc0: 09 20 20 20 20 2f 2a 20 4d 61 69 6e 20 64 61 74 . /* Main dat
8bd0: 61 62 61 73 65 20 77 68 65 6e 20 6f 70 65 6e 69 abase when openi
8be0: 6e 67 20 61 75 78 20 6f 74 68 65 72 77 69 73 65 ng aux otherwise
8bf0: 20 30 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 0 */. const ch
8c00: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 ar *zFilename,
8c10: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
8c20: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 file containing
8c30: 20 74 68 65 20 42 54 72 65 65 20 64 61 74 61 62 the BTree datab
8c40: 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6f 6d 69 ase */. int omi
8c50: 74 4a 6f 75 72 6e 61 6c 2c 20 20 20 20 20 20 20 tJournal,
8c60: 20 20 20 2f 2a 20 69 66 20 54 52 55 45 20 74 68 /* if TRUE th
8c70: 65 6e 20 64 6f 20 6e 6f 74 20 6a 6f 75 72 6e 61 en do not journa
8c80: 6c 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 l this file */.
8c90: 20 69 6e 74 20 6e 43 61 63 68 65 2c 20 20 20 20 int nCache,
8ca0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 6f /* Ho
8cb0: 77 20 6d 61 6e 79 20 70 61 67 65 73 20 69 6e 20 w many pages in
8cc0: 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20 2a the page cache *
8cd0: 2f 0a 20 20 42 74 72 65 65 20 2a 2a 70 70 42 74 /. Btree **ppBt
8ce0: 72 65 65 29 7b 20 20 20 20 20 20 20 20 20 2f 2a ree){ /*
8cf0: 20 50 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 20 Pointer to new
8d00: 42 74 72 65 65 20 6f 62 6a 65 63 74 20 77 72 69 Btree object wri
8d10: 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a 0a 20 20 tten here */..
8d20: 61 73 73 65 72 74 28 20 70 70 42 74 72 65 65 20 assert( ppBtree
8d30: 21 3d 20 30 29 3b 0a 0a 23 69 66 6e 64 65 66 20 != 0);..#ifndef
8d40: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 4d 45 SQLITE_OMIT_INME
8d50: 4d 4f 52 59 44 42 0a 20 20 69 66 28 20 7a 46 69 MORYDB. if( zFi
8d60: 6c 65 6e 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 lename==0 ){.
8d70: 20 69 66 20 28 54 45 4d 50 5f 53 54 4f 52 45 20 if (TEMP_STORE
8d80: 3d 3d 20 30 29 20 7b 0a 20 20 20 20 20 20 2f 2a == 0) {. /*
8d90: 20 41 6c 77 61 79 73 20 75 73 65 20 66 69 6c 65 Always use file
8da0: 20 62 61 73 65 64 20 74 65 6d 70 6f 72 61 72 79 based temporary
8db0: 20 44 42 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 DB */. ret
8dc0: 75 72 6e 20 73 71 6c 69 74 65 42 74 72 65 65 4f urn sqliteBtreeO
8dd0: 70 65 6e 28 30 2c 20 6f 6d 69 74 4a 6f 75 72 6e pen(0, omitJourn
8de0: 61 6c 2c 20 6e 43 61 63 68 65 2c 20 70 70 42 74 al, nCache, ppBt
8df0: 72 65 65 29 3b 0a 20 20 20 20 7d 20 65 6c 73 65 ree);. } else
8e00: 20 69 66 20 28 54 45 4d 50 5f 53 54 4f 52 45 20 if (TEMP_STORE
8e10: 3d 3d 20 31 20 7c 7c 20 54 45 4d 50 5f 53 54 4f == 1 || TEMP_STO
8e20: 52 45 20 3d 3d 20 32 29 20 7b 0a 20 20 20 20 20 RE == 2) {.
8e30: 20 2f 2a 20 53 77 69 74 63 68 20 64 65 70 65 6e /* Switch depen
8e40: 64 69 6e 67 20 6f 6e 20 63 6f 6d 70 69 6c 65 2d ding on compile-
8e50: 74 69 6d 65 20 61 6e 64 2f 6f 72 20 72 75 6e 74 time and/or runt
8e60: 69 6d 65 20 73 65 74 74 69 6e 67 73 2e 20 2a 2f ime settings. */
8e70: 0a 20 20 20 20 20 20 69 6e 74 20 6c 6f 63 61 74 . int locat
8e80: 69 6f 6e 20 3d 20 64 62 2d 3e 74 65 6d 70 5f 73 ion = db->temp_s
8e90: 74 6f 72 65 3d 3d 30 20 3f 20 54 45 4d 50 5f 53 tore==0 ? TEMP_S
8ea0: 54 4f 52 45 20 3a 20 64 62 2d 3e 74 65 6d 70 5f TORE : db->temp_
8eb0: 73 74 6f 72 65 3b 0a 0a 20 20 20 20 20 20 69 66 store;.. if
8ec0: 20 28 6c 6f 63 61 74 69 6f 6e 20 3d 3d 20 31 29 (location == 1)
8ed0: 20 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 {. retur
8ee0: 6e 20 73 71 6c 69 74 65 42 74 72 65 65 4f 70 65 n sqliteBtreeOpe
8ef0: 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 6f 6d 69 n(zFilename, omi
8f00: 74 4a 6f 75 72 6e 61 6c 2c 20 6e 43 61 63 68 65 tJournal, nCache
8f10: 2c 20 70 70 42 74 72 65 65 29 3b 0a 20 20 20 20 , ppBtree);.
8f20: 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 } else {.
8f30: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 return sqlite
8f40: 52 62 74 72 65 65 4f 70 65 6e 28 30 2c 20 30 2c RbtreeOpen(0, 0,
8f50: 20 30 2c 20 70 70 42 74 72 65 65 29 3b 0a 20 20 0, ppBtree);.
8f60: 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 6c 73 65 }. } else
8f70: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 41 6c 77 61 {. /* Alwa
8f80: 79 73 20 75 73 65 20 69 6e 2d 63 6f 72 65 20 44 ys use in-core D
8f90: 42 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 B */. retur
8fa0: 6e 20 73 71 6c 69 74 65 52 62 74 72 65 65 4f 70 n sqliteRbtreeOp
8fb0: 65 6e 28 30 2c 20 30 2c 20 30 2c 20 70 70 42 74 en(0, 0, 0, ppBt
8fc0: 72 65 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 ree);. }. }e
8fd0: 6c 73 65 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d lse if( zFilenam
8fe0: 65 5b 30 5d 3d 3d 27 3a 27 20 26 26 20 73 74 72 e[0]==':' && str
8ff0: 63 6d 70 28 7a 46 69 6c 65 6e 61 6d 65 2c 22 3a cmp(zFilename,":
9000: 6d 65 6d 6f 72 79 3a 22 29 3d 3d 30 20 29 7b 0a memory:")==0 ){.
9010: 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 return sqlit
9020: 65 52 62 74 72 65 65 4f 70 65 6e 28 30 2c 20 30 eRbtreeOpen(0, 0
9030: 2c 20 30 2c 20 70 70 42 74 72 65 65 29 3b 0a 20 , 0, ppBtree);.
9040: 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 }else.#endif.
9050: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c {. return sql
9060: 69 74 65 42 74 72 65 65 4f 70 65 6e 28 7a 46 69 iteBtreeOpen(zFi
9070: 6c 65 6e 61 6d 65 2c 20 6f 6d 69 74 4a 6f 75 72 lename, omitJour
9080: 6e 61 6c 2c 20 6e 43 61 63 68 65 2c 20 70 70 42 nal, nCache, ppB
9090: 74 72 65 65 29 3b 0a 20 20 7d 0a 7d 0a tree);. }.}.