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

Artifact b21019084b93fe685a8a25217d01f6958584ae9b:


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 36 38 20 32 30 30 32 2f 30 33 2f  ,v 1.68 2002/03/
0280: 30 36 20 32 32 3a 30 31 3a 33 36 20 64 72 68 20  06 22:01:36 drh 
0290: 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64  Exp $.*/.#includ
02a0: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a  e "sqliteInt.h".
02b0: 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a  #include "os.h".
02c0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74  ./*.** This is t
02d0: 68 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74  he callback rout
02e0: 69 6e 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65  ine for the code
02f0: 20 74 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65   that initialize
0300: 73 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73  s the.** databas
0310: 65 2e 20 20 53 65 65 20 73 71 6c 69 74 65 49 6e  e.  See sqliteIn
0320: 69 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20 61  it() below for a
0330: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d  dditional inform
0340: 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63  ation..**.** Eac
0350: 68 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61  h callback conta
0360: 69 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  ins the followin
0370: 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a  g information:.*
0380: 2a 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 30 5d  *.**     argv[0]
0390: 20 3d 20 22 66 69 6c 65 2d 66 6f 72 6d 61 74 22   = "file-format"
03a0: 20 6f 72 20 22 73 63 68 65 6d 61 2d 63 6f 6f 6b   or "schema-cook
03b0: 69 65 22 20 6f 72 20 22 74 61 62 6c 65 22 20 6f  ie" or "table" o
03c0: 72 20 22 69 6e 64 65 78 22 0a 2a 2a 20 20 20 20  r "index".**    
03d0: 20 61 72 67 76 5b 31 5d 20 3d 20 74 61 62 6c 65   argv[1] = table
03e0: 20 6f 72 20 69 6e 64 65 78 20 6e 61 6d 65 20 6f   or index name o
03f0: 72 20 6d 65 74 61 20 73 74 61 74 65 6d 65 6e 74  r meta statement
0400: 20 74 79 70 65 2e 0a 2a 2a 20 20 20 20 20 61 72   type..**     ar
0410: 67 76 5b 32 5d 20 3d 20 72 6f 6f 74 20 70 61 67  gv[2] = root pag
0420: 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 61 62  e number for tab
0430: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 4e 55  le or index.  NU
0440: 4c 4c 20 66 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20  LL for meta..** 
0450: 20 20 20 20 61 72 67 76 5b 33 5d 20 3d 20 53 51      argv[3] = SQ
0460: 4c 20 63 72 65 61 74 65 20 73 74 61 74 65 6d 65  L create stateme
0470: 6e 74 20 66 6f 72 20 74 68 65 20 74 61 62 6c 65  nt for the table
0480: 20 6f 72 20 69 6e 64 65 78 0a 2a 2a 0a 2a 2f 0a   or index.**.*/.
0490: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
04a0: 65 4f 70 65 6e 43 62 28 76 6f 69 64 20 2a 70 44  eOpenCb(void *pD
04b0: 62 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61  b, int argc, cha
04c0: 72 20 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a  r **argv, char *
04d0: 2a 61 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20 20 73  *azColName){.  s
04e0: 71 6c 69 74 65 20 2a 64 62 20 3d 20 28 73 71 6c  qlite *db = (sql
04f0: 69 74 65 2a 29 70 44 62 3b 0a 20 20 50 61 72 73  ite*)pDb;.  Pars
0500: 65 20 73 50 61 72 73 65 3b 0a 20 20 69 6e 74 20  e sParse;.  int 
0510: 6e 45 72 72 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20  nErr = 0;..  /* 
0520: 54 4f 44 4f 3a 20 44 6f 20 73 6f 6d 65 20 76 61  TODO: Do some va
0530: 6c 69 64 69 74 79 20 63 68 65 63 6b 73 20 6f 6e  lidity checks on
0540: 20 61 6c 6c 20 66 69 65 6c 64 73 2e 20 20 49 6e   all fields.  In
0550: 20 70 61 72 74 69 63 75 6c 61 72 2c 0a 20 20 2a   particular,.  *
0560: 2a 20 6d 61 6b 65 20 73 75 72 65 20 66 69 65 6c  * make sure fiel
0570: 64 73 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69  ds do not contai
0580: 6e 20 4e 55 4c 4c 73 2e 20 4f 74 68 65 72 77 69  n NULLs. Otherwi
0590: 73 65 20 77 65 20 6d 69 67 68 74 20 63 6f 72 65  se we might core
05a0: 0a 20 20 2a 2a 20 77 68 65 6e 20 61 74 74 65 6d  .  ** when attem
05b0: 70 74 69 6e 67 20 74 6f 20 69 6e 69 74 69 61 6c  pting to initial
05c0: 69 7a 65 20 66 72 6f 6d 20 61 20 63 6f 72 72 75  ize from a corru
05d0: 70 74 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  pt database file
05e0: 2e 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20  . */..  assert( 
05f0: 61 72 67 63 3d 3d 34 20 29 3b 0a 20 20 73 77 69  argc==4 );.  swi
0600: 74 63 68 28 20 61 72 67 76 5b 30 5d 5b 30 5d 20  tch( argv[0][0] 
0610: 29 7b 0a 20 20 20 20 63 61 73 65 20 27 63 27 3a  ){.    case 'c':
0620: 20 7b 20 20 2f 2a 20 52 65 63 6f 6d 6d 65 6e 64   {  /* Recommend
0630: 65 64 20 70 61 67 65 72 20 63 61 63 68 65 20 73  ed pager cache s
0640: 69 7a 65 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74  ize */.      int
0650: 20 73 69 7a 65 20 3d 20 61 74 6f 69 28 61 72 67   size = atoi(arg
0660: 76 5b 33 5d 29 3b 0a 20 20 20 20 20 20 69 66 28  v[3]);.      if(
0670: 20 73 69 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65   size==0 ){ size
0680: 20 3d 20 4d 41 58 5f 50 41 47 45 53 3b 20 7d 0a   = MAX_PAGES; }.
0690: 20 20 20 20 20 20 64 62 2d 3e 63 61 63 68 65 5f        db->cache_
06a0: 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a 20 20 20  size = size;.   
06b0: 20 20 20 73 71 6c 69 74 65 42 74 72 65 65 53 65     sqliteBtreeSe
06c0: 74 43 61 63 68 65 53 69 7a 65 28 64 62 2d 3e 70  tCacheSize(db->p
06d0: 42 65 2c 20 73 69 7a 65 29 3b 0a 20 20 20 20 20  Be, size);.     
06e0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
06f0: 20 20 63 61 73 65 20 27 66 27 3a 20 7b 20 20 2f    case 'f': {  /
0700: 2a 20 46 69 6c 65 20 66 6f 72 6d 61 74 20 2a 2f  * File format */
0710: 0a 20 20 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f  .      db->file_
0720: 66 6f 72 6d 61 74 20 3d 20 61 74 6f 69 28 61 72  format = atoi(ar
0730: 67 76 5b 33 5d 29 3b 0a 20 20 20 20 20 20 62 72  gv[3]);.      br
0740: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  eak;.    }.    c
0750: 61 73 65 20 27 73 27 3a 20 7b 20 2f 2a 20 53 63  ase 's': { /* Sc
0760: 68 65 6d 61 20 63 6f 6f 6b 69 65 20 2a 2f 0a 20  hema cookie */. 
0770: 20 20 20 20 20 64 62 2d 3e 73 63 68 65 6d 61 5f       db->schema_
0780: 63 6f 6f 6b 69 65 20 3d 20 61 74 6f 69 28 61 72  cookie = atoi(ar
0790: 67 76 5b 33 5d 29 3b 0a 20 20 20 20 20 20 64 62  gv[3]);.      db
07a0: 2d 3e 6e 65 78 74 5f 63 6f 6f 6b 69 65 20 3d 20  ->next_cookie = 
07b0: 64 62 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69  db->schema_cooki
07c0: 65 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  e;.      break;.
07d0: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 27      }.    case '
07e0: 76 27 3a 0a 20 20 20 20 63 61 73 65 20 27 69 27  v':.    case 'i'
07f0: 3a 0a 20 20 20 20 63 61 73 65 20 27 74 27 3a 20  :.    case 't': 
0800: 7b 20 20 2f 2a 20 43 52 45 41 54 45 20 54 41 42  {  /* CREATE TAB
0810: 4c 45 2c 20 43 52 45 41 54 45 20 49 4e 44 45 58  LE, CREATE INDEX
0820: 2c 20 6f 72 20 43 52 45 41 54 45 20 56 49 45 57  , or CREATE VIEW
0830: 20 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a 20   statements */. 
0840: 20 20 20 20 20 69 66 28 20 61 72 67 76 5b 33 5d       if( argv[3]
0850: 20 26 26 20 61 72 67 76 5b 33 5d 5b 30 5d 20 29   && argv[3][0] )
0860: 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 43 61 6c  {.        /* Cal
0870: 6c 20 74 68 65 20 70 61 72 73 65 72 20 74 6f 20  l the parser to 
0880: 70 72 6f 63 65 73 73 20 61 20 43 52 45 41 54 45  process a CREATE
0890: 20 54 41 42 4c 45 2c 20 49 4e 44 45 58 20 6f 72   TABLE, INDEX or
08a0: 20 56 49 45 57 2e 0a 20 20 20 20 20 20 20 20 2a   VIEW..        *
08b0: 2a 20 42 75 74 20 62 65 63 61 75 73 65 20 73 50  * But because sP
08c0: 61 72 73 65 2e 69 6e 69 74 46 6c 61 67 20 69 73  arse.initFlag is
08d0: 20 73 65 74 20 74 6f 20 31 2c 20 6e 6f 20 56 44   set to 1, no VD
08e0: 42 45 20 63 6f 64 65 20 69 73 20 67 65 6e 65 72  BE code is gener
08f0: 61 74 65 64 0a 20 20 20 20 20 20 20 20 2a 2a 20  ated.        ** 
0900: 6f 72 20 65 78 65 63 75 74 65 64 2e 20 20 41 6c  or executed.  Al
0910: 6c 20 74 68 65 20 70 61 72 73 65 72 20 64 6f 65  l the parser doe
0920: 73 20 69 73 20 62 75 69 6c 64 20 74 68 65 20 69  s is build the i
0930: 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a 20 20 20  nternal data.   
0940: 20 20 20 20 20 2a 2a 20 73 74 72 75 63 74 75 72       ** structur
0950: 65 73 20 74 68 61 74 20 64 65 73 63 72 69 62 65  es that describe
0960: 20 74 68 65 20 74 61 62 6c 65 2c 20 69 6e 64 65   the table, inde
0970: 78 2c 20 6f 72 20 76 69 65 77 2e 0a 20 20 20 20  x, or view..    
0980: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d      */.        m
0990: 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20 30  emset(&sParse, 0
09a0: 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29  , sizeof(sParse)
09b0: 29 3b 0a 20 20 20 20 20 20 20 20 73 50 61 72 73  );.        sPars
09c0: 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 20 20 20  e.db = db;.     
09d0: 20 20 20 73 50 61 72 73 65 2e 69 6e 69 74 46 6c     sParse.initFl
09e0: 61 67 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20  ag = 1;.        
09f0: 73 50 61 72 73 65 2e 6e 65 77 54 6e 75 6d 20 3d  sParse.newTnum =
0a00: 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a   atoi(argv[2]);.
0a10: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 52 75          sqliteRu
0a20: 6e 50 61 72 73 65 72 28 26 73 50 61 72 73 65 2c  nParser(&sParse,
0a30: 20 61 72 67 76 5b 33 5d 2c 20 30 29 3b 0a 20 20   argv[3], 0);.  
0a40: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
0a50: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51 4c     /* If the SQL
0a60: 20 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e 6b   column is blank
0a70: 20 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69   it means this i
0a80: 73 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 0a  s an index that.
0a90: 20 20 20 20 20 20 20 20 2a 2a 20 77 61 73 20 63          ** was c
0aa0: 72 65 61 74 65 64 20 74 6f 20 62 65 20 74 68 65  reated to be the
0ab0: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20   PRIMARY KEY or 
0ac0: 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e 49  to fulfill a UNI
0ad0: 51 55 45 0a 20 20 20 20 20 20 20 20 2a 2a 20 63  QUE.        ** c
0ae0: 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 61 20  onstraint for a 
0af0: 43 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20 54  CREATE TABLE.  T
0b00: 68 65 20 69 6e 64 65 78 20 73 68 6f 75 6c 64 20  he index should 
0b10: 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20 20  have already.   
0b20: 20 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72 65       ** been cre
0b30: 61 74 65 64 20 77 68 65 6e 20 77 65 20 70 72 6f  ated when we pro
0b40: 63 65 73 73 65 64 20 74 68 65 20 43 52 45 41 54  cessed the CREAT
0b50: 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77 65  E TABLE.  All we
0b60: 20 68 61 76 65 0a 20 20 20 20 20 20 20 20 2a 2a   have.        **
0b70: 20 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20 72   to do here is r
0b80: 65 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20 70  ecord the root p
0b90: 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74  age number for t
0ba0: 68 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20 20  hat index..     
0bb0: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 49 6e     */.        In
0bc0: 64 65 78 20 2a 70 49 6e 64 65 78 20 3d 20 73 71  dex *pIndex = sq
0bd0: 6c 69 74 65 46 69 6e 64 49 6e 64 65 78 28 64 62  liteFindIndex(db
0be0: 2c 20 61 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20  , argv[1]);.    
0bf0: 20 20 20 20 69 66 28 20 70 49 6e 64 65 78 3d 3d      if( pIndex==
0c00: 30 20 7c 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75  0 || pIndex->tnu
0c10: 6d 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  m!=0 ){.        
0c20: 20 20 2f 2a 20 54 68 69 73 20 63 61 6e 20 6f 63    /* This can oc
0c30: 63 75 72 20 69 66 20 74 68 65 72 65 20 65 78 69  cur if there exi
0c40: 73 74 73 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20  sts an index on 
0c50: 61 20 54 45 4d 50 20 74 61 62 6c 65 20 77 68 69  a TEMP table whi
0c60: 63 68 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20  ch.          ** 
0c70: 68 61 73 20 74 68 65 20 73 61 6d 65 20 6e 61 6d  has the same nam
0c80: 65 20 61 73 20 61 6e 6f 74 68 65 72 20 69 6e 64  e as another ind
0c90: 65 78 20 6f 6e 20 61 20 70 65 72 6d 61 6e 65 6e  ex on a permanen
0ca0: 74 20 69 6e 64 65 78 2e 20 20 53 69 6e 63 65 0a  t index.  Since.
0cb0: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65            ** the
0cc0: 20 70 65 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65   permanent table
0cd0: 20 69 73 20 68 69 64 64 65 6e 20 62 79 20 74 68   is hidden by th
0ce0: 65 20 54 45 4d 50 20 74 61 62 6c 65 2c 20 77 65  e TEMP table, we
0cf0: 20 63 61 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20   can also.      
0d00: 20 20 20 20 2a 2a 20 73 61 66 65 6c 79 20 69 67      ** safely ig
0d10: 6e 6f 72 65 20 74 68 65 20 69 6e 64 65 78 20 6f  nore the index o
0d20: 6e 20 74 68 65 20 70 65 72 6d 61 6e 65 6e 74 20  n the permanent 
0d30: 74 61 62 6c 65 2e 0a 20 20 20 20 20 20 20 20 20  table..         
0d40: 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 2f 2a   */.          /*
0d50: 20 44 6f 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b 0a   Do Nothing */;.
0d60: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20          }else{. 
0d70: 20 20 20 20 20 20 20 20 20 70 49 6e 64 65 78 2d           pIndex-
0d80: 3e 74 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72 67  >tnum = atoi(arg
0d90: 76 5b 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 7d  v[2]);.        }
0da0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62  .      }.      b
0db0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
0dc0: 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20  default: {.     
0dd0: 20 2f 2a 20 54 68 69 73 20 63 61 6e 20 6e 6f 74   /* This can not
0de0: 20 68 61 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20   happen! */.    
0df0: 20 20 6e 45 72 72 20 3d 20 31 3b 0a 20 20 20 20    nErr = 1;.    
0e00: 20 20 61 73 73 65 72 74 28 20 6e 45 72 72 3d 3d    assert( nErr==
0e10: 30 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20  0 );.    }.  }. 
0e20: 20 72 65 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a   return nErr;.}.
0e30: 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74  ./*.** Attempt t
0e40: 6f 20 72 65 61 64 20 74 68 65 20 64 61 74 61 62  o read the datab
0e50: 61 73 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69  ase schema and i
0e60: 6e 69 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e  nitialize intern
0e70: 61 6c 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63  al.** data struc
0e80: 74 75 72 65 73 2e 20 20 52 65 74 75 72 6e 20 6f  tures.  Return o
0e90: 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45  ne of the SQLITE
0ea0: 5f 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74 6f  _ error codes to
0eb0: 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20 73 75 63  .** indicate suc
0ec0: 63 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65 2e  cess or failure.
0ed0: 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65  .**.** After the
0ee0: 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 69   database is ini
0ef0: 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 53 51  tialized, the SQ
0f00: 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64  LITE_Initialized
0f10: 0a 2a 2a 20 62 69 74 20 69 73 20 73 65 74 20 69  .** bit is set i
0f20: 6e 20 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c  n the flags fiel
0f30: 64 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20  d of the sqlite 
0f40: 73 74 72 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a  structure.  An.*
0f50: 2a 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64  * attempt is mad
0f60: 65 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20  e to initialize 
0f70: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 73 20  the database as 
0f80: 73 6f 6f 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73  soon as it.** is
0f90: 20 6f 70 65 6e 65 64 2e 20 20 49 66 20 74 68 61   opened.  If tha
0fa0: 74 20 66 61 69 6c 73 20 28 70 65 72 68 61 70 73  t fails (perhaps
0fb0: 20 62 65 63 61 75 73 65 20 61 6e 6f 74 68 65 72   because another
0fc0: 20 70 72 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20   process.** has 
0fd0: 74 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65  the sqlite_maste
0fe0: 72 20 74 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20  r table locked) 
0ff0: 74 68 61 6e 20 61 6e 6f 74 68 65 72 20 61 74 74  than another att
1000: 65 6d 70 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20  empt.** is made 
1010: 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74  the first time t
1020: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61  he database is a
1030: 63 63 65 73 73 65 64 2e 0a 2a 2f 0a 73 74 61 74  ccessed..*/.stat
1040: 69 63 20 69 6e 74 20 73 71 6c 69 74 65 49 6e 69  ic int sqliteIni
1050: 74 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 63 68  t(sqlite *db, ch
1060: 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a  ar **pzErrMsg){.
1070: 20 20 56 64 62 65 20 2a 76 64 62 65 3b 0a 20 20    Vdbe *vdbe;.  
1080: 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a 0a 20 20  int rc;..  /*.  
1090: 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61  ** The master da
10a0: 74 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73  tabase table has
10b0: 20 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b   a structure lik
10c0: 65 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74  e this.  */.  st
10d0: 61 74 69 63 20 63 68 61 72 20 6d 61 73 74 65 72  atic char master
10e0: 5f 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20  _schema[] = .   
10f0: 20 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20    "CREATE TABLE 
1100: 22 20 4d 41 53 54 45 52 5f 4e 41 4d 45 20 22 20  " MASTER_NAME " 
1110: 28 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70  (\n".     "  typ
1120: 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20  e text,\n".     
1130: 22 20 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22  "  name text,\n"
1140: 0a 20 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d  .     "  tbl_nam
1150: 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20  e text,\n".     
1160: 22 20 20 72 6f 6f 74 70 61 67 65 20 69 6e 74 65  "  rootpage inte
1170: 67 65 72 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ger,\n".     "  
1180: 73 71 6c 20 74 65 78 74 5c 6e 22 0a 20 20 20 20  sql text\n".    
1190: 20 22 29 22 0a 20 20 3b 0a 0a 20 20 2f 2a 20 54   ")".  ;..  /* T
11a0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 56 44 42  he following VDB
11b0: 45 20 70 72 6f 67 72 61 6d 20 69 73 20 75 73 65  E program is use
11c0: 64 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20  d to initialize 
11d0: 74 68 65 20 69 6e 74 65 72 6e 61 6c 0a 20 20 2a  the internal.  *
11e0: 2a 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64  * structure hold
11f0: 69 6e 67 20 74 68 65 20 74 61 62 6c 65 73 20 61  ing the tables a
1200: 6e 64 20 69 6e 64 65 78 65 73 20 6f 66 20 74 68  nd indexes of th
1210: 65 20 64 61 74 61 62 61 73 65 2e 0a 20 20 2a 2a  e database..  **
1220: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 63 6f   The database co
1230: 6e 74 61 69 6e 73 20 61 20 73 70 65 63 69 61 6c  ntains a special
1240: 20 74 61 62 6c 65 20 6e 61 6d 65 64 20 22 73 71   table named "sq
1250: 6c 69 74 65 5f 6d 61 73 74 65 72 22 0a 20 20 2a  lite_master".  *
1260: 2a 20 64 65 66 69 6e 65 64 20 61 73 20 66 6f 6c  * defined as fol
1270: 6c 6f 77 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20  lows:.  **.  ** 
1280: 20 20 20 43 52 45 41 54 45 20 54 41 42 4c 45 20     CREATE TABLE 
1290: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 28 0a  sqlite_master (.
12a0: 20 20 2a 2a 20 20 20 20 20 20 20 20 74 79 70 65    **        type
12b0: 20 20 20 20 20 20 20 74 65 78 74 2c 20 20 20 20         text,    
12c0: 2d 2d 20 20 45 69 74 68 65 72 20 22 74 61 62 6c  --  Either "tabl
12d0: 65 22 20 6f 72 20 22 69 6e 64 65 78 22 20 6f 72  e" or "index" or
12e0: 20 22 6d 65 74 61 22 0a 20 20 2a 2a 20 20 20 20   "meta".  **    
12f0: 20 20 20 20 6e 61 6d 65 20 20 20 20 20 20 20 74      name       t
1300: 65 78 74 2c 20 20 20 20 2d 2d 20 20 4e 61 6d 65  ext,    --  Name
1310: 20 6f 66 20 74 61 62 6c 65 20 6f 72 20 69 6e 64   of table or ind
1320: 65 78 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 74  ex.  **        t
1330: 62 6c 5f 6e 61 6d 65 20 20 20 74 65 78 74 2c 20  bl_name   text, 
1340: 20 20 20 2d 2d 20 20 41 73 73 6f 63 69 61 74 65     --  Associate
1350: 64 20 74 61 62 6c 65 20 0a 20 20 2a 2a 20 20 20  d table .  **   
1360: 20 20 20 20 20 72 6f 6f 74 70 61 67 65 20 20 20       rootpage   
1370: 69 6e 74 65 67 65 72 2c 20 2d 2d 20 20 54 68 65  integer, --  The
1380: 20 69 6e 74 65 67 65 72 20 70 61 67 65 20 6e 75   integer page nu
1390: 6d 62 65 72 20 6f 66 20 72 6f 6f 74 20 70 61 67  mber of root pag
13a0: 65 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 73 71  e.  **        sq
13b0: 6c 20 20 20 20 20 20 20 20 74 65 78 74 20 20 20  l        text   
13c0: 20 20 2d 2d 20 20 54 68 65 20 43 52 45 41 54 45    --  The CREATE
13d0: 20 73 74 61 74 65 6d 65 6e 74 20 66 6f 72 20 74   statement for t
13e0: 68 69 73 20 6f 62 6a 65 63 74 0a 20 20 2a 2a 20  his object.  ** 
13f0: 20 20 20 29 3b 0a 20 20 2a 2a 0a 20 20 2a 2a 20     );.  **.  ** 
1400: 54 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65  The sqlite_maste
1410: 72 20 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73  r table contains
1420: 20 61 20 73 69 6e 67 6c 65 20 65 6e 74 72 79 20   a single entry 
1430: 66 6f 72 20 65 61 63 68 20 74 61 62 6c 65 0a 20  for each table. 
1440: 20 2a 2a 20 61 6e 64 20 65 61 63 68 20 69 6e 64   ** and each ind
1450: 65 78 2e 20 20 54 68 65 20 22 74 79 70 65 22 20  ex.  The "type" 
1460: 63 6f 6c 75 6d 6e 20 74 65 6c 6c 73 20 77 68 65  column tells whe
1470: 74 68 65 72 20 74 68 65 20 65 6e 74 72 79 20 69  ther the entry i
1480: 73 0a 20 20 2a 2a 20 61 20 74 61 62 6c 65 20 6f  s.  ** a table o
1490: 72 20 69 6e 64 65 78 2e 20 20 54 68 65 20 22 6e  r index.  The "n
14a0: 61 6d 65 22 20 63 6f 6c 75 6d 6e 20 69 73 20 74  ame" column is t
14b0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6f  he name of the o
14c0: 62 6a 65 63 74 2e 0a 20 20 2a 2a 20 54 68 65 20  bject..  ** The 
14d0: 22 74 62 6c 5f 6e 61 6d 65 22 20 69 73 20 74 68  "tbl_name" is th
14e0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 61 73  e name of the as
14f0: 73 6f 63 69 61 74 65 64 20 74 61 62 6c 65 2e 20  sociated table. 
1500: 20 46 6f 72 20 74 61 62 6c 65 73 2c 0a 20 20 2a   For tables,.  *
1510: 2a 20 74 68 65 20 74 62 6c 5f 6e 61 6d 65 20 63  * the tbl_name c
1520: 6f 6c 75 6d 6e 20 69 73 20 61 6c 77 61 79 73 20  olumn is always 
1530: 74 68 65 20 73 61 6d 65 20 61 73 20 6e 61 6d 65  the same as name
1540: 2e 20 20 46 6f 72 20 69 6e 64 69 63 65 73 2c 20  .  For indices, 
1550: 74 68 65 0a 20 20 2a 2a 20 74 62 6c 5f 6e 61 6d  the.  ** tbl_nam
1560: 65 20 63 6f 6c 75 6d 6e 20 63 6f 6e 74 61 69 6e  e column contain
1570: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  s the name of th
1580: 65 20 74 61 62 6c 65 20 74 68 61 74 20 74 68 65  e table that the
1590: 20 69 6e 64 65 78 0a 20 20 2a 2a 20 69 6e 64 65   index.  ** inde
15a0: 78 65 73 2e 20 20 54 68 65 20 22 72 6f 6f 74 70  xes.  The "rootp
15b0: 61 67 65 22 20 63 6f 6c 75 6d 6e 20 68 6f 6c 64  age" column hold
15c0: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
15d0: 74 68 65 20 72 6f 6f 74 20 70 61 67 65 0a 20 20  the root page.  
15e0: 2a 2a 20 66 6f 72 20 74 68 65 20 62 2d 74 72 65  ** for the b-tre
15f0: 65 20 66 6f 72 20 74 68 65 20 74 61 62 6c 65 20  e for the table 
1600: 6f 72 20 69 6e 64 65 78 2e 20 20 46 69 6e 61 6c  or index.  Final
1610: 6c 79 2c 20 74 68 65 20 22 73 71 6c 22 20 63 6f  ly, the "sql" co
1620: 6c 75 6d 6e 0a 20 20 2a 2a 20 63 6f 6e 74 61 69  lumn.  ** contai
1630: 6e 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20  ns the complete 
1640: 74 65 78 74 20 6f 66 20 74 68 65 20 43 52 45 41  text of the CREA
1650: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41  TE TABLE or CREA
1660: 54 45 20 49 4e 44 45 58 0a 20 20 2a 2a 20 73 74  TE INDEX.  ** st
1670: 61 74 65 6d 65 6e 74 20 74 68 61 74 20 6f 72 69  atement that ori
1680: 67 69 6e 61 6c 6c 79 20 63 72 65 61 74 65 64 20  ginally created 
1690: 74 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e 64  the table or ind
16a0: 65 78 2e 20 20 49 66 20 61 6e 20 69 6e 64 65 78  ex.  If an index
16b0: 0a 20 20 2a 2a 20 77 61 73 20 63 72 65 61 74 65  .  ** was create
16c0: 64 20 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 50  d to fulfill a P
16d0: 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20 55 4e  RIMARY KEY or UN
16e0: 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20  IQUE constraint 
16f0: 6f 6e 20 61 20 74 61 62 6c 65 2c 0a 20 20 2a 2a  on a table,.  **
1700: 20 74 68 65 6e 20 74 68 65 20 22 73 71 6c 22 20   then the "sql" 
1710: 63 6f 6c 75 6d 6e 20 69 73 20 4e 55 4c 4c 2e 0a  column is NULL..
1720: 20 20 2a 2a 0a 20 20 2a 2a 20 49 6e 20 66 6f 72    **.  ** In for
1730: 6d 61 74 20 31 2c 20 65 6e 74 72 69 65 73 20 69  mat 1, entries i
1740: 6e 20 74 68 65 20 73 71 6c 69 74 65 5f 6d 61 73  n the sqlite_mas
1750: 74 65 72 20 74 61 62 6c 65 20 61 72 65 20 69 6e  ter table are in
1760: 20 61 20 72 61 6e 64 6f 6d 0a 20 20 2a 2a 20 6f   a random.  ** o
1770: 72 64 65 72 2e 20 20 54 77 6f 20 70 61 73 73 65  rder.  Two passe
1780: 73 20 6d 75 73 74 20 62 65 20 6d 61 64 65 20 74  s must be made t
1790: 68 72 6f 75 67 68 20 74 68 65 20 74 61 62 6c 65  hrough the table
17a0: 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 0a 20   to initialize. 
17b0: 20 2a 2a 20 69 6e 74 65 72 6e 61 6c 20 64 61 74   ** internal dat
17c0: 61 20 73 74 72 75 63 74 75 72 65 73 2e 20 20 54  a structures.  T
17d0: 68 65 20 66 69 72 73 74 20 70 61 73 73 20 72 65  he first pass re
17e0: 61 64 73 20 74 61 62 6c 65 20 64 65 66 69 6e 69  ads table defini
17f0: 74 69 6f 6e 73 0a 20 20 2a 2a 20 61 6e 64 20 74  tions.  ** and t
1800: 68 65 20 73 65 63 6f 6e 64 20 70 61 73 73 20 72  he second pass r
1810: 65 61 64 20 69 6e 64 65 78 20 64 65 66 69 6e 69  ead index defini
1820: 74 69 6f 6e 73 2e 20 20 48 61 76 69 6e 67 20 74  tions.  Having t
1830: 77 6f 20 70 61 73 73 65 73 0a 20 20 2a 2a 20 69  wo passes.  ** i
1840: 6e 73 75 72 65 73 20 74 68 61 74 20 69 6e 64 69  nsures that indi
1850: 63 65 73 20 61 70 70 65 61 72 20 61 66 74 65 72  ces appear after
1860: 20 74 68 65 69 72 20 74 61 62 6c 65 73 2e 0a 20   their tables.. 
1870: 20 2a 2a 0a 20 20 2a 2a 20 49 6e 20 66 6f 72 6d   **.  ** In form
1880: 61 74 20 32 2c 20 65 6e 74 72 69 65 73 20 61 70  at 2, entries ap
1890: 70 65 61 72 20 69 6e 20 63 68 72 6f 6e 6f 6c 6f  pear in chronolo
18a0: 67 69 63 61 6c 20 6f 72 64 65 72 2e 20 20 4f 6e  gical order.  On
18b0: 6c 79 20 61 20 73 69 6e 67 6c 65 0a 20 20 2a 2a  ly a single.  **
18c0: 20 70 61 73 73 20 6e 65 65 64 73 20 74 6f 20 62   pass needs to b
18d0: 65 20 6d 61 64 65 20 74 68 72 6f 75 67 68 20 74  e made through t
18e0: 68 65 20 74 61 62 6c 65 20 73 69 6e 63 65 20 65  he table since e
18f0: 76 65 72 79 74 68 69 6e 67 20 77 69 6c 6c 20 62  verything will b
1900: 65 0a 20 20 2a 2a 20 69 6e 20 74 68 65 20 77 72  e.  ** in the wr
1910: 69 74 65 20 6f 72 64 65 72 2e 20 20 56 49 45 57  ite order.  VIEW
1920: 73 20 6d 61 79 20 6f 6e 6c 79 20 6f 63 63 75 72  s may only occur
1930: 20 69 6e 20 66 6f 72 6d 61 74 20 32 2e 0a 20 20   in format 2..  
1940: 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66 6f 6c 6c  **.  ** The foll
1950: 6f 77 69 6e 67 20 70 72 6f 67 72 61 6d 20 69 6e  owing program in
1960: 76 6f 6b 65 73 20 69 74 73 20 63 61 6c 6c 62 61  vokes its callba
1970: 63 6b 20 6f 6e 20 74 68 65 20 53 51 4c 20 66 6f  ck on the SQL fo
1980: 72 20 65 61 63 68 0a 20 20 2a 2a 20 74 61 62 6c  r each.  ** tabl
1990: 65 20 74 68 65 6e 20 67 6f 65 73 20 62 61 63 6b  e then goes back
19a0: 20 61 6e 64 20 69 6e 76 6f 6b 65 73 20 74 68 65   and invokes the
19b0: 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 20 74 68 65   callback on the
19c0: 0a 20 20 2a 2a 20 53 51 4c 20 66 6f 72 20 65 61  .  ** SQL for ea
19d0: 63 68 20 69 6e 64 65 78 2e 20 20 54 68 65 20 63  ch index.  The c
19e0: 61 6c 6c 62 61 63 6b 20 77 69 6c 6c 20 69 6e 76  allback will inv
19f0: 6f 6b 65 20 74 68 65 0a 20 20 2a 2a 20 70 61 72  oke the.  ** par
1a00: 73 65 72 20 74 6f 20 62 75 69 6c 64 20 74 68 65  ser to build the
1a10: 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73   internal repres
1a20: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 0a  entation of the.
1a30: 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 73 63    ** database sc
1a40: 68 65 6d 65 2e 0a 20 20 2a 2f 0a 20 20 73 74 61  heme..  */.  sta
1a50: 74 69 63 20 56 64 62 65 4f 70 20 69 6e 69 74 50  tic VdbeOp initP
1a60: 72 6f 67 5b 5d 20 3d 20 7b 0a 20 20 20 20 2f 2a  rog[] = {.    /*
1a70: 20 53 65 6e 64 20 74 68 65 20 66 69 6c 65 20 66   Send the file f
1a80: 6f 72 6d 61 74 20 74 6f 20 74 68 65 20 63 61 6c  ormat to the cal
1a90: 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 0a 20 20  lback routine.  
1aa0: 20 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 4f 70    */.    { OP_Op
1ab0: 65 6e 2c 20 20 20 20 20 20 20 30 2c 20 32 2c 20  en,       0, 2, 
1ac0: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74   0},.    { OP_St
1ad0: 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c 20  ring,     0, 0, 
1ae0: 20 22 66 69 6c 65 2d 66 6f 72 6d 61 74 22 7d 2c   "file-format"},
1af0: 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e 67  .    { OP_String
1b00: 2c 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c  ,     0, 0,  0},
1b10: 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e 67  .    { OP_String
1b20: 2c 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c  ,     0, 0,  0},
1b30: 0a 20 20 20 20 7b 20 4f 50 5f 52 65 61 64 43 6f  .    { OP_ReadCo
1b40: 6f 6b 69 65 2c 20 30 2c 20 31 2c 20 20 30 7d 2c  okie, 0, 1,  0},
1b50: 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61  .    { OP_Callba
1b60: 63 6b 2c 20 20 20 34 2c 20 30 2c 20 20 30 7d 2c  ck,   4, 0,  0},
1b70: 0a 0a 20 20 20 20 2f 2a 20 53 65 6e 64 20 74 68  ..    /* Send th
1b80: 65 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 70 61  e recommended pa
1b90: 67 65 72 20 63 61 63 68 65 20 73 69 7a 65 20 74  ger cache size t
1ba0: 6f 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 72  o the callback r
1bb0: 6f 75 74 69 6e 65 0a 20 20 20 20 2a 2f 0a 20 20  outine.    */.  
1bc0: 20 20 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20    { OP_String,  
1bd0: 20 20 20 30 2c 20 30 2c 20 20 22 63 61 63 68 65     0, 0,  "cache
1be0: 2d 73 69 7a 65 22 7d 2c 0a 20 20 20 20 7b 20 4f  -size"},.    { O
1bf0: 50 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c  P_String,     0,
1c00: 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f   0,  0},.    { O
1c10: 50 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c  P_String,     0,
1c20: 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f   0,  0},.    { O
1c30: 50 5f 52 65 61 64 43 6f 6f 6b 69 65 2c 20 30 2c  P_ReadCookie, 0,
1c40: 20 32 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f   2,  0},.    { O
1c50: 50 5f 43 61 6c 6c 62 61 63 6b 2c 20 20 20 34 2c  P_Callback,   4,
1c60: 20 30 2c 20 20 30 7d 2c 0a 0a 20 20 20 20 2f 2a   0,  0},..    /*
1c70: 20 53 65 6e 64 20 74 68 65 20 69 6e 69 74 69 61   Send the initia
1c80: 6c 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20  l schema cookie 
1c90: 74 6f 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 0a  to the callback.
1ca0: 20 20 20 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f      */.    { OP_
1cb0: 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30  String,     0, 0
1cc0: 2c 20 20 22 73 63 68 65 6d 61 5f 63 6f 6f 6b 69  ,  "schema_cooki
1cd0: 65 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74  e"},.    { OP_St
1ce0: 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c 20  ring,     0, 0, 
1cf0: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74   0},.    { OP_St
1d00: 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c 20  ring,     0, 0, 
1d10: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 65   0},.    { OP_Re
1d20: 61 64 43 6f 6f 6b 69 65 2c 20 30 2c 20 30 2c 20  adCookie, 0, 0, 
1d30: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 61   0},.    { OP_Ca
1d40: 6c 6c 62 61 63 6b 2c 20 20 20 34 2c 20 30 2c 20  llback,   4, 0, 
1d50: 20 30 7d 2c 0a 0a 20 20 20 20 2f 2a 20 43 68 65   0},..    /* Che
1d60: 63 6b 20 74 68 65 20 66 69 6c 65 20 66 6f 72 6d  ck the file form
1d70: 61 74 2e 20 20 49 66 20 74 68 65 20 66 6f 72 6d  at.  If the form
1d80: 61 74 20 6e 75 6d 62 65 72 20 69 73 20 32 20 6f  at number is 2 o
1d90: 72 20 6d 6f 72 65 2c 0a 20 20 20 20 2a 2a 20 74  r more,.    ** t
1da0: 68 65 6e 20 64 6f 20 61 20 73 69 6e 67 6c 65 20  hen do a single 
1db0: 70 61 73 73 20 74 68 72 6f 75 67 68 20 74 68 65  pass through the
1dc0: 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74   SQLITE_MASTER t
1dd0: 61 62 6c 65 2e 20 20 46 6f 72 0a 20 20 20 20 2a  able.  For.    *
1de0: 2a 20 61 20 66 6f 72 6d 61 74 20 6e 75 6d 62 65  * a format numbe
1df0: 72 20 6f 66 20 6c 65 73 73 20 74 68 61 6e 20 32  r of less than 2
1e00: 2c 20 6a 75 6d 70 20 66 6f 72 77 61 72 64 20 74  , jump forward t
1e10: 6f 20 61 20 64 69 66 66 65 72 65 6e 74 0a 20 20  o a different.  
1e20: 20 20 2a 2a 20 61 6c 67 6f 72 69 74 68 6d 20 74    ** algorithm t
1e30: 68 61 74 20 6d 61 6b 65 73 20 74 77 6f 20 70 61  hat makes two pa
1e40: 73 73 65 73 20 74 68 72 6f 75 67 68 20 74 68 65  sses through the
1e50: 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74   SQLITE_MASTER t
1e60: 61 62 6c 65 2c 0a 20 20 20 20 2a 2a 20 6f 6e 63  able,.    ** onc
1e70: 65 20 66 6f 72 20 74 61 62 6c 65 73 20 61 6e 64  e for tables and
1e80: 20 61 20 73 65 63 6f 6e 64 20 74 69 6d 65 20 66   a second time f
1e90: 6f 72 20 69 6e 64 69 63 65 73 2e 0a 20 20 20 20  or indices..    
1ea0: 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 52 65 61 64  */.    { OP_Read
1eb0: 43 6f 6f 6b 69 65 2c 20 30 2c 20 31 2c 20 20 30  Cookie, 0, 1,  0
1ec0: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 49 6e 74 65  },.    { OP_Inte
1ed0: 67 65 72 2c 20 20 20 20 32 2c 20 30 2c 20 20 30  ger,    2, 0,  0
1ee0: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4c 74 2c 20  },.    { OP_Lt, 
1ef0: 20 20 20 20 20 20 20 20 30 2c 20 32 38 2c 20 30          0, 28, 0
1f00: 7d 2c 0a 0a 20 20 20 20 2f 2a 20 54 68 69 73 20  },..    /* This 
1f10: 69 73 20 74 68 65 20 63 6f 64 65 20 66 6f 72 20  is the code for 
1f20: 64 6f 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 73  doing a single s
1f30: 63 61 6e 20 74 68 72 6f 75 67 68 20 74 68 65 20  can through the 
1f40: 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 0a 20 20  SQLITE_MASTER.  
1f50: 20 20 2a 2a 20 74 61 62 6c 65 2e 20 20 54 68 69    ** table.  Thi
1f60: 73 20 63 6f 64 65 20 72 75 6e 73 20 66 6f 72 20  s code runs for 
1f70: 66 6f 72 6d 61 74 20 32 20 61 6e 64 20 67 72 65  format 2 and gre
1f80: 61 74 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  ater..    */.   
1f90: 20 7b 20 4f 50 5f 52 65 77 69 6e 64 2c 20 20 20   { OP_Rewind,   
1fa0: 20 20 30 2c 20 32 36 2c 20 30 7d 2c 0a 20 20 20    0, 26, 0},.   
1fb0: 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20   { OP_Column,   
1fc0: 20 20 30 2c 20 30 2c 20 20 30 7d 2c 20 20 20 20    0, 0,  0},    
1fd0: 20 20 20 20 20 20 20 2f 2a 20 32 30 20 2a 2f 0a         /* 20 */.
1fe0: 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c      { OP_Column,
1ff0: 20 20 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a       0, 1,  0},.
2000: 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c      { OP_Column,
2010: 20 20 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a       0, 3,  0},.
2020: 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c      { OP_Column,
2030: 20 20 20 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a       0, 4,  0},.
2040: 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63      { OP_Callbac
2050: 6b 2c 20 20 20 34 2c 20 30 2c 20 20 30 7d 2c 0a  k,   4, 0,  0},.
2060: 20 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20      { OP_Next,  
2070: 20 20 20 20 20 30 2c 20 32 30 2c 20 30 7d 2c 0a       0, 20, 0},.
2080: 20 20 20 20 7b 20 4f 50 5f 43 6c 6f 73 65 2c 20      { OP_Close, 
2090: 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 20       0, 0,  0}, 
20a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 32 36 20            /* 26 
20b0: 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 48 61 6c 74  */.    { OP_Halt
20c0: 2c 20 20 20 20 20 20 20 30 2c 20 30 2c 20 20 30  ,       0, 0,  0
20d0: 7d 2c 0a 0a 20 20 20 20 2f 2a 20 54 68 69 73 20  },..    /* This 
20e0: 69 73 20 74 68 65 20 63 6f 64 65 20 66 6f 72 20  is the code for 
20f0: 64 6f 69 6e 67 20 74 77 6f 20 70 61 73 73 65 73  doing two passes
2100: 20 74 68 72 6f 75 67 68 20 53 51 4c 49 54 45 5f   through SQLITE_
2110: 4d 41 53 54 45 52 2e 20 20 54 68 69 73 0a 20 20  MASTER.  This.  
2120: 20 20 2a 2a 20 63 6f 64 65 20 72 75 6e 73 20 66    ** code runs f
2130: 6f 72 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 31  or file format 1
2140: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 7b 20 4f  ..    */.    { O
2150: 50 5f 52 65 77 69 6e 64 2c 20 20 20 20 20 30 2c  P_Rewind,     0,
2160: 20 34 38 2c 20 30 7d 2c 20 20 20 20 20 20 20 20   48, 0},        
2170: 20 20 20 2f 2a 20 32 38 20 2a 2f 0a 20 20 20 20     /* 28 */.    
2180: 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 20  { OP_Column,    
2190: 20 30 2c 20 30 2c 20 20 30 7d 2c 20 20 20 20 20   0, 0,  0},     
21a0: 20 20 20 20 20 20 2f 2a 20 32 39 20 2a 2f 0a 20        /* 29 */. 
21b0: 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20     { OP_String, 
21c0: 20 20 20 20 30 2c 20 30 2c 20 20 22 74 61 62 6c      0, 0,  "tabl
21d0: 65 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65  e"},.    { OP_Ne
21e0: 2c 20 20 20 20 20 20 20 20 20 30 2c 20 33 37 2c  ,         0, 37,
21f0: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f   0},.    { OP_Co
2200: 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 30 2c 20  lumn,     0, 0, 
2210: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f   0},.    { OP_Co
2220: 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 31 2c 20  lumn,     0, 1, 
2230: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f   0},.    { OP_Co
2240: 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 33 2c 20  lumn,     0, 3, 
2250: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f   0},.    { OP_Co
2260: 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 34 2c 20  lumn,     0, 4, 
2270: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 61   0},.    { OP_Ca
2280: 6c 6c 62 61 63 6b 2c 20 20 20 34 2c 20 30 2c 20  llback,   4, 0, 
2290: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65   0},.    { OP_Ne
22a0: 78 74 2c 20 20 20 20 20 20 20 30 2c 20 32 39 2c  xt,       0, 29,
22b0: 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f   0},           /
22c0: 2a 20 33 37 20 2a 2f 0a 20 20 20 20 7b 20 4f 50  * 37 */.    { OP
22d0: 5f 52 65 77 69 6e 64 2c 20 20 20 20 20 30 2c 20  _Rewind,     0, 
22e0: 34 38 2c 20 30 7d 2c 20 20 20 20 20 20 20 20 20  48, 0},         
22f0: 20 20 2f 2a 20 33 38 20 2a 2f 0a 20 20 20 20 7b    /* 38 */.    {
2300: 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 20 20   OP_Column,     
2310: 30 2c 20 30 2c 20 20 30 7d 2c 20 20 20 20 20 20  0, 0,  0},      
2320: 20 20 20 20 20 2f 2a 20 33 39 20 2a 2f 0a 20 20       /* 39 */.  
2330: 20 20 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20    { OP_String,  
2340: 20 20 20 30 2c 20 30 2c 20 20 22 69 6e 64 65 78     0, 0,  "index
2350: 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 2c  "},.    { OP_Ne,
2360: 20 20 20 20 20 20 20 20 20 30 2c 20 34 37 2c 20           0, 47, 
2370: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c  0},.    { OP_Col
2380: 75 6d 6e 2c 20 20 20 20 20 30 2c 20 30 2c 20 20  umn,     0, 0,  
2390: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c  0},.    { OP_Col
23a0: 75 6d 6e 2c 20 20 20 20 20 30 2c 20 31 2c 20 20  umn,     0, 1,  
23b0: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c  0},.    { OP_Col
23c0: 75 6d 6e 2c 20 20 20 20 20 30 2c 20 33 2c 20 20  umn,     0, 3,  
23d0: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c  0},.    { OP_Col
23e0: 75 6d 6e 2c 20 20 20 20 20 30 2c 20 34 2c 20 20  umn,     0, 4,  
23f0: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c  0},.    { OP_Cal
2400: 6c 62 61 63 6b 2c 20 20 20 34 2c 20 30 2c 20 20  lback,   4, 0,  
2410: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 78  0},.    { OP_Nex
2420: 74 2c 20 20 20 20 20 20 20 30 2c 20 33 39 2c 20  t,       0, 39, 
2430: 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a  0},           /*
2440: 20 34 37 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f   47 */.    { OP_
2450: 43 6c 6f 73 65 2c 20 20 20 20 20 20 30 2c 20 30  Close,      0, 0
2460: 2c 20 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20  ,  0},          
2470: 20 2f 2a 20 34 38 20 2a 2f 0a 20 20 20 20 7b 20   /* 48 */.    { 
2480: 4f 50 5f 48 61 6c 74 2c 20 20 20 20 20 20 20 30  OP_Halt,       0
2490: 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 7d 3b 0a 0a  , 0,  0},.  };..
24a0: 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 76 69    /* Create a vi
24b0: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 6f  rtual machine to
24c0: 20 72 75 6e 20 74 68 65 20 69 6e 69 74 69 61 6c   run the initial
24d0: 69 7a 61 74 69 6f 6e 20 70 72 6f 67 72 61 6d 2e  ization program.
24e0: 20 20 52 75 6e 0a 20 20 2a 2a 20 74 68 65 20 70    Run.  ** the p
24f0: 72 6f 67 72 61 6d 2e 20 20 54 68 65 6e 20 64 65  rogram.  Then de
2500: 6c 65 74 65 20 74 68 65 20 76 69 72 74 75 61 6c  lete the virtual
2510: 20 6d 61 63 68 69 6e 65 2e 0a 20 20 2a 2f 0a 20   machine..  */. 
2520: 20 76 64 62 65 20 3d 20 73 71 6c 69 74 65 56 64   vdbe = sqliteVd
2530: 62 65 43 72 65 61 74 65 28 64 62 29 3b 0a 20 20  beCreate(db);.  
2540: 69 66 28 20 76 64 62 65 3d 3d 30 20 29 7b 0a 20  if( vdbe==0 ){. 
2550: 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69     sqliteSetStri
2560: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f 75  ng(pzErrMsg, "ou
2570: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 30 29  t of memory", 0)
2580: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  ;.    return SQL
2590: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20  ITE_NOMEM;.  }. 
25a0: 20 73 71 6c 69 74 65 56 64 62 65 41 64 64 4f 70   sqliteVdbeAddOp
25b0: 4c 69 73 74 28 76 64 62 65 2c 20 73 69 7a 65 6f  List(vdbe, sizeo
25c0: 66 28 69 6e 69 74 50 72 6f 67 29 2f 73 69 7a 65  f(initProg)/size
25d0: 6f 66 28 69 6e 69 74 50 72 6f 67 5b 30 5d 29 2c  of(initProg[0]),
25e0: 20 69 6e 69 74 50 72 6f 67 29 3b 0a 20 20 72 63   initProg);.  rc
25f0: 20 3d 20 73 71 6c 69 74 65 56 64 62 65 45 78 65   = sqliteVdbeExe
2600: 63 28 76 64 62 65 2c 20 73 71 6c 69 74 65 4f 70  c(vdbe, sqliteOp
2610: 65 6e 43 62 2c 20 64 62 2c 20 70 7a 45 72 72 4d  enCb, db, pzErrM
2620: 73 67 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20  sg, .           
2630: 20 20 20 20 20 20 20 20 20 20 20 64 62 2d 3e 70             db->p
2640: 42 75 73 79 41 72 67 2c 20 64 62 2d 3e 78 42 75  BusyArg, db->xBu
2650: 73 79 43 61 6c 6c 62 61 63 6b 29 3b 0a 20 20 73  syCallback);.  s
2660: 71 6c 69 74 65 56 64 62 65 44 65 6c 65 74 65 28  qliteVdbeDelete(
2670: 76 64 62 65 29 3b 0a 20 20 69 66 28 20 72 63 3d  vdbe);.  if( rc=
2680: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 64 62  =SQLITE_OK && db
2690: 2d 3e 6e 54 61 62 6c 65 3d 3d 30 20 29 7b 0a 20  ->nTable==0 ){. 
26a0: 20 20 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d     db->file_form
26b0: 61 74 20 3d 20 32 3b 0a 20 20 7d 0a 20 20 69 66  at = 2;.  }.  if
26c0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
26d0: 26 26 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d  && db->file_form
26e0: 61 74 3e 32 20 29 7b 0a 20 20 20 20 73 71 6c 69  at>2 ){.    sqli
26f0: 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  teSetString(pzEr
2700: 72 4d 73 67 2c 20 22 75 6e 73 75 70 70 6f 72 74  rMsg, "unsupport
2710: 65 64 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c  ed file format",
2720: 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51   0);.    rc = SQ
2730: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a  LITE_ERROR;.  }.
2740: 0a 20 20 2f 2a 20 54 68 65 20 73 63 68 65 6d 61  .  /* The schema
2750: 20 66 6f 72 20 74 68 65 20 53 51 4c 49 54 45 5f   for the SQLITE_
2760: 4d 41 53 54 45 52 20 74 61 62 6c 65 20 69 73 20  MASTER table is 
2770: 6e 6f 74 20 73 74 6f 72 65 64 20 69 6e 20 74 68  not stored in th
2780: 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20  e.  ** database 
2790: 69 74 73 65 6c 66 2e 20 20 57 65 20 68 61 76 65  itself.  We have
27a0: 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 65 20 63   to invoke the c
27b0: 61 6c 6c 62 61 63 6b 20 6f 6e 65 20 65 78 74 72  allback one extr
27c0: 61 0a 20 20 2a 2a 20 74 69 6d 65 20 74 6f 20 67  a.  ** time to g
27d0: 65 74 20 69 74 20 74 6f 20 70 72 6f 63 65 73 73  et it to process
27e0: 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41 53 54   the SQLITE_MAST
27f0: 45 52 20 74 61 62 6c 65 20 64 65 66 69 6e 74 69  ER table definti
2800: 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72  on..  */.  if( r
2810: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
2820: 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b      Table *pTab;
2830: 0a 20 20 20 20 63 68 61 72 20 2a 61 7a 41 72 67  .    char *azArg
2840: 5b 36 5d 3b 0a 20 20 20 20 61 7a 41 72 67 5b 30  [6];.    azArg[0
2850: 5d 20 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 20  ] = "table";.   
2860: 20 61 7a 41 72 67 5b 31 5d 20 3d 20 4d 41 53 54   azArg[1] = MAST
2870: 45 52 5f 4e 41 4d 45 3b 0a 20 20 20 20 61 7a 41  ER_NAME;.    azA
2880: 72 67 5b 32 5d 20 3d 20 22 32 22 3b 0a 20 20 20  rg[2] = "2";.   
2890: 20 61 7a 41 72 67 5b 33 5d 20 3d 20 6d 61 73 74   azArg[3] = mast
28a0: 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 20 20 61  er_schema;.    a
28b0: 7a 41 72 67 5b 34 5d 20 3d 20 30 3b 0a 20 20 20  zArg[4] = 0;.   
28c0: 20 73 71 6c 69 74 65 4f 70 65 6e 43 62 28 64 62   sqliteOpenCb(db
28d0: 2c 20 34 2c 20 61 7a 41 72 67 2c 20 30 29 3b 0a  , 4, azArg, 0);.
28e0: 20 20 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74      pTab = sqlit
28f0: 65 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 4d  eFindTable(db, M
2900: 41 53 54 45 52 5f 4e 41 4d 45 29 3b 0a 20 20 20  ASTER_NAME);.   
2910: 20 69 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20   if( pTab ){.   
2920: 20 20 20 70 54 61 62 2d 3e 72 65 61 64 4f 6e 6c     pTab->readOnl
2930: 79 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20  y = 1;.    }.   
2940: 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51   db->flags |= SQ
2950: 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64  LITE_Initialized
2960: 3b 0a 20 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d  ;.    sqliteComm
2970: 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65  itInternalChange
2980: 73 28 64 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74  s(db);.  }.  ret
2990: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
29a0: 20 54 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   The version of 
29b0: 74 68 65 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63  the library.*/.c
29c0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
29d0: 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c  _version[] = SQL
29e0: 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a  ITE_VERSION;../*
29f0: 0a 2a 2a 20 44 6f 65 73 20 74 68 65 20 6c 69 62  .** Does the lib
2a00: 72 61 72 79 20 65 78 70 65 63 74 20 64 61 74 61  rary expect data
2a10: 20 74 6f 20 62 65 20 65 6e 63 6f 64 65 64 20 61   to be encoded a
2a20: 73 20 55 54 46 2d 38 20 6f 72 20 69 73 6f 38 38  s UTF-8 or iso88
2a30: 35 39 3f 20 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c  59?  The.** foll
2a40: 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e  owing global con
2a50: 73 74 61 6e 74 20 61 6c 77 61 79 73 20 6c 65 74  stant always let
2a60: 73 20 75 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a 23 69  s us know..*/.#i
2a70: 66 64 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38  fdef SQLITE_UTF8
2a80: 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69  .const char sqli
2a90: 74 65 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20  te_encoding[] = 
2aa0: 22 55 54 46 2d 38 22 3b 0a 23 65 6c 73 65 0a 63  "UTF-8";.#else.c
2ab0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
2ac0: 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 69  _encoding[] = "i
2ad0: 73 6f 38 38 35 39 22 3b 0a 23 65 6e 64 69 66 0a  so8859";.#endif.
2ae0: 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65  ./*.** Open a ne
2af0: 77 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  w SQLite databas
2b00: 65 2e 20 20 43 6f 6e 73 74 72 75 63 74 20 61 6e  e.  Construct an
2b10: 20 22 73 71 6c 69 74 65 22 20 73 74 72 75 63 74   "sqlite" struct
2b20: 75 72 65 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a  ure to define.**
2b30: 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68   the state of th
2b40: 69 73 20 64 61 74 61 62 61 73 65 20 61 6e 64 20  is database and 
2b50: 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72  return a pointer
2b60: 20 74 6f 20 74 68 61 74 20 73 74 72 75 63 74 75   to that structu
2b70: 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 74 74  re..**.** An att
2b80: 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20  empt is made to 
2b90: 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69  initialize the i
2ba0: 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 20 73 74  n-memory data st
2bb0: 72 75 63 74 75 72 65 73 20 74 68 61 74 0a 2a 2a  ructures that.**
2bc0: 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61   hold the databa
2bd0: 73 65 20 73 63 68 65 6d 61 2e 20 20 42 75 74 20  se schema.  But 
2be0: 69 66 20 74 68 69 73 20 66 61 69 6c 73 20 28 62  if this fails (b
2bf0: 65 63 61 75 73 65 20 74 68 65 20 73 63 68 65 6d  ecause the schem
2c00: 61 20 66 69 6c 65 0a 2a 2a 20 69 73 20 6c 6f 63  a file.** is loc
2c10: 6b 65 64 29 20 74 68 65 6e 20 74 68 61 74 20 73  ked) then that s
2c20: 74 65 70 20 69 73 20 64 65 66 65 72 72 65 64 20  tep is deferred 
2c30: 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20  until the first 
2c40: 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74  call to.** sqlit
2c50: 65 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 73 71 6c  e_exec()..*/.sql
2c60: 69 74 65 20 2a 73 71 6c 69 74 65 5f 6f 70 65 6e  ite *sqlite_open
2c70: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69  (const char *zFi
2c80: 6c 65 6e 61 6d 65 2c 20 69 6e 74 20 6d 6f 64 65  lename, int mode
2c90: 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73  , char **pzErrMs
2ca0: 67 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  g){.  sqlite *db
2cb0: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f  ;.  int rc;..  /
2cc0: 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73  * Allocate the s
2cd0: 71 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63  qlite data struc
2ce0: 74 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73  ture */.  db = s
2cf0: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a  qliteMalloc( siz
2d00: 65 6f 66 28 73 71 6c 69 74 65 29 20 29 3b 0a 20  eof(sqlite) );. 
2d10: 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20   if( pzErrMsg ) 
2d20: 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20  *pzErrMsg = 0;. 
2d30: 20 69 66 28 20 64 62 3d 3d 30 20 29 20 67 6f 74   if( db==0 ) got
2d40: 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e  o no_mem_on_open
2d50: 3b 0a 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e  ;.  sqliteHashIn
2d60: 69 74 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c  it(&db->tblHash,
2d70: 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52   SQLITE_HASH_STR
2d80: 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74  ING, 0);.  sqlit
2d90: 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 69  eHashInit(&db->i
2da0: 64 78 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48  dxHash, SQLITE_H
2db0: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
2dc0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
2dd0: 28 26 64 62 2d 3e 74 62 6c 44 72 6f 70 2c 20 53  (&db->tblDrop, S
2de0: 51 4c 49 54 45 5f 48 41 53 48 5f 50 4f 49 4e 54  QLITE_HASH_POINT
2df0: 45 52 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65  ER, 0);.  sqlite
2e00: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 69 64  HashInit(&db->id
2e10: 78 44 72 6f 70 2c 20 53 51 4c 49 54 45 5f 48 41  xDrop, SQLITE_HA
2e20: 53 48 5f 50 4f 49 4e 54 45 52 2c 20 30 29 3b 0a  SH_POINTER, 0);.
2e30: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
2e40: 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 53 51 4c  (&db->aFunc, SQL
2e50: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
2e60: 20 31 29 3b 0a 20 20 73 71 6c 69 74 65 52 65 67   1);.  sqliteReg
2e70: 69 73 74 65 72 42 75 69 6c 64 69 6e 46 75 6e 63  isterBuildinFunc
2e80: 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20 64 62 2d  tions(db);.  db-
2e90: 3e 6f 6e 45 72 72 6f 72 20 3d 20 4f 45 5f 44 65  >onError = OE_De
2ea0: 66 61 75 6c 74 3b 0a 20 20 64 62 2d 3e 70 72 69  fault;.  db->pri
2eb0: 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b 0a  orNewRowid = 0;.
2ec0: 20 20 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65    .  /* Open the
2ed0: 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73   backend databas
2ee0: 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63  e driver */.  rc
2ef0: 20 3d 20 73 71 6c 69 74 65 42 74 72 65 65 4f 70   = sqliteBtreeOp
2f00: 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 6d 6f  en(zFilename, mo
2f10: 64 65 2c 20 4d 41 58 5f 50 41 47 45 53 2c 20 26  de, MAX_PAGES, &
2f20: 64 62 2d 3e 70 42 65 29 3b 0a 20 20 69 66 28 20  db->pBe);.  if( 
2f30: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
2f40: 0a 20 20 20 20 73 77 69 74 63 68 28 20 72 63 20  .    switch( rc 
2f50: 29 7b 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74  ){.      default
2f60: 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  : {.        sqli
2f70: 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  teSetString(pzEr
2f80: 72 4d 73 67 2c 20 22 75 6e 61 62 6c 65 20 74 6f  rMsg, "unable to
2f90: 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 3a 20   open database: 
2fa0: 22 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 29  ", zFilename, 0)
2fb0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
2fc0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 64      sqliteFree(d
2fd0: 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 74  b);.    sqliteSt
2fe0: 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73  rRealloc(pzErrMs
2ff0: 67 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30  g);.    return 0
3000: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 74 74 65  ;.  }..  /* Atte
3010: 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 20  mpt to read the 
3020: 73 63 68 65 6d 61 20 2a 2f 0a 20 20 72 63 20 3d  schema */.  rc =
3030: 20 73 71 6c 69 74 65 49 6e 69 74 28 64 62 2c 20   sqliteInit(db, 
3040: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28  pzErrMsg);.  if(
3050: 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66   sqlite_malloc_f
3060: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 71 6c  ailed ){.    sql
3070: 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20  ite_close(db);. 
3080: 20 20 20 67 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f 6f     goto no_mem_o
3090: 6e 5f 6f 70 65 6e 3b 0a 20 20 7d 65 6c 73 65 20  n_open;.  }else 
30a0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
30b0: 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f  K && rc!=SQLITE_
30c0: 42 55 53 59 20 29 7b 0a 20 20 20 20 73 71 6c 69  BUSY ){.    sqli
30d0: 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20  te_close(db);.  
30e0: 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c    sqliteStrReall
30f0: 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  oc(pzErrMsg);.  
3100: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 65    return 0;.  }e
3110: 6c 73 65 20 69 66 28 20 70 7a 45 72 72 4d 73 67  lse if( pzErrMsg
3120: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 46 72   ){.    sqliteFr
3130: 65 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b 0a 20  ee(*pzErrMsg);. 
3140: 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30     *pzErrMsg = 0
3150: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64  ;.  }.  return d
3160: 62 3b 0a 0a 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70  b;..no_mem_on_op
3170: 65 6e 3a 0a 20 20 73 71 6c 69 74 65 53 65 74 53  en:.  sqliteSetS
3180: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
3190: 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c  "out of memory",
31a0: 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 53 74 72   0);.  sqliteStr
31b0: 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67  Realloc(pzErrMsg
31c0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d  );.  return 0;.}
31d0: 0a 0a 2f 2a 0a 2a 2a 20 45 72 61 73 65 20 61 6c  ../*.** Erase al
31e0: 6c 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61  l schema informa
31f0: 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 73 63  tion from the sc
3200: 68 65 6d 61 20 68 61 73 68 20 74 61 62 6c 65 2e  hema hash table.
3210: 20 20 45 78 63 65 70 74 0a 2a 2a 20 74 61 62 6c    Except.** tabl
3220: 65 73 20 74 68 61 74 20 61 72 65 20 63 72 65 61  es that are crea
3230: 74 65 64 20 75 73 69 6e 67 20 43 52 45 41 54 45  ted using CREATE
3240: 20 54 45 4d 50 4f 52 41 52 59 20 54 41 42 4c 45   TEMPORARY TABLE
3250: 20 61 72 65 20 70 72 65 73 65 72 76 65 64 0a 2a   are preserved.*
3260: 2a 20 69 66 20 74 68 65 20 70 72 65 73 65 72 76  * if the preserv
3270: 65 54 65 6d 70 73 20 66 6c 61 67 20 69 73 20 74  eTemps flag is t
3280: 72 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64  rue..**.** The d
3290: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69  atabase schema i
32a0: 73 20 6e 6f 72 6d 61 6c 6c 79 20 72 65 61 64 20  s normally read 
32b0: 69 6e 20 6f 6e 63 65 20 77 68 65 6e 20 74 68 65  in once when the
32c0: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 69 73 20   database.** is 
32d0: 66 69 72 73 74 20 6f 70 65 6e 65 64 20 61 6e 64  first opened and
32e0: 20 73 74 6f 72 65 64 20 69 6e 20 61 20 68 61 73   stored in a has
32f0: 68 20 74 61 62 6c 65 20 69 6e 20 74 68 65 20 73  h table in the s
3300: 71 6c 69 74 65 20 73 74 72 75 63 74 75 72 65 2e  qlite structure.
3310: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
3320: 20 65 72 61 73 65 73 20 74 68 65 20 73 74 6f 72   erases the stor
3330: 65 64 20 73 63 68 65 6d 61 2e 20 20 54 68 69 73  ed schema.  This
3340: 20 65 72 61 73 75 72 65 20 6f 63 63 75 72 73 20   erasure occurs 
3350: 62 65 63 61 75 73 65 0a 2a 2a 20 65 69 74 68 65  because.** eithe
3360: 72 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69  r the database i
3370: 73 20 62 65 69 6e 67 20 63 6c 6f 73 65 64 20 6f  s being closed o
3380: 72 20 62 65 63 61 75 73 65 20 73 6f 6d 65 20 6f  r because some o
3390: 74 68 65 72 20 70 72 6f 63 65 73 73 0a 2a 2a 20  ther process.** 
33a0: 63 68 61 6e 67 65 64 20 74 68 65 20 73 63 68 65  changed the sche
33b0: 6d 61 20 61 6e 64 20 74 68 69 73 20 70 72 6f 63  ma and this proc
33c0: 65 73 73 20 6e 65 65 64 73 20 74 6f 20 72 65 72  ess needs to rer
33d0: 65 61 64 20 69 74 2e 0a 2a 2f 0a 73 74 61 74 69  ead it..*/.stati
33e0: 63 20 76 6f 69 64 20 63 6c 65 61 72 48 61 73 68  c void clearHash
33f0: 54 61 62 6c 65 28 73 71 6c 69 74 65 20 2a 64 62  Table(sqlite *db
3400: 2c 20 69 6e 74 20 70 72 65 73 65 72 76 65 54 65  , int preserveTe
3410: 6d 70 73 29 7b 0a 20 20 48 61 73 68 45 6c 65 6d  mps){.  HashElem
3420: 20 2a 70 45 6c 65 6d 3b 0a 20 20 48 61 73 68 20   *pElem;.  Hash 
3430: 74 65 6d 70 31 3b 0a 20 20 61 73 73 65 72 74 28  temp1;.  assert(
3440: 20 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74   sqliteHashFirst
3450: 28 26 64 62 2d 3e 74 62 6c 44 72 6f 70 29 3d 3d  (&db->tblDrop)==
3460: 30 20 29 3b 20 2f 2a 20 54 68 65 72 65 20 63 61  0 ); /* There ca
3470: 6e 20 6e 6f 74 20 62 65 20 75 6e 63 6f 6d 6d 69  n not be uncommi
3480: 74 74 65 64 20 2a 2f 0a 20 20 61 73 73 65 72 74  tted */.  assert
3490: 28 20 73 71 6c 69 74 65 48 61 73 68 46 69 72 73  ( sqliteHashFirs
34a0: 74 28 26 64 62 2d 3e 69 64 78 44 72 6f 70 29 3d  t(&db->idxDrop)=
34b0: 3d 30 20 29 3b 20 2f 2a 20 20 20 44 52 4f 50 20  =0 ); /*   DROP 
34c0: 54 41 42 4c 45 73 20 6f 72 20 44 52 4f 50 20 49  TABLEs or DROP I
34d0: 4e 44 45 58 73 20 2a 2f 0a 20 20 74 65 6d 70 31  NDEXs */.  temp1
34e0: 20 3d 20 64 62 2d 3e 74 62 6c 48 61 73 68 3b 0a   = db->tblHash;.
34f0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
3500: 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c 20 53  (&db->tblHash, S
3510: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
3520: 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 48  G, 0);.  sqliteH
3530: 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 69 64  ashClear(&db->id
3540: 78 48 61 73 68 29 3b 0a 20 20 66 6f 72 28 70 45  xHash);.  for(pE
3550: 6c 65 6d 3d 73 71 6c 69 74 65 48 61 73 68 46 69  lem=sqliteHashFi
3560: 72 73 74 28 26 74 65 6d 70 31 29 3b 20 70 45 6c  rst(&temp1); pEl
3570: 65 6d 3b 20 70 45 6c 65 6d 3d 73 71 6c 69 74 65  em; pElem=sqlite
3580: 48 61 73 68 4e 65 78 74 28 70 45 6c 65 6d 29 29  HashNext(pElem))
3590: 7b 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61  {.    Table *pTa
35a0: 62 20 3d 20 73 71 6c 69 74 65 48 61 73 68 44 61  b = sqliteHashDa
35b0: 74 61 28 70 45 6c 65 6d 29 3b 0a 20 20 20 20 69  ta(pElem);.    i
35c0: 66 28 20 70 72 65 73 65 72 76 65 54 65 6d 70 73  f( preserveTemps
35d0: 20 26 26 20 70 54 61 62 2d 3e 69 73 54 65 6d 70   && pTab->isTemp
35e0: 20 29 7b 0a 20 20 20 20 20 20 49 6e 64 65 78 20   ){.      Index 
35f0: 2a 70 49 64 78 3b 0a 20 20 20 20 20 20 69 6e 74  *pIdx;.      int
3600: 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28   nName = strlen(
3610: 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20  pTab->zName);.  
3620: 20 20 20 20 54 61 62 6c 65 20 2a 70 4f 6c 64 20      Table *pOld 
3630: 3d 20 73 71 6c 69 74 65 48 61 73 68 49 6e 73 65  = sqliteHashInse
3640: 72 74 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c  rt(&db->tblHash,
3650: 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 6e 4e   pTab->zName, nN
3660: 61 6d 65 2b 31 2c 20 70 54 61 62 29 3b 0a 20 20  ame+1, pTab);.  
3670: 20 20 20 20 69 66 28 20 70 4f 6c 64 21 3d 30 20      if( pOld!=0 
3680: 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  ){.        asser
3690: 74 28 20 70 4f 6c 64 3d 3d 70 54 61 62 20 29 3b  t( pOld==pTab );
36a0: 20 20 20 2f 2a 20 4d 61 6c 6c 6f 63 20 66 61 69     /* Malloc fai
36b0: 6c 65 64 20 6f 6e 20 74 68 65 20 48 61 73 68 49  led on the HashI
36c0: 6e 73 65 72 74 20 2a 2f 0a 20 20 20 20 20 20 20  nsert */.       
36d0: 20 73 71 6c 69 74 65 44 65 6c 65 74 65 54 61 62   sqliteDeleteTab
36e0: 6c 65 28 64 62 2c 20 70 4f 6c 64 29 3b 0a 20 20  le(db, pOld);.  
36f0: 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a        continue;.
3700: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 6f        }.      fo
3710: 72 28 70 49 64 78 3d 70 54 61 62 2d 3e 70 49 6e  r(pIdx=pTab->pIn
3720: 64 65 78 3b 20 70 49 64 78 3b 20 70 49 64 78 3d  dex; pIdx; pIdx=
3730: 70 49 64 78 2d 3e 70 4e 65 78 74 29 7b 0a 20 20  pIdx->pNext){.  
3740: 20 20 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 74        int n = st
3750: 72 6c 65 6e 28 70 49 64 78 2d 3e 7a 4e 61 6d 65  rlen(pIdx->zName
3760: 29 2b 31 3b 0a 20 20 20 20 20 20 20 20 49 6e 64  )+1;.        Ind
3770: 65 78 20 2a 70 4f 6c 64 49 64 78 3b 0a 20 20 20  ex *pOldIdx;.   
3780: 20 20 20 20 20 70 4f 6c 64 49 64 78 20 3d 20 73       pOldIdx = s
3790: 71 6c 69 74 65 48 61 73 68 49 6e 73 65 72 74 28  qliteHashInsert(
37a0: 26 64 62 2d 3e 69 64 78 48 61 73 68 2c 20 70 49  &db->idxHash, pI
37b0: 64 78 2d 3e 7a 4e 61 6d 65 2c 20 6e 2c 20 70 49  dx->zName, n, pI
37c0: 64 78 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28  dx);.        if(
37d0: 20 70 4f 6c 64 20 29 7b 0a 20 20 20 20 20 20 20   pOld ){.       
37e0: 20 20 20 61 73 73 65 72 74 28 20 70 4f 6c 64 49     assert( pOldI
37f0: 64 78 3d 3d 70 49 64 78 20 29 3b 0a 20 20 20 20  dx==pIdx );.    
3800: 20 20 20 20 20 20 73 71 6c 69 74 65 55 6e 6c 69        sqliteUnli
3810: 6e 6b 41 6e 64 44 65 6c 65 74 65 49 6e 64 65 78  nkAndDeleteIndex
3820: 28 64 62 2c 20 70 4f 6c 64 49 64 78 29 3b 0a 20  (db, pOldIdx);. 
3830: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
3840: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
3850: 20 20 73 71 6c 69 74 65 44 65 6c 65 74 65 54 61    sqliteDeleteTa
3860: 62 6c 65 28 64 62 2c 20 70 54 61 62 29 3b 0a 20  ble(db, pTab);. 
3870: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74     }.  }.  sqlit
3880: 65 48 61 73 68 43 6c 65 61 72 28 26 74 65 6d 70  eHashClear(&temp
3890: 31 29 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20  1);.  db->flags 
38a0: 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e 69 74 69  &= ~SQLITE_Initi
38b0: 61 6c 69 7a 65 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  alized;.}../*.**
38c0: 20 52 65 74 75 72 6e 20 74 68 65 20 52 4f 57 49   Return the ROWI
38d0: 44 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65  D of the most re
38e0: 63 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f 0a 69  cent insert.*/.i
38f0: 6e 74 20 73 71 6c 69 74 65 5f 6c 61 73 74 5f 69  nt sqlite_last_i
3900: 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69  nsert_rowid(sqli
3910: 74 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72  te *db){.  retur
3920: 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b  n db->lastRowid;
3930: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20  .}../*.** Close 
3940: 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69  an existing SQLi
3950: 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 76  te database.*/.v
3960: 6f 69 64 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65  oid sqlite_close
3970: 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20  (sqlite *db){.  
3980: 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 73  HashElem *i;.  s
3990: 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 65 28  qliteBtreeClose(
39a0: 64 62 2d 3e 70 42 65 29 3b 0a 20 20 63 6c 65 61  db->pBe);.  clea
39b0: 72 48 61 73 68 54 61 62 6c 65 28 64 62 2c 20 30  rHashTable(db, 0
39c0: 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 70 42 65  );.  if( db->pBe
39d0: 54 65 6d 70 20 29 7b 0a 20 20 20 20 73 71 6c 69  Temp ){.    sqli
39e0: 74 65 42 74 72 65 65 43 6c 6f 73 65 28 64 62 2d  teBtreeClose(db-
39f0: 3e 70 42 65 54 65 6d 70 29 3b 0a 20 20 7d 0a 20  >pBeTemp);.  }. 
3a00: 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73   for(i=sqliteHas
3a10: 68 46 69 72 73 74 28 26 64 62 2d 3e 61 46 75 6e  hFirst(&db->aFun
3a20: 63 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48  c); i; i=sqliteH
3a30: 61 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20  ashNext(i)){.   
3a40: 20 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c   FuncDef *pFunc,
3a50: 20 2a 70 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72   *pNext;.    for
3a60: 28 70 46 75 6e 63 20 3d 20 28 46 75 6e 63 44 65  (pFunc = (FuncDe
3a70: 66 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 74  f*)sqliteHashDat
3a80: 61 28 69 29 3b 20 70 46 75 6e 63 3b 20 70 46 75  a(i); pFunc; pFu
3a90: 6e 63 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 20  nc=pNext){.     
3aa0: 20 70 4e 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e   pNext = pFunc->
3ab0: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 73 71 6c  pNext;.      sql
3ac0: 69 74 65 46 72 65 65 28 70 46 75 6e 63 29 3b 0a  iteFree(pFunc);.
3ad0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69      }.  }.  sqli
3ae0: 74 65 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d  teHashClear(&db-
3af0: 3e 61 46 75 6e 63 29 3b 0a 20 20 73 71 6c 69 74  >aFunc);.  sqlit
3b00: 65 46 72 65 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a  eFree(db);.}../*
3b10: 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20  .** Return TRUE 
3b20: 69 66 20 74 68 65 20 67 69 76 65 6e 20 53 51 4c  if the given SQL
3b30: 20 73 74 72 69 6e 67 20 65 6e 64 73 20 69 6e 20   string ends in 
3b40: 61 20 73 65 6d 69 63 6f 6c 6f 6e 2e 0a 2a 2f 0a  a semicolon..*/.
3b50: 69 6e 74 20 73 71 6c 69 74 65 5f 63 6f 6d 70 6c  int sqlite_compl
3b60: 65 74 65 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  ete(const char *
3b70: 7a 53 71 6c 29 7b 0a 20 20 69 6e 74 20 69 73 43  zSql){.  int isC
3b80: 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 77  omplete = 0;.  w
3b90: 68 69 6c 65 28 20 2a 7a 53 71 6c 20 29 7b 0a 20  hile( *zSql ){. 
3ba0: 20 20 20 73 77 69 74 63 68 28 20 2a 7a 53 71 6c     switch( *zSql
3bb0: 20 29 7b 0a 20 20 20 20 20 20 63 61 73 65 20 27   ){.      case '
3bc0: 3b 27 3a 20 7b 0a 20 20 20 20 20 20 20 20 69 73  ;': {.        is
3bd0: 43 6f 6d 70 6c 65 74 65 20 3d 20 31 3b 0a 20 20  Complete = 1;.  
3be0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3bf0: 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20     }.      case 
3c00: 27 20 27 3a 0a 20 20 20 20 20 20 63 61 73 65 20  ' ':.      case 
3c10: 27 5c 74 27 3a 0a 20 20 20 20 20 20 63 61 73 65  '\t':.      case
3c20: 20 27 5c 6e 27 3a 0a 20 20 20 20 20 20 63 61 73   '\n':.      cas
3c30: 65 20 27 5c 66 27 3a 20 7b 0a 20 20 20 20 20 20  e '\f': {.      
3c40: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d    break;.      }
3c50: 0a 20 20 20 20 20 20 63 61 73 65 20 27 5b 27 3a  .      case '[':
3c60: 20 7b 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d   {.        isCom
3c70: 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20  plete = 0;.     
3c80: 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20 20     zSql++;.     
3c90: 20 20 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20     while( *zSql 
3ca0: 26 26 20 2a 7a 53 71 6c 21 3d 27 5d 27 20 29 7b  && *zSql!=']' ){
3cb0: 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20 20 20 20 20   zSql++; }.     
3cc0: 20 20 20 69 66 28 20 2a 7a 53 71 6c 3d 3d 30 20     if( *zSql==0 
3cd0: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20  ) return 0;.    
3ce0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
3cf0: 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27 5c   }.      case '\
3d00: 27 27 3a 20 7b 0a 20 20 20 20 20 20 20 20 69 73  '': {.        is
3d10: 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20  Complete = 0;.  
3d20: 20 20 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 20        zSql++;.  
3d30: 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a 53        while( *zS
3d40: 71 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 27 5c 27  ql && *zSql!='\'
3d50: 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20  ' ){ zSql++; }. 
3d60: 20 20 20 20 20 20 20 69 66 28 20 2a 7a 53 71 6c         if( *zSql
3d70: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  ==0 ) return 0;.
3d80: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
3d90: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73       }.      cas
3da0: 65 20 27 22 27 3a 20 7b 0a 20 20 20 20 20 20 20  e '"': {.       
3db0: 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b   isComplete = 0;
3dc0: 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b 3b  .        zSql++;
3dd0: 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 20  .        while( 
3de0: 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21 3d  *zSql && *zSql!=
3df0: 27 22 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d  '"' ){ zSql++; }
3e00: 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a 7a 53  .        if( *zS
3e10: 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30  ql==0 ) return 0
3e20: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
3e30: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63  .      }.      c
3e40: 61 73 65 20 27 2d 27 3a 20 7b 0a 20 20 20 20 20  ase '-': {.     
3e50: 20 20 20 69 66 28 20 7a 53 71 6c 5b 31 5d 21 3d     if( zSql[1]!=
3e60: 27 2d 27 20 29 7b 0a 20 20 20 20 20 20 20 20 20  '-' ){.         
3e70: 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b   isComplete = 0;
3e80: 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b  .          break
3e90: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
3ea0: 20 20 20 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c      while( *zSql
3eb0: 20 26 26 20 2a 7a 53 71 6c 21 3d 27 5c 6e 27 20   && *zSql!='\n' 
3ec0: 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20 20 20  ){ zSql++; }.   
3ed0: 20 20 20 20 20 69 66 28 20 2a 7a 53 71 6c 3d 3d       if( *zSql==
3ee0: 30 20 29 20 72 65 74 75 72 6e 20 69 73 43 6f 6d  0 ) return isCom
3ef0: 70 6c 65 74 65 3b 0a 20 20 20 20 20 20 20 20 62  plete;.        b
3f00: 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 20 0a 20  reak;.      } . 
3f10: 20 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a       default: {.
3f20: 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70 6c 65          isComple
3f30: 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  te = 0;.        
3f40: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20  break;.      }. 
3f50: 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 2b 2b 3b     }.    zSql++;
3f60: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 73  .  }.  return is
3f70: 43 6f 6d 70 6c 65 74 65 3b 0a 7d 0a 0a 2f 2a 0a  Complete;.}../*.
3f80: 2a 2a 20 45 78 65 63 75 74 65 20 53 51 4c 20 63  ** Execute SQL c
3f90: 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65  ode.  Return one
3fa0: 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20   of the SQLITE_ 
3fb0: 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 0a  success/failure.
3fc0: 2a 2a 20 63 6f 64 65 73 2e 20 20 41 6c 73 6f 20  ** codes.  Also 
3fd0: 77 72 69 74 65 20 61 6e 20 65 72 72 6f 72 20 6d  write an error m
3fe0: 65 73 73 61 67 65 20 69 6e 74 6f 20 6d 65 6d 6f  essage into memo
3ff0: 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d  ry obtained from
4000: 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 61 6e 64  .** malloc() and
4010: 20 6d 61 6b 65 20 2a 70 7a 45 72 72 4d 73 67 20   make *pzErrMsg 
4020: 70 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 6d 65  point to that me
4030: 73 73 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  ssage..**.** If 
4040: 74 68 65 20 53 51 4c 20 69 73 20 61 20 71 75 65  the SQL is a que
4050: 72 79 2c 20 74 68 65 6e 20 66 6f 72 20 65 61 63  ry, then for eac
4060: 68 20 72 6f 77 20 69 6e 20 74 68 65 20 71 75 65  h row in the que
4070: 72 79 20 72 65 73 75 6c 74 0a 2a 2a 20 74 68 65  ry result.** the
4080: 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 66 75 6e   xCallback() fun
4090: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e  ction is called.
40a0: 20 20 70 41 72 67 20 62 65 63 6f 6d 65 73 20 74    pArg becomes t
40b0: 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75  he first.** argu
40c0: 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63  ment to xCallbac
40d0: 6b 28 29 2e 20 20 49 66 20 78 43 61 6c 6c 62 61  k().  If xCallba
40e0: 63 6b 3d 4e 55 4c 4c 20 74 68 65 6e 20 6e 6f 20  ck=NULL then no 
40f0: 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 69 73 20 69  callback.** is i
4100: 6e 76 6f 6b 65 64 2c 20 65 76 65 6e 20 66 6f 72  nvoked, even for
4110: 20 71 75 65 72 69 65 73 2e 0a 2a 2f 0a 69 6e 74   queries..*/.int
4120: 20 73 71 6c 69 74 65 5f 65 78 65 63 28 0a 20 20   sqlite_exec(.  
4130: 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20  sqlite *db,     
4140: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
4150: 68 65 20 64 61 74 61 62 61 73 65 20 6f 6e 20 77  he database on w
4160: 68 69 63 68 20 74 68 65 20 53 51 4c 20 65 78 65  hich the SQL exe
4170: 63 75 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74  cutes */.  const
4180: 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20   char *zSql,    
4190: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51         /* The SQ
41a0: 4c 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64  L to be executed
41b0: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 63 61 6c   */.  sqlite_cal
41c0: 6c 62 61 63 6b 20 78 43 61 6c 6c 62 61 63 6b 2c  lback xCallback,
41d0: 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 69 73    /* Invoke this
41e0: 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e   callback routin
41f0: 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72  e */.  void *pAr
4200: 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  g,              
4210: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75     /* First argu
4220: 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63  ment to xCallbac
4230: 6b 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a  k() */.  char **
4240: 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 20  pzErrMsg        
4250: 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 65 72       /* Write er
4260: 72 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 72  ror messages her
4270: 65 20 2a 2f 0a 29 7b 0a 20 20 50 61 72 73 65 20  e */.){.  Parse 
4280: 73 50 61 72 73 65 3b 0a 0a 20 20 69 66 28 20 70  sParse;..  if( p
4290: 7a 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72 72  zErrMsg ) *pzErr
42a0: 4d 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20 28  Msg = 0;.  if( (
42b0: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
42c0: 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 3d  TE_Initialized)=
42d0: 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63  =0 ){.    int rc
42e0: 20 3d 20 73 71 6c 69 74 65 49 6e 69 74 28 64 62   = sqliteInit(db
42f0: 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  , pzErrMsg);.   
4300: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
4310: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  OK ){.      sqli
4320: 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45  teStrRealloc(pzE
4330: 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 72 65  rrMsg);.      re
4340: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20  turn rc;.    }. 
4350: 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61   }.  memset(&sPa
4360: 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73  rse, 0, sizeof(s
4370: 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72 73  Parse));.  sPars
4380: 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 73 50 61  e.db = db;.  sPa
4390: 72 73 65 2e 70 42 65 20 3d 20 64 62 2d 3e 70 42  rse.pBe = db->pB
43a0: 65 3b 0a 20 20 73 50 61 72 73 65 2e 78 43 61 6c  e;.  sParse.xCal
43b0: 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63  lback = xCallbac
43c0: 6b 3b 0a 20 20 73 50 61 72 73 65 2e 70 41 72 67  k;.  sParse.pArg
43d0: 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74   = pArg;.  sqlit
43e0: 65 52 75 6e 50 61 72 73 65 72 28 26 73 50 61 72  eRunParser(&sPar
43f0: 73 65 2c 20 7a 53 71 6c 2c 20 70 7a 45 72 72 4d  se, zSql, pzErrM
4400: 73 67 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74  sg);.  if( sqlit
4410: 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20  e_malloc_failed 
4420: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74  ){.    sqliteSet
4430: 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c  String(pzErrMsg,
4440: 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22   "out of memory"
4450: 2c 20 30 29 3b 0a 20 20 20 20 73 50 61 72 73 65  , 0);.    sParse
4460: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d  .rc = SQLITE_NOM
4470: 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 42 74  EM;.    sqliteBt
4480: 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e  reeRollback(db->
4490: 70 42 65 29 3b 0a 20 20 20 20 69 66 28 20 64 62  pBe);.    if( db
44a0: 2d 3e 70 42 65 54 65 6d 70 20 29 20 73 71 6c 69  ->pBeTemp ) sqli
44b0: 74 65 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28  teBtreeRollback(
44c0: 64 62 2d 3e 70 42 65 54 65 6d 70 29 3b 0a 20 20  db->pBeTemp);.  
44d0: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e    db->flags &= ~
44e0: 53 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b 0a  SQLITE_InTrans;.
44f0: 20 20 20 20 63 6c 65 61 72 48 61 73 68 54 61 62      clearHashTab
4500: 6c 65 28 64 62 2c 20 30 29 3b 0a 20 20 7d 0a 20  le(db, 0);.  }. 
4510: 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f   sqliteStrReallo
4520: 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69  c(pzErrMsg);.  i
4530: 66 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51  f( sParse.rc==SQ
4540: 4c 49 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20  LITE_SCHEMA ){. 
4550: 20 20 20 63 6c 65 61 72 48 61 73 68 54 61 62 6c     clearHashTabl
4560: 65 28 64 62 2c 20 31 29 3b 0a 20 20 7d 0a 20 20  e(db, 1);.  }.  
4570: 72 65 74 75 72 6e 20 73 50 61 72 73 65 2e 72 63  return sParse.rc
4580: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
4590: 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e  routine implemen
45a0: 74 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 61  ts a busy callba
45b0: 63 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 61  ck that sleeps a
45c0: 6e 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 69  nd tries.** agai
45d0: 6e 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75  n until a timeou
45e0: 74 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 68  t value is reach
45f0: 65 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 74  ed.  The timeout
4600: 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20   value is.** an 
4610: 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f  integer number o
4620: 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70  f milliseconds p
4630: 61 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20  assed in as the 
4640: 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e  first.** argumen
4650: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  t..*/.static int
4660: 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75   sqliteDefaultBu
4670: 73 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69  syCallback(. voi
4680: 64 20 2a 54 69 6d 65 6f 75 74 2c 20 20 20 20 20  d *Timeout,     
4690: 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d        /* Maximum
46a0: 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20   amount of time 
46b0: 74 6f 20 77 61 69 74 20 2a 2f 0a 20 63 6f 6e 73  to wait */. cons
46c0: 74 20 63 68 61 72 20 2a 4e 6f 74 55 73 65 64 2c  t char *NotUsed,
46d0: 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 6d 65       /* The name
46e0: 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68   of the table th
46f0: 61 74 20 69 73 20 62 75 73 79 20 2a 2f 0a 20 69  at is busy */. i
4700: 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20  nt count        
4710: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
4720: 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65  r of times table
4730: 20 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a   has been busy *
4740: 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f  /.){.#if SQLITE_
4750: 4d 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31 0a  MIN_SLEEP_MS==1.
4760: 20 20 69 6e 74 20 64 65 6c 61 79 20 3d 20 31 30    int delay = 10
4770: 3b 0a 20 20 69 6e 74 20 70 72 69 6f 72 5f 64 65  ;.  int prior_de
4780: 6c 61 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 74  lay = 0;.  int t
4790: 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54 69  imeout = (int)Ti
47a0: 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 69 3b 0a  meout;.  int i;.
47b0: 0a 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 63 6f  .  for(i=1; i<co
47c0: 75 6e 74 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20  unt; i++){ .    
47d0: 70 72 69 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 64  prior_delay += d
47e0: 65 6c 61 79 3b 0a 20 20 20 20 64 65 6c 61 79 20  elay;.    delay 
47f0: 3d 20 64 65 6c 61 79 2a 32 3b 0a 20 20 20 20 69  = delay*2;.    i
4800: 66 28 20 64 65 6c 61 79 3e 3d 31 30 30 30 20 29  f( delay>=1000 )
4810: 7b 0a 20 20 20 20 20 20 64 65 6c 61 79 20 3d 20  {.      delay = 
4820: 31 30 30 30 3b 0a 20 20 20 20 20 20 70 72 69 6f  1000;.      prio
4830: 72 5f 64 65 6c 61 79 20 2b 3d 20 31 30 30 30 2a  r_delay += 1000*
4840: 28 63 6f 75 6e 74 20 2d 20 69 20 2d 20 31 29 3b  (count - i - 1);
4850: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  .      break;.  
4860: 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 72    }.  }.  if( pr
4870: 69 6f 72 5f 64 65 6c 61 79 20 2b 20 64 65 6c 61  ior_delay + dela
4880: 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20  y > timeout ){. 
4890: 20 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f     delay = timeo
48a0: 75 74 20 2d 20 70 72 69 6f 72 5f 64 65 6c 61 79  ut - prior_delay
48b0: 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c  ;.    if( delay<
48c0: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
48d0: 20 7d 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c 65   }.  sqliteOsSle
48e0: 65 70 28 64 65 6c 61 79 29 3b 0a 20 20 72 65 74  ep(delay);.  ret
48f0: 75 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69  urn 1;.#else.  i
4900: 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e  nt timeout = (in
4910: 74 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28  t)Timeout;.  if(
4920: 20 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20   (count+1)*1000 
4930: 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20  > timeout ){.   
4940: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20   return 0;.  }. 
4950: 20 73 71 6c 69 74 65 4f 73 53 6c 65 65 70 28 31   sqliteOsSleep(1
4960: 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31  000);.  return 1
4970: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a  ;.#endif.}../*.*
4980: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
4990: 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61 6c  ets the busy cal
49a0: 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c  lback for an Sql
49b0: 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20  ite database to 
49c0: 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c  the.** given cal
49d0: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77  lback function w
49e0: 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72  ith the given ar
49f0: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20  gument..*/.void 
4a00: 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64  sqlite_busy_hand
4a10: 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a 64  ler(.  sqlite *d
4a20: 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79  b,.  int (*xBusy
4a30: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68  )(void*,const ch
4a40: 61 72 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64  ar*,int),.  void
4a50: 20 2a 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d 3e   *pArg.){.  db->
4a60: 78 42 75 73 79 43 61 6c 6c 62 61 63 6b 20 3d 20  xBusyCallback = 
4a70: 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e 70 42 75  xBusy;.  db->pBu
4a80: 73 79 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d 0a  syArg = pArg;.}.
4a90: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
4aa0: 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64  ine installs a d
4ab0: 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64  efault busy hand
4ac0: 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20 66  ler that waits f
4ad0: 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66  or the.** specif
4ae0: 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69  ied number of mi
4af0: 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72  lliseconds befor
4b00: 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a  e returning 0..*
4b10: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 75  /.void sqlite_bu
4b20: 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74  sy_timeout(sqlit
4b30: 65 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a  e *db, int ms){.
4b40: 20 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20    if( ms>0 ){.  
4b50: 20 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61    sqlite_busy_ha
4b60: 6e 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65  ndler(db, sqlite
4b70: 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62  DefaultBusyCallb
4b80: 61 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b  ack, (void*)ms);
4b90: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71  .  }else{.    sq
4ba0: 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65  lite_busy_handle
4bb0: 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d  r(db, 0, 0);.  }
4bc0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20  .}../*.** Cause 
4bd0: 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72  any pending oper
4be0: 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74  ation to stop at
4bf0: 20 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70   its earliest op
4c00: 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f  portunity..*/.vo
4c10: 69 64 20 73 71 6c 69 74 65 5f 69 6e 74 65 72 72  id sqlite_interr
4c20: 75 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29 7b  upt(sqlite *db){
4c30: 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20  .  db->flags |= 
4c40: 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74  SQLITE_Interrupt
4c50: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f  ;.}../*.** Windo
4c60: 77 73 20 73 79 73 74 65 6d 73 20 73 68 6f 75 6c  ws systems shoul
4c70: 64 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74  d call this rout
4c80: 69 6e 65 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f  ine to free memo
4c90: 72 79 20 74 68 61 74 0a 2a 2a 20 69 73 20 72 65  ry that.** is re
4ca0: 74 75 72 6e 65 64 20 69 6e 20 74 68 65 20 69 6e  turned in the in
4cb0: 20 74 68 65 20 65 72 72 6d 73 67 20 70 61 72 61   the errmsg para
4cc0: 6d 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 5f  meter of sqlite_
4cd0: 6f 70 65 6e 28 29 20 77 68 65 6e 0a 2a 2a 20 53  open() when.** S
4ce0: 51 4c 69 74 65 20 69 73 20 61 20 44 4c 4c 2e 20  QLite is a DLL. 
4cf0: 20 46 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e   For some reason
4d00: 2c 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 77 6f  , it does not wo
4d10: 72 6b 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28  rk to call free(
4d20: 29 0a 2a 2a 20 64 69 72 65 63 74 6c 79 2e 0a 2a  ).** directly..*
4d30: 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 77  *.** Note that w
4d40: 65 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 66  e need to call f
4d50: 72 65 65 28 29 20 6e 6f 74 20 73 71 6c 69 74 65  ree() not sqlite
4d60: 46 72 65 65 28 29 20 68 65 72 65 2c 20 73 69 6e  Free() here, sin
4d70: 63 65 20 65 76 65 72 79 0a 2a 2a 20 73 74 72 69  ce every.** stri
4d80: 6e 67 20 74 68 61 74 20 69 73 20 65 78 70 6f 72  ng that is expor
4d90: 74 65 64 20 66 72 6f 6d 20 53 51 4c 69 74 65 20  ted from SQLite 
4da0: 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65  should have alre
4db0: 61 64 79 20 70 61 73 73 65 64 20 74 68 72 6f 75  ady passed throu
4dc0: 67 68 0a 2a 2a 20 73 71 6c 69 74 65 53 74 72 52  gh.** sqliteStrR
4dd0: 65 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69  ealloc()..*/.voi
4de0: 64 20 73 71 6c 69 74 65 5f 66 72 65 65 6d 65 6d  d sqlite_freemem
4df0: 28 76 6f 69 64 20 2a 70 29 7b 20 66 72 65 65 28  (void *p){ free(
4e00: 70 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e  p); }../*.** Win
4e10: 64 6f 77 73 20 73 79 73 74 65 6d 73 20 6e 65 65  dows systems nee
4e20: 64 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 63  d functions to c
4e30: 61 6c 6c 20 74 6f 20 72 65 74 75 72 6e 20 74 68  all to return th
4e40: 65 20 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e  e sqlite_version
4e50: 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 5f 65  .** and sqlite_e
4e60: 6e 63 6f 64 69 6e 67 20 73 74 72 69 6e 67 73 2e  ncoding strings.
4e70: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a  .*/.const char *
4e80: 73 71 6c 69 74 65 5f 6c 69 62 76 65 72 73 69 6f  sqlite_libversio
4e90: 6e 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20  n(void){ return 
4ea0: 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 3b 20  sqlite_version; 
4eb0: 7d 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  }.const char *sq
4ec0: 6c 69 74 65 5f 6c 69 62 65 6e 63 6f 64 69 6e 67  lite_libencoding
4ed0: 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 73  (void){ return s
4ee0: 71 6c 69 74 65 5f 65 6e 63 6f 64 69 6e 67 3b 20  qlite_encoding; 
4ef0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20  }../*.** Create 
4f00: 6e 65 77 20 75 73 65 72 2d 64 65 66 69 6e 65 64  new user-defined
4f10: 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65   functions.  The
4f20: 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 66   sqlite_create_f
4f30: 75 6e 63 74 69 6f 6e 28 29 0a 2a 2a 20 72 6f 75  unction().** rou
4f40: 74 69 6e 65 20 63 72 65 61 74 65 73 20 61 20 72  tine creates a r
4f50: 65 67 75 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20  egular function 
4f60: 61 6e 64 20 73 71 6c 69 74 65 5f 63 72 65 61 74  and sqlite_creat
4f70: 65 5f 61 67 67 72 65 67 61 74 65 28 29 0a 2a 2a  e_aggregate().**
4f80: 20 63 72 65 61 74 65 73 20 61 6e 20 61 67 67 72   creates an aggr
4f90: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 2e 0a  egate function..
4fa0: 2a 2a 0a 2a 2a 20 50 61 73 73 69 6e 67 20 61 20  **.** Passing a 
4fb0: 4e 55 4c 4c 20 78 46 75 6e 63 20 61 72 67 75 6d  NULL xFunc argum
4fc0: 65 6e 74 20 6f 72 20 4e 55 4c 4c 20 78 53 74 65  ent or NULL xSte
4fd0: 70 20 61 6e 64 20 78 46 69 6e 61 6c 69 7a 65 20  p and xFinalize 
4fe0: 61 72 67 75 6d 65 6e 74 73 0a 2a 2a 20 64 69 73  arguments.** dis
4ff0: 61 62 6c 65 73 20 74 68 65 20 66 75 6e 63 74 69  ables the functi
5000: 6f 6e 2e 20 20 43 61 6c 6c 69 6e 67 20 73 71 6c  on.  Calling sql
5010: 69 74 65 5f 63 72 65 61 74 65 5f 66 75 6e 63 74  ite_create_funct
5020: 69 6f 6e 28 29 20 77 69 74 68 20 74 68 65 0a 2a  ion() with the.*
5030: 2a 20 73 61 6d 65 20 6e 61 6d 65 20 61 6e 64 20  * same name and 
5040: 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65  number of argume
5050: 6e 74 73 20 61 73 20 61 20 70 72 69 6f 72 20 63  nts as a prior c
5060: 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65  all to.** sqlite
5070: 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74  _create_aggregat
5080: 65 28 29 20 64 69 73 61 62 6c 65 73 20 74 68 65  e() disables the
5090: 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 0a 2a   prior call to.*
50a0: 2a 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f  * sqlite_create_
50b0: 61 67 67 72 65 67 61 74 65 28 29 2c 20 61 6e 64  aggregate(), and
50c0: 20 76 69 63 65 20 76 65 72 73 61 2e 0a 2a 2a 0a   vice versa..**.
50d0: 2a 2a 20 49 66 20 6e 41 72 67 20 69 73 20 2d 31  ** If nArg is -1
50e0: 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74   it means that t
50f0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c  his function wil
5100: 6c 20 61 63 63 65 70 74 20 61 6e 79 20 6e 75 6d  l accept any num
5110: 62 65 72 0a 2a 2a 20 6f 66 20 61 72 67 75 6d 65  ber.** of argume
5120: 6e 74 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 30  nts, including 0
5130: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f  ..*/.int sqlite_
5140: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28  create_function(
5150: 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20  .  sqlite *db,  
5160: 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74          /* Add t
5170: 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74  he function to t
5180: 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e  his database con
5190: 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e  nection */.  con
51a0: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20  st char *zName, 
51b0: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65    /* Name of the
51c0: 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 61 64 64   function to add
51d0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 72 67 2c 20   */.  int nArg, 
51e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
51f0: 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74  mber of argument
5200: 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46  s */.  void (*xF
5210: 75 6e 63 29 28 73 71 6c 69 74 65 5f 66 75 6e 63  unc)(sqlite_func
5220: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72  *,int,const char
5230: 2a 2a 29 2c 20 20 2f 2a 20 54 68 65 20 69 6d 70  **),  /* The imp
5240: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20  lementation */. 
5250: 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61   void *pUserData
5260: 20 20 20 20 20 20 2f 2a 20 55 73 65 72 20 64 61        /* User da
5270: 74 61 20 2a 2f 0a 29 7b 0a 20 20 46 75 6e 63 44  ta */.){.  FuncD
5280: 65 66 20 2a 70 3b 0a 20 20 69 66 28 20 64 62 3d  ef *p;.  if( db=
5290: 3d 30 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 29  =0 || zName==0 )
52a0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 20 3d   return 1;.  p =
52b0: 20 73 71 6c 69 74 65 46 69 6e 64 46 75 6e 63 74   sqliteFindFunct
52c0: 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 73  ion(db, zName, s
52d0: 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 6e 41  trlen(zName), nA
52e0: 72 67 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 3d  rg, 1);.  if( p=
52f0: 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20  =0 ) return 1;. 
5300: 20 70 2d 3e 78 46 75 6e 63 20 3d 20 78 46 75 6e   p->xFunc = xFun
5310: 63 3b 0a 20 20 70 2d 3e 78 53 74 65 70 20 3d 20  c;.  p->xStep = 
5320: 30 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a  0;.  p->xFinaliz
5330: 65 20 3d 20 30 3b 0a 20 20 70 2d 3e 70 55 73 65  e = 0;.  p->pUse
5340: 72 44 61 74 61 20 3d 20 70 55 73 65 72 44 61 74  rData = pUserDat
5350: 61 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d  a;.  return 0;.}
5360: 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 72 65 61  .int sqlite_crea
5370: 74 65 5f 61 67 67 72 65 67 61 74 65 28 0a 20 20  te_aggregate(.  
5380: 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20  sqlite *db,     
5390: 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20       /* Add the 
53a0: 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74 68 69 73  function to this
53b0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
53c0: 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  tion */.  const 
53d0: 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20 20 2f  char *zName,   /
53e0: 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 75  * Name of the fu
53f0: 6e 63 74 69 6f 6e 20 74 6f 20 61 64 64 20 2a 2f  nction to add */
5400: 0a 20 20 69 6e 74 20 6e 41 72 67 2c 20 20 20 20  .  int nArg,    
5410: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
5420: 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 2a  r of arguments *
5430: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70  /.  void (*xStep
5440: 29 28 73 71 6c 69 74 65 5f 66 75 6e 63 2a 2c 69  )(sqlite_func*,i
5450: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2a 29  nt,const char**)
5460: 2c 20 2f 2a 20 54 68 65 20 73 74 65 70 20 66 75  , /* The step fu
5470: 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64  nction */.  void
5480: 20 28 2a 78 46 69 6e 61 6c 69 7a 65 29 28 73 71   (*xFinalize)(sq
5490: 6c 69 74 65 5f 66 75 6e 63 2a 29 2c 20 20 20 20  lite_func*),    
54a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
54b0: 20 66 69 6e 61 6c 69 7a 65 72 20 2a 2f 0a 20 20   finalizer */.  
54c0: 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 20  void *pUserData 
54d0: 20 20 20 20 20 2f 2a 20 55 73 65 72 20 64 61 74       /* User dat
54e0: 61 20 2a 2f 0a 29 7b 0a 20 20 46 75 6e 63 44 65  a */.){.  FuncDe
54f0: 66 20 2a 70 3b 0a 20 20 69 66 28 20 64 62 3d 3d  f *p;.  if( db==
5500: 30 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 29 20  0 || zName==0 ) 
5510: 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 20 3d 20  return 1;.  p = 
5520: 73 71 6c 69 74 65 46 69 6e 64 46 75 6e 63 74 69  sqliteFindFuncti
5530: 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 73 74  on(db, zName, st
5540: 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 6e 41 72  rlen(zName), nAr
5550: 67 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 3d 3d  g, 1);.  if( p==
5560: 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20  0 ) return 1;.  
5570: 70 2d 3e 78 46 75 6e 63 20 3d 20 30 3b 0a 20 20  p->xFunc = 0;.  
5580: 70 2d 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70  p->xStep = xStep
5590: 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65  ;.  p->xFinalize
55a0: 20 3d 20 78 46 69 6e 61 6c 69 7a 65 3b 0a 20 20   = xFinalize;.  
55b0: 70 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70  p->pUserData = p
55c0: 55 73 65 72 44 61 74 61 3b 0a 20 20 72 65 74 75  UserData;.  retu
55d0: 72 6e 20 30 3b 0a 7d 0a                          rn 0;.}.