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

Artifact 4b82d7e78f4c9799343b02740a5ba9768d5e464d:


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