/ Hex Artifact Content
Login

Artifact 95a915b2fe9bd879aa47f80472654f11e033b7a6:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 4d 61 69 6e 20 66  ******.** Main f
0180: 69 6c 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69  ile for the SQLi
0190: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 54 68 65  te library.  The
01a0: 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 69   routines in thi
01b0: 73 20 66 69 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d  s file.** implem
01c0: 65 6e 74 20 74 68 65 20 70 72 6f 67 72 61 6d 6d  ent the programm
01d0: 65 72 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20  er interface to 
01e0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 52 6f  the library.  Ro
01f0: 75 74 69 6e 65 73 20 69 6e 0a 2a 2a 20 6f 74 68  utines in.** oth
0200: 65 72 20 66 69 6c 65 73 20 61 72 65 20 66 6f 72  er files are for
0210: 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 20 62 79   internal use by
0220: 20 53 51 4c 69 74 65 20 61 6e 64 20 73 68 6f 75   SQLite and shou
0230: 6c 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 63 63  ld not be.** acc
0240: 65 73 73 65 64 20 62 79 20 75 73 65 72 73 20 6f  essed by users o
0250: 66 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 2a  f the library..*
0260: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 69 6e 2e 63  *.** $Id: main.c
0270: 2c 76 20 31 2e 32 34 32 20 32 30 30 34 2f 30 36  ,v 1.242 2004/06
0280: 2f 32 39 20 31 33 3a 31 38 3a 32 34 20 64 61 6e  /29 13:18:24 dan
0290: 69 65 6c 6b 31 39 37 37 20 45 78 70 20 24 0a 2a  ielk1977 Exp $.*
02a0: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69  /.#include "sqli
02b0: 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64  teInt.h".#includ
02c0: 65 20 22 6f 73 2e 68 22 0a 23 69 6e 63 6c 75 64  e "os.h".#includ
02d0: 65 20 3c 63 74 79 70 65 2e 68 3e 0a 0a 2f 2a 0a  e <ctype.h>../*.
02e0: 2a 2a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20  ** A pointer to 
02f0: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 69  this structure i
0300: 73 20 75 73 65 64 20 74 6f 20 63 6f 6d 6d 75 6e  s used to commun
0310: 69 63 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f  icate informatio
0320: 6e 0a 2a 2a 20 66 72 6f 6d 20 73 71 6c 69 74 65  n.** from sqlite
0330: 33 49 6e 69 74 20 69 6e 74 6f 20 74 68 65 20 73  3Init into the s
0340: 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61  qlite3InitCallba
0350: 63 6b 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73  ck..*/.typedef s
0360: 74 72 75 63 74 20 7b 0a 20 20 73 71 6c 69 74 65  truct {.  sqlite
0370: 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20 2f 2a   *db;         /*
0380: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 62 65   The database be
0390: 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20  ing initialized 
03a0: 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72  */.  char **pzEr
03b0: 72 4d 73 67 3b 20 20 20 20 2f 2a 20 45 72 72 6f  rMsg;    /* Erro
03c0: 72 20 6d 65 73 73 61 67 65 20 73 74 6f 72 65 64  r message stored
03d0: 20 68 65 72 65 20 2a 2f 0a 7d 20 49 6e 69 74 44   here */.} InitD
03e0: 61 74 61 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  ata;../*.** The 
03f0: 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6e 73 74 61  following consta
0400: 6e 74 20 76 61 6c 75 65 20 69 73 20 75 73 65 64  nt value is used
0410: 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f 42   by the SQLITE_B
0420: 49 47 45 4e 44 49 41 4e 20 61 6e 64 0a 2a 2a 20  IGENDIAN and.** 
0430: 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44  SQLITE_LITTLEEND
0440: 49 41 4e 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a 63  IAN macros..*/.c
0450: 6f 6e 73 74 20 69 6e 74 20 73 71 6c 69 74 65 33  onst int sqlite3
0460: 6f 6e 65 20 3d 20 31 3b 0a 0a 2f 2a 0a 2a 2a 20  one = 1;../*.** 
0470: 46 69 6c 6c 20 74 68 65 20 49 6e 69 74 44 61 74  Fill the InitDat
0480: 61 20 73 74 72 75 63 74 75 72 65 20 77 69 74 68  a structure with
0490: 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67   an error messag
04a0: 65 20 74 68 61 74 20 69 6e 64 69 63 61 74 65 73  e that indicates
04b0: 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 64 61 74  .** that the dat
04c0: 61 62 61 73 65 20 69 73 20 63 6f 72 72 75 70 74  abase is corrupt
04d0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
04e0: 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 49   corruptSchema(I
04f0: 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61 2c 20  nitData *pData, 
0500: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 78 74  const char *zExt
0510: 72 61 29 7b 0a 20 20 69 66 28 20 21 73 71 6c 69  ra){.  if( !sqli
0520: 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65  te3_malloc_faile
0530: 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  d ){.    sqlite3
0540: 53 65 74 53 74 72 69 6e 67 28 70 44 61 74 61 2d  SetString(pData-
0550: 3e 70 7a 45 72 72 4d 73 67 2c 20 22 6d 61 6c 66  >pzErrMsg, "malf
0560: 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 73  ormed database s
0570: 63 68 65 6d 61 22 2c 0a 20 20 20 20 20 20 20 7a  chema",.       z
0580: 45 78 74 72 61 21 3d 30 20 26 26 20 7a 45 78 74  Extra!=0 && zExt
0590: 72 61 5b 30 5d 21 3d 30 20 3f 20 22 20 2d 20 22  ra[0]!=0 ? " - "
05a0: 20 3a 20 28 63 68 61 72 2a 29 30 2c 20 7a 45 78   : (char*)0, zEx
05b0: 74 72 61 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a  tra, (char*)0);.
05c0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69    }.}../*.** Thi
05d0: 73 20 69 73 20 74 68 65 20 63 61 6c 6c 62 61 63  s is the callbac
05e0: 6b 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 74 68  k routine for th
05f0: 65 20 63 6f 64 65 20 74 68 61 74 20 69 6e 69 74  e code that init
0600: 69 61 6c 69 7a 65 73 20 74 68 65 0a 2a 2a 20 64  ializes the.** d
0610: 61 74 61 62 61 73 65 2e 20 20 53 65 65 20 73 71  atabase.  See sq
0620: 6c 69 74 65 33 49 6e 69 74 28 29 20 62 65 6c 6f  lite3Init() belo
0630: 77 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  w for additional
0640: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2a   information..**
0650: 0a 2a 2a 20 45 61 63 68 20 63 61 6c 6c 62 61 63  .** Each callbac
0660: 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66  k contains the f
0670: 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61  ollowing informa
0680: 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  tion:.**.**     
0690: 61 72 67 76 5b 30 5d 20 3d 20 22 66 69 6c 65 2d  argv[0] = "file-
06a0: 66 6f 72 6d 61 74 22 20 6f 72 20 22 73 63 68 65  format" or "sche
06b0: 6d 61 2d 63 6f 6f 6b 69 65 22 20 6f 72 20 22 74  ma-cookie" or "t
06c0: 61 62 6c 65 22 20 6f 72 20 22 69 6e 64 65 78 22  able" or "index"
06d0: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 31 5d 20  .**     argv[1] 
06e0: 3d 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  = table or index
06f0: 20 6e 61 6d 65 20 6f 72 20 6d 65 74 61 20 73 74   name or meta st
0700: 61 74 65 6d 65 6e 74 20 74 79 70 65 2e 0a 2a 2a  atement type..**
0710: 20 20 20 20 20 61 72 67 76 5b 32 5d 20 3d 20 72       argv[2] = r
0720: 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20  oot page number 
0730: 66 6f 72 20 74 61 62 6c 65 20 6f 72 20 69 6e 64  for table or ind
0740: 65 78 2e 20 20 4e 55 4c 4c 20 66 6f 72 20 6d 65  ex.  NULL for me
0750: 74 61 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  ta..**     argv[
0760: 33 5d 20 3d 20 53 51 4c 20 74 65 78 74 20 66 6f  3] = SQL text fo
0770: 72 20 61 20 43 52 45 41 54 45 20 54 41 42 4c 45  r a CREATE TABLE
0780: 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44 45 58   or CREATE INDEX
0790: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 20   statement..**  
07a0: 20 20 20 61 72 67 76 5b 34 5d 20 3d 20 22 31 22     argv[4] = "1"
07b0: 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 66   for temporary f
07c0: 69 6c 65 73 2c 20 22 30 22 20 66 6f 72 20 6d 61  iles, "0" for ma
07d0: 69 6e 20 64 61 74 61 62 61 73 65 2c 20 22 32 22  in database, "2"
07e0: 20 6f 72 20 6d 6f 72 65 0a 2a 2a 20 20 20 20 20   or more.**     
07f0: 20 20 20 20 20 20 20 20 20 20 66 6f 72 20 61 75            for au
0800: 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73 65  xiliary database
0810: 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2f 0a 73 74   files..**.*/.st
0820: 61 74 69 63 0a 69 6e 74 20 73 71 6c 69 74 65 33  atic.int sqlite3
0830: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76 6f 69  InitCallback(voi
0840: 64 20 2a 70 49 6e 69 74 2c 20 69 6e 74 20 61 72  d *pInit, int ar
0850: 67 63 2c 20 63 68 61 72 20 2a 2a 61 72 67 76 2c  gc, char **argv,
0860: 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 4e 61 6d   char **azColNam
0870: 65 29 7b 0a 20 20 49 6e 69 74 44 61 74 61 20 2a  e){.  InitData *
0880: 70 44 61 74 61 20 3d 20 28 49 6e 69 74 44 61 74  pData = (InitDat
0890: 61 2a 29 70 49 6e 69 74 3b 0a 20 20 69 6e 74 20  a*)pInit;.  int 
08a0: 6e 45 72 72 20 3d 20 30 3b 0a 0a 20 20 61 73 73  nErr = 0;..  ass
08b0: 65 72 74 28 20 61 72 67 63 3d 3d 35 20 29 3b 0a  ert( argc==5 );.
08c0: 20 20 69 66 28 20 61 72 67 76 3d 3d 30 20 29 20    if( argv==0 ) 
08d0: 72 65 74 75 72 6e 20 30 3b 20 20 20 2f 2a 20 4d  return 0;   /* M
08e0: 69 67 68 74 20 68 61 70 70 65 6e 20 69 66 20 45  ight happen if E
08f0: 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43 41 4c 4c  MPTY_RESULT_CALL
0900: 42 41 43 4b 53 20 61 72 65 20 6f 6e 20 2a 2f 0a  BACKS are on */.
0910: 20 20 69 66 28 20 61 72 67 76 5b 30 5d 3d 3d 30    if( argv[0]==0
0920: 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53   ){.    corruptS
0930: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 30 29 3b  chema(pData, 0);
0940: 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20  .    return 1;. 
0950: 20 7d 0a 20 20 73 77 69 74 63 68 28 20 61 72 67   }.  switch( arg
0960: 76 5b 30 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 63  v[0][0] ){.    c
0970: 61 73 65 20 27 76 27 3a 0a 20 20 20 20 63 61 73  ase 'v':.    cas
0980: 65 20 27 69 27 3a 0a 20 20 20 20 63 61 73 65 20  e 'i':.    case 
0990: 27 74 27 3a 20 7b 20 20 2f 2a 20 43 52 45 41 54  't': {  /* CREAT
09a0: 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54 45 20  E TABLE, CREATE 
09b0: 49 4e 44 45 58 2c 20 6f 72 20 43 52 45 41 54 45  INDEX, or CREATE
09c0: 20 56 49 45 57 20 73 74 61 74 65 6d 65 6e 74 73   VIEW statements
09d0: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65   */.      sqlite
09e0: 20 2a 64 62 20 3d 20 70 44 61 74 61 2d 3e 64 62   *db = pData->db
09f0: 3b 0a 20 20 20 20 20 20 69 66 28 20 61 72 67 76  ;.      if( argv
0a00: 5b 32 5d 3d 3d 30 20 7c 7c 20 61 72 67 76 5b 34  [2]==0 || argv[4
0a10: 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  ]==0 ){.        
0a20: 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44  corruptSchema(pD
0a30: 61 74 61 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  ata, 0);.       
0a40: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20   return 1;.     
0a50: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 61 72 67   }.      if( arg
0a60: 76 5b 33 5d 20 26 26 20 61 72 67 76 5b 33 5d 5b  v[3] && argv[3][
0a70: 30 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a  0] ){.        /*
0a80: 20 43 61 6c 6c 20 74 68 65 20 70 61 72 73 65 72   Call the parser
0a90: 20 74 6f 20 70 72 6f 63 65 73 73 20 61 20 43 52   to process a CR
0aa0: 45 41 54 45 20 54 41 42 4c 45 2c 20 49 4e 44 45  EATE TABLE, INDE
0ab0: 58 20 6f 72 20 56 49 45 57 2e 0a 20 20 20 20 20  X or VIEW..     
0ac0: 20 20 20 2a 2a 20 42 75 74 20 62 65 63 61 75 73     ** But becaus
0ad0: 65 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20  e db->init.busy 
0ae0: 69 73 20 73 65 74 20 74 6f 20 31 2c 20 6e 6f 20  is set to 1, no 
0af0: 56 44 42 45 20 63 6f 64 65 20 69 73 20 67 65 6e  VDBE code is gen
0b00: 65 72 61 74 65 64 0a 20 20 20 20 20 20 20 20 2a  erated.        *
0b10: 2a 20 6f 72 20 65 78 65 63 75 74 65 64 2e 20 20  * or executed.  
0b20: 41 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 64  All the parser d
0b30: 6f 65 73 20 69 73 20 62 75 69 6c 64 20 74 68 65  oes is build the
0b40: 20 69 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a 20   internal data. 
0b50: 20 20 20 20 20 20 20 2a 2a 20 73 74 72 75 63 74         ** struct
0b60: 75 72 65 73 20 74 68 61 74 20 64 65 73 63 72 69  ures that descri
0b70: 62 65 20 74 68 65 20 74 61 62 6c 65 2c 20 69 6e  be the table, in
0b80: 64 65 78 2c 20 6f 72 20 76 69 65 77 2e 0a 20 20  dex, or view..  
0b90: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20        */.       
0ba0: 20 63 68 61 72 20 2a 7a 45 72 72 3b 0a 20 20 20   char *zErr;.   
0bb0: 20 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20       int rc;.   
0bc0: 20 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d       assert( db-
0bd0: 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20 20  >init.busy );.  
0be0: 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69        db->init.i
0bf0: 44 62 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 34  Db = atoi(argv[4
0c00: 5d 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65  ]);.        asse
0c10: 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 69 44 62  rt( db->init.iDb
0c20: 3e 3d 30 20 26 26 20 64 62 2d 3e 69 6e 69 74 2e  >=0 && db->init.
0c30: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  iDb<db->nDb );. 
0c40: 20 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e         db->init.
0c50: 6e 65 77 54 6e 75 6d 20 3d 20 61 74 6f 69 28 61  newTnum = atoi(a
0c60: 72 67 76 5b 32 5d 29 3b 0a 20 20 20 20 20 20 20  rgv[2]);.       
0c70: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 78   rc = sqlite3_ex
0c80: 65 63 28 64 62 2c 20 61 72 67 76 5b 33 5d 2c 20  ec(db, argv[3], 
0c90: 30 2c 20 30 2c 20 26 7a 45 72 72 29 3b 0a 20 20  0, 0, &zErr);.  
0ca0: 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69        db->init.i
0cb0: 44 62 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  Db = 0;.        
0cc0: 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72  if( SQLITE_OK!=r
0cd0: 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 63  c ){.          c
0ce0: 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61  orruptSchema(pDa
0cf0: 74 61 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20 20  ta, zErr);.     
0d00: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65       sqlite3_fre
0d10: 65 28 7a 45 72 72 29 3b 0a 20 20 20 20 20 20 20  e(zErr);.       
0d20: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
0d30: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65        }.      }e
0d40: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20  lse{.        /* 
0d50: 49 66 20 74 68 65 20 53 51 4c 20 63 6f 6c 75 6d  If the SQL colum
0d60: 6e 20 69 73 20 62 6c 61 6e 6b 20 69 74 20 6d 65  n is blank it me
0d70: 61 6e 73 20 74 68 69 73 20 69 73 20 61 6e 20 69  ans this is an i
0d80: 6e 64 65 78 20 74 68 61 74 0a 20 20 20 20 20 20  ndex that.      
0d90: 20 20 2a 2a 20 77 61 73 20 63 72 65 61 74 65 64    ** was created
0da0: 20 74 6f 20 62 65 20 74 68 65 20 50 52 49 4d 41   to be the PRIMA
0db0: 52 59 20 4b 45 59 20 6f 72 20 74 6f 20 66 75 6c  RY KEY or to ful
0dc0: 66 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a 20 20  fill a UNIQUE.  
0dd0: 20 20 20 20 20 20 2a 2a 20 63 6f 6e 73 74 72 61        ** constra
0de0: 69 6e 74 20 66 6f 72 20 61 20 43 52 45 41 54 45  int for a CREATE
0df0: 20 54 41 42 4c 45 2e 20 20 54 68 65 20 69 6e 64   TABLE.  The ind
0e00: 65 78 20 73 68 6f 75 6c 64 20 68 61 76 65 20 61  ex should have a
0e10: 6c 72 65 61 64 79 0a 20 20 20 20 20 20 20 20 2a  lready.        *
0e20: 2a 20 62 65 65 6e 20 63 72 65 61 74 65 64 20 77  * been created w
0e30: 68 65 6e 20 77 65 20 70 72 6f 63 65 73 73 65 64  hen we processed
0e40: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
0e50: 45 2e 20 20 41 6c 6c 20 77 65 20 68 61 76 65 0a  E.  All we have.
0e60: 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 64 6f          ** to do
0e70: 20 68 65 72 65 20 69 73 20 72 65 63 6f 72 64 20   here is record 
0e80: 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6e 75  the root page nu
0e90: 6d 62 65 72 20 66 6f 72 20 74 68 61 74 20 69 6e  mber for that in
0ea0: 64 65 78 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a  dex..        */.
0eb0: 20 20 20 20 20 20 20 20 69 6e 74 20 69 44 62 3b          int iDb;
0ec0: 0a 20 20 20 20 20 20 20 20 49 6e 64 65 78 20 2a  .        Index *
0ed0: 70 49 6e 64 65 78 3b 0a 0a 20 20 20 20 20 20 20  pIndex;..       
0ee0: 20 69 44 62 20 3d 20 61 74 6f 69 28 61 72 67 76   iDb = atoi(argv
0ef0: 5b 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 61 73  [4]);.        as
0f00: 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26 26 20  sert( iDb>=0 && 
0f10: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  iDb<db->nDb );. 
0f20: 20 20 20 20 20 20 20 70 49 6e 64 65 78 20 3d 20         pIndex = 
0f30: 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 78  sqlite3FindIndex
0f40: 28 64 62 2c 20 61 72 67 76 5b 31 5d 2c 20 64 62  (db, argv[1], db
0f50: 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65  ->aDb[iDb].zName
0f60: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70  );.        if( p
0f70: 49 6e 64 65 78 3d 3d 30 20 7c 7c 20 70 49 6e 64  Index==0 || pInd
0f80: 65 78 2d 3e 74 6e 75 6d 21 3d 30 20 29 7b 0a 20  ex->tnum!=0 ){. 
0f90: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73           /* This
0fa0: 20 63 61 6e 20 6f 63 63 75 72 20 69 66 20 74 68   can occur if th
0fb0: 65 72 65 20 65 78 69 73 74 73 20 61 6e 20 69 6e  ere exists an in
0fc0: 64 65 78 20 6f 6e 20 61 20 54 45 4d 50 20 74 61  dex on a TEMP ta
0fd0: 62 6c 65 20 77 68 69 63 68 0a 20 20 20 20 20 20  ble which.      
0fe0: 20 20 20 20 2a 2a 20 68 61 73 20 74 68 65 20 73      ** has the s
0ff0: 61 6d 65 20 6e 61 6d 65 20 61 73 20 61 6e 6f 74  ame name as anot
1000: 68 65 72 20 69 6e 64 65 78 20 6f 6e 20 61 20 70  her index on a p
1010: 65 72 6d 61 6e 65 6e 74 20 69 6e 64 65 78 2e 20  ermanent index. 
1020: 20 53 69 6e 63 65 0a 20 20 20 20 20 20 20 20 20   Since.         
1030: 20 2a 2a 20 74 68 65 20 70 65 72 6d 61 6e 65 6e   ** the permanen
1040: 74 20 74 61 62 6c 65 20 69 73 20 68 69 64 64 65  t table is hidde
1050: 6e 20 62 79 20 74 68 65 20 54 45 4d 50 20 74 61  n by the TEMP ta
1060: 62 6c 65 2c 20 77 65 20 63 61 6e 20 61 6c 73 6f  ble, we can also
1070: 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73 61  .          ** sa
1080: 66 65 6c 79 20 69 67 6e 6f 72 65 20 74 68 65 20  fely ignore the 
1090: 69 6e 64 65 78 20 6f 6e 20 74 68 65 20 70 65 72  index on the per
10a0: 6d 61 6e 65 6e 74 20 74 61 62 6c 65 2e 0a 20 20  manent table..  
10b0: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20          */.     
10c0: 20 20 20 20 20 2f 2a 20 44 6f 20 4e 6f 74 68 69       /* Do Nothi
10d0: 6e 67 20 2a 2f 3b 0a 20 20 20 20 20 20 20 20 7d  ng */;.        }
10e0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20  else{.          
10f0: 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 20 3d 20 61  pIndex->tnum = a
1100: 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a 20 20  toi(argv[2]);.  
1110: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
1120: 20 20 20 20 7d 0a 20 20 20 20 62 72 65 61 6b 3b      }.    break;
1130: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a  .    default: {.
1140: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63 61        /* This ca
1150: 6e 20 6e 6f 74 20 68 61 70 70 65 6e 21 20 2a 2f  n not happen! */
1160: 0a 20 20 20 20 20 20 6e 45 72 72 20 3d 20 31 3b  .      nErr = 1;
1170: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e  .      assert( n
1180: 45 72 72 3d 3d 30 20 29 3b 0a 20 20 20 20 7d 0a  Err==0 );.    }.
1190: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 45 72    }.  return nEr
11a0: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65  r;.}../*.** Atte
11b0: 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 20  mpt to read the 
11c0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20  database schema 
11d0: 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 69  and initialize i
11e0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64 61 74 61 20  nternal.** data 
11f0: 73 74 72 75 63 74 75 72 65 73 20 66 6f 72 20 61  structures for a
1200: 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65   single database
1210: 20 66 69 6c 65 2e 20 20 54 68 65 20 69 6e 64 65   file.  The inde
1220: 78 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61  x of the.** data
1230: 62 61 73 65 20 66 69 6c 65 20 69 73 20 67 69 76  base file is giv
1240: 65 6e 20 62 79 20 69 44 62 2e 20 20 69 44 62 3d  en by iDb.  iDb=
1250: 3d 30 20 69 73 20 75 73 65 64 20 66 6f 72 20 74  =0 is used for t
1260: 68 65 20 6d 61 69 6e 0a 2a 2a 20 64 61 74 61 62  he main.** datab
1270: 61 73 65 2e 20 20 69 44 62 3d 3d 31 20 73 68 6f  ase.  iDb==1 sho
1280: 75 6c 64 20 6e 65 76 65 72 20 62 65 20 75 73 65  uld never be use
1290: 64 2e 20 20 69 44 62 3e 3d 32 20 69 73 20 75 73  d.  iDb>=2 is us
12a0: 65 64 20 66 6f 72 0a 2a 2a 20 61 75 78 69 6c 69  ed for.** auxili
12b0: 61 72 79 20 64 61 74 61 62 61 73 65 73 2e 20 20  ary databases.  
12c0: 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74 68  Return one of th
12d0: 65 20 53 51 4c 49 54 45 5f 20 65 72 72 6f 72 20  e SQLITE_ error 
12e0: 63 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e 64 69  codes to.** indi
12f0: 63 61 74 65 20 73 75 63 63 65 73 73 20 6f 72 20  cate success or 
1300: 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 74 61 74  failure..*/.stat
1310: 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 49 6e  ic int sqlite3In
1320: 69 74 4f 6e 65 28 73 71 6c 69 74 65 20 2a 64 62  itOne(sqlite *db
1330: 2c 20 69 6e 74 20 69 44 62 2c 20 63 68 61 72 20  , int iDb, char 
1340: 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20 69  **pzErrMsg){.  i
1350: 6e 74 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f  nt rc;.  BtCurso
1360: 72 20 2a 63 75 72 4d 61 69 6e 3b 0a 20 20 69 6e  r *curMain;.  in
1370: 74 20 73 69 7a 65 3b 0a 20 20 54 61 62 6c 65 20  t size;.  Table 
1380: 2a 70 54 61 62 3b 0a 20 20 63 68 61 72 20 63 6f  *pTab;.  char co
1390: 6e 73 74 20 2a 61 7a 41 72 67 5b 36 5d 3b 0a 20  nst *azArg[6];. 
13a0: 20 63 68 61 72 20 7a 44 62 4e 75 6d 5b 33 30 5d   char zDbNum[30]
13b0: 3b 0a 20 20 69 6e 74 20 6d 65 74 61 5b 31 30 5d  ;.  int meta[10]
13c0: 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69 6e 69  ;.  InitData ini
13d0: 74 44 61 74 61 3b 0a 20 20 63 68 61 72 20 63 6f  tData;.  char co
13e0: 6e 73 74 20 2a 7a 4d 61 73 74 65 72 53 63 68 65  nst *zMasterSche
13f0: 6d 61 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74  ma;.  char const
1400: 20 2a 7a 4d 61 73 74 65 72 4e 61 6d 65 3b 0a 0a   *zMasterName;..
1410: 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 6d 61    /*.  ** The ma
1420: 73 74 65 72 20 64 61 74 61 62 61 73 65 20 74 61  ster database ta
1430: 62 6c 65 20 68 61 73 20 61 20 73 74 72 75 63 74  ble has a struct
1440: 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a 20 20  ure like this.  
1450: 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68 61 72  */.  static char
1460: 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d   master_schema[]
1470: 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 45   = .     "CREATE
1480: 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d 61   TABLE sqlite_ma
1490: 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20 22 20  ster(\n".     " 
14a0: 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a 20   type text,\n". 
14b0: 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65 78 74      "  name text
14c0: 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 62 6c  ,\n".     "  tbl
14d0: 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20  _name text,\n". 
14e0: 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67 65 20      "  rootpage 
14f0: 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20 20  integer,\n".    
1500: 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22 0a   "  sql text\n".
1510: 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 20 20 73       ")".  ;.  s
1520: 74 61 74 69 63 20 63 68 61 72 20 74 65 6d 70 5f  tatic char temp_
1530: 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d 20  master_schema[] 
1540: 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 45 20  = .     "CREATE 
1550: 54 45 4d 50 20 54 41 42 4c 45 20 73 71 6c 69 74  TEMP TABLE sqlit
1560: 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 28 5c 6e  e_temp_master(\n
1570: 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 74  ".     "  type t
1580: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
1590: 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20  name text,\n".  
15a0: 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 74     "  tbl_name t
15b0: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
15c0: 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72  rootpage integer
15d0: 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 6c  ,\n".     "  sql
15e0: 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 29   text\n".     ")
15f0: 22 0a 20 20 3b 0a 0a 20 20 61 73 73 65 72 74 28  ".  ;..  assert(
1600: 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62 3c 64   iDb>=0 && iDb<d
1610: 62 2d 3e 6e 44 62 20 29 3b 0a 0a 20 20 2f 2a 20  b->nDb );..  /* 
1620: 7a 4d 61 73 74 65 72 53 63 68 65 6d 61 20 61 6e  zMasterSchema an
1630: 64 20 7a 49 6e 69 74 53 63 72 69 70 74 20 61 72  d zInitScript ar
1640: 65 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 61  e set to point a
1650: 74 20 74 68 65 20 6d 61 73 74 65 72 20 73 63 68  t the master sch
1660: 65 6d 61 0a 20 20 2a 2a 20 61 6e 64 20 69 6e 69  ema.  ** and ini
1670: 74 69 61 6c 69 73 61 74 69 6f 6e 20 73 63 72 69  tialisation scri
1680: 70 74 20 61 70 70 72 6f 70 72 69 61 74 65 20 66  pt appropriate f
1690: 6f 72 20 74 68 65 20 64 61 74 61 62 61 73 65 20  or the database 
16a0: 62 65 69 6e 67 0a 20 20 2a 2a 20 69 6e 69 74 69  being.  ** initi
16b0: 61 6c 69 73 65 64 2e 20 7a 4d 61 73 74 65 72 4e  alised. zMasterN
16c0: 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20  ame is the name 
16d0: 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 74 61  of the master ta
16e0: 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  ble..  */.  if( 
16f0: 69 44 62 3d 3d 31 20 29 7b 0a 20 20 20 20 7a 4d  iDb==1 ){.    zM
1700: 61 73 74 65 72 53 63 68 65 6d 61 20 3d 20 74 65  asterSchema = te
1710: 6d 70 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d 61  mp_master_schema
1720: 3b 0a 20 20 20 20 7a 4d 61 73 74 65 72 4e 61 6d  ;.    zMasterNam
1730: 65 20 3d 20 54 45 4d 50 5f 4d 41 53 54 45 52 5f  e = TEMP_MASTER_
1740: 4e 41 4d 45 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  NAME;.  }else{. 
1750: 20 20 20 7a 4d 61 73 74 65 72 53 63 68 65 6d 61     zMasterSchema
1760: 20 3d 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61   = master_schema
1770: 3b 0a 20 20 20 20 7a 4d 61 73 74 65 72 4e 61 6d  ;.    zMasterNam
1780: 65 20 3d 20 4d 41 53 54 45 52 5f 4e 41 4d 45 3b  e = MASTER_NAME;
1790: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 6f 6e 73 74  .  }..  /* Const
17a0: 72 75 63 74 20 74 68 65 20 73 63 68 65 6d 61 20  ruct the schema 
17b0: 74 61 62 6c 65 73 2e 20 20 2a 2f 0a 20 20 73 71  tables.  */.  sq
17c0: 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28 64  lite3SafetyOff(d
17d0: 62 29 3b 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d  b);.  azArg[0] =
17e0: 20 22 74 61 62 6c 65 22 3b 0a 20 20 61 7a 41 72   "table";.  azAr
17f0: 67 5b 31 5d 20 3d 20 7a 4d 61 73 74 65 72 4e 61  g[1] = zMasterNa
1800: 6d 65 3b 0a 20 20 61 7a 41 72 67 5b 32 5d 20 3d  me;.  azArg[2] =
1810: 20 22 31 22 3b 0a 20 20 61 7a 41 72 67 5b 33 5d   "1";.  azArg[3]
1820: 20 3d 20 7a 4d 61 73 74 65 72 53 63 68 65 6d 61   = zMasterSchema
1830: 3b 0a 20 20 73 70 72 69 6e 74 66 28 7a 44 62 4e  ;.  sprintf(zDbN
1840: 75 6d 2c 20 22 25 64 22 2c 20 69 44 62 29 3b 0a  um, "%d", iDb);.
1850: 20 20 61 7a 41 72 67 5b 34 5d 20 3d 20 7a 44 62    azArg[4] = zDb
1860: 4e 75 6d 3b 0a 20 20 61 7a 41 72 67 5b 35 5d 20  Num;.  azArg[5] 
1870: 3d 20 30 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e  = 0;.  initData.
1880: 64 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69 74 44  db = db;.  initD
1890: 61 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d 20 70  ata.pzErrMsg = p
18a0: 7a 45 72 72 4d 73 67 3b 0a 20 20 72 63 20 3d 20  zErrMsg;.  rc = 
18b0: 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62  sqlite3InitCallb
18c0: 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c 20 35  ack(&initData, 5
18d0: 2c 20 28 63 68 61 72 20 2a 2a 29 61 7a 41 72 67  , (char **)azArg
18e0: 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d  , 0);.  if( rc!=
18f0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
1900: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e   sqlite3SafetyOn
1910: 28 64 62 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  (db);.    return
1920: 20 72 63 3b 0a 20 20 7d 0a 20 20 70 54 61 62 20   rc;.  }.  pTab 
1930: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 54 61 62  = sqlite3FindTab
1940: 6c 65 28 64 62 2c 20 7a 4d 61 73 74 65 72 4e 61  le(db, zMasterNa
1950: 6d 65 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  me, db->aDb[iDb]
1960: 2e 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 70  .zName);.  if( p
1970: 54 61 62 20 29 7b 0a 20 20 20 20 70 54 61 62 2d  Tab ){.    pTab-
1980: 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20  >readOnly = 1;. 
1990: 20 7d 0a 20 20 73 71 6c 69 74 65 33 53 61 66 65   }.  sqlite3Safe
19a0: 74 79 4f 6e 28 64 62 29 3b 0a 0a 20 20 2f 2a 20  tyOn(db);..  /* 
19b0: 43 72 65 61 74 65 20 61 20 63 75 72 73 6f 72 20  Create a cursor 
19c0: 74 6f 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61  to hold the data
19d0: 62 61 73 65 20 6f 70 65 6e 0a 20 20 2a 2f 0a 20  base open.  */. 
19e0: 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 44 62   if( db->aDb[iDb
19f0: 5d 2e 70 42 74 3d 3d 30 20 29 20 72 65 74 75 72  ].pBt==0 ) retur
1a00: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 72  n SQLITE_OK;.  r
1a10: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
1a20: 43 75 72 73 6f 72 28 64 62 2d 3e 61 44 62 5b 69  Cursor(db->aDb[i
1a30: 44 62 5d 2e 70 42 74 2c 20 4d 41 53 54 45 52 5f  Db].pBt, MASTER_
1a40: 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 30 2c 20 26  ROOT, 0, 0, 0, &
1a50: 63 75 72 4d 61 69 6e 29 3b 0a 20 20 69 66 28 20  curMain);.  if( 
1a60: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc!=SQLITE_OK &&
1a70: 20 72 63 21 3d 53 51 4c 49 54 45 5f 45 4d 50 54   rc!=SQLITE_EMPT
1a80: 59 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  Y ){.    sqlite3
1a90: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d  SetString(pzErrM
1aa0: 73 67 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74  sg, sqlite3ErrSt
1ab0: 72 28 72 63 29 2c 20 28 63 68 61 72 2a 29 30 29  r(rc), (char*)0)
1ac0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  ;.    return rc;
1ad0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 47 65 74 20 74  .  }..  /* Get t
1ae0: 68 65 20 64 61 74 61 62 61 73 65 20 6d 65 74 61  he database meta
1af0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 20 20   information..  
1b00: 2a 2a 0a 20 20 2a 2a 20 4d 65 74 61 20 76 61 6c  **.  ** Meta val
1b10: 75 65 73 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f  ues are as follo
1b20: 77 73 3a 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61  ws:.  **    meta
1b30: 5b 30 5d 20 20 20 53 63 68 65 6d 61 20 63 6f 6f  [0]   Schema coo
1b40: 6b 69 65 2e 20 20 43 68 61 6e 67 65 73 20 77 69  kie.  Changes wi
1b50: 74 68 20 65 61 63 68 20 73 63 68 65 6d 61 20 63  th each schema c
1b60: 68 61 6e 67 65 2e 0a 20 20 2a 2a 20 20 20 20 6d  hange..  **    m
1b70: 65 74 61 5b 31 5d 20 20 20 46 69 6c 65 20 66 6f  eta[1]   File fo
1b80: 72 6d 61 74 20 6f 66 20 73 63 68 65 6d 61 20 6c  rmat of schema l
1b90: 61 79 65 72 2e 0a 20 20 2a 2a 20 20 20 20 6d 65  ayer..  **    me
1ba0: 74 61 5b 32 5d 20 20 20 53 69 7a 65 20 6f 66 20  ta[2]   Size of 
1bb0: 74 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 0a  the page cache..
1bc0: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 33 5d 0a    **    meta[3].
1bd0: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34 5d 20    **    meta[4] 
1be0: 20 20 44 62 20 74 65 78 74 20 65 6e 63 6f 64 69    Db text encodi
1bf0: 6e 67 2e 20 31 3a 55 54 46 2d 38 20 33 3a 55 54  ng. 1:UTF-8 3:UT
1c00: 46 2d 31 36 20 4c 45 20 34 3a 55 54 46 2d 31 36  F-16 LE 4:UTF-16
1c10: 20 42 45 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61   BE.  **    meta
1c20: 5b 35 5d 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61  [5].  **    meta
1c30: 5b 36 5d 20 20 20 0a 20 20 2a 2a 20 20 20 20 6d  [6]   .  **    m
1c40: 65 74 61 5b 37 5d 0a 20 20 2a 2a 20 20 20 20 6d  eta[7].  **    m
1c50: 65 74 61 5b 38 5d 0a 20 20 2a 2a 20 20 20 20 6d  eta[8].  **    m
1c60: 65 74 61 5b 39 5d 0a 20 20 2a 2a 0a 20 20 2a 2a  eta[9].  **.  **
1c70: 20 4e 6f 74 65 3a 20 54 68 65 20 68 61 73 68 20   Note: The hash 
1c80: 64 65 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 55  defined SQLITE_U
1c90: 54 46 2a 20 73 79 6d 62 6f 6c 73 20 69 6e 20 73  TF* symbols in s
1ca0: 71 6c 69 74 65 49 6e 74 2e 68 20 63 6f 72 72 65  qliteInt.h corre
1cb0: 73 70 6f 6e 64 20 74 6f 0a 20 20 2a 2a 20 74 68  spond to.  ** th
1cc0: 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65  e possible value
1cd0: 73 20 6f 66 20 6d 65 74 61 5b 34 5d 2e 0a 20 20  s of meta[4]..  
1ce0: 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  */.  if( rc==SQL
1cf0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 6e  ITE_OK ){.    in
1d00: 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30  t i;.    for(i=0
1d10: 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ; rc==SQLITE_OK 
1d20: 26 26 20 69 3c 73 69 7a 65 6f 66 28 6d 65 74 61  && i<sizeof(meta
1d30: 29 2f 73 69 7a 65 6f 66 28 6d 65 74 61 5b 30 5d  )/sizeof(meta[0]
1d40: 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72  ); i++){.      r
1d50: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
1d60: 47 65 74 4d 65 74 61 28 64 62 2d 3e 61 44 62 5b  GetMeta(db->aDb[
1d70: 69 44 62 5d 2e 70 42 74 2c 20 69 2b 31 2c 20 28  iDb].pBt, i+1, (
1d80: 75 33 32 20 2a 29 26 6d 65 74 61 5b 69 5d 29 3b  u32 *)&meta[i]);
1d90: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72  .    }.    if( r
1da0: 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  c ){.      sqlit
1db0: 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  e3SetString(pzEr
1dc0: 72 4d 73 67 2c 20 73 71 6c 69 74 65 33 45 72 72  rMsg, sqlite3Err
1dd0: 53 74 72 28 72 63 29 2c 20 28 63 68 61 72 2a 29  Str(rc), (char*)
1de0: 30 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  0);.      sqlite
1df0: 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f  3BtreeCloseCurso
1e00: 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 20 20  r(curMain);.    
1e10: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20    return rc;.   
1e20: 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20   }.  }else{.    
1e30: 6d 65 6d 73 65 74 28 6d 65 74 61 2c 20 30 2c 20  memset(meta, 0, 
1e40: 73 69 7a 65 6f 66 28 6d 65 74 61 29 29 3b 0a 20  sizeof(meta));. 
1e50: 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 69 44 62   }.  db->aDb[iDb
1e60: 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 20  ].schema_cookie 
1e70: 3d 20 6d 65 74 61 5b 30 5d 3b 0a 0a 20 20 2f 2a  = meta[0];..  /*
1e80: 20 49 66 20 6f 70 65 6e 69 6e 67 20 61 20 6e 6f   If opening a no
1e90: 6e 2d 65 6d 70 74 79 20 64 61 74 61 62 61 73 65  n-empty database
1ea0: 2c 20 63 68 65 63 6b 20 74 68 65 20 74 65 78 74  , check the text
1eb0: 20 65 6e 63 6f 64 69 6e 67 2e 20 46 6f 72 20 74   encoding. For t
1ec0: 68 65 0a 20 20 2a 2a 20 6d 61 69 6e 20 64 61 74  he.  ** main dat
1ed0: 61 62 61 73 65 2c 20 73 65 74 20 73 71 6c 69 74  abase, set sqlit
1ee0: 65 33 2e 65 6e 63 20 74 6f 20 74 68 65 20 65 6e  e3.enc to the en
1ef0: 63 6f 64 69 6e 67 20 6f 66 20 74 68 65 20 6d 61  coding of the ma
1f00: 69 6e 20 64 61 74 61 62 61 73 65 2e 0a 20 20 2a  in database..  *
1f10: 2a 20 46 6f 72 20 61 6e 20 61 74 74 61 63 68 65  * For an attache
1f20: 64 20 64 62 2c 20 69 74 20 69 73 20 61 6e 20 65  d db, it is an e
1f30: 72 72 6f 72 20 69 66 20 74 68 65 20 65 6e 63 6f  rror if the enco
1f40: 64 69 6e 67 20 69 73 20 6e 6f 74 20 74 68 65 20  ding is not the 
1f50: 73 61 6d 65 0a 20 20 2a 2a 20 61 73 20 73 71 6c  same.  ** as sql
1f60: 69 74 65 33 2e 65 6e 63 2e 0a 20 20 2a 2f 0a 20  ite3.enc..  */. 
1f70: 20 69 66 28 20 6d 65 74 61 5b 34 5d 20 29 7b 20   if( meta[4] ){ 
1f80: 20 2f 2a 20 74 65 78 74 20 65 6e 63 6f 64 69 6e   /* text encodin
1f90: 67 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 44 62  g */.    if( iDb
1fa0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  ==0 ){.      /* 
1fb0: 49 66 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 6d  If opening the m
1fc0: 61 69 6e 20 64 61 74 61 62 61 73 65 2c 20 73 65  ain database, se
1fd0: 74 20 64 62 2d 3e 65 6e 63 2e 20 2a 2f 0a 20 20  t db->enc. */.  
1fe0: 20 20 20 20 64 62 2d 3e 65 6e 63 20 3d 20 28 75      db->enc = (u
1ff0: 38 29 6d 65 74 61 5b 34 5d 3b 0a 20 20 20 20 20  8)meta[4];.     
2000: 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d   db->pDfltColl =
2010: 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c   sqlite3FindColl
2020: 53 65 71 28 64 62 2c 20 64 62 2d 3e 65 6e 63 2c  Seq(db, db->enc,
2030: 20 22 42 49 4e 41 52 59 22 2c 20 36 2c 20 30 29   "BINARY", 6, 0)
2040: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
2050: 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67     /* If opening
2060: 20 61 6e 20 61 74 74 61 63 68 65 64 20 64 61 74   an attached dat
2070: 61 62 61 73 65 2c 20 74 68 65 20 65 6e 63 6f 64  abase, the encod
2080: 69 6e 67 20 6d 75 63 68 20 6d 61 74 63 68 20 64  ing much match d
2090: 62 2d 3e 65 6e 63 20 2a 2f 0a 20 20 20 20 20 20  b->enc */.      
20a0: 69 66 28 20 6d 65 74 61 5b 34 5d 21 3d 64 62 2d  if( meta[4]!=db-
20b0: 3e 65 6e 63 20 29 7b 0a 20 20 20 20 20 20 20 20  >enc ){.        
20c0: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73  sqlite3BtreeClos
20d0: 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29  eCursor(curMain)
20e0: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
20f0: 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72  3SetString(pzErr
2100: 4d 73 67 2c 20 22 61 74 74 61 63 68 65 64 20 64  Msg, "attached d
2110: 61 74 61 62 61 73 65 73 20 6d 75 73 74 20 75 73  atabases must us
2120: 65 20 74 68 65 20 73 61 6d 65 22 0a 20 20 20 20  e the same".    
2130: 20 20 20 20 20 20 20 20 22 20 74 65 78 74 20 65          " text e
2140: 6e 63 6f 64 69 6e 67 20 61 73 20 6d 61 69 6e 20  ncoding as main 
2150: 64 61 74 61 62 61 73 65 22 2c 20 28 63 68 61 72  database", (char
2160: 2a 29 30 29 3b 0a 20 20 20 20 20 20 20 20 72 65  *)0);.        re
2170: 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f  turn SQLITE_ERRO
2180: 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  R;.      }.    }
2190: 0a 20 20 7d 0a 0a 20 20 73 69 7a 65 20 3d 20 6d  .  }..  size = m
21a0: 65 74 61 5b 32 5d 3b 0a 20 20 69 66 28 20 73 69  eta[2];.  if( si
21b0: 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d 20  ze==0 ){ size = 
21c0: 4d 41 58 5f 50 41 47 45 53 3b 20 7d 0a 20 20 64  MAX_PAGES; }.  d
21d0: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 63 61 63 68  b->aDb[iDb].cach
21e0: 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a 0a  e_size = size;..
21f0: 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29 7b 0a    if( iDb==0 ){.
2200: 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72      db->file_for
2210: 6d 61 74 20 3d 20 6d 65 74 61 5b 31 5d 3b 0a 20  mat = meta[1];. 
2220: 20 20 20 69 66 28 20 64 62 2d 3e 66 69 6c 65 5f     if( db->file_
2230: 66 6f 72 6d 61 74 3d 3d 30 20 29 7b 0a 20 20 20  format==0 ){.   
2240: 20 20 20 2f 2a 20 54 68 69 73 20 68 61 70 70 65     /* This happe
2250: 6e 73 20 69 66 20 74 68 65 20 64 61 74 61 62 61  ns if the databa
2260: 73 65 20 77 61 73 20 69 6e 69 74 69 61 6c 6c 79  se was initially
2270: 20 65 6d 70 74 79 20 2a 2f 0a 20 20 20 20 20 20   empty */.      
2280: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20  db->file_format 
2290: 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  = 1;.    }.  }..
22a0: 20 20 2f 2a 0a 20 20 2a 2a 20 20 66 69 6c 65 5f    /*.  **  file_
22b0: 66 6f 72 6d 61 74 3d 3d 31 20 20 20 20 56 65 72  format==1    Ver
22c0: 73 69 6f 6e 20 33 2e 30 2e 30 2e 0a 20 20 2a 2f  sion 3.0.0..  */
22d0: 0a 20 20 69 66 28 20 6d 65 74 61 5b 31 5d 3e 31  .  if( meta[1]>1
22e0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42   ){.    sqlite3B
22f0: 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28  treeCloseCursor(
2300: 63 75 72 4d 61 69 6e 29 3b 0a 20 20 20 20 73 71  curMain);.    sq
2310: 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70  lite3SetString(p
2320: 7a 45 72 72 4d 73 67 2c 20 22 75 6e 73 75 70 70  zErrMsg, "unsupp
2330: 6f 72 74 65 64 20 66 69 6c 65 20 66 6f 72 6d 61  orted file forma
2340: 74 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20  t", (char*)0);. 
2350: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
2360: 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 73  _ERROR;.  }..  s
2370: 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 61  qlite3BtreeSetCa
2380: 63 68 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 5b  cheSize(db->aDb[
2390: 69 44 62 5d 2e 70 42 74 2c 20 64 62 2d 3e 61 44  iDb].pBt, db->aD
23a0: 62 5b 69 44 62 5d 2e 63 61 63 68 65 5f 73 69 7a  b[iDb].cache_siz
23b0: 65 29 3b 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74  e);..  /* Read t
23c0: 68 65 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d  he schema inform
23d0: 61 74 69 6f 6e 20 6f 75 74 20 6f 66 20 74 68 65  ation out of the
23e0: 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 0a 20   schema tables. 
23f0: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 64 62   */.  assert( db
2400: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20  ->init.busy );. 
2410: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
2420: 45 4d 50 54 59 20 29 7b 0a 20 20 20 20 2f 2a 20  EMPTY ){.    /* 
2430: 46 6f 72 20 61 6e 20 65 6d 70 74 79 20 64 61 74  For an empty dat
2440: 61 62 61 73 65 2c 20 74 68 65 72 65 20 69 73 20  abase, there is 
2450: 6e 6f 74 68 69 6e 67 20 74 6f 20 72 65 61 64 20  nothing to read 
2460: 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  */.    rc = SQLI
2470: 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a  TE_OK;.  }else{.
2480: 20 20 20 20 63 68 61 72 20 2a 7a 53 71 6c 20 3d      char *zSql =
2490: 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53   0;.    sqlite3S
24a0: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20  afetyOff(db);.  
24b0: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
24c0: 6e 67 28 26 7a 53 71 6c 2c 20 0a 20 20 20 20 20  ng(&zSql, .     
24d0: 20 20 20 22 53 45 4c 45 43 54 20 74 79 70 65 2c     "SELECT type,
24e0: 20 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c   name, rootpage,
24f0: 20 73 71 6c 2c 20 22 2c 20 7a 44 62 4e 75 6d 2c   sql, ", zDbNum,
2500: 20 22 20 46 52 4f 4d 20 5c 22 22 2c 0a 20 20 20   " FROM \"",.   
2510: 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69 44 62       db->aDb[iDb
2520: 5d 2e 7a 4e 61 6d 65 2c 20 22 5c 22 2e 22 2c 20  ].zName, "\".", 
2530: 7a 4d 61 73 74 65 72 4e 61 6d 65 2c 20 28 63 68  zMasterName, (ch
2540: 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 63 20 3d  ar*)0);.    rc =
2550: 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64 62   sqlite3_exec(db
2560: 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33 49  , zSql, sqlite3I
2570: 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26 69 6e  nitCallback, &in
2580: 69 74 44 61 74 61 2c 20 30 29 3b 0a 20 20 20 20  itData, 0);.    
2590: 73 71 6c 69 74 65 46 72 65 65 28 7a 53 71 6c 29  sqliteFree(zSql)
25a0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 61 66  ;.    sqlite3Saf
25b0: 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 20 20 73  etyOn(db);.    s
25c0: 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65  qlite3BtreeClose
25d0: 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29 3b  Cursor(curMain);
25e0: 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74  .  }.  if( sqlit
25f0: 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64  e3_malloc_failed
2600: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 53   ){.    sqlite3S
2610: 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73  etString(pzErrMs
2620: 67 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72  g, "out of memor
2630: 79 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20  y", (char*)0);. 
2640: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e     rc = SQLITE_N
2650: 4f 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65  OMEM;.    sqlite
2660: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
2670: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 7d  hema(db, 0);.  }
2680: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
2690: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 44 62 53 65  E_OK ){.    DbSe
26a0: 74 50 72 6f 70 65 72 74 79 28 64 62 2c 20 69 44  tProperty(db, iD
26b0: 62 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64  b, DB_SchemaLoad
26c0: 65 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  ed);.  }else{.  
26d0: 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e    sqlite3ResetIn
26e0: 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c  ternalSchema(db,
26f0: 20 69 44 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74   iDb);.  }.  ret
2700: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
2710: 20 49 6e 69 74 69 61 6c 69 7a 65 20 61 6c 6c 20   Initialize all 
2720: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 2d  database files -
2730: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61   the main databa
2740: 73 65 20 66 69 6c 65 2c 20 74 68 65 20 66 69 6c  se file, the fil
2750: 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f  e.** used to sto
2760: 72 65 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62  re temporary tab
2770: 6c 65 73 2c 20 61 6e 64 20 61 6e 79 20 61 64 64  les, and any add
2780: 69 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65  itional database
2790: 20 66 69 6c 65 73 0a 2a 2a 20 63 72 65 61 74 65   files.** create
27a0: 64 20 75 73 69 6e 67 20 41 54 54 41 43 48 20 73  d using ATTACH s
27b0: 74 61 74 65 6d 65 6e 74 73 2e 20 20 52 65 74 75  tatements.  Retu
27c0: 72 6e 20 61 20 73 75 63 63 65 73 73 20 63 6f 64  rn a success cod
27d0: 65 2e 20 20 49 66 20 61 6e 0a 2a 2a 20 65 72 72  e.  If an.** err
27e0: 6f 72 20 6f 63 63 75 72 73 2c 20 77 72 69 74 65  or occurs, write
27f0: 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67   an error messag
2800: 65 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67  e into *pzErrMsg
2810: 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68  ..**.** After th
2820: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e  e database is in
2830: 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 53  itialized, the S
2840: 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65  QLITE_Initialize
2850: 64 0a 2a 2a 20 62 69 74 20 69 73 20 73 65 74 20  d.** bit is set 
2860: 69 6e 20 74 68 65 20 66 6c 61 67 73 20 66 69 65  in the flags fie
2870: 6c 64 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65  ld of the sqlite
2880: 20 73 74 72 75 63 74 75 72 65 2e 20 0a 2a 2f 0a   structure. .*/.
2890: 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 69 74 28  int sqlite3Init(
28a0: 73 71 6c 69 74 65 20 2a 64 62 2c 20 63 68 61 72  sqlite *db, char
28b0: 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20   **pzErrMsg){.  
28c0: 69 6e 74 20 69 2c 20 72 63 3b 0a 20 20 0a 20 20  int i, rc;.  .  
28d0: 69 66 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73  if( db->init.bus
28e0: 79 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54  y ) return SQLIT
28f0: 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 28 20  E_OK;.  assert( 
2900: 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c  (db->flags & SQL
2910: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29  ITE_Initialized)
2920: 3d 3d 30 20 29 3b 0a 20 20 72 63 20 3d 20 53 51  ==0 );.  rc = SQ
2930: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 64 62 2d 3e 69  LITE_OK;.  db->i
2940: 6e 69 74 2e 62 75 73 79 20 3d 20 31 3b 0a 20 20  nit.busy = 1;.  
2950: 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c  for(i=0; rc==SQL
2960: 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e  ITE_OK && i<db->
2970: 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69  nDb; i++){.    i
2980: 66 28 20 44 62 48 61 73 50 72 6f 70 65 72 74 79  f( DbHasProperty
2990: 28 64 62 2c 20 69 2c 20 44 42 5f 53 63 68 65 6d  (db, i, DB_Schem
29a0: 61 4c 6f 61 64 65 64 29 20 7c 7c 20 69 3d 3d 31  aLoaded) || i==1
29b0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
29c0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e 69   rc = sqlite3Ini
29d0: 74 4f 6e 65 28 64 62 2c 20 69 2c 20 70 7a 45 72  tOne(db, i, pzEr
29e0: 72 4d 73 67 29 3b 0a 20 20 20 20 69 66 28 20 72  rMsg);.    if( r
29f0: 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  c ){.      sqlit
2a00: 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53  e3ResetInternalS
2a10: 63 68 65 6d 61 28 64 62 2c 20 69 29 3b 0a 20 20  chema(db, i);.  
2a20: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 6e    }.  }..  /* On
2a30: 63 65 20 61 6c 6c 20 74 68 65 20 6f 74 68 65 72  ce all the other
2a40: 20 64 61 74 61 62 61 73 65 73 20 68 61 76 65 20   databases have 
2a50: 62 65 65 6e 20 69 6e 69 74 69 61 6c 69 73 65 64  been initialised
2a60: 2c 20 6c 6f 61 64 20 74 68 65 20 73 63 68 65 6d  , load the schem
2a70: 61 0a 20 20 2a 2a 20 66 6f 72 20 74 68 65 20 54  a.  ** for the T
2a80: 45 4d 50 20 64 61 74 61 62 61 73 65 2e 20 54 68  EMP database. Th
2a90: 69 73 20 69 73 20 6c 6f 61 64 65 64 20 6c 61 73  is is loaded las
2aa0: 74 2c 20 61 73 20 74 68 65 20 54 45 4d 50 20 64  t, as the TEMP d
2ab0: 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 73 63 68  atabase.  ** sch
2ac0: 65 6d 61 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20  ema may contain 
2ad0: 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 6f 62  references to ob
2ae0: 6a 65 63 74 73 20 69 6e 20 6f 74 68 65 72 20 64  jects in other d
2af0: 61 74 61 62 61 73 65 73 2e 0a 20 20 2a 2f 0a 20  atabases..  */. 
2b00: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
2b10: 4f 4b 20 26 26 20 64 62 2d 3e 6e 44 62 3e 31 20  OK && db->nDb>1 
2b20: 26 26 20 21 44 62 48 61 73 50 72 6f 70 65 72 74  && !DbHasPropert
2b30: 79 28 64 62 2c 20 31 2c 20 44 42 5f 53 63 68 65  y(db, 1, DB_Sche
2b40: 6d 61 4c 6f 61 64 65 64 29 20 29 7b 0a 20 20 20  maLoaded) ){.   
2b50: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e 69   rc = sqlite3Ini
2b60: 74 4f 6e 65 28 64 62 2c 20 31 2c 20 70 7a 45 72  tOne(db, 1, pzEr
2b70: 72 4d 73 67 29 3b 0a 20 20 20 20 69 66 28 20 72  rMsg);.    if( r
2b80: 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  c ){.      sqlit
2b90: 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53  e3ResetInternalS
2ba0: 63 68 65 6d 61 28 64 62 2c 20 31 29 3b 0a 20 20  chema(db, 1);.  
2bb0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 64 62 2d 3e 69    }.  }..  db->i
2bc0: 6e 69 74 2e 62 75 73 79 20 3d 20 30 3b 0a 20 20  nit.busy = 0;.  
2bd0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
2be0: 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61  K ){.    db->fla
2bf0: 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 49 6e 69  gs |= SQLITE_Ini
2c00: 74 69 61 6c 69 7a 65 64 3b 0a 20 20 20 20 73 71  tialized;.    sq
2c10: 6c 69 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72  lite3CommitInter
2c20: 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29 3b 0a  nalChanges(db);.
2c30: 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 21 3d 53    }..  if( rc!=S
2c40: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
2c50: 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51  db->flags &= ~SQ
2c60: 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64  LITE_Initialized
2c70: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
2c80: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  c;.}../*.** This
2c90: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f   routine is a no
2ca0: 2d 6f 70 20 69 66 20 74 68 65 20 64 61 74 61 62  -op if the datab
2cb0: 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 61 6c  ase schema is al
2cc0: 72 65 61 64 79 20 69 6e 69 74 69 61 6c 69 73 65  ready initialise
2cd0: 64 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c  d..** Otherwise,
2ce0: 20 74 68 65 20 73 63 68 65 6d 61 20 69 73 20 6c   the schema is l
2cf0: 6f 61 64 65 64 2e 20 41 6e 20 65 72 72 6f 72 20  oaded. An error 
2d00: 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64  code is returned
2d10: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
2d20: 52 65 61 64 53 63 68 65 6d 61 28 50 61 72 73 65  ReadSchema(Parse
2d30: 20 2a 70 50 61 72 73 65 29 7b 0a 20 20 69 6e 74   *pParse){.  int
2d40: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
2d50: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d  .  sqlite3 *db =
2d60: 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 69   pParse->db;.  i
2d70: 66 28 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73  f( !db->init.bus
2d80: 79 20 29 7b 0a 20 20 20 20 69 66 28 20 28 64 62  y ){.    if( (db
2d90: 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45  ->flags & SQLITE
2da0: 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30  _Initialized)==0
2db0: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73   ){.      rc = s
2dc0: 71 6c 69 74 65 33 49 6e 69 74 28 64 62 2c 20 26  qlite3Init(db, &
2dd0: 70 50 61 72 73 65 2d 3e 7a 45 72 72 4d 73 67 29  pParse->zErrMsg)
2de0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73  ;.    }.  }.  as
2df0: 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45  sert( rc!=SQLITE
2e00: 5f 4f 4b 20 7c 7c 20 28 64 62 2d 3e 66 6c 61 67  _OK || (db->flag
2e10: 73 20 26 20 53 51 4c 49 54 45 5f 49 6e 69 74 69  s & SQLITE_Initi
2e20: 61 6c 69 7a 65 64 29 7c 7c 64 62 2d 3e 69 6e 69  alized)||db->ini
2e30: 74 2e 62 75 73 79 20 29 3b 0a 20 20 69 66 28 20  t.busy );.  if( 
2e40: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
2e50: 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 72 63 20  .    pParse->rc 
2e60: 3d 20 72 63 3b 0a 20 20 20 20 70 50 61 72 73 65  = rc;.    pParse
2e70: 2d 3e 6e 45 72 72 2b 2b 3b 0a 20 20 7d 0a 20 20  ->nErr++;.  }.  
2e80: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
2e90: 0a 2a 2a 20 54 68 65 20 76 65 72 73 69 6f 6e 20  .** The version 
2ea0: 6f 66 20 74 68 65 20 6c 69 62 72 61 72 79 0a 2a  of the library.*
2eb0: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 72 63 73  /.const char rcs
2ec0: 69 64 33 5b 5d 20 3d 20 22 40 28 23 29 20 5c 30  id3[] = "@(#) \0
2ed0: 34 34 49 64 3a 20 53 51 4c 69 74 65 20 76 65 72  44Id: SQLite ver
2ee0: 73 69 6f 6e 20 22 20 53 51 4c 49 54 45 5f 56 45  sion " SQLITE_VE
2ef0: 52 53 49 4f 4e 20 22 20 24 22 3b 0a 63 6f 6e 73  RSION " $";.cons
2f00: 74 20 63 68 61 72 20 73 71 6c 69 74 65 33 5f 76  t char sqlite3_v
2f10: 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 54  ersion[] = SQLIT
2f20: 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a 0a 2a  E_VERSION;../*.*
2f30: 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 64 65  * This is the de
2f40: 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20  fault collating 
2f50: 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 20 22  function named "
2f60: 42 49 4e 41 52 59 22 20 77 68 69 63 68 20 69 73  BINARY" which is
2f70: 20 61 6c 77 61 79 73 0a 2a 2a 20 61 76 61 69 6c   always.** avail
2f80: 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  able..*/.static 
2f90: 69 6e 74 20 62 69 6e 61 72 79 43 6f 6c 6c 61 74  int binaryCollat
2fa0: 69 6e 67 46 75 6e 63 28 0a 20 20 76 6f 69 64 20  ingFunc(.  void 
2fb0: 2a 4e 6f 74 55 73 65 64 2c 0a 20 20 69 6e 74 20  *NotUsed,.  int 
2fc0: 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69  nKey1, const voi
2fd0: 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20  d *pKey1,.  int 
2fe0: 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69  nKey2, const voi
2ff0: 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e  d *pKey2.){.  in
3000: 74 20 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d 20 6e  t rc, n;.  n = n
3010: 4b 65 79 31 3c 6e 4b 65 79 32 20 3f 20 6e 4b 65  Key1<nKey2 ? nKe
3020: 79 31 20 3a 20 6e 4b 65 79 32 3b 0a 20 20 72 63  y1 : nKey2;.  rc
3030: 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79 31 2c   = memcmp(pKey1,
3040: 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20 69 66   pKey2, n);.  if
3050: 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 72  ( rc==0 ){.    r
3060: 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b 65 79  c = nKey1 - nKey
3070: 32 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  2;.  }.  return 
3080: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6e 6f  rc;.}../*.** Ano
3090: 74 68 65 72 20 62 75 69 6c 74 2d 69 6e 20 63 6f  ther built-in co
30a0: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65  llating sequence
30b0: 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a 2a 0a 2a 2a  : NOCASE. .**.**
30c0: 20 54 68 69 73 20 63 6f 6c 6c 61 74 69 6e 67 20   This collating 
30d0: 73 65 71 75 65 6e 63 65 20 69 73 20 69 6e 74 65  sequence is inte
30e0: 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20  nded to be used 
30f0: 66 6f 72 20 22 63 61 73 65 20 69 6e 64 65 70 65  for "case indepe
3100: 6e 64 61 6e 74 0a 2a 2a 20 63 6f 6d 70 61 72 69  ndant.** compari
3110: 73 6f 6e 22 2e 20 53 51 4c 69 74 65 27 73 20 6b  son". SQLite's k
3120: 6e 6f 77 6c 65 64 67 65 20 6f 66 20 75 70 70 65  nowledge of uppe
3130: 72 20 61 6e 64 20 6c 6f 77 65 72 20 63 61 73 65  r and lower case
3140: 20 65 71 75 69 76 61 6c 65 6e 74 73 0a 2a 2a 20   equivalents.** 
3150: 65 78 74 65 6e 64 73 20 6f 6e 6c 79 20 74 6f 20  extends only to 
3160: 74 68 65 20 32 36 20 63 68 61 72 61 63 74 65 72  the 26 character
3170: 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 45 6e  s used in the En
3180: 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 2e 0a  glish language..
3190: 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 20 6d 6f 6d  **.** At the mom
31a0: 65 6e 74 20 74 68 65 72 65 20 69 73 20 6f 6e 6c  ent there is onl
31b0: 79 20 61 20 55 54 46 2d 38 20 69 6d 70 6c 65 6d  y a UTF-8 implem
31c0: 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61  entation..*/.sta
31d0: 74 69 63 20 69 6e 74 20 6e 6f 63 61 73 65 43 6f  tic int nocaseCo
31e0: 6c 6c 61 74 69 6e 67 46 75 6e 63 28 0a 20 20 76  llatingFunc(.  v
31f0: 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a 20 20  oid *NotUsed,.  
3200: 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74  int nKey1, const
3210: 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20   void *pKey1,.  
3220: 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74  int nKey2, const
3230: 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a   void *pKey2.){.
3240: 20 20 69 6e 74 20 72 20 3d 20 73 71 6c 69 74 65    int r = sqlite
3250: 33 53 74 72 4e 49 43 6d 70 28 0a 20 20 20 20 20  3StrNICmp(.     
3260: 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70   (const char *)p
3270: 4b 65 79 31 2c 20 28 63 6f 6e 73 74 20 63 68 61  Key1, (const cha
3280: 72 20 2a 29 70 4b 65 79 32 2c 20 28 6e 4b 65 79  r *)pKey2, (nKey
3290: 31 3e 6e 4b 65 79 32 29 3f 6e 4b 65 79 31 3a 6e  1>nKey2)?nKey1:n
32a0: 4b 65 79 32 29 3b 0a 20 20 69 66 28 20 30 3d 3d  Key2);.  if( 0==
32b0: 72 20 29 7b 0a 20 20 20 20 72 20 3d 20 6e 4b 65  r ){.    r = nKe
32c0: 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 20  y1-nKey2;.  }.  
32d0: 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a 2f 2a 0a  return r;.}../*.
32e0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 52 4f  ** Return the RO
32f0: 57 49 44 20 6f 66 20 74 68 65 20 6d 6f 73 74 20  WID of the most 
3300: 72 65 63 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f  recent insert.*/
3310: 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 71  .sqlite_int64 sq
3320: 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73 65 72  lite3_last_inser
3330: 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 65 20 2a  t_rowid(sqlite *
3340: 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62  db){.  return db
3350: 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d 0a 0a  ->lastRowid;.}..
3360: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
3370: 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e 67   number of chang
3380: 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74 20 72  es in the most r
3390: 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20 73 71  ecent call to sq
33a0: 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a 2f  lite3_exec()..*/
33b0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 68 61  .int sqlite3_cha
33c0: 6e 67 65 73 28 73 71 6c 69 74 65 20 2a 64 62 29  nges(sqlite *db)
33d0: 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e  {.  return db->n
33e0: 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Change;.}../*.**
33f0: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62   Return the numb
3400: 65 72 20 6f 66 20 63 68 61 6e 67 65 73 20 73 69  er of changes si
3410: 6e 63 65 20 74 68 65 20 64 61 74 61 62 61 73 65  nce the database
3420: 20 68 61 6e 64 6c 65 20 77 61 73 20 6f 70 65 6e   handle was open
3430: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
3440: 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73  e3_total_changes
3450: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
3460: 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e 54 6f 74   return db->nTot
3470: 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a  alChange;.}../*.
3480: 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65 78 69 73  ** Close an exis
3490: 74 69 6e 67 20 53 51 4c 69 74 65 20 64 61 74 61  ting SQLite data
34a0: 62 61 73 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  base.*/.int sqli
34b0: 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c 69 74 65  te3_close(sqlite
34c0: 20 2a 64 62 29 7b 0a 20 20 48 61 73 68 45 6c 65   *db){.  HashEle
34d0: 6d 20 2a 69 3b 0a 20 20 69 6e 74 20 6a 3b 0a 0a  m *i;.  int j;..
34e0: 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20 20 20    if( !db ){.   
34f0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
3500: 4b 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 64 62  K;.  }..  if( db
3510: 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f  ->magic!=SQLITE_
3520: 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 26 26 20  MAGIC_CLOSED && 
3530: 0a 20 20 20 20 20 20 64 62 2d 3e 6d 61 67 69 63  .      db->magic
3540: 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f  !=SQLITE_MAGIC_O
3550: 50 45 4e 20 26 26 0a 20 20 20 20 20 20 64 62 2d  PEN &&.      db-
3560: 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d  >magic!=SQLITE_M
3570: 41 47 49 43 5f 42 55 53 59 0a 20 20 29 7b 0a 20  AGIC_BUSY.  ){. 
3580: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
3590: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20  _MISUSE;.  }..  
35a0: 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20  /* If there are 
35b0: 61 6e 79 20 6f 75 74 73 74 61 6e 64 69 6e 67 20  any outstanding 
35c0: 56 4d 73 2c 20 72 65 74 75 72 6e 20 53 51 4c 49  VMs, return SQLI
35d0: 54 45 5f 42 55 53 59 2e 20 2a 2f 0a 20 20 69 66  TE_BUSY. */.  if
35e0: 28 20 64 62 2d 3e 70 56 64 62 65 20 29 7b 0a 20  ( db->pVdbe ){. 
35f0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
3600: 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c  db, SQLITE_BUSY,
3610: 20 0a 20 20 20 20 20 20 20 20 22 55 6e 61 62 6c   .        "Unabl
3620: 65 20 74 6f 20 63 6c 6f 73 65 20 64 75 65 20 74  e to close due t
3630: 6f 20 75 6e 66 69 6e 61 6c 69 73 65 64 20 73 74  o unfinalised st
3640: 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20  atements");.    
3650: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55  return SQLITE_BU
3660: 53 59 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74  SY;.  }.  assert
3670: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79  ( !sqlite3Safety
3680: 43 68 65 63 6b 28 64 62 29 20 29 3b 0a 0a 20 20  Check(db) );..  
3690: 2f 2a 20 46 49 58 20 4d 45 3a 20 64 62 2d 3e 6d  /* FIX ME: db->m
36a0: 61 67 69 63 20 6d 61 79 20 62 65 20 73 65 74 20  agic may be set 
36b0: 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  to SQLITE_MAGIC_
36c0: 43 4c 4f 53 45 44 20 69 66 20 74 68 65 20 64 61  CLOSED if the da
36d0: 74 61 62 61 73 65 0a 20 20 2a 2a 20 63 61 6e 6e  tabase.  ** cann
36e0: 6f 74 20 62 65 20 6f 70 65 6e 65 64 20 66 6f 72  ot be opened for
36f0: 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2e 20 53 6f   some reason. So
3700: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 6e 65   this routine ne
3710: 65 64 73 20 74 6f 20 72 75 6e 20 69 6e 0a 20 20  eds to run in.  
3720: 2a 2a 20 74 68 61 74 20 63 61 73 65 2e 20 42 75  ** that case. Bu
3730: 74 20 6d 61 79 62 65 20 74 68 65 72 65 20 73 68  t maybe there sh
3740: 6f 75 6c 64 20 62 65 20 61 6e 20 65 78 74 72 61  ould be an extra
3750: 20 6d 61 67 69 63 20 76 61 6c 75 65 20 66 6f 72   magic value for
3760: 20 74 68 65 0a 20 20 2a 2a 20 22 66 61 69 6c 65   the.  ** "faile
3770: 64 20 74 6f 20 6f 70 65 6e 22 20 73 74 61 74 65  d to open" state
3780: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d  ..  */.  if( db-
3790: 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d  >magic!=SQLITE_M
37a0: 41 47 49 43 5f 43 4c 4f 53 45 44 20 26 26 20 73  AGIC_CLOSED && s
37b0: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64  qlite3SafetyOn(d
37c0: 62 29 20 29 7b 0a 20 20 20 20 2f 2a 20 70 72 69  b) ){.    /* pri
37d0: 6e 74 66 28 22 44 49 44 20 4e 4f 54 20 43 4c 4f  ntf("DID NOT CLO
37e0: 53 45 5c 6e 22 29 3b 20 66 66 6c 75 73 68 28 73  SE\n"); fflush(s
37f0: 74 64 6f 75 74 29 3b 20 2a 2f 0a 20 20 20 20 72  tdout); */.    r
3800: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52  eturn SQLITE_ERR
3810: 4f 52 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 6a  OR;.  }..  for(j
3820: 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a  =0; j<db->nDb; j
3830: 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20  ++){.    struct 
3840: 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e 61  Db *pDb = &db->a
3850: 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 70  Db[j];.    if( p
3860: 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20  Db->pBt ){.     
3870: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
3880: 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20  se(pDb->pBt);.  
3890: 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 30      pDb->pBt = 0
38a0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71  ;.    }.  }.  sq
38b0: 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e  lite3ResetIntern
38c0: 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b  alSchema(db, 0);
38d0: 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e  .  assert( db->n
38e0: 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72  Db<=2 );.  asser
38f0: 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e  t( db->aDb==db->
3900: 61 44 62 53 74 61 74 69 63 20 29 3b 0a 20 20 66  aDbStatic );.  f
3910: 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46  or(i=sqliteHashF
3920: 69 72 73 74 28 26 64 62 2d 3e 61 46 75 6e 63 29  irst(&db->aFunc)
3930: 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73  ; i; i=sqliteHas
3940: 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 46  hNext(i)){.    F
3950: 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c 20 2a  uncDef *pFunc, *
3960: 70 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72 28 70  pNext;.    for(p
3970: 46 75 6e 63 20 3d 20 28 46 75 6e 63 44 65 66 2a  Func = (FuncDef*
3980: 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28  )sqliteHashData(
3990: 69 29 3b 20 70 46 75 6e 63 3b 20 70 46 75 6e 63  i); pFunc; pFunc
39a0: 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 70  =pNext){.      p
39b0: 4e 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e 70 4e  Next = pFunc->pN
39c0: 65 78 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  ext;.      sqlit
39d0: 65 46 72 65 65 28 70 46 75 6e 63 29 3b 0a 20 20  eFree(pFunc);.  
39e0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 69    }.  }..  for(i
39f0: 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74  =sqliteHashFirst
3a00: 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b  (&db->aCollSeq);
3a10: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68   i; i=sqliteHash
3a20: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43 6f  Next(i)){.    Co
3a30: 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28  llSeq *pColl = (
3a40: 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74 65  CollSeq *)sqlite
3a50: 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 20  HashData(i);.   
3a60: 20 73 71 6c 69 74 65 46 72 65 65 28 70 43 6f 6c   sqliteFree(pCol
3a70: 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  l);.  }.  sqlite
3a80: 33 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e  3HashClear(&db->
3a90: 61 43 6f 6c 6c 53 65 71 29 3b 0a 0a 20 20 73 71  aCollSeq);..  sq
3aa0: 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26  lite3HashClear(&
3ab0: 64 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 73 71  db->aFunc);.  sq
3ac0: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53  lite3Error(db, S
3ad0: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 2f 2a  QLITE_OK, 0); /*
3ae0: 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 6e 79   Deallocates any
3af0: 20 63 61 63 68 65 64 20 65 72 72 6f 72 20 73 74   cached error st
3b00: 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 28 20  rings. */.  if( 
3b10: 64 62 2d 3e 70 56 61 6c 75 65 20 29 7b 0a 20 20  db->pValue ){.  
3b20: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72    sqlite3ValueFr
3b30: 65 65 28 64 62 2d 3e 70 56 61 6c 75 65 29 3b 0a  ee(db->pValue);.
3b40: 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 70 45    }.  if( db->pE
3b50: 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  rr ){.    sqlite
3b60: 33 56 61 6c 75 65 46 72 65 65 28 64 62 2d 3e 70  3ValueFree(db->p
3b70: 45 72 72 29 3b 0a 20 20 7d 0a 0a 20 20 64 62 2d  Err);.  }..  db-
3b80: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f  >magic = SQLITE_
3b90: 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 20 20 73  MAGIC_ERROR;.  s
3ba0: 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b 0a 20  qliteFree(db);. 
3bb0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
3bc0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c  K;.}../*.** Roll
3bd0: 62 61 63 6b 20 61 6c 6c 20 64 61 74 61 62 61 73  back all databas
3be0: 65 20 66 69 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 64  e files..*/.void
3bf0: 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b   sqlite3Rollback
3c00: 41 6c 6c 28 73 71 6c 69 74 65 20 2a 64 62 29 7b  All(sqlite *db){
3c10: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28  .  int i;.  for(
3c20: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
3c30: 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 64 62  i++){.    if( db
3c40: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 20 29 7b 0a  ->aDb[i].pBt ){.
3c50: 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72        sqlite3Btr
3c60: 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 61  eeRollback(db->a
3c70: 44 62 5b 69 5d 2e 70 42 74 29 3b 0a 20 20 20 20  Db[i].pBt);.    
3c80: 20 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54    db->aDb[i].inT
3c90: 72 61 6e 73 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  rans = 0;.    }.
3ca0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 52 65 73    }.  sqlite3Res
3cb0: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61  etInternalSchema
3cc0: 28 64 62 2c 20 30 29 3b 0a 20 20 2f 2a 20 73 71  (db, 0);.  /* sq
3cd0: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 49 6e 74  lite3RollbackInt
3ce0: 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29  ernalChanges(db)
3cf0: 3b 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  ; */.}../*.** Re
3d00: 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 74  turn a static st
3d10: 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 69  ring that descri
3d20: 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 20  bes the kind of 
3d30: 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 20  error specified 
3d40: 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65  in the.** argume
3d50: 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  nt..*/.const cha
3d60: 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53 74 72  r *sqlite3ErrStr
3d70: 28 69 6e 74 20 72 63 29 7b 0a 20 20 63 6f 6e 73  (int rc){.  cons
3d80: 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 73 77 69  t char *z;.  swi
3d90: 74 63 68 28 20 72 63 20 29 7b 0a 20 20 20 20 63  tch( rc ){.    c
3da0: 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a 20 20  ase SQLITE_OK:  
3db0: 20 20 20 20 20 20 20 7a 20 3d 20 22 6e 6f 74 20         z = "not 
3dc0: 61 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20 20  an error";      
3dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3de0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
3df0: 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  ase SQLITE_ERROR
3e00: 3a 20 20 20 20 20 20 7a 20 3d 20 22 53 51 4c 20  :      z = "SQL 
3e10: 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72 20 6d  logic error or m
3e20: 69 73 73 69 6e 67 20 64 61 74 61 62 61 73 65 22  issing database"
3e30: 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63  ;   break;.    c
3e40: 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52  ase SQLITE_INTER
3e50: 4e 41 4c 3a 20 20 20 7a 20 3d 20 22 69 6e 74 65  NAL:   z = "inte
3e60: 72 6e 61 6c 20 53 51 4c 69 74 65 20 69 6d 70 6c  rnal SQLite impl
3e70: 65 6d 65 6e 74 61 74 69 6f 6e 20 66 6c 61 77 22  ementation flaw"
3e80: 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63  ;   break;.    c
3e90: 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52 4d 3a  ase SQLITE_PERM:
3ea0: 20 20 20 20 20 20 20 7a 20 3d 20 22 61 63 63 65         z = "acce
3eb0: 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 20 64 65  ss permission de
3ec0: 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20 20 20  nied";          
3ed0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
3ee0: 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 54  ase SQLITE_ABORT
3ef0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 63 61 6c 6c  :      z = "call
3f00: 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 20 71  back requested q
3f10: 75 65 72 79 20 61 62 6f 72 74 22 3b 20 20 20 20  uery abort";    
3f20: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
3f30: 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 3a  ase SQLITE_BUSY:
3f40: 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61         z = "data
3f50: 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 3b  base is locked";
3f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3f70: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
3f80: 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45  ase SQLITE_LOCKE
3f90: 44 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61  D:     z = "data
3fa0: 62 61 73 65 20 74 61 62 6c 65 20 69 73 20 6c 6f  base table is lo
3fb0: 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20 20  cked";          
3fc0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
3fd0: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  ase SQLITE_NOMEM
3fe0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 6f 75 74 20  :      z = "out 
3ff0: 6f 66 20 6d 65 6d 6f 72 79 22 3b 20 20 20 20 20  of memory";     
4000: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4010: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4020: 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f  ase SQLITE_READO
4030: 4e 4c 59 3a 20 20 20 7a 20 3d 20 22 61 74 74 65  NLY:   z = "atte
4040: 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61 20 72  mpt to write a r
4050: 65 61 64 6f 6e 6c 79 20 64 61 74 61 62 61 73 65  eadonly database
4060: 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63  ";  break;.    c
4070: 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52  ase SQLITE_INTER
4080: 52 55 50 54 3a 20 20 7a 20 3d 20 22 69 6e 74 65  RUPT:  z = "inte
4090: 72 72 75 70 74 65 64 22 3b 20 20 20 20 20 20 20  rrupted";       
40a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
40b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
40c0: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  ase SQLITE_IOERR
40d0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 64 69 73 6b  :      z = "disk
40e0: 20 49 2f 4f 20 65 72 72 6f 72 22 3b 20 20 20 20   I/O error";    
40f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4100: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4110: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55  ase SQLITE_CORRU
4120: 50 54 3a 20 20 20 20 7a 20 3d 20 22 64 61 74 61  PT:    z = "data
4130: 62 61 73 65 20 64 69 73 6b 20 69 6d 61 67 65 20  base disk image 
4140: 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22 3b 20 20  is malformed";  
4150: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4160: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 46 4f  ase SQLITE_NOTFO
4170: 55 4e 44 3a 20 20 20 7a 20 3d 20 22 74 61 62 6c  UND:   z = "tabl
4180: 65 20 6f 72 20 72 65 63 6f 72 64 20 6e 6f 74 20  e or record not 
4190: 66 6f 75 6e 64 22 3b 20 20 20 20 20 20 20 20 20  found";         
41a0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
41b0: 61 73 65 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3a  ase SQLITE_FULL:
41c0: 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61         z = "data
41d0: 62 61 73 65 20 69 73 20 66 75 6c 6c 22 3b 20 20  base is full";  
41e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
41f0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4200: 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f  ase SQLITE_CANTO
4210: 50 45 4e 3a 20 20 20 7a 20 3d 20 22 75 6e 61 62  PEN:   z = "unab
4220: 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62  le to open datab
4230: 61 73 65 20 66 69 6c 65 22 3b 20 20 20 20 20 20  ase file";      
4240: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4250: 61 73 65 20 53 51 4c 49 54 45 5f 50 52 4f 54 4f  ase SQLITE_PROTO
4260: 43 4f 4c 3a 20 20 20 7a 20 3d 20 22 64 61 74 61  COL:   z = "data
4270: 62 61 73 65 20 6c 6f 63 6b 69 6e 67 20 70 72 6f  base locking pro
4280: 74 6f 63 6f 6c 20 66 61 69 6c 75 72 65 22 3b 20  tocol failure"; 
4290: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
42a0: 61 73 65 20 53 51 4c 49 54 45 5f 45 4d 50 54 59  ase SQLITE_EMPTY
42b0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 74 61 62 6c  :      z = "tabl
42c0: 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 64 61  e contains no da
42d0: 74 61 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ta";            
42e0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
42f0: 61 73 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d  ase SQLITE_SCHEM
4300: 41 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61  A:     z = "data
4310: 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20  base schema has 
4320: 63 68 61 6e 67 65 64 22 3b 20 20 20 20 20 20 20  changed";       
4330: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4340: 61 73 65 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49  ase SQLITE_TOOBI
4350: 47 3a 20 20 20 20 20 7a 20 3d 20 22 74 6f 6f 20  G:     z = "too 
4360: 6d 75 63 68 20 64 61 74 61 20 66 6f 72 20 6f 6e  much data for on
4370: 65 20 74 61 62 6c 65 20 72 6f 77 22 3b 20 20 20  e table row";   
4380: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4390: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54  ase SQLITE_CONST
43a0: 52 41 49 4e 54 3a 20 7a 20 3d 20 22 63 6f 6e 73  RAINT: z = "cons
43b0: 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 3b 20  traint failed"; 
43c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
43d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
43e0: 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41  ase SQLITE_MISMA
43f0: 54 43 48 3a 20 20 20 7a 20 3d 20 22 64 61 74 61  TCH:   z = "data
4400: 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22 3b 20  type mismatch"; 
4410: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4420: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4430: 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  ase SQLITE_MISUS
4440: 45 3a 20 20 20 20 20 7a 20 3d 20 22 6c 69 62 72  E:     z = "libr
4450: 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c  ary routine call
4460: 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e  ed out of sequen
4470: 63 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 63  ce";break;.    c
4480: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53  ase SQLITE_NOLFS
4490: 3a 20 20 20 20 20 20 7a 20 3d 20 22 6b 65 72 6e  :      z = "kern
44a0: 65 6c 20 6c 61 63 6b 73 20 6c 61 72 67 65 20 66  el lacks large f
44b0: 69 6c 65 20 73 75 70 70 6f 72 74 22 3b 20 20 20  ile support";   
44c0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
44d0: 61 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48 3a  ase SQLITE_AUTH:
44e0: 20 20 20 20 20 20 20 7a 20 3d 20 22 61 75 74 68         z = "auth
44f0: 6f 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69 65 64  orization denied
4500: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
4510: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4520: 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41  ase SQLITE_FORMA
4530: 54 3a 20 20 20 20 20 7a 20 3d 20 22 61 75 78 69  T:     z = "auxi
4540: 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 20 66  liary database f
4550: 6f 72 6d 61 74 20 65 72 72 6f 72 22 3b 20 20 20  ormat error";   
4560: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
4570: 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  ase SQLITE_RANGE
4580: 3a 20 20 20 20 20 20 7a 20 3d 20 22 62 69 6e 64  :      z = "bind
4590: 20 69 6e 64 65 78 20 6f 75 74 20 6f 66 20 72 61   index out of ra
45a0: 6e 67 65 22 3b 20 20 20 20 20 20 20 20 20 20 20  nge";           
45b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
45c0: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44  ase SQLITE_NOTAD
45d0: 42 3a 20 20 20 20 20 7a 20 3d 20 22 66 69 6c 65  B:     z = "file
45e0: 20 69 73 20 65 6e 63 72 79 70 74 65 64 20 6f 72   is encrypted or
45f0: 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61 62 61   is not a databa
4600: 73 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 64  se";break;.    d
4610: 65 66 61 75 6c 74 3a 20 20 20 20 20 20 20 20 20  efault:         
4620: 20 20 20 20 20 20 20 7a 20 3d 20 22 75 6e 6b 6e         z = "unkn
4630: 6f 77 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20  own error";     
4640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4650: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20      break;.  }. 
4660: 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f 2a   return z;.}../*
4670: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
4680: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62 75   implements a bu
4690: 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61 74  sy callback that
46a0: 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69 65   sleeps and trie
46b0: 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69 6c  s.** again until
46c0: 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65   a timeout value
46d0: 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 54 68   is reached.  Th
46e0: 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20  e timeout value 
46f0: 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72  is.** an integer
4700: 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69   number of milli
4710: 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20 69  seconds passed i
4720: 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a  n as the first.*
4730: 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73  * argument..*/.s
4740: 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65  tatic int sqlite
4750: 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62  DefaultBusyCallb
4760: 61 63 6b 28 0a 20 76 6f 69 64 20 2a 54 69 6d 65  ack(. void *Time
4770: 6f 75 74 2c 20 20 20 20 20 20 20 20 20 20 20 2f  out,           /
4780: 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74  * Maximum amount
4790: 20 6f 66 20 74 69 6d 65 20 74 6f 20 77 61 69 74   of time to wait
47a0: 20 2a 2f 0a 20 69 6e 74 20 63 6f 75 6e 74 20 20   */. int count  
47b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
47c0: 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73   Number of times
47d0: 20 74 61 62 6c 65 20 68 61 73 20 62 65 65 6e 20   table has been 
47e0: 62 75 73 79 20 2a 2f 0a 29 7b 0a 23 69 66 20 53  busy */.){.#if S
47f0: 51 4c 49 54 45 5f 4d 49 4e 5f 53 4c 45 45 50 5f  QLITE_MIN_SLEEP_
4800: 4d 53 3d 3d 31 0a 20 20 73 74 61 74 69 63 20 63  MS==1.  static c
4810: 6f 6e 73 74 20 63 68 61 72 20 64 65 6c 61 79 73  onst char delays
4820: 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 31 2c 20 32  [] =.     { 1, 2
4830: 2c 20 35 2c 20 31 30 2c 20 31 35 2c 20 32 30 2c  , 5, 10, 15, 20,
4840: 20 32 35 2c 20 32 35 2c 20 20 32 35 2c 20 20 35   25, 25,  25,  5
4850: 30 2c 20 20 35 30 2c 20 20 35 30 2c 20 31 30 30  0,  50,  50, 100
4860: 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73  };.  static cons
4870: 74 20 73 68 6f 72 74 20 69 6e 74 20 74 6f 74 61  t short int tota
4880: 6c 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 30 2c  ls[] =.     { 0,
4890: 20 31 2c 20 33 2c 20 20 38 2c 20 31 38 2c 20 33   1, 3,  8, 18, 3
48a0: 33 2c 20 35 33 2c 20 37 38 2c 20 31 30 33 2c 20  3, 53, 78, 103, 
48b0: 31 32 38 2c 20 31 37 38 2c 20 32 32 38 2c 20 32  128, 178, 228, 2
48c0: 38 37 7d 3b 0a 23 20 64 65 66 69 6e 65 20 4e 44  87};.# define ND
48d0: 45 4c 41 59 20 28 73 69 7a 65 6f 66 28 64 65 6c  ELAY (sizeof(del
48e0: 61 79 73 29 2f 73 69 7a 65 6f 66 28 64 65 6c 61  ays)/sizeof(dela
48f0: 79 73 5b 30 5d 29 29 0a 20 20 69 6e 74 20 74 69  ys[0])).  int ti
4900: 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54 69 6d  meout = (int)Tim
4910: 65 6f 75 74 3b 0a 20 20 69 6e 74 20 64 65 6c 61  eout;.  int dela
4920: 79 2c 20 70 72 69 6f 72 3b 0a 0a 20 20 69 66 28  y, prior;..  if(
4930: 20 63 6f 75 6e 74 20 3c 3d 20 4e 44 45 4c 41 59   count <= NDELAY
4940: 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20   ){.    delay = 
4950: 64 65 6c 61 79 73 5b 63 6f 75 6e 74 2d 31 5d 3b  delays[count-1];
4960: 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74  .    prior = tot
4970: 61 6c 73 5b 63 6f 75 6e 74 2d 31 5d 3b 0a 20 20  als[count-1];.  
4980: 7d 65 6c 73 65 7b 0a 20 20 20 20 64 65 6c 61 79  }else{.    delay
4990: 20 3d 20 64 65 6c 61 79 73 5b 4e 44 45 4c 41 59   = delays[NDELAY
49a0: 2d 31 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d  -1];.    prior =
49b0: 20 74 6f 74 61 6c 73 5b 4e 44 45 4c 41 59 2d 31   totals[NDELAY-1
49c0: 5d 20 2b 20 64 65 6c 61 79 2a 28 63 6f 75 6e 74  ] + delay*(count
49d0: 2d 4e 44 45 4c 41 59 2d 31 29 3b 0a 20 20 7d 0a  -NDELAY-1);.  }.
49e0: 20 20 69 66 28 20 70 72 69 6f 72 20 2b 20 64 65    if( prior + de
49f0: 6c 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b  lay > timeout ){
4a00: 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 74 69 6d  .    delay = tim
4a10: 65 6f 75 74 20 2d 20 70 72 69 6f 72 3b 0a 20 20  eout - prior;.  
4a20: 20 20 69 66 28 20 64 65 6c 61 79 3c 3d 30 20 29    if( delay<=0 )
4a30: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20   return 0;.  }. 
4a40: 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28   sqlite3OsSleep(
4a50: 64 65 6c 61 79 29 3b 0a 20 20 72 65 74 75 72 6e  delay);.  return
4a60: 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20   1;.#else.  int 
4a70: 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54  timeout = (int)T
4a80: 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20 28 63  imeout;.  if( (c
4a90: 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20 74  ount+1)*1000 > t
4aa0: 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 72 65  imeout ){.    re
4ab0: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71  turn 0;.  }.  sq
4ac0: 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 31 30 30  lite3OsSleep(100
4ad0: 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  0);.  return 1;.
4ae0: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  #endif.}../*.** 
4af0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74  This routine set
4b00: 73 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62  s the busy callb
4b10: 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69 74  ack for an Sqlit
4b20: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68  e database to th
4b30: 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62  e.** given callb
4b40: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69 74  ack function wit
4b50: 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67 75  h the given argu
4b60: 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ment..*/.int sql
4b70: 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65  ite3_busy_handle
4b80: 72 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  r(.  sqlite3 *db
4b90: 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79 29  ,.  int (*xBusy)
4ba0: 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a 20 20 76  (void*,int),.  v
4bb0: 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 64  oid *pArg.){.  d
4bc0: 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 78  b->busyHandler.x
4bd0: 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a 20 20  Func = xBusy;.  
4be0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e  db->busyHandler.
4bf0: 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72  pArg = pArg;.  r
4c00: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
4c10: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  .}..#ifndef SQLI
4c20: 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53  TE_OMIT_PROGRESS
4c30: 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20  _CALLBACK./*.** 
4c40: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74  This routine set
4c50: 73 20 74 68 65 20 70 72 6f 67 72 65 73 73 20 63  s the progress c
4c60: 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53  allback for an S
4c70: 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74  qlite database t
4c80: 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63  o the.** given c
4c90: 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e  allback function
4ca0: 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20   with the given 
4cb0: 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 72  argument. The pr
4cc0: 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20  ogress callback 
4cd0: 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b  will.** be invok
4ce0: 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20 6f 70  ed every nOps op
4cf0: 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73  codes..*/.void s
4d00: 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f  qlite3_progress_
4d10: 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74  handler(.  sqlit
4d20: 65 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e 4f  e *db, .  int nO
4d30: 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72 6f  ps,.  int (*xPro
4d40: 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20 0a  gress)(void*), .
4d50: 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a    void *pArg.){.
4d60: 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 29 7b 0a    if( nOps>0 ){.
4d70: 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 73      db->xProgres
4d80: 73 20 3d 20 78 50 72 6f 67 72 65 73 73 3b 0a 20  s = xProgress;. 
4d90: 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73     db->nProgress
4da0: 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a 20 20 20 20  Ops = nOps;.    
4db0: 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 67  db->pProgressArg
4dc0: 20 3d 20 70 41 72 67 3b 0a 20 20 7d 65 6c 73 65   = pArg;.  }else
4dd0: 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 72  {.    db->xProgr
4de0: 65 73 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d  ess = 0;.    db-
4df0: 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20 3d 20  >nProgressOps = 
4e00: 30 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72 6f 67  0;.    db->pProg
4e10: 72 65 73 73 41 72 67 20 3d 20 30 3b 0a 20 20 7d  ressArg = 0;.  }
4e20: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a  .}.#endif.../*.*
4e30: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
4e40: 6e 73 74 61 6c 6c 73 20 61 20 64 65 66 61 75 6c  nstalls a defaul
4e50: 74 20 62 75 73 79 20 68 61 6e 64 6c 65 72 20 74  t busy handler t
4e60: 68 61 74 20 77 61 69 74 73 20 66 6f 72 20 74 68  hat waits for th
4e70: 65 0a 2a 2a 20 73 70 65 63 69 66 69 65 64 20 6e  e.** specified n
4e80: 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65  umber of millise
4e90: 63 6f 6e 64 73 20 62 65 66 6f 72 65 20 72 65 74  conds before ret
4ea0: 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74  urning 0..*/.int
4eb0: 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 74 69   sqlite3_busy_ti
4ec0: 6d 65 6f 75 74 28 73 71 6c 69 74 65 33 20 2a 64  meout(sqlite3 *d
4ed0: 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20 20 69 66  b, int ms){.  if
4ee0: 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20 20 73 71  ( ms>0 ){.    sq
4ef0: 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c  lite3_busy_handl
4f00: 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65 66  er(db, sqliteDef
4f10: 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b  aultBusyCallback
4f20: 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a 20 20  , (void*)ms);.  
4f30: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74  }else{.    sqlit
4f40: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28  e3_busy_handler(
4f50: 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20  db, 0, 0);.  }. 
4f60: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
4f70: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73  K;.}../*.** Caus
4f80: 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70  e any pending op
4f90: 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20  eration to stop 
4fa0: 61 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20  at its earliest 
4fb0: 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a  opportunity..*/.
4fc0: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 6e 74  void sqlite3_int
4fd0: 65 72 72 75 70 74 28 73 71 6c 69 74 65 20 2a 64  errupt(sqlite *d
4fe0: 62 29 7b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20  b){.  db->flags 
4ff0: 7c 3d 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 72  |= SQLITE_Interr
5000: 75 70 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69  upt;.}../*.** Wi
5010: 6e 64 6f 77 73 20 73 79 73 74 65 6d 73 20 73 68  ndows systems sh
5020: 6f 75 6c 64 20 63 61 6c 6c 20 74 68 69 73 20 72  ould call this r
5030: 6f 75 74 69 6e 65 20 74 6f 20 66 72 65 65 20 6d  outine to free m
5040: 65 6d 6f 72 79 20 74 68 61 74 0a 2a 2a 20 69 73  emory that.** is
5050: 20 72 65 74 75 72 6e 65 64 20 69 6e 20 74 68 65   returned in the
5060: 20 69 6e 20 74 68 65 20 65 72 72 6d 73 67 20 70   in the errmsg p
5070: 61 72 61 6d 65 74 65 72 20 6f 66 20 73 71 6c 69  arameter of sqli
5080: 74 65 33 5f 6f 70 65 6e 28 29 20 77 68 65 6e 0a  te3_open() when.
5090: 2a 2a 20 53 51 4c 69 74 65 20 69 73 20 61 20 44  ** SQLite is a D
50a0: 4c 4c 2e 20 20 46 6f 72 20 73 6f 6d 65 20 72 65  LL.  For some re
50b0: 61 73 6f 6e 2c 20 69 74 20 64 6f 65 73 20 6e 6f  ason, it does no
50c0: 74 20 77 6f 72 6b 20 74 6f 20 63 61 6c 6c 20 66  t work to call f
50d0: 72 65 65 28 29 0a 2a 2a 20 64 69 72 65 63 74 6c  ree().** directl
50e0: 79 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68  y..**.** Note th
50f0: 61 74 20 77 65 20 6e 65 65 64 20 74 6f 20 63 61  at we need to ca
5100: 6c 6c 20 66 72 65 65 28 29 20 6e 6f 74 20 73 71  ll free() not sq
5110: 6c 69 74 65 46 72 65 65 28 29 20 68 65 72 65 2c  liteFree() here,
5120: 20 73 69 6e 63 65 20 65 76 65 72 79 0a 2a 2a 20   since every.** 
5130: 73 74 72 69 6e 67 20 74 68 61 74 20 69 73 20 65  string that is e
5140: 78 70 6f 72 74 65 64 20 66 72 6f 6d 20 53 51 4c  xported from SQL
5150: 69 74 65 20 73 68 6f 75 6c 64 20 68 61 76 65 20  ite should have 
5160: 61 6c 72 65 61 64 79 20 70 61 73 73 65 64 20 74  already passed t
5170: 68 72 6f 75 67 68 0a 2a 2a 20 73 71 6c 69 74 65  hrough.** sqlite
5180: 33 53 74 72 52 65 61 6c 6c 6f 63 28 29 2e 0a 2a  3StrRealloc()..*
5190: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 66  /.void sqlite3_f
51a0: 72 65 65 28 63 68 61 72 20 2a 70 29 7b 20 66 72  ree(char *p){ fr
51b0: 65 65 28 70 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20  ee(p); }../*.** 
51c0: 43 72 65 61 74 65 20 6e 65 77 20 75 73 65 72 20  Create new user 
51d0: 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e  functions..*/.in
51e0: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65  t sqlite3_create
51f0: 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c  _function(.  sql
5200: 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73  ite3 *db,.  cons
5210: 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 74 69 6f  t char *zFunctio
5220: 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72  nName,.  int nAr
5230: 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 20  g,.  int enc,.  
5240: 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 2c  void *pUserData,
5250: 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29  .  void (*xFunc)
5260: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
5270: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61  *,int,sqlite3_va
5280: 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20  lue **),.  void 
5290: 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65 33  (*xStep)(sqlite3
52a0: 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71  _context*,int,sq
52b0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c  lite3_value **),
52c0: 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c  .  void (*xFinal
52d0: 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  )(sqlite3_contex
52e0: 74 2a 29 0a 29 7b 0a 20 20 46 75 6e 63 44 65 66  t*).){.  FuncDef
52f0: 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65   *p;.  int nName
5300: 3b 0a 0a 20 20 69 66 28 20 28 64 62 3d 3d 30 20  ;..  if( (db==0 
5310: 7c 7c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65  || zFunctionName
5320: 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 53 61  ==0 || sqlite3Sa
5330: 66 65 74 79 43 68 65 63 6b 28 64 62 29 29 20 7c  fetyCheck(db)) |
5340: 7c 0a 20 20 20 20 20 20 28 78 46 75 6e 63 20 26  |.      (xFunc &
5350: 26 20 28 78 46 69 6e 61 6c 20 7c 7c 20 78 53 74  & (xFinal || xSt
5360: 65 70 29 29 20 7c 7c 20 0a 20 20 20 20 20 20 28  ep)) || .      (
5370: 21 78 46 75 6e 63 20 26 26 20 28 78 46 69 6e 61  !xFunc && (xFina
5380: 6c 20 26 26 20 21 78 53 74 65 70 29 29 20 7c 7c  l && !xStep)) ||
5390: 0a 20 20 20 20 20 20 28 21 78 46 75 6e 63 20 26  .      (!xFunc &
53a0: 26 20 28 21 78 46 69 6e 61 6c 20 26 26 20 78 53  & (!xFinal && xS
53b0: 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 20 20 28  tep)) ||.      (
53c0: 6e 41 72 67 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e  nArg<-1 || nArg>
53d0: 31 32 37 29 20 7c 7c 0a 20 20 20 20 20 20 28 32  127) ||.      (2
53e0: 35 35 3c 28 6e 4e 61 6d 65 20 3d 20 73 74 72 6c  55<(nName = strl
53f0: 65 6e 28 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65  en(zFunctionName
5400: 29 29 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ))) ){.    retur
5410: 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  n SQLITE_ERROR;.
5420: 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 49 66 20 53    }.  .  /* If S
5430: 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 73  QLITE_UTF16 is s
5440: 70 65 63 69 66 69 65 64 20 61 73 20 74 68 65 20  pecified as the 
5450: 65 6e 63 6f 64 69 6e 67 20 74 79 70 65 2c 20 74  encoding type, t
5460: 72 61 6e 73 66 6f 72 6d 20 74 68 69 73 0a 20 20  ransform this.  
5470: 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66 20 53 51 4c  ** to one of SQL
5480: 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53  ITE_UTF16LE or S
5490: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 75 73  QLITE_UTF16BE us
54a0: 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c  ing the.  ** SQL
54b0: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20  ITE_UTF16NATIVE 
54c0: 6d 61 63 72 6f 2e 20 53 51 4c 49 54 45 5f 55 54  macro. SQLITE_UT
54d0: 46 31 36 20 69 73 20 6e 6f 74 20 75 73 65 64 20  F16 is not used 
54e0: 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2a  internally..  **
54f0: 0a 20 20 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f  .  ** If SQLITE_
5500: 41 4e 59 20 69 73 20 73 70 65 63 69 66 69 65 64  ANY is specified
5510: 2c 20 61 64 64 20 74 68 72 65 65 20 76 65 72 73  , add three vers
5520: 69 6f 6e 73 20 6f 66 20 74 68 65 20 66 75 6e 63  ions of the func
5530: 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 74 68 65  tion.  ** to the
5540: 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 20 20 2a   hash table..  *
5550: 2f 0a 20 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c  /.  if( enc==SQL
5560: 49 54 45 5f 55 54 46 31 36 20 29 7b 0a 20 20 20  ITE_UTF16 ){.   
5570: 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54   enc = SQLITE_UT
5580: 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d 65 6c  F16NATIVE;.  }el
5590: 73 65 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49  se if( enc==SQLI
55a0: 54 45 5f 41 4e 59 20 29 7b 0a 20 20 20 20 69 6e  TE_ANY ){.    in
55b0: 74 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 73  t rc;.    rc = s
55c0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75  qlite3_create_fu
55d0: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63  nction(db, zFunc
55e0: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20  tionName, nArg, 
55f0: 53 51 4c 49 54 45 5f 55 54 46 38 2c 0a 20 20 20  SQLITE_UTF8,.   
5600: 20 20 20 20 20 20 70 55 73 65 72 44 61 74 61 2c        pUserData,
5610: 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78   xFunc, xStep, x
5620: 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 66 28 20  Final);.    if( 
5630: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc!=SQLITE_OK ) 
5640: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 72  return rc;.    r
5650: 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65 61  c = sqlite3_crea
5660: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20  te_function(db, 
5670: 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e  zFunctionName, n
5680: 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  Arg, SQLITE_UTF1
5690: 36 4c 45 2c 0a 20 20 20 20 20 20 20 20 70 55 73  6LE,.        pUs
56a0: 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c 20 78  erData, xFunc, x
56b0: 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b 0a 20  Step, xFinal);. 
56c0: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
56d0: 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63  E_OK ) return rc
56e0: 3b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 4c 49  ;.    enc = SQLI
56f0: 54 45 5f 55 54 46 31 36 42 45 3b 0a 20 20 7d 0a  TE_UTF16BE;.  }.
5700: 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46 69  .  p = sqlite3Fi
5710: 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a  ndFunction(db, z
5720: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e  FunctionName, nN
5730: 61 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20  ame, nArg, enc, 
5740: 31 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29  1);.  if( p==0 )
5750: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 2d 3e   return 1;.  p->
5760: 78 46 75 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20  xFunc = xFunc;. 
5770: 20 70 2d 3e 78 53 74 65 70 20 3d 20 78 53 74 65   p->xStep = xSte
5780: 70 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a  p;.  p->xFinaliz
5790: 65 20 3d 20 78 46 69 6e 61 6c 3b 0a 20 20 70 2d  e = xFinal;.  p-
57a0: 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70 55 73  >pUserData = pUs
57b0: 65 72 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e  erData;.  return
57c0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 69 6e   SQLITE_OK;.}.in
57d0: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65  t sqlite3_create
57e0: 5f 66 75 6e 63 74 69 6f 6e 31 36 28 0a 20 20 73  _function16(.  s
57f0: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f  qlite3 *db,.  co
5800: 6e 73 74 20 76 6f 69 64 20 2a 7a 46 75 6e 63 74  nst void *zFunct
5810: 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e  ionName,.  int n
5820: 41 72 67 2c 0a 20 20 69 6e 74 20 65 54 65 78 74  Arg,.  int eText
5830: 52 65 70 2c 0a 20 20 76 6f 69 64 20 2a 70 55 73  Rep,.  void *pUs
5840: 65 72 44 61 74 61 2c 0a 20 20 76 6f 69 64 20 28  erData,.  void (
5850: 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f  *xFunc)(sqlite3_
5860: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c  context*,int,sql
5870: 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20  ite3_value**),. 
5880: 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73   void (*xStep)(s
5890: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c  qlite3_context*,
58a0: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75  int,sqlite3_valu
58b0: 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78  e**),.  void (*x
58c0: 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63  Final)(sqlite3_c
58d0: 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 69 6e  ontext*).){.  in
58e0: 74 20 72 63 3b 0a 20 20 63 68 61 72 20 63 6f 6e  t rc;.  char con
58f0: 73 74 20 2a 7a 46 75 6e 63 38 3b 0a 0a 20 20 73  st *zFunc8;..  s
5900: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 54  qlite3_value *pT
5910: 6d 70 20 3d 20 73 71 6c 69 74 65 33 47 65 74 54  mp = sqlite3GetT
5920: 72 61 6e 73 69 65 6e 74 56 61 6c 75 65 28 64 62  ransientValue(db
5930: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75  );.  sqlite3Valu
5940: 65 53 65 74 53 74 72 28 70 54 6d 70 2c 20 2d 31  eSetStr(pTmp, -1
5950: 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c  , zFunctionName,
5960: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
5970: 49 56 45 2c 53 51 4c 49 54 45 5f 53 54 41 54 49  IVE,SQLITE_STATI
5980: 43 29 3b 0a 20 20 7a 46 75 6e 63 38 20 3d 20 73  C);.  zFunc8 = s
5990: 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28  qlite3ValueText(
59a0: 70 54 6d 70 2c 20 53 51 4c 49 54 45 5f 55 54 46  pTmp, SQLITE_UTF
59b0: 38 29 3b 0a 0a 20 20 69 66 28 20 21 7a 46 75 6e  8);..  if( !zFun
59c0: 63 38 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  c8 ){.    return
59d0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
59e0: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65   }.  rc = sqlite
59f0: 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f  3_create_functio
5a00: 6e 28 64 62 2c 20 7a 46 75 6e 63 38 2c 20 6e 41  n(db, zFunc8, nA
5a10: 72 67 2c 20 65 54 65 78 74 52 65 70 2c 20 0a 20  rg, eTextRep, . 
5a20: 20 20 20 20 20 70 55 73 65 72 44 61 74 61 2c 20       pUserData, 
5a30: 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 46  xFunc, xStep, xF
5a40: 69 6e 61 6c 29 3b 0a 20 20 72 65 74 75 72 6e 20  inal);.  return 
5a50: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67  rc;.}../*.** Reg
5a60: 69 73 74 65 72 20 61 20 74 72 61 63 65 20 66 75  ister a trace fu
5a70: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72  nction.  The pAr
5a80: 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69  g from the previ
5a90: 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64  ously registered
5aa0: 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74   trace.** is ret
5ab0: 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41  urned.  .**.** A
5ac0: 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63   NULL trace func
5ad0: 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20  tion means that 
5ae0: 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 78  no tracing is ex
5af0: 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e  ecutes.  A non-N
5b00: 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20  ULL.** trace is 
5b10: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66  a pointer to a f
5b20: 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20  unction that is 
5b30: 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73  invoked at the s
5b40: 74 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20  tart of each.** 
5b50: 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a  sqlite3_exec()..
5b60: 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  */.void *sqlite3
5b70: 5f 74 72 61 63 65 28 73 71 6c 69 74 65 20 2a 64  _trace(sqlite *d
5b80: 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65  b, void (*xTrace
5b90: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68  )(void*,const ch
5ba0: 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 67  ar*), void *pArg
5bb0: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20  ){.  void *pOld 
5bc0: 3d 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 3b  = db->pTraceArg;
5bd0: 0a 20 20 64 62 2d 3e 78 54 72 61 63 65 20 3d 20  .  db->xTrace = 
5be0: 78 54 72 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54  xTrace;.  db->pT
5bf0: 72 61 63 65 41 72 67 20 3d 20 70 41 72 67 3b 0a  raceArg = pArg;.
5c00: 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d    return pOld;.}
5c10: 0a 0a 2f 2a 2a 2a 20 45 58 50 45 52 49 4d 45 4e  ../*** EXPERIMEN
5c20: 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65  TAL ***.**.** Re
5c30: 67 69 73 74 65 72 20 61 20 66 75 6e 63 74 69 6f  gister a functio
5c40: 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20  n to be invoked 
5c50: 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74 69  when a transacti
5c60: 6f 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a 20  on comments..** 
5c70: 49 66 20 65 69 74 68 65 72 20 66 75 6e 63 74 69  If either functi
5c80: 6f 6e 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a  on returns non-z
5c90: 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 63 6f  ero, then the co
5ca0: 6d 6d 69 74 20 62 65 63 6f 6d 65 73 20 61 0a 2a  mmit becomes a.*
5cb0: 2a 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 76  * rollback..*/.v
5cc0: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6d  oid *sqlite3_com
5cd0: 6d 69 74 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69  mit_hook(.  sqli
5ce0: 74 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  te *db,         
5cf0: 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20        /* Attach 
5d00: 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73  the hook to this
5d10: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69   database */.  i
5d20: 6e 74 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28  nt (*xCallback)(
5d30: 76 6f 69 64 2a 29 2c 20 20 2f 2a 20 46 75 6e 63  void*),  /* Func
5d40: 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b 65 20 6f  tion to invoke o
5d50: 6e 20 65 61 63 68 20 63 6f 6d 6d 69 74 20 2a 2f  n each commit */
5d60: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20  .  void *pArg   
5d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5d80: 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20  Argument to the 
5d90: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20  function */.){. 
5da0: 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62   void *pOld = db
5db0: 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 20  ->pCommitArg;.  
5dc0: 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62  db->xCommitCallb
5dd0: 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b  ack = xCallback;
5de0: 0a 20 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72  .  db->pCommitAr
5df0: 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 65 74 75  g = pArg;.  retu
5e00: 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 0a 2f 2a 0a  rn pOld;.}.../*.
5e10: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
5e20: 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 63 72 65  is called to cre
5e30: 61 74 65 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e  ate a connection
5e40: 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 42   to a database B
5e50: 54 72 65 65 0a 2a 2a 20 64 72 69 76 65 72 2e 20  Tree.** driver. 
5e60: 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73   If zFilename is
5e70: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 66   the name of a f
5e80: 69 6c 65 2c 20 74 68 65 6e 20 74 68 61 74 20 66  ile, then that f
5e90: 69 6c 65 20 69 73 0a 2a 2a 20 6f 70 65 6e 65 64  ile is.** opened
5ea0: 20 61 6e 64 20 75 73 65 64 2e 20 20 49 66 20 7a   and used.  If z
5eb0: 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 20  Filename is the 
5ec0: 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d 65 6d  magic name ":mem
5ed0: 6f 72 79 3a 22 20 74 68 65 6e 0a 2a 2a 20 74 68  ory:" then.** th
5ee0: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 73 74  e database is st
5ef0: 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 28  ored in memory (
5f00: 61 6e 64 20 69 73 20 74 68 75 73 20 66 6f 72 67  and is thus forg
5f10: 6f 74 74 65 6e 20 61 73 20 73 6f 6f 6e 20 61 73  otten as soon as
5f20: 0a 2a 2a 20 74 68 65 20 63 6f 6e 6e 65 63 74 69  .** the connecti
5f30: 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e 29 20 20  on is closed.)  
5f40: 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20  If zFilename is 
5f50: 4e 55 4c 4c 20 74 68 65 6e 20 74 68 65 20 64 61  NULL then the da
5f60: 74 61 62 61 73 65 0a 2a 2a 20 69 73 20 66 6f 72  tabase.** is for
5f70: 20 74 65 6d 70 6f 72 61 72 79 20 75 73 65 20 6f   temporary use o
5f80: 6e 6c 79 20 61 6e 64 20 69 73 20 64 65 6c 65 74  nly and is delet
5f90: 65 64 20 61 73 20 73 6f 6f 6e 20 61 73 20 74 68  ed as soon as th
5fa0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20  e connection.** 
5fb0: 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2f 0a 69 6e  is closed..*/.in
5fc0: 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 61  t sqlite3BtreeFa
5fd0: 63 74 6f 72 79 28 0a 20 20 63 6f 6e 73 74 20 73  ctory(.  const s
5fe0: 71 6c 69 74 65 20 2a 64 62 2c 09 20 20 20 20 2f  qlite *db,.    /
5ff0: 2a 20 4d 61 69 6e 20 64 61 74 61 62 61 73 65 20  * Main database 
6000: 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 61 75 78  when opening aux
6010: 20 6f 74 68 65 72 77 69 73 65 20 30 20 2a 2f 0a   otherwise 0 */.
6020: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46    const char *zF
6030: 69 6c 65 6e 61 6d 65 2c 20 20 20 20 2f 2a 20 4e  ilename,    /* N
6040: 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20  ame of the file 
6050: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42  containing the B
6060: 54 72 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f  Tree database */
6070: 0a 20 20 69 6e 74 20 6f 6d 69 74 4a 6f 75 72 6e  .  int omitJourn
6080: 61 6c 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  al,          /* 
6090: 69 66 20 54 52 55 45 20 74 68 65 6e 20 64 6f 20  if TRUE then do 
60a0: 6e 6f 74 20 6a 6f 75 72 6e 61 6c 20 74 68 69 73  not journal this
60b0: 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e   file */.  int n
60c0: 43 61 63 68 65 2c 20 20 20 20 20 20 20 20 20 20  Cache,          
60d0: 20 20 20 20 20 2f 2a 20 48 6f 77 20 6d 61 6e 79       /* How many
60e0: 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 70 61   pages in the pa
60f0: 67 65 20 63 61 63 68 65 20 2a 2f 0a 20 20 42 74  ge cache */.  Bt
6100: 72 65 65 20 2a 2a 70 70 42 74 72 65 65 20 20 20  ree **ppBtree   
6110: 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74          /* Point
6120: 65 72 20 74 6f 20 6e 65 77 20 42 74 72 65 65 20  er to new Btree 
6130: 6f 62 6a 65 63 74 20 77 72 69 74 74 65 6e 20 68  object written h
6140: 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20  ere */.){.  int 
6150: 62 74 72 65 65 5f 66 6c 61 67 73 20 3d 20 30 3b  btree_flags = 0;
6160: 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 70 70  .  .  assert( pp
6170: 42 74 72 65 65 20 21 3d 20 30 29 3b 0a 20 20 69  Btree != 0);.  i
6180: 66 28 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 20 29  f( omitJournal )
6190: 7b 0a 20 20 20 20 62 74 72 65 65 5f 66 6c 61 67  {.    btree_flag
61a0: 73 20 7c 3d 20 42 54 52 45 45 5f 4f 4d 49 54 5f  s |= BTREE_OMIT_
61b0: 4a 4f 55 52 4e 41 4c 3b 0a 20 20 7d 0a 20 20 69  JOURNAL;.  }.  i
61c0: 66 28 20 21 7a 46 69 6c 65 6e 61 6d 65 20 7c 7c  f( !zFilename ||
61d0: 20 21 73 74 72 63 6d 70 28 7a 46 69 6c 65 6e 61   !strcmp(zFilena
61e0: 6d 65 2c 20 22 3a 6d 65 6d 6f 72 79 3a 22 29 20  me, ":memory:") 
61f0: 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 7a 46 69  ){.    /* If zFi
6200: 6c 65 6e 61 6d 65 20 69 73 20 4e 55 4c 4c 20 6f  lename is NULL o
6210: 72 20 74 68 65 20 6d 61 67 69 63 20 73 74 72 69  r the magic stri
6220: 6e 67 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 68  ng ":memory:" th
6230: 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 6e 65  en the.    ** ne
6240: 77 20 62 74 72 65 65 20 73 74 6f 72 65 73 74 20  w btree storest 
6250: 64 61 74 61 20 69 6e 20 6d 61 69 6e 20 6d 65 6d  data in main mem
6260: 6f 72 79 2c 20 6e 6f 74 20 61 20 66 69 6c 65 2e  ory, not a file.
6270: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 62 74 72 65  .    */.    btre
6280: 65 5f 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45  e_flags |= BTREE
6290: 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a 0a 20 20  _MEMORY;.  }..  
62a0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 74  return sqlite3Bt
62b0: 72 65 65 4f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d  reeOpen(zFilenam
62c0: 65 2c 20 70 70 42 74 72 65 65 2c 20 6e 43 61 63  e, ppBtree, nCac
62d0: 68 65 2c 20 62 74 72 65 65 5f 66 6c 61 67 73 2c  he, btree_flags,
62e0: 0a 20 20 20 20 20 20 28 76 6f 69 64 20 2a 29 26  .      (void *)&
62f0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 29  db->busyHandler)
6300: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
6310: 6e 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20  n UTF-8 encoded 
6320: 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65  English language
6330: 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20   explanation of 
6340: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a  the most recent.
6350: 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e  ** error..*/.con
6360: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33  st char *sqlite3
6370: 5f 65 72 72 6d 73 67 28 73 71 6c 69 74 65 33 20  _errmsg(sqlite3 
6380: 2a 64 62 29 7b 0a 20 20 69 66 28 20 21 64 62 20  *db){.  if( !db 
6390: 7c 7c 20 21 64 62 2d 3e 70 45 72 72 20 29 7b 0a  || !db->pErr ){.
63a0: 20 20 20 20 2f 2a 20 49 66 20 64 62 20 69 73 20      /* If db is 
63b0: 4e 55 4c 4c 2c 20 74 68 65 6e 20 61 73 73 75 6d  NULL, then assum
63c0: 65 20 74 68 61 74 20 61 20 6d 61 6c 6c 6f 63 28  e that a malloc(
63d0: 29 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20  ) failed during 
63e0: 61 6e 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65  an.    ** sqlite
63f0: 33 5f 6f 70 65 6e 28 29 20 63 61 6c 6c 2e 0a 20  3_open() call.. 
6400: 20 20 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e     */.    return
6410: 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53   sqlite3ErrStr(S
6420: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 20  QLITE_NOMEM);.  
6430: 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 67 69  }.  if( db->magi
6440: 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  c!=SQLITE_MAGIC_
6450: 4f 50 45 4e 20 26 26 20 0a 20 20 20 20 20 20 64  OPEN && .      d
6460: 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45  b->magic!=SQLITE
6470: 5f 4d 41 47 49 43 5f 42 55 53 59 20 26 26 0a 20  _MAGIC_BUSY &&. 
6480: 20 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 21 3d       db->magic!=
6490: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f  SQLITE_MAGIC_CLO
64a0: 53 45 44 20 0a 20 20 29 7b 0a 20 20 20 20 72 65  SED .  ){.    re
64b0: 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53  turn sqlite3ErrS
64c0: 74 72 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  tr(SQLITE_MISUSE
64d0: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71  );.  }.  if( !sq
64e0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
64f0: 28 64 62 2d 3e 70 45 72 72 29 20 29 7b 0a 20 20  (db->pErr) ){.  
6500: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
6510: 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43 6f  ErrStr(db->errCo
6520: 64 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  de);.  }.  retur
6530: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
6540: 74 65 78 74 28 64 62 2d 3e 70 45 72 72 29 3b 0a  text(db->pErr);.
6550: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
6560: 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 45  UTF-16 encoded E
6570: 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20  nglish language 
6580: 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74  explanation of t
6590: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a  he most recent.*
65a0: 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73  * error..*/.cons
65b0: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  t void *sqlite3_
65c0: 65 72 72 6d 73 67 31 36 28 73 71 6c 69 74 65 33  errmsg16(sqlite3
65d0: 20 2a 64 62 29 7b 0a 20 20 2f 2a 20 42 65 63 61   *db){.  /* Beca
65e0: 75 73 65 20 61 6c 6c 20 74 68 65 20 63 68 61 72  use all the char
65f0: 61 63 74 65 72 73 20 69 6e 20 74 68 65 20 73 74  acters in the st
6600: 72 69 6e 67 20 61 72 65 20 69 6e 20 74 68 65 20  ring are in the 
6610: 75 6e 69 63 6f 64 65 0a 20 20 2a 2a 20 72 61 6e  unicode.  ** ran
6620: 67 65 20 30 78 30 30 2d 30 78 46 46 2c 20 69 66  ge 0x00-0xFF, if
6630: 20 77 65 20 70 61 64 20 74 68 65 20 62 69 67 2d   we pad the big-
6640: 65 6e 64 69 61 6e 20 73 74 72 69 6e 67 20 77 69  endian string wi
6650: 74 68 20 61 20 0a 20 20 2a 2a 20 7a 65 72 6f 20  th a .  ** zero 
6660: 62 79 74 65 2c 20 77 65 20 63 61 6e 20 6f 62 74  byte, we can obt
6670: 61 69 6e 20 74 68 65 20 6c 69 74 74 6c 65 2d 65  ain the little-e
6680: 6e 64 69 61 6e 20 73 74 72 69 6e 67 20 77 69 74  ndian string wit
6690: 68 0a 20 20 2a 2a 20 26 62 69 67 5f 65 6e 64 69  h.  ** &big_endi
66a0: 61 6e 5b 31 5d 2e 0a 20 20 2a 2f 0a 20 20 73 74  an[1]..  */.  st
66b0: 61 74 69 63 20 63 68 61 72 20 6f 75 74 4f 66 4d  atic char outOfM
66c0: 65 6d 42 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 30  emBe[] = {.    0
66d0: 2c 20 27 6f 27 2c 20 30 2c 20 27 75 27 2c 20 30  , 'o', 0, 'u', 0
66e0: 2c 20 27 74 27 2c 20 30 2c 20 27 20 27 2c 20 0a  , 't', 0, ' ', .
66f0: 20 20 20 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27      0, 'o', 0, '
6700: 66 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20  f', 0, ' ', .   
6710: 20 30 2c 20 27 6d 27 2c 20 30 2c 20 27 65 27 2c   0, 'm', 0, 'e',
6720: 20 30 2c 20 27 6d 27 2c 20 30 2c 20 27 6f 27 2c   0, 'm', 0, 'o',
6730: 20 30 2c 20 27 72 27 2c 20 30 2c 20 27 79 27 2c   0, 'r', 0, 'y',
6740: 20 30 2c 20 30 2c 20 30 0a 20 20 7d 3b 0a 20 20   0, 0, 0.  };.  
6750: 73 74 61 74 69 63 20 63 68 61 72 20 6d 69 73 75  static char misu
6760: 73 65 42 65 20 5b 5d 20 3d 20 7b 0a 20 20 20 20  seBe [] = {.    
6770: 30 2c 20 27 6c 27 2c 20 30 2c 20 27 69 27 2c 20  0, 'l', 0, 'i', 
6780: 30 2c 20 27 62 27 2c 20 30 2c 20 27 72 27 2c 20  0, 'b', 0, 'r', 
6790: 30 2c 20 27 61 27 2c 20 30 2c 20 27 72 27 2c 20  0, 'a', 0, 'r', 
67a0: 30 2c 20 27 79 27 2c 20 30 2c 20 27 20 27 2c 20  0, 'y', 0, ' ', 
67b0: 0a 20 20 20 20 30 2c 20 27 72 27 2c 20 30 2c 20  .    0, 'r', 0, 
67c0: 27 6f 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20  'o', 0, 'u', 0, 
67d0: 27 74 27 2c 20 30 2c 20 27 69 27 2c 20 30 2c 20  't', 0, 'i', 0, 
67e0: 27 6e 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20  'n', 0, 'e', 0, 
67f0: 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 63 27  ' ', .    0, 'c'
6800: 2c 20 30 2c 20 27 61 27 2c 20 30 2c 20 27 6c 27  , 0, 'a', 0, 'l'
6810: 2c 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 65 27  , 0, 'l', 0, 'e'
6820: 2c 20 30 2c 20 27 64 27 2c 20 30 2c 20 27 20 27  , 0, 'd', 0, ' '
6830: 2c 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20 30  , .    0, 'o', 0
6840: 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c 20 30  , 'u', 0, 't', 0
6850: 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27  , ' ', .    0, '
6860: 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30 2c 20 27  o', 0, 'f', 0, '
6870: 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 73 27 2c   ', .    0, 's',
6880: 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 71 27 2c   0, 'e', 0, 'q',
6890: 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 65 27 2c   0, 'u', 0, 'e',
68a0: 20 30 2c 20 27 6e 27 2c 20 30 2c 20 27 63 27 2c   0, 'n', 0, 'c',
68b0: 20 30 2c 20 27 65 27 2c 20 30 2c 20 30 2c 20 30   0, 'e', 0, 0, 0
68c0: 0a 20 20 7d 3b 0a 0a 20 20 69 66 28 20 64 62 20  .  };..  if( db 
68d0: 26 26 20 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20  && db->pErr ){. 
68e0: 20 20 20 69 66 28 20 64 62 2d 3e 6d 61 67 69 63     if( db->magic
68f0: 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f  !=SQLITE_MAGIC_O
6900: 50 45 4e 20 26 26 20 0a 20 20 20 20 20 20 20 20  PEN && .        
6910: 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54  db->magic!=SQLIT
6920: 45 5f 4d 41 47 49 43 5f 42 55 53 59 20 26 26 0a  E_MAGIC_BUSY &&.
6930: 20 20 20 20 20 20 20 20 64 62 2d 3e 6d 61 67 69          db->magi
6940: 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  c!=SQLITE_MAGIC_
6950: 43 4c 4f 53 45 44 20 0a 20 20 20 20 29 7b 0a 20  CLOSED .    ){. 
6960: 20 20 20 20 20 72 65 74 75 72 6e 20 28 76 6f 69       return (voi
6970: 64 20 2a 29 28 26 6d 69 73 75 73 65 42 65 5b 53  d *)(&misuseBe[S
6980: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56  QLITE_UTF16NATIV
6990: 45 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 4c  E==SQLITE_UTF16L
69a0: 45 3f 31 3a 30 5d 29 3b 0a 20 20 20 20 7d 0a 20  E?1:0]);.    }. 
69b0: 20 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 5f     if( !sqlite3_
69c0: 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d  value_text16(db-
69d0: 3e 70 45 72 72 29 20 29 7b 0a 20 20 20 20 20 20  >pErr) ){.      
69e0: 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53  sqlite3ValueSetS
69f0: 74 72 28 64 62 2d 3e 70 45 72 72 2c 20 2d 31 2c  tr(db->pErr, -1,
6a00: 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 64   sqlite3ErrStr(d
6a10: 62 2d 3e 65 72 72 43 6f 64 65 29 2c 0a 20 20 20  b->errCode),.   
6a20: 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 55 54         SQLITE_UT
6a30: 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49  F8, SQLITE_STATI
6a40: 43 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  C);.    }.    if
6a50: 28 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ( sqlite3_value_
6a60: 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72 29  text16(db->pErr)
6a70: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e   ){.      return
6a80: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
6a90: 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72 29 3b  ext16(db->pErr);
6aa0: 0a 20 20 20 20 7d 0a 20 20 7d 20 20 0a 0a 20 20  .    }.  }  ..  
6ab0: 2f 2a 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c  /* If db is NULL
6ac0: 2c 20 74 68 65 6e 20 61 73 73 75 6d 65 20 74 68  , then assume th
6ad0: 61 74 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61  at a malloc() fa
6ae0: 69 6c 65 64 20 64 75 72 69 6e 67 20 61 6e 0a 20  iled during an. 
6af0: 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e   ** sqlite3_open
6b00: 28 29 20 63 61 6c 6c 2e 20 57 65 20 68 61 76 65  () call. We have
6b10: 20 61 20 73 74 61 74 69 63 20 76 65 72 73 69 6f   a static versio
6b20: 6e 20 6f 66 20 74 68 65 20 73 74 72 69 6e 67 20  n of the string 
6b30: 0a 20 20 2a 2a 20 22 6f 75 74 20 6f 66 20 6d 65  .  ** "out of me
6b40: 6d 6f 72 79 22 20 65 6e 63 6f 64 65 64 20 75 73  mory" encoded us
6b50: 69 6e 67 20 55 54 46 2d 31 36 20 6a 75 73 74 20  ing UTF-16 just 
6b60: 66 6f 72 20 74 68 69 73 20 70 75 72 70 6f 73 65  for this purpose
6b70: 2e 0a 20 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20  ..  */.  return 
6b80: 28 76 6f 69 64 20 2a 29 28 26 6f 75 74 4f 66 4d  (void *)(&outOfM
6b90: 65 6d 42 65 5b 53 51 4c 49 54 45 5f 55 54 46 31  emBe[SQLITE_UTF1
6ba0: 36 4e 41 54 49 56 45 3d 3d 53 51 4c 49 54 45 5f  6NATIVE==SQLITE_
6bb0: 55 54 46 31 36 4c 45 3f 31 3a 30 5d 29 3b 0a 7d  UTF16LE?1:0]);.}
6bc0: 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 72  ..int sqlite3_er
6bd0: 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 2a 64  rcode(sqlite3 *d
6be0: 62 29 7b 0a 20 20 69 66 28 20 21 64 62 20 29 20  b){.  if( !db ) 
6bf0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
6c00: 4d 45 4d 3b 0a 20 20 72 65 74 75 72 6e 20 64 62  MEM;.  return db
6c10: 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a 2f 2a  ->errCode;.}../*
6c20: 0a 2a 2a 20 43 68 65 63 6b 20 73 63 68 65 6d 61  .** Check schema
6c30: 20 63 6f 6f 6b 69 65 73 20 69 6e 20 61 6c 6c 20   cookies in all 
6c40: 64 61 74 61 62 61 73 65 73 20 65 78 63 65 70 74  databases except
6c50: 20 54 45 4d 50 2e 20 20 49 66 20 61 6e 79 20 63   TEMP.  If any c
6c60: 6f 6f 6b 69 65 20 69 73 20 6f 75 74 0a 2a 2a 20  ookie is out.** 
6c70: 6f 66 20 64 61 74 65 2c 20 72 65 74 75 72 6e 20  of date, return 
6c80: 30 2e 20 20 49 66 20 61 6c 6c 20 73 63 68 65 6d  0.  If all schem
6c90: 61 20 63 6f 6f 6b 69 65 73 20 61 72 65 20 63 75  a cookies are cu
6ca0: 72 72 65 6e 74 2c 20 72 65 74 75 72 6e 20 31 2e  rrent, return 1.
6cb0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73  .*/.static int s
6cc0: 63 68 65 6d 61 49 73 56 61 6c 69 64 28 73 71 6c  chemaIsValid(sql
6cd0: 69 74 65 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20  ite *db){.  int 
6ce0: 69 44 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  iDb;.  int rc;. 
6cf0: 20 42 74 43 75 72 73 6f 72 20 2a 63 75 72 54 65   BtCursor *curTe
6d00: 6d 70 3b 0a 20 20 69 6e 74 20 63 6f 6f 6b 69 65  mp;.  int cookie
6d10: 3b 0a 20 20 69 6e 74 20 61 6c 6c 4f 6b 20 3d 20  ;.  int allOk = 
6d20: 31 3b 0a 0a 20 20 66 6f 72 28 69 44 62 3d 30 3b  1;..  for(iDb=0;
6d30: 20 61 6c 6c 4f 6b 20 26 26 20 69 44 62 3c 64 62   allOk && iDb<db
6d40: 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b 29 7b 0a 20  ->nDb; iDb++){. 
6d50: 20 20 20 42 74 72 65 65 20 2a 70 42 74 3b 0a 20     Btree *pBt;. 
6d60: 20 20 20 69 66 28 20 69 44 62 3d 3d 31 20 29 20     if( iDb==1 ) 
6d70: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 70 42  continue;.    pB
6d80: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  t = db->aDb[iDb]
6d90: 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42  .pBt;.    if( pB
6da0: 74 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b  t==0 ) continue;
6db0: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
6dc0: 33 42 74 72 65 65 43 75 72 73 6f 72 28 70 42 74  3BtreeCursor(pBt
6dd0: 2c 20 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20 30  , MASTER_ROOT, 0
6de0: 2c 20 30 2c 20 30 2c 20 26 63 75 72 54 65 6d 70  , 0, 0, &curTemp
6df0: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  );.    if( rc==S
6e00: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
6e10: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74    rc = sqlite3Bt
6e20: 72 65 65 47 65 74 4d 65 74 61 28 70 42 74 2c 20  reeGetMeta(pBt, 
6e30: 31 2c 20 28 75 33 32 20 2a 29 26 63 6f 6f 6b 69  1, (u32 *)&cooki
6e40: 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  e);.      if( rc
6e50: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 63  ==SQLITE_OK && c
6e60: 6f 6f 6b 69 65 21 3d 64 62 2d 3e 61 44 62 5b 69  ookie!=db->aDb[i
6e70: 44 62 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69  Db].schema_cooki
6e80: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 61 6c 6c  e ){.        all
6e90: 4f 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a  Ok = 0;.      }.
6ea0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72        sqlite3Btr
6eb0: 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75  eeCloseCursor(cu
6ec0: 72 54 65 6d 70 29 3b 0a 20 20 20 20 7d 0a 20 20  rTemp);.    }.  
6ed0: 7d 0a 20 20 72 65 74 75 72 6e 20 61 6c 6c 4f 6b  }.  return allOk
6ee0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 69  ;.}../*.** Compi
6ef0: 6c 65 20 74 68 65 20 55 54 46 2d 38 20 65 6e 63  le the UTF-8 enc
6f00: 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65  oded SQL stateme
6f10: 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20 61 20 73  nt zSql into a s
6f20: 74 61 74 65 6d 65 6e 74 20 68 61 6e 64 6c 65 2e  tatement handle.
6f30: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
6f40: 70 72 65 70 61 72 65 28 0a 20 20 73 71 6c 69 74  prepare(.  sqlit
6f50: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
6f60: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
6f70: 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f   handle. */.  co
6f80: 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20  nst char *zSql, 
6f90: 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38          /* UTF-8
6fa0: 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61   encoded SQL sta
6fb0: 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74  tement. */.  int
6fc0: 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20   nBytes,        
6fd0: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68         /* Length
6fe0: 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65   of zSql in byte
6ff0: 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  s. */.  sqlite3_
7000: 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20  stmt **ppStmt,  
7010: 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e    /* OUT: A poin
7020: 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61  ter to the prepa
7030: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f  red statement */
7040: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 2a 2a 20  .  const char** 
7050: 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20  pzTail       /* 
7060: 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73  OUT: End of pars
7070: 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a  ed string */.){.
7080: 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a    Parse sParse;.
7090: 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 20    char *zErrMsg 
70a0: 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  = 0;.  int rc = 
70b0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73  SQLITE_OK;..  as
70c0: 73 65 72 74 28 20 70 70 53 74 6d 74 20 29 3b 0a  sert( ppStmt );.
70d0: 20 20 2a 70 70 53 74 6d 74 20 3d 20 30 3b 0a 20    *ppStmt = 0;. 
70e0: 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65   if( sqlite3Safe
70f0: 74 79 4f 6e 28 64 62 29 20 29 7b 0a 20 20 20 20  tyOn(db) ){.    
7100: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
7110: 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 6d 65 6d  SUSE;.  }..  mem
7120: 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c 20  set(&sParse, 0, 
7130: 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29 29 3b  sizeof(sParse));
7140: 0a 20 20 73 50 61 72 73 65 2e 64 62 20 3d 20 64  .  sParse.db = d
7150: 62 3b 0a 20 20 73 71 6c 69 74 65 33 52 75 6e 50  b;.  sqlite3RunP
7160: 61 72 73 65 72 28 26 73 50 61 72 73 65 2c 20 7a  arser(&sParse, z
7170: 53 71 6c 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a  Sql, &zErrMsg);.
7180: 0a 20 20 69 66 28 20 64 62 2d 3e 78 54 72 61 63  .  if( db->xTrac
7190: 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 74 2e 62  e && !db->init.b
71a0: 75 73 79 20 29 7b 0a 20 20 20 20 2f 2a 20 54 72  usy ){.    /* Tr
71b0: 61 63 65 20 6f 6e 6c 79 20 74 68 65 20 73 74 61  ace only the sta
71c0: 74 6d 65 6e 74 20 74 68 61 74 20 77 61 73 20 63  tment that was c
71d0: 6f 6d 70 69 6c 65 64 2e 0a 20 20 20 20 2a 2a 20  ompiled..    ** 
71e0: 4d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 20 74  Make a copy of t
71f0: 68 61 74 20 70 61 72 74 20 6f 66 20 74 68 65 20  hat part of the 
7200: 53 51 4c 20 73 74 72 69 6e 67 20 73 69 6e 63 65  SQL string since
7210: 20 7a 53 51 4c 20 69 73 20 63 6f 6e 73 74 0a 20   zSQL is const. 
7220: 20 20 20 2a 2a 20 61 6e 64 20 77 65 20 6d 75 73     ** and we mus
7230: 74 20 70 61 73 73 20 61 20 7a 65 72 6f 20 74 65  t pass a zero te
7240: 72 6d 69 6e 61 74 65 64 20 73 74 72 69 6e 67 20  rminated string 
7250: 74 6f 20 74 68 65 20 74 72 61 63 65 20 66 75 6e  to the trace fun
7260: 63 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 54 68 65  ction.    ** The
7270: 20 63 6f 70 79 20 69 73 20 75 6e 6e 65 63 65 73   copy is unneces
7280: 73 61 72 79 20 69 66 20 74 68 65 20 74 61 69 6c  sary if the tail
7290: 20 70 6f 69 6e 74 65 72 20 69 73 20 70 6f 69 6e   pointer is poin
72a0: 74 69 6e 67 20 61 74 20 74 68 65 0a 20 20 20 20  ting at the.    
72b0: 2a 2a 20 62 65 67 69 6e 6e 69 67 20 6f 72 20 65  ** beginnig or e
72c0: 6e 64 20 6f 66 20 74 68 65 20 53 51 4c 20 73 74  nd of the SQL st
72d0: 72 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  ring..    */.   
72e0: 20 69 66 28 20 73 50 61 72 73 65 2e 7a 54 61 69   if( sParse.zTai
72f0: 6c 20 26 26 20 73 50 61 72 73 65 2e 7a 54 61 69  l && sParse.zTai
7300: 6c 21 3d 7a 53 71 6c 20 26 26 20 2a 73 50 61 72  l!=zSql && *sPar
7310: 73 65 2e 7a 54 61 69 6c 20 29 7b 0a 20 20 20 20  se.zTail ){.    
7320: 20 20 63 68 61 72 20 2a 74 6d 70 53 71 6c 20 3d    char *tmpSql =
7330: 20 73 71 6c 69 74 65 53 74 72 4e 44 75 70 28 7a   sqliteStrNDup(z
7340: 53 71 6c 2c 20 73 50 61 72 73 65 2e 7a 54 61 69  Sql, sParse.zTai
7350: 6c 20 2d 20 7a 53 71 6c 29 3b 0a 20 20 20 20 20  l - zSql);.     
7360: 20 69 66 28 20 74 6d 70 53 71 6c 20 29 7b 0a 20   if( tmpSql ){. 
7370: 20 20 20 20 20 20 20 64 62 2d 3e 78 54 72 61 63         db->xTrac
7380: 65 28 64 62 2d 3e 70 54 72 61 63 65 41 72 67 2c  e(db->pTraceArg,
7390: 20 74 6d 70 53 71 6c 29 3b 0a 20 20 20 20 20 20   tmpSql);.      
73a0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 74 6d 70    sqliteFree(tmp
73b0: 53 71 6c 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73  Sql);.      }els
73c0: 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66  e{.        /* If
73d0: 20 61 20 6d 65 6d 6f 72 79 20 65 72 72 6f 72 20   a memory error 
73e0: 6f 63 63 75 72 72 65 64 20 64 75 72 69 6e 67 20  occurred during 
73f0: 74 68 65 20 63 6f 70 79 2c 0a 20 20 20 20 20 20  the copy,.      
7400: 20 20 2a 2a 20 74 72 61 63 65 20 65 6e 74 69 72    ** trace entir
7410: 65 20 53 51 4c 20 73 74 72 69 6e 67 20 61 6e 64  e SQL string and
7420: 20 66 61 6c 6c 20 74 68 72 6f 75 67 68 20 74 6f   fall through to
7430: 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20   the.        ** 
7440: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
7450: 61 69 6c 65 64 20 74 65 73 74 20 74 6f 20 72 65  ailed test to re
7460: 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72 2e 0a  port the error..
7470: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20          */.     
7480: 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28 64 62     db->xTrace(db
7490: 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 7a 53 71  ->pTraceArg, zSq
74a0: 6c 29 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20  l); .      }.   
74b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 64 62   }else{.      db
74c0: 2d 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54 72  ->xTrace(db->pTr
74d0: 61 63 65 41 72 67 2c 20 7a 53 71 6c 29 3b 20 0a  aceArg, zSql); .
74e0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
74f0: 50 72 69 6e 74 20 61 20 63 6f 70 79 20 6f 66 20  Print a copy of 
7500: 53 51 4c 20 61 73 20 69 74 20 69 73 20 65 78 65  SQL as it is exe
7510: 63 75 74 65 64 20 69 66 20 74 68 65 20 53 51 4c  cuted if the SQL
7520: 5f 54 52 41 43 45 20 70 72 61 67 6d 61 20 69 73  _TRACE pragma is
7530: 20 74 75 72 6e 65 64 0a 20 20 2a 2a 20 6f 6e 20   turned.  ** on 
7540: 69 6e 20 64 65 62 75 67 67 69 6e 67 20 6d 6f 64  in debugging mod
7550: 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53  e..  */.#ifdef S
7560: 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 69 66  QLITE_DEBUG.  if
7570: 28 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  ( (db->flags & S
7580: 51 4c 49 54 45 5f 53 71 6c 54 72 61 63 65 29 21  QLITE_SqlTrace)!
7590: 3d 30 20 26 26 20 73 50 61 72 73 65 2e 7a 54 61  =0 && sParse.zTa
75a0: 69 6c 20 26 26 20 73 50 61 72 73 65 2e 7a 54 61  il && sParse.zTa
75b0: 69 6c 21 3d 7a 53 71 6c 20 29 7b 0a 20 20 20 20  il!=zSql ){.    
75c0: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e  sqlite3DebugPrin
75d0: 74 66 28 22 53 51 4c 2d 74 72 61 63 65 3a 20 25  tf("SQL-trace: %
75e0: 2e 2a 73 5c 6e 22 2c 20 73 50 61 72 73 65 2e 7a  .*s\n", sParse.z
75f0: 54 61 69 6c 20 2d 20 7a 53 71 6c 2c 20 7a 53 71  Tail - zSql, zSq
7600: 6c 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f  l);.  }.#endif /
7610: 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 2a  * SQLITE_DEBUG *
7620: 2f 0a 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65  /...  if( sqlite
7630: 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20  3_malloc_failed 
7640: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
7650: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 73 71  TE_NOMEM;.    sq
7660: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c  lite3RollbackAll
7670: 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  (db);.    sqlite
7680: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
7690: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 20  hema(db, 0);.   
76a0: 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53   db->flags &= ~S
76b0: 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b 0a 20  QLITE_InTrans;. 
76c0: 20 20 20 67 6f 74 6f 20 70 72 65 70 61 72 65 5f     goto prepare_
76d0: 6f 75 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73  out;.  }.  if( s
76e0: 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49 54 45  Parse.rc==SQLITE
76f0: 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65 2e 72  _DONE ) sParse.r
7700: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
7710: 20 69 66 28 20 73 50 61 72 73 65 2e 63 68 65 63   if( sParse.chec
7720: 6b 53 63 68 65 6d 61 20 26 26 20 21 73 63 68 65  kSchema && !sche
7730: 6d 61 49 73 56 61 6c 69 64 28 64 62 29 20 29 7b  maIsValid(db) ){
7740: 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63 20 3d  .    sParse.rc =
7750: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 3b 0a   SQLITE_SCHEMA;.
7760: 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72 73 65    }.  if( sParse
7770: 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45  .rc==SQLITE_SCHE
7780: 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  MA ){.    sqlite
7790: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
77a0: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 7d  hema(db, 0);.  }
77b0: 0a 20 20 69 66 28 20 70 7a 54 61 69 6c 20 29 20  .  if( pzTail ) 
77c0: 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 72 73 65  *pzTail = sParse
77d0: 2e 7a 54 61 69 6c 3b 0a 20 20 72 63 20 3d 20 73  .zTail;.  rc = s
77e0: 50 61 72 73 65 2e 72 63 3b 0a 0a 20 20 69 66 28  Parse.rc;..  if(
77f0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
7800: 26 20 73 50 61 72 73 65 2e 70 56 64 62 65 20 26  & sParse.pVdbe &
7810: 26 20 73 50 61 72 73 65 2e 65 78 70 6c 61 69 6e  & sParse.explain
7820: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56   ){.    sqlite3V
7830: 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 73 50  dbeSetNumCols(sP
7840: 61 72 73 65 2e 70 56 64 62 65 2c 20 35 29 3b 0a  arse.pVdbe, 5);.
7850: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
7860: 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65  etColName(sParse
7870: 2e 70 56 64 62 65 2c 20 30 2c 20 22 61 64 64 72  .pVdbe, 0, "addr
7880: 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20  ", P3_STATIC);. 
7890: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65     sqlite3VdbeSe
78a0: 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e  tColName(sParse.
78b0: 70 56 64 62 65 2c 20 31 2c 20 22 6f 70 63 6f 64  pVdbe, 1, "opcod
78c0: 65 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a  e", P3_STATIC);.
78d0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
78e0: 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65  etColName(sParse
78f0: 2e 70 56 64 62 65 2c 20 32 2c 20 22 70 31 22 2c  .pVdbe, 2, "p1",
7900: 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20 20 20   P3_STATIC);.   
7910: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43   sqlite3VdbeSetC
7920: 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56  olName(sParse.pV
7930: 64 62 65 2c 20 33 2c 20 22 70 32 22 2c 20 50 33  dbe, 3, "p2", P3
7940: 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 73 71  _STATIC);.    sq
7950: 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e  lite3VdbeSetColN
7960: 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65  ame(sParse.pVdbe
7970: 2c 20 34 2c 20 22 70 33 22 2c 20 50 33 5f 53 54  , 4, "p3", P3_ST
7980: 41 54 49 43 29 3b 0a 20 20 7d 20 0a 0a 70 72 65  ATIC);.  } ..pre
7990: 70 61 72 65 5f 6f 75 74 3a 0a 20 20 69 66 28 20  pare_out:.  if( 
79a0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66  sqlite3SafetyOff
79b0: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 63 20 3d  (db) ){.    rc =
79c0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
79d0: 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51    }.  if( rc==SQ
79e0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a  LITE_OK ){.    *
79f0: 70 70 53 74 6d 74 20 3d 20 28 73 71 6c 69 74 65  ppStmt = (sqlite
7a00: 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70  3_stmt*)sParse.p
7a10: 56 64 62 65 3b 0a 20 20 7d 65 6c 73 65 20 69 66  Vdbe;.  }else if
7a20: 28 20 73 50 61 72 73 65 2e 70 56 64 62 65 20 29  ( sParse.pVdbe )
7a30: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69  {.    sqlite3_fi
7a40: 6e 61 6c 69 7a 65 28 28 73 71 6c 69 74 65 33 5f  nalize((sqlite3_
7a50: 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70 56 64  stmt*)sParse.pVd
7a60: 62 65 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  be);.  }..  if( 
7a70: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 73  zErrMsg ){.    s
7a80: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
7a90: 72 63 2c 20 22 25 73 22 2c 20 7a 45 72 72 4d 73  rc, "%s", zErrMs
7aa0: 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72  g);.    sqliteFr
7ab0: 65 65 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d  ee(zErrMsg);.  }
7ac0: 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65  else{.    sqlite
7ad0: 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 30  3Error(db, rc, 0
7ae0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
7af0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d  rc;.}../*.** Com
7b00: 70 69 6c 65 20 74 68 65 20 55 54 46 2d 31 36 20  pile the UTF-16 
7b10: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
7b20: 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20  ement zSql into 
7b30: 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64  a statement hand
7b40: 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  le..*/.int sqlit
7b50: 65 33 5f 70 72 65 70 61 72 65 31 36 28 0a 20 20  e3_prepare16(.  
7b60: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
7b70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
7b80: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f  abase handle. */
7b90: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
7ba0: 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a  zSql,         /*
7bb0: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53   UTF-8 encoded S
7bc0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f  QL statement. */
7bd0: 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20  .  int nBytes,  
7be0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7bf0: 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69  Length of zSql i
7c00: 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71  n bytes. */.  sq
7c10: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53  lite3_stmt **ppS
7c20: 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20  tmt,    /* OUT: 
7c30: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  A pointer to the
7c40: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
7c50: 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76  ent */.  const v
7c60: 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20  oid **pzTail    
7c70: 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f     /* OUT: End o
7c80: 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20  f parsed string 
7c90: 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 54 68 69 73 20  */.){.  /* This 
7ca0: 66 75 6e 63 74 69 6f 6e 20 63 75 72 72 65 6e 74  function current
7cb0: 6c 79 20 77 6f 72 6b 73 20 62 79 20 66 69 72 73  ly works by firs
7cc0: 74 20 74 72 61 6e 73 66 6f 72 6d 69 6e 67 20 74  t transforming t
7cd0: 68 65 20 55 54 46 2d 31 36 0a 20 20 2a 2a 20 65  he UTF-16.  ** e
7ce0: 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 20 74 6f  ncoded string to
7cf0: 20 55 54 46 2d 38 2c 20 74 68 65 6e 20 69 6e 76   UTF-8, then inv
7d00: 6f 6b 69 6e 67 20 73 71 6c 69 74 65 33 5f 70 72  oking sqlite3_pr
7d10: 65 70 61 72 65 28 29 2e 20 54 68 65 0a 20 20 2a  epare(). The.  *
7d20: 2a 20 74 72 69 63 6b 79 20 62 69 74 20 69 73 20  * tricky bit is 
7d30: 66 69 67 75 72 69 6e 67 20 6f 75 74 20 74 68 65  figuring out the
7d40: 20 70 6f 69 6e 74 65 72 20 74 6f 20 72 65 74 75   pointer to retu
7d50: 72 6e 20 69 6e 20 2a 70 7a 54 61 69 6c 2e 0a 20  rn in *pzTail.. 
7d60: 20 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 74   */.  char const
7d70: 20 2a 7a 53 71 6c 38 20 3d 20 30 3b 0a 20 20 63   *zSql8 = 0;.  c
7d80: 68 61 72 20 63 6f 6e 73 74 20 2a 7a 54 61 69 6c  har const *zTail
7d90: 38 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b  8 = 0;.  int rc;
7da0: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  .  sqlite3_value
7db0: 20 2a 70 54 6d 70 3b 0a 0a 20 20 70 54 6d 70 20   *pTmp;..  pTmp 
7dc0: 3d 20 73 71 6c 69 74 65 33 47 65 74 54 72 61 6e  = sqlite3GetTran
7dd0: 73 69 65 6e 74 56 61 6c 75 65 28 64 62 29 3b 0a  sientValue(db);.
7de0: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65    sqlite3ValueSe
7df0: 74 53 74 72 28 70 54 6d 70 2c 20 2d 31 2c 20 7a  tStr(pTmp, -1, z
7e00: 53 71 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  Sql, SQLITE_UTF1
7e10: 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 54 45 5f  6NATIVE, SQLITE_
7e20: 53 54 41 54 49 43 29 3b 0a 20 20 7a 53 71 6c 38  STATIC);.  zSql8
7e30: 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54   = sqlite3ValueT
7e40: 65 78 74 28 70 54 6d 70 2c 20 53 51 4c 49 54 45  ext(pTmp, SQLITE
7e50: 5f 55 54 46 38 29 3b 0a 20 20 69 66 28 20 21 7a  _UTF8);.  if( !z
7e60: 53 71 6c 38 20 29 7b 0a 20 20 20 20 73 71 6c 69  Sql8 ){.    sqli
7e70: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c  te3Error(db, SQL
7e80: 49 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b 0a 20  ITE_NOMEM, 0);. 
7e90: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
7ea0: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 63  _NOMEM;.  }.  rc
7eb0: 20 3d 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61   = sqlite3_prepa
7ec0: 72 65 28 64 62 2c 20 7a 53 71 6c 38 2c 20 2d 31  re(db, zSql8, -1
7ed0: 2c 20 70 70 53 74 6d 74 2c 20 26 7a 54 61 69 6c  , ppStmt, &zTail
7ee0: 38 29 3b 0a 0a 20 20 69 66 28 20 7a 54 61 69 6c  8);..  if( zTail
7ef0: 38 20 26 26 20 70 7a 54 61 69 6c 20 29 7b 0a 20  8 && pzTail ){. 
7f00: 20 20 20 2f 2a 20 49 66 20 73 71 6c 69 74 65 33     /* If sqlite3
7f10: 5f 70 72 65 70 61 72 65 20 72 65 74 75 72 6e 73  _prepare returns
7f20: 20 61 20 74 61 69 6c 20 70 6f 69 6e 74 65 72 2c   a tail pointer,
7f30: 20 77 65 20 63 61 6c 63 75 6c 61 74 65 20 74 68   we calculate th
7f40: 65 0a 20 20 20 20 2a 2a 20 65 71 75 69 76 61 6c  e.    ** equival
7f50: 65 6e 74 20 70 6f 69 6e 74 65 72 20 69 6e 74 6f  ent pointer into
7f60: 20 74 68 65 20 55 54 46 2d 31 36 20 73 74 72 69   the UTF-16 stri
7f70: 6e 67 20 62 79 20 63 6f 75 6e 74 69 6e 67 20 74  ng by counting t
7f80: 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 20 20 2a  he unicode.    *
7f90: 2a 20 63 68 61 72 61 63 74 65 72 73 20 62 65 74  * characters bet
7fa0: 77 65 65 6e 20 7a 53 71 6c 38 20 61 6e 64 20 7a  ween zSql8 and z
7fb0: 54 61 69 6c 38 2c 20 61 6e 64 20 74 68 65 6e 20  Tail8, and then 
7fc0: 72 65 74 75 72 6e 69 6e 67 20 61 20 70 6f 69 6e  returning a poin
7fd0: 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 65 20 73  ter.    ** the s
7fe0: 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68  ame number of ch
7ff0: 61 72 61 63 74 65 72 73 20 69 6e 74 6f 20 74 68  aracters into th
8000: 65 20 55 54 46 2d 31 36 20 73 74 72 69 6e 67 2e  e UTF-16 string.
8010: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20  .    */.    int 
8020: 63 68 61 72 73 5f 70 61 72 73 65 64 20 3d 20 73  chars_parsed = s
8030: 71 6c 69 74 65 33 75 74 66 38 43 68 61 72 4c 65  qlite3utf8CharLe
8040: 6e 28 7a 53 71 6c 38 2c 20 7a 54 61 69 6c 38 2d  n(zSql8, zTail8-
8050: 7a 53 71 6c 38 29 3b 0a 20 20 20 20 2a 70 7a 54  zSql8);.    *pzT
8060: 61 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53 71 6c  ail = (u8 *)zSql
8070: 20 2b 20 73 71 6c 69 74 65 33 75 74 66 31 36 42   + sqlite3utf16B
8080: 79 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63 68 61  yteLen(zSql, cha
8090: 72 73 5f 70 61 72 73 65 64 29 3b 0a 20 20 7d 0a  rs_parsed);.  }.
80a0: 20 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d   .  return rc;.}
80b0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
80c0: 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 77 6f  tine does the wo
80d0: 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20 61 20  rk of opening a 
80e0: 64 61 74 61 62 61 73 65 20 6f 6e 20 62 65 68 61  database on beha
80f0: 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 65 33  lf of.** sqlite3
8100: 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 71 6c 69  _open() and sqli
8110: 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20 54 68  te3_open16(). Th
8120: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 6e  e database filen
8130: 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65 22 20  ame "zFilename" 
8140: 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20 65 6e   .** is UTF-8 en
8150: 63 6f 64 65 64 2e 20 54 68 65 20 66 6f 75 72 74  coded. The fourt
8160: 68 20 61 72 67 75 6d 65 6e 74 2c 20 22 64 65 66  h argument, "def
8170: 5f 65 6e 63 22 20 69 73 20 6f 6e 65 20 6f 66 20  _enc" is one of 
8180: 74 68 65 20 54 45 58 54 5f 2a 0a 2a 2a 20 6d 61  the TEXT_*.** ma
8190: 63 72 6f 73 20 66 72 6f 6d 20 73 71 6c 69 74 65  cros from sqlite
81a0: 49 6e 74 2e 68 2e 20 49 66 20 77 65 20 65 6e 64  Int.h. If we end
81b0: 20 75 70 20 63 72 65 61 74 69 6e 67 20 61 20 6e   up creating a n
81c0: 65 77 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ew database file
81d0: 0a 2a 2a 20 28 6e 6f 74 20 6f 70 65 6e 69 6e 67  .** (not opening
81e0: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6f 6e 65   an existing one
81f0: 29 2c 20 74 68 65 20 74 65 78 74 20 65 6e 63 6f  ), the text enco
8200: 64 69 6e 67 20 6f 66 20 74 68 65 20 64 61 74 61  ding of the data
8210: 62 61 73 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 20  base.** will be 
8220: 73 65 74 20 74 6f 20 74 68 69 73 20 76 61 6c 75  set to this valu
8230: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
8240: 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 0a 20   openDatabase(. 
8250: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69   const char *zFi
8260: 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74 61 62  lename, /* Datab
8270: 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55 54 46  ase filename UTF
8280: 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20  -8 encoded */.  
8290: 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 20  sqlite3 **ppDb  
82a0: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52         /* OUT: R
82b0: 65 74 75 72 6e 65 64 20 64 61 74 61 62 61 73 65  eturned database
82c0: 20 68 61 6e 64 6c 65 20 2a 2f 0a 29 7b 0a 20 20   handle */.){.  
82d0: 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 69  sqlite3 *db;.  i
82e0: 6e 74 20 72 63 2c 20 69 3b 0a 20 20 63 68 61 72  nt rc, i;.  char
82f0: 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 0a   *zErrMsg = 0;..
8300: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68    /* Allocate th
8310: 65 20 73 71 6c 69 74 65 20 64 61 74 61 20 73 74  e sqlite data st
8320: 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 64 62 20  ructure */.  db 
8330: 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20  = sqliteMalloc( 
8340: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 29 20 29  sizeof(sqlite) )
8350: 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 20  ;.  if( db==0 ) 
8360: 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b  goto opendb_out;
8370: 0a 20 20 64 62 2d 3e 70 72 69 6f 72 4e 65 77 52  .  db->priorNewR
8380: 6f 77 69 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e  owid = 0;.  db->
8390: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d  magic = SQLITE_M
83a0: 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64 62 2d  AGIC_BUSY;.  db-
83b0: 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d 3e  >nDb = 2;.  db->
83c0: 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 74 61  aDb = db->aDbSta
83d0: 74 69 63 3b 0a 20 20 64 62 2d 3e 65 6e 63 20 3d  tic;.  db->enc =
83e0: 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20   SQLITE_UTF8;.  
83f0: 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d  db->autoCommit =
8400: 20 31 3b 0a 20 20 2f 2a 20 64 62 2d 3e 66 6c 61   1;.  /* db->fla
8410: 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 53 68 6f  gs |= SQLITE_Sho
8420: 72 74 43 6f 6c 4e 61 6d 65 73 3b 20 2a 2f 0a 20  rtColNames; */. 
8430: 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74   sqlite3HashInit
8440: 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 53 51 4c  (&db->aFunc, SQL
8450: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
8460: 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 48 61   0);.  sqlite3Ha
8470: 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 43 6f 6c  shInit(&db->aCol
8480: 6c 53 65 71 2c 20 53 51 4c 49 54 45 5f 48 41 53  lSeq, SQLITE_HAS
8490: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20  H_STRING, 0);.  
84a0: 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e  for(i=0; i<db->n
84b0: 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71  Db; i++){.    sq
84c0: 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 64  lite3HashInit(&d
84d0: 62 2d 3e 61 44 62 5b 69 5d 2e 74 62 6c 48 61 73  b->aDb[i].tblHas
84e0: 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53  h, SQLITE_HASH_S
84f0: 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 20 20 73  TRING, 0);.    s
8500: 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26  qlite3HashInit(&
8510: 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 64 78 48 61  db->aDb[i].idxHa
8520: 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f  sh, SQLITE_HASH_
8530: 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 20 20  STRING, 0);.    
8540: 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28  sqlite3HashInit(
8550: 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 74 72 69 67  &db->aDb[i].trig
8560: 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53  Hash, SQLITE_HAS
8570: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20  H_STRING, 0);.  
8580: 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69    sqlite3HashIni
8590: 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 61 46  t(&db->aDb[i].aF
85a0: 4b 65 79 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  Key, SQLITE_HASH
85b0: 5f 53 54 52 49 4e 47 2c 20 31 29 3b 0a 20 20 7d  _STRING, 1);.  }
85c0: 0a 20 20 0a 20 20 2f 2a 20 41 64 64 20 74 68 65  .  .  /* Add the
85d0: 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69   default collati
85e0: 6f 6e 20 73 65 71 75 65 6e 63 65 20 42 49 4e 41  on sequence BINA
85f0: 52 59 2e 20 42 49 4e 41 52 59 20 77 6f 72 6b 73  RY. BINARY works
8600: 20 66 6f 72 20 62 6f 74 68 20 55 54 46 2d 38 0a   for both UTF-8.
8610: 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d 31 36 2c    ** and UTF-16,
8620: 20 73 6f 20 61 64 64 20 61 20 76 65 72 73 69 6f   so add a versio
8630: 6e 20 66 6f 72 20 65 61 63 68 20 74 6f 20 61 76  n for each to av
8640: 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63 65 73 73  oid any unnecess
8650: 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 65 72 73  ary.  ** convers
8660: 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c 79 20 65  ions. The only e
8670: 72 72 6f 72 20 74 68 61 74 20 63 61 6e 20 6f 63  rror that can oc
8680: 63 75 72 20 68 65 72 65 20 69 73 20 61 20 6d 61  cur here is a ma
8690: 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2e 0a  lloc() failure..
86a0: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 63    */.  sqlite3_c
86b0: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
86c0: 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51  db, "BINARY", SQ
86d0: 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 62 69 6e  LITE_UTF8, 0,bin
86e0: 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63  aryCollatingFunc
86f0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 72 65  );.  sqlite3_cre
8700: 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62  ate_collation(db
8710: 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49  , "BINARY", SQLI
8720: 54 45 5f 55 54 46 31 36 4c 45 2c 20 30 2c 62 69  TE_UTF16LE, 0,bi
8730: 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75 6e  naryCollatingFun
8740: 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 72  c);.  sqlite3_cr
8750: 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64  eate_collation(d
8760: 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c  b, "BINARY", SQL
8770: 49 54 45 5f 55 54 46 31 36 42 45 2c 20 30 2c 62  ITE_UTF16BE, 0,b
8780: 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75  inaryCollatingFu
8790: 6e 63 29 3b 0a 20 20 64 62 2d 3e 70 44 66 6c 74  nc);.  db->pDflt
87a0: 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69  Coll = sqlite3Fi
87b0: 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 64 62  ndCollSeq(db, db
87c0: 2d 3e 65 6e 63 2c 20 22 42 49 4e 41 52 59 22 2c  ->enc, "BINARY",
87d0: 20 36 2c 20 30 29 3b 0a 20 20 69 66 28 20 21 64   6, 0);.  if( !d
87e0: 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 29 7b 0a  b->pDfltColl ){.
87f0: 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 65 72 72      rc = db->err
8800: 43 6f 64 65 3b 0a 20 20 20 20 61 73 73 65 72 74  Code;.    assert
8810: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
8820: 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63  );.    db->magic
8830: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f   = SQLITE_MAGIC_
8840: 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f 74 6f  CLOSED;.    goto
8850: 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d   opendb_out;.  }
8860: 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64 20  ..  /* Also add 
8870: 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69 6e 73  a UTF-8 case-ins
8880: 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 74 69  ensitive collati
8890: 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f 0a  on sequence. */.
88a0: 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65    sqlite3_create
88b0: 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22  _collation(db, "
88c0: 4e 4f 43 41 53 45 22 2c 20 53 51 4c 49 54 45 5f  NOCASE", SQLITE_
88d0: 55 54 46 38 2c 20 30 2c 20 6e 6f 63 61 73 65 43  UTF8, 0, nocaseC
88e0: 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 29 3b 0a 0a  ollatingFunc);..
88f0: 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 61    /* Open the ba
8900: 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20 64  ckend database d
8910: 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 20 3d 20  river */.  rc = 
8920: 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74  sqlite3BtreeFact
8930: 6f 72 79 28 64 62 2c 20 7a 46 69 6c 65 6e 61 6d  ory(db, zFilenam
8940: 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47 45 53 2c  e, 0, MAX_PAGES,
8950: 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74   &db->aDb[0].pBt
8960: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c  );.  if( rc!=SQL
8970: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71  ITE_OK ){.    sq
8980: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72  lite3Error(db, r
8990: 63 2c 20 30 29 3b 0a 20 20 20 20 64 62 2d 3e 6d  c, 0);.    db->m
89a0: 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41  agic = SQLITE_MA
89b0: 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 20 20  GIC_CLOSED;.    
89c0: 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b  goto opendb_out;
89d0: 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 30  .  }.  db->aDb[0
89e0: 5d 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 22  ].zName = "main"
89f0: 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a  ;.  db->aDb[1].z
8a00: 4e 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a 0a  Name = "temp";..
8a10: 20 20 2f 2a 20 54 68 65 20 64 65 66 61 75 6c 74    /* The default
8a20: 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 66 6f   safety_level fo
8a30: 72 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62  r the main datab
8a40: 61 73 65 20 69 73 20 27 66 75 6c 6c 27 20 66 6f  ase is 'full' fo
8a50: 72 20 74 68 65 20 74 65 6d 70 0a 20 20 2a 2a 20  r the temp.  ** 
8a60: 64 61 74 61 62 61 73 65 20 69 74 20 69 73 20 27  database it is '
8a70: 4e 4f 4e 45 27 2e 20 54 68 69 73 20 6d 61 74 63  NONE'. This matc
8a80: 68 65 73 20 74 68 65 20 70 61 67 65 72 20 6c 61  hes the pager la
8a90: 79 65 72 20 64 65 66 61 75 6c 74 73 2e 20 20 2a  yer defaults.  *
8aa0: 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 73  /.  db->aDb[0].s
8ab0: 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 33 3b  afety_level = 3;
8ac0: 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 73 61  .  db->aDb[1].sa
8ad0: 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 31 3b 0a  fety_level = 1;.
8ae0: 0a 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 61  .  /* Register a
8af0: 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63  ll built-in func
8b00: 74 69 6f 6e 73 2c 20 62 75 74 20 64 6f 20 6e 6f  tions, but do no
8b10: 74 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 61  t attempt to rea
8b20: 64 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62  d the.  ** datab
8b30: 61 73 65 20 73 63 68 65 6d 61 20 79 65 74 2e 20  ase schema yet. 
8b40: 54 68 69 73 20 69 73 20 64 65 6c 61 79 65 64 20  This is delayed 
8b50: 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20  until the first 
8b60: 74 69 6d 65 20 74 68 65 20 64 61 74 61 62 61 73  time the databas
8b70: 65 0a 20 20 2a 2a 20 69 73 20 61 63 63 65 73 73  e.  ** is access
8b80: 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74  ed..  */.  sqlit
8b90: 65 33 52 65 67 69 73 74 65 72 42 75 69 6c 74 69  e3RegisterBuilti
8ba0: 6e 46 75 6e 63 74 69 6f 6e 73 28 64 62 29 3b 0a  nFunctions(db);.
8bb0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
8bc0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  _OK ){.    sqlit
8bd0: 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49  e3Error(db, SQLI
8be0: 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20 20 64  TE_OK, 0);.    d
8bf0: 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54  b->magic = SQLIT
8c00: 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20  E_MAGIC_OPEN;.  
8c10: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74  }else{.    sqlit
8c20: 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20  e3Error(db, rc, 
8c30: 22 25 73 22 2c 20 7a 45 72 72 4d 73 67 2c 20 30  "%s", zErrMsg, 0
8c40: 29 3b 0a 20 20 20 20 69 66 28 20 7a 45 72 72 4d  );.    if( zErrM
8c50: 73 67 20 29 20 73 71 6c 69 74 65 46 72 65 65 28  sg ) sqliteFree(
8c60: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 64 62  zErrMsg);.    db
8c70: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
8c80: 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20  _MAGIC_CLOSED;. 
8c90: 20 7d 0a 0a 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a   }..opendb_out:.
8ca0: 20 20 2a 70 70 44 62 20 3d 20 64 62 3b 0a 20 20    *ppDb = db;.  
8cb0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 65  return sqlite3_e
8cc0: 72 72 63 6f 64 65 28 64 62 29 3b 0a 7d 0a 0a 2f  rrcode(db);.}../
8cd0: 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20  *.** Open a new 
8ce0: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e  database handle.
8cf0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
8d00: 6f 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68  open(.  const ch
8d10: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a  ar *zFilename, .
8d20: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62    sqlite3 **ppDb
8d30: 20 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70   .){.  return op
8d40: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65  enDatabase(zFile
8d50: 6e 61 6d 65 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a  name, ppDb);.}..
8d60: 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77  /*.** Open a new
8d70: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
8d80: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
8d90: 5f 6f 70 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74  _open16(.  const
8da0: 20 76 6f 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65   void *zFilename
8db0: 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70  , .  sqlite3 **p
8dc0: 70 44 62 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f  pDb.){.  char co
8dd0: 6e 73 74 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b  nst *zFilename8;
8de0: 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20     /* zFilename 
8df0: 65 6e 63 6f 64 65 64 20 69 6e 20 55 54 46 2d 38  encoded in UTF-8
8e00: 20 69 6e 73 74 65 61 64 20 6f 66 20 55 54 46 2d   instead of UTF-
8e10: 31 36 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d  16 */.  int rc =
8e20: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
8e30: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
8e40: 70 56 61 6c 3b 0a 0a 20 20 61 73 73 65 72 74 28  pVal;..  assert(
8e50: 20 70 70 44 62 20 29 3b 0a 20 20 2a 70 70 44 62   ppDb );.  *ppDb
8e60: 20 3d 20 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73   = 0;.  pVal = s
8e70: 71 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 28 29  qlite3ValueNew()
8e80: 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65  ;.  sqlite3Value
8e90: 53 65 74 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c  SetStr(pVal, -1,
8ea0: 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49   zFilename, SQLI
8eb0: 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20  TE_UTF16NATIVE, 
8ec0: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
8ed0: 20 20 7a 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73    zFilename8 = s
8ee0: 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28  qlite3ValueText(
8ef0: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  pVal, SQLITE_UTF
8f00: 38 29 3b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e  8);.  if( zFilen
8f10: 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 63 20 3d  ame8 ){.    rc =
8f20: 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46   openDatabase(zF
8f30: 69 6c 65 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b  ilename8, ppDb);
8f40: 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  .    if( rc==SQL
8f50: 49 54 45 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20  ITE_OK && *ppDb 
8f60: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
8f70: 5f 65 78 65 63 28 2a 70 70 44 62 2c 20 22 50 52  _exec(*ppDb, "PR
8f80: 41 47 4d 41 20 65 6e 63 6f 64 69 6e 67 20 3d 20  AGMA encoding = 
8f90: 27 55 54 46 2d 31 36 27 22 2c 20 30 2c 20 30 2c  'UTF-16'", 0, 0,
8fa0: 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20   0);.    }.  }. 
8fb0: 20 69 66 28 20 70 56 61 6c 20 29 7b 0a 20 20 20   if( pVal ){.   
8fc0: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65   sqlite3ValueFre
8fd0: 65 28 70 56 61 6c 29 3b 0a 20 20 7d 0a 0a 20 20  e(pVal);.  }..  
8fe0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
8ff0: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
9000: 67 20 72 6f 75 74 69 6e 65 20 64 65 73 74 72 6f  g routine destro
9010: 79 73 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63  ys a virtual mac
9020: 68 69 6e 65 20 74 68 61 74 20 69 73 20 63 72 65  hine that is cre
9030: 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 73  ated by.** the s
9040: 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 28 29  qlite3_compile()
9050: 20 72 6f 75 74 69 6e 65 2e 20 54 68 65 20 69 6e   routine. The in
9060: 74 65 67 65 72 20 72 65 74 75 72 6e 65 64 20 69  teger returned i
9070: 73 20 61 6e 20 53 51 4c 49 54 45 5f 0a 2a 2a 20  s an SQLITE_.** 
9080: 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20  success/failure 
9090: 63 6f 64 65 20 74 68 61 74 20 64 65 73 63 72 69  code that descri
90a0: 62 65 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f  bes the result o
90b0: 66 20 65 78 65 63 75 74 69 6e 67 20 74 68 65 20  f executing the 
90c0: 76 69 72 74 75 61 6c 0a 2a 2a 20 6d 61 63 68 69  virtual.** machi
90d0: 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  ne..**.** This r
90e0: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
90f0: 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73  error code and s
9100: 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62  tring returned b
9110: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72  y.** sqlite3_err
9120: 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f  code(), sqlite3_
9130: 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c  errmsg() and sql
9140: 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e  ite3_errmsg16().
9150: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
9160: 66 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 33  finalize(sqlite3
9170: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
9180: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
9190: 64 62 65 46 69 6e 61 6c 69 7a 65 28 28 56 64 62  dbeFinalize((Vdb
91a0: 65 2a 29 70 53 74 6d 74 29 3b 0a 7d 0a 0a 2f 2a  e*)pStmt);.}../*
91b0: 0a 2a 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68  .** Terminate th
91c0: 65 20 63 75 72 72 65 6e 74 20 65 78 65 63 75 74  e current execut
91d0: 69 6f 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 74  ion of an SQL st
91e0: 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 65  atement and rese
91f0: 74 20 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f 20  t it.** back to 
9200: 69 74 73 20 73 74 61 72 74 69 6e 67 20 73 74 61  its starting sta
9210: 74 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 61  te so that it ca
9220: 6e 20 62 65 20 72 65 75 73 65 64 2e 20 41 20 73  n be reused. A s
9230: 75 63 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d  uccess code from
9240: 0a 2a 2a 20 74 68 65 20 70 72 69 6f 72 20 65 78  .** the prior ex
9250: 65 63 75 74 69 6f 6e 20 69 73 20 72 65 74 75 72  ecution is retur
9260: 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ned..**.** This 
9270: 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65  routine sets the
9280: 20 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20   error code and 
9290: 73 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20  string returned 
92a0: 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72  by.** sqlite3_er
92b0: 72 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33  rcode(), sqlite3
92c0: 5f 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71  _errmsg() and sq
92d0: 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29  lite3_errmsg16()
92e0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
92f0: 5f 72 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73  _reset(sqlite3_s
9300: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69  tmt *pStmt){.  i
9310: 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56  nt rc = sqlite3V
9320: 64 62 65 52 65 73 65 74 28 28 56 64 62 65 2a 29  dbeReset((Vdbe*)
9330: 70 53 74 6d 74 29 3b 0a 20 20 73 71 6c 69 74 65  pStmt);.  sqlite
9340: 33 56 64 62 65 4d 61 6b 65 52 65 61 64 79 28 28  3VdbeMakeReady((
9350: 56 64 62 65 2a 29 70 53 74 6d 74 2c 20 2d 31 2c  Vdbe*)pStmt, -1,
9360: 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63   0);.  return rc
9370: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73  ;.}../*.** Regis
9380: 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74  ter a new collat
9390: 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74  ion sequence wit
93a0: 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68  h the database h
93b0: 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74  andle db..*/.int
93c0: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f   sqlite3_create_
93d0: 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c  collation(.  sql
93e0: 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e  ite3* db, .  con
93f0: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20  st char *zName, 
9400: 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76  .  int enc, .  v
9410: 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74  oid* pCtx,.  int
9420: 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64  (*xCompare)(void
9430: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64  *,int,const void
9440: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64  *,int,const void
9450: 2a 29 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20  *).){.  CollSeq 
9460: 2a 70 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 72 63  *pColl;.  int rc
9470: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
9480: 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f  .  /* If SQLITE_
9490: 55 54 46 31 36 20 69 73 20 73 70 65 63 69 66 69  UTF16 is specifi
94a0: 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69  ed as the encodi
94b0: 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f  ng type, transfo
94c0: 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20  rm this.  ** to 
94d0: 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54  one of SQLITE_UT
94e0: 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f  F16LE or SQLITE_
94f0: 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 68  UTF16BE using th
9500: 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54  e.  ** SQLITE_UT
9510: 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e  F16NATIVE macro.
9520: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73   SQLITE_UTF16 is
9530: 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e   not used intern
9540: 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ally..  */.  if(
9550: 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46   enc==SQLITE_UTF
9560: 31 36 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20  16 ){.    enc = 
9570: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49  SQLITE_UTF16NATI
9580: 56 45 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 65  VE;.  }..  if( e
9590: 6e 63 21 3d 53 51 4c 49 54 45 5f 55 54 46 38 20  nc!=SQLITE_UTF8 
95a0: 26 26 20 65 6e 63 21 3d 53 51 4c 49 54 45 5f 55  && enc!=SQLITE_U
95b0: 54 46 31 36 4c 45 20 26 26 20 65 6e 63 21 3d 53  TF16LE && enc!=S
95c0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 29 7b  QLITE_UTF16BE ){
95d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
95e0: 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 52  r(db, SQLITE_ERR
95f0: 4f 52 2c 20 0a 20 20 20 20 20 20 20 20 22 50 61  OR, .        "Pa
9600: 72 61 6d 20 33 20 74 6f 20 73 71 6c 69 74 65 33  ram 3 to sqlite3
9610: 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f  _create_collatio
9620: 6e 28 29 20 6d 75 73 74 20 62 65 20 6f 6e 65 20  n() must be one 
9630: 6f 66 20 22 0a 20 20 20 20 20 20 20 20 22 53 51  of ".        "SQ
9640: 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54  LITE_UTF8, SQLIT
9650: 45 5f 55 54 46 31 36 2c 20 53 51 4c 49 54 45 5f  E_UTF16, SQLITE_
9660: 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54  UTF16LE or SQLIT
9670: 45 5f 55 54 46 31 36 42 45 22 0a 20 20 20 20 29  E_UTF16BE".    )
9680: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  ;.    return SQL
9690: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20  ITE_ERROR;.  }. 
96a0: 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33   pColl = sqlite3
96b0: 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20  FindCollSeq(db, 
96c0: 28 75 38 29 65 6e 63 2c 20 7a 4e 61 6d 65 2c 20  (u8)enc, zName, 
96d0: 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 31  strlen(zName), 1
96e0: 29 3b 0a 20 20 69 66 28 20 30 3d 3d 70 43 6f 6c  );.  if( 0==pCol
96f0: 6c 20 29 7b 0a 20 20 20 72 63 20 3d 20 53 51 4c  l ){.   rc = SQL
9700: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c  ITE_NOMEM;.  }el
9710: 73 65 7b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 78  se{.    pColl->x
9720: 43 6d 70 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a  Cmp = xCompare;.
9730: 20 20 20 20 70 43 6f 6c 6c 2d 3e 70 55 73 65 72      pColl->pUser
9740: 20 3d 20 70 43 74 78 3b 0a 20 20 20 20 70 43 6f   = pCtx;.    pCo
9750: 6c 6c 2d 3e 65 6e 63 20 3d 20 65 6e 63 3b 0a 20  ll->enc = enc;. 
9760: 20 7d 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f   }.  sqlite3Erro
9770: 72 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20  r(db, rc, 0);.  
9780: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
9790: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 6e  .** Register a n
97a0: 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71  ew collation seq
97b0: 75 65 6e 63 65 20 77 69 74 68 20 74 68 65 20 64  uence with the d
97c0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64  atabase handle d
97d0: 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  b..*/.int sqlite
97e0: 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69  3_create_collati
97f0: 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 65 33 2a  on16(.  sqlite3*
9800: 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68   db, .  const ch
9810: 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e  ar *zName, .  in
9820: 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20  t enc, .  void* 
9830: 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f  pCtx,.  int(*xCo
9840: 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74  mpare)(void*,int
9850: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74  ,const void*,int
9860: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b  ,const void*).){
9870: 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a  .  char const *z
9880: 4e 61 6d 65 38 3b 0a 20 20 73 71 6c 69 74 65 33  Name8;.  sqlite3
9890: 5f 76 61 6c 75 65 20 2a 70 54 6d 70 20 3d 20 73  _value *pTmp = s
98a0: 71 6c 69 74 65 33 47 65 74 54 72 61 6e 73 69 65  qlite3GetTransie
98b0: 6e 74 56 61 6c 75 65 28 64 62 29 3b 0a 20 20 73  ntValue(db);.  s
98c0: 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53 74  qlite3ValueSetSt
98d0: 72 28 70 54 6d 70 2c 20 2d 31 2c 20 7a 4e 61 6d  r(pTmp, -1, zNam
98e0: 65 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e  e, SQLITE_UTF16N
98f0: 41 54 49 56 45 2c 20 53 51 4c 49 54 45 5f 53 54  ATIVE, SQLITE_ST
9900: 41 54 49 43 29 3b 0a 20 20 7a 4e 61 6d 65 38 20  ATIC);.  zName8 
9910: 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65  = sqlite3ValueTe
9920: 78 74 28 70 54 6d 70 2c 20 53 51 4c 49 54 45 5f  xt(pTmp, SQLITE_
9930: 55 54 46 38 29 3b 0a 20 20 72 65 74 75 72 6e 20  UTF8);.  return 
9940: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63  sqlite3_create_c
9950: 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61  ollation(db, zNa
9960: 6d 65 38 2c 20 65 6e 63 2c 20 70 43 74 78 2c 20  me8, enc, pCtx, 
9970: 78 43 6f 6d 70 61 72 65 29 3b 0a 7d 0a 0a 2f 2a  xCompare);.}../*
9980: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63  .** Register a c
9990: 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63  ollation sequenc
99a0: 65 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61  e factory callba
99b0: 63 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 61  ck with the data
99c0: 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64  base handle.** d
99d0: 62 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70  b. Replace any p
99e0: 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c  reviously instal
99f0: 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65  led collation se
9a00: 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a  quence factory..
9a10: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
9a20: 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 28  ollation_needed(
9a30: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  .  sqlite3 *db, 
9a40: 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65  .  void *pCollNe
9a50: 65 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64  ededArg, .  void
9a60: 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76  (*xCollNeeded)(v
9a70: 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e  oid*,sqlite3*,in
9a80: 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74  t eTextRep,const
9a90: 20 63 68 61 72 2a 29 0a 29 7b 0a 20 20 64 62 2d   char*).){.  db-
9aa0: 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 78  >xCollNeeded = x
9ab0: 43 6f 6c 6c 4e 65 65 64 65 64 3b 0a 20 20 64 62  CollNeeded;.  db
9ac0: 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20  ->xCollNeeded16 
9ad0: 3d 20 30 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c  = 0;.  db->pColl
9ae0: 4e 65 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c  NeededArg = pCol
9af0: 6c 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 72 65  lNeededArg;.  re
9b00: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
9b10: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65  }../*.** Registe
9b20: 72 20 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65  r a collation se
9b30: 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 20 63  quence factory c
9b40: 61 6c 6c 62 61 63 6b 20 77 69 74 68 20 74 68 65  allback with the
9b50: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
9b60: 0a 2a 2a 20 64 62 2e 20 52 65 70 6c 61 63 65 20  .** db. Replace 
9b70: 61 6e 79 20 70 72 65 76 69 6f 75 73 6c 79 20 69  any previously i
9b80: 6e 73 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 74 69  nstalled collati
9b90: 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74  on sequence fact
9ba0: 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ory..*/.int sqli
9bb0: 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65  te3_collation_ne
9bc0: 65 64 65 64 31 36 28 0a 20 20 73 71 6c 69 74 65  eded16(.  sqlite
9bd0: 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a  3 *db, .  void *
9be0: 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20  pCollNeededArg, 
9bf0: 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65  .  void(*xCollNe
9c00: 65 64 65 64 31 36 29 28 76 6f 69 64 2a 2c 73 71  eded16)(void*,sq
9c10: 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74  lite3*,int eText
9c20: 52 65 70 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29  Rep,const void*)
9c30: 0a 29 7b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e  .){.  db->xCollN
9c40: 65 65 64 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d  eeded = 0;.  db-
9c50: 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d  >xCollNeeded16 =
9c60: 20 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a   xCollNeeded16;.
9c70: 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65    db->pCollNeede
9c80: 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64  dArg = pCollNeed
9c90: 65 64 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20  edArg;.  return 
9ca0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a           SQLITE_OK;.}.