/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact 2732115c888440caaebf50fc791b13cfdcc5dcd7:


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 37 31 20 32 30 30 34 2f 30 35  ,v 1.171 2004/05
0280: 2f 31 31 20 30 38 3a 34 38 3a 31 31 20 64 61 6e  /11 08:48:11 dan
0290: 69 65 6c 6b 31 39 37 37 20 45 78 70 20 24 0a 2a  ielk1977 Exp $.*
02a0: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69  /.#include "sqli
02b0: 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64  teInt.h".#includ
02c0: 65 20 22 6f 73 2e 68 22 0a 23 69 6e 63 6c 75 64  e "os.h".#includ
02d0: 65 20 3c 63 74 79 70 65 2e 68 3e 0a 0a 2f 2a 0a  e <ctype.h>../*.
02e0: 2a 2a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20  ** A pointer to 
02f0: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 69  this structure i
0300: 73 20 75 73 65 64 20 74 6f 20 63 6f 6d 6d 75 6e  s used to commun
0310: 69 63 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f  icate informatio
0320: 6e 0a 2a 2a 20 66 72 6f 6d 20 73 71 6c 69 74 65  n.** from sqlite
0330: 33 49 6e 69 74 20 69 6e 74 6f 20 74 68 65 20 73  3Init into the s
0340: 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61  qlite3InitCallba
0350: 63 6b 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73  ck..*/.typedef s
0360: 74 72 75 63 74 20 7b 0a 20 20 73 71 6c 69 74 65  truct {.  sqlite
0370: 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20 2f 2a   *db;         /*
0380: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 62 65   The database be
0390: 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20  ing initialized 
03a0: 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72  */.  char **pzEr
03b0: 72 4d 73 67 3b 20 20 20 20 2f 2a 20 45 72 72 6f  rMsg;    /* Erro
03c0: 72 20 6d 65 73 73 61 67 65 20 73 74 6f 72 65 64  r message stored
03d0: 20 68 65 72 65 20 2a 2f 0a 7d 20 49 6e 69 74 44   here */.} InitD
03e0: 61 74 61 3b 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 6c  ata;../*.** Fill
03f0: 20 74 68 65 20 49 6e 69 74 44 61 74 61 20 73 74   the InitData st
0400: 72 75 63 74 75 72 65 20 77 69 74 68 20 61 6e 20  ructure with an 
0410: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 68  error message th
0420: 61 74 20 69 6e 64 69 63 61 74 65 73 0a 2a 2a 20  at indicates.** 
0430: 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73  that the databas
0440: 65 20 69 73 20 63 6f 72 72 75 70 74 2e 0a 2a 2f  e is corrupt..*/
0450: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f 72  .static void cor
0460: 72 75 70 74 53 63 68 65 6d 61 28 49 6e 69 74 44  ruptSchema(InitD
0470: 61 74 61 20 2a 70 44 61 74 61 2c 20 63 6f 6e 73  ata *pData, cons
0480: 74 20 63 68 61 72 20 2a 7a 45 78 74 72 61 29 7b  t char *zExtra){
0490: 0a 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72  .  sqlite3SetStr
04a0: 69 6e 67 28 70 44 61 74 61 2d 3e 70 7a 45 72 72  ing(pData->pzErr
04b0: 4d 73 67 2c 20 22 6d 61 6c 66 6f 72 6d 65 64 20  Msg, "malformed 
04c0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 22  database schema"
04d0: 2c 0a 20 20 20 20 20 7a 45 78 74 72 61 21 3d 30  ,.     zExtra!=0
04e0: 20 26 26 20 7a 45 78 74 72 61 5b 30 5d 21 3d 30   && zExtra[0]!=0
04f0: 20 3f 20 22 20 2d 20 22 20 3a 20 28 63 68 61 72   ? " - " : (char
0500: 2a 29 30 2c 20 7a 45 78 74 72 61 2c 20 28 63 68  *)0, zExtra, (ch
0510: 61 72 2a 29 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ar*)0);.}../*.**
0520: 20 54 68 69 73 20 69 73 20 74 68 65 20 63 61 6c   This is the cal
0530: 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20 66 6f  lback routine fo
0540: 72 20 74 68 65 20 63 6f 64 65 20 74 68 61 74 20  r the code that 
0550: 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 68 65 0a  initializes the.
0560: 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20 53 65  ** database.  Se
0570: 65 20 73 71 6c 69 74 65 33 49 6e 69 74 28 29 20  e sqlite3Init() 
0580: 62 65 6c 6f 77 20 66 6f 72 20 61 64 64 69 74 69  below for additi
0590: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  onal information
05a0: 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 63 61 6c  ..**.** Each cal
05b0: 6c 62 61 63 6b 20 63 6f 6e 74 61 69 6e 73 20 74  lback contains t
05c0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66  he following inf
05d0: 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a 20  ormation:.**.** 
05e0: 20 20 20 20 61 72 67 76 5b 30 5d 20 3d 20 22 66      argv[0] = "f
05f0: 69 6c 65 2d 66 6f 72 6d 61 74 22 20 6f 72 20 22  ile-format" or "
0600: 73 63 68 65 6d 61 2d 63 6f 6f 6b 69 65 22 20 6f  schema-cookie" o
0610: 72 20 22 74 61 62 6c 65 22 20 6f 72 20 22 69 6e  r "table" or "in
0620: 64 65 78 22 0a 2a 2a 20 20 20 20 20 61 72 67 76  dex".**     argv
0630: 5b 31 5d 20 3d 20 74 61 62 6c 65 20 6f 72 20 69  [1] = table or i
0640: 6e 64 65 78 20 6e 61 6d 65 20 6f 72 20 6d 65 74  ndex name or met
0650: 61 20 73 74 61 74 65 6d 65 6e 74 20 74 79 70 65  a statement type
0660: 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 32 5d  ..**     argv[2]
0670: 20 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d   = root page num
0680: 62 65 72 20 66 6f 72 20 74 61 62 6c 65 20 6f 72  ber for table or
0690: 20 69 6e 64 65 78 2e 20 20 4e 55 4c 4c 20 66 6f   index.  NULL fo
06a0: 72 20 6d 65 74 61 2e 0a 2a 2a 20 20 20 20 20 61  r meta..**     a
06b0: 72 67 76 5b 33 5d 20 3d 20 53 51 4c 20 74 65 78  rgv[3] = SQL tex
06c0: 74 20 66 6f 72 20 61 20 43 52 45 41 54 45 20 54  t for a CREATE T
06d0: 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20 49  ABLE or CREATE I
06e0: 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74 2e 0a  NDEX statement..
06f0: 2a 2a 20 20 20 20 20 61 72 67 76 5b 34 5d 20 3d  **     argv[4] =
0700: 20 22 31 22 20 66 6f 72 20 74 65 6d 70 6f 72 61   "1" for tempora
0710: 72 79 20 66 69 6c 65 73 2c 20 22 30 22 20 66 6f  ry files, "0" fo
0720: 72 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2c  r main database,
0730: 20 22 32 22 20 6f 72 20 6d 6f 72 65 0a 2a 2a 20   "2" or more.** 
0740: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6f                fo
0750: 72 20 61 75 78 69 6c 69 61 72 79 20 64 61 74 61  r auxiliary data
0760: 62 61 73 65 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a  base files..**.*
0770: 2f 0a 73 74 61 74 69 63 0a 69 6e 74 20 73 71 6c  /.static.int sql
0780: 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b  ite3InitCallback
0790: 28 76 6f 69 64 20 2a 70 49 6e 69 74 2c 20 69 6e  (void *pInit, in
07a0: 74 20 61 72 67 63 2c 20 63 68 61 72 20 2a 2a 61  t argc, char **a
07b0: 72 67 76 2c 20 63 68 61 72 20 2a 2a 61 7a 43 6f  rgv, char **azCo
07c0: 6c 4e 61 6d 65 29 7b 0a 20 20 49 6e 69 74 44 61  lName){.  InitDa
07d0: 74 61 20 2a 70 44 61 74 61 20 3d 20 28 49 6e 69  ta *pData = (Ini
07e0: 74 44 61 74 61 2a 29 70 49 6e 69 74 3b 0a 20 20  tData*)pInit;.  
07f0: 69 6e 74 20 6e 45 72 72 20 3d 20 30 3b 0a 0a 20  int nErr = 0;.. 
0800: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 35   assert( argc==5
0810: 20 29 3b 0a 20 20 69 66 28 20 61 72 67 76 3d 3d   );.  if( argv==
0820: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 20 20 20  0 ) return 0;   
0830: 2f 2a 20 4d 69 67 68 74 20 68 61 70 70 65 6e 20  /* Might happen 
0840: 69 66 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f  if EMPTY_RESULT_
0850: 43 41 4c 4c 42 41 43 4b 53 20 61 72 65 20 6f 6e  CALLBACKS are on
0860: 20 2a 2f 0a 20 20 69 66 28 20 61 72 67 76 5b 30   */.  if( argv[0
0870: 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 63 6f 72 72  ]==0 ){.    corr
0880: 75 70 74 53 63 68 65 6d 61 28 70 44 61 74 61 2c  uptSchema(pData,
0890: 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20   0);.    return 
08a0: 31 3b 0a 20 20 7d 0a 20 20 73 77 69 74 63 68 28  1;.  }.  switch(
08b0: 20 61 72 67 76 5b 30 5d 5b 30 5d 20 29 7b 0a 20   argv[0][0] ){. 
08c0: 20 20 20 63 61 73 65 20 27 76 27 3a 0a 20 20 20     case 'v':.   
08d0: 20 63 61 73 65 20 27 69 27 3a 0a 20 20 20 20 63   case 'i':.    c
08e0: 61 73 65 20 27 74 27 3a 20 7b 20 20 2f 2a 20 43  ase 't': {  /* C
08f0: 52 45 41 54 45 20 54 41 42 4c 45 2c 20 43 52 45  REATE TABLE, CRE
0900: 41 54 45 20 49 4e 44 45 58 2c 20 6f 72 20 43 52  ATE INDEX, or CR
0910: 45 41 54 45 20 56 49 45 57 20 73 74 61 74 65 6d  EATE VIEW statem
0920: 65 6e 74 73 20 2a 2f 0a 20 20 20 20 20 20 73 71  ents */.      sq
0930: 6c 69 74 65 20 2a 64 62 20 3d 20 70 44 61 74 61  lite *db = pData
0940: 2d 3e 64 62 3b 0a 20 20 20 20 20 20 69 66 28 20  ->db;.      if( 
0950: 61 72 67 76 5b 32 5d 3d 3d 30 20 7c 7c 20 61 72  argv[2]==0 || ar
0960: 67 76 5b 34 5d 3d 3d 30 20 29 7b 0a 20 20 20 20  gv[4]==0 ){.    
0970: 20 20 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d      corruptSchem
0980: 61 28 70 44 61 74 61 2c 20 30 29 3b 0a 20 20 20  a(pData, 0);.   
0990: 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20       return 1;. 
09a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28       }.      if(
09b0: 20 61 72 67 76 5b 33 5d 20 26 26 20 61 72 67 76   argv[3] && argv
09c0: 5b 33 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20  [3][0] ){.      
09d0: 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65 20 70 61    /* Call the pa
09e0: 72 73 65 72 20 74 6f 20 70 72 6f 63 65 73 73 20  rser to process 
09f0: 61 20 43 52 45 41 54 45 20 54 41 42 4c 45 2c 20  a CREATE TABLE, 
0a00: 49 4e 44 45 58 20 6f 72 20 56 49 45 57 2e 0a 20  INDEX or VIEW.. 
0a10: 20 20 20 20 20 20 20 2a 2a 20 42 75 74 20 62 65         ** But be
0a20: 63 61 75 73 65 20 64 62 2d 3e 69 6e 69 74 2e 62  cause db->init.b
0a30: 75 73 79 20 69 73 20 73 65 74 20 74 6f 20 31 2c  usy is set to 1,
0a40: 20 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73   no VDBE code is
0a50: 20 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 20   generated.     
0a60: 20 20 20 2a 2a 20 6f 72 20 65 78 65 63 75 74 65     ** or execute
0a70: 64 2e 20 20 41 6c 6c 20 74 68 65 20 70 61 72 73  d.  All the pars
0a80: 65 72 20 64 6f 65 73 20 69 73 20 62 75 69 6c 64  er does is build
0a90: 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 64 61   the internal da
0aa0: 74 61 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74  ta.        ** st
0ab0: 72 75 63 74 75 72 65 73 20 74 68 61 74 20 64 65  ructures that de
0ac0: 73 63 72 69 62 65 20 74 68 65 20 74 61 62 6c 65  scribe the table
0ad0: 2c 20 69 6e 64 65 78 2c 20 6f 72 20 76 69 65 77  , index, or view
0ae0: 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20  ..        */.   
0af0: 20 20 20 20 20 63 68 61 72 20 2a 7a 45 72 72 3b       char *zErr;
0b00: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
0b10: 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29   db->init.busy )
0b20: 3b 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 69 6e  ;.        db->in
0b30: 69 74 2e 69 44 62 20 3d 20 61 74 6f 69 28 61 72  it.iDb = atoi(ar
0b40: 67 76 5b 34 5d 29 3b 0a 20 20 20 20 20 20 20 20  gv[4]);.        
0b50: 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e 69 74  assert( db->init
0b60: 2e 69 44 62 3e 3d 30 20 26 26 20 64 62 2d 3e 69  .iDb>=0 && db->i
0b70: 6e 69 74 2e 69 44 62 3c 64 62 2d 3e 6e 44 62 20  nit.iDb<db->nDb 
0b80: 29 3b 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 69  );.        db->i
0b90: 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 61 74  nit.newTnum = at
0ba0: 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a 20 20 20  oi(argv[2]);.   
0bb0: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33       if( sqlite3
0bc0: 5f 65 78 65 63 28 64 62 2c 20 61 72 67 76 5b 33  _exec(db, argv[3
0bd0: 5d 2c 20 30 2c 20 30 2c 20 26 7a 45 72 72 29 20  ], 0, 0, &zErr) 
0be0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6f 72  ){.          cor
0bf0: 72 75 70 74 53 63 68 65 6d 61 28 70 44 61 74 61  ruptSchema(pData
0c00: 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20 20 20 20  , zErr);.       
0c10: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 6d     sqlite3_freem
0c20: 65 6d 28 7a 45 72 72 29 3b 0a 20 20 20 20 20 20  em(zErr);.      
0c30: 20 20 7d 0a 20 20 20 20 20 20 20 20 64 62 2d 3e    }.        db->
0c40: 69 6e 69 74 2e 69 44 62 20 3d 20 30 3b 0a 20 20  init.iDb = 0;.  
0c50: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
0c60: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51 4c     /* If the SQL
0c70: 20 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e 6b   column is blank
0c80: 20 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69   it means this i
0c90: 73 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 0a  s an index that.
0ca0: 20 20 20 20 20 20 20 20 2a 2a 20 77 61 73 20 63          ** was c
0cb0: 72 65 61 74 65 64 20 74 6f 20 62 65 20 74 68 65  reated to be the
0cc0: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20   PRIMARY KEY or 
0cd0: 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e 49  to fulfill a UNI
0ce0: 51 55 45 0a 20 20 20 20 20 20 20 20 2a 2a 20 63  QUE.        ** c
0cf0: 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 61 20  onstraint for a 
0d00: 43 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20 54  CREATE TABLE.  T
0d10: 68 65 20 69 6e 64 65 78 20 73 68 6f 75 6c 64 20  he index should 
0d20: 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20 20  have already.   
0d30: 20 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72 65       ** been cre
0d40: 61 74 65 64 20 77 68 65 6e 20 77 65 20 70 72 6f  ated when we pro
0d50: 63 65 73 73 65 64 20 74 68 65 20 43 52 45 41 54  cessed the CREAT
0d60: 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77 65  E TABLE.  All we
0d70: 20 68 61 76 65 0a 20 20 20 20 20 20 20 20 2a 2a   have.        **
0d80: 20 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20 72   to do here is r
0d90: 65 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20 70  ecord the root p
0da0: 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74  age number for t
0db0: 68 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20 20  hat index..     
0dc0: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 6e     */.        in
0dd0: 74 20 69 44 62 3b 0a 20 20 20 20 20 20 20 20 49  t iDb;.        I
0de0: 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 0a 0a 20  ndex *pIndex;.. 
0df0: 20 20 20 20 20 20 20 69 44 62 20 3d 20 61 74 6f         iDb = ato
0e00: 69 28 61 72 67 76 5b 34 5d 29 3b 0a 20 20 20 20  i(argv[4]);.    
0e10: 20 20 20 20 61 73 73 65 72 74 28 20 69 44 62 3e      assert( iDb>
0e20: 3d 30 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e 44  =0 && iDb<db->nD
0e30: 62 20 29 3b 0a 20 20 20 20 20 20 20 20 70 49 6e  b );.        pIn
0e40: 64 65 78 20 3d 20 73 71 6c 69 74 65 33 46 69 6e  dex = sqlite3Fin
0e50: 64 49 6e 64 65 78 28 64 62 2c 20 61 72 67 76 5b  dIndex(db, argv[
0e60: 31 5d 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  1], db->aDb[iDb]
0e70: 2e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20  .zName);.       
0e80: 20 69 66 28 20 70 49 6e 64 65 78 3d 3d 30 20 7c   if( pIndex==0 |
0e90: 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 21 3d  | pIndex->tnum!=
0ea0: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f  0 ){.          /
0eb0: 2a 20 54 68 69 73 20 63 61 6e 20 6f 63 63 75 72  * This can occur
0ec0: 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73   if there exists
0ed0: 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 61 20 54   an index on a T
0ee0: 45 4d 50 20 74 61 62 6c 65 20 77 68 69 63 68 0a  EMP table which.
0ef0: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 68 61 73            ** has
0f00: 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61   the same name a
0f10: 73 20 61 6e 6f 74 68 65 72 20 69 6e 64 65 78 20  s another index 
0f20: 6f 6e 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 69  on a permanent i
0f30: 6e 64 65 78 2e 20 20 53 69 6e 63 65 0a 20 20 20  ndex.  Since.   
0f40: 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 70 65         ** the pe
0f50: 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 20 69 73  rmanent table is
0f60: 20 68 69 64 64 65 6e 20 62 79 20 74 68 65 20 54   hidden by the T
0f70: 45 4d 50 20 74 61 62 6c 65 2c 20 77 65 20 63 61  EMP table, we ca
0f80: 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20 20 20 20  n also.         
0f90: 20 2a 2a 20 73 61 66 65 6c 79 20 69 67 6e 6f 72   ** safely ignor
0fa0: 65 20 74 68 65 20 69 6e 64 65 78 20 6f 6e 20 74  e the index on t
0fb0: 68 65 20 70 65 72 6d 61 6e 65 6e 74 20 74 61 62  he permanent tab
0fc0: 6c 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f  le..          */
0fd0: 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f  .          /* Do
0fe0: 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b 0a 20 20 20   Nothing */;.   
0ff0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
1000: 20 20 20 20 20 20 70 49 6e 64 65 78 2d 3e 74 6e        pIndex->tn
1010: 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 32  um = atoi(argv[2
1020: 5d 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ]);.        }.  
1030: 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61      }.      brea
1040: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66  k;.    }.    def
1050: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f 2a  ault: {.      /*
1060: 20 54 68 69 73 20 63 61 6e 20 6e 6f 74 20 68 61   This can not ha
1070: 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20 20 20 6e  ppen! */.      n
1080: 45 72 72 20 3d 20 31 3b 0a 20 20 20 20 20 20 61  Err = 1;.      a
1090: 73 73 65 72 74 28 20 6e 45 72 72 3d 3d 30 20 29  ssert( nErr==0 )
10a0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
10b0: 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a 0a 2f 2a  turn nErr;.}../*
10c0: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 61  .** This is a ca
10d0: 6c 6c 62 61 63 6b 20 70 72 6f 63 65 64 75 72 65  llback procedure
10e0: 20 75 73 65 64 20 74 6f 20 72 65 63 6f 6e 73 74   used to reconst
10f0: 72 75 63 74 20 61 20 74 61 62 6c 65 2e 20 20 54  ruct a table.  T
1100: 68 65 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 74 68  he.** name of th
1110: 65 20 74 61 62 6c 65 20 74 6f 20 62 65 20 72 65  e table to be re
1120: 63 6f 6e 73 74 72 75 63 74 65 64 20 69 73 20 70  constructed is p
1130: 61 73 73 65 64 20 69 6e 20 61 73 20 61 72 67 76  assed in as argv
1140: 5b 30 5d 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  [0]..**.** This 
1150: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20  routine is used 
1160: 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  to automatically
1170: 20 75 70 67 72 61 64 65 20 61 20 64 61 74 61 62   upgrade a datab
1180: 61 73 65 20 66 72 6f 6d 0a 2a 2a 20 66 6f 72 6d  ase from.** form
1190: 61 74 20 76 65 72 73 69 6f 6e 20 31 20 6f 72 20  at version 1 or 
11a0: 32 20 74 6f 20 76 65 72 73 69 6f 6e 20 33 2e 20  2 to version 3. 
11b0: 20 54 68 65 20 63 6f 72 72 65 63 74 20 6f 70 65   The correct ope
11c0: 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 69  ration of.** thi
11d0: 73 20 72 6f 75 74 69 6e 65 20 72 65 6c 79 73 20  s routine relys 
11e0: 6f 6e 20 74 68 65 20 66 61 63 74 20 74 68 61 74  on the fact that
11f0: 20 6e 6f 20 69 6e 64 69 63 65 73 20 61 72 65 20   no indices are 
1200: 75 73 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 70  used when.** cop
1210: 79 69 6e 67 20 61 20 74 61 62 6c 65 20 6f 75 74  ying a table out
1220: 20 74 6f 20 61 20 74 65 6d 70 6f 72 61 72 79 20   to a temporary 
1230: 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  file..**.** The 
1240: 63 68 61 6e 67 65 20 66 72 6f 6d 20 76 65 72 73  change from vers
1250: 69 6f 6e 20 32 20 74 6f 20 76 65 72 73 69 6f 6e  ion 2 to version
1260: 20 33 20 6f 63 63 75 72 72 65 64 20 62 65 74 77   3 occurred betw
1270: 65 65 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 76 65  een SQLite.** ve
1280: 72 73 69 6f 6e 20 32 2e 35 2e 36 20 61 6e 64 20  rsion 2.5.6 and 
1290: 32 2e 36 2e 30 20 6f 6e 20 32 30 30 32 2d 4a 75  2.6.0 on 2002-Ju
12a0: 6c 79 2d 31 38 2e 20 20 0a 2a 2f 0a 73 74 61 74  ly-18.  .*/.stat
12b0: 69 63 0a 69 6e 74 20 75 70 67 72 61 64 65 5f 33  ic.int upgrade_3
12c0: 5f 63 61 6c 6c 62 61 63 6b 28 76 6f 69 64 20 2a  _callback(void *
12d0: 70 49 6e 69 74 2c 20 69 6e 74 20 61 72 67 63 2c  pInit, int argc,
12e0: 20 63 68 61 72 20 2a 2a 61 72 67 76 2c 20 63 68   char **argv, ch
12f0: 61 72 20 2a 2a 4e 6f 74 55 73 65 64 29 7b 0a 20  ar **NotUsed){. 
1300: 20 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61   InitData *pData
1310: 20 3d 20 28 49 6e 69 74 44 61 74 61 2a 29 70 49   = (InitData*)pI
1320: 6e 69 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  nit;.  int rc;. 
1330: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20   Table *pTab;.  
1340: 54 72 69 67 67 65 72 20 2a 70 54 72 69 67 3b 0a  Trigger *pTrig;.
1350: 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30    char *zErr = 0
1360: 3b 0a 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69  ;..  pTab = sqli
1370: 74 65 33 46 69 6e 64 54 61 62 6c 65 28 70 44 61  te3FindTable(pDa
1380: 74 61 2d 3e 64 62 2c 20 61 72 67 76 5b 30 5d 2c  ta->db, argv[0],
1390: 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70   0);.  assert( p
13a0: 54 61 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65  Tab!=0 );.  asse
13b0: 72 74 28 20 73 71 6c 69 74 65 33 53 74 72 49 43  rt( sqlite3StrIC
13c0: 6d 70 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20  mp(pTab->zName, 
13d0: 61 72 67 76 5b 30 5d 29 3d 3d 30 20 29 3b 0a 20  argv[0])==0 );. 
13e0: 20 69 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20   if( pTab ){.   
13f0: 20 70 54 72 69 67 20 3d 20 70 54 61 62 2d 3e 70   pTrig = pTab->p
1400: 54 72 69 67 67 65 72 3b 0a 20 20 20 20 70 54 61  Trigger;.    pTa
1410: 62 2d 3e 70 54 72 69 67 67 65 72 20 3d 20 30 3b  b->pTrigger = 0;
1420: 20 20 2f 2a 20 44 69 73 61 62 6c 65 20 61 6c 6c    /* Disable all
1430: 20 74 72 69 67 67 65 72 73 20 62 65 66 6f 72 65   triggers before
1440: 20 72 65 62 75 69 6c 64 69 6e 67 20 74 68 65 20   rebuilding the 
1450: 74 61 62 6c 65 20 2a 2f 0a 20 20 7d 0a 20 20 72  table */.  }.  r
1460: 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 78 65 63  c = sqlite3_exec
1470: 5f 70 72 69 6e 74 66 28 70 44 61 74 61 2d 3e 64  _printf(pData->d
1480: 62 2c 0a 20 20 20 20 22 43 52 45 41 54 45 20 54  b,.    "CREATE T
1490: 45 4d 50 20 54 41 42 4c 45 20 73 71 6c 69 74 65  EMP TABLE sqlite
14a0: 5f 78 20 41 53 20 53 45 4c 45 43 54 20 2a 20 46  _x AS SELECT * F
14b0: 52 4f 4d 20 27 25 71 27 3b 20 22 0a 20 20 20 20  ROM '%q'; ".    
14c0: 22 44 45 4c 45 54 45 20 46 52 4f 4d 20 27 25 71  "DELETE FROM '%q
14d0: 27 3b 20 22 0a 20 20 20 20 22 49 4e 53 45 52 54  '; ".    "INSERT
14e0: 20 49 4e 54 4f 20 27 25 71 27 20 53 45 4c 45 43   INTO '%q' SELEC
14f0: 54 20 2a 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f  T * FROM sqlite_
1500: 78 3b 20 22 0a 20 20 20 20 22 44 52 4f 50 20 54  x; ".    "DROP T
1510: 41 42 4c 45 20 73 71 6c 69 74 65 5f 78 3b 22 2c  ABLE sqlite_x;",
1520: 0a 20 20 20 20 30 2c 20 30 2c 20 26 7a 45 72 72  .    0, 0, &zErr
1530: 2c 20 61 72 67 76 5b 30 5d 2c 20 61 72 67 76 5b  , argv[0], argv[
1540: 30 5d 2c 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20  0], argv[0]);.  
1550: 69 66 28 20 7a 45 72 72 20 29 7b 0a 20 20 20 20  if( zErr ){.    
1560: 69 66 28 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72  if( *pData->pzEr
1570: 72 4d 73 67 20 29 20 73 71 6c 69 74 65 33 5f 66  rMsg ) sqlite3_f
1580: 72 65 65 6d 65 6d 28 2a 70 44 61 74 61 2d 3e 70  reemem(*pData->p
1590: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 2a 70  zErrMsg);.    *p
15a0: 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73 67 20 3d  Data->pzErrMsg =
15b0: 20 7a 45 72 72 3b 0a 20 20 7d 0a 0a 20 20 2f 2a   zErr;.  }..  /*
15c0: 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   If an error occ
15d0: 75 72 72 65 64 20 69 6e 20 74 68 65 20 53 51 4c  urred in the SQL
15e0: 20 61 62 6f 76 65 2c 20 74 68 65 6e 20 74 68 65   above, then the
15f0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c   transaction wil
1600: 6c 0a 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20  l.  ** rollback 
1610: 77 68 69 63 68 20 77 69 6c 6c 20 64 65 6c 65 74  which will delet
1620: 65 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73  e the internal s
1630: 79 6d 62 6f 6c 20 74 61 62 6c 65 73 2e 20 20 54  ymbol tables.  T
1640: 68 69 73 20 77 69 6c 6c 0a 20 20 2a 2a 20 63 61  his will.  ** ca
1650: 75 73 65 20 74 68 65 20 73 74 72 75 63 74 75 72  use the structur
1660: 65 20 74 68 61 74 20 70 54 61 62 20 70 6f 69 6e  e that pTab poin
1670: 74 73 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64  ts to be deleted
1680: 2e 20 20 49 6e 20 63 61 73 65 20 74 68 61 74 0a  .  In case that.
1690: 20 20 2a 2a 20 68 61 70 70 65 6e 65 64 2c 20 77    ** happened, w
16a0: 65 20 6e 65 65 64 20 74 6f 20 72 65 66 65 74 63  e need to refetc
16b0: 68 20 70 54 61 62 2e 0a 20 20 2a 2f 0a 20 20 70  h pTab..  */.  p
16c0: 54 61 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e  Tab = sqlite3Fin
16d0: 64 54 61 62 6c 65 28 70 44 61 74 61 2d 3e 64 62  dTable(pData->db
16e0: 2c 20 61 72 67 76 5b 30 5d 2c 20 30 29 3b 0a 20  , argv[0], 0);. 
16f0: 20 69 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20   if( pTab ){.   
1700: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
1710: 53 74 72 49 43 6d 70 28 70 54 61 62 2d 3e 7a 4e  StrICmp(pTab->zN
1720: 61 6d 65 2c 20 61 72 67 76 5b 30 5d 29 3d 3d 30  ame, argv[0])==0
1730: 20 29 3b 0a 20 20 20 20 70 54 61 62 2d 3e 70 54   );.    pTab->pT
1740: 72 69 67 67 65 72 20 3d 20 70 54 72 69 67 3b 20  rigger = pTrig; 
1750: 20 2f 2a 20 52 65 2d 65 6e 61 62 6c 65 20 74 72   /* Re-enable tr
1760: 69 67 67 65 72 73 20 2a 2f 0a 20 20 7d 0a 20 20  iggers */.  }.  
1770: 72 65 74 75 72 6e 20 72 63 21 3d 53 51 4c 49 54  return rc!=SQLIT
1780: 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 0a 2f 2a 0a 2a 2a  E_OK;.}..../*.**
1790: 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64   Attempt to read
17a0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63   the database sc
17b0: 68 65 6d 61 20 61 6e 64 20 69 6e 69 74 69 61 6c  hema and initial
17c0: 69 7a 65 20 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20  ize internal.** 
17d0: 64 61 74 61 20 73 74 72 75 63 74 75 72 65 73 20  data structures 
17e0: 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 64 61 74  for a single dat
17f0: 61 62 61 73 65 20 66 69 6c 65 2e 20 20 54 68 65  abase file.  The
1800: 20 69 6e 64 65 78 20 6f 66 20 74 68 65 0a 2a 2a   index of the.**
1810: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69   database file i
1820: 73 20 67 69 76 65 6e 20 62 79 20 69 44 62 2e 20  s given by iDb. 
1830: 20 69 44 62 3d 3d 30 20 69 73 20 75 73 65 64 20   iDb==0 is used 
1840: 66 6f 72 20 74 68 65 20 6d 61 69 6e 0a 2a 2a 20  for the main.** 
1850: 64 61 74 61 62 61 73 65 2e 20 20 69 44 62 3d 3d  database.  iDb==
1860: 31 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 62  1 should never b
1870: 65 20 75 73 65 64 2e 20 20 69 44 62 3e 3d 32 20  e used.  iDb>=2 
1880: 69 73 20 75 73 65 64 20 66 6f 72 0a 2a 2a 20 61  is used for.** a
1890: 75 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73  uxiliary databas
18a0: 65 73 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65 20  es.  Return one 
18b0: 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20 65  of the SQLITE_ e
18c0: 72 72 6f 72 20 63 6f 64 65 73 20 74 6f 0a 2a 2a  rror codes to.**
18d0: 20 69 6e 64 69 63 61 74 65 20 73 75 63 63 65 73   indicate succes
18e0: 73 20 6f 72 20 66 61 69 6c 75 72 65 2e 0a 2a 2f  s or failure..*/
18f0: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69  .static int sqli
1900: 74 65 33 49 6e 69 74 4f 6e 65 28 73 71 6c 69 74  te3InitOne(sqlit
1910: 65 20 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20  e *db, int iDb, 
1920: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29  char **pzErrMsg)
1930: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74  {.  int rc;.  Bt
1940: 43 75 72 73 6f 72 20 2a 63 75 72 4d 61 69 6e 3b  Cursor *curMain;
1950: 0a 20 20 69 6e 74 20 73 69 7a 65 3b 0a 20 20 54  .  int size;.  T
1960: 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20 63 68  able *pTab;.  ch
1970: 61 72 20 2a 61 7a 41 72 67 5b 36 5d 3b 0a 20 20  ar *azArg[6];.  
1980: 63 68 61 72 20 7a 44 62 4e 75 6d 5b 33 30 5d 3b  char zDbNum[30];
1990: 0a 20 20 69 6e 74 20 6d 65 74 61 5b 53 51 4c 49  .  int meta[SQLI
19a0: 54 45 5f 4e 5f 42 54 52 45 45 5f 4d 45 54 41 5d  TE_N_BTREE_META]
19b0: 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69 6e 69  ;.  InitData ini
19c0: 74 44 61 74 61 3b 0a 0a 20 20 2f 2a 0a 20 20 2a  tData;..  /*.  *
19d0: 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61 74  * The master dat
19e0: 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73 20  abase table has 
19f0: 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b 65  a structure like
1a00: 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74 61   this.  */.  sta
1a10: 74 69 63 20 63 68 61 72 20 6d 61 73 74 65 72 5f  tic char master_
1a20: 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20  schema[] = .    
1a30: 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20 73   "CREATE TABLE s
1a40: 71 6c 69 74 65 5f 6d 61 73 74 65 72 28 5c 6e 22  qlite_master(\n"
1a50: 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 74 65  .     "  type te
1a60: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 6e  xt,\n".     "  n
1a70: 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20  ame text,\n".   
1a80: 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 74 65    "  tbl_name te
1a90: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 72  xt,\n".     "  r
1aa0: 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72 2c  ootpage integer,
1ab0: 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 6c 20  \n".     "  sql 
1ac0: 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 29 22  text\n".     ")"
1ad0: 0a 20 20 3b 0a 20 20 73 74 61 74 69 63 20 63 68  .  ;.  static ch
1ae0: 61 72 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f 73  ar temp_master_s
1af0: 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20 20  chema[] = .     
1b00: 22 43 52 45 41 54 45 20 54 45 4d 50 20 54 41 42  "CREATE TEMP TAB
1b10: 4c 45 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d  LE sqlite_temp_m
1b20: 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20 22  aster(\n".     "
1b30: 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a    type text,\n".
1b40: 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65 78       "  name tex
1b50: 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 62  t,\n".     "  tb
1b60: 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a  l_name text,\n".
1b70: 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67 65       "  rootpage
1b80: 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20   integer,\n".   
1b90: 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22    "  sql text\n"
1ba0: 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 0a 20  .     ")".  ;.. 
1bb0: 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e   /* The followin
1bc0: 67 20 53 51 4c 20 77 69 6c 6c 20 72 65 61 64 20  g SQL will read 
1bd0: 74 68 65 20 73 63 68 65 6d 61 20 66 72 6f 6d 20  the schema from 
1be0: 74 68 65 20 6d 61 73 74 65 72 20 74 61 62 6c 65  the master table
1bf0: 73 2e 0a 20 20 2a 2f 0a 20 20 73 74 61 74 69 63  s..  */.  static
1c00: 20 63 68 61 72 20 69 6e 69 74 5f 73 63 72 69 70   char init_scrip
1c10: 74 5b 5d 20 3d 20 0a 20 20 20 20 20 22 53 45 4c  t[] = .     "SEL
1c20: 45 43 54 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20  ECT type, name, 
1c30: 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c 2c 20 31  rootpage, sql, 1
1c40: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 74 65 6d   FROM sqlite_tem
1c50: 70 5f 6d 61 73 74 65 72 20 22 0a 20 20 20 20 20  p_master ".     
1c60: 22 55 4e 49 4f 4e 20 41 4c 4c 20 22 0a 20 20 20  "UNION ALL ".   
1c70: 20 20 22 53 45 4c 45 43 54 20 74 79 70 65 2c 20    "SELECT type, 
1c80: 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20  name, rootpage, 
1c90: 73 71 6c 2c 20 30 20 46 52 4f 4d 20 73 71 6c 69  sql, 0 FROM sqli
1ca0: 74 65 5f 6d 61 73 74 65 72 22 3b 0a 0a 20 20 61  te_master";..  a
1cb0: 73 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26 26  ssert( iDb>=0 &&
1cc0: 20 69 44 62 21 3d 31 20 26 26 20 69 44 62 3c 64   iDb!=1 && iDb<d
1cd0: 62 2d 3e 6e 44 62 20 29 3b 0a 0a 20 20 2f 2a 20  b->nDb );..  /* 
1ce0: 43 6f 6e 73 74 72 75 63 74 20 74 68 65 20 73 63  Construct the sc
1cf0: 68 65 6d 61 20 74 61 62 6c 65 73 3a 20 73 71 6c  hema tables: sql
1d00: 69 74 65 5f 6d 61 73 74 65 72 20 61 6e 64 20 73  ite_master and s
1d10: 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65  qlite_temp_maste
1d20: 72 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  r.  */.  sqlite3
1d30: 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20  SafetyOff(db);. 
1d40: 20 61 7a 41 72 67 5b 30 5d 20 3d 20 22 74 61 62   azArg[0] = "tab
1d50: 6c 65 22 3b 0a 20 20 61 7a 41 72 67 5b 31 5d 20  le";.  azArg[1] 
1d60: 3d 20 4d 41 53 54 45 52 5f 4e 41 4d 45 3b 0a 20  = MASTER_NAME;. 
1d70: 20 61 7a 41 72 67 5b 32 5d 20 3d 20 22 31 22 3b   azArg[2] = "1";
1d80: 0a 20 20 61 7a 41 72 67 5b 33 5d 20 3d 20 6d 61  .  azArg[3] = ma
1d90: 73 74 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 73  ster_schema;.  s
1da0: 70 72 69 6e 74 66 28 7a 44 62 4e 75 6d 2c 20 22  printf(zDbNum, "
1db0: 25 64 22 2c 20 69 44 62 29 3b 0a 20 20 61 7a 41  %d", iDb);.  azA
1dc0: 72 67 5b 34 5d 20 3d 20 7a 44 62 4e 75 6d 3b 0a  rg[4] = zDbNum;.
1dd0: 20 20 61 7a 41 72 67 5b 35 5d 20 3d 20 30 3b 0a    azArg[5] = 0;.
1de0: 20 20 69 6e 69 74 44 61 74 61 2e 64 62 20 3d 20    initData.db = 
1df0: 64 62 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 70  db;.  initData.p
1e00: 7a 45 72 72 4d 73 67 20 3d 20 70 7a 45 72 72 4d  zErrMsg = pzErrM
1e10: 73 67 3b 0a 20 20 73 71 6c 69 74 65 33 49 6e 69  sg;.  sqlite3Ini
1e20: 74 43 61 6c 6c 62 61 63 6b 28 26 69 6e 69 74 44  tCallback(&initD
1e30: 61 74 61 2c 20 35 2c 20 61 7a 41 72 67 2c 20 30  ata, 5, azArg, 0
1e40: 29 3b 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69  );.  pTab = sqli
1e50: 74 65 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c  te3FindTable(db,
1e60: 20 4d 41 53 54 45 52 5f 4e 41 4d 45 2c 20 22 6d   MASTER_NAME, "m
1e70: 61 69 6e 22 29 3b 0a 20 20 69 66 28 20 70 54 61  ain");.  if( pTa
1e80: 62 20 29 7b 0a 20 20 20 20 70 54 61 62 2d 3e 72  b ){.    pTab->r
1e90: 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20 20 7d  eadOnly = 1;.  }
1ea0: 0a 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29 7b  .  if( iDb==0 ){
1eb0: 0a 20 20 20 20 61 7a 41 72 67 5b 31 5d 20 3d 20  .    azArg[1] = 
1ec0: 54 45 4d 50 5f 4d 41 53 54 45 52 5f 4e 41 4d 45  TEMP_MASTER_NAME
1ed0: 3b 0a 20 20 20 20 61 7a 41 72 67 5b 33 5d 20 3d  ;.    azArg[3] =
1ee0: 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f 73 63 68   temp_master_sch
1ef0: 65 6d 61 3b 0a 20 20 20 20 61 7a 41 72 67 5b 34  ema;.    azArg[4
1f00: 5d 20 3d 20 22 31 22 3b 0a 20 20 20 20 73 71 6c  ] = "1";.    sql
1f10: 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b  ite3InitCallback
1f20: 28 26 69 6e 69 74 44 61 74 61 2c 20 35 2c 20 61  (&initData, 5, a
1f30: 7a 41 72 67 2c 20 30 29 3b 0a 20 20 20 20 70 54  zArg, 0);.    pT
1f40: 61 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64  ab = sqlite3Find
1f50: 54 61 62 6c 65 28 64 62 2c 20 54 45 4d 50 5f 4d  Table(db, TEMP_M
1f60: 41 53 54 45 52 5f 4e 41 4d 45 2c 20 22 74 65 6d  ASTER_NAME, "tem
1f70: 70 22 29 3b 0a 20 20 20 20 69 66 28 20 70 54 61  p");.    if( pTa
1f80: 62 20 29 7b 0a 20 20 20 20 20 20 70 54 61 62 2d  b ){.      pTab-
1f90: 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20  >readOnly = 1;. 
1fa0: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74     }.  }.  sqlit
1fb0: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a  e3SafetyOn(db);.
1fc0: 0a 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 63  .  /* Create a c
1fd0: 75 72 73 6f 72 20 74 6f 20 68 6f 6c 64 20 74 68  ursor to hold th
1fe0: 65 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e 0a  e database open.
1ff0: 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 61    */.  if( db->a
2000: 44 62 5b 69 44 62 5d 2e 70 42 74 3d 3d 30 20 29  Db[iDb].pBt==0 )
2010: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
2020: 4b 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  K;.  rc = sqlite
2030: 33 42 74 72 65 65 43 75 72 73 6f 72 28 64 62 2d  3BtreeCursor(db-
2040: 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 2c 20 4d  >aDb[iDb].pBt, M
2050: 41 53 54 45 52 5f 52 4f 4f 54 2c 20 30 2c 20 30  ASTER_ROOT, 0, 0
2060: 2c 20 30 2c 20 26 63 75 72 4d 61 69 6e 29 3b 0a  , 0, &curMain);.
2070: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
2080: 5f 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54  _OK && rc!=SQLIT
2090: 45 5f 45 4d 50 54 59 20 29 7b 0a 20 20 20 20 73  E_EMPTY ){.    s
20a0: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28  qlite3SetString(
20b0: 70 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65  pzErrMsg, sqlite
20c0: 33 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 72  3_error_string(r
20d0: 63 29 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20  c), (char*)0);. 
20e0: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
20f0: 7d 0a 0a 20 20 2f 2a 20 47 65 74 20 74 68 65 20  }..  /* Get the 
2100: 64 61 74 61 62 61 73 65 20 6d 65 74 61 20 69 6e  database meta in
2110: 66 6f 72 6d 61 74 69 6f 6e 0a 20 20 2a 2f 0a 20  formation.  */. 
2120: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
2130: 4f 4b 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b  OK ){.    int i;
2140: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 72 63  .    for(i=0; rc
2150: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69  ==SQLITE_OK && i
2160: 3c 53 51 4c 49 54 45 5f 4e 5f 42 54 52 45 45 5f  <SQLITE_N_BTREE_
2170: 4d 45 54 41 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  META; i++){.    
2180: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74    rc = sqlite3Bt
2190: 72 65 65 47 65 74 4d 65 74 61 28 64 62 2d 3e 61  reeGetMeta(db->a
21a0: 44 62 5b 69 44 62 5d 2e 70 42 74 2c 20 69 2c 20  Db[iDb].pBt, i, 
21b0: 26 6d 65 74 61 5b 69 5d 29 3b 0a 20 20 20 20 7d  &meta[i]);.    }
21c0: 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20  .    if( rc ){. 
21d0: 20 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53       sqlite3SetS
21e0: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
21f0: 73 71 6c 69 74 65 33 5f 65 72 72 6f 72 5f 73 74  sqlite3_error_st
2200: 72 69 6e 67 28 72 63 29 2c 20 28 63 68 61 72 2a  ring(rc), (char*
2210: 29 30 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  )0);.      sqlit
2220: 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73  e3BtreeCloseCurs
2230: 6f 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 20  or(curMain);.   
2240: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
2250: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20    }.  }else{.   
2260: 20 6d 65 6d 73 65 74 28 6d 65 74 61 2c 20 30 2c   memset(meta, 0,
2270: 20 73 69 7a 65 6f 66 28 6d 65 74 61 29 29 3b 0a   sizeof(meta));.
2280: 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 69 44    }.  db->aDb[iD
2290: 62 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65  b].schema_cookie
22a0: 20 3d 20 6d 65 74 61 5b 31 5d 3b 0a 20 20 69 66   = meta[1];.  if
22b0: 28 20 69 44 62 3d 3d 30 20 29 7b 0a 20 20 20 20  ( iDb==0 ){.    
22c0: 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b 69 65 20  db->next_cookie 
22d0: 3d 20 6d 65 74 61 5b 31 5d 3b 0a 20 20 20 20 64  = meta[1];.    d
22e0: 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d  b->file_format =
22f0: 20 6d 65 74 61 5b 32 5d 3b 0a 20 20 20 20 73 69   meta[2];.    si
2300: 7a 65 20 3d 20 6d 65 74 61 5b 33 5d 3b 0a 20 20  ze = meta[3];.  
2310: 20 20 69 66 28 20 73 69 7a 65 3d 3d 30 20 29 7b    if( size==0 ){
2320: 20 73 69 7a 65 20 3d 20 4d 41 58 5f 50 41 47 45   size = MAX_PAGE
2330: 53 3b 20 7d 0a 20 20 20 20 64 62 2d 3e 63 61 63  S; }.    db->cac
2340: 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a  he_size = size;.
2350: 20 20 20 20 64 62 2d 3e 73 61 66 65 74 79 5f 6c      db->safety_l
2360: 65 76 65 6c 20 3d 20 6d 65 74 61 5b 34 5d 3b 0a  evel = meta[4];.
2370: 20 20 20 20 69 66 28 20 6d 65 74 61 5b 36 5d 3e      if( meta[6]>
2380: 30 20 26 26 20 6d 65 74 61 5b 36 5d 3c 3d 32 20  0 && meta[6]<=2 
2390: 26 26 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72  && db->temp_stor
23a0: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 64 62  e==0 ){.      db
23b0: 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 3d 20 6d  ->temp_store = m
23c0: 65 74 61 5b 36 5d 3b 0a 20 20 20 20 7d 0a 20 20  eta[6];.    }.  
23d0: 20 20 69 66 28 20 64 62 2d 3e 73 61 66 65 74 79    if( db->safety
23e0: 5f 6c 65 76 65 6c 3d 3d 30 20 29 20 64 62 2d 3e  _level==0 ) db->
23f0: 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 32  safety_level = 2
2400: 3b 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a  ;..    /*.    **
2410: 20 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 31    file_format==1
2420: 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 30 2e      Version 3.0.
2430: 30 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66  0..    */.    if
2440: 28 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61  ( db->file_forma
2450: 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a  t==0 ){.      /*
2460: 20 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 66   This happens if
2470: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77 61   the database wa
2480: 73 20 69 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74  s initially empt
2490: 79 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 66  y */.      db->f
24a0: 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a  ile_format = 1;.
24b0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62      }else if( db
24c0: 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 31 20  ->file_format>1 
24d0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
24e0: 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72  BtreeCloseCursor
24f0: 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 20 20 20  (curMain);.     
2500: 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e   sqlite3SetStrin
2510: 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e 73  g(pzErrMsg, "uns
2520: 75 70 70 6f 72 74 65 64 20 66 69 6c 65 20 66 6f  upported file fo
2530: 72 6d 61 74 22 2c 20 28 63 68 61 72 2a 29 30 29  rmat", (char*)0)
2540: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53  ;.      return S
2550: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20  QLITE_ERROR;.   
2560: 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64   }.  }else if( d
2570: 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 21 3d  b->file_format!=
2580: 6d 65 74 61 5b 32 5d 20 29 7b 0a 20 20 20 20 69  meta[2] ){.    i
2590: 66 28 20 6d 65 74 61 5b 32 5d 3d 3d 30 20 29 7b  f( meta[2]==0 ){
25a0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 65  .      sqlite3Se
25b0: 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67  tString(pzErrMsg
25c0: 2c 20 22 63 61 6e 6e 6f 74 20 61 74 74 61 63 68  , "cannot attach
25d0: 20 65 6d 70 74 79 20 64 61 74 61 62 61 73 65 3a   empty database:
25e0: 20 22 2c 0a 20 20 20 20 20 20 20 20 20 64 62 2d   ",.         db-
25f0: 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 2c  >aDb[iDb].zName,
2600: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20   (char*)0);.    
2610: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
2620: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a  ite3SetString(pz
2630: 45 72 72 4d 73 67 2c 20 22 69 6e 63 6f 6d 70 61  ErrMsg, "incompa
2640: 74 69 62 6c 65 20 66 69 6c 65 20 66 6f 72 6d 61  tible file forma
2650: 74 20 69 6e 20 61 75 78 69 6c 69 61 72 79 20 22  t in auxiliary "
2660: 0a 20 20 20 20 20 20 20 20 20 22 64 61 74 61 62  .         "datab
2670: 61 73 65 3a 20 22 2c 20 64 62 2d 3e 61 44 62 5b  ase: ", db->aDb[
2680: 69 44 62 5d 2e 7a 4e 61 6d 65 2c 20 28 63 68 61  iDb].zName, (cha
2690: 72 2a 29 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20  r*)0);.    }.   
26a0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
26b0: 73 65 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e  se(db->aDb[iDb].
26c0: 70 42 74 29 3b 0a 20 20 20 20 64 62 2d 3e 61 44  pBt);.    db->aD
26d0: 62 5b 69 44 62 5d 2e 70 42 74 20 3d 20 30 3b 0a  b[iDb].pBt = 0;.
26e0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
26f0: 45 5f 46 4f 52 4d 41 54 3b 0a 20 20 7d 0a 20 20  E_FORMAT;.  }.  
2700: 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 43  sqlite3BtreeSetC
2710: 61 63 68 65 53 69 7a 65 28 64 62 2d 3e 61 44 62  acheSize(db->aDb
2720: 5b 69 44 62 5d 2e 70 42 74 2c 20 64 62 2d 3e 63  [iDb].pBt, db->c
2730: 61 63 68 65 5f 73 69 7a 65 29 3b 0a 20 20 73 71  ache_size);.  sq
2740: 6c 69 74 65 33 42 74 72 65 65 53 65 74 53 61 66  lite3BtreeSetSaf
2750: 65 74 79 4c 65 76 65 6c 28 64 62 2d 3e 61 44 62  etyLevel(db->aDb
2760: 5b 69 44 62 5d 2e 70 42 74 2c 20 6d 65 74 61 5b  [iDb].pBt, meta[
2770: 34 5d 3d 3d 30 20 3f 20 32 20 3a 20 6d 65 74 61  4]==0 ? 2 : meta
2780: 5b 34 5d 29 3b 0a 0a 20 20 2f 2a 20 52 65 61 64  [4]);..  /* Read
2790: 20 74 68 65 20 73 63 68 65 6d 61 20 69 6e 66 6f   the schema info
27a0: 72 6d 61 74 69 6f 6e 20 6f 75 74 20 6f 66 20 74  rmation out of t
27b0: 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73  he schema tables
27c0: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
27d0: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b  db->init.busy );
27e0: 0a 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79  .  sqlite3Safety
27f0: 4f 66 66 28 64 62 29 3b 0a 20 20 69 66 28 20 72  Off(db);.  if( r
2800: 63 3d 3d 53 51 4c 49 54 45 5f 45 4d 50 54 59 20  c==SQLITE_EMPTY 
2810: 29 7b 0a 20 20 20 20 2f 2a 20 46 6f 72 20 61 6e  ){.    /* For an
2820: 20 65 6d 70 74 79 20 64 61 74 61 62 61 73 65 2c   empty database,
2830: 20 74 68 65 72 65 20 69 73 20 6e 6f 74 68 69 6e   there is nothin
2840: 67 20 74 6f 20 72 65 61 64 20 2a 2f 0a 20 20 20  g to read */.   
2850: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
2860: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66  .  }else{.    if
2870: 28 20 69 44 62 3d 3d 30 20 29 7b 0a 20 20 20 20  ( iDb==0 ){.    
2880: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65    rc = sqlite3_e
2890: 78 65 63 28 64 62 2c 20 69 6e 69 74 5f 73 63 72  xec(db, init_scr
28a0: 69 70 74 2c 20 73 71 6c 69 74 65 33 49 6e 69 74  ipt, sqlite3Init
28b0: 43 61 6c 6c 62 61 63 6b 2c 20 26 69 6e 69 74 44  Callback, &initD
28c0: 61 74 61 2c 20 30 29 3b 0a 20 20 20 20 7d 65 6c  ata, 0);.    }el
28d0: 73 65 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a  se{.      char *
28e0: 7a 53 71 6c 20 3d 20 30 3b 0a 20 20 20 20 20 20  zSql = 0;.      
28f0: 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67  sqlite3SetString
2900: 28 26 7a 53 71 6c 2c 20 0a 20 20 20 20 20 20 20  (&zSql, .       
2910: 20 20 22 53 45 4c 45 43 54 20 74 79 70 65 2c 20    "SELECT type, 
2920: 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20  name, rootpage, 
2930: 73 71 6c 2c 20 22 2c 20 7a 44 62 4e 75 6d 2c 20  sql, ", zDbNum, 
2940: 22 20 46 52 4f 4d 20 5c 22 22 2c 0a 20 20 20 20  " FROM \"",.    
2950: 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69 44 62       db->aDb[iDb
2960: 5d 2e 7a 4e 61 6d 65 2c 20 22 5c 22 2e 73 71 6c  ].zName, "\".sql
2970: 69 74 65 5f 6d 61 73 74 65 72 22 2c 20 28 63 68  ite_master", (ch
2980: 61 72 2a 29 30 29 3b 0a 20 20 20 20 20 20 72 63  ar*)0);.      rc
2990: 20 3d 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28   = sqlite3_exec(
29a0: 64 62 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65  db, zSql, sqlite
29b0: 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26  3InitCallback, &
29c0: 69 6e 69 74 44 61 74 61 2c 20 30 29 3b 0a 20 20  initData, 0);.  
29d0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a      sqliteFree(z
29e0: 53 71 6c 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  Sql);.    }.    
29f0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
2a00: 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  db);.    sqlite3
2a10: 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72  BtreeCloseCursor
2a20: 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 7d 0a 20  (curMain);.  }. 
2a30: 20 69 66 28 20 73 71 6c 69 74 65 33 5f 6d 61 6c   if( sqlite3_mal
2a40: 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20  loc_failed ){.  
2a50: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
2a60: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f 75  ng(pzErrMsg, "ou
2a70: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 28 63  t of memory", (c
2a80: 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 63 20  har*)0);.    rc 
2a90: 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  = SQLITE_NOMEM;.
2aa0: 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74      sqlite3Reset
2ab0: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64  InternalSchema(d
2ac0: 62 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66 28  b, 0);.  }.  if(
2ad0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
2ae0: 7b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70 65  {.    DbSetPrope
2af0: 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f  rty(db, iDb, DB_
2b00: 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20  SchemaLoaded);. 
2b10: 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29 7b     if( iDb==0 ){
2b20: 0a 20 20 20 20 20 20 44 62 53 65 74 50 72 6f 70  .      DbSetProp
2b30: 65 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53  erty(db, 1, DB_S
2b40: 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20  chemaLoaded);.  
2b50: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20    }.  }else{.   
2b60: 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74   sqlite3ResetInt
2b70: 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20  ernalSchema(db, 
2b80: 69 44 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  iDb);.  }.  retu
2b90: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
2ba0: 49 6e 69 74 69 61 6c 69 7a 65 20 61 6c 6c 20 64  Initialize all d
2bb0: 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 2d 20  atabase files - 
2bc0: 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73  the main databas
2bd0: 65 20 66 69 6c 65 2c 20 74 68 65 20 66 69 6c 65  e file, the file
2be0: 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72  .** used to stor
2bf0: 65 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c  e temporary tabl
2c00: 65 73 2c 20 61 6e 64 20 61 6e 79 20 61 64 64 69  es, and any addi
2c10: 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 20  tional database 
2c20: 66 69 6c 65 73 0a 2a 2a 20 63 72 65 61 74 65 64  files.** created
2c30: 20 75 73 69 6e 67 20 41 54 54 41 43 48 20 73 74   using ATTACH st
2c40: 61 74 65 6d 65 6e 74 73 2e 20 20 52 65 74 75 72  atements.  Retur
2c50: 6e 20 61 20 73 75 63 63 65 73 73 20 63 6f 64 65  n a success code
2c60: 2e 20 20 49 66 20 61 6e 0a 2a 2a 20 65 72 72 6f  .  If an.** erro
2c70: 72 20 6f 63 63 75 72 73 2c 20 77 72 69 74 65 20  r occurs, write 
2c80: 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  an error message
2c90: 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e   into *pzErrMsg.
2ca0: 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65  .**.** After the
2cb0: 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 69   database is ini
2cc0: 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 53 51  tialized, the SQ
2cd0: 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64  LITE_Initialized
2ce0: 0a 2a 2a 20 62 69 74 20 69 73 20 73 65 74 20 69  .** bit is set i
2cf0: 6e 20 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c  n the flags fiel
2d00: 64 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20  d of the sqlite 
2d10: 73 74 72 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a  structure.  An.*
2d20: 2a 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64  * attempt is mad
2d30: 65 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20  e to initialize 
2d40: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 73 20  the database as 
2d50: 73 6f 6f 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73  soon as it.** is
2d60: 20 6f 70 65 6e 65 64 2e 20 20 49 66 20 74 68 61   opened.  If tha
2d70: 74 20 66 61 69 6c 73 20 28 70 65 72 68 61 70 73  t fails (perhaps
2d80: 20 62 65 63 61 75 73 65 20 61 6e 6f 74 68 65 72   because another
2d90: 20 70 72 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20   process.** has 
2da0: 74 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65  the sqlite_maste
2db0: 72 20 74 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20  r table locked) 
2dc0: 74 68 61 6e 20 61 6e 6f 74 68 65 72 20 61 74 74  than another att
2dd0: 65 6d 70 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20  empt.** is made 
2de0: 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74  the first time t
2df0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61  he database is a
2e00: 63 63 65 73 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20  ccessed..*/.int 
2e10: 73 71 6c 69 74 65 33 49 6e 69 74 28 73 71 6c 69  sqlite3Init(sqli
2e20: 74 65 20 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70  te *db, char **p
2e30: 7a 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20  zErrMsg){.  int 
2e40: 69 2c 20 72 63 3b 0a 20 20 0a 20 20 69 66 28 20  i, rc;.  .  if( 
2e50: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 20  db->init.busy ) 
2e60: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
2e70: 3b 0a 20 20 61 73 73 65 72 74 28 20 28 64 62 2d  ;.  assert( (db-
2e80: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
2e90: 49 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20  Initialized)==0 
2ea0: 29 3b 0a 20 20 72 63 20 3d 20 53 51 4c 49 54 45  );.  rc = SQLITE
2eb0: 5f 4f 4b 3b 0a 20 20 64 62 2d 3e 69 6e 69 74 2e  _OK;.  db->init.
2ec0: 62 75 73 79 20 3d 20 31 3b 0a 20 20 66 6f 72 28  busy = 1;.  for(
2ed0: 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f  i=0; rc==SQLITE_
2ee0: 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b  OK && i<db->nDb;
2ef0: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 44   i++){.    if( D
2f00: 62 48 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c  bHasProperty(db,
2f10: 20 69 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61   i, DB_SchemaLoa
2f20: 64 65 64 29 20 29 20 63 6f 6e 74 69 6e 75 65 3b  ded) ) continue;
2f30: 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 21 3d  .    assert( i!=
2f40: 31 20 29 3b 20 20 2f 2a 20 53 68 6f 75 6c 64 20  1 );  /* Should 
2f50: 68 61 76 65 20 62 65 65 6e 20 69 6e 69 74 69 61  have been initia
2f60: 6c 69 7a 65 64 20 74 6f 67 65 74 68 65 72 20 77  lized together w
2f70: 69 74 68 20 30 20 2a 2f 0a 20 20 20 20 72 63 20  ith 0 */.    rc 
2f80: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65  = sqlite3InitOne
2f90: 28 64 62 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67  (db, i, pzErrMsg
2fa0: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b  );.    if( rc ){
2fb0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 65  .      sqlite3Re
2fc0: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
2fd0: 61 28 64 62 2c 20 69 29 3b 0a 20 20 20 20 7d 0a  a(db, i);.    }.
2fe0: 20 20 7d 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62    }.  db->init.b
2ff0: 75 73 79 20 3d 20 30 3b 0a 20 20 69 66 28 20 72  usy = 0;.  if( r
3000: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
3010: 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d      db->flags |=
3020: 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69   SQLITE_Initiali
3030: 7a 65 64 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  zed;.    sqlite3
3040: 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68  CommitInternalCh
3050: 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a  anges(db);.  }..
3060: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
3070: 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66  _OK ){.    db->f
3080: 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f  lags &= ~SQLITE_
3090: 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 20 20 7d  Initialized;.  }
30a0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
30b0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76 65 72 73 69  ./*.** The versi
30c0: 6f 6e 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72  on of the librar
30d0: 79 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20  y.*/.const char 
30e0: 72 63 73 69 64 5b 5d 20 3d 20 22 40 28 23 29 20  rcsid[] = "@(#) 
30f0: 5c 30 34 34 49 64 3a 20 53 51 4c 69 74 65 20 76  \044Id: SQLite v
3100: 65 72 73 69 6f 6e 20 22 20 53 51 4c 49 54 45 5f  ersion " SQLITE_
3110: 56 45 52 53 49 4f 4e 20 22 20 24 22 3b 0a 63 6f  VERSION " $";.co
3120: 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 33  nst char sqlite3
3130: 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c  _version[] = SQL
3140: 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a  ITE_VERSION;../*
3150: 0a 2a 2a 20 44 6f 65 73 20 74 68 65 20 6c 69 62  .** Does the lib
3160: 72 61 72 79 20 65 78 70 65 63 74 20 64 61 74 61  rary expect data
3170: 20 74 6f 20 62 65 20 65 6e 63 6f 64 65 64 20 61   to be encoded a
3180: 73 20 55 54 46 2d 38 20 6f 72 20 69 73 6f 38 38  s UTF-8 or iso88
3190: 35 39 3f 20 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c  59?  The.** foll
31a0: 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e  owing global con
31b0: 73 74 61 6e 74 20 61 6c 77 61 79 73 20 6c 65 74  stant always let
31c0: 73 20 75 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a 23 69  s us know..*/.#i
31d0: 66 64 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38  fdef SQLITE_UTF8
31e0: 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69  .const char sqli
31f0: 74 65 33 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d  te3_encoding[] =
3200: 20 22 55 54 46 2d 38 22 3b 0a 23 65 6c 73 65 0a   "UTF-8";.#else.
3210: 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74  const char sqlit
3220: 65 33 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20  e3_encoding[] = 
3230: 22 69 73 6f 38 38 35 39 22 3b 0a 23 65 6e 64 69  "iso8859";.#endi
3240: 66 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20  f../*.** Open a 
3250: 6e 65 77 20 53 51 4c 69 74 65 20 64 61 74 61 62  new SQLite datab
3260: 61 73 65 2e 20 20 43 6f 6e 73 74 72 75 63 74 20  ase.  Construct 
3270: 61 6e 20 22 73 71 6c 69 74 65 22 20 73 74 72 75  an "sqlite" stru
3280: 63 74 75 72 65 20 74 6f 20 64 65 66 69 6e 65 0a  cture to define.
3290: 2a 2a 20 74 68 65 20 73 74 61 74 65 20 6f 66 20  ** the state of 
32a0: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 61 6e  this database an
32b0: 64 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  d return a point
32c0: 65 72 20 74 6f 20 74 68 61 74 20 73 74 72 75 63  er to that struc
32d0: 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61  ture..**.** An a
32e0: 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74  ttempt is made t
32f0: 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65  o initialize the
3300: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 20   in-memory data 
3310: 73 74 72 75 63 74 75 72 65 73 20 74 68 61 74 0a  structures that.
3320: 2a 2a 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61  ** hold the data
3330: 62 61 73 65 20 73 63 68 65 6d 61 2e 20 20 42 75  base schema.  Bu
3340: 74 20 69 66 20 74 68 69 73 20 66 61 69 6c 73 20  t if this fails 
3350: 28 62 65 63 61 75 73 65 20 74 68 65 20 73 63 68  (because the sch
3360: 65 6d 61 20 66 69 6c 65 0a 2a 2a 20 69 73 20 6c  ema file.** is l
3370: 6f 63 6b 65 64 29 20 74 68 65 6e 20 74 68 61 74  ocked) then that
3380: 20 73 74 65 70 20 69 73 20 64 65 66 65 72 72 65   step is deferre
3390: 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73  d until the firs
33a0: 74 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c  t call to.** sql
33b0: 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a  ite3_exec()..*/.
33c0: 73 71 6c 69 74 65 20 2a 73 71 6c 69 74 65 33 5f  sqlite *sqlite3_
33d0: 6f 70 65 6e 28 63 6f 6e 73 74 20 63 68 61 72 20  open(const char 
33e0: 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 69 6e 74 20  *zFilename, int 
33f0: 6d 6f 64 65 2c 20 63 68 61 72 20 2a 2a 70 7a 45  mode, char **pzE
3400: 72 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69 74 65  rrMsg){.  sqlite
3410: 20 2a 64 62 3b 0a 20 20 69 6e 74 20 72 63 2c 20   *db;.  int rc, 
3420: 69 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74  i;..  /* Allocat
3430: 65 20 74 68 65 20 73 71 6c 69 74 65 20 64 61 74  e the sqlite dat
3440: 61 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20  a structure */. 
3450: 20 64 62 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c   db = sqliteMall
3460: 6f 63 28 20 73 69 7a 65 6f 66 28 73 71 6c 69 74  oc( sizeof(sqlit
3470: 65 29 20 29 3b 0a 20 20 69 66 28 20 70 7a 45 72  e) );.  if( pzEr
3480: 72 4d 73 67 20 29 20 2a 70 7a 45 72 72 4d 73 67  rMsg ) *pzErrMsg
3490: 20 3d 20 30 3b 0a 20 20 69 66 28 20 64 62 3d 3d   = 0;.  if( db==
34a0: 30 20 29 20 67 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f  0 ) goto no_mem_
34b0: 6f 6e 5f 6f 70 65 6e 3b 0a 20 20 64 62 2d 3e 6f  on_open;.  db->o
34c0: 6e 45 72 72 6f 72 20 3d 20 4f 45 5f 44 65 66 61  nError = OE_Defa
34d0: 75 6c 74 3b 0a 20 20 64 62 2d 3e 70 72 69 6f 72  ult;.  db->prior
34e0: 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b 0a 20 20  NewRowid = 0;.  
34f0: 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49  db->magic = SQLI
3500: 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 3b 0a 20  TE_MAGIC_BUSY;. 
3510: 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b 0a 20 20   db->nDb = 2;.  
3520: 64 62 2d 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44  db->aDb = db->aD
3530: 62 53 74 61 74 69 63 3b 0a 20 20 2f 2a 20 64 62  bStatic;.  /* db
3540: 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54  ->flags |= SQLIT
3550: 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 3b  E_ShortColNames;
3560: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 48 61 73   */.  sqlite3Has
3570: 68 49 6e 69 74 28 26 64 62 2d 3e 61 46 75 6e 63  hInit(&db->aFunc
3580: 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54  , SQLITE_HASH_ST
3590: 52 49 4e 47 2c 20 31 29 3b 0a 20 20 66 6f 72 28  RING, 1);.  for(
35a0: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
35b0: 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  i++){.    sqlite
35c0: 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61  3HashInit(&db->a
35d0: 44 62 5b 69 5d 2e 74 62 6c 48 61 73 68 2c 20 53  Db[i].tblHash, S
35e0: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
35f0: 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74  G, 0);.    sqlit
3600: 65 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e  e3HashInit(&db->
3610: 61 44 62 5b 69 5d 2e 69 64 78 48 61 73 68 2c 20  aDb[i].idxHash, 
3620: 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49  SQLITE_HASH_STRI
3630: 4e 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69  NG, 0);.    sqli
3640: 74 65 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d  te3HashInit(&db-
3650: 3e 61 44 62 5b 69 5d 2e 74 72 69 67 48 61 73 68  >aDb[i].trigHash
3660: 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54  , SQLITE_HASH_ST
3670: 52 49 4e 47 2c 20 30 29 3b 0a 20 20 20 20 73 71  RING, 0);.    sq
3680: 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 64  lite3HashInit(&d
3690: 62 2d 3e 61 44 62 5b 69 5d 2e 61 46 4b 65 79 2c  b->aDb[i].aFKey,
36a0: 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52   SQLITE_HASH_STR
36b0: 49 4e 47 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 0a  ING, 1);.  }.  .
36c0: 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 61    /* Open the ba
36d0: 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20 64  ckend database d
36e0: 72 69 76 65 72 20 2a 2f 0a 20 20 69 66 28 20 7a  river */.  if( z
36f0: 46 69 6c 65 6e 61 6d 65 5b 30 5d 3d 3d 27 3a 27  Filename[0]==':'
3700: 20 26 26 20 73 74 72 63 6d 70 28 7a 46 69 6c 65   && strcmp(zFile
3710: 6e 61 6d 65 2c 22 3a 6d 65 6d 6f 72 79 3a 22 29  name,":memory:")
3720: 3d 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 74  ==0 ){.    db->t
3730: 65 6d 70 5f 73 74 6f 72 65 20 3d 20 32 3b 0a 20  emp_store = 2;. 
3740: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65   }.  rc = sqlite
3750: 33 42 74 72 65 65 46 61 63 74 6f 72 79 28 64 62  3BtreeFactory(db
3760: 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 2c 20  , zFilename, 0, 
3770: 4d 41 58 5f 50 41 47 45 53 2c 20 26 64 62 2d 3e  MAX_PAGES, &db->
3780: 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 69  aDb[0].pBt);.  i
3790: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
37a0: 20 29 7b 0a 20 20 20 20 73 77 69 74 63 68 28 20   ){.    switch( 
37b0: 72 63 20 29 7b 0a 20 20 20 20 20 20 64 65 66 61  rc ){.      defa
37c0: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 20 20 73  ult: {.        s
37d0: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28  qlite3SetString(
37e0: 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e 61 62 6c  pzErrMsg, "unabl
37f0: 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62 61  e to open databa
3800: 73 65 3a 20 22 2c 0a 20 20 20 20 20 20 20 20 20  se: ",.         
3810: 20 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 28 63 68    zFilename, (ch
3820: 61 72 2a 29 30 29 3b 0a 20 20 20 20 20 20 7d 0a  ar*)0);.      }.
3830: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
3840: 46 72 65 65 28 64 62 29 3b 0a 20 20 20 20 73 71  Free(db);.    sq
3850: 6c 69 74 65 33 53 74 72 52 65 61 6c 6c 6f 63 28  lite3StrRealloc(
3860: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 72  pzErrMsg);.    r
3870: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 64  eturn 0;.  }.  d
3880: 62 2d 3e 61 44 62 5b 30 5d 2e 7a 4e 61 6d 65 20  b->aDb[0].zName 
3890: 3d 20 22 6d 61 69 6e 22 3b 0a 20 20 64 62 2d 3e  = "main";.  db->
38a0: 61 44 62 5b 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22  aDb[1].zName = "
38b0: 74 65 6d 70 22 3b 0a 0a 20 20 2f 2a 20 41 74 74  temp";..  /* Att
38c0: 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 65  empt to read the
38d0: 20 73 63 68 65 6d 61 20 2a 2f 0a 20 20 73 71 6c   schema */.  sql
38e0: 69 74 65 33 52 65 67 69 73 74 65 72 42 75 69 6c  ite3RegisterBuil
38f0: 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 64 62 29  tinFunctions(db)
3900: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  ;.  rc = sqlite3
3910: 49 6e 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73  Init(db, pzErrMs
3920: 67 29 3b 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20  g);.  db->magic 
3930: 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f  = SQLITE_MAGIC_O
3940: 50 45 4e 3b 0a 20 20 69 66 28 20 73 71 6c 69 74  PEN;.  if( sqlit
3950: 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64  e3_malloc_failed
3960: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
3970: 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 67  close(db);.    g
3980: 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70  oto no_mem_on_op
3990: 65 6e 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  en;.  }else if( 
39a0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc!=SQLITE_OK &&
39b0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 42 55 53 59   rc!=SQLITE_BUSY
39c0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
39d0: 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 73  close(db);.    s
39e0: 71 6c 69 74 65 33 53 74 72 52 65 61 6c 6c 6f 63  qlite3StrRealloc
39f0: 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  (pzErrMsg);.    
3a00: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 65 6c 73  return 0;.  }els
3a10: 65 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29  e if( pzErrMsg )
3a20: 7b 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65  {.    sqliteFree
3a30: 28 2a 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  (*pzErrMsg);.   
3a40: 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a   *pzErrMsg = 0;.
3a50: 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 74 75 72 6e    }..  /* Return
3a60: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68   a pointer to th
3a70: 65 20 6e 65 77 6c 79 20 6f 70 65 6e 65 64 20 64  e newly opened d
3a80: 61 74 61 62 61 73 65 20 73 74 72 75 63 74 75 72  atabase structur
3a90: 65 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 64 62  e */.  return db
3aa0: 3b 0a 0a 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65  ;..no_mem_on_ope
3ab0: 6e 3a 0a 20 20 73 71 6c 69 74 65 33 53 65 74 53  n:.  sqlite3SetS
3ac0: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
3ad0: 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c  "out of memory",
3ae0: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 73 71   (char*)0);.  sq
3af0: 6c 69 74 65 33 53 74 72 52 65 61 6c 6c 6f 63 28  lite3StrRealloc(
3b00: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74  pzErrMsg);.  ret
3b10: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
3b20: 52 65 74 75 72 6e 20 74 68 65 20 52 4f 57 49 44  Return the ROWID
3b30: 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63   of the most rec
3b40: 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f 0a 69 6e  ent insert.*/.in
3b50: 74 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69  t sqlite3_last_i
3b60: 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69  nsert_rowid(sqli
3b70: 74 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72  te *db){.  retur
3b80: 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b  n db->lastRowid;
3b90: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
3ba0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63   the number of c
3bb0: 68 61 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f  hanges in the mo
3bc0: 73 74 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74  st recent call t
3bd0: 6f 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29  o sqlite3_exec()
3be0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
3bf0: 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 20  _changes(sqlite 
3c00: 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64  *db){.  return d
3c10: 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f  b->nChange;.}../
3c20: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
3c30: 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65  number of change
3c40: 73 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68  s produced by th
3c50: 65 20 6c 61 73 74 20 49 4e 53 45 52 54 2c 20 55  e last INSERT, U
3c60: 50 44 41 54 45 2c 20 6f 72 0a 2a 2a 20 44 45 4c  PDATE, or.** DEL
3c70: 45 54 45 20 73 74 61 74 65 6d 65 6e 74 20 74 6f  ETE statement to
3c80: 20 63 6f 6d 70 6c 65 74 65 20 65 78 65 63 75 74   complete execut
3c90: 69 6f 6e 2e 20 54 68 65 20 63 6f 75 6e 74 20 64  ion. The count d
3ca0: 6f 65 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 0a  oes not include.
3cb0: 2a 2a 20 63 68 61 6e 67 65 73 20 64 75 65 20 74  ** changes due t
3cc0: 6f 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73  o SQL statements
3cd0: 20 65 78 65 63 75 74 65 64 20 69 6e 20 74 72 69   executed in tri
3ce0: 67 67 65 72 20 70 72 6f 67 72 61 6d 73 20 74 68  gger programs th
3cf0: 61 74 20 77 65 72 65 0a 2a 2a 20 74 72 69 67 67  at were.** trigg
3d00: 65 72 65 64 20 62 79 20 74 68 61 74 20 73 74 61  ered by that sta
3d10: 74 65 6d 65 6e 74 0a 2a 2f 0a 69 6e 74 20 73 71  tement.*/.int sq
3d20: 6c 69 74 65 33 5f 6c 61 73 74 5f 73 74 61 74 65  lite3_last_state
3d30: 6d 65 6e 74 5f 63 68 61 6e 67 65 73 28 73 71 6c  ment_changes(sql
3d40: 69 74 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75  ite *db){.  retu
3d50: 72 6e 20 64 62 2d 3e 6c 73 43 68 61 6e 67 65 3b  rn db->lsChange;
3d60: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20  .}../*.** Close 
3d70: 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69  an existing SQLi
3d80: 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 76  te database.*/.v
3d90: 6f 69 64 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73  oid sqlite3_clos
3da0: 65 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20  e(sqlite *db){. 
3db0: 20 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 20   HashElem *i;.  
3dc0: 69 6e 74 20 6a 3b 0a 20 20 64 62 2d 3e 77 61 6e  int j;.  db->wan
3dd0: 74 5f 74 6f 5f 63 6c 6f 73 65 20 3d 20 31 3b 0a  t_to_close = 1;.
3de0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66    if( sqlite3Saf
3df0: 65 74 79 43 68 65 63 6b 28 64 62 29 20 7c 7c 20  etyCheck(db) || 
3e00: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
3e10: 64 62 29 20 29 7b 0a 20 20 20 20 2f 2a 20 70 72  db) ){.    /* pr
3e20: 69 6e 74 66 28 22 44 49 44 20 4e 4f 54 20 43 4c  intf("DID NOT CL
3e30: 4f 53 45 5c 6e 22 29 3b 20 66 66 6c 75 73 68 28  OSE\n"); fflush(
3e40: 73 74 64 6f 75 74 29 3b 20 2a 2f 0a 20 20 20 20  stdout); */.    
3e50: 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 64 62  return;.  }.  db
3e60: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
3e70: 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20  _MAGIC_CLOSED;. 
3e80: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e   for(j=0; j<db->
3e90: 6e 44 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 73  nDb; j++){.    s
3ea0: 74 72 75 63 74 20 44 62 20 2a 70 44 62 20 3d 20  truct Db *pDb = 
3eb0: 26 64 62 2d 3e 61 44 62 5b 6a 5d 3b 0a 20 20 20  &db->aDb[j];.   
3ec0: 20 69 66 28 20 70 44 62 2d 3e 70 42 74 20 29 7b   if( pDb->pBt ){
3ed0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74  .      sqlite3Bt
3ee0: 72 65 65 43 6c 6f 73 65 28 70 44 62 2d 3e 70 42  reeClose(pDb->pB
3ef0: 74 29 3b 0a 20 20 20 20 20 20 70 44 62 2d 3e 70  t);.      pDb->p
3f00: 42 74 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20  Bt = 0;.    }.  
3f10: 7d 0a 20 20 73 71 6c 69 74 65 33 52 65 73 65 74  }.  sqlite3Reset
3f20: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64  InternalSchema(d
3f30: 62 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28  b, 0);.  assert(
3f40: 20 64 62 2d 3e 6e 44 62 3c 3d 32 20 29 3b 0a 20   db->nDb<=2 );. 
3f50: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 61 44 62   assert( db->aDb
3f60: 3d 3d 64 62 2d 3e 61 44 62 53 74 61 74 69 63 20  ==db->aDbStatic 
3f70: 29 3b 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69 74  );.  for(i=sqlit
3f80: 65 48 61 73 68 46 69 72 73 74 28 26 64 62 2d 3e  eHashFirst(&db->
3f90: 61 46 75 6e 63 29 3b 20 69 3b 20 69 3d 73 71 6c  aFunc); i; i=sql
3fa0: 69 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b  iteHashNext(i)){
3fb0: 0a 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70 46  .    FuncDef *pF
3fc0: 75 6e 63 2c 20 2a 70 4e 65 78 74 3b 0a 20 20 20  unc, *pNext;.   
3fd0: 20 66 6f 72 28 70 46 75 6e 63 20 3d 20 28 46 75   for(pFunc = (Fu
3fe0: 6e 63 44 65 66 2a 29 73 71 6c 69 74 65 48 61 73  ncDef*)sqliteHas
3ff0: 68 44 61 74 61 28 69 29 3b 20 70 46 75 6e 63 3b  hData(i); pFunc;
4000: 20 70 46 75 6e 63 3d 70 4e 65 78 74 29 7b 0a 20   pFunc=pNext){. 
4010: 20 20 20 20 20 70 4e 65 78 74 20 3d 20 70 46 75       pNext = pFu
4020: 6e 63 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20  nc->pNext;.     
4030: 20 73 71 6c 69 74 65 46 72 65 65 28 70 46 75 6e   sqliteFree(pFun
4040: 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  c);.    }.  }.  
4050: 73 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72  sqlite3HashClear
4060: 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20  (&db->aFunc);.  
4070: 73 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b 0a  sqliteFree(db);.
4080: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63  }../*.** Rollbac
4090: 6b 20 61 6c 6c 20 64 61 74 61 62 61 73 65 20 66  k all database f
40a0: 69 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  iles..*/.void sq
40b0: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c  lite3RollbackAll
40c0: 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20  (sqlite *db){.  
40d0: 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30  int i;.  for(i=0
40e0: 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b  ; i<db->nDb; i++
40f0: 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61  ){.    if( db->a
4100: 44 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20 20 20  Db[i].pBt ){.   
4110: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52     sqlite3BtreeR
4120: 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44 62 5b  ollback(db->aDb[
4130: 69 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20 20 64  i].pBt);.      d
4140: 62 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72 61 6e  b->aDb[i].inTran
4150: 73 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d  s = 0;.    }.  }
4160: 0a 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49  .  sqlite3ResetI
4170: 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62  nternalSchema(db
4180: 2c 20 30 29 3b 0a 20 20 2f 2a 20 73 71 6c 69 74  , 0);.  /* sqlit
4190: 65 33 52 6f 6c 6c 62 61 63 6b 49 6e 74 65 72 6e  e3RollbackIntern
41a0: 61 6c 43 68 61 6e 67 65 73 28 64 62 29 3b 20 2a  alChanges(db); *
41b0: 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75  /.}../*.** Execu
41c0: 74 65 20 53 51 4c 20 63 6f 64 65 2e 20 20 52 65  te SQL code.  Re
41d0: 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20  turn one of the 
41e0: 53 51 4c 49 54 45 5f 20 73 75 63 63 65 73 73 2f  SQLITE_ success/
41f0: 66 61 69 6c 75 72 65 0a 2a 2a 20 63 6f 64 65 73  failure.** codes
4200: 2e 20 20 41 6c 73 6f 20 77 72 69 74 65 20 61 6e  .  Also write an
4210: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69   error message i
4220: 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69  nto memory obtai
4230: 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 6d 61 6c 6c  ned from.** mall
4240: 6f 63 28 29 20 61 6e 64 20 6d 61 6b 65 20 2a 70  oc() and make *p
4250: 7a 45 72 72 4d 73 67 20 70 6f 69 6e 74 20 74 6f  zErrMsg point to
4260: 20 74 68 61 74 20 6d 65 73 73 61 67 65 2e 0a 2a   that message..*
4270: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 53 51 4c 20  *.** If the SQL 
4280: 69 73 20 61 20 71 75 65 72 79 2c 20 74 68 65 6e  is a query, then
4290: 20 66 6f 72 20 65 61 63 68 20 72 6f 77 20 69 6e   for each row in
42a0: 20 74 68 65 20 71 75 65 72 79 20 72 65 73 75 6c   the query resul
42b0: 74 0a 2a 2a 20 74 68 65 20 78 43 61 6c 6c 62 61  t.** the xCallba
42c0: 63 6b 28 29 20 66 75 6e 63 74 69 6f 6e 20 69 73  ck() function is
42d0: 20 63 61 6c 6c 65 64 2e 20 20 70 41 72 67 20 62   called.  pArg b
42e0: 65 63 6f 6d 65 73 20 74 68 65 20 66 69 72 73 74  ecomes the first
42f0: 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  .** argument to 
4300: 78 43 61 6c 6c 62 61 63 6b 28 29 2e 20 20 49 66  xCallback().  If
4310: 20 78 43 61 6c 6c 62 61 63 6b 3d 4e 55 4c 4c 20   xCallback=NULL 
4320: 74 68 65 6e 20 6e 6f 20 63 61 6c 6c 62 61 63 6b  then no callback
4330: 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20  .** is invoked, 
4340: 65 76 65 6e 20 66 6f 72 20 71 75 65 72 69 65 73  even for queries
4350: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
4360: 5f 65 78 65 63 28 0a 20 20 73 71 6c 69 74 65 20  _exec(.  sqlite 
4370: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
4380: 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61       /* The data
4390: 62 61 73 65 20 6f 6e 20 77 68 69 63 68 20 74 68  base on which th
43a0: 65 20 53 51 4c 20 65 78 65 63 75 74 65 73 20 2a  e SQL executes *
43b0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
43c0: 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 20 20  zSql,           
43d0: 2f 2a 20 54 68 65 20 53 51 4c 20 74 6f 20 62 65  /* The SQL to be
43e0: 20 65 78 65 63 75 74 65 64 20 2a 2f 0a 20 20 73   executed */.  s
43f0: 71 6c 69 74 65 5f 63 61 6c 6c 62 61 63 6b 20 78  qlite_callback x
4400: 43 61 6c 6c 62 61 63 6b 2c 20 20 2f 2a 20 49 6e  Callback,  /* In
4410: 76 6f 6b 65 20 74 68 69 73 20 63 61 6c 6c 62 61  voke this callba
4420: 63 6b 20 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20  ck routine */.  
4430: 76 6f 69 64 20 2a 70 41 72 67 2c 20 20 20 20 20  void *pArg,     
4440: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46              /* F
4450: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f  irst argument to
4460: 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 2a 2f 0a   xCallback() */.
4470: 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73    char **pzErrMs
4480: 67 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  g             /*
4490: 20 57 72 69 74 65 20 65 72 72 6f 72 20 6d 65 73   Write error mes
44a0: 73 61 67 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b  sages here */.){
44b0: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
44c0: 54 45 5f 4f 4b 3b 0a 20 20 63 6f 6e 73 74 20 63  TE_OK;.  const c
44d0: 68 61 72 20 2a 7a 4c 65 66 74 6f 76 65 72 3b 0a  har *zLeftover;.
44e0: 20 20 73 71 6c 69 74 65 5f 76 6d 20 2a 70 56 6d    sqlite_vm *pVm
44f0: 3b 0a 20 20 69 6e 74 20 6e 52 65 74 72 79 20 3d  ;.  int nRetry =
4500: 20 30 3b 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67   0;.  int nChang
4510: 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 43 61  e = 0;.  int nCa
4520: 6c 6c 62 61 63 6b 3b 0a 0a 20 20 69 66 28 20 7a  llback;..  if( z
4530: 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  Sql==0 ) return 
4540: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 77 68 69  SQLITE_OK;.  whi
4550: 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  le( rc==SQLITE_O
4560: 4b 20 26 26 20 7a 53 71 6c 5b 30 5d 20 29 7b 0a  K && zSql[0] ){.
4570: 20 20 20 20 70 56 6d 20 3d 20 30 3b 0a 20 20 20      pVm = 0;.   
4580: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f   rc = sqlite3_co
4590: 6d 70 69 6c 65 28 64 62 2c 20 7a 53 71 6c 2c 20  mpile(db, zSql, 
45a0: 26 7a 4c 65 66 74 6f 76 65 72 2c 20 26 70 56 6d  &zLeftover, &pVm
45b0: 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  , pzErrMsg);.   
45c0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
45d0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65  OK ){.      asse
45e0: 72 74 28 20 70 56 6d 3d 3d 30 20 7c 7c 20 73 71  rt( pVm==0 || sq
45f0: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69  lite3_malloc_fai
4600: 6c 65 64 20 29 3b 0a 20 20 20 20 20 20 72 65 74  led );.      ret
4610: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20  urn rc;.    }.  
4620: 20 20 69 66 28 20 70 56 6d 3d 3d 30 20 29 7b 0a    if( pVm==0 ){.
4630: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 68 61        /* This ha
4640: 70 70 65 6e 73 20 69 66 20 74 68 65 20 7a 53 71  ppens if the zSq
4650: 6c 20 69 6e 70 75 74 20 63 6f 6e 74 61 69 6e 65  l input containe
4660: 64 20 6f 6e 6c 79 20 77 68 69 74 65 73 70 61 63  d only whitespac
4670: 65 20 2a 2f 0a 20 20 20 20 20 20 62 72 65 61 6b  e */.      break
4680: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e  ;.    }.    db->
4690: 6e 43 68 61 6e 67 65 20 2b 3d 20 6e 43 68 61 6e  nChange += nChan
46a0: 67 65 3b 0a 20 20 20 20 6e 43 61 6c 6c 62 61 63  ge;.    nCallbac
46b0: 6b 20 3d 20 30 3b 0a 20 20 20 20 77 68 69 6c 65  k = 0;.    while
46c0: 28 31 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e  (1){.      int n
46d0: 41 72 67 3b 0a 20 20 20 20 20 20 63 68 61 72 20  Arg;.      char 
46e0: 2a 2a 61 7a 41 72 67 2c 20 2a 2a 61 7a 43 6f 6c  **azArg, **azCol
46f0: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  ;.      rc = sql
4700: 69 74 65 33 5f 73 74 65 70 28 70 56 6d 2c 20 26  ite3_step(pVm, &
4710: 6e 41 72 67 2c 20 28 63 6f 6e 73 74 20 63 68 61  nArg, (const cha
4720: 72 2a 2a 2a 29 26 61 7a 41 72 67 2c 28 63 6f 6e  r***)&azArg,(con
4730: 73 74 20 63 68 61 72 2a 2a 2a 29 26 61 7a 43 6f  st char***)&azCo
4740: 6c 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  l);.      if( rc
4750: 3d 3d 53 51 4c 49 54 45 5f 52 4f 57 20 29 7b 0a  ==SQLITE_ROW ){.
4760: 20 20 20 20 20 20 20 20 69 66 28 20 78 43 61 6c          if( xCal
4770: 6c 62 61 63 6b 21 3d 30 20 26 26 20 78 43 61 6c  lback!=0 && xCal
4780: 6c 62 61 63 6b 28 70 41 72 67 2c 20 6e 41 72 67  lback(pArg, nArg
4790: 2c 20 61 7a 41 72 67 2c 20 61 7a 43 6f 6c 29 20  , azArg, azCol) 
47a0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  ){.          sql
47b0: 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 70 56  ite3_finalize(pV
47c0: 6d 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20  m, 0);.         
47d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 41   return SQLITE_A
47e0: 42 4f 52 54 3b 0a 20 20 20 20 20 20 20 20 7d 0a  BORT;.        }.
47f0: 20 20 20 20 20 20 20 20 6e 43 61 6c 6c 62 61 63          nCallbac
4800: 6b 2b 2b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65  k++;.      }else
4810: 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63  {.        if( rc
4820: 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 26 26  ==SQLITE_DONE &&
4830: 20 6e 43 61 6c 6c 62 61 63 6b 3d 3d 30 0a 20 20   nCallback==0.  
4840: 20 20 20 20 20 20 20 20 26 26 20 28 64 62 2d 3e          && (db->
4850: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4e  flags & SQLITE_N
4860: 75 6c 6c 43 61 6c 6c 62 61 63 6b 29 21 3d 30 20  ullCallback)!=0 
4870: 26 26 20 78 43 61 6c 6c 62 61 63 6b 21 3d 30 20  && xCallback!=0 
4880: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 78 43 61  ){.          xCa
4890: 6c 6c 62 61 63 6b 28 70 41 72 67 2c 20 6e 41 72  llback(pArg, nAr
48a0: 67 2c 20 61 7a 41 72 67 2c 20 61 7a 43 6f 6c 29  g, azArg, azCol)
48b0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
48c0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
48d0: 5f 66 69 6e 61 6c 69 7a 65 28 70 56 6d 2c 20 70  _finalize(pVm, p
48e0: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20  zErrMsg);.      
48f0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
4900: 5f 53 43 48 45 4d 41 20 26 26 20 6e 52 65 74 72  _SCHEMA && nRetr
4910: 79 3c 32 20 29 7b 0a 20 20 20 20 20 20 20 20 20  y<2 ){.         
4920: 20 6e 52 65 74 72 79 2b 2b 3b 0a 20 20 20 20 20   nRetry++;.     
4930: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45       rc = SQLITE
4940: 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 62  _OK;.          b
4950: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a  reak;.        }.
4960: 20 20 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e          if( db->
4970: 70 56 64 62 65 3d 3d 30 20 29 7b 0a 20 20 20 20  pVdbe==0 ){.    
4980: 20 20 20 20 20 20 6e 43 68 61 6e 67 65 20 3d 20        nChange = 
4990: 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a 20 20 20  db->nChange;.   
49a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 6e       }.        n
49b0: 52 65 74 72 79 20 3d 20 30 3b 0a 20 20 20 20 20  Retry = 0;.     
49c0: 20 20 20 7a 53 71 6c 20 3d 20 7a 4c 65 66 74 6f     zSql = zLefto
49d0: 76 65 72 3b 0a 20 20 20 20 20 20 20 20 77 68 69  ver;.        whi
49e0: 6c 65 28 20 69 73 73 70 61 63 65 28 7a 53 71 6c  le( isspace(zSql
49f0: 5b 30 5d 29 20 29 20 7a 53 71 6c 2b 2b 3b 0a 20  [0]) ) zSql++;. 
4a00: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
4a10: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
4a20: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
4a30: 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 61  ./*.** Compile a
4a40: 20 73 69 6e 67 6c 65 20 73 74 61 74 65 6d 65 6e   single statemen
4a50: 74 20 6f 66 20 53 51 4c 20 69 6e 74 6f 20 61 20  t of SQL into a 
4a60: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e  virtual machine.
4a70: 20 20 52 65 74 75 72 6e 20 6f 6e 65 0a 2a 2a 20    Return one.** 
4a80: 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20 73  of the SQLITE_ s
4a90: 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20 63  uccess/failure c
4aa0: 6f 64 65 73 2e 20 20 41 6c 73 6f 20 77 72 69 74  odes.  Also writ
4ab0: 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61  e an error messa
4ac0: 67 65 20 69 6e 74 6f 0a 2a 2a 20 6d 65 6d 6f 72  ge into.** memor
4ad0: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20  y obtained from 
4ae0: 6d 61 6c 6c 6f 63 28 29 20 61 6e 64 20 6d 61 6b  malloc() and mak
4af0: 65 20 2a 70 7a 45 72 72 4d 73 67 20 70 6f 69 6e  e *pzErrMsg poin
4b00: 74 20 74 6f 20 74 68 61 74 20 6d 65 73 73 61 67  t to that messag
4b10: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
4b20: 33 5f 63 6f 6d 70 69 6c 65 28 0a 20 20 73 71 6c  3_compile(.  sql
4b30: 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20  ite *db,        
4b40: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
4b50: 64 61 74 61 62 61 73 65 20 6f 6e 20 77 68 69 63  database on whic
4b60: 68 20 74 68 65 20 53 51 4c 20 65 78 65 63 75 74  h the SQL execut
4b70: 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  es */.  const ch
4b80: 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20  ar *zSql,       
4b90: 20 20 20 20 2f 2a 20 54 68 65 20 53 51 4c 20 74      /* The SQL t
4ba0: 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 2a 2f  o be executed */
4bb0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a  .  const char **
4bc0: 70 7a 54 61 69 6c 2c 20 20 20 20 20 20 20 20 2f  pzTail,        /
4bd0: 2a 20 4f 55 54 3a 20 4e 65 78 74 20 73 74 61 74  * OUT: Next stat
4be0: 65 6d 65 6e 74 20 61 66 74 65 72 20 74 68 65 20  ement after the 
4bf0: 66 69 72 73 74 20 2a 2f 0a 20 20 73 71 6c 69 74  first */.  sqlit
4c00: 65 5f 76 6d 20 2a 2a 70 70 56 6d 2c 20 20 20 20  e_vm **ppVm,    
4c10: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54         /* OUT: T
4c20: 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  he virtual machi
4c30: 6e 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70  ne */.  char **p
4c40: 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 20 20  zErrMsg         
4c50: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 57 72 69 74      /* OUT: Writ
4c60: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73  e error messages
4c70: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 50 61   here */.){.  Pa
4c80: 72 73 65 20 73 50 61 72 73 65 3b 0a 0a 20 20 69  rse sParse;..  i
4c90: 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20 2a 70  f( pzErrMsg ) *p
4ca0: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69  zErrMsg = 0;.  i
4cb0: 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79  f( sqlite3Safety
4cc0: 4f 6e 28 64 62 29 20 29 20 67 6f 74 6f 20 65 78  On(db) ) goto ex
4cd0: 65 63 5f 6d 69 73 75 73 65 3b 0a 20 20 69 66 28  ec_misuse;.  if(
4ce0: 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20   !db->init.busy 
4cf0: 29 7b 0a 20 20 20 20 69 66 28 20 28 64 62 2d 3e  ){.    if( (db->
4d00: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49  flags & SQLITE_I
4d10: 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29  nitialized)==0 )
4d20: 7b 0a 20 20 20 20 20 20 69 6e 74 20 72 63 2c 20  {.      int rc, 
4d30: 63 6e 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 77  cnt = 1;.      w
4d40: 68 69 6c 65 28 20 28 72 63 20 3d 20 73 71 6c 69  hile( (rc = sqli
4d50: 74 65 33 49 6e 69 74 28 64 62 2c 20 70 7a 45 72  te3Init(db, pzEr
4d60: 72 4d 73 67 29 29 3d 3d 53 51 4c 49 54 45 5f 42  rMsg))==SQLITE_B
4d70: 55 53 59 0a 20 20 20 20 20 20 20 20 20 26 26 20  USY.         && 
4d80: 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c 62 61 63  db->xBusyCallbac
4d90: 6b 0a 20 20 20 20 20 20 20 20 20 26 26 20 64 62  k.         && db
4da0: 2d 3e 78 42 75 73 79 43 61 6c 6c 62 61 63 6b 28  ->xBusyCallback(
4db0: 64 62 2d 3e 70 42 75 73 79 41 72 67 2c 20 22 22  db->pBusyArg, ""
4dc0: 2c 20 63 6e 74 2b 2b 29 21 3d 30 20 29 7b 7d 0a  , cnt++)!=0 ){}.
4dd0: 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51        if( rc!=SQ
4de0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
4df0: 20 20 20 73 71 6c 69 74 65 33 53 74 72 52 65 61     sqlite3StrRea
4e00: 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a  lloc(pzErrMsg);.
4e10: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 53          sqlite3S
4e20: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20  afetyOff(db);.  
4e30: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
4e40: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69  .      }.      i
4e50: 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a 20  f( pzErrMsg ){. 
4e60: 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65         sqliteFre
4e70: 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  e(*pzErrMsg);.  
4e80: 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20        *pzErrMsg 
4e90: 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  = 0;.      }.   
4ea0: 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28   }.  }.  assert(
4eb0: 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51   (db->flags & SQ
4ec0: 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64  LITE_Initialized
4ed0: 29 21 3d 30 20 7c 7c 20 64 62 2d 3e 69 6e 69 74  )!=0 || db->init
4ee0: 2e 62 75 73 79 20 29 3b 0a 20 20 69 66 28 20 64  .busy );.  if( d
4ef0: 62 2d 3e 70 56 64 62 65 3d 3d 30 20 29 7b 20 64  b->pVdbe==0 ){ d
4f00: 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b 20  b->nChange = 0; 
4f10: 7d 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72  }.  memset(&sPar
4f20: 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 50  se, 0, sizeof(sP
4f30: 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72 73 65  arse));.  sParse
4f40: 2e 64 62 20 3d 20 64 62 3b 0a 20 20 73 71 6c 69  .db = db;.  sqli
4f50: 74 65 33 52 75 6e 50 61 72 73 65 72 28 26 73 50  te3RunParser(&sP
4f60: 61 72 73 65 2c 20 7a 53 71 6c 2c 20 70 7a 45 72  arse, zSql, pzEr
4f70: 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 64 62 2d  rMsg);.  if( db-
4f80: 3e 78 54 72 61 63 65 20 26 26 20 21 64 62 2d 3e  >xTrace && !db->
4f90: 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20 20  init.busy ){.   
4fa0: 20 2f 2a 20 54 72 61 63 65 20 6f 6e 6c 79 20 74   /* Trace only t
4fb0: 68 65 20 73 74 61 74 6d 65 6e 74 20 74 68 61 74  he statment that
4fc0: 20 77 61 73 20 63 6f 6d 70 69 6c 65 64 2e 0a 20   was compiled.. 
4fd0: 20 20 20 2a 2a 20 4d 61 6b 65 20 61 20 63 6f 70     ** Make a cop
4fe0: 79 20 6f 66 20 74 68 61 74 20 70 61 72 74 20 6f  y of that part o
4ff0: 66 20 74 68 65 20 53 51 4c 20 73 74 72 69 6e 67  f the SQL string
5000: 20 73 69 6e 63 65 20 7a 53 51 4c 20 69 73 20 63   since zSQL is c
5010: 6f 6e 73 74 0a 20 20 20 20 2a 2a 20 61 6e 64 20  onst.    ** and 
5020: 77 65 20 6d 75 73 74 20 70 61 73 73 20 61 20 7a  we must pass a z
5030: 65 72 6f 20 74 65 72 6d 69 6e 61 74 65 64 20 73  ero terminated s
5040: 74 72 69 6e 67 20 74 6f 20 74 68 65 20 74 72 61  tring to the tra
5050: 63 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20  ce function.    
5060: 2a 2a 20 54 68 65 20 63 6f 70 79 20 69 73 20 75  ** The copy is u
5070: 6e 6e 65 63 65 73 73 61 72 79 20 69 66 20 74 68  nnecessary if th
5080: 65 20 74 61 69 6c 20 70 6f 69 6e 74 65 72 20 69  e tail pointer i
5090: 73 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 74 68  s pointing at th
50a0: 65 0a 20 20 20 20 2a 2a 20 62 65 67 69 6e 6e 69  e.    ** beginni
50b0: 67 20 6f 72 20 65 6e 64 20 6f 66 20 74 68 65 20  g or end of the 
50c0: 53 51 4c 20 73 74 72 69 6e 67 2e 0a 20 20 20 20  SQL string..    
50d0: 2a 2f 0a 20 20 20 20 69 66 28 20 73 50 61 72 73  */.    if( sPars
50e0: 65 2e 7a 54 61 69 6c 20 26 26 20 73 50 61 72 73  e.zTail && sPars
50f0: 65 2e 7a 54 61 69 6c 21 3d 7a 53 71 6c 20 26 26  e.zTail!=zSql &&
5100: 20 2a 73 50 61 72 73 65 2e 7a 54 61 69 6c 20 29   *sParse.zTail )
5110: 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 74 6d  {.      char *tm
5120: 70 53 71 6c 20 3d 20 73 71 6c 69 74 65 53 74 72  pSql = sqliteStr
5130: 4e 44 75 70 28 7a 53 71 6c 2c 20 73 50 61 72 73  NDup(zSql, sPars
5140: 65 2e 7a 54 61 69 6c 20 2d 20 7a 53 71 6c 29 3b  e.zTail - zSql);
5150: 0a 20 20 20 20 20 20 69 66 28 20 74 6d 70 53 71  .      if( tmpSq
5160: 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 64 62 2d  l ){.        db-
5170: 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54 72 61  >xTrace(db->pTra
5180: 63 65 41 72 67 2c 20 74 6d 70 53 71 6c 29 3b 0a  ceArg, tmpSql);.
5190: 20 20 20 20 20 20 20 20 66 72 65 65 28 74 6d 70          free(tmp
51a0: 53 71 6c 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73  Sql);.      }els
51b0: 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66  e{.        /* If
51c0: 20 61 20 6d 65 6d 6f 72 79 20 65 72 72 6f 72 20   a memory error 
51d0: 6f 63 63 75 72 72 65 64 20 64 75 72 69 6e 67 20  occurred during 
51e0: 74 68 65 20 63 6f 70 79 2c 0a 20 20 20 20 20 20  the copy,.      
51f0: 20 20 2a 2a 20 74 72 61 63 65 20 65 6e 74 69 72    ** trace entir
5200: 65 20 53 51 4c 20 73 74 72 69 6e 67 20 61 6e 64  e SQL string and
5210: 20 66 61 6c 6c 20 74 68 72 6f 75 67 68 20 74 6f   fall through to
5220: 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20   the.        ** 
5230: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
5240: 61 69 6c 65 64 20 74 65 73 74 20 74 6f 20 72 65  ailed test to re
5250: 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72 2e 0a  port the error..
5260: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20          */.     
5270: 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28 64 62     db->xTrace(db
5280: 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 7a 53 71  ->pTraceArg, zSq
5290: 6c 29 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20  l); .      }.   
52a0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 64 62   }else{.      db
52b0: 2d 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54 72  ->xTrace(db->pTr
52c0: 61 63 65 41 72 67 2c 20 7a 53 71 6c 29 3b 20 0a  aceArg, zSql); .
52d0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20      }.  }.  if( 
52e0: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
52f0: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 71 6c  ailed ){.    sql
5300: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a  ite3SetString(pz
5310: 45 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20  ErrMsg, "out of 
5320: 6d 65 6d 6f 72 79 22 2c 20 28 63 68 61 72 2a 29  memory", (char*)
5330: 30 29 3b 0a 20 20 20 20 73 50 61 72 73 65 2e 72  0);.    sParse.r
5340: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
5350: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 6f 6c  ;.    sqlite3Rol
5360: 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b 0a 20 20  lbackAll(db);.  
5370: 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e    sqlite3ResetIn
5380: 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c  ternalSchema(db,
5390: 20 30 29 3b 0a 20 20 20 20 64 62 2d 3e 66 6c 61   0);.    db->fla
53a0: 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e  gs &= ~SQLITE_In
53b0: 54 72 61 6e 73 3b 0a 20 20 7d 0a 20 20 69 66 28  Trans;.  }.  if(
53c0: 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49   sParse.rc==SQLI
53d0: 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65  TE_DONE ) sParse
53e0: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  .rc = SQLITE_OK;
53f0: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 72 63  .  if( sParse.rc
5400: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70  !=SQLITE_OK && p
5410: 7a 45 72 72 4d 73 67 20 26 26 20 2a 70 7a 45 72  zErrMsg && *pzEr
5420: 72 4d 73 67 3d 3d 30 20 29 7b 0a 20 20 20 20 73  rMsg==0 ){.    s
5430: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28  qlite3SetString(
5440: 70 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65  pzErrMsg, sqlite
5450: 33 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 73  3_error_string(s
5460: 50 61 72 73 65 2e 72 63 29 2c 20 28 63 68 61 72  Parse.rc), (char
5470: 2a 29 30 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  *)0);.  }.  sqli
5480: 74 65 33 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a  te3StrRealloc(pz
5490: 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 73  ErrMsg);.  if( s
54a0: 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49 54 45  Parse.rc==SQLITE
54b0: 5f 53 43 48 45 4d 41 20 29 7b 0a 20 20 20 20 73  _SCHEMA ){.    s
54c0: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72  qlite3ResetInter
54d0: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29  nalSchema(db, 0)
54e0: 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20  ;.  }.  assert( 
54f0: 70 70 56 6d 20 29 3b 0a 20 20 2a 70 70 56 6d 20  ppVm );.  *ppVm 
5500: 3d 20 28 73 71 6c 69 74 65 5f 76 6d 2a 29 73 50  = (sqlite_vm*)sP
5510: 61 72 73 65 2e 70 56 64 62 65 3b 0a 20 20 69 66  arse.pVdbe;.  if
5520: 28 20 70 7a 54 61 69 6c 20 29 20 2a 70 7a 54 61  ( pzTail ) *pzTa
5530: 69 6c 20 3d 20 73 50 61 72 73 65 2e 7a 54 61 69  il = sParse.zTai
5540: 6c 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  l;.  if( sqlite3
5550: 53 61 66 65 74 79 4f 66 66 28 64 62 29 20 29 20  SafetyOff(db) ) 
5560: 67 6f 74 6f 20 65 78 65 63 5f 6d 69 73 75 73 65  goto exec_misuse
5570: 3b 0a 20 20 72 65 74 75 72 6e 20 73 50 61 72 73  ;.  return sPars
5580: 65 2e 72 63 3b 0a 0a 65 78 65 63 5f 6d 69 73 75  e.rc;..exec_misu
5590: 73 65 3a 0a 20 20 69 66 28 20 70 7a 45 72 72 4d  se:.  if( pzErrM
55a0: 73 67 20 29 7b 0a 20 20 20 20 2a 70 7a 45 72 72  sg ){.    *pzErr
55b0: 4d 73 67 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c  Msg = 0;.    sql
55c0: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a  ite3SetString(pz
55d0: 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 33 5f  ErrMsg, sqlite3_
55e0: 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 53 51 4c  error_string(SQL
55f0: 49 54 45 5f 4d 49 53 55 53 45 29 2c 20 28 63 68  ITE_MISUSE), (ch
5600: 61 72 2a 29 30 29 3b 0a 20 20 20 20 73 71 6c 69  ar*)0);.    sqli
5610: 74 65 33 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a  te3StrRealloc(pz
5620: 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 72  ErrMsg);.  }.  r
5630: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
5640: 55 53 45 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54  USE;.}.../*.** T
5650: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75  he following rou
5660: 74 69 6e 65 20 64 65 73 74 72 6f 79 73 20 61 20  tine destroys a 
5670: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20  virtual machine 
5680: 74 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20  that is created 
5690: 62 79 0a 2a 2a 20 74 68 65 20 73 71 6c 69 74 65  by.** the sqlite
56a0: 33 5f 63 6f 6d 70 69 6c 65 28 29 20 72 6f 75 74  3_compile() rout
56b0: 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69  ine..**.** The i
56c0: 6e 74 65 67 65 72 20 72 65 74 75 72 6e 65 64 20  nteger returned 
56d0: 69 73 20 61 6e 20 53 51 4c 49 54 45 5f 20 73 75  is an SQLITE_ su
56e0: 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20 63 6f  ccess/failure co
56f0: 64 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65  de that describe
5700: 73 0a 2a 2a 20 74 68 65 20 72 65 73 75 6c 74 20  s.** the result 
5710: 6f 66 20 65 78 65 63 75 74 69 6e 67 20 74 68 65  of executing the
5720: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
5730: 2e 20 20 41 6e 20 65 72 72 6f 72 20 6d 65 73 73  .  An error mess
5740: 61 67 65 20 69 73 0a 2a 2a 20 77 72 69 74 74 65  age is.** writte
5750: 6e 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62  n into memory ob
5760: 74 61 69 6e 65 64 20 66 72 6f 6d 20 6d 61 6c 6c  tained from mall
5770: 6f 63 20 61 6e 64 20 2a 70 7a 45 72 72 4d 73 67  oc and *pzErrMsg
5780: 20 69 73 20 6d 61 64 65 20 74 6f 0a 2a 2a 20 70   is made to.** p
5790: 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 65 72 72  oint to that err
57a0: 6f 72 20 69 66 20 70 7a 45 72 72 4d 73 67 20 69  or if pzErrMsg i
57b0: 73 20 6e 6f 74 20 4e 55 4c 4c 2e 20 20 54 68 65  s not NULL.  The
57c0: 20 63 61 6c 6c 69 6e 67 20 72 6f 75 74 69 6e 65   calling routine
57d0: 0a 2a 2a 20 73 68 6f 75 6c 64 20 75 73 65 20 73  .** should use s
57e0: 71 6c 69 74 65 33 5f 66 72 65 65 6d 65 6d 28 29  qlite3_freemem()
57f0: 20 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6d   to delete the m
5800: 65 73 73 61 67 65 20 77 68 65 6e 20 69 74 20 68  essage when it h
5810: 61 73 20 66 69 6e 69 73 68 65 64 0a 2a 2a 20 77  as finished.** w
5820: 69 74 68 20 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73  ith it..*/.int s
5830: 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28  qlite3_finalize(
5840: 0a 20 20 73 71 6c 69 74 65 5f 76 6d 20 2a 70 56  .  sqlite_vm *pV
5850: 6d 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  m,            /*
5860: 20 54 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63   The virtual mac
5870: 68 69 6e 65 20 74 6f 20 62 65 20 64 65 73 74 72  hine to be destr
5880: 6f 79 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a  oyed */.  char *
5890: 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20  *pzErrMsg       
58a0: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 57 72 69       /* OUT: Wri
58b0: 74 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  te error message
58c0: 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69  s here */.){.  i
58d0: 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56  nt rc = sqlite3V
58e0: 64 62 65 46 69 6e 61 6c 69 7a 65 28 28 56 64 62  dbeFinalize((Vdb
58f0: 65 2a 29 70 56 6d 2c 20 70 7a 45 72 72 4d 73 67  e*)pVm, pzErrMsg
5900: 29 3b 0a 20 20 73 71 6c 69 74 65 33 53 74 72 52  );.  sqlite3StrR
5910: 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29  ealloc(pzErrMsg)
5920: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
5930: 0a 0a 2f 2a 0a 2a 2a 20 54 65 72 6d 69 6e 61 74  ../*.** Terminat
5940: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 65 78  e the current ex
5950: 65 63 75 74 69 6f 6e 20 6f 66 20 61 20 76 69 72  ecution of a vir
5960: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 68 65  tual machine the
5970: 6e 0a 2a 2a 20 72 65 73 65 74 20 74 68 65 20 76  n.** reset the v
5980: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 62  irtual machine b
5990: 61 63 6b 20 74 6f 20 69 74 73 20 73 74 61 72 74  ack to its start
59a0: 69 6e 67 20 73 74 61 74 65 20 73 6f 20 74 68 61  ing state so tha
59b0: 74 20 69 74 0a 2a 2a 20 63 61 6e 20 62 65 20 72  t it.** can be r
59c0: 65 75 73 65 64 2e 20 20 41 6e 79 20 65 72 72 6f  eused.  Any erro
59d0: 72 20 6d 65 73 73 61 67 65 20 72 65 73 75 6c 74  r message result
59e0: 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 70 72 69  ing from the pri
59f0: 6f 72 20 65 78 65 63 75 74 69 6f 6e 0a 2a 2a 20  or execution.** 
5a00: 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20  is written into 
5a10: 2a 70 7a 45 72 72 4d 73 67 2e 20 20 41 20 73 75  *pzErrMsg.  A su
5a20: 63 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d 20  ccess code from 
5a30: 74 68 65 20 70 72 69 6f 72 20 65 78 65 63 75 74  the prior execut
5a40: 69 6f 6e 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e  ion.** is return
5a50: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
5a60: 65 33 5f 72 65 73 65 74 28 0a 20 20 73 71 6c 69  e3_reset(.  sqli
5a70: 74 65 5f 76 6d 20 2a 70 56 6d 2c 20 20 20 20 20  te_vm *pVm,     
5a80: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 76 69         /* The vi
5a90: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 6f  rtual machine to
5aa0: 20 62 65 20 64 65 73 74 72 6f 79 65 64 20 2a 2f   be destroyed */
5ab0: 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d  .  char **pzErrM
5ac0: 73 67 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  sg            /*
5ad0: 20 4f 55 54 3a 20 57 72 69 74 65 20 65 72 72 6f   OUT: Write erro
5ae0: 72 20 6d 65 73 73 61 67 65 73 20 68 65 72 65 20  r messages here 
5af0: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  */.){.  int rc =
5b00: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73 65   sqlite3VdbeRese
5b10: 74 28 28 56 64 62 65 2a 29 70 56 6d 2c 20 70 7a  t((Vdbe*)pVm, pz
5b20: 45 72 72 4d 73 67 29 3b 0a 20 20 73 71 6c 69 74  ErrMsg);.  sqlit
5b30: 65 33 56 64 62 65 4d 61 6b 65 52 65 61 64 79 28  e3VdbeMakeReady(
5b40: 28 56 64 62 65 2a 29 70 56 6d 2c 20 2d 31 2c 20  (Vdbe*)pVm, -1, 
5b50: 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 53 74 72  0);.  sqlite3Str
5b60: 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67  Realloc(pzErrMsg
5b70: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
5b80: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
5b90: 61 20 73 74 61 74 69 63 20 73 74 72 69 6e 67 20  a static string 
5ba0: 74 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74  that describes t
5bb0: 68 65 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f 72  he kind of error
5bc0: 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68   specified in th
5bd0: 65 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a  e.** argument..*
5be0: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  /.const char *sq
5bf0: 6c 69 74 65 33 5f 65 72 72 6f 72 5f 73 74 72 69  lite3_error_stri
5c00: 6e 67 28 69 6e 74 20 72 63 29 7b 0a 20 20 63 6f  ng(int rc){.  co
5c10: 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 73  nst char *z;.  s
5c20: 77 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20 20  witch( rc ){.   
5c30: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a   case SQLITE_OK:
5c40: 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22 6e 6f           z = "no
5c50: 74 20 61 6e 20 65 72 72 6f 72 22 3b 20 20 20 20  t an error";    
5c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5c70: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5c80: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52   case SQLITE_ERR
5c90: 4f 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 53 51  OR:      z = "SQ
5ca0: 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72  L logic error or
5cb0: 20 6d 69 73 73 69 6e 67 20 64 61 74 61 62 61 73   missing databas
5cc0: 65 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  e";   break;.   
5cd0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54   case SQLITE_INT
5ce0: 45 52 4e 41 4c 3a 20 20 20 7a 20 3d 20 22 69 6e  ERNAL:   z = "in
5cf0: 74 65 72 6e 61 6c 20 53 51 4c 69 74 65 20 69 6d  ternal SQLite im
5d00: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66 6c 61  plementation fla
5d10: 77 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  w";   break;.   
5d20: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52   case SQLITE_PER
5d30: 4d 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61 63  M:       z = "ac
5d40: 63 65 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 20  cess permission 
5d50: 64 65 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20  denied";        
5d60: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5d70: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f   case SQLITE_ABO
5d80: 52 54 3a 20 20 20 20 20 20 7a 20 3d 20 22 63 61  RT:      z = "ca
5d90: 6c 6c 62 61 63 6b 20 72 65 71 75 65 73 74 65 64  llback requested
5da0: 20 71 75 65 72 79 20 61 62 6f 72 74 22 3b 20 20   query abort";  
5db0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5dc0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53   case SQLITE_BUS
5dd0: 59 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61  Y:       z = "da
5de0: 74 61 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64  tabase is locked
5df0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
5e00: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5e10: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43   case SQLITE_LOC
5e20: 4b 45 44 3a 20 20 20 20 20 7a 20 3d 20 22 64 61  KED:     z = "da
5e30: 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 73 20  tabase table is 
5e40: 6c 6f 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20  locked";        
5e50: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5e60: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d   case SQLITE_NOM
5e70: 45 4d 3a 20 20 20 20 20 20 7a 20 3d 20 22 6f 75  EM:      z = "ou
5e80: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 3b 20 20 20  t of memory";   
5e90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5ea0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5eb0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41   case SQLITE_REA
5ec0: 44 4f 4e 4c 59 3a 20 20 20 7a 20 3d 20 22 61 74  DONLY:   z = "at
5ed0: 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61  tempt to write a
5ee0: 20 72 65 61 64 6f 6e 6c 79 20 64 61 74 61 62 61   readonly databa
5ef0: 73 65 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20  se";  break;.   
5f00: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54   case SQLITE_INT
5f10: 45 52 52 55 50 54 3a 20 20 7a 20 3d 20 22 69 6e  ERRUPT:  z = "in
5f20: 74 65 72 72 75 70 74 65 64 22 3b 20 20 20 20 20  terrupted";     
5f30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5f40: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5f50: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45   case SQLITE_IOE
5f60: 52 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 64 69  RR:      z = "di
5f70: 73 6b 20 49 2f 4f 20 65 72 72 6f 72 22 3b 20 20  sk I/O error";  
5f80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5f90: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5fa0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52   case SQLITE_COR
5fb0: 52 55 50 54 3a 20 20 20 20 7a 20 3d 20 22 64 61  RUPT:    z = "da
5fc0: 74 61 62 61 73 65 20 64 69 73 6b 20 69 6d 61 67  tabase disk imag
5fd0: 65 20 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22 3b  e is malformed";
5fe0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
5ff0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54   case SQLITE_NOT
6000: 46 4f 55 4e 44 3a 20 20 20 7a 20 3d 20 22 74 61  FOUND:   z = "ta
6010: 62 6c 65 20 6f 72 20 72 65 63 6f 72 64 20 6e 6f  ble or record no
6020: 74 20 66 6f 75 6e 64 22 3b 20 20 20 20 20 20 20  t found";       
6030: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6040: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 55 4c   case SQLITE_FUL
6050: 4c 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61  L:       z = "da
6060: 74 61 62 61 73 65 20 69 73 20 66 75 6c 6c 22 3b  tabase is full";
6070: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6080: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6090: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e   case SQLITE_CAN
60a0: 54 4f 50 45 4e 3a 20 20 20 7a 20 3d 20 22 75 6e  TOPEN:   z = "un
60b0: 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74  able to open dat
60c0: 61 62 61 73 65 20 66 69 6c 65 22 3b 20 20 20 20  abase file";    
60d0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
60e0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 52 4f   case SQLITE_PRO
60f0: 54 4f 43 4f 4c 3a 20 20 20 7a 20 3d 20 22 64 61  TOCOL:   z = "da
6100: 74 61 62 61 73 65 20 6c 6f 63 6b 69 6e 67 20 70  tabase locking p
6110: 72 6f 74 6f 63 6f 6c 20 66 61 69 6c 75 72 65 22  rotocol failure"
6120: 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  ;     break;.   
6130: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 4d 50   case SQLITE_EMP
6140: 54 59 3a 20 20 20 20 20 20 7a 20 3d 20 22 74 61  TY:      z = "ta
6150: 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20  ble contains no 
6160: 64 61 74 61 22 3b 20 20 20 20 20 20 20 20 20 20  data";          
6170: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6180: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 48   case SQLITE_SCH
6190: 45 4d 41 3a 20 20 20 20 20 7a 20 3d 20 22 64 61  EMA:     z = "da
61a0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61  tabase schema ha
61b0: 73 20 63 68 61 6e 67 65 64 22 3b 20 20 20 20 20  s changed";     
61c0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
61d0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 4f 4f   case SQLITE_TOO
61e0: 42 49 47 3a 20 20 20 20 20 7a 20 3d 20 22 74 6f  BIG:     z = "to
61f0: 6f 20 6d 75 63 68 20 64 61 74 61 20 66 6f 72 20  o much data for 
6200: 6f 6e 65 20 74 61 62 6c 65 20 72 6f 77 22 3b 20  one table row"; 
6210: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6220: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e   case SQLITE_CON
6230: 53 54 52 41 49 4e 54 3a 20 7a 20 3d 20 22 63 6f  STRAINT: z = "co
6240: 6e 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22  nstraint failed"
6250: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
6260: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6270: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53   case SQLITE_MIS
6280: 4d 41 54 43 48 3a 20 20 20 7a 20 3d 20 22 64 61  MATCH:   z = "da
6290: 74 61 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22  tatype mismatch"
62a0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
62b0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
62c0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53   case SQLITE_MIS
62d0: 55 53 45 3a 20 20 20 20 20 7a 20 3d 20 22 6c 69  USE:     z = "li
62e0: 62 72 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61  brary routine ca
62f0: 6c 6c 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75  lled out of sequ
6300: 65 6e 63 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20  ence";break;.   
6310: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c   case SQLITE_NOL
6320: 46 53 3a 20 20 20 20 20 20 7a 20 3d 20 22 6b 65  FS:      z = "ke
6330: 72 6e 65 6c 20 6c 61 63 6b 73 20 6c 61 72 67 65  rnel lacks large
6340: 20 66 69 6c 65 20 73 75 70 70 6f 72 74 22 3b 20   file support"; 
6350: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6360: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 55 54   case SQLITE_AUT
6370: 48 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61 75  H:       z = "au
6380: 74 68 6f 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69  thorization deni
6390: 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ed";            
63a0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
63b0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52   case SQLITE_FOR
63c0: 4d 41 54 3a 20 20 20 20 20 7a 20 3d 20 22 61 75  MAT:     z = "au
63d0: 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73 65  xiliary database
63e0: 20 66 6f 72 6d 61 74 20 65 72 72 6f 72 22 3b 20   format error"; 
63f0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6400: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e   case SQLITE_RAN
6410: 47 45 3a 20 20 20 20 20 20 7a 20 3d 20 22 62 69  GE:      z = "bi
6420: 6e 64 20 69 6e 64 65 78 20 6f 75 74 20 6f 66 20  nd index out of 
6430: 72 61 6e 67 65 22 3b 20 20 20 20 20 20 20 20 20  range";         
6440: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6450: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54   case SQLITE_NOT
6460: 41 44 42 3a 20 20 20 20 20 7a 20 3d 20 22 66 69  ADB:     z = "fi
6470: 6c 65 20 69 73 20 65 6e 63 72 79 70 74 65 64 20  le is encrypted 
6480: 6f 72 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61  or is not a data
6490: 62 61 73 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20  base";break;.   
64a0: 20 64 65 66 61 75 6c 74 3a 20 20 20 20 20 20 20   default:       
64b0: 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22 75 6e           z = "un
64c0: 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 20 20 20  known error";   
64d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
64e0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d        break;.  }
64f0: 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a  .  return z;.}..
6500: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
6510: 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20  ne implements a 
6520: 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68  busy callback th
6530: 61 74 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72  at sleeps and tr
6540: 69 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74  ies.** again unt
6550: 69 6c 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c  il a timeout val
6560: 75 65 20 69 73 20 72 65 61 63 68 65 64 2e 20 20  ue is reached.  
6570: 54 68 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75  The timeout valu
6580: 65 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67  e is.** an integ
6590: 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c  er number of mil
65a0: 6c 69 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64  liseconds passed
65b0: 20 69 6e 20 61 73 20 74 68 65 20 66 69 72 73 74   in as the first
65c0: 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f  .** argument..*/
65d0: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69  .static int sqli
65e0: 74 65 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c  teDefaultBusyCal
65f0: 6c 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a 54 69  lback(. void *Ti
6600: 6d 65 6f 75 74 2c 20 20 20 20 20 20 20 20 20 20  meout,          
6610: 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f 75   /* Maximum amou
6620: 6e 74 20 6f 66 20 74 69 6d 65 20 74 6f 20 77 61  nt of time to wa
6630: 69 74 20 2a 2f 0a 20 63 6f 6e 73 74 20 63 68 61  it */. const cha
6640: 72 20 2a 4e 6f 74 55 73 65 64 2c 20 20 20 20 20  r *NotUsed,     
6650: 2f 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74  /* The name of t
6660: 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 69 73  he table that is
6670: 20 62 75 73 79 20 2a 2f 0a 20 69 6e 74 20 63 6f   busy */. int co
6680: 75 6e 74 20 20 20 20 20 20 20 20 20 20 20 20 20  unt             
6690: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
66a0: 74 69 6d 65 73 20 74 61 62 6c 65 20 68 61 73 20  times table has 
66b0: 62 65 65 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a  been busy */.){.
66c0: 23 69 66 20 53 51 4c 49 54 45 5f 4d 49 4e 5f 53  #if SQLITE_MIN_S
66d0: 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20 20 73 74 61  LEEP_MS==1.  sta
66e0: 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 64  tic const char d
66f0: 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 20 20 20 7b  elays[] =.     {
6700: 20 31 2c 20 32 2c 20 35 2c 20 31 30 2c 20 31 35   1, 2, 5, 10, 15
6710: 2c 20 32 30 2c 20 32 35 2c 20 32 35 2c 20 20 32  , 20, 25, 25,  2
6720: 35 2c 20 20 35 30 2c 20 20 35 30 2c 20 20 35 30  5,  50,  50,  50
6730: 2c 20 31 30 30 7d 3b 0a 20 20 73 74 61 74 69 63  , 100};.  static
6740: 20 63 6f 6e 73 74 20 73 68 6f 72 74 20 69 6e 74   const short int
6750: 20 74 6f 74 61 6c 73 5b 5d 20 3d 0a 20 20 20 20   totals[] =.    
6760: 20 7b 20 30 2c 20 31 2c 20 33 2c 20 20 38 2c 20   { 0, 1, 3,  8, 
6770: 31 38 2c 20 33 33 2c 20 35 33 2c 20 37 38 2c 20  18, 33, 53, 78, 
6780: 31 30 33 2c 20 31 32 38 2c 20 31 37 38 2c 20 32  103, 128, 178, 2
6790: 32 38 2c 20 32 38 37 7d 3b 0a 23 20 64 65 66 69  28, 287};.# defi
67a0: 6e 65 20 4e 44 45 4c 41 59 20 28 73 69 7a 65 6f  ne NDELAY (sizeo
67b0: 66 28 64 65 6c 61 79 73 29 2f 73 69 7a 65 6f 66  f(delays)/sizeof
67c0: 28 64 65 6c 61 79 73 5b 30 5d 29 29 0a 20 20 69  (delays[0])).  i
67d0: 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e  nt timeout = (in
67e0: 74 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74  t)Timeout;.  int
67f0: 20 64 65 6c 61 79 2c 20 70 72 69 6f 72 3b 0a 0a   delay, prior;..
6800: 20 20 69 66 28 20 63 6f 75 6e 74 20 3c 3d 20 4e    if( count <= N
6810: 44 45 4c 41 59 20 29 7b 0a 20 20 20 20 64 65 6c  DELAY ){.    del
6820: 61 79 20 3d 20 64 65 6c 61 79 73 5b 63 6f 75 6e  ay = delays[coun
6830: 74 2d 31 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20  t-1];.    prior 
6840: 3d 20 74 6f 74 61 6c 73 5b 63 6f 75 6e 74 2d 31  = totals[count-1
6850: 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  ];.  }else{.    
6860: 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b 4e  delay = delays[N
6870: 44 45 4c 41 59 2d 31 5d 3b 0a 20 20 20 20 70 72  DELAY-1];.    pr
6880: 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 4e 44 45  ior = totals[NDE
6890: 4c 41 59 2d 31 5d 20 2b 20 64 65 6c 61 79 2a 28  LAY-1] + delay*(
68a0: 63 6f 75 6e 74 2d 4e 44 45 4c 41 59 2d 31 29 3b  count-NDELAY-1);
68b0: 0a 20 20 7d 0a 20 20 69 66 28 20 70 72 69 6f 72  .  }.  if( prior
68c0: 20 2b 20 64 65 6c 61 79 20 3e 20 74 69 6d 65 6f   + delay > timeo
68d0: 75 74 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20  ut ){.    delay 
68e0: 3d 20 74 69 6d 65 6f 75 74 20 2d 20 70 72 69 6f  = timeout - prio
68f0: 72 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79  r;.    if( delay
6900: 3c 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  <=0 ) return 0;.
6910: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 53    }.  sqlite3OsS
6920: 6c 65 65 70 28 64 65 6c 61 79 29 3b 0a 20 20 72  leep(delay);.  r
6930: 65 74 75 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20  eturn 1;.#else. 
6940: 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28   int timeout = (
6950: 69 6e 74 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69  int)Timeout;.  i
6960: 66 28 20 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30  f( (count+1)*100
6970: 30 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20  0 > timeout ){. 
6980: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
6990: 0a 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65  .  sqlite3OsSlee
69a0: 70 28 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72  p(1000);.  retur
69b0: 6e 20 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f  n 1;.#endif.}../
69c0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
69d0: 65 20 73 65 74 73 20 74 68 65 20 62 75 73 79 20  e sets the busy 
69e0: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20  callback for an 
69f0: 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20  Sqlite database 
6a00: 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20  to the.** given 
6a10: 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f  callback functio
6a20: 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e  n with the given
6a30: 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f   argument..*/.vo
6a40: 69 64 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f  id sqlite3_busy_
6a50: 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74  handler(.  sqlit
6a60: 65 20 2a 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78  e *db,.  int (*x
6a70: 42 75 73 79 29 28 76 6f 69 64 2a 2c 63 6f 6e 73  Busy)(void*,cons
6a80: 74 20 63 68 61 72 2a 2c 69 6e 74 29 2c 0a 20 20  t char*,int),.  
6a90: 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20  void *pArg.){.  
6aa0: 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c 62 61 63  db->xBusyCallbac
6ab0: 6b 20 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 2d  k = xBusy;.  db-
6ac0: 3e 70 42 75 73 79 41 72 67 20 3d 20 70 41 72 67  >pBusyArg = pArg
6ad0: 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c  ;.}..#ifndef SQL
6ae0: 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53  ITE_OMIT_PROGRES
6af0: 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a  S_CALLBACK./*.**
6b00: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65   This routine se
6b10: 74 73 20 74 68 65 20 70 72 6f 67 72 65 73 73 20  ts the progress 
6b20: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20  callback for an 
6b30: 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20  Sqlite database 
6b40: 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20  to the.** given 
6b50: 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f  callback functio
6b60: 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e  n with the given
6b70: 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 70   argument. The p
6b80: 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b  rogress callback
6b90: 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f   will.** be invo
6ba0: 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20 6f  ked every nOps o
6bb0: 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20  pcodes..*/.void 
6bc0: 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73  sqlite3_progress
6bd0: 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69  _handler(.  sqli
6be0: 74 65 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e  te *db, .  int n
6bf0: 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72  Ops,.  int (*xPr
6c00: 6f 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20  ogress)(void*), 
6c10: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b  .  void *pArg.){
6c20: 0a 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 29 7b  .  if( nOps>0 ){
6c30: 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 72 65  .    db->xProgre
6c40: 73 73 20 3d 20 78 50 72 6f 67 72 65 73 73 3b 0a  ss = xProgress;.
6c50: 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73      db->nProgres
6c60: 73 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a 20 20 20  sOps = nOps;.   
6c70: 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 72   db->pProgressAr
6c80: 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d 65 6c 73  g = pArg;.  }els
6c90: 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67  e{.    db->xProg
6ca0: 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 20 64 62  ress = 0;.    db
6cb0: 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20 3d  ->nProgressOps =
6cc0: 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72 6f   0;.    db->pPro
6cd0: 67 72 65 73 73 41 72 67 20 3d 20 30 3b 0a 20 20  gressArg = 0;.  
6ce0: 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a  }.}.#endif.../*.
6cf0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
6d00: 69 6e 73 74 61 6c 6c 73 20 61 20 64 65 66 61 75  installs a defau
6d10: 6c 74 20 62 75 73 79 20 68 61 6e 64 6c 65 72 20  lt busy handler 
6d20: 74 68 61 74 20 77 61 69 74 73 20 66 6f 72 20 74  that waits for t
6d30: 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 65 64 20  he.** specified 
6d40: 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73  number of millis
6d50: 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20 72 65  econds before re
6d60: 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f 0a 76 6f  turning 0..*/.vo
6d70: 69 64 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f  id sqlite3_busy_
6d80: 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65 20 2a  timeout(sqlite *
6d90: 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20 20 69  db, int ms){.  i
6da0: 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20 20 73  f( ms>0 ){.    s
6db0: 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64  qlite3_busy_hand
6dc0: 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65  ler(db, sqliteDe
6dd0: 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63  faultBusyCallbac
6de0: 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a 20  k, (void*)ms);. 
6df0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69   }else{.    sqli
6e00: 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72  te3_busy_handler
6e10: 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a  (db, 0, 0);.  }.
6e20: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61  }../*.** Cause a
6e30: 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61  ny pending opera
6e40: 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20  tion to stop at 
6e50: 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70  its earliest opp
6e60: 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69  ortunity..*/.voi
6e70: 64 20 73 71 6c 69 74 65 33 5f 69 6e 74 65 72 72  d sqlite3_interr
6e80: 75 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29 7b  upt(sqlite *db){
6e90: 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20  .  db->flags |= 
6ea0: 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74  SQLITE_Interrupt
6eb0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f  ;.}../*.** Windo
6ec0: 77 73 20 73 79 73 74 65 6d 73 20 73 68 6f 75 6c  ws systems shoul
6ed0: 64 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74  d call this rout
6ee0: 69 6e 65 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f  ine to free memo
6ef0: 72 79 20 74 68 61 74 0a 2a 2a 20 69 73 20 72 65  ry that.** is re
6f00: 74 75 72 6e 65 64 20 69 6e 20 74 68 65 20 69 6e  turned in the in
6f10: 20 74 68 65 20 65 72 72 6d 73 67 20 70 61 72 61   the errmsg para
6f20: 6d 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 33  meter of sqlite3
6f30: 5f 6f 70 65 6e 28 29 20 77 68 65 6e 0a 2a 2a 20  _open() when.** 
6f40: 53 51 4c 69 74 65 20 69 73 20 61 20 44 4c 4c 2e  SQLite is a DLL.
6f50: 20 20 46 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f    For some reaso
6f60: 6e 2c 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 77  n, it does not w
6f70: 6f 72 6b 20 74 6f 20 63 61 6c 6c 20 66 72 65 65  ork to call free
6f80: 28 29 0a 2a 2a 20 64 69 72 65 63 74 6c 79 2e 0a  ().** directly..
6f90: 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20  **.** Note that 
6fa0: 77 65 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20  we need to call 
6fb0: 66 72 65 65 28 29 20 6e 6f 74 20 73 71 6c 69 74  free() not sqlit
6fc0: 65 46 72 65 65 28 29 20 68 65 72 65 2c 20 73 69  eFree() here, si
6fd0: 6e 63 65 20 65 76 65 72 79 0a 2a 2a 20 73 74 72  nce every.** str
6fe0: 69 6e 67 20 74 68 61 74 20 69 73 20 65 78 70 6f  ing that is expo
6ff0: 72 74 65 64 20 66 72 6f 6d 20 53 51 4c 69 74 65  rted from SQLite
7000: 20 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72   should have alr
7010: 65 61 64 79 20 70 61 73 73 65 64 20 74 68 72 6f  eady passed thro
7020: 75 67 68 0a 2a 2a 20 73 71 6c 69 74 65 33 53 74  ugh.** sqlite3St
7030: 72 52 65 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76  rRealloc()..*/.v
7040: 6f 69 64 20 73 71 6c 69 74 65 33 5f 66 72 65 65  oid sqlite3_free
7050: 6d 65 6d 28 76 6f 69 64 20 2a 70 29 7b 20 66 72  mem(void *p){ fr
7060: 65 65 28 70 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20  ee(p); }../*.** 
7070: 57 69 6e 64 6f 77 73 20 73 79 73 74 65 6d 73 20  Windows systems 
7080: 6e 65 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 74  need functions t
7090: 6f 20 63 61 6c 6c 20 74 6f 20 72 65 74 75 72 6e  o call to return
70a0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 65 72   the sqlite3_ver
70b0: 73 69 6f 6e 0a 2a 2a 20 61 6e 64 20 73 71 6c 69  sion.** and sqli
70c0: 74 65 33 5f 65 6e 63 6f 64 69 6e 67 20 73 74 72  te3_encoding str
70d0: 69 6e 67 73 20 73 69 6e 63 65 20 74 68 65 79 20  ings since they 
70e0: 61 72 65 20 75 6e 61 62 6c 65 20 74 6f 20 61 63  are unable to ac
70f0: 63 65 73 73 20 63 6f 6e 73 74 61 6e 74 73 0a 2a  cess constants.*
7100: 2a 20 77 69 74 68 69 6e 20 44 4c 4c 73 2e 0a 2a  * within DLLs..*
7110: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  /.const char *sq
7120: 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e  lite3_libversion
7130: 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 73  (void){ return s
7140: 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 3b 20  qlite3_version; 
7150: 7d 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  }.const char *sq
7160: 6c 69 74 65 33 5f 6c 69 62 65 6e 63 6f 64 69 6e  lite3_libencodin
7170: 67 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20  g(void){ return 
7180: 73 71 6c 69 74 65 33 5f 65 6e 63 6f 64 69 6e 67  sqlite3_encoding
7190: 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ; }../*.** Creat
71a0: 65 20 6e 65 77 20 75 73 65 72 2d 64 65 66 69 6e  e new user-defin
71b0: 65 64 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54  ed functions.  T
71c0: 68 65 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74  he sqlite3_creat
71d0: 65 5f 66 75 6e 63 74 69 6f 6e 28 29 0a 2a 2a 20  e_function().** 
71e0: 72 6f 75 74 69 6e 65 20 63 72 65 61 74 65 73 20  routine creates 
71f0: 61 20 72 65 67 75 6c 61 72 20 66 75 6e 63 74 69  a regular functi
7200: 6f 6e 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 63  on and sqlite3_c
7210: 72 65 61 74 65 5f 61 67 67 72 65 67 61 74 65 28  reate_aggregate(
7220: 29 0a 2a 2a 20 63 72 65 61 74 65 73 20 61 6e 20  ).** creates an 
7230: 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69  aggregate functi
7240: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50 61 73 73 69 6e  on..**.** Passin
7250: 67 20 61 20 4e 55 4c 4c 20 78 46 75 6e 63 20 61  g a NULL xFunc a
7260: 72 67 75 6d 65 6e 74 20 6f 72 20 4e 55 4c 4c 20  rgument or NULL 
7270: 78 53 74 65 70 20 61 6e 64 20 78 46 69 6e 61 6c  xStep and xFinal
7280: 69 7a 65 20 61 72 67 75 6d 65 6e 74 73 0a 2a 2a  ize arguments.**
7290: 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 66 75   disables the fu
72a0: 6e 63 74 69 6f 6e 2e 20 20 43 61 6c 6c 69 6e 67  nction.  Calling
72b0: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f   sqlite3_create_
72c0: 66 75 6e 63 74 69 6f 6e 28 29 20 77 69 74 68 20  function() with 
72d0: 74 68 65 0a 2a 2a 20 73 61 6d 65 20 6e 61 6d 65  the.** same name
72e0: 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f 66 20 61   and number of a
72f0: 72 67 75 6d 65 6e 74 73 20 61 73 20 61 20 70 72  rguments as a pr
7300: 69 6f 72 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73  ior call to.** s
7310: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 61 67  qlite3_create_ag
7320: 67 72 65 67 61 74 65 28 29 20 64 69 73 61 62 6c  gregate() disabl
7330: 65 73 20 74 68 65 20 70 72 69 6f 72 20 63 61 6c  es the prior cal
7340: 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 5f  l to.** sqlite3_
7350: 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74 65  create_aggregate
7360: 28 29 2c 20 61 6e 64 20 76 69 63 65 20 76 65 72  (), and vice ver
7370: 73 61 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 41 72  sa..**.** If nAr
7380: 67 20 69 73 20 2d 31 20 69 74 20 6d 65 61 6e 73  g is -1 it means
7390: 20 74 68 61 74 20 74 68 69 73 20 66 75 6e 63 74   that this funct
73a0: 69 6f 6e 20 77 69 6c 6c 20 61 63 63 65 70 74 20  ion will accept 
73b0: 61 6e 79 20 6e 75 6d 62 65 72 0a 2a 2a 20 6f 66  any number.** of
73c0: 20 61 72 67 75 6d 65 6e 74 73 2c 20 69 6e 63 6c   arguments, incl
73d0: 75 64 69 6e 67 20 30 2e 20 20 54 68 65 20 6d 61  uding 0.  The ma
73e0: 78 69 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 76 61  ximum allowed va
73f0: 6c 75 65 20 6f 66 20 6e 41 72 67 20 69 73 20 31  lue of nArg is 1
7400: 32 37 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  27..*/.int sqlit
7410: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69  e3_create_functi
7420: 6f 6e 28 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  on(.  sqlite *db
7430: 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64  ,          /* Ad
7440: 64 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 74  d the function t
7450: 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20  o this database 
7460: 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20  connection */.  
7470: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d  const char *zNam
7480: 65 2c 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20  e,   /* Name of 
7490: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20  the function to 
74a0: 61 64 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 72  add */.  int nAr
74b0: 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  g,            /*
74c0: 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d   Number of argum
74d0: 65 6e 74 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28  ents */.  void (
74e0: 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 5f 66  *xFunc)(sqlite_f
74f0: 75 6e 63 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63  unc*,int,const c
7500: 68 61 72 2a 2a 29 2c 20 20 2f 2a 20 54 68 65 20  har**),  /* The 
7510: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a  implementation *
7520: 2f 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44  /.  void *pUserD
7530: 61 74 61 20 20 20 20 20 20 2f 2a 20 55 73 65 72  ata      /* User
7540: 20 64 61 74 61 20 2a 2f 0a 29 7b 0a 20 20 46 75   data */.){.  Fu
7550: 6e 63 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20  ncDef *p;.  int 
7560: 6e 4e 61 6d 65 3b 0a 20 20 69 66 28 20 64 62 3d  nName;.  if( db=
7570: 3d 30 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 7c  =0 || zName==0 |
7580: 7c 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 43  | sqlite3SafetyC
7590: 68 65 63 6b 28 64 62 29 20 29 20 72 65 74 75 72  heck(db) ) retur
75a0: 6e 20 31 3b 0a 20 20 69 66 28 20 6e 41 72 67 3c  n 1;.  if( nArg<
75b0: 2d 31 20 7c 7c 20 6e 41 72 67 3e 31 32 37 20 29  -1 || nArg>127 )
75c0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 6e 4e 61   return 1;.  nNa
75d0: 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d  me = strlen(zNam
75e0: 65 29 3b 0a 20 20 69 66 28 20 6e 4e 61 6d 65 3e  e);.  if( nName>
75f0: 32 35 35 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  255 ) return 1;.
7600: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46 69 6e    p = sqlite3Fin
7610: 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e  dFunction(db, zN
7620: 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67  ame, nName, nArg
7630: 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30  , 1);.  if( p==0
7640: 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 70   ) return 1;.  p
7650: 2d 3e 78 46 75 6e 63 20 3d 20 78 46 75 6e 63 3b  ->xFunc = xFunc;
7660: 0a 20 20 70 2d 3e 78 53 74 65 70 20 3d 20 30 3b  .  p->xStep = 0;
7670: 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20  .  p->xFinalize 
7680: 3d 20 30 3b 0a 20 20 70 2d 3e 70 55 73 65 72 44  = 0;.  p->pUserD
7690: 61 74 61 20 3d 20 70 55 73 65 72 44 61 74 61 3b  ata = pUserData;
76a0: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 69  .  return 0;.}.i
76b0: 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74  nt sqlite3_creat
76c0: 65 5f 61 67 67 72 65 67 61 74 65 28 0a 20 20 73  e_aggregate(.  s
76d0: 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20  qlite *db,      
76e0: 20 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20 66      /* Add the f
76f0: 75 6e 63 74 69 6f 6e 20 74 6f 20 74 68 69 73 20  unction to this 
7700: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
7710: 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  ion */.  const c
7720: 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20 20 2f 2a  har *zName,   /*
7730: 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 75 6e   Name of the fun
7740: 63 74 69 6f 6e 20 74 6f 20 61 64 64 20 2a 2f 0a  ction to add */.
7750: 20 20 69 6e 74 20 6e 41 72 67 2c 20 20 20 20 20    int nArg,     
7760: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
7770: 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 2a 2f   of arguments */
7780: 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29  .  void (*xStep)
7790: 28 73 71 6c 69 74 65 5f 66 75 6e 63 2a 2c 69 6e  (sqlite_func*,in
77a0: 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2a 29 2c  t,const char**),
77b0: 20 2f 2a 20 54 68 65 20 73 74 65 70 20 66 75 6e   /* The step fun
77c0: 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20  ction */.  void 
77d0: 28 2a 78 46 69 6e 61 6c 69 7a 65 29 28 73 71 6c  (*xFinalize)(sql
77e0: 69 74 65 5f 66 75 6e 63 2a 29 2c 20 20 20 20 20  ite_func*),     
77f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
7800: 66 69 6e 61 6c 69 7a 65 72 20 2a 2f 0a 20 20 76  finalizer */.  v
7810: 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 20 20  oid *pUserData  
7820: 20 20 20 20 2f 2a 20 55 73 65 72 20 64 61 74 61      /* User data
7830: 20 2a 2f 0a 29 7b 0a 20 20 46 75 6e 63 44 65 66   */.){.  FuncDef
7840: 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65   *p;.  int nName
7850: 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 7c 7c  ;.  if( db==0 ||
7860: 20 7a 4e 61 6d 65 3d 3d 30 20 7c 7c 20 73 71 6c   zName==0 || sql
7870: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28  ite3SafetyCheck(
7880: 64 62 29 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  db) ) return 1;.
7890: 20 20 69 66 28 20 6e 41 72 67 3c 2d 31 20 7c 7c    if( nArg<-1 ||
78a0: 20 6e 41 72 67 3e 31 32 37 20 29 20 72 65 74 75   nArg>127 ) retu
78b0: 72 6e 20 31 3b 0a 20 20 6e 4e 61 6d 65 20 3d 20  rn 1;.  nName = 
78c0: 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 3b 0a 20  strlen(zName);. 
78d0: 20 69 66 28 20 6e 4e 61 6d 65 3e 32 35 35 20 29   if( nName>255 )
78e0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 20 3d   return 1;.  p =
78f0: 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e 63   sqlite3FindFunc
7900: 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20  tion(db, zName, 
7910: 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 31 29 3b  nName, nArg, 1);
7920: 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65  .  if( p==0 ) re
7930: 74 75 72 6e 20 31 3b 0a 20 20 70 2d 3e 78 46 75  turn 1;.  p->xFu
7940: 6e 63 20 3d 20 30 3b 0a 20 20 70 2d 3e 78 53 74  nc = 0;.  p->xSt
7950: 65 70 20 3d 20 78 53 74 65 70 3b 0a 20 20 70 2d  ep = xStep;.  p-
7960: 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 78 46 69  >xFinalize = xFi
7970: 6e 61 6c 69 7a 65 3b 0a 20 20 70 2d 3e 70 55 73  nalize;.  p->pUs
7980: 65 72 44 61 74 61 20 3d 20 70 55 73 65 72 44 61  erData = pUserDa
7990: 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a  ta;.  return 0;.
79a0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20  }../*.** Change 
79b0: 74 68 65 20 64 61 74 61 74 79 70 65 20 66 6f 72  the datatype for
79c0: 20 61 6c 6c 20 66 75 6e 63 74 69 6f 6e 73 20 77   all functions w
79d0: 69 74 68 20 61 20 67 69 76 65 6e 20 6e 61 6d 65  ith a given name
79e0: 2e 20 20 53 65 65 20 74 68 65 0a 2a 2a 20 68 65  .  See the.** he
79f0: 61 64 65 72 20 63 6f 6d 6d 65 6e 74 20 66 6f 72  ader comment for
7a00: 20 74 68 65 20 70 72 6f 74 6f 74 79 70 65 20 6f   the prototype o
7a10: 66 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  f this function 
7a20: 69 6e 20 73 71 6c 69 74 65 2e 68 20 66 6f 72 0a  in sqlite.h for.
7a30: 2a 2a 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  ** additional in
7a40: 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e  formation..*/.in
7a50: 74 20 73 71 6c 69 74 65 33 5f 66 75 6e 63 74 69  t sqlite3_functi
7a60: 6f 6e 5f 74 79 70 65 28 73 71 6c 69 74 65 20 2a  on_type(sqlite *
7a70: 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  db, const char *
7a80: 7a 4e 61 6d 65 2c 20 69 6e 74 20 64 61 74 61 54  zName, int dataT
7a90: 79 70 65 29 7b 0a 20 20 46 75 6e 63 44 65 66 20  ype){.  FuncDef 
7aa0: 2a 70 20 3d 20 28 46 75 6e 63 44 65 66 2a 29 73  *p = (FuncDef*)s
7ab0: 71 6c 69 74 65 33 48 61 73 68 46 69 6e 64 28 26  qlite3HashFind(&
7ac0: 64 62 2d 3e 61 46 75 6e 63 2c 20 7a 4e 61 6d 65  db->aFunc, zName
7ad0: 2c 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 29  , strlen(zName))
7ae0: 3b 0a 20 20 77 68 69 6c 65 28 20 70 20 29 7b 0a  ;.  while( p ){.
7af0: 20 20 20 20 70 2d 3e 64 61 74 61 54 79 70 65 20      p->dataType 
7b00: 3d 20 64 61 74 61 54 79 70 65 3b 20 0a 20 20 20  = dataType; .   
7b10: 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20   p = p->pNext;. 
7b20: 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49   }.  return SQLI
7b30: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
7b40: 52 65 67 69 73 74 65 72 20 61 20 74 72 61 63 65  Register a trace
7b50: 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20   function.  The 
7b60: 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20 70 72  pArg from the pr
7b70: 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65  eviously registe
7b80: 72 65 64 20 74 72 61 63 65 0a 2a 2a 20 69 73 20  red trace.** is 
7b90: 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a  returned.  .**.*
7ba0: 2a 20 41 20 4e 55 4c 4c 20 74 72 61 63 65 20 66  * A NULL trace f
7bb0: 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68  unction means th
7bc0: 61 74 20 6e 6f 20 74 72 61 63 69 6e 67 20 69 73  at no tracing is
7bd0: 20 65 78 65 63 75 74 65 73 2e 20 20 41 20 6e 6f   executes.  A no
7be0: 6e 2d 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20  n-NULL.** trace 
7bf0: 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  is a pointer to 
7c00: 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20  a function that 
7c10: 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 68  is invoked at th
7c20: 65 20 73 74 61 72 74 20 6f 66 20 65 61 63 68 0a  e start of each.
7c30: 2a 2a 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28  ** sqlite3_exec(
7c40: 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69  )..*/.void *sqli
7c50: 74 65 33 5f 74 72 61 63 65 28 73 71 6c 69 74 65  te3_trace(sqlite
7c60: 20 2a 64 62 2c 20 76 6f 69 64 20 28 2a 78 54 72   *db, void (*xTr
7c70: 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74  ace)(void*,const
7c80: 20 63 68 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70   char*), void *p
7c90: 41 72 67 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f  Arg){.  void *pO
7ca0: 6c 64 20 3d 20 64 62 2d 3e 70 54 72 61 63 65 41  ld = db->pTraceA
7cb0: 72 67 3b 0a 20 20 64 62 2d 3e 78 54 72 61 63 65  rg;.  db->xTrace
7cc0: 20 3d 20 78 54 72 61 63 65 3b 0a 20 20 64 62 2d   = xTrace;.  db-
7cd0: 3e 70 54 72 61 63 65 41 72 67 20 3d 20 70 41 72  >pTraceArg = pAr
7ce0: 67 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64  g;.  return pOld
7cf0: 3b 0a 7d 0a 0a 2f 2a 2a 2a 20 45 58 50 45 52 49  ;.}../*** EXPERI
7d00: 4d 45 4e 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a 2a  MENTAL ***.**.**
7d10: 20 52 65 67 69 73 74 65 72 20 61 20 66 75 6e 63   Register a func
7d20: 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b  tion to be invok
7d30: 65 64 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61  ed when a transa
7d40: 63 74 69 6f 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a  ction comments..
7d50: 2a 2a 20 49 66 20 65 69 74 68 65 72 20 66 75 6e  ** If either fun
7d60: 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 6e 6f  ction returns no
7d70: 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65  n-zero, then the
7d80: 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d 65 73 20   commit becomes 
7d90: 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a  a.** rollback..*
7da0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
7db0: 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a 20 20 73  commit_hook(.  s
7dc0: 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20  qlite *db,      
7dd0: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61           /* Atta
7de0: 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74  ch the hook to t
7df0: 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a  his database */.
7e00: 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c 62 61 63    int (*xCallbac
7e10: 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f 2a 20 46  k)(void*),  /* F
7e20: 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b  unction to invok
7e30: 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d 69 74  e on each commit
7e40: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67   */.  void *pArg
7e50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7e60: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74  /* Argument to t
7e70: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29  he function */.)
7e80: 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d  {.  void *pOld =
7e90: 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 3b   db->pCommitArg;
7ea0: 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61  .  db->xCommitCa
7eb0: 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61  llback = xCallba
7ec0: 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d 6d 69  ck;.  db->pCommi
7ed0: 74 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72  tArg = pArg;.  r
7ee0: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 0a  eturn pOld;.}...
7ef0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
7f00: 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20  ne is called to 
7f10: 63 72 65 61 74 65 20 61 20 63 6f 6e 6e 65 63 74  create a connect
7f20: 69 6f 6e 20 74 6f 20 61 20 64 61 74 61 62 61 73  ion to a databas
7f30: 65 20 42 54 72 65 65 0a 2a 2a 20 64 72 69 76 65  e BTree.** drive
7f40: 72 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65  r.  If zFilename
7f50: 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20   is the name of 
7f60: 61 20 66 69 6c 65 2c 20 74 68 65 6e 20 74 68 61  a file, then tha
7f70: 74 20 66 69 6c 65 20 69 73 0a 2a 2a 20 6f 70 65  t file is.** ope
7f80: 6e 65 64 20 61 6e 64 20 75 73 65 64 2e 20 20 49  ned and used.  I
7f90: 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74  f zFilename is t
7fa0: 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a  he magic name ":
7fb0: 6d 65 6d 6f 72 79 3a 22 20 74 68 65 6e 0a 2a 2a  memory:" then.**
7fc0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
7fd0: 20 73 74 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72   stored in memor
7fe0: 79 20 28 61 6e 64 20 69 73 20 74 68 75 73 20 66  y (and is thus f
7ff0: 6f 72 67 6f 74 74 65 6e 20 61 73 20 73 6f 6f 6e  orgotten as soon
8000: 20 61 73 0a 2a 2a 20 74 68 65 20 63 6f 6e 6e 65   as.** the conne
8010: 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e  ction is closed.
8020: 29 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20  )  If zFilename 
8030: 69 73 20 4e 55 4c 4c 20 74 68 65 6e 20 74 68 65  is NULL then the
8040: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 69 73 20   database.** is 
8050: 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 75 73  for temporary us
8060: 65 20 6f 6e 6c 79 20 61 6e 64 20 69 73 20 64 65  e only and is de
8070: 6c 65 74 65 64 20 61 73 20 73 6f 6f 6e 20 61 73  leted as soon as
8080: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a   the connection.
8090: 2a 2a 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a  ** is closed..**
80a0: 0a 2a 2a 20 41 20 74 65 6d 70 6f 72 61 72 79 20  .** A temporary 
80b0: 64 61 74 61 62 61 73 65 20 63 61 6e 20 62 65 20  database can be 
80c0: 65 69 74 68 65 72 20 61 20 64 69 73 6b 20 66 69  either a disk fi
80d0: 6c 65 20 28 74 68 61 74 20 69 73 20 61 75 74 6f  le (that is auto
80e0: 6d 61 74 69 63 61 6c 6c 79 0a 2a 2a 20 64 65 6c  matically.** del
80f0: 65 74 65 64 20 77 68 65 6e 20 74 68 65 20 66 69  eted when the fi
8100: 6c 65 20 69 73 20 63 6c 6f 73 65 64 29 20 6f 72  le is closed) or
8110: 20 61 20 73 65 74 20 6f 66 20 72 65 64 2d 62 6c   a set of red-bl
8120: 61 63 6b 20 74 72 65 65 73 20 68 65 6c 64 20 69  ack trees held i
8130: 6e 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 64 65 70  n memory,.** dep
8140: 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61  ending on the va
8150: 6c 75 65 73 20 6f 66 20 74 68 65 20 54 45 4d 50  lues of the TEMP
8160: 5f 53 54 4f 52 45 20 63 6f 6d 70 69 6c 65 2d 74  _STORE compile-t
8170: 69 6d 65 20 6d 61 63 72 6f 20 61 6e 64 20 74 68  ime macro and th
8180: 65 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 5f 73 74  e.** db->temp_st
8190: 6f 72 65 20 76 61 72 69 61 62 6c 65 2c 20 61 63  ore variable, ac
81a0: 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 66  cording to the f
81b0: 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 3a 0a  ollowing chart:.
81c0: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 54 45 4d 50  **.**       TEMP
81d0: 5f 53 54 4f 52 45 20 20 20 20 20 64 62 2d 3e 74  _STORE     db->t
81e0: 65 6d 70 5f 73 74 6f 72 65 20 20 20 20 20 4c 6f  emp_store     Lo
81f0: 63 61 74 69 6f 6e 20 6f 66 20 74 65 6d 70 6f 72  cation of tempor
8200: 61 72 79 20 64 61 74 61 62 61 73 65 0a 2a 2a 20  ary database.** 
8210: 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d        ----------
8220: 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d       -----------
8230: 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d  ---     --------
8240: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8250: 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 20  ------.**       
8260: 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20      0           
8270: 20 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20      any         
8280: 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20      file.**     
8290: 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20        1         
82a0: 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20         1        
82b0: 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20        file.**   
82c0: 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20          1       
82d0: 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20           2      
82e0: 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a          memory.*
82f0: 2a 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20  *           1   
8300: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20 20               0  
8310: 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c 65              file
8320: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 32 20  .**           2 
8330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31                 1
8340: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69                fi
8350: 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  le.**           
8360: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  2               
8370: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20   2              
8380: 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20 20 20  memory.**       
8390: 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20      2           
83a0: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20       0          
83b0: 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20      memory.**   
83c0: 20 20 20 20 20 20 20 20 33 20 20 20 20 20 20 20          3       
83d0: 20 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 20          any     
83e0: 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a          memory.*
83f0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72  /.int sqlite3Btr
8400: 65 65 46 61 63 74 6f 72 79 28 0a 20 20 63 6f 6e  eeFactory(.  con
8410: 73 74 20 73 71 6c 69 74 65 20 2a 64 62 2c 09 20  st sqlite *db,. 
8420: 20 20 20 2f 2a 20 4d 61 69 6e 20 64 61 74 61 62     /* Main datab
8430: 61 73 65 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67  ase when opening
8440: 20 61 75 78 20 6f 74 68 65 72 77 69 73 65 20 30   aux otherwise 0
8450: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
8460: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 20 20   *zFilename,    
8470: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66  /* Name of the f
8480: 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74  ile containing t
8490: 68 65 20 42 54 72 65 65 20 64 61 74 61 62 61 73  he BTree databas
84a0: 65 20 2a 2f 0a 20 20 69 6e 74 20 6f 6d 69 74 4a  e */.  int omitJ
84b0: 6f 75 72 6e 61 6c 2c 20 20 20 20 20 20 20 20 20  ournal,         
84c0: 20 2f 2a 20 69 66 20 54 52 55 45 20 74 68 65 6e   /* if TRUE then
84d0: 20 64 6f 20 6e 6f 74 20 6a 6f 75 72 6e 61 6c 20   do not journal 
84e0: 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 69  this file */.  i
84f0: 6e 74 20 6e 43 61 63 68 65 2c 20 20 20 20 20 20  nt nCache,      
8500: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 6f 77 20           /* How 
8510: 6d 61 6e 79 20 70 61 67 65 73 20 69 6e 20 74 68  many pages in th
8520: 65 20 70 61 67 65 20 63 61 63 68 65 20 2a 2f 0a  e page cache */.
8530: 20 20 42 74 72 65 65 20 2a 2a 70 70 42 74 72 65    Btree **ppBtre
8540: 65 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50  e           /* P
8550: 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 20 42 74  ointer to new Bt
8560: 72 65 65 20 6f 62 6a 65 63 74 20 77 72 69 74 74  ree object writt
8570: 65 6e 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20  en here */.){.  
8580: 69 6e 74 20 62 74 72 65 65 5f 66 6c 61 67 73 20  int btree_flags 
8590: 3d 20 30 3b 0a 20 20 0a 20 20 61 73 73 65 72 74  = 0;.  .  assert
85a0: 28 20 70 70 42 74 72 65 65 20 21 3d 20 30 29 3b  ( ppBtree != 0);
85b0: 0a 20 20 69 66 28 20 6f 6d 69 74 4a 6f 75 72 6e  .  if( omitJourn
85c0: 61 6c 20 29 7b 0a 20 20 20 20 62 74 72 65 65 5f  al ){.    btree_
85d0: 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f 4f  flags |= BTREE_O
85e0: 4d 49 54 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 7d  MIT_JOURNAL;.  }
85f0: 0a 20 20 69 66 28 20 21 7a 46 69 6c 65 6e 61 6d  .  if( !zFilenam
8600: 65 20 29 7b 0a 20 20 20 20 62 74 72 65 65 5f 66  e ){.    btree_f
8610: 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f 4d 45  lags |= BTREE_ME
8620: 4d 4f 52 59 3b 0a 20 20 7d 0a 0a 20 20 72 65 74  MORY;.  }..  ret
8630: 75 72 6e 20 73 71 6c 69 74 65 33 42 74 72 65 65  urn sqlite3Btree
8640: 4f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20  Open(zFilename, 
8650: 70 70 42 74 72 65 65 2c 20 6e 43 61 63 68 65 2c  ppBtree, nCache,
8660: 20 62 74 72 65 65 5f 66 6c 61 67 73 29 3b 0a 7d   btree_flags);.}
8670: 0a 0a 23 69 66 20 30 0a 0a 2f 2a 0a 2a 2a 20 73  ..#if 0../*.** s
8680: 71 6c 69 74 65 33 5f 6f 70 65 6e 0a 2a 2a 0a 2a  qlite3_open.**.*
8690: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70  /.int sqlite3_op
86a0: 65 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 66  en(const char *f
86b0: 69 6c 65 6e 61 6d 65 2c 20 73 71 6c 69 74 65 33  ilename, sqlite3
86c0: 20 2a 2a 70 44 62 2c 20 63 6f 6e 73 74 20 63 68   **pDb, const ch
86d0: 61 72 20 2a 2a 6f 70 74 69 6f 6e 73 29 7b 0a 20  ar **options){. 
86e0: 20 2a 70 44 62 20 3d 20 73 71 6c 69 74 65 33 5f   *pDb = sqlite3_
86f0: 6f 70 65 6e 28 66 69 6c 65 6e 61 6d 65 2c 20 30  open(filename, 0
8700: 2c 20 26 65 72 72 6d 73 67 29 3b 0a 20 20 72 65  , &errmsg);.  re
8710: 74 75 72 6e 20 28 2a 70 44 62 3f 53 51 4c 49 54  turn (*pDb?SQLIT
8720: 45 5f 4f 4b 3a 53 51 4c 49 54 45 5f 45 52 52 4f  E_OK:SQLITE_ERRO
8730: 52 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  R);.}.int sqlite
8740: 33 5f 6f 70 65 6e 31 36 28 63 6f 6e 73 74 20 76  3_open16(const v
8750: 6f 69 64 20 2a 66 69 6c 65 6e 61 6d 65 2c 20 73  oid *filename, s
8760: 71 6c 69 74 65 33 20 2a 2a 70 44 62 2c 20 63 6f  qlite3 **pDb, co
8770: 6e 73 74 20 63 68 61 72 20 2a 2a 6f 70 74 69 6f  nst char **optio
8780: 6e 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  ns){.  int rc;. 
8790: 20 63 68 61 72 20 2a 20 66 69 6c 65 6e 61 6d 65   char * filename
87a0: 38 3b 0a 0a 20 20 66 69 6c 65 6e 61 6d 65 38 20  8;..  filename8 
87b0: 3d 20 73 71 6c 69 74 65 33 75 74 66 31 36 74 6f  = sqlite3utf16to
87c0: 38 28 66 69 6c 65 6e 61 6d 65 2c 20 2d 31 29 3b  8(filename, -1);
87d0: 0a 20 20 69 66 28 20 21 66 69 6c 65 6e 61 6d 65  .  if( !filename
87e0: 38 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  8 ){.    return 
87f0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
8800: 7d 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  }..  rc = sqlite
8810: 33 5f 6f 70 65 6e 28 66 69 6c 65 6e 61 6d 65 38  3_open(filename8
8820: 2c 20 70 44 62 2c 20 6f 70 74 69 6f 6e 73 29 3b  , pDb, options);
8830: 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 66 69  .  sqliteFree(fi
8840: 6c 65 6e 61 6d 65 38 29 3b 0a 0a 20 20 72 65 74  lename8);..  ret
8850: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
8860: 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 0a 2a   sqlite3_close.*
8870: 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  *.*/.int sqlite3
8880: 5f 63 6c 6f 73 65 28 73 71 6c 69 74 65 33 20 2a  _close(sqlite3 *
8890: 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71  db){.  return sq
88a0: 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b  lite3_close(db);
88b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74 65  .}../*.** sqlite
88c0: 33 5f 65 72 72 6d 73 67 0a 2a 2a 0a 2a 2a 20 54  3_errmsg.**.** T
88d0: 4f 44 4f 3a 20 21 0a 2a 2f 0a 63 6f 6e 73 74 20  ODO: !.*/.const 
88e0: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72  char *sqlite3_er
88f0: 72 6d 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62  rmsg(sqlite3 *db
8900: 29 7b 0a 20 20 61 73 73 65 72 74 28 21 22 54 4f  ){.  assert(!"TO
8910: 44 4f 22 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f  DO");.}.const vo
8920: 69 64 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d  id *sqlite3_errm
8930: 73 67 31 36 28 73 71 6c 69 74 65 33 20 2a 64 62  sg16(sqlite3 *db
8940: 29 7b 0a 20 20 61 73 73 65 72 74 28 21 22 54 4f  ){.  assert(!"TO
8950: 44 4f 22 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 73  DO");.}../*.** s
8960: 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 0a 2a  qlite3_errcode.*
8970: 2a 0a 2a 2a 20 54 4f 44 4f 3a 20 21 0a 2a 2f 0a  *.** TODO: !.*/.
8980: 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63  int sqlite3_errc
8990: 6f 64 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29  ode(sqlite3 *db)
89a0: 7b 0a 20 20 61 73 73 65 72 74 28 21 22 54 4f 44  {.  assert(!"TOD
89b0: 4f 22 29 3b 0a 7d 0a 0a 73 74 72 75 63 74 20 73  O");.}..struct s
89c0: 71 6c 69 74 65 5f 73 74 6d 74 20 7b 0a 7d 3b 0a  qlite_stmt {.};.
89d0: 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 70  ./*.** sqlite3_p
89e0: 72 65 70 61 72 65 0a 2a 2a 0a 2a 2a 20 54 4f 44  repare.**.** TOD
89f0: 4f 3a 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  O: error message
8a00: 20 68 61 6e 64 6c 69 6e 67 0a 2a 2f 0a 69 6e 74   handling.*/.int
8a10: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
8a20: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c  (.  sqlite3 *db,
8a30: 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a   .  const char *
8a40: 7a 53 71 6c 2c 20 0a 20 20 73 71 6c 69 74 65 33  zSql, .  sqlite3
8a50: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
8a60: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 2a 2a 20  .  const char** 
8a70: 70 7a 54 61 69 6c 0a 29 7b 0a 20 20 69 6e 74 20  pzTail.){.  int 
8a80: 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  rc;.  rc = sqlit
8a90: 65 33 5f 63 6f 6d 70 69 6c 65 28 64 62 2c 20 7a  e3_compile(db, z
8aa0: 53 71 6c 2c 20 70 7a 54 61 69 6c 2c 20 70 70 53  Sql, pzTail, ppS
8ab0: 74 6d 74 2c 20 30 29 3b 20 0a 20 20 72 65 74 75  tmt, 0); .  retu
8ac0: 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c  rn rc;.}.int sql
8ad0: 69 74 65 33 5f 70 72 65 70 61 72 65 31 36 28 0a  ite3_prepare16(.
8ae0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a    sqlite3 *db, .
8af0: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53    const void *zS
8b00: 71 6c 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 73  ql, .  sqlite3_s
8b10: 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 0a 20  tmt **ppStmt, . 
8b20: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a   const void **pz
8b30: 54 61 69 6c 0a 29 7b 0a 20 20 69 6e 74 20 72 63  Tail.){.  int rc
8b40: 3b 0a 20 20 63 68 61 72 20 2a 73 71 6c 38 3b 0a  ;.  char *sql8;.
8b50: 0a 20 20 73 71 6c 38 20 3d 20 73 71 6c 69 74 65  .  sql8 = sqlite
8b60: 33 75 74 66 31 36 74 6f 38 28 7a 53 71 6c 2c 20  3utf16to8(zSql, 
8b70: 2d 31 29 3b 0a 20 20 69 66 28 20 21 73 71 6c 38  -1);.  if( !sql8
8b80: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
8b90: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d  QLITE_NOMEM;.  }
8ba0: 0a 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 48 61 76  ..  /* TODO: Hav
8bb0: 65 20 74 6f 20 73 65 74 20 2a 70 7a 54 61 69 6c  e to set *pzTail
8bc0: 20 74 6f 20 70 6f 69 6e 74 20 69 6e 74 6f 20 74   to point into t
8bd0: 68 65 20 6f 72 69 67 69 6e 61 6c 20 55 54 46 2d  he original UTF-
8be0: 31 36 20 73 74 72 69 6e 67 0a 20 20 2a 2a 20 73  16 string.  ** s
8bf0: 6f 6d 65 68 6f 77 2e 0a 20 20 2a 2f 0a 20 20 72  omehow..  */.  r
8c00: 63 20 3d 20 73 71 6c 69 74 65 33 5f 70 72 65 70  c = sqlite3_prep
8c10: 61 72 65 28 64 62 2c 20 73 71 6c 38 2c 20 70 70  are(db, sql8, pp
8c20: 53 74 6d 74 2c 20 30 29 3b 0a 20 20 73 71 6c 69  Stmt, 0);.  sqli
8c30: 74 65 46 72 65 65 28 66 69 6c 65 6e 61 6d 65 38  teFree(filename8
8c40: 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  );..  return rc;
8c50: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74 65  .}../*.** sqlite
8c60: 33 5f 66 69 6e 61 6c 69 7a 65 0a 2a 2f 0a 69 6e  3_finalize.*/.in
8c70: 74 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69  t sqlite3_finali
8c80: 7a 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  ze(sqlite3_stmt 
8c90: 2a 73 74 6d 74 29 7b 0a 20 20 72 65 74 75 72 6e  *stmt){.  return
8ca0: 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a   sqlite3_finaliz
8cb0: 65 28 73 74 6d 74 2c 20 30 29 3b 0a 7d 0a 0a 2f  e(stmt, 0);.}../
8cc0: 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65 73  *.** sqlite3_res
8cd0: 65 74 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  et.*/.int sqlite
8ce0: 33 5f 72 65 73 65 74 28 73 71 6c 69 74 65 33 5f  3_reset(sqlite3_
8cf0: 73 74 6d 74 2a 29 7b 0a 20 20 72 65 74 75 72 6e  stmt*){.  return
8d00: 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 73   sqlite3_reset(s
8d10: 74 6d 74 2c 20 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  tmt, 0);.}../*.*
8d20: 2a 20 73 71 6c 69 74 65 33 5f 73 74 65 70 0a 2a  * sqlite3_step.*
8d30: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74  /.int sqlite3_st
8d40: 65 70 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  ep(sqlite3_stmt 
8d50: 2a 70 53 74 6d 74 29 7b 0a 20 20 72 65 74 75 72  *pStmt){.  retur
8d60: 6e 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 70  n sqlite3_step(p
8d70: 53 74 6d 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Stmt);.}../*.** 
8d80: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78  sqlite3_bind_tex
8d90: 74 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  t.*/.int sqlite3
8da0: 5f 62 69 6e 64 5f 74 65 78 74 28 0a 20 20 73 71  _bind_text(.  sq
8db0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
8dc0: 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20  t, .  int i, .  
8dd0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 56 61 6c  const char *zVal
8de0: 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 69  , .  int n, .  i
8df0: 6e 74 20 65 43 6f 70 79 0a 29 7b 0a 20 20 72 65  nt eCopy.){.  re
8e00: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 62 69 6e  turn sqlite3_bin
8e10: 64 28 70 53 74 6d 74 2c 20 69 2c 20 7a 56 61 6c  d(pStmt, i, zVal
8e20: 2c 20 6e 2c 20 65 43 6f 70 79 29 3b 0a 7d 0a 0a  , n, eCopy);.}..
8e30: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
8e40: 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69 74  _text16(.  sqlit
8e50: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
8e60: 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 76 6f 69  .  int i, .  voi
8e70: 64 20 2a 7a 56 61 6c 2c 20 0a 20 20 69 6e 74 20  d *zVal, .  int 
8e80: 6e 2c 20 0a 20 20 69 6e 74 20 65 43 6f 70 79 0a  n, .  int eCopy.
8e90: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63  ){.  int rc;.  c
8ea0: 68 61 72 20 2a 20 7a 56 61 6c 38 3b 0a 0a 20 20  har * zVal8;..  
8eb0: 2f 2a 20 63 6f 6e 76 65 72 74 20 74 68 65 20 66  /* convert the f
8ec0: 69 72 73 74 20 6e 20 62 79 74 65 73 20 6f 66 20  irst n bytes of 
8ed0: 74 68 65 20 55 54 46 2d 31 36 20 73 74 72 69 6e  the UTF-16 strin
8ee0: 67 20 74 6f 20 55 54 46 2d 38 20 2a 2f 0a 20 20  g to UTF-8 */.  
8ef0: 7a 56 61 6c 38 20 3d 20 73 71 6c 69 74 65 33 75  zVal8 = sqlite3u
8f00: 74 66 31 36 74 6f 38 28 7a 56 61 6c 2c 20 6e 29  tf16to8(zVal, n)
8f10: 3b 0a 20 20 69 66 28 20 21 7a 56 61 6c 38 20 29  ;.  if( !zVal8 )
8f20: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
8f30: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a  ITE_NOMEM;.  }..
8f40: 20 20 2f 2a 20 50 61 73 73 20 2d 31 20 61 73 20    /* Pass -1 as 
8f50: 74 68 65 20 6c 65 6e 67 74 68 20 6f 66 20 74 68  the length of th
8f60: 65 20 55 54 46 2d 38 20 73 74 72 69 6e 67 2e 20  e UTF-8 string. 
8f70: 49 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 64  It is guaranteed
8f80: 20 74 6f 20 62 65 0a 20 20 2a 2a 20 4e 55 4c 4c   to be.  ** NULL
8f90: 2d 74 65 72 6d 69 6e 61 74 65 64 20 62 79 20 73  -terminated by s
8fa0: 71 6c 69 74 65 33 75 74 66 31 36 74 6f 38 28 29  qlite3utf16to8()
8fb0: 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71  ..  */.  rc = sq
8fc0: 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 28  lite3_bind_text(
8fd0: 70 53 74 6d 74 2c 20 69 2c 20 7a 56 61 6c 38 2c  pStmt, i, zVal8,
8fe0: 20 2d 31 2c 20 65 43 6f 70 79 29 3b 0a 20 20 73   -1, eCopy);.  s
8ff0: 71 6c 69 74 65 46 72 65 65 28 66 69 6c 65 6e 61  qliteFree(filena
9000: 6d 65 38 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20  me8);..  return 
9010: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c  rc;.}../*.** sql
9020: 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c 0a 2a  ite3_bind_null.*
9030: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69  /.int sqlite3_bi
9040: 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f  nd_null(sqlite3_
9050: 73 74 6d 74 2a 2c 20 69 6e 74 20 69 50 61 72 6d  stmt*, int iParm
9060: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
9070: 74 65 33 5f 62 69 6e 64 28 70 53 74 6d 74 2c 20  te3_bind(pStmt, 
9080: 69 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 7d 0a 0a  i, 0, 0, 0);.}..
9090: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
90a0: 64 5f 69 6e 74 33 32 28 73 71 6c 69 74 65 33 5f  d_int32(sqlite3_
90b0: 73 74 6d 74 2a 2c 20 69 6e 74 20 69 50 61 72 6d  stmt*, int iParm
90c0: 2c 20 69 6e 74 20 69 56 61 6c 75 65 29 7b 0a 20  , int iValue){. 
90d0: 20 61 73 73 65 72 74 28 21 22 54 4f 44 4f 22 29   assert(!"TODO")
90e0: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ;.}.int sqlite3_
90f0: 62 69 6e 64 5f 69 6e 74 36 34 28 73 71 6c 69 74  bind_int64(sqlit
9100: 65 33 5f 73 74 6d 74 2a 2c 20 69 6e 74 20 69 50  e3_stmt*, int iP
9110: 61 72 6d 2c 20 6c 6f 6e 67 20 6c 6f 6e 67 20 69  arm, long long i
9120: 6e 74 20 69 56 61 6c 75 65 29 7b 0a 20 20 61 73  nt iValue){.  as
9130: 73 65 72 74 28 21 22 54 4f 44 4f 22 29 3b 0a 7d  sert(!"TODO");.}
9140: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
9150: 64 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33  d_double(sqlite3
9160: 5f 73 74 6d 74 2a 2c 20 69 6e 74 20 69 50 61 72  _stmt*, int iPar
9170: 6d 2c 20 64 6f 75 62 6c 65 20 69 56 61 6c 75 65  m, double iValue
9180: 29 7b 0a 20 20 61 73 73 65 72 74 28 21 22 54 4f  ){.  assert(!"TO
9190: 44 4f 22 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69  DO");.}.int sqli
91a0: 74 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 28 73 71  te3_bind_blob(sq
91b0: 6c 69 74 65 33 5f 73 74 6d 74 2a 2c 20 69 6e 74  lite3_stmt*, int
91c0: 20 69 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c   i, const void*,
91d0: 20 69 6e 74 20 6e 2c 20 69 6e 74 20 65 43 6f 70   int n, int eCop
91e0: 79 29 7b 0a 20 20 61 73 73 65 72 74 28 21 22 54  y){.  assert(!"T
91f0: 4f 44 4f 22 29 3b 0a 7d 0a 0a 0a 69 6e 74 20 73  ODO");.}...int s
9200: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f  qlite3_column_co
9210: 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  unt(sqlite3_stmt
9220: 2a 29 7b 0a 7d 0a 0a 69 6e 74 20 73 71 6c 69 74  *){.}..int sqlit
9230: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 28 73  e3_column_type(s
9240: 71 6c 69 74 65 33 5f 73 74 6d 74 2a 2c 69 6e 74  qlite3_stmt*,int
9250: 29 7b 0a 7d 0a 0a 63 6f 6e 73 74 20 63 68 61 72  ){.}..const char
9260: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
9270: 5f 64 65 63 6c 74 79 70 65 28 73 71 6c 69 74 65  _decltype(sqlite
9280: 33 5f 73 74 6d 74 2a 2c 69 6e 74 29 7b 0a 7d 0a  3_stmt*,int){.}.
9290: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
92a0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c  ite3_column_decl
92b0: 74 79 70 65 31 36 28 73 71 6c 69 74 65 33 5f 73  type16(sqlite3_s
92c0: 74 6d 74 2a 2c 69 6e 74 29 7b 0a 7d 0a 0a 63 6f  tmt*,int){.}..co
92d0: 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65  nst char *sqlite
92e0: 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 73 71  3_column_name(sq
92f0: 6c 69 74 65 33 5f 73 74 6d 74 2a 2c 69 6e 74 29  lite3_stmt*,int)
9300: 7b 0a 7d 0a 0a 63 6f 6e 73 74 20 76 6f 69 64 20  {.}..const void 
9310: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  *sqlite3_column_
9320: 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73  name16(sqlite3_s
9330: 74 6d 74 2a 2c 69 6e 74 29 7b 0a 7d 0a 0a 63 6f  tmt*,int){.}..co
9340: 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61  nst unsigned cha
9350: 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  r *sqlite3_colum
9360: 6e 5f 64 61 74 61 28 73 71 6c 69 74 65 33 5f 73  n_data(sqlite3_s
9370: 74 6d 74 2a 2c 69 6e 74 29 7b 0a 7d 0a 0a 63 6f  tmt*,int){.}..co
9380: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65  nst void *sqlite
9390: 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 31 36 28  3_column_data16(
93a0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 2c 69 6e  sqlite3_stmt*,in
93b0: 74 29 7b 0a 7d 0a 0a 69 6e 74 20 73 71 6c 69 74  t){.}..int sqlit
93c0: 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 28  e3_column_bytes(
93d0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 2c 69 6e  sqlite3_stmt*,in
93e0: 74 29 7b 0a 7d 0a 0a 6c 6f 6e 67 20 6c 6f 6e 67  t){.}..long long
93f0: 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c   int sqlite3_col
9400: 75 6d 6e 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f  umn_int(sqlite3_
9410: 73 74 6d 74 2a 2c 69 6e 74 29 7b 0a 7d 0a 0a 64  stmt*,int){.}..d
9420: 6f 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 63 6f  ouble sqlite3_co
9430: 6c 75 6d 6e 5f 66 6c 6f 61 74 28 73 71 6c 69 74  lumn_float(sqlit
9440: 65 33 5f 73 74 6d 74 2a 2c 69 6e 74 29 7b 0a 7d  e3_stmt*,int){.}
9450: 0a 0a 23 65 6e 64 69 66 0a                       ..#endif.