/ Hex Artifact Content
Login

Artifact 9cb3598be553c6e247e7ad7e9c41a9a0c38c7211:


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 34 20 32 30 30 34 2f 30 36  ,v 1.244 2004/06
0280: 2f 33 30 20 31 31 3a 35 34 3a 30 37 20 64 61 6e  /30 11:54:07 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 53 51 4c 49 54 45 5f 4e   return SQLITE_N
5760: 4f 4d 45 4d 3b 0a 20 20 70 2d 3e 78 46 75 6e 63  OMEM;.  p->xFunc
5770: 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 2d 3e 78   = xFunc;.  p->x
5780: 53 74 65 70 20 3d 20 78 53 74 65 70 3b 0a 20 20  Step = xStep;.  
5790: 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 78  p->xFinalize = x
57a0: 46 69 6e 61 6c 3b 0a 20 20 70 2d 3e 70 55 73 65  Final;.  p->pUse
57b0: 72 44 61 74 61 20 3d 20 70 55 73 65 72 44 61 74  rData = pUserDat
57c0: 61 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  a;.  return SQLI
57d0: 54 45 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 73 71 6c  TE_OK;.}.int sql
57e0: 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63  ite3_create_func
57f0: 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 65  tion16(.  sqlite
5800: 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 76  3 *db,.  const v
5810: 6f 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61  oid *zFunctionNa
5820: 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a  me,.  int nArg,.
5830: 20 20 69 6e 74 20 65 54 65 78 74 52 65 70 2c 0a    int eTextRep,.
5840: 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74    void *pUserDat
5850: 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e  a,.  void (*xFun
5860: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  c)(sqlite3_conte
5870: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f  xt*,int,sqlite3_
5880: 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64  value**),.  void
5890: 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65   (*xStep)(sqlite
58a0: 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73  3_context*,int,s
58b0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c  qlite3_value**),
58c0: 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c  .  void (*xFinal
58d0: 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  )(sqlite3_contex
58e0: 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b  t*).){.  int rc;
58f0: 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a  .  char const *z
5900: 46 75 6e 63 38 3b 0a 0a 20 20 73 71 6c 69 74 65  Func8;..  sqlite
5910: 33 5f 76 61 6c 75 65 20 2a 70 54 6d 70 20 3d 20  3_value *pTmp = 
5920: 73 71 6c 69 74 65 33 47 65 74 54 72 61 6e 73 69  sqlite3GetTransi
5930: 65 6e 74 56 61 6c 75 65 28 64 62 29 3b 0a 20 20  entValue(db);.  
5940: 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53  sqlite3ValueSetS
5950: 74 72 28 70 54 6d 70 2c 20 2d 31 2c 20 7a 46 75  tr(pTmp, -1, zFu
5960: 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 53 51 4c 49  nctionName, SQLI
5970: 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 53  TE_UTF16NATIVE,S
5980: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
5990: 20 7a 46 75 6e 63 38 20 3d 20 73 71 6c 69 74 65   zFunc8 = sqlite
59a0: 33 56 61 6c 75 65 54 65 78 74 28 70 54 6d 70 2c  3ValueText(pTmp,
59b0: 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 0a   SQLITE_UTF8);..
59c0: 20 20 69 66 28 20 21 7a 46 75 6e 63 38 20 29 7b    if( !zFunc8 ){
59d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
59e0: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20  TE_NOMEM;.  }.  
59f0: 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65  rc = sqlite3_cre
5a00: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c  ate_function(db,
5a10: 20 7a 46 75 6e 63 38 2c 20 6e 41 72 67 2c 20 65   zFunc8, nArg, e
5a20: 54 65 78 74 52 65 70 2c 20 0a 20 20 20 20 20 20  TextRep, .      
5a30: 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63  pUserData, xFunc
5a40: 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29  , xStep, xFinal)
5a50: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
5a60: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72  ../*.** Register
5a70: 20 61 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f   a trace functio
5a80: 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 72 6f  n.  The pArg fro
5a90: 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79  m the previously
5aa0: 20 72 65 67 69 73 74 65 72 65 64 20 74 72 61 63   registered trac
5ab0: 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64  e.** is returned
5ac0: 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c  .  .**.** A NULL
5ad0: 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 20   trace function 
5ae0: 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 74 72  means that no tr
5af0: 61 63 69 6e 67 20 69 73 20 65 78 65 63 75 74 65  acing is execute
5b00: 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a  s.  A non-NULL.*
5b10: 2a 20 74 72 61 63 65 20 69 73 20 61 20 70 6f 69  * trace is a poi
5b20: 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69  nter to a functi
5b30: 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b  on that is invok
5b40: 65 64 20 61 74 20 74 68 65 20 73 74 61 72 74 20  ed at the start 
5b50: 6f 66 20 65 61 63 68 0a 2a 2a 20 73 71 6c 69 74  of each.** sqlit
5b60: 65 33 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 76 6f  e3_exec()..*/.vo
5b70: 69 64 20 2a 73 71 6c 69 74 65 33 5f 74 72 61 63  id *sqlite3_trac
5b80: 65 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 76 6f  e(sqlite *db, vo
5b90: 69 64 20 28 2a 78 54 72 61 63 65 29 28 76 6f 69  id (*xTrace)(voi
5ba0: 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 2c  d*,const char*),
5bb0: 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20 20   void *pArg){.  
5bc0: 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62 2d  void *pOld = db-
5bd0: 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20 64 62  >pTraceArg;.  db
5be0: 2d 3e 78 54 72 61 63 65 20 3d 20 78 54 72 61 63  ->xTrace = xTrac
5bf0: 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 65 41  e;.  db->pTraceA
5c00: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 65 74  rg = pArg;.  ret
5c10: 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a 2a  urn pOld;.}../**
5c20: 2a 20 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 2a  * EXPERIMENTAL *
5c30: 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 67 69 73 74 65  **.**.** Registe
5c40: 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20  r a function to 
5c50: 62 65 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e 20  be invoked when 
5c60: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f  a transaction co
5c70: 6d 6d 65 6e 74 73 2e 0a 2a 2a 20 49 66 20 65 69  mments..** If ei
5c80: 74 68 65 72 20 66 75 6e 63 74 69 6f 6e 20 72 65  ther function re
5c90: 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20  turns non-zero, 
5ca0: 74 68 65 6e 20 74 68 65 20 63 6f 6d 6d 69 74 20  then the commit 
5cb0: 62 65 63 6f 6d 65 73 20 61 0a 2a 2a 20 72 6f 6c  becomes a.** rol
5cc0: 6c 62 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 20 2a  lback..*/.void *
5cd0: 73 71 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 5f 68  sqlite3_commit_h
5ce0: 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 20 2a 64  ook(.  sqlite *d
5cf0: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b,              
5d00: 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 20 68   /* Attach the h
5d10: 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61  ook to this data
5d20: 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 28 2a  base */.  int (*
5d30: 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a  xCallback)(void*
5d40: 29 2c 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20  ),  /* Function 
5d50: 74 6f 20 69 6e 76 6f 6b 65 20 6f 6e 20 65 61 63  to invoke on eac
5d60: 68 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 76 6f  h commit */.  vo
5d70: 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 20 20  id *pArg        
5d80: 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d          /* Argum
5d90: 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74  ent to the funct
5da0: 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64  ion */.){.  void
5db0: 20 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 43 6f   *pOld = db->pCo
5dc0: 6d 6d 69 74 41 72 67 3b 0a 20 20 64 62 2d 3e 78  mmitArg;.  db->x
5dd0: 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 20 3d  CommitCallback =
5de0: 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62   xCallback;.  db
5df0: 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 20 3d 20 70  ->pCommitArg = p
5e00: 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f  Arg;.  return pO
5e10: 6c 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68  ld;.}.../*.** Th
5e20: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61  is routine is ca
5e30: 6c 6c 65 64 20 74 6f 20 63 72 65 61 74 65 20 61  lled to create a
5e40: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61   connection to a
5e50: 20 64 61 74 61 62 61 73 65 20 42 54 72 65 65 0a   database BTree.
5e60: 2a 2a 20 64 72 69 76 65 72 2e 20 20 49 66 20 7a  ** driver.  If z
5e70: 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 20  Filename is the 
5e80: 6e 61 6d 65 20 6f 66 20 61 20 66 69 6c 65 2c 20  name of a file, 
5e90: 74 68 65 6e 20 74 68 61 74 20 66 69 6c 65 20 69  then that file i
5ea0: 73 0a 2a 2a 20 6f 70 65 6e 65 64 20 61 6e 64 20  s.** opened and 
5eb0: 75 73 65 64 2e 20 20 49 66 20 7a 46 69 6c 65 6e  used.  If zFilen
5ec0: 61 6d 65 20 69 73 20 74 68 65 20 6d 61 67 69 63  ame is the magic
5ed0: 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22   name ":memory:"
5ee0: 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 64 61 74   then.** the dat
5ef0: 61 62 61 73 65 20 69 73 20 73 74 6f 72 65 64 20  abase is stored 
5f00: 69 6e 20 6d 65 6d 6f 72 79 20 28 61 6e 64 20 69  in memory (and i
5f10: 73 20 74 68 75 73 20 66 6f 72 67 6f 74 74 65 6e  s thus forgotten
5f20: 20 61 73 20 73 6f 6f 6e 20 61 73 0a 2a 2a 20 74   as soon as.** t
5f30: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73  he connection is
5f40: 20 63 6c 6f 73 65 64 2e 29 20 20 49 66 20 7a 46   closed.)  If zF
5f50: 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 4c 4c 20  ilename is NULL 
5f60: 74 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73  then the databas
5f70: 65 0a 2a 2a 20 69 73 20 66 6f 72 20 74 65 6d 70  e.** is for temp
5f80: 6f 72 61 72 79 20 75 73 65 20 6f 6e 6c 79 20 61  orary use only a
5f90: 6e 64 20 69 73 20 64 65 6c 65 74 65 64 20 61 73  nd is deleted as
5fa0: 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 63 6f 6e   soon as the con
5fb0: 6e 65 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 63 6c  nection.** is cl
5fc0: 6f 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  osed..*/.int sql
5fd0: 69 74 65 33 42 74 72 65 65 46 61 63 74 6f 72 79  ite3BtreeFactory
5fe0: 28 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 65  (.  const sqlite
5ff0: 20 2a 64 62 2c 09 20 20 20 20 2f 2a 20 4d 61 69   *db,.    /* Mai
6000: 6e 20 64 61 74 61 62 61 73 65 20 77 68 65 6e 20  n database when 
6010: 6f 70 65 6e 69 6e 67 20 61 75 78 20 6f 74 68 65  opening aux othe
6020: 72 77 69 73 65 20 30 20 2a 2f 0a 20 20 63 6f 6e  rwise 0 */.  con
6030: 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61  st char *zFilena
6040: 6d 65 2c 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f  me,    /* Name o
6050: 66 20 74 68 65 20 66 69 6c 65 20 63 6f 6e 74 61  f the file conta
6060: 69 6e 69 6e 67 20 74 68 65 20 42 54 72 65 65 20  ining the BTree 
6070: 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e  database */.  in
6080: 74 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 2c 20 20  t omitJournal,  
6090: 20 20 20 20 20 20 20 20 2f 2a 20 69 66 20 54 52          /* if TR
60a0: 55 45 20 74 68 65 6e 20 64 6f 20 6e 6f 74 20 6a  UE then do not j
60b0: 6f 75 72 6e 61 6c 20 74 68 69 73 20 66 69 6c 65  ournal this file
60c0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 61 63 68 65   */.  int nCache
60d0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
60e0: 2f 2a 20 48 6f 77 20 6d 61 6e 79 20 70 61 67 65  /* How many page
60f0: 73 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61  s in the page ca
6100: 63 68 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a  che */.  Btree *
6110: 2a 70 70 42 74 72 65 65 20 20 20 20 20 20 20 20  *ppBtree        
6120: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f     /* Pointer to
6130: 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 63   new Btree objec
6140: 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 2a  t written here *
6150: 2f 0a 29 7b 0a 20 20 69 6e 74 20 62 74 72 65 65  /.){.  int btree
6160: 5f 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20 0a 20  _flags = 0;.  . 
6170: 20 61 73 73 65 72 74 28 20 70 70 42 74 72 65 65   assert( ppBtree
6180: 20 21 3d 20 30 29 3b 0a 20 20 69 66 28 20 6f 6d   != 0);.  if( om
6190: 69 74 4a 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20  itJournal ){.   
61a0: 20 62 74 72 65 65 5f 66 6c 61 67 73 20 7c 3d 20   btree_flags |= 
61b0: 42 54 52 45 45 5f 4f 4d 49 54 5f 4a 4f 55 52 4e  BTREE_OMIT_JOURN
61c0: 41 4c 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 7a  AL;.  }.  if( !z
61d0: 46 69 6c 65 6e 61 6d 65 20 7c 7c 20 21 73 74 72  Filename || !str
61e0: 63 6d 70 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 22  cmp(zFilename, "
61f0: 3a 6d 65 6d 6f 72 79 3a 22 29 20 29 7b 0a 20 20  :memory:") ){.  
6200: 20 20 2f 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d    /* If zFilenam
6210: 65 20 69 73 20 4e 55 4c 4c 20 6f 72 20 74 68 65  e is NULL or the
6220: 20 6d 61 67 69 63 20 73 74 72 69 6e 67 20 22 3a   magic string ":
6230: 6d 65 6d 6f 72 79 3a 22 20 74 68 65 6e 20 74 68  memory:" then th
6240: 65 0a 20 20 20 20 2a 2a 20 6e 65 77 20 62 74 72  e.    ** new btr
6250: 65 65 20 73 74 6f 72 65 73 74 20 64 61 74 61 20  ee storest data 
6260: 69 6e 20 6d 61 69 6e 20 6d 65 6d 6f 72 79 2c 20  in main memory, 
6270: 6e 6f 74 20 61 20 66 69 6c 65 2e 0a 20 20 20 20  not a file..    
6280: 2a 2f 0a 20 20 20 20 62 74 72 65 65 5f 66 6c 61  */.    btree_fla
6290: 67 73 20 7c 3d 20 42 54 52 45 45 5f 4d 45 4d 4f  gs |= BTREE_MEMO
62a0: 52 59 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72  RY;.  }..  retur
62b0: 6e 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70  n sqlite3BtreeOp
62c0: 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 70  en(zFilename, pp
62d0: 42 74 72 65 65 2c 20 6e 43 61 63 68 65 2c 20 62  Btree, nCache, b
62e0: 74 72 65 65 5f 66 6c 61 67 73 2c 0a 20 20 20 20  tree_flags,.    
62f0: 20 20 28 76 6f 69 64 20 2a 29 26 64 62 2d 3e 62    (void *)&db->b
6300: 75 73 79 48 61 6e 64 6c 65 72 29 3b 0a 7d 0a 0a  usyHandler);.}..
6310: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46  /*.** Return UTF
6320: 2d 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69  -8 encoded Engli
6330: 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c  sh language expl
6340: 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d  anation of the m
6350: 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72  ost recent.** er
6360: 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68  ror..*/.const ch
6370: 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d  ar *sqlite3_errm
6380: 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  sg(sqlite3 *db){
6390: 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 21 64  .  if( !db || !d
63a0: 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20 2f  b->pErr ){.    /
63b0: 2a 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c  * If db is NULL,
63c0: 20 74 68 65 6e 20 61 73 73 75 6d 65 20 74 68 61   then assume tha
63d0: 74 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69  t a malloc() fai
63e0: 6c 65 64 20 64 75 72 69 6e 67 20 61 6e 0a 20 20  led during an.  
63f0: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65    ** sqlite3_ope
6400: 6e 28 29 20 63 61 6c 6c 2e 0a 20 20 20 20 2a 2f  n() call..    */
6410: 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69  .    return sqli
6420: 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 54 45  te3ErrStr(SQLITE
6430: 5f 4e 4f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 69  _NOMEM);.  }.  i
6440: 66 28 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51  f( db->magic!=SQ
6450: 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 20  LITE_MAGIC_OPEN 
6460: 26 26 20 0a 20 20 20 20 20 20 64 62 2d 3e 6d 61  && .      db->ma
6470: 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49  gic!=SQLITE_MAGI
6480: 43 5f 42 55 53 59 20 26 26 0a 20 20 20 20 20 20  C_BUSY &&.      
6490: 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54  db->magic!=SQLIT
64a0: 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 0a  E_MAGIC_CLOSED .
64b0: 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20    ){.    return 
64c0: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53 51  sqlite3ErrStr(SQ
64d0: 4c 49 54 45 5f 4d 49 53 55 53 45 29 3b 0a 20 20  LITE_MISUSE);.  
64e0: 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33  }.  if( !sqlite3
64f0: 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e  _value_text(db->
6500: 70 45 72 72 29 20 29 7b 0a 20 20 20 20 72 65 74  pErr) ){.    ret
6510: 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 74  urn sqlite3ErrSt
6520: 72 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 3b 0a  r(db->errCode);.
6530: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 73 71 6c    }.  return sql
6540: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28  ite3_value_text(
6550: 64 62 2d 3e 70 45 72 72 29 3b 0a 7d 0a 0a 2f 2a  db->pErr);.}../*
6560: 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 2d 31  .** Return UTF-1
6570: 36 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 73  6 encoded Englis
6580: 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c 61  h language expla
6590: 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f  nation of the mo
65a0: 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 72  st recent.** err
65b0: 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69  or..*/.const voi
65c0: 64 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d 73  d *sqlite3_errms
65d0: 67 31 36 28 73 71 6c 69 74 65 33 20 2a 64 62 29  g16(sqlite3 *db)
65e0: 7b 0a 20 20 2f 2a 20 42 65 63 61 75 73 65 20 61  {.  /* Because a
65f0: 6c 6c 20 74 68 65 20 63 68 61 72 61 63 74 65 72  ll the character
6600: 73 20 69 6e 20 74 68 65 20 73 74 72 69 6e 67 20  s in the string 
6610: 61 72 65 20 69 6e 20 74 68 65 20 75 6e 69 63 6f  are in the unico
6620: 64 65 0a 20 20 2a 2a 20 72 61 6e 67 65 20 30 78  de.  ** range 0x
6630: 30 30 2d 30 78 46 46 2c 20 69 66 20 77 65 20 70  00-0xFF, if we p
6640: 61 64 20 74 68 65 20 62 69 67 2d 65 6e 64 69 61  ad the big-endia
6650: 6e 20 73 74 72 69 6e 67 20 77 69 74 68 20 61 20  n string with a 
6660: 0a 20 20 2a 2a 20 7a 65 72 6f 20 62 79 74 65 2c  .  ** zero byte,
6670: 20 77 65 20 63 61 6e 20 6f 62 74 61 69 6e 20 74   we can obtain t
6680: 68 65 20 6c 69 74 74 6c 65 2d 65 6e 64 69 61 6e  he little-endian
6690: 20 73 74 72 69 6e 67 20 77 69 74 68 0a 20 20 2a   string with.  *
66a0: 2a 20 26 62 69 67 5f 65 6e 64 69 61 6e 5b 31 5d  * &big_endian[1]
66b0: 2e 0a 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20  ..  */.  static 
66c0: 63 68 61 72 20 6f 75 74 4f 66 4d 65 6d 42 65 5b  char outOfMemBe[
66d0: 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6f 27  ] = {.    0, 'o'
66e0: 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27  , 0, 'u', 0, 't'
66f0: 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30  , 0, ' ', .    0
6700: 2c 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30  , 'o', 0, 'f', 0
6710: 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27  , ' ', .    0, '
6720: 6d 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27  m', 0, 'e', 0, '
6730: 6d 27 2c 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27  m', 0, 'o', 0, '
6740: 72 27 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20 30  r', 0, 'y', 0, 0
6750: 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69  , 0.  };.  stati
6760: 63 20 63 68 61 72 20 6d 69 73 75 73 65 42 65 20  c char misuseBe 
6770: 5b 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6c  [] = {.    0, 'l
6780: 27 2c 20 30 2c 20 27 69 27 2c 20 30 2c 20 27 62  ', 0, 'i', 0, 'b
6790: 27 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 27 61  ', 0, 'r', 0, 'a
67a0: 27 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 27 79  ', 0, 'r', 0, 'y
67b0: 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20  ', 0, ' ', .    
67c0: 30 2c 20 27 72 27 2c 20 30 2c 20 27 6f 27 2c 20  0, 'r', 0, 'o', 
67d0: 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c 20  0, 'u', 0, 't', 
67e0: 30 2c 20 27 69 27 2c 20 30 2c 20 27 6e 27 2c 20  0, 'i', 0, 'n', 
67f0: 30 2c 20 27 65 27 2c 20 30 2c 20 27 20 27 2c 20  0, 'e', 0, ' ', 
6800: 0a 20 20 20 20 30 2c 20 27 63 27 2c 20 30 2c 20  .    0, 'c', 0, 
6810: 27 61 27 2c 20 30 2c 20 27 6c 27 2c 20 30 2c 20  'a', 0, 'l', 0, 
6820: 27 6c 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20  'l', 0, 'e', 0, 
6830: 27 64 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20  'd', 0, ' ', .  
6840: 20 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27 75 27    0, 'o', 0, 'u'
6850: 2c 20 30 2c 20 27 74 27 2c 20 30 2c 20 27 20 27  , 0, 't', 0, ' '
6860: 2c 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20 30  , .    0, 'o', 0
6870: 2c 20 27 66 27 2c 20 30 2c 20 27 20 27 2c 20 0a  , 'f', 0, ' ', .
6880: 20 20 20 20 30 2c 20 27 73 27 2c 20 30 2c 20 27      0, 's', 0, '
6890: 65 27 2c 20 30 2c 20 27 71 27 2c 20 30 2c 20 27  e', 0, 'q', 0, '
68a0: 75 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27  u', 0, 'e', 0, '
68b0: 6e 27 2c 20 30 2c 20 27 63 27 2c 20 30 2c 20 27  n', 0, 'c', 0, '
68c0: 65 27 2c 20 30 2c 20 30 2c 20 30 0a 20 20 7d 3b  e', 0, 0, 0.  };
68d0: 0a 0a 20 20 69 66 28 20 64 62 20 26 26 20 64 62  ..  if( db && db
68e0: 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20 69 66  ->pErr ){.    if
68f0: 28 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c  ( db->magic!=SQL
6900: 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 20 26  ITE_MAGIC_OPEN &
6910: 26 20 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 6d  & .        db->m
6920: 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47  agic!=SQLITE_MAG
6930: 49 43 5f 42 55 53 59 20 26 26 0a 20 20 20 20 20  IC_BUSY &&.     
6940: 20 20 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51     db->magic!=SQ
6950: 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45  LITE_MAGIC_CLOSE
6960: 44 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20  D .    ){.      
6970: 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a 29 28  return (void *)(
6980: 26 6d 69 73 75 73 65 42 65 5b 53 51 4c 49 54 45  &misuseBe[SQLITE
6990: 5f 55 54 46 31 36 4e 41 54 49 56 45 3d 3d 53 51  _UTF16NATIVE==SQ
69a0: 4c 49 54 45 5f 55 54 46 31 36 4c 45 3f 31 3a 30  LITE_UTF16LE?1:0
69b0: 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  ]);.    }.    if
69c0: 28 20 21 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  ( !sqlite3_value
69d0: 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72  _text16(db->pErr
69e0: 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ) ){.      sqlit
69f0: 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 64 62  e3ValueSetStr(db
6a00: 2d 3e 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c 69  ->pErr, -1, sqli
6a10: 74 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72  te3ErrStr(db->er
6a20: 72 43 6f 64 65 29 2c 0a 20 20 20 20 20 20 20 20  rCode),.        
6a30: 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53    SQLITE_UTF8, S
6a40: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
6a50: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 73 71 6c     }.    if( sql
6a60: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
6a70: 36 28 64 62 2d 3e 70 45 72 72 29 20 29 7b 0a 20  6(db->pErr) ){. 
6a80: 20 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69       return sqli
6a90: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36  te3_value_text16
6aa0: 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 20 20  (db->pErr);.    
6ab0: 7d 0a 20 20 7d 20 20 0a 0a 20 20 2f 2a 20 49 66  }.  }  ..  /* If
6ac0: 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65   db is NULL, the
6ad0: 6e 20 61 73 73 75 6d 65 20 74 68 61 74 20 61 20  n assume that a 
6ae0: 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20  malloc() failed 
6af0: 64 75 72 69 6e 67 20 61 6e 0a 20 20 2a 2a 20 73  during an.  ** s
6b00: 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 63 61  qlite3_open() ca
6b10: 6c 6c 2e 20 57 65 20 68 61 76 65 20 61 20 73 74  ll. We have a st
6b20: 61 74 69 63 20 76 65 72 73 69 6f 6e 20 6f 66 20  atic version of 
6b30: 74 68 65 20 73 74 72 69 6e 67 20 0a 20 20 2a 2a  the string .  **
6b40: 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22   "out of memory"
6b50: 20 65 6e 63 6f 64 65 64 20 75 73 69 6e 67 20 55   encoded using U
6b60: 54 46 2d 31 36 20 6a 75 73 74 20 66 6f 72 20 74  TF-16 just for t
6b70: 68 69 73 20 70 75 72 70 6f 73 65 2e 0a 20 20 2a  his purpose..  *
6b80: 2f 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64  /.  return (void
6b90: 20 2a 29 28 26 6f 75 74 4f 66 4d 65 6d 42 65 5b   *)(&outOfMemBe[
6ba0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49  SQLITE_UTF16NATI
6bb0: 56 45 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36  VE==SQLITE_UTF16
6bc0: 4c 45 3f 31 3a 30 5d 29 3b 0a 7d 0a 0a 69 6e 74  LE?1:0]);.}..int
6bd0: 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65   sqlite3_errcode
6be0: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
6bf0: 20 69 66 28 20 21 64 62 20 29 20 72 65 74 75 72   if( !db ) retur
6c00: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
6c10: 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 65 72 72    return db->err
6c20: 43 6f 64 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  Code;.}../*.** C
6c30: 68 65 63 6b 20 73 63 68 65 6d 61 20 63 6f 6f 6b  heck schema cook
6c40: 69 65 73 20 69 6e 20 61 6c 6c 20 64 61 74 61 62  ies in all datab
6c50: 61 73 65 73 20 65 78 63 65 70 74 20 54 45 4d 50  ases except TEMP
6c60: 2e 20 20 49 66 20 61 6e 79 20 63 6f 6f 6b 69 65  .  If any cookie
6c70: 20 69 73 20 6f 75 74 0a 2a 2a 20 6f 66 20 64 61   is out.** of da
6c80: 74 65 2c 20 72 65 74 75 72 6e 20 30 2e 20 20 49  te, return 0.  I
6c90: 66 20 61 6c 6c 20 73 63 68 65 6d 61 20 63 6f 6f  f all schema coo
6ca0: 6b 69 65 73 20 61 72 65 20 63 75 72 72 65 6e 74  kies are current
6cb0: 2c 20 72 65 74 75 72 6e 20 31 2e 0a 2a 2f 0a 73  , return 1..*/.s
6cc0: 74 61 74 69 63 20 69 6e 74 20 73 63 68 65 6d 61  tatic int schema
6cd0: 49 73 56 61 6c 69 64 28 73 71 6c 69 74 65 20 2a  IsValid(sqlite *
6ce0: 64 62 29 7b 0a 20 20 69 6e 74 20 69 44 62 3b 0a  db){.  int iDb;.
6cf0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 43 75    int rc;.  BtCu
6d00: 72 73 6f 72 20 2a 63 75 72 54 65 6d 70 3b 0a 20  rsor *curTemp;. 
6d10: 20 69 6e 74 20 63 6f 6f 6b 69 65 3b 0a 20 20 69   int cookie;.  i
6d20: 6e 74 20 61 6c 6c 4f 6b 20 3d 20 31 3b 0a 0a 20  nt allOk = 1;.. 
6d30: 20 66 6f 72 28 69 44 62 3d 30 3b 20 61 6c 6c 4f   for(iDb=0; allO
6d40: 6b 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e 44 62  k && iDb<db->nDb
6d50: 3b 20 69 44 62 2b 2b 29 7b 0a 20 20 20 20 42 74  ; iDb++){.    Bt
6d60: 72 65 65 20 2a 70 42 74 3b 0a 20 20 20 20 69 66  ree *pBt;.    if
6d70: 28 20 69 44 62 3d 3d 31 20 29 20 63 6f 6e 74 69  ( iDb==1 ) conti
6d80: 6e 75 65 3b 0a 20 20 20 20 70 42 74 20 3d 20 64  nue;.    pBt = d
6d90: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 3b  b->aDb[iDb].pBt;
6da0: 0a 20 20 20 20 69 66 28 20 70 42 74 3d 3d 30 20  .    if( pBt==0 
6db0: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20  ) continue;.    
6dc0: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
6dd0: 65 43 75 72 73 6f 72 28 70 42 74 2c 20 4d 41 53  eCursor(pBt, MAS
6de0: 54 45 52 5f 52 4f 4f 54 2c 20 30 2c 20 30 2c 20  TER_ROOT, 0, 0, 
6df0: 30 2c 20 26 63 75 72 54 65 6d 70 29 3b 0a 20 20  0, &curTemp);.  
6e00: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
6e10: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20  _OK ){.      rc 
6e20: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65  = sqlite3BtreeGe
6e30: 74 4d 65 74 61 28 70 42 74 2c 20 31 2c 20 28 75  tMeta(pBt, 1, (u
6e40: 33 32 20 2a 29 26 63 6f 6f 6b 69 65 29 3b 0a 20  32 *)&cookie);. 
6e50: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c       if( rc==SQL
6e60: 49 54 45 5f 4f 4b 20 26 26 20 63 6f 6f 6b 69 65  ITE_OK && cookie
6e70: 21 3d 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 73  !=db->aDb[iDb].s
6e80: 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 20 29 7b 0a  chema_cookie ){.
6e90: 20 20 20 20 20 20 20 20 61 6c 6c 4f 6b 20 3d 20          allOk = 
6ea0: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  0;.      }.     
6eb0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
6ec0: 73 65 43 75 72 73 6f 72 28 63 75 72 54 65 6d 70  seCursor(curTemp
6ed0: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  );.    }.  }.  r
6ee0: 65 74 75 72 6e 20 61 6c 6c 4f 6b 3b 0a 7d 0a 0a  eturn allOk;.}..
6ef0: 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 74 68  /*.** Compile th
6f00: 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20  e UTF-8 encoded 
6f10: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a 53  SQL statement zS
6f20: 71 6c 20 69 6e 74 6f 20 61 20 73 74 61 74 65 6d  ql into a statem
6f30: 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69  ent handle..*/.i
6f40: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
6f50: 72 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  re(.  sqlite3 *d
6f60: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b,              
6f70: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
6f80: 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  le. */.  const c
6f90: 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  har *zSql,      
6fa0: 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f     /* UTF-8 enco
6fb0: 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ded SQL statemen
6fc0: 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74  t. */.  int nByt
6fd0: 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  es,             
6fe0: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a    /* Length of z
6ff0: 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f  Sql in bytes. */
7000: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
7010: 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20  **ppStmt,    /* 
7020: 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74  OUT: A pointer t
7030: 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  o the prepared s
7040: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f  tatement */.  co
7050: 6e 73 74 20 63 68 61 72 2a 2a 20 70 7a 54 61 69  nst char** pzTai
7060: 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20  l       /* OUT: 
7070: 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74  End of parsed st
7080: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50 61 72  ring */.){.  Par
7090: 73 65 20 73 50 61 72 73 65 3b 0a 20 20 63 68 61  se sParse;.  cha
70a0: 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a  r *zErrMsg = 0;.
70b0: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
70c0: 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 73 71 6c  E_OK;..  if( sql
70d0: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
70e0: 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ed ){.    return
70f0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
7100: 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 70 70   }..  assert( pp
7110: 53 74 6d 74 20 29 3b 0a 20 20 2a 70 70 53 74 6d  Stmt );.  *ppStm
7120: 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 73 71 6c  t = 0;.  if( sql
7130: 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29  ite3SafetyOn(db)
7140: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
7150: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
7160: 7d 0a 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61  }..  memset(&sPa
7170: 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73  rse, 0, sizeof(s
7180: 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72 73  Parse));.  sPars
7190: 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 73 71 6c  e.db = db;.  sql
71a0: 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 26 73  ite3RunParser(&s
71b0: 50 61 72 73 65 2c 20 7a 53 71 6c 2c 20 26 7a 45  Parse, zSql, &zE
71c0: 72 72 4d 73 67 29 3b 0a 0a 20 20 69 66 28 20 64  rrMsg);..  if( d
71d0: 62 2d 3e 78 54 72 61 63 65 20 26 26 20 21 64 62  b->xTrace && !db
71e0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20  ->init.busy ){. 
71f0: 20 20 20 2f 2a 20 54 72 61 63 65 20 6f 6e 6c 79     /* Trace only
7200: 20 74 68 65 20 73 74 61 74 6d 65 6e 74 20 74 68   the statment th
7210: 61 74 20 77 61 73 20 63 6f 6d 70 69 6c 65 64 2e  at was compiled.
7220: 0a 20 20 20 20 2a 2a 20 4d 61 6b 65 20 61 20 63  .    ** Make a c
7230: 6f 70 79 20 6f 66 20 74 68 61 74 20 70 61 72 74  opy of that part
7240: 20 6f 66 20 74 68 65 20 53 51 4c 20 73 74 72 69   of the SQL stri
7250: 6e 67 20 73 69 6e 63 65 20 7a 53 51 4c 20 69 73  ng since zSQL is
7260: 20 63 6f 6e 73 74 0a 20 20 20 20 2a 2a 20 61 6e   const.    ** an
7270: 64 20 77 65 20 6d 75 73 74 20 70 61 73 73 20 61  d we must pass a
7280: 20 7a 65 72 6f 20 74 65 72 6d 69 6e 61 74 65 64   zero terminated
7290: 20 73 74 72 69 6e 67 20 74 6f 20 74 68 65 20 74   string to the t
72a0: 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20  race function.  
72b0: 20 20 2a 2a 20 54 68 65 20 63 6f 70 79 20 69 73    ** The copy is
72c0: 20 75 6e 6e 65 63 65 73 73 61 72 79 20 69 66 20   unnecessary if 
72d0: 74 68 65 20 74 61 69 6c 20 70 6f 69 6e 74 65 72  the tail pointer
72e0: 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 61 74 20   is pointing at 
72f0: 74 68 65 0a 20 20 20 20 2a 2a 20 62 65 67 69 6e  the.    ** begin
7300: 6e 69 67 20 6f 72 20 65 6e 64 20 6f 66 20 74 68  nig or end of th
7310: 65 20 53 51 4c 20 73 74 72 69 6e 67 2e 0a 20 20  e SQL string..  
7320: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 73 50 61    */.    if( sPa
7330: 72 73 65 2e 7a 54 61 69 6c 20 26 26 20 73 50 61  rse.zTail && sPa
7340: 72 73 65 2e 7a 54 61 69 6c 21 3d 7a 53 71 6c 20  rse.zTail!=zSql 
7350: 26 26 20 2a 73 50 61 72 73 65 2e 7a 54 61 69 6c  && *sParse.zTail
7360: 20 29 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a   ){.      char *
7370: 74 6d 70 53 71 6c 20 3d 20 73 71 6c 69 74 65 53  tmpSql = sqliteS
7380: 74 72 4e 44 75 70 28 7a 53 71 6c 2c 20 73 50 61  trNDup(zSql, sPa
7390: 72 73 65 2e 7a 54 61 69 6c 20 2d 20 7a 53 71 6c  rse.zTail - zSql
73a0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 74 6d 70  );.      if( tmp
73b0: 53 71 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 64  Sql ){.        d
73c0: 62 2d 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54  b->xTrace(db->pT
73d0: 72 61 63 65 41 72 67 2c 20 74 6d 70 53 71 6c 29  raceArg, tmpSql)
73e0: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
73f0: 46 72 65 65 28 74 6d 70 53 71 6c 29 3b 0a 20 20  Free(tmpSql);.  
7400: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
7410: 20 20 20 2f 2a 20 49 66 20 61 20 6d 65 6d 6f 72     /* If a memor
7420: 79 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64  y error occurred
7430: 20 64 75 72 69 6e 67 20 74 68 65 20 63 6f 70 79   during the copy
7440: 2c 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 72 61  ,.        ** tra
7450: 63 65 20 65 6e 74 69 72 65 20 53 51 4c 20 73 74  ce entire SQL st
7460: 72 69 6e 67 20 61 6e 64 20 66 61 6c 6c 20 74 68  ring and fall th
7470: 72 6f 75 67 68 20 74 6f 20 74 68 65 0a 20 20 20  rough to the.   
7480: 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f       ** sqlite3_
7490: 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 74 65  malloc_failed te
74a0: 73 74 20 74 6f 20 72 65 70 6f 72 74 20 74 68 65  st to report the
74b0: 20 65 72 72 6f 72 2e 0a 20 20 20 20 20 20 20 20   error..        
74c0: 2a 2f 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 78  */.        db->x
74d0: 54 72 61 63 65 28 64 62 2d 3e 70 54 72 61 63 65  Trace(db->pTrace
74e0: 41 72 67 2c 20 7a 53 71 6c 29 3b 20 0a 20 20 20  Arg, zSql); .   
74f0: 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a     }.    }else{.
7500: 20 20 20 20 20 20 64 62 2d 3e 78 54 72 61 63 65        db->xTrace
7510: 28 64 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20  (db->pTraceArg, 
7520: 7a 53 71 6c 29 3b 20 0a 20 20 20 20 7d 0a 20 20  zSql); .    }.  
7530: 7d 0a 0a 20 20 2f 2a 20 50 72 69 6e 74 20 61 20  }..  /* Print a 
7540: 63 6f 70 79 20 6f 66 20 53 51 4c 20 61 73 20 69  copy of SQL as i
7550: 74 20 69 73 20 65 78 65 63 75 74 65 64 20 69 66  t is executed if
7560: 20 74 68 65 20 53 51 4c 5f 54 52 41 43 45 20 70   the SQL_TRACE p
7570: 72 61 67 6d 61 20 69 73 20 74 75 72 6e 65 64 0a  ragma is turned.
7580: 20 20 2a 2a 20 6f 6e 20 69 6e 20 64 65 62 75 67    ** on in debug
7590: 67 69 6e 67 20 6d 6f 64 65 2e 0a 20 20 2a 2f 0a  ging mode..  */.
75a0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
75b0: 42 55 47 0a 20 20 69 66 28 20 28 64 62 2d 3e 66  BUG.  if( (db->f
75c0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 53 71  lags & SQLITE_Sq
75d0: 6c 54 72 61 63 65 29 21 3d 30 20 26 26 20 73 50  lTrace)!=0 && sP
75e0: 61 72 73 65 2e 7a 54 61 69 6c 20 26 26 20 73 50  arse.zTail && sP
75f0: 61 72 73 65 2e 7a 54 61 69 6c 21 3d 7a 53 71 6c  arse.zTail!=zSql
7600: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44   ){.    sqlite3D
7610: 65 62 75 67 50 72 69 6e 74 66 28 22 53 51 4c 2d  ebugPrintf("SQL-
7620: 74 72 61 63 65 3a 20 25 2e 2a 73 5c 6e 22 2c 20  trace: %.*s\n", 
7630: 73 50 61 72 73 65 2e 7a 54 61 69 6c 20 2d 20 7a  sParse.zTail - z
7640: 53 71 6c 2c 20 7a 53 71 6c 29 3b 0a 20 20 7d 0a  Sql, zSql);.  }.
7650: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
7660: 5f 44 45 42 55 47 20 2a 2f 0a 0a 0a 20 20 69 66  _DEBUG */...  if
7670: 28 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  ( sqlite3_malloc
7680: 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 72  _failed ){.    r
7690: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
76a0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 6f 6c  ;.    sqlite3Rol
76b0: 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b 0a 20 20  lbackAll(db);.  
76c0: 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e    sqlite3ResetIn
76d0: 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c  ternalSchema(db,
76e0: 20 30 29 3b 0a 20 20 20 20 64 62 2d 3e 66 6c 61   0);.    db->fla
76f0: 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e  gs &= ~SQLITE_In
7700: 54 72 61 6e 73 3b 0a 20 20 20 20 67 6f 74 6f 20  Trans;.    goto 
7710: 70 72 65 70 61 72 65 5f 6f 75 74 3b 0a 20 20 7d  prepare_out;.  }
7720: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 72 63  .  if( sParse.rc
7730: 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 20  ==SQLITE_DONE ) 
7740: 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49  sParse.rc = SQLI
7750: 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 73 50 61  TE_OK;.  if( sPa
7760: 72 73 65 2e 63 68 65 63 6b 53 63 68 65 6d 61 20  rse.checkSchema 
7770: 26 26 20 21 73 63 68 65 6d 61 49 73 56 61 6c 69  && !schemaIsVali
7780: 64 28 64 62 29 20 29 7b 0a 20 20 20 20 73 50 61  d(db) ){.    sPa
7790: 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f  rse.rc = SQLITE_
77a0: 53 43 48 45 4d 41 3b 0a 20 20 7d 0a 20 20 69 66  SCHEMA;.  }.  if
77b0: 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c  ( sParse.rc==SQL
77c0: 49 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20 20  ITE_SCHEMA ){.  
77d0: 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e    sqlite3ResetIn
77e0: 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c  ternalSchema(db,
77f0: 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70   0);.  }.  if( p
7800: 7a 54 61 69 6c 20 29 20 2a 70 7a 54 61 69 6c 20  zTail ) *pzTail 
7810: 3d 20 73 50 61 72 73 65 2e 7a 54 61 69 6c 3b 0a  = sParse.zTail;.
7820: 20 20 72 63 20 3d 20 73 50 61 72 73 65 2e 72 63    rc = sParse.rc
7830: 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  ;..  if( rc==SQL
7840: 49 54 45 5f 4f 4b 20 26 26 20 73 50 61 72 73 65  ITE_OK && sParse
7850: 2e 70 56 64 62 65 20 26 26 20 73 50 61 72 73 65  .pVdbe && sParse
7860: 2e 65 78 70 6c 61 69 6e 20 29 7b 0a 20 20 20 20  .explain ){.    
7870: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75  sqlite3VdbeSetNu
7880: 6d 43 6f 6c 73 28 73 50 61 72 73 65 2e 70 56 64  mCols(sParse.pVd
7890: 62 65 2c 20 35 29 3b 0a 20 20 20 20 73 71 6c 69  be, 5);.    sqli
78a0: 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d  te3VdbeSetColNam
78b0: 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20  e(sParse.pVdbe, 
78c0: 30 2c 20 22 61 64 64 72 22 2c 20 50 33 5f 53 54  0, "addr", P3_ST
78d0: 41 54 49 43 29 3b 0a 20 20 20 20 73 71 6c 69 74  ATIC);.    sqlit
78e0: 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65  e3VdbeSetColName
78f0: 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 31  (sParse.pVdbe, 1
7900: 2c 20 22 6f 70 63 6f 64 65 22 2c 20 50 33 5f 53  , "opcode", P3_S
7910: 54 41 54 49 43 29 3b 0a 20 20 20 20 73 71 6c 69  TATIC);.    sqli
7920: 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d  te3VdbeSetColNam
7930: 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20  e(sParse.pVdbe, 
7940: 32 2c 20 22 70 31 22 2c 20 50 33 5f 53 54 41 54  2, "p1", P3_STAT
7950: 49 43 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  IC);.    sqlite3
7960: 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73  VdbeSetColName(s
7970: 50 61 72 73 65 2e 70 56 64 62 65 2c 20 33 2c 20  Parse.pVdbe, 3, 
7980: 22 70 32 22 2c 20 50 33 5f 53 54 41 54 49 43 29  "p2", P3_STATIC)
7990: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
79a0: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72  eSetColName(sPar
79b0: 73 65 2e 70 56 64 62 65 2c 20 34 2c 20 22 70 33  se.pVdbe, 4, "p3
79c0: 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20  ", P3_STATIC);. 
79d0: 20 7d 20 0a 0a 70 72 65 70 61 72 65 5f 6f 75 74   } ..prepare_out
79e0: 3a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53  :.  if( sqlite3S
79f0: 61 66 65 74 79 4f 66 66 28 64 62 29 20 29 7b 0a  afetyOff(db) ){.
7a00: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
7a10: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66  MISUSE;.  }.  if
7a20: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
7a30: 29 7b 0a 20 20 20 20 2a 70 70 53 74 6d 74 20 3d  ){.    *ppStmt =
7a40: 20 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29   (sqlite3_stmt*)
7a50: 73 50 61 72 73 65 2e 70 56 64 62 65 3b 0a 20 20  sParse.pVdbe;.  
7a60: 7d 65 6c 73 65 20 69 66 28 20 73 50 61 72 73 65  }else if( sParse
7a70: 2e 70 56 64 62 65 20 29 7b 0a 20 20 20 20 73 71  .pVdbe ){.    sq
7a80: 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 28  lite3_finalize((
7a90: 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29 73 50  sqlite3_stmt*)sP
7aa0: 61 72 73 65 2e 70 56 64 62 65 29 3b 0a 20 20 7d  arse.pVdbe);.  }
7ab0: 0a 0a 20 20 69 66 28 20 7a 45 72 72 4d 73 67 20  ..  if( zErrMsg 
7ac0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72  ){.    sqlite3Er
7ad0: 72 6f 72 28 64 62 2c 20 72 63 2c 20 22 25 73 22  ror(db, rc, "%s"
7ae0: 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  , zErrMsg);.    
7af0: 73 71 6c 69 74 65 46 72 65 65 28 7a 45 72 72 4d  sqliteFree(zErrM
7b00: 73 67 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  sg);.  }else{.  
7b10: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64    sqlite3Error(d
7b20: 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20 7d 0a 20  b, rc, 0);.  }. 
7b30: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
7b40: 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 74 68 65  *.** Compile the
7b50: 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20   UTF-16 encoded 
7b60: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a 53  SQL statement zS
7b70: 71 6c 20 69 6e 74 6f 20 61 20 73 74 61 74 65 6d  ql into a statem
7b80: 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69  ent handle..*/.i
7b90: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
7ba0: 72 65 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20  re16(.  sqlite3 
7bb0: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
7bc0: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61    /* Database ha
7bd0: 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73  ndle. */ .  cons
7be0: 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 20  t void *zSql,   
7bf0: 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65        /* UTF-8 e
7c00: 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65  ncoded SQL state
7c10: 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e  ment. */.  int n
7c20: 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20 20  Bytes,          
7c30: 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f       /* Length o
7c40: 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e  f zSql in bytes.
7c50: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74   */.  sqlite3_st
7c60: 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20  mt **ppStmt,    
7c70: 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65  /* OUT: A pointe
7c80: 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 65  r to the prepare
7c90: 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20  d statement */. 
7ca0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a   const void **pz
7cb0: 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55  Tail       /* OU
7cc0: 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64  T: End of parsed
7cd0: 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20   string */.){.  
7ce0: 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  /* This function
7cf0: 20 63 75 72 72 65 6e 74 6c 79 20 77 6f 72 6b 73   currently works
7d00: 20 62 79 20 66 69 72 73 74 20 74 72 61 6e 73 66   by first transf
7d10: 6f 72 6d 69 6e 67 20 74 68 65 20 55 54 46 2d 31  orming the UTF-1
7d20: 36 0a 20 20 2a 2a 20 65 6e 63 6f 64 65 64 20 73  6.  ** encoded s
7d30: 74 72 69 6e 67 20 74 6f 20 55 54 46 2d 38 2c 20  tring to UTF-8, 
7d40: 74 68 65 6e 20 69 6e 76 6f 6b 69 6e 67 20 73 71  then invoking sq
7d50: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 2e  lite3_prepare().
7d60: 20 54 68 65 0a 20 20 2a 2a 20 74 72 69 63 6b 79   The.  ** tricky
7d70: 20 62 69 74 20 69 73 20 66 69 67 75 72 69 6e 67   bit is figuring
7d80: 20 6f 75 74 20 74 68 65 20 70 6f 69 6e 74 65 72   out the pointer
7d90: 20 74 6f 20 72 65 74 75 72 6e 20 69 6e 20 2a 70   to return in *p
7da0: 7a 54 61 69 6c 2e 0a 20 20 2a 2f 0a 20 20 63 68  zTail..  */.  ch
7db0: 61 72 20 63 6f 6e 73 74 20 2a 7a 53 71 6c 38 20  ar const *zSql8 
7dc0: 3d 20 30 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73  = 0;.  char cons
7dd0: 74 20 2a 7a 54 61 69 6c 38 20 3d 20 30 3b 0a 20  t *zTail8 = 0;. 
7de0: 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74   int rc;.  sqlit
7df0: 65 33 5f 76 61 6c 75 65 20 2a 70 54 6d 70 3b 0a  e3_value *pTmp;.
7e00: 0a 20 20 70 54 6d 70 20 3d 20 73 71 6c 69 74 65  .  pTmp = sqlite
7e10: 33 47 65 74 54 72 61 6e 73 69 65 6e 74 56 61 6c  3GetTransientVal
7e20: 75 65 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65  ue(db);.  sqlite
7e30: 33 56 61 6c 75 65 53 65 74 53 74 72 28 70 54 6d  3ValueSetStr(pTm
7e40: 70 2c 20 2d 31 2c 20 7a 53 71 6c 2c 20 53 51 4c  p, -1, zSql, SQL
7e50: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c  ITE_UTF16NATIVE,
7e60: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
7e70: 0a 20 20 7a 53 71 6c 38 20 3d 20 73 71 6c 69 74  .  zSql8 = sqlit
7e80: 65 33 56 61 6c 75 65 54 65 78 74 28 70 54 6d 70  e3ValueText(pTmp
7e90: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a  , SQLITE_UTF8);.
7ea0: 20 20 69 66 28 20 21 7a 53 71 6c 38 20 29 7b 0a    if( !zSql8 ){.
7eb0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
7ec0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  (db, SQLITE_NOME
7ed0: 4d 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72  M, 0);.    retur
7ee0: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
7ef0: 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74    }.  rc = sqlit
7f00: 65 33 5f 70 72 65 70 61 72 65 28 64 62 2c 20 7a  e3_prepare(db, z
7f10: 53 71 6c 38 2c 20 2d 31 2c 20 70 70 53 74 6d 74  Sql8, -1, ppStmt
7f20: 2c 20 26 7a 54 61 69 6c 38 29 3b 0a 0a 20 20 69  , &zTail8);..  i
7f30: 66 28 20 7a 54 61 69 6c 38 20 26 26 20 70 7a 54  f( zTail8 && pzT
7f40: 61 69 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66  ail ){.    /* If
7f50: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
7f60: 20 72 65 74 75 72 6e 73 20 61 20 74 61 69 6c 20   returns a tail 
7f70: 70 6f 69 6e 74 65 72 2c 20 77 65 20 63 61 6c 63  pointer, we calc
7f80: 75 6c 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a  ulate the.    **
7f90: 20 65 71 75 69 76 61 6c 65 6e 74 20 70 6f 69 6e   equivalent poin
7fa0: 74 65 72 20 69 6e 74 6f 20 74 68 65 20 55 54 46  ter into the UTF
7fb0: 2d 31 36 20 73 74 72 69 6e 67 20 62 79 20 63 6f  -16 string by co
7fc0: 75 6e 74 69 6e 67 20 74 68 65 20 75 6e 69 63 6f  unting the unico
7fd0: 64 65 0a 20 20 20 20 2a 2a 20 63 68 61 72 61 63  de.    ** charac
7fe0: 74 65 72 73 20 62 65 74 77 65 65 6e 20 7a 53 71  ters between zSq
7ff0: 6c 38 20 61 6e 64 20 7a 54 61 69 6c 38 2c 20 61  l8 and zTail8, a
8000: 6e 64 20 74 68 65 6e 20 72 65 74 75 72 6e 69 6e  nd then returnin
8010: 67 20 61 20 70 6f 69 6e 74 65 72 0a 20 20 20 20  g a pointer.    
8020: 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 75 6d 62  ** the same numb
8030: 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 72 73  er of characters
8040: 20 69 6e 74 6f 20 74 68 65 20 55 54 46 2d 31 36   into the UTF-16
8050: 20 73 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a   string..    */.
8060: 20 20 20 20 69 6e 74 20 63 68 61 72 73 5f 70 61      int chars_pa
8070: 72 73 65 64 20 3d 20 73 71 6c 69 74 65 33 75 74  rsed = sqlite3ut
8080: 66 38 43 68 61 72 4c 65 6e 28 7a 53 71 6c 38 2c  f8CharLen(zSql8,
8090: 20 7a 54 61 69 6c 38 2d 7a 53 71 6c 38 29 3b 0a   zTail8-zSql8);.
80a0: 20 20 20 20 2a 70 7a 54 61 69 6c 20 3d 20 28 75      *pzTail = (u
80b0: 38 20 2a 29 7a 53 71 6c 20 2b 20 73 71 6c 69 74  8 *)zSql + sqlit
80c0: 65 33 75 74 66 31 36 42 79 74 65 4c 65 6e 28 7a  e3utf16ByteLen(z
80d0: 53 71 6c 2c 20 63 68 61 72 73 5f 70 61 72 73 65  Sql, chars_parse
80e0: 64 29 3b 0a 20 20 7d 0a 20 0a 20 20 72 65 74 75  d);.  }. .  retu
80f0: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
8100: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64 6f 65  This routine doe
8110: 73 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 6f 70  s the work of op
8120: 65 6e 69 6e 67 20 61 20 64 61 74 61 62 61 73 65  ening a database
8130: 20 6f 6e 20 62 65 68 61 6c 66 20 6f 66 0a 2a 2a   on behalf of.**
8140: 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20   sqlite3_open() 
8150: 61 6e 64 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e  and sqlite3_open
8160: 31 36 28 29 2e 20 54 68 65 20 64 61 74 61 62 61  16(). The databa
8170: 73 65 20 66 69 6c 65 6e 61 6d 65 20 22 7a 46 69  se filename "zFi
8180: 6c 65 6e 61 6d 65 22 20 20 0a 2a 2a 20 69 73 20  lename"  .** is 
8190: 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 2e 20 54  UTF-8 encoded. T
81a0: 68 65 20 66 6f 75 72 74 68 20 61 72 67 75 6d 65  he fourth argume
81b0: 6e 74 2c 20 22 64 65 66 5f 65 6e 63 22 20 69 73  nt, "def_enc" is
81c0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 54 45 58 54   one of the TEXT
81d0: 5f 2a 0a 2a 2a 20 6d 61 63 72 6f 73 20 66 72 6f  _*.** macros fro
81e0: 6d 20 73 71 6c 69 74 65 49 6e 74 2e 68 2e 20 49  m sqliteInt.h. I
81f0: 66 20 77 65 20 65 6e 64 20 75 70 20 63 72 65 61  f we end up crea
8200: 74 69 6e 67 20 61 20 6e 65 77 20 64 61 74 61 62  ting a new datab
8210: 61 73 65 20 66 69 6c 65 0a 2a 2a 20 28 6e 6f 74  ase file.** (not
8220: 20 6f 70 65 6e 69 6e 67 20 61 6e 20 65 78 69 73   opening an exis
8230: 74 69 6e 67 20 6f 6e 65 29 2c 20 74 68 65 20 74  ting one), the t
8240: 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20  ext encoding of 
8250: 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20  the database.** 
8260: 77 69 6c 6c 20 62 65 20 73 65 74 20 74 6f 20 74  will be set to t
8270: 68 69 73 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74  his value..*/.st
8280: 61 74 69 63 20 69 6e 74 20 6f 70 65 6e 44 61 74  atic int openDat
8290: 61 62 61 73 65 28 0a 20 20 63 6f 6e 73 74 20 63  abase(.  const c
82a0: 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20  har *zFilename, 
82b0: 2f 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65  /* Database file
82c0: 6e 61 6d 65 20 55 54 46 2d 38 20 65 6e 63 6f 64  name UTF-8 encod
82d0: 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20  ed */.  sqlite3 
82e0: 2a 2a 70 70 44 62 20 20 20 20 20 20 20 20 20 2f  **ppDb         /
82f0: 2a 20 4f 55 54 3a 20 52 65 74 75 72 6e 65 64 20  * OUT: Returned 
8300: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  database handle 
8310: 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20  */.){.  sqlite3 
8320: 2a 64 62 3b 0a 20 20 69 6e 74 20 72 63 2c 20 69  *db;.  int rc, i
8330: 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73  ;.  char *zErrMs
8340: 67 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 41 6c 6c  g = 0;..  /* All
8350: 6f 63 61 74 65 20 74 68 65 20 73 71 6c 69 74 65  ocate the sqlite
8360: 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65 20   data structure 
8370: 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 65  */.  db = sqlite
8380: 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 73  Malloc( sizeof(s
8390: 71 6c 69 74 65 29 20 29 3b 0a 20 20 69 66 28 20  qlite) );.  if( 
83a0: 64 62 3d 3d 30 20 29 20 67 6f 74 6f 20 6f 70 65  db==0 ) goto ope
83b0: 6e 64 62 5f 6f 75 74 3b 0a 20 20 64 62 2d 3e 70  ndb_out;.  db->p
83c0: 72 69 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30  riorNewRowid = 0
83d0: 3b 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20  ;.  db->magic = 
83e0: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53  SQLITE_MAGIC_BUS
83f0: 59 3b 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32  Y;.  db->nDb = 2
8400: 3b 0a 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62  ;.  db->aDb = db
8410: 2d 3e 61 44 62 53 74 61 74 69 63 3b 0a 20 20 64  ->aDbStatic;.  d
8420: 62 2d 3e 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f  b->enc = SQLITE_
8430: 55 54 46 38 3b 0a 20 20 64 62 2d 3e 61 75 74 6f  UTF8;.  db->auto
8440: 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 2f 2a  Commit = 1;.  /*
8450: 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51   db->flags |= SQ
8460: 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d  LITE_ShortColNam
8470: 65 73 3b 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  es; */.  sqlite3
8480: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 46  HashInit(&db->aF
8490: 75 6e 63 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  unc, SQLITE_HASH
84a0: 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73  _STRING, 0);.  s
84b0: 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26  qlite3HashInit(&
84c0: 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c 20 53 51  db->aCollSeq, SQ
84d0: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47  LITE_HASH_STRING
84e0: 2c 20 30 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b  , 0);.  for(i=0;
84f0: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
8500: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 48 61 73  {.    sqlite3Has
8510: 68 49 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69  hInit(&db->aDb[i
8520: 5d 2e 74 62 6c 48 61 73 68 2c 20 53 51 4c 49 54  ].tblHash, SQLIT
8530: 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30  E_HASH_STRING, 0
8540: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 48 61  );.    sqlite3Ha
8550: 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b  shInit(&db->aDb[
8560: 69 5d 2e 69 64 78 48 61 73 68 2c 20 53 51 4c 49  i].idxHash, SQLI
8570: 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20  TE_HASH_STRING, 
8580: 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 48  0);.    sqlite3H
8590: 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 44 62  ashInit(&db->aDb
85a0: 5b 69 5d 2e 74 72 69 67 48 61 73 68 2c 20 53 51  [i].trigHash, SQ
85b0: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47  LITE_HASH_STRING
85c0: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
85d0: 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61  3HashInit(&db->a
85e0: 44 62 5b 69 5d 2e 61 46 4b 65 79 2c 20 53 51 4c  Db[i].aFKey, SQL
85f0: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
8600: 20 31 29 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a   1);.  }.  .  /*
8610: 20 41 64 64 20 74 68 65 20 64 65 66 61 75 6c 74   Add the default
8620: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65   collation seque
8630: 6e 63 65 20 42 49 4e 41 52 59 2e 20 42 49 4e 41  nce BINARY. BINA
8640: 52 59 20 77 6f 72 6b 73 20 66 6f 72 20 62 6f 74  RY works for bot
8650: 68 20 55 54 46 2d 38 0a 20 20 2a 2a 20 61 6e 64  h UTF-8.  ** and
8660: 20 55 54 46 2d 31 36 2c 20 73 6f 20 61 64 64 20   UTF-16, so add 
8670: 61 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 65 61  a version for ea
8680: 63 68 20 74 6f 20 61 76 6f 69 64 20 61 6e 79 20  ch to avoid any 
8690: 75 6e 6e 65 63 65 73 73 61 72 79 0a 20 20 2a 2a  unnecessary.  **
86a0: 20 63 6f 6e 76 65 72 73 69 6f 6e 73 2e 20 54 68   conversions. Th
86b0: 65 20 6f 6e 6c 79 20 65 72 72 6f 72 20 74 68 61  e only error tha
86c0: 74 20 63 61 6e 20 6f 63 63 75 72 20 68 65 72 65  t can occur here
86d0: 20 69 73 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66   is a malloc() f
86e0: 61 69 6c 75 72 65 2e 0a 20 20 2a 2f 0a 20 20 73  ailure..  */.  s
86f0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f  qlite3_create_co
8700: 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e  llation(db, "BIN
8710: 41 52 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 46  ARY", SQLITE_UTF
8720: 38 2c 20 30 2c 62 69 6e 61 72 79 43 6f 6c 6c 61  8, 0,binaryColla
8730: 74 69 6e 67 46 75 6e 63 29 3b 0a 20 20 73 71 6c  tingFunc);.  sql
8740: 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c  ite3_create_coll
8750: 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52  ation(db, "BINAR
8760: 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  Y", SQLITE_UTF16
8770: 4c 45 2c 20 30 2c 62 69 6e 61 72 79 43 6f 6c 6c  LE, 0,binaryColl
8780: 61 74 69 6e 67 46 75 6e 63 29 3b 0a 20 20 73 71  atingFunc);.  sq
8790: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c  lite3_create_col
87a0: 6c 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41  lation(db, "BINA
87b0: 52 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  RY", SQLITE_UTF1
87c0: 36 42 45 2c 20 30 2c 62 69 6e 61 72 79 43 6f 6c  6BE, 0,binaryCol
87d0: 6c 61 74 69 6e 67 46 75 6e 63 29 3b 0a 20 20 64  latingFunc);.  d
87e0: 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d 20 73  b->pDfltColl = s
87f0: 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65  qlite3FindCollSe
8800: 71 28 64 62 2c 20 64 62 2d 3e 65 6e 63 2c 20 22  q(db, db->enc, "
8810: 42 49 4e 41 52 59 22 2c 20 36 2c 20 30 29 3b 0a  BINARY", 6, 0);.
8820: 20 20 69 66 28 20 21 64 62 2d 3e 70 44 66 6c 74    if( !db->pDflt
8830: 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d  Coll ){.    rc =
8840: 20 64 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20   db->errCode;.  
8850: 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51    assert( rc!=SQ
8860: 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 64  LITE_OK );.    d
8870: 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54  b->magic = SQLIT
8880: 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a  E_MAGIC_CLOSED;.
8890: 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f      goto opendb_
88a0: 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41  out;.  }..  /* A
88b0: 6c 73 6f 20 61 64 64 20 61 20 55 54 46 2d 38 20  lso add a UTF-8 
88c0: 63 61 73 65 2d 69 6e 73 65 6e 73 69 74 69 76 65  case-insensitive
88d0: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65   collation seque
88e0: 6e 63 65 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65  nce. */.  sqlite
88f0: 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69  3_create_collati
8900: 6f 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c  on(db, "NOCASE",
8910: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c   SQLITE_UTF8, 0,
8920: 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67   nocaseCollating
8930: 46 75 6e 63 29 3b 0a 0a 20 20 2f 2a 20 4f 70 65  Func);..  /* Ope
8940: 6e 20 74 68 65 20 62 61 63 6b 65 6e 64 20 64 61  n the backend da
8950: 74 61 62 61 73 65 20 64 72 69 76 65 72 20 2a 2f  tabase driver */
8960: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42  .  rc = sqlite3B
8970: 74 72 65 65 46 61 63 74 6f 72 79 28 64 62 2c 20  treeFactory(db, 
8980: 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 2c 20 4d 41  zFilename, 0, MA
8990: 58 5f 50 41 47 45 53 2c 20 26 64 62 2d 3e 61 44  X_PAGES, &db->aD
89a0: 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 69 66 28  b[0].pBt);.  if(
89b0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
89c0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72  {.    sqlite3Err
89d0: 6f 72 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20  or(db, rc, 0);. 
89e0: 20 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53     db->magic = S
89f0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53  QLITE_MAGIC_CLOS
8a00: 45 44 3b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65  ED;.    goto ope
8a10: 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 64  ndb_out;.  }.  d
8a20: 62 2d 3e 61 44 62 5b 30 5d 2e 7a 4e 61 6d 65 20  b->aDb[0].zName 
8a30: 3d 20 22 6d 61 69 6e 22 3b 0a 20 20 64 62 2d 3e  = "main";.  db->
8a40: 61 44 62 5b 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22  aDb[1].zName = "
8a50: 74 65 6d 70 22 3b 0a 0a 20 20 2f 2a 20 54 68 65  temp";..  /* The
8a60: 20 64 65 66 61 75 6c 74 20 73 61 66 65 74 79 5f   default safety_
8a70: 6c 65 76 65 6c 20 66 6f 72 20 74 68 65 20 6d 61  level for the ma
8a80: 69 6e 20 64 61 74 61 62 61 73 65 20 69 73 20 27  in database is '
8a90: 66 75 6c 6c 27 20 66 6f 72 20 74 68 65 20 74 65  full' for the te
8aa0: 6d 70 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65  mp.  ** database
8ab0: 20 69 74 20 69 73 20 27 4e 4f 4e 45 27 2e 20 54   it is 'NONE'. T
8ac0: 68 69 73 20 6d 61 74 63 68 65 73 20 74 68 65 20  his matches the 
8ad0: 70 61 67 65 72 20 6c 61 79 65 72 20 64 65 66 61  pager layer defa
8ae0: 75 6c 74 73 2e 20 20 2a 2f 0a 20 20 64 62 2d 3e  ults.  */.  db->
8af0: 61 44 62 5b 30 5d 2e 73 61 66 65 74 79 5f 6c 65  aDb[0].safety_le
8b00: 76 65 6c 20 3d 20 33 3b 0a 20 20 64 62 2d 3e 61  vel = 3;.  db->a
8b10: 44 62 5b 31 5d 2e 73 61 66 65 74 79 5f 6c 65 76  Db[1].safety_lev
8b20: 65 6c 20 3d 20 31 3b 0a 0a 20 20 2f 2a 20 52 65  el = 1;..  /* Re
8b30: 67 69 73 74 65 72 20 61 6c 6c 20 62 75 69 6c 74  gister all built
8b40: 2d 69 6e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 62  -in functions, b
8b50: 75 74 20 64 6f 20 6e 6f 74 20 61 74 74 65 6d 70  ut do not attemp
8b60: 74 20 74 6f 20 72 65 61 64 20 74 68 65 0a 20 20  t to read the.  
8b70: 2a 2a 20 64 61 74 61 62 61 73 65 20 73 63 68 65  ** database sche
8b80: 6d 61 20 79 65 74 2e 20 54 68 69 73 20 69 73 20  ma yet. This is 
8b90: 64 65 6c 61 79 65 64 20 75 6e 74 69 6c 20 74 68  delayed until th
8ba0: 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 65  e first time the
8bb0: 20 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 69   database.  ** i
8bc0: 73 20 61 63 63 65 73 73 65 64 2e 0a 20 20 2a 2f  s accessed..  */
8bd0: 0a 20 20 73 71 6c 69 74 65 33 52 65 67 69 73 74  .  sqlite3Regist
8be0: 65 72 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f  erBuiltinFunctio
8bf0: 6e 73 28 64 62 29 3b 0a 20 20 69 66 28 20 72 63  ns(db);.  if( rc
8c00: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
8c10: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
8c20: 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30  db, SQLITE_OK, 0
8c30: 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63  );.    db->magic
8c40: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f   = SQLITE_MAGIC_
8c50: 4f 50 45 4e 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  OPEN;.  }else{. 
8c60: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
8c70: 64 62 2c 20 72 63 2c 20 22 25 73 22 2c 20 7a 45  db, rc, "%s", zE
8c80: 72 72 4d 73 67 2c 20 30 29 3b 0a 20 20 20 20 69  rrMsg, 0);.    i
8c90: 66 28 20 7a 45 72 72 4d 73 67 20 29 20 73 71 6c  f( zErrMsg ) sql
8ca0: 69 74 65 46 72 65 65 28 7a 45 72 72 4d 73 67 29  iteFree(zErrMsg)
8cb0: 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 20  ;.    db->magic 
8cc0: 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43  = SQLITE_MAGIC_C
8cd0: 4c 4f 53 45 44 3b 0a 20 20 7d 0a 0a 6f 70 65 6e  LOSED;.  }..open
8ce0: 64 62 5f 6f 75 74 3a 0a 20 20 69 66 28 20 73 71  db_out:.  if( sq
8cf0: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 64 62  lite3_errcode(db
8d00: 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  )==SQLITE_OK && 
8d10: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
8d20: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 71 6c  ailed ){.    sql
8d30: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51  ite3Error(db, SQ
8d40: 4c 49 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b 0a  LITE_NOMEM, 0);.
8d50: 20 20 7d 0a 20 20 2a 70 70 44 62 20 3d 20 64 62    }.  *ppDb = db
8d60: 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  ;.  return sqlit
8d70: 65 33 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a  e3_errcode(db);.
8d80: 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20  }../*.** Open a 
8d90: 6e 65 77 20 64 61 74 61 62 61 73 65 20 68 61 6e  new database han
8da0: 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  dle..*/.int sqli
8db0: 74 65 33 5f 6f 70 65 6e 28 0a 20 20 63 6f 6e 73  te3_open(.  cons
8dc0: 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d  t char *zFilenam
8dd0: 65 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a  e, .  sqlite3 **
8de0: 70 70 44 62 20 0a 29 7b 0a 20 20 72 65 74 75 72  ppDb .){.  retur
8df0: 6e 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 7a  n openDatabase(z
8e00: 46 69 6c 65 6e 61 6d 65 2c 20 70 70 44 62 29 3b  Filename, ppDb);
8e10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61  .}../*.** Open a
8e20: 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 68 61   new database ha
8e30: 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ndle..*/.int sql
8e40: 69 74 65 33 5f 6f 70 65 6e 31 36 28 0a 20 20 63  ite3_open16(.  c
8e50: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 46 69 6c 65  onst void *zFile
8e60: 6e 61 6d 65 2c 20 0a 20 20 73 71 6c 69 74 65 33  name, .  sqlite3
8e70: 20 2a 2a 70 70 44 62 0a 29 7b 0a 20 20 63 68 61   **ppDb.){.  cha
8e80: 72 20 63 6f 6e 73 74 20 2a 7a 46 69 6c 65 6e 61  r const *zFilena
8e90: 6d 65 38 3b 20 20 20 2f 2a 20 7a 46 69 6c 65 6e  me8;   /* zFilen
8ea0: 61 6d 65 20 65 6e 63 6f 64 65 64 20 69 6e 20 55  ame encoded in U
8eb0: 54 46 2d 38 20 69 6e 73 74 65 61 64 20 6f 66 20  TF-8 instead of 
8ec0: 55 54 46 2d 31 36 20 2a 2f 0a 20 20 69 6e 74 20  UTF-16 */.  int 
8ed0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  rc = SQLITE_NOME
8ee0: 4d 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c  M;.  sqlite3_val
8ef0: 75 65 20 2a 70 56 61 6c 3b 0a 0a 20 20 61 73 73  ue *pVal;..  ass
8f00: 65 72 74 28 20 70 70 44 62 20 29 3b 0a 20 20 2a  ert( ppDb );.  *
8f10: 70 70 44 62 20 3d 20 30 3b 0a 20 20 70 56 61 6c  ppDb = 0;.  pVal
8f20: 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 4e   = sqlite3ValueN
8f30: 65 77 28 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  ew();.  sqlite3V
8f40: 61 6c 75 65 53 65 74 53 74 72 28 70 56 61 6c 2c  alueSetStr(pVal,
8f50: 20 2d 31 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20   -1, zFilename, 
8f60: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49  SQLITE_UTF16NATI
8f70: 56 45 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49  VE, SQLITE_STATI
8f80: 43 29 3b 0a 20 20 7a 46 69 6c 65 6e 61 6d 65 38  C);.  zFilename8
8f90: 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54   = sqlite3ValueT
8fa0: 65 78 74 28 70 56 61 6c 2c 20 53 51 4c 49 54 45  ext(pVal, SQLITE
8fb0: 5f 55 54 46 38 29 3b 0a 20 20 69 66 28 20 7a 46  _UTF8);.  if( zF
8fc0: 69 6c 65 6e 61 6d 65 38 20 29 7b 0a 20 20 20 20  ilename8 ){.    
8fd0: 72 63 20 3d 20 6f 70 65 6e 44 61 74 61 62 61 73  rc = openDatabas
8fe0: 65 28 7a 46 69 6c 65 6e 61 6d 65 38 2c 20 70 70  e(zFilename8, pp
8ff0: 44 62 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d  Db);.    if( rc=
9000: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 2a 70  =SQLITE_OK && *p
9010: 70 44 62 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  pDb ){.      sql
9020: 69 74 65 33 5f 65 78 65 63 28 2a 70 70 44 62 2c  ite3_exec(*ppDb,
9030: 20 22 50 52 41 47 4d 41 20 65 6e 63 6f 64 69 6e   "PRAGMA encodin
9040: 67 20 3d 20 27 55 54 46 2d 31 36 27 22 2c 20 30  g = 'UTF-16'", 0
9050: 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20  , 0, 0);.    }. 
9060: 20 7d 0a 20 20 69 66 28 20 70 56 61 6c 20 29 7b   }.  if( pVal ){
9070: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 61 6c 75  .    sqlite3Valu
9080: 65 46 72 65 65 28 70 56 61 6c 29 3b 0a 20 20 7d  eFree(pVal);.  }
9090: 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ..  return rc;.}
90a0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c  ../*.** The foll
90b0: 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 20 64 65  owing routine de
90c0: 73 74 72 6f 79 73 20 61 20 76 69 72 74 75 61 6c  stroys a virtual
90d0: 20 6d 61 63 68 69 6e 65 20 74 68 61 74 20 69 73   machine that is
90e0: 20 63 72 65 61 74 65 64 20 62 79 0a 2a 2a 20 74   created by.** t
90f0: 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70 69  he sqlite3_compi
9100: 6c 65 28 29 20 72 6f 75 74 69 6e 65 2e 20 54 68  le() routine. Th
9110: 65 20 69 6e 74 65 67 65 72 20 72 65 74 75 72 6e  e integer return
9120: 65 64 20 69 73 20 61 6e 20 53 51 4c 49 54 45 5f  ed is an SQLITE_
9130: 0a 2a 2a 20 73 75 63 63 65 73 73 2f 66 61 69 6c  .** success/fail
9140: 75 72 65 20 63 6f 64 65 20 74 68 61 74 20 64 65  ure code that de
9150: 73 63 72 69 62 65 73 20 74 68 65 20 72 65 73 75  scribes the resu
9160: 6c 74 20 6f 66 20 65 78 65 63 75 74 69 6e 67 20  lt of executing 
9170: 74 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20 6d  the virtual.** m
9180: 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  achine..**.** Th
9190: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20  is routine sets 
91a0: 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 61  the error code a
91b0: 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 72 6e  nd string return
91c0: 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33  ed by.** sqlite3
91d0: 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 6c 69  _errcode(), sqli
91e0: 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e 64  te3_errmsg() and
91f0: 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31   sqlite3_errmsg1
9200: 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  6()..*/.int sqli
9210: 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 73 71 6c  te3_finalize(sql
9220: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
9230: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
9240: 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28  te3VdbeFinalize(
9250: 28 56 64 62 65 2a 29 70 53 74 6d 74 29 3b 0a 7d  (Vdbe*)pStmt);.}
9260: 0a 0a 2f 2a 0a 2a 2a 20 54 65 72 6d 69 6e 61 74  ../*.** Terminat
9270: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 65 78  e the current ex
9280: 65 63 75 74 69 6f 6e 20 6f 66 20 61 6e 20 53 51  ecution of an SQ
9290: 4c 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20  L statement and 
92a0: 72 65 73 65 74 20 69 74 0a 2a 2a 20 62 61 63 6b  reset it.** back
92b0: 20 74 6f 20 69 74 73 20 73 74 61 72 74 69 6e 67   to its starting
92c0: 20 73 74 61 74 65 20 73 6f 20 74 68 61 74 20 69   state so that i
92d0: 74 20 63 61 6e 20 62 65 20 72 65 75 73 65 64 2e  t can be reused.
92e0: 20 41 20 73 75 63 63 65 73 73 20 63 6f 64 65 20   A success code 
92f0: 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 70 72 69 6f  from.** the prio
9300: 72 20 65 78 65 63 75 74 69 6f 6e 20 69 73 20 72  r execution is r
9310: 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54  eturned..**.** T
9320: 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73  his routine sets
9330: 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20   the error code 
9340: 61 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 72  and string retur
9350: 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65  ned by.** sqlite
9360: 33 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 6c  3_errcode(), sql
9370: 69 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e  ite3_errmsg() an
9380: 64 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67  d sqlite3_errmsg
9390: 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  16()..*/.int sql
93a0: 69 74 65 33 5f 72 65 73 65 74 28 73 71 6c 69 74  ite3_reset(sqlit
93b0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
93c0: 0a 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69  .  int rc = sqli
93d0: 74 65 33 56 64 62 65 52 65 73 65 74 28 28 56 64  te3VdbeReset((Vd
93e0: 62 65 2a 29 70 53 74 6d 74 29 3b 0a 20 20 73 71  be*)pStmt);.  sq
93f0: 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61  lite3VdbeMakeRea
9400: 64 79 28 28 56 64 62 65 2a 29 70 53 74 6d 74 2c  dy((Vdbe*)pStmt,
9410: 20 2d 31 2c 20 30 29 3b 0a 20 20 72 65 74 75 72   -1, 0);.  retur
9420: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  n rc;.}../*.** R
9430: 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f  egister a new co
9440: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65  llation sequence
9450: 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61   with the databa
9460: 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f  se handle db..*/
9470: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65  .int sqlite3_cre
9480: 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20  ate_collation(. 
9490: 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20   sqlite3* db, . 
94a0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
94b0: 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20  me, .  int enc, 
94c0: 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20  .  void* pCtx,. 
94d0: 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28   int(*xCompare)(
94e0: 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20  void*,int,const 
94f0: 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20  void*,int,const 
9500: 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 43 6f 6c 6c  void*).){.  Coll
9510: 53 65 71 20 2a 70 43 6f 6c 6c 3b 0a 20 20 69 6e  Seq *pColl;.  in
9520: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
9530: 3b 0a 20 20 0a 20 20 2f 2a 20 49 66 20 53 51 4c  ;.  .  /* If SQL
9540: 49 54 45 5f 55 54 46 31 36 20 69 73 20 73 70 65  ITE_UTF16 is spe
9550: 63 69 66 69 65 64 20 61 73 20 74 68 65 20 65 6e  cified as the en
9560: 63 6f 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61  coding type, tra
9570: 6e 73 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a  nsform this.  **
9580: 20 74 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54   to one of SQLIT
9590: 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c  E_UTF16LE or SQL
95a0: 49 54 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e  ITE_UTF16BE usin
95b0: 67 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54  g the.  ** SQLIT
95c0: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61  E_UTF16NATIVE ma
95d0: 63 72 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31  cro. SQLITE_UTF1
95e0: 36 20 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e  6 is not used in
95f0: 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20  ternally..  */. 
9600: 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45   if( enc==SQLITE
9610: 5f 55 54 46 31 36 20 29 7b 0a 20 20 20 20 65 6e  _UTF16 ){.    en
9620: 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36  c = SQLITE_UTF16
9630: 4e 41 54 49 56 45 3b 0a 20 20 7d 0a 0a 20 20 69  NATIVE;.  }..  i
9640: 66 28 20 65 6e 63 21 3d 53 51 4c 49 54 45 5f 55  f( enc!=SQLITE_U
9650: 54 46 38 20 26 26 20 65 6e 63 21 3d 53 51 4c 49  TF8 && enc!=SQLI
9660: 54 45 5f 55 54 46 31 36 4c 45 20 26 26 20 65 6e  TE_UTF16LE && en
9670: 63 21 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 42  c!=SQLITE_UTF16B
9680: 45 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  E ){.    sqlite3
9690: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45  Error(db, SQLITE
96a0: 5f 45 52 52 4f 52 2c 20 0a 20 20 20 20 20 20 20  _ERROR, .       
96b0: 20 22 50 61 72 61 6d 20 33 20 74 6f 20 73 71 6c   "Param 3 to sql
96c0: 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c  ite3_create_coll
96d0: 61 74 69 6f 6e 28 29 20 6d 75 73 74 20 62 65 20  ation() must be 
96e0: 6f 6e 65 20 6f 66 20 22 0a 20 20 20 20 20 20 20  one of ".       
96f0: 20 22 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53   "SQLITE_UTF8, S
9700: 51 4c 49 54 45 5f 55 54 46 31 36 2c 20 53 51 4c  QLITE_UTF16, SQL
9710: 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53  ITE_UTF16LE or S
9720: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 22 0a 20  QLITE_UTF16BE". 
9730: 20 20 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e     );.    return
9740: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
9750: 20 7d 0a 20 20 70 43 6f 6c 6c 20 3d 20 73 71 6c   }.  pColl = sql
9760: 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28  ite3FindCollSeq(
9770: 64 62 2c 20 28 75 38 29 65 6e 63 2c 20 7a 4e 61  db, (u8)enc, zNa
9780: 6d 65 2c 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65  me, strlen(zName
9790: 29 2c 20 31 29 3b 0a 20 20 69 66 28 20 30 3d 3d  ), 1);.  if( 0==
97a0: 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 72 63 20 3d  pColl ){.   rc =
97b0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
97c0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43 6f 6c   }else{.    pCol
97d0: 6c 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d 70 61  l->xCmp = xCompa
97e0: 72 65 3b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 70  re;.    pColl->p
97f0: 55 73 65 72 20 3d 20 70 43 74 78 3b 0a 20 20 20  User = pCtx;.   
9800: 20 70 43 6f 6c 6c 2d 3e 65 6e 63 20 3d 20 65 6e   pColl->enc = en
9810: 63 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  c;.  }.  sqlite3
9820: 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 30 29  Error(db, rc, 0)
9830: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
9840: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72  ../*.** Register
9850: 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e   a new collation
9860: 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 74   sequence with t
9870: 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64  he database hand
9880: 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71  le db..*/.int sq
9890: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c  lite3_create_col
98a0: 6c 61 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69  lation16(.  sqli
98b0: 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73  te3* db, .  cons
98c0: 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a  t char *zName, .
98d0: 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f    int enc, .  vo
98e0: 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28  id* pCtx,.  int(
98f0: 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a  *xCompare)(void*
9900: 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a  ,int,const void*
9910: 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a  ,int,const void*
9920: 29 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73  ).){.  char cons
9930: 74 20 2a 7a 4e 61 6d 65 38 3b 0a 20 20 73 71 6c  t *zName8;.  sql
9940: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 54 6d 70  ite3_value *pTmp
9950: 20 3d 20 73 71 6c 69 74 65 33 47 65 74 54 72 61   = sqlite3GetTra
9960: 6e 73 69 65 6e 74 56 61 6c 75 65 28 64 62 29 3b  nsientValue(db);
9970: 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53  .  sqlite3ValueS
9980: 65 74 53 74 72 28 70 54 6d 70 2c 20 2d 31 2c 20  etStr(pTmp, -1, 
9990: 7a 4e 61 6d 65 2c 20 53 51 4c 49 54 45 5f 55 54  zName, SQLITE_UT
99a0: 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 54  F16NATIVE, SQLIT
99b0: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 4e 61  E_STATIC);.  zNa
99c0: 6d 65 38 20 3d 20 73 71 6c 69 74 65 33 56 61 6c  me8 = sqlite3Val
99d0: 75 65 54 65 78 74 28 70 54 6d 70 2c 20 53 51 4c  ueText(pTmp, SQL
99e0: 49 54 45 5f 55 54 46 38 29 3b 0a 20 20 72 65 74  ITE_UTF8);.  ret
99f0: 75 72 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61  urn sqlite3_crea
9a00: 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c  te_collation(db,
9a10: 20 7a 4e 61 6d 65 38 2c 20 65 6e 63 2c 20 70 43   zName8, enc, pC
9a20: 74 78 2c 20 78 43 6f 6d 70 61 72 65 29 3b 0a 7d  tx, xCompare);.}
9a30: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72  ../*.** Register
9a40: 20 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71   a collation seq
9a50: 75 65 6e 63 65 20 66 61 63 74 6f 72 79 20 63 61  uence factory ca
9a60: 6c 6c 62 61 63 6b 20 77 69 74 68 20 74 68 65 20  llback with the 
9a70: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a  database handle.
9a80: 2a 2a 20 64 62 2e 20 52 65 70 6c 61 63 65 20 61  ** db. Replace a
9a90: 6e 79 20 70 72 65 76 69 6f 75 73 6c 79 20 69 6e  ny previously in
9aa0: 73 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 74 69 6f  stalled collatio
9ab0: 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f  n sequence facto
9ac0: 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ry..*/.int sqlit
9ad0: 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65  e3_collation_nee
9ae0: 64 65 64 28 0a 20 20 73 71 6c 69 74 65 33 20 2a  ded(.  sqlite3 *
9af0: 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f  db, .  void *pCo
9b00: 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20 0a 20 20  llNeededArg, .  
9b10: 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65  void(*xCollNeede
9b20: 64 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33  d)(void*,sqlite3
9b30: 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63  *,int eTextRep,c
9b40: 6f 6e 73 74 20 63 68 61 72 2a 29 0a 29 7b 0a 20  onst char*).){. 
9b50: 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64   db->xCollNeeded
9b60: 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 65 64 3b 0a   = xCollNeeded;.
9b70: 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65    db->xCollNeede
9b80: 64 31 36 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 70  d16 = 0;.  db->p
9b90: 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 20 3d 20  CollNeededArg = 
9ba0: 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a  pCollNeededArg;.
9bb0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
9bc0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67  OK;.}../*.** Reg
9bd0: 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f  ister a collatio
9be0: 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f  n sequence facto
9bf0: 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68  ry callback with
9c00: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61   the database ha
9c10: 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c  ndle.** db. Repl
9c20: 61 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73  ace any previous
9c30: 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c  ly installed col
9c40: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20  lation sequence 
9c50: 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20  factory..*/.int 
9c60: 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f  sqlite3_collatio
9c70: 6e 5f 6e 65 65 64 65 64 31 36 28 0a 20 20 73 71  n_needed16(.  sq
9c80: 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f  lite3 *db, .  vo
9c90: 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41  id *pCollNeededA
9ca0: 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f  rg, .  void(*xCo
9cb0: 6c 6c 4e 65 65 64 65 64 31 36 29 28 76 6f 69 64  llNeeded16)(void
9cc0: 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65  *,sqlite3*,int e
9cd0: 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 76 6f  TextRep,const vo
9ce0: 69 64 2a 29 0a 29 7b 0a 20 20 64 62 2d 3e 78 43  id*).){.  db->xC
9cf0: 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 30 3b 0a 20  ollNeeded = 0;. 
9d00: 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64   db->xCollNeeded
9d10: 31 36 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 65 64  16 = xCollNeeded
9d20: 31 36 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e  16;.  db->pCollN
9d30: 65 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c  eededArg = pColl
9d40: 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 72 65 74  NeededArg;.  ret
9d50: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
9d60: 0a                                               .