/ Hex Artifact Content
Login

Artifact be449edb106a16f1ad95f9b798bdc2337f8c3f83b96c284f417c0a26d43f0c1b:


0000: 2f 2a 0a 2a 2a 20 32 30 30 35 20 4d 61 79 20 32  /*.** 2005 May 2
0010: 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  5.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
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: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f  .** This file co
0180: 6e 74 61 69 6e 73 20 74 68 65 20 69 6d 70 6c 65  ntains the imple
0190: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
01a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
01b0: 28 29 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2c  ().** interface,
01c0: 20 61 6e 64 20 72 6f 75 74 69 6e 65 73 20 74 68   and routines th
01d0: 61 74 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f  at contribute to
01e0: 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74   loading the dat
01f0: 61 62 61 73 65 20 73 63 68 65 6d 61 0a 2a 2a 20  abase schema.** 
0200: 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2f 0a 23 69  from disk..*/.#i
0210: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e  nclude "sqliteIn
0220: 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 6c  t.h"../*.** Fill
0230: 20 74 68 65 20 49 6e 69 74 44 61 74 61 20 73 74   the InitData st
0240: 72 75 63 74 75 72 65 20 77 69 74 68 20 61 6e 20  ructure with an 
0250: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 68  error message th
0260: 61 74 20 69 6e 64 69 63 61 74 65 73 0a 2a 2a 20  at indicates.** 
0270: 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73  that the databas
0280: 65 20 69 73 20 63 6f 72 72 75 70 74 2e 0a 2a 2f  e is corrupt..*/
0290: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f 72  .static void cor
02a0: 72 75 70 74 53 63 68 65 6d 61 28 0a 20 20 49 6e  ruptSchema(.  In
02b0: 69 74 44 61 74 61 20 2a 70 44 61 74 61 2c 20 20  itData *pData,  
02c0: 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 7a 61     /* Initializa
02d0: 74 69 6f 6e 20 63 6f 6e 74 65 78 74 20 2a 2f 0a  tion context */.
02e0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4f    const char *zO
02f0: 62 6a 2c 20 20 20 20 2f 2a 20 4f 62 6a 65 63 74  bj,    /* Object
0300: 20 62 65 69 6e 67 20 70 61 72 73 65 64 20 61 74   being parsed at
0310: 20 74 68 65 20 70 6f 69 6e 74 20 6f 66 20 65 72   the point of er
0320: 72 6f 72 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  ror */.  const c
0330: 68 61 72 20 2a 7a 45 78 74 72 61 20 20 20 2f 2a  har *zExtra   /*
0340: 20 45 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69   Error informati
0350: 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74  on */.){.  sqlit
0360: 65 33 20 2a 64 62 20 3d 20 70 44 61 74 61 2d 3e  e3 *db = pData->
0370: 64 62 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61  db;.  if( db->ma
0380: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20  llocFailed ){.  
0390: 20 20 70 44 61 74 61 2d 3e 72 63 20 3d 20 53 51    pData->rc = SQ
03a0: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b  LITE_NOMEM_BKPT;
03b0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 44 61  .  }else if( pDa
03c0: 74 61 2d 3e 70 7a 45 72 72 4d 73 67 5b 30 5d 21  ta->pzErrMsg[0]!
03d0: 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 41 20 65  =0 ){.    /* A e
03e0: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 68 61 73  rror message has
03f0: 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 67 65   already been ge
0400: 6e 65 72 61 74 65 64 2e 20 20 44 6f 20 6e 6f 74  nerated.  Do not
0410: 20 6f 76 65 72 77 72 69 74 65 20 69 74 20 2a 2f   overwrite it */
0420: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 44 61  .  }else if( pDa
0430: 74 61 2d 3e 6d 49 6e 69 74 46 6c 61 67 73 20 26  ta->mInitFlags &
0440: 20 49 4e 49 54 46 4c 41 47 5f 41 6c 74 65 72 54   INITFLAG_AlterT
0450: 61 62 6c 65 20 29 7b 0a 20 20 20 20 2a 70 44 61  able ){.    *pDa
0460: 74 61 2d 3e 70 7a 45 72 72 4d 73 67 20 3d 20 73  ta->pzErrMsg = s
0470: 71 6c 69 74 65 33 44 62 53 74 72 44 75 70 28 64  qlite3DbStrDup(d
0480: 62 2c 20 7a 45 78 74 72 61 29 3b 0a 20 20 20 20  b, zExtra);.    
0490: 70 44 61 74 61 2d 3e 72 63 20 3d 20 53 51 4c 49  pData->rc = SQLI
04a0: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 65 6c 73  TE_ERROR;.  }els
04b0: 65 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 20  e if( db->flags 
04c0: 26 20 53 51 4c 49 54 45 5f 57 72 69 74 65 53 63  & SQLITE_WriteSc
04d0: 68 65 6d 61 20 29 7b 0a 20 20 20 20 70 44 61 74  hema ){.    pDat
04e0: 61 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 43  a->rc = SQLITE_C
04f0: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d  ORRUPT_BKPT;.  }
0500: 65 6c 73 65 7b 0a 20 20 20 20 63 68 61 72 20 2a  else{.    char *
0510: 7a 3b 0a 20 20 20 20 69 66 28 20 7a 4f 62 6a 3d  z;.    if( zObj=
0520: 3d 30 20 29 20 7a 4f 62 6a 20 3d 20 22 3f 22 3b  =0 ) zObj = "?";
0530: 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33  .    z = sqlite3
0540: 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 6d 61 6c  MPrintf(db, "mal
0550: 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20  formed database 
0560: 73 63 68 65 6d 61 20 28 25 73 29 22 2c 20 7a 4f  schema (%s)", zO
0570: 62 6a 29 3b 0a 20 20 20 20 69 66 28 20 7a 45 78  bj);.    if( zEx
0580: 74 72 61 20 26 26 20 7a 45 78 74 72 61 5b 30 5d  tra && zExtra[0]
0590: 20 29 20 7a 20 3d 20 73 71 6c 69 74 65 33 4d 50   ) z = sqlite3MP
05a0: 72 69 6e 74 66 28 64 62 2c 20 22 25 7a 20 2d 20  rintf(db, "%z - 
05b0: 25 73 22 2c 20 7a 2c 20 7a 45 78 74 72 61 29 3b  %s", z, zExtra);
05c0: 0a 20 20 20 20 2a 70 44 61 74 61 2d 3e 70 7a 45  .    *pData->pzE
05d0: 72 72 4d 73 67 20 3d 20 7a 3b 0a 20 20 20 20 70  rrMsg = z;.    p
05e0: 44 61 74 61 2d 3e 72 63 20 3d 20 53 51 4c 49 54  Data->rc = SQLIT
05f0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a  E_CORRUPT_BKPT;.
0600: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69    }.}../*.** Thi
0610: 73 20 69 73 20 74 68 65 20 63 61 6c 6c 62 61 63  s is the callbac
0620: 6b 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 74 68  k routine for th
0630: 65 20 63 6f 64 65 20 74 68 61 74 20 69 6e 69 74  e code that init
0640: 69 61 6c 69 7a 65 73 20 74 68 65 0a 2a 2a 20 64  ializes the.** d
0650: 61 74 61 62 61 73 65 2e 20 20 53 65 65 20 73 71  atabase.  See sq
0660: 6c 69 74 65 33 49 6e 69 74 28 29 20 62 65 6c 6f  lite3Init() belo
0670: 77 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  w for additional
0680: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2a   information..**
0690: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
06a0: 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 66 72 6f   also called fro
06b0: 6d 20 74 68 65 20 4f 50 5f 50 61 72 73 65 53 63  m the OP_ParseSc
06c0: 68 65 6d 61 20 6f 70 63 6f 64 65 20 6f 66 20 74  hema opcode of t
06d0: 68 65 20 56 44 42 45 2e 0a 2a 2a 0a 2a 2a 20 45  he VDBE..**.** E
06e0: 61 63 68 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e  ach callback con
06f0: 74 61 69 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77  tains the follow
0700: 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a  ing information:
0710: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  .**.**     argv[
0720: 30 5d 20 3d 20 6e 61 6d 65 20 6f 66 20 74 68 69  0] = name of thi
0730: 6e 67 20 62 65 69 6e 67 20 63 72 65 61 74 65 64  ng being created
0740: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 31 5d 20  .**     argv[1] 
0750: 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62  = root page numb
0760: 65 72 20 66 6f 72 20 74 61 62 6c 65 20 6f 72 20  er for table or 
0770: 69 6e 64 65 78 2e 20 30 20 66 6f 72 20 74 72 69  index. 0 for tri
0780: 67 67 65 72 20 6f 72 20 76 69 65 77 2e 0a 2a 2a  gger or view..**
0790: 20 20 20 20 20 61 72 67 76 5b 32 5d 20 3d 20 53       argv[2] = S
07a0: 51 4c 20 74 65 78 74 20 66 6f 72 20 74 68 65 20  QL text for the 
07b0: 43 52 45 41 54 45 20 73 74 61 74 65 6d 65 6e 74  CREATE statement
07c0: 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ..**.*/.int sqli
07d0: 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28  te3InitCallback(
07e0: 76 6f 69 64 20 2a 70 49 6e 69 74 2c 20 69 6e 74  void *pInit, int
07f0: 20 61 72 67 63 2c 20 63 68 61 72 20 2a 2a 61 72   argc, char **ar
0800: 67 76 2c 20 63 68 61 72 20 2a 2a 4e 6f 74 55 73  gv, char **NotUs
0810: 65 64 29 7b 0a 20 20 49 6e 69 74 44 61 74 61 20  ed){.  InitData 
0820: 2a 70 44 61 74 61 20 3d 20 28 49 6e 69 74 44 61  *pData = (InitDa
0830: 74 61 2a 29 70 49 6e 69 74 3b 0a 20 20 73 71 6c  ta*)pInit;.  sql
0840: 69 74 65 33 20 2a 64 62 20 3d 20 70 44 61 74 61  ite3 *db = pData
0850: 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 44 62 20  ->db;.  int iDb 
0860: 3d 20 70 44 61 74 61 2d 3e 69 44 62 3b 0a 0a 20  = pData->iDb;.. 
0870: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 33   assert( argc==3
0880: 20 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52   );.  UNUSED_PAR
0890: 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64 2c  AMETER2(NotUsed,
08a0: 20 61 72 67 63 29 3b 0a 20 20 61 73 73 65 72 74   argc);.  assert
08b0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
08c0: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20  held(db->mutex) 
08d0: 29 3b 0a 20 20 44 62 43 6c 65 61 72 50 72 6f 70  );.  DbClearProp
08e0: 65 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42  erty(db, iDb, DB
08f0: 5f 45 6d 70 74 79 29 3b 0a 20 20 69 66 28 20 64  _Empty);.  if( d
0900: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  b->mallocFailed 
0910: 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 63  ){.    corruptSc
0920: 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 76  hema(pData, argv
0930: 5b 30 5d 2c 20 30 29 3b 0a 20 20 20 20 72 65 74  [0], 0);.    ret
0940: 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 61 73  urn 1;.  }..  as
0950: 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26 26 20  sert( iDb>=0 && 
0960: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  iDb<db->nDb );. 
0970: 20 69 66 28 20 61 72 67 76 3d 3d 30 20 29 20 72   if( argv==0 ) r
0980: 65 74 75 72 6e 20 30 3b 20 20 20 2f 2a 20 4d 69  eturn 0;   /* Mi
0990: 67 68 74 20 68 61 70 70 65 6e 20 69 66 20 45 4d  ght happen if EM
09a0: 50 54 59 5f 52 45 53 55 4c 54 5f 43 41 4c 4c 42  PTY_RESULT_CALLB
09b0: 41 43 4b 53 20 61 72 65 20 6f 6e 20 2a 2f 0a 20  ACKS are on */. 
09c0: 20 69 66 28 20 61 72 67 76 5b 31 5d 3d 3d 30 20   if( argv[1]==0 
09d0: 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 63  ){.    corruptSc
09e0: 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 76  hema(pData, argv
09f0: 5b 30 5d 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65  [0], 0);.  }else
0a00: 20 69 66 28 20 73 71 6c 69 74 65 33 5f 73 74 72   if( sqlite3_str
0a10: 6e 69 63 6d 70 28 61 72 67 76 5b 32 5d 2c 22 63  nicmp(argv[2],"c
0a20: 72 65 61 74 65 20 22 2c 37 29 3d 3d 30 20 29 7b  reate ",7)==0 ){
0a30: 0a 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65  .    /* Call the
0a40: 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 65   parser to proce
0a50: 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42 4c  ss a CREATE TABL
0a60: 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 45 57  E, INDEX or VIEW
0a70: 2e 0a 20 20 20 20 2a 2a 20 42 75 74 20 62 65 63  ..    ** But bec
0a80: 61 75 73 65 20 64 62 2d 3e 69 6e 69 74 2e 62 75  ause db->init.bu
0a90: 73 79 20 69 73 20 73 65 74 20 74 6f 20 31 2c 20  sy is set to 1, 
0aa0: 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73 20  no VDBE code is 
0ab0: 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 2a 2a  generated.    **
0ac0: 20 6f 72 20 65 78 65 63 75 74 65 64 2e 20 20 41   or executed.  A
0ad0: 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 64 6f  ll the parser do
0ae0: 65 73 20 69 73 20 62 75 69 6c 64 20 74 68 65 20  es is build the 
0af0: 69 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a 20 20  internal data.  
0b00: 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 73 20    ** structures 
0b10: 74 68 61 74 20 64 65 73 63 72 69 62 65 20 74 68  that describe th
0b20: 65 20 74 61 62 6c 65 2c 20 69 6e 64 65 78 2c 20  e table, index, 
0b30: 6f 72 20 76 69 65 77 2e 0a 20 20 20 20 2a 2f 0a  or view..    */.
0b40: 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20      int rc;.    
0b50: 75 38 20 73 61 76 65 64 5f 69 44 62 20 3d 20 64  u8 saved_iDb = d
0b60: 62 2d 3e 69 6e 69 74 2e 69 44 62 3b 0a 20 20 20  b->init.iDb;.   
0b70: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70   sqlite3_stmt *p
0b80: 53 74 6d 74 3b 0a 20 20 20 20 54 45 53 54 4f 4e  Stmt;.    TESTON
0b90: 4c 59 28 69 6e 74 20 72 63 70 29 3b 20 20 20 20  LY(int rcp);    
0ba0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72          /* Retur
0bb0: 6e 20 63 6f 64 65 20 66 72 6f 6d 20 73 71 6c 69  n code from sqli
0bc0: 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 2a 2f  te3_prepare() */
0bd0: 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62  ..    assert( db
0be0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20  ->init.busy );. 
0bf0: 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 44 62 20     db->init.iDb 
0c00: 3d 20 69 44 62 3b 0a 20 20 20 20 64 62 2d 3e 69  = iDb;.    db->i
0c10: 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 73 71  nit.newTnum = sq
0c20: 6c 69 74 65 33 41 74 6f 69 28 61 72 67 76 5b 31  lite3Atoi(argv[1
0c30: 5d 29 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74  ]);.    db->init
0c40: 2e 6f 72 70 68 61 6e 54 72 69 67 67 65 72 20 3d  .orphanTrigger =
0c50: 20 30 3b 0a 20 20 20 20 54 45 53 54 4f 4e 4c 59   0;.    TESTONLY
0c60: 28 72 63 70 20 3d 20 29 20 73 71 6c 69 74 65 33  (rcp = ) sqlite3
0c70: 5f 70 72 65 70 61 72 65 28 64 62 2c 20 61 72 67  _prepare(db, arg
0c80: 76 5b 32 5d 2c 20 2d 31 2c 20 26 70 53 74 6d 74  v[2], -1, &pStmt
0c90: 2c 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 64  , 0);.    rc = d
0ca0: 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 20 20  b->errCode;.    
0cb0: 61 73 73 65 72 74 28 20 28 72 63 26 30 78 46 46  assert( (rc&0xFF
0cc0: 29 3d 3d 28 72 63 70 26 30 78 46 46 29 20 29 3b  )==(rcp&0xFF) );
0cd0: 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 44  .    db->init.iD
0ce0: 62 20 3d 20 73 61 76 65 64 5f 69 44 62 3b 0a 20  b = saved_iDb;. 
0cf0: 20 20 20 2f 2a 20 61 73 73 65 72 74 28 20 73 61     /* assert( sa
0d00: 76 65 64 5f 69 44 62 3d 3d 30 20 7c 7c 20 28 64  ved_iDb==0 || (d
0d10: 62 2d 3e 6d 44 62 46 6c 61 67 73 20 26 20 44 42  b->mDbFlags & DB
0d20: 46 4c 41 47 5f 56 61 63 75 75 6d 29 21 3d 30 20  FLAG_Vacuum)!=0 
0d30: 29 3b 20 2a 2f 0a 20 20 20 20 69 66 28 20 53 51  ); */.    if( SQ
0d40: 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20  LITE_OK!=rc ){. 
0d50: 20 20 20 20 20 69 66 28 20 64 62 2d 3e 69 6e 69       if( db->ini
0d60: 74 2e 6f 72 70 68 61 6e 54 72 69 67 67 65 72 20  t.orphanTrigger 
0d70: 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  ){.        asser
0d80: 74 28 20 69 44 62 3d 3d 31 20 29 3b 0a 20 20 20  t( iDb==1 );.   
0d90: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
0da0: 20 20 70 44 61 74 61 2d 3e 72 63 20 3d 20 72 63    pData->rc = rc
0db0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63  ;.        if( rc
0dc0: 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29  ==SQLITE_NOMEM )
0dd0: 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  {.          sqli
0de0: 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29 3b  te3OomFault(db);
0df0: 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69  .        }else i
0e00: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 49 4e  f( rc!=SQLITE_IN
0e10: 54 45 52 52 55 50 54 20 26 26 20 28 72 63 26 30  TERRUPT && (rc&0
0e20: 78 46 46 29 21 3d 53 51 4c 49 54 45 5f 4c 4f 43  xFF)!=SQLITE_LOC
0e30: 4b 45 44 20 29 7b 0a 20 20 20 20 20 20 20 20 20  KED ){.         
0e40: 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70   corruptSchema(p
0e50: 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c 20 73  Data, argv[0], s
0e60: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 64 62  qlite3_errmsg(db
0e70: 29 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ));.        }.  
0e80: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
0e90: 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65  sqlite3_finalize
0ea0: 28 70 53 74 6d 74 29 3b 0a 20 20 7d 65 6c 73 65  (pStmt);.  }else
0eb0: 20 69 66 28 20 61 72 67 76 5b 30 5d 3d 3d 30 20   if( argv[0]==0 
0ec0: 7c 7c 20 28 61 72 67 76 5b 32 5d 21 3d 30 20 26  || (argv[2]!=0 &
0ed0: 26 20 61 72 67 76 5b 32 5d 5b 30 5d 21 3d 30 29  & argv[2][0]!=0)
0ee0: 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53   ){.    corruptS
0ef0: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67  chema(pData, arg
0f00: 76 5b 30 5d 2c 20 30 29 3b 0a 20 20 7d 65 6c 73  v[0], 0);.  }els
0f10: 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65  e{.    /* If the
0f20: 20 53 51 4c 20 63 6f 6c 75 6d 6e 20 69 73 20 62   SQL column is b
0f30: 6c 61 6e 6b 20 69 74 20 6d 65 61 6e 73 20 74 68  lank it means th
0f40: 69 73 20 69 73 20 61 6e 20 69 6e 64 65 78 20 74  is is an index t
0f50: 68 61 74 0a 20 20 20 20 2a 2a 20 77 61 73 20 63  hat.    ** was c
0f60: 72 65 61 74 65 64 20 74 6f 20 62 65 20 74 68 65  reated to be the
0f70: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20   PRIMARY KEY or 
0f80: 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e 49  to fulfill a UNI
0f90: 51 55 45 0a 20 20 20 20 2a 2a 20 63 6f 6e 73 74  QUE.    ** const
0fa0: 72 61 69 6e 74 20 66 6f 72 20 61 20 43 52 45 41  raint for a CREA
0fb0: 54 45 20 54 41 42 4c 45 2e 20 20 54 68 65 20 69  TE TABLE.  The i
0fc0: 6e 64 65 78 20 73 68 6f 75 6c 64 20 68 61 76 65  ndex should have
0fd0: 20 61 6c 72 65 61 64 79 0a 20 20 20 20 2a 2a 20   already.    ** 
0fe0: 62 65 65 6e 20 63 72 65 61 74 65 64 20 77 68 65  been created whe
0ff0: 6e 20 77 65 20 70 72 6f 63 65 73 73 65 64 20 74  n we processed t
1000: 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45 2e  he CREATE TABLE.
1010: 20 20 41 6c 6c 20 77 65 20 68 61 76 65 0a 20 20    All we have.  
1020: 20 20 2a 2a 20 74 6f 20 64 6f 20 68 65 72 65 20    ** to do here 
1030: 69 73 20 72 65 63 6f 72 64 20 74 68 65 20 72 6f  is record the ro
1040: 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66  ot page number f
1050: 6f 72 20 74 68 61 74 20 69 6e 64 65 78 2e 0a 20  or that index.. 
1060: 20 20 20 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20     */.    Index 
1070: 2a 70 49 6e 64 65 78 3b 0a 20 20 20 20 70 49 6e  *pIndex;.    pIn
1080: 64 65 78 20 3d 20 73 71 6c 69 74 65 33 46 69 6e  dex = sqlite3Fin
1090: 64 49 6e 64 65 78 28 64 62 2c 20 61 72 67 76 5b  dIndex(db, argv[
10a0: 30 5d 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  0], db->aDb[iDb]
10b0: 2e 7a 44 62 53 4e 61 6d 65 29 3b 0a 20 20 20 20  .zDbSName);.    
10c0: 69 66 28 20 70 49 6e 64 65 78 3d 3d 30 20 29 7b  if( pIndex==0 ){
10d0: 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63  .      /* This c
10e0: 61 6e 20 6f 63 63 75 72 20 69 66 20 74 68 65 72  an occur if ther
10f0: 65 20 65 78 69 73 74 73 20 61 6e 20 69 6e 64 65  e exists an inde
1100: 78 20 6f 6e 20 61 20 54 45 4d 50 20 74 61 62 6c  x on a TEMP tabl
1110: 65 20 77 68 69 63 68 0a 20 20 20 20 20 20 2a 2a  e which.      **
1120: 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 6e 61   has the same na
1130: 6d 65 20 61 73 20 61 6e 6f 74 68 65 72 20 69 6e  me as another in
1140: 64 65 78 20 6f 6e 20 61 20 70 65 72 6d 61 6e 65  dex on a permane
1150: 6e 74 20 69 6e 64 65 78 2e 20 20 53 69 6e 63 65  nt index.  Since
1160: 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 70 65  .      ** the pe
1170: 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 20 69 73  rmanent table is
1180: 20 68 69 64 64 65 6e 20 62 79 20 74 68 65 20 54   hidden by the T
1190: 45 4d 50 20 74 61 62 6c 65 2c 20 77 65 20 63 61  EMP table, we ca
11a0: 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20 2a 2a 20  n also.      ** 
11b0: 73 61 66 65 6c 79 20 69 67 6e 6f 72 65 20 74 68  safely ignore th
11c0: 65 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20 70  e index on the p
11d0: 65 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 2e 0a  ermanent table..
11e0: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 2f        */.      /
11f0: 2a 20 44 6f 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b  * Do Nothing */;
1200: 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 73  .    }else if( s
1210: 71 6c 69 74 65 33 47 65 74 49 6e 74 33 32 28 61  qlite3GetInt32(a
1220: 72 67 76 5b 31 5d 2c 20 26 70 49 6e 64 65 78 2d  rgv[1], &pIndex-
1230: 3e 74 6e 75 6d 29 3d 3d 30 20 29 7b 0a 20 20 20  >tnum)==0 ){.   
1240: 20 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61     corruptSchema
1250: 28 70 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c  (pData, argv[0],
1260: 20 22 69 6e 76 61 6c 69 64 20 72 6f 6f 74 70 61   "invalid rootpa
1270: 67 65 22 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  ge");.    }.  }.
1280: 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f    return 0;.}../
1290: 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20  *.** Attempt to 
12a0: 72 65 61 64 20 74 68 65 20 64 61 74 61 62 61 73  read the databas
12b0: 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69 6e 69  e schema and ini
12c0: 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e 61 6c  tialize internal
12d0: 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74 75  .** data structu
12e0: 72 65 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65  res for a single
12f0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20   database file. 
1300: 20 54 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68   The index of th
1310: 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69  e.** database fi
1320: 6c 65 20 69 73 20 67 69 76 65 6e 20 62 79 20 69  le is given by i
1330: 44 62 2e 20 20 69 44 62 3d 3d 30 20 69 73 20 75  Db.  iDb==0 is u
1340: 73 65 64 20 66 6f 72 20 74 68 65 20 6d 61 69 6e  sed for the main
1350: 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20 69  .** database.  i
1360: 44 62 3d 3d 31 20 73 68 6f 75 6c 64 20 6e 65 76  Db==1 should nev
1370: 65 72 20 62 65 20 75 73 65 64 2e 20 20 69 44 62  er be used.  iDb
1380: 3e 3d 32 20 69 73 20 75 73 65 64 20 66 6f 72 0a  >=2 is used for.
1390: 2a 2a 20 61 75 78 69 6c 69 61 72 79 20 64 61 74  ** auxiliary dat
13a0: 61 62 61 73 65 73 2e 20 20 52 65 74 75 72 6e 20  abases.  Return 
13b0: 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54  one of the SQLIT
13c0: 45 5f 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74  E_ error codes t
13d0: 6f 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20 73 75  o.** indicate su
13e0: 63 63 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65  ccess or failure
13f0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
1400: 49 6e 69 74 4f 6e 65 28 73 71 6c 69 74 65 33 20  InitOne(sqlite3 
1410: 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 63 68  *db, int iDb, ch
1420: 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 2c 20 75  ar **pzErrMsg, u
1430: 33 32 20 6d 46 6c 61 67 73 29 7b 0a 20 20 69 6e  32 mFlags){.  in
1440: 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 3b 0a 23  t rc;.  int i;.#
1450: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
1460: 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 20 20  IT_DEPRECATED.  
1470: 69 6e 74 20 73 69 7a 65 3b 0a 23 65 6e 64 69 66  int size;.#endif
1480: 0a 20 20 44 62 20 2a 70 44 62 3b 0a 20 20 63 68  .  Db *pDb;.  ch
1490: 61 72 20 63 6f 6e 73 74 20 2a 61 7a 41 72 67 5b  ar const *azArg[
14a0: 34 5d 3b 0a 20 20 69 6e 74 20 6d 65 74 61 5b 35  4];.  int meta[5
14b0: 5d 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69 6e  ];.  InitData in
14c0: 69 74 44 61 74 61 3b 0a 20 20 63 6f 6e 73 74 20  itData;.  const 
14d0: 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 4e 61 6d  char *zMasterNam
14e0: 65 3b 0a 20 20 69 6e 74 20 6f 70 65 6e 65 64 54  e;.  int openedT
14f0: 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 30 3b 0a  ransaction = 0;.
1500: 0a 20 20 61 73 73 65 72 74 28 20 28 64 62 2d 3e  .  assert( (db->
1510: 6d 44 62 46 6c 61 67 73 20 26 20 44 42 46 4c 41  mDbFlags & DBFLA
1520: 47 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b 29  G_SchemaKnownOk)
1530: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
1540: 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62 3c 64   iDb>=0 && iDb<d
1550: 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 61 73 73 65  b->nDb );.  asse
1560: 72 74 28 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  rt( db->aDb[iDb]
1570: 2e 70 53 63 68 65 6d 61 20 29 3b 0a 20 20 61 73  .pSchema );.  as
1580: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
1590: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
15a0: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ex) );.  assert(
15b0: 20 69 44 62 3d 3d 31 20 7c 7c 20 73 71 6c 69 74   iDb==1 || sqlit
15c0: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65  e3BtreeHoldsMute
15d0: 78 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70  x(db->aDb[iDb].p
15e0: 42 74 29 20 29 3b 0a 0a 20 20 64 62 2d 3e 69 6e  Bt) );..  db->in
15f0: 69 74 2e 62 75 73 79 20 3d 20 31 3b 0a 0a 20 20  it.busy = 1;..  
1600: 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74 68 65  /* Construct the
1610: 20 69 6e 2d 6d 65 6d 6f 72 79 20 72 65 70 72 65   in-memory repre
1620: 73 65 6e 74 61 74 69 6f 6e 20 73 63 68 65 6d 61  sentation schema
1630: 20 74 61 62 6c 65 73 20 28 73 71 6c 69 74 65 5f   tables (sqlite_
1640: 6d 61 73 74 65 72 20 6f 72 0a 20 20 2a 2a 20 73  master or.  ** s
1650: 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65  qlite_temp_maste
1660: 72 29 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74  r) by invoking t
1670: 68 65 20 70 61 72 73 65 72 20 64 69 72 65 63 74  he parser direct
1680: 6c 79 2e 20 20 54 68 65 20 61 70 70 72 6f 70 72  ly.  The appropr
1690: 69 61 74 65 0a 20 20 2a 2a 20 74 61 62 6c 65 20  iate.  ** table 
16a0: 6e 61 6d 65 20 77 69 6c 6c 20 62 65 20 69 6e 73  name will be ins
16b0: 65 72 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61  erted automatica
16c0: 6c 6c 79 20 62 79 20 74 68 65 20 70 61 72 73 65  lly by the parse
16d0: 72 20 73 6f 20 77 65 20 63 61 6e 20 6a 75 73 74  r so we can just
16e0: 0a 20 20 2a 2a 20 75 73 65 20 74 68 65 20 61 62  .  ** use the ab
16f0: 62 72 65 76 69 61 74 69 6f 6e 20 22 78 22 20 68  breviation "x" h
1700: 65 72 65 2e 20 20 54 68 65 20 70 61 72 73 65 72  ere.  The parser
1710: 20 77 69 6c 6c 20 61 6c 73 6f 20 61 75 74 6f 6d   will also autom
1720: 61 74 69 63 61 6c 6c 79 20 74 61 67 0a 20 20 2a  atically tag.  *
1730: 2a 20 74 68 65 20 73 63 68 65 6d 61 20 74 61 62  * the schema tab
1740: 6c 65 20 61 73 20 72 65 61 64 2d 6f 6e 6c 79 2e  le as read-only.
1750: 20 2a 2f 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d   */.  azArg[0] =
1760: 20 7a 4d 61 73 74 65 72 4e 61 6d 65 20 3d 20 53   zMasterName = S
1770: 43 48 45 4d 41 5f 54 41 42 4c 45 28 69 44 62 29  CHEMA_TABLE(iDb)
1780: 3b 0a 20 20 61 7a 41 72 67 5b 31 5d 20 3d 20 22  ;.  azArg[1] = "
1790: 31 22 3b 0a 20 20 61 7a 41 72 67 5b 32 5d 20 3d  1";.  azArg[2] =
17a0: 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20 78   "CREATE TABLE x
17b0: 28 74 79 70 65 20 74 65 78 74 2c 6e 61 6d 65 20  (type text,name 
17c0: 74 65 78 74 2c 74 62 6c 5f 6e 61 6d 65 20 74 65  text,tbl_name te
17d0: 78 74 2c 22 0a 20 20 20 20 20 20 20 20 20 20 20  xt,".           
17e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
17f0: 20 22 72 6f 6f 74 70 61 67 65 20 69 6e 74 2c 73   "rootpage int,s
1800: 71 6c 20 74 65 78 74 29 22 3b 0a 20 20 61 7a 41  ql text)";.  azA
1810: 72 67 5b 33 5d 20 3d 20 30 3b 0a 20 20 69 6e 69  rg[3] = 0;.  ini
1820: 74 44 61 74 61 2e 64 62 20 3d 20 64 62 3b 0a 20  tData.db = db;. 
1830: 20 69 6e 69 74 44 61 74 61 2e 69 44 62 20 3d 20   initData.iDb = 
1840: 69 44 62 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e  iDb;.  initData.
1850: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
1860: 20 20 69 6e 69 74 44 61 74 61 2e 70 7a 45 72 72    initData.pzErr
1870: 4d 73 67 20 3d 20 70 7a 45 72 72 4d 73 67 3b 0a  Msg = pzErrMsg;.
1880: 20 20 69 6e 69 74 44 61 74 61 2e 6d 49 6e 69 74    initData.mInit
1890: 46 6c 61 67 73 20 3d 20 6d 46 6c 61 67 73 3b 0a  Flags = mFlags;.
18a0: 20 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c    sqlite3InitCal
18b0: 6c 62 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c  lback(&initData,
18c0: 20 33 2c 20 28 63 68 61 72 20 2a 2a 29 61 7a 41   3, (char **)azA
18d0: 72 67 2c 20 30 29 3b 0a 20 20 69 66 28 20 69 6e  rg, 0);.  if( in
18e0: 69 74 44 61 74 61 2e 72 63 20 29 7b 0a 20 20 20  itData.rc ){.   
18f0: 20 72 63 20 3d 20 69 6e 69 74 44 61 74 61 2e 72   rc = initData.r
1900: 63 3b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f  c;.    goto erro
1910: 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  r_out;.  }..  /*
1920: 20 43 72 65 61 74 65 20 61 20 63 75 72 73 6f 72   Create a cursor
1930: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 64 61 74   to hold the dat
1940: 61 62 61 73 65 20 6f 70 65 6e 0a 20 20 2a 2f 0a  abase open.  */.
1950: 20 20 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62    pDb = &db->aDb
1960: 5b 69 44 62 5d 3b 0a 20 20 69 66 28 20 70 44 62  [iDb];.  if( pDb
1970: 2d 3e 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20  ->pBt==0 ){.    
1980: 61 73 73 65 72 74 28 20 69 44 62 3d 3d 31 20 29  assert( iDb==1 )
1990: 3b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70 65  ;.    DbSetPrope
19a0: 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53 63  rty(db, 1, DB_Sc
19b0: 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20  hemaLoaded);.   
19c0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
19d0: 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f  .    goto error_
19e0: 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49  out;.  }..  /* I
19f0: 66 20 74 68 65 72 65 20 69 73 20 6e 6f 74 20 61  f there is not a
1a00: 6c 72 65 61 64 79 20 61 20 72 65 61 64 2d 6f 6e  lready a read-on
1a10: 6c 79 20 28 6f 72 20 72 65 61 64 2d 77 72 69 74  ly (or read-writ
1a20: 65 29 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f  e) transaction o
1a30: 70 65 6e 65 64 0a 20 20 2a 2a 20 6f 6e 20 74 68  pened.  ** on th
1a40: 65 20 62 2d 74 72 65 65 20 64 61 74 61 62 61 73  e b-tree databas
1a50: 65 2c 20 6f 70 65 6e 20 6f 6e 65 20 6e 6f 77 2e  e, open one now.
1a60: 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   If a transactio
1a70: 6e 20 69 73 20 6f 70 65 6e 65 64 2c 20 69 74 20  n is opened, it 
1a80: 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 63 6c  .  ** will be cl
1a90: 6f 73 65 64 20 62 65 66 6f 72 65 20 74 68 69 73  osed before this
1aa0: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e   function return
1ab0: 73 2e 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  s.  */.  sqlite3
1ac0: 42 74 72 65 65 45 6e 74 65 72 28 70 44 62 2d 3e  BtreeEnter(pDb->
1ad0: 70 42 74 29 3b 0a 20 20 69 66 28 20 21 73 71 6c  pBt);.  if( !sql
1ae0: 69 74 65 33 42 74 72 65 65 49 73 49 6e 52 65 61  ite3BtreeIsInRea
1af0: 64 54 72 61 6e 73 28 70 44 62 2d 3e 70 42 74 29  dTrans(pDb->pBt)
1b00: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
1b10: 69 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 72  ite3BtreeBeginTr
1b20: 61 6e 73 28 70 44 62 2d 3e 70 42 74 2c 20 30 2c  ans(pDb->pBt, 0,
1b30: 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21   0);.    if( rc!
1b40: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
1b50: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
1b60: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64  ring(pzErrMsg, d
1b70: 62 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 72  b, sqlite3ErrStr
1b80: 28 72 63 29 29 3b 0a 20 20 20 20 20 20 67 6f 74  (rc));.      got
1b90: 6f 20 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f  o initone_error_
1ba0: 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6f  out;.    }.    o
1bb0: 70 65 6e 65 64 54 72 61 6e 73 61 63 74 69 6f 6e  penedTransaction
1bc0: 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20   = 1;.  }..  /* 
1bd0: 47 65 74 20 74 68 65 20 64 61 74 61 62 61 73 65  Get the database
1be0: 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f   meta informatio
1bf0: 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4d 65 74  n..  **.  ** Met
1c00: 61 20 76 61 6c 75 65 73 20 61 72 65 20 61 73 20  a values are as 
1c10: 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a 20 20 20  follows:.  **   
1c20: 20 6d 65 74 61 5b 30 5d 20 20 20 53 63 68 65 6d   meta[0]   Schem
1c30: 61 20 63 6f 6f 6b 69 65 2e 20 20 43 68 61 6e 67  a cookie.  Chang
1c40: 65 73 20 77 69 74 68 20 65 61 63 68 20 73 63 68  es with each sch
1c50: 65 6d 61 20 63 68 61 6e 67 65 2e 0a 20 20 2a 2a  ema change..  **
1c60: 20 20 20 20 6d 65 74 61 5b 31 5d 20 20 20 46 69      meta[1]   Fi
1c70: 6c 65 20 66 6f 72 6d 61 74 20 6f 66 20 73 63 68  le format of sch
1c80: 65 6d 61 20 6c 61 79 65 72 2e 0a 20 20 2a 2a 20  ema layer..  ** 
1c90: 20 20 20 6d 65 74 61 5b 32 5d 20 20 20 53 69 7a     meta[2]   Siz
1ca0: 65 20 6f 66 20 74 68 65 20 70 61 67 65 20 63 61  e of the page ca
1cb0: 63 68 65 2e 0a 20 20 2a 2a 20 20 20 20 6d 65 74  che..  **    met
1cc0: 61 5b 33 5d 20 20 20 4c 61 72 67 65 73 74 20 72  a[3]   Largest r
1cd0: 6f 6f 74 70 61 67 65 20 28 61 75 74 6f 2f 69 6e  ootpage (auto/in
1ce0: 63 72 5f 76 61 63 75 75 6d 20 6d 6f 64 65 29 0a  cr_vacuum mode).
1cf0: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34 5d 20    **    meta[4] 
1d00: 20 20 44 62 20 74 65 78 74 20 65 6e 63 6f 64 69    Db text encodi
1d10: 6e 67 2e 20 31 3a 55 54 46 2d 38 20 32 3a 55 54  ng. 1:UTF-8 2:UT
1d20: 46 2d 31 36 4c 45 20 33 3a 55 54 46 2d 31 36 42  F-16LE 3:UTF-16B
1d30: 45 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 35  E.  **    meta[5
1d40: 5d 20 20 20 55 73 65 72 20 76 65 72 73 69 6f 6e  ]   User version
1d50: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 36 5d  .  **    meta[6]
1d60: 20 20 20 49 6e 63 72 65 6d 65 6e 74 61 6c 20 76     Incremental v
1d70: 61 63 75 75 6d 20 6d 6f 64 65 0a 20 20 2a 2a 20  acuum mode.  ** 
1d80: 20 20 20 6d 65 74 61 5b 37 5d 20 20 20 75 6e 75     meta[7]   unu
1d90: 73 65 64 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61  sed.  **    meta
1da0: 5b 38 5d 20 20 20 75 6e 75 73 65 64 0a 20 20 2a  [8]   unused.  *
1db0: 2a 20 20 20 20 6d 65 74 61 5b 39 5d 20 20 20 75  *    meta[9]   u
1dc0: 6e 75 73 65 64 0a 20 20 2a 2a 0a 20 20 2a 2a 20  nused.  **.  ** 
1dd0: 4e 6f 74 65 3a 20 54 68 65 20 23 64 65 66 69 6e  Note: The #defin
1de0: 65 64 20 53 51 4c 49 54 45 5f 55 54 46 2a 20 73  ed SQLITE_UTF* s
1df0: 79 6d 62 6f 6c 73 20 69 6e 20 73 71 6c 69 74 65  ymbols in sqlite
1e00: 49 6e 74 2e 68 20 63 6f 72 72 65 73 70 6f 6e 64  Int.h correspond
1e10: 20 74 6f 0a 20 20 2a 2a 20 74 68 65 20 70 6f 73   to.  ** the pos
1e20: 73 69 62 6c 65 20 76 61 6c 75 65 73 20 6f 66 20  sible values of 
1e30: 6d 65 74 61 5b 34 5d 2e 0a 20 20 2a 2f 0a 20 20  meta[4]..  */.  
1e40: 66 6f 72 28 69 3d 30 3b 20 69 3c 41 72 72 61 79  for(i=0; i<Array
1e50: 53 69 7a 65 28 6d 65 74 61 29 3b 20 69 2b 2b 29  Size(meta); i++)
1e60: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72  {.    sqlite3Btr
1e70: 65 65 47 65 74 4d 65 74 61 28 70 44 62 2d 3e 70  eeGetMeta(pDb->p
1e80: 42 74 2c 20 69 2b 31 2c 20 28 75 33 32 20 2a 29  Bt, i+1, (u32 *)
1e90: 26 6d 65 74 61 5b 69 5d 29 3b 0a 20 20 7d 0a 20  &meta[i]);.  }. 
1ea0: 20 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 20   if( (db->flags 
1eb0: 26 20 53 51 4c 49 54 45 5f 52 65 73 65 74 44 61  & SQLITE_ResetDa
1ec0: 74 61 62 61 73 65 29 21 3d 30 20 29 7b 0a 20 20  tabase)!=0 ){.  
1ed0: 20 20 6d 65 6d 73 65 74 28 6d 65 74 61 2c 20 30    memset(meta, 0
1ee0: 2c 20 73 69 7a 65 6f 66 28 6d 65 74 61 29 29 3b  , sizeof(meta));
1ef0: 0a 20 20 7d 0a 20 20 70 44 62 2d 3e 70 53 63 68  .  }.  pDb->pSch
1f00: 65 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b  ema->schema_cook
1f10: 69 65 20 3d 20 6d 65 74 61 5b 42 54 52 45 45 5f  ie = meta[BTREE_
1f20: 53 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 2d 31  SCHEMA_VERSION-1
1f30: 5d 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 70 65 6e  ];..  /* If open
1f40: 69 6e 67 20 61 20 6e 6f 6e 2d 65 6d 70 74 79 20  ing a non-empty 
1f50: 64 61 74 61 62 61 73 65 2c 20 63 68 65 63 6b 20  database, check 
1f60: 74 68 65 20 74 65 78 74 20 65 6e 63 6f 64 69 6e  the text encodin
1f70: 67 2e 20 46 6f 72 20 74 68 65 0a 20 20 2a 2a 20  g. For the.  ** 
1f80: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2c 20 73  main database, s
1f90: 65 74 20 73 71 6c 69 74 65 33 2e 65 6e 63 20 74  et sqlite3.enc t
1fa0: 6f 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f  o the encoding o
1fb0: 66 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62  f the main datab
1fc0: 61 73 65 2e 0a 20 20 2a 2a 20 46 6f 72 20 61 6e  ase..  ** For an
1fd0: 20 61 74 74 61 63 68 65 64 20 64 62 2c 20 69 74   attached db, it
1fe0: 20 69 73 20 61 6e 20 65 72 72 6f 72 20 69 66 20   is an error if 
1ff0: 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 73 20  the encoding is 
2000: 6e 6f 74 20 74 68 65 20 73 61 6d 65 0a 20 20 2a  not the same.  *
2010: 2a 20 61 73 20 73 71 6c 69 74 65 33 2e 65 6e 63  * as sqlite3.enc
2020: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6d 65 74  ..  */.  if( met
2030: 61 5b 42 54 52 45 45 5f 54 45 58 54 5f 45 4e 43  a[BTREE_TEXT_ENC
2040: 4f 44 49 4e 47 2d 31 5d 20 29 7b 20 20 2f 2a 20  ODING-1] ){  /* 
2050: 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 2a 2f  text encoding */
2060: 0a 20 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20  .    if( iDb==0 
2070: 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  ){.#ifndef SQLIT
2080: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 20  E_OMIT_UTF16.   
2090: 20 20 20 75 38 20 65 6e 63 6f 64 69 6e 67 3b 0a     u8 encoding;.
20a0: 20 20 20 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e        /* If open
20b0: 69 6e 67 20 74 68 65 20 6d 61 69 6e 20 64 61 74  ing the main dat
20c0: 61 62 61 73 65 2c 20 73 65 74 20 45 4e 43 28 64  abase, set ENC(d
20d0: 62 29 2e 20 2a 2f 0a 20 20 20 20 20 20 65 6e 63  b). */.      enc
20e0: 6f 64 69 6e 67 20 3d 20 28 75 38 29 6d 65 74 61  oding = (u8)meta
20f0: 5b 42 54 52 45 45 5f 54 45 58 54 5f 45 4e 43 4f  [BTREE_TEXT_ENCO
2100: 44 49 4e 47 2d 31 5d 20 26 20 33 3b 0a 20 20 20  DING-1] & 3;.   
2110: 20 20 20 69 66 28 20 65 6e 63 6f 64 69 6e 67 3d     if( encoding=
2120: 3d 30 20 29 20 65 6e 63 6f 64 69 6e 67 20 3d 20  =0 ) encoding = 
2130: 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20 20  SQLITE_UTF8;.   
2140: 20 20 20 45 4e 43 28 64 62 29 20 3d 20 65 6e 63     ENC(db) = enc
2150: 6f 64 69 6e 67 3b 0a 23 65 6c 73 65 0a 20 20 20  oding;.#else.   
2160: 20 20 20 45 4e 43 28 64 62 29 20 3d 20 53 51 4c     ENC(db) = SQL
2170: 49 54 45 5f 55 54 46 38 3b 0a 23 65 6e 64 69 66  ITE_UTF8;.#endif
2180: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
2190: 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20    /* If opening 
21a0: 61 6e 20 61 74 74 61 63 68 65 64 20 64 61 74 61  an attached data
21b0: 62 61 73 65 2c 20 74 68 65 20 65 6e 63 6f 64 69  base, the encodi
21c0: 6e 67 20 6d 75 63 68 20 6d 61 74 63 68 20 45 4e  ng much match EN
21d0: 43 28 64 62 29 20 2a 2f 0a 20 20 20 20 20 20 69  C(db) */.      i
21e0: 66 28 20 6d 65 74 61 5b 42 54 52 45 45 5f 54 45  f( meta[BTREE_TE
21f0: 58 54 5f 45 4e 43 4f 44 49 4e 47 2d 31 5d 21 3d  XT_ENCODING-1]!=
2200: 45 4e 43 28 64 62 29 20 29 7b 0a 20 20 20 20 20  ENC(db) ){.     
2210: 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72     sqlite3SetStr
2220: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64 62  ing(pzErrMsg, db
2230: 2c 20 22 61 74 74 61 63 68 65 64 20 64 61 74 61  , "attached data
2240: 62 61 73 65 73 20 6d 75 73 74 20 75 73 65 20 74  bases must use t
2250: 68 65 20 73 61 6d 65 22 0a 20 20 20 20 20 20 20  he same".       
2260: 20 20 20 20 20 22 20 74 65 78 74 20 65 6e 63 6f       " text enco
2270: 64 69 6e 67 20 61 73 20 6d 61 69 6e 20 64 61 74  ding as main dat
2280: 61 62 61 73 65 22 29 3b 0a 20 20 20 20 20 20 20  abase");.       
2290: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
22a0: 4f 52 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f  OR;.        goto
22b0: 20 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f   initone_error_o
22c0: 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ut;.      }.    
22d0: 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 44  }.  }else{.    D
22e0: 62 53 65 74 50 72 6f 70 65 72 74 79 28 64 62 2c  bSetProperty(db,
22f0: 20 69 44 62 2c 20 44 42 5f 45 6d 70 74 79 29 3b   iDb, DB_Empty);
2300: 0a 20 20 7d 0a 20 20 70 44 62 2d 3e 70 53 63 68  .  }.  pDb->pSch
2310: 65 6d 61 2d 3e 65 6e 63 20 3d 20 45 4e 43 28 64  ema->enc = ENC(d
2320: 62 29 3b 0a 0a 20 20 69 66 28 20 70 44 62 2d 3e  b);..  if( pDb->
2330: 70 53 63 68 65 6d 61 2d 3e 63 61 63 68 65 5f 73  pSchema->cache_s
2340: 69 7a 65 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65  ize==0 ){.#ifnde
2350: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45  f SQLITE_OMIT_DE
2360: 50 52 45 43 41 54 45 44 0a 20 20 20 20 73 69 7a  PRECATED.    siz
2370: 65 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e  e = sqlite3AbsIn
2380: 74 33 32 28 6d 65 74 61 5b 42 54 52 45 45 5f 44  t32(meta[BTREE_D
2390: 45 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a  EFAULT_CACHE_SIZ
23a0: 45 2d 31 5d 29 3b 0a 20 20 20 20 69 66 28 20 73  E-1]);.    if( s
23b0: 69 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d  ize==0 ){ size =
23c0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f   SQLITE_DEFAULT_
23d0: 43 41 43 48 45 5f 53 49 5a 45 3b 20 7d 0a 20 20  CACHE_SIZE; }.  
23e0: 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e    pDb->pSchema->
23f0: 63 61 63 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a  cache_size = siz
2400: 65 3b 0a 23 65 6c 73 65 0a 20 20 20 20 70 44 62  e;.#else.    pDb
2410: 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61 63 68 65  ->pSchema->cache
2420: 5f 73 69 7a 65 20 3d 20 53 51 4c 49 54 45 5f 44  _size = SQLITE_D
2430: 45 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a  EFAULT_CACHE_SIZ
2440: 45 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71  E;.#endif.    sq
2450: 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 61 63  lite3BtreeSetCac
2460: 68 65 53 69 7a 65 28 70 44 62 2d 3e 70 42 74 2c  heSize(pDb->pBt,
2470: 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63   pDb->pSchema->c
2480: 61 63 68 65 5f 73 69 7a 65 29 3b 0a 20 20 7d 0a  ache_size);.  }.
2490: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 66 69 6c 65 5f  .  /*.  ** file_
24a0: 66 6f 72 6d 61 74 3d 3d 31 20 20 20 20 56 65 72  format==1    Ver
24b0: 73 69 6f 6e 20 33 2e 30 2e 30 2e 0a 20 20 2a 2a  sion 3.0.0..  **
24c0: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 32 20   file_format==2 
24d0: 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 31 2e 33     Version 3.1.3
24e0: 2e 20 20 2f 2f 20 41 4c 54 45 52 20 54 41 42 4c  .  // ALTER TABL
24f0: 45 20 41 44 44 20 43 4f 4c 55 4d 4e 0a 20 20 2a  E ADD COLUMN.  *
2500: 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 33  * file_format==3
2510: 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 31 2e      Version 3.1.
2520: 34 2e 20 20 2f 2f 20 64 69 74 74 6f 20 62 75 74  4.  // ditto but
2530: 20 77 69 74 68 20 6e 6f 6e 2d 4e 55 4c 4c 20 64   with non-NULL d
2540: 65 66 61 75 6c 74 73 0a 20 20 2a 2a 20 66 69 6c  efaults.  ** fil
2550: 65 5f 66 6f 72 6d 61 74 3d 3d 34 20 20 20 20 56  e_format==4    V
2560: 65 72 73 69 6f 6e 20 33 2e 33 2e 30 2e 20 20 2f  ersion 3.3.0.  /
2570: 2f 20 44 45 53 43 20 69 6e 64 69 63 65 73 2e 20  / DESC indices. 
2580: 20 42 6f 6f 6c 65 61 6e 20 63 6f 6e 73 74 61 6e   Boolean constan
2590: 74 73 0a 20 20 2a 2f 0a 20 20 70 44 62 2d 3e 70  ts.  */.  pDb->p
25a0: 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72  Schema->file_for
25b0: 6d 61 74 20 3d 20 28 75 38 29 6d 65 74 61 5b 42  mat = (u8)meta[B
25c0: 54 52 45 45 5f 46 49 4c 45 5f 46 4f 52 4d 41 54  TREE_FILE_FORMAT
25d0: 2d 31 5d 3b 0a 20 20 69 66 28 20 70 44 62 2d 3e  -1];.  if( pDb->
25e0: 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f  pSchema->file_fo
25f0: 72 6d 61 74 3d 3d 30 20 29 7b 0a 20 20 20 20 70  rmat==0 ){.    p
2600: 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c  Db->pSchema->fil
2610: 65 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a 20 20  e_format = 1;.  
2620: 7d 0a 20 20 69 66 28 20 70 44 62 2d 3e 70 53 63  }.  if( pDb->pSc
2630: 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61  hema->file_forma
2640: 74 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 46 49 4c  t>SQLITE_MAX_FIL
2650: 45 5f 46 4f 52 4d 41 54 20 29 7b 0a 20 20 20 20  E_FORMAT ){.    
2660: 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67  sqlite3SetString
2670: 28 70 7a 45 72 72 4d 73 67 2c 20 64 62 2c 20 22  (pzErrMsg, db, "
2680: 75 6e 73 75 70 70 6f 72 74 65 64 20 66 69 6c 65  unsupported file
2690: 20 66 6f 72 6d 61 74 22 29 3b 0a 20 20 20 20 72   format");.    r
26a0: 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  c = SQLITE_ERROR
26b0: 3b 0a 20 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f  ;.    goto inito
26c0: 6e 65 5f 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20  ne_error_out;.  
26d0: 7d 0a 0a 20 20 2f 2a 20 54 69 63 6b 65 74 20 23  }..  /* Ticket #
26e0: 32 38 30 34 3a 20 20 57 68 65 6e 20 77 65 20 6f  2804:  When we o
26f0: 70 65 6e 20 61 20 64 61 74 61 62 61 73 65 20 69  pen a database i
2700: 6e 20 74 68 65 20 6e 65 77 65 72 20 66 69 6c 65  n the newer file
2710: 20 66 6f 72 6d 61 74 2c 0a 20 20 2a 2a 20 63 6c   format,.  ** cl
2720: 65 61 72 20 74 68 65 20 6c 65 67 61 63 79 5f 66  ear the legacy_f
2730: 69 6c 65 5f 66 6f 72 6d 61 74 20 70 72 61 67 6d  ile_format pragm
2740: 61 20 66 6c 61 67 20 73 6f 20 74 68 61 74 20 61  a flag so that a
2750: 20 56 41 43 55 55 4d 20 77 69 6c 6c 0a 20 20 2a   VACUUM will.  *
2760: 2a 20 6e 6f 74 20 64 6f 77 6e 67 72 61 64 65 20  * not downgrade 
2770: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64  the database and
2780: 20 74 68 75 73 20 69 6e 76 61 6c 69 64 61 74 65   thus invalidate
2790: 20 61 6e 79 20 64 65 73 63 65 6e 64 69 6e 67 0a   any descending.
27a0: 20 20 2a 2a 20 69 6e 64 69 63 65 73 20 74 68 61    ** indices tha
27b0: 74 20 74 68 65 20 75 73 65 72 20 6d 69 67 68 74  t the user might
27c0: 20 68 61 76 65 20 63 72 65 61 74 65 64 2e 0a 20   have created.. 
27d0: 20 2a 2f 0a 20 20 69 66 28 20 69 44 62 3d 3d 30   */.  if( iDb==0
27e0: 20 26 26 20 6d 65 74 61 5b 42 54 52 45 45 5f 46   && meta[BTREE_F
27f0: 49 4c 45 5f 46 4f 52 4d 41 54 2d 31 5d 3e 3d 34  ILE_FORMAT-1]>=4
2800: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67   ){.    db->flag
2810: 73 20 26 3d 20 7e 28 75 36 34 29 53 51 4c 49 54  s &= ~(u64)SQLIT
2820: 45 5f 4c 65 67 61 63 79 46 69 6c 65 46 6d 74 3b  E_LegacyFileFmt;
2830: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 61 64 20  .  }..  /* Read 
2840: 74 68 65 20 73 63 68 65 6d 61 20 69 6e 66 6f 72  the schema infor
2850: 6d 61 74 69 6f 6e 20 6f 75 74 20 6f 66 20 74 68  mation out of th
2860: 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 0a  e schema tables.
2870: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 64    */.  assert( d
2880: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a  b->init.busy );.
2890: 20 20 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53    {.    char *zS
28a0: 71 6c 3b 0a 20 20 20 20 7a 53 71 6c 20 3d 20 73  ql;.    zSql = s
28b0: 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62  qlite3MPrintf(db
28c0: 2c 20 0a 20 20 20 20 20 20 20 20 22 53 45 4c 45  , .        "SELE
28d0: 43 54 20 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67  CT name, rootpag
28e0: 65 2c 20 73 71 6c 20 46 52 4f 4d 20 5c 22 25 77  e, sql FROM \"%w
28f0: 5c 22 2e 25 73 20 4f 52 44 45 52 20 42 59 20 72  \".%s ORDER BY r
2900: 6f 77 69 64 22 2c 0a 20 20 20 20 20 20 20 20 64  owid",.        d
2910: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 44 62 53  b->aDb[iDb].zDbS
2920: 4e 61 6d 65 2c 20 7a 4d 61 73 74 65 72 4e 61 6d  Name, zMasterNam
2930: 65 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  e);.#ifndef SQLI
2940: 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a  TE_OMIT_AUTHORIZ
2950: 41 54 49 4f 4e 0a 20 20 20 20 7b 0a 20 20 20 20  ATION.    {.    
2960: 20 20 73 71 6c 69 74 65 33 5f 78 61 75 74 68 20    sqlite3_xauth 
2970: 78 41 75 74 68 3b 0a 20 20 20 20 20 20 78 41 75  xAuth;.      xAu
2980: 74 68 20 3d 20 64 62 2d 3e 78 41 75 74 68 3b 0a  th = db->xAuth;.
2990: 20 20 20 20 20 20 64 62 2d 3e 78 41 75 74 68 20        db->xAuth 
29a0: 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  = 0;.#endif.    
29b0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65    rc = sqlite3_e
29c0: 78 65 63 28 64 62 2c 20 7a 53 71 6c 2c 20 73 71  xec(db, zSql, sq
29d0: 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63  lite3InitCallbac
29e0: 6b 2c 20 26 69 6e 69 74 44 61 74 61 2c 20 30 29  k, &initData, 0)
29f0: 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ;.#ifndef SQLITE
2a00: 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54  _OMIT_AUTHORIZAT
2a10: 49 4f 4e 0a 20 20 20 20 20 20 64 62 2d 3e 78 41  ION.      db->xA
2a20: 75 74 68 20 3d 20 78 41 75 74 68 3b 0a 20 20 20  uth = xAuth;.   
2a30: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66   }.#endif.    if
2a40: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
2a50: 29 20 72 63 20 3d 20 69 6e 69 74 44 61 74 61 2e  ) rc = initData.
2a60: 72 63 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44  rc;.    sqlite3D
2a70: 62 46 72 65 65 28 64 62 2c 20 7a 53 71 6c 29 3b  bFree(db, zSql);
2a80: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
2a90: 4f 4d 49 54 5f 41 4e 41 4c 59 5a 45 0a 20 20 20  OMIT_ANALYZE.   
2aa0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
2ab0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  OK ){.      sqli
2ac0: 74 65 33 41 6e 61 6c 79 73 69 73 4c 6f 61 64 28  te3AnalysisLoad(
2ad0: 64 62 2c 20 69 44 62 29 3b 0a 20 20 20 20 7d 0a  db, iDb);.    }.
2ae0: 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 69 66 28  #endif.  }.  if(
2af0: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65   db->mallocFaile
2b00: 64 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51  d ){.    rc = SQ
2b10: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b  LITE_NOMEM_BKPT;
2b20: 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65  .    sqlite3Rese
2b30: 74 41 6c 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e  tAllSchemasOfCon
2b40: 6e 65 63 74 69 6f 6e 28 64 62 29 3b 0a 20 20 7d  nection(db);.  }
2b50: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
2b60: 45 5f 4f 4b 20 7c 7c 20 28 64 62 2d 3e 66 6c 61  E_OK || (db->fla
2b70: 67 73 26 53 51 4c 49 54 45 5f 4e 6f 53 63 68 65  gs&SQLITE_NoSche
2b80: 6d 61 45 72 72 6f 72 29 29 7b 0a 20 20 20 20 2f  maError)){.    /
2b90: 2a 20 42 6c 61 63 6b 20 6d 61 67 69 63 3a 20 49  * Black magic: I
2ba0: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 4e 6f 53  f the SQLITE_NoS
2bb0: 63 68 65 6d 61 45 72 72 6f 72 20 66 6c 61 67 20  chemaError flag 
2bc0: 69 73 20 73 65 74 2c 20 74 68 65 6e 20 63 6f 6e  is set, then con
2bd0: 73 69 64 65 72 0a 20 20 20 20 2a 2a 20 74 68 65  sider.    ** the
2be0: 20 73 63 68 65 6d 61 20 6c 6f 61 64 65 64 2c 20   schema loaded, 
2bf0: 65 76 65 6e 20 69 66 20 65 72 72 6f 72 73 20 6f  even if errors o
2c00: 63 63 75 72 72 65 64 2e 20 49 6e 20 74 68 69 73  ccurred. In this
2c10: 20 73 69 74 75 61 74 69 6f 6e 20 74 68 65 20 0a   situation the .
2c20: 20 20 20 20 2a 2a 20 63 75 72 72 65 6e 74 20 73      ** current s
2c30: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29  qlite3_prepare()
2c40: 20 6f 70 65 72 61 74 69 6f 6e 20 77 69 6c 6c 20   operation will 
2c50: 66 61 69 6c 2c 20 62 75 74 20 74 68 65 20 66 6f  fail, but the fo
2c60: 6c 6c 6f 77 69 6e 67 20 6f 6e 65 0a 20 20 20 20  llowing one.    
2c70: 2a 2a 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 20  ** will attempt 
2c80: 74 6f 20 63 6f 6d 70 69 6c 65 20 74 68 65 20 73  to compile the s
2c90: 75 70 70 6c 69 65 64 20 73 74 61 74 65 6d 65 6e  upplied statemen
2ca0: 74 20 61 67 61 69 6e 73 74 20 77 68 61 74 65 76  t against whatev
2cb0: 65 72 20 73 75 62 73 65 74 0a 20 20 20 20 2a 2a  er subset.    **
2cc0: 20 6f 66 20 74 68 65 20 73 63 68 65 6d 61 20 77   of the schema w
2cd0: 61 73 20 6c 6f 61 64 65 64 20 62 65 66 6f 72 65  as loaded before
2ce0: 20 74 68 65 20 65 72 72 6f 72 20 6f 63 63 75 72   the error occur
2cf0: 72 65 64 2e 20 54 68 65 20 70 72 69 6d 61 72 79  red. The primary
2d00: 0a 20 20 20 20 2a 2a 20 70 75 72 70 6f 73 65 20  .    ** purpose 
2d10: 6f 66 20 74 68 69 73 20 69 73 20 74 6f 20 61 6c  of this is to al
2d20: 6c 6f 77 20 61 63 63 65 73 73 20 74 6f 20 74 68  low access to th
2d30: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  e sqlite_master 
2d40: 74 61 62 6c 65 0a 20 20 20 20 2a 2a 20 65 76 65  table.    ** eve
2d50: 6e 20 77 68 65 6e 20 69 74 73 20 63 6f 6e 74 65  n when its conte
2d60: 6e 74 73 20 68 61 76 65 20 62 65 65 6e 20 63 6f  nts have been co
2d70: 72 72 75 70 74 65 64 2e 0a 20 20 20 20 2a 2f 0a  rrupted..    */.
2d80: 20 20 20 20 44 62 53 65 74 50 72 6f 70 65 72 74      DbSetPropert
2d90: 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f 53 63  y(db, iDb, DB_Sc
2da0: 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20  hemaLoaded);.   
2db0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
2dc0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20  .  }..  /* Jump 
2dd0: 68 65 72 65 20 66 6f 72 20 61 6e 20 65 72 72 6f  here for an erro
2de0: 72 20 74 68 61 74 20 6f 63 63 75 72 73 20 61 66  r that occurs af
2df0: 74 65 72 20 73 75 63 63 65 73 73 66 75 6c 6c 79  ter successfully
2e00: 20 61 6c 6c 6f 63 61 74 69 6e 67 0a 20 20 2a 2a   allocating.  **
2e10: 20 63 75 72 4d 61 69 6e 20 61 6e 64 20 63 61 6c   curMain and cal
2e20: 6c 69 6e 67 20 73 71 6c 69 74 65 33 42 74 72 65  ling sqlite3Btre
2e30: 65 45 6e 74 65 72 28 29 2e 20 46 6f 72 20 61 6e  eEnter(). For an
2e40: 20 65 72 72 6f 72 20 74 68 61 74 20 6f 63 63 75   error that occu
2e50: 72 73 0a 20 20 2a 2a 20 62 65 66 6f 72 65 20 74  rs.  ** before t
2e60: 68 61 74 20 70 6f 69 6e 74 2c 20 6a 75 6d 70 20  hat point, jump 
2e70: 74 6f 20 65 72 72 6f 72 5f 6f 75 74 2e 0a 20 20  to error_out..  
2e80: 2a 2f 0a 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72  */.initone_error
2e90: 5f 6f 75 74 3a 0a 20 20 69 66 28 20 6f 70 65 6e  _out:.  if( open
2ea0: 65 64 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 7b  edTransaction ){
2eb0: 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65  .    sqlite3Btre
2ec0: 65 43 6f 6d 6d 69 74 28 70 44 62 2d 3e 70 42 74  eCommit(pDb->pBt
2ed0: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  );.  }.  sqlite3
2ee0: 42 74 72 65 65 4c 65 61 76 65 28 70 44 62 2d 3e  BtreeLeave(pDb->
2ef0: 70 42 74 29 3b 0a 0a 65 72 72 6f 72 5f 6f 75 74  pBt);..error_out
2f00: 3a 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20  :.  if( rc ){.  
2f10: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
2f20: 5f 4e 4f 4d 45 4d 20 7c 7c 20 72 63 3d 3d 53 51  _NOMEM || rc==SQ
2f30: 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d  LITE_IOERR_NOMEM
2f40: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
2f50: 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29 3b 0a 20  3OomFault(db);. 
2f60: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33     }.    sqlite3
2f70: 52 65 73 65 74 4f 6e 65 53 63 68 65 6d 61 28 64  ResetOneSchema(d
2f80: 62 2c 20 69 44 62 29 3b 0a 20 20 7d 0a 20 20 64  b, iDb);.  }.  d
2f90: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 3d 20 30  b->init.busy = 0
2fa0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
2fb0: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69  ../*.** Initiali
2fc0: 7a 65 20 61 6c 6c 20 64 61 74 61 62 61 73 65 20  ze all database 
2fd0: 66 69 6c 65 73 20 2d 20 74 68 65 20 6d 61 69 6e  files - the main
2fe0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20   database file, 
2ff0: 74 68 65 20 66 69 6c 65 0a 2a 2a 20 75 73 65 64  the file.** used
3000: 20 74 6f 20 73 74 6f 72 65 20 74 65 6d 70 6f 72   to store tempor
3010: 61 72 79 20 74 61 62 6c 65 73 2c 20 61 6e 64 20  ary tables, and 
3020: 61 6e 79 20 61 64 64 69 74 69 6f 6e 61 6c 20 64  any additional d
3030: 61 74 61 62 61 73 65 20 66 69 6c 65 73 0a 2a 2a  atabase files.**
3040: 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 41   created using A
3050: 54 54 41 43 48 20 73 74 61 74 65 6d 65 6e 74 73  TTACH statements
3060: 2e 20 20 52 65 74 75 72 6e 20 61 20 73 75 63 63  .  Return a succ
3070: 65 73 73 20 63 6f 64 65 2e 20 20 49 66 20 61 6e  ess code.  If an
3080: 0a 2a 2a 20 65 72 72 6f 72 20 6f 63 63 75 72 73  .** error occurs
3090: 2c 20 77 72 69 74 65 20 61 6e 20 65 72 72 6f 72  , write an error
30a0: 20 6d 65 73 73 61 67 65 20 69 6e 74 6f 20 2a 70   message into *p
30b0: 7a 45 72 72 4d 73 67 2e 0a 2a 2a 0a 2a 2a 20 41  zErrMsg..**.** A
30c0: 66 74 65 72 20 61 20 64 61 74 61 62 61 73 65 20  fter a database 
30d0: 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20  is initialized, 
30e0: 74 68 65 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61  the DB_SchemaLoa
30f0: 64 65 64 20 62 69 74 20 69 73 20 73 65 74 0a 2a  ded bit is set.*
3100: 2a 20 62 69 74 20 69 73 20 73 65 74 20 69 6e 20  * bit is set in 
3110: 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20  the flags field 
3120: 6f 66 20 74 68 65 20 44 62 20 73 74 72 75 63 74  of the Db struct
3130: 75 72 65 2e 20 49 66 20 74 68 65 20 64 61 74 61  ure. If the data
3140: 62 61 73 65 0a 2a 2a 20 66 69 6c 65 20 77 61 73  base.** file was
3150: 20 6f 66 20 7a 65 72 6f 2d 6c 65 6e 67 74 68 2c   of zero-length,
3160: 20 74 68 65 6e 20 74 68 65 20 44 42 5f 45 6d 70   then the DB_Emp
3170: 74 79 20 66 6c 61 67 20 69 73 20 61 6c 73 6f 20  ty flag is also 
3180: 73 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  set..*/.int sqli
3190: 74 65 33 49 6e 69 74 28 73 71 6c 69 74 65 33 20  te3Init(sqlite3 
31a0: 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72  *db, char **pzEr
31b0: 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20 69 2c 20  rMsg){.  int i, 
31c0: 72 63 3b 0a 20 20 69 6e 74 20 63 6f 6d 6d 69 74  rc;.  int commit
31d0: 5f 69 6e 74 65 72 6e 61 6c 20 3d 20 21 28 64 62  _internal = !(db
31e0: 2d 3e 6d 44 62 46 6c 61 67 73 26 44 42 46 4c 41  ->mDbFlags&DBFLA
31f0: 47 5f 53 63 68 65 6d 61 43 68 61 6e 67 65 29 3b  G_SchemaChange);
3200: 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 73 71  .  .  assert( sq
3210: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
3220: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  (db->mutex) );. 
3230: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3240: 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28  BtreeHoldsMutex(
3250: 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 20  db->aDb[0].pBt) 
3260: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d  );.  assert( db-
3270: 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20 29 3b  >init.busy==0 );
3280: 0a 20 20 45 4e 43 28 64 62 29 20 3d 20 53 43 48  .  ENC(db) = SCH
3290: 45 4d 41 5f 45 4e 43 28 64 62 29 3b 0a 20 20 61  EMA_ENC(db);.  a
32a0: 73 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 3e 30  ssert( db->nDb>0
32b0: 20 29 3b 0a 20 20 2f 2a 20 44 6f 20 74 68 65 20   );.  /* Do the 
32c0: 6d 61 69 6e 20 73 63 68 65 6d 61 20 66 69 72 73  main schema firs
32d0: 74 20 2a 2f 0a 20 20 69 66 28 20 21 44 62 48 61  t */.  if( !DbHa
32e0: 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20 30 2c  sProperty(db, 0,
32f0: 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64   DB_SchemaLoaded
3300: 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71  ) ){.    rc = sq
3310: 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28 64 62 2c  lite3InitOne(db,
3320: 20 30 2c 20 70 7a 45 72 72 4d 73 67 2c 20 30 29   0, pzErrMsg, 0)
3330: 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72  ;.    if( rc ) r
3340: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
3350: 2f 2a 20 41 6c 6c 20 6f 74 68 65 72 20 73 63 68  /* All other sch
3360: 65 6d 61 73 20 61 66 74 65 72 20 74 68 65 20 6d  emas after the m
3370: 61 69 6e 20 73 63 68 65 6d 61 2e 20 54 68 65 20  ain schema. The 
3380: 22 74 65 6d 70 22 20 73 63 68 65 6d 61 20 6d 75  "temp" schema mu
3390: 73 74 20 62 65 20 6c 61 73 74 20 2a 2f 0a 20 20  st be last */.  
33a0: 66 6f 72 28 69 3d 64 62 2d 3e 6e 44 62 2d 31 3b  for(i=db->nDb-1;
33b0: 20 69 3e 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20   i>0; i--){.    
33c0: 61 73 73 65 72 74 28 20 69 3d 3d 31 20 7c 7c 20  assert( i==1 || 
33d0: 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64  sqlite3BtreeHold
33e0: 73 4d 75 74 65 78 28 64 62 2d 3e 61 44 62 5b 69  sMutex(db->aDb[i
33f0: 5d 2e 70 42 74 29 20 29 3b 0a 20 20 20 20 69 66  ].pBt) );.    if
3400: 28 20 21 44 62 48 61 73 50 72 6f 70 65 72 74 79  ( !DbHasProperty
3410: 28 64 62 2c 20 69 2c 20 44 42 5f 53 63 68 65 6d  (db, i, DB_Schem
3420: 61 4c 6f 61 64 65 64 29 20 29 7b 0a 20 20 20 20  aLoaded) ){.    
3430: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e    rc = sqlite3In
3440: 69 74 4f 6e 65 28 64 62 2c 20 69 2c 20 70 7a 45  itOne(db, i, pzE
3450: 72 72 4d 73 67 2c 20 30 29 3b 0a 20 20 20 20 20  rrMsg, 0);.     
3460: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e   if( rc ) return
3470: 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20   rc;.    }.  }. 
3480: 20 69 66 28 20 63 6f 6d 6d 69 74 5f 69 6e 74 65   if( commit_inte
3490: 72 6e 61 6c 20 29 7b 0a 20 20 20 20 73 71 6c 69  rnal ){.    sqli
34a0: 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61  te3CommitInterna
34b0: 6c 43 68 61 6e 67 65 73 28 64 62 29 3b 0a 20 20  lChanges(db);.  
34c0: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  }.  return SQLIT
34d0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  E_OK;.}../*.** T
34e0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61  his routine is a
34f0: 20 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 64 61   no-op if the da
3500: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 73  tabase schema is
3510: 20 61 6c 72 65 61 64 79 20 69 6e 69 74 69 61 6c   already initial
3520: 69 7a 65 64 2e 0a 2a 2a 20 4f 74 68 65 72 77 69  ized..** Otherwi
3530: 73 65 2c 20 74 68 65 20 73 63 68 65 6d 61 20 69  se, the schema i
3540: 73 20 6c 6f 61 64 65 64 2e 20 41 6e 20 65 72 72  s loaded. An err
3550: 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72  or code is retur
3560: 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ned..*/.int sqli
3570: 74 65 33 52 65 61 64 53 63 68 65 6d 61 28 50 61  te3ReadSchema(Pa
3580: 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20 20  rse *pParse){.  
3590: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
35a0: 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  OK;.  sqlite3 *d
35b0: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a  b = pParse->db;.
35c0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
35d0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d  3_mutex_held(db-
35e0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28  >mutex) );.  if(
35f0: 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20   !db->init.busy 
3600: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  ){.    rc = sqli
3610: 74 65 33 49 6e 69 74 28 64 62 2c 20 26 70 50 61  te3Init(db, &pPa
3620: 72 73 65 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20  rse->zErrMsg);. 
3630: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
3640: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50  E_OK ){.      pP
3650: 61 72 73 65 2d 3e 72 63 20 3d 20 72 63 3b 0a 20  arse->rc = rc;. 
3660: 20 20 20 20 20 70 50 61 72 73 65 2d 3e 6e 45 72       pParse->nEr
3670: 72 2b 2b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69  r++;.    }else i
3680: 66 28 20 64 62 2d 3e 6e 6f 53 68 61 72 65 64 43  f( db->noSharedC
3690: 61 63 68 65 20 29 7b 0a 20 20 20 20 20 20 64 62  ache ){.      db
36a0: 2d 3e 6d 44 62 46 6c 61 67 73 20 7c 3d 20 44 42  ->mDbFlags |= DB
36b0: 46 4c 41 47 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e  FLAG_SchemaKnown
36c0: 4f 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  Ok;.    }.  }.  
36d0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f  return rc;.}.../
36e0: 2a 0a 2a 2a 20 43 68 65 63 6b 20 73 63 68 65 6d  *.** Check schem
36f0: 61 20 63 6f 6f 6b 69 65 73 20 69 6e 20 61 6c 6c  a cookies in all
3700: 20 64 61 74 61 62 61 73 65 73 2e 20 20 49 66 20   databases.  If 
3710: 61 6e 79 20 63 6f 6f 6b 69 65 20 69 73 20 6f 75  any cookie is ou
3720: 74 0a 2a 2a 20 6f 66 20 64 61 74 65 20 73 65 74  t.** of date set
3730: 20 70 50 61 72 73 65 2d 3e 72 63 20 74 6f 20 53   pParse->rc to S
3740: 51 4c 49 54 45 5f 53 43 48 45 4d 41 2e 20 20 49  QLITE_SCHEMA.  I
3750: 66 20 61 6c 6c 20 73 63 68 65 6d 61 20 63 6f 6f  f all schema coo
3760: 6b 69 65 73 0a 2a 2a 20 6d 61 6b 65 20 6e 6f 20  kies.** make no 
3770: 63 68 61 6e 67 65 73 20 74 6f 20 70 50 61 72 73  changes to pPars
3780: 65 2d 3e 72 63 2e 0a 2a 2f 0a 73 74 61 74 69 63  e->rc..*/.static
3790: 20 76 6f 69 64 20 73 63 68 65 6d 61 49 73 56 61   void schemaIsVa
37a0: 6c 69 64 28 50 61 72 73 65 20 2a 70 50 61 72 73  lid(Parse *pPars
37b0: 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  e){.  sqlite3 *d
37c0: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a  b = pParse->db;.
37d0: 20 20 69 6e 74 20 69 44 62 3b 0a 20 20 69 6e 74    int iDb;.  int
37e0: 20 72 63 3b 0a 20 20 69 6e 74 20 63 6f 6f 6b 69   rc;.  int cooki
37f0: 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50  e;..  assert( pP
3800: 61 72 73 65 2d 3e 63 68 65 63 6b 53 63 68 65 6d  arse->checkSchem
3810: 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73  a );.  assert( s
3820: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
3830: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  d(db->mutex) );.
3840: 20 20 66 6f 72 28 69 44 62 3d 30 3b 20 69 44 62    for(iDb=0; iDb
3850: 3c 64 62 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b 29  <db->nDb; iDb++)
3860: 7b 0a 20 20 20 20 69 6e 74 20 6f 70 65 6e 65 64  {.    int opened
3870: 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 30 3b  Transaction = 0;
3880: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65           /* True
3890: 20 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   if a transactio
38a0: 6e 20 69 73 20 6f 70 65 6e 65 64 20 2a 2f 0a 20  n is opened */. 
38b0: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
38c0: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74  db->aDb[iDb].pBt
38d0: 3b 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 64  ;     /* Btree d
38e0: 61 74 61 62 61 73 65 20 74 6f 20 72 65 61 64 20  atabase to read 
38f0: 63 6f 6f 6b 69 65 20 66 72 6f 6d 20 2a 2f 0a 20  cookie from */. 
3900: 20 20 20 69 66 28 20 70 42 74 3d 3d 30 20 29 20     if( pBt==0 ) 
3910: 63 6f 6e 74 69 6e 75 65 3b 0a 0a 20 20 20 20 2f  continue;..    /
3920: 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f  * If there is no
3930: 74 20 61 6c 72 65 61 64 79 20 61 20 72 65 61 64  t already a read
3940: 2d 6f 6e 6c 79 20 28 6f 72 20 72 65 61 64 2d 77  -only (or read-w
3950: 72 69 74 65 29 20 74 72 61 6e 73 61 63 74 69 6f  rite) transactio
3960: 6e 20 6f 70 65 6e 65 64 0a 20 20 20 20 2a 2a 20  n opened.    ** 
3970: 6f 6e 20 74 68 65 20 62 2d 74 72 65 65 20 64 61  on the b-tree da
3980: 74 61 62 61 73 65 2c 20 6f 70 65 6e 20 6f 6e 65  tabase, open one
3990: 20 6e 6f 77 2e 20 49 66 20 61 20 74 72 61 6e 73   now. If a trans
39a0: 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64  action is opened
39b0: 2c 20 69 74 20 0a 20 20 20 20 2a 2a 20 77 69 6c  , it .    ** wil
39c0: 6c 20 62 65 20 63 6c 6f 73 65 64 20 69 6d 6d 65  l be closed imme
39d0: 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 72 65  diately after re
39e0: 61 64 69 6e 67 20 74 68 65 20 6d 65 74 61 2d 76  ading the meta-v
39f0: 61 6c 75 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28  alue. */.    if(
3a00: 20 21 73 71 6c 69 74 65 33 42 74 72 65 65 49 73   !sqlite3BtreeIs
3a10: 49 6e 52 65 61 64 54 72 61 6e 73 28 70 42 74 29  InReadTrans(pBt)
3a20: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73   ){.      rc = s
3a30: 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 69 6e  qlite3BtreeBegin
3a40: 54 72 61 6e 73 28 70 42 74 2c 20 30 2c 20 30 29  Trans(pBt, 0, 0)
3a50: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d  ;.      if( rc==
3a60: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20  SQLITE_NOMEM || 
3a70: 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52  rc==SQLITE_IOERR
3a80: 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20  _NOMEM ){.      
3a90: 20 20 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c    sqlite3OomFaul
3aa0: 74 28 64 62 29 3b 0a 20 20 20 20 20 20 7d 0a 20  t(db);.      }. 
3ab0: 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c       if( rc!=SQL
3ac0: 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 3b  ITE_OK ) return;
3ad0: 0a 20 20 20 20 20 20 6f 70 65 6e 65 64 54 72 61  .      openedTra
3ae0: 6e 73 61 63 74 69 6f 6e 20 3d 20 31 3b 0a 20 20  nsaction = 1;.  
3af0: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 52 65 61 64    }..    /* Read
3b00: 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b   the schema cook
3b10: 69 65 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61  ie from the data
3b20: 62 61 73 65 2e 20 49 66 20 69 74 20 64 6f 65 73  base. If it does
3b30: 20 6e 6f 74 20 6d 61 74 63 68 20 74 68 65 20 0a   not match the .
3b40: 20 20 20 20 2a 2a 20 76 61 6c 75 65 20 73 74 6f      ** value sto
3b50: 72 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 74  red as part of t
3b60: 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 73 63 68  he in-memory sch
3b70: 65 6d 61 20 72 65 70 72 65 73 65 6e 74 61 74 69  ema representati
3b80: 6f 6e 2c 0a 20 20 20 20 2a 2a 20 73 65 74 20 50  on,.    ** set P
3b90: 61 72 73 65 2e 72 63 20 74 6f 20 53 51 4c 49 54  arse.rc to SQLIT
3ba0: 45 5f 53 43 48 45 4d 41 2e 20 2a 2f 0a 20 20 20  E_SCHEMA. */.   
3bb0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74   sqlite3BtreeGet
3bc0: 4d 65 74 61 28 70 42 74 2c 20 42 54 52 45 45 5f  Meta(pBt, BTREE_
3bd0: 53 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 2c 20  SCHEMA_VERSION, 
3be0: 28 75 33 32 20 2a 29 26 63 6f 6f 6b 69 65 29 3b  (u32 *)&cookie);
3bf0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c  .    assert( sql
3c00: 69 74 65 33 53 63 68 65 6d 61 4d 75 74 65 78 48  ite3SchemaMutexH
3c10: 65 6c 64 28 64 62 2c 20 69 44 62 2c 20 30 29 20  eld(db, iDb, 0) 
3c20: 29 3b 0a 20 20 20 20 69 66 28 20 63 6f 6f 6b 69  );.    if( cooki
3c30: 65 21 3d 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e  e!=db->aDb[iDb].
3c40: 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f  pSchema->schema_
3c50: 63 6f 6f 6b 69 65 20 29 7b 0a 20 20 20 20 20 20  cookie ){.      
3c60: 73 71 6c 69 74 65 33 52 65 73 65 74 4f 6e 65 53  sqlite3ResetOneS
3c70: 63 68 65 6d 61 28 64 62 2c 20 69 44 62 29 3b 0a  chema(db, iDb);.
3c80: 20 20 20 20 20 20 70 50 61 72 73 65 2d 3e 72 63        pParse->rc
3c90: 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41   = SQLITE_SCHEMA
3ca0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20  ;.    }..    /* 
3cb0: 43 6c 6f 73 65 20 74 68 65 20 74 72 61 6e 73 61  Close the transa
3cc0: 63 74 69 6f 6e 2c 20 69 66 20 6f 6e 65 20 77 61  ction, if one wa
3cd0: 73 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 20  s opened. */.   
3ce0: 20 69 66 28 20 6f 70 65 6e 65 64 54 72 61 6e 73   if( openedTrans
3cf0: 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20  action ){.      
3d00: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
3d10: 69 74 28 70 42 74 29 3b 0a 20 20 20 20 7d 0a 20  it(pBt);.    }. 
3d20: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76   }.}../*.** Conv
3d30: 65 72 74 20 61 20 73 63 68 65 6d 61 20 70 6f 69  ert a schema poi
3d40: 6e 74 65 72 20 69 6e 74 6f 20 74 68 65 20 69 44  nter into the iD
3d50: 62 20 69 6e 64 65 78 20 74 68 61 74 20 69 6e 64  b index that ind
3d60: 69 63 61 74 65 73 0a 2a 2a 20 77 68 69 63 68 20  icates.** which 
3d70: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e  database file in
3d80: 20 64 62 2d 3e 61 44 62 5b 5d 20 74 68 65 20 73   db->aDb[] the s
3d90: 63 68 65 6d 61 20 72 65 66 65 72 73 20 74 6f 2e  chema refers to.
3da0: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 73 61  .**.** If the sa
3db0: 6d 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61  me database is a
3dc0: 74 74 61 63 68 65 64 20 6d 6f 72 65 20 74 68 61  ttached more tha
3dd0: 6e 20 6f 6e 63 65 2c 20 74 68 65 20 66 69 72 73  n once, the firs
3de0: 74 0a 2a 2a 20 61 74 74 61 63 68 65 64 20 64 61  t.** attached da
3df0: 74 61 62 61 73 65 20 69 73 20 72 65 74 75 72 6e  tabase is return
3e00: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
3e10: 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 65 78 28  e3SchemaToIndex(
3e20: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 53 63 68  sqlite3 *db, Sch
3e30: 65 6d 61 20 2a 70 53 63 68 65 6d 61 29 7b 0a 20  ema *pSchema){. 
3e40: 20 69 6e 74 20 69 20 3d 20 2d 31 30 30 30 30 30   int i = -100000
3e50: 30 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 53 63 68  0;..  /* If pSch
3e60: 65 6d 61 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65  ema is NULL, the
3e70: 6e 20 72 65 74 75 72 6e 20 2d 31 30 30 30 30 30  n return -100000
3e80: 30 2e 20 54 68 69 73 20 68 61 70 70 65 6e 73 20  0. This happens 
3e90: 77 68 65 6e 20 63 6f 64 65 20 69 6e 20 0a 20 20  when code in .  
3ea0: 2a 2a 20 65 78 70 72 2e 63 20 69 73 20 74 72 79  ** expr.c is try
3eb0: 69 6e 67 20 74 6f 20 72 65 73 6f 6c 76 65 20 61  ing to resolve a
3ec0: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20   reference to a 
3ed0: 74 72 61 6e 73 69 65 6e 74 20 74 61 62 6c 65 20  transient table 
3ee0: 28 69 2e 65 2e 20 6f 6e 65 0a 20 20 2a 2a 20 63  (i.e. one.  ** c
3ef0: 72 65 61 74 65 64 20 62 79 20 61 20 73 75 62 2d  reated by a sub-
3f00: 73 65 6c 65 63 74 29 2e 20 49 6e 20 74 68 69 73  select). In this
3f10: 20 63 61 73 65 20 74 68 65 20 72 65 74 75 72 6e   case the return
3f20: 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 0a   value of this .
3f30: 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 73 68    ** function sh
3f40: 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 75 73  ould never be us
3f50: 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 65  ed..  **.  ** We
3f60: 20 72 65 74 75 72 6e 20 2d 31 30 30 30 30 30 30   return -1000000
3f70: 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20   instead of the 
3f80: 6d 6f 72 65 20 75 73 75 61 6c 20 2d 31 20 73 69  more usual -1 si
3f90: 6d 70 6c 79 20 62 65 63 61 75 73 65 20 75 73 69  mply because usi
3fa0: 6e 67 0a 20 20 2a 2a 20 2d 31 30 30 30 30 30 30  ng.  ** -1000000
3fb0: 20 61 73 20 74 68 65 20 69 6e 63 6f 72 72 65 63   as the incorrec
3fc0: 74 20 69 6e 64 65 78 20 69 6e 74 6f 20 64 62 2d  t index into db-
3fd0: 3e 61 44 62 5b 5d 20 69 73 20 6d 75 63 68 20 0a  >aDb[] is much .
3fe0: 20 20 2a 2a 20 6d 6f 72 65 20 6c 69 6b 65 6c 79    ** more likely
3ff0: 20 74 6f 20 63 61 75 73 65 20 61 20 73 65 67 66   to cause a segf
4000: 61 75 6c 74 20 74 68 61 6e 20 2d 31 20 28 6f 66  ault than -1 (of
4010: 20 63 6f 75 72 73 65 20 74 68 65 72 65 20 61 72   course there ar
4020: 65 20 61 73 73 65 72 74 28 29 0a 20 20 2a 2a 20  e assert().  ** 
4030: 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 6f 2c 20  statements too, 
4040: 62 75 74 20 69 74 20 6e 65 76 65 72 20 68 75 72  but it never hur
4050: 74 73 20 74 6f 20 70 6c 61 79 20 74 68 65 20 6f  ts to play the o
4060: 64 64 73 29 2e 0a 20 20 2a 2f 0a 20 20 61 73 73  dds)..  */.  ass
4070: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
4080: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65  ex_held(db->mute
4090: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 53 63 68  x) );.  if( pSch
40a0: 65 6d 61 20 29 7b 0a 20 20 20 20 66 6f 72 28 69  ema ){.    for(i
40b0: 3d 30 3b 20 31 3b 20 69 2b 2b 29 7b 0a 20 20 20  =0; 1; i++){.   
40c0: 20 20 20 61 73 73 65 72 74 28 20 69 3c 64 62 2d     assert( i<db-
40d0: 3e 6e 44 62 20 29 3b 0a 20 20 20 20 20 20 69 66  >nDb );.      if
40e0: 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 53 63  ( db->aDb[i].pSc
40f0: 68 65 6d 61 3d 3d 70 53 63 68 65 6d 61 20 29 7b  hema==pSchema ){
4100: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
4110: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
4120: 20 20 61 73 73 65 72 74 28 20 69 3e 3d 30 20 26    assert( i>=0 &
4130: 26 20 69 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  & i<db->nDb );. 
4140: 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d   }.  return i;.}
4150: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c  ../*.** Free all
4160: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69   memory allocati
4170: 6f 6e 73 20 69 6e 20 74 68 65 20 70 50 61 72 73  ons in the pPars
4180: 65 20 6f 62 6a 65 63 74 0a 2a 2f 0a 76 6f 69 64  e object.*/.void
4190: 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 65   sqlite3ParserRe
41a0: 73 65 74 28 50 61 72 73 65 20 2a 70 50 61 72 73  set(Parse *pPars
41b0: 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  e){.  sqlite3 *d
41c0: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a  b = pParse->db;.
41d0: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
41e0: 64 62 2c 20 70 50 61 72 73 65 2d 3e 61 4c 61 62  db, pParse->aLab
41f0: 65 6c 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 78  el);.  sqlite3Ex
4200: 70 72 4c 69 73 74 44 65 6c 65 74 65 28 64 62 2c  prListDelete(db,
4210: 20 70 50 61 72 73 65 2d 3e 70 43 6f 6e 73 74 45   pParse->pConstE
4220: 78 70 72 29 3b 0a 20 20 69 66 28 20 64 62 20 29  xpr);.  if( db )
4230: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62  {.    assert( db
4240: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 44 69 73  ->lookaside.bDis
4250: 61 62 6c 65 20 3e 3d 20 70 50 61 72 73 65 2d 3e  able >= pParse->
4260: 64 69 73 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65  disableLookaside
4270: 20 29 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b   );.    db->look
4280: 61 73 69 64 65 2e 62 44 69 73 61 62 6c 65 20 2d  aside.bDisable -
4290: 3d 20 70 50 61 72 73 65 2d 3e 64 69 73 61 62 6c  = pParse->disabl
42a0: 65 4c 6f 6f 6b 61 73 69 64 65 3b 0a 20 20 7d 0a  eLookaside;.  }.
42b0: 20 20 70 50 61 72 73 65 2d 3e 64 69 73 61 62 6c    pParse->disabl
42c0: 65 4c 6f 6f 6b 61 73 69 64 65 20 3d 20 30 3b 0a  eLookaside = 0;.
42d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65  }../*.** Compile
42e0: 20 74 68 65 20 55 54 46 2d 38 20 65 6e 63 6f 64   the UTF-8 encod
42f0: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ed SQL statement
4300: 20 7a 53 71 6c 20 69 6e 74 6f 20 61 20 73 74 61   zSql into a sta
4310: 74 65 6d 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a  tement handle..*
4320: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c  /.static int sql
4330: 69 74 65 33 50 72 65 70 61 72 65 28 0a 20 20 73  ite3Prepare(.  s
4340: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
4350: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61           /* Data
4360: 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a  base handle. */.
4370: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53    const char *zS
4380: 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55  ql,         /* U
4390: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c  TF-8 encoded SQL
43a0: 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20   statement. */. 
43b0: 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20   int nBytes,    
43c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65             /* Le
43d0: 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20  ngth of zSql in 
43e0: 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 33 32 20  bytes. */.  u32 
43f0: 70 72 65 70 46 6c 61 67 73 2c 20 20 20 20 20 20  prepFlags,      
4400: 20 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72        /* Zero or
4410: 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50 52 45   more SQLITE_PRE
4420: 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a  PARE_* flags */.
4430: 20 20 56 64 62 65 20 2a 70 52 65 70 72 65 70 61    Vdbe *pReprepa
4440: 72 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 56  re,         /* V
4450: 4d 20 62 65 69 6e 67 20 72 65 70 72 65 70 61 72  M being reprepar
4460: 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  ed */.  sqlite3_
4470: 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20  stmt **ppStmt,  
4480: 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e    /* OUT: A poin
4490: 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61  ter to the prepa
44a0: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f  red statement */
44b0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a  .  const char **
44c0: 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20  pzTail       /* 
44d0: 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73  OUT: End of pars
44e0: 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a  ed string */.){.
44f0: 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 20    char *zErrMsg 
4500: 3d 20 30 3b 20 20 20 20 20 20 20 20 2f 2a 20 45  = 0;        /* E
4510: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 2a 2f 0a  rror message */.
4520: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
4530: 45 5f 4f 4b 3b 20 20 20 20 20 20 20 2f 2a 20 52  E_OK;       /* R
4540: 65 73 75 6c 74 20 63 6f 64 65 20 2a 2f 0a 20 20  esult code */.  
4550: 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20  int i;          
4560: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f            /* Loo
4570: 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 50  p counter */.  P
4580: 61 72 73 65 20 73 50 61 72 73 65 3b 20 20 20 20  arse sParse;    
4590: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73           /* Pars
45a0: 69 6e 67 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 0a  ing context */..
45b0: 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65    memset(&sParse
45c0: 2c 20 30 2c 20 50 41 52 53 45 5f 48 44 52 5f 53  , 0, PARSE_HDR_S
45d0: 5a 29 3b 0a 20 20 6d 65 6d 73 65 74 28 50 41 52  Z);.  memset(PAR
45e0: 53 45 5f 54 41 49 4c 28 26 73 50 61 72 73 65 29  SE_TAIL(&sParse)
45f0: 2c 20 30 2c 20 50 41 52 53 45 5f 54 41 49 4c 5f  , 0, PARSE_TAIL_
4600: 53 5a 29 3b 0a 20 20 73 50 61 72 73 65 2e 70 52  SZ);.  sParse.pR
4610: 65 70 72 65 70 61 72 65 20 3d 20 70 52 65 70 72  eprepare = pRepr
4620: 65 70 61 72 65 3b 0a 20 20 61 73 73 65 72 74 28  epare;.  assert(
4630: 20 70 70 53 74 6d 74 20 26 26 20 2a 70 70 53 74   ppStmt && *ppSt
4640: 6d 74 3d 3d 30 20 29 3b 0a 20 20 2f 2a 20 61 73  mt==0 );.  /* as
4650: 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f  sert( !db->mallo
4660: 63 46 61 69 6c 65 64 20 29 3b 20 2f 2f 20 6e 6f  cFailed ); // no
4670: 74 20 74 72 75 65 20 77 69 74 68 20 53 51 4c 49  t true with SQLI
4680: 54 45 5f 55 53 45 5f 41 4c 4c 4f 43 41 20 2a 2f  TE_USE_ALLOCA */
4690: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
46a0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62  e3_mutex_held(db
46b0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2f  ->mutex) );..  /
46c0: 2a 20 46 6f 72 20 61 20 6c 6f 6e 67 2d 74 65 72  * For a long-ter
46d0: 6d 20 75 73 65 20 70 72 65 70 61 72 65 64 20 73  m use prepared s
46e0: 74 61 74 65 6d 65 6e 74 20 61 76 6f 69 64 20 74  tatement avoid t
46f0: 68 65 20 75 73 65 20 6f 66 0a 20 20 2a 2a 20 6c  he use of.  ** l
4700: 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 2e  ookaside memory.
4710: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 72 65 70  .  */.  if( prep
4720: 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 50  Flags & SQLITE_P
4730: 52 45 50 41 52 45 5f 50 45 52 53 49 53 54 45 4e  REPARE_PERSISTEN
4740: 54 20 29 7b 0a 20 20 20 20 73 50 61 72 73 65 2e  T ){.    sParse.
4750: 64 69 73 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65  disableLookaside
4760: 2b 2b 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b  ++;.    db->look
4770: 61 73 69 64 65 2e 62 44 69 73 61 62 6c 65 2b 2b  aside.bDisable++
4780: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63  ;.  }..  /* Chec
4790: 6b 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74  k to verify that
47a0: 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20   it is possible 
47b0: 74 6f 20 67 65 74 20 61 20 72 65 61 64 20 6c 6f  to get a read lo
47c0: 63 6b 20 6f 6e 20 61 6c 6c 0a 20 20 2a 2a 20 64  ck on all.  ** d
47d0: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 73 2e  atabase schemas.
47e0: 20 20 54 68 65 20 69 6e 61 62 69 6c 69 74 79 20    The inability 
47f0: 74 6f 20 67 65 74 20 61 20 72 65 61 64 20 6c 6f  to get a read lo
4800: 63 6b 20 69 6e 64 69 63 61 74 65 73 20 74 68 61  ck indicates tha
4810: 74 0a 20 20 2a 2a 20 73 6f 6d 65 20 6f 74 68 65  t.  ** some othe
4820: 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  r database conne
4830: 63 74 69 6f 6e 20 69 73 20 68 6f 6c 64 69 6e 67  ction is holding
4840: 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 2c 20 77   a write-lock, w
4850: 68 69 63 68 20 69 6e 0a 20 20 2a 2a 20 74 75 72  hich in.  ** tur
4860: 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65  n means that the
4870: 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f   other connectio
4880: 6e 20 68 61 73 20 6d 61 64 65 20 75 6e 63 6f 6d  n has made uncom
4890: 6d 69 74 74 65 64 20 63 68 61 6e 67 65 73 0a 20  mitted changes. 
48a0: 20 2a 2a 20 74 6f 20 74 68 65 20 73 63 68 65 6d   ** to the schem
48b0: 61 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 65 72  a..  **.  ** Wer
48c0: 65 20 77 65 20 74 6f 20 70 72 6f 63 65 65 64 20  e we to proceed 
48d0: 61 6e 64 20 70 72 65 70 61 72 65 20 74 68 65 20  and prepare the 
48e0: 73 74 61 74 65 6d 65 6e 74 20 61 67 61 69 6e 73  statement agains
48f0: 74 20 74 68 65 20 75 6e 63 6f 6d 6d 69 74 74 65  t the uncommitte
4900: 64 0a 20 20 2a 2a 20 73 63 68 65 6d 61 20 63 68  d.  ** schema ch
4910: 61 6e 67 65 73 20 61 6e 64 20 69 66 20 74 68 6f  anges and if tho
4920: 73 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65  se schema change
4930: 73 20 61 72 65 20 73 75 62 73 65 71 75 65 6e 74  s are subsequent
4940: 6c 79 20 72 6f 6c 6c 65 64 0a 20 20 2a 2a 20 62  ly rolled.  ** b
4950: 61 63 6b 20 61 6e 64 20 64 69 66 66 65 72 65 6e  ack and differen
4960: 74 20 63 68 61 6e 67 65 73 20 61 72 65 20 6d 61  t changes are ma
4970: 64 65 20 69 6e 20 74 68 65 69 72 20 70 6c 61 63  de in their plac
4980: 65 2c 20 74 68 65 6e 20 77 68 65 6e 20 74 68 69  e, then when thi
4990: 73 0a 20 20 2a 2a 20 70 72 65 70 61 72 65 64 20  s.  ** prepared 
49a0: 73 74 61 74 65 6d 65 6e 74 20 67 6f 65 73 20 74  statement goes t
49b0: 6f 20 72 75 6e 20 74 68 65 20 73 63 68 65 6d 61  o run the schema
49c0: 20 63 6f 6f 6b 69 65 20 77 6f 75 6c 64 20 66 61   cookie would fa
49d0: 69 6c 20 74 6f 20 64 65 74 65 63 74 0a 20 20 2a  il to detect.  *
49e0: 2a 20 74 68 65 20 73 63 68 65 6d 61 20 63 68 61  * the schema cha
49f0: 6e 67 65 2e 20 20 44 69 73 61 73 74 65 72 20 77  nge.  Disaster w
4a00: 6f 75 6c 64 20 66 6f 6c 6c 6f 77 2e 0a 20 20 2a  ould follow..  *
4a10: 2a 0a 20 20 2a 2a 20 54 68 69 73 20 74 68 72 65  *.  ** This thre
4a20: 61 64 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20  ad is currently 
4a30: 68 6f 6c 64 69 6e 67 20 6d 75 74 65 78 65 73 20  holding mutexes 
4a40: 6f 6e 20 61 6c 6c 20 42 74 72 65 65 73 20 28 62  on all Btrees (b
4a50: 65 63 61 75 73 65 0a 20 20 2a 2a 20 6f 66 20 74  ecause.  ** of t
4a60: 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 45  he sqlite3BtreeE
4a70: 6e 74 65 72 41 6c 6c 28 29 20 69 6e 20 73 71 6c  nterAll() in sql
4a80: 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61  ite3LockAndPrepa
4a90: 72 65 28 29 29 20 73 6f 20 69 74 0a 20 20 2a 2a  re()) so it.  **
4aa0: 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65   is not possible
4ab0: 20 66 6f 72 20 61 6e 6f 74 68 65 72 20 74 68 72   for another thr
4ac0: 65 61 64 20 74 6f 20 73 74 61 72 74 20 61 20 6e  ead to start a n
4ad0: 65 77 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65  ew schema change
4ae0: 0a 20 20 2a 2a 20 77 68 69 6c 65 20 74 68 69 73  .  ** while this
4af0: 20 72 6f 75 74 69 6e 65 20 69 73 20 72 75 6e 6e   routine is runn
4b00: 69 6e 67 2e 20 20 48 65 6e 63 65 2c 20 77 65 20  ing.  Hence, we 
4b10: 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 68  do not need to h
4b20: 6f 6c 64 20 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20  old .  ** locks 
4b30: 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 2c 20 77  on the schema, w
4b40: 65 20 6a 75 73 74 20 6e 65 65 64 20 74 6f 20 6d  e just need to m
4b50: 61 6b 65 20 73 75 72 65 20 6e 6f 62 6f 64 79 20  ake sure nobody 
4b60: 65 6c 73 65 20 69 73 20 0a 20 20 2a 2a 20 68 6f  else is .  ** ho
4b70: 6c 64 69 6e 67 20 74 68 65 6d 2e 0a 20 20 2a 2a  lding them..  **
4b80: 0a 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20  .  ** Note that 
4b90: 73 65 74 74 69 6e 67 20 52 45 41 44 5f 55 4e 43  setting READ_UNC
4ba0: 4f 4d 4d 49 54 54 45 44 20 6f 76 65 72 72 69 64  OMMITTED overrid
4bb0: 65 73 20 6d 6f 73 74 20 6c 6f 63 6b 20 64 65 74  es most lock det
4bc0: 65 63 74 69 6f 6e 2c 0a 20 20 2a 2a 20 62 75 74  ection,.  ** but
4bd0: 20 69 74 20 64 6f 65 73 20 2a 6e 6f 74 2a 20 6f   it does *not* o
4be0: 76 65 72 72 69 64 65 20 73 63 68 65 6d 61 20 6c  verride schema l
4bf0: 6f 63 6b 20 64 65 74 65 63 74 69 6f 6e 2c 20 73  ock detection, s
4c00: 6f 20 74 68 69 73 20 61 6c 6c 20 73 74 69 6c 6c  o this all still
4c10: 0a 20 20 2a 2a 20 77 6f 72 6b 73 20 65 76 65 6e  .  ** works even
4c20: 20 69 66 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49   if READ_UNCOMMI
4c30: 54 54 45 44 20 69 73 20 73 65 74 2e 0a 20 20 2a  TTED is set..  *
4c40: 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64  /.  for(i=0; i<d
4c50: 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 20 7b 0a 20  b->nDb; i++) {. 
4c60: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
4c70: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
4c80: 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20      if( pBt ){. 
4c90: 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c       assert( sql
4ca0: 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75  ite3BtreeHoldsMu
4cb0: 74 65 78 28 70 42 74 29 20 29 3b 0a 20 20 20 20  tex(pBt) );.    
4cc0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74    rc = sqlite3Bt
4cd0: 72 65 65 53 63 68 65 6d 61 4c 6f 63 6b 65 64 28  reeSchemaLocked(
4ce0: 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20  pBt);.      if( 
4cf0: 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 63 6f  rc ){.        co
4d00: 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 20 3d 20  nst char *zDb = 
4d10: 64 62 2d 3e 61 44 62 5b 69 5d 2e 7a 44 62 53 4e  db->aDb[i].zDbSN
4d20: 61 6d 65 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  ame;.        sql
4d30: 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67  ite3ErrorWithMsg
4d40: 28 64 62 2c 20 72 63 2c 20 22 64 61 74 61 62 61  (db, rc, "databa
4d50: 73 65 20 73 63 68 65 6d 61 20 69 73 20 6c 6f 63  se schema is loc
4d60: 6b 65 64 3a 20 25 73 22 2c 20 7a 44 62 29 3b 0a  ked: %s", zDb);.
4d70: 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65          testcase
4d80: 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51  ( db->flags & SQ
4d90: 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69  LITE_ReadUncommi
4da0: 74 20 29 3b 0a 20 20 20 20 20 20 20 20 67 6f 74  t );.        got
4db0: 6f 20 65 6e 64 5f 70 72 65 70 61 72 65 3b 0a 20  o end_prepare;. 
4dc0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
4dd0: 0a 0a 20 20 73 71 6c 69 74 65 33 56 74 61 62 55  ..  sqlite3VtabU
4de0: 6e 6c 6f 63 6b 4c 69 73 74 28 64 62 29 3b 0a 0a  nlockList(db);..
4df0: 20 20 73 50 61 72 73 65 2e 64 62 20 3d 20 64 62    sParse.db = db
4e00: 3b 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3e 3d  ;.  if( nBytes>=
4e10: 30 20 26 26 20 28 6e 42 79 74 65 73 3d 3d 30 20  0 && (nBytes==0 
4e20: 7c 7c 20 7a 53 71 6c 5b 6e 42 79 74 65 73 2d 31  || zSql[nBytes-1
4e30: 5d 21 3d 30 29 20 29 7b 0a 20 20 20 20 63 68 61  ]!=0) ){.    cha
4e40: 72 20 2a 7a 53 71 6c 43 6f 70 79 3b 0a 20 20 20  r *zSqlCopy;.   
4e50: 20 69 6e 74 20 6d 78 4c 65 6e 20 3d 20 64 62 2d   int mxLen = db-
4e60: 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c  >aLimit[SQLITE_L
4e70: 49 4d 49 54 5f 53 51 4c 5f 4c 45 4e 47 54 48 5d  IMIT_SQL_LENGTH]
4e80: 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20  ;.    testcase( 
4e90: 6e 42 79 74 65 73 3d 3d 6d 78 4c 65 6e 20 29 3b  nBytes==mxLen );
4ea0: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e  .    testcase( n
4eb0: 42 79 74 65 73 3d 3d 6d 78 4c 65 6e 2b 31 20 29  Bytes==mxLen+1 )
4ec0: 3b 0a 20 20 20 20 69 66 28 20 6e 42 79 74 65 73  ;.    if( nBytes
4ed0: 3e 6d 78 4c 65 6e 20 29 7b 0a 20 20 20 20 20 20  >mxLen ){.      
4ee0: 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68  sqlite3ErrorWith
4ef0: 4d 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f 54  Msg(db, SQLITE_T
4f00: 4f 4f 42 49 47 2c 20 22 73 74 61 74 65 6d 65 6e  OOBIG, "statemen
4f10: 74 20 74 6f 6f 20 6c 6f 6e 67 22 29 3b 0a 20 20  t too long");.  
4f20: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
4f30: 41 70 69 45 78 69 74 28 64 62 2c 20 53 51 4c 49  ApiExit(db, SQLI
4f40: 54 45 5f 54 4f 4f 42 49 47 29 3b 0a 20 20 20 20  TE_TOOBIG);.    
4f50: 20 20 67 6f 74 6f 20 65 6e 64 5f 70 72 65 70 61    goto end_prepa
4f60: 72 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 53  re;.    }.    zS
4f70: 71 6c 43 6f 70 79 20 3d 20 73 71 6c 69 74 65 33  qlCopy = sqlite3
4f80: 44 62 53 74 72 4e 44 75 70 28 64 62 2c 20 7a 53  DbStrNDup(db, zS
4f90: 71 6c 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 20  ql, nBytes);.   
4fa0: 20 69 66 28 20 7a 53 71 6c 43 6f 70 79 20 29 7b   if( zSqlCopy ){
4fb0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 75  .      sqlite3Ru
4fc0: 6e 50 61 72 73 65 72 28 26 73 50 61 72 73 65 2c  nParser(&sParse,
4fd0: 20 7a 53 71 6c 43 6f 70 79 2c 20 26 7a 45 72 72   zSqlCopy, &zErr
4fe0: 4d 73 67 29 3b 0a 20 20 20 20 20 20 73 50 61 72  Msg);.      sPar
4ff0: 73 65 2e 7a 54 61 69 6c 20 3d 20 26 7a 53 71 6c  se.zTail = &zSql
5000: 5b 73 50 61 72 73 65 2e 7a 54 61 69 6c 2d 7a 53  [sParse.zTail-zS
5010: 71 6c 43 6f 70 79 5d 3b 0a 20 20 20 20 20 20 73  qlCopy];.      s
5020: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c  qlite3DbFree(db,
5030: 20 7a 53 71 6c 43 6f 70 79 29 3b 0a 20 20 20 20   zSqlCopy);.    
5040: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 50 61  }else{.      sPa
5050: 72 73 65 2e 7a 54 61 69 6c 20 3d 20 26 7a 53 71  rse.zTail = &zSq
5060: 6c 5b 6e 42 79 74 65 73 5d 3b 0a 20 20 20 20 7d  l[nBytes];.    }
5070: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71  .  }else{.    sq
5080: 6c 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 26  lite3RunParser(&
5090: 73 50 61 72 73 65 2c 20 7a 53 71 6c 2c 20 26 7a  sParse, zSql, &z
50a0: 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 61  ErrMsg);.  }.  a
50b0: 73 73 65 72 74 28 20 30 3d 3d 73 50 61 72 73 65  ssert( 0==sParse
50c0: 2e 6e 51 75 65 72 79 4c 6f 6f 70 20 29 3b 0a 0a  .nQueryLoop );..
50d0: 20 20 69 66 28 20 73 50 61 72 73 65 2e 72 63 3d    if( sParse.rc=
50e0: 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 20 73  =SQLITE_DONE ) s
50f0: 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 54  Parse.rc = SQLIT
5100: 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 73 50 61 72  E_OK;.  if( sPar
5110: 73 65 2e 63 68 65 63 6b 53 63 68 65 6d 61 20 29  se.checkSchema )
5120: 7b 0a 20 20 20 20 73 63 68 65 6d 61 49 73 56 61  {.    schemaIsVa
5130: 6c 69 64 28 26 73 50 61 72 73 65 29 3b 0a 20 20  lid(&sParse);.  
5140: 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c  }.  if( db->mall
5150: 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20  ocFailed ){.    
5160: 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49  sParse.rc = SQLI
5170: 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20  TE_NOMEM_BKPT;. 
5180: 20 7d 0a 20 20 69 66 28 20 70 7a 54 61 69 6c 20   }.  if( pzTail 
5190: 29 7b 0a 20 20 20 20 2a 70 7a 54 61 69 6c 20 3d  ){.    *pzTail =
51a0: 20 73 50 61 72 73 65 2e 7a 54 61 69 6c 3b 0a 20   sParse.zTail;. 
51b0: 20 7d 0a 20 20 72 63 20 3d 20 73 50 61 72 73 65   }.  rc = sParse
51c0: 2e 72 63 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51  .rc;..#ifndef SQ
51d0: 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49  LITE_OMIT_EXPLAI
51e0: 4e 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  N.  if( rc==SQLI
51f0: 54 45 5f 4f 4b 20 26 26 20 73 50 61 72 73 65 2e  TE_OK && sParse.
5200: 70 56 64 62 65 20 26 26 20 73 50 61 72 73 65 2e  pVdbe && sParse.
5210: 65 78 70 6c 61 69 6e 20 29 7b 0a 20 20 20 20 73  explain ){.    s
5220: 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72  tatic const char
5230: 20 2a 20 63 6f 6e 73 74 20 61 7a 43 6f 6c 4e 61   * const azColNa
5240: 6d 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20  me[] = {.       
5250: 22 61 64 64 72 22 2c 20 22 6f 70 63 6f 64 65 22  "addr", "opcode"
5260: 2c 20 22 70 31 22 2c 20 22 70 32 22 2c 20 22 70  , "p1", "p2", "p
5270: 33 22 2c 20 22 70 34 22 2c 20 22 70 35 22 2c 20  3", "p4", "p5", 
5280: 22 63 6f 6d 6d 65 6e 74 22 2c 0a 20 20 20 20 20  "comment",.     
5290: 20 20 22 69 64 22 2c 20 22 70 61 72 65 6e 74 22    "id", "parent"
52a0: 2c 20 22 6e 6f 74 75 73 65 64 22 2c 20 22 64 65  , "notused", "de
52b0: 74 61 69 6c 22 0a 20 20 20 20 7d 3b 0a 20 20 20  tail".    };.   
52c0: 20 69 6e 74 20 69 46 69 72 73 74 2c 20 6d 78 3b   int iFirst, mx;
52d0: 0a 20 20 20 20 69 66 28 20 73 50 61 72 73 65 2e  .    if( sParse.
52e0: 65 78 70 6c 61 69 6e 3d 3d 32 20 29 7b 0a 20 20  explain==2 ){.  
52f0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
5300: 65 74 4e 75 6d 43 6f 6c 73 28 73 50 61 72 73 65  etNumCols(sParse
5310: 2e 70 56 64 62 65 2c 20 34 29 3b 0a 20 20 20 20  .pVdbe, 4);.    
5320: 20 20 69 46 69 72 73 74 20 3d 20 38 3b 0a 20 20    iFirst = 8;.  
5330: 20 20 20 20 6d 78 20 3d 20 31 32 3b 0a 20 20 20      mx = 12;.   
5340: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71   }else{.      sq
5350: 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d 43  lite3VdbeSetNumC
5360: 6f 6c 73 28 73 50 61 72 73 65 2e 70 56 64 62 65  ols(sParse.pVdbe
5370: 2c 20 38 29 3b 0a 20 20 20 20 20 20 69 46 69 72  , 8);.      iFir
5380: 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 6d 78  st = 0;.      mx
5390: 20 3d 20 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20   = 8;.    }.    
53a0: 66 6f 72 28 69 3d 69 46 69 72 73 74 3b 20 69 3c  for(i=iFirst; i<
53b0: 6d 78 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  mx; i++){.      
53c0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f  sqlite3VdbeSetCo
53d0: 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64  lName(sParse.pVd
53e0: 62 65 2c 20 69 2d 69 46 69 72 73 74 2c 20 43 4f  be, i-iFirst, CO
53f0: 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 0a 20 20 20 20  LNAME_NAME,.    
5400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5410: 20 20 20 20 20 20 20 20 61 7a 43 6f 6c 4e 61 6d          azColNam
5420: 65 5b 69 5d 2c 20 53 51 4c 49 54 45 5f 53 54 41  e[i], SQLITE_STA
5430: 54 49 43 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  TIC);.    }.  }.
5440: 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 64 62  #endif..  if( db
5450: 2d 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20 29  ->init.busy==0 )
5460: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
5470: 65 53 65 74 53 71 6c 28 73 50 61 72 73 65 2e 70  eSetSql(sParse.p
5480: 56 64 62 65 2c 20 7a 53 71 6c 2c 20 28 69 6e 74  Vdbe, zSql, (int
5490: 29 28 73 50 61 72 73 65 2e 7a 54 61 69 6c 2d 7a  )(sParse.zTail-z
54a0: 53 71 6c 29 2c 20 70 72 65 70 46 6c 61 67 73 29  Sql), prepFlags)
54b0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72  ;.  }.  if( sPar
54c0: 73 65 2e 70 56 64 62 65 20 26 26 20 28 72 63 21  se.pVdbe && (rc!
54d0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 64 62  =SQLITE_OK || db
54e0: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 29 20  ->mallocFailed) 
54f0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64  ){.    sqlite3Vd
5500: 62 65 46 69 6e 61 6c 69 7a 65 28 73 50 61 72 73  beFinalize(sPars
5510: 65 2e 70 56 64 62 65 29 3b 0a 20 20 20 20 61 73  e.pVdbe);.    as
5520: 73 65 72 74 28 21 28 2a 70 70 53 74 6d 74 29 29  sert(!(*ppStmt))
5530: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a  ;.  }else{.    *
5540: 70 70 53 74 6d 74 20 3d 20 28 73 71 6c 69 74 65  ppStmt = (sqlite
5550: 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70  3_stmt*)sParse.p
5560: 56 64 62 65 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  Vdbe;.  }..  if(
5570: 20 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20   zErrMsg ){.    
5580: 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68  sqlite3ErrorWith
5590: 4d 73 67 28 64 62 2c 20 72 63 2c 20 22 25 73 22  Msg(db, rc, "%s"
55a0: 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  , zErrMsg);.    
55b0: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62  sqlite3DbFree(db
55c0: 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d 65  , zErrMsg);.  }e
55d0: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  lse{.    sqlite3
55e0: 45 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20  Error(db, rc);. 
55f0: 20 7d 0a 0a 20 20 2f 2a 20 44 65 6c 65 74 65 20   }..  /* Delete 
5600: 61 6e 79 20 54 72 69 67 67 65 72 50 72 67 20 73  any TriggerPrg s
5610: 74 72 75 63 74 75 72 65 73 20 61 6c 6c 6f 63 61  tructures alloca
5620: 74 65 64 20 77 68 69 6c 65 20 70 61 72 73 69 6e  ted while parsin
5630: 67 20 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74  g this statement
5640: 2e 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 73 50  . */.  while( sP
5650: 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 72 67  arse.pTriggerPrg
5660: 20 29 7b 0a 20 20 20 20 54 72 69 67 67 65 72 50   ){.    TriggerP
5670: 72 67 20 2a 70 54 20 3d 20 73 50 61 72 73 65 2e  rg *pT = sParse.
5680: 70 54 72 69 67 67 65 72 50 72 67 3b 0a 20 20 20  pTriggerPrg;.   
5690: 20 73 50 61 72 73 65 2e 70 54 72 69 67 67 65 72   sParse.pTrigger
56a0: 50 72 67 20 3d 20 70 54 2d 3e 70 4e 65 78 74 3b  Prg = pT->pNext;
56b0: 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72  .    sqlite3DbFr
56c0: 65 65 28 64 62 2c 20 70 54 29 3b 0a 20 20 7d 0a  ee(db, pT);.  }.
56d0: 0a 65 6e 64 5f 70 72 65 70 61 72 65 3a 0a 0a 20  .end_prepare:.. 
56e0: 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 65   sqlite3ParserRe
56f0: 73 65 74 28 26 73 50 61 72 73 65 29 3b 0a 20 20  set(&sParse);.  
5700: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 61  return rc;.}.sta
5710: 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 4c  tic int sqlite3L
5720: 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 0a 20  ockAndPrepare(. 
5730: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
5740: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61             /* Da
5750: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a  tabase handle. *
5760: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
5770: 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a  zSql,         /*
5780: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53   UTF-8 encoded S
5790: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f  QL statement. */
57a0: 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20  .  int nBytes,  
57b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
57c0: 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69  Length of zSql i
57d0: 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 33  n bytes. */.  u3
57e0: 32 20 70 72 65 70 46 6c 61 67 73 2c 20 20 20 20  2 prepFlags,    
57f0: 20 20 20 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20          /* Zero 
5800: 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50  or more SQLITE_P
5810: 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a  REPARE_* flags *
5820: 2f 0a 20 20 56 64 62 65 20 2a 70 4f 6c 64 2c 20  /.  Vdbe *pOld, 
5830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
5840: 20 56 4d 20 62 65 69 6e 67 20 72 65 70 72 65 70   VM being reprep
5850: 61 72 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65  ared */.  sqlite
5860: 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c  3_stmt **ppStmt,
5870: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f      /* OUT: A po
5880: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65  inter to the pre
5890: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
58a0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
58b0: 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f  **pzTail       /
58c0: 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61  * OUT: End of pa
58d0: 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29  rsed string */.)
58e0: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e  {.  int rc;.  in
58f0: 74 20 63 6e 74 20 3d 20 30 3b 0a 0a 23 69 66 64  t cnt = 0;..#ifd
5900: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
5910: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28  _API_ARMOR.  if(
5920: 20 70 70 53 74 6d 74 3d 3d 30 20 29 20 72 65 74   ppStmt==0 ) ret
5930: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
5940: 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20  E_BKPT;.#endif. 
5950: 20 2a 70 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20   *ppStmt = 0;.  
5960: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65  if( !sqlite3Safe
5970: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 7c 7c 7a  tyCheckOk(db)||z
5980: 53 71 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65  Sql==0 ){.    re
5990: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  turn SQLITE_MISU
59a0: 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73  SE_BKPT;.  }.  s
59b0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
59c0: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  er(db->mutex);. 
59d0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74   sqlite3BtreeEnt
59e0: 65 72 41 6c 6c 28 64 62 29 3b 0a 20 20 64 6f 7b  erAll(db);.  do{
59f0: 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 20 6d 75 6c  .    /* Make mul
5a00: 74 69 70 6c 65 20 61 74 74 65 6d 70 74 73 20 74  tiple attempts t
5a10: 6f 20 63 6f 6d 70 69 6c 65 20 74 68 65 20 53 51  o compile the SQ
5a20: 4c 2c 20 75 6e 74 69 6c 20 69 74 20 65 69 74 68  L, until it eith
5a30: 65 72 20 73 75 63 63 65 65 64 73 0a 20 20 20 20  er succeeds.    
5a40: 2a 2a 20 6f 72 20 65 6e 63 6f 75 6e 74 65 72 73  ** or encounters
5a50: 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 65 72 72   a permanent err
5a60: 6f 72 2e 20 20 41 20 73 63 68 65 6d 61 20 70 72  or.  A schema pr
5a70: 6f 62 6c 65 6d 20 61 66 74 65 72 20 6f 6e 65 20  oblem after one 
5a80: 73 63 68 65 6d 61 0a 20 20 20 20 2a 2a 20 72 65  schema.    ** re
5a90: 73 65 74 20 69 73 20 63 6f 6e 73 69 64 65 72 65  set is considere
5aa0: 64 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 65 72  d a permanent er
5ab0: 72 6f 72 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d  ror. */.    rc =
5ac0: 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 28   sqlite3Prepare(
5ad0: 64 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73  db, zSql, nBytes
5ae0: 2c 20 70 72 65 70 46 6c 61 67 73 2c 20 70 4f 6c  , prepFlags, pOl
5af0: 64 2c 20 70 70 53 74 6d 74 2c 20 70 7a 54 61 69  d, ppStmt, pzTai
5b00: 6c 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  l);.    assert( 
5b10: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c  rc==SQLITE_OK ||
5b20: 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20   *ppStmt==0 );. 
5b30: 20 7d 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c   }while( rc==SQL
5b40: 49 54 45 5f 45 52 52 4f 52 5f 52 45 54 52 59 0a  ITE_ERROR_RETRY.
5b50: 20 20 20 20 20 20 20 7c 7c 20 28 72 63 3d 3d 53         || (rc==S
5b60: 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 26 26 20  QLITE_SCHEMA && 
5b70: 28 73 71 6c 69 74 65 33 52 65 73 65 74 4f 6e 65  (sqlite3ResetOne
5b80: 53 63 68 65 6d 61 28 64 62 2c 2d 31 29 2c 20 63  Schema(db,-1), c
5b90: 6e 74 2b 2b 29 3d 3d 30 29 20 29 3b 0a 20 20 73  nt++)==0) );.  s
5ba0: 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65  qlite3BtreeLeave
5bb0: 41 6c 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d 20  All(db);.  rc = 
5bc0: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64  sqlite3ApiExit(d
5bd0: 62 2c 20 72 63 29 3b 0a 20 20 61 73 73 65 72 74  b, rc);.  assert
5be0: 28 20 28 72 63 26 64 62 2d 3e 65 72 72 4d 61 73  ( (rc&db->errMas
5bf0: 6b 29 3d 3d 72 63 20 29 3b 0a 20 20 73 71 6c 69  k)==rc );.  sqli
5c00: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
5c10: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65  db->mutex);.  re
5c20: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 64  turn rc;.}..#ifd
5c30: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
5c40: 5f 4e 4f 52 4d 41 4c 49 5a 45 0a 0a 2f 2a 0a 2a  _NORMALIZE../*.*
5c50: 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 65 73 74  * Attempt to est
5c60: 69 6d 61 74 65 20 74 68 65 20 66 69 6e 61 6c 20  imate the final 
5c70: 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 73 69  output buffer si
5c80: 7a 65 20 6e 65 65 64 65 64 20 66 6f 72 20 74 68  ze needed for th
5c90: 65 20 66 75 6c 6c 79 0a 2a 2a 20 6e 6f 72 6d 61  e fully.** norma
5ca0: 6c 69 7a 65 64 20 76 65 72 73 69 6f 6e 20 6f 66  lized version of
5cb0: 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 53   the specified S
5cc0: 51 4c 20 73 74 72 69 6e 67 2e 20 20 54 68 69 73  QL string.  This
5cd0: 20 73 68 6f 75 6c 64 20 74 61 6b 65 20 69 6e 74   should take int
5ce0: 6f 0a 2a 2a 20 61 63 63 6f 75 6e 74 20 61 6e 79  o.** account any
5cf0: 20 70 6f 74 65 6e 74 69 61 6c 20 65 78 70 61 6e   potential expan
5d00: 73 69 6f 6e 20 74 68 61 74 20 63 6f 75 6c 64 20  sion that could 
5d10: 6f 63 63 75 72 20 28 65 2e 67 2e 20 76 69 61 20  occur (e.g. via 
5d20: 49 4e 20 63 6c 61 75 73 65 73 0a 2a 2a 20 62 65  IN clauses.** be
5d30: 69 6e 67 20 65 78 70 61 6e 64 65 64 2c 20 65 74  ing expanded, et
5d40: 63 29 2e 20 20 54 68 69 73 20 73 69 7a 65 20 72  c).  This size r
5d50: 65 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 74  eturned is the t
5d60: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62  otal number of b
5d70: 79 74 65 73 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e  ytes.** includin
5d80: 67 20 74 68 65 20 4e 55 4c 20 74 65 72 6d 69 6e  g the NUL termin
5d90: 61 74 6f 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ator..*/.static 
5da0: 69 6e 74 20 65 73 74 69 6d 61 74 65 4e 6f 72 6d  int estimateNorm
5db0: 61 6c 69 7a 65 64 53 69 7a 65 28 0a 20 20 63 6f  alizedSize(.  co
5dc0: 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20  nst char *zSql, 
5dd0: 2f 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20  /* The original 
5de0: 53 51 4c 20 73 74 72 69 6e 67 20 2a 2f 0a 20 20  SQL string */.  
5df0: 69 6e 74 20 6e 53 71 6c 20 20 20 20 20 20 20 20  int nSql        
5e00: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 6f    /* Length of o
5e10: 72 69 67 69 6e 61 6c 20 53 51 4c 20 73 74 72 69  riginal SQL stri
5e20: 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e  ng */.){.  int n
5e30: 4f 75 74 20 3d 20 6e 53 71 6c 20 2b 20 34 3b 0a  Out = nSql + 4;.
5e40: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20    const char *z 
5e50: 3d 20 7a 53 71 6c 3b 0a 20 20 77 68 69 6c 65 28  = zSql;.  while(
5e60: 20 6e 4f 75 74 3c 6e 53 71 6c 2a 35 20 29 7b 0a   nOut<nSql*5 ){.
5e70: 20 20 20 20 77 68 69 6c 65 28 20 7a 5b 30 5d 21      while( z[0]!
5e80: 3d 30 20 26 26 20 7a 5b 30 5d 21 3d 27 49 27 20  =0 && z[0]!='I' 
5e90: 26 26 20 7a 5b 30 5d 21 3d 27 69 27 20 29 7b 20  && z[0]!='i' ){ 
5ea0: 7a 2b 2b 3b 20 7d 0a 20 20 20 20 69 66 28 20 7a  z++; }.    if( z
5eb0: 5b 30 5d 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a  [0]==0 ) break;.
5ec0: 20 20 20 20 7a 2b 2b 3b 0a 20 20 20 20 69 66 28      z++;.    if(
5ed0: 20 7a 5b 30 5d 21 3d 27 4e 27 20 26 26 20 7a 5b   z[0]!='N' && z[
5ee0: 30 5d 21 3d 27 6e 27 20 29 20 62 72 65 61 6b 3b  0]!='n' ) break;
5ef0: 0a 20 20 20 20 7a 2b 2b 3b 0a 20 20 20 20 77 68  .    z++;.    wh
5f00: 69 6c 65 28 20 73 71 6c 69 74 65 33 49 73 73 70  ile( sqlite3Issp
5f10: 61 63 65 28 7a 5b 30 5d 29 20 29 7b 20 7a 2b 2b  ace(z[0]) ){ z++
5f20: 3b 20 7d 0a 20 20 20 20 69 66 28 20 7a 5b 30 5d  ; }.    if( z[0]
5f30: 21 3d 27 28 27 20 29 20 62 72 65 61 6b 3b 0a 20  !='(' ) break;. 
5f40: 20 20 20 7a 2b 2b 3b 0a 20 20 20 20 6e 4f 75 74     z++;.    nOut
5f50: 20 2b 3d 20 35 3b 20 2f 2a 20 3f 2c 3f 2c 3f 20   += 5; /* ?,?,? 
5f60: 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  */.  }.  return 
5f70: 6e 4f 75 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  nOut;.}../*.** C
5f80: 6f 70 79 20 74 68 65 20 63 75 72 72 65 6e 74 20  opy the current 
5f90: 74 6f 6b 65 6e 20 69 6e 74 6f 20 74 68 65 20 6f  token into the o
5fa0: 75 74 70 75 74 20 62 75 66 66 65 72 20 77 68 69  utput buffer whi
5fb0: 6c 65 20 64 65 61 6c 69 6e 67 20 77 69 74 68 20  le dealing with 
5fc0: 71 75 6f 74 65 64 0a 2a 2a 20 69 64 65 6e 74 69  quoted.** identi
5fd0: 66 69 65 72 73 2e 20 20 42 79 20 64 65 66 61 75  fiers.  By defau
5fe0: 6c 74 2c 20 61 6c 6c 20 6c 65 74 74 65 72 73 20  lt, all letters 
5ff0: 77 69 6c 6c 20 62 65 20 63 6f 6e 76 65 72 74 65  will be converte
6000: 64 20 69 6e 74 6f 20 6c 6f 77 65 72 63 61 73 65  d into lowercase
6010: 2e 0a 2a 2a 20 49 66 20 74 68 65 20 62 55 70 70  ..** If the bUpp
6020: 65 72 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20  er flag is set, 
6030: 75 70 70 65 72 63 61 73 65 20 77 69 6c 6c 20 62  uppercase will b
6040: 65 20 75 73 65 64 2e 20 20 54 68 65 20 70 69 4f  e used.  The piO
6050: 75 74 20 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 77  ut argument.** w
6060: 69 6c 6c 20 62 65 20 75 73 65 64 20 74 6f 20 75  ill be used to u
6070: 70 64 61 74 65 20 74 68 65 20 74 61 72 67 65 74  pdate the target
6080: 20 69 6e 64 65 78 20 69 6e 74 6f 20 74 68 65 20   index into the 
6090: 6f 75 74 70 75 74 20 73 74 72 69 6e 67 2e 0a 2a  output string..*
60a0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f  /.static void co
60b0: 70 79 4e 6f 72 6d 61 6c 69 7a 65 64 54 6f 6b 65  pyNormalizedToke
60c0: 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  n(.  const char 
60d0: 2a 7a 53 71 6c 2c 20 2f 2a 20 54 68 65 20 6f 72  *zSql, /* The or
60e0: 69 67 69 6e 61 6c 20 53 51 4c 20 73 74 72 69 6e  iginal SQL strin
60f0: 67 20 2a 2f 0a 20 20 69 6e 74 20 69 49 6e 2c 20  g */.  int iIn, 
6100: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72           /* Curr
6110: 65 6e 74 20 69 6e 64 65 78 20 69 6e 74 6f 20 74  ent index into t
6120: 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20  he original SQL 
6130: 73 74 72 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20  string */.  int 
6140: 6e 54 6f 6b 65 6e 2c 20 20 20 20 20 20 20 2f 2a  nToken,       /*
6150: 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   Number of bytes
6160: 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20   in the current 
6170: 74 6f 6b 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 74  token */.  int t
6180: 6f 6b 65 6e 46 6c 61 67 73 2c 20 20 20 2f 2a 20  okenFlags,   /* 
6190: 46 6c 61 67 73 20 72 65 74 75 72 6e 65 64 20 62  Flags returned b
61a0: 79 20 74 68 65 20 74 6f 6b 65 6e 69 7a 65 72 20  y the tokenizer 
61b0: 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4f 75 74 2c  */.  char *zOut,
61c0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 75         /* The ou
61d0: 74 70 75 74 20 73 74 72 69 6e 67 20 2a 2f 0a 20  tput string */. 
61e0: 20 69 6e 74 20 2a 70 69 4f 75 74 20 20 20 20 20   int *piOut     
61f0: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f     /* Pointer to
6200: 20 74 61 72 67 65 74 20 69 6e 64 65 78 20 69 6e   target index in
6210: 74 6f 20 74 68 65 20 6f 75 74 70 75 74 20 73 74  to the output st
6220: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  ring */.){.  int
6230: 20 62 51 75 6f 74 65 64 20 3d 20 74 6f 6b 65 6e   bQuoted = token
6240: 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 54  Flags & SQLITE_T
6250: 4f 4b 45 4e 5f 51 55 4f 54 45 44 3b 0a 20 20 69  OKEN_QUOTED;.  i
6260: 6e 74 20 62 4b 65 79 77 6f 72 64 20 3d 20 74 6f  nt bKeyword = to
6270: 6b 65 6e 46 6c 61 67 73 20 26 20 53 51 4c 49 54  kenFlags & SQLIT
6280: 45 5f 54 4f 4b 45 4e 5f 4b 45 59 57 4f 52 44 3b  E_TOKEN_KEYWORD;
6290: 0a 20 20 69 6e 74 20 6a 20 3d 20 2a 70 69 4f 75  .  int j = *piOu
62a0: 74 2c 20 6b 20 3d 20 30 3b 0a 20 20 66 6f 72 28  t, k = 0;.  for(
62b0: 3b 20 6b 3c 6e 54 6f 6b 65 6e 3b 20 6b 2b 2b 29  ; k<nToken; k++)
62c0: 7b 0a 20 20 20 20 69 66 28 20 62 51 75 6f 74 65  {.    if( bQuote
62d0: 64 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 6b  d ){.      if( k
62e0: 3d 3d 30 20 26 26 20 69 49 6e 3e 30 20 29 7b 0a  ==0 && iIn>0 ){.
62f0: 20 20 20 20 20 20 20 20 7a 4f 75 74 5b 6a 2b 2b          zOut[j++
6300: 5d 20 3d 20 27 22 27 3b 0a 20 20 20 20 20 20 20  ] = '"';.       
6310: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20   continue;.     
6320: 20 7d 65 6c 73 65 20 69 66 28 20 6b 3d 3d 6e 54   }else if( k==nT
6330: 6f 6b 65 6e 2d 31 20 29 7b 0a 20 20 20 20 20 20  oken-1 ){.      
6340: 20 20 7a 4f 75 74 5b 6a 2b 2b 5d 20 3d 20 27 22    zOut[j++] = '"
6350: 27 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 69  ';.        conti
6360: 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  nue;.      }.   
6370: 20 7d 0a 20 20 20 20 69 66 28 20 62 4b 65 79 77   }.    if( bKeyw
6380: 6f 72 64 20 29 7b 0a 20 20 20 20 20 20 7a 4f 75  ord ){.      zOu
6390: 74 5b 6a 2b 2b 5d 20 3d 20 73 71 6c 69 74 65 33  t[j++] = sqlite3
63a0: 54 6f 75 70 70 65 72 28 7a 53 71 6c 5b 69 49 6e  Toupper(zSql[iIn
63b0: 2b 6b 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  +k]);.    }else{
63c0: 0a 20 20 20 20 20 20 7a 4f 75 74 5b 6a 2b 2b 5d  .      zOut[j++]
63d0: 20 3d 20 73 71 6c 69 74 65 33 54 6f 6c 6f 77 65   = sqlite3Tolowe
63e0: 72 28 7a 53 71 6c 5b 69 49 6e 2b 6b 5d 29 3b 0a  r(zSql[iIn+k]);.
63f0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 2a 70 69 4f      }.  }.  *piO
6400: 75 74 20 3d 20 6a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ut = j;.}../*.**
6410: 20 43 6f 6d 70 75 74 65 20 61 20 6e 6f 72 6d 61   Compute a norma
6420: 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  lization of the 
6430: 53 51 4c 20 67 69 76 65 6e 20 62 79 20 7a 53 71  SQL given by zSq
6440: 6c 5b 30 2e 2e 6e 53 71 6c 2d 31 5d 2e 20 20 52  l[0..nSql-1].  R
6450: 65 74 75 72 6e 0a 2a 2a 20 74 68 65 20 6e 6f 72  eturn.** the nor
6460: 6d 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 20 73 70  malization in sp
6470: 61 63 65 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  ace obtained fro
6480: 6d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f  m sqlite3DbMallo
6490: 63 28 29 2e 20 20 4f 72 20 72 65 74 75 72 6e 0a  c().  Or return.
64a0: 2a 2a 20 4e 55 4c 4c 20 69 66 20 61 6e 79 74 68  ** NULL if anyth
64b0: 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 20 6f  ing goes wrong o
64c0: 72 20 69 66 20 7a 53 71 6c 20 69 73 20 4e 55 4c  r if zSql is NUL
64d0: 4c 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 6c 69  L..*/.char *sqli
64e0: 74 65 33 4e 6f 72 6d 61 6c 69 7a 65 28 0a 20 20  te3Normalize(.  
64f0: 56 64 62 65 20 2a 70 56 64 62 65 2c 20 20 20 20  Vdbe *pVdbe,    
6500: 20 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 72 65    /* VM being re
6510: 70 72 65 70 61 72 65 64 20 2a 2f 0a 20 20 63 6f  prepared */.  co
6520: 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20  nst char *zSql, 
6530: 2f 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20  /* The original 
6540: 53 51 4c 20 73 74 72 69 6e 67 20 2a 2f 0a 20 20  SQL string */.  
6550: 69 6e 74 20 6e 53 71 6c 20 20 20 20 20 20 20 20  int nSql        
6560: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65    /* Size of the
6570: 20 69 6e 70 75 74 20 73 74 72 69 6e 67 20 69 6e   input string in
6580: 20 62 79 74 65 73 20 2a 2f 0a 29 7b 0a 20 20 73   bytes */.){.  s
6590: 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 20 20  qlite3 *db;     
65a0: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
65b0: 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63  e handle. */.  c
65c0: 68 61 72 20 2a 7a 3b 20 20 20 20 20 20 20 20 20  har *z;         
65d0: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 75 74        /* The out
65e0: 70 75 74 20 73 74 72 69 6e 67 20 2a 2f 0a 20 20  put string */.  
65f0: 69 6e 74 20 6e 5a 3b 20 20 20 20 20 20 20 20 20  int nZ;         
6600: 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f         /* Size o
6610: 66 20 74 68 65 20 6f 75 74 70 75 74 20 73 74 72  f the output str
6620: 69 6e 67 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a  ing in bytes */.
6630: 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20    int i;        
6640: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74           /* Next
6650: 20 63 68 61 72 61 63 74 65 72 20 74 6f 20 72 65   character to re
6660: 61 64 20 66 72 6f 6d 20 7a 53 71 6c 5b 5d 20 2a  ad from zSql[] *
6670: 2f 0a 20 20 69 6e 74 20 6a 3b 20 20 20 20 20 20  /.  int j;      
6680: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65             /* Ne
6690: 78 74 20 63 68 61 72 61 63 74 65 72 20 74 6f 20  xt character to 
66a0: 66 69 6c 6c 20 69 6e 20 6f 6e 20 7a 5b 5d 20 2a  fill in on z[] *
66b0: 2f 0a 20 20 69 6e 74 20 74 6f 6b 65 6e 54 79 70  /.  int tokenTyp
66c0: 65 20 3d 20 30 3b 20 20 20 20 20 2f 2a 20 54 79  e = 0;     /* Ty
66d0: 70 65 20 6f 66 20 74 68 65 20 6e 65 78 74 20 74  pe of the next t
66e0: 6f 6b 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 70 72  oken */.  int pr
66f0: 65 76 54 6f 6b 65 6e 54 79 70 65 20 3d 20 30 3b  evTokenType = 0;
6700: 20 2f 2a 20 54 79 70 65 20 6f 66 20 74 68 65 20   /* Type of the 
6710: 70 72 65 76 69 6f 75 73 20 74 6f 6b 65 6e 2c 20  previous token, 
6720: 65 78 63 65 70 74 20 73 70 61 63 65 73 20 2a 2f  except spaces */
6730: 0a 20 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 20  .  int n;       
6740: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a            /* Siz
6750: 65 20 6f 66 20 74 68 65 20 6e 65 78 74 20 74 6f  e of the next to
6760: 6b 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61  ken */.  int nPa
6770: 72 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 20 20  ren = 0;        
6780: 2f 2a 20 4e 65 73 74 69 6e 67 20 6c 65 76 65 6c  /* Nesting level
6790: 20 6f 66 20 70 61 72 65 6e 74 68 65 73 69 73 20   of parenthesis 
67a0: 2a 2f 0a 20 20 69 6e 74 20 69 53 74 61 72 74 49  */.  int iStartI
67b0: 4e 20 3d 20 30 3b 20 20 20 20 20 20 2f 2a 20 53  N = 0;      /* S
67c0: 74 61 72 74 20 6f 66 20 52 48 53 20 6f 66 20 49  tart of RHS of I
67d0: 4e 20 6f 70 65 72 61 74 6f 72 20 69 6e 20 7a 5b  N operator in z[
67e0: 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 72 65  ] */.  int nPare
67f0: 6e 41 74 49 4e 20 3d 20 30 3b 20 20 20 20 2f 2a  nAtIN = 0;    /*
6800: 20 56 61 6c 75 65 20 6f 66 20 6e 50 61 72 65 6e   Value of nParen
6810: 74 20 61 74 20 73 74 61 72 74 20 6f 66 20 52 48  t at start of RH
6820: 53 20 6f 66 20 49 4e 20 6f 70 65 72 61 74 6f 72  S of IN operator
6830: 20 2a 2f 0a 0a 20 20 64 62 20 3d 20 73 71 6c 69   */..  db = sqli
6840: 74 65 33 56 64 62 65 44 62 28 70 56 64 62 65 29  te3VdbeDb(pVdbe)
6850: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 21 3d  ;.  assert( db!=
6860: 30 20 29 3b 0a 20 20 69 66 28 20 7a 53 71 6c 3d  0 );.  if( zSql=
6870: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
6880: 20 6e 5a 20 3d 20 65 73 74 69 6d 61 74 65 4e 6f   nZ = estimateNo
6890: 72 6d 61 6c 69 7a 65 64 53 69 7a 65 28 7a 53 71  rmalizedSize(zSq
68a0: 6c 2c 20 6e 53 71 6c 29 3b 0a 20 20 7a 20 3d 20  l, nSql);.  z = 
68b0: 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52  sqlite3DbMallocR
68c0: 61 77 4e 4e 28 64 62 2c 20 6e 5a 29 3b 0a 20 20  awNN(db, nZ);.  
68d0: 69 66 28 20 7a 3d 3d 30 20 29 20 67 6f 74 6f 20  if( z==0 ) goto 
68e0: 6e 6f 72 6d 61 6c 69 7a 65 45 72 72 6f 72 3b 0a  normalizeError;.
68f0: 20 20 66 6f 72 28 69 3d 6a 3d 30 3b 20 69 3c 6e    for(i=j=0; i<n
6900: 53 71 6c 20 26 26 20 7a 53 71 6c 5b 69 5d 3b 20  Sql && zSql[i]; 
6910: 69 2b 3d 6e 29 7b 0a 20 20 20 20 69 6e 74 20 66  i+=n){.    int f
6920: 6c 61 67 73 20 3d 20 30 3b 0a 20 20 20 20 69 66  lags = 0;.    if
6930: 28 20 74 6f 6b 65 6e 54 79 70 65 21 3d 54 4b 5f  ( tokenType!=TK_
6940: 53 50 41 43 45 20 29 20 70 72 65 76 54 6f 6b 65  SPACE ) prevToke
6950: 6e 54 79 70 65 20 3d 20 74 6f 6b 65 6e 54 79 70  nType = tokenTyp
6960: 65 3b 0a 20 20 20 20 6e 20 3d 20 73 71 6c 69 74  e;.    n = sqlit
6970: 65 33 47 65 74 54 6f 6b 65 6e 4e 6f 72 6d 61 6c  e3GetTokenNormal
6980: 69 7a 65 64 28 28 75 6e 73 69 67 6e 65 64 20 63  ized((unsigned c
6990: 68 61 72 2a 29 7a 53 71 6c 2b 69 2c 20 26 74 6f  har*)zSql+i, &to
69a0: 6b 65 6e 54 79 70 65 2c 20 26 66 6c 61 67 73 29  kenType, &flags)
69b0: 3b 0a 20 20 20 20 73 77 69 74 63 68 28 20 74 6f  ;.    switch( to
69c0: 6b 65 6e 54 79 70 65 20 29 7b 0a 20 20 20 20 20  kenType ){.     
69d0: 20 63 61 73 65 20 54 4b 5f 53 50 41 43 45 3a 20   case TK_SPACE: 
69e0: 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  {.        break;
69f0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63  .      }.      c
6a00: 61 73 65 20 54 4b 5f 49 4c 4c 45 47 41 4c 3a 20  ase TK_ILLEGAL: 
6a10: 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6e  {.        goto n
6a20: 6f 72 6d 61 6c 69 7a 65 45 72 72 6f 72 3b 0a 20  ormalizeError;. 
6a30: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73       }.      cas
6a40: 65 20 54 4b 5f 53 54 52 49 4e 47 3a 0a 20 20 20  e TK_STRING:.   
6a50: 20 20 20 63 61 73 65 20 54 4b 5f 49 4e 54 45 47     case TK_INTEG
6a60: 45 52 3a 0a 20 20 20 20 20 20 63 61 73 65 20 54  ER:.      case T
6a70: 4b 5f 46 4c 4f 41 54 3a 0a 20 20 20 20 20 20 63  K_FLOAT:.      c
6a80: 61 73 65 20 54 4b 5f 56 41 52 49 41 42 4c 45 3a  ase TK_VARIABLE:
6a90: 0a 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 42  .      case TK_B
6aa0: 4c 4f 42 3a 20 7b 0a 20 20 20 20 20 20 20 20 7a  LOB: {.        z
6ab0: 5b 6a 2b 2b 5d 20 3d 20 27 3f 27 3b 0a 20 20 20  [j++] = '?';.   
6ac0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
6ad0: 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20 54    }.      case T
6ae0: 4b 5f 4c 50 3a 0a 20 20 20 20 20 20 63 61 73 65  K_LP:.      case
6af0: 20 54 4b 5f 52 50 3a 20 7b 0a 20 20 20 20 20 20   TK_RP: {.      
6b00: 20 20 69 66 28 20 74 6f 6b 65 6e 54 79 70 65 3d    if( tokenType=
6b10: 3d 54 4b 5f 4c 50 20 29 7b 0a 20 20 20 20 20 20  =TK_LP ){.      
6b20: 20 20 20 20 6e 50 61 72 65 6e 2b 2b 3b 0a 20 20      nParen++;.  
6b30: 20 20 20 20 20 20 20 20 69 66 28 20 70 72 65 76          if( prev
6b40: 54 6f 6b 65 6e 54 79 70 65 3d 3d 54 4b 5f 49 4e  TokenType==TK_IN
6b50: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
6b60: 69 53 74 61 72 74 49 4e 20 3d 20 6a 3b 0a 20 20  iStartIN = j;.  
6b70: 20 20 20 20 20 20 20 20 20 20 6e 50 61 72 65 6e            nParen
6b80: 41 74 49 4e 20 3d 20 6e 50 61 72 65 6e 3b 0a 20  AtIN = nParen;. 
6b90: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20           }.     
6ba0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
6bb0: 20 20 20 20 69 66 28 20 69 53 74 61 72 74 49 4e      if( iStartIN
6bc0: 3e 30 20 26 26 20 6e 50 61 72 65 6e 3d 3d 6e 50  >0 && nParen==nP
6bd0: 61 72 65 6e 41 74 49 4e 20 29 7b 0a 20 20 20 20  arenAtIN ){.    
6be0: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
6bf0: 69 53 74 61 72 74 49 4e 2b 36 3c 6e 5a 20 29 3b  iStartIN+6<nZ );
6c00: 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d  .            mem
6c10: 63 70 79 28 7a 2b 69 53 74 61 72 74 49 4e 2b 31  cpy(z+iStartIN+1
6c20: 2c 20 22 3f 2c 3f 2c 3f 22 2c 20 35 29 3b 0a 20  , "?,?,?", 5);. 
6c30: 20 20 20 20 20 20 20 20 20 20 20 6a 20 3d 20 69             j = i
6c40: 53 74 61 72 74 49 4e 2b 36 3b 0a 20 20 20 20 20  StartIN+6;.     
6c50: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e         assert( n
6c60: 5a 2d 31 2d 6a 3e 3d 30 20 29 3b 0a 20 20 20 20  Z-1-j>=0 );.    
6c70: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
6c80: 6e 5a 2d 31 2d 6a 3c 6e 5a 20 29 3b 0a 20 20 20  nZ-1-j<nZ );.   
6c90: 20 20 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28           memset(
6ca0: 7a 2b 6a 2c 20 30 2c 20 6e 5a 2d 31 2d 6a 29 3b  z+j, 0, nZ-1-j);
6cb0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 53 74  .            iSt
6cc0: 61 72 74 49 4e 20 3d 20 30 3b 0a 20 20 20 20 20  artIN = 0;.     
6cd0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
6ce0: 20 6e 50 61 72 65 6e 2d 2d 3b 0a 20 20 20 20 20   nParen--;.     
6cf0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73     }.        ass
6d00: 65 72 74 28 20 6e 50 61 72 65 6e 3e 3d 30 20 29  ert( nParen>=0 )
6d10: 3b 0a 20 20 20 20 20 20 20 20 2f 2a 20 46 61 6c  ;.        /* Fal
6d20: 6c 20 74 68 72 6f 75 67 68 20 2a 2f 0a 20 20 20  l through */.   
6d30: 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20     }.      case 
6d40: 54 4b 5f 4d 49 4e 55 53 3a 0a 20 20 20 20 20 20  TK_MINUS:.      
6d50: 63 61 73 65 20 54 4b 5f 53 45 4d 49 3a 0a 20 20  case TK_SEMI:.  
6d60: 20 20 20 20 63 61 73 65 20 54 4b 5f 50 4c 55 53      case TK_PLUS
6d70: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f  :.      case TK_
6d80: 53 54 41 52 3a 0a 20 20 20 20 20 20 63 61 73 65  STAR:.      case
6d90: 20 54 4b 5f 53 4c 41 53 48 3a 0a 20 20 20 20 20   TK_SLASH:.     
6da0: 20 63 61 73 65 20 54 4b 5f 52 45 4d 3a 0a 20 20   case TK_REM:.  
6db0: 20 20 20 20 63 61 73 65 20 54 4b 5f 45 51 3a 0a      case TK_EQ:.
6dc0: 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 4c 45        case TK_LE
6dd0: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f  :.      case TK_
6de0: 4e 45 3a 0a 20 20 20 20 20 20 63 61 73 65 20 54  NE:.      case T
6df0: 4b 5f 4c 53 48 49 46 54 3a 0a 20 20 20 20 20 20  K_LSHIFT:.      
6e00: 63 61 73 65 20 54 4b 5f 4c 54 3a 0a 20 20 20 20  case TK_LT:.    
6e10: 20 20 63 61 73 65 20 54 4b 5f 52 53 48 49 46 54    case TK_RSHIFT
6e20: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f  :.      case TK_
6e30: 47 54 3a 0a 20 20 20 20 20 20 63 61 73 65 20 54  GT:.      case T
6e40: 4b 5f 47 45 3a 0a 20 20 20 20 20 20 63 61 73 65  K_GE:.      case
6e50: 20 54 4b 5f 42 49 54 4f 52 3a 0a 20 20 20 20 20   TK_BITOR:.     
6e60: 20 63 61 73 65 20 54 4b 5f 43 4f 4e 43 41 54 3a   case TK_CONCAT:
6e70: 0a 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 43  .      case TK_C
6e80: 4f 4d 4d 41 3a 0a 20 20 20 20 20 20 63 61 73 65  OMMA:.      case
6e90: 20 54 4b 5f 42 49 54 41 4e 44 3a 0a 20 20 20 20   TK_BITAND:.    
6ea0: 20 20 63 61 73 65 20 54 4b 5f 42 49 54 4e 4f 54    case TK_BITNOT
6eb0: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f  :.      case TK_
6ec0: 44 4f 54 3a 0a 20 20 20 20 20 20 63 61 73 65 20  DOT:.      case 
6ed0: 54 4b 5f 49 4e 3a 0a 20 20 20 20 20 20 63 61 73  TK_IN:.      cas
6ee0: 65 20 54 4b 5f 49 53 3a 0a 20 20 20 20 20 20 63  e TK_IS:.      c
6ef0: 61 73 65 20 54 4b 5f 4e 4f 54 3a 0a 20 20 20 20  ase TK_NOT:.    
6f00: 20 20 63 61 73 65 20 54 4b 5f 4e 55 4c 4c 3a 0a    case TK_NULL:.
6f10: 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 49 44        case TK_ID
6f20: 3a 20 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20  : {.        if( 
6f30: 74 6f 6b 65 6e 54 79 70 65 3d 3d 54 4b 5f 4e 55  tokenType==TK_NU
6f40: 4c 4c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  LL ){.          
6f50: 69 66 28 20 70 72 65 76 54 6f 6b 65 6e 54 79 70  if( prevTokenTyp
6f60: 65 3d 3d 54 4b 5f 49 53 20 7c 7c 20 70 72 65 76  e==TK_IS || prev
6f70: 54 6f 6b 65 6e 54 79 70 65 3d 3d 54 4b 5f 4e 4f  TokenType==TK_NO
6f80: 54 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  T ){.           
6f90: 20 2f 2a 20 4e 55 4c 4c 20 69 73 20 61 20 6b 65   /* NULL is a ke
6fa0: 79 77 6f 72 64 20 69 6e 20 74 68 69 73 20 63 61  yword in this ca
6fb0: 73 65 2c 20 6e 6f 74 20 61 20 6c 69 74 65 72 61  se, not a litera
6fc0: 6c 20 76 61 6c 75 65 20 2a 2f 0a 20 20 20 20 20  l value */.     
6fd0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
6fe0: 20 20 20 20 20 20 20 20 2f 2a 20 48 65 72 65 20          /* Here 
6ff0: 74 68 65 20 4e 55 4c 4c 20 69 73 20 61 20 6c 69  the NULL is a li
7000: 74 65 72 61 6c 20 76 61 6c 75 65 20 2a 2f 0a 20  teral value */. 
7010: 20 20 20 20 20 20 20 20 20 20 20 7a 5b 6a 2b 2b             z[j++
7020: 5d 20 3d 20 27 3f 27 3b 0a 20 20 20 20 20 20 20  ] = '?';.       
7030: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
7040: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
7050: 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 6a 3e  }.        if( j>
7060: 30 20 26 26 20 73 71 6c 69 74 65 33 49 73 49 64  0 && sqlite3IsId
7070: 43 68 61 72 28 7a 5b 6a 2d 31 5d 29 20 26 26 20  Char(z[j-1]) && 
7080: 73 71 6c 69 74 65 33 49 73 49 64 43 68 61 72 28  sqlite3IsIdChar(
7090: 7a 53 71 6c 5b 69 5d 29 20 29 7b 0a 20 20 20 20  zSql[i]) ){.    
70a0: 20 20 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d 20 27        z[j++] = '
70b0: 20 27 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20   ';.        }.  
70c0: 20 20 20 20 20 20 69 66 28 20 74 6f 6b 65 6e 54        if( tokenT
70d0: 79 70 65 3d 3d 54 4b 5f 49 44 20 29 7b 0a 20 20  ype==TK_ID ){.  
70e0: 20 20 20 20 20 20 20 20 69 66 28 20 7a 53 71 6c          if( zSql
70f0: 5b 69 5d 3d 3d 27 22 27 0a 20 20 20 20 20 20 20  [i]=='"'.       
7100: 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 56 64      && sqlite3Vd
7110: 62 65 55 73 65 73 44 6f 75 62 6c 65 51 75 6f 74  beUsesDoubleQuot
7120: 65 64 53 74 72 69 6e 67 28 64 62 2c 70 56 64 62  edString(db,pVdb
7130: 65 2c 7a 53 71 6c 2b 69 2c 6e 29 0a 20 20 20 20  e,zSql+i,n).    
7140: 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20        ){.       
7150: 20 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d 20 27 3f       z[j++] = '?
7160: 27 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 62  ';.            b
7170: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20  reak;.          
7180: 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20  }.          if( 
7190: 6e 50 61 72 65 6e 3d 3d 6e 50 61 72 65 6e 41 74  nParen==nParenAt
71a0: 49 4e 20 29 20 69 53 74 61 72 74 49 4e 20 3d 20  IN ) iStartIN = 
71b0: 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  0;.        }.   
71c0: 20 20 20 20 20 63 6f 70 79 4e 6f 72 6d 61 6c 69       copyNormali
71d0: 7a 65 64 54 6f 6b 65 6e 28 7a 53 71 6c 2c 20 69  zedToken(zSql, i
71e0: 2c 20 6e 2c 20 66 6c 61 67 73 2c 20 7a 2c 20 26  , n, flags, z, &
71f0: 6a 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61  j);.        brea
7200: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  k;.      }.    }
7210: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6a  .  }.  assert( j
7220: 3c 6e 5a 20 26 26 20 22 6f 6e 65 22 20 29 3b 0a  <nZ && "one" );.
7230: 20 20 77 68 69 6c 65 28 20 6a 3e 30 20 26 26 20    while( j>0 && 
7240: 7a 5b 6a 2d 31 5d 3d 3d 27 20 27 20 29 7b 20 6a  z[j-1]==' ' ){ j
7250: 2d 2d 3b 20 7d 0a 20 20 69 66 28 20 6a 3e 30 20  --; }.  if( j>0 
7260: 26 26 20 7a 5b 6a 2d 31 5d 21 3d 27 3b 27 20 29  && z[j-1]!=';' )
7270: 7b 20 7a 5b 6a 2b 2b 5d 20 3d 20 27 3b 27 3b 20  { z[j++] = ';'; 
7280: 7d 0a 20 20 7a 5b 6a 5d 20 3d 20 30 3b 0a 20 20  }.  z[j] = 0;.  
7290: 61 73 73 65 72 74 28 20 6a 3c 6e 5a 20 26 26 20  assert( j<nZ && 
72a0: 22 74 77 6f 22 20 29 3b 0a 20 20 72 65 74 75 72  "two" );.  retur
72b0: 6e 20 7a 3b 0a 0a 6e 6f 72 6d 61 6c 69 7a 65 45  n z;..normalizeE
72c0: 72 72 6f 72 3a 0a 20 20 73 71 6c 69 74 65 33 44  rror:.  sqlite3D
72d0: 62 46 72 65 65 28 64 62 2c 20 7a 29 3b 0a 20 20  bFree(db, z);.  
72e0: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e 64  return 0;.}.#end
72f0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
7300: 42 4c 45 5f 4e 4f 52 4d 41 4c 49 5a 45 20 2a 2f  BLE_NORMALIZE */
7310: 0a 0a 2f 2a 0a 2a 2a 20 52 65 72 75 6e 20 74 68  ../*.** Rerun th
7320: 65 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 66  e compilation of
7330: 20 61 20 73 74 61 74 65 6d 65 6e 74 20 61 66 74   a statement aft
7340: 65 72 20 61 20 73 63 68 65 6d 61 20 63 68 61 6e  er a schema chan
7350: 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65  ge..**.** If the
7360: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 73 75   statement is su
7370: 63 63 65 73 73 66 75 6c 6c 79 20 72 65 63 6f 6d  ccessfully recom
7380: 70 69 6c 65 64 2c 20 72 65 74 75 72 6e 20 53 51  piled, return SQ
7390: 4c 49 54 45 5f 4f 4b 2e 20 4f 74 68 65 72 77 69  LITE_OK. Otherwi
73a0: 73 65 2c 0a 2a 2a 20 69 66 20 74 68 65 20 73 74  se,.** if the st
73b0: 61 74 65 6d 65 6e 74 20 63 61 6e 6e 6f 74 20 62  atement cannot b
73c0: 65 20 72 65 63 6f 6d 70 69 6c 65 64 20 62 65 63  e recompiled bec
73d0: 61 75 73 65 20 61 6e 6f 74 68 65 72 20 63 6f 6e  ause another con
73e0: 6e 65 63 74 69 6f 6e 20 68 61 73 0a 2a 2a 20 6c  nection has.** l
73f0: 6f 63 6b 65 64 20 74 68 65 20 73 71 6c 69 74 65  ocked the sqlite
7400: 33 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 2c 20  3_master table, 
7410: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f  return SQLITE_LO
7420: 43 4b 45 44 2e 20 49 66 20 61 6e 79 20 6f 74 68  CKED. If any oth
7430: 65 72 20 65 72 72 6f 72 0a 2a 2a 20 6f 63 63 75  er error.** occu
7440: 72 73 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54  rs, return SQLIT
7450: 45 5f 53 43 48 45 4d 41 2e 0a 2a 2f 0a 69 6e 74  E_SCHEMA..*/.int
7460: 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72   sqlite3Reprepar
7470: 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  e(Vdbe *p){.  in
7480: 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f  t rc;.  sqlite3_
7490: 73 74 6d 74 20 2a 70 4e 65 77 3b 0a 20 20 63 6f  stmt *pNew;.  co
74a0: 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a  nst char *zSql;.
74b0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20    sqlite3 *db;. 
74c0: 20 75 38 20 70 72 65 70 46 6c 61 67 73 3b 0a 0a   u8 prepFlags;..
74d0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
74e0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 73 71 6c  3_mutex_held(sql
74f0: 69 74 65 33 56 64 62 65 44 62 28 70 29 2d 3e 6d  ite3VdbeDb(p)->m
7500: 75 74 65 78 29 20 29 3b 0a 20 20 7a 53 71 6c 20  utex) );.  zSql 
7510: 3d 20 73 71 6c 69 74 65 33 5f 73 71 6c 28 28 73  = sqlite3_sql((s
7520: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 29 70 29  qlite3_stmt *)p)
7530: 3b 0a 20 20 61 73 73 65 72 74 28 20 7a 53 71 6c  ;.  assert( zSql
7540: 21 3d 30 20 29 3b 20 20 2f 2a 20 52 65 70 72 65  !=0 );  /* Repre
7550: 70 61 72 65 20 6f 6e 6c 79 20 63 61 6c 6c 65 64  pare only called
7560: 20 66 6f 72 20 70 72 65 70 61 72 65 5f 76 32 28   for prepare_v2(
7570: 29 20 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a  ) statements */.
7580: 20 20 64 62 20 3d 20 73 71 6c 69 74 65 33 56 64    db = sqlite3Vd
7590: 62 65 44 62 28 70 29 3b 0a 20 20 61 73 73 65 72  beDb(p);.  asser
75a0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
75b0: 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29  _held(db->mutex)
75c0: 20 29 3b 0a 20 20 70 72 65 70 46 6c 61 67 73 20   );.  prepFlags 
75d0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 50 72 65  = sqlite3VdbePre
75e0: 70 61 72 65 46 6c 61 67 73 28 70 29 3b 0a 20 20  pareFlags(p);.  
75f0: 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b  rc = sqlite3Lock
7600: 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c 20 7a  AndPrepare(db, z
7610: 53 71 6c 2c 20 2d 31 2c 20 70 72 65 70 46 6c 61  Sql, -1, prepFla
7620: 67 73 2c 20 70 2c 20 26 70 4e 65 77 2c 20 30 29  gs, p, &pNew, 0)
7630: 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20  ;.  if( rc ){.  
7640: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
7650: 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20  _NOMEM ){.      
7660: 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28  sqlite3OomFault(
7670: 64 62 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61  db);.    }.    a
7680: 73 73 65 72 74 28 20 70 4e 65 77 3d 3d 30 20 29  ssert( pNew==0 )
7690: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  ;.    return rc;
76a0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
76b0: 73 65 72 74 28 20 70 4e 65 77 21 3d 30 20 29 3b  sert( pNew!=0 );
76c0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 64  .  }.  sqlite3Vd
76d0: 62 65 53 77 61 70 28 28 56 64 62 65 2a 29 70 4e  beSwap((Vdbe*)pN
76e0: 65 77 2c 20 70 29 3b 0a 20 20 73 71 6c 69 74 65  ew, p);.  sqlite
76f0: 33 54 72 61 6e 73 66 65 72 42 69 6e 64 69 6e 67  3TransferBinding
7700: 73 28 70 4e 65 77 2c 20 28 73 71 6c 69 74 65 33  s(pNew, (sqlite3
7710: 5f 73 74 6d 74 2a 29 70 29 3b 0a 20 20 73 71 6c  _stmt*)p);.  sql
7720: 69 74 65 33 56 64 62 65 52 65 73 65 74 53 74 65  ite3VdbeResetSte
7730: 70 52 65 73 75 6c 74 28 28 56 64 62 65 2a 29 70  pResult((Vdbe*)p
7740: 4e 65 77 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  New);.  sqlite3V
7750: 64 62 65 46 69 6e 61 6c 69 7a 65 28 28 56 64 62  dbeFinalize((Vdb
7760: 65 2a 29 70 4e 65 77 29 3b 0a 20 20 72 65 74 75  e*)pNew);.  retu
7770: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
7780: 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 76 65 72 73  ../*.** Two vers
7790: 69 6f 6e 73 20 6f 66 20 74 68 65 20 6f 66 66 69  ions of the offi
77a0: 63 69 61 6c 20 41 50 49 2e 20 20 4c 65 67 61 63  cial API.  Legac
77b0: 79 20 61 6e 64 20 6e 65 77 20 75 73 65 2e 20 20  y and new use.  
77c0: 49 6e 20 74 68 65 20 6c 65 67 61 63 79 0a 2a 2a  In the legacy.**
77d0: 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72   version, the or
77e0: 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 78 74 20  iginal SQL text 
77f0: 69 73 20 6e 6f 74 20 73 61 76 65 64 20 69 6e 20  is not saved in 
7800: 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61  the prepared sta
7810: 74 65 6d 65 6e 74 0a 2a 2a 20 61 6e 64 20 73 6f  tement.** and so
7820: 20 69 66 20 61 20 73 63 68 65 6d 61 20 63 68 61   if a schema cha
7830: 6e 67 65 20 6f 63 63 75 72 73 2c 20 53 51 4c 49  nge occurs, SQLI
7840: 54 45 5f 53 43 48 45 4d 41 20 69 73 20 72 65 74  TE_SCHEMA is ret
7850: 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69  urned by.** sqli
7860: 74 65 33 5f 73 74 65 70 28 29 2e 20 20 49 6e 20  te3_step().  In 
7870: 74 68 65 20 6e 65 77 20 76 65 72 73 69 6f 6e 2c  the new version,
7880: 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51   the original SQ
7890: 4c 20 74 65 78 74 20 69 73 20 72 65 74 61 69 6e  L text is retain
78a0: 65 64 0a 2a 2a 20 61 6e 64 20 74 68 65 20 73 74  ed.** and the st
78b0: 61 74 65 6d 65 6e 74 20 69 73 20 61 75 74 6f 6d  atement is autom
78c0: 61 74 69 63 61 6c 6c 79 20 72 65 63 6f 6d 70 69  atically recompi
78d0: 6c 65 64 20 69 66 20 61 6e 20 73 63 68 65 6d 61  led if an schema
78e0: 20 63 68 61 6e 67 65 0a 2a 2a 20 6f 63 63 75 72   change.** occur
78f0: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  s..*/.int sqlite
7900: 33 5f 70 72 65 70 61 72 65 28 0a 20 20 73 71 6c  3_prepare(.  sql
7910: 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20  ite3 *db,       
7920: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61         /* Databa
7930: 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20  se handle. */.  
7940: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c  const char *zSql
7950: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46  ,         /* UTF
7960: 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73  -8 encoded SQL s
7970: 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69  tatement. */.  i
7980: 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20  nt nBytes,      
7990: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67           /* Leng
79a0: 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79  th of zSql in by
79b0: 74 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65  tes. */.  sqlite
79c0: 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c  3_stmt **ppStmt,
79d0: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f      /* OUT: A po
79e0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65  inter to the pre
79f0: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
7a00: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
7a10: 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f  **pzTail       /
7a20: 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61  * OUT: End of pa
7a30: 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29  rsed string */.)
7a40: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63  {.  int rc;.  rc
7a50: 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e   = sqlite3LockAn
7a60: 64 50 72 65 70 61 72 65 28 64 62 2c 7a 53 71 6c  dPrepare(db,zSql
7a70: 2c 6e 42 79 74 65 73 2c 30 2c 30 2c 70 70 53 74  ,nBytes,0,0,ppSt
7a80: 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73  mt,pzTail);.  as
7a90: 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45  sert( rc==SQLITE
7aa0: 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30  _OK || ppStmt==0
7ab0: 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29   || *ppStmt==0 )
7ac0: 3b 20 20 2f 2a 20 56 45 52 49 46 59 3a 20 46 31  ;  /* VERIFY: F1
7ad0: 33 30 32 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e  3021 */.  return
7ae0: 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74   rc;.}.int sqlit
7af0: 65 33 5f 70 72 65 70 61 72 65 5f 76 32 28 0a 20  e3_prepare_v2(. 
7b00: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
7b10: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61             /* Da
7b20: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a  tabase handle. *
7b30: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
7b40: 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a  zSql,         /*
7b50: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53   UTF-8 encoded S
7b60: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f  QL statement. */
7b70: 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20  .  int nBytes,  
7b80: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7b90: 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69  Length of zSql i
7ba0: 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71  n bytes. */.  sq
7bb0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53  lite3_stmt **ppS
7bc0: 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20  tmt,    /* OUT: 
7bd0: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  A pointer to the
7be0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
7bf0: 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  ent */.  const c
7c00: 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20  har **pzTail    
7c10: 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f     /* OUT: End o
7c20: 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20  f parsed string 
7c30: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  */.){.  int rc;.
7c40: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46    /* EVIDENCE-OF
7c50: 3a 20 52 2d 33 37 39 32 33 2d 31 32 31 37 33 20  : R-37923-12173 
7c60: 54 68 65 20 73 71 6c 69 74 65 33 5f 70 72 65 70  The sqlite3_prep
7c70: 61 72 65 5f 76 32 28 29 20 69 6e 74 65 72 66 61  are_v2() interfa
7c80: 63 65 20 77 6f 72 6b 73 0a 20 20 2a 2a 20 65 78  ce works.  ** ex
7c90: 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 20 61  actly the same a
7ca0: 73 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72  s sqlite3_prepar
7cb0: 65 5f 76 33 28 29 20 77 69 74 68 20 61 20 7a 65  e_v3() with a ze
7cc0: 72 6f 20 70 72 65 70 46 6c 61 67 73 0a 20 20 2a  ro prepFlags.  *
7cd0: 2a 20 70 61 72 61 6d 65 74 65 72 2e 0a 20 20 2a  * parameter..  *
7ce0: 2a 0a 20 20 2a 2a 20 50 72 6f 6f 66 20 69 6e 20  *.  ** Proof in 
7cf0: 74 68 61 74 20 74 68 65 20 35 74 68 20 70 61 72  that the 5th par
7d00: 61 6d 65 74 65 72 20 74 6f 20 73 71 6c 69 74 65  ameter to sqlite
7d10: 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 20  3LockAndPrepare 
7d20: 69 73 20 30 20 2a 2f 0a 20 20 72 63 20 3d 20 73  is 0 */.  rc = s
7d30: 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65  qlite3LockAndPre
7d40: 70 61 72 65 28 64 62 2c 7a 53 71 6c 2c 6e 42 79  pare(db,zSql,nBy
7d50: 74 65 73 2c 53 51 4c 49 54 45 5f 50 52 45 50 41  tes,SQLITE_PREPA
7d60: 52 45 5f 53 41 56 45 53 51 4c 2c 30 2c 0a 20 20  RE_SAVESQL,0,.  
7d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7d80: 20 20 20 20 20 20 20 20 20 20 20 70 70 53 74 6d             ppStm
7d90: 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73  t,pzTail);.  ass
7da0: 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f  ert( rc==SQLITE_
7db0: 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20  OK || ppStmt==0 
7dc0: 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b  || *ppStmt==0 );
7dd0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
7de0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70  int sqlite3_prep
7df0: 61 72 65 5f 76 33 28 0a 20 20 73 71 6c 69 74 65  are_v3(.  sqlite
7e00: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
7e10: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20      /* Database 
7e20: 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e  handle. */.  con
7e30: 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20  st char *zSql,  
7e40: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20         /* UTF-8 
7e50: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
7e60: 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20  ement. */.  int 
7e70: 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20  nBytes,         
7e80: 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20        /* Length 
7e90: 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73  of zSql in bytes
7ea0: 2e 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  . */.  unsigned 
7eb0: 69 6e 74 20 70 72 65 70 46 6c 61 67 73 2c 20 20  int prepFlags,  
7ec0: 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65   /* Zero or more
7ed0: 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f   SQLITE_PREPARE_
7ee0: 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 20 73 71 6c  * flags */.  sql
7ef0: 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74  ite3_stmt **ppSt
7f00: 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41  mt,    /* OUT: A
7f10: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
7f20: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
7f30: 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  nt */.  const ch
7f40: 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20  ar **pzTail     
7f50: 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66    /* OUT: End of
7f60: 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20 2a   parsed string *
7f70: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  /.){.  int rc;. 
7f80: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a   /* EVIDENCE-OF:
7f90: 20 52 2d 35 36 38 36 31 2d 34 32 36 37 33 20 73   R-56861-42673 s
7fa0: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76  qlite3_prepare_v
7fb0: 33 28 29 20 64 69 66 66 65 72 73 20 66 72 6f 6d  3() differs from
7fc0: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 70 72  .  ** sqlite3_pr
7fd0: 65 70 61 72 65 5f 76 32 28 29 20 6f 6e 6c 79 20  epare_v2() only 
7fe0: 69 6e 20 68 61 76 69 6e 67 20 74 68 65 20 65 78  in having the ex
7ff0: 74 72 61 20 70 72 65 70 46 6c 61 67 73 20 70 61  tra prepFlags pa
8000: 72 61 6d 65 74 65 72 2c 0a 20 20 2a 2a 20 77 68  rameter,.  ** wh
8010: 69 63 68 20 69 73 20 61 20 62 69 74 20 61 72 72  ich is a bit arr
8020: 61 79 20 63 6f 6e 73 69 73 74 69 6e 67 20 6f 66  ay consisting of
8030: 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 6f 66   zero or more of
8040: 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45   the.  ** SQLITE
8050: 5f 50 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 73  _PREPARE_* flags
8060: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 50 72 6f 6f  ..  **.  ** Proo
8070: 66 20 62 79 20 63 6f 6d 70 61 72 69 73 6f 6e 20  f by comparison 
8080: 74 6f 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  to the implement
8090: 61 74 69 6f 6e 20 6f 66 20 73 71 6c 69 74 65 33  ation of sqlite3
80a0: 5f 70 72 65 70 61 72 65 5f 76 32 28 29 0a 20 20  _prepare_v2().  
80b0: 2a 2a 20 64 69 72 65 63 74 6c 79 20 61 62 6f 76  ** directly abov
80c0: 65 2e 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c  e. */.  rc = sql
80d0: 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61  ite3LockAndPrepa
80e0: 72 65 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65  re(db,zSql,nByte
80f0: 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  s,.             
8100: 20 20 20 20 53 51 4c 49 54 45 5f 50 52 45 50 41      SQLITE_PREPA
8110: 52 45 5f 53 41 56 45 53 51 4c 7c 28 70 72 65 70  RE_SAVESQL|(prep
8120: 46 6c 61 67 73 26 53 51 4c 49 54 45 5f 50 52 45  Flags&SQLITE_PRE
8130: 50 41 52 45 5f 4d 41 53 4b 29 2c 0a 20 20 20 20  PARE_MASK),.    
8140: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 2c 70               0,p
8150: 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20  pStmt,pzTail);. 
8160: 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c   assert( rc==SQL
8170: 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74  ITE_OK || ppStmt
8180: 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d  ==0 || *ppStmt==
8190: 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  0 );.  return rc
81a0: 3b 0a 7d 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51  ;.}...#ifndef SQ
81b0: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
81c0: 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 74 68  /*.** Compile th
81d0: 65 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64  e UTF-16 encoded
81e0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a   SQL statement z
81f0: 53 71 6c 20 69 6e 74 6f 20 61 20 73 74 61 74 65  Sql into a state
8200: 6d 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a  ment handle..*/.
8210: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
8220: 65 33 50 72 65 70 61 72 65 31 36 28 0a 20 20 73  e3Prepare16(.  s
8230: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
8240: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61           /* Data
8250: 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 20  base handle. */ 
8260: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a  .  const void *z
8270: 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20  Sql,         /* 
8280: 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 53  UTF-16 encoded S
8290: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f  QL statement. */
82a0: 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20  .  int nBytes,  
82b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
82c0: 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69  Length of zSql i
82d0: 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 33  n bytes. */.  u3
82e0: 32 20 70 72 65 70 46 6c 61 67 73 2c 20 20 20 20  2 prepFlags,    
82f0: 20 20 20 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20          /* Zero 
8300: 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50  or more SQLITE_P
8310: 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a  REPARE_* flags *
8320: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74  /.  sqlite3_stmt
8330: 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a   **ppStmt,    /*
8340: 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20   OUT: A pointer 
8350: 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20  to the prepared 
8360: 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63  statement */.  c
8370: 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61  onst void **pzTa
8380: 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a  il       /* OUT:
8390: 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73   End of parsed s
83a0: 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 2f 2a  tring */.){.  /*
83b0: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63   This function c
83c0: 75 72 72 65 6e 74 6c 79 20 77 6f 72 6b 73 20 62  urrently works b
83d0: 79 20 66 69 72 73 74 20 74 72 61 6e 73 66 6f 72  y first transfor
83e0: 6d 69 6e 67 20 74 68 65 20 55 54 46 2d 31 36 0a  ming the UTF-16.
83f0: 20 20 2a 2a 20 65 6e 63 6f 64 65 64 20 73 74 72    ** encoded str
8400: 69 6e 67 20 74 6f 20 55 54 46 2d 38 2c 20 74 68  ing to UTF-8, th
8410: 65 6e 20 69 6e 76 6f 6b 69 6e 67 20 73 71 6c 69  en invoking sqli
8420: 74 65 33 5f 70 72 65 70 61 72 65 28 29 2e 20 54  te3_prepare(). T
8430: 68 65 0a 20 20 2a 2a 20 74 72 69 63 6b 79 20 62  he.  ** tricky b
8440: 69 74 20 69 73 20 66 69 67 75 72 69 6e 67 20 6f  it is figuring o
8450: 75 74 20 74 68 65 20 70 6f 69 6e 74 65 72 20 74  ut the pointer t
8460: 6f 20 72 65 74 75 72 6e 20 69 6e 20 2a 70 7a 54  o return in *pzT
8470: 61 69 6c 2e 0a 20 20 2a 2f 0a 20 20 63 68 61 72  ail..  */.  char
8480: 20 2a 7a 53 71 6c 38 3b 0a 20 20 63 6f 6e 73 74   *zSql8;.  const
8490: 20 63 68 61 72 20 2a 7a 54 61 69 6c 38 20 3d 20   char *zTail8 = 
84a0: 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  0;.  int rc = SQ
84b0: 4c 49 54 45 5f 4f 4b 3b 0a 0a 23 69 66 64 65 66  LITE_OK;..#ifdef
84c0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41   SQLITE_ENABLE_A
84d0: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 70  PI_ARMOR.  if( p
84e0: 70 53 74 6d 74 3d 3d 30 20 29 20 72 65 74 75 72  pStmt==0 ) retur
84f0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f  n SQLITE_MISUSE_
8500: 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 2a  BKPT;.#endif.  *
8510: 70 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20 69 66  ppStmt = 0;.  if
8520: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79  ( !sqlite3Safety
8530: 43 68 65 63 6b 4f 6b 28 64 62 29 7c 7c 7a 53 71  CheckOk(db)||zSq
8540: 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  l==0 ){.    retu
8550: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
8560: 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28  _BKPT;.  }.  if(
8570: 20 6e 42 79 74 65 73 3e 3d 30 20 29 7b 0a 20 20   nBytes>=0 ){.  
8580: 20 20 69 6e 74 20 73 7a 3b 0a 20 20 20 20 63 6f    int sz;.    co
8590: 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 28 63  nst char *z = (c
85a0: 6f 6e 73 74 20 63 68 61 72 2a 29 7a 53 71 6c 3b  onst char*)zSql;
85b0: 0a 20 20 20 20 66 6f 72 28 73 7a 3d 30 3b 20 73  .    for(sz=0; s
85c0: 7a 3c 6e 42 79 74 65 73 20 26 26 20 28 7a 5b 73  z<nBytes && (z[s
85d0: 7a 5d 21 3d 30 20 7c 7c 20 7a 5b 73 7a 2b 31 5d  z]!=0 || z[sz+1]
85e0: 21 3d 30 29 3b 20 73 7a 20 2b 3d 20 32 29 7b 7d  !=0); sz += 2){}
85f0: 0a 20 20 20 20 6e 42 79 74 65 73 20 3d 20 73 7a  .    nBytes = sz
8600: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f  ;.  }.  sqlite3_
8610: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e  mutex_enter(db->
8620: 6d 75 74 65 78 29 3b 0a 20 20 7a 53 71 6c 38 20  mutex);.  zSql8 
8630: 3d 20 73 71 6c 69 74 65 33 55 74 66 31 36 74 6f  = sqlite3Utf16to
8640: 38 28 64 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74  8(db, zSql, nByt
8650: 65 73 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  es, SQLITE_UTF16
8660: 4e 41 54 49 56 45 29 3b 0a 20 20 69 66 28 20 7a  NATIVE);.  if( z
8670: 53 71 6c 38 20 29 7b 0a 20 20 20 20 72 63 20 3d  Sql8 ){.    rc =
8680: 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50   sqlite3LockAndP
8690: 72 65 70 61 72 65 28 64 62 2c 20 7a 53 71 6c 38  repare(db, zSql8
86a0: 2c 20 2d 31 2c 20 70 72 65 70 46 6c 61 67 73 2c  , -1, prepFlags,
86b0: 20 30 2c 20 70 70 53 74 6d 74 2c 20 26 7a 54 61   0, ppStmt, &zTa
86c0: 69 6c 38 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  il8);.  }..  if(
86d0: 20 7a 54 61 69 6c 38 20 26 26 20 70 7a 54 61 69   zTail8 && pzTai
86e0: 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 73  l ){.    /* If s
86f0: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 20 72  qlite3_prepare r
8700: 65 74 75 72 6e 73 20 61 20 74 61 69 6c 20 70 6f  eturns a tail po
8710: 69 6e 74 65 72 2c 20 77 65 20 63 61 6c 63 75 6c  inter, we calcul
8720: 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 65  ate the.    ** e
8730: 71 75 69 76 61 6c 65 6e 74 20 70 6f 69 6e 74 65  quivalent pointe
8740: 72 20 69 6e 74 6f 20 74 68 65 20 55 54 46 2d 31  r into the UTF-1
8750: 36 20 73 74 72 69 6e 67 20 62 79 20 63 6f 75 6e  6 string by coun
8760: 74 69 6e 67 20 74 68 65 20 75 6e 69 63 6f 64 65  ting the unicode
8770: 0a 20 20 20 20 2a 2a 20 63 68 61 72 61 63 74 65  .    ** characte
8780: 72 73 20 62 65 74 77 65 65 6e 20 7a 53 71 6c 38  rs between zSql8
8790: 20 61 6e 64 20 7a 54 61 69 6c 38 2c 20 61 6e 64   and zTail8, and
87a0: 20 74 68 65 6e 20 72 65 74 75 72 6e 69 6e 67 20   then returning 
87b0: 61 20 70 6f 69 6e 74 65 72 0a 20 20 20 20 2a 2a  a pointer.    **
87c0: 20 74 68 65 20 73 61 6d 65 20 6e 75 6d 62 65 72   the same number
87d0: 20 6f 66 20 63 68 61 72 61 63 74 65 72 73 20 69   of characters i
87e0: 6e 74 6f 20 74 68 65 20 55 54 46 2d 31 36 20 73  nto the UTF-16 s
87f0: 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20 20  tring..    */.  
8800: 20 20 69 6e 74 20 63 68 61 72 73 5f 70 61 72 73    int chars_pars
8810: 65 64 20 3d 20 73 71 6c 69 74 65 33 55 74 66 38  ed = sqlite3Utf8
8820: 43 68 61 72 4c 65 6e 28 7a 53 71 6c 38 2c 20 28  CharLen(zSql8, (
8830: 69 6e 74 29 28 7a 54 61 69 6c 38 2d 7a 53 71 6c  int)(zTail8-zSql
8840: 38 29 29 3b 0a 20 20 20 20 2a 70 7a 54 61 69 6c  8));.    *pzTail
8850: 20 3d 20 28 75 38 20 2a 29 7a 53 71 6c 20 2b 20   = (u8 *)zSql + 
8860: 73 71 6c 69 74 65 33 55 74 66 31 36 42 79 74 65  sqlite3Utf16Byte
8870: 4c 65 6e 28 7a 53 71 6c 2c 20 63 68 61 72 73 5f  Len(zSql, chars_
8880: 70 61 72 73 65 64 29 3b 0a 20 20 7d 0a 20 20 73  parsed);.  }.  s
8890: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c  qlite3DbFree(db,
88a0: 20 7a 53 71 6c 38 29 3b 20 0a 20 20 72 63 20 3d   zSql8); .  rc =
88b0: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
88c0: 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 74  db, rc);.  sqlit
88d0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64  e3_mutex_leave(d
88e0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74  b->mutex);.  ret
88f0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
8900: 20 54 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66   Two versions of
8910: 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 41 50   the official AP
8920: 49 2e 20 20 4c 65 67 61 63 79 20 61 6e 64 20 6e  I.  Legacy and n
8930: 65 77 20 75 73 65 2e 20 20 49 6e 20 74 68 65 20  ew use.  In the 
8940: 6c 65 67 61 63 79 0a 2a 2a 20 76 65 72 73 69 6f  legacy.** versio
8950: 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20  n, the original 
8960: 53 51 4c 20 74 65 78 74 20 69 73 20 6e 6f 74 20  SQL text is not 
8970: 73 61 76 65 64 20 69 6e 20 74 68 65 20 70 72 65  saved in the pre
8980: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 0a  pared statement.
8990: 2a 2a 20 61 6e 64 20 73 6f 20 69 66 20 61 20 73  ** and so if a s
89a0: 63 68 65 6d 61 20 63 68 61 6e 67 65 20 6f 63 63  chema change occ
89b0: 75 72 73 2c 20 53 51 4c 49 54 45 5f 53 43 48 45  urs, SQLITE_SCHE
89c0: 4d 41 20 69 73 20 72 65 74 75 72 6e 65 64 20 62  MA is returned b
89d0: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74 65  y.** sqlite3_ste
89e0: 70 28 29 2e 20 20 49 6e 20 74 68 65 20 6e 65 77  p().  In the new
89f0: 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72   version, the or
8a00: 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 78 74 20  iginal SQL text 
8a10: 69 73 20 72 65 74 61 69 6e 65 64 0a 2a 2a 20 61  is retained.** a
8a20: 6e 64 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  nd the statement
8a30: 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   is automaticall
8a40: 79 20 72 65 63 6f 6d 70 69 6c 65 64 20 69 66 20  y recompiled if 
8a50: 61 6e 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65  an schema change
8a60: 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69  .** occurs..*/.i
8a70: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
8a80: 72 65 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20  re16(.  sqlite3 
8a90: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
8aa0: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61    /* Database ha
8ab0: 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73  ndle. */ .  cons
8ac0: 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 20  t void *zSql,   
8ad0: 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 31 36 20        /* UTF-16 
8ae0: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
8af0: 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20  ement. */.  int 
8b00: 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20  nBytes,         
8b10: 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20        /* Length 
8b20: 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73  of zSql in bytes
8b30: 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73  . */.  sqlite3_s
8b40: 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20  tmt **ppStmt,   
8b50: 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74   /* OUT: A point
8b60: 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72  er to the prepar
8b70: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a  ed statement */.
8b80: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70    const void **p
8b90: 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f  zTail       /* O
8ba0: 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65  UT: End of parse
8bb0: 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20  d string */.){. 
8bc0: 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d 20   int rc;.  rc = 
8bd0: 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 31 36  sqlite3Prepare16
8be0: 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c  (db,zSql,nBytes,
8bf0: 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29  0,ppStmt,pzTail)
8c00: 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d  ;.  assert( rc==
8c10: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53  SQLITE_OK || ppS
8c20: 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d  tmt==0 || *ppStm
8c30: 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49  t==0 );  /* VERI
8c40: 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20  FY: F13021 */.  
8c50: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74  return rc;.}.int
8c60: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
8c70: 31 36 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 33  16_v2(.  sqlite3
8c80: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20   *db,           
8c90: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68     /* Database h
8ca0: 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e  andle. */ .  con
8cb0: 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20  st void *zSql,  
8cc0: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 31 36         /* UTF-16
8cd0: 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61   encoded SQL sta
8ce0: 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74  tement. */.  int
8cf0: 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20   nBytes,        
8d00: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68         /* Length
8d10: 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65   of zSql in byte
8d20: 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  s. */.  sqlite3_
8d30: 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20  stmt **ppStmt,  
8d40: 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e    /* OUT: A poin
8d50: 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61  ter to the prepa
8d60: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f  red statement */
8d70: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a  .  const void **
8d80: 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20  pzTail       /* 
8d90: 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73  OUT: End of pars
8da0: 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a  ed string */.){.
8db0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d    int rc;.  rc =
8dc0: 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 31   sqlite3Prepare1
8dd0: 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73  6(db,zSql,nBytes
8de0: 2c 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f  ,SQLITE_PREPARE_
8df0: 53 41 56 45 53 51 4c 2c 70 70 53 74 6d 74 2c 70  SAVESQL,ppStmt,p
8e00: 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73 65 72 74  zTail);.  assert
8e10: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
8e20: 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20  || ppStmt==0 || 
8e30: 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 20 20 2f  *ppStmt==0 );  /
8e40: 2a 20 56 45 52 49 46 59 3a 20 46 31 33 30 32 31  * VERIFY: F13021
8e50: 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b   */.  return rc;
8e60: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70  .}.int sqlite3_p
8e70: 72 65 70 61 72 65 31 36 5f 76 33 28 0a 20 20 73  repare16_v3(.  s
8e80: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
8e90: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61           /* Data
8ea0: 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 20  base handle. */ 
8eb0: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a  .  const void *z
8ec0: 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20  Sql,         /* 
8ed0: 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 53  UTF-16 encoded S
8ee0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f  QL statement. */
8ef0: 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20  .  int nBytes,  
8f00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
8f10: 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69  Length of zSql i
8f20: 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 6e  n bytes. */.  un
8f30: 73 69 67 6e 65 64 20 69 6e 74 20 70 72 65 70 46  signed int prepF
8f40: 6c 61 67 73 2c 20 20 20 2f 2a 20 5a 65 72 6f 20  lags,   /* Zero 
8f50: 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50  or more SQLITE_P
8f60: 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a  REPARE_* flags *
8f70: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74  /.  sqlite3_stmt
8f80: 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a   **ppStmt,    /*
8f90: 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20   OUT: A pointer 
8fa0: 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20  to the prepared 
8fb0: 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63  statement */.  c
8fc0: 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61  onst void **pzTa
8fd0: 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a  il       /* OUT:
8fe0: 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73   End of parsed s
8ff0: 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e  tring */.){.  in
9000: 74 20 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c  t rc;.  rc = sql
9010: 69 74 65 33 50 72 65 70 61 72 65 31 36 28 64 62  ite3Prepare16(db
9020: 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 0a 20 20  ,zSql,nBytes,.  
9030: 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 50 52         SQLITE_PR
9040: 45 50 41 52 45 5f 53 41 56 45 53 51 4c 7c 28 70  EPARE_SAVESQL|(p
9050: 72 65 70 46 6c 61 67 73 26 53 51 4c 49 54 45 5f  repFlags&SQLITE_
9060: 50 52 45 50 41 52 45 5f 4d 41 53 4b 29 2c 0a 20  PREPARE_MASK),. 
9070: 20 20 20 20 20 20 20 20 70 70 53 74 6d 74 2c 70          ppStmt,p
9080: 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73 65 72 74  zTail);.  assert
9090: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
90a0: 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20  || ppStmt==0 || 
90b0: 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 20 20 2f  *ppStmt==0 );  /
90c0: 2a 20 56 45 52 49 46 59 3a 20 46 31 33 30 32 31  * VERIFY: F13021
90d0: 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b   */.  return rc;
90e0: 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  .}..#endif /* SQ
90f0: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20  LITE_OMIT_UTF16 
9100: 2a 2f 0a                                         */.