/ Hex Artifact Content
Login

Artifact f04f93b8928d6d85976e5137fea146a46de1fd6e:


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 30 34 20 32 30 30 32 2f 31 31  ,v 1.104 2002/11
0280: 2f 30 39 20 30 30 3a 33 33 3a 31 36 20 64 72 68  /09 00:33:16 drh
0290: 20 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75   Exp $.*/.#inclu
02a0: 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22  de "sqliteInt.h"
02b0: 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22  .#include "os.h"
02c0: 0a 23 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65  .#include <ctype
02d0: 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 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 0a 2f 2a 0a   InitData;.../*.
03e0: 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 63  ** This is the c
03f0: 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20  allback routine 
0400: 66 6f 72 20 74 68 65 20 63 6f 64 65 20 74 68 61  for the code tha
0410: 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 68  t initializes th
0420: 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20  e.** database.  
0430: 53 65 65 20 73 71 6c 69 74 65 49 6e 69 74 28 29  See sqliteInit()
0440: 20 62 65 6c 6f 77 20 66 6f 72 20 61 64 64 69 74   below for addit
0450: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
0460: 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 63 61  n..**.** Each ca
0470: 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69 6e 73 20  llback contains 
0480: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e  the following in
0490: 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a  formation:.**.**
04a0: 20 20 20 20 20 61 72 67 76 5b 30 5d 20 3d 20 22       argv[0] = "
04b0: 66 69 6c 65 2d 66 6f 72 6d 61 74 22 20 6f 72 20  file-format" or 
04c0: 22 73 63 68 65 6d 61 2d 63 6f 6f 6b 69 65 22 20  "schema-cookie" 
04d0: 6f 72 20 22 74 61 62 6c 65 22 20 6f 72 20 22 69  or "table" or "i
04e0: 6e 64 65 78 22 0a 2a 2a 20 20 20 20 20 61 72 67  ndex".**     arg
04f0: 76 5b 31 5d 20 3d 20 74 61 62 6c 65 20 6f 72 20  v[1] = table or 
0500: 69 6e 64 65 78 20 6e 61 6d 65 20 6f 72 20 6d 65  index name or me
0510: 74 61 20 73 74 61 74 65 6d 65 6e 74 20 74 79 70  ta statement typ
0520: 65 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 32  e..**     argv[2
0530: 5d 20 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e 75  ] = root page nu
0540: 6d 62 65 72 20 66 6f 72 20 74 61 62 6c 65 20 6f  mber for table o
0550: 72 20 69 6e 64 65 78 2e 20 20 4e 55 4c 4c 20 66  r index.  NULL f
0560: 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20 20 20 20 20  or meta..**     
0570: 61 72 67 76 5b 33 5d 20 3d 20 53 51 4c 20 63 72  argv[3] = SQL cr
0580: 65 61 74 65 20 73 74 61 74 65 6d 65 6e 74 20 66  eate statement f
0590: 6f 72 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20  or the table or 
05a0: 69 6e 64 65 78 0a 2a 2a 20 20 20 20 20 61 72 67  index.**     arg
05b0: 76 5b 34 5d 20 3d 20 22 31 22 20 66 6f 72 20 74  v[4] = "1" for t
05c0: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2c 20  emporary files, 
05d0: 22 30 22 20 66 6f 72 20 6d 61 69 6e 20 64 61 74  "0" for main dat
05e0: 61 62 61 73 65 0a 2a 2a 0a 2a 2f 0a 73 74 61 74  abase.**.*/.stat
05f0: 69 63 0a 69 6e 74 20 73 71 6c 69 74 65 49 6e 69  ic.int sqliteIni
0600: 74 43 61 6c 6c 62 61 63 6b 28 76 6f 69 64 20 2a  tCallback(void *
0610: 70 49 6e 69 74 2c 20 69 6e 74 20 61 72 67 63 2c  pInit, int argc,
0620: 20 63 68 61 72 20 2a 2a 61 72 67 76 2c 20 63 68   char **argv, ch
0630: 61 72 20 2a 2a 61 7a 43 6f 6c 4e 61 6d 65 29 7b  ar **azColName){
0640: 0a 20 20 49 6e 69 74 44 61 74 61 20 2a 70 44 61  .  InitData *pDa
0650: 74 61 20 3d 20 28 49 6e 69 74 44 61 74 61 2a 29  ta = (InitData*)
0660: 70 49 6e 69 74 3b 0a 20 20 50 61 72 73 65 20 73  pInit;.  Parse s
0670: 50 61 72 73 65 3b 0a 20 20 69 6e 74 20 6e 45 72  Parse;.  int nEr
0680: 72 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 54 4f 44  r = 0;..  /* TOD
0690: 4f 3a 20 44 6f 20 73 6f 6d 65 20 76 61 6c 69 64  O: Do some valid
06a0: 69 74 79 20 63 68 65 63 6b 73 20 6f 6e 20 61 6c  ity checks on al
06b0: 6c 20 66 69 65 6c 64 73 2e 20 20 49 6e 20 70 61  l fields.  In pa
06c0: 72 74 69 63 75 6c 61 72 2c 0a 20 20 2a 2a 20 6d  rticular,.  ** m
06d0: 61 6b 65 20 73 75 72 65 20 66 69 65 6c 64 73 20  ake sure fields 
06e0: 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 4e  do not contain N
06f0: 55 4c 4c 73 2e 20 4f 74 68 65 72 77 69 73 65 20  ULLs. Otherwise 
0700: 77 65 20 6d 69 67 68 74 20 63 6f 72 65 0a 20 20  we might core.  
0710: 2a 2a 20 77 68 65 6e 20 61 74 74 65 6d 70 74 69  ** when attempti
0720: 6e 67 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65  ng to initialize
0730: 20 66 72 6f 6d 20 61 20 63 6f 72 72 75 70 74 20   from a corrupt 
0740: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 2a  database file. *
0750: 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 61 72 67  /..  assert( arg
0760: 63 3d 3d 35 20 29 3b 0a 20 20 73 77 69 74 63 68  c==5 );.  switch
0770: 28 20 61 72 67 76 5b 30 5d 5b 30 5d 20 29 7b 0a  ( argv[0][0] ){.
0780: 20 20 20 20 63 61 73 65 20 27 76 27 3a 0a 20 20      case 'v':.  
0790: 20 20 63 61 73 65 20 27 69 27 3a 0a 20 20 20 20    case 'i':.    
07a0: 63 61 73 65 20 27 74 27 3a 20 7b 20 20 2f 2a 20  case 't': {  /* 
07b0: 43 52 45 41 54 45 20 54 41 42 4c 45 2c 20 43 52  CREATE TABLE, CR
07c0: 45 41 54 45 20 49 4e 44 45 58 2c 20 6f 72 20 43  EATE INDEX, or C
07d0: 52 45 41 54 45 20 56 49 45 57 20 73 74 61 74 65  REATE VIEW state
07e0: 6d 65 6e 74 73 20 2a 2f 0a 20 20 20 20 20 20 69  ments */.      i
07f0: 66 28 20 61 72 67 76 5b 33 5d 20 26 26 20 61 72  f( argv[3] && ar
0800: 67 76 5b 33 5d 5b 30 5d 20 29 7b 0a 20 20 20 20  gv[3][0] ){.    
0810: 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65 20      /* Call the 
0820: 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 65 73  parser to proces
0830: 73 20 61 20 43 52 45 41 54 45 20 54 41 42 4c 45  s a CREATE TABLE
0840: 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 45 57 2e  , INDEX or VIEW.
0850: 0a 20 20 20 20 20 20 20 20 2a 2a 20 42 75 74 20  .        ** But 
0860: 62 65 63 61 75 73 65 20 73 50 61 72 73 65 2e 69  because sParse.i
0870: 6e 69 74 46 6c 61 67 20 69 73 20 73 65 74 20 74  nitFlag is set t
0880: 6f 20 31 2c 20 6e 6f 20 56 44 42 45 20 63 6f 64  o 1, no VDBE cod
0890: 65 20 69 73 20 67 65 6e 65 72 61 74 65 64 0a 20  e is generated. 
08a0: 20 20 20 20 20 20 20 2a 2a 20 6f 72 20 65 78 65         ** or exe
08b0: 63 75 74 65 64 2e 20 20 41 6c 6c 20 74 68 65 20  cuted.  All the 
08c0: 70 61 72 73 65 72 20 64 6f 65 73 20 69 73 20 62  parser does is b
08d0: 75 69 6c 64 20 74 68 65 20 69 6e 74 65 72 6e 61  uild the interna
08e0: 6c 20 64 61 74 61 0a 20 20 20 20 20 20 20 20 2a  l data.        *
08f0: 2a 20 73 74 72 75 63 74 75 72 65 73 20 74 68 61  * structures tha
0900: 74 20 64 65 73 63 72 69 62 65 20 74 68 65 20 74  t describe the t
0910: 61 62 6c 65 2c 20 69 6e 64 65 78 2c 20 6f 72 20  able, index, or 
0920: 76 69 65 77 2e 0a 20 20 20 20 20 20 20 20 2a 2f  view..        */
0930: 0a 20 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28  .        memset(
0940: 26 73 50 61 72 73 65 2c 20 30 2c 20 73 69 7a 65  &sParse, 0, size
0950: 6f 66 28 73 50 61 72 73 65 29 29 3b 0a 20 20 20  of(sParse));.   
0960: 20 20 20 20 20 73 50 61 72 73 65 2e 64 62 20 3d       sParse.db =
0970: 20 70 44 61 74 61 2d 3e 64 62 3b 0a 20 20 20 20   pData->db;.    
0980: 20 20 20 20 73 50 61 72 73 65 2e 69 6e 69 74 46      sParse.initF
0990: 6c 61 67 20 3d 20 31 3b 0a 20 20 20 20 20 20 20  lag = 1;.       
09a0: 20 73 50 61 72 73 65 2e 69 73 54 65 6d 70 20 3d   sParse.isTemp =
09b0: 20 61 72 67 76 5b 34 5d 5b 30 5d 20 2d 20 27 30   argv[4][0] - '0
09c0: 27 3b 0a 20 20 20 20 20 20 20 20 73 50 61 72 73  ';.        sPars
09d0: 65 2e 6e 65 77 54 6e 75 6d 20 3d 20 61 74 6f 69  e.newTnum = atoi
09e0: 28 61 72 67 76 5b 32 5d 29 3b 0a 20 20 20 20 20  (argv[2]);.     
09f0: 20 20 20 73 71 6c 69 74 65 52 75 6e 50 61 72 73     sqliteRunPars
0a00: 65 72 28 26 73 50 61 72 73 65 2c 20 61 72 67 76  er(&sParse, argv
0a10: 5b 33 5d 2c 20 70 44 61 74 61 2d 3e 70 7a 45 72  [3], pData->pzEr
0a20: 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 7d 65 6c  rMsg);.      }el
0a30: 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49  se{.        /* I
0a40: 66 20 74 68 65 20 53 51 4c 20 63 6f 6c 75 6d 6e  f the SQL column
0a50: 20 69 73 20 62 6c 61 6e 6b 20 69 74 20 6d 65 61   is blank it mea
0a60: 6e 73 20 74 68 69 73 20 69 73 20 61 6e 20 69 6e  ns this is an in
0a70: 64 65 78 20 74 68 61 74 0a 20 20 20 20 20 20 20  dex that.       
0a80: 20 2a 2a 20 77 61 73 20 63 72 65 61 74 65 64 20   ** was created 
0a90: 74 6f 20 62 65 20 74 68 65 20 50 52 49 4d 41 52  to be the PRIMAR
0aa0: 59 20 4b 45 59 20 6f 72 20 74 6f 20 66 75 6c 66  Y KEY or to fulf
0ab0: 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a 20 20 20  ill a UNIQUE.   
0ac0: 20 20 20 20 20 2a 2a 20 63 6f 6e 73 74 72 61 69       ** constrai
0ad0: 6e 74 20 66 6f 72 20 61 20 43 52 45 41 54 45 20  nt for a CREATE 
0ae0: 54 41 42 4c 45 2e 20 20 54 68 65 20 69 6e 64 65  TABLE.  The inde
0af0: 78 20 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6c  x should have al
0b00: 72 65 61 64 79 0a 20 20 20 20 20 20 20 20 2a 2a  ready.        **
0b10: 20 62 65 65 6e 20 63 72 65 61 74 65 64 20 77 68   been created wh
0b20: 65 6e 20 77 65 20 70 72 6f 63 65 73 73 65 64 20  en we processed 
0b30: 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  the CREATE TABLE
0b40: 2e 20 20 41 6c 6c 20 77 65 20 68 61 76 65 0a 20  .  All we have. 
0b50: 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 64 6f 20         ** to do 
0b60: 68 65 72 65 20 69 73 20 72 65 63 6f 72 64 20 74  here is record t
0b70: 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d  he root page num
0b80: 62 65 72 20 66 6f 72 20 74 68 61 74 20 69 6e 64  ber for that ind
0b90: 65 78 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20  ex..        */. 
0ba0: 20 20 20 20 20 20 20 49 6e 64 65 78 20 2a 70 49         Index *pI
0bb0: 6e 64 65 78 20 3d 20 73 71 6c 69 74 65 46 69 6e  ndex = sqliteFin
0bc0: 64 49 6e 64 65 78 28 70 44 61 74 61 2d 3e 64 62  dIndex(pData->db
0bd0: 2c 20 61 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20  , argv[1]);.    
0be0: 20 20 20 20 69 66 28 20 70 49 6e 64 65 78 3d 3d      if( pIndex==
0bf0: 30 20 7c 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75  0 || pIndex->tnu
0c00: 6d 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  m!=0 ){.        
0c10: 20 20 2f 2a 20 54 68 69 73 20 63 61 6e 20 6f 63    /* This can oc
0c20: 63 75 72 20 69 66 20 74 68 65 72 65 20 65 78 69  cur if there exi
0c30: 73 74 73 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20  sts an index on 
0c40: 61 20 54 45 4d 50 20 74 61 62 6c 65 20 77 68 69  a TEMP table whi
0c50: 63 68 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20  ch.          ** 
0c60: 68 61 73 20 74 68 65 20 73 61 6d 65 20 6e 61 6d  has the same nam
0c70: 65 20 61 73 20 61 6e 6f 74 68 65 72 20 69 6e 64  e as another ind
0c80: 65 78 20 6f 6e 20 61 20 70 65 72 6d 61 6e 65 6e  ex on a permanen
0c90: 74 20 69 6e 64 65 78 2e 20 20 53 69 6e 63 65 0a  t index.  Since.
0ca0: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65            ** the
0cb0: 20 70 65 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65   permanent table
0cc0: 20 69 73 20 68 69 64 64 65 6e 20 62 79 20 74 68   is hidden by th
0cd0: 65 20 54 45 4d 50 20 74 61 62 6c 65 2c 20 77 65  e TEMP table, we
0ce0: 20 63 61 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20   can also.      
0cf0: 20 20 20 20 2a 2a 20 73 61 66 65 6c 79 20 69 67      ** safely ig
0d00: 6e 6f 72 65 20 74 68 65 20 69 6e 64 65 78 20 6f  nore the index o
0d10: 6e 20 74 68 65 20 70 65 72 6d 61 6e 65 6e 74 20  n the permanent 
0d20: 74 61 62 6c 65 2e 0a 20 20 20 20 20 20 20 20 20  table..         
0d30: 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 2f 2a   */.          /*
0d40: 20 44 6f 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b 0a   Do Nothing */;.
0d50: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20          }else{. 
0d60: 20 20 20 20 20 20 20 20 20 70 49 6e 64 65 78 2d           pIndex-
0d70: 3e 74 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72 67  >tnum = atoi(arg
0d80: 76 5b 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 7d  v[2]);.        }
0d90: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62  .      }.      b
0da0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
0db0: 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20  default: {.     
0dc0: 20 2f 2a 20 54 68 69 73 20 63 61 6e 20 6e 6f 74   /* This can not
0dd0: 20 68 61 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20   happen! */.    
0de0: 20 20 6e 45 72 72 20 3d 20 31 3b 0a 20 20 20 20    nErr = 1;.    
0df0: 20 20 61 73 73 65 72 74 28 20 6e 45 72 72 3d 3d    assert( nErr==
0e00: 30 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20  0 );.    }.  }. 
0e10: 20 72 65 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a   return nErr;.}.
0e20: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61  ./*.** This is a
0e30: 20 63 61 6c 6c 62 61 63 6b 20 70 72 6f 63 65 64   callback proced
0e40: 75 72 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f  ure used to reco
0e50: 6e 73 74 72 75 63 74 20 61 20 74 61 62 6c 65 2e  nstruct a table.
0e60: 20 20 54 68 65 0a 2a 2a 20 6e 61 6d 65 20 6f 66    The.** name of
0e70: 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 62 65   the table to be
0e80: 20 72 65 63 6f 6e 73 74 72 75 63 74 65 64 20 69   reconstructed i
0e90: 73 20 70 61 73 73 65 64 20 69 6e 20 61 73 20 61  s passed in as a
0ea0: 72 67 76 5b 30 5d 2e 0a 2a 2a 0a 2a 2a 20 54 68  rgv[0]..**.** Th
0eb0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73  is routine is us
0ec0: 65 64 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61  ed to automatica
0ed0: 6c 6c 79 20 75 70 67 72 61 64 65 20 61 20 64 61  lly upgrade a da
0ee0: 74 61 62 61 73 65 20 66 72 6f 6d 0a 2a 2a 20 66  tabase from.** f
0ef0: 6f 72 6d 61 74 20 76 65 72 73 69 6f 6e 20 31 20  ormat version 1 
0f00: 6f 72 20 32 20 74 6f 20 76 65 72 73 69 6f 6e 20  or 2 to version 
0f10: 33 2e 20 20 54 68 65 20 63 6f 72 72 65 63 74 20  3.  The correct 
0f20: 6f 70 65 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20  operation of.** 
0f30: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 6c  this routine rel
0f40: 79 73 20 6f 6e 20 74 68 65 20 66 61 63 74 20 74  ys on the fact t
0f50: 68 61 74 20 6e 6f 20 69 6e 64 69 63 65 73 20 61  hat no indices a
0f60: 72 65 20 75 73 65 64 20 77 68 65 6e 0a 2a 2a 20  re used when.** 
0f70: 63 6f 70 79 69 6e 67 20 61 20 74 61 62 6c 65 20  copying a table 
0f80: 6f 75 74 20 74 6f 20 61 20 74 65 6d 70 6f 72 61  out to a tempora
0f90: 72 79 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74  ry file..*/.stat
0fa0: 69 63 0a 69 6e 74 20 75 70 67 72 61 64 65 5f 33  ic.int upgrade_3
0fb0: 5f 63 61 6c 6c 62 61 63 6b 28 76 6f 69 64 20 2a  _callback(void *
0fc0: 70 49 6e 69 74 2c 20 69 6e 74 20 61 72 67 63 2c  pInit, int argc,
0fd0: 20 63 68 61 72 20 2a 2a 61 72 67 76 2c 20 63 68   char **argv, ch
0fe0: 61 72 20 2a 2a 4e 6f 74 55 73 65 64 29 7b 0a 20  ar **NotUsed){. 
0ff0: 20 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61   InitData *pData
1000: 20 3d 20 28 49 6e 69 74 44 61 74 61 2a 29 70 49   = (InitData*)pI
1010: 6e 69 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  nit;.  int rc;. 
1020: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20   Table *pTab;.  
1030: 54 72 69 67 67 65 72 20 2a 70 54 72 69 67 3b 0a  Trigger *pTrig;.
1040: 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30    char *zErr = 0
1050: 3b 0a 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69  ;..  pTab = sqli
1060: 74 65 46 69 6e 64 54 61 62 6c 65 28 70 44 61 74  teFindTable(pDat
1070: 61 2d 3e 64 62 2c 20 61 72 67 76 5b 30 5d 29 3b  a->db, argv[0]);
1080: 0a 20 20 61 73 73 65 72 74 28 20 70 54 61 62 21  .  assert( pTab!
1090: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
10a0: 73 71 6c 69 74 65 53 74 72 49 43 6d 70 28 70 54  sqliteStrICmp(pT
10b0: 61 62 2d 3e 7a 4e 61 6d 65 2c 20 61 72 67 76 5b  ab->zName, argv[
10c0: 30 5d 29 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20  0])==0 );.  if( 
10d0: 70 54 61 62 20 29 7b 0a 20 20 20 20 70 54 72 69  pTab ){.    pTri
10e0: 67 20 3d 20 70 54 61 62 2d 3e 70 54 72 69 67 67  g = pTab->pTrigg
10f0: 65 72 3b 0a 20 20 20 20 70 54 61 62 2d 3e 70 54  er;.    pTab->pT
1100: 72 69 67 67 65 72 20 3d 20 30 3b 20 20 2f 2a 20  rigger = 0;  /* 
1110: 44 69 73 61 62 6c 65 20 61 6c 6c 20 74 72 69 67  Disable all trig
1120: 67 65 72 73 20 62 65 66 6f 72 65 20 72 65 62 75  gers before rebu
1130: 69 6c 64 69 6e 67 20 74 68 65 20 74 61 62 6c 65  ilding the table
1140: 20 2a 2f 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73   */.  }.  rc = s
1150: 71 6c 69 74 65 5f 65 78 65 63 5f 70 72 69 6e 74  qlite_exec_print
1160: 66 28 70 44 61 74 61 2d 3e 64 62 2c 0a 20 20 20  f(pData->db,.   
1170: 20 22 43 52 45 41 54 45 20 54 45 4d 50 20 54 41   "CREATE TEMP TA
1180: 42 4c 45 20 73 71 6c 69 74 65 5f 78 20 41 53 20  BLE sqlite_x AS 
1190: 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 27 25  SELECT * FROM '%
11a0: 71 27 3b 20 22 0a 20 20 20 20 22 44 45 4c 45 54  q'; ".    "DELET
11b0: 45 20 46 52 4f 4d 20 27 25 71 27 3b 20 22 0a 20  E FROM '%q'; ". 
11c0: 20 20 20 22 49 4e 53 45 52 54 20 49 4e 54 4f 20     "INSERT INTO 
11d0: 27 25 71 27 20 53 45 4c 45 43 54 20 2a 20 46 52  '%q' SELECT * FR
11e0: 4f 4d 20 73 71 6c 69 74 65 5f 78 3b 20 22 0a 20  OM sqlite_x; ". 
11f0: 20 20 20 22 44 52 4f 50 20 54 41 42 4c 45 20 73     "DROP TABLE s
1200: 71 6c 69 74 65 5f 78 3b 22 2c 0a 20 20 20 20 30  qlite_x;",.    0
1210: 2c 20 30 2c 20 26 7a 45 72 72 2c 20 61 72 67 76  , 0, &zErr, argv
1220: 5b 30 5d 2c 20 61 72 67 76 5b 30 5d 2c 20 61 72  [0], argv[0], ar
1230: 67 76 5b 30 5d 29 3b 0a 20 20 69 66 28 20 7a 45  gv[0]);.  if( zE
1240: 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  rr ){.    sqlite
1250: 53 65 74 53 74 72 69 6e 67 28 70 44 61 74 61 2d  SetString(pData-
1260: 3e 70 7a 45 72 72 4d 73 67 2c 20 7a 45 72 72 2c  >pzErrMsg, zErr,
1270: 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 5f   0);.    sqlite_
1280: 66 72 65 65 6d 65 6d 28 7a 45 72 72 29 3b 0a 20  freemem(zErr);. 
1290: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 61 6e 20 65   }..  /* If an e
12a0: 72 72 6f 72 20 6f 63 63 75 72 72 65 64 20 69 6e  rror occurred in
12b0: 20 74 68 65 20 53 51 4c 20 61 62 6f 76 65 2c 20   the SQL above, 
12c0: 74 68 65 6e 20 74 68 65 20 74 72 61 6e 73 61 63  then the transac
12d0: 74 69 6f 6e 20 77 69 6c 6c 0a 20 20 2a 2a 20 72  tion will.  ** r
12e0: 6f 6c 6c 62 61 63 6b 20 77 68 69 63 68 20 77 69  ollback which wi
12f0: 6c 6c 20 64 65 6c 65 74 65 20 74 68 65 20 69 6e  ll delete the in
1300: 74 65 72 6e 61 6c 20 73 79 6d 62 6f 6c 20 74 61  ternal symbol ta
1310: 62 6c 65 73 2e 20 20 54 68 69 73 20 77 69 6c 6c  bles.  This will
1320: 0a 20 20 2a 2a 20 63 61 75 73 65 20 74 68 65 20  .  ** cause the 
1330: 73 74 72 75 63 74 75 72 65 20 74 68 61 74 20 70  structure that p
1340: 54 61 62 20 70 6f 69 6e 74 73 20 74 6f 20 62 65  Tab points to be
1350: 20 64 65 6c 65 74 65 64 2e 20 20 49 6e 20 63 61   deleted.  In ca
1360: 73 65 20 74 68 61 74 0a 20 20 2a 2a 20 68 61 70  se that.  ** hap
1370: 70 65 6e 65 64 2c 20 77 65 20 6e 65 65 64 20 74  pened, we need t
1380: 6f 20 72 65 66 65 74 63 68 20 70 54 61 62 2e 0a  o refetch pTab..
1390: 20 20 2a 2f 0a 20 20 70 54 61 62 20 3d 20 73 71    */.  pTab = sq
13a0: 6c 69 74 65 46 69 6e 64 54 61 62 6c 65 28 70 44  liteFindTable(pD
13b0: 61 74 61 2d 3e 64 62 2c 20 61 72 67 76 5b 30 5d  ata->db, argv[0]
13c0: 29 3b 0a 20 20 69 66 28 20 70 54 61 62 20 29 7b  );.  if( pTab ){
13d0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c  .    assert( sql
13e0: 69 74 65 53 74 72 49 43 6d 70 28 70 54 61 62 2d  iteStrICmp(pTab-
13f0: 3e 7a 4e 61 6d 65 2c 20 61 72 67 76 5b 30 5d 29  >zName, argv[0])
1400: 3d 3d 30 20 29 3b 0a 20 20 20 20 70 54 61 62 2d  ==0 );.    pTab-
1410: 3e 70 54 72 69 67 67 65 72 20 3d 20 70 54 72 69  >pTrigger = pTri
1420: 67 3b 20 20 2f 2a 20 52 65 2d 65 6e 61 62 6c 65  g;  /* Re-enable
1430: 20 74 72 69 67 67 65 72 73 20 2a 2f 0a 20 20 7d   triggers */.  }
1440: 0a 20 20 72 65 74 75 72 6e 20 72 63 21 3d 53 51  .  return rc!=SQ
1450: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 0a 2f 2a  LITE_OK;.}..../*
1460: 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 72  .** Attempt to r
1470: 65 61 64 20 74 68 65 20 64 61 74 61 62 61 73 65  ead the database
1480: 20 73 63 68 65 6d 61 20 61 6e 64 20 69 6e 69 74   schema and init
1490: 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e 61 6c 0a  ialize internal.
14a0: 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74 75 72  ** data structur
14b0: 65 73 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65 20  es.  Return one 
14c0: 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20 65  of the SQLITE_ e
14d0: 72 72 6f 72 20 63 6f 64 65 73 20 74 6f 0a 2a 2a  rror codes to.**
14e0: 20 69 6e 64 69 63 61 74 65 20 73 75 63 63 65 73   indicate succes
14f0: 73 20 6f 72 20 66 61 69 6c 75 72 65 2e 0a 2a 2a  s or failure..**
1500: 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20 64 61  .** After the da
1510: 74 61 62 61 73 65 20 69 73 20 69 6e 69 74 69 61  tabase is initia
1520: 6c 69 7a 65 64 2c 20 74 68 65 20 53 51 4c 49 54  lized, the SQLIT
1530: 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 0a 2a 2a  E_Initialized.**
1540: 20 62 69 74 20 69 73 20 73 65 74 20 69 6e 20 74   bit is set in t
1550: 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20 6f  he flags field o
1560: 66 20 74 68 65 20 73 71 6c 69 74 65 20 73 74 72  f the sqlite str
1570: 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a 2a 20 61  ucture.  An.** a
1580: 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74  ttempt is made t
1590: 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65  o initialize the
15a0: 20 64 61 74 61 62 61 73 65 20 61 73 20 73 6f 6f   database as soo
15b0: 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73 20 6f 70  n as it.** is op
15c0: 65 6e 65 64 2e 20 20 49 66 20 74 68 61 74 20 66  ened.  If that f
15d0: 61 69 6c 73 20 28 70 65 72 68 61 70 73 20 62 65  ails (perhaps be
15e0: 63 61 75 73 65 20 61 6e 6f 74 68 65 72 20 70 72  cause another pr
15f0: 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20 74 68 65  ocess.** has the
1600: 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 74   sqlite_master t
1610: 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20 74 68 61  able locked) tha
1620: 6e 20 61 6e 6f 74 68 65 72 20 61 74 74 65 6d 70  n another attemp
1630: 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20 74 68 65  t.** is made the
1640: 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 65 20   first time the 
1650: 64 61 74 61 62 61 73 65 20 69 73 20 61 63 63 65  database is acce
1660: 73 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ssed..*/.int sql
1670: 69 74 65 49 6e 69 74 28 73 71 6c 69 74 65 20 2a  iteInit(sqlite *
1680: 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  db, char **pzErr
1690: 4d 73 67 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  Msg){.  int rc;.
16a0: 20 20 42 74 43 75 72 73 6f 72 20 2a 63 75 72 4d    BtCursor *curM
16b0: 61 69 6e 3b 0a 20 20 69 6e 74 20 73 69 7a 65 3b  ain;.  int size;
16c0: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a  .  Table *pTab;.
16d0: 20 20 63 68 61 72 20 2a 61 7a 41 72 67 5b 36 5d    char *azArg[6]
16e0: 3b 0a 20 20 69 6e 74 20 6d 65 74 61 5b 53 51 4c  ;.  int meta[SQL
16f0: 49 54 45 5f 4e 5f 42 54 52 45 45 5f 4d 45 54 41  ITE_N_BTREE_META
1700: 5d 3b 0a 20 20 50 61 72 73 65 20 73 50 61 72 73  ];.  Parse sPars
1710: 65 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69 6e  e;.  InitData in
1720: 69 74 44 61 74 61 3b 0a 0a 20 20 2f 2a 0a 20 20  itData;..  /*.  
1730: 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61  ** The master da
1740: 74 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73  tabase table has
1750: 20 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b   a structure lik
1760: 65 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74  e this.  */.  st
1770: 61 74 69 63 20 63 68 61 72 20 6d 61 73 74 65 72  atic char master
1780: 5f 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20  _schema[] = .   
1790: 20 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20    "CREATE TABLE 
17a0: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 28 5c 6e  sqlite_master(\n
17b0: 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 74  ".     "  type t
17c0: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
17d0: 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20  name text,\n".  
17e0: 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 74     "  tbl_name t
17f0: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
1800: 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72  rootpage integer
1810: 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 6c  ,\n".     "  sql
1820: 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 29   text\n".     ")
1830: 22 0a 20 20 3b 0a 20 20 73 74 61 74 69 63 20 63  ".  ;.  static c
1840: 68 61 72 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f  har temp_master_
1850: 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20  schema[] = .    
1860: 20 22 43 52 45 41 54 45 20 54 45 4d 50 20 54 41   "CREATE TEMP TA
1870: 42 4c 45 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f  BLE sqlite_temp_
1880: 6d 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20  master(\n".     
1890: 22 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22  "  type text,\n"
18a0: 0a 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65  .     "  name te
18b0: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74  xt,\n".     "  t
18c0: 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22  bl_name text,\n"
18d0: 0a 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67  .     "  rootpag
18e0: 65 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20  e integer,\n".  
18f0: 20 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e     "  sql text\n
1900: 22 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 0a  ".     ")".  ;..
1910: 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69    /* The followi
1920: 6e 67 20 53 51 4c 20 77 69 6c 6c 20 72 65 61 64  ng SQL will read
1930: 20 74 68 65 20 73 63 68 65 6d 61 20 66 72 6f 6d   the schema from
1940: 20 74 68 65 20 6d 61 73 74 65 72 20 74 61 62 6c   the master tabl
1950: 65 73 2e 0a 20 20 2a 2a 20 54 68 65 20 66 69 72  es..  ** The fir
1960: 73 74 20 76 65 72 73 69 6f 6e 20 77 6f 72 6b 73  st version works
1970: 20 77 69 74 68 20 53 51 4c 69 74 65 20 66 69 6c   with SQLite fil
1980: 65 20 66 6f 72 6d 61 74 73 20 32 20 6f 72 20 67  e formats 2 or g
1990: 72 65 61 74 65 72 2e 0a 20 20 2a 2a 20 54 68 65  reater..  ** The
19a0: 20 73 65 63 6f 6e 64 20 76 65 72 73 69 6f 6e 20   second version 
19b0: 69 73 20 66 6f 72 20 66 6f 72 6d 61 74 20 31 20  is for format 1 
19c0: 66 69 6c 65 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  files..  **.  **
19d0: 20 42 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20   Beginning with 
19e0: 66 69 6c 65 20 66 6f 72 6d 61 74 20 32 2c 20 74  file format 2, t
19f0: 68 65 20 72 6f 77 69 64 20 66 6f 72 20 6e 65 77  he rowid for new
1a00: 20 74 61 62 6c 65 20 65 6e 74 72 69 65 73 0a 20   table entries. 
1a10: 20 2a 2a 20 28 69 6e 63 6c 75 64 69 6e 67 20 65   ** (including e
1a20: 6e 74 72 69 65 73 20 69 6e 20 73 71 6c 69 74 65  ntries in sqlite
1a30: 5f 6d 61 73 74 65 72 29 20 69 73 20 61 6e 20 69  _master) is an i
1a40: 6e 63 72 65 61 73 69 6e 67 20 69 6e 74 65 67 65  ncreasing intege
1a50: 72 2e 0a 20 20 2a 2a 20 53 6f 20 66 6f 72 20 66  r..  ** So for f
1a60: 69 6c 65 20 66 6f 72 6d 61 74 20 32 20 61 6e 64  ile format 2 and
1a70: 20 6c 61 74 65 72 2c 20 77 65 20 63 61 6e 20 70   later, we can p
1a80: 6c 61 79 20 62 61 63 6b 20 73 71 6c 69 74 65 5f  lay back sqlite_
1a90: 6d 61 73 74 65 72 0a 20 20 2a 2a 20 61 6e 64 20  master.  ** and 
1aa0: 61 6c 6c 20 74 68 65 20 43 52 45 41 54 45 20 73  all the CREATE s
1ab0: 74 61 74 65 6d 65 6e 74 73 20 77 69 6c 6c 20 61  tatements will a
1ac0: 70 70 65 61 72 20 69 6e 20 74 68 65 20 72 69 67  ppear in the rig
1ad0: 68 74 20 6f 72 64 65 72 2e 0a 20 20 2a 2a 20 42  ht order..  ** B
1ae0: 75 74 20 77 69 74 68 20 66 69 6c 65 20 66 6f 72  ut with file for
1af0: 6d 61 74 20 31 2c 20 74 61 62 6c 65 20 65 6e 74  mat 1, table ent
1b00: 72 69 65 73 20 77 65 72 65 20 72 61 6e 64 6f 6d  ries were random
1b10: 20 61 6e 64 20 73 6f 20 77 65 0a 20 20 2a 2a 20   and so we.  ** 
1b20: 68 61 76 65 20 74 6f 20 6d 61 6b 65 20 73 75 72  have to make sur
1b30: 65 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42  e the CREATE TAB
1b40: 4c 45 73 20 6f 63 63 75 72 20 62 65 66 6f 72 65  LEs occur before
1b50: 20 74 68 65 69 72 20 63 6f 72 72 65 73 70 6f 6e   their correspon
1b60: 64 69 6e 67 0a 20 20 2a 2a 20 43 52 45 41 54 45  ding.  ** CREATE
1b70: 20 49 4e 44 45 58 73 2e 20 20 28 57 65 20 64 6f   INDEXs.  (We do
1b80: 6e 27 74 20 68 61 76 65 20 74 6f 20 64 65 61 6c  n't have to deal
1b90: 20 77 69 74 68 20 43 52 45 41 54 45 20 56 49 45   with CREATE VIE
1ba0: 57 20 6f 72 0a 20 20 2a 2a 20 43 52 45 41 54 45  W or.  ** CREATE
1bb0: 20 54 52 49 47 47 45 52 20 69 6e 20 66 69 6c 65   TRIGGER in file
1bc0: 20 66 6f 72 6d 61 74 20 31 20 62 65 63 61 75 73   format 1 becaus
1bd0: 65 20 74 68 6f 73 65 20 63 6f 6e 73 74 72 75 63  e those construc
1be0: 74 73 20 64 69 64 0a 20 20 2a 2a 20 6e 6f 74 20  ts did.  ** not 
1bf0: 65 78 69 73 74 20 74 68 65 6e 2e 29 20 0a 20 20  exist then.) .  
1c00: 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68 61 72  */.  static char
1c10: 20 69 6e 69 74 5f 73 63 72 69 70 74 5b 5d 20 3d   init_script[] =
1c20: 20 0a 20 20 20 20 20 22 53 45 4c 45 43 54 20 74   .     "SELECT t
1c30: 79 70 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f 74 70  ype, name, rootp
1c40: 61 67 65 2c 20 73 71 6c 2c 20 31 20 46 52 4f 4d  age, sql, 1 FROM
1c50: 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73   sqlite_temp_mas
1c60: 74 65 72 20 22 0a 20 20 20 20 20 22 55 4e 49 4f  ter ".     "UNIO
1c70: 4e 20 41 4c 4c 20 22 0a 20 20 20 20 20 22 53 45  N ALL ".     "SE
1c80: 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d 65 2c  LECT type, name,
1c90: 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c 2c 20   rootpage, sql, 
1ca0: 30 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61  0 FROM sqlite_ma
1cb0: 73 74 65 72 22 3b 0a 20 20 73 74 61 74 69 63 20  ster";.  static 
1cc0: 63 68 61 72 20 6f 6c 64 65 72 5f 69 6e 69 74 5f  char older_init_
1cd0: 73 63 72 69 70 74 5b 5d 20 3d 20 0a 20 20 20 20  script[] = .    
1ce0: 20 22 53 45 4c 45 43 54 20 74 79 70 65 2c 20 6e   "SELECT type, n
1cf0: 61 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73  ame, rootpage, s
1d00: 71 6c 2c 20 31 20 46 52 4f 4d 20 73 71 6c 69 74  ql, 1 FROM sqlit
1d10: 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 20 22 0a  e_temp_master ".
1d20: 20 20 20 20 20 22 55 4e 49 4f 4e 20 41 4c 4c 20       "UNION ALL 
1d30: 22 0a 20 20 20 20 20 22 53 45 4c 45 43 54 20 74  ".     "SELECT t
1d40: 79 70 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f 74 70  ype, name, rootp
1d50: 61 67 65 2c 20 73 71 6c 2c 20 30 20 46 52 4f 4d  age, sql, 0 FROM
1d60: 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 22   sqlite_master "
1d70: 0a 20 20 20 20 20 22 57 48 45 52 45 20 74 79 70  .     "WHERE typ
1d80: 65 3d 27 74 61 62 6c 65 27 20 22 0a 20 20 20 20  e='table' ".    
1d90: 20 22 55 4e 49 4f 4e 20 41 4c 4c 20 22 0a 20 20   "UNION ALL ".  
1da0: 20 20 20 22 53 45 4c 45 43 54 20 74 79 70 65 2c     "SELECT type,
1db0: 20 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c   name, rootpage,
1dc0: 20 73 71 6c 2c 20 30 20 46 52 4f 4d 20 73 71 6c   sql, 0 FROM sql
1dd0: 69 74 65 5f 6d 61 73 74 65 72 20 22 0a 20 20 20  ite_master ".   
1de0: 20 20 22 57 48 45 52 45 20 74 79 70 65 3d 27 69    "WHERE type='i
1df0: 6e 64 65 78 27 22 3b 0a 0a 0a 20 20 2f 2a 20 43  ndex'";...  /* C
1e00: 6f 6e 73 74 72 75 63 74 20 74 68 65 20 73 63 68  onstruct the sch
1e10: 65 6d 61 20 74 61 62 6c 65 73 3a 20 73 71 6c 69  ema tables: sqli
1e20: 74 65 5f 6d 61 73 74 65 72 20 61 6e 64 20 73 71  te_master and sq
1e30: 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72  lite_temp_master
1e40: 0a 20 20 2a 2f 0a 20 20 61 7a 41 72 67 5b 30 5d  .  */.  azArg[0]
1e50: 20 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 61 7a   = "table";.  az
1e60: 41 72 67 5b 31 5d 20 3d 20 4d 41 53 54 45 52 5f  Arg[1] = MASTER_
1e70: 4e 41 4d 45 3b 0a 20 20 61 7a 41 72 67 5b 32 5d  NAME;.  azArg[2]
1e80: 20 3d 20 22 32 22 3b 0a 20 20 61 7a 41 72 67 5b   = "2";.  azArg[
1e90: 33 5d 20 3d 20 6d 61 73 74 65 72 5f 73 63 68 65  3] = master_sche
1ea0: 6d 61 3b 0a 20 20 61 7a 41 72 67 5b 34 5d 20 3d  ma;.  azArg[4] =
1eb0: 20 22 30 22 3b 0a 20 20 61 7a 41 72 67 5b 35 5d   "0";.  azArg[5]
1ec0: 20 3d 20 30 3b 0a 20 20 69 6e 69 74 44 61 74 61   = 0;.  initData
1ed0: 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69 74  .db = db;.  init
1ee0: 44 61 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d 20  Data.pzErrMsg = 
1ef0: 70 7a 45 72 72 4d 73 67 3b 0a 20 20 73 71 6c 69  pzErrMsg;.  sqli
1f00: 74 65 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 26  teInitCallback(&
1f10: 69 6e 69 74 44 61 74 61 2c 20 35 2c 20 61 7a 41  initData, 5, azA
1f20: 72 67 2c 20 30 29 3b 0a 20 20 70 54 61 62 20 3d  rg, 0);.  pTab =
1f30: 20 73 71 6c 69 74 65 46 69 6e 64 54 61 62 6c 65   sqliteFindTable
1f40: 28 64 62 2c 20 4d 41 53 54 45 52 5f 4e 41 4d 45  (db, MASTER_NAME
1f50: 29 3b 0a 20 20 69 66 28 20 70 54 61 62 20 29 7b  );.  if( pTab ){
1f60: 0a 20 20 20 20 70 54 61 62 2d 3e 72 65 61 64 4f  .    pTab->readO
1f70: 6e 6c 79 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 61  nly = 1;.  }.  a
1f80: 7a 41 72 67 5b 31 5d 20 3d 20 54 45 4d 50 5f 4d  zArg[1] = TEMP_M
1f90: 41 53 54 45 52 5f 4e 41 4d 45 3b 0a 20 20 61 7a  ASTER_NAME;.  az
1fa0: 41 72 67 5b 33 5d 20 3d 20 74 65 6d 70 5f 6d 61  Arg[3] = temp_ma
1fb0: 73 74 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 61  ster_schema;.  a
1fc0: 7a 41 72 67 5b 34 5d 20 3d 20 22 31 22 3b 0a 20  zArg[4] = "1";. 
1fd0: 20 73 71 6c 69 74 65 49 6e 69 74 43 61 6c 6c 62   sqliteInitCallb
1fe0: 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c 20 35  ack(&initData, 5
1ff0: 2c 20 61 7a 41 72 67 2c 20 30 29 3b 0a 20 20 70  , azArg, 0);.  p
2000: 54 61 62 20 3d 20 73 71 6c 69 74 65 46 69 6e 64  Tab = sqliteFind
2010: 54 61 62 6c 65 28 64 62 2c 20 54 45 4d 50 5f 4d  Table(db, TEMP_M
2020: 41 53 54 45 52 5f 4e 41 4d 45 29 3b 0a 20 20 69  ASTER_NAME);.  i
2030: 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20 70  f( pTab ){.    p
2040: 54 61 62 2d 3e 72 65 61 64 4f 6e 6c 79 20 3d 20  Tab->readOnly = 
2050: 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 72 65  1;.  }..  /* Cre
2060: 61 74 65 20 61 20 63 75 72 73 6f 72 20 74 6f 20  ate a cursor to 
2070: 68 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61 73  hold the databas
2080: 65 20 6f 70 65 6e 0a 20 20 2a 2f 0a 20 20 69 66  e open.  */.  if
2090: 28 20 64 62 2d 3e 70 42 65 3d 3d 30 20 29 20 72  ( db->pBe==0 ) r
20a0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
20b0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 42 74  .  rc = sqliteBt
20c0: 72 65 65 43 75 72 73 6f 72 28 64 62 2d 3e 70 42  reeCursor(db->pB
20d0: 65 2c 20 32 2c 20 30 2c 20 26 63 75 72 4d 61 69  e, 2, 0, &curMai
20e0: 6e 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a  n);.  if( rc ){.
20f0: 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72      sqliteSetStr
2100: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 73 71  ing(pzErrMsg, sq
2110: 6c 69 74 65 5f 65 72 72 6f 72 5f 73 74 72 69 6e  lite_error_strin
2120: 67 28 72 63 29 2c 20 30 29 3b 0a 20 20 20 20 73  g(rc), 0);.    s
2130: 71 6c 69 74 65 52 65 73 65 74 49 6e 74 65 72 6e  qliteResetIntern
2140: 61 6c 53 63 68 65 6d 61 28 64 62 29 3b 0a 20 20  alSchema(db);.  
2150: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d    return rc;.  }
2160: 0a 0a 20 20 2f 2a 20 47 65 74 20 74 68 65 20 64  ..  /* Get the d
2170: 61 74 61 62 61 73 65 20 6d 65 74 61 20 69 6e 66  atabase meta inf
2180: 6f 72 6d 61 74 69 6f 6e 0a 20 20 2a 2f 0a 20 20  ormation.  */.  
2190: 72 63 20 3d 20 73 71 6c 69 74 65 42 74 72 65 65  rc = sqliteBtree
21a0: 47 65 74 4d 65 74 61 28 64 62 2d 3e 70 42 65 2c  GetMeta(db->pBe,
21b0: 20 6d 65 74 61 29 3b 0a 20 20 69 66 28 20 72 63   meta);.  if( rc
21c0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65   ){.    sqliteSe
21d0: 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67  tString(pzErrMsg
21e0: 2c 20 73 71 6c 69 74 65 5f 65 72 72 6f 72 5f 73  , sqlite_error_s
21f0: 74 72 69 6e 67 28 72 63 29 2c 20 30 29 3b 0a 20  tring(rc), 0);. 
2200: 20 20 20 73 71 6c 69 74 65 52 65 73 65 74 49 6e     sqliteResetIn
2210: 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 29  ternalSchema(db)
2220: 3b 0a 20 20 20 20 73 71 6c 69 74 65 42 74 72 65  ;.    sqliteBtre
2230: 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75 72  eCloseCursor(cur
2240: 4d 61 69 6e 29 3b 0a 20 20 20 20 72 65 74 75 72  Main);.    retur
2250: 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e  n rc;.  }.  db->
2260: 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 20 3d 20  schema_cookie = 
2270: 6d 65 74 61 5b 31 5d 3b 0a 20 20 64 62 2d 3e 6e  meta[1];.  db->n
2280: 65 78 74 5f 63 6f 6f 6b 69 65 20 3d 20 64 62 2d  ext_cookie = db-
2290: 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 3b 0a  >schema_cookie;.
22a0: 20 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61    db->file_forma
22b0: 74 20 3d 20 6d 65 74 61 5b 32 5d 3b 0a 20 20 73  t = meta[2];.  s
22c0: 69 7a 65 20 3d 20 6d 65 74 61 5b 33 5d 3b 0a 20  ize = meta[3];. 
22d0: 20 69 66 28 20 73 69 7a 65 3d 3d 30 20 29 7b 20   if( size==0 ){ 
22e0: 73 69 7a 65 20 3d 20 4d 41 58 5f 50 41 47 45 53  size = MAX_PAGES
22f0: 3b 20 7d 0a 20 20 64 62 2d 3e 63 61 63 68 65 5f  ; }.  db->cache_
2300: 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a 20 20 73  size = size;.  s
2310: 71 6c 69 74 65 42 74 72 65 65 53 65 74 43 61 63  qliteBtreeSetCac
2320: 68 65 53 69 7a 65 28 64 62 2d 3e 70 42 65 2c 20  heSize(db->pBe, 
2330: 73 69 7a 65 29 3b 0a 0a 20 20 2f 2a 0a 20 20 2a  size);..  /*.  *
2340: 2a 20 20 20 20 20 66 69 6c 65 5f 66 6f 72 6d 61  *     file_forma
2350: 74 3d 3d 31 20 20 20 20 56 65 72 73 69 6f 6e 20  t==1    Version 
2360: 32 2e 31 2e 30 2e 0a 20 20 2a 2a 20 20 20 20 20  2.1.0..  **     
2370: 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 32 20 20  file_format==2  
2380: 20 20 56 65 72 73 69 6f 6e 20 32 2e 32 2e 30 2e    Version 2.2.0.
2390: 20 41 64 64 20 73 75 70 70 6f 72 74 20 66 6f 72   Add support for
23a0: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59   INTEGER PRIMARY
23b0: 20 4b 45 59 2e 0a 20 20 2a 2a 20 20 20 20 20 66   KEY..  **     f
23c0: 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 33 20 20 20  ile_format==3   
23d0: 20 56 65 72 73 69 6f 6e 20 32 2e 36 2e 30 2e 20   Version 2.6.0. 
23e0: 46 69 78 20 65 6d 70 74 79 2d 73 74 72 69 6e 67  Fix empty-string
23f0: 20 69 6e 64 65 78 20 62 75 67 2e 0a 20 20 2a 2a   index bug..  **
2400: 20 20 20 20 20 66 69 6c 65 5f 66 6f 72 6d 61 74       file_format
2410: 3d 3d 34 20 20 20 20 56 65 72 73 69 6f 6e 20 32  ==4    Version 2
2420: 2e 37 2e 30 2e 20 41 64 64 20 73 75 70 70 6f 72  .7.0. Add suppor
2430: 74 20 66 6f 72 20 73 65 70 61 72 61 74 65 20 6e  t for separate n
2440: 75 6d 65 72 69 63 20 61 6e 64 0a 20 20 2a 2a 20  umeric and.  ** 
2450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2460: 20 20 20 20 20 20 74 65 78 74 20 64 61 74 61 74        text datat
2470: 79 70 65 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ypes..  */.  if(
2480: 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74   db->file_format
2490: 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68  ==0 ){.    /* Th
24a0: 69 73 20 68 61 70 70 65 6e 73 20 69 66 20 74 68  is happens if th
24b0: 65 20 64 61 74 61 62 61 73 65 20 77 61 73 20 69  e database was i
24c0: 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74 79 20 2a  nitially empty *
24d0: 2f 0a 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f 66  /.    db->file_f
24e0: 6f 72 6d 61 74 20 3d 20 34 3b 0a 20 20 7d 65 6c  ormat = 4;.  }el
24f0: 73 65 20 69 66 28 20 64 62 2d 3e 66 69 6c 65 5f  se if( db->file_
2500: 66 6f 72 6d 61 74 3e 34 20 29 7b 0a 20 20 20 20  format>4 ){.    
2510: 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 65  sqliteBtreeClose
2520: 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29 3b  Cursor(curMain);
2530: 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74  .    sqliteSetSt
2540: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22  ring(pzErrMsg, "
2550: 75 6e 73 75 70 70 6f 72 74 65 64 20 66 69 6c 65  unsupported file
2560: 20 66 6f 72 6d 61 74 22 2c 20 30 29 3b 0a 20 20   format", 0);.  
2570: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
2580: 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  ERROR;.  }..  /*
2590: 20 52 65 61 64 20 74 68 65 20 73 63 68 65 6d 61   Read the schema
25a0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 75 74   information out
25b0: 20 6f 66 20 74 68 65 20 73 63 68 65 6d 61 20 74   of the schema t
25c0: 61 62 6c 65 73 0a 20 20 2a 2f 0a 20 20 6d 65 6d  ables.  */.  mem
25d0: 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c 20  set(&sParse, 0, 
25e0: 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29 29 3b  sizeof(sParse));
25f0: 0a 20 20 73 50 61 72 73 65 2e 64 62 20 3d 20 64  .  sParse.db = d
2600: 62 3b 0a 20 20 73 50 61 72 73 65 2e 70 42 65 20  b;.  sParse.pBe 
2610: 3d 20 64 62 2d 3e 70 42 65 3b 0a 20 20 73 50 61  = db->pBe;.  sPa
2620: 72 73 65 2e 78 43 61 6c 6c 62 61 63 6b 20 3d 20  rse.xCallback = 
2630: 73 71 6c 69 74 65 49 6e 69 74 43 61 6c 6c 62 61  sqliteInitCallba
2640: 63 6b 3b 0a 20 20 73 50 61 72 73 65 2e 70 41 72  ck;.  sParse.pAr
2650: 67 20 3d 20 28 76 6f 69 64 2a 29 26 69 6e 69 74  g = (void*)&init
2660: 44 61 74 61 3b 0a 20 20 73 50 61 72 73 65 2e 69  Data;.  sParse.i
2670: 6e 69 74 46 6c 61 67 20 3d 20 31 3b 0a 20 20 73  nitFlag = 1;.  s
2680: 71 6c 69 74 65 52 75 6e 50 61 72 73 65 72 28 26  qliteRunParser(&
2690: 73 50 61 72 73 65 2c 0a 20 20 20 20 20 20 64 62  sParse,.      db
26a0: 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 3d 32  ->file_format>=2
26b0: 20 3f 20 69 6e 69 74 5f 73 63 72 69 70 74 20 3a   ? init_script :
26c0: 20 6f 6c 64 65 72 5f 69 6e 69 74 5f 73 63 72 69   older_init_scri
26d0: 70 74 2c 0a 20 20 20 20 20 20 70 7a 45 72 72 4d  pt,.      pzErrM
26e0: 73 67 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74  sg);.  if( sqlit
26f0: 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20  e_malloc_failed 
2700: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74  ){.    sqliteSet
2710: 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c  String(pzErrMsg,
2720: 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22   "out of memory"
2730: 2c 20 30 29 3b 0a 20 20 20 20 73 50 61 72 73 65  , 0);.    sParse
2740: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d  .rc = SQLITE_NOM
2750: 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 42 74  EM;.    sqliteBt
2760: 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e  reeRollback(db->
2770: 70 42 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  pBe);.    sqlite
2780: 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68  ResetInternalSch
2790: 65 6d 61 28 64 62 29 3b 0a 20 20 7d 0a 20 20 69  ema(db);.  }.  i
27a0: 66 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51  f( sParse.rc==SQ
27b0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 64  LITE_OK ){.    d
27c0: 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49  b->flags |= SQLI
27d0: 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a  TE_Initialized;.
27e0: 20 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d 69 74      sqliteCommit
27f0: 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28  InternalChanges(
2800: 64 62 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  db);.  }else{.  
2810: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e    db->flags &= ~
2820: 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a  SQLITE_Initializ
2830: 65 64 3b 0a 20 20 20 20 73 71 6c 69 74 65 52 65  ed;.    sqliteRe
2840: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
2850: 61 28 64 62 29 3b 0a 20 20 7d 0a 20 20 73 71 6c  a(db);.  }.  sql
2860: 69 74 65 42 74 72 65 65 43 6c 6f 73 65 43 75 72  iteBtreeCloseCur
2870: 73 6f 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20  sor(curMain);.  
2880: 72 65 74 75 72 6e 20 73 50 61 72 73 65 2e 72 63  return sParse.rc
2890: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76  ;.}../*.** The v
28a0: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 6c 69  ersion of the li
28b0: 62 72 61 72 79 0a 2a 2f 0a 63 6f 6e 73 74 20 63  brary.*/.const c
28c0: 68 61 72 20 72 63 73 69 64 5b 5d 20 3d 20 22 40  har rcsid[] = "@
28d0: 28 23 29 20 5c 30 34 34 49 64 3a 20 53 51 4c 69  (#) \044Id: SQLi
28e0: 74 65 20 76 65 72 73 69 6f 6e 20 22 20 53 51 4c  te version " SQL
28f0: 49 54 45 5f 56 45 52 53 49 4f 4e 20 22 20 24 22  ITE_VERSION " $"
2900: 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c  ;.const char sql
2910: 69 74 65 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20  ite_version[] = 
2920: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a  SQLITE_VERSION;.
2930: 0a 2f 2a 0a 2a 2a 20 44 6f 65 73 20 74 68 65 20  ./*.** Does the 
2940: 6c 69 62 72 61 72 79 20 65 78 70 65 63 74 20 64  library expect d
2950: 61 74 61 20 74 6f 20 62 65 20 65 6e 63 6f 64 65  ata to be encode
2960: 64 20 61 73 20 55 54 46 2d 38 20 6f 72 20 69 73  d as UTF-8 or is
2970: 6f 38 38 35 39 3f 20 20 54 68 65 0a 2a 2a 20 66  o8859?  The.** f
2980: 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20  ollowing global 
2990: 63 6f 6e 73 74 61 6e 74 20 61 6c 77 61 79 73 20  constant always 
29a0: 6c 65 74 73 20 75 73 20 6b 6e 6f 77 2e 0a 2a 2f  lets us know..*/
29b0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55  .#ifdef SQLITE_U
29c0: 54 46 38 0a 63 6f 6e 73 74 20 63 68 61 72 20 73  TF8.const char s
29d0: 71 6c 69 74 65 5f 65 6e 63 6f 64 69 6e 67 5b 5d  qlite_encoding[]
29e0: 20 3d 20 22 55 54 46 2d 38 22 3b 0a 23 65 6c 73   = "UTF-8";.#els
29f0: 65 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c  e.const char sql
2a00: 69 74 65 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d  ite_encoding[] =
2a10: 20 22 69 73 6f 38 38 35 39 22 3b 0a 23 65 6e 64   "iso8859";.#end
2a20: 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61  if../*.** Open a
2a30: 20 6e 65 77 20 53 51 4c 69 74 65 20 64 61 74 61   new SQLite data
2a40: 62 61 73 65 2e 20 20 43 6f 6e 73 74 72 75 63 74  base.  Construct
2a50: 20 61 6e 20 22 73 71 6c 69 74 65 22 20 73 74 72   an "sqlite" str
2a60: 75 63 74 75 72 65 20 74 6f 20 64 65 66 69 6e 65  ucture to define
2a70: 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 20 6f 66  .** the state of
2a80: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 61   this database a
2a90: 6e 64 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e  nd return a poin
2aa0: 74 65 72 20 74 6f 20 74 68 61 74 20 73 74 72 75  ter to that stru
2ab0: 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20  cture..**.** An 
2ac0: 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20  attempt is made 
2ad0: 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68  to initialize th
2ae0: 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61  e in-memory data
2af0: 20 73 74 72 75 63 74 75 72 65 73 20 74 68 61 74   structures that
2b00: 0a 2a 2a 20 68 6f 6c 64 20 74 68 65 20 64 61 74  .** hold the dat
2b10: 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 20 42  abase schema.  B
2b20: 75 74 20 69 66 20 74 68 69 73 20 66 61 69 6c 73  ut if this fails
2b30: 20 28 62 65 63 61 75 73 65 20 74 68 65 20 73 63   (because the sc
2b40: 68 65 6d 61 20 66 69 6c 65 0a 2a 2a 20 69 73 20  hema file.** is 
2b50: 6c 6f 63 6b 65 64 29 20 74 68 65 6e 20 74 68 61  locked) then tha
2b60: 74 20 73 74 65 70 20 69 73 20 64 65 66 65 72 72  t step is deferr
2b70: 65 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72  ed until the fir
2b80: 73 74 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71  st call to.** sq
2b90: 6c 69 74 65 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a  lite_exec()..*/.
2ba0: 73 71 6c 69 74 65 20 2a 73 71 6c 69 74 65 5f 6f  sqlite *sqlite_o
2bb0: 70 65 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  pen(const char *
2bc0: 7a 46 69 6c 65 6e 61 6d 65 2c 20 69 6e 74 20 6d  zFilename, int m
2bd0: 6f 64 65 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72  ode, char **pzEr
2be0: 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69 74 65 20  rMsg){.  sqlite 
2bf0: 2a 64 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a  *db;.  int rc;..
2c00: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68    /* Allocate th
2c10: 65 20 73 71 6c 69 74 65 20 64 61 74 61 20 73 74  e sqlite data st
2c20: 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 64 62 20  ructure */.  db 
2c30: 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20  = sqliteMalloc( 
2c40: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 29 20 29  sizeof(sqlite) )
2c50: 3b 0a 20 20 69 66 28 20 70 7a 45 72 72 4d 73 67  ;.  if( pzErrMsg
2c60: 20 29 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30   ) *pzErrMsg = 0
2c70: 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 20  ;.  if( db==0 ) 
2c80: 67 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f  goto no_mem_on_o
2c90: 70 65 6e 3b 0a 20 20 73 71 6c 69 74 65 48 61 73  pen;.  sqliteHas
2ca0: 68 49 6e 69 74 28 26 64 62 2d 3e 74 62 6c 48 61  hInit(&db->tblHa
2cb0: 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f  sh, SQLITE_HASH_
2cc0: 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71  STRING, 0);.  sq
2cd0: 6c 69 74 65 48 61 73 68 49 6e 69 74 28 26 64 62  liteHashInit(&db
2ce0: 2d 3e 69 64 78 48 61 73 68 2c 20 53 51 4c 49 54  ->idxHash, SQLIT
2cf0: 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30  E_HASH_STRING, 0
2d00: 29 3b 0a 20 20 73 71 6c 69 74 65 48 61 73 68 49  );.  sqliteHashI
2d10: 6e 69 74 28 26 64 62 2d 3e 74 72 69 67 48 61 73  nit(&db->trigHas
2d20: 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53  h, SQLITE_HASH_S
2d30: 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71 6c  TRING, 0);.  sql
2d40: 69 74 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d  iteHashInit(&db-
2d50: 3e 61 46 75 6e 63 2c 20 53 51 4c 49 54 45 5f 48  >aFunc, SQLITE_H
2d60: 41 53 48 5f 53 54 52 49 4e 47 2c 20 31 29 3b 0a  ASH_STRING, 1);.
2d70: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
2d80: 28 26 64 62 2d 3e 61 46 4b 65 79 2c 20 53 51 4c  (&db->aFKey, SQL
2d90: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
2da0: 20 31 29 3b 0a 20 20 64 62 2d 3e 6f 6e 45 72 72   1);.  db->onErr
2db0: 6f 72 20 3d 20 4f 45 5f 44 65 66 61 75 6c 74 3b  or = OE_Default;
2dc0: 0a 20 20 64 62 2d 3e 70 72 69 6f 72 4e 65 77 52  .  db->priorNewR
2dd0: 6f 77 69 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e  owid = 0;.  db->
2de0: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d  magic = SQLITE_M
2df0: 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 0a 20 20  AGIC_BUSY;.  .  
2e00: 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 61 63 6b  /* Open the back
2e10: 65 6e 64 20 64 61 74 61 62 61 73 65 20 64 72 69  end database dri
2e20: 76 65 72 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71  ver */.  rc = sq
2e30: 6c 69 74 65 42 74 72 65 65 4f 70 65 6e 28 7a 46  liteBtreeOpen(zF
2e40: 69 6c 65 6e 61 6d 65 2c 20 6d 6f 64 65 2c 20 4d  ilename, mode, M
2e50: 41 58 5f 50 41 47 45 53 2c 20 26 64 62 2d 3e 70  AX_PAGES, &db->p
2e60: 42 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53  Be);.  if( rc!=S
2e70: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
2e80: 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20  switch( rc ){.  
2e90: 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20      default: {. 
2ea0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 53 65 74         sqliteSet
2eb0: 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c  String(pzErrMsg,
2ec0: 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e   "unable to open
2ed0: 20 64 61 74 61 62 61 73 65 3a 20 22 2c 20 7a 46   database: ", zF
2ee0: 69 6c 65 6e 61 6d 65 2c 20 30 29 3b 0a 20 20 20  ilename, 0);.   
2ef0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73     }.    }.    s
2f00: 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b 0a 20  qliteFree(db);. 
2f10: 20 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c     sqliteStrReal
2f20: 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20  loc(pzErrMsg);. 
2f30: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
2f40: 0a 0a 20 20 2f 2a 20 41 74 74 65 6d 70 74 20 74  ..  /* Attempt t
2f50: 6f 20 72 65 61 64 20 74 68 65 20 73 63 68 65 6d  o read the schem
2f60: 61 20 2a 2f 0a 20 20 73 71 6c 69 74 65 52 65 67  a */.  sqliteReg
2f70: 69 73 74 65 72 42 75 69 6c 74 69 6e 46 75 6e 63  isterBuiltinFunc
2f80: 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20 72 63 20  tions(db);.  rc 
2f90: 3d 20 73 71 6c 69 74 65 49 6e 69 74 28 64 62 2c  = sqliteInit(db,
2fa0: 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 64 62   pzErrMsg);.  db
2fb0: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
2fc0: 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 69  _MAGIC_OPEN;.  i
2fd0: 66 28 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63  f( sqlite_malloc
2fe0: 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73  _failed ){.    s
2ff0: 71 6c 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b  qlite_close(db);
3000: 0a 20 20 20 20 67 6f 74 6f 20 6e 6f 5f 6d 65 6d  .    goto no_mem
3010: 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20 20 7d 65 6c 73  _on_open;.  }els
3020: 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45  e if( rc!=SQLITE
3030: 5f 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54  _OK && rc!=SQLIT
3040: 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 73 71  E_BUSY ){.    sq
3050: 6c 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a  lite_close(db);.
3060: 20 20 20 20 73 71 6c 69 74 65 53 74 72 52 65 61      sqliteStrRea
3070: 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a  lloc(pzErrMsg);.
3080: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
3090: 7d 65 6c 73 65 20 69 66 28 20 70 7a 45 72 72 4d  }else if( pzErrM
30a0: 73 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  sg ){.    sqlite
30b0: 46 72 65 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b  Free(*pzErrMsg);
30c0: 0a 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d  .    *pzErrMsg =
30d0: 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66   0;.  }..  /* If
30e0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
30f0: 20 69 6e 20 66 6f 72 6d 61 74 73 20 31 20 6f 72   in formats 1 or
3100: 20 32 2c 20 74 68 65 6e 20 75 70 67 72 61 64 65   2, then upgrade
3110: 20 69 74 20 74 6f 0a 20 20 2a 2a 20 76 65 72 73   it to.  ** vers
3120: 69 6f 6e 20 33 2e 20 20 54 68 69 73 20 77 69 6c  ion 3.  This wil
3130: 6c 20 72 65 63 6f 6e 73 74 72 75 63 74 20 61 6c  l reconstruct al
3140: 6c 20 69 6e 64 69 63 65 73 2e 20 20 49 66 20 74  l indices.  If t
3150: 68 65 0a 20 20 2a 2a 20 75 70 67 72 61 64 65 20  he.  ** upgrade 
3160: 66 61 69 6c 73 20 66 6f 72 20 61 6e 79 20 72 65  fails for any re
3170: 61 73 6f 6e 20 28 65 78 3a 20 6f 75 74 20 6f 66  ason (ex: out of
3180: 20 64 69 73 6b 20 73 70 61 63 65 2c 20 64 61 74   disk space, dat
3190: 61 62 61 73 65 0a 20 20 2a 2a 20 69 73 20 72 65  abase.  ** is re
31a0: 61 64 20 6f 6e 6c 79 2c 20 69 6e 74 65 72 72 75  ad only, interru
31b0: 70 74 20 72 65 63 65 69 76 65 2c 20 65 74 63 2e  pt receive, etc.
31c0: 29 20 74 68 65 6e 20 72 65 66 75 73 65 20 74 6f  ) then refuse to
31d0: 20 6f 70 65 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66   open..  */.  if
31e0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
31f0: 26 26 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d  && db->file_form
3200: 61 74 3c 33 20 29 7b 0a 20 20 20 20 63 68 61 72  at<3 ){.    char
3210: 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 20 20 20 20   *zErr = 0;.    
3220: 49 6e 69 74 44 61 74 61 20 69 6e 69 74 44 61 74  InitData initDat
3230: 61 3b 0a 20 20 20 20 69 6e 74 20 6d 65 74 61 5b  a;.    int meta[
3240: 53 51 4c 49 54 45 5f 4e 5f 42 54 52 45 45 5f 4d  SQLITE_N_BTREE_M
3250: 45 54 41 5d 3b 0a 0a 20 20 20 20 69 6e 69 74 44  ETA];..    initD
3260: 61 74 61 2e 64 62 20 3d 20 64 62 3b 0a 20 20 20  ata.db = db;.   
3270: 20 69 6e 69 74 44 61 74 61 2e 70 7a 45 72 72 4d   initData.pzErrM
3280: 73 67 20 3d 20 26 7a 45 72 72 3b 0a 20 20 20 20  sg = &zErr;.    
3290: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20  db->file_format 
32a0: 3d 20 33 3b 0a 20 20 20 20 72 63 20 3d 20 73 71  = 3;.    rc = sq
32b0: 6c 69 74 65 5f 65 78 65 63 28 64 62 2c 0a 20 20  lite_exec(db,.  
32c0: 20 20 20 20 22 42 45 47 49 4e 3b 20 53 45 4c 45      "BEGIN; SELE
32d0: 43 54 20 6e 61 6d 65 20 46 52 4f 4d 20 73 71 6c  CT name FROM sql
32e0: 69 74 65 5f 6d 61 73 74 65 72 20 57 48 45 52 45  ite_master WHERE
32f0: 20 74 79 70 65 3d 27 74 61 62 6c 65 27 3b 22 2c   type='table';",
3300: 0a 20 20 20 20 20 20 75 70 67 72 61 64 65 5f 33  .      upgrade_3
3310: 5f 63 61 6c 6c 62 61 63 6b 2c 0a 20 20 20 20 20  _callback,.     
3320: 20 26 69 6e 69 74 44 61 74 61 2c 0a 20 20 20 20   &initData,.    
3330: 20 20 26 7a 45 72 72 29 3b 0a 20 20 20 20 69 66    &zErr);.    if
3340: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
3350: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 42  ){.      sqliteB
3360: 74 72 65 65 47 65 74 4d 65 74 61 28 64 62 2d 3e  treeGetMeta(db->
3370: 70 42 65 2c 20 6d 65 74 61 29 3b 0a 20 20 20 20  pBe, meta);.    
3380: 20 20 6d 65 74 61 5b 32 5d 20 3d 20 34 3b 0a 20    meta[2] = 4;. 
3390: 20 20 20 20 20 73 71 6c 69 74 65 42 74 72 65 65       sqliteBtree
33a0: 55 70 64 61 74 65 4d 65 74 61 28 64 62 2d 3e 70  UpdateMeta(db->p
33b0: 42 65 2c 20 6d 65 74 61 29 3b 0a 20 20 20 20 20  Be, meta);.     
33c0: 20 73 71 6c 69 74 65 5f 65 78 65 63 28 64 62 2c   sqlite_exec(db,
33d0: 20 22 43 4f 4d 4d 49 54 22 2c 20 30 2c 20 30 2c   "COMMIT", 0, 0,
33e0: 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69   0);.    }.    i
33f0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
3400: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
3410: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d  SetString(pzErrM
3420: 73 67 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e  sg, .        "un
3430: 61 62 6c 65 20 74 6f 20 75 70 67 72 61 64 65 20  able to upgrade 
3440: 64 61 74 61 62 61 73 65 20 74 6f 20 74 68 65 20  database to the 
3450: 76 65 72 73 69 6f 6e 20 32 2e 36 20 66 6f 72 6d  version 2.6 form
3460: 61 74 22 2c 0a 20 20 20 20 20 20 20 20 7a 45 72  at",.        zEr
3470: 72 20 3f 20 22 3a 20 22 20 3a 20 30 2c 20 7a 45  r ? ": " : 0, zE
3480: 72 72 2c 20 30 29 3b 0a 20 20 20 20 20 20 73 71  rr, 0);.      sq
3490: 6c 69 74 65 5f 66 72 65 65 6d 65 6d 28 7a 45 72  lite_freemem(zEr
34a0: 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  r);.      sqlite
34b0: 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72  StrRealloc(pzErr
34c0: 4d 73 67 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  Msg);.      sqli
34d0: 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20  te_close(db);.  
34e0: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
34f0: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 5f 66    }.    sqlite_f
3500: 72 65 65 6d 65 6d 28 7a 45 72 72 29 3b 0a 20 20  reemem(zErr);.  
3510: 7d 0a 0a 20 20 2f 2a 20 52 65 74 75 72 6e 20 61  }..  /* Return a
3520: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
3530: 6e 65 77 6c 79 20 6f 70 65 6e 65 64 20 64 61 74  newly opened dat
3540: 61 62 61 73 65 20 73 74 72 75 63 74 75 72 65 20  abase structure 
3550: 2a 2f 0a 20 20 72 65 74 75 72 6e 20 64 62 3b 0a  */.  return db;.
3560: 0a 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3a  .no_mem_on_open:
3570: 0a 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69  .  sqliteSetStri
3580: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f 75  ng(pzErrMsg, "ou
3590: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 30 29  t of memory", 0)
35a0: 3b 0a 20 20 73 71 6c 69 74 65 53 74 72 52 65 61  ;.  sqliteStrRea
35b0: 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a  lloc(pzErrMsg);.
35c0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f    return 0;.}../
35d0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
35e0: 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6d 6f 73  ROWID of the mos
35f0: 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 0a  t recent insert.
3600: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 6c 61  */.int sqlite_la
3610: 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28  st_insert_rowid(
3620: 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 72  sqlite *db){.  r
3630: 65 74 75 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f  eturn db->lastRo
3640: 77 69 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  wid;.}../*.** Re
3650: 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20  turn the number 
3660: 6f 66 20 63 68 61 6e 67 65 73 20 69 6e 20 74 68  of changes in th
3670: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 61  e most recent ca
3680: 6c 6c 20 74 6f 20 73 71 6c 69 74 65 5f 65 78 65  ll to sqlite_exe
3690: 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  c()..*/.int sqli
36a0: 74 65 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74  te_changes(sqlit
36b0: 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e  e *db){.  return
36c0: 20 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a   db->nChange;.}.
36d0: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20  ./*.** Close an 
36e0: 65 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20  existing SQLite 
36f0: 64 61 74 61 62 61 73 65 0a 2a 2f 0a 76 6f 69 64  database.*/.void
3700: 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28 73 71   sqlite_close(sq
3710: 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 48 61 73  lite *db){.  Has
3720: 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 69 66 28 20  hElem *i;.  if( 
3730: 73 71 6c 69 74 65 53 61 66 65 74 79 43 68 65 63  sqliteSafetyChec
3740: 6b 28 64 62 29 20 7c 7c 20 73 71 6c 69 74 65 53  k(db) || sqliteS
3750: 61 66 65 74 79 4f 6e 28 64 62 29 20 29 7b 20 72  afetyOn(db) ){ r
3760: 65 74 75 72 6e 3b 20 7d 0a 20 20 64 62 2d 3e 6d  eturn; }.  db->m
3770: 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41  agic = SQLITE_MA
3780: 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 73 71  GIC_CLOSED;.  sq
3790: 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 65 28 64  liteBtreeClose(d
37a0: 62 2d 3e 70 42 65 29 3b 0a 20 20 73 71 6c 69 74  b->pBe);.  sqlit
37b0: 65 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  eResetInternalSc
37c0: 68 65 6d 61 28 64 62 29 3b 0a 20 20 69 66 28 20  hema(db);.  if( 
37d0: 64 62 2d 3e 70 42 65 54 65 6d 70 20 29 7b 0a 20  db->pBeTemp ){. 
37e0: 20 20 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c     sqliteBtreeCl
37f0: 6f 73 65 28 64 62 2d 3e 70 42 65 54 65 6d 70 29  ose(db->pBeTemp)
3800: 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 69 3d 73 71  ;.  }.  for(i=sq
3810: 6c 69 74 65 48 61 73 68 46 69 72 73 74 28 26 64  liteHashFirst(&d
3820: 62 2d 3e 61 46 75 6e 63 29 3b 20 69 3b 20 69 3d  b->aFunc); i; i=
3830: 73 71 6c 69 74 65 48 61 73 68 4e 65 78 74 28 69  sqliteHashNext(i
3840: 29 29 7b 0a 20 20 20 20 46 75 6e 63 44 65 66 20  )){.    FuncDef 
3850: 2a 70 46 75 6e 63 2c 20 2a 70 4e 65 78 74 3b 0a  *pFunc, *pNext;.
3860: 20 20 20 20 66 6f 72 28 70 46 75 6e 63 20 3d 20      for(pFunc = 
3870: 28 46 75 6e 63 44 65 66 2a 29 73 71 6c 69 74 65  (FuncDef*)sqlite
3880: 48 61 73 68 44 61 74 61 28 69 29 3b 20 70 46 75  HashData(i); pFu
3890: 6e 63 3b 20 70 46 75 6e 63 3d 70 4e 65 78 74 29  nc; pFunc=pNext)
38a0: 7b 0a 20 20 20 20 20 20 70 4e 65 78 74 20 3d 20  {.      pNext = 
38b0: 70 46 75 6e 63 2d 3e 70 4e 65 78 74 3b 0a 20 20  pFunc->pNext;.  
38c0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
38d0: 46 75 6e 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  Func);.    }.  }
38e0: 0a 20 20 73 71 6c 69 74 65 48 61 73 68 43 6c 65  .  sqliteHashCle
38f0: 61 72 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b 0a  ar(&db->aFunc);.
3900: 20 20 73 71 6c 69 74 65 48 61 73 68 43 6c 65 61    sqliteHashClea
3910: 72 28 26 64 62 2d 3e 61 46 4b 65 79 29 3b 0a 20  r(&db->aFKey);. 
3920: 20 73 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b   sqliteFree(db);
3930: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
3940: 20 54 52 55 45 20 69 66 20 74 68 65 20 67 69 76   TRUE if the giv
3950: 65 6e 20 53 51 4c 20 73 74 72 69 6e 67 20 65 6e  en SQL string en
3960: 64 73 20 69 6e 20 61 20 73 65 6d 69 63 6f 6c 6f  ds in a semicolo
3970: 6e 2e 0a 2a 2a 0a 2a 2a 20 53 70 65 63 69 61 6c  n..**.** Special
3980: 20 68 61 6e 64 6c 69 6e 67 20 69 73 20 72 65 71   handling is req
3990: 75 69 72 65 20 66 6f 72 20 43 52 45 41 54 45 20  uire for CREATE 
39a0: 54 52 49 47 47 45 52 20 73 74 61 74 65 6d 65 6e  TRIGGER statemen
39b0: 74 73 2e 0a 2a 2a 20 57 68 65 6e 65 76 65 72 20  ts..** Whenever 
39c0: 74 68 65 20 43 52 45 41 54 45 20 54 52 49 47 47  the CREATE TRIGG
39d0: 45 52 20 6b 65 79 77 6f 72 64 73 20 61 72 65 20  ER keywords are 
39e0: 73 65 65 6e 2c 20 74 68 65 20 73 74 61 74 65 6d  seen, the statem
39f0: 65 6e 74 0a 2a 2a 20 6d 75 73 74 20 65 6e 64 20  ent.** must end 
3a00: 77 69 74 68 20 22 3b 45 4e 44 3b 22 2e 0a 2a 2f  with ";END;"..*/
3a10: 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 6f 6d 70  .int sqlite_comp
3a20: 6c 65 74 65 28 63 6f 6e 73 74 20 63 68 61 72 20  lete(const char 
3a30: 2a 7a 53 71 6c 29 7b 0a 20 20 69 6e 74 20 69 73  *zSql){.  int is
3a40: 43 6f 6d 70 6c 65 74 65 20 3d 20 31 3b 0a 20 20  Complete = 1;.  
3a50: 69 6e 74 20 72 65 71 75 69 72 65 45 6e 64 20 3d  int requireEnd =
3a60: 20 30 3b 0a 20 20 69 6e 74 20 73 65 65 6e 54 65   0;.  int seenTe
3a70: 78 74 20 3d 20 30 3b 0a 20 20 69 6e 74 20 73 65  xt = 0;.  int se
3a80: 65 6e 43 72 65 61 74 65 20 3d 20 30 3b 0a 20 20  enCreate = 0;.  
3a90: 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20 29 7b 0a  while( *zSql ){.
3aa0: 20 20 20 20 73 77 69 74 63 68 28 20 2a 7a 53 71      switch( *zSq
3ab0: 6c 20 29 7b 0a 20 20 20 20 20 20 63 61 73 65 20  l ){.      case 
3ac0: 27 3b 27 3a 20 7b 0a 20 20 20 20 20 20 20 20 69  ';': {.        i
3ad0: 73 43 6f 6d 70 6c 65 74 65 20 3d 20 31 3b 0a 20  sComplete = 1;. 
3ae0: 20 20 20 20 20 20 20 73 65 65 6e 54 65 78 74 20         seenText 
3af0: 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 73 65 65  = 1;.        see
3b00: 6e 43 72 65 61 74 65 20 3d 20 30 3b 0a 20 20 20  nCreate = 0;.   
3b10: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
3b20: 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27    }.      case '
3b30: 20 27 3a 0a 20 20 20 20 20 20 63 61 73 65 20 27   ':.      case '
3b40: 5c 74 27 3a 0a 20 20 20 20 20 20 63 61 73 65 20  \t':.      case 
3b50: 27 5c 6e 27 3a 0a 20 20 20 20 20 20 63 61 73 65  '\n':.      case
3b60: 20 27 5c 66 27 3a 20 7b 0a 20 20 20 20 20 20 20   '\f': {.       
3b70: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a   break;.      }.
3b80: 20 20 20 20 20 20 63 61 73 65 20 27 5b 27 3a 20        case '[': 
3b90: 7b 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70  {.        isComp
3ba0: 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20  lete = 0;.      
3bb0: 20 20 73 65 65 6e 54 65 78 74 20 3d 20 31 3b 0a    seenText = 1;.
3bc0: 20 20 20 20 20 20 20 20 73 65 65 6e 43 72 65 61          seenCrea
3bd0: 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  te = 0;.        
3be0: 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20  zSql++;.        
3bf0: 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20 26 26 20  while( *zSql && 
3c00: 2a 7a 53 71 6c 21 3d 27 5d 27 20 29 7b 20 7a 53  *zSql!=']' ){ zS
3c10: 71 6c 2b 2b 3b 20 7d 0a 20 20 20 20 20 20 20 20  ql++; }.        
3c20: 69 66 28 20 2a 7a 53 71 6c 3d 3d 30 20 29 20 72  if( *zSql==0 ) r
3c30: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20 20  eturn 0;.       
3c40: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a   break;.      }.
3c50: 20 20 20 20 20 20 63 61 73 65 20 27 22 27 3a 0a        case '"':.
3c60: 20 20 20 20 20 20 63 61 73 65 20 27 5c 27 27 3a        case '\'':
3c70: 20 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 63   {.        int c
3c80: 20 3d 20 2a 7a 53 71 6c 3b 0a 20 20 20 20 20 20   = *zSql;.      
3c90: 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30    isComplete = 0
3ca0: 3b 0a 20 20 20 20 20 20 20 20 73 65 65 6e 54 65  ;.        seenTe
3cb0: 78 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20  xt = 1;.        
3cc0: 73 65 65 6e 43 72 65 61 74 65 20 3d 20 30 3b 0a  seenCreate = 0;.
3cd0: 20 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a          zSql++;.
3ce0: 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a          while( *
3cf0: 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 63  zSql && *zSql!=c
3d00: 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20 20   ){ zSql++; }.  
3d10: 20 20 20 20 20 20 69 66 28 20 2a 7a 53 71 6c 3d        if( *zSql=
3d20: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
3d30: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
3d40: 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65      }.      case
3d50: 20 27 2d 27 3a 20 7b 0a 20 20 20 20 20 20 20 20   '-': {.        
3d60: 69 66 28 20 7a 53 71 6c 5b 31 5d 21 3d 27 2d 27  if( zSql[1]!='-'
3d70: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 73   ){.          is
3d80: 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20  Complete = 0;.  
3d90: 20 20 20 20 20 20 20 20 73 65 65 6e 43 72 65 61          seenCrea
3da0: 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  te = 0;.        
3db0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20    break;.       
3dc0: 20 7d 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65   }.        while
3dd0: 28 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c  ( *zSql && *zSql
3de0: 21 3d 27 5c 6e 27 20 29 7b 20 7a 53 71 6c 2b 2b  !='\n' ){ zSql++
3df0: 3b 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20  ; }.        if( 
3e00: 2a 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72  *zSql==0 ) retur
3e10: 6e 20 73 65 65 6e 54 65 78 74 20 26 26 20 69 73  n seenText && is
3e20: 43 6f 6d 70 6c 65 74 65 20 26 26 20 72 65 71 75  Complete && requ
3e30: 69 72 65 45 6e 64 3d 3d 30 3b 0a 20 20 20 20 20  ireEnd==0;.     
3e40: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
3e50: 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27 63 27  }.      case 'c'
3e60: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 27 43 27  :.      case 'C'
3e70: 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 65 65 6e  : {.        seen
3e80: 54 65 78 74 20 3d 20 31 3b 0a 20 20 20 20 20 20  Text = 1;.      
3e90: 20 20 69 66 28 20 21 69 73 43 6f 6d 70 6c 65 74    if( !isComplet
3ea0: 65 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20  e ) break;.     
3eb0: 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20     isComplete = 
3ec0: 30 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 73  0;.        if( s
3ed0: 71 6c 69 74 65 53 74 72 4e 49 43 6d 70 28 7a 53  qliteStrNICmp(zS
3ee0: 71 6c 2c 20 22 63 72 65 61 74 65 22 2c 20 36 29  ql, "create", 6)
3ef0: 21 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20  !=0 ) break;.   
3f00: 20 20 20 20 20 69 66 28 20 21 69 73 73 70 61 63       if( !isspac
3f10: 65 28 7a 53 71 6c 5b 36 5d 29 20 29 20 62 72 65  e(zSql[6]) ) bre
3f20: 61 6b 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c  ak;.        zSql
3f30: 20 2b 3d 20 35 3b 0a 20 20 20 20 20 20 20 20 73   += 5;.        s
3f40: 65 65 6e 43 72 65 61 74 65 20 3d 20 31 3b 0a 20  eenCreate = 1;. 
3f50: 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 69 73         while( is
3f60: 73 70 61 63 65 28 7a 53 71 6c 5b 31 5d 29 20 29  space(zSql[1]) )
3f70: 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20 20 20 20   zSql++;.       
3f80: 20 69 66 28 20 73 71 6c 69 74 65 53 74 72 4e 49   if( sqliteStrNI
3f90: 43 6d 70 28 26 7a 53 71 6c 5b 31 5d 2c 22 74 72  Cmp(&zSql[1],"tr
3fa0: 69 67 67 65 72 22 2c 20 37 29 21 3d 30 20 29 20  igger", 7)!=0 ) 
3fb0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7a  break;.        z
3fc0: 53 71 6c 20 2b 3d 20 37 3b 0a 20 20 20 20 20 20  Sql += 7;.      
3fd0: 20 20 72 65 71 75 69 72 65 45 6e 64 2b 2b 3b 0a    requireEnd++;.
3fe0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
3ff0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73       }.      cas
4000: 65 20 27 74 27 3a 0a 20 20 20 20 20 20 63 61 73  e 't':.      cas
4010: 65 20 27 54 27 3a 20 7b 0a 20 20 20 20 20 20 20  e 'T': {.       
4020: 20 73 65 65 6e 54 65 78 74 20 3d 20 31 3b 0a 20   seenText = 1;. 
4030: 20 20 20 20 20 20 20 69 66 28 20 21 73 65 65 6e         if( !seen
4040: 43 72 65 61 74 65 20 29 20 62 72 65 61 6b 3b 0a  Create ) break;.
4050: 20 20 20 20 20 20 20 20 73 65 65 6e 43 72 65 61          seenCrea
4060: 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  te = 0;.        
4070: 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a  isComplete = 0;.
4080: 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c 69          if( sqli
4090: 74 65 53 74 72 4e 49 43 6d 70 28 7a 53 71 6c 2c  teStrNICmp(zSql,
40a0: 20 22 74 72 69 67 67 65 72 22 2c 20 37 29 21 3d   "trigger", 7)!=
40b0: 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20  0 ) break;.     
40c0: 20 20 20 69 66 28 20 21 69 73 73 70 61 63 65 28     if( !isspace(
40d0: 7a 53 71 6c 5b 37 5d 29 20 29 20 62 72 65 61 6b  zSql[7]) ) break
40e0: 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 20 2b  ;.        zSql +
40f0: 3d 20 36 3b 0a 20 20 20 20 20 20 20 20 72 65 71  = 6;.        req
4100: 75 69 72 65 45 6e 64 2b 2b 3b 0a 20 20 20 20 20  uireEnd++;.     
4110: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
4120: 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27 65 27  }.      case 'e'
4130: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 27 45 27  :.      case 'E'
4140: 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 65 65 6e  : {.        seen
4150: 43 72 65 61 74 65 20 3d 20 30 3b 0a 20 20 20 20  Create = 0;.    
4160: 20 20 20 20 73 65 65 6e 54 65 78 74 20 3d 20 31      seenText = 1
4170: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 69  ;.        if( !i
4180: 73 43 6f 6d 70 6c 65 74 65 20 29 20 62 72 65 61  sComplete ) brea
4190: 6b 3b 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d  k;.        isCom
41a0: 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20  plete = 0;.     
41b0: 20 20 20 69 66 28 20 72 65 71 75 69 72 65 45 6e     if( requireEn
41c0: 64 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20  d==0 ) break;.  
41d0: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65        if( sqlite
41e0: 53 74 72 4e 49 43 6d 70 28 7a 53 71 6c 2c 20 22  StrNICmp(zSql, "
41f0: 65 6e 64 22 2c 20 33 29 21 3d 30 20 29 20 62 72  end", 3)!=0 ) br
4200: 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7a 53 71  eak;.        zSq
4210: 6c 20 2b 3d 20 32 3b 0a 20 20 20 20 20 20 20 20  l += 2;.        
4220: 77 68 69 6c 65 28 20 69 73 73 70 61 63 65 28 7a  while( isspace(z
4230: 53 71 6c 5b 31 5d 29 20 29 20 7a 53 71 6c 2b 2b  Sql[1]) ) zSql++
4240: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a 53  ;.        if( zS
4250: 71 6c 5b 31 5d 3d 3d 27 3b 27 20 29 7b 0a 20 20  ql[1]==';' ){.  
4260: 20 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a          zSql++;.
4270: 20 20 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70            isComp
4280: 6c 65 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20  lete = 1;.      
4290: 20 20 20 20 72 65 71 75 69 72 65 45 6e 64 2d 2d      requireEnd--
42a0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
42b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
42c0: 20 7d 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74   }.      default
42d0: 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 65 65 6e  : {.        seen
42e0: 43 72 65 61 74 65 20 3d 20 30 3b 0a 20 20 20 20  Create = 0;.    
42f0: 20 20 20 20 73 65 65 6e 54 65 78 74 20 3d 20 31      seenText = 1
4300: 3b 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70  ;.        isComp
4310: 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20  lete = 0;.      
4320: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d    break;.      }
4330: 0a 20 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 2b  .    }.    zSql+
4340: 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  +;.  }.  return 
4350: 73 65 65 6e 54 65 78 74 20 26 26 20 69 73 43 6f  seenText && isCo
4360: 6d 70 6c 65 74 65 20 26 26 20 72 65 71 75 69 72  mplete && requir
4370: 65 45 6e 64 3d 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a  eEnd==0;.}../*.*
4380: 2a 20 45 78 65 63 75 74 65 20 53 51 4c 20 63 6f  * Execute SQL co
4390: 64 65 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65 20  de.  Return one 
43a0: 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20 73  of the SQLITE_ s
43b0: 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 0a 2a  uccess/failure.*
43c0: 2a 20 63 6f 64 65 73 2e 20 20 41 6c 73 6f 20 77  * codes.  Also w
43d0: 72 69 74 65 20 61 6e 20 65 72 72 6f 72 20 6d 65  rite an error me
43e0: 73 73 61 67 65 20 69 6e 74 6f 20 6d 65 6d 6f 72  ssage into memor
43f0: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a  y obtained from.
4400: 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 61 6e 64 20  ** malloc() and 
4410: 6d 61 6b 65 20 2a 70 7a 45 72 72 4d 73 67 20 70  make *pzErrMsg p
4420: 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 6d 65 73  oint to that mes
4430: 73 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74  sage..**.** If t
4440: 68 65 20 53 51 4c 20 69 73 20 61 20 71 75 65 72  he SQL is a quer
4450: 79 2c 20 74 68 65 6e 20 66 6f 72 20 65 61 63 68  y, then for each
4460: 20 72 6f 77 20 69 6e 20 74 68 65 20 71 75 65 72   row in the quer
4470: 79 20 72 65 73 75 6c 74 0a 2a 2a 20 74 68 65 20  y result.** the 
4480: 78 43 61 6c 6c 62 61 63 6b 28 29 20 66 75 6e 63  xCallback() func
4490: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 20  tion is called. 
44a0: 20 70 41 72 67 20 62 65 63 6f 6d 65 73 20 74 68   pArg becomes th
44b0: 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d  e first.** argum
44c0: 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b  ent to xCallback
44d0: 28 29 2e 20 20 49 66 20 78 43 61 6c 6c 62 61 63  ().  If xCallbac
44e0: 6b 3d 4e 55 4c 4c 20 74 68 65 6e 20 6e 6f 20 63  k=NULL then no c
44f0: 61 6c 6c 62 61 63 6b 0a 2a 2a 20 69 73 20 69 6e  allback.** is in
4500: 76 6f 6b 65 64 2c 20 65 76 65 6e 20 66 6f 72 20  voked, even for 
4510: 71 75 65 72 69 65 73 2e 0a 2a 2f 0a 69 6e 74 20  queries..*/.int 
4520: 73 71 6c 69 74 65 5f 65 78 65 63 28 0a 20 20 73  sqlite_exec(.  s
4530: 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20  qlite *db,      
4540: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
4550: 65 20 64 61 74 61 62 61 73 65 20 6f 6e 20 77 68  e database on wh
4560: 69 63 68 20 74 68 65 20 53 51 4c 20 65 78 65 63  ich the SQL exec
4570: 75 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  utes */.  const 
4580: 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20  char *zSql,     
4590: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51 4c        /* The SQL
45a0: 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20   to be executed 
45b0: 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 63 61 6c 6c  */.  sqlite_call
45c0: 62 61 63 6b 20 78 43 61 6c 6c 62 61 63 6b 2c 20  back xCallback, 
45d0: 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 69 73 20   /* Invoke this 
45e0: 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65  callback routine
45f0: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67   */.  void *pArg
4600: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
4610: 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d    /* First argum
4620: 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b  ent to xCallback
4630: 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70  () */.  char **p
4640: 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 20 20  zErrMsg         
4650: 20 20 20 20 2f 2a 20 57 72 69 74 65 20 65 72 72      /* Write err
4660: 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 72 65  or messages here
4670: 20 2a 2f 0a 29 7b 0a 20 20 50 61 72 73 65 20 73   */.){.  Parse s
4680: 50 61 72 73 65 3b 0a 0a 20 20 69 66 28 20 70 7a  Parse;..  if( pz
4690: 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72 72 4d  ErrMsg ) *pzErrM
46a0: 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20 73 71  sg = 0;.  if( sq
46b0: 6c 69 74 65 53 61 66 65 74 79 4f 6e 28 64 62 29  liteSafetyOn(db)
46c0: 20 29 20 67 6f 74 6f 20 65 78 65 63 5f 6d 69 73   ) goto exec_mis
46d0: 75 73 65 3b 0a 20 20 69 66 28 20 28 64 62 2d 3e  use;.  if( (db->
46e0: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49  flags & SQLITE_I
46f0: 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29  nitialized)==0 )
4700: 7b 0a 20 20 20 20 69 6e 74 20 72 63 2c 20 63 6e  {.    int rc, cn
4710: 74 20 3d 20 31 3b 0a 20 20 20 20 77 68 69 6c 65  t = 1;.    while
4720: 28 20 28 72 63 20 3d 20 73 71 6c 69 74 65 49 6e  ( (rc = sqliteIn
4730: 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29  it(db, pzErrMsg)
4740: 29 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 0a 20  )==SQLITE_BUSY. 
4750: 20 20 20 20 20 20 26 26 20 64 62 2d 3e 78 42 75        && db->xBu
4760: 73 79 43 61 6c 6c 62 61 63 6b 20 26 26 20 64 62  syCallback && db
4770: 2d 3e 78 42 75 73 79 43 61 6c 6c 62 61 63 6b 28  ->xBusyCallback(
4780: 64 62 2d 3e 70 42 75 73 79 41 72 67 2c 20 22 22  db->pBusyArg, ""
4790: 2c 20 63 6e 74 2b 2b 29 21 3d 30 20 29 7b 7d 0a  , cnt++)!=0 ){}.
47a0: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
47b0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73  TE_OK ){.      s
47c0: 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28  qliteStrRealloc(
47d0: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20  pzErrMsg);.     
47e0: 20 73 71 6c 69 74 65 53 61 66 65 74 79 4f 66 66   sqliteSafetyOff
47f0: 28 64 62 29 3b 0a 20 20 20 20 20 20 72 65 74 75  (db);.      retu
4800: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20  rn rc;.    }.   
4810: 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b   if( pzErrMsg ){
4820: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65  .      sqliteFre
4830: 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  e(*pzErrMsg);.  
4840: 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20      *pzErrMsg = 
4850: 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69  0;.    }.  }.  i
4860: 66 28 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d  f( db->file_form
4870: 61 74 3c 33 20 29 7b 0a 20 20 20 20 73 71 6c 69  at<3 ){.    sqli
4880: 74 65 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b  teSafetyOff(db);
4890: 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74  .    sqliteSetSt
48a0: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22  ring(pzErrMsg, "
48b0: 6f 62 73 6f 6c 65 74 65 20 64 61 74 61 62 61 73  obsolete databas
48c0: 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c 20  e file format", 
48d0: 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  0);.    return S
48e0: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d  QLITE_ERROR;.  }
48f0: 0a 20 20 69 66 28 20 64 62 2d 3e 72 65 63 75 72  .  if( db->recur
4900: 73 69 6f 6e 44 65 70 74 68 3d 3d 30 20 29 7b 20  sionDepth==0 ){ 
4910: 64 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b  db->nChange = 0;
4920: 20 7d 0a 20 20 64 62 2d 3e 72 65 63 75 72 73 69   }.  db->recursi
4930: 6f 6e 44 65 70 74 68 2b 2b 3b 0a 20 20 6d 65 6d  onDepth++;.  mem
4940: 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c 20  set(&sParse, 0, 
4950: 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29 29 3b  sizeof(sParse));
4960: 0a 20 20 73 50 61 72 73 65 2e 64 62 20 3d 20 64  .  sParse.db = d
4970: 62 3b 0a 20 20 73 50 61 72 73 65 2e 70 42 65 20  b;.  sParse.pBe 
4980: 3d 20 64 62 2d 3e 70 42 65 3b 0a 20 20 73 50 61  = db->pBe;.  sPa
4990: 72 73 65 2e 78 43 61 6c 6c 62 61 63 6b 20 3d 20  rse.xCallback = 
49a0: 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 73 50 61  xCallback;.  sPa
49b0: 72 73 65 2e 70 41 72 67 20 3d 20 70 41 72 67 3b  rse.pArg = pArg;
49c0: 0a 20 20 73 71 6c 69 74 65 52 75 6e 50 61 72 73  .  sqliteRunPars
49d0: 65 72 28 26 73 50 61 72 73 65 2c 20 7a 53 71 6c  er(&sParse, zSql
49e0: 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69  , pzErrMsg);.  i
49f0: 66 28 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63  f( sqlite_malloc
4a00: 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73  _failed ){.    s
4a10: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70  qliteSetString(p
4a20: 7a 45 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66  zErrMsg, "out of
4a30: 20 6d 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20   memory", 0);.  
4a40: 20 20 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51    sParse.rc = SQ
4a50: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
4a60: 73 71 6c 69 74 65 42 74 72 65 65 52 6f 6c 6c 62  sqliteBtreeRollb
4a70: 61 63 6b 28 64 62 2d 3e 70 42 65 29 3b 0a 20 20  ack(db->pBe);.  
4a80: 20 20 69 66 28 20 64 62 2d 3e 70 42 65 54 65 6d    if( db->pBeTem
4a90: 70 20 29 20 73 71 6c 69 74 65 42 74 72 65 65 52  p ) sqliteBtreeR
4aa0: 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 42 65 54  ollback(db->pBeT
4ab0: 65 6d 70 29 3b 0a 20 20 20 20 64 62 2d 3e 66 6c  emp);.    db->fl
4ac0: 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49  ags &= ~SQLITE_I
4ad0: 6e 54 72 61 6e 73 3b 0a 20 20 20 20 73 71 6c 69  nTrans;.    sqli
4ae0: 74 65 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53  teResetInternalS
4af0: 63 68 65 6d 61 28 64 62 29 3b 0a 20 20 7d 0a 20  chema(db);.  }. 
4b00: 20 69 66 28 20 73 50 61 72 73 65 2e 72 63 21 3d   if( sParse.rc!=
4b10: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 7a 45  SQLITE_OK && pzE
4b20: 72 72 4d 73 67 20 26 26 20 2a 70 7a 45 72 72 4d  rrMsg && *pzErrM
4b30: 73 67 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c  sg==0 ){.    sql
4b40: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45  iteSetString(pzE
4b50: 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f 65 72  rrMsg, sqlite_er
4b60: 72 6f 72 5f 73 74 72 69 6e 67 28 73 50 61 72 73  ror_string(sPars
4b70: 65 2e 72 63 29 2c 20 30 29 3b 0a 20 20 7d 0a 20  e.rc), 0);.  }. 
4b80: 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f   sqliteStrReallo
4b90: 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69  c(pzErrMsg);.  i
4ba0: 66 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51  f( sParse.rc==SQ
4bb0: 4c 49 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20  LITE_SCHEMA ){. 
4bc0: 20 20 20 73 71 6c 69 74 65 52 65 73 65 74 49 6e     sqliteResetIn
4bd0: 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 29  ternalSchema(db)
4be0: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 72 65 63 75  ;.  }.  db->recu
4bf0: 72 73 69 6f 6e 44 65 70 74 68 2d 2d 3b 0a 20 20  rsionDepth--;.  
4c00: 69 66 28 20 73 71 6c 69 74 65 53 61 66 65 74 79  if( sqliteSafety
4c10: 4f 66 66 28 64 62 29 20 29 20 67 6f 74 6f 20 65  Off(db) ) goto e
4c20: 78 65 63 5f 6d 69 73 75 73 65 3b 0a 20 20 72 65  xec_misuse;.  re
4c30: 74 75 72 6e 20 73 50 61 72 73 65 2e 72 63 3b 0a  turn sParse.rc;.
4c40: 0a 65 78 65 63 5f 6d 69 73 75 73 65 3a 0a 20 20  .exec_misuse:.  
4c50: 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a  if( pzErrMsg ){.
4c60: 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20      *pzErrMsg = 
4c70: 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74  0;.    sqliteSet
4c80: 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c  String(pzErrMsg,
4c90: 20 73 71 6c 69 74 65 5f 65 72 72 6f 72 5f 73 74   sqlite_error_st
4ca0: 72 69 6e 67 28 53 51 4c 49 54 45 5f 4d 49 53 55  ring(SQLITE_MISU
4cb0: 53 45 29 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c  SE), 0);.    sql
4cc0: 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a  iteStrRealloc(pz
4cd0: 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 72  ErrMsg);.  }.  r
4ce0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
4cf0: 55 53 45 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  USE;.}../*.** Re
4d00: 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 74  turn a static st
4d10: 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 69  ring that descri
4d20: 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 20  bes the kind of 
4d30: 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 20  error specified 
4d40: 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65  in the.** argume
4d50: 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  nt..*/.const cha
4d60: 72 20 2a 73 71 6c 69 74 65 5f 65 72 72 6f 72 5f  r *sqlite_error_
4d70: 73 74 72 69 6e 67 28 69 6e 74 20 72 63 29 7b 0a  string(int rc){.
4d80: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b    const char *z;
4d90: 0a 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b  .  switch( rc ){
4da0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4db0: 5f 4f 4b 3a 20 20 20 20 20 20 20 20 20 7a 20 3d  _OK:         z =
4dc0: 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 3b   "not an error";
4dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4de0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
4df0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4e00: 5f 45 52 52 4f 52 3a 20 20 20 20 20 20 7a 20 3d  _ERROR:      z =
4e10: 20 22 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f   "SQL logic erro
4e20: 72 20 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74  r or missing dat
4e30: 61 62 61 73 65 22 3b 20 20 20 62 72 65 61 6b 3b  abase";   break;
4e40: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4e50: 5f 49 4e 54 45 52 4e 41 4c 3a 20 20 20 7a 20 3d  _INTERNAL:   z =
4e60: 20 22 69 6e 74 65 72 6e 61 6c 20 53 51 4c 69 74   "internal SQLit
4e70: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  e implementation
4e80: 20 66 6c 61 77 22 3b 20 20 20 62 72 65 61 6b 3b   flaw";   break;
4e90: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4ea0: 5f 50 45 52 4d 3a 20 20 20 20 20 20 20 7a 20 3d  _PERM:       z =
4eb0: 20 22 61 63 63 65 73 73 20 70 65 72 6d 69 73 73   "access permiss
4ec0: 69 6f 6e 20 64 65 6e 69 65 64 22 3b 20 20 20 20  ion denied";    
4ed0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
4ee0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4ef0: 5f 41 42 4f 52 54 3a 20 20 20 20 20 20 7a 20 3d  _ABORT:      z =
4f00: 20 22 63 61 6c 6c 62 61 63 6b 20 72 65 71 75 65   "callback reque
4f10: 73 74 65 64 20 71 75 65 72 79 20 61 62 6f 72 74  sted query abort
4f20: 22 3b 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ";        break;
4f30: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4f40: 5f 42 55 53 59 3a 20 20 20 20 20 20 20 7a 20 3d  _BUSY:       z =
4f50: 20 22 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f   "database is lo
4f60: 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20 20  cked";          
4f70: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
4f80: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4f90: 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 20 7a 20 3d  _LOCKED:     z =
4fa0: 20 22 64 61 74 61 62 61 73 65 20 74 61 62 6c 65   "database table
4fb0: 20 69 73 20 6c 6f 63 6b 65 64 22 3b 20 20 20 20   is locked";    
4fc0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
4fd0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
4fe0: 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 20 7a 20 3d  _NOMEM:      z =
4ff0: 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22   "out of memory"
5000: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
5010: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5020: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5030: 5f 52 45 41 44 4f 4e 4c 59 3a 20 20 20 7a 20 3d  _READONLY:   z =
5040: 20 22 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69   "attempt to wri
5050: 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 20 64 61  te a readonly da
5060: 74 61 62 61 73 65 22 3b 20 20 62 72 65 61 6b 3b  tabase";  break;
5070: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5080: 5f 49 4e 54 45 52 52 55 50 54 3a 20 20 7a 20 3d  _INTERRUPT:  z =
5090: 20 22 69 6e 74 65 72 72 75 70 74 65 64 22 3b 20   "interrupted"; 
50a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
50b0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
50c0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
50d0: 5f 49 4f 45 52 52 3a 20 20 20 20 20 20 7a 20 3d  _IOERR:      z =
50e0: 20 22 64 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72   "disk I/O error
50f0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
5100: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5110: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5120: 5f 43 4f 52 52 55 50 54 3a 20 20 20 20 7a 20 3d  _CORRUPT:    z =
5130: 20 22 64 61 74 61 62 61 73 65 20 64 69 73 6b 20   "database disk 
5140: 69 6d 61 67 65 20 69 73 20 6d 61 6c 66 6f 72 6d  image is malform
5150: 65 64 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b  ed";      break;
5160: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5170: 5f 4e 4f 54 46 4f 55 4e 44 3a 20 20 20 7a 20 3d  _NOTFOUND:   z =
5180: 20 22 74 61 62 6c 65 20 6f 72 20 72 65 63 6f 72   "table or recor
5190: 64 20 6e 6f 74 20 66 6f 75 6e 64 22 3b 20 20 20  d not found";   
51a0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
51b0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
51c0: 5f 46 55 4c 4c 3a 20 20 20 20 20 20 20 7a 20 3d  _FULL:       z =
51d0: 20 22 64 61 74 61 62 61 73 65 20 69 73 20 66 75   "database is fu
51e0: 6c 6c 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ll";            
51f0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5200: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5210: 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20 7a 20 3d  _CANTOPEN:   z =
5220: 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e   "unable to open
5230: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 22 3b   database file";
5240: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5250: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5260: 5f 50 52 4f 54 4f 43 4f 4c 3a 20 20 20 7a 20 3d  _PROTOCOL:   z =
5270: 20 22 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 69   "database locki
5280: 6e 67 20 70 72 6f 74 6f 63 6f 6c 20 66 61 69 6c  ng protocol fail
5290: 75 72 65 22 3b 20 20 20 20 20 62 72 65 61 6b 3b  ure";     break;
52a0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
52b0: 5f 45 4d 50 54 59 3a 20 20 20 20 20 20 7a 20 3d  _EMPTY:      z =
52c0: 20 22 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73   "table contains
52d0: 20 6e 6f 20 64 61 74 61 22 3b 20 20 20 20 20 20   no data";      
52e0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
52f0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5300: 5f 53 43 48 45 4d 41 3a 20 20 20 20 20 7a 20 3d  _SCHEMA:     z =
5310: 20 22 64 61 74 61 62 61 73 65 20 73 63 68 65 6d   "database schem
5320: 61 20 68 61 73 20 63 68 61 6e 67 65 64 22 3b 20  a has changed"; 
5330: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5340: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5350: 5f 54 4f 4f 42 49 47 3a 20 20 20 20 20 7a 20 3d  _TOOBIG:     z =
5360: 20 22 74 6f 6f 20 6d 75 63 68 20 64 61 74 61 20   "too much data 
5370: 66 6f 72 20 6f 6e 65 20 74 61 62 6c 65 20 72 6f  for one table ro
5380: 77 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b  w";       break;
5390: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
53a0: 5f 43 4f 4e 53 54 52 41 49 4e 54 3a 20 7a 20 3d  _CONSTRAINT: z =
53b0: 20 22 63 6f 6e 73 74 72 61 69 6e 74 20 66 61 69   "constraint fai
53c0: 6c 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20  led";           
53d0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
53e0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
53f0: 5f 4d 49 53 4d 41 54 43 48 3a 20 20 20 7a 20 3d  _MISMATCH:   z =
5400: 20 22 64 61 74 61 74 79 70 65 20 6d 69 73 6d 61   "datatype misma
5410: 74 63 68 22 3b 20 20 20 20 20 20 20 20 20 20 20  tch";           
5420: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5430: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5440: 5f 4d 49 53 55 53 45 3a 20 20 20 20 20 7a 20 3d  _MISUSE:     z =
5450: 20 22 6c 69 62 72 61 72 79 20 72 6f 75 74 69 6e   "library routin
5460: 65 20 63 61 6c 6c 65 64 20 6f 75 74 20 6f 66 20  e called out of 
5470: 73 65 71 75 65 6e 63 65 22 3b 62 72 65 61 6b 3b  sequence";break;
5480: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5490: 5f 4e 4f 4c 46 53 3a 20 20 20 20 20 20 7a 20 3d  _NOLFS:      z =
54a0: 20 22 6b 65 72 6e 65 6c 20 6c 61 63 6b 73 20 6c   "kernel lacks l
54b0: 61 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72  arge file suppor
54c0: 74 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b  t";       break;
54d0: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 20 20  .    default:   
54e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 20 3d               z =
54f0: 20 22 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f 72 22   "unknown error"
5500: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
5510: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5520: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b  .  }.  return z;
5530: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
5540: 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74  outine implement
5550: 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 61 63  s a busy callbac
5560: 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 61 6e  k that sleeps an
5570: 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e  d tries.** again
5580: 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 74   until a timeout
5590: 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 68 65   value is reache
55a0: 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 74 20  d.  The timeout 
55b0: 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69  value is.** an i
55c0: 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66  nteger number of
55d0: 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61   milliseconds pa
55e0: 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 66  ssed in as the f
55f0: 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74  irst.** argument
5600: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
5610: 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73  sqliteDefaultBus
5620: 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64  yCallback(. void
5630: 20 2a 54 69 6d 65 6f 75 74 2c 20 20 20 20 20 20   *Timeout,      
5640: 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20       /* Maximum 
5650: 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 74  amount of time t
5660: 6f 20 77 61 69 74 20 2a 2f 0a 20 63 6f 6e 73 74  o wait */. const
5670: 20 63 68 61 72 20 2a 4e 6f 74 55 73 65 64 2c 20   char *NotUsed, 
5680: 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 6d 65 20      /* The name 
5690: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61  of the table tha
56a0: 74 20 69 73 20 62 75 73 79 20 2a 2f 0a 20 69 6e  t is busy */. in
56b0: 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20 20  t count         
56c0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
56d0: 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65 20   of times table 
56e0: 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a 2f  has been busy */
56f0: 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d  .){.#if SQLITE_M
5700: 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20  IN_SLEEP_MS==1. 
5710: 20 69 6e 74 20 64 65 6c 61 79 20 3d 20 31 30 3b   int delay = 10;
5720: 0a 20 20 69 6e 74 20 70 72 69 6f 72 5f 64 65 6c  .  int prior_del
5730: 61 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 74 69  ay = 0;.  int ti
5740: 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54 69 6d  meout = (int)Tim
5750: 65 6f 75 74 3b 0a 20 20 69 6e 74 20 69 3b 0a 0a  eout;.  int i;..
5760: 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 63 6f 75    for(i=1; i<cou
5770: 6e 74 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 70  nt; i++){ .    p
5780: 72 69 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 64 65  rior_delay += de
5790: 6c 61 79 3b 0a 20 20 20 20 64 65 6c 61 79 20 3d  lay;.    delay =
57a0: 20 64 65 6c 61 79 2a 32 3b 0a 20 20 20 20 69 66   delay*2;.    if
57b0: 28 20 64 65 6c 61 79 3e 3d 31 30 30 30 20 29 7b  ( delay>=1000 ){
57c0: 0a 20 20 20 20 20 20 64 65 6c 61 79 20 3d 20 31  .      delay = 1
57d0: 30 30 30 3b 0a 20 20 20 20 20 20 70 72 69 6f 72  000;.      prior
57e0: 5f 64 65 6c 61 79 20 2b 3d 20 31 30 30 30 2a 28  _delay += 1000*(
57f0: 63 6f 75 6e 74 20 2d 20 69 20 2d 20 31 29 3b 0a  count - i - 1);.
5800: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5810: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 72 69   }.  }.  if( pri
5820: 6f 72 5f 64 65 6c 61 79 20 2b 20 64 65 6c 61 79  or_delay + delay
5830: 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20   > timeout ){.  
5840: 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75    delay = timeou
5850: 74 20 2d 20 70 72 69 6f 72 5f 64 65 6c 61 79 3b  t - prior_delay;
5860: 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c 3d  .    if( delay<=
5870: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
5880: 7d 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c 65 65  }.  sqliteOsSlee
5890: 70 28 64 65 6c 61 79 29 3b 0a 20 20 72 65 74 75  p(delay);.  retu
58a0: 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69 6e  rn 1;.#else.  in
58b0: 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74  t timeout = (int
58c0: 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20  )Timeout;.  if( 
58d0: 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e  (count+1)*1000 >
58e0: 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20   timeout ){.    
58f0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
5900: 73 71 6c 69 74 65 4f 73 53 6c 65 65 70 28 31 30  sqliteOsSleep(10
5910: 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b  00);.  return 1;
5920: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a  .#endif.}../*.**
5930: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65   This routine se
5940: 74 73 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c  ts the busy call
5950: 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69  back for an Sqli
5960: 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74  te database to t
5970: 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c  he.** given call
5980: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69  back function wi
5990: 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67  th the given arg
59a0: 75 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ument..*/.void s
59b0: 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c  qlite_busy_handl
59c0: 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  er(.  sqlite *db
59d0: 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79 29  ,.  int (*xBusy)
59e0: 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61  (void*,const cha
59f0: 72 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20  r*,int),.  void 
5a00: 2a 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d 3e 78  *pArg.){.  db->x
5a10: 42 75 73 79 43 61 6c 6c 62 61 63 6b 20 3d 20 78  BusyCallback = x
5a20: 42 75 73 79 3b 0a 20 20 64 62 2d 3e 70 42 75 73  Busy;.  db->pBus
5a30: 79 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d 0a 0a  yArg = pArg;.}..
5a40: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
5a50: 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65  ne installs a de
5a60: 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c  fault busy handl
5a70: 65 72 20 74 68 61 74 20 77 61 69 74 73 20 66 6f  er that waits fo
5a80: 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69  r the.** specifi
5a90: 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c  ed number of mil
5aa0: 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65  liseconds before
5ab0: 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f   returning 0..*/
5ac0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 75 73  .void sqlite_bus
5ad0: 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65  y_timeout(sqlite
5ae0: 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20   *db, int ms){. 
5af0: 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20   if( ms>0 ){.   
5b00: 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e   sqlite_busy_han
5b10: 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44  dler(db, sqliteD
5b20: 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61  efaultBusyCallba
5b30: 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a  ck, (void*)ms);.
5b40: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
5b50: 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72  ite_busy_handler
5b60: 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a  (db, 0, 0);.  }.
5b70: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61  }../*.** Cause a
5b80: 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61  ny pending opera
5b90: 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20  tion to stop at 
5ba0: 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70  its earliest opp
5bb0: 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69  ortunity..*/.voi
5bc0: 64 20 73 71 6c 69 74 65 5f 69 6e 74 65 72 72 75  d sqlite_interru
5bd0: 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a  pt(sqlite *db){.
5be0: 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53    db->flags |= S
5bf0: 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b  QLITE_Interrupt;
5c00: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77  .}../*.** Window
5c10: 73 20 73 79 73 74 65 6d 73 20 73 68 6f 75 6c 64  s systems should
5c20: 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69   call this routi
5c30: 6e 65 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f 72  ne to free memor
5c40: 79 20 74 68 61 74 0a 2a 2a 20 69 73 20 72 65 74  y that.** is ret
5c50: 75 72 6e 65 64 20 69 6e 20 74 68 65 20 69 6e 20  urned in the in 
5c60: 74 68 65 20 65 72 72 6d 73 67 20 70 61 72 61 6d  the errmsg param
5c70: 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 5f 6f  eter of sqlite_o
5c80: 70 65 6e 28 29 20 77 68 65 6e 0a 2a 2a 20 53 51  pen() when.** SQ
5c90: 4c 69 74 65 20 69 73 20 61 20 44 4c 4c 2e 20 20  Lite is a DLL.  
5ca0: 46 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c  For some reason,
5cb0: 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72   it does not wor
5cc0: 6b 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28 29  k to call free()
5cd0: 0a 2a 2a 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2a  .** directly..**
5ce0: 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 77 65  .** Note that we
5cf0: 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 66 72   need to call fr
5d00: 65 65 28 29 20 6e 6f 74 20 73 71 6c 69 74 65 46  ee() not sqliteF
5d10: 72 65 65 28 29 20 68 65 72 65 2c 20 73 69 6e 63  ree() here, sinc
5d20: 65 20 65 76 65 72 79 0a 2a 2a 20 73 74 72 69 6e  e every.** strin
5d30: 67 20 74 68 61 74 20 69 73 20 65 78 70 6f 72 74  g that is export
5d40: 65 64 20 66 72 6f 6d 20 53 51 4c 69 74 65 20 73  ed from SQLite s
5d50: 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61  hould have alrea
5d60: 64 79 20 70 61 73 73 65 64 20 74 68 72 6f 75 67  dy passed throug
5d70: 68 0a 2a 2a 20 73 71 6c 69 74 65 53 74 72 52 65  h.** sqliteStrRe
5d80: 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64  alloc()..*/.void
5d90: 20 73 71 6c 69 74 65 5f 66 72 65 65 6d 65 6d 28   sqlite_freemem(
5da0: 76 6f 69 64 20 2a 70 29 7b 20 66 72 65 65 28 70  void *p){ free(p
5db0: 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64  ); }../*.** Wind
5dc0: 6f 77 73 20 73 79 73 74 65 6d 73 20 6e 65 65 64  ows systems need
5dd0: 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 63 61   functions to ca
5de0: 6c 6c 20 74 6f 20 72 65 74 75 72 6e 20 74 68 65  ll to return the
5df0: 20 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 0a   sqlite_version.
5e00: 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 5f 65 6e  ** and sqlite_en
5e10: 63 6f 64 69 6e 67 20 73 74 72 69 6e 67 73 2e 0a  coding strings..
5e20: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
5e30: 71 6c 69 74 65 5f 6c 69 62 76 65 72 73 69 6f 6e  qlite_libversion
5e40: 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 73  (void){ return s
5e50: 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 3b 20 7d  qlite_version; }
5e60: 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c  .const char *sql
5e70: 69 74 65 5f 6c 69 62 65 6e 63 6f 64 69 6e 67 28  ite_libencoding(
5e80: 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 73 71  void){ return sq
5e90: 6c 69 74 65 5f 65 6e 63 6f 64 69 6e 67 3b 20 7d  lite_encoding; }
5ea0: 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 6e  ../*.** Create n
5eb0: 65 77 20 75 73 65 72 2d 64 65 66 69 6e 65 64 20  ew user-defined 
5ec0: 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65 20  functions.  The 
5ed0: 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 66 75  sqlite_create_fu
5ee0: 6e 63 74 69 6f 6e 28 29 0a 2a 2a 20 72 6f 75 74  nction().** rout
5ef0: 69 6e 65 20 63 72 65 61 74 65 73 20 61 20 72 65  ine creates a re
5f00: 67 75 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 61  gular function a
5f10: 6e 64 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65  nd sqlite_create
5f20: 5f 61 67 67 72 65 67 61 74 65 28 29 0a 2a 2a 20  _aggregate().** 
5f30: 63 72 65 61 74 65 73 20 61 6e 20 61 67 67 72 65  creates an aggre
5f40: 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a  gate function..*
5f50: 2a 0a 2a 2a 20 50 61 73 73 69 6e 67 20 61 20 4e  *.** Passing a N
5f60: 55 4c 4c 20 78 46 75 6e 63 20 61 72 67 75 6d 65  ULL xFunc argume
5f70: 6e 74 20 6f 72 20 4e 55 4c 4c 20 78 53 74 65 70  nt or NULL xStep
5f80: 20 61 6e 64 20 78 46 69 6e 61 6c 69 7a 65 20 61   and xFinalize a
5f90: 72 67 75 6d 65 6e 74 73 0a 2a 2a 20 64 69 73 61  rguments.** disa
5fa0: 62 6c 65 73 20 74 68 65 20 66 75 6e 63 74 69 6f  bles the functio
5fb0: 6e 2e 20 20 43 61 6c 6c 69 6e 67 20 73 71 6c 69  n.  Calling sqli
5fc0: 74 65 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69  te_create_functi
5fd0: 6f 6e 28 29 20 77 69 74 68 20 74 68 65 0a 2a 2a  on() with the.**
5fe0: 20 73 61 6d 65 20 6e 61 6d 65 20 61 6e 64 20 6e   same name and n
5ff0: 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e  umber of argumen
6000: 74 73 20 61 73 20 61 20 70 72 69 6f 72 20 63 61  ts as a prior ca
6010: 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 5f  ll to.** sqlite_
6020: 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74 65  create_aggregate
6030: 28 29 20 64 69 73 61 62 6c 65 73 20 74 68 65 20  () disables the 
6040: 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 0a 2a 2a  prior call to.**
6050: 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 61   sqlite_create_a
6060: 67 67 72 65 67 61 74 65 28 29 2c 20 61 6e 64 20  ggregate(), and 
6070: 76 69 63 65 20 76 65 72 73 61 2e 0a 2a 2a 0a 2a  vice versa..**.*
6080: 2a 20 49 66 20 6e 41 72 67 20 69 73 20 2d 31 20  * If nArg is -1 
6090: 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68  it means that th
60a0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c  is function will
60b0: 20 61 63 63 65 70 74 20 61 6e 79 20 6e 75 6d 62   accept any numb
60c0: 65 72 0a 2a 2a 20 6f 66 20 61 72 67 75 6d 65 6e  er.** of argumen
60d0: 74 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 30 2e  ts, including 0.
60e0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63  .*/.int sqlite_c
60f0: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 0a  reate_function(.
6100: 20 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20    sqlite *db,   
6110: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68         /* Add th
6120: 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74 68  e function to th
6130: 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  is database conn
6140: 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73  ection */.  cons
6150: 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20  t char *zName,  
6160: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20   /* Name of the 
6170: 66 75 6e 63 74 69 6f 6e 20 74 6f 20 61 64 64 20  function to add 
6180: 2a 2f 0a 20 20 69 6e 74 20 6e 41 72 67 2c 20 20  */.  int nArg,  
6190: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
61a0: 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73  ber of arguments
61b0: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46 75   */.  void (*xFu
61c0: 6e 63 29 28 73 71 6c 69 74 65 5f 66 75 6e 63 2a  nc)(sqlite_func*
61d0: 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a  ,int,const char*
61e0: 2a 29 2c 20 20 2f 2a 20 54 68 65 20 69 6d 70 6c  *),  /* The impl
61f0: 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20  ementation */.  
6200: 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 20  void *pUserData 
6210: 20 20 20 20 20 2f 2a 20 55 73 65 72 20 64 61 74       /* User dat
6220: 61 20 2a 2f 0a 29 7b 0a 20 20 46 75 6e 63 44 65  a */.){.  FuncDe
6230: 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d  f *p;.  int nNam
6240: 65 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 7c  e;.  if( db==0 |
6250: 7c 20 7a 4e 61 6d 65 3d 3d 30 20 7c 7c 20 73 71  | zName==0 || sq
6260: 6c 69 74 65 53 61 66 65 74 79 43 68 65 63 6b 28  liteSafetyCheck(
6270: 64 62 29 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  db) ) return 1;.
6280: 20 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e    nName = strlen
6290: 28 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 6e  (zName);.  if( n
62a0: 4e 61 6d 65 3e 32 35 35 20 29 20 72 65 74 75 72  Name>255 ) retur
62b0: 6e 20 31 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74  n 1;.  p = sqlit
62c0: 65 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62  eFindFunction(db
62d0: 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20  , zName, nName, 
62e0: 6e 41 72 67 2c 20 31 29 3b 0a 20 20 69 66 28 20  nArg, 1);.  if( 
62f0: 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b  p==0 ) return 1;
6300: 0a 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20 78 46  .  p->xFunc = xF
6310: 75 6e 63 3b 0a 20 20 70 2d 3e 78 53 74 65 70 20  unc;.  p->xStep 
6320: 3d 20 30 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c  = 0;.  p->xFinal
6330: 69 7a 65 20 3d 20 30 3b 0a 20 20 70 2d 3e 70 55  ize = 0;.  p->pU
6340: 73 65 72 44 61 74 61 20 3d 20 70 55 73 65 72 44  serData = pUserD
6350: 61 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b  ata;.  return 0;
6360: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 72  .}.int sqlite_cr
6370: 65 61 74 65 5f 61 67 67 72 65 67 61 74 65 28 0a  eate_aggregate(.
6380: 20 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20    sqlite *db,   
6390: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68         /* Add th
63a0: 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74 68  e function to th
63b0: 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  is database conn
63c0: 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73  ection */.  cons
63d0: 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20  t char *zName,  
63e0: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20   /* Name of the 
63f0: 66 75 6e 63 74 69 6f 6e 20 74 6f 20 61 64 64 20  function to add 
6400: 2a 2f 0a 20 20 69 6e 74 20 6e 41 72 67 2c 20 20  */.  int nArg,  
6410: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
6420: 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73  ber of arguments
6430: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 53 74   */.  void (*xSt
6440: 65 70 29 28 73 71 6c 69 74 65 5f 66 75 6e 63 2a  ep)(sqlite_func*
6450: 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a  ,int,const char*
6460: 2a 29 2c 20 2f 2a 20 54 68 65 20 73 74 65 70 20  *), /* The step 
6470: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f  function */.  vo
6480: 69 64 20 28 2a 78 46 69 6e 61 6c 69 7a 65 29 28  id (*xFinalize)(
6490: 73 71 6c 69 74 65 5f 66 75 6e 63 2a 29 2c 20 20  sqlite_func*),  
64a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
64b0: 68 65 20 66 69 6e 61 6c 69 7a 65 72 20 2a 2f 0a  he finalizer */.
64c0: 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74    void *pUserDat
64d0: 61 20 20 20 20 20 20 2f 2a 20 55 73 65 72 20 64  a      /* User d
64e0: 61 74 61 20 2a 2f 0a 29 7b 0a 20 20 46 75 6e 63  ata */.){.  Func
64f0: 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e  Def *p;.  int nN
6500: 61 6d 65 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30  ame;.  if( db==0
6510: 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 7c 7c 20   || zName==0 || 
6520: 73 71 6c 69 74 65 53 61 66 65 74 79 43 68 65 63  sqliteSafetyChec
6530: 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 31  k(db) ) return 1
6540: 3b 0a 20 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c  ;.  nName = strl
6550: 65 6e 28 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28  en(zName);.  if(
6560: 20 6e 4e 61 6d 65 3e 32 35 35 20 29 20 72 65 74   nName>255 ) ret
6570: 75 72 6e 20 31 3b 0a 20 20 70 20 3d 20 73 71 6c  urn 1;.  p = sql
6580: 69 74 65 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28  iteFindFunction(
6590: 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65  db, zName, nName
65a0: 2c 20 6e 41 72 67 2c 20 31 29 3b 0a 20 20 69 66  , nArg, 1);.  if
65b0: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  ( p==0 ) return 
65c0: 31 3b 0a 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20  1;.  p->xFunc = 
65d0: 30 3b 0a 20 20 70 2d 3e 78 53 74 65 70 20 3d 20  0;.  p->xStep = 
65e0: 78 53 74 65 70 3b 0a 20 20 70 2d 3e 78 46 69 6e  xStep;.  p->xFin
65f0: 61 6c 69 7a 65 20 3d 20 78 46 69 6e 61 6c 69 7a  alize = xFinaliz
6600: 65 3b 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74  e;.  p->pUserDat
6610: 61 20 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20  a = pUserData;. 
6620: 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a   return 0;.}../*
6630: 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 64  .** Change the d
6640: 61 74 61 74 79 70 65 20 66 6f 72 20 61 6c 6c 20  atatype for all 
6650: 66 75 6e 63 74 69 6f 6e 73 20 77 69 74 68 20 61  functions with a
6660: 20 67 69 76 65 6e 20 6e 61 6d 65 2e 20 20 53 65   given name.  Se
6670: 65 20 74 68 65 0a 2a 2a 20 68 65 61 64 65 72 20  e the.** header 
6680: 63 6f 6d 6d 65 6e 74 20 66 6f 72 20 74 68 65 20  comment for the 
6690: 70 72 6f 74 6f 74 79 70 65 20 6f 66 20 74 68 69  prototype of thi
66a0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 6e 20 73 71  s function in sq
66b0: 6c 69 74 65 2e 68 20 66 6f 72 0a 2a 2a 20 61 64  lite.h for.** ad
66c0: 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61  ditional informa
66d0: 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  tion..*/.int sql
66e0: 69 74 65 5f 66 75 6e 63 74 69 6f 6e 5f 74 79 70  ite_function_typ
66f0: 65 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 63 6f  e(sqlite *db, co
6700: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
6710: 20 69 6e 74 20 64 61 74 61 54 79 70 65 29 7b 0a   int dataType){.
6720: 20 20 46 75 6e 63 44 65 66 20 2a 70 20 3d 20 28    FuncDef *p = (
6730: 46 75 6e 63 44 65 66 2a 29 73 71 6c 69 74 65 48  FuncDef*)sqliteH
6740: 61 73 68 46 69 6e 64 28 26 64 62 2d 3e 61 46 75  ashFind(&db->aFu
6750: 6e 63 2c 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65  nc, zName, strle
6760: 6e 28 7a 4e 61 6d 65 29 29 3b 0a 20 20 77 68 69  n(zName));.  whi
6770: 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 70 2d 3e  le( p ){.    p->
6780: 64 61 74 61 54 79 70 65 20 3d 20 64 61 74 61 54  dataType = dataT
6790: 79 70 65 3b 20 0a 20 20 20 20 70 20 3d 20 70 2d  ype; .    p = p-
67a0: 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 72 65  >pNext;.  }.  re
67b0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
67c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74  }../*.** Attempt
67d0: 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 66 69 6c   to open the fil
67e0: 65 20 6e 61 6d 65 64 20 69 6e 20 74 68 65 20 61  e named in the a
67f0: 72 67 75 6d 65 6e 74 20 61 73 20 74 68 65 20 61  rgument as the a
6800: 75 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73  uxiliary databas
6810: 65 0a 2a 2a 20 66 69 6c 65 2e 20 20 54 68 65 20  e.** file.  The 
6820: 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 62 61  auxiliary databa
6830: 73 65 20 66 69 6c 65 20 69 73 20 75 73 65 64 20  se file is used 
6840: 74 6f 20 73 74 6f 72 65 20 54 45 4d 50 20 74 61  to store TEMP ta
6850: 62 6c 65 73 2e 20 20 42 75 74 0a 2a 2a 20 62 79  bles.  But.** by
6860: 20 75 73 69 6e 67 20 74 68 69 73 20 41 50 49 2c   using this API,
6870: 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20   it is possible 
6880: 74 6f 20 74 72 69 63 6b 20 53 51 4c 69 74 65 20  to trick SQLite 
6890: 69 6e 74 6f 20 6f 70 65 6e 69 6e 67 20 74 77 6f  into opening two
68a0: 0a 2a 2a 20 73 65 70 61 72 61 74 65 20 64 61 74  .** separate dat
68b0: 61 62 61 73 65 73 20 61 6e 64 20 61 63 74 69 6e  abases and actin
68c0: 67 20 6f 6e 20 74 68 65 6d 20 61 73 20 69 66 20  g on them as if 
68d0: 74 68 65 79 20 77 65 72 65 20 6f 6e 65 2e 0a 2a  they were one..*
68e0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
68f0: 65 20 63 6c 6f 73 65 73 20 74 68 65 20 65 78 69  e closes the exi
6900: 73 74 69 6e 67 20 61 75 78 69 6c 69 61 72 79 20  sting auxiliary 
6910: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 77  database file, w
6920: 68 69 63 68 20 77 69 6c 6c 0a 2a 2a 20 63 61 75  hich will.** cau
6930: 73 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c  se any previousl
6940: 79 20 63 72 65 61 74 65 64 20 54 45 4d 50 20 74  y created TEMP t
6950: 61 62 6c 65 73 20 74 6f 20 62 65 20 64 72 6f 70  ables to be drop
6960: 70 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 7a  ped..**.** The z
6970: 4e 61 6d 65 20 70 61 72 61 6d 65 74 65 72 20 63  Name parameter c
6980: 61 6e 20 62 65 20 61 20 4e 55 4c 4c 20 70 6f 69  an be a NULL poi
6990: 6e 74 65 72 20 6f 72 20 61 6e 20 65 6d 70 74 79  nter or an empty
69a0: 20 73 74 72 69 6e 67 20 74 6f 20 63 61 75 73 65   string to cause
69b0: 0a 2a 2a 20 61 20 74 65 6d 70 6f 72 61 72 79 20  .** a temporary 
69c0: 66 69 6c 65 20 74 6f 20 62 65 20 6f 70 65 6e 65  file to be opene
69d0: 64 20 61 6e 64 20 61 75 74 6f 6d 61 74 69 63 61  d and automatica
69e0: 6c 6c 79 20 64 65 6c 65 74 65 64 20 77 68 65 6e  lly deleted when
69f0: 20 63 6c 6f 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20   closed..*/.int 
6a00: 73 71 6c 69 74 65 5f 6f 70 65 6e 5f 61 75 78 5f  sqlite_open_aux_
6a10: 66 69 6c 65 28 73 71 6c 69 74 65 20 2a 64 62 2c  file(sqlite *db,
6a20: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
6a30: 6d 65 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  me, char **pzErr
6a40: 4d 73 67 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  Msg){.  int rc;.
6a50: 20 20 69 66 28 20 7a 4e 61 6d 65 20 26 26 20 7a    if( zName && z
6a60: 4e 61 6d 65 5b 30 5d 3d 3d 30 20 29 20 7a 4e 61  Name[0]==0 ) zNa
6a70: 6d 65 20 3d 20 30 3b 0a 20 20 69 66 28 20 73 71  me = 0;.  if( sq
6a80: 6c 69 74 65 53 61 66 65 74 79 4f 6e 28 64 62 29  liteSafetyOn(db)
6a90: 20 29 20 67 6f 74 6f 20 6f 70 65 6e 61 75 78 5f   ) goto openaux_
6aa0: 6d 69 73 75 73 65 3b 0a 20 20 73 71 6c 69 74 65  misuse;.  sqlite
6ab0: 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68  ResetInternalSch
6ac0: 65 6d 61 28 64 62 29 3b 0a 20 20 69 66 28 20 64  ema(db);.  if( d
6ad0: 62 2d 3e 70 42 65 54 65 6d 70 21 3d 30 20 29 7b  b->pBeTemp!=0 ){
6ae0: 0a 20 20 20 20 73 71 6c 69 74 65 42 74 72 65 65  .    sqliteBtree
6af0: 43 6c 6f 73 65 28 64 62 2d 3e 70 42 65 54 65 6d  Close(db->pBeTem
6b00: 70 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73  p);.  }.  rc = s
6b10: 71 6c 69 74 65 42 74 72 65 65 4f 70 65 6e 28 7a  qliteBtreeOpen(z
6b20: 4e 61 6d 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47  Name, 0, MAX_PAG
6b30: 45 53 2c 20 26 64 62 2d 3e 70 42 65 54 65 6d 70  ES, &db->pBeTemp
6b40: 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20  );.  if( rc ){. 
6b50: 20 20 20 69 66 28 20 7a 4e 61 6d 65 3d 3d 30 20     if( zName==0 
6b60: 29 20 7a 4e 61 6d 65 20 3d 20 22 61 20 74 65 6d  ) zName = "a tem
6b70: 70 6f 72 61 72 79 20 66 69 6c 65 22 3b 0a 20 20  porary file";.  
6b80: 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e    sqliteSetStrin
6b90: 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e 61  g(pzErrMsg, "una
6ba0: 62 6c 65 20 74 6f 20 6f 70 65 6e 20 22 2c 20 7a  ble to open ", z
6bb0: 4e 61 6d 65 2c 20 0a 20 20 20 20 20 20 22 3a 20  Name, .      ": 
6bc0: 22 2c 20 73 71 6c 69 74 65 5f 65 72 72 6f 72 5f  ", sqlite_error_
6bd0: 73 74 72 69 6e 67 28 72 63 29 2c 20 30 29 3b 0a  string(rc), 0);.
6be0: 20 20 20 20 73 71 6c 69 74 65 53 74 72 52 65 61      sqliteStrRea
6bf0: 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a  lloc(pzErrMsg);.
6c00: 20 20 20 20 73 71 6c 69 74 65 53 61 66 65 74 79      sqliteSafety
6c10: 4f 66 66 28 64 62 29 3b 0a 20 20 20 20 72 65 74  Off(db);.    ret
6c20: 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 72 63  urn rc;.  }.  rc
6c30: 20 3d 20 73 71 6c 69 74 65 49 6e 69 74 28 64 62   = sqliteInit(db
6c40: 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69  , pzErrMsg);.  i
6c50: 66 28 20 73 71 6c 69 74 65 53 61 66 65 74 79 4f  f( sqliteSafetyO
6c60: 66 66 28 64 62 29 20 29 20 67 6f 74 6f 20 6f 70  ff(db) ) goto op
6c70: 65 6e 61 75 78 5f 6d 69 73 75 73 65 3b 0a 20 20  enaux_misuse;.  
6c80: 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63  sqliteStrRealloc
6c90: 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65  (pzErrMsg);.  re
6ca0: 74 75 72 6e 20 72 63 3b 0a 0a 6f 70 65 6e 61 75  turn rc;..openau
6cb0: 78 5f 6d 69 73 75 73 65 3a 0a 20 20 73 71 6c 69  x_misuse:.  sqli
6cc0: 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  teSetString(pzEr
6cd0: 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f 65 72 72  rMsg, sqlite_err
6ce0: 6f 72 5f 73 74 72 69 6e 67 28 53 51 4c 49 54 45  or_string(SQLITE
6cf0: 5f 4d 49 53 55 53 45 29 2c 20 30 29 3b 0a 20 20  _MISUSE), 0);.  
6d00: 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63  sqliteStrRealloc
6d10: 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65  (pzErrMsg);.  re
6d20: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  turn SQLITE_MISU
6d30: 53 45 3b 0a 7d 0a                                SE;.}.