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

Artifact 54ce5c19d64dd41381f92fa5e4610d9408c9b9a3:


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 32 38 20 32 30 30 34 2f 30 36  ,v 1.228 2004/06
0280: 2f 31 39 20 30 33 3a 33 33 3a 35 37 20 64 61 6e  /19 03:33:57 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 73 71 6c 69 74 65 33 53 65  ra){.  sqlite3Se
0520: 74 53 74 72 69 6e 67 28 70 44 61 74 61 2d 3e 70  tString(pData->p
0530: 7a 45 72 72 4d 73 67 2c 20 22 6d 61 6c 66 6f 72  zErrMsg, "malfor
0540: 6d 65 64 20 64 61 74 61 62 61 73 65 20 73 63 68  med database sch
0550: 65 6d 61 22 2c 0a 20 20 20 20 20 7a 45 78 74 72  ema",.     zExtr
0560: 61 21 3d 30 20 26 26 20 7a 45 78 74 72 61 5b 30  a!=0 && zExtra[0
0570: 5d 21 3d 30 20 3f 20 22 20 2d 20 22 20 3a 20 28  ]!=0 ? " - " : (
0580: 63 68 61 72 2a 29 30 2c 20 7a 45 78 74 72 61 2c  char*)0, zExtra,
0590: 20 28 63 68 61 72 2a 29 30 29 3b 0a 7d 0a 0a 2f   (char*)0);.}../
05a0: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65  *.** This is the
05b0: 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e   callback routin
05c0: 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65 20 74  e for the code t
05d0: 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 20  hat initializes 
05e0: 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e  the.** database.
05f0: 20 20 53 65 65 20 73 71 6c 69 74 65 33 49 6e 69    See sqlite3Ini
0600: 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20 61 64  t() below for ad
0610: 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61  ditional informa
0620: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68  tion..**.** Each
0630: 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69   callback contai
0640: 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ns the following
0650: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a   information:.**
0660: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 30 5d 20  .**     argv[0] 
0670: 3d 20 22 66 69 6c 65 2d 66 6f 72 6d 61 74 22 20  = "file-format" 
0680: 6f 72 20 22 73 63 68 65 6d 61 2d 63 6f 6f 6b 69  or "schema-cooki
0690: 65 22 20 6f 72 20 22 74 61 62 6c 65 22 20 6f 72  e" or "table" or
06a0: 20 22 69 6e 64 65 78 22 0a 2a 2a 20 20 20 20 20   "index".**     
06b0: 61 72 67 76 5b 31 5d 20 3d 20 74 61 62 6c 65 20  argv[1] = table 
06c0: 6f 72 20 69 6e 64 65 78 20 6e 61 6d 65 20 6f 72  or index name or
06d0: 20 6d 65 74 61 20 73 74 61 74 65 6d 65 6e 74 20   meta statement 
06e0: 74 79 70 65 2e 0a 2a 2a 20 20 20 20 20 61 72 67  type..**     arg
06f0: 76 5b 32 5d 20 3d 20 72 6f 6f 74 20 70 61 67 65  v[2] = root page
0700: 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 61 62 6c   number for tabl
0710: 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 4e 55 4c  e or index.  NUL
0720: 4c 20 66 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20 20  L for meta..**  
0730: 20 20 20 61 72 67 76 5b 33 5d 20 3d 20 53 51 4c     argv[3] = SQL
0740: 20 74 65 78 74 20 66 6f 72 20 61 20 43 52 45 41   text for a CREA
0750: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41  TE TABLE or CREA
0760: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65  TE INDEX stateme
0770: 6e 74 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  nt..**     argv[
0780: 34 5d 20 3d 20 22 31 22 20 66 6f 72 20 74 65 6d  4] = "1" for tem
0790: 70 6f 72 61 72 79 20 66 69 6c 65 73 2c 20 22 30  porary files, "0
07a0: 22 20 66 6f 72 20 6d 61 69 6e 20 64 61 74 61 62  " for main datab
07b0: 61 73 65 2c 20 22 32 22 20 6f 72 20 6d 6f 72 65  ase, "2" or more
07c0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
07d0: 20 20 66 6f 72 20 61 75 78 69 6c 69 61 72 79 20    for auxiliary 
07e0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e 0a  database files..
07f0: 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63 0a 69 6e 74  **.*/.static.int
0800: 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c   sqlite3InitCall
0810: 62 61 63 6b 28 76 6f 69 64 20 2a 70 49 6e 69 74  back(void *pInit
0820: 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61 72  , int argc, char
0830: 20 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a 2a   **argv, char **
0840: 61 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20 20 49 6e  azColName){.  In
0850: 69 74 44 61 74 61 20 2a 70 44 61 74 61 20 3d 20  itData *pData = 
0860: 28 49 6e 69 74 44 61 74 61 2a 29 70 49 6e 69 74  (InitData*)pInit
0870: 3b 0a 20 20 69 6e 74 20 6e 45 72 72 20 3d 20 30  ;.  int nErr = 0
0880: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 61 72 67  ;..  assert( arg
0890: 63 3d 3d 35 20 29 3b 0a 20 20 69 66 28 20 61 72  c==5 );.  if( ar
08a0: 67 76 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30  gv==0 ) return 0
08b0: 3b 20 20 20 2f 2a 20 4d 69 67 68 74 20 68 61 70  ;   /* Might hap
08c0: 70 65 6e 20 69 66 20 45 4d 50 54 59 5f 52 45 53  pen if EMPTY_RES
08d0: 55 4c 54 5f 43 41 4c 4c 42 41 43 4b 53 20 61 72  ULT_CALLBACKS ar
08e0: 65 20 6f 6e 20 2a 2f 0a 20 20 69 66 28 20 61 72  e on */.  if( ar
08f0: 67 76 5b 30 5d 3d 3d 30 20 29 7b 0a 20 20 20 20  gv[0]==0 ){.    
0900: 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44  corruptSchema(pD
0910: 61 74 61 2c 20 30 29 3b 0a 20 20 20 20 72 65 74  ata, 0);.    ret
0920: 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 73 77 69  urn 1;.  }.  swi
0930: 74 63 68 28 20 61 72 67 76 5b 30 5d 5b 30 5d 20  tch( argv[0][0] 
0940: 29 7b 0a 20 20 20 20 63 61 73 65 20 27 76 27 3a  ){.    case 'v':
0950: 0a 20 20 20 20 63 61 73 65 20 27 69 27 3a 0a 20  .    case 'i':. 
0960: 20 20 20 63 61 73 65 20 27 74 27 3a 20 7b 20 20     case 't': {  
0970: 2f 2a 20 43 52 45 41 54 45 20 54 41 42 4c 45 2c  /* CREATE TABLE,
0980: 20 43 52 45 41 54 45 20 49 4e 44 45 58 2c 20 6f   CREATE INDEX, o
0990: 72 20 43 52 45 41 54 45 20 56 49 45 57 20 73 74  r CREATE VIEW st
09a0: 61 74 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 20 20  atements */.    
09b0: 20 20 73 71 6c 69 74 65 20 2a 64 62 20 3d 20 70    sqlite *db = p
09c0: 44 61 74 61 2d 3e 64 62 3b 0a 20 20 20 20 20 20  Data->db;.      
09d0: 69 66 28 20 61 72 67 76 5b 32 5d 3d 3d 30 20 7c  if( argv[2]==0 |
09e0: 7c 20 61 72 67 76 5b 34 5d 3d 3d 30 20 29 7b 0a  | argv[4]==0 ){.
09f0: 20 20 20 20 20 20 20 20 63 6f 72 72 75 70 74 53          corruptS
0a00: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 30 29 3b  chema(pData, 0);
0a10: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
0a20: 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  1;.      }.     
0a30: 20 69 66 28 20 61 72 67 76 5b 33 5d 20 26 26 20   if( argv[3] && 
0a40: 61 72 67 76 5b 33 5d 5b 30 5d 20 29 7b 0a 20 20  argv[3][0] ){.  
0a50: 20 20 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68        /* Call th
0a60: 65 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63  e parser to proc
0a70: 65 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42  ess a CREATE TAB
0a80: 4c 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 45  LE, INDEX or VIE
0a90: 57 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 42 75  W..        ** Bu
0aa0: 74 20 62 65 63 61 75 73 65 20 64 62 2d 3e 69 6e  t because db->in
0ab0: 69 74 2e 62 75 73 79 20 69 73 20 73 65 74 20 74  it.busy is set t
0ac0: 6f 20 31 2c 20 6e 6f 20 56 44 42 45 20 63 6f 64  o 1, no VDBE cod
0ad0: 65 20 69 73 20 67 65 6e 65 72 61 74 65 64 0a 20  e is generated. 
0ae0: 20 20 20 20 20 20 20 2a 2a 20 6f 72 20 65 78 65         ** or exe
0af0: 63 75 74 65 64 2e 20 20 41 6c 6c 20 74 68 65 20  cuted.  All the 
0b00: 70 61 72 73 65 72 20 64 6f 65 73 20 69 73 20 62  parser does is b
0b10: 75 69 6c 64 20 74 68 65 20 69 6e 74 65 72 6e 61  uild the interna
0b20: 6c 20 64 61 74 61 0a 20 20 20 20 20 20 20 20 2a  l data.        *
0b30: 2a 20 73 74 72 75 63 74 75 72 65 73 20 74 68 61  * structures tha
0b40: 74 20 64 65 73 63 72 69 62 65 20 74 68 65 20 74  t describe the t
0b50: 61 62 6c 65 2c 20 69 6e 64 65 78 2c 20 6f 72 20  able, index, or 
0b60: 76 69 65 77 2e 0a 20 20 20 20 20 20 20 20 2a 2f  view..        */
0b70: 0a 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 7a  .        char *z
0b80: 45 72 72 3b 0a 20 20 20 20 20 20 20 20 61 73 73  Err;.        ass
0b90: 65 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75  ert( db->init.bu
0ba0: 73 79 20 29 3b 0a 20 20 20 20 20 20 20 20 64 62  sy );.        db
0bb0: 2d 3e 69 6e 69 74 2e 69 44 62 20 3d 20 61 74 6f  ->init.iDb = ato
0bc0: 69 28 61 72 67 76 5b 34 5d 29 3b 0a 20 20 20 20  i(argv[4]);.    
0bd0: 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e      assert( db->
0be0: 69 6e 69 74 2e 69 44 62 3e 3d 30 20 26 26 20 64  init.iDb>=0 && d
0bf0: 62 2d 3e 69 6e 69 74 2e 69 44 62 3c 64 62 2d 3e  b->init.iDb<db->
0c00: 6e 44 62 20 29 3b 0a 20 20 20 20 20 20 20 20 64  nDb );.        d
0c10: 62 2d 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20  b->init.newTnum 
0c20: 3d 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b  = atoi(argv[2]);
0c30: 0a 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c  .        if( sql
0c40: 69 74 65 33 5f 65 78 65 63 28 64 62 2c 20 61 72  ite3_exec(db, ar
0c50: 67 76 5b 33 5d 2c 20 30 2c 20 30 2c 20 26 7a 45  gv[3], 0, 0, &zE
0c60: 72 72 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20  rr) ){.         
0c70: 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70   corruptSchema(p
0c80: 44 61 74 61 2c 20 7a 45 72 72 29 3b 0a 20 20 20  Data, zErr);.   
0c90: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66         sqlite3_f
0ca0: 72 65 65 28 7a 45 72 72 29 3b 0a 20 20 20 20 20  ree(zErr);.     
0cb0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 64 62 2d     }.        db-
0cc0: 3e 69 6e 69 74 2e 69 44 62 20 3d 20 30 3b 0a 20  >init.iDb = 0;. 
0cd0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
0ce0: 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51      /* If the SQ
0cf0: 4c 20 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e  L column is blan
0d00: 6b 20 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20  k it means this 
0d10: 69 73 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74  is an index that
0d20: 0a 20 20 20 20 20 20 20 20 2a 2a 20 77 61 73 20  .        ** was 
0d30: 63 72 65 61 74 65 64 20 74 6f 20 62 65 20 74 68  created to be th
0d40: 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72  e PRIMARY KEY or
0d50: 20 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e   to fulfill a UN
0d60: 49 51 55 45 0a 20 20 20 20 20 20 20 20 2a 2a 20  IQUE.        ** 
0d70: 63 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 61  constraint for a
0d80: 20 43 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20   CREATE TABLE.  
0d90: 54 68 65 20 69 6e 64 65 78 20 73 68 6f 75 6c 64  The index should
0da0: 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20   have already.  
0db0: 20 20 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72        ** been cr
0dc0: 65 61 74 65 64 20 77 68 65 6e 20 77 65 20 70 72  eated when we pr
0dd0: 6f 63 65 73 73 65 64 20 74 68 65 20 43 52 45 41  ocessed the CREA
0de0: 54 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77  TE TABLE.  All w
0df0: 65 20 68 61 76 65 0a 20 20 20 20 20 20 20 20 2a  e have.        *
0e00: 2a 20 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20  * to do here is 
0e10: 72 65 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20  record the root 
0e20: 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20  page number for 
0e30: 74 68 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20  that index..    
0e40: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69      */.        i
0e50: 6e 74 20 69 44 62 3b 0a 20 20 20 20 20 20 20 20  nt iDb;.        
0e60: 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 0a 0a  Index *pIndex;..
0e70: 20 20 20 20 20 20 20 20 69 44 62 20 3d 20 61 74          iDb = at
0e80: 6f 69 28 61 72 67 76 5b 34 5d 29 3b 0a 20 20 20  oi(argv[4]);.   
0e90: 20 20 20 20 20 61 73 73 65 72 74 28 20 69 44 62       assert( iDb
0ea0: 3e 3d 30 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e  >=0 && iDb<db->n
0eb0: 44 62 20 29 3b 0a 20 20 20 20 20 20 20 20 70 49  Db );.        pI
0ec0: 6e 64 65 78 20 3d 20 73 71 6c 69 74 65 33 46 69  ndex = sqlite3Fi
0ed0: 6e 64 49 6e 64 65 78 28 64 62 2c 20 61 72 67 76  ndIndex(db, argv
0ee0: 5b 31 5d 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62  [1], db->aDb[iDb
0ef0: 5d 2e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20  ].zName);.      
0f00: 20 20 69 66 28 20 70 49 6e 64 65 78 3d 3d 30 20    if( pIndex==0 
0f10: 7c 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 21  || pIndex->tnum!
0f20: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  =0 ){.          
0f30: 2f 2a 20 54 68 69 73 20 63 61 6e 20 6f 63 63 75  /* This can occu
0f40: 72 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74  r if there exist
0f50: 73 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 61 20  s an index on a 
0f60: 54 45 4d 50 20 74 61 62 6c 65 20 77 68 69 63 68  TEMP table which
0f70: 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 68 61  .          ** ha
0f80: 73 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20  s the same name 
0f90: 61 73 20 61 6e 6f 74 68 65 72 20 69 6e 64 65 78  as another index
0fa0: 20 6f 6e 20 61 20 70 65 72 6d 61 6e 65 6e 74 20   on a permanent 
0fb0: 69 6e 64 65 78 2e 20 20 53 69 6e 63 65 0a 20 20  index.  Since.  
0fc0: 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 70          ** the p
0fd0: 65 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 20 69  ermanent table i
0fe0: 73 20 68 69 64 64 65 6e 20 62 79 20 74 68 65 20  s hidden by the 
0ff0: 54 45 4d 50 20 74 61 62 6c 65 2c 20 77 65 20 63  TEMP table, we c
1000: 61 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20 20 20  an also.        
1010: 20 20 2a 2a 20 73 61 66 65 6c 79 20 69 67 6e 6f    ** safely igno
1020: 72 65 20 74 68 65 20 69 6e 64 65 78 20 6f 6e 20  re the index on 
1030: 74 68 65 20 70 65 72 6d 61 6e 65 6e 74 20 74 61  the permanent ta
1040: 62 6c 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a  ble..          *
1050: 2f 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44  /.          /* D
1060: 6f 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b 0a 20 20  o Nothing */;.  
1070: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
1080: 20 20 20 20 20 20 20 70 49 6e 64 65 78 2d 3e 74         pIndex->t
1090: 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76 5b  num = atoi(argv[
10a0: 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  2]);.        }. 
10b0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 65       }.      bre
10c0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65  ak;.    }.    de
10d0: 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f  fault: {.      /
10e0: 2a 20 54 68 69 73 20 63 61 6e 20 6e 6f 74 20 68  * This can not h
10f0: 61 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20 20 20  appen! */.      
1100: 6e 45 72 72 20 3d 20 31 3b 0a 20 20 20 20 20 20  nErr = 1;.      
1110: 61 73 73 65 72 74 28 20 6e 45 72 72 3d 3d 30 20  assert( nErr==0 
1120: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  );.    }.  }.  r
1130: 65 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a 0a 2f  eturn nErr;.}../
1140: 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20  *.** Attempt to 
1150: 72 65 61 64 20 74 68 65 20 64 61 74 61 62 61 73  read the databas
1160: 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69 6e 69  e schema and ini
1170: 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e 61 6c  tialize internal
1180: 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74 75  .** data structu
1190: 72 65 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65  res for a single
11a0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20   database file. 
11b0: 20 54 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68   The index of th
11c0: 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69  e.** database fi
11d0: 6c 65 20 69 73 20 67 69 76 65 6e 20 62 79 20 69  le is given by i
11e0: 44 62 2e 20 20 69 44 62 3d 3d 30 20 69 73 20 75  Db.  iDb==0 is u
11f0: 73 65 64 20 66 6f 72 20 74 68 65 20 6d 61 69 6e  sed for the main
1200: 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20 69  .** database.  i
1210: 44 62 3d 3d 31 20 73 68 6f 75 6c 64 20 6e 65 76  Db==1 should nev
1220: 65 72 20 62 65 20 75 73 65 64 2e 20 20 69 44 62  er be used.  iDb
1230: 3e 3d 32 20 69 73 20 75 73 65 64 20 66 6f 72 0a  >=2 is used for.
1240: 2a 2a 20 61 75 78 69 6c 69 61 72 79 20 64 61 74  ** auxiliary dat
1250: 61 62 61 73 65 73 2e 20 20 52 65 74 75 72 6e 20  abases.  Return 
1260: 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54  one of the SQLIT
1270: 45 5f 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74  E_ error codes t
1280: 6f 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20 73 75  o.** indicate su
1290: 63 63 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65  ccess or failure
12a0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
12b0: 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28 73  sqlite3InitOne(s
12c0: 71 6c 69 74 65 20 2a 64 62 2c 20 69 6e 74 20 69  qlite *db, int i
12d0: 44 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  Db, char **pzErr
12e0: 4d 73 67 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  Msg){.  int rc;.
12f0: 20 20 42 74 43 75 72 73 6f 72 20 2a 63 75 72 4d    BtCursor *curM
1300: 61 69 6e 3b 0a 20 20 69 6e 74 20 73 69 7a 65 3b  ain;.  int size;
1310: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a  .  Table *pTab;.
1320: 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 61 7a    char const *az
1330: 41 72 67 5b 36 5d 3b 0a 20 20 63 68 61 72 20 7a  Arg[6];.  char z
1340: 44 62 4e 75 6d 5b 33 30 5d 3b 0a 20 20 69 6e 74  DbNum[30];.  int
1350: 20 6d 65 74 61 5b 31 30 5d 3b 0a 20 20 49 6e 69   meta[10];.  Ini
1360: 74 44 61 74 61 20 69 6e 69 74 44 61 74 61 3b 0a  tData initData;.
1370: 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4d    char const *zM
1380: 61 73 74 65 72 53 63 68 65 6d 61 3b 0a 20 20 63  asterSchema;.  c
1390: 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61 73 74  har const *zMast
13a0: 65 72 4e 61 6d 65 3b 0a 0a 20 20 2f 2a 0a 20 20  erName;..  /*.  
13b0: 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61  ** The master da
13c0: 74 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73  tabase table has
13d0: 20 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b   a structure lik
13e0: 65 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74  e this.  */.  st
13f0: 61 74 69 63 20 63 68 61 72 20 6d 61 73 74 65 72  atic char master
1400: 5f 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20  _schema[] = .   
1410: 20 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20    "CREATE TABLE 
1420: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 28 5c 6e  sqlite_master(\n
1430: 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 74  ".     "  type t
1440: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
1450: 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20  name text,\n".  
1460: 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 74     "  tbl_name t
1470: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
1480: 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72  rootpage integer
1490: 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 6c  ,\n".     "  sql
14a0: 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 29   text\n".     ")
14b0: 22 0a 20 20 3b 0a 20 20 73 74 61 74 69 63 20 63  ".  ;.  static c
14c0: 68 61 72 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f  har temp_master_
14d0: 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20  schema[] = .    
14e0: 20 22 43 52 45 41 54 45 20 54 45 4d 50 20 54 41   "CREATE TEMP TA
14f0: 42 4c 45 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f  BLE sqlite_temp_
1500: 6d 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20  master(\n".     
1510: 22 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22  "  type text,\n"
1520: 0a 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65  .     "  name te
1530: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74  xt,\n".     "  t
1540: 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22  bl_name text,\n"
1550: 0a 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67  .     "  rootpag
1560: 65 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20  e integer,\n".  
1570: 20 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e     "  sql text\n
1580: 22 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 0a  ".     ")".  ;..
1590: 20 20 61 73 73 65 72 74 28 20 69 44 62 3e 3d 30    assert( iDb>=0
15a0: 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e 44 62 20   && iDb<db->nDb 
15b0: 29 3b 0a 0a 20 20 2f 2a 20 7a 4d 61 73 74 65 72  );..  /* zMaster
15c0: 53 63 68 65 6d 61 20 61 6e 64 20 7a 49 6e 69 74  Schema and zInit
15d0: 53 63 72 69 70 74 20 61 72 65 20 73 65 74 20 74  Script are set t
15e0: 6f 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 6d  o point at the m
15f0: 61 73 74 65 72 20 73 63 68 65 6d 61 0a 20 20 2a  aster schema.  *
1600: 2a 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 73 61  * and initialisa
1610: 74 69 6f 6e 20 73 63 72 69 70 74 20 61 70 70 72  tion script appr
1620: 6f 70 72 69 61 74 65 20 66 6f 72 20 74 68 65 20  opriate for the 
1630: 64 61 74 61 62 61 73 65 20 62 65 69 6e 67 0a 20  database being. 
1640: 20 2a 2a 20 69 6e 69 74 69 61 6c 69 73 65 64 2e   ** initialised.
1650: 20 7a 4d 61 73 74 65 72 4e 61 6d 65 20 69 73 20   zMasterName is 
1660: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
1670: 6d 61 73 74 65 72 20 74 61 62 6c 65 2e 0a 20 20  master table..  
1680: 2a 2f 0a 20 20 69 66 28 20 69 44 62 3d 3d 31 20  */.  if( iDb==1 
1690: 29 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72 53 63  ){.    zMasterSc
16a0: 68 65 6d 61 20 3d 20 74 65 6d 70 5f 6d 61 73 74  hema = temp_mast
16b0: 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 20 20 7a  er_schema;.    z
16c0: 4d 61 73 74 65 72 4e 61 6d 65 20 3d 20 54 45 4d  MasterName = TEM
16d0: 50 5f 4d 41 53 54 45 52 5f 4e 41 4d 45 3b 0a 20  P_MASTER_NAME;. 
16e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 4d 61 73   }else{.    zMas
16f0: 74 65 72 53 63 68 65 6d 61 20 3d 20 6d 61 73 74  terSchema = mast
1700: 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 20 20 7a  er_schema;.    z
1710: 4d 61 73 74 65 72 4e 61 6d 65 20 3d 20 4d 41 53  MasterName = MAS
1720: 54 45 52 5f 4e 41 4d 45 3b 0a 20 20 7d 0a 0a 20  TER_NAME;.  }.. 
1730: 20 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74 68   /* Construct th
1740: 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 2e  e schema tables.
1750: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 53 61    */.  sqlite3Sa
1760: 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 61  fetyOff(db);.  a
1770: 7a 41 72 67 5b 30 5d 20 3d 20 22 74 61 62 6c 65  zArg[0] = "table
1780: 22 3b 0a 20 20 61 7a 41 72 67 5b 31 5d 20 3d 20  ";.  azArg[1] = 
1790: 7a 4d 61 73 74 65 72 4e 61 6d 65 3b 0a 20 20 61  zMasterName;.  a
17a0: 7a 41 72 67 5b 32 5d 20 3d 20 22 31 22 3b 0a 20  zArg[2] = "1";. 
17b0: 20 61 7a 41 72 67 5b 33 5d 20 3d 20 7a 4d 61 73   azArg[3] = zMas
17c0: 74 65 72 53 63 68 65 6d 61 3b 0a 20 20 73 70 72  terSchema;.  spr
17d0: 69 6e 74 66 28 7a 44 62 4e 75 6d 2c 20 22 25 64  intf(zDbNum, "%d
17e0: 22 2c 20 69 44 62 29 3b 0a 20 20 61 7a 41 72 67  ", iDb);.  azArg
17f0: 5b 34 5d 20 3d 20 7a 44 62 4e 75 6d 3b 0a 20 20  [4] = zDbNum;.  
1800: 61 7a 41 72 67 5b 35 5d 20 3d 20 30 3b 0a 20 20  azArg[5] = 0;.  
1810: 69 6e 69 74 44 61 74 61 2e 64 62 20 3d 20 64 62  initData.db = db
1820: 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 70 7a 45  ;.  initData.pzE
1830: 72 72 4d 73 67 20 3d 20 70 7a 45 72 72 4d 73 67  rrMsg = pzErrMsg
1840: 3b 0a 20 20 73 71 6c 69 74 65 33 49 6e 69 74 43  ;.  sqlite3InitC
1850: 61 6c 6c 62 61 63 6b 28 26 69 6e 69 74 44 61 74  allback(&initDat
1860: 61 2c 20 35 2c 20 28 63 68 61 72 20 2a 2a 29 61  a, 5, (char **)a
1870: 7a 41 72 67 2c 20 30 29 3b 0a 20 20 70 54 61 62  zArg, 0);.  pTab
1880: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 54 61   = sqlite3FindTa
1890: 62 6c 65 28 64 62 2c 20 7a 4d 61 73 74 65 72 4e  ble(db, zMasterN
18a0: 61 6d 65 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62  ame, db->aDb[iDb
18b0: 5d 2e 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20  ].zName);.  if( 
18c0: 70 54 61 62 20 29 7b 0a 20 20 20 20 70 54 61 62  pTab ){.    pTab
18d0: 2d 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a  ->readOnly = 1;.
18e0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 53 61 66    }.  sqlite3Saf
18f0: 65 74 79 4f 6e 28 64 62 29 3b 0a 0a 20 20 2f 2a  etyOn(db);..  /*
1900: 20 43 72 65 61 74 65 20 61 20 63 75 72 73 6f 72   Create a cursor
1910: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 64 61 74   to hold the dat
1920: 61 62 61 73 65 20 6f 70 65 6e 0a 20 20 2a 2f 0a  abase open.  */.
1930: 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 44    if( db->aDb[iD
1940: 62 5d 2e 70 42 74 3d 3d 30 20 29 20 72 65 74 75  b].pBt==0 ) retu
1950: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
1960: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
1970: 65 43 75 72 73 6f 72 28 64 62 2d 3e 61 44 62 5b  eCursor(db->aDb[
1980: 69 44 62 5d 2e 70 42 74 2c 20 4d 41 53 54 45 52  iDb].pBt, MASTER
1990: 5f 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 30 2c 20  _ROOT, 0, 0, 0, 
19a0: 26 63 75 72 4d 61 69 6e 29 3b 0a 20 20 69 66 28  &curMain);.  if(
19b0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc!=SQLITE_OK &
19c0: 26 20 72 63 21 3d 53 51 4c 49 54 45 5f 45 4d 50  & rc!=SQLITE_EMP
19d0: 54 59 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  TY ){.    sqlite
19e0: 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72  3SetString(pzErr
19f0: 4d 73 67 2c 20 73 71 6c 69 74 65 33 45 72 72 53  Msg, sqlite3ErrS
1a00: 74 72 28 72 63 29 2c 20 28 63 68 61 72 2a 29 30  tr(rc), (char*)0
1a10: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63  );.    return rc
1a20: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 47 65 74 20  ;.  }..  /* Get 
1a30: 74 68 65 20 64 61 74 61 62 61 73 65 20 6d 65 74  the database met
1a40: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 20  a information.. 
1a50: 20 2a 2a 0a 20 20 2a 2a 20 4d 65 74 61 20 76 61   **.  ** Meta va
1a60: 6c 75 65 73 20 61 72 65 20 61 73 20 66 6f 6c 6c  lues are as foll
1a70: 6f 77 73 3a 0a 20 20 2a 2a 20 20 20 20 6d 65 74  ows:.  **    met
1a80: 61 5b 30 5d 20 20 20 53 63 68 65 6d 61 20 63 6f  a[0]   Schema co
1a90: 6f 6b 69 65 2e 20 20 43 68 61 6e 67 65 73 20 77  okie.  Changes w
1aa0: 69 74 68 20 65 61 63 68 20 73 63 68 65 6d 61 20  ith each schema 
1ab0: 63 68 61 6e 67 65 2e 0a 20 20 2a 2a 20 20 20 20  change..  **    
1ac0: 6d 65 74 61 5b 31 5d 20 20 20 46 69 6c 65 20 66  meta[1]   File f
1ad0: 6f 72 6d 61 74 20 6f 66 20 73 63 68 65 6d 61 20  ormat of schema 
1ae0: 6c 61 79 65 72 2e 0a 20 20 2a 2a 20 20 20 20 6d  layer..  **    m
1af0: 65 74 61 5b 32 5d 20 20 20 53 69 7a 65 20 6f 66  eta[2]   Size of
1b00: 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 2e   the page cache.
1b10: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 33 5d  .  **    meta[3]
1b20: 20 20 20 53 79 6e 63 68 72 6f 6e 6f 75 73 20 73     Synchronous s
1b30: 65 74 74 69 6e 67 2e 20 20 31 3a 6f 66 66 2c 20  etting.  1:off, 
1b40: 32 3a 6e 6f 72 6d 61 6c 2c 20 33 3a 66 75 6c 6c  2:normal, 3:full
1b50: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34 5d  .  **    meta[4]
1b60: 20 20 20 44 62 20 74 65 78 74 20 65 6e 63 6f 64     Db text encod
1b70: 69 6e 67 2e 20 31 3a 55 54 46 2d 38 20 33 3a 55  ing. 1:UTF-8 3:U
1b80: 54 46 2d 31 36 20 4c 45 20 34 3a 55 54 46 2d 31  TF-16 LE 4:UTF-1
1b90: 36 20 42 45 0a 20 20 2a 2a 20 20 20 20 6d 65 74  6 BE.  **    met
1ba0: 61 5b 35 5d 20 20 20 50 72 61 67 6d 61 20 74 65  a[5]   Pragma te
1bb0: 6d 70 5f 73 74 6f 72 65 20 76 61 6c 75 65 2e 20  mp_store value. 
1bc0: 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e   See comments on
1bd0: 20 42 74 72 65 65 46 61 63 74 6f 72 79 0a 20 20   BtreeFactory.  
1be0: 2a 2a 20 20 20 20 6d 65 74 61 5b 36 5d 20 20 20  **    meta[6]   
1bf0: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 37 5d  .  **    meta[7]
1c00: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 38 5d  .  **    meta[8]
1c10: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 39 5d  .  **    meta[9]
1c20: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4e 6f 74 65 3a  .  **.  ** Note:
1c30: 20 54 68 65 20 68 61 73 68 20 64 65 66 69 6e 65   The hash define
1c40: 64 20 53 51 4c 49 54 45 5f 55 54 46 2a 20 73 79  d SQLITE_UTF* sy
1c50: 6d 62 6f 6c 73 20 69 6e 20 73 71 6c 69 74 65 49  mbols in sqliteI
1c60: 6e 74 2e 68 20 63 6f 72 72 65 73 70 6f 6e 64 20  nt.h correspond 
1c70: 74 6f 0a 20 20 2a 2a 20 74 68 65 20 70 6f 73 73  to.  ** the poss
1c80: 69 62 6c 65 20 76 61 6c 75 65 73 20 6f 66 20 6d  ible values of m
1c90: 65 74 61 5b 34 5d 2e 0a 20 20 2a 2f 0a 20 20 69  eta[4]..  */.  i
1ca0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
1cb0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20   ){.    int i;. 
1cc0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d     for(i=0; rc==
1cd0: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 73  SQLITE_OK && i<s
1ce0: 69 7a 65 6f 66 28 6d 65 74 61 29 2f 73 69 7a 65  izeof(meta)/size
1cf0: 6f 66 28 6d 65 74 61 5b 30 5d 29 3b 20 69 2b 2b  of(meta[0]); i++
1d00: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71  ){.      rc = sq
1d10: 6c 69 74 65 33 42 74 72 65 65 47 65 74 4d 65 74  lite3BtreeGetMet
1d20: 61 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70  a(db->aDb[iDb].p
1d30: 42 74 2c 20 69 2b 31 2c 20 26 6d 65 74 61 5b 69  Bt, i+1, &meta[i
1d40: 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  ]);.    }.    if
1d50: 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 73 71  ( rc ){.      sq
1d60: 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70  lite3SetString(p
1d70: 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 33  zErrMsg, sqlite3
1d80: 45 72 72 53 74 72 28 72 63 29 2c 20 28 63 68 61  ErrStr(rc), (cha
1d90: 72 2a 29 30 29 3b 0a 20 20 20 20 20 20 73 71 6c  r*)0);.      sql
1da0: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75  ite3BtreeCloseCu
1db0: 72 73 6f 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20  rsor(curMain);. 
1dc0: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
1dd0: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20      }.  }else{. 
1de0: 20 20 20 6d 65 6d 73 65 74 28 6d 65 74 61 2c 20     memset(meta, 
1df0: 30 2c 20 73 69 7a 65 6f 66 28 6d 65 74 61 29 29  0, sizeof(meta))
1e00: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b  ;.  }.  db->aDb[
1e10: 69 44 62 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f 6b  iDb].schema_cook
1e20: 69 65 20 3d 20 6d 65 74 61 5b 30 5d 3b 0a 0a 20  ie = meta[0];.. 
1e30: 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20 61   /* If opening a
1e40: 20 6e 6f 6e 2d 65 6d 70 74 79 20 64 61 74 61 62   non-empty datab
1e50: 61 73 65 2c 20 63 68 65 63 6b 20 74 68 65 20 74  ase, check the t
1e60: 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20 46 6f  ext encoding. Fo
1e70: 72 20 74 68 65 0a 20 20 2a 2a 20 6d 61 69 6e 20  r the.  ** main 
1e80: 64 61 74 61 62 61 73 65 2c 20 73 65 74 20 73 71  database, set sq
1e90: 6c 69 74 65 33 2e 65 6e 63 20 74 6f 20 74 68 65  lite3.enc to the
1ea0: 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20 74 68 65   encoding of the
1eb0: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2e 0a   main database..
1ec0: 20 20 2a 2a 20 46 6f 72 20 61 6e 20 61 74 74 61    ** For an atta
1ed0: 63 68 65 64 20 64 62 2c 20 69 74 20 69 73 20 61  ched db, it is a
1ee0: 6e 20 65 72 72 6f 72 20 69 66 20 74 68 65 20 65  n error if the e
1ef0: 6e 63 6f 64 69 6e 67 20 69 73 20 6e 6f 74 20 74  ncoding is not t
1f00: 68 65 20 73 61 6d 65 0a 20 20 2a 2a 20 61 73 20  he same.  ** as 
1f10: 73 71 6c 69 74 65 33 2e 65 6e 63 2e 0a 20 20 2a  sqlite3.enc..  *
1f20: 2f 0a 20 20 69 66 28 20 6d 65 74 61 5b 34 5d 20  /.  if( meta[4] 
1f30: 29 7b 20 20 2f 2a 20 74 65 78 74 20 65 6e 63 6f  ){  /* text enco
1f40: 64 69 6e 67 20 2a 2f 0a 20 20 20 20 69 66 28 20  ding */.    if( 
1f50: 69 44 62 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  iDb==0 ){.      
1f60: 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20 74 68  /* If opening th
1f70: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2c  e main database,
1f80: 20 73 65 74 20 64 62 2d 3e 65 6e 63 2e 20 2a 2f   set db->enc. */
1f90: 0a 20 20 20 20 20 20 64 62 2d 3e 65 6e 63 20 3d  .      db->enc =
1fa0: 20 28 75 38 29 6d 65 74 61 5b 34 5d 3b 0a 20 20   (u8)meta[4];.  
1fb0: 20 20 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c      db->pDfltCol
1fc0: 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43  l = sqlite3FindC
1fd0: 6f 6c 6c 53 65 71 28 64 62 2c 20 64 62 2d 3e 65  ollSeq(db, db->e
1fe0: 6e 63 2c 20 22 42 49 4e 41 52 59 22 2c 20 36 2c  nc, "BINARY", 6,
1ff0: 20 30 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a   0);.    }else{.
2000: 20 20 20 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e        /* If open
2010: 69 6e 67 20 61 6e 20 61 74 74 61 63 68 65 64 20  ing an attached 
2020: 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 65 6e  database, the en
2030: 63 6f 64 69 6e 67 20 6d 75 63 68 20 6d 61 74 63  coding much matc
2040: 68 20 64 62 2d 3e 65 6e 63 20 2a 2f 0a 20 20 20  h db->enc */.   
2050: 20 20 20 69 66 28 20 6d 65 74 61 5b 34 5d 21 3d     if( meta[4]!=
2060: 64 62 2d 3e 65 6e 63 20 29 7b 0a 20 20 20 20 20  db->enc ){.     
2070: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
2080: 6c 6f 73 65 43 75 72 73 6f 72 28 63 75 72 4d 61  loseCursor(curMa
2090: 69 6e 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  in);.        sql
20a0: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a  ite3SetString(pz
20b0: 45 72 72 4d 73 67 2c 20 22 61 74 74 61 63 68 65  ErrMsg, "attache
20c0: 64 20 64 61 74 61 62 61 73 65 73 20 6d 75 73 74  d databases must
20d0: 20 75 73 65 20 74 68 65 20 73 61 6d 65 22 0a 20   use the same". 
20e0: 20 20 20 20 20 20 20 20 20 20 20 22 20 74 65 78             " tex
20f0: 74 20 65 6e 63 6f 64 69 6e 67 20 61 73 20 6d 61  t encoding as ma
2100: 69 6e 20 64 61 74 61 62 61 73 65 22 2c 20 28 63  in database", (c
2110: 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 20 20 20  har*)0);.       
2120: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
2130: 52 52 4f 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20  RROR;.      }.  
2140: 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 69    }.  }..  if( i
2150: 44 62 3d 3d 30 20 29 7b 0a 20 20 20 20 73 69 7a  Db==0 ){.    siz
2160: 65 20 3d 20 6d 65 74 61 5b 32 5d 3b 0a 20 20 20  e = meta[2];.   
2170: 20 69 66 28 20 73 69 7a 65 3d 3d 30 20 29 7b 20   if( size==0 ){ 
2180: 73 69 7a 65 20 3d 20 4d 41 58 5f 50 41 47 45 53  size = MAX_PAGES
2190: 3b 20 7d 0a 20 20 20 20 64 62 2d 3e 63 61 63 68  ; }.    db->cach
21a0: 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a 20  e_size = size;. 
21b0: 20 20 20 64 62 2d 3e 73 61 66 65 74 79 5f 6c 65     db->safety_le
21c0: 76 65 6c 20 3d 20 6d 65 74 61 5b 33 5d 3b 0a 20  vel = meta[3];. 
21d0: 20 20 20 69 66 28 20 6d 65 74 61 5b 35 5d 3e 30     if( meta[5]>0
21e0: 20 26 26 20 6d 65 74 61 5b 35 5d 3c 3d 32 20 26   && meta[5]<=2 &
21f0: 26 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65  & db->temp_store
2200: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 64 62 2d  ==0 ){.      db-
2210: 3e 74 65 6d 70 5f 73 74 6f 72 65 20 3d 20 6d 65  >temp_store = me
2220: 74 61 5b 35 5d 3b 0a 20 20 20 20 7d 0a 20 20 20  ta[5];.    }.   
2230: 20 69 66 28 20 64 62 2d 3e 73 61 66 65 74 79 5f   if( db->safety_
2240: 6c 65 76 65 6c 3d 3d 30 20 29 20 64 62 2d 3e 73  level==0 ) db->s
2250: 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 32 3b  afety_level = 2;
2260: 0a 0a 20 20 20 20 2f 2a 20 46 49 58 20 4d 45 3a  ..    /* FIX ME:
2270: 20 45 76 65 72 79 20 73 74 72 75 63 74 20 44 62   Every struct Db
2280: 20 77 69 6c 6c 20 6e 65 65 64 20 61 20 6e 65 78   will need a nex
2290: 74 5f 63 6f 6f 6b 69 65 20 2a 2f 0a 20 20 20 20  t_cookie */.    
22a0: 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b 69 65 20  db->next_cookie 
22b0: 3d 20 6d 65 74 61 5b 30 5d 3b 0a 20 20 20 20 64  = meta[0];.    d
22c0: 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d  b->file_format =
22d0: 20 6d 65 74 61 5b 31 5d 3b 0a 20 20 20 20 69 66   meta[1];.    if
22e0: 28 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61  ( db->file_forma
22f0: 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a  t==0 ){.      /*
2300: 20 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 66   This happens if
2310: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77 61   the database wa
2320: 73 20 69 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74  s initially empt
2330: 79 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 66  y */.      db->f
2340: 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a  ile_format = 1;.
2350: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 0a      }.  }..  /*.
2360: 20 20 2a 2a 20 20 66 69 6c 65 5f 66 6f 72 6d 61    **  file_forma
2370: 74 3d 3d 31 20 20 20 20 56 65 72 73 69 6f 6e 20  t==1    Version 
2380: 33 2e 30 2e 30 2e 0a 20 20 2a 2f 0a 20 20 69 66  3.0.0..  */.  if
2390: 28 20 6d 65 74 61 5b 31 5d 3e 31 20 29 7b 0a 20  ( meta[1]>1 ){. 
23a0: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
23b0: 6c 6f 73 65 43 75 72 73 6f 72 28 63 75 72 4d 61  loseCursor(curMa
23c0: 69 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  in);.    sqlite3
23d0: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d  SetString(pzErrM
23e0: 73 67 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64  sg, "unsupported
23f0: 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c 20 28   file format", (
2400: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 65  char*)0);.    re
2410: 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f  turn SQLITE_ERRO
2420: 52 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65  R;.  }..  sqlite
2430: 33 42 74 72 65 65 53 65 74 43 61 63 68 65 53 69  3BtreeSetCacheSi
2440: 7a 65 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e  ze(db->aDb[iDb].
2450: 70 42 74 2c 20 64 62 2d 3e 63 61 63 68 65 5f 73  pBt, db->cache_s
2460: 69 7a 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 42  ize);.  sqlite3B
2470: 74 72 65 65 53 65 74 53 61 66 65 74 79 4c 65 76  treeSetSafetyLev
2480: 65 6c 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e  el(db->aDb[iDb].
2490: 70 42 74 2c 20 6d 65 74 61 5b 33 5d 3d 3d 30 20  pBt, meta[3]==0 
24a0: 3f 20 32 20 3a 20 6d 65 74 61 5b 33 5d 29 3b 0a  ? 2 : meta[3]);.
24b0: 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73  .  /* Read the s
24c0: 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f  chema informatio
24d0: 6e 20 6f 75 74 20 6f 66 20 74 68 65 20 73 63 68  n out of the sch
24e0: 65 6d 61 20 74 61 62 6c 65 73 0a 20 20 2a 2f 0a  ema tables.  */.
24f0: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e    assert( db->in
2500: 69 74 2e 62 75 73 79 20 29 3b 0a 20 20 69 66 28  it.busy );.  if(
2510: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45 4d 50 54   rc==SQLITE_EMPT
2520: 59 20 29 7b 0a 20 20 20 20 2f 2a 20 46 6f 72 20  Y ){.    /* For 
2530: 61 6e 20 65 6d 70 74 79 20 64 61 74 61 62 61 73  an empty databas
2540: 65 2c 20 74 68 65 72 65 20 69 73 20 6e 6f 74 68  e, there is noth
2550: 69 6e 67 20 74 6f 20 72 65 61 64 20 2a 2f 0a 20  ing to read */. 
2560: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f     rc = SQLITE_O
2570: 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  K;.  }else{.    
2580: 63 68 61 72 20 2a 7a 53 71 6c 20 3d 20 30 3b 0a  char *zSql = 0;.
2590: 20 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74      sqlite3Safet
25a0: 79 4f 66 66 28 64 62 29 3b 0a 20 20 20 20 73 71  yOff(db);.    sq
25b0: 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 26  lite3SetString(&
25c0: 7a 53 71 6c 2c 20 0a 20 20 20 20 20 20 20 20 22  zSql, .        "
25d0: 53 45 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d  SELECT type, nam
25e0: 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c  e, rootpage, sql
25f0: 2c 20 22 2c 20 7a 44 62 4e 75 6d 2c 20 22 20 46  , ", zDbNum, " F
2600: 52 4f 4d 20 5c 22 22 2c 0a 20 20 20 20 20 20 20  ROM \"",.       
2610: 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e   db->aDb[iDb].zN
2620: 61 6d 65 2c 20 22 5c 22 2e 22 2c 20 7a 4d 61 73  ame, "\".", zMas
2630: 74 65 72 4e 61 6d 65 2c 20 28 63 68 61 72 2a 29  terName, (char*)
2640: 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  0);.    rc = sql
2650: 69 74 65 33 5f 65 78 65 63 28 64 62 2c 20 7a 53  ite3_exec(db, zS
2660: 71 6c 2c 20 73 71 6c 69 74 65 33 49 6e 69 74 43  ql, sqlite3InitC
2670: 61 6c 6c 62 61 63 6b 2c 20 26 69 6e 69 74 44 61  allback, &initDa
2680: 74 61 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69  ta, 0);.    sqli
2690: 74 65 46 72 65 65 28 7a 53 71 6c 29 3b 0a 20 20  teFree(zSql);.  
26a0: 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f    sqlite3SafetyO
26b0: 6e 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74  n(db);.    sqlit
26c0: 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73  e3BtreeCloseCurs
26d0: 6f 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 7d  or(curMain);.  }
26e0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 6d  .  if( sqlite3_m
26f0: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a  alloc_failed ){.
2700: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
2710: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22  ring(pzErrMsg, "
2720: 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20  out of memory", 
2730: 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72  (char*)0);.    r
2740: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
2750: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 73  ;.    sqlite3Res
2760: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61  etInternalSchema
2770: 28 64 62 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69  (db, 0);.  }.  i
2780: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
2790: 20 29 7b 0a 20 20 20 20 44 62 53 65 74 50 72 6f   ){.    DbSetPro
27a0: 70 65 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44  perty(db, iDb, D
27b0: 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b  B_SchemaLoaded);
27c0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71  .  }else{.    sq
27d0: 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e  lite3ResetIntern
27e0: 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 69 44 62  alSchema(db, iDb
27f0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
2800: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69  rc;.}../*.** Ini
2810: 74 69 61 6c 69 7a 65 20 61 6c 6c 20 64 61 74 61  tialize all data
2820: 62 61 73 65 20 66 69 6c 65 73 20 2d 20 74 68 65  base files - the
2830: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 66   main database f
2840: 69 6c 65 2c 20 74 68 65 20 66 69 6c 65 0a 2a 2a  ile, the file.**
2850: 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74   used to store t
2860: 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 73 2c  emporary tables,
2870: 20 61 6e 64 20 61 6e 79 20 61 64 64 69 74 69 6f   and any additio
2880: 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c  nal database fil
2890: 65 73 0a 2a 2a 20 63 72 65 61 74 65 64 20 75 73  es.** created us
28a0: 69 6e 67 20 41 54 54 41 43 48 20 73 74 61 74 65  ing ATTACH state
28b0: 6d 65 6e 74 73 2e 20 20 52 65 74 75 72 6e 20 61  ments.  Return a
28c0: 20 73 75 63 63 65 73 73 20 63 6f 64 65 2e 20 20   success code.  
28d0: 49 66 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 20 6f  If an.** error o
28e0: 63 63 75 72 73 2c 20 77 72 69 74 65 20 61 6e 20  ccurs, write an 
28f0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 6e  error message in
2900: 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a 2a 2a  to *pzErrMsg..**
2910: 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20 64 61  .** After the da
2920: 74 61 62 61 73 65 20 69 73 20 69 6e 69 74 69 61  tabase is initia
2930: 6c 69 7a 65 64 2c 20 74 68 65 20 53 51 4c 49 54  lized, the SQLIT
2940: 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 0a 2a 2a  E_Initialized.**
2950: 20 62 69 74 20 69 73 20 73 65 74 20 69 6e 20 74   bit is set in t
2960: 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20 6f  he flags field o
2970: 66 20 74 68 65 20 73 71 6c 69 74 65 20 73 74 72  f the sqlite str
2980: 75 63 74 75 72 65 2e 20 0a 2a 2f 0a 69 6e 74 20  ucture. .*/.int 
2990: 73 71 6c 69 74 65 33 49 6e 69 74 28 73 71 6c 69  sqlite3Init(sqli
29a0: 74 65 20 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70  te *db, char **p
29b0: 7a 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20  zErrMsg){.  int 
29c0: 69 2c 20 72 63 3b 0a 20 20 0a 20 20 69 66 28 20  i, rc;.  .  if( 
29d0: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 20  db->init.busy ) 
29e0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
29f0: 3b 0a 20 20 61 73 73 65 72 74 28 20 28 64 62 2d  ;.  assert( (db-
2a00: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
2a10: 49 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20  Initialized)==0 
2a20: 29 3b 0a 20 20 72 63 20 3d 20 53 51 4c 49 54 45  );.  rc = SQLITE
2a30: 5f 4f 4b 3b 0a 20 20 64 62 2d 3e 69 6e 69 74 2e  _OK;.  db->init.
2a40: 62 75 73 79 20 3d 20 31 3b 0a 20 20 66 6f 72 28  busy = 1;.  for(
2a50: 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f  i=0; rc==SQLITE_
2a60: 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b  OK && i<db->nDb;
2a70: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 44   i++){.    if( D
2a80: 62 48 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c  bHasProperty(db,
2a90: 20 69 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61   i, DB_SchemaLoa
2aa0: 64 65 64 29 20 7c 7c 20 69 3d 3d 31 20 29 20 63  ded) || i==1 ) c
2ab0: 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 72 63 20  ontinue;.    rc 
2ac0: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65  = sqlite3InitOne
2ad0: 28 64 62 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67  (db, i, pzErrMsg
2ae0: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b  );.    if( rc ){
2af0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 65  .      sqlite3Re
2b00: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
2b10: 61 28 64 62 2c 20 69 29 3b 0a 20 20 20 20 7d 0a  a(db, i);.    }.
2b20: 20 20 7d 0a 0a 20 20 2f 2a 20 4f 6e 63 65 20 61    }..  /* Once a
2b30: 6c 6c 20 74 68 65 20 6f 74 68 65 72 20 64 61 74  ll the other dat
2b40: 61 62 61 73 65 73 20 68 61 76 65 20 62 65 65 6e  abases have been
2b50: 20 69 6e 69 74 69 61 6c 69 73 65 64 2c 20 6c 6f   initialised, lo
2b60: 61 64 20 74 68 65 20 73 63 68 65 6d 61 0a 20 20  ad the schema.  
2b70: 2a 2a 20 66 6f 72 20 74 68 65 20 54 45 4d 50 20  ** for the TEMP 
2b80: 64 61 74 61 62 61 73 65 2e 20 54 68 69 73 20 69  database. This i
2b90: 73 20 6c 6f 61 64 65 64 20 6c 61 73 74 2c 20 61  s loaded last, a
2ba0: 73 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 62  s the TEMP datab
2bb0: 61 73 65 0a 20 20 2a 2a 20 73 63 68 65 6d 61 20  ase.  ** schema 
2bc0: 6d 61 79 20 63 6f 6e 74 61 69 6e 20 72 65 66 65  may contain refe
2bd0: 72 65 6e 63 65 73 20 74 6f 20 6f 62 6a 65 63 74  rences to object
2be0: 73 20 69 6e 20 6f 74 68 65 72 20 64 61 74 61 62  s in other datab
2bf0: 61 73 65 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ases..  */.  if(
2c00: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
2c10: 26 20 64 62 2d 3e 6e 44 62 3e 31 20 26 26 20 21  & db->nDb>1 && !
2c20: 44 62 48 61 73 50 72 6f 70 65 72 74 79 28 64 62  DbHasProperty(db
2c30: 2c 20 31 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f  , 1, DB_SchemaLo
2c40: 61 64 65 64 29 20 29 7b 0a 20 20 20 20 72 63 20  aded) ){.    rc 
2c50: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65  = sqlite3InitOne
2c60: 28 64 62 2c 20 31 2c 20 70 7a 45 72 72 4d 73 67  (db, 1, pzErrMsg
2c70: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b  );.    if( rc ){
2c80: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 65  .      sqlite3Re
2c90: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
2ca0: 61 28 64 62 2c 20 31 29 3b 0a 20 20 20 20 7d 0a  a(db, 1);.    }.
2cb0: 20 20 7d 0a 0a 20 20 64 62 2d 3e 69 6e 69 74 2e    }..  db->init.
2cc0: 62 75 73 79 20 3d 20 30 3b 0a 20 20 69 66 28 20  busy = 0;.  if( 
2cd0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
2ce0: 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c  .    db->flags |
2cf0: 3d 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c  = SQLITE_Initial
2d00: 69 7a 65 64 3b 0a 20 20 20 20 73 71 6c 69 74 65  ized;.    sqlite
2d10: 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43  3CommitInternalC
2d20: 68 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a  hanges(db);.  }.
2d30: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  .  if( rc!=SQLIT
2d40: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e  E_OK ){.    db->
2d50: 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45  flags &= ~SQLITE
2d60: 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 20 20  _Initialized;.  
2d70: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  }.  return rc;.}
2d80: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
2d90: 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 20  tine is a no-op 
2da0: 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  if the database 
2db0: 73 63 68 65 6d 61 20 69 73 20 61 6c 72 65 61 64  schema is alread
2dc0: 79 20 69 6e 69 74 69 61 6c 69 73 65 64 2e 0a 2a  y initialised..*
2dd0: 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65  * Otherwise, the
2de0: 20 73 63 68 65 6d 61 20 69 73 20 6c 6f 61 64 65   schema is loade
2df0: 64 2e 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 65  d. An error code
2e00: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f   is returned..*/
2e10: 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 61 64  .int sqlite3Read
2e20: 53 63 68 65 6d 61 28 73 71 6c 69 74 65 20 2a 64  Schema(sqlite *d
2e30: 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d  b, char **pzErrM
2e40: 73 67 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20  sg){.  int rc = 
2e50: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66  SQLITE_OK;..  if
2e60: 28 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79  ( !db->init.busy
2e70: 20 29 7b 0a 20 20 20 20 69 66 28 20 28 64 62 2d   ){.    if( (db-
2e80: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
2e90: 49 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20  Initialized)==0 
2ea0: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71  ){.      rc = sq
2eb0: 6c 69 74 65 33 49 6e 69 74 28 64 62 2c 20 70 7a  lite3Init(db, pz
2ec0: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 7d 0a 20  ErrMsg);.    }. 
2ed0: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 72 63 21   }.  assert( rc!
2ee0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 64  =SQLITE_OK || (d
2ef0: 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54  b->flags & SQLIT
2f00: 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 7c 7c  E_Initialized)||
2f10: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b  db->init.busy );
2f20: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
2f30: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76 65 72 73 69  ./*.** The versi
2f40: 6f 6e 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72  on of the librar
2f50: 79 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20  y.*/.const char 
2f60: 72 63 73 69 64 33 5b 5d 20 3d 20 22 40 28 23 29  rcsid3[] = "@(#)
2f70: 20 5c 30 34 34 49 64 3a 20 53 51 4c 69 74 65 20   \044Id: SQLite 
2f80: 76 65 72 73 69 6f 6e 20 22 20 53 51 4c 49 54 45  version " SQLITE
2f90: 5f 56 45 52 53 49 4f 4e 20 22 20 24 22 3b 0a 63  _VERSION " $";.c
2fa0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
2fb0: 33 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51  3_version[] = SQ
2fc0: 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f  LITE_VERSION;../
2fd0: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65  *.** This is the
2fe0: 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69   default collati
2ff0: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65  ng function name
3000: 64 20 22 42 49 4e 41 52 59 22 20 77 68 69 63 68  d "BINARY" which
3010: 20 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 61 76   is always.** av
3020: 61 69 6c 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74  ailable..*/.stat
3030: 69 63 20 69 6e 74 20 62 69 6e 61 72 79 43 6f 6c  ic int binaryCol
3040: 6c 61 74 69 6e 67 46 75 6e 63 28 0a 20 20 76 6f  latingFunc(.  vo
3050: 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a 20 20 69  id *NotUsed,.  i
3060: 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20  nt nKey1, const 
3070: 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69  void *pKey1,.  i
3080: 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20  nt nKey2, const 
3090: 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20  void *pKey2.){. 
30a0: 20 69 6e 74 20 72 63 2c 20 6e 3b 0a 20 20 6e 20   int rc, n;.  n 
30b0: 3d 20 6e 4b 65 79 31 3c 6e 4b 65 79 32 20 3f 20  = nKey1<nKey2 ? 
30c0: 6e 4b 65 79 31 20 3a 20 6e 4b 65 79 32 3b 0a 20  nKey1 : nKey2;. 
30d0: 20 72 63 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65   rc = memcmp(pKe
30e0: 79 31 2c 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20  y1, pKey2, n);. 
30f0: 20 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20   if( rc==0 ){.  
3100: 20 20 72 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e    rc = nKey1 - n
3110: 4b 65 79 32 3b 0a 20 20 7d 0a 20 20 72 65 74 75  Key2;.  }.  retu
3120: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
3130: 41 6e 6f 74 68 65 72 20 62 75 69 6c 74 2d 69 6e  Another built-in
3140: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65   collating seque
3150: 6e 63 65 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a 2a  nce: NOCASE. .**
3160: 0a 2a 2a 20 54 68 69 73 20 63 6f 6c 6c 61 74 69  .** This collati
3170: 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 69  ng sequence is i
3180: 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73  ntended to be us
3190: 65 64 20 66 6f 72 20 22 63 61 73 65 20 69 6e 64  ed for "case ind
31a0: 65 70 65 6e 64 61 6e 74 0a 2a 2a 20 63 6f 6d 70  ependant.** comp
31b0: 61 72 69 73 6f 6e 22 2e 20 53 51 4c 69 74 65 27  arison". SQLite'
31c0: 73 20 6b 6e 6f 77 6c 65 64 67 65 20 6f 66 20 75  s knowledge of u
31d0: 70 70 65 72 20 61 6e 64 20 6c 6f 77 65 72 20 63  pper and lower c
31e0: 61 73 65 20 65 71 75 69 76 61 6c 65 6e 74 73 0a  ase equivalents.
31f0: 2a 2a 20 65 78 74 65 6e 64 73 20 6f 6e 6c 79 20  ** extends only 
3200: 74 6f 20 74 68 65 20 32 36 20 63 68 61 72 61 63  to the 26 charac
3210: 74 65 72 73 20 75 73 65 64 20 69 6e 20 74 68 65  ters used in the
3220: 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67   English languag
3230: 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 20  e..**.** At the 
3240: 6d 6f 6d 65 6e 74 20 74 68 65 72 65 20 69 73 20  moment there is 
3250: 6f 6e 6c 79 20 61 20 55 54 46 2d 38 20 69 6d 70  only a UTF-8 imp
3260: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a  lementation..*/.
3270: 73 74 61 74 69 63 20 69 6e 74 20 6e 6f 63 61 73  static int nocas
3280: 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 28 0a  eCollatingFunc(.
3290: 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c    void *NotUsed,
32a0: 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f  .  int nKey1, co
32b0: 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c  nst void *pKey1,
32c0: 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f  .  int nKey2, co
32d0: 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a  nst void *pKey2.
32e0: 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 73 71 6c  ){.  int r = sql
32f0: 69 74 65 33 53 74 72 4e 49 43 6d 70 28 0a 20 20  ite3StrNICmp(.  
3300: 20 20 20 20 28 63 6f 6e 73 74 20 63 68 61 72 20      (const char 
3310: 2a 29 70 4b 65 79 31 2c 20 28 63 6f 6e 73 74 20  *)pKey1, (const 
3320: 63 68 61 72 20 2a 29 70 4b 65 79 32 2c 20 28 6e  char *)pKey2, (n
3330: 4b 65 79 31 3e 6e 4b 65 79 32 29 3f 6e 4b 65 79  Key1>nKey2)?nKey
3340: 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 69 66 28 20  1:nKey2);.  if( 
3350: 30 3d 3d 72 20 29 7b 0a 20 20 20 20 72 20 3d 20  0==r ){.    r = 
3360: 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d  nKey1-nKey2;.  }
3370: 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a  .  return r;.}..
3380: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
3390: 20 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6d 6f   ROWID of the mo
33a0: 73 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74  st recent insert
33b0: 0a 2a 2f 0a 6c 6f 6e 67 20 6c 6f 6e 67 20 69 6e  .*/.long long in
33c0: 74 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69  t sqlite3_last_i
33d0: 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69  nsert_rowid(sqli
33e0: 74 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72  te *db){.  retur
33f0: 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b  n db->lastRowid;
3400: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
3410: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63   the number of c
3420: 68 61 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f  hanges in the mo
3430: 73 74 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74  st recent call t
3440: 6f 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29  o sqlite3_exec()
3450: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
3460: 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 20  _changes(sqlite 
3470: 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64  *db){.  return d
3480: 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f  b->nChange;.}../
3490: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
34a0: 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65  number of change
34b0: 73 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68  s produced by th
34c0: 65 20 6c 61 73 74 20 49 4e 53 45 52 54 2c 20 55  e last INSERT, U
34d0: 50 44 41 54 45 2c 20 6f 72 0a 2a 2a 20 44 45 4c  PDATE, or.** DEL
34e0: 45 54 45 20 73 74 61 74 65 6d 65 6e 74 20 74 6f  ETE statement to
34f0: 20 63 6f 6d 70 6c 65 74 65 20 65 78 65 63 75 74   complete execut
3500: 69 6f 6e 2e 20 54 68 65 20 63 6f 75 6e 74 20 64  ion. The count d
3510: 6f 65 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 0a  oes not include.
3520: 2a 2a 20 63 68 61 6e 67 65 73 20 64 75 65 20 74  ** changes due t
3530: 6f 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73  o SQL statements
3540: 20 65 78 65 63 75 74 65 64 20 69 6e 20 74 72 69   executed in tri
3550: 67 67 65 72 20 70 72 6f 67 72 61 6d 73 20 74 68  gger programs th
3560: 61 74 20 77 65 72 65 0a 2a 2a 20 74 72 69 67 67  at were.** trigg
3570: 65 72 65 64 20 62 79 20 74 68 61 74 20 73 74 61  ered by that sta
3580: 74 65 6d 65 6e 74 0a 2a 2f 0a 69 6e 74 20 73 71  tement.*/.int sq
3590: 6c 69 74 65 33 5f 6c 61 73 74 5f 73 74 61 74 65  lite3_last_state
35a0: 6d 65 6e 74 5f 63 68 61 6e 67 65 73 28 73 71 6c  ment_changes(sql
35b0: 69 74 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75  ite *db){.  retu
35c0: 72 6e 20 64 62 2d 3e 6c 73 43 68 61 6e 67 65 3b  rn db->lsChange;
35d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20  .}../*.** Close 
35e0: 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69  an existing SQLi
35f0: 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 69  te database.*/.i
3600: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65  nt sqlite3_close
3610: 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20  (sqlite *db){.  
3620: 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 69  HashElem *i;.  i
3630: 6e 74 20 6a 3b 0a 0a 20 20 69 66 28 20 21 64 62  nt j;..  if( !db
3640: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
3650: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20  QLITE_OK;.  }.. 
3660: 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65   /* If there are
3670: 20 61 6e 79 20 6f 75 74 73 74 61 6e 64 69 6e 67   any outstanding
3680: 20 56 4d 73 2c 20 72 65 74 75 72 6e 20 53 51 4c   VMs, return SQL
3690: 49 54 45 5f 42 55 53 59 2e 20 2a 2f 0a 20 20 69  ITE_BUSY. */.  i
36a0: 66 28 20 64 62 2d 3e 70 56 64 62 65 20 29 7b 0a  f( db->pVdbe ){.
36b0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
36c0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59  (db, SQLITE_BUSY
36d0: 2c 20 0a 20 20 20 20 20 20 20 20 22 55 6e 61 62  , .        "Unab
36e0: 6c 65 20 74 6f 20 63 6c 6f 73 65 20 64 75 65 20  le to close due 
36f0: 74 6f 20 75 6e 66 69 6e 61 6c 69 73 65 64 20 73  to unfinalised s
3700: 74 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20  tatements");.   
3710: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42   return SQLITE_B
3720: 55 53 59 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72  USY;.  }.  asser
3730: 74 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74  t( !sqlite3Safet
3740: 79 43 68 65 63 6b 28 64 62 29 20 29 3b 0a 0a 20  yCheck(db) );.. 
3750: 20 2f 2a 20 46 49 58 20 4d 45 3a 20 64 62 2d 3e   /* FIX ME: db->
3760: 6d 61 67 69 63 20 6d 61 79 20 62 65 20 73 65 74  magic may be set
3770: 20 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49 43   to SQLITE_MAGIC
3780: 5f 43 4c 4f 53 45 44 20 69 66 20 74 68 65 20 64  _CLOSED if the d
3790: 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 63 61 6e  atabase.  ** can
37a0: 6e 6f 74 20 62 65 20 6f 70 65 6e 65 64 20 66 6f  not be opened fo
37b0: 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2e 20 53  r some reason. S
37c0: 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 6e  o this routine n
37d0: 65 65 64 73 20 74 6f 20 72 75 6e 20 69 6e 0a 20  eeds to run in. 
37e0: 20 2a 2a 20 74 68 61 74 20 63 61 73 65 2e 20 42   ** that case. B
37f0: 75 74 20 6d 61 79 62 65 20 74 68 65 72 65 20 73  ut maybe there s
3800: 68 6f 75 6c 64 20 62 65 20 61 6e 20 65 78 74 72  hould be an extr
3810: 61 20 6d 61 67 69 63 20 76 61 6c 75 65 20 66 6f  a magic value fo
3820: 72 20 74 68 65 0a 20 20 2a 2a 20 22 66 61 69 6c  r the.  ** "fail
3830: 65 64 20 74 6f 20 6f 70 65 6e 22 20 73 74 61 74  ed to open" stat
3840: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62  e..  */.  if( db
3850: 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f  ->magic!=SQLITE_
3860: 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 26 26 20  MAGIC_CLOSED && 
3870: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
3880: 64 62 29 20 29 7b 0a 20 20 20 20 2f 2a 20 70 72  db) ){.    /* pr
3890: 69 6e 74 66 28 22 44 49 44 20 4e 4f 54 20 43 4c  intf("DID NOT CL
38a0: 4f 53 45 5c 6e 22 29 3b 20 66 66 6c 75 73 68 28  OSE\n"); fflush(
38b0: 73 74 64 6f 75 74 29 3b 20 2a 2f 0a 20 20 20 20  stdout); */.    
38c0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52  return SQLITE_ER
38d0: 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 28  ROR;.  }..  for(
38e0: 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20  j=0; j<db->nDb; 
38f0: 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74  j++){.    struct
3900: 20 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e   Db *pDb = &db->
3910: 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20  aDb[j];.    if( 
3920: 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20  pDb->pBt ){.    
3930: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c    sqlite3BtreeCl
3940: 6f 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20  ose(pDb->pBt);. 
3950: 20 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20       pDb->pBt = 
3960: 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73  0;.    }.  }.  s
3970: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72  qlite3ResetInter
3980: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29  nalSchema(db, 0)
3990: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e  ;.  assert( db->
39a0: 6e 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65  nDb<=2 );.  asse
39b0: 72 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d  rt( db->aDb==db-
39c0: 3e 61 44 62 53 74 61 74 69 63 20 29 3b 0a 20 20  >aDbStatic );.  
39d0: 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68  for(i=sqliteHash
39e0: 46 69 72 73 74 28 26 64 62 2d 3e 61 46 75 6e 63  First(&db->aFunc
39f0: 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61  ); i; i=sqliteHa
3a00: 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20  shNext(i)){.    
3a10: 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c 20  FuncDef *pFunc, 
3a20: 2a 70 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72 28  *pNext;.    for(
3a30: 70 46 75 6e 63 20 3d 20 28 46 75 6e 63 44 65 66  pFunc = (FuncDef
3a40: 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61  *)sqliteHashData
3a50: 28 69 29 3b 20 70 46 75 6e 63 3b 20 70 46 75 6e  (i); pFunc; pFun
3a60: 63 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20  c=pNext){.      
3a70: 70 4e 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e 70  pNext = pFunc->p
3a80: 4e 65 78 74 3b 0a 20 20 20 20 20 20 73 71 6c 69  Next;.      sqli
3a90: 74 65 46 72 65 65 28 70 46 75 6e 63 29 3b 0a 20  teFree(pFunc);. 
3aa0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 66 6f 72 28     }.  }..  for(
3ab0: 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73  i=sqliteHashFirs
3ac0: 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29  t(&db->aCollSeq)
3ad0: 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73  ; i; i=sqliteHas
3ae0: 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43  hNext(i)){.    C
3af0: 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20  ollSeq *pColl = 
3b00: 28 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74  (CollSeq *)sqlit
3b10: 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20  eHashData(i);.  
3b20: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 43 6f    sqliteFree(pCo
3b30: 6c 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  ll);.  }.  sqlit
3b40: 65 33 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d  e3HashClear(&db-
3b50: 3e 61 43 6f 6c 6c 53 65 71 29 3b 0a 0a 20 20 73  >aCollSeq);..  s
3b60: 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28  qlite3HashClear(
3b70: 26 64 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 73  &db->aFunc);.  s
3b80: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
3b90: 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 2f  SQLITE_OK, 0); /
3ba0: 2a 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 6e  * Deallocates an
3bb0: 79 20 63 61 63 68 65 64 20 65 72 72 6f 72 20 73  y cached error s
3bc0: 74 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 28  trings. */.  if(
3bd0: 20 64 62 2d 3e 70 56 61 6c 75 65 20 29 7b 0a 20   db->pValue ){. 
3be0: 20 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46     sqlite3ValueF
3bf0: 72 65 65 28 64 62 2d 3e 70 56 61 6c 75 65 29 3b  ree(db->pValue);
3c00: 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 70  .  }.  if( db->p
3c10: 45 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  Err ){.    sqlit
3c20: 65 33 56 61 6c 75 65 46 72 65 65 28 64 62 2d 3e  e3ValueFree(db->
3c30: 70 45 72 72 29 3b 0a 20 20 7d 0a 0a 20 20 64 62  pErr);.  }..  db
3c40: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
3c50: 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 20 20  _MAGIC_ERROR;.  
3c60: 73 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b 0a  sqliteFree(db);.
3c70: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
3c80: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c  OK;.}../*.** Rol
3c90: 6c 62 61 63 6b 20 61 6c 6c 20 64 61 74 61 62 61  lback all databa
3ca0: 73 65 20 66 69 6c 65 73 2e 0a 2a 2f 0a 76 6f 69  se files..*/.voi
3cb0: 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63  d sqlite3Rollbac
3cc0: 6b 41 6c 6c 28 73 71 6c 69 74 65 20 2a 64 62 29  kAll(sqlite *db)
3cd0: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72  {.  int i;.  for
3ce0: 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b  (i=0; i<db->nDb;
3cf0: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 64   i++){.    if( d
3d00: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 20 29 7b  b->aDb[i].pBt ){
3d10: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74  .      sqlite3Bt
3d20: 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e  reeRollback(db->
3d30: 61 44 62 5b 69 5d 2e 70 42 74 29 3b 0a 20 20 20  aDb[i].pBt);.   
3d40: 20 20 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 6e     db->aDb[i].in
3d50: 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 20 20 7d  Trans = 0;.    }
3d60: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 52 65  .  }.  sqlite3Re
3d70: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
3d80: 61 28 64 62 2c 20 30 29 3b 0a 20 20 2f 2a 20 73  a(db, 0);.  /* s
3d90: 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 49 6e  qlite3RollbackIn
3da0: 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62  ternalChanges(db
3db0: 29 3b 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  ); */.}../*.** R
3dc0: 65 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73  eturn a static s
3dd0: 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72  tring that descr
3de0: 69 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66  ibes the kind of
3df0: 20 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64   error specified
3e00: 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d   in the.** argum
3e10: 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68  ent..*/.const ch
3e20: 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53 74  ar *sqlite3ErrSt
3e30: 72 28 69 6e 74 20 72 63 29 7b 0a 20 20 63 6f 6e  r(int rc){.  con
3e40: 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 73 77  st char *z;.  sw
3e50: 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20 20 20  itch( rc ){.    
3e60: 63 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a 20  case SQLITE_OK: 
3e70: 20 20 20 20 20 20 20 20 7a 20 3d 20 22 6e 6f 74          z = "not
3e80: 20 61 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20   an error";     
3e90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3ea0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
3eb0: 63 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52 4f  case SQLITE_ERRO
3ec0: 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 53 51 4c  R:      z = "SQL
3ed0: 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72 20   logic error or 
3ee0: 6d 69 73 73 69 6e 67 20 64 61 74 61 62 61 73 65  missing database
3ef0: 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20  ";   break;.    
3f00: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45  case SQLITE_INTE
3f10: 52 4e 41 4c 3a 20 20 20 7a 20 3d 20 22 69 6e 74  RNAL:   z = "int
3f20: 65 72 6e 61 6c 20 53 51 4c 69 74 65 20 69 6d 70  ernal SQLite imp
3f30: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66 6c 61 77  lementation flaw
3f40: 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20  ";   break;.    
3f50: 63 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52 4d  case SQLITE_PERM
3f60: 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61 63 63  :       z = "acc
3f70: 65 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 20 64  ess permission d
3f80: 65 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20 20  enied";         
3f90: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
3fa0: 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52  case SQLITE_ABOR
3fb0: 54 3a 20 20 20 20 20 20 7a 20 3d 20 22 63 61 6c  T:      z = "cal
3fc0: 6c 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 20  lback requested 
3fd0: 71 75 65 72 79 20 61 62 6f 72 74 22 3b 20 20 20  query abort";   
3fe0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
3ff0: 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59  case SQLITE_BUSY
4000: 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74  :       z = "dat
4010: 61 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22  abase is locked"
4020: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
4030: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4040: 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b  case SQLITE_LOCK
4050: 45 44 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74  ED:     z = "dat
4060: 61 62 61 73 65 20 74 61 62 6c 65 20 69 73 20 6c  abase table is l
4070: 6f 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20  ocked";         
4080: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4090: 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  case SQLITE_NOME
40a0: 4d 3a 20 20 20 20 20 20 7a 20 3d 20 22 6f 75 74  M:      z = "out
40b0: 20 6f 66 20 6d 65 6d 6f 72 79 22 3b 20 20 20 20   of memory";    
40c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
40d0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
40e0: 63 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44  case SQLITE_READ
40f0: 4f 4e 4c 59 3a 20 20 20 7a 20 3d 20 22 61 74 74  ONLY:   z = "att
4100: 65 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61 20  empt to write a 
4110: 72 65 61 64 6f 6e 6c 79 20 64 61 74 61 62 61 73  readonly databas
4120: 65 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20  e";  break;.    
4130: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45  case SQLITE_INTE
4140: 52 52 55 50 54 3a 20 20 7a 20 3d 20 22 69 6e 74  RRUPT:  z = "int
4150: 65 72 72 75 70 74 65 64 22 3b 20 20 20 20 20 20  errupted";      
4160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4170: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4180: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52  case SQLITE_IOER
4190: 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 64 69 73  R:      z = "dis
41a0: 6b 20 49 2f 4f 20 65 72 72 6f 72 22 3b 20 20 20  k I/O error";   
41b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
41c0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
41d0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52  case SQLITE_CORR
41e0: 55 50 54 3a 20 20 20 20 7a 20 3d 20 22 64 61 74  UPT:    z = "dat
41f0: 61 62 61 73 65 20 64 69 73 6b 20 69 6d 61 67 65  abase disk image
4200: 20 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22 3b 20   is malformed"; 
4210: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4220: 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 46  case SQLITE_NOTF
4230: 4f 55 4e 44 3a 20 20 20 7a 20 3d 20 22 74 61 62  OUND:   z = "tab
4240: 6c 65 20 6f 72 20 72 65 63 6f 72 64 20 6e 6f 74  le or record not
4250: 20 66 6f 75 6e 64 22 3b 20 20 20 20 20 20 20 20   found";        
4260: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4270: 63 61 73 65 20 53 51 4c 49 54 45 5f 46 55 4c 4c  case SQLITE_FULL
4280: 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74  :       z = "dat
4290: 61 62 61 73 65 20 69 73 20 66 75 6c 6c 22 3b 20  abase is full"; 
42a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
42b0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
42c0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e 54  case SQLITE_CANT
42d0: 4f 50 45 4e 3a 20 20 20 7a 20 3d 20 22 75 6e 61  OPEN:   z = "una
42e0: 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61  ble to open data
42f0: 62 61 73 65 20 66 69 6c 65 22 3b 20 20 20 20 20  base file";     
4300: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4310: 63 61 73 65 20 53 51 4c 49 54 45 5f 50 52 4f 54  case SQLITE_PROT
4320: 4f 43 4f 4c 3a 20 20 20 7a 20 3d 20 22 64 61 74  OCOL:   z = "dat
4330: 61 62 61 73 65 20 6c 6f 63 6b 69 6e 67 20 70 72  abase locking pr
4340: 6f 74 6f 63 6f 6c 20 66 61 69 6c 75 72 65 22 3b  otocol failure";
4350: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4360: 63 61 73 65 20 53 51 4c 49 54 45 5f 45 4d 50 54  case SQLITE_EMPT
4370: 59 3a 20 20 20 20 20 20 7a 20 3d 20 22 74 61 62  Y:      z = "tab
4380: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 64  le contains no d
4390: 61 74 61 22 3b 20 20 20 20 20 20 20 20 20 20 20  ata";           
43a0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
43b0: 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 48 45  case SQLITE_SCHE
43c0: 4d 41 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74  MA:     z = "dat
43d0: 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73  abase schema has
43e0: 20 63 68 61 6e 67 65 64 22 3b 20 20 20 20 20 20   changed";      
43f0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4400: 63 61 73 65 20 53 51 4c 49 54 45 5f 54 4f 4f 42  case SQLITE_TOOB
4410: 49 47 3a 20 20 20 20 20 7a 20 3d 20 22 74 6f 6f  IG:     z = "too
4420: 20 6d 75 63 68 20 64 61 74 61 20 66 6f 72 20 6f   much data for o
4430: 6e 65 20 74 61 62 6c 65 20 72 6f 77 22 3b 20 20  ne table row";  
4440: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4450: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53  case SQLITE_CONS
4460: 54 52 41 49 4e 54 3a 20 7a 20 3d 20 22 63 6f 6e  TRAINT: z = "con
4470: 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 3b  straint failed";
4480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4490: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
44a0: 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 4d  case SQLITE_MISM
44b0: 41 54 43 48 3a 20 20 20 7a 20 3d 20 22 64 61 74  ATCH:   z = "dat
44c0: 61 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22 3b  atype mismatch";
44d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
44e0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
44f0: 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 55  case SQLITE_MISU
4500: 53 45 3a 20 20 20 20 20 7a 20 3d 20 22 6c 69 62  SE:     z = "lib
4510: 72 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c  rary routine cal
4520: 6c 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65  led out of seque
4530: 6e 63 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20  nce";break;.    
4540: 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46  case SQLITE_NOLF
4550: 53 3a 20 20 20 20 20 20 7a 20 3d 20 22 6b 65 72  S:      z = "ker
4560: 6e 65 6c 20 6c 61 63 6b 73 20 6c 61 72 67 65 20  nel lacks large 
4570: 66 69 6c 65 20 73 75 70 70 6f 72 74 22 3b 20 20  file support";  
4580: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4590: 63 61 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48  case SQLITE_AUTH
45a0: 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61 75 74  :       z = "aut
45b0: 68 6f 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69 65  horization denie
45c0: 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  d";             
45d0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
45e0: 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d  case SQLITE_FORM
45f0: 41 54 3a 20 20 20 20 20 7a 20 3d 20 22 61 75 78  AT:     z = "aux
4600: 69 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 20  iliary database 
4610: 66 6f 72 6d 61 74 20 65 72 72 6f 72 22 3b 20 20  format error";  
4620: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4630: 63 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47  case SQLITE_RANG
4640: 45 3a 20 20 20 20 20 20 7a 20 3d 20 22 62 69 6e  E:      z = "bin
4650: 64 20 69 6e 64 65 78 20 6f 75 74 20 6f 66 20 72  d index out of r
4660: 61 6e 67 65 22 3b 20 20 20 20 20 20 20 20 20 20  ange";          
4670: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4680: 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 41  case SQLITE_NOTA
4690: 44 42 3a 20 20 20 20 20 7a 20 3d 20 22 66 69 6c  DB:     z = "fil
46a0: 65 20 69 73 20 65 6e 63 72 79 70 74 65 64 20 6f  e is encrypted o
46b0: 72 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61 62  r is not a datab
46c0: 61 73 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20  ase";break;.    
46d0: 64 65 66 61 75 6c 74 3a 20 20 20 20 20 20 20 20  default:        
46e0: 20 20 20 20 20 20 20 20 7a 20 3d 20 22 75 6e 6b          z = "unk
46f0: 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 20 20 20 20  nown error";    
4700: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4710: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a       break;.  }.
4720: 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f    return z;.}../
4730: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
4740: 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62  e implements a b
4750: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61  usy callback tha
4760: 74 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69  t sleeps and tri
4770: 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69  es.** again unti
4780: 6c 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75  l a timeout valu
4790: 65 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 54  e is reached.  T
47a0: 68 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65  he timeout value
47b0: 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65   is.** an intege
47c0: 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c  r number of mill
47d0: 69 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20  iseconds passed 
47e0: 69 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 0a  in as the first.
47f0: 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a  ** argument..*/.
4800: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
4810: 65 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c  eDefaultBusyCall
4820: 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a 54 69 6d  back(. void *Tim
4830: 65 6f 75 74 2c 20 20 20 20 20 20 20 20 20 20 20  eout,           
4840: 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e  /* Maximum amoun
4850: 74 20 6f 66 20 74 69 6d 65 20 74 6f 20 77 61 69  t of time to wai
4860: 74 20 2a 2f 0a 20 69 6e 74 20 63 6f 75 6e 74 20  t */. int count 
4870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
4880: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65  * Number of time
4890: 73 20 74 61 62 6c 65 20 68 61 73 20 62 65 65 6e  s table has been
48a0: 20 62 75 73 79 20 2a 2f 0a 29 7b 0a 23 69 66 20   busy */.){.#if 
48b0: 53 51 4c 49 54 45 5f 4d 49 4e 5f 53 4c 45 45 50  SQLITE_MIN_SLEEP
48c0: 5f 4d 53 3d 3d 31 0a 20 20 73 74 61 74 69 63 20  _MS==1.  static 
48d0: 63 6f 6e 73 74 20 63 68 61 72 20 64 65 6c 61 79  const char delay
48e0: 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 31 2c 20  s[] =.     { 1, 
48f0: 32 2c 20 35 2c 20 31 30 2c 20 31 35 2c 20 32 30  2, 5, 10, 15, 20
4900: 2c 20 32 35 2c 20 32 35 2c 20 20 32 35 2c 20 20  , 25, 25,  25,  
4910: 35 30 2c 20 20 35 30 2c 20 20 35 30 2c 20 31 30  50,  50,  50, 10
4920: 30 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e  0};.  static con
4930: 73 74 20 73 68 6f 72 74 20 69 6e 74 20 74 6f 74  st short int tot
4940: 61 6c 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 30  als[] =.     { 0
4950: 2c 20 31 2c 20 33 2c 20 20 38 2c 20 31 38 2c 20  , 1, 3,  8, 18, 
4960: 33 33 2c 20 35 33 2c 20 37 38 2c 20 31 30 33 2c  33, 53, 78, 103,
4970: 20 31 32 38 2c 20 31 37 38 2c 20 32 32 38 2c 20   128, 178, 228, 
4980: 32 38 37 7d 3b 0a 23 20 64 65 66 69 6e 65 20 4e  287};.# define N
4990: 44 45 4c 41 59 20 28 73 69 7a 65 6f 66 28 64 65  DELAY (sizeof(de
49a0: 6c 61 79 73 29 2f 73 69 7a 65 6f 66 28 64 65 6c  lays)/sizeof(del
49b0: 61 79 73 5b 30 5d 29 29 0a 20 20 69 6e 74 20 74  ays[0])).  int t
49c0: 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54 69  imeout = (int)Ti
49d0: 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 64 65 6c  meout;.  int del
49e0: 61 79 2c 20 70 72 69 6f 72 3b 0a 0a 20 20 69 66  ay, prior;..  if
49f0: 28 20 63 6f 75 6e 74 20 3c 3d 20 4e 44 45 4c 41  ( count <= NDELA
4a00: 59 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d  Y ){.    delay =
4a10: 20 64 65 6c 61 79 73 5b 63 6f 75 6e 74 2d 31 5d   delays[count-1]
4a20: 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f  ;.    prior = to
4a30: 74 61 6c 73 5b 63 6f 75 6e 74 2d 31 5d 3b 0a 20  tals[count-1];. 
4a40: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 65 6c 61   }else{.    dela
4a50: 79 20 3d 20 64 65 6c 61 79 73 5b 4e 44 45 4c 41  y = delays[NDELA
4a60: 59 2d 31 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20  Y-1];.    prior 
4a70: 3d 20 74 6f 74 61 6c 73 5b 4e 44 45 4c 41 59 2d  = totals[NDELAY-
4a80: 31 5d 20 2b 20 64 65 6c 61 79 2a 28 63 6f 75 6e  1] + delay*(coun
4a90: 74 2d 4e 44 45 4c 41 59 2d 31 29 3b 0a 20 20 7d  t-NDELAY-1);.  }
4aa0: 0a 20 20 69 66 28 20 70 72 69 6f 72 20 2b 20 64  .  if( prior + d
4ab0: 65 6c 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 29  elay > timeout )
4ac0: 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 74 69  {.    delay = ti
4ad0: 6d 65 6f 75 74 20 2d 20 70 72 69 6f 72 3b 0a 20  meout - prior;. 
4ae0: 20 20 20 69 66 28 20 64 65 6c 61 79 3c 3d 30 20     if( delay<=0 
4af0: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a  ) return 0;.  }.
4b00: 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70    sqlite3OsSleep
4b10: 28 64 65 6c 61 79 29 3b 0a 20 20 72 65 74 75 72  (delay);.  retur
4b20: 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74  n 1;.#else.  int
4b30: 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29   timeout = (int)
4b40: 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20 28  Timeout;.  if( (
4b50: 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20  count+1)*1000 > 
4b60: 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 72  timeout ){.    r
4b70: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73  eturn 0;.  }.  s
4b80: 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 31 30  qlite3OsSleep(10
4b90: 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b  00);.  return 1;
4ba0: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a  .#endif.}../*.**
4bb0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65   This routine se
4bc0: 74 73 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c  ts the busy call
4bd0: 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69  back for an Sqli
4be0: 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74  te database to t
4bf0: 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c  he.** given call
4c00: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69  back function wi
4c10: 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67  th the given arg
4c20: 75 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ument..*/.void s
4c30: 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64  qlite3_busy_hand
4c40: 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a 64  ler(.  sqlite *d
4c50: 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79  b,.  int (*xBusy
4c60: 29 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a 20 20  )(void*,int),.  
4c70: 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20  void *pArg.){.  
4c80: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e  db->busyHandler.
4c90: 78 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a 20  xFunc = xBusy;. 
4ca0: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72   db->busyHandler
4cb0: 2e 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d 0a  .pArg = pArg;.}.
4cc0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
4cd0: 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 5f 43 41  OMIT_PROGRESS_CA
4ce0: 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 54 68 69  LLBACK./*.** Thi
4cf0: 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74  s routine sets t
4d00: 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c  he progress call
4d10: 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69  back for an Sqli
4d20: 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74  te database to t
4d30: 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c  he.** given call
4d40: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69  back function wi
4d50: 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67  th the given arg
4d60: 75 6d 65 6e 74 2e 20 54 68 65 20 70 72 6f 67 72  ument. The progr
4d70: 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 77 69 6c  ess callback wil
4d80: 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64 20  l.** be invoked 
4d90: 65 76 65 72 79 20 6e 4f 70 73 20 6f 70 63 6f 64  every nOps opcod
4da0: 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  es..*/.void sqli
4db0: 74 65 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e  te3_progress_han
4dc0: 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a  dler(.  sqlite *
4dd0: 64 62 2c 20 0a 20 20 69 6e 74 20 6e 4f 70 73 2c  db, .  int nOps,
4de0: 0a 20 20 69 6e 74 20 28 2a 78 50 72 6f 67 72 65  .  int (*xProgre
4df0: 73 73 29 28 76 6f 69 64 2a 29 2c 20 0a 20 20 76  ss)(void*), .  v
4e00: 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 69  oid *pArg.){.  i
4e10: 66 28 20 6e 4f 70 73 3e 30 20 29 7b 0a 20 20 20  f( nOps>0 ){.   
4e20: 20 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d   db->xProgress =
4e30: 20 78 50 72 6f 67 72 65 73 73 3b 0a 20 20 20 20   xProgress;.    
4e40: 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73  db->nProgressOps
4e50: 20 3d 20 6e 4f 70 73 3b 0a 20 20 20 20 64 62 2d   = nOps;.    db-
4e60: 3e 70 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20  >pProgressArg = 
4e70: 70 41 72 67 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  pArg;.  }else{. 
4e80: 20 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 73 73     db->xProgress
4e90: 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 6e 50   = 0;.    db->nP
4ea0: 72 6f 67 72 65 73 73 4f 70 73 20 3d 20 30 3b 0a  rogressOps = 0;.
4eb0: 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73      db->pProgres
4ec0: 73 41 72 67 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a  sArg = 0;.  }.}.
4ed0: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54  #endif.../*.** T
4ee0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6e 73 74  his routine inst
4ef0: 61 6c 6c 73 20 61 20 64 65 66 61 75 6c 74 20 62  alls a default b
4f00: 75 73 79 20 68 61 6e 64 6c 65 72 20 74 68 61 74  usy handler that
4f10: 20 77 61 69 74 73 20 66 6f 72 20 74 68 65 0a 2a   waits for the.*
4f20: 2a 20 73 70 65 63 69 66 69 65 64 20 6e 75 6d 62  * specified numb
4f30: 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e  er of millisecon
4f40: 64 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e  ds before return
4f50: 69 6e 67 20 30 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ing 0..*/.void s
4f60: 71 6c 69 74 65 33 5f 62 75 73 79 5f 74 69 6d 65  qlite3_busy_time
4f70: 6f 75 74 28 73 71 6c 69 74 65 20 2a 64 62 2c 20  out(sqlite *db, 
4f80: 69 6e 74 20 6d 73 29 7b 0a 20 20 69 66 28 20 6d  int ms){.  if( m
4f90: 73 3e 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  s>0 ){.    sqlit
4fa0: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28  e3_busy_handler(
4fb0: 64 62 2c 20 73 71 6c 69 74 65 44 65 66 61 75 6c  db, sqliteDefaul
4fc0: 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 2c 20 28  tBusyCallback, (
4fd0: 76 6f 69 64 2a 29 6d 73 29 3b 0a 20 20 7d 65 6c  void*)ms);.  }el
4fe0: 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  se{.    sqlite3_
4ff0: 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c  busy_handler(db,
5000: 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f   0, 0);.  }.}../
5010: 2a 0a 2a 2a 20 43 61 75 73 65 20 61 6e 79 20 70  *.** Cause any p
5020: 65 6e 64 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e  ending operation
5030: 20 74 6f 20 73 74 6f 70 20 61 74 20 69 74 73 20   to stop at its 
5040: 65 61 72 6c 69 65 73 74 20 6f 70 70 6f 72 74 75  earliest opportu
5050: 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  nity..*/.void sq
5060: 6c 69 74 65 33 5f 69 6e 74 65 72 72 75 70 74 28  lite3_interrupt(
5070: 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 64  sqlite *db){.  d
5080: 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49  b->flags |= SQLI
5090: 54 45 5f 49 6e 74 65 72 72 75 70 74 3b 0a 7d 0a  TE_Interrupt;.}.
50a0: 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77 73 20 73  ./*.** Windows s
50b0: 79 73 74 65 6d 73 20 73 68 6f 75 6c 64 20 63 61  ystems should ca
50c0: 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  ll this routine 
50d0: 74 6f 20 66 72 65 65 20 6d 65 6d 6f 72 79 20 74  to free memory t
50e0: 68 61 74 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e  hat.** is return
50f0: 65 64 20 69 6e 20 74 68 65 20 69 6e 20 74 68 65  ed in the in the
5100: 20 65 72 72 6d 73 67 20 70 61 72 61 6d 65 74 65   errmsg paramete
5110: 72 20 6f 66 20 73 71 6c 69 74 65 33 5f 6f 70 65  r of sqlite3_ope
5120: 6e 28 29 20 77 68 65 6e 0a 2a 2a 20 53 51 4c 69  n() when.** SQLi
5130: 74 65 20 69 73 20 61 20 44 4c 4c 2e 20 20 46 6f  te is a DLL.  Fo
5140: 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c 20 69  r some reason, i
5150: 74 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20  t does not work 
5160: 74 6f 20 63 61 6c 6c 20 66 72 65 65 28 29 0a 2a  to call free().*
5170: 2a 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2a 0a 2a  * directly..**.*
5180: 2a 20 4e 6f 74 65 20 74 68 61 74 20 77 65 20 6e  * Note that we n
5190: 65 65 64 20 74 6f 20 63 61 6c 6c 20 66 72 65 65  eed to call free
51a0: 28 29 20 6e 6f 74 20 73 71 6c 69 74 65 46 72 65  () not sqliteFre
51b0: 65 28 29 20 68 65 72 65 2c 20 73 69 6e 63 65 20  e() here, since 
51c0: 65 76 65 72 79 0a 2a 2a 20 73 74 72 69 6e 67 20  every.** string 
51d0: 74 68 61 74 20 69 73 20 65 78 70 6f 72 74 65 64  that is exported
51e0: 20 66 72 6f 6d 20 53 51 4c 69 74 65 20 73 68 6f   from SQLite sho
51f0: 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 79  uld have already
5200: 20 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 0a   passed through.
5210: 2a 2a 20 73 71 6c 69 74 65 33 53 74 72 52 65 61  ** sqlite3StrRea
5220: 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20  lloc()..*/.void 
5230: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 63 68 61  sqlite3_free(cha
5240: 72 20 2a 70 29 7b 20 66 72 65 65 28 70 29 3b 20  r *p){ free(p); 
5250: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20  }../*.** Create 
5260: 6e 65 77 20 75 73 65 72 20 66 75 6e 63 74 69 6f  new user functio
5270: 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ns..*/.int sqlit
5280: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69  e3_create_functi
5290: 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  on(.  sqlite3 *d
52a0: 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  b,.  const char 
52b0: 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a  *zFunctionName,.
52c0: 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e    int nArg,.  in
52d0: 74 20 65 6e 63 2c 0a 20 20 69 6e 74 20 69 43 6f  t enc,.  int iCo
52e0: 6c 6c 61 74 65 41 72 67 2c 0a 20 20 76 6f 69 64  llateArg,.  void
52f0: 20 2a 70 55 73 65 72 44 61 74 61 2c 0a 20 20 76   *pUserData,.  v
5300: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c  oid (*xFunc)(sql
5310: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e  ite3_context*,in
5320: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  t,sqlite3_value 
5330: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53  **),.  void (*xS
5340: 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e  tep)(sqlite3_con
5350: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65  text*,int,sqlite
5360: 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76  3_value **),.  v
5370: 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71  oid (*xFinal)(sq
5380: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a  lite3_context*).
5390: 29 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 3b  ){.  FuncDef *p;
53a0: 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 0a 20  .  int nName;.. 
53b0: 20 69 66 28 20 28 64 62 3d 3d 30 20 7c 7c 20 7a   if( (db==0 || z
53c0: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 3d 3d 30 20  FunctionName==0 
53d0: 7c 7c 20 73 71 6c 69 74 65 33 53 61 66 65 74 79  || sqlite3Safety
53e0: 43 68 65 63 6b 28 64 62 29 29 20 7c 7c 0a 20 20  Check(db)) ||.  
53f0: 20 20 20 20 28 78 46 75 6e 63 20 26 26 20 28 78      (xFunc && (x
5400: 46 69 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29  Final || xStep))
5410: 20 7c 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75   || .      (!xFu
5420: 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26  nc && (xFinal &&
5430: 20 21 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20   !xStep)) ||.   
5440: 20 20 20 28 21 78 46 75 6e 63 20 26 26 20 28 21     (!xFunc && (!
5450: 78 46 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29  xFinal && xStep)
5460: 29 20 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67  ) ||.      (nArg
5470: 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 31 32 37 29  <-1 || nArg>127)
5480: 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 35 3c 28   ||.      (255<(
5490: 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a  nName = strlen(z
54a0: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20  FunctionName))) 
54b0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
54c0: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a  LITE_ERROR;.  }.
54d0: 20 20 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54    .  /* If SQLIT
54e0: 45 5f 55 54 46 31 36 20 69 73 20 73 70 65 63 69  E_UTF16 is speci
54f0: 66 69 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f  fied as the enco
5500: 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73  ding type, trans
5510: 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74  form this.  ** t
5520: 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f  o one of SQLITE_
5530: 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54  UTF16LE or SQLIT
5540: 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e 67 20  E_UTF16BE using 
5550: 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f  the.  ** SQLITE_
5560: 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72  UTF16NATIVE macr
5570: 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20  o. SQLITE_UTF16 
5580: 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65  is not used inte
5590: 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2a 0a 20 20 2a  rnally..  **.  *
55a0: 2a 20 49 66 20 53 51 4c 49 54 45 5f 41 4e 59 20  * If SQLITE_ANY 
55b0: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 61 64  is specified, ad
55c0: 64 20 74 68 72 65 65 20 76 65 72 73 69 6f 6e 73  d three versions
55d0: 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e   of the function
55e0: 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 68 61 73  .  ** to the has
55f0: 68 20 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20  h table..  */.  
5600: 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f  if( enc==SQLITE_
5610: 55 54 46 31 36 20 29 7b 0a 20 20 20 20 65 6e 63  UTF16 ){.    enc
5620: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e   = SQLITE_UTF16N
5630: 41 54 49 56 45 3b 0a 20 20 7d 65 6c 73 65 20 69  ATIVE;.  }else i
5640: 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 41  f( enc==SQLITE_A
5650: 4e 59 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63  NY ){.    int rc
5660: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  ;.    rc = sqlit
5670: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69  e3_create_functi
5680: 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e  on(db, zFunction
5690: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49  Name, nArg, SQLI
56a0: 54 45 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20  TE_UTF8,.       
56b0: 20 69 43 6f 6c 6c 61 74 65 41 72 67 2c 20 70 55   iCollateArg, pU
56c0: 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c 20  serData, xFunc, 
56d0: 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b 0a  xStep, xFinal);.
56e0: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
56f0: 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72  TE_OK ) return r
5700: 63 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  c;.    rc = sqli
5710: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74  te3_create_funct
5720: 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f  ion(db, zFunctio
5730: 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c  nName, nArg, SQL
5740: 49 54 45 5f 55 54 46 31 36 4c 45 2c 0a 20 20 20  ITE_UTF16LE,.   
5750: 20 20 20 20 20 69 43 6f 6c 6c 61 74 65 41 72 67       iCollateArg
5760: 2c 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75  , pUserData, xFu
5770: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61  nc, xStep, xFina
5780: 6c 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d  l);.    if( rc!=
5790: 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75  SQLITE_OK ) retu
57a0: 72 6e 20 72 63 3b 0a 20 20 20 20 65 6e 63 20 3d  rn rc;.    enc =
57b0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b   SQLITE_UTF16BE;
57c0: 0a 20 20 7d 0a 0a 20 20 70 20 3d 20 73 71 6c 69  .  }..  p = sqli
57d0: 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28  te3FindFunction(
57e0: 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d  db, zFunctionNam
57f0: 65 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20  e, nName, nArg, 
5800: 65 6e 63 2c 20 31 29 3b 0a 20 20 69 66 28 20 70  enc, 1);.  if( p
5810: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  ==0 ) return 1;.
5820: 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20 78 46 75    p->xFunc = xFu
5830: 6e 63 3b 0a 20 20 70 2d 3e 78 53 74 65 70 20 3d  nc;.  p->xStep =
5840: 20 78 53 74 65 70 3b 0a 20 20 70 2d 3e 78 46 69   xStep;.  p->xFi
5850: 6e 61 6c 69 7a 65 20 3d 20 78 46 69 6e 61 6c 3b  nalize = xFinal;
5860: 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74 61 20  .  p->pUserData 
5870: 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20 20 72  = pUserData;.  r
5880: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
5890: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  .}.int sqlite3_c
58a0: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 31 36  reate_function16
58b0: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c  (.  sqlite3 *db,
58c0: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a  .  const void *z
58d0: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20  FunctionName,.  
58e0: 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20  int nArg,.  int 
58f0: 65 54 65 78 74 52 65 70 2c 0a 20 20 69 6e 74 20  eTextRep,.  int 
5900: 69 43 6f 6c 6c 61 74 65 41 72 67 2c 0a 20 20 76  iCollateArg,.  v
5910: 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 2c 0a  oid *pUserData,.
5920: 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28    void (*xFunc)(
5930: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a  sqlite3_context*
5940: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c  ,int,sqlite3_val
5950: 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a  ue**),.  void (*
5960: 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63  xStep)(sqlite3_c
5970: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69  ontext*,int,sqli
5980: 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20  te3_value**),.  
5990: 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73  void (*xFinal)(s
59a0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29  qlite3_context*)
59b0: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  .){.  int rc;.  
59c0: 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46 75 6e  char const *zFun
59d0: 63 38 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 76  c8;..  sqlite3_v
59e0: 61 6c 75 65 20 2a 70 54 6d 70 20 3d 20 73 71 6c  alue *pTmp = sql
59f0: 69 74 65 33 47 65 74 54 72 61 6e 73 69 65 6e 74  ite3GetTransient
5a00: 56 61 6c 75 65 28 64 62 29 3b 0a 20 20 73 71 6c  Value(db);.  sql
5a10: 69 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28  ite3ValueSetStr(
5a20: 70 54 6d 70 2c 20 2d 31 2c 20 7a 46 75 6e 63 74  pTmp, -1, zFunct
5a30: 69 6f 6e 4e 61 6d 65 2c 20 53 51 4c 49 54 45 5f  ionName, SQLITE_
5a40: 55 54 46 31 36 4e 41 54 49 56 45 2c 53 51 4c 49  UTF16NATIVE,SQLI
5a50: 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 46  TE_STATIC);.  zF
5a60: 75 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 56 61  unc8 = sqlite3Va
5a70: 6c 75 65 54 65 78 74 28 70 54 6d 70 2c 20 53 51  lueText(pTmp, SQ
5a80: 4c 49 54 45 5f 55 54 46 38 29 3b 0a 0a 20 20 69  LITE_UTF8);..  i
5a90: 66 28 20 21 7a 46 75 6e 63 38 20 29 7b 0a 20 20  f( !zFunc8 ){.  
5aa0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
5ab0: 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 63 20  NOMEM;.  }.  rc 
5ac0: 3d 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65  = sqlite3_create
5ad0: 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46  _function(db, zF
5ae0: 75 6e 63 38 2c 20 6e 41 72 67 2c 20 65 54 65 78  unc8, nArg, eTex
5af0: 74 52 65 70 2c 20 0a 20 20 20 20 20 20 69 43 6f  tRep, .      iCo
5b00: 6c 6c 61 74 65 41 72 67 2c 20 70 55 73 65 72 44  llateArg, pUserD
5b10: 61 74 61 2c 20 78 46 75 6e 63 2c 20 78 53 74 65  ata, xFunc, xSte
5b20: 70 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20 72 65  p, xFinal);.  re
5b30: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
5b40: 2a 20 52 65 67 69 73 74 65 72 20 61 20 74 72 61  * Register a tra
5b50: 63 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68  ce function.  Th
5b60: 65 20 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20  e pArg from the 
5b70: 70 72 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73  previously regis
5b80: 74 65 72 65 64 20 74 72 61 63 65 0a 2a 2a 20 69  tered trace.** i
5b90: 73 20 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a  s returned.  .**
5ba0: 0a 2a 2a 20 41 20 4e 55 4c 4c 20 74 72 61 63 65  .** A NULL trace
5bb0: 20 66 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20   function means 
5bc0: 74 68 61 74 20 6e 6f 20 74 72 61 63 69 6e 67 20  that no tracing 
5bd0: 69 73 20 65 78 65 63 75 74 65 73 2e 20 20 41 20  is executes.  A 
5be0: 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63  non-NULL.** trac
5bf0: 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74  e is a pointer t
5c00: 6f 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61  o a function tha
5c10: 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20  t is invoked at 
5c20: 74 68 65 20 73 74 61 72 74 20 6f 66 20 65 61 63  the start of eac
5c30: 68 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 78 65  h.** sqlite3_exe
5c40: 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71  c()..*/.void *sq
5c50: 6c 69 74 65 33 5f 74 72 61 63 65 28 73 71 6c 69  lite3_trace(sqli
5c60: 74 65 20 2a 64 62 2c 20 76 6f 69 64 20 28 2a 78  te *db, void (*x
5c70: 54 72 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f 6e  Trace)(void*,con
5c80: 73 74 20 63 68 61 72 2a 29 2c 20 76 6f 69 64 20  st char*), void 
5c90: 2a 70 41 72 67 29 7b 0a 20 20 76 6f 69 64 20 2a  *pArg){.  void *
5ca0: 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 54 72 61 63  pOld = db->pTrac
5cb0: 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 54 72 61  eArg;.  db->xTra
5cc0: 63 65 20 3d 20 78 54 72 61 63 65 3b 0a 20 20 64  ce = xTrace;.  d
5cd0: 62 2d 3e 70 54 72 61 63 65 41 72 67 20 3d 20 70  b->pTraceArg = p
5ce0: 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f  Arg;.  return pO
5cf0: 6c 64 3b 0a 7d 0a 0a 2f 2a 2a 2a 20 45 58 50 45  ld;.}../*** EXPE
5d00: 52 49 4d 45 4e 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a  RIMENTAL ***.**.
5d10: 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 66 75  ** Register a fu
5d20: 6e 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76  nction to be inv
5d30: 6f 6b 65 64 20 77 68 65 6e 20 61 20 74 72 61 6e  oked when a tran
5d40: 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 65 6e 74 73  saction comments
5d50: 2e 0a 2a 2a 20 49 66 20 65 69 74 68 65 72 20 66  ..** If either f
5d60: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20  unction returns 
5d70: 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 74  non-zero, then t
5d80: 68 65 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d 65  he commit become
5d90: 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2e  s a.** rollback.
5da0: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  .*/.void *sqlite
5db0: 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a 20  3_commit_hook(. 
5dc0: 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20   sqlite *db,    
5dd0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74             /* At
5de0: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f  tach the hook to
5df0: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a   this database *
5e00: 2f 0a 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c 62  /.  int (*xCallb
5e10: 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f 2a  ack)(void*),  /*
5e20: 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76   Function to inv
5e30: 6f 6b 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d  oke on each comm
5e40: 69 74 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41  it */.  void *pA
5e50: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20  rg              
5e60: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f    /* Argument to
5e70: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f   the function */
5e80: 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64  .){.  void *pOld
5e90: 20 3d 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72   = db->pCommitAr
5ea0: 67 3b 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 74  g;.  db->xCommit
5eb0: 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c  Callback = xCall
5ec0: 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d  back;.  db->pCom
5ed0: 6d 69 74 41 72 67 20 3d 20 70 41 72 67 3b 0a 20  mitArg = pArg;. 
5ee0: 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a   return pOld;.}.
5ef0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
5f00: 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 74  tine is called t
5f10: 6f 20 63 72 65 61 74 65 20 61 20 63 6f 6e 6e 65  o create a conne
5f20: 63 74 69 6f 6e 20 74 6f 20 61 20 64 61 74 61 62  ction to a datab
5f30: 61 73 65 20 42 54 72 65 65 0a 2a 2a 20 64 72 69  ase BTree.** dri
5f40: 76 65 72 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61  ver.  If zFilena
5f50: 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f  me is the name o
5f60: 66 20 61 20 66 69 6c 65 2c 20 74 68 65 6e 20 74  f a file, then t
5f70: 68 61 74 20 66 69 6c 65 20 69 73 0a 2a 2a 20 6f  hat file is.** o
5f80: 70 65 6e 65 64 20 61 6e 64 20 75 73 65 64 2e 20  pened and used. 
5f90: 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73   If zFilename is
5fa0: 20 74 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 20   the magic name 
5fb0: 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 68 65 6e 0a  ":memory:" then.
5fc0: 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ** the database 
5fd0: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 6d 65 6d  is stored in mem
5fe0: 6f 72 79 20 28 61 6e 64 20 69 73 20 74 68 75 73  ory (and is thus
5ff0: 20 66 6f 72 67 6f 74 74 65 6e 20 61 73 20 73 6f   forgotten as so
6000: 6f 6e 20 61 73 0a 2a 2a 20 74 68 65 20 63 6f 6e  on as.** the con
6010: 6e 65 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 65  nection is close
6020: 64 2e 29 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d  d.)  If zFilenam
6030: 65 20 69 73 20 4e 55 4c 4c 20 74 68 65 6e 20 74  e is NULL then t
6040: 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 69  he database.** i
6050: 73 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20  s for temporary 
6060: 75 73 65 20 6f 6e 6c 79 20 61 6e 64 20 69 73 20  use only and is 
6070: 64 65 6c 65 74 65 64 20 61 73 20 73 6f 6f 6e 20  deleted as soon 
6080: 61 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f  as the connectio
6090: 6e 0a 2a 2a 20 69 73 20 63 6c 6f 73 65 64 2e 0a  n.** is closed..
60a0: 2a 2a 0a 2a 2a 20 41 20 74 65 6d 70 6f 72 61 72  **.** A temporar
60b0: 79 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62  y database can b
60c0: 65 20 65 69 74 68 65 72 20 61 20 64 69 73 6b 20  e either a disk 
60d0: 66 69 6c 65 20 28 74 68 61 74 20 69 73 20 61 75  file (that is au
60e0: 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 2a 2a 20 64  tomatically.** d
60f0: 65 6c 65 74 65 64 20 77 68 65 6e 20 74 68 65 20  eleted when the 
6100: 66 69 6c 65 20 69 73 20 63 6c 6f 73 65 64 29 20  file is closed) 
6110: 6f 72 20 61 20 73 65 74 20 6f 66 20 72 65 64 2d  or a set of red-
6120: 62 6c 61 63 6b 20 74 72 65 65 73 20 68 65 6c 64  black trees held
6130: 20 69 6e 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 64   in memory,.** d
6140: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20  epending on the 
6150: 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 54 45  values of the TE
6160: 4d 50 5f 53 54 4f 52 45 20 63 6f 6d 70 69 6c 65  MP_STORE compile
6170: 2d 74 69 6d 65 20 6d 61 63 72 6f 20 61 6e 64 20  -time macro and 
6180: 74 68 65 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 5f  the.** db->temp_
6190: 73 74 6f 72 65 20 76 61 72 69 61 62 6c 65 2c 20  store variable, 
61a0: 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65  according to the
61b0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74   following chart
61c0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 54 45  :.**.**       TE
61d0: 4d 50 5f 53 54 4f 52 45 20 20 20 20 20 64 62 2d  MP_STORE     db-
61e0: 3e 74 65 6d 70 5f 73 74 6f 72 65 20 20 20 20 20  >temp_store     
61f0: 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 65 6d 70  Location of temp
6200: 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 0a 2a  orary database.*
6210: 2a 20 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d  *       --------
6220: 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d  --     ---------
6230: 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d  -----     ------
6240: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6250: 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20  --------.**     
6260: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20        0         
6270: 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20 20        any       
6280: 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20        file.**   
6290: 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20          1       
62a0: 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20           1      
62b0: 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20          file.** 
62c0: 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20            1     
62d0: 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20             2    
62e0: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79            memory
62f0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 31 20  .**           1 
6300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30                 0
6310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69                fi
6320: 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  le.**           
6330: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  2               
6340: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20   1              
6350: 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20  file.**         
6360: 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20    2             
6370: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20     2            
6380: 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20    memory.**     
6390: 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20        2         
63a0: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20         0        
63b0: 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20        memory.** 
63c0: 20 20 20 20 20 20 20 20 20 20 33 20 20 20 20 20            3     
63d0: 20 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 20            any   
63e0: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79            memory
63f0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42  .*/.int sqlite3B
6400: 74 72 65 65 46 61 63 74 6f 72 79 28 0a 20 20 63  treeFactory(.  c
6410: 6f 6e 73 74 20 73 71 6c 69 74 65 20 2a 64 62 2c  onst sqlite *db,
6420: 09 20 20 20 20 2f 2a 20 4d 61 69 6e 20 64 61 74  .    /* Main dat
6430: 61 62 61 73 65 20 77 68 65 6e 20 6f 70 65 6e 69  abase when openi
6440: 6e 67 20 61 75 78 20 6f 74 68 65 72 77 69 73 65  ng aux otherwise
6450: 20 30 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68   0 */.  const ch
6460: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20  ar *zFilename,  
6470: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65    /* Name of the
6480: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67   file containing
6490: 20 74 68 65 20 42 54 72 65 65 20 64 61 74 61 62   the BTree datab
64a0: 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6f 6d 69  ase */.  int omi
64b0: 74 4a 6f 75 72 6e 61 6c 2c 20 20 20 20 20 20 20  tJournal,       
64c0: 20 20 20 2f 2a 20 69 66 20 54 52 55 45 20 74 68     /* if TRUE th
64d0: 65 6e 20 64 6f 20 6e 6f 74 20 6a 6f 75 72 6e 61  en do not journa
64e0: 6c 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20  l this file */. 
64f0: 20 69 6e 74 20 6e 43 61 63 68 65 2c 20 20 20 20   int nCache,    
6500: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 6f             /* Ho
6510: 77 20 6d 61 6e 79 20 70 61 67 65 73 20 69 6e 20  w many pages in 
6520: 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20 2a  the page cache *
6530: 2f 0a 20 20 42 74 72 65 65 20 2a 2a 70 70 42 74  /.  Btree **ppBt
6540: 72 65 65 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ree           /*
6550: 20 50 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 20   Pointer to new 
6560: 42 74 72 65 65 20 6f 62 6a 65 63 74 20 77 72 69  Btree object wri
6570: 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a 29 7b 0a  tten here */.){.
6580: 20 20 69 6e 74 20 62 74 72 65 65 5f 66 6c 61 67    int btree_flag
6590: 73 20 3d 20 30 3b 0a 20 20 0a 20 20 61 73 73 65  s = 0;.  .  asse
65a0: 72 74 28 20 70 70 42 74 72 65 65 20 21 3d 20 30  rt( ppBtree != 0
65b0: 29 3b 0a 20 20 69 66 28 20 6f 6d 69 74 4a 6f 75  );.  if( omitJou
65c0: 72 6e 61 6c 20 29 7b 0a 20 20 20 20 62 74 72 65  rnal ){.    btre
65d0: 65 5f 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45  e_flags |= BTREE
65e0: 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 3b 0a 20  _OMIT_JOURNAL;. 
65f0: 20 7d 0a 20 20 69 66 28 20 21 7a 46 69 6c 65 6e   }.  if( !zFilen
6600: 61 6d 65 20 29 7b 0a 20 20 20 20 62 74 72 65 65  ame ){.    btree
6610: 5f 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f  _flags |= BTREE_
6620: 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a 0a 20 20 72  MEMORY;.  }..  r
6630: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 74 72  eturn sqlite3Btr
6640: 65 65 4f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65  eeOpen(zFilename
6650: 2c 20 70 70 42 74 72 65 65 2c 20 6e 43 61 63 68  , ppBtree, nCach
6660: 65 2c 20 62 74 72 65 65 5f 66 6c 61 67 73 2c 0a  e, btree_flags,.
6670: 20 20 20 20 20 20 28 76 6f 69 64 20 2a 29 26 64        (void *)&d
6680: 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 29 3b  b->busyHandler);
6690: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
66a0: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 45   UTF-8 encoded E
66b0: 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20  nglish language 
66c0: 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74  explanation of t
66d0: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a  he most recent.*
66e0: 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73  * error..*/.cons
66f0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f  t char *sqlite3_
6700: 65 72 72 6d 73 67 28 73 71 6c 69 74 65 33 20 2a  errmsg(sqlite3 *
6710: 64 62 29 7b 0a 20 20 69 66 28 20 21 64 62 20 7c  db){.  if( !db |
6720: 7c 20 21 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20  | !db->pErr ){. 
6730: 20 20 20 2f 2a 20 49 66 20 64 62 20 69 73 20 4e     /* If db is N
6740: 55 4c 4c 2c 20 74 68 65 6e 20 61 73 73 75 6d 65  ULL, then assume
6750: 20 74 68 61 74 20 61 20 6d 61 6c 6c 6f 63 28 29   that a malloc()
6760: 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20 61   failed during a
6770: 6e 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33  n.    ** sqlite3
6780: 5f 6f 70 65 6e 28 29 20 63 61 6c 6c 2e 0a 20 20  _open() call..  
6790: 20 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20    */.    return 
67a0: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53 51  sqlite3ErrStr(SQ
67b0: 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 20 7d  LITE_NOMEM);.  }
67c0: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 5f  .  if( !sqlite3_
67d0: 76 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e 70  value_text(db->p
67e0: 45 72 72 29 20 29 7b 0a 20 20 20 20 72 65 74 75  Err) ){.    retu
67f0: 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 74 72  rn sqlite3ErrStr
6800: 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 3b 0a 20  (db->errCode);. 
6810: 20 7d 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69   }.  return sqli
6820: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 64  te3_value_text(d
6830: 62 2d 3e 70 45 72 72 29 3b 0a 7d 0a 0a 2f 2a 0a  b->pErr);.}../*.
6840: 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 2d 31 36  ** Return UTF-16
6850: 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 73 68   encoded English
6860: 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c 61 6e   language explan
6870: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73  ation of the mos
6880: 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f  t recent.** erro
6890: 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64  r..*/.const void
68a0: 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67   *sqlite3_errmsg
68b0: 31 36 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  16(sqlite3 *db){
68c0: 0a 20 20 2f 2a 20 42 65 63 61 75 73 65 20 61 6c  .  /* Because al
68d0: 6c 20 74 68 65 20 63 68 61 72 61 63 74 65 72 73  l the characters
68e0: 20 69 6e 20 74 68 65 20 73 74 72 69 6e 67 20 61   in the string a
68f0: 72 65 20 69 6e 20 74 68 65 20 75 6e 69 63 6f 64  re in the unicod
6900: 65 0a 20 20 2a 2a 20 72 61 6e 67 65 20 30 78 30  e.  ** range 0x0
6910: 30 2d 30 78 46 46 2c 20 69 66 20 77 65 20 70 61  0-0xFF, if we pa
6920: 64 20 74 68 65 20 62 69 67 2d 65 6e 64 69 61 6e  d the big-endian
6930: 20 73 74 72 69 6e 67 20 77 69 74 68 20 61 20 0a   string with a .
6940: 20 20 2a 2a 20 7a 65 72 6f 20 62 79 74 65 2c 20    ** zero byte, 
6950: 77 65 20 63 61 6e 20 6f 62 74 61 69 6e 20 74 68  we can obtain th
6960: 65 20 6c 69 74 74 6c 65 2d 65 6e 64 69 61 6e 20  e little-endian 
6970: 73 74 72 69 6e 67 20 77 69 74 68 0a 20 20 2a 2a  string with.  **
6980: 20 26 62 69 67 5f 65 6e 64 69 61 6e 5b 31 5d 2e   &big_endian[1].
6990: 0a 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63  .  */.  static c
69a0: 68 61 72 20 6f 75 74 4f 66 4d 65 6d 42 65 5b 5d  har outOfMemBe[]
69b0: 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6f 27 2c   = {.    0, 'o',
69c0: 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c   0, 'u', 0, 't',
69d0: 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c   0, ' ', .    0,
69e0: 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30 2c   'o', 0, 'f', 0,
69f0: 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 6d   ' ', .    0, 'm
6a00: 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 6d  ', 0, 'e', 0, 'm
6a10: 27 2c 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27 72  ', 0, 'o', 0, 'r
6a20: 27 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20 30 2c  ', 0, 'y', 0, 0,
6a30: 20 30 0a 20 20 7d 3b 0a 0a 20 20 69 66 28 20 64   0.  };..  if( d
6a40: 62 20 26 26 20 64 62 2d 3e 70 45 72 72 20 29 7b  b && db->pErr ){
6a50: 0a 20 20 20 20 69 66 28 20 21 73 71 6c 69 74 65  .    if( !sqlite
6a60: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64  3_value_text16(d
6a70: 62 2d 3e 70 45 72 72 29 20 29 7b 0a 20 20 20 20  b->pErr) ){.    
6a80: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65    sqlite3ValueSe
6a90: 74 53 74 72 28 64 62 2d 3e 70 45 72 72 2c 20 2d  tStr(db->pErr, -
6aa0: 31 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 72  1, sqlite3ErrStr
6ab0: 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 2c 0a 20  (db->errCode),. 
6ac0: 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f           SQLITE_
6ad0: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 41  UTF8, SQLITE_STA
6ae0: 54 49 43 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  TIC);.    }.    
6af0: 69 66 28 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  if( sqlite3_valu
6b00: 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72  e_text16(db->pEr
6b10: 72 29 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75  r) ){.      retu
6b20: 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  rn sqlite3_value
6b30: 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72  _text16(db->pErr
6b40: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 20 20 0a 0a  );.    }.  }  ..
6b50: 20 20 2f 2a 20 49 66 20 64 62 20 69 73 20 4e 55    /* If db is NU
6b60: 4c 4c 2c 20 74 68 65 6e 20 61 73 73 75 6d 65 20  LL, then assume 
6b70: 74 68 61 74 20 61 20 6d 61 6c 6c 6f 63 28 29 20  that a malloc() 
6b80: 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20 61 6e  failed during an
6b90: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70  .  ** sqlite3_op
6ba0: 65 6e 28 29 20 63 61 6c 6c 2e 20 57 65 20 68 61  en() call. We ha
6bb0: 76 65 20 61 20 73 74 61 74 69 63 20 76 65 72 73  ve a static vers
6bc0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 74 72 69 6e  ion of the strin
6bd0: 67 20 0a 20 20 2a 2a 20 22 6f 75 74 20 6f 66 20  g .  ** "out of 
6be0: 6d 65 6d 6f 72 79 22 20 65 6e 63 6f 64 65 64 20  memory" encoded 
6bf0: 75 73 69 6e 67 20 55 54 46 2d 31 36 20 6a 75 73  using UTF-16 jus
6c00: 74 20 66 6f 72 20 74 68 69 73 20 70 75 72 70 6f  t for this purpo
6c10: 73 65 2e 0a 20 20 2a 2f 0a 20 20 72 65 74 75 72  se..  */.  retur
6c20: 6e 20 28 76 6f 69 64 20 2a 29 28 26 6f 75 74 4f  n (void *)(&outO
6c30: 66 4d 65 6d 42 65 5b 53 51 4c 49 54 45 5f 55 54  fMemBe[SQLITE_UT
6c40: 46 31 36 4e 41 54 49 56 45 3d 3d 53 51 4c 49 54  F16NATIVE==SQLIT
6c50: 45 5f 55 54 46 31 36 4c 45 3f 31 3a 30 5d 29 3b  E_UTF16LE?1:0]);
6c60: 0a 7d 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .}..int sqlite3_
6c70: 65 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20  errcode(sqlite3 
6c80: 2a 64 62 29 7b 0a 20 20 69 66 28 20 21 64 62 20  *db){.  if( !db 
6c90: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  ) return SQLITE_
6ca0: 4e 4f 4d 45 4d 3b 0a 20 20 72 65 74 75 72 6e 20  NOMEM;.  return 
6cb0: 64 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a  db->errCode;.}..
6cc0: 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 73 63 68 65  /*.** Check sche
6cd0: 6d 61 20 63 6f 6f 6b 69 65 73 20 69 6e 20 61 6c  ma cookies in al
6ce0: 6c 20 64 61 74 61 62 61 73 65 73 20 65 78 63 65  l databases exce
6cf0: 70 74 20 54 45 4d 50 2e 20 20 49 66 20 61 6e 79  pt TEMP.  If any
6d00: 20 63 6f 6f 6b 69 65 20 69 73 20 6f 75 74 0a 2a   cookie is out.*
6d10: 2a 20 6f 66 20 64 61 74 65 2c 20 72 65 74 75 72  * of date, retur
6d20: 6e 20 30 2e 20 20 49 66 20 61 6c 6c 20 73 63 68  n 0.  If all sch
6d30: 65 6d 61 20 63 6f 6f 6b 69 65 73 20 61 72 65 20  ema cookies are 
6d40: 63 75 72 72 65 6e 74 2c 20 72 65 74 75 72 6e 20  current, return 
6d50: 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  1..*/.static int
6d60: 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64 28 73   schemaIsValid(s
6d70: 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 69 6e  qlite *db){.  in
6d80: 74 20 69 44 62 3b 0a 20 20 69 6e 74 20 72 63 3b  t iDb;.  int rc;
6d90: 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 63 75 72  .  BtCursor *cur
6da0: 54 65 6d 70 3b 0a 20 20 69 6e 74 20 63 6f 6f 6b  Temp;.  int cook
6db0: 69 65 3b 0a 20 20 69 6e 74 20 61 6c 6c 4f 6b 20  ie;.  int allOk 
6dc0: 3d 20 31 3b 0a 0a 20 20 66 6f 72 28 69 44 62 3d  = 1;..  for(iDb=
6dd0: 30 3b 20 61 6c 6c 4f 6b 20 26 26 20 69 44 62 3c  0; allOk && iDb<
6de0: 64 62 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b 29 7b  db->nDb; iDb++){
6df0: 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 3b  .    Btree *pBt;
6e00: 0a 20 20 20 20 69 66 28 20 69 44 62 3d 3d 31 20  .    if( iDb==1 
6e10: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20  ) continue;.    
6e20: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 44  pBt = db->aDb[iD
6e30: 62 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20  b].pBt;.    if( 
6e40: 70 42 74 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75  pBt==0 ) continu
6e50: 65 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  e;.    rc = sqli
6e60: 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 28 70  te3BtreeCursor(p
6e70: 42 74 2c 20 4d 41 53 54 45 52 5f 52 4f 4f 54 2c  Bt, MASTER_ROOT,
6e80: 20 30 2c 20 30 2c 20 30 2c 20 26 63 75 72 54 65   0, 0, 0, &curTe
6e90: 6d 70 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d  mp);.    if( rc=
6ea0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
6eb0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
6ec0: 42 74 72 65 65 47 65 74 4d 65 74 61 28 70 42 74  BtreeGetMeta(pBt
6ed0: 2c 20 31 2c 20 26 63 6f 6f 6b 69 65 29 3b 0a 20  , 1, &cookie);. 
6ee0: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c       if( rc==SQL
6ef0: 49 54 45 5f 4f 4b 20 26 26 20 63 6f 6f 6b 69 65  ITE_OK && cookie
6f00: 21 3d 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 73  !=db->aDb[iDb].s
6f10: 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 20 29 7b 0a  chema_cookie ){.
6f20: 20 20 20 20 20 20 20 20 61 6c 6c 4f 6b 20 3d 20          allOk = 
6f30: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  0;.      }.     
6f40: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
6f50: 73 65 43 75 72 73 6f 72 28 63 75 72 54 65 6d 70  seCursor(curTemp
6f60: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  );.    }.  }.  r
6f70: 65 74 75 72 6e 20 61 6c 6c 4f 6b 3b 0a 7d 0a 0a  eturn allOk;.}..
6f80: 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 74 68  /*.** Compile th
6f90: 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20  e UTF-8 encoded 
6fa0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a 53  SQL statement zS
6fb0: 71 6c 20 69 6e 74 6f 20 61 20 73 74 61 74 65 6d  ql into a statem
6fc0: 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69  ent handle..*/.i
6fd0: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
6fe0: 72 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  re(.  sqlite3 *d
6ff0: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b,              
7000: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
7010: 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  le. */.  const c
7020: 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  har *zSql,      
7030: 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f     /* UTF-8 enco
7040: 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ded SQL statemen
7050: 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74  t. */.  int nByt
7060: 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  es,             
7070: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a    /* Length of z
7080: 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f  Sql in bytes. */
7090: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
70a0: 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20  **ppStmt,    /* 
70b0: 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74  OUT: A pointer t
70c0: 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  o the prepared s
70d0: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f  tatement */.  co
70e0: 6e 73 74 20 63 68 61 72 2a 2a 20 70 7a 54 61 69  nst char** pzTai
70f0: 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20  l       /* OUT: 
7100: 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74  End of parsed st
7110: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50 61 72  ring */.){.  Par
7120: 73 65 20 73 50 61 72 73 65 3b 0a 20 20 63 68 61  se sParse;.  cha
7130: 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a  r *zErrMsg = 0;.
7140: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
7150: 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28  E_OK;..  assert(
7160: 20 70 70 53 74 6d 74 20 29 3b 0a 20 20 2a 70 70   ppStmt );.  *pp
7170: 53 74 6d 74 20 3d 20 30 3b 0a 20 20 69 66 28 20  Stmt = 0;.  if( 
7180: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
7190: 64 62 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  db) ){.    rc = 
71a0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20  SQLITE_MISUSE;. 
71b0: 20 20 20 67 6f 74 6f 20 70 72 65 70 61 72 65 5f     goto prepare_
71c0: 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  out;.  }..  if( 
71d0: 64 62 2d 3e 70 56 64 62 65 3d 3d 30 20 29 7b 20  db->pVdbe==0 ){ 
71e0: 64 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b  db->nChange = 0;
71f0: 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61   }.  memset(&sPa
7200: 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73  rse, 0, sizeof(s
7210: 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72 73  Parse));.  sPars
7220: 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 73 71 6c  e.db = db;.  sql
7230: 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 26 73  ite3RunParser(&s
7240: 50 61 72 73 65 2c 20 7a 53 71 6c 2c 20 26 7a 45  Parse, zSql, &zE
7250: 72 72 4d 73 67 29 3b 0a 0a 20 20 69 66 28 20 64  rrMsg);..  if( d
7260: 62 2d 3e 78 54 72 61 63 65 20 26 26 20 21 64 62  b->xTrace && !db
7270: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20  ->init.busy ){. 
7280: 20 20 20 2f 2a 20 54 72 61 63 65 20 6f 6e 6c 79     /* Trace only
7290: 20 74 68 65 20 73 74 61 74 6d 65 6e 74 20 74 68   the statment th
72a0: 61 74 20 77 61 73 20 63 6f 6d 70 69 6c 65 64 2e  at was compiled.
72b0: 0a 20 20 20 20 2a 2a 20 4d 61 6b 65 20 61 20 63  .    ** Make a c
72c0: 6f 70 79 20 6f 66 20 74 68 61 74 20 70 61 72 74  opy of that part
72d0: 20 6f 66 20 74 68 65 20 53 51 4c 20 73 74 72 69   of the SQL stri
72e0: 6e 67 20 73 69 6e 63 65 20 7a 53 51 4c 20 69 73  ng since zSQL is
72f0: 20 63 6f 6e 73 74 0a 20 20 20 20 2a 2a 20 61 6e   const.    ** an
7300: 64 20 77 65 20 6d 75 73 74 20 70 61 73 73 20 61  d we must pass a
7310: 20 7a 65 72 6f 20 74 65 72 6d 69 6e 61 74 65 64   zero terminated
7320: 20 73 74 72 69 6e 67 20 74 6f 20 74 68 65 20 74   string to the t
7330: 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20  race function.  
7340: 20 20 2a 2a 20 54 68 65 20 63 6f 70 79 20 69 73    ** The copy is
7350: 20 75 6e 6e 65 63 65 73 73 61 72 79 20 69 66 20   unnecessary if 
7360: 74 68 65 20 74 61 69 6c 20 70 6f 69 6e 74 65 72  the tail pointer
7370: 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 61 74 20   is pointing at 
7380: 74 68 65 0a 20 20 20 20 2a 2a 20 62 65 67 69 6e  the.    ** begin
7390: 6e 69 67 20 6f 72 20 65 6e 64 20 6f 66 20 74 68  nig or end of th
73a0: 65 20 53 51 4c 20 73 74 72 69 6e 67 2e 0a 20 20  e SQL string..  
73b0: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 73 50 61    */.    if( sPa
73c0: 72 73 65 2e 7a 54 61 69 6c 20 26 26 20 73 50 61  rse.zTail && sPa
73d0: 72 73 65 2e 7a 54 61 69 6c 21 3d 7a 53 71 6c 20  rse.zTail!=zSql 
73e0: 26 26 20 2a 73 50 61 72 73 65 2e 7a 54 61 69 6c  && *sParse.zTail
73f0: 20 29 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a   ){.      char *
7400: 74 6d 70 53 71 6c 20 3d 20 73 71 6c 69 74 65 53  tmpSql = sqliteS
7410: 74 72 4e 44 75 70 28 7a 53 71 6c 2c 20 73 50 61  trNDup(zSql, sPa
7420: 72 73 65 2e 7a 54 61 69 6c 20 2d 20 7a 53 71 6c  rse.zTail - zSql
7430: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 74 6d 70  );.      if( tmp
7440: 53 71 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 64  Sql ){.        d
7450: 62 2d 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54  b->xTrace(db->pT
7460: 72 61 63 65 41 72 67 2c 20 74 6d 70 53 71 6c 29  raceArg, tmpSql)
7470: 3b 0a 20 20 20 20 20 20 20 20 66 72 65 65 28 74  ;.        free(t
7480: 6d 70 53 71 6c 29 3b 0a 20 20 20 20 20 20 7d 65  mpSql);.      }e
7490: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20  lse{.        /* 
74a0: 49 66 20 61 20 6d 65 6d 6f 72 79 20 65 72 72 6f  If a memory erro
74b0: 72 20 6f 63 63 75 72 72 65 64 20 64 75 72 69 6e  r occurred durin
74c0: 67 20 74 68 65 20 63 6f 70 79 2c 0a 20 20 20 20  g the copy,.    
74d0: 20 20 20 20 2a 2a 20 74 72 61 63 65 20 65 6e 74      ** trace ent
74e0: 69 72 65 20 53 51 4c 20 73 74 72 69 6e 67 20 61  ire SQL string a
74f0: 6e 64 20 66 61 6c 6c 20 74 68 72 6f 75 67 68 20  nd fall through 
7500: 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a  to the.        *
7510: 2a 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  * sqlite3_malloc
7520: 5f 66 61 69 6c 65 64 20 74 65 73 74 20 74 6f 20  _failed test to 
7530: 72 65 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72  report the error
7540: 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20  ..        */.   
7550: 20 20 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28       db->xTrace(
7560: 64 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 7a  db->pTraceArg, z
7570: 53 71 6c 29 3b 20 0a 20 20 20 20 20 20 7d 0a 20  Sql); .      }. 
7580: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
7590: 64 62 2d 3e 78 54 72 61 63 65 28 64 62 2d 3e 70  db->xTrace(db->p
75a0: 54 72 61 63 65 41 72 67 2c 20 7a 53 71 6c 29 3b  TraceArg, zSql);
75b0: 20 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f   .    }.  }..  /
75c0: 2a 20 50 72 69 6e 74 20 61 20 63 6f 70 79 20 6f  * Print a copy o
75d0: 66 20 53 51 4c 20 61 73 20 69 74 20 69 73 20 65  f SQL as it is e
75e0: 78 65 63 75 74 65 64 20 69 66 20 74 68 65 20 53  xecuted if the S
75f0: 51 4c 5f 54 52 41 43 45 20 70 72 61 67 6d 61 20  QL_TRACE pragma 
7600: 69 73 20 74 75 72 6e 65 64 0a 20 20 2a 2a 20 6f  is turned.  ** o
7610: 6e 20 69 6e 20 64 65 62 75 67 67 69 6e 67 20 6d  n in debugging m
7620: 6f 64 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66  ode..  */.#ifdef
7630: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20   SQLITE_DEBUG.  
7640: 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 20 26  if( (db->flags &
7650: 20 53 51 4c 49 54 45 5f 53 71 6c 54 72 61 63 65   SQLITE_SqlTrace
7660: 29 21 3d 30 20 26 26 20 73 50 61 72 73 65 2e 7a  )!=0 && sParse.z
7670: 54 61 69 6c 20 26 26 20 73 50 61 72 73 65 2e 7a  Tail && sParse.z
7680: 54 61 69 6c 21 3d 7a 53 71 6c 20 29 7b 0a 20 20  Tail!=zSql ){.  
7690: 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72    sqlite3DebugPr
76a0: 69 6e 74 66 28 22 53 51 4c 2d 74 72 61 63 65 3a  intf("SQL-trace:
76b0: 20 25 2e 2a 73 5c 6e 22 2c 20 73 50 61 72 73 65   %.*s\n", sParse
76c0: 2e 7a 54 61 69 6c 20 2d 20 7a 53 71 6c 2c 20 7a  .zTail - zSql, z
76d0: 53 71 6c 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  Sql);.  }.#endif
76e0: 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47   /* SQLITE_DEBUG
76f0: 20 2a 2f 0a 0a 0a 20 20 69 66 28 20 73 71 6c 69   */...  if( sqli
7700: 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65  te3_malloc_faile
7710: 64 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51  d ){.    rc = SQ
7720: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
7730: 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41  sqlite3RollbackA
7740: 6c 6c 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69  ll(db);.    sqli
7750: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
7760: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
7770: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20     db->flags &= 
7780: 7e 53 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b  ~SQLITE_InTrans;
7790: 0a 20 20 20 20 67 6f 74 6f 20 70 72 65 70 61 72  .    goto prepar
77a0: 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 69 66 28  e_out;.  }.  if(
77b0: 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49   sParse.rc==SQLI
77c0: 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65  TE_DONE ) sParse
77d0: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  .rc = SQLITE_OK;
77e0: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 63 68  .  if( sParse.ch
77f0: 65 63 6b 53 63 68 65 6d 61 20 26 26 20 21 73 63  eckSchema && !sc
7800: 68 65 6d 61 49 73 56 61 6c 69 64 28 64 62 29 20  hemaIsValid(db) 
7810: 29 7b 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63  ){.    sParse.rc
7820: 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41   = SQLITE_SCHEMA
7830: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72  ;.  }.  if( sPar
7840: 73 65 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43  se.rc==SQLITE_SC
7850: 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c 69  HEMA ){.    sqli
7860: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
7870: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
7880: 20 7d 0a 20 20 69 66 28 20 70 7a 54 61 69 6c 20   }.  if( pzTail 
7890: 29 20 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 72  ) *pzTail = sPar
78a0: 73 65 2e 7a 54 61 69 6c 3b 0a 20 20 72 63 20 3d  se.zTail;.  rc =
78b0: 20 73 50 61 72 73 65 2e 72 63 3b 0a 0a 20 20 69   sParse.rc;..  i
78c0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
78d0: 20 26 26 20 73 50 61 72 73 65 2e 70 56 64 62 65   && sParse.pVdbe
78e0: 20 26 26 20 73 50 61 72 73 65 2e 65 78 70 6c 61   && sParse.expla
78f0: 69 6e 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  in ){.    sqlite
7900: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
7910: 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 35 29  sParse.pVdbe, 5)
7920: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
7930: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72  eSetColName(sPar
7940: 73 65 2e 70 56 64 62 65 2c 20 30 2c 20 22 61 64  se.pVdbe, 0, "ad
7950: 64 72 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b  dr", P3_STATIC);
7960: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
7970: 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73  SetColName(sPars
7980: 65 2e 70 56 64 62 65 2c 20 31 2c 20 22 6f 70 63  e.pVdbe, 1, "opc
7990: 6f 64 65 22 2c 20 50 33 5f 53 54 41 54 49 43 29  ode", P3_STATIC)
79a0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
79b0: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72  eSetColName(sPar
79c0: 73 65 2e 70 56 64 62 65 2c 20 32 2c 20 22 70 31  se.pVdbe, 2, "p1
79d0: 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20  ", P3_STATIC);. 
79e0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65     sqlite3VdbeSe
79f0: 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e  tColName(sParse.
7a00: 70 56 64 62 65 2c 20 33 2c 20 22 70 32 22 2c 20  pVdbe, 3, "p2", 
7a10: 50 33 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20  P3_STATIC);.    
7a20: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f  sqlite3VdbeSetCo
7a30: 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64  lName(sParse.pVd
7a40: 62 65 2c 20 34 2c 20 22 70 33 22 2c 20 50 33 5f  be, 4, "p3", P3_
7a50: 53 54 41 54 49 43 29 3b 0a 20 20 7d 20 0a 0a 70  STATIC);.  } ..p
7a60: 72 65 70 61 72 65 5f 6f 75 74 3a 0a 20 20 69 66  repare_out:.  if
7a70: 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f  ( sqlite3SafetyO
7a80: 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20 72 63  ff(db) ){.    rc
7a90: 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45   = SQLITE_MISUSE
7aa0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d  ;.  }.  if( rc==
7ab0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
7ac0: 20 2a 70 70 53 74 6d 74 20 3d 20 28 73 71 6c 69   *ppStmt = (sqli
7ad0: 74 65 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65  te3_stmt*)sParse
7ae0: 2e 70 56 64 62 65 3b 0a 20 20 7d 65 6c 73 65 20  .pVdbe;.  }else 
7af0: 69 66 28 20 73 50 61 72 73 65 2e 70 56 64 62 65  if( sParse.pVdbe
7b00: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
7b10: 66 69 6e 61 6c 69 7a 65 28 28 73 71 6c 69 74 65  finalize((sqlite
7b20: 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70  3_stmt*)sParse.p
7b30: 56 64 62 65 29 3b 0a 20 20 7d 0a 0a 20 20 69 66  Vdbe);.  }..  if
7b40: 28 20 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20  ( zErrMsg ){.   
7b50: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
7b60: 2c 20 72 63 2c 20 22 25 73 22 2c 20 7a 45 72 72  , rc, "%s", zErr
7b70: 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Msg);.    sqlite
7b80: 46 72 65 65 28 7a 45 72 72 4d 73 67 29 3b 0a 20  Free(zErrMsg);. 
7b90: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69   }else{.    sqli
7ba0: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c  te3Error(db, rc,
7bb0: 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72   0);.  }.  retur
7bc0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  n rc;.}../*.** C
7bd0: 6f 6d 70 69 6c 65 20 74 68 65 20 55 54 46 2d 31  ompile the UTF-1
7be0: 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  6 encoded SQL st
7bf0: 61 74 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74  atement zSql int
7c00: 6f 20 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61  o a statement ha
7c10: 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ndle..*/.int sql
7c20: 69 74 65 33 5f 70 72 65 70 61 72 65 31 36 28 0a  ite3_prepare16(.
7c30: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20    sqlite3 *db,  
7c40: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
7c50: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20  atabase handle. 
7c60: 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  */ .  const void
7c70: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20   *zSql,         
7c80: 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64  /* UTF-8 encoded
7c90: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20   SQL statement. 
7ca0: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c  */.  int nBytes,
7cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
7cc0: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c  * Length of zSql
7cd0: 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20   in bytes. */.  
7ce0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70  sqlite3_stmt **p
7cf0: 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54  pStmt,    /* OUT
7d00: 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  : A pointer to t
7d10: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
7d20: 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74  ement */.  const
7d30: 20 76 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 20   void **pzTail  
7d40: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64       /* OUT: End
7d50: 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 6e   of parsed strin
7d60: 67 20 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 54 68 69  g */.){.  /* Thi
7d70: 73 20 66 75 6e 63 74 69 6f 6e 20 63 75 72 72 65  s function curre
7d80: 6e 74 6c 79 20 77 6f 72 6b 73 20 62 79 20 66 69  ntly works by fi
7d90: 72 73 74 20 74 72 61 6e 73 66 6f 72 6d 69 6e 67  rst transforming
7da0: 20 74 68 65 20 55 54 46 2d 31 36 0a 20 20 2a 2a   the UTF-16.  **
7db0: 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 20   encoded string 
7dc0: 74 6f 20 55 54 46 2d 38 2c 20 74 68 65 6e 20 69  to UTF-8, then i
7dd0: 6e 76 6f 6b 69 6e 67 20 73 71 6c 69 74 65 33 5f  nvoking sqlite3_
7de0: 70 72 65 70 61 72 65 28 29 2e 20 54 68 65 0a 20  prepare(). The. 
7df0: 20 2a 2a 20 74 72 69 63 6b 79 20 62 69 74 20 69   ** tricky bit i
7e00: 73 20 66 69 67 75 72 69 6e 67 20 6f 75 74 20 74  s figuring out t
7e10: 68 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 72 65  he pointer to re
7e20: 74 75 72 6e 20 69 6e 20 2a 70 7a 54 61 69 6c 2e  turn in *pzTail.
7e30: 0a 20 20 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e  .  */.  char con
7e40: 73 74 20 2a 7a 53 71 6c 38 20 3d 20 30 3b 0a 20  st *zSql8 = 0;. 
7e50: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 54 61   char const *zTa
7e60: 69 6c 38 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72  il8 = 0;.  int r
7e70: 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c  c;.  sqlite3_val
7e80: 75 65 20 2a 70 54 6d 70 3b 0a 0a 20 20 70 54 6d  ue *pTmp;..  pTm
7e90: 70 20 3d 20 73 71 6c 69 74 65 33 47 65 74 54 72  p = sqlite3GetTr
7ea0: 61 6e 73 69 65 6e 74 56 61 6c 75 65 28 64 62 29  ansientValue(db)
7eb0: 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65  ;.  sqlite3Value
7ec0: 53 65 74 53 74 72 28 70 54 6d 70 2c 20 2d 31 2c  SetStr(pTmp, -1,
7ed0: 20 7a 53 71 6c 2c 20 53 51 4c 49 54 45 5f 55 54   zSql, SQLITE_UT
7ee0: 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 54  F16NATIVE, SQLIT
7ef0: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 53 71  E_STATIC);.  zSq
7f00: 6c 38 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75  l8 = sqlite3Valu
7f10: 65 54 65 78 74 28 70 54 6d 70 2c 20 53 51 4c 49  eText(pTmp, SQLI
7f20: 54 45 5f 55 54 46 38 29 3b 0a 20 20 69 66 28 20  TE_UTF8);.  if( 
7f30: 21 7a 53 71 6c 38 20 29 7b 0a 20 20 20 20 73 71  !zSql8 ){.    sq
7f40: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53  lite3Error(db, S
7f50: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b  QLITE_NOMEM, 0);
7f60: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
7f70: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20  TE_NOMEM;.  }.  
7f80: 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 70 72 65  rc = sqlite3_pre
7f90: 70 61 72 65 28 64 62 2c 20 7a 53 71 6c 38 2c 20  pare(db, zSql8, 
7fa0: 2d 31 2c 20 70 70 53 74 6d 74 2c 20 26 7a 54 61  -1, ppStmt, &zTa
7fb0: 69 6c 38 29 3b 0a 0a 20 20 69 66 28 20 7a 54 61  il8);..  if( zTa
7fc0: 69 6c 38 20 26 26 20 70 7a 54 61 69 6c 20 29 7b  il8 && pzTail ){
7fd0: 0a 20 20 20 20 2f 2a 20 49 66 20 73 71 6c 69 74  .    /* If sqlit
7fe0: 65 33 5f 70 72 65 70 61 72 65 20 72 65 74 75 72  e3_prepare retur
7ff0: 6e 73 20 61 20 74 61 69 6c 20 70 6f 69 6e 74 65  ns a tail pointe
8000: 72 2c 20 77 65 20 63 61 6c 63 75 6c 61 74 65 20  r, we calculate 
8010: 74 68 65 0a 20 20 20 20 2a 2a 20 65 71 75 69 76  the.    ** equiv
8020: 61 6c 65 6e 74 20 70 6f 69 6e 74 65 72 20 69 6e  alent pointer in
8030: 74 6f 20 74 68 65 20 55 54 46 2d 31 36 20 73 74  to the UTF-16 st
8040: 72 69 6e 67 20 62 79 20 63 6f 75 6e 74 69 6e 67  ring by counting
8050: 20 74 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 20   the unicode.   
8060: 20 2a 2a 20 63 68 61 72 61 63 74 65 72 73 20 62   ** characters b
8070: 65 74 77 65 65 6e 20 7a 53 71 6c 38 20 61 6e 64  etween zSql8 and
8080: 20 7a 54 61 69 6c 38 2c 20 61 6e 64 20 74 68 65   zTail8, and the
8090: 6e 20 72 65 74 75 72 6e 69 6e 67 20 61 20 70 6f  n returning a po
80a0: 69 6e 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 65  inter.    ** the
80b0: 20 73 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20   same number of 
80c0: 63 68 61 72 61 63 74 65 72 73 20 69 6e 74 6f 20  characters into 
80d0: 74 68 65 20 55 54 46 2d 31 36 20 73 74 72 69 6e  the UTF-16 strin
80e0: 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e  g..    */.    in
80f0: 74 20 63 68 61 72 73 5f 70 61 72 73 65 64 20 3d  t chars_parsed =
8100: 20 73 71 6c 69 74 65 33 75 74 66 38 43 68 61 72   sqlite3utf8Char
8110: 4c 65 6e 28 7a 53 71 6c 38 2c 20 7a 54 61 69 6c  Len(zSql8, zTail
8120: 38 2d 7a 53 71 6c 38 29 3b 0a 20 20 20 20 2a 70  8-zSql8);.    *p
8130: 7a 54 61 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53  zTail = (u8 *)zS
8140: 71 6c 20 2b 20 73 71 6c 69 74 65 33 75 74 66 31  ql + sqlite3utf1
8150: 36 42 79 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63  6ByteLen(zSql, c
8160: 68 61 72 73 5f 70 61 72 73 65 64 29 3b 0a 20 20  hars_parsed);.  
8170: 7d 0a 20 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  }. .  return rc;
8180: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
8190: 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20  outine does the 
81a0: 77 6f 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20  work of opening 
81b0: 61 20 64 61 74 61 62 61 73 65 20 6f 6e 20 62 65  a database on be
81c0: 68 61 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74  half of.** sqlit
81d0: 65 33 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 71  e3_open() and sq
81e0: 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20  lite3_open16(). 
81f0: 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  The database fil
8200: 65 6e 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65  ename "zFilename
8210: 22 20 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20  "  .** is UTF-8 
8220: 65 6e 63 6f 64 65 64 2e 20 54 68 65 20 66 6f 75  encoded. The fou
8230: 72 74 68 20 61 72 67 75 6d 65 6e 74 2c 20 22 64  rth argument, "d
8240: 65 66 5f 65 6e 63 22 20 69 73 20 6f 6e 65 20 6f  ef_enc" is one o
8250: 66 20 74 68 65 20 54 45 58 54 5f 2a 0a 2a 2a 20  f the TEXT_*.** 
8260: 6d 61 63 72 6f 73 20 66 72 6f 6d 20 73 71 6c 69  macros from sqli
8270: 74 65 49 6e 74 2e 68 2e 20 49 66 20 77 65 20 65  teInt.h. If we e
8280: 6e 64 20 75 70 20 63 72 65 61 74 69 6e 67 20 61  nd up creating a
8290: 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 66 69   new database fi
82a0: 6c 65 0a 2a 2a 20 28 6e 6f 74 20 6f 70 65 6e 69  le.** (not openi
82b0: 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6f  ng an existing o
82c0: 6e 65 29 2c 20 74 68 65 20 74 65 78 74 20 65 6e  ne), the text en
82d0: 63 6f 64 69 6e 67 20 6f 66 20 74 68 65 20 64 61  coding of the da
82e0: 74 61 62 61 73 65 0a 2a 2a 20 77 69 6c 6c 20 62  tabase.** will b
82f0: 65 20 73 65 74 20 74 6f 20 74 68 69 73 20 76 61  e set to this va
8300: 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  lue..*/.static i
8310: 6e 74 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28  nt openDatabase(
8320: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
8330: 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74  Filename, /* Dat
8340: 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55  abase filename U
8350: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a  TF-8 encoded */.
8360: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62    sqlite3 **ppDb
8370: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
8380: 20 52 65 74 75 72 6e 65 64 20 64 61 74 61 62 61   Returned databa
8390: 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 29 7b 0a  se handle */.){.
83a0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20    sqlite3 *db;. 
83b0: 20 69 6e 74 20 72 63 2c 20 69 3b 0a 20 20 63 68   int rc, i;.  ch
83c0: 61 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b  ar *zErrMsg = 0;
83d0: 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20  ..  /* Allocate 
83e0: 74 68 65 20 73 71 6c 69 74 65 20 64 61 74 61 20  the sqlite data 
83f0: 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 64  structure */.  d
8400: 62 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63  b = sqliteMalloc
8410: 28 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 29  ( sizeof(sqlite)
8420: 20 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20   );.  if( db==0 
8430: 29 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75  ) goto opendb_ou
8440: 74 3b 0a 20 20 64 62 2d 3e 70 72 69 6f 72 4e 65  t;.  db->priorNe
8450: 77 52 6f 77 69 64 20 3d 20 30 3b 0a 20 20 64 62  wRowid = 0;.  db
8460: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
8470: 5f 4d 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64  _MAGIC_BUSY;.  d
8480: 62 2d 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62  b->nDb = 2;.  db
8490: 2d 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53  ->aDb = db->aDbS
84a0: 74 61 74 69 63 3b 0a 20 20 64 62 2d 3e 65 6e 63  tatic;.  db->enc
84b0: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a   = SQLITE_UTF8;.
84c0: 20 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74    db->autoCommit
84d0: 20 3d 20 31 3b 0a 20 20 2f 2a 20 64 62 2d 3e 66   = 1;.  /* db->f
84e0: 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 53  lags |= SQLITE_S
84f0: 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 3b 20 2a 2f  hortColNames; */
8500: 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e  .  sqlite3HashIn
8510: 69 74 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 53  it(&db->aFunc, S
8520: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
8530: 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 33  G, 0);.  sqlite3
8540: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 43  HashInit(&db->aC
8550: 6f 6c 6c 53 65 71 2c 20 53 51 4c 49 54 45 5f 48  ollSeq, SQLITE_H
8560: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
8570: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d    for(i=0; i<db-
8580: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  >nDb; i++){.    
8590: 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28  sqlite3HashInit(
85a0: 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 74 62 6c 48  &db->aDb[i].tblH
85b0: 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  ash, SQLITE_HASH
85c0: 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 20  _STRING, 0);.   
85d0: 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74   sqlite3HashInit
85e0: 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 64 78  (&db->aDb[i].idx
85f0: 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53  Hash, SQLITE_HAS
8600: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20  H_STRING, 0);.  
8610: 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69    sqlite3HashIni
8620: 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 74 72  t(&db->aDb[i].tr
8630: 69 67 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48  igHash, SQLITE_H
8640: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
8650: 20 20 20 20 73 71 6c 69 74 65 33 48 61 73 68 49      sqlite3HashI
8660: 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e  nit(&db->aDb[i].
8670: 61 46 4b 65 79 2c 20 53 51 4c 49 54 45 5f 48 41  aFKey, SQLITE_HA
8680: 53 48 5f 53 54 52 49 4e 47 2c 20 31 29 3b 0a 20  SH_STRING, 1);. 
8690: 20 7d 0a 20 20 0a 20 20 2f 2a 20 41 64 64 20 74   }.  .  /* Add t
86a0: 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61  he default colla
86b0: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 42 49  tion sequence BI
86c0: 4e 41 52 59 2e 20 42 49 4e 41 52 59 20 77 6f 72  NARY. BINARY wor
86d0: 6b 73 20 66 6f 72 20 62 6f 74 68 20 55 54 46 2d  ks for both UTF-
86e0: 38 0a 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d 31  8.  ** and UTF-1
86f0: 36 2c 20 73 6f 20 61 64 64 20 61 20 76 65 72 73  6, so add a vers
8700: 69 6f 6e 20 66 6f 72 20 65 61 63 68 20 74 6f 20  ion for each to 
8710: 61 76 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63 65  avoid any unnece
8720: 73 73 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 65  ssary.  ** conve
8730: 72 73 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c 79  rsions. The only
8740: 20 65 72 72 6f 72 20 74 68 61 74 20 63 61 6e 20   error that can 
8750: 6f 63 63 75 72 20 68 65 72 65 20 69 73 20 61 20  occur here is a 
8760: 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65  malloc() failure
8770: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ..  */.  sqlite3
8780: 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f  _create_collatio
8790: 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20  n(db, "BINARY", 
87a0: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 62  SQLITE_UTF8, 0,b
87b0: 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75  inaryCollatingFu
87c0: 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63  nc);.  sqlite3_c
87d0: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
87e0: 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51  db, "BINARY", SQ
87f0: 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 30 2c  LITE_UTF16LE, 0,
8800: 62 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46  binaryCollatingF
8810: 75 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f  unc);.  sqlite3_
8820: 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e  create_collation
8830: 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53  (db, "BINARY", S
8840: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 30  QLITE_UTF16BE, 0
8850: 2c 62 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67  ,binaryCollating
8860: 46 75 6e 63 29 3b 0a 20 20 64 62 2d 3e 70 44 66  Func);.  db->pDf
8870: 6c 74 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33  ltColl = sqlite3
8880: 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20  FindCollSeq(db, 
8890: 64 62 2d 3e 65 6e 63 2c 20 22 42 49 4e 41 52 59  db->enc, "BINARY
88a0: 22 2c 20 36 2c 20 30 29 3b 0a 20 20 69 66 28 20  ", 6, 0);.  if( 
88b0: 21 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 29  !db->pDfltColl )
88c0: 7b 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 65  {.    rc = db->e
88d0: 72 72 43 6f 64 65 3b 0a 20 20 20 20 61 73 73 65  rrCode;.    asse
88e0: 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  rt( rc!=SQLITE_O
88f0: 4b 20 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67  K );.    db->mag
8900: 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49  ic = SQLITE_MAGI
8910: 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f  C_CLOSED;.    go
8920: 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20  to opendb_out;. 
8930: 20 7d 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64   }..  /* Also ad
8940: 64 20 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69  d a UTF-8 case-i
8950: 6e 73 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61  nsensitive colla
8960: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a  tion sequence. *
8970: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61  /.  sqlite3_crea
8980: 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c  te_collation(db,
8990: 20 22 4e 4f 43 41 53 45 22 2c 20 53 51 4c 49 54   "NOCASE", SQLIT
89a0: 45 5f 55 54 46 38 2c 20 30 2c 20 6e 6f 63 61 73  E_UTF8, 0, nocas
89b0: 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 29 3b  eCollatingFunc);
89c0: 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20  ..  /* Open the 
89d0: 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65  backend database
89e0: 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 69 66 28   driver */.  if(
89f0: 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 3d 3d 27   zFilename[0]=='
8a00: 3a 27 20 26 26 20 73 74 72 63 6d 70 28 7a 46 69  :' && strcmp(zFi
8a10: 6c 65 6e 61 6d 65 2c 22 3a 6d 65 6d 6f 72 79 3a  lename,":memory:
8a20: 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d  ")==0 ){.    db-
8a30: 3e 74 65 6d 70 5f 73 74 6f 72 65 20 3d 20 32 3b  >temp_store = 2;
8a40: 0a 20 20 20 20 64 62 2d 3e 6e 4d 61 73 74 65 72  .    db->nMaster
8a50: 20 3d 20 30 3b 20 20 20 20 2f 2a 20 44 69 73 61   = 0;    /* Disa
8a60: 62 6c 65 20 61 74 6f 6d 69 63 20 6d 75 6c 74 69  ble atomic multi
8a70: 2d 66 69 6c 65 20 63 6f 6d 6d 69 74 20 66 6f 72  -file commit for
8a80: 20 3a 6d 65 6d 6f 72 79 3a 20 2a 2f 0a 20 20 7d   :memory: */.  }
8a90: 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 6e 4d  else{.    db->nM
8aa0: 61 73 74 65 72 20 3d 20 2d 31 3b 20 20 20 2f 2a  aster = -1;   /*
8ab0: 20 53 69 7a 65 20 6f 66 20 6d 61 73 74 65 72 20   Size of master 
8ac0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65  journal filename
8ad0: 20 69 6e 69 74 69 61 6c 6c 79 20 75 6e 6b 6e 6f   initially unkno
8ae0: 77 6e 20 2a 2f 0a 20 20 7d 0a 20 20 72 63 20 3d  wn */.  }.  rc =
8af0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63   sqlite3BtreeFac
8b00: 74 6f 72 79 28 64 62 2c 20 7a 46 69 6c 65 6e 61  tory(db, zFilena
8b10: 6d 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47 45 53  me, 0, MAX_PAGES
8b20: 2c 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42  , &db->aDb[0].pB
8b30: 74 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51  t);.  if( rc!=SQ
8b40: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73  LITE_OK ){.    s
8b50: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
8b60: 72 63 2c 20 30 29 3b 0a 20 20 20 20 64 62 2d 3e  rc, 0);.    db->
8b70: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d  magic = SQLITE_M
8b80: 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 20  AGIC_CLOSED;.   
8b90: 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74   goto opendb_out
8ba0: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b  ;.  }.  db->aDb[
8bb0: 30 5d 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69 6e  0].zName = "main
8bc0: 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e  ";.  db->aDb[1].
8bd0: 7a 4e 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a  zName = "temp";.
8be0: 0a 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 61  .  /* Register a
8bf0: 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63  ll built-in func
8c00: 74 69 6f 6e 73 2c 20 62 75 74 20 64 6f 20 6e 6f  tions, but do no
8c10: 74 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 61  t attempt to rea
8c20: 64 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62  d the.  ** datab
8c30: 61 73 65 20 73 63 68 65 6d 61 20 79 65 74 2e 20  ase schema yet. 
8c40: 54 68 69 73 20 69 73 20 64 65 6c 61 79 65 64 20  This is delayed 
8c50: 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20  until the first 
8c60: 74 69 6d 65 20 74 68 65 20 64 61 74 61 62 61 73  time the databas
8c70: 65 0a 20 20 2a 2a 20 69 73 20 61 63 63 65 73 73  e.  ** is access
8c80: 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74  ed..  */.  sqlit
8c90: 65 33 52 65 67 69 73 74 65 72 42 75 69 6c 74 69  e3RegisterBuilti
8ca0: 6e 46 75 6e 63 74 69 6f 6e 73 28 64 62 29 3b 0a  nFunctions(db);.
8cb0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
8cc0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  _OK ){.    sqlit
8cd0: 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49  e3Error(db, SQLI
8ce0: 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20 20 64  TE_OK, 0);.    d
8cf0: 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54  b->magic = SQLIT
8d00: 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20  E_MAGIC_OPEN;.  
8d10: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74  }else{.    sqlit
8d20: 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20  e3Error(db, rc, 
8d30: 22 25 73 22 2c 20 7a 45 72 72 4d 73 67 2c 20 30  "%s", zErrMsg, 0
8d40: 29 3b 0a 20 20 20 20 69 66 28 20 7a 45 72 72 4d  );.    if( zErrM
8d50: 73 67 20 29 20 73 71 6c 69 74 65 46 72 65 65 28  sg ) sqliteFree(
8d60: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 64 62  zErrMsg);.    db
8d70: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
8d80: 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20  _MAGIC_CLOSED;. 
8d90: 20 7d 0a 0a 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a   }..opendb_out:.
8da0: 20 20 2a 70 70 44 62 20 3d 20 64 62 3b 0a 20 20    *ppDb = db;.  
8db0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 65  return sqlite3_e
8dc0: 72 72 63 6f 64 65 28 64 62 29 3b 0a 7d 0a 0a 2f  rrcode(db);.}../
8dd0: 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20  *.** Open a new 
8de0: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e  database handle.
8df0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
8e00: 6f 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68  open(.  const ch
8e10: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a  ar *zFilename, .
8e20: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62    sqlite3 **ppDb
8e30: 20 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70   .){.  return op
8e40: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65  enDatabase(zFile
8e50: 6e 61 6d 65 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a  name, ppDb);.}..
8e60: 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77  /*.** Open a new
8e70: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
8e80: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
8e90: 5f 6f 70 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74  _open16(.  const
8ea0: 20 76 6f 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65   void *zFilename
8eb0: 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70  , .  sqlite3 **p
8ec0: 70 44 62 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f  pDb.){.  char co
8ed0: 6e 73 74 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b  nst *zFilename8;
8ee0: 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20     /* zFilename 
8ef0: 65 6e 63 6f 64 65 64 20 69 6e 20 55 54 46 2d 38  encoded in UTF-8
8f00: 20 69 6e 73 74 65 61 64 20 6f 66 20 55 54 46 2d   instead of UTF-
8f10: 31 36 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d  16 */.  int rc =
8f20: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
8f30: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
8f40: 70 56 61 6c 3b 0a 0a 20 20 61 73 73 65 72 74 28  pVal;..  assert(
8f50: 20 70 70 44 62 20 29 3b 0a 20 20 2a 70 70 44 62   ppDb );.  *ppDb
8f60: 20 3d 20 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73   = 0;.  pVal = s
8f70: 71 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 28 29  qlite3ValueNew()
8f80: 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65  ;.  sqlite3Value
8f90: 53 65 74 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c  SetStr(pVal, -1,
8fa0: 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49   zFilename, SQLI
8fb0: 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20  TE_UTF16NATIVE, 
8fc0: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
8fd0: 20 20 7a 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73    zFilename8 = s
8fe0: 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28  qlite3ValueText(
8ff0: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  pVal, SQLITE_UTF
9000: 38 29 3b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e  8);.  if( zFilen
9010: 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 63 20 3d  ame8 ){.    rc =
9020: 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46   openDatabase(zF
9030: 69 6c 65 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b  ilename8, ppDb);
9040: 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  .    if( rc==SQL
9050: 49 54 45 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20  ITE_OK && *ppDb 
9060: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
9070: 5f 65 78 65 63 28 2a 70 70 44 62 2c 20 22 50 52  _exec(*ppDb, "PR
9080: 41 47 4d 41 20 65 6e 63 6f 64 69 6e 67 20 3d 20  AGMA encoding = 
9090: 27 55 54 46 2d 31 36 27 22 2c 20 30 2c 20 30 2c  'UTF-16'", 0, 0,
90a0: 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20   0);.    }.  }. 
90b0: 20 69 66 28 20 70 56 61 6c 20 29 7b 0a 20 20 20   if( pVal ){.   
90c0: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65   sqlite3ValueFre
90d0: 65 28 70 56 61 6c 29 3b 0a 20 20 7d 0a 0a 20 20  e(pVal);.  }..  
90e0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
90f0: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
9100: 67 20 72 6f 75 74 69 6e 65 20 64 65 73 74 72 6f  g routine destro
9110: 79 73 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63  ys a virtual mac
9120: 68 69 6e 65 20 74 68 61 74 20 69 73 20 63 72 65  hine that is cre
9130: 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 73  ated by.** the s
9140: 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 28 29  qlite3_compile()
9150: 20 72 6f 75 74 69 6e 65 2e 20 54 68 65 20 69 6e   routine. The in
9160: 74 65 67 65 72 20 72 65 74 75 72 6e 65 64 20 69  teger returned i
9170: 73 20 61 6e 20 53 51 4c 49 54 45 5f 0a 2a 2a 20  s an SQLITE_.** 
9180: 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20  success/failure 
9190: 63 6f 64 65 20 74 68 61 74 20 64 65 73 63 72 69  code that descri
91a0: 62 65 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f  bes the result o
91b0: 66 20 65 78 65 63 75 74 69 6e 67 20 74 68 65 20  f executing the 
91c0: 76 69 72 74 75 61 6c 0a 2a 2a 20 6d 61 63 68 69  virtual.** machi
91d0: 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  ne..**.** This r
91e0: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
91f0: 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73  error code and s
9200: 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62  tring returned b
9210: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72  y.** sqlite3_err
9220: 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f  code(), sqlite3_
9230: 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c  errmsg() and sql
9240: 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e  ite3_errmsg16().
9250: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
9260: 66 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 33  finalize(sqlite3
9270: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
9280: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
9290: 64 62 65 46 69 6e 61 6c 69 7a 65 28 28 56 64 62  dbeFinalize((Vdb
92a0: 65 2a 29 70 53 74 6d 74 2c 20 30 29 3b 0a 7d 0a  e*)pStmt, 0);.}.
92b0: 0a 2f 2a 0a 2a 2a 20 54 65 72 6d 69 6e 61 74 65  ./*.** Terminate
92c0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 65 78 65   the current exe
92d0: 63 75 74 69 6f 6e 20 6f 66 20 61 6e 20 53 51 4c  cution of an SQL
92e0: 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72   statement and r
92f0: 65 73 65 74 20 69 74 0a 2a 2a 20 62 61 63 6b 20  eset it.** back 
9300: 74 6f 20 69 74 73 20 73 74 61 72 74 69 6e 67 20  to its starting 
9310: 73 74 61 74 65 20 73 6f 20 74 68 61 74 20 69 74  state so that it
9320: 20 63 61 6e 20 62 65 20 72 65 75 73 65 64 2e 20   can be reused. 
9330: 41 20 73 75 63 63 65 73 73 20 63 6f 64 65 20 66  A success code f
9340: 72 6f 6d 0a 2a 2a 20 74 68 65 20 70 72 69 6f 72  rom.** the prior
9350: 20 65 78 65 63 75 74 69 6f 6e 20 69 73 20 72 65   execution is re
9360: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  turned..**.** Th
9370: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20  is routine sets 
9380: 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 61  the error code a
9390: 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 72 6e  nd string return
93a0: 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33  ed by.** sqlite3
93b0: 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 6c 69  _errcode(), sqli
93c0: 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e 64  te3_errmsg() and
93d0: 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31   sqlite3_errmsg1
93e0: 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  6()..*/.int sqli
93f0: 74 65 33 5f 72 65 73 65 74 28 73 71 6c 69 74 65  te3_reset(sqlite
9400: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a  3_stmt *pStmt){.
9410: 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 74    int rc = sqlit
9420: 65 33 56 64 62 65 52 65 73 65 74 28 28 56 64 62  e3VdbeReset((Vdb
9430: 65 2a 29 70 53 74 6d 74 2c 20 30 29 3b 0a 20 20  e*)pStmt, 0);.  
9440: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52  sqlite3VdbeMakeR
9450: 65 61 64 79 28 28 56 64 62 65 2a 29 70 53 74 6d  eady((Vdbe*)pStm
9460: 74 2c 20 2d 31 2c 20 30 29 3b 0a 20 20 72 65 74  t, -1, 0);.  ret
9470: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
9480: 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 20   Register a new 
9490: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e  collation sequen
94a0: 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74 61  ce with the data
94b0: 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a  base handle db..
94c0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
94d0: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
94e0: 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20  .  sqlite3* db, 
94f0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
9500: 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63  Name, .  int enc
9510: 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c  , .  void* pCtx,
9520: 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65  .  int(*xCompare
9530: 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73  )(void*,int,cons
9540: 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73  t void*,int,cons
9550: 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 43 6f  t void*).){.  Co
9560: 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 3b 0a 20 20  llSeq *pColl;.  
9570: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
9580: 4f 4b 3b 0a 20 20 0a 20 20 2f 2a 20 49 66 20 53  OK;.  .  /* If S
9590: 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 73  QLITE_UTF16 is s
95a0: 70 65 63 69 66 69 65 64 20 61 73 20 74 68 65 20  pecified as the 
95b0: 65 6e 63 6f 64 69 6e 67 20 74 79 70 65 2c 20 74  encoding type, t
95c0: 72 61 6e 73 66 6f 72 6d 20 74 68 69 73 0a 20 20  ransform this.  
95d0: 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66 20 53 51 4c  ** to one of SQL
95e0: 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53  ITE_UTF16LE or S
95f0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 75 73  QLITE_UTF16BE us
9600: 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c  ing the.  ** SQL
9610: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20  ITE_UTF16NATIVE 
9620: 6d 61 63 72 6f 2e 20 53 51 4c 49 54 45 5f 55 54  macro. SQLITE_UT
9630: 46 31 36 20 69 73 20 6e 6f 74 20 75 73 65 64 20  F16 is not used 
9640: 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f  internally..  */
9650: 0a 20 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49  .  if( enc==SQLI
9660: 54 45 5f 55 54 46 31 36 20 29 7b 0a 20 20 20 20  TE_UTF16 ){.    
9670: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46  enc = SQLITE_UTF
9680: 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d 0a 0a 20  16NATIVE;.  }.. 
9690: 20 69 66 28 20 65 6e 63 21 3d 53 51 4c 49 54 45   if( enc!=SQLITE
96a0: 5f 55 54 46 38 20 26 26 20 65 6e 63 21 3d 53 51  _UTF8 && enc!=SQ
96b0: 4c 49 54 45 5f 55 54 46 31 36 4c 45 20 26 26 20  LITE_UTF16LE && 
96c0: 65 6e 63 21 3d 53 51 4c 49 54 45 5f 55 54 46 31  enc!=SQLITE_UTF1
96d0: 36 42 45 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  6BE ){.    sqlit
96e0: 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49  e3Error(db, SQLI
96f0: 54 45 5f 45 52 52 4f 52 2c 20 0a 20 20 20 20 20  TE_ERROR, .     
9700: 20 20 20 22 50 61 72 61 6d 20 33 20 74 6f 20 73     "Param 3 to s
9710: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f  qlite3_create_co
9720: 6c 6c 61 74 69 6f 6e 28 29 20 6d 75 73 74 20 62  llation() must b
9730: 65 20 6f 6e 65 20 6f 66 20 22 0a 20 20 20 20 20  e one of ".     
9740: 20 20 20 22 53 51 4c 49 54 45 5f 55 54 46 38 2c     "SQLITE_UTF8,
9750: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 2c 20 53   SQLITE_UTF16, S
9760: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72  QLITE_UTF16LE or
9770: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 22   SQLITE_UTF16BE"
9780: 0a 20 20 20 20 29 3b 0a 20 20 20 20 72 65 74 75  .    );.    retu
9790: 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b  rn SQLITE_ERROR;
97a0: 0a 20 20 7d 0a 20 20 70 43 6f 6c 6c 20 3d 20 73  .  }.  pColl = s
97b0: 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65  qlite3FindCollSe
97c0: 71 28 64 62 2c 20 28 75 38 29 65 6e 63 2c 20 7a  q(db, (u8)enc, z
97d0: 4e 61 6d 65 2c 20 73 74 72 6c 65 6e 28 7a 4e 61  Name, strlen(zNa
97e0: 6d 65 29 2c 20 31 29 3b 0a 20 20 69 66 28 20 30  me), 1);.  if( 0
97f0: 3d 3d 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 72 63  ==pColl ){.   rc
9800: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b   = SQLITE_NOMEM;
9810: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43  .  }else{.    pC
9820: 6f 6c 6c 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d  oll->xCmp = xCom
9830: 70 61 72 65 3b 0a 20 20 20 20 70 43 6f 6c 6c 2d  pare;.    pColl-
9840: 3e 70 55 73 65 72 20 3d 20 70 43 74 78 3b 0a 20  >pUser = pCtx;. 
9850: 20 7d 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f   }.  sqlite3Erro
9860: 72 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20  r(db, rc, 0);.  
9870: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
9880: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 6e  .** Register a n
9890: 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71  ew collation seq
98a0: 75 65 6e 63 65 20 77 69 74 68 20 74 68 65 20 64  uence with the d
98b0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64  atabase handle d
98c0: 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  b..*/.int sqlite
98d0: 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69  3_create_collati
98e0: 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 65 33 2a  on16(.  sqlite3*
98f0: 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68   db, .  const ch
9900: 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e  ar *zName, .  in
9910: 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20  t enc, .  void* 
9920: 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f  pCtx,.  int(*xCo
9930: 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74  mpare)(void*,int
9940: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74  ,const void*,int
9950: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b  ,const void*).){
9960: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 68 61  .  int rc;.  cha
9970: 72 20 63 6f 6e 73 74 20 2a 7a 4e 61 6d 65 38 3b  r const *zName8;
9980: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  .  sqlite3_value
9990: 20 2a 70 54 6d 70 20 3d 20 73 71 6c 69 74 65 33   *pTmp = sqlite3
99a0: 47 65 74 54 72 61 6e 73 69 65 6e 74 56 61 6c 75  GetTransientValu
99b0: 65 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33  e(db);.  sqlite3
99c0: 56 61 6c 75 65 53 65 74 53 74 72 28 70 54 6d 70  ValueSetStr(pTmp
99d0: 2c 20 2d 31 2c 20 7a 4e 61 6d 65 2c 20 53 51 4c  , -1, zName, SQL
99e0: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c  ITE_UTF16NATIVE,
99f0: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
9a00: 0a 20 20 7a 4e 61 6d 65 38 20 3d 20 73 71 6c 69  .  zName8 = sqli
9a10: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 54 6d  te3ValueText(pTm
9a20: 70 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b  p, SQLITE_UTF8);
9a30: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
9a40: 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69  3_create_collati
9a50: 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 38 2c 20 65  on(db, zName8, e
9a60: 6e 63 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61  nc, pCtx, xCompa
9a70: 72 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  re);.}../*.** Re
9a80: 67 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69  gister a collati
9a90: 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74  on sequence fact
9aa0: 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74  ory callback wit
9ab0: 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68  h the database h
9ac0: 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70  andle.** db. Rep
9ad0: 6c 61 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75  lace any previou
9ae0: 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f  sly installed co
9af0: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65  llation sequence
9b00: 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74   factory..*/.int
9b10: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69   sqlite3_collati
9b20: 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 20 73 71 6c  on_needed(.  sql
9b30: 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69  ite3 *db, .  voi
9b40: 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72  d *pCollNeededAr
9b50: 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c  g, .  void(*xCol
9b60: 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 2a 2c 73  lNeeded)(void*,s
9b70: 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 78  qlite3*,int eTex
9b80: 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a  tRep,const char*
9b90: 29 0a 29 7b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c  ).){.  db->xColl
9ba0: 4e 65 65 64 65 64 20 3d 20 78 43 6f 6c 6c 4e 65  Needed = xCollNe
9bb0: 65 64 65 64 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c  eded;.  db->xCol
9bc0: 6c 4e 65 65 64 65 64 31 36 20 3d 20 30 3b 0a 20  lNeeded16 = 0;. 
9bd0: 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64   db->pCollNeeded
9be0: 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65  Arg = pCollNeede
9bf0: 64 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53  dArg;.  return S
9c00: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
9c10: 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 6f  ** Register a co
9c20: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65  llation sequence
9c30: 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63   factory callbac
9c40: 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62  k with the datab
9c50: 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62  ase handle.** db
9c60: 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72  . Replace any pr
9c70: 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c  eviously install
9c80: 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71  ed collation seq
9c90: 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a  uence factory..*
9ca0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f  /.int sqlite3_co
9cb0: 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 31 36  llation_needed16
9cc0: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c  (.  sqlite3 *db,
9cd0: 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e   .  void *pCollN
9ce0: 65 65 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69  eededArg, .  voi
9cf0: 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36  d(*xCollNeeded16
9d00: 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a  )(void*,sqlite3*
9d10: 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f  ,int eTextRep,co
9d20: 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20  nst void*).){.  
9d30: 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 20  db->xCollNeeded 
9d40: 3d 20 30 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c  = 0;.  db->xColl
9d50: 4e 65 65 64 65 64 31 36 20 3d 20 78 43 6f 6c 6c  Needed16 = xColl
9d60: 4e 65 65 64 65 64 31 36 3b 0a 20 20 64 62 2d 3e  Needed16;.  db->
9d70: 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 20 3d  pCollNeededArg =
9d80: 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b   pCollNeededArg;
9d90: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
9da0: 5f 4f 4b 3b 0a 7d 0a                             _OK;.}.