/ Hex Artifact Content
Login

Artifact cbfa66d53578935790488f37f476d4932e36c01a:


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 34 20 32 30 30 32 2f 30 32 2f  ,v 1.64 2002/02/
0280: 32 37 20 30 31 3a 35 33 3a 31 33 20 64 72 68 20  27 01:53:13 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 66 27 3a  ){.    case 'f':
0620: 20 7b 20 20 2f 2a 20 46 69 6c 65 20 66 6f 72 6d   {  /* File form
0630: 61 74 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e  at */.      db->
0640: 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 61 74  file_format = at
0650: 6f 69 28 61 72 67 76 5b 33 5d 29 3b 0a 20 20 20  oi(argv[3]);.   
0660: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
0670: 20 20 20 20 63 61 73 65 20 27 73 27 3a 20 7b 20      case 's': { 
0680: 2f 2a 20 53 63 68 65 6d 61 20 63 6f 6f 6b 69 65  /* Schema cookie
0690: 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 73 63   */.      db->sc
06a0: 68 65 6d 61 5f 63 6f 6f 6b 69 65 20 3d 20 61 74  hema_cookie = at
06b0: 6f 69 28 61 72 67 76 5b 33 5d 29 3b 0a 20 20 20  oi(argv[3]);.   
06c0: 20 20 20 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b     db->next_cook
06d0: 69 65 20 3d 20 64 62 2d 3e 73 63 68 65 6d 61 5f  ie = db->schema_
06e0: 63 6f 6f 6b 69 65 3b 0a 20 20 20 20 20 20 62 72  cookie;.      br
06f0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  eak;.    }.    c
0700: 61 73 65 20 27 76 27 3a 0a 20 20 20 20 63 61 73  ase 'v':.    cas
0710: 65 20 27 69 27 3a 0a 20 20 20 20 63 61 73 65 20  e 'i':.    case 
0720: 27 74 27 3a 20 7b 20 20 2f 2a 20 43 52 45 41 54  't': {  /* CREAT
0730: 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54 45 20  E TABLE, CREATE 
0740: 49 4e 44 45 58 2c 20 6f 72 20 43 52 45 41 54 45  INDEX, or CREATE
0750: 20 56 49 45 57 20 73 74 61 74 65 6d 65 6e 74 73   VIEW statements
0760: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 61 72   */.      if( ar
0770: 67 76 5b 33 5d 20 26 26 20 61 72 67 76 5b 33 5d  gv[3] && argv[3]
0780: 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 2f  [0] ){.        /
0790: 2a 20 43 61 6c 6c 20 74 68 65 20 70 61 72 73 65  * Call the parse
07a0: 72 20 74 6f 20 70 72 6f 63 65 73 73 20 61 20 43  r to process a C
07b0: 52 45 41 54 45 20 54 41 42 4c 45 2c 20 49 4e 44  REATE TABLE, IND
07c0: 45 58 20 6f 72 20 56 49 45 57 2e 0a 20 20 20 20  EX or VIEW..    
07d0: 20 20 20 20 2a 2a 20 42 75 74 20 62 65 63 61 75      ** But becau
07e0: 73 65 20 73 50 61 72 73 65 2e 69 6e 69 74 46 6c  se sParse.initFl
07f0: 61 67 20 69 73 20 73 65 74 20 74 6f 20 31 2c 20  ag is set to 1, 
0800: 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73 20  no VDBE code is 
0810: 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 20 20  generated.      
0820: 20 20 2a 2a 20 6f 72 20 65 78 65 63 75 74 65 64    ** or executed
0830: 2e 20 20 41 6c 6c 20 74 68 65 20 70 61 72 73 65  .  All the parse
0840: 72 20 64 6f 65 73 20 69 73 20 62 75 69 6c 64 20  r does is build 
0850: 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 64 61 74  the internal dat
0860: 61 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 72  a.        ** str
0870: 75 63 74 75 72 65 73 20 74 68 61 74 20 64 65 73  uctures that des
0880: 63 72 69 62 65 20 74 68 65 20 74 61 62 6c 65 2c  cribe the table,
0890: 20 69 6e 64 65 78 2c 20 6f 72 20 76 69 65 77 2e   index, or view.
08a0: 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  .        */.    
08b0: 20 20 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72      memset(&sPar
08c0: 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 50  se, 0, sizeof(sP
08d0: 61 72 73 65 29 29 3b 0a 20 20 20 20 20 20 20 20  arse));.        
08e0: 73 50 61 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a  sParse.db = db;.
08f0: 20 20 20 20 20 20 20 20 73 50 61 72 73 65 2e 69          sParse.i
0900: 6e 69 74 46 6c 61 67 20 3d 20 31 3b 0a 20 20 20  nitFlag = 1;.   
0910: 20 20 20 20 20 73 50 61 72 73 65 2e 6e 65 77 54       sParse.newT
0920: 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76 5b  num = atoi(argv[
0930: 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  2]);.        sql
0940: 69 74 65 52 75 6e 50 61 72 73 65 72 28 26 73 50  iteRunParser(&sP
0950: 61 72 73 65 2c 20 61 72 67 76 5b 33 5d 2c 20 30  arse, argv[3], 0
0960: 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  );.      }else{.
0970: 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68          /* If th
0980: 65 20 53 51 4c 20 63 6f 6c 75 6d 6e 20 69 73 20  e SQL column is 
0990: 62 6c 61 6e 6b 20 69 74 20 6d 65 61 6e 73 20 74  blank it means t
09a0: 68 69 73 20 69 73 20 61 6e 20 69 6e 64 65 78 20  his is an index 
09b0: 74 68 61 74 0a 20 20 20 20 20 20 20 20 2a 2a 20  that.        ** 
09c0: 77 61 73 20 63 72 65 61 74 65 64 20 74 6f 20 62  was created to b
09d0: 65 20 74 68 65 20 50 52 49 4d 41 52 59 20 4b 45  e the PRIMARY KE
09e0: 59 20 6f 72 20 74 6f 20 66 75 6c 66 69 6c 6c 20  Y or to fulfill 
09f0: 61 20 55 4e 49 51 55 45 0a 20 20 20 20 20 20 20  a UNIQUE.       
0a00: 20 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74 20 66   ** constraint f
0a10: 6f 72 20 61 20 43 52 45 41 54 45 20 54 41 42 4c  or a CREATE TABL
0a20: 45 2e 20 20 54 68 65 20 69 6e 64 65 78 20 73 68  E.  The index sh
0a30: 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64  ould have alread
0a40: 79 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 65 65  y.        ** bee
0a50: 6e 20 63 72 65 61 74 65 64 20 77 68 65 6e 20 77  n created when w
0a60: 65 20 70 72 6f 63 65 73 73 65 64 20 74 68 65 20  e processed the 
0a70: 43 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20 41  CREATE TABLE.  A
0a80: 6c 6c 20 77 65 20 68 61 76 65 0a 20 20 20 20 20  ll we have.     
0a90: 20 20 20 2a 2a 20 74 6f 20 64 6f 20 68 65 72 65     ** to do here
0aa0: 20 69 73 20 72 65 63 6f 72 64 20 74 68 65 20 72   is record the r
0ab0: 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20  oot page number 
0ac0: 66 6f 72 20 74 68 61 74 20 69 6e 64 65 78 2e 0a  for that index..
0ad0: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20          */.     
0ae0: 20 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78     Index *pIndex
0af0: 20 3d 20 73 71 6c 69 74 65 46 69 6e 64 49 6e 64   = sqliteFindInd
0b00: 65 78 28 64 62 2c 20 61 72 67 76 5b 31 5d 29 3b  ex(db, argv[1]);
0b10: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 49 6e  .        if( pIn
0b20: 64 65 78 3d 3d 30 20 7c 7c 20 70 49 6e 64 65 78  dex==0 || pIndex
0b30: 2d 3e 74 6e 75 6d 21 3d 30 20 29 7b 0a 20 20 20  ->tnum!=0 ){.   
0b40: 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63         /* This c
0b50: 61 6e 20 6f 63 63 75 72 20 69 66 20 74 68 65 72  an occur if ther
0b60: 65 20 65 78 69 73 74 73 20 61 6e 20 69 6e 64 65  e exists an inde
0b70: 78 20 6f 6e 20 61 20 54 45 4d 50 20 74 61 62 6c  x on a TEMP tabl
0b80: 65 20 77 68 69 63 68 0a 20 20 20 20 20 20 20 20  e which.        
0b90: 20 20 2a 2a 20 68 61 73 20 74 68 65 20 73 61 6d    ** has the sam
0ba0: 65 20 6e 61 6d 65 20 61 73 20 61 6e 6f 74 68 65  e name as anothe
0bb0: 72 20 69 6e 64 65 78 20 6f 6e 20 61 20 70 65 72  r index on a per
0bc0: 6d 61 6e 65 6e 74 20 69 6e 64 65 78 2e 20 20 53  manent index.  S
0bd0: 69 6e 63 65 0a 20 20 20 20 20 20 20 20 20 20 2a  ince.          *
0be0: 2a 20 74 68 65 20 70 65 72 6d 61 6e 65 6e 74 20  * the permanent 
0bf0: 74 61 62 6c 65 20 69 73 20 68 69 64 64 65 6e 20  table is hidden 
0c00: 62 79 20 74 68 65 20 54 45 4d 50 20 74 61 62 6c  by the TEMP tabl
0c10: 65 2c 20 77 65 20 63 61 6e 20 61 6c 73 6f 0a 20  e, we can also. 
0c20: 20 20 20 20 20 20 20 20 20 2a 2a 20 73 61 66 65           ** safe
0c30: 6c 79 20 69 67 6e 6f 72 65 20 74 68 65 20 69 6e  ly ignore the in
0c40: 64 65 78 20 6f 6e 20 74 68 65 20 70 65 72 6d 61  dex on the perma
0c50: 6e 65 6e 74 20 74 61 62 6c 65 2e 0a 20 20 20 20  nent table..    
0c60: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20        */.       
0c70: 20 20 20 2f 2a 20 44 6f 20 4e 6f 74 68 69 6e 67     /* Do Nothing
0c80: 20 2a 2f 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c   */;.        }el
0c90: 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 70 49  se{.          pI
0ca0: 6e 64 65 78 2d 3e 74 6e 75 6d 20 3d 20 61 74 6f  ndex->tnum = ato
0cb0: 69 28 61 72 67 76 5b 32 5d 29 3b 0a 20 20 20 20  i(argv[2]);.    
0cc0: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20      }.      }.  
0cd0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
0ce0: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a  .    default: {.
0cf0: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63 61        /* This ca
0d00: 6e 20 6e 6f 74 20 68 61 70 70 65 6e 21 20 2a 2f  n not happen! */
0d10: 0a 20 20 20 20 20 20 6e 45 72 72 20 3d 20 31 3b  .      nErr = 1;
0d20: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e  .      assert( n
0d30: 45 72 72 3d 3d 30 20 29 3b 0a 20 20 20 20 7d 0a  Err==0 );.    }.
0d40: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 45 72    }.  return nEr
0d50: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65  r;.}../*.** Atte
0d60: 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 20  mpt to read the 
0d70: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20  database schema 
0d80: 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 69  and initialize i
0d90: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64 61 74 61 20  nternal.** data 
0da0: 73 74 72 75 63 74 75 72 65 73 2e 20 20 52 65 74  structures.  Ret
0db0: 75 72 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 53  urn one of the S
0dc0: 51 4c 49 54 45 5f 20 65 72 72 6f 72 20 63 6f 64  QLITE_ error cod
0dd0: 65 73 20 74 6f 0a 2a 2a 20 69 6e 64 69 63 61 74  es to.** indicat
0de0: 65 20 73 75 63 63 65 73 73 20 6f 72 20 66 61 69  e success or fai
0df0: 6c 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65  lure..**.** Afte
0e00: 72 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69  r the database i
0e10: 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20 74  s initialized, t
0e20: 68 65 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 61  he SQLITE_Initia
0e30: 6c 69 7a 65 64 0a 2a 2a 20 62 69 74 20 69 73 20  lized.** bit is 
0e40: 73 65 74 20 69 6e 20 74 68 65 20 66 6c 61 67 73  set in the flags
0e50: 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 73 71   field of the sq
0e60: 6c 69 74 65 20 73 74 72 75 63 74 75 72 65 2e 20  lite structure. 
0e70: 20 41 6e 0a 2a 2a 20 61 74 74 65 6d 70 74 20 69   An.** attempt i
0e80: 73 20 6d 61 64 65 20 74 6f 20 69 6e 69 74 69 61  s made to initia
0e90: 6c 69 7a 65 20 74 68 65 20 64 61 74 61 62 61 73  lize the databas
0ea0: 65 20 61 73 20 73 6f 6f 6e 20 61 73 20 69 74 0a  e as soon as it.
0eb0: 2a 2a 20 69 73 20 6f 70 65 6e 65 64 2e 20 20 49  ** is opened.  I
0ec0: 66 20 74 68 61 74 20 66 61 69 6c 73 20 28 70 65  f that fails (pe
0ed0: 72 68 61 70 73 20 62 65 63 61 75 73 65 20 61 6e  rhaps because an
0ee0: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 0a 2a 2a  other process.**
0ef0: 20 68 61 73 20 74 68 65 20 73 71 6c 69 74 65 5f   has the sqlite_
0f00: 6d 61 73 74 65 72 20 74 61 62 6c 65 20 6c 6f 63  master table loc
0f10: 6b 65 64 29 20 74 68 61 6e 20 61 6e 6f 74 68 65  ked) than anothe
0f20: 72 20 61 74 74 65 6d 70 74 0a 2a 2a 20 69 73 20  r attempt.** is 
0f30: 6d 61 64 65 20 74 68 65 20 66 69 72 73 74 20 74  made the first t
0f40: 69 6d 65 20 74 68 65 20 64 61 74 61 62 61 73 65  ime the database
0f50: 20 69 73 20 61 63 63 65 73 73 65 64 2e 0a 2a 2f   is accessed..*/
0f60: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69  .static int sqli
0f70: 74 65 49 6e 69 74 28 73 71 6c 69 74 65 20 2a 64  teInit(sqlite *d
0f80: 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d  b, char **pzErrM
0f90: 73 67 29 7b 0a 20 20 56 64 62 65 20 2a 76 64 62  sg){.  Vdbe *vdb
0fa0: 65 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20  e;.  int rc;..  
0fb0: 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 6d 61 73 74  /*.  ** The mast
0fc0: 65 72 20 64 61 74 61 62 61 73 65 20 74 61 62 6c  er database tabl
0fd0: 65 20 68 61 73 20 61 20 73 74 72 75 63 74 75 72  e has a structur
0fe0: 65 20 6c 69 6b 65 20 74 68 69 73 0a 20 20 2a 2f  e like this.  */
0ff0: 0a 20 20 73 74 61 74 69 63 20 63 68 61 72 20 6d  .  static char m
1000: 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d 20 3d  aster_schema[] =
1010: 20 0a 20 20 20 20 20 22 43 52 45 41 54 45 20 54   .     "CREATE T
1020: 41 42 4c 45 20 22 20 4d 41 53 54 45 52 5f 4e 41  ABLE " MASTER_NA
1030: 4d 45 20 22 20 28 5c 6e 22 0a 20 20 20 20 20 22  ME " (\n".     "
1040: 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a    type text,\n".
1050: 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65 78       "  name tex
1060: 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 62  t,\n".     "  tb
1070: 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a  l_name text,\n".
1080: 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67 65       "  rootpage
1090: 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20   integer,\n".   
10a0: 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22    "  sql text\n"
10b0: 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 0a 20  .     ")".  ;.. 
10c0: 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e   /* The followin
10d0: 67 20 56 44 42 45 20 70 72 6f 67 72 61 6d 20 69  g VDBE program i
10e0: 73 20 75 73 65 64 20 74 6f 20 69 6e 69 74 69 61  s used to initia
10f0: 6c 69 7a 65 20 74 68 65 20 69 6e 74 65 72 6e 61  lize the interna
1100: 6c 0a 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65  l.  ** structure
1110: 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 74 61 62   holding the tab
1120: 6c 65 73 20 61 6e 64 20 69 6e 64 65 78 65 73 20  les and indexes 
1130: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  of the database.
1140: 0a 20 20 2a 2a 20 54 68 65 20 64 61 74 61 62 61  .  ** The databa
1150: 73 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 73 70  se contains a sp
1160: 65 63 69 61 6c 20 74 61 62 6c 65 20 6e 61 6d 65  ecial table name
1170: 64 20 22 73 71 6c 69 74 65 5f 6d 61 73 74 65 72  d "sqlite_master
1180: 22 0a 20 20 2a 2a 20 64 65 66 69 6e 65 64 20 61  ".  ** defined a
1190: 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a 0a  s follows:.  **.
11a0: 20 20 2a 2a 20 20 20 20 43 52 45 41 54 45 20 54    **    CREATE T
11b0: 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d 61 73 74  ABLE sqlite_mast
11c0: 65 72 20 28 0a 20 20 2a 2a 20 20 20 20 20 20 20  er (.  **       
11d0: 20 74 79 70 65 20 20 20 20 20 20 20 74 65 78 74   type       text
11e0: 2c 20 20 20 20 2d 2d 20 20 45 69 74 68 65 72 20  ,    --  Either 
11f0: 22 74 61 62 6c 65 22 20 6f 72 20 22 69 6e 64 65  "table" or "inde
1200: 78 22 20 6f 72 20 22 6d 65 74 61 22 0a 20 20 2a  x" or "meta".  *
1210: 2a 20 20 20 20 20 20 20 20 6e 61 6d 65 20 20 20  *        name   
1220: 20 20 20 20 74 65 78 74 2c 20 20 20 20 2d 2d 20      text,    -- 
1230: 20 4e 61 6d 65 20 6f 66 20 74 61 62 6c 65 20 6f   Name of table o
1240: 72 20 69 6e 64 65 78 0a 20 20 2a 2a 20 20 20 20  r index.  **    
1250: 20 20 20 20 74 62 6c 5f 6e 61 6d 65 20 20 20 74      tbl_name   t
1260: 65 78 74 2c 20 20 20 20 2d 2d 20 20 41 73 73 6f  ext,    --  Asso
1270: 63 69 61 74 65 64 20 74 61 62 6c 65 20 0a 20 20  ciated table .  
1280: 2a 2a 20 20 20 20 20 20 20 20 72 6f 6f 74 70 61  **        rootpa
1290: 67 65 20 20 20 69 6e 74 65 67 65 72 2c 20 2d 2d  ge   integer, --
12a0: 20 20 54 68 65 20 69 6e 74 65 67 65 72 20 70 61    The integer pa
12b0: 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 6f  ge number of roo
12c0: 74 20 70 61 67 65 0a 20 20 2a 2a 20 20 20 20 20  t page.  **     
12d0: 20 20 20 73 71 6c 20 20 20 20 20 20 20 20 74 65     sql        te
12e0: 78 74 20 20 20 20 20 2d 2d 20 20 54 68 65 20 43  xt     --  The C
12f0: 52 45 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20  REATE statement 
1300: 66 6f 72 20 74 68 69 73 20 6f 62 6a 65 63 74 0a  for this object.
1310: 20 20 2a 2a 20 20 20 20 29 3b 0a 20 20 2a 2a 0a    **    );.  **.
1320: 20 20 2a 2a 20 54 68 65 20 73 71 6c 69 74 65 5f    ** The sqlite_
1330: 6d 61 73 74 65 72 20 74 61 62 6c 65 20 63 6f 6e  master table con
1340: 74 61 69 6e 73 20 61 20 73 69 6e 67 6c 65 20 65  tains a single e
1350: 6e 74 72 79 20 66 6f 72 20 65 61 63 68 20 74 61  ntry for each ta
1360: 62 6c 65 0a 20 20 2a 2a 20 61 6e 64 20 65 61 63  ble.  ** and eac
1370: 68 20 69 6e 64 65 78 2e 20 20 54 68 65 20 22 74  h index.  The "t
1380: 79 70 65 22 20 63 6f 6c 75 6d 6e 20 74 65 6c 6c  ype" column tell
1390: 73 20 77 68 65 74 68 65 72 20 74 68 65 20 65 6e  s whether the en
13a0: 74 72 79 20 69 73 0a 20 20 2a 2a 20 61 20 74 61  try is.  ** a ta
13b0: 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 54  ble or index.  T
13c0: 68 65 20 22 6e 61 6d 65 22 20 63 6f 6c 75 6d 6e  he "name" column
13d0: 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20   is the name of 
13e0: 74 68 65 20 6f 62 6a 65 63 74 2e 0a 20 20 2a 2a  the object..  **
13f0: 20 54 68 65 20 22 74 62 6c 5f 6e 61 6d 65 22 20   The "tbl_name" 
1400: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  is the name of t
1410: 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 74 61  he associated ta
1420: 62 6c 65 2e 20 20 46 6f 72 20 74 61 62 6c 65 73  ble.  For tables
1430: 2c 0a 20 20 2a 2a 20 74 68 65 20 74 62 6c 5f 6e  ,.  ** the tbl_n
1440: 61 6d 65 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6c  ame column is al
1450: 77 61 79 73 20 74 68 65 20 73 61 6d 65 20 61 73  ways the same as
1460: 20 6e 61 6d 65 2e 20 20 46 6f 72 20 69 6e 64 69   name.  For indi
1470: 63 65 73 2c 20 74 68 65 0a 20 20 2a 2a 20 74 62  ces, the.  ** tb
1480: 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20 63 6f  l_name column co
1490: 6e 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 20  ntains the name 
14a0: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61  of the table tha
14b0: 74 20 74 68 65 20 69 6e 64 65 78 0a 20 20 2a 2a  t the index.  **
14c0: 20 69 6e 64 65 78 65 73 2e 20 20 54 68 65 20 22   indexes.  The "
14d0: 72 6f 6f 74 70 61 67 65 22 20 63 6f 6c 75 6d 6e  rootpage" column
14e0: 20 68 6f 6c 64 73 20 74 68 65 20 6e 75 6d 62 65   holds the numbe
14f0: 72 20 6f 66 20 74 68 65 20 72 6f 6f 74 20 70 61  r of the root pa
1500: 67 65 0a 20 20 2a 2a 20 66 6f 72 20 74 68 65 20  ge.  ** for the 
1510: 62 2d 74 72 65 65 20 66 6f 72 20 74 68 65 20 74  b-tree for the t
1520: 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20  able or index.  
1530: 46 69 6e 61 6c 6c 79 2c 20 74 68 65 20 22 73 71  Finally, the "sq
1540: 6c 22 20 63 6f 6c 75 6d 6e 0a 20 20 2a 2a 20 63  l" column.  ** c
1550: 6f 6e 74 61 69 6e 73 20 74 68 65 20 63 6f 6d 70  ontains the comp
1560: 6c 65 74 65 20 74 65 78 74 20 6f 66 20 74 68 65  lete text of the
1570: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 6f 72   CREATE TABLE or
1580: 20 43 52 45 41 54 45 20 49 4e 44 45 58 0a 20 20   CREATE INDEX.  
1590: 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61  ** statement tha
15a0: 74 20 6f 72 69 67 69 6e 61 6c 6c 79 20 63 72 65  t originally cre
15b0: 61 74 65 64 20 74 68 65 20 74 61 62 6c 65 20 6f  ated the table o
15c0: 72 20 69 6e 64 65 78 2e 20 20 49 66 20 61 6e 20  r index.  If an 
15d0: 69 6e 64 65 78 0a 20 20 2a 2a 20 77 61 73 20 63  index.  ** was c
15e0: 72 65 61 74 65 64 20 74 6f 20 66 75 6c 66 69 6c  reated to fulfil
15f0: 6c 20 61 20 50 52 49 4d 41 52 59 20 4b 45 59 20  l a PRIMARY KEY 
1600: 6f 72 20 55 4e 49 51 55 45 20 63 6f 6e 73 74 72  or UNIQUE constr
1610: 61 69 6e 74 20 6f 6e 20 61 20 74 61 62 6c 65 2c  aint on a table,
1620: 0a 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 22  .  ** then the "
1630: 73 71 6c 22 20 63 6f 6c 75 6d 6e 20 69 73 20 4e  sql" column is N
1640: 55 4c 4c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49  ULL..  **.  ** I
1650: 6e 20 66 6f 72 6d 61 74 20 31 2c 20 65 6e 74 72  n format 1, entr
1660: 69 65 73 20 69 6e 20 74 68 65 20 73 71 6c 69 74  ies in the sqlit
1670: 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 20 61  e_master table a
1680: 72 65 20 69 6e 20 61 20 72 61 6e 64 6f 6d 0a 20  re in a random. 
1690: 20 2a 2a 20 6f 72 64 65 72 2e 20 20 54 77 6f 20   ** order.  Two 
16a0: 70 61 73 73 65 73 20 6d 75 73 74 20 62 65 20 6d  passes must be m
16b0: 61 64 65 20 74 68 72 6f 75 67 68 20 74 68 65 20  ade through the 
16c0: 74 61 62 6c 65 20 74 6f 20 69 6e 69 74 69 61 6c  table to initial
16d0: 69 7a 65 0a 20 20 2a 2a 20 69 6e 74 65 72 6e 61  ize.  ** interna
16e0: 6c 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65  l data structure
16f0: 73 2e 20 20 54 68 65 20 66 69 72 73 74 20 70 61  s.  The first pa
1700: 73 73 20 72 65 61 64 73 20 74 61 62 6c 65 20 64  ss reads table d
1710: 65 66 69 6e 69 74 69 6f 6e 73 0a 20 20 2a 2a 20  efinitions.  ** 
1720: 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 20 70  and the second p
1730: 61 73 73 20 72 65 61 64 20 69 6e 64 65 78 20 64  ass read index d
1740: 65 66 69 6e 69 74 69 6f 6e 73 2e 20 20 48 61 76  efinitions.  Hav
1750: 69 6e 67 20 74 77 6f 20 70 61 73 73 65 73 0a 20  ing two passes. 
1760: 20 2a 2a 20 69 6e 73 75 72 65 73 20 74 68 61 74   ** insures that
1770: 20 69 6e 64 69 63 65 73 20 61 70 70 65 61 72 20   indices appear 
1780: 61 66 74 65 72 20 74 68 65 69 72 20 74 61 62 6c  after their tabl
1790: 65 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 6e  es..  **.  ** In
17a0: 20 66 6f 72 6d 61 74 20 32 2c 20 65 6e 74 72 69   format 2, entri
17b0: 65 73 20 61 70 70 65 61 72 20 69 6e 20 63 68 72  es appear in chr
17c0: 6f 6e 6f 6c 6f 67 69 63 61 6c 20 6f 72 64 65 72  onological order
17d0: 2e 20 20 4f 6e 6c 79 20 61 20 73 69 6e 67 6c 65  .  Only a single
17e0: 0a 20 20 2a 2a 20 70 61 73 73 20 6e 65 65 64 73  .  ** pass needs
17f0: 20 74 6f 20 62 65 20 6d 61 64 65 20 74 68 72 6f   to be made thro
1800: 75 67 68 20 74 68 65 20 74 61 62 6c 65 20 73 69  ugh the table si
1810: 6e 63 65 20 65 76 65 72 79 74 68 69 6e 67 20 77  nce everything w
1820: 69 6c 6c 20 62 65 0a 20 20 2a 2a 20 69 6e 20 74  ill be.  ** in t
1830: 68 65 20 77 72 69 74 65 20 6f 72 64 65 72 2e 20  he write order. 
1840: 20 56 49 45 57 73 20 6d 61 79 20 6f 6e 6c 79 20   VIEWs may only 
1850: 6f 63 63 75 72 20 69 6e 20 66 6f 72 6d 61 74 20  occur in format 
1860: 32 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65  2..  **.  ** The
1870: 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 67 72   following progr
1880: 61 6d 20 69 6e 76 6f 6b 65 73 20 69 74 73 20 63  am invokes its c
1890: 61 6c 6c 62 61 63 6b 20 6f 6e 20 74 68 65 20 53  allback on the S
18a0: 51 4c 20 66 6f 72 20 65 61 63 68 0a 20 20 2a 2a  QL for each.  **
18b0: 20 74 61 62 6c 65 20 74 68 65 6e 20 67 6f 65 73   table then goes
18c0: 20 62 61 63 6b 20 61 6e 64 20 69 6e 76 6f 6b 65   back and invoke
18d0: 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 6f  s the callback o
18e0: 6e 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c 20 66  n the.  ** SQL f
18f0: 6f 72 20 65 61 63 68 20 69 6e 64 65 78 2e 20 20  or each index.  
1900: 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 77 69 6c  The callback wil
1910: 6c 20 69 6e 76 6f 6b 65 20 74 68 65 0a 20 20 2a  l invoke the.  *
1920: 2a 20 70 61 72 73 65 72 20 74 6f 20 62 75 69 6c  * parser to buil
1930: 64 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 72  d the internal r
1940: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66  epresentation of
1950: 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61   the.  ** databa
1960: 73 65 20 73 63 68 65 6d 65 2e 0a 20 20 2a 2f 0a  se scheme..  */.
1970: 20 20 73 74 61 74 69 63 20 56 64 62 65 4f 70 20    static VdbeOp 
1980: 69 6e 69 74 50 72 6f 67 5b 5d 20 3d 20 7b 0a 20  initProg[] = {. 
1990: 20 20 20 2f 2a 20 53 65 6e 64 20 74 68 65 20 66     /* Send the f
19a0: 69 6c 65 20 66 6f 72 6d 61 74 20 74 6f 20 74 68  ile format to th
19b0: 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69  e callback routi
19c0: 6e 65 0a 20 20 20 20 2a 2f 0a 20 20 20 20 7b 20  ne.    */.    { 
19d0: 4f 50 5f 4f 70 65 6e 2c 20 20 20 20 20 20 20 30  OP_Open,       0
19e0: 2c 20 32 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20  , 2,  0},.    { 
19f0: 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30  OP_String,     0
1a00: 2c 20 30 2c 20 20 22 66 69 6c 65 2d 66 6f 72 6d  , 0,  "file-form
1a10: 61 74 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53  at"},.    { OP_S
1a20: 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c  tring,     0, 0,
1a30: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53    0},.    { OP_S
1a40: 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c  tring,     0, 0,
1a50: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52    0},.    { OP_R
1a60: 65 61 64 43 6f 6f 6b 69 65 2c 20 30 2c 20 31 2c  eadCookie, 0, 1,
1a70: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43    0},.    { OP_C
1a80: 61 6c 6c 62 61 63 6b 2c 20 20 20 34 2c 20 30 2c  allback,   4, 0,
1a90: 20 20 30 7d 2c 0a 0a 20 20 20 20 2f 2a 20 53 65    0},..    /* Se
1aa0: 6e 64 20 74 68 65 20 69 6e 69 74 69 61 6c 20 73  nd the initial s
1ab0: 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20 74 6f 20  chema cookie to 
1ac0: 74 68 65 20 63 61 6c 6c 62 61 63 6b 0a 20 20 20  the callback.   
1ad0: 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72   */.    { OP_Str
1ae0: 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c 20 20  ing,     0, 0,  
1af0: 22 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 22 7d  "schema_cookie"}
1b00: 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e  ,.    { OP_Strin
1b10: 67 2c 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d  g,     0, 0,  0}
1b20: 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e  ,.    { OP_Strin
1b30: 67 2c 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d  g,     0, 0,  0}
1b40: 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 65 61 64 43  ,.    { OP_ReadC
1b50: 6f 6f 6b 69 65 2c 20 30 2c 20 30 2c 20 20 30 7d  ookie, 0, 0,  0}
1b60: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62  ,.    { OP_Callb
1b70: 61 63 6b 2c 20 20 20 34 2c 20 30 2c 20 20 30 7d  ack,   4, 0,  0}
1b80: 2c 0a 0a 20 20 20 20 2f 2a 20 43 68 65 63 6b 20  ,..    /* Check 
1b90: 74 68 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e  the file format.
1ba0: 20 20 49 66 20 74 68 65 20 66 6f 72 6d 61 74 20    If the format 
1bb0: 6e 75 6d 62 65 72 20 69 73 20 32 20 6f 72 20 6d  number is 2 or m
1bc0: 6f 72 65 2c 0a 20 20 20 20 2a 2a 20 74 68 65 6e  ore,.    ** then
1bd0: 20 64 6f 20 61 20 73 69 6e 67 6c 65 20 70 61 73   do a single pas
1be0: 73 20 74 68 72 6f 75 67 68 20 74 68 65 20 53 51  s through the SQ
1bf0: 4c 49 54 45 5f 4d 41 53 54 45 52 20 74 61 62 6c  LITE_MASTER tabl
1c00: 65 2e 20 20 46 6f 72 0a 20 20 20 20 2a 2a 20 61  e.  For.    ** a
1c10: 20 66 6f 72 6d 61 74 20 6e 75 6d 62 65 72 20 6f   format number o
1c20: 66 20 6c 65 73 73 20 74 68 61 6e 20 32 2c 20 6a  f less than 2, j
1c30: 75 6d 70 20 66 6f 72 77 61 72 64 20 74 6f 20 61  ump forward to a
1c40: 20 64 69 66 66 65 72 65 6e 74 0a 20 20 20 20 2a   different.    *
1c50: 2a 20 61 6c 67 6f 72 69 74 68 6d 20 74 68 61 74  * algorithm that
1c60: 20 6d 61 6b 65 73 20 74 77 6f 20 70 61 73 73 65   makes two passe
1c70: 73 20 74 68 72 6f 75 67 68 20 74 68 65 20 53 51  s through the SQ
1c80: 4c 49 54 45 5f 4d 41 53 54 45 52 20 74 61 62 6c  LITE_MASTER tabl
1c90: 65 2c 0a 20 20 20 20 2a 2a 20 6f 6e 63 65 20 66  e,.    ** once f
1ca0: 6f 72 20 74 61 62 6c 65 73 20 61 6e 64 20 61 20  or tables and a 
1cb0: 73 65 63 6f 6e 64 20 74 69 6d 65 20 66 6f 72 20  second time for 
1cc0: 69 6e 64 69 63 65 73 2e 0a 20 20 20 20 2a 2f 0a  indices..    */.
1cd0: 20 20 20 20 7b 20 4f 50 5f 52 65 61 64 43 6f 6f      { OP_ReadCoo
1ce0: 6b 69 65 2c 20 30 2c 20 31 2c 20 20 30 7d 2c 0a  kie, 0, 1,  0},.
1cf0: 20 20 20 20 7b 20 4f 50 5f 49 6e 74 65 67 65 72      { OP_Integer
1d00: 2c 20 20 20 20 32 2c 20 30 2c 20 20 30 7d 2c 0a  ,    2, 0,  0},.
1d10: 20 20 20 20 7b 20 4f 50 5f 4c 74 2c 20 20 20 20      { OP_Lt,    
1d20: 20 20 20 20 20 30 2c 20 32 33 2c 20 30 7d 2c 0a       0, 23, 0},.
1d30: 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20  .    /* This is 
1d40: 74 68 65 20 63 6f 64 65 20 66 6f 72 20 64 6f 69  the code for doi
1d50: 6e 67 20 61 20 73 69 6e 67 6c 65 20 73 63 61 6e  ng a single scan
1d60: 20 74 68 72 6f 75 67 68 20 74 68 65 20 53 51 4c   through the SQL
1d70: 49 54 45 5f 4d 41 53 54 45 52 0a 20 20 20 20 2a  ITE_MASTER.    *
1d80: 2a 20 74 61 62 6c 65 2e 20 20 54 68 69 73 20 63  * table.  This c
1d90: 6f 64 65 20 72 75 6e 73 20 66 6f 72 20 66 6f 72  ode runs for for
1da0: 6d 61 74 20 32 20 61 6e 64 20 67 72 65 61 74 65  mat 2 and greate
1db0: 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 7b 20  r..    */.    { 
1dc0: 4f 50 5f 52 65 77 69 6e 64 2c 20 20 20 20 20 30  OP_Rewind,     0
1dd0: 2c 20 32 31 2c 20 30 7d 2c 0a 20 20 20 20 7b 20  , 21, 0},.    { 
1de0: 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 20 20 30  OP_Column,     0
1df0: 2c 20 30 2c 20 20 30 7d 2c 20 20 20 20 20 20 20  , 0,  0},       
1e00: 20 20 20 20 2f 2a 20 31 35 20 2a 2f 0a 20 20 20      /* 15 */.   
1e10: 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20   { OP_Column,   
1e20: 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a 20 20 20    0, 1,  0},.   
1e30: 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20   { OP_Column,   
1e40: 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a 20 20 20    0, 3,  0},.   
1e50: 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20   { OP_Column,   
1e60: 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a 20 20 20    0, 4,  0},.   
1e70: 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63 6b 2c 20   { OP_Callback, 
1e80: 20 20 34 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20    4, 0,  0},.   
1e90: 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20 20 20 20   { OP_Next,     
1ea0: 20 20 30 2c 20 31 35 2c 20 30 7d 2c 0a 20 20 20    0, 15, 0},.   
1eb0: 20 7b 20 4f 50 5f 43 6c 6f 73 65 2c 20 20 20 20   { OP_Close,    
1ec0: 20 20 30 2c 20 30 2c 20 20 30 7d 2c 20 20 20 20    0, 0,  0},    
1ed0: 20 20 20 20 20 20 20 2f 2a 20 32 31 20 2a 2f 0a         /* 21 */.
1ee0: 20 20 20 20 7b 20 4f 50 5f 48 61 6c 74 2c 20 20      { OP_Halt,  
1ef0: 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a       0, 0,  0},.
1f00: 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20  .    /* This is 
1f10: 74 68 65 20 63 6f 64 65 20 66 6f 72 20 64 6f 69  the code for doi
1f20: 6e 67 20 74 77 6f 20 70 61 73 73 65 73 20 74 68  ng two passes th
1f30: 72 6f 75 67 68 20 53 51 4c 49 54 45 5f 4d 41 53  rough SQLITE_MAS
1f40: 54 45 52 2e 20 20 54 68 69 73 0a 20 20 20 20 2a  TER.  This.    *
1f50: 2a 20 63 6f 64 65 20 72 75 6e 73 20 66 6f 72 20  * code runs for 
1f60: 66 69 6c 65 20 66 6f 72 6d 61 74 20 31 2e 0a 20  file format 1.. 
1f70: 20 20 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 52     */.    { OP_R
1f80: 65 77 69 6e 64 2c 20 20 20 20 20 30 2c 20 34 33  ewind,     0, 43
1f90: 2c 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20  , 0},           
1fa0: 2f 2a 20 32 33 20 2a 2f 0a 20 20 20 20 7b 20 4f  /* 23 */.    { O
1fb0: 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 20 20 30 2c  P_Column,     0,
1fc0: 20 30 2c 20 20 30 7d 2c 20 20 20 20 20 20 20 20   0,  0},        
1fd0: 20 20 20 2f 2a 20 32 34 20 2a 2f 0a 20 20 20 20     /* 24 */.    
1fe0: 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 20  { OP_String,    
1ff0: 20 30 2c 20 30 2c 20 20 22 74 61 62 6c 65 22 7d   0, 0,  "table"}
2000: 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 2c 20 20  ,.    { OP_Ne,  
2010: 20 20 20 20 20 20 20 30 2c 20 33 32 2c 20 30 7d         0, 32, 0}
2020: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d  ,.    { OP_Colum
2030: 6e 2c 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d  n,     0, 0,  0}
2040: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d  ,.    { OP_Colum
2050: 6e 2c 20 20 20 20 20 30 2c 20 31 2c 20 20 30 7d  n,     0, 1,  0}
2060: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d  ,.    { OP_Colum
2070: 6e 2c 20 20 20 20 20 30 2c 20 33 2c 20 20 30 7d  n,     0, 3,  0}
2080: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d  ,.    { OP_Colum
2090: 6e 2c 20 20 20 20 20 30 2c 20 34 2c 20 20 30 7d  n,     0, 4,  0}
20a0: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62  ,.    { OP_Callb
20b0: 61 63 6b 2c 20 20 20 34 2c 20 30 2c 20 20 30 7d  ack,   4, 0,  0}
20c0: 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c  ,.    { OP_Next,
20d0: 20 20 20 20 20 20 20 30 2c 20 32 34 2c 20 30 7d         0, 24, 0}
20e0: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 33  ,           /* 3
20f0: 32 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 52 65  2 */.    { OP_Re
2100: 77 69 6e 64 2c 20 20 20 20 20 30 2c 20 34 33 2c  wind,     0, 43,
2110: 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f   0},           /
2120: 2a 20 33 33 20 2a 2f 0a 20 20 20 20 7b 20 4f 50  * 33 */.    { OP
2130: 5f 43 6f 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20  _Column,     0, 
2140: 30 2c 20 20 30 7d 2c 20 20 20 20 20 20 20 20 20  0,  0},         
2150: 20 20 2f 2a 20 33 34 20 2a 2f 0a 20 20 20 20 7b    /* 34 */.    {
2160: 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 20 20   OP_String,     
2170: 30 2c 20 30 2c 20 20 22 69 6e 64 65 78 22 7d 2c  0, 0,  "index"},
2180: 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 2c 20 20 20  .    { OP_Ne,   
2190: 20 20 20 20 20 20 30 2c 20 34 32 2c 20 30 7d 2c        0, 42, 0},
21a0: 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e  .    { OP_Column
21b0: 2c 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c  ,     0, 0,  0},
21c0: 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e  .    { OP_Column
21d0: 2c 20 20 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c  ,     0, 1,  0},
21e0: 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e  .    { OP_Column
21f0: 2c 20 20 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c  ,     0, 3,  0},
2200: 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e  .    { OP_Column
2210: 2c 20 20 20 20 20 30 2c 20 34 2c 20 20 30 7d 2c  ,     0, 4,  0},
2220: 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61  .    { OP_Callba
2230: 63 6b 2c 20 20 20 34 2c 20 30 2c 20 20 30 7d 2c  ck,   4, 0,  0},
2240: 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c 20  .    { OP_Next, 
2250: 20 20 20 20 20 20 30 2c 20 33 34 2c 20 30 7d 2c        0, 34, 0},
2260: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 34 32             /* 42
2270: 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 43 6c 6f   */.    { OP_Clo
2280: 73 65 2c 20 20 20 20 20 20 30 2c 20 30 2c 20 20  se,      0, 0,  
2290: 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a  0},           /*
22a0: 20 34 33 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f   43 */.    { OP_
22b0: 48 61 6c 74 2c 20 20 20 20 20 20 20 30 2c 20 30  Halt,       0, 0
22c0: 2c 20 20 30 7d 2c 0a 20 20 7d 3b 0a 0a 20 20 2f  ,  0},.  };..  /
22d0: 2a 20 43 72 65 61 74 65 20 61 20 76 69 72 74 75  * Create a virtu
22e0: 61 6c 20 6d 61 63 68 69 6e 65 20 74 6f 20 72 75  al machine to ru
22f0: 6e 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61  n the initializa
2300: 74 69 6f 6e 20 70 72 6f 67 72 61 6d 2e 20 20 52  tion program.  R
2310: 75 6e 0a 20 20 2a 2a 20 74 68 65 20 70 72 6f 67  un.  ** the prog
2320: 72 61 6d 2e 20 20 54 68 65 6e 20 64 65 6c 65 74  ram.  Then delet
2330: 65 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61  e the virtual ma
2340: 63 68 69 6e 65 2e 0a 20 20 2a 2f 0a 20 20 76 64  chine..  */.  vd
2350: 62 65 20 3d 20 73 71 6c 69 74 65 56 64 62 65 43  be = sqliteVdbeC
2360: 72 65 61 74 65 28 64 62 29 3b 0a 20 20 69 66 28  reate(db);.  if(
2370: 20 76 64 62 65 3d 3d 30 20 29 7b 0a 20 20 20 20   vdbe==0 ){.    
2380: 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28  sqliteSetString(
2390: 70 7a 45 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f  pzErrMsg, "out o
23a0: 66 20 6d 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20  f memory", 0);. 
23b0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
23c0: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73 71  _NOMEM;.  }.  sq
23d0: 6c 69 74 65 56 64 62 65 41 64 64 4f 70 4c 69 73  liteVdbeAddOpLis
23e0: 74 28 76 64 62 65 2c 20 73 69 7a 65 6f 66 28 69  t(vdbe, sizeof(i
23f0: 6e 69 74 50 72 6f 67 29 2f 73 69 7a 65 6f 66 28  nitProg)/sizeof(
2400: 69 6e 69 74 50 72 6f 67 5b 30 5d 29 2c 20 69 6e  initProg[0]), in
2410: 69 74 50 72 6f 67 29 3b 0a 20 20 72 63 20 3d 20  itProg);.  rc = 
2420: 73 71 6c 69 74 65 56 64 62 65 45 78 65 63 28 76  sqliteVdbeExec(v
2430: 64 62 65 2c 20 73 71 6c 69 74 65 4f 70 65 6e 43  dbe, sqliteOpenC
2440: 62 2c 20 64 62 2c 20 70 7a 45 72 72 4d 73 67 2c  b, db, pzErrMsg,
2450: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20   .              
2460: 20 20 20 20 20 20 20 20 64 62 2d 3e 70 42 75 73          db->pBus
2470: 79 41 72 67 2c 20 64 62 2d 3e 78 42 75 73 79 43  yArg, db->xBusyC
2480: 61 6c 6c 62 61 63 6b 29 3b 0a 20 20 73 71 6c 69  allback);.  sqli
2490: 74 65 56 64 62 65 44 65 6c 65 74 65 28 76 64 62  teVdbeDelete(vdb
24a0: 65 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  e);.  if( rc==SQ
24b0: 4c 49 54 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 6e  LITE_OK && db->n
24c0: 54 61 62 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20  Table==0 ){.    
24d0: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20  db->file_format 
24e0: 3d 20 32 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72  = 2;.  }.  if( r
24f0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c==SQLITE_OK && 
2500: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3e  db->file_format>
2510: 32 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53  2 ){.    sqliteS
2520: 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73  etString(pzErrMs
2530: 67 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64 20  g, "unsupported 
2540: 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c 20 30 29  file format", 0)
2550: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ;.    rc = SQLIT
2560: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20  E_ERROR;.  }..  
2570: 2f 2a 20 54 68 65 20 73 63 68 65 6d 61 20 66 6f  /* The schema fo
2580: 72 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41 53  r the SQLITE_MAS
2590: 54 45 52 20 74 61 62 6c 65 20 69 73 20 6e 6f 74  TER table is not
25a0: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 20   stored in the. 
25b0: 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 74 73   ** database its
25c0: 65 6c 66 2e 20 20 57 65 20 68 61 76 65 20 74 6f  elf.  We have to
25d0: 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c   invoke the call
25e0: 62 61 63 6b 20 6f 6e 65 20 65 78 74 72 61 0a 20  back one extra. 
25f0: 20 2a 2a 20 74 69 6d 65 20 74 6f 20 67 65 74 20   ** time to get 
2600: 69 74 20 74 6f 20 70 72 6f 63 65 73 73 20 74 68  it to process th
2610: 65 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20  e SQLITE_MASTER 
2620: 74 61 62 6c 65 20 64 65 66 69 6e 74 69 6f 6e 2e  table defintion.
2630: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d  .  */.  if( rc==
2640: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
2650: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20   Table *pTab;.  
2660: 20 20 63 68 61 72 20 2a 61 7a 41 72 67 5b 36 5d    char *azArg[6]
2670: 3b 0a 20 20 20 20 61 7a 41 72 67 5b 30 5d 20 3d  ;.    azArg[0] =
2680: 20 22 74 61 62 6c 65 22 3b 0a 20 20 20 20 61 7a   "table";.    az
2690: 41 72 67 5b 31 5d 20 3d 20 4d 41 53 54 45 52 5f  Arg[1] = MASTER_
26a0: 4e 41 4d 45 3b 0a 20 20 20 20 61 7a 41 72 67 5b  NAME;.    azArg[
26b0: 32 5d 20 3d 20 22 32 22 3b 0a 20 20 20 20 61 7a  2] = "2";.    az
26c0: 41 72 67 5b 33 5d 20 3d 20 6d 61 73 74 65 72 5f  Arg[3] = master_
26d0: 73 63 68 65 6d 61 3b 0a 20 20 20 20 61 7a 41 72  schema;.    azAr
26e0: 67 5b 34 5d 20 3d 20 30 3b 0a 20 20 20 20 73 71  g[4] = 0;.    sq
26f0: 6c 69 74 65 4f 70 65 6e 43 62 28 64 62 2c 20 34  liteOpenCb(db, 4
2700: 2c 20 61 7a 41 72 67 2c 20 30 29 3b 0a 20 20 20  , azArg, 0);.   
2710: 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65 46 69   pTab = sqliteFi
2720: 6e 64 54 61 62 6c 65 28 64 62 2c 20 4d 41 53 54  ndTable(db, MAST
2730: 45 52 5f 4e 41 4d 45 29 3b 0a 20 20 20 20 69 66  ER_NAME);.    if
2740: 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20 20 20  ( pTab ){.      
2750: 70 54 61 62 2d 3e 72 65 61 64 4f 6e 6c 79 20 3d  pTab->readOnly =
2760: 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62   1;.    }.    db
2770: 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54  ->flags |= SQLIT
2780: 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 20  E_Initialized;. 
2790: 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d 69 74 49     sqliteCommitI
27a0: 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64  nternalChanges(d
27b0: 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  b);.  }.  return
27c0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68   rc;.}../*.** Th
27d0: 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65  e version of the
27e0: 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63 6f 6e 73   library.*/.cons
27f0: 74 20 63 68 61 72 20 73 71 6c 69 74 65 5f 76 65  t char sqlite_ve
2800: 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 54 45  rsion[] = SQLITE
2810: 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a 0a 2a 2a  _VERSION;../*.**
2820: 20 44 6f 65 73 20 74 68 65 20 6c 69 62 72 61 72   Does the librar
2830: 79 20 65 78 70 65 63 74 20 64 61 74 61 20 74 6f  y expect data to
2840: 20 62 65 20 65 6e 63 6f 64 65 64 20 61 73 20 55   be encoded as U
2850: 54 46 2d 38 20 6f 72 20 69 73 6f 38 38 35 39 3f  TF-8 or iso8859?
2860: 20 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c 6f 77 69    The.** followi
2870: 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e 73 74 61  ng global consta
2880: 6e 74 20 61 6c 77 61 79 73 20 6c 65 74 73 20 75  nt always lets u
2890: 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a 23 69 66 64 65  s know..*/.#ifde
28a0: 66 20 53 51 4c 49 54 45 5f 55 54 46 38 0a 63 6f  f SQLITE_UTF8.co
28b0: 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 5f  nst char sqlite_
28c0: 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 55 54  encoding[] = "UT
28d0: 46 2d 38 22 3b 0a 23 65 6c 73 65 0a 63 6f 6e 73  F-8";.#else.cons
28e0: 74 20 63 68 61 72 20 73 71 6c 69 74 65 5f 65 6e  t char sqlite_en
28f0: 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 69 73 6f 38  coding[] = "iso8
2900: 38 35 39 22 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a  859";.#endif../*
2910: 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 53  .** Open a new S
2920: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 20  QLite database. 
2930: 20 43 6f 6e 73 74 72 75 63 74 20 61 6e 20 22 73   Construct an "s
2940: 71 6c 69 74 65 22 20 73 74 72 75 63 74 75 72 65  qlite" structure
2950: 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a 20 74 68   to define.** th
2960: 65 20 73 74 61 74 65 20 6f 66 20 74 68 69 73 20  e state of this 
2970: 64 61 74 61 62 61 73 65 20 61 6e 64 20 72 65 74  database and ret
2980: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  urn a pointer to
2990: 20 74 68 61 74 20 73 74 72 75 63 74 75 72 65 2e   that structure.
29a0: 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 74 74 65 6d 70  .**.** An attemp
29b0: 74 20 69 73 20 6d 61 64 65 20 74 6f 20 69 6e 69  t is made to ini
29c0: 74 69 61 6c 69 7a 65 20 74 68 65 20 69 6e 2d 6d  tialize the in-m
29d0: 65 6d 6f 72 79 20 64 61 74 61 20 73 74 72 75 63  emory data struc
29e0: 74 75 72 65 73 20 74 68 61 74 0a 2a 2a 20 68 6f  tures that.** ho
29f0: 6c 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ld the database 
2a00: 73 63 68 65 6d 61 2e 20 20 42 75 74 20 69 66 20  schema.  But if 
2a10: 74 68 69 73 20 66 61 69 6c 73 20 28 62 65 63 61  this fails (beca
2a20: 75 73 65 20 74 68 65 20 73 63 68 65 6d 61 20 66  use the schema f
2a30: 69 6c 65 0a 2a 2a 20 69 73 20 6c 6f 63 6b 65 64  ile.** is locked
2a40: 29 20 74 68 65 6e 20 74 68 61 74 20 73 74 65 70  ) then that step
2a50: 20 69 73 20 64 65 66 65 72 72 65 64 20 75 6e 74   is deferred unt
2a60: 69 6c 20 74 68 65 20 66 69 72 73 74 20 63 61 6c  il the first cal
2a70: 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 5f 65  l to.** sqlite_e
2a80: 78 65 63 28 29 2e 0a 2a 2f 0a 73 71 6c 69 74 65  xec()..*/.sqlite
2a90: 20 2a 73 71 6c 69 74 65 5f 6f 70 65 6e 28 63 6f   *sqlite_open(co
2aa0: 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e  nst char *zFilen
2ab0: 61 6d 65 2c 20 69 6e 74 20 6d 6f 64 65 2c 20 63  ame, int mode, c
2ac0: 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b  har **pzErrMsg){
2ad0: 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 3b 0a 20  .  sqlite *db;. 
2ae0: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a 20 41   int rc;..  /* A
2af0: 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 6c 69  llocate the sqli
2b00: 74 65 20 64 61 74 61 20 73 74 72 75 63 74 75 72  te data structur
2b10: 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c 69  e */.  db = sqli
2b20: 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66  teMalloc( sizeof
2b30: 28 73 71 6c 69 74 65 29 20 29 3b 0a 20 20 69 66  (sqlite) );.  if
2b40: 28 20 70 7a 45 72 72 4d 73 67 20 29 20 2a 70 7a  ( pzErrMsg ) *pz
2b50: 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69 66  ErrMsg = 0;.  if
2b60: 28 20 64 62 3d 3d 30 20 29 20 67 6f 74 6f 20 6e  ( db==0 ) goto n
2b70: 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20  o_mem_on_open;. 
2b80: 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74 28   sqliteHashInit(
2b90: 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c 20 53 51  &db->tblHash, SQ
2ba0: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47  LITE_HASH_STRING
2bb0: 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 48 61  , 0);.  sqliteHa
2bc0: 73 68 49 6e 69 74 28 26 64 62 2d 3e 69 64 78 48  shInit(&db->idxH
2bd0: 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  ash, SQLITE_HASH
2be0: 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73  _STRING, 0);.  s
2bf0: 71 6c 69 74 65 48 61 73 68 49 6e 69 74 28 26 64  qliteHashInit(&d
2c00: 62 2d 3e 74 62 6c 44 72 6f 70 2c 20 53 51 4c 49  b->tblDrop, SQLI
2c10: 54 45 5f 48 41 53 48 5f 50 4f 49 4e 54 45 52 2c  TE_HASH_POINTER,
2c20: 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 48 61 73   0);.  sqliteHas
2c30: 68 49 6e 69 74 28 26 64 62 2d 3e 69 64 78 44 72  hInit(&db->idxDr
2c40: 6f 70 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f  op, SQLITE_HASH_
2c50: 50 4f 49 4e 54 45 52 2c 20 30 29 3b 0a 20 20 73  POINTER, 0);.  s
2c60: 71 6c 69 74 65 48 61 73 68 49 6e 69 74 28 26 64  qliteHashInit(&d
2c70: 62 2d 3e 75 73 65 72 46 75 6e 63 2c 20 53 51 4c  b->userFunc, SQL
2c80: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
2c90: 20 31 29 3b 0a 20 20 73 71 6c 69 74 65 52 65 67   1);.  sqliteReg
2ca0: 69 73 74 65 72 42 75 69 6c 64 69 6e 46 75 6e 63  isterBuildinFunc
2cb0: 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20 64 62 2d  tions(db);.  db-
2cc0: 3e 6f 6e 45 72 72 6f 72 20 3d 20 4f 45 5f 44 65  >onError = OE_De
2cd0: 66 61 75 6c 74 3b 0a 20 20 64 62 2d 3e 70 72 69  fault;.  db->pri
2ce0: 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b 0a  orNewRowid = 0;.
2cf0: 20 20 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65    .  /* Open the
2d00: 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73   backend databas
2d10: 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63  e driver */.  rc
2d20: 20 3d 20 73 71 6c 69 74 65 42 74 72 65 65 4f 70   = sqliteBtreeOp
2d30: 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 6d 6f  en(zFilename, mo
2d40: 64 65 2c 20 4d 41 58 5f 50 41 47 45 53 2c 20 26  de, MAX_PAGES, &
2d50: 64 62 2d 3e 70 42 65 29 3b 0a 20 20 69 66 28 20  db->pBe);.  if( 
2d60: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
2d70: 0a 20 20 20 20 73 77 69 74 63 68 28 20 72 63 20  .    switch( rc 
2d80: 29 7b 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74  ){.      default
2d90: 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  : {.        sqli
2da0: 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  teSetString(pzEr
2db0: 72 4d 73 67 2c 20 22 75 6e 61 62 6c 65 20 74 6f  rMsg, "unable to
2dc0: 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 3a 20   open database: 
2dd0: 22 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 29  ", zFilename, 0)
2de0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
2df0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 64      sqliteFree(d
2e00: 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 74  b);.    sqliteSt
2e10: 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73  rRealloc(pzErrMs
2e20: 67 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30  g);.    return 0
2e30: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 74 74 65  ;.  }..  /* Atte
2e40: 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 20  mpt to read the 
2e50: 73 63 68 65 6d 61 20 2a 2f 0a 20 20 72 63 20 3d  schema */.  rc =
2e60: 20 73 71 6c 69 74 65 49 6e 69 74 28 64 62 2c 20   sqliteInit(db, 
2e70: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28  pzErrMsg);.  if(
2e80: 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66   sqlite_malloc_f
2e90: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 71 6c  ailed ){.    sql
2ea0: 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20  ite_close(db);. 
2eb0: 20 20 20 67 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f 6f     goto no_mem_o
2ec0: 6e 5f 6f 70 65 6e 3b 0a 20 20 7d 65 6c 73 65 20  n_open;.  }else 
2ed0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
2ee0: 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f  K && rc!=SQLITE_
2ef0: 42 55 53 59 20 29 7b 0a 20 20 20 20 73 71 6c 69  BUSY ){.    sqli
2f00: 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20  te_close(db);.  
2f10: 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c    sqliteStrReall
2f20: 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  oc(pzErrMsg);.  
2f30: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 65    return 0;.  }e
2f40: 6c 73 65 20 69 66 28 20 70 7a 45 72 72 4d 73 67  lse if( pzErrMsg
2f50: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 46 72   ){.    sqliteFr
2f60: 65 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b 0a 20  ee(*pzErrMsg);. 
2f70: 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30     *pzErrMsg = 0
2f80: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64  ;.  }.  return d
2f90: 62 3b 0a 0a 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70  b;..no_mem_on_op
2fa0: 65 6e 3a 0a 20 20 73 71 6c 69 74 65 53 65 74 53  en:.  sqliteSetS
2fb0: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
2fc0: 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c  "out of memory",
2fd0: 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 53 74 72   0);.  sqliteStr
2fe0: 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67  Realloc(pzErrMsg
2ff0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d  );.  return 0;.}
3000: 0a 0a 2f 2a 0a 2a 2a 20 45 72 61 73 65 20 61 6c  ../*.** Erase al
3010: 6c 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61  l schema informa
3020: 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 73 63  tion from the sc
3030: 68 65 6d 61 20 68 61 73 68 20 74 61 62 6c 65 2e  hema hash table.
3040: 20 20 45 78 63 65 70 74 0a 2a 2a 20 74 61 62 6c    Except.** tabl
3050: 65 73 20 74 68 61 74 20 61 72 65 20 63 72 65 61  es that are crea
3060: 74 65 64 20 75 73 69 6e 67 20 43 52 45 41 54 45  ted using CREATE
3070: 20 54 45 4d 50 4f 52 41 52 59 20 54 41 42 4c 45   TEMPORARY TABLE
3080: 20 61 72 65 20 70 72 65 73 65 72 76 65 64 0a 2a   are preserved.*
3090: 2a 20 69 66 20 74 68 65 20 70 72 65 73 65 72 76  * if the preserv
30a0: 65 54 65 6d 70 73 20 66 6c 61 67 20 69 73 20 74  eTemps flag is t
30b0: 72 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64  rue..**.** The d
30c0: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69  atabase schema i
30d0: 73 20 6e 6f 72 6d 61 6c 6c 79 20 72 65 61 64 20  s normally read 
30e0: 69 6e 20 6f 6e 63 65 20 77 68 65 6e 20 74 68 65  in once when the
30f0: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 69 73 20   database.** is 
3100: 66 69 72 73 74 20 6f 70 65 6e 65 64 20 61 6e 64  first opened and
3110: 20 73 74 6f 72 65 64 20 69 6e 20 61 20 68 61 73   stored in a has
3120: 68 20 74 61 62 6c 65 20 69 6e 20 74 68 65 20 73  h table in the s
3130: 71 6c 69 74 65 20 73 74 72 75 63 74 75 72 65 2e  qlite structure.
3140: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
3150: 20 65 72 61 73 65 73 20 74 68 65 20 73 74 6f 72   erases the stor
3160: 65 64 20 73 63 68 65 6d 61 2e 20 20 54 68 69 73  ed schema.  This
3170: 20 65 72 61 73 75 72 65 20 6f 63 63 75 72 73 20   erasure occurs 
3180: 62 65 63 61 75 73 65 0a 2a 2a 20 65 69 74 68 65  because.** eithe
3190: 72 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69  r the database i
31a0: 73 20 62 65 69 6e 67 20 63 6c 6f 73 65 64 20 6f  s being closed o
31b0: 72 20 62 65 63 61 75 73 65 20 73 6f 6d 65 20 6f  r because some o
31c0: 74 68 65 72 20 70 72 6f 63 65 73 73 0a 2a 2a 20  ther process.** 
31d0: 63 68 61 6e 67 65 64 20 74 68 65 20 73 63 68 65  changed the sche
31e0: 6d 61 20 61 6e 64 20 74 68 69 73 20 70 72 6f 63  ma and this proc
31f0: 65 73 73 20 6e 65 65 64 73 20 74 6f 20 72 65 72  ess needs to rer
3200: 65 61 64 20 69 74 2e 0a 2a 2f 0a 73 74 61 74 69  ead it..*/.stati
3210: 63 20 76 6f 69 64 20 63 6c 65 61 72 48 61 73 68  c void clearHash
3220: 54 61 62 6c 65 28 73 71 6c 69 74 65 20 2a 64 62  Table(sqlite *db
3230: 2c 20 69 6e 74 20 70 72 65 73 65 72 76 65 54 65  , int preserveTe
3240: 6d 70 73 29 7b 0a 20 20 48 61 73 68 45 6c 65 6d  mps){.  HashElem
3250: 20 2a 70 45 6c 65 6d 3b 0a 20 20 48 61 73 68 20   *pElem;.  Hash 
3260: 74 65 6d 70 31 3b 0a 20 20 61 73 73 65 72 74 28  temp1;.  assert(
3270: 20 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74   sqliteHashFirst
3280: 28 26 64 62 2d 3e 74 62 6c 44 72 6f 70 29 3d 3d  (&db->tblDrop)==
3290: 30 20 29 3b 20 2f 2a 20 54 68 65 72 65 20 63 61  0 ); /* There ca
32a0: 6e 20 6e 6f 74 20 62 65 20 75 6e 63 6f 6d 6d 69  n not be uncommi
32b0: 74 74 65 64 20 2a 2f 0a 20 20 61 73 73 65 72 74  tted */.  assert
32c0: 28 20 73 71 6c 69 74 65 48 61 73 68 46 69 72 73  ( sqliteHashFirs
32d0: 74 28 26 64 62 2d 3e 69 64 78 44 72 6f 70 29 3d  t(&db->idxDrop)=
32e0: 3d 30 20 29 3b 20 2f 2a 20 20 20 44 52 4f 50 20  =0 ); /*   DROP 
32f0: 54 41 42 4c 45 73 20 6f 72 20 44 52 4f 50 20 49  TABLEs or DROP I
3300: 4e 44 45 58 73 20 2a 2f 0a 20 20 74 65 6d 70 31  NDEXs */.  temp1
3310: 20 3d 20 64 62 2d 3e 74 62 6c 48 61 73 68 3b 0a   = db->tblHash;.
3320: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
3330: 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c 20 53  (&db->tblHash, S
3340: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
3350: 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 48  G, 0);.  sqliteH
3360: 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 69 64  ashClear(&db->id
3370: 78 48 61 73 68 29 3b 0a 20 20 66 6f 72 28 70 45  xHash);.  for(pE
3380: 6c 65 6d 3d 73 71 6c 69 74 65 48 61 73 68 46 69  lem=sqliteHashFi
3390: 72 73 74 28 26 74 65 6d 70 31 29 3b 20 70 45 6c  rst(&temp1); pEl
33a0: 65 6d 3b 20 70 45 6c 65 6d 3d 73 71 6c 69 74 65  em; pElem=sqlite
33b0: 48 61 73 68 4e 65 78 74 28 70 45 6c 65 6d 29 29  HashNext(pElem))
33c0: 7b 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61  {.    Table *pTa
33d0: 62 20 3d 20 73 71 6c 69 74 65 48 61 73 68 44 61  b = sqliteHashDa
33e0: 74 61 28 70 45 6c 65 6d 29 3b 0a 20 20 20 20 69  ta(pElem);.    i
33f0: 66 28 20 70 72 65 73 65 72 76 65 54 65 6d 70 73  f( preserveTemps
3400: 20 26 26 20 70 54 61 62 2d 3e 69 73 54 65 6d 70   && pTab->isTemp
3410: 20 29 7b 0a 20 20 20 20 20 20 49 6e 64 65 78 20   ){.      Index 
3420: 2a 70 49 64 78 3b 0a 20 20 20 20 20 20 69 6e 74  *pIdx;.      int
3430: 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28   nName = strlen(
3440: 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20  pTab->zName);.  
3450: 20 20 20 20 54 61 62 6c 65 20 2a 70 4f 6c 64 20      Table *pOld 
3460: 3d 20 73 71 6c 69 74 65 48 61 73 68 49 6e 73 65  = sqliteHashInse
3470: 72 74 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c  rt(&db->tblHash,
3480: 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 6e 4e   pTab->zName, nN
3490: 61 6d 65 2b 31 2c 20 70 54 61 62 29 3b 0a 20 20  ame+1, pTab);.  
34a0: 20 20 20 20 69 66 28 20 70 4f 6c 64 21 3d 30 20      if( pOld!=0 
34b0: 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  ){.        asser
34c0: 74 28 20 70 4f 6c 64 3d 3d 70 54 61 62 20 29 3b  t( pOld==pTab );
34d0: 20 20 20 2f 2a 20 4d 61 6c 6c 6f 63 20 66 61 69     /* Malloc fai
34e0: 6c 65 64 20 6f 6e 20 74 68 65 20 48 61 73 68 49  led on the HashI
34f0: 6e 73 65 72 74 20 2a 2f 0a 20 20 20 20 20 20 20  nsert */.       
3500: 20 73 71 6c 69 74 65 44 65 6c 65 74 65 54 61 62   sqliteDeleteTab
3510: 6c 65 28 64 62 2c 20 70 4f 6c 64 29 3b 0a 20 20  le(db, pOld);.  
3520: 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a        continue;.
3530: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 6f        }.      fo
3540: 72 28 70 49 64 78 3d 70 54 61 62 2d 3e 70 49 6e  r(pIdx=pTab->pIn
3550: 64 65 78 3b 20 70 49 64 78 3b 20 70 49 64 78 3d  dex; pIdx; pIdx=
3560: 70 49 64 78 2d 3e 70 4e 65 78 74 29 7b 0a 20 20  pIdx->pNext){.  
3570: 20 20 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 74        int n = st
3580: 72 6c 65 6e 28 70 49 64 78 2d 3e 7a 4e 61 6d 65  rlen(pIdx->zName
3590: 29 2b 31 3b 0a 20 20 20 20 20 20 20 20 49 6e 64  )+1;.        Ind
35a0: 65 78 20 2a 70 4f 6c 64 49 64 78 3b 0a 20 20 20  ex *pOldIdx;.   
35b0: 20 20 20 20 20 70 4f 6c 64 49 64 78 20 3d 20 73       pOldIdx = s
35c0: 71 6c 69 74 65 48 61 73 68 49 6e 73 65 72 74 28  qliteHashInsert(
35d0: 26 64 62 2d 3e 69 64 78 48 61 73 68 2c 20 70 49  &db->idxHash, pI
35e0: 64 78 2d 3e 7a 4e 61 6d 65 2c 20 6e 2c 20 70 49  dx->zName, n, pI
35f0: 64 78 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28  dx);.        if(
3600: 20 70 4f 6c 64 20 29 7b 0a 20 20 20 20 20 20 20   pOld ){.       
3610: 20 20 20 61 73 73 65 72 74 28 20 70 4f 6c 64 49     assert( pOldI
3620: 64 78 3d 3d 70 49 64 78 20 29 3b 0a 20 20 20 20  dx==pIdx );.    
3630: 20 20 20 20 20 20 73 71 6c 69 74 65 55 6e 6c 69        sqliteUnli
3640: 6e 6b 41 6e 64 44 65 6c 65 74 65 49 6e 64 65 78  nkAndDeleteIndex
3650: 28 64 62 2c 20 70 4f 6c 64 49 64 78 29 3b 0a 20  (db, pOldIdx);. 
3660: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
3670: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
3680: 20 20 73 71 6c 69 74 65 44 65 6c 65 74 65 54 61    sqliteDeleteTa
3690: 62 6c 65 28 64 62 2c 20 70 54 61 62 29 3b 0a 20  ble(db, pTab);. 
36a0: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74     }.  }.  sqlit
36b0: 65 48 61 73 68 43 6c 65 61 72 28 26 74 65 6d 70  eHashClear(&temp
36c0: 31 29 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20  1);.  db->flags 
36d0: 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e 69 74 69  &= ~SQLITE_Initi
36e0: 61 6c 69 7a 65 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  alized;.}../*.**
36f0: 20 52 65 74 75 72 6e 20 74 68 65 20 52 4f 57 49   Return the ROWI
3700: 44 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65  D of the most re
3710: 63 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f 0a 69  cent insert.*/.i
3720: 6e 74 20 73 71 6c 69 74 65 5f 6c 61 73 74 5f 69  nt sqlite_last_i
3730: 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69  nsert_rowid(sqli
3740: 74 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72  te *db){.  retur
3750: 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b  n db->lastRowid;
3760: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20  .}../*.** Close 
3770: 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69  an existing SQLi
3780: 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 76  te database.*/.v
3790: 6f 69 64 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65  oid sqlite_close
37a0: 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20  (sqlite *db){.  
37b0: 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 73  HashElem *i;.  s
37c0: 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 65 28  qliteBtreeClose(
37d0: 64 62 2d 3e 70 42 65 29 3b 0a 20 20 63 6c 65 61  db->pBe);.  clea
37e0: 72 48 61 73 68 54 61 62 6c 65 28 64 62 2c 20 30  rHashTable(db, 0
37f0: 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 70 42 65  );.  if( db->pBe
3800: 54 65 6d 70 20 29 7b 0a 20 20 20 20 73 71 6c 69  Temp ){.    sqli
3810: 74 65 42 74 72 65 65 43 6c 6f 73 65 28 64 62 2d  teBtreeClose(db-
3820: 3e 70 42 65 54 65 6d 70 29 3b 0a 20 20 7d 0a 20  >pBeTemp);.  }. 
3830: 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73   for(i=sqliteHas
3840: 68 46 69 72 73 74 28 26 64 62 2d 3e 75 73 65 72  hFirst(&db->user
3850: 46 75 6e 63 29 3b 20 69 3b 20 69 3d 73 71 6c 69  Func); i; i=sqli
3860: 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b 0a  teHashNext(i)){.
3870: 20 20 20 20 55 73 65 72 46 75 6e 63 20 2a 70 46      UserFunc *pF
3880: 75 6e 63 2c 20 2a 70 4e 65 78 74 3b 0a 20 20 20  unc, *pNext;.   
3890: 20 66 6f 72 28 70 46 75 6e 63 20 3d 20 28 55 73   for(pFunc = (Us
38a0: 65 72 46 75 6e 63 2a 29 73 71 6c 69 74 65 48 61  erFunc*)sqliteHa
38b0: 73 68 44 61 74 61 28 69 29 3b 20 70 46 75 6e 63  shData(i); pFunc
38c0: 3b 20 70 46 75 6e 63 3d 70 4e 65 78 74 29 7b 0a  ; pFunc=pNext){.
38d0: 20 20 20 20 20 20 70 4e 65 78 74 20 3d 20 70 46        pNext = pF
38e0: 75 6e 63 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  unc->pNext;.    
38f0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 46 75    sqliteFree(pFu
3900: 6e 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20  nc);.    }.  }. 
3910: 20 73 71 6c 69 74 65 48 61 73 68 43 6c 65 61 72   sqliteHashClear
3920: 28 26 64 62 2d 3e 75 73 65 72 46 75 6e 63 29 3b  (&db->userFunc);
3930: 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 64 62  .  sqliteFree(db
3940: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  );.}../*.** Retu
3950: 72 6e 20 54 52 55 45 20 69 66 20 74 68 65 20 67  rn TRUE if the g
3960: 69 76 65 6e 20 53 51 4c 20 73 74 72 69 6e 67 20  iven SQL string 
3970: 65 6e 64 73 20 69 6e 20 61 20 73 65 6d 69 63 6f  ends in a semico
3980: 6c 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  lon..*/.int sqli
3990: 74 65 5f 63 6f 6d 70 6c 65 74 65 28 63 6f 6e 73  te_complete(cons
39a0: 74 20 63 68 61 72 20 2a 7a 53 71 6c 29 7b 0a 20  t char *zSql){. 
39b0: 20 69 6e 74 20 69 73 43 6f 6d 70 6c 65 74 65 20   int isComplete 
39c0: 3d 20 30 3b 0a 20 20 77 68 69 6c 65 28 20 2a 7a  = 0;.  while( *z
39d0: 53 71 6c 20 29 7b 0a 20 20 20 20 73 77 69 74 63  Sql ){.    switc
39e0: 68 28 20 2a 7a 53 71 6c 20 29 7b 0a 20 20 20 20  h( *zSql ){.    
39f0: 20 20 63 61 73 65 20 27 3b 27 3a 20 7b 0a 20 20    case ';': {.  
3a00: 20 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65        isComplete
3a10: 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 62 72   = 1;.        br
3a20: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  eak;.      }.   
3a30: 20 20 20 63 61 73 65 20 27 20 27 3a 0a 20 20 20     case ' ':.   
3a40: 20 20 20 63 61 73 65 20 27 5c 74 27 3a 0a 20 20     case '\t':.  
3a50: 20 20 20 20 63 61 73 65 20 27 5c 6e 27 3a 0a 20      case '\n':. 
3a60: 20 20 20 20 20 63 61 73 65 20 27 5c 66 27 3a 20       case '\f': 
3a70: 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  {.        break;
3a80: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63  .      }.      c
3a90: 61 73 65 20 27 5b 27 3a 20 7b 0a 20 20 20 20 20  ase '[': {.     
3aa0: 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20     isComplete = 
3ab0: 30 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 2b  0;.        zSql+
3ac0: 2b 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65  +;.        while
3ad0: 28 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c  ( *zSql && *zSql
3ae0: 21 3d 27 5d 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b  !=']' ){ zSql++;
3af0: 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a   }.        if( *
3b00: 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e  zSql==0 ) return
3b10: 20 30 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61   0;.        brea
3b20: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  k;.      }.     
3b30: 20 63 61 73 65 20 27 5c 27 27 3a 20 7b 0a 20 20   case '\'': {.  
3b40: 20 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65        isComplete
3b50: 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7a 53   = 0;.        zS
3b60: 71 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20 77 68  ql++;.        wh
3b70: 69 6c 65 28 20 2a 7a 53 71 6c 20 26 26 20 2a 7a  ile( *zSql && *z
3b80: 53 71 6c 21 3d 27 5c 27 27 20 29 7b 20 7a 53 71  Sql!='\'' ){ zSq
3b90: 6c 2b 2b 3b 20 7d 0a 20 20 20 20 20 20 20 20 69  l++; }.        i
3ba0: 66 28 20 2a 7a 53 71 6c 3d 3d 30 20 29 20 72 65  f( *zSql==0 ) re
3bb0: 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20 20 20  turn 0;.        
3bc0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20  break;.      }. 
3bd0: 20 20 20 20 20 63 61 73 65 20 27 22 27 3a 20 7b       case '"': {
3be0: 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70 6c  .        isCompl
3bf0: 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20  ete = 0;.       
3c00: 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20 20 20 20   zSql++;.       
3c10: 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20 26 26   while( *zSql &&
3c20: 20 2a 7a 53 71 6c 21 3d 27 22 27 20 29 7b 20 7a   *zSql!='"' ){ z
3c30: 53 71 6c 2b 2b 3b 20 7d 0a 20 20 20 20 20 20 20  Sql++; }.       
3c40: 20 69 66 28 20 2a 7a 53 71 6c 3d 3d 30 20 29 20   if( *zSql==0 ) 
3c50: 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20  return 0;.      
3c60: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d    break;.      }
3c70: 0a 20 20 20 20 20 20 63 61 73 65 20 27 2d 27 3a  .      case '-':
3c80: 20 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a   {.        if( z
3c90: 53 71 6c 5b 31 5d 21 3d 27 2d 27 20 29 7b 0a 20  Sql[1]!='-' ){. 
3ca0: 20 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70 6c           isCompl
3cb0: 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20  ete = 0;.       
3cc0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
3cd0: 20 20 7d 0a 20 20 20 20 20 20 20 20 77 68 69 6c    }.        whil
3ce0: 65 28 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71  e( *zSql && *zSq
3cf0: 6c 21 3d 27 5c 6e 27 20 29 7b 20 7a 53 71 6c 2b  l!='\n' ){ zSql+
3d00: 2b 3b 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28  +; }.        if(
3d10: 20 2a 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75   *zSql==0 ) retu
3d20: 72 6e 20 69 73 43 6f 6d 70 6c 65 74 65 3b 0a 20  rn isComplete;. 
3d30: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
3d40: 20 20 20 20 7d 20 0a 20 20 20 20 20 20 64 65 66      } .      def
3d50: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 20 20  ault: {.        
3d60: 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a  isComplete = 0;.
3d70: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
3d80: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
3d90: 20 7a 53 71 6c 2b 2b 3b 0a 20 20 7d 0a 20 20 72   zSql++;.  }.  r
3da0: 65 74 75 72 6e 20 69 73 43 6f 6d 70 6c 65 74 65  eturn isComplete
3db0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75  ;.}../*.** Execu
3dc0: 74 65 20 53 51 4c 20 63 6f 64 65 2e 20 20 52 65  te SQL code.  Re
3dd0: 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20  turn one of the 
3de0: 53 51 4c 49 54 45 5f 20 73 75 63 63 65 73 73 2f  SQLITE_ success/
3df0: 66 61 69 6c 75 72 65 0a 2a 2a 20 63 6f 64 65 73  failure.** codes
3e00: 2e 20 20 41 6c 73 6f 20 77 72 69 74 65 20 61 6e  .  Also write an
3e10: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69   error message i
3e20: 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69  nto memory obtai
3e30: 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 6d 61 6c 6c  ned from.** mall
3e40: 6f 63 28 29 20 61 6e 64 20 6d 61 6b 65 20 2a 70  oc() and make *p
3e50: 7a 45 72 72 4d 73 67 20 70 6f 69 6e 74 20 74 6f  zErrMsg point to
3e60: 20 74 68 61 74 20 6d 65 73 73 61 67 65 2e 0a 2a   that message..*
3e70: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 53 51 4c 20  *.** If the SQL 
3e80: 69 73 20 61 20 71 75 65 72 79 2c 20 74 68 65 6e  is a query, then
3e90: 20 66 6f 72 20 65 61 63 68 20 72 6f 77 20 69 6e   for each row in
3ea0: 20 74 68 65 20 71 75 65 72 79 20 72 65 73 75 6c   the query resul
3eb0: 74 0a 2a 2a 20 74 68 65 20 78 43 61 6c 6c 62 61  t.** the xCallba
3ec0: 63 6b 28 29 20 66 75 6e 63 74 69 6f 6e 20 69 73  ck() function is
3ed0: 20 63 61 6c 6c 65 64 2e 20 20 70 41 72 67 20 62   called.  pArg b
3ee0: 65 63 6f 6d 65 73 20 74 68 65 20 66 69 72 73 74  ecomes the first
3ef0: 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  .** argument to 
3f00: 78 43 61 6c 6c 62 61 63 6b 28 29 2e 20 20 49 66  xCallback().  If
3f10: 20 78 43 61 6c 6c 62 61 63 6b 3d 4e 55 4c 4c 20   xCallback=NULL 
3f20: 74 68 65 6e 20 6e 6f 20 63 61 6c 6c 62 61 63 6b  then no callback
3f30: 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20  .** is invoked, 
3f40: 65 76 65 6e 20 66 6f 72 20 71 75 65 72 69 65 73  even for queries
3f50: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f  ..*/.int sqlite_
3f60: 65 78 65 63 28 0a 20 20 73 71 6c 69 74 65 20 2a  exec(.  sqlite *
3f70: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  db,             
3f80: 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62      /* The datab
3f90: 61 73 65 20 6f 6e 20 77 68 69 63 68 20 74 68 65  ase on which the
3fa0: 20 53 51 4c 20 65 78 65 63 75 74 65 73 20 2a 2f   SQL executes */
3fb0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
3fc0: 53 71 6c 2c 20 20 20 20 20 20 20 20 20 20 20 2f  Sql,           /
3fd0: 2a 20 54 68 65 20 53 51 4c 20 74 6f 20 62 65 20  * The SQL to be 
3fe0: 65 78 65 63 75 74 65 64 20 2a 2f 0a 20 20 73 71  executed */.  sq
3ff0: 6c 69 74 65 5f 63 61 6c 6c 62 61 63 6b 20 78 43  lite_callback xC
4000: 61 6c 6c 62 61 63 6b 2c 20 20 2f 2a 20 49 6e 76  allback,  /* Inv
4010: 6f 6b 65 20 74 68 69 73 20 63 61 6c 6c 62 61 63  oke this callbac
4020: 6b 20 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 76  k routine */.  v
4030: 6f 69 64 20 2a 70 41 72 67 2c 20 20 20 20 20 20  oid *pArg,      
4040: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69             /* Fi
4050: 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  rst argument to 
4060: 78 43 61 6c 6c 62 61 63 6b 28 29 20 2a 2f 0a 20  xCallback() */. 
4070: 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67   char **pzErrMsg
4080: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4090: 57 72 69 74 65 20 65 72 72 6f 72 20 6d 65 73 73  Write error mess
40a0: 61 67 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a  ages here */.){.
40b0: 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a    Parse sParse;.
40c0: 0a 20 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20  .  if( pzErrMsg 
40d0: 29 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b  ) *pzErrMsg = 0;
40e0: 0a 20 20 69 66 28 20 28 64 62 2d 3e 66 6c 61 67  .  if( (db->flag
40f0: 73 20 26 20 53 51 4c 49 54 45 5f 49 6e 69 74 69  s & SQLITE_Initi
4100: 61 6c 69 7a 65 64 29 3d 3d 30 20 29 7b 0a 20 20  alized)==0 ){.  
4110: 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 74    int rc = sqlit
4120: 65 49 6e 69 74 28 64 62 2c 20 70 7a 45 72 72 4d  eInit(db, pzErrM
4130: 73 67 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21  sg);.    if( rc!
4140: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
4150: 20 20 20 20 73 71 6c 69 74 65 53 74 72 52 65 61      sqliteStrRea
4160: 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a  lloc(pzErrMsg);.
4170: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
4180: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 6d 65 6d  .    }.  }.  mem
4190: 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c 20  set(&sParse, 0, 
41a0: 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29 29 3b  sizeof(sParse));
41b0: 0a 20 20 73 50 61 72 73 65 2e 64 62 20 3d 20 64  .  sParse.db = d
41c0: 62 3b 0a 20 20 73 50 61 72 73 65 2e 70 42 65 20  b;.  sParse.pBe 
41d0: 3d 20 64 62 2d 3e 70 42 65 3b 0a 20 20 73 50 61  = db->pBe;.  sPa
41e0: 72 73 65 2e 78 43 61 6c 6c 62 61 63 6b 20 3d 20  rse.xCallback = 
41f0: 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 73 50 61  xCallback;.  sPa
4200: 72 73 65 2e 70 41 72 67 20 3d 20 70 41 72 67 3b  rse.pArg = pArg;
4210: 0a 20 20 73 71 6c 69 74 65 52 75 6e 50 61 72 73  .  sqliteRunPars
4220: 65 72 28 26 73 50 61 72 73 65 2c 20 7a 53 71 6c  er(&sParse, zSql
4230: 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69  , pzErrMsg);.  i
4240: 66 28 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63  f( sqlite_malloc
4250: 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73  _failed ){.    s
4260: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70  qliteSetString(p
4270: 7a 45 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66  zErrMsg, "out of
4280: 20 6d 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20   memory", 0);.  
4290: 20 20 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51    sParse.rc = SQ
42a0: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
42b0: 73 71 6c 69 74 65 42 74 72 65 65 52 6f 6c 6c 62  sqliteBtreeRollb
42c0: 61 63 6b 28 64 62 2d 3e 70 42 65 29 3b 0a 20 20  ack(db->pBe);.  
42d0: 20 20 69 66 28 20 64 62 2d 3e 70 42 65 54 65 6d    if( db->pBeTem
42e0: 70 20 29 20 73 71 6c 69 74 65 42 74 72 65 65 52  p ) sqliteBtreeR
42f0: 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 42 65 54  ollback(db->pBeT
4300: 65 6d 70 29 3b 0a 20 20 20 20 64 62 2d 3e 66 6c  emp);.    db->fl
4310: 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49  ags &= ~SQLITE_I
4320: 6e 54 72 61 6e 73 3b 0a 20 20 20 20 63 6c 65 61  nTrans;.    clea
4330: 72 48 61 73 68 54 61 62 6c 65 28 64 62 2c 20 30  rHashTable(db, 0
4340: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 53  );.  }.  sqliteS
4350: 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d  trRealloc(pzErrM
4360: 73 67 29 3b 0a 20 20 69 66 28 20 73 50 61 72 73  sg);.  if( sPars
4370: 65 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43 48  e.rc==SQLITE_SCH
4380: 45 4d 41 20 29 7b 0a 20 20 20 20 63 6c 65 61 72  EMA ){.    clear
4390: 48 61 73 68 54 61 62 6c 65 28 64 62 2c 20 31 29  HashTable(db, 1)
43a0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 73  ;.  }.  return s
43b0: 50 61 72 73 65 2e 72 63 3b 0a 7d 0a 0a 2f 2a 0a  Parse.rc;.}../*.
43c0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
43d0: 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62 75 73  implements a bus
43e0: 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61 74 20  y callback that 
43f0: 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69 65 73  sleeps and tries
4400: 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69 6c 20  .** again until 
4410: 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20  a timeout value 
4420: 69 73 20 72 65 61 63 68 65 64 2e 20 20 54 68 65  is reached.  The
4430: 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20 69   timeout value i
4440: 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 20  s.** an integer 
4450: 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73  number of millis
4460: 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20 69 6e  econds passed in
4470: 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a 2a   as the first.**
4480: 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74   argument..*/.st
4490: 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 44  atic int sqliteD
44a0: 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61  efaultBusyCallba
44b0: 63 6b 28 0a 20 76 6f 69 64 20 2a 54 69 6d 65 6f  ck(. void *Timeo
44c0: 75 74 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ut,           /*
44d0: 20 4d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20   Maximum amount 
44e0: 6f 66 20 74 69 6d 65 20 74 6f 20 77 61 69 74 20  of time to wait 
44f0: 2a 2f 0a 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  */. const char *
4500: 4e 6f 74 55 73 65 64 2c 20 20 20 20 20 2f 2a 20  NotUsed,     /* 
4510: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
4520: 74 61 62 6c 65 20 74 68 61 74 20 69 73 20 62 75  table that is bu
4530: 73 79 20 2a 2f 0a 20 69 6e 74 20 63 6f 75 6e 74  sy */. int count
4540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4550: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d  /* Number of tim
4560: 65 73 20 74 61 62 6c 65 20 68 61 73 20 62 65 65  es table has bee
4570: 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a 23 69 66  n busy */.){.#if
4580: 20 53 51 4c 49 54 45 5f 4d 49 4e 5f 53 4c 45 45   SQLITE_MIN_SLEE
4590: 50 5f 4d 53 3d 3d 31 0a 20 20 69 6e 74 20 64 65  P_MS==1.  int de
45a0: 6c 61 79 20 3d 20 31 30 3b 0a 20 20 69 6e 74 20  lay = 10;.  int 
45b0: 70 72 69 6f 72 5f 64 65 6c 61 79 20 3d 20 30 3b  prior_delay = 0;
45c0: 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d  .  int timeout =
45d0: 20 28 69 6e 74 29 54 69 6d 65 6f 75 74 3b 0a 20   (int)Timeout;. 
45e0: 20 69 6e 74 20 69 3b 0a 0a 20 20 66 6f 72 28 69   int i;..  for(i
45f0: 3d 31 3b 20 69 3c 63 6f 75 6e 74 3b 20 69 2b 2b  =1; i<count; i++
4600: 29 7b 20 0a 20 20 20 20 70 72 69 6f 72 5f 64 65  ){ .    prior_de
4610: 6c 61 79 20 2b 3d 20 64 65 6c 61 79 3b 0a 20 20  lay += delay;.  
4620: 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 2a    delay = delay*
4630: 32 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79  2;.    if( delay
4640: 3e 3d 31 30 30 30 20 29 7b 0a 20 20 20 20 20 20  >=1000 ){.      
4650: 64 65 6c 61 79 20 3d 20 31 30 30 30 3b 0a 20 20  delay = 1000;.  
4660: 20 20 20 20 70 72 69 6f 72 5f 64 65 6c 61 79 20      prior_delay 
4670: 2b 3d 20 31 30 30 30 2a 28 63 6f 75 6e 74 20 2d  += 1000*(count -
4680: 20 69 20 2d 20 31 29 3b 0a 20 20 20 20 20 20 62   i - 1);.      b
4690: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  reak;.    }.  }.
46a0: 20 20 69 66 28 20 70 72 69 6f 72 5f 64 65 6c 61    if( prior_dela
46b0: 79 20 2b 20 64 65 6c 61 79 20 3e 20 74 69 6d 65  y + delay > time
46c0: 6f 75 74 20 29 7b 0a 20 20 20 20 64 65 6c 61 79  out ){.    delay
46d0: 20 3d 20 74 69 6d 65 6f 75 74 20 2d 20 70 72 69   = timeout - pri
46e0: 6f 72 5f 64 65 6c 61 79 3b 0a 20 20 20 20 69 66  or_delay;.    if
46f0: 28 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 65 74  ( delay<=0 ) ret
4700: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c  urn 0;.  }.  sql
4710: 69 74 65 4f 73 53 6c 65 65 70 28 64 65 6c 61 79  iteOsSleep(delay
4720: 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23  );.  return 1;.#
4730: 65 6c 73 65 0a 20 20 69 6e 74 20 74 69 6d 65 6f  else.  int timeo
4740: 75 74 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f 75  ut = (int)Timeou
4750: 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 6e 74 2b  t;.  if( (count+
4760: 31 29 2a 31 30 30 30 20 3e 20 74 69 6d 65 6f 75  1)*1000 > timeou
4770: 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  t ){.    return 
4780: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 4f  0;.  }.  sqliteO
4790: 73 53 6c 65 65 70 28 31 30 30 30 29 3b 0a 20 20  sSleep(1000);.  
47a0: 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66  return 1;.#endif
47b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
47c0: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
47d0: 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 66 6f  busy callback fo
47e0: 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61  r an Sqlite data
47f0: 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67  base to the.** g
4800: 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75  iven callback fu
4810: 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20  nction with the 
4820: 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 0a  given argument..
4830: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62  */.void sqlite_b
4840: 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73  usy_handler(.  s
4850: 71 6c 69 74 65 20 2a 64 62 2c 0a 20 20 69 6e 74  qlite *db,.  int
4860: 20 28 2a 78 42 75 73 79 29 28 76 6f 69 64 2a 2c   (*xBusy)(void*,
4870: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29  const char*,int)
4880: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29  ,.  void *pArg.)
4890: 7b 0a 20 20 64 62 2d 3e 78 42 75 73 79 43 61 6c  {.  db->xBusyCal
48a0: 6c 62 61 63 6b 20 3d 20 78 42 75 73 79 3b 0a 20  lback = xBusy;. 
48b0: 20 64 62 2d 3e 70 42 75 73 79 41 72 67 20 3d 20   db->pBusyArg = 
48c0: 70 41 72 67 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  pArg;.}../*.** T
48d0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6e 73 74  his routine inst
48e0: 61 6c 6c 73 20 61 20 64 65 66 61 75 6c 74 20 62  alls a default b
48f0: 75 73 79 20 68 61 6e 64 6c 65 72 20 74 68 61 74  usy handler that
4900: 20 77 61 69 74 73 20 66 6f 72 20 74 68 65 0a 2a   waits for the.*
4910: 2a 20 73 70 65 63 69 66 69 65 64 20 6e 75 6d 62  * specified numb
4920: 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e  er of millisecon
4930: 64 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e  ds before return
4940: 69 6e 67 20 30 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ing 0..*/.void s
4950: 71 6c 69 74 65 5f 62 75 73 79 5f 74 69 6d 65 6f  qlite_busy_timeo
4960: 75 74 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 69  ut(sqlite *db, i
4970: 6e 74 20 6d 73 29 7b 0a 20 20 69 66 28 20 6d 73  nt ms){.  if( ms
4980: 3e 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  >0 ){.    sqlite
4990: 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62  _busy_handler(db
49a0: 2c 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42  , sqliteDefaultB
49b0: 75 73 79 43 61 6c 6c 62 61 63 6b 2c 20 28 76 6f  usyCallback, (vo
49c0: 69 64 2a 29 6d 73 29 3b 0a 20 20 7d 65 6c 73 65  id*)ms);.  }else
49d0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f 62 75 73  {.    sqlite_bus
49e0: 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 30 2c  y_handler(db, 0,
49f0: 20 30 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a   0);.  }.}../*.*
4a00: 2a 20 43 61 75 73 65 20 61 6e 79 20 70 65 6e 64  * Cause any pend
4a10: 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f  ing operation to
4a20: 20 73 74 6f 70 20 61 74 20 69 74 73 20 65 61 72   stop at its ear
4a30: 6c 69 65 73 74 20 6f 70 70 6f 72 74 75 6e 69 74  liest opportunit
4a40: 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  y..*/.void sqlit
4a50: 65 5f 69 6e 74 65 72 72 75 70 74 28 73 71 6c 69  e_interrupt(sqli
4a60: 74 65 20 2a 64 62 29 7b 0a 20 20 64 62 2d 3e 66  te *db){.  db->f
4a70: 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 49  lags |= SQLITE_I
4a80: 6e 74 65 72 72 75 70 74 3b 0a 7d 0a 0a 2f 2a 0a  nterrupt;.}../*.
4a90: 2a 2a 20 57 69 6e 64 6f 77 73 20 73 79 73 74 65  ** Windows syste
4aa0: 6d 73 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74  ms should call t
4ab0: 68 69 73 20 72 6f 75 74 69 6e 65 20 74 6f 20 66  his routine to f
4ac0: 72 65 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 0a  ree memory that.
4ad0: 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20 69  ** is returned i
4ae0: 6e 20 74 68 65 20 69 6e 20 74 68 65 20 65 72 72  n the in the err
4af0: 6d 73 67 20 70 61 72 61 6d 65 74 65 72 20 6f 66  msg parameter of
4b00: 20 73 71 6c 69 74 65 5f 6f 70 65 6e 28 29 20 77   sqlite_open() w
4b10: 68 65 6e 0a 2a 2a 20 53 51 4c 69 74 65 20 69 73  hen.** SQLite is
4b20: 20 61 20 44 4c 4c 2e 20 20 46 6f 72 20 73 6f 6d   a DLL.  For som
4b30: 65 20 72 65 61 73 6f 6e 2c 20 69 74 20 64 6f 65  e reason, it doe
4b40: 73 20 6e 6f 74 20 77 6f 72 6b 20 74 6f 20 63 61  s not work to ca
4b50: 6c 6c 20 66 72 65 65 28 29 0a 2a 2a 20 64 69 72  ll free().** dir
4b60: 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74  ectly..**.** Not
4b70: 65 20 74 68 61 74 20 77 65 20 6e 65 65 64 20 74  e that we need t
4b80: 6f 20 63 61 6c 6c 20 66 72 65 65 28 29 20 6e 6f  o call free() no
4b90: 74 20 73 71 6c 69 74 65 46 72 65 65 28 29 20 68  t sqliteFree() h
4ba0: 65 72 65 2c 20 73 69 6e 63 65 20 65 76 65 72 79  ere, since every
4bb0: 0a 2a 2a 20 73 74 72 69 6e 67 20 74 68 61 74 20  .** string that 
4bc0: 69 73 20 65 78 70 6f 72 74 65 64 20 66 72 6f 6d  is exported from
4bd0: 20 53 51 4c 69 74 65 20 73 68 6f 75 6c 64 20 68   SQLite should h
4be0: 61 76 65 20 61 6c 72 65 61 64 79 20 70 61 73 73  ave already pass
4bf0: 65 64 20 74 68 72 6f 75 67 68 0a 2a 2a 20 73 71  ed through.** sq
4c00: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 29  liteStrRealloc()
4c10: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
4c20: 5f 66 72 65 65 6d 65 6d 28 76 6f 69 64 20 2a 70  _freemem(void *p
4c30: 29 7b 20 66 72 65 65 28 70 29 3b 20 7d 0a 0a 2f  ){ free(p); }../
4c40: 2a 0a 2a 2a 20 57 69 6e 64 6f 77 73 20 73 79 73  *.** Windows sys
4c50: 74 65 6d 73 20 6e 65 65 64 20 66 75 6e 63 74 69  tems need functi
4c60: 6f 6e 73 20 74 6f 20 63 61 6c 6c 20 74 6f 20 72  ons to call to r
4c70: 65 74 75 72 6e 20 74 68 65 20 73 71 6c 69 74 65  eturn the sqlite
4c80: 5f 76 65 72 73 69 6f 6e 0a 2a 2a 20 61 6e 64 20  _version.** and 
4c90: 73 71 6c 69 74 65 5f 65 6e 63 6f 64 69 6e 67 20  sqlite_encoding 
4ca0: 73 74 72 69 6e 67 73 2e 0a 2a 2f 0a 63 6f 6e 73  strings..*/.cons
4cb0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 5f 6c  t char *sqlite_l
4cc0: 69 62 76 65 72 73 69 6f 6e 28 76 6f 69 64 29 7b  ibversion(void){
4cd0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 5f 76   return sqlite_v
4ce0: 65 72 73 69 6f 6e 3b 20 7d 0a 63 6f 6e 73 74 20  ersion; }.const 
4cf0: 63 68 61 72 20 2a 73 71 6c 69 74 65 5f 6c 69 62  char *sqlite_lib
4d00: 65 6e 63 6f 64 69 6e 67 28 76 6f 69 64 29 7b 20  encoding(void){ 
4d10: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 5f 65 6e  return sqlite_en
4d20: 63 6f 64 69 6e 67 3b 20 7d 0a 0a 2f 2a 0a 2a 2a  coding; }../*.**
4d30: 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 65 72   Create new user
4d40: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f  -defined functio
4d50: 6e 73 2e 20 20 54 68 65 20 73 71 6c 69 74 65 5f  ns.  The sqlite_
4d60: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28  create_function(
4d70: 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 63 72 65  ).** routine cre
4d80: 61 74 65 73 20 61 20 72 65 67 75 6c 61 72 20 66  ates a regular f
4d90: 75 6e 63 74 69 6f 6e 20 61 6e 64 20 73 71 6c 69  unction and sqli
4da0: 74 65 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67  te_create_aggreg
4db0: 61 74 65 28 29 0a 2a 2a 20 63 72 65 61 74 65 73  ate().** creates
4dc0: 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 66 75   an aggregate fu
4dd0: 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50 61  nction..**.** Pa
4de0: 73 73 69 6e 67 20 61 20 4e 55 4c 4c 20 78 46 75  ssing a NULL xFu
4df0: 6e 63 20 61 72 67 75 6d 65 6e 74 20 6f 72 20 4e  nc argument or N
4e00: 55 4c 4c 20 78 53 74 65 70 20 61 6e 64 20 78 46  ULL xStep and xF
4e10: 69 6e 61 6c 69 7a 65 20 61 72 67 75 6d 65 6e 74  inalize argument
4e20: 73 0a 2a 2a 20 64 69 73 61 62 6c 65 73 20 74 68  s.** disables th
4e30: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 43 61 6c  e function.  Cal
4e40: 6c 69 6e 67 20 73 71 6c 69 74 65 5f 63 72 65 61  ling sqlite_crea
4e50: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 20 77 69  te_function() wi
4e60: 74 68 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20 6e  th the.** same n
4e70: 61 6d 65 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f  ame and number o
4e80: 66 20 61 72 67 75 6d 65 6e 74 73 20 61 73 20 61  f arguments as a
4e90: 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 0a 2a   prior call to.*
4ea0: 2a 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f  * sqlite_create_
4eb0: 61 67 67 72 65 67 61 74 65 28 29 20 64 69 73 61  aggregate() disa
4ec0: 62 6c 65 73 20 74 68 65 20 70 72 69 6f 72 20 63  bles the prior c
4ed0: 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65  all to.** sqlite
4ee0: 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74  _create_aggregat
4ef0: 65 28 29 2c 20 61 6e 64 20 76 69 63 65 20 76 65  e(), and vice ve
4f00: 72 73 61 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 41  rsa..**.** If nA
4f10: 72 67 20 69 73 20 2d 31 20 69 74 20 6d 65 61 6e  rg is -1 it mean
4f20: 73 20 74 68 61 74 20 74 68 69 73 20 66 75 6e 63  s that this func
4f30: 74 69 6f 6e 20 77 69 6c 6c 20 61 63 63 65 70 74  tion will accept
4f40: 20 61 6e 79 20 6e 75 6d 62 65 72 0a 2a 2a 20 6f   any number.** o
4f50: 66 20 61 72 67 75 6d 65 6e 74 73 2c 20 69 6e 63  f arguments, inc
4f60: 6c 75 64 69 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74  luding 0..*/.int
4f70: 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 66   sqlite_create_f
4f80: 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74  unction(.  sqlit
4f90: 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  e *db,          
4fa0: 2f 2a 20 41 64 64 20 74 68 65 20 66 75 6e 63 74  /* Add the funct
4fb0: 69 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61  ion to this data
4fc0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
4fd0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
4fe0: 2a 7a 4e 61 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d  *zName,   /* Nam
4ff0: 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f  e of the functio
5000: 6e 20 74 6f 20 61 64 64 20 2a 2f 0a 20 20 69 6e  n to add */.  in
5010: 74 20 6e 41 72 67 2c 20 20 20 20 20 20 20 20 20  t nArg,         
5020: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
5030: 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 76  arguments */.  v
5040: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 76 6f 69  oid (*xFunc)(voi
5050: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61  d*,int,const cha
5060: 72 2a 2a 29 20 20 2f 2a 20 49 6d 70 6c 65 6d 65  r**)  /* Impleme
5070: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 66  ntation of the f
5080: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20  unction */.){.  
5090: 55 73 65 72 46 75 6e 63 20 2a 70 3b 0a 20 20 69  UserFunc *p;.  i
50a0: 66 28 20 64 62 3d 3d 30 20 7c 7c 20 7a 4e 61 6d  f( db==0 || zNam
50b0: 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b  e==0 ) return 1;
50c0: 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 46 69 6e  .  p = sqliteFin
50d0: 64 55 73 65 72 46 75 6e 63 74 69 6f 6e 28 64 62  dUserFunction(db
50e0: 2c 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65 6e 28  , zName, strlen(
50f0: 7a 4e 61 6d 65 29 2c 20 6e 41 72 67 2c 20 31 29  zName), nArg, 1)
5100: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72  ;.  if( p==0 ) r
5110: 65 74 75 72 6e 20 31 3b 0a 20 20 70 2d 3e 78 46  eturn 1;.  p->xF
5120: 75 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70  unc = xFunc;.  p
5130: 2d 3e 78 53 74 65 70 20 3d 20 30 3b 0a 20 20 70  ->xStep = 0;.  p
5140: 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 30 3b  ->xFinalize = 0;
5150: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 69  .  return 0;.}.i
5160: 6e 74 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65  nt sqlite_create
5170: 5f 61 67 67 72 65 67 61 74 65 28 0a 20 20 73 71  _aggregate(.  sq
5180: 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20 20  lite *db,       
5190: 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20 66 75     /* Add the fu
51a0: 6e 63 74 69 6f 6e 20 74 6f 20 74 68 69 73 20 64  nction to this d
51b0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
51c0: 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  on */.  const ch
51d0: 61 72 20 2a 7a 4e 61 6d 65 2c 20 20 20 2f 2a 20  ar *zName,   /* 
51e0: 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 75 6e 63  Name of the func
51f0: 74 69 6f 6e 20 74 6f 20 61 64 64 20 2a 2f 0a 20  tion to add */. 
5200: 20 69 6e 74 20 6e 41 72 67 2c 20 20 20 20 20 20   int nArg,      
5210: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
5220: 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a  of arguments */.
5230: 20 20 76 6f 69 64 20 2a 28 2a 78 53 74 65 70 29    void *(*xStep)
5240: 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74  (void*,int,const
5250: 20 63 68 61 72 2a 2a 29 2c 20 2f 2a 20 54 68 65   char**), /* The
5260: 20 73 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 2a   step function *
5270: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61  /.  void (*xFina
5280: 6c 69 7a 65 29 28 76 6f 69 64 2a 2c 76 6f 69 64  lize)(void*,void
5290: 2a 29 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54  *)          /* T
52a0: 68 65 20 66 69 6e 61 6c 69 7a 65 72 20 2a 2f 0a  he finalizer */.
52b0: 29 7b 0a 20 20 55 73 65 72 46 75 6e 63 20 2a 70  ){.  UserFunc *p
52c0: 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 7c 7c  ;.  if( db==0 ||
52d0: 20 7a 4e 61 6d 65 3d 3d 30 20 29 20 72 65 74 75   zName==0 ) retu
52e0: 72 6e 20 31 3b 0a 20 20 70 20 3d 20 73 71 6c 69  rn 1;.  p = sqli
52f0: 74 65 46 69 6e 64 55 73 65 72 46 75 6e 63 74 69  teFindUserFuncti
5300: 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 73 74  on(db, zName, st
5310: 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 6e 41 72  rlen(zName), nAr
5320: 67 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 3d 3d  g, 1);.  if( p==
5330: 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20  0 ) return 1;.  
5340: 70 2d 3e 78 46 75 6e 63 20 3d 20 30 3b 0a 20 20  p->xFunc = 0;.  
5350: 70 2d 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70  p->xStep = xStep
5360: 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65  ;.  p->xFinalize
5370: 20 3d 20 78 46 69 6e 61 6c 69 7a 65 3b 0a 20 20   = xFinalize;.  
5380: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a              return 0;.}.