/ Hex Artifact Content
Login

Artifact 2a4f3fe32ee6357b5b914ab5e2bd0979202570f4:


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 33 33 20 32 30 30 34 2f 30 36  ,v 1.233 2004/06
0280: 2f 32 32 20 31 32 3a 31 33 3a 35 35 20 64 72 68  /22 12:13:55 drh
0290: 20 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75   Exp $.*/.#inclu
02a0: 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22  de "sqliteInt.h"
02b0: 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22  .#include "os.h"
02c0: 0a 23 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65  .#include <ctype
02d0: 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 6f 69  .h>../*.** A poi
02e0: 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 72  nter to this str
02f0: 75 63 74 75 72 65 20 69 73 20 75 73 65 64 20 74  ucture is used t
0300: 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 69 6e  o communicate in
0310: 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 6f  formation.** fro
0320: 6d 20 73 71 6c 69 74 65 33 49 6e 69 74 20 69 6e  m sqlite3Init in
0330: 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 49 6e  to the sqlite3In
0340: 69 74 43 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 74  itCallback..*/.t
0350: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 7b 0a  ypedef struct {.
0360: 20 20 73 71 6c 69 74 65 20 2a 64 62 3b 20 20 20    sqlite *db;   
0370: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74        /* The dat
0380: 61 62 61 73 65 20 62 65 69 6e 67 20 69 6e 69 74  abase being init
0390: 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 63 68 61  ialized */.  cha
03a0: 72 20 2a 2a 70 7a 45 72 72 4d 73 67 3b 20 20 20  r **pzErrMsg;   
03b0: 20 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67   /* Error messag
03c0: 65 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f  e stored here */
03d0: 0a 7d 20 49 6e 69 74 44 61 74 61 3b 0a 0a 2f 2a  .} InitData;../*
03e0: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
03f0: 67 20 63 6f 6e 73 74 61 6e 74 20 76 61 6c 75 65  g constant value
0400: 20 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20   is used by the 
0410: 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e  SQLITE_BIGENDIAN
0420: 20 61 6e 64 0a 2a 2a 20 53 51 4c 49 54 45 5f 4c   and.** SQLITE_L
0430: 49 54 54 4c 45 45 4e 44 49 41 4e 20 6d 61 63 72  ITTLEENDIAN macr
0440: 6f 73 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 69 6e 74  os..*/.const int
0450: 20 73 71 6c 69 74 65 33 6f 6e 65 20 3d 20 31 3b   sqlite3one = 1;
0460: 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 6c 20 74 68 65  ../*.** Fill the
0470: 20 49 6e 69 74 44 61 74 61 20 73 74 72 75 63 74   InitData struct
0480: 75 72 65 20 77 69 74 68 20 61 6e 20 65 72 72 6f  ure with an erro
0490: 72 20 6d 65 73 73 61 67 65 20 74 68 61 74 20 69  r message that i
04a0: 6e 64 69 63 61 74 65 73 0a 2a 2a 20 74 68 61 74  ndicates.** that
04b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
04c0: 20 63 6f 72 72 75 70 74 2e 0a 2a 2f 0a 73 74 61   corrupt..*/.sta
04d0: 74 69 63 20 76 6f 69 64 20 63 6f 72 72 75 70 74  tic void corrupt
04e0: 53 63 68 65 6d 61 28 49 6e 69 74 44 61 74 61 20  Schema(InitData 
04f0: 2a 70 44 61 74 61 2c 20 63 6f 6e 73 74 20 63 68  *pData, const ch
0500: 61 72 20 2a 7a 45 78 74 72 61 29 7b 0a 20 20 73  ar *zExtra){.  s
0510: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28  qlite3SetString(
0520: 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73 67 2c  pData->pzErrMsg,
0530: 20 22 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74 61   "malformed data
0540: 62 61 73 65 20 73 63 68 65 6d 61 22 2c 0a 20 20  base schema",.  
0550: 20 20 20 7a 45 78 74 72 61 21 3d 30 20 26 26 20     zExtra!=0 && 
0560: 7a 45 78 74 72 61 5b 30 5d 21 3d 30 20 3f 20 22  zExtra[0]!=0 ? "
0570: 20 2d 20 22 20 3a 20 28 63 68 61 72 2a 29 30 2c   - " : (char*)0,
0580: 20 7a 45 78 74 72 61 2c 20 28 63 68 61 72 2a 29   zExtra, (char*)
0590: 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  0);.}../*.** Thi
05a0: 73 20 69 73 20 74 68 65 20 63 61 6c 6c 62 61 63  s is the callbac
05b0: 6b 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 74 68  k routine for th
05c0: 65 20 63 6f 64 65 20 74 68 61 74 20 69 6e 69 74  e code that init
05d0: 69 61 6c 69 7a 65 73 20 74 68 65 0a 2a 2a 20 64  ializes the.** d
05e0: 61 74 61 62 61 73 65 2e 20 20 53 65 65 20 73 71  atabase.  See sq
05f0: 6c 69 74 65 33 49 6e 69 74 28 29 20 62 65 6c 6f  lite3Init() belo
0600: 77 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  w for additional
0610: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2a   information..**
0620: 0a 2a 2a 20 45 61 63 68 20 63 61 6c 6c 62 61 63  .** Each callbac
0630: 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66  k contains the f
0640: 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61  ollowing informa
0650: 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  tion:.**.**     
0660: 61 72 67 76 5b 30 5d 20 3d 20 22 66 69 6c 65 2d  argv[0] = "file-
0670: 66 6f 72 6d 61 74 22 20 6f 72 20 22 73 63 68 65  format" or "sche
0680: 6d 61 2d 63 6f 6f 6b 69 65 22 20 6f 72 20 22 74  ma-cookie" or "t
0690: 61 62 6c 65 22 20 6f 72 20 22 69 6e 64 65 78 22  able" or "index"
06a0: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 31 5d 20  .**     argv[1] 
06b0: 3d 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  = table or index
06c0: 20 6e 61 6d 65 20 6f 72 20 6d 65 74 61 20 73 74   name or meta st
06d0: 61 74 65 6d 65 6e 74 20 74 79 70 65 2e 0a 2a 2a  atement type..**
06e0: 20 20 20 20 20 61 72 67 76 5b 32 5d 20 3d 20 72       argv[2] = r
06f0: 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20  oot page number 
0700: 66 6f 72 20 74 61 62 6c 65 20 6f 72 20 69 6e 64  for table or ind
0710: 65 78 2e 20 20 4e 55 4c 4c 20 66 6f 72 20 6d 65  ex.  NULL for me
0720: 74 61 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  ta..**     argv[
0730: 33 5d 20 3d 20 53 51 4c 20 74 65 78 74 20 66 6f  3] = SQL text fo
0740: 72 20 61 20 43 52 45 41 54 45 20 54 41 42 4c 45  r a CREATE TABLE
0750: 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44 45 58   or CREATE INDEX
0760: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 20   statement..**  
0770: 20 20 20 61 72 67 76 5b 34 5d 20 3d 20 22 31 22     argv[4] = "1"
0780: 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 66   for temporary f
0790: 69 6c 65 73 2c 20 22 30 22 20 66 6f 72 20 6d 61  iles, "0" for ma
07a0: 69 6e 20 64 61 74 61 62 61 73 65 2c 20 22 32 22  in database, "2"
07b0: 20 6f 72 20 6d 6f 72 65 0a 2a 2a 20 20 20 20 20   or more.**     
07c0: 20 20 20 20 20 20 20 20 20 20 66 6f 72 20 61 75            for au
07d0: 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73 65  xiliary database
07e0: 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2f 0a 73 74   files..**.*/.st
07f0: 61 74 69 63 0a 69 6e 74 20 73 71 6c 69 74 65 33  atic.int sqlite3
0800: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76 6f 69  InitCallback(voi
0810: 64 20 2a 70 49 6e 69 74 2c 20 69 6e 74 20 61 72  d *pInit, int ar
0820: 67 63 2c 20 63 68 61 72 20 2a 2a 61 72 67 76 2c  gc, char **argv,
0830: 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 4e 61 6d   char **azColNam
0840: 65 29 7b 0a 20 20 49 6e 69 74 44 61 74 61 20 2a  e){.  InitData *
0850: 70 44 61 74 61 20 3d 20 28 49 6e 69 74 44 61 74  pData = (InitDat
0860: 61 2a 29 70 49 6e 69 74 3b 0a 20 20 69 6e 74 20  a*)pInit;.  int 
0870: 6e 45 72 72 20 3d 20 30 3b 0a 0a 20 20 61 73 73  nErr = 0;..  ass
0880: 65 72 74 28 20 61 72 67 63 3d 3d 35 20 29 3b 0a  ert( argc==5 );.
0890: 20 20 69 66 28 20 61 72 67 76 3d 3d 30 20 29 20    if( argv==0 ) 
08a0: 72 65 74 75 72 6e 20 30 3b 20 20 20 2f 2a 20 4d  return 0;   /* M
08b0: 69 67 68 74 20 68 61 70 70 65 6e 20 69 66 20 45  ight happen if E
08c0: 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43 41 4c 4c  MPTY_RESULT_CALL
08d0: 42 41 43 4b 53 20 61 72 65 20 6f 6e 20 2a 2f 0a  BACKS are on */.
08e0: 20 20 69 66 28 20 61 72 67 76 5b 30 5d 3d 3d 30    if( argv[0]==0
08f0: 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53   ){.    corruptS
0900: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 30 29 3b  chema(pData, 0);
0910: 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20  .    return 1;. 
0920: 20 7d 0a 20 20 73 77 69 74 63 68 28 20 61 72 67   }.  switch( arg
0930: 76 5b 30 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 63  v[0][0] ){.    c
0940: 61 73 65 20 27 76 27 3a 0a 20 20 20 20 63 61 73  ase 'v':.    cas
0950: 65 20 27 69 27 3a 0a 20 20 20 20 63 61 73 65 20  e 'i':.    case 
0960: 27 74 27 3a 20 7b 20 20 2f 2a 20 43 52 45 41 54  't': {  /* CREAT
0970: 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54 45 20  E TABLE, CREATE 
0980: 49 4e 44 45 58 2c 20 6f 72 20 43 52 45 41 54 45  INDEX, or CREATE
0990: 20 56 49 45 57 20 73 74 61 74 65 6d 65 6e 74 73   VIEW statements
09a0: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65   */.      sqlite
09b0: 20 2a 64 62 20 3d 20 70 44 61 74 61 2d 3e 64 62   *db = pData->db
09c0: 3b 0a 20 20 20 20 20 20 69 66 28 20 61 72 67 76  ;.      if( argv
09d0: 5b 32 5d 3d 3d 30 20 7c 7c 20 61 72 67 76 5b 34  [2]==0 || argv[4
09e0: 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  ]==0 ){.        
09f0: 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44  corruptSchema(pD
0a00: 61 74 61 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  ata, 0);.       
0a10: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20   return 1;.     
0a20: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 61 72 67   }.      if( arg
0a30: 76 5b 33 5d 20 26 26 20 61 72 67 76 5b 33 5d 5b  v[3] && argv[3][
0a40: 30 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a  0] ){.        /*
0a50: 20 43 61 6c 6c 20 74 68 65 20 70 61 72 73 65 72   Call the parser
0a60: 20 74 6f 20 70 72 6f 63 65 73 73 20 61 20 43 52   to process a CR
0a70: 45 41 54 45 20 54 41 42 4c 45 2c 20 49 4e 44 45  EATE TABLE, INDE
0a80: 58 20 6f 72 20 56 49 45 57 2e 0a 20 20 20 20 20  X or VIEW..     
0a90: 20 20 20 2a 2a 20 42 75 74 20 62 65 63 61 75 73     ** But becaus
0aa0: 65 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20  e db->init.busy 
0ab0: 69 73 20 73 65 74 20 74 6f 20 31 2c 20 6e 6f 20  is set to 1, no 
0ac0: 56 44 42 45 20 63 6f 64 65 20 69 73 20 67 65 6e  VDBE code is gen
0ad0: 65 72 61 74 65 64 0a 20 20 20 20 20 20 20 20 2a  erated.        *
0ae0: 2a 20 6f 72 20 65 78 65 63 75 74 65 64 2e 20 20  * or executed.  
0af0: 41 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 64  All the parser d
0b00: 6f 65 73 20 69 73 20 62 75 69 6c 64 20 74 68 65  oes is build the
0b10: 20 69 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a 20   internal data. 
0b20: 20 20 20 20 20 20 20 2a 2a 20 73 74 72 75 63 74         ** struct
0b30: 75 72 65 73 20 74 68 61 74 20 64 65 73 63 72 69  ures that descri
0b40: 62 65 20 74 68 65 20 74 61 62 6c 65 2c 20 69 6e  be the table, in
0b50: 64 65 78 2c 20 6f 72 20 76 69 65 77 2e 0a 20 20  dex, or view..  
0b60: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20        */.       
0b70: 20 63 68 61 72 20 2a 7a 45 72 72 3b 0a 20 20 20   char *zErr;.   
0b80: 20 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d       assert( db-
0b90: 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20 20  >init.busy );.  
0ba0: 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69        db->init.i
0bb0: 44 62 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 34  Db = atoi(argv[4
0bc0: 5d 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65  ]);.        asse
0bd0: 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 69 44 62  rt( db->init.iDb
0be0: 3e 3d 30 20 26 26 20 64 62 2d 3e 69 6e 69 74 2e  >=0 && db->init.
0bf0: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  iDb<db->nDb );. 
0c00: 20 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e         db->init.
0c10: 6e 65 77 54 6e 75 6d 20 3d 20 61 74 6f 69 28 61  newTnum = atoi(a
0c20: 72 67 76 5b 32 5d 29 3b 0a 20 20 20 20 20 20 20  rgv[2]);.       
0c30: 20 69 66 28 20 73 71 6c 69 74 65 33 5f 65 78 65   if( sqlite3_exe
0c40: 63 28 64 62 2c 20 61 72 67 76 5b 33 5d 2c 20 30  c(db, argv[3], 0
0c50: 2c 20 30 2c 20 26 7a 45 72 72 29 20 29 7b 0a 20  , 0, &zErr) ){. 
0c60: 20 20 20 20 20 20 20 20 20 63 6f 72 72 75 70 74           corrupt
0c70: 53 63 68 65 6d 61 28 70 44 61 74 61 2c 20 7a 45  Schema(pData, zE
0c80: 72 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73  rr);.          s
0c90: 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 72 72  qlite3_free(zErr
0ca0: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
0cb0: 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 44       db->init.iD
0cc0: 62 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c  b = 0;.      }el
0cd0: 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49  se{.        /* I
0ce0: 66 20 74 68 65 20 53 51 4c 20 63 6f 6c 75 6d 6e  f the SQL column
0cf0: 20 69 73 20 62 6c 61 6e 6b 20 69 74 20 6d 65 61   is blank it mea
0d00: 6e 73 20 74 68 69 73 20 69 73 20 61 6e 20 69 6e  ns this is an in
0d10: 64 65 78 20 74 68 61 74 0a 20 20 20 20 20 20 20  dex that.       
0d20: 20 2a 2a 20 77 61 73 20 63 72 65 61 74 65 64 20   ** was created 
0d30: 74 6f 20 62 65 20 74 68 65 20 50 52 49 4d 41 52  to be the PRIMAR
0d40: 59 20 4b 45 59 20 6f 72 20 74 6f 20 66 75 6c 66  Y KEY or to fulf
0d50: 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a 20 20 20  ill a UNIQUE.   
0d60: 20 20 20 20 20 2a 2a 20 63 6f 6e 73 74 72 61 69       ** constrai
0d70: 6e 74 20 66 6f 72 20 61 20 43 52 45 41 54 45 20  nt for a CREATE 
0d80: 54 41 42 4c 45 2e 20 20 54 68 65 20 69 6e 64 65  TABLE.  The inde
0d90: 78 20 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6c  x should have al
0da0: 72 65 61 64 79 0a 20 20 20 20 20 20 20 20 2a 2a  ready.        **
0db0: 20 62 65 65 6e 20 63 72 65 61 74 65 64 20 77 68   been created wh
0dc0: 65 6e 20 77 65 20 70 72 6f 63 65 73 73 65 64 20  en we processed 
0dd0: 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  the CREATE TABLE
0de0: 2e 20 20 41 6c 6c 20 77 65 20 68 61 76 65 0a 20  .  All we have. 
0df0: 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 64 6f 20         ** to do 
0e00: 68 65 72 65 20 69 73 20 72 65 63 6f 72 64 20 74  here is record t
0e10: 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d  he root page num
0e20: 62 65 72 20 66 6f 72 20 74 68 61 74 20 69 6e 64  ber for that ind
0e30: 65 78 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20  ex..        */. 
0e40: 20 20 20 20 20 20 20 69 6e 74 20 69 44 62 3b 0a         int iDb;.
0e50: 20 20 20 20 20 20 20 20 49 6e 64 65 78 20 2a 70          Index *p
0e60: 49 6e 64 65 78 3b 0a 0a 20 20 20 20 20 20 20 20  Index;..        
0e70: 69 44 62 20 3d 20 61 74 6f 69 28 61 72 67 76 5b  iDb = atoi(argv[
0e80: 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73  4]);.        ass
0e90: 65 72 74 28 20 69 44 62 3e 3d 30 20 26 26 20 69  ert( iDb>=0 && i
0ea0: 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20 20  Db<db->nDb );.  
0eb0: 20 20 20 20 20 20 70 49 6e 64 65 78 20 3d 20 73        pIndex = s
0ec0: 71 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 78 28  qlite3FindIndex(
0ed0: 64 62 2c 20 61 72 67 76 5b 31 5d 2c 20 64 62 2d  db, argv[1], db-
0ee0: 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29  >aDb[iDb].zName)
0ef0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 49  ;.        if( pI
0f00: 6e 64 65 78 3d 3d 30 20 7c 7c 20 70 49 6e 64 65  ndex==0 || pInde
0f10: 78 2d 3e 74 6e 75 6d 21 3d 30 20 29 7b 0a 20 20  x->tnum!=0 ){.  
0f20: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20          /* This 
0f30: 63 61 6e 20 6f 63 63 75 72 20 69 66 20 74 68 65  can occur if the
0f40: 72 65 20 65 78 69 73 74 73 20 61 6e 20 69 6e 64  re exists an ind
0f50: 65 78 20 6f 6e 20 61 20 54 45 4d 50 20 74 61 62  ex on a TEMP tab
0f60: 6c 65 20 77 68 69 63 68 0a 20 20 20 20 20 20 20  le which.       
0f70: 20 20 20 2a 2a 20 68 61 73 20 74 68 65 20 73 61     ** has the sa
0f80: 6d 65 20 6e 61 6d 65 20 61 73 20 61 6e 6f 74 68  me name as anoth
0f90: 65 72 20 69 6e 64 65 78 20 6f 6e 20 61 20 70 65  er index on a pe
0fa0: 72 6d 61 6e 65 6e 74 20 69 6e 64 65 78 2e 20 20  rmanent index.  
0fb0: 53 69 6e 63 65 0a 20 20 20 20 20 20 20 20 20 20  Since.          
0fc0: 2a 2a 20 74 68 65 20 70 65 72 6d 61 6e 65 6e 74  ** the permanent
0fd0: 20 74 61 62 6c 65 20 69 73 20 68 69 64 64 65 6e   table is hidden
0fe0: 20 62 79 20 74 68 65 20 54 45 4d 50 20 74 61 62   by the TEMP tab
0ff0: 6c 65 2c 20 77 65 20 63 61 6e 20 61 6c 73 6f 0a  le, we can also.
1000: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73 61 66            ** saf
1010: 65 6c 79 20 69 67 6e 6f 72 65 20 74 68 65 20 69  ely ignore the i
1020: 6e 64 65 78 20 6f 6e 20 74 68 65 20 70 65 72 6d  ndex on the perm
1030: 61 6e 65 6e 74 20 74 61 62 6c 65 2e 0a 20 20 20  anent table..   
1040: 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20         */.      
1050: 20 20 20 20 2f 2a 20 44 6f 20 4e 6f 74 68 69 6e      /* Do Nothin
1060: 67 20 2a 2f 3b 0a 20 20 20 20 20 20 20 20 7d 65  g */;.        }e
1070: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 70  lse{.          p
1080: 49 6e 64 65 78 2d 3e 74 6e 75 6d 20 3d 20 61 74  Index->tnum = at
1090: 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a 20 20 20  oi(argv[2]);.   
10a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20       }.      }. 
10b0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
10c0: 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b  }.    default: {
10d0: 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63  .      /* This c
10e0: 61 6e 20 6e 6f 74 20 68 61 70 70 65 6e 21 20 2a  an not happen! *
10f0: 2f 0a 20 20 20 20 20 20 6e 45 72 72 20 3d 20 31  /.      nErr = 1
1100: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  ;.      assert( 
1110: 6e 45 72 72 3d 3d 30 20 29 3b 0a 20 20 20 20 7d  nErr==0 );.    }
1120: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 45  .  }.  return nE
1130: 72 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74  rr;.}../*.** Att
1140: 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 65  empt to read the
1150: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61   database schema
1160: 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20   and initialize 
1170: 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64 61 74 61  internal.** data
1180: 20 73 74 72 75 63 74 75 72 65 73 20 66 6f 72 20   structures for 
1190: 61 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73  a single databas
11a0: 65 20 66 69 6c 65 2e 20 20 54 68 65 20 69 6e 64  e file.  The ind
11b0: 65 78 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74  ex of the.** dat
11c0: 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 67 69  abase file is gi
11d0: 76 65 6e 20 62 79 20 69 44 62 2e 20 20 69 44 62  ven by iDb.  iDb
11e0: 3d 3d 30 20 69 73 20 75 73 65 64 20 66 6f 72 20  ==0 is used for 
11f0: 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 64 61 74 61  the main.** data
1200: 62 61 73 65 2e 20 20 69 44 62 3d 3d 31 20 73 68  base.  iDb==1 sh
1210: 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 75 73  ould never be us
1220: 65 64 2e 20 20 69 44 62 3e 3d 32 20 69 73 20 75  ed.  iDb>=2 is u
1230: 73 65 64 20 66 6f 72 0a 2a 2a 20 61 75 78 69 6c  sed for.** auxil
1240: 69 61 72 79 20 64 61 74 61 62 61 73 65 73 2e 20  iary databases. 
1250: 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74   Return one of t
1260: 68 65 20 53 51 4c 49 54 45 5f 20 65 72 72 6f 72  he SQLITE_ error
1270: 20 63 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e 64   codes to.** ind
1280: 69 63 61 74 65 20 73 75 63 63 65 73 73 20 6f 72  icate success or
1290: 20 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 74 61   failure..*/.sta
12a0: 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 49  tic int sqlite3I
12b0: 6e 69 74 4f 6e 65 28 73 71 6c 69 74 65 20 2a 64  nitOne(sqlite *d
12c0: 62 2c 20 69 6e 74 20 69 44 62 2c 20 63 68 61 72  b, int iDb, char
12d0: 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20   **pzErrMsg){.  
12e0: 69 6e 74 20 72 63 3b 0a 20 20 42 74 43 75 72 73  int rc;.  BtCurs
12f0: 6f 72 20 2a 63 75 72 4d 61 69 6e 3b 0a 20 20 69  or *curMain;.  i
1300: 6e 74 20 73 69 7a 65 3b 0a 20 20 54 61 62 6c 65  nt size;.  Table
1310: 20 2a 70 54 61 62 3b 0a 20 20 63 68 61 72 20 63   *pTab;.  char c
1320: 6f 6e 73 74 20 2a 61 7a 41 72 67 5b 36 5d 3b 0a  onst *azArg[6];.
1330: 20 20 63 68 61 72 20 7a 44 62 4e 75 6d 5b 33 30    char zDbNum[30
1340: 5d 3b 0a 20 20 69 6e 74 20 6d 65 74 61 5b 31 30  ];.  int meta[10
1350: 5d 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69 6e  ];.  InitData in
1360: 69 74 44 61 74 61 3b 0a 20 20 63 68 61 72 20 63  itData;.  char c
1370: 6f 6e 73 74 20 2a 7a 4d 61 73 74 65 72 53 63 68  onst *zMasterSch
1380: 65 6d 61 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73  ema;.  char cons
1390: 74 20 2a 7a 4d 61 73 74 65 72 4e 61 6d 65 3b 0a  t *zMasterName;.
13a0: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 6d  .  /*.  ** The m
13b0: 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 74  aster database t
13c0: 61 62 6c 65 20 68 61 73 20 61 20 73 74 72 75 63  able has a struc
13d0: 74 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a 20  ture like this. 
13e0: 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68 61   */.  static cha
13f0: 72 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b  r master_schema[
1400: 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54  ] = .     "CREAT
1410: 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d  E TABLE sqlite_m
1420: 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20 22  aster(\n".     "
1430: 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a    type text,\n".
1440: 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65 78       "  name tex
1450: 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 62  t,\n".     "  tb
1460: 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a  l_name text,\n".
1470: 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67 65       "  rootpage
1480: 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20   integer,\n".   
1490: 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22    "  sql text\n"
14a0: 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 20 20  .     ")".  ;.  
14b0: 73 74 61 74 69 63 20 63 68 61 72 20 74 65 6d 70  static char temp
14c0: 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d  _master_schema[]
14d0: 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 45   = .     "CREATE
14e0: 20 54 45 4d 50 20 54 41 42 4c 45 20 73 71 6c 69   TEMP TABLE sqli
14f0: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 28 5c  te_temp_master(\
1500: 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20  n".     "  type 
1510: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20  text,\n".     " 
1520: 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20   name text,\n". 
1530: 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20      "  tbl_name 
1540: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20  text,\n".     " 
1550: 20 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65   rootpage intege
1560: 72 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71  r,\n".     "  sq
1570: 6c 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22  l text\n".     "
1580: 29 22 0a 20 20 3b 0a 0a 20 20 61 73 73 65 72 74  )".  ;..  assert
1590: 28 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62 3c  ( iDb>=0 && iDb<
15a0: 64 62 2d 3e 6e 44 62 20 29 3b 0a 0a 20 20 2f 2a  db->nDb );..  /*
15b0: 20 7a 4d 61 73 74 65 72 53 63 68 65 6d 61 20 61   zMasterSchema a
15c0: 6e 64 20 7a 49 6e 69 74 53 63 72 69 70 74 20 61  nd zInitScript a
15d0: 72 65 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20  re set to point 
15e0: 61 74 20 74 68 65 20 6d 61 73 74 65 72 20 73 63  at the master sc
15f0: 68 65 6d 61 0a 20 20 2a 2a 20 61 6e 64 20 69 6e  hema.  ** and in
1600: 69 74 69 61 6c 69 73 61 74 69 6f 6e 20 73 63 72  itialisation scr
1610: 69 70 74 20 61 70 70 72 6f 70 72 69 61 74 65 20  ipt appropriate 
1620: 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 73 65  for the database
1630: 20 62 65 69 6e 67 0a 20 20 2a 2a 20 69 6e 69 74   being.  ** init
1640: 69 61 6c 69 73 65 64 2e 20 7a 4d 61 73 74 65 72  ialised. zMaster
1650: 4e 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65  Name is the name
1660: 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 74   of the master t
1670: 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  able..  */.  if(
1680: 20 69 44 62 3d 3d 31 20 29 7b 0a 20 20 20 20 7a   iDb==1 ){.    z
1690: 4d 61 73 74 65 72 53 63 68 65 6d 61 20 3d 20 74  MasterSchema = t
16a0: 65 6d 70 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d  emp_master_schem
16b0: 61 3b 0a 20 20 20 20 7a 4d 61 73 74 65 72 4e 61  a;.    zMasterNa
16c0: 6d 65 20 3d 20 54 45 4d 50 5f 4d 41 53 54 45 52  me = TEMP_MASTER
16d0: 5f 4e 41 4d 45 3b 0a 20 20 7d 65 6c 73 65 7b 0a  _NAME;.  }else{.
16e0: 20 20 20 20 7a 4d 61 73 74 65 72 53 63 68 65 6d      zMasterSchem
16f0: 61 20 3d 20 6d 61 73 74 65 72 5f 73 63 68 65 6d  a = master_schem
1700: 61 3b 0a 20 20 20 20 7a 4d 61 73 74 65 72 4e 61  a;.    zMasterNa
1710: 6d 65 20 3d 20 4d 41 53 54 45 52 5f 4e 41 4d 45  me = MASTER_NAME
1720: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 6f 6e 73  ;.  }..  /* Cons
1730: 74 72 75 63 74 20 74 68 65 20 73 63 68 65 6d 61  truct the schema
1740: 20 74 61 62 6c 65 73 2e 20 20 2a 2f 0a 20 20 73   tables.  */.  s
1750: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28  qlite3SafetyOff(
1760: 64 62 29 3b 0a 20 20 61 7a 41 72 67 5b 30 5d 20  db);.  azArg[0] 
1770: 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 61 7a 41  = "table";.  azA
1780: 72 67 5b 31 5d 20 3d 20 7a 4d 61 73 74 65 72 4e  rg[1] = zMasterN
1790: 61 6d 65 3b 0a 20 20 61 7a 41 72 67 5b 32 5d 20  ame;.  azArg[2] 
17a0: 3d 20 22 31 22 3b 0a 20 20 61 7a 41 72 67 5b 33  = "1";.  azArg[3
17b0: 5d 20 3d 20 7a 4d 61 73 74 65 72 53 63 68 65 6d  ] = zMasterSchem
17c0: 61 3b 0a 20 20 73 70 72 69 6e 74 66 28 7a 44 62  a;.  sprintf(zDb
17d0: 4e 75 6d 2c 20 22 25 64 22 2c 20 69 44 62 29 3b  Num, "%d", iDb);
17e0: 0a 20 20 61 7a 41 72 67 5b 34 5d 20 3d 20 7a 44  .  azArg[4] = zD
17f0: 62 4e 75 6d 3b 0a 20 20 61 7a 41 72 67 5b 35 5d  bNum;.  azArg[5]
1800: 20 3d 20 30 3b 0a 20 20 69 6e 69 74 44 61 74 61   = 0;.  initData
1810: 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69 74  .db = db;.  init
1820: 44 61 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d 20  Data.pzErrMsg = 
1830: 70 7a 45 72 72 4d 73 67 3b 0a 20 20 73 71 6c 69  pzErrMsg;.  sqli
1840: 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28  te3InitCallback(
1850: 26 69 6e 69 74 44 61 74 61 2c 20 35 2c 20 28 63  &initData, 5, (c
1860: 68 61 72 20 2a 2a 29 61 7a 41 72 67 2c 20 30 29  har **)azArg, 0)
1870: 3b 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74  ;.  pTab = sqlit
1880: 65 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20  e3FindTable(db, 
1890: 7a 4d 61 73 74 65 72 4e 61 6d 65 2c 20 64 62 2d  zMasterName, db-
18a0: 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29  >aDb[iDb].zName)
18b0: 3b 0a 20 20 69 66 28 20 70 54 61 62 20 29 7b 0a  ;.  if( pTab ){.
18c0: 20 20 20 20 70 54 61 62 2d 3e 72 65 61 64 4f 6e      pTab->readOn
18d0: 6c 79 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73 71  ly = 1;.  }.  sq
18e0: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
18f0: 29 3b 0a 0a 20 20 2f 2a 20 43 72 65 61 74 65 20  );..  /* Create 
1900: 61 20 63 75 72 73 6f 72 20 74 6f 20 68 6f 6c 64  a cursor to hold
1910: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6f 70   the database op
1920: 65 6e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62  en.  */.  if( db
1930: 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 3d 3d  ->aDb[iDb].pBt==
1940: 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54  0 ) return SQLIT
1950: 45 5f 4f 4b 3b 0a 20 20 72 63 20 3d 20 73 71 6c  E_OK;.  rc = sql
1960: 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 28  ite3BtreeCursor(
1970: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74  db->aDb[iDb].pBt
1980: 2c 20 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20 30  , MASTER_ROOT, 0
1990: 2c 20 30 2c 20 30 2c 20 26 63 75 72 4d 61 69 6e  , 0, 0, &curMain
19a0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c  );.  if( rc!=SQL
19b0: 49 54 45 5f 4f 4b 20 26 26 20 72 63 21 3d 53 51  ITE_OK && rc!=SQ
19c0: 4c 49 54 45 5f 45 4d 50 54 59 20 29 7b 0a 20 20  LITE_EMPTY ){.  
19d0: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
19e0: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 73 71 6c  ng(pzErrMsg, sql
19f0: 69 74 65 33 45 72 72 53 74 72 28 72 63 29 2c 20  ite3ErrStr(rc), 
1a00: 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72  (char*)0);.    r
1a10: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20  eturn rc;.  }.. 
1a20: 20 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74 61   /* Get the data
1a30: 62 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72 6d  base meta inform
1a40: 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  ation..  **.  **
1a50: 20 4d 65 74 61 20 76 61 6c 75 65 73 20 61 72 65   Meta values are
1a60: 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a   as follows:.  *
1a70: 2a 20 20 20 20 6d 65 74 61 5b 30 5d 20 20 20 53  *    meta[0]   S
1a80: 63 68 65 6d 61 20 63 6f 6f 6b 69 65 2e 20 20 43  chema cookie.  C
1a90: 68 61 6e 67 65 73 20 77 69 74 68 20 65 61 63 68  hanges with each
1aa0: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e 0a   schema change..
1ab0: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 31 5d 20    **    meta[1] 
1ac0: 20 20 46 69 6c 65 20 66 6f 72 6d 61 74 20 6f 66    File format of
1ad0: 20 73 63 68 65 6d 61 20 6c 61 79 65 72 2e 0a 20   schema layer.. 
1ae0: 20 2a 2a 20 20 20 20 6d 65 74 61 5b 32 5d 20 20   **    meta[2]  
1af0: 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67   Size of the pag
1b00: 65 20 63 61 63 68 65 2e 0a 20 20 2a 2a 20 20 20  e cache..  **   
1b10: 20 6d 65 74 61 5b 33 5d 20 20 20 53 79 6e 63 68   meta[3]   Synch
1b20: 72 6f 6e 6f 75 73 20 73 65 74 74 69 6e 67 2e 20  ronous setting. 
1b30: 20 31 3a 6f 66 66 2c 20 32 3a 6e 6f 72 6d 61 6c   1:off, 2:normal
1b40: 2c 20 33 3a 66 75 6c 6c 0a 20 20 2a 2a 20 20 20  , 3:full.  **   
1b50: 20 6d 65 74 61 5b 34 5d 20 20 20 44 62 20 74 65   meta[4]   Db te
1b60: 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20 31 3a 55  xt encoding. 1:U
1b70: 54 46 2d 38 20 33 3a 55 54 46 2d 31 36 20 4c 45  TF-8 3:UTF-16 LE
1b80: 20 34 3a 55 54 46 2d 31 36 20 42 45 0a 20 20 2a   4:UTF-16 BE.  *
1b90: 2a 20 20 20 20 6d 65 74 61 5b 35 5d 20 20 20 50  *    meta[5]   P
1ba0: 72 61 67 6d 61 20 74 65 6d 70 5f 73 74 6f 72 65  ragma temp_store
1bb0: 20 76 61 6c 75 65 2e 20 20 53 65 65 20 63 6f 6d   value.  See com
1bc0: 6d 65 6e 74 73 20 6f 6e 20 42 74 72 65 65 46 61  ments on BtreeFa
1bd0: 63 74 6f 72 79 0a 20 20 2a 2a 20 20 20 20 6d 65  ctory.  **    me
1be0: 74 61 5b 36 5d 20 20 20 0a 20 20 2a 2a 20 20 20  ta[6]   .  **   
1bf0: 20 6d 65 74 61 5b 37 5d 0a 20 20 2a 2a 20 20 20   meta[7].  **   
1c00: 20 6d 65 74 61 5b 38 5d 0a 20 20 2a 2a 20 20 20   meta[8].  **   
1c10: 20 6d 65 74 61 5b 39 5d 0a 20 20 2a 2a 0a 20 20   meta[9].  **.  
1c20: 2a 2a 20 4e 6f 74 65 3a 20 54 68 65 20 68 61 73  ** Note: The has
1c30: 68 20 64 65 66 69 6e 65 64 20 53 51 4c 49 54 45  h defined SQLITE
1c40: 5f 55 54 46 2a 20 73 79 6d 62 6f 6c 73 20 69 6e  _UTF* symbols in
1c50: 20 73 71 6c 69 74 65 49 6e 74 2e 68 20 63 6f 72   sqliteInt.h cor
1c60: 72 65 73 70 6f 6e 64 20 74 6f 0a 20 20 2a 2a 20  respond to.  ** 
1c70: 74 68 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c  the possible val
1c80: 75 65 73 20 6f 66 20 6d 65 74 61 5b 34 5d 2e 0a  ues of meta[4]..
1c90: 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53    */.  if( rc==S
1ca0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
1cb0: 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69  int i;.    for(i
1cc0: 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  =0; rc==SQLITE_O
1cd0: 4b 20 26 26 20 69 3c 73 69 7a 65 6f 66 28 6d 65  K && i<sizeof(me
1ce0: 74 61 29 2f 73 69 7a 65 6f 66 28 6d 65 74 61 5b  ta)/sizeof(meta[
1cf0: 30 5d 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  0]); i++){.     
1d00: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
1d10: 65 65 47 65 74 4d 65 74 61 28 64 62 2d 3e 61 44  eeGetMeta(db->aD
1d20: 62 5b 69 44 62 5d 2e 70 42 74 2c 20 69 2b 31 2c  b[iDb].pBt, i+1,
1d30: 20 26 6d 65 74 61 5b 69 5d 29 3b 0a 20 20 20 20   &meta[i]);.    
1d40: 7d 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a  }.    if( rc ){.
1d50: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 65 74        sqlite3Set
1d60: 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c  String(pzErrMsg,
1d70: 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 72   sqlite3ErrStr(r
1d80: 63 29 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20  c), (char*)0);. 
1d90: 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65       sqlite3Btre
1da0: 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75 72  eCloseCursor(cur
1db0: 4d 61 69 6e 29 3b 0a 20 20 20 20 20 20 72 65 74  Main);.      ret
1dc0: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20  urn rc;.    }.  
1dd0: 7d 65 6c 73 65 7b 0a 20 20 20 20 6d 65 6d 73 65  }else{.    memse
1de0: 74 28 6d 65 74 61 2c 20 30 2c 20 73 69 7a 65 6f  t(meta, 0, sizeo
1df0: 66 28 6d 65 74 61 29 29 3b 0a 20 20 7d 0a 20 20  f(meta));.  }.  
1e00: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 73 63 68  db->aDb[iDb].sch
1e10: 65 6d 61 5f 63 6f 6f 6b 69 65 20 3d 20 6d 65 74  ema_cookie = met
1e20: 61 5b 30 5d 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f  a[0];..  /* If o
1e30: 70 65 6e 69 6e 67 20 61 20 6e 6f 6e 2d 65 6d 70  pening a non-emp
1e40: 74 79 20 64 61 74 61 62 61 73 65 2c 20 63 68 65  ty database, che
1e50: 63 6b 20 74 68 65 20 74 65 78 74 20 65 6e 63 6f  ck the text enco
1e60: 64 69 6e 67 2e 20 46 6f 72 20 74 68 65 0a 20 20  ding. For the.  
1e70: 2a 2a 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  ** main database
1e80: 2c 20 73 65 74 20 73 71 6c 69 74 65 33 2e 65 6e  , set sqlite3.en
1e90: 63 20 74 6f 20 74 68 65 20 65 6e 63 6f 64 69 6e  c to the encodin
1ea0: 67 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 64 61  g of the main da
1eb0: 74 61 62 61 73 65 2e 0a 20 20 2a 2a 20 46 6f 72  tabase..  ** For
1ec0: 20 61 6e 20 61 74 74 61 63 68 65 64 20 64 62 2c   an attached db,
1ed0: 20 69 74 20 69 73 20 61 6e 20 65 72 72 6f 72 20   it is an error 
1ee0: 69 66 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20  if the encoding 
1ef0: 69 73 20 6e 6f 74 20 74 68 65 20 73 61 6d 65 0a  is not the same.
1f00: 20 20 2a 2a 20 61 73 20 73 71 6c 69 74 65 33 2e    ** as sqlite3.
1f10: 65 6e 63 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  enc..  */.  if( 
1f20: 6d 65 74 61 5b 34 5d 20 29 7b 20 20 2f 2a 20 74  meta[4] ){  /* t
1f30: 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 2a 2f 0a  ext encoding */.
1f40: 20 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29      if( iDb==0 )
1f50: 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 6f 70  {.      /* If op
1f60: 65 6e 69 6e 67 20 74 68 65 20 6d 61 69 6e 20 64  ening the main d
1f70: 61 74 61 62 61 73 65 2c 20 73 65 74 20 64 62 2d  atabase, set db-
1f80: 3e 65 6e 63 2e 20 2a 2f 0a 20 20 20 20 20 20 64  >enc. */.      d
1f90: 62 2d 3e 65 6e 63 20 3d 20 28 75 38 29 6d 65 74  b->enc = (u8)met
1fa0: 61 5b 34 5d 3b 0a 20 20 20 20 20 20 64 62 2d 3e  a[4];.      db->
1fb0: 70 44 66 6c 74 43 6f 6c 6c 20 3d 20 73 71 6c 69  pDfltColl = sqli
1fc0: 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64  te3FindCollSeq(d
1fd0: 62 2c 20 64 62 2d 3e 65 6e 63 2c 20 22 42 49 4e  b, db->enc, "BIN
1fe0: 41 52 59 22 2c 20 36 2c 20 30 29 3b 0a 20 20 20  ARY", 6, 0);.   
1ff0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a   }else{.      /*
2000: 20 49 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 61   If opening an a
2010: 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65  ttached database
2020: 2c 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6d  , the encoding m
2030: 75 63 68 20 6d 61 74 63 68 20 64 62 2d 3e 65 6e  uch match db->en
2040: 63 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d  c */.      if( m
2050: 65 74 61 5b 34 5d 21 3d 64 62 2d 3e 65 6e 63 20  eta[4]!=db->enc 
2060: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ){.        sqlit
2070: 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73  e3BtreeCloseCurs
2080: 6f 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 20  or(curMain);.   
2090: 20 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53       sqlite3SetS
20a0: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
20b0: 22 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61  "attached databa
20c0: 73 65 73 20 6d 75 73 74 20 75 73 65 20 74 68 65  ses must use the
20d0: 20 73 61 6d 65 22 0a 20 20 20 20 20 20 20 20 20   same".         
20e0: 20 20 20 22 20 74 65 78 74 20 65 6e 63 6f 64 69     " text encodi
20f0: 6e 67 20 61 73 20 6d 61 69 6e 20 64 61 74 61 62  ng as main datab
2100: 61 73 65 22 2c 20 28 63 68 61 72 2a 29 30 29 3b  ase", (char*)0);
2110: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
2120: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20  SQLITE_ERROR;.  
2130: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
2140: 0a 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29 7b  .  if( iDb==0 ){
2150: 0a 20 20 20 20 73 69 7a 65 20 3d 20 6d 65 74 61  .    size = meta
2160: 5b 32 5d 3b 0a 20 20 20 20 69 66 28 20 73 69 7a  [2];.    if( siz
2170: 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d 20 4d  e==0 ){ size = M
2180: 41 58 5f 50 41 47 45 53 3b 20 7d 0a 20 20 20 20  AX_PAGES; }.    
2190: 64 62 2d 3e 63 61 63 68 65 5f 73 69 7a 65 20 3d  db->cache_size =
21a0: 20 73 69 7a 65 3b 0a 20 20 20 20 64 62 2d 3e 73   size;.    db->s
21b0: 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 6d 65  afety_level = me
21c0: 74 61 5b 33 5d 3b 0a 20 20 20 20 69 66 28 20 6d  ta[3];.    if( m
21d0: 65 74 61 5b 35 5d 3e 30 20 26 26 20 6d 65 74 61  eta[5]>0 && meta
21e0: 5b 35 5d 3c 3d 32 20 26 26 20 64 62 2d 3e 74 65  [5]<=2 && db->te
21f0: 6d 70 5f 73 74 6f 72 65 3d 3d 30 20 29 7b 0a 20  mp_store==0 ){. 
2200: 20 20 20 20 20 64 62 2d 3e 74 65 6d 70 5f 73 74       db->temp_st
2210: 6f 72 65 20 3d 20 6d 65 74 61 5b 35 5d 3b 0a 20  ore = meta[5];. 
2220: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 64 62 2d     }.    if( db-
2230: 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c 3d 3d 30  >safety_level==0
2240: 20 29 20 64 62 2d 3e 73 61 66 65 74 79 5f 6c 65   ) db->safety_le
2250: 76 65 6c 20 3d 20 32 3b 0a 0a 20 20 20 20 64 62  vel = 2;..    db
2260: 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20  ->file_format = 
2270: 6d 65 74 61 5b 31 5d 3b 0a 20 20 20 20 69 66 28  meta[1];.    if(
2280: 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74   db->file_format
2290: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  ==0 ){.      /* 
22a0: 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 66 20  This happens if 
22b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 77 61 73  the database was
22c0: 20 69 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74 79   initially empty
22d0: 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 66 69   */.      db->fi
22e0: 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a 20  le_format = 1;. 
22f0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20     }.  }..  /*. 
2300: 20 2a 2a 20 20 66 69 6c 65 5f 66 6f 72 6d 61 74   **  file_format
2310: 3d 3d 31 20 20 20 20 56 65 72 73 69 6f 6e 20 33  ==1    Version 3
2320: 2e 30 2e 30 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  .0.0..  */.  if(
2330: 20 6d 65 74 61 5b 31 5d 3e 31 20 29 7b 0a 20 20   meta[1]>1 ){.  
2340: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c    sqlite3BtreeCl
2350: 6f 73 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69  oseCursor(curMai
2360: 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53  n);.    sqlite3S
2370: 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73  etString(pzErrMs
2380: 67 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64 20  g, "unsupported 
2390: 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c 20 28 63  file format", (c
23a0: 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 65 74  har*)0);.    ret
23b0: 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  urn SQLITE_ERROR
23c0: 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 33  ;.  }..  sqlite3
23d0: 42 74 72 65 65 53 65 74 43 61 63 68 65 53 69 7a  BtreeSetCacheSiz
23e0: 65 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70  e(db->aDb[iDb].p
23f0: 42 74 2c 20 64 62 2d 3e 63 61 63 68 65 5f 73 69  Bt, db->cache_si
2400: 7a 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74  ze);.  sqlite3Bt
2410: 72 65 65 53 65 74 53 61 66 65 74 79 4c 65 76 65  reeSetSafetyLeve
2420: 6c 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70  l(db->aDb[iDb].p
2430: 42 74 2c 20 6d 65 74 61 5b 33 5d 3d 3d 30 20 3f  Bt, meta[3]==0 ?
2440: 20 32 20 3a 20 6d 65 74 61 5b 33 5d 29 3b 0a 0a   2 : meta[3]);..
2450: 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73 63    /* Read the sc
2460: 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  hema information
2470: 20 6f 75 74 20 6f 66 20 74 68 65 20 73 63 68 65   out of the sche
2480: 6d 61 20 74 61 62 6c 65 73 0a 20 20 2a 2f 0a 20  ma tables.  */. 
2490: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e 69   assert( db->ini
24a0: 74 2e 62 75 73 79 20 29 3b 0a 20 20 69 66 28 20  t.busy );.  if( 
24b0: 72 63 3d 3d 53 51 4c 49 54 45 5f 45 4d 50 54 59  rc==SQLITE_EMPTY
24c0: 20 29 7b 0a 20 20 20 20 2f 2a 20 46 6f 72 20 61   ){.    /* For a
24d0: 6e 20 65 6d 70 74 79 20 64 61 74 61 62 61 73 65  n empty database
24e0: 2c 20 74 68 65 72 65 20 69 73 20 6e 6f 74 68 69  , there is nothi
24f0: 6e 67 20 74 6f 20 72 65 61 64 20 2a 2f 0a 20 20  ng to read */.  
2500: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b    rc = SQLITE_OK
2510: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 63  ;.  }else{.    c
2520: 68 61 72 20 2a 7a 53 71 6c 20 3d 20 30 3b 0a 20  har *zSql = 0;. 
2530: 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79     sqlite3Safety
2540: 4f 66 66 28 64 62 29 3b 0a 20 20 20 20 73 71 6c  Off(db);.    sql
2550: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 26 7a  ite3SetString(&z
2560: 53 71 6c 2c 20 0a 20 20 20 20 20 20 20 20 22 53  Sql, .        "S
2570: 45 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d 65  ELECT type, name
2580: 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c 2c  , rootpage, sql,
2590: 20 22 2c 20 7a 44 62 4e 75 6d 2c 20 22 20 46 52   ", zDbNum, " FR
25a0: 4f 4d 20 5c 22 22 2c 0a 20 20 20 20 20 20 20 20  OM \"",.        
25b0: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61  db->aDb[iDb].zNa
25c0: 6d 65 2c 20 22 5c 22 2e 22 2c 20 7a 4d 61 73 74  me, "\".", zMast
25d0: 65 72 4e 61 6d 65 2c 20 28 63 68 61 72 2a 29 30  erName, (char*)0
25e0: 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  );.    rc = sqli
25f0: 74 65 33 5f 65 78 65 63 28 64 62 2c 20 7a 53 71  te3_exec(db, zSq
2600: 6c 2c 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61  l, sqlite3InitCa
2610: 6c 6c 62 61 63 6b 2c 20 26 69 6e 69 74 44 61 74  llback, &initDat
2620: 61 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74  a, 0);.    sqlit
2630: 65 46 72 65 65 28 7a 53 71 6c 29 3b 0a 20 20 20  eFree(zSql);.   
2640: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e   sqlite3SafetyOn
2650: 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  (db);.    sqlite
2660: 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f  3BtreeCloseCurso
2670: 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 7d 0a  r(curMain);.  }.
2680: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 6d 61    if( sqlite3_ma
2690: 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20  lloc_failed ){. 
26a0: 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72     sqlite3SetStr
26b0: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f  ing(pzErrMsg, "o
26c0: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 28  ut of memory", (
26d0: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 63  char*)0);.    rc
26e0: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b   = SQLITE_NOMEM;
26f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65  .    sqlite3Rese
2700: 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28  tInternalSchema(
2710: 64 62 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66  db, 0);.  }.  if
2720: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
2730: 29 7b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70  ){.    DbSetProp
2740: 65 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42  erty(db, iDb, DB
2750: 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a  _SchemaLoaded);.
2760: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
2770: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61  ite3ResetInterna
2780: 6c 53 63 68 65 6d 61 28 64 62 2c 20 69 44 62 29  lSchema(db, iDb)
2790: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
27a0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74  c;.}../*.** Init
27b0: 69 61 6c 69 7a 65 20 61 6c 6c 20 64 61 74 61 62  ialize all datab
27c0: 61 73 65 20 66 69 6c 65 73 20 2d 20 74 68 65 20  ase files - the 
27d0: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 66 69  main database fi
27e0: 6c 65 2c 20 74 68 65 20 66 69 6c 65 0a 2a 2a 20  le, the file.** 
27f0: 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 65  used to store te
2800: 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 73 2c 20  mporary tables, 
2810: 61 6e 64 20 61 6e 79 20 61 64 64 69 74 69 6f 6e  and any addition
2820: 61 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  al database file
2830: 73 0a 2a 2a 20 63 72 65 61 74 65 64 20 75 73 69  s.** created usi
2840: 6e 67 20 41 54 54 41 43 48 20 73 74 61 74 65 6d  ng ATTACH statem
2850: 65 6e 74 73 2e 20 20 52 65 74 75 72 6e 20 61 20  ents.  Return a 
2860: 73 75 63 63 65 73 73 20 63 6f 64 65 2e 20 20 49  success code.  I
2870: 66 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 20 6f 63  f an.** error oc
2880: 63 75 72 73 2c 20 77 72 69 74 65 20 61 6e 20 65  curs, write an e
2890: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 6e 74  rror message int
28a0: 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a 2a 2a 0a  o *pzErrMsg..**.
28b0: 2a 2a 20 41 66 74 65 72 20 74 68 65 20 64 61 74  ** After the dat
28c0: 61 62 61 73 65 20 69 73 20 69 6e 69 74 69 61 6c  abase is initial
28d0: 69 7a 65 64 2c 20 74 68 65 20 53 51 4c 49 54 45  ized, the SQLITE
28e0: 5f 49 6e 69 74 69 61 6c 69 7a 65 64 0a 2a 2a 20  _Initialized.** 
28f0: 62 69 74 20 69 73 20 73 65 74 20 69 6e 20 74 68  bit is set in th
2900: 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20 6f 66  e flags field of
2910: 20 74 68 65 20 73 71 6c 69 74 65 20 73 74 72 75   the sqlite stru
2920: 63 74 75 72 65 2e 20 0a 2a 2f 0a 69 6e 74 20 73  cture. .*/.int s
2930: 71 6c 69 74 65 33 49 6e 69 74 28 73 71 6c 69 74  qlite3Init(sqlit
2940: 65 20 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a  e *db, char **pz
2950: 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20 69  ErrMsg){.  int i
2960: 2c 20 72 63 3b 0a 20 20 0a 20 20 69 66 28 20 64  , rc;.  .  if( d
2970: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 20 72  b->init.busy ) r
2980: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
2990: 0a 20 20 61 73 73 65 72 74 28 20 28 64 62 2d 3e  .  assert( (db->
29a0: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49  flags & SQLITE_I
29b0: 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29  nitialized)==0 )
29c0: 3b 0a 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  ;.  rc = SQLITE_
29d0: 4f 4b 3b 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62  OK;.  db->init.b
29e0: 75 73 79 20 3d 20 31 3b 0a 20 20 66 6f 72 28 69  usy = 1;.  for(i
29f0: 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  =0; rc==SQLITE_O
2a00: 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  K && i<db->nDb; 
2a10: 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 44 62  i++){.    if( Db
2a20: 48 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20  HasProperty(db, 
2a30: 69 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64  i, DB_SchemaLoad
2a40: 65 64 29 20 7c 7c 20 69 3d 3d 31 20 29 20 63 6f  ed) || i==1 ) co
2a50: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 72 63 20 3d  ntinue;.    rc =
2a60: 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28   sqlite3InitOne(
2a70: 64 62 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67 29  db, i, pzErrMsg)
2a80: 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a  ;.    if( rc ){.
2a90: 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 65 73        sqlite3Res
2aa0: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61  etInternalSchema
2ab0: 28 64 62 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20  (db, i);.    }. 
2ac0: 20 7d 0a 0a 20 20 2f 2a 20 4f 6e 63 65 20 61 6c   }..  /* Once al
2ad0: 6c 20 74 68 65 20 6f 74 68 65 72 20 64 61 74 61  l the other data
2ae0: 62 61 73 65 73 20 68 61 76 65 20 62 65 65 6e 20  bases have been 
2af0: 69 6e 69 74 69 61 6c 69 73 65 64 2c 20 6c 6f 61  initialised, loa
2b00: 64 20 74 68 65 20 73 63 68 65 6d 61 0a 20 20 2a  d the schema.  *
2b10: 2a 20 66 6f 72 20 74 68 65 20 54 45 4d 50 20 64  * for the TEMP d
2b20: 61 74 61 62 61 73 65 2e 20 54 68 69 73 20 69 73  atabase. This is
2b30: 20 6c 6f 61 64 65 64 20 6c 61 73 74 2c 20 61 73   loaded last, as
2b40: 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 62 61   the TEMP databa
2b50: 73 65 0a 20 20 2a 2a 20 73 63 68 65 6d 61 20 6d  se.  ** schema m
2b60: 61 79 20 63 6f 6e 74 61 69 6e 20 72 65 66 65 72  ay contain refer
2b70: 65 6e 63 65 73 20 74 6f 20 6f 62 6a 65 63 74 73  ences to objects
2b80: 20 69 6e 20 6f 74 68 65 72 20 64 61 74 61 62 61   in other databa
2b90: 73 65 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  ses..  */.  if( 
2ba0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
2bb0: 20 64 62 2d 3e 6e 44 62 3e 31 20 26 26 20 21 44   db->nDb>1 && !D
2bc0: 62 48 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c  bHasProperty(db,
2bd0: 20 31 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61   1, DB_SchemaLoa
2be0: 64 65 64 29 20 29 7b 0a 20 20 20 20 72 63 20 3d  ded) ){.    rc =
2bf0: 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28   sqlite3InitOne(
2c00: 64 62 2c 20 31 2c 20 70 7a 45 72 72 4d 73 67 29  db, 1, pzErrMsg)
2c10: 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a  ;.    if( rc ){.
2c20: 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 65 73        sqlite3Res
2c30: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61  etInternalSchema
2c40: 28 64 62 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20  (db, 1);.    }. 
2c50: 20 7d 0a 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62   }..  db->init.b
2c60: 75 73 79 20 3d 20 30 3b 0a 20 20 69 66 28 20 72  usy = 0;.  if( r
2c70: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
2c80: 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d      db->flags |=
2c90: 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69   SQLITE_Initiali
2ca0: 7a 65 64 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  zed;.    sqlite3
2cb0: 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68  CommitInternalCh
2cc0: 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a  anges(db);.  }..
2cd0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
2ce0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66  _OK ){.    db->f
2cf0: 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f  lags &= ~SQLITE_
2d00: 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 20 20 7d  Initialized;.  }
2d10: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
2d20: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
2d30: 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69  ine is a no-op i
2d40: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73  f the database s
2d50: 63 68 65 6d 61 20 69 73 20 61 6c 72 65 61 64 79  chema is already
2d60: 20 69 6e 69 74 69 61 6c 69 73 65 64 2e 0a 2a 2a   initialised..**
2d70: 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 20   Otherwise, the 
2d80: 73 63 68 65 6d 61 20 69 73 20 6c 6f 61 64 65 64  schema is loaded
2d90: 2e 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 65 20  . An error code 
2da0: 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a  is returned..*/.
2db0: 69 6e 74 20 73 71 6c 69 74 65 33 52 65 61 64 53  int sqlite3ReadS
2dc0: 63 68 65 6d 61 28 73 71 6c 69 74 65 20 2a 64 62  chema(sqlite *db
2dd0: 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73  , char **pzErrMs
2de0: 67 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  g){.  int rc = S
2df0: 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28  QLITE_OK;..  if(
2e00: 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20   !db->init.busy 
2e10: 29 7b 0a 20 20 20 20 69 66 28 20 28 64 62 2d 3e  ){.    if( (db->
2e20: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49  flags & SQLITE_I
2e30: 6e 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29  nitialized)==0 )
2e40: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  {.      rc = sql
2e50: 69 74 65 33 49 6e 69 74 28 64 62 2c 20 70 7a 45  ite3Init(db, pzE
2e60: 72 72 4d 73 67 29 3b 0a 20 20 20 20 7d 0a 20 20  rrMsg);.    }.  
2e70: 7d 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d  }.  assert( rc!=
2e80: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 64 62  SQLITE_OK || (db
2e90: 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45  ->flags & SQLITE
2ea0: 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 7c 7c 64  _Initialized)||d
2eb0: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a  b->init.busy );.
2ec0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
2ed0: 2f 2a 0a 2a 2a 20 54 68 65 20 76 65 72 73 69 6f  /*.** The versio
2ee0: 6e 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72 79  n of the library
2ef0: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 72  .*/.const char r
2f00: 63 73 69 64 33 5b 5d 20 3d 20 22 40 28 23 29 20  csid3[] = "@(#) 
2f10: 5c 30 34 34 49 64 3a 20 53 51 4c 69 74 65 20 76  \044Id: SQLite v
2f20: 65 72 73 69 6f 6e 20 22 20 53 51 4c 49 54 45 5f  ersion " SQLITE_
2f30: 56 45 52 53 49 4f 4e 20 22 20 24 22 3b 0a 63 6f  VERSION " $";.co
2f40: 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 33  nst char sqlite3
2f50: 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c  _version[] = SQL
2f60: 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a  ITE_VERSION;../*
2f70: 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20  .** This is the 
2f80: 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e  default collatin
2f90: 67 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64  g function named
2fa0: 20 22 42 49 4e 41 52 59 22 20 77 68 69 63 68 20   "BINARY" which 
2fb0: 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 61 76 61  is always.** ava
2fc0: 69 6c 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69  ilable..*/.stati
2fd0: 63 20 69 6e 74 20 62 69 6e 61 72 79 43 6f 6c 6c  c int binaryColl
2fe0: 61 74 69 6e 67 46 75 6e 63 28 0a 20 20 76 6f 69  atingFunc(.  voi
2ff0: 64 20 2a 4e 6f 74 55 73 65 64 2c 0a 20 20 69 6e  d *NotUsed,.  in
3000: 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76  t nKey1, const v
3010: 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e  oid *pKey1,.  in
3020: 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76  t nKey2, const v
3030: 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20  oid *pKey2.){.  
3040: 69 6e 74 20 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d  int rc, n;.  n =
3050: 20 6e 4b 65 79 31 3c 6e 4b 65 79 32 20 3f 20 6e   nKey1<nKey2 ? n
3060: 4b 65 79 31 20 3a 20 6e 4b 65 79 32 3b 0a 20 20  Key1 : nKey2;.  
3070: 72 63 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79  rc = memcmp(pKey
3080: 31 2c 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20  1, pKey2, n);.  
3090: 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20  if( rc==0 ){.   
30a0: 20 72 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b   rc = nKey1 - nK
30b0: 65 79 32 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  ey2;.  }.  retur
30c0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  n rc;.}../*.** A
30d0: 6e 6f 74 68 65 72 20 62 75 69 6c 74 2d 69 6e 20  nother built-in 
30e0: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e  collating sequen
30f0: 63 65 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a 2a 0a  ce: NOCASE. .**.
3100: 2a 2a 20 54 68 69 73 20 63 6f 6c 6c 61 74 69 6e  ** This collatin
3110: 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 69 6e  g sequence is in
3120: 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65  tended to be use
3130: 64 20 66 6f 72 20 22 63 61 73 65 20 69 6e 64 65  d for "case inde
3140: 70 65 6e 64 61 6e 74 0a 2a 2a 20 63 6f 6d 70 61  pendant.** compa
3150: 72 69 73 6f 6e 22 2e 20 53 51 4c 69 74 65 27 73  rison". SQLite's
3160: 20 6b 6e 6f 77 6c 65 64 67 65 20 6f 66 20 75 70   knowledge of up
3170: 70 65 72 20 61 6e 64 20 6c 6f 77 65 72 20 63 61  per and lower ca
3180: 73 65 20 65 71 75 69 76 61 6c 65 6e 74 73 0a 2a  se equivalents.*
3190: 2a 20 65 78 74 65 6e 64 73 20 6f 6e 6c 79 20 74  * extends only t
31a0: 6f 20 74 68 65 20 32 36 20 63 68 61 72 61 63 74  o the 26 charact
31b0: 65 72 73 20 75 73 65 64 20 69 6e 20 74 68 65 20  ers used in the 
31c0: 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65  English language
31d0: 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 20 6d  ..**.** At the m
31e0: 6f 6d 65 6e 74 20 74 68 65 72 65 20 69 73 20 6f  oment there is o
31f0: 6e 6c 79 20 61 20 55 54 46 2d 38 20 69 6d 70 6c  nly a UTF-8 impl
3200: 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 73  ementation..*/.s
3210: 74 61 74 69 63 20 69 6e 74 20 6e 6f 63 61 73 65  tatic int nocase
3220: 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 28 0a 20  CollatingFunc(. 
3230: 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a   void *NotUsed,.
3240: 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e    int nKey1, con
3250: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a  st void *pKey1,.
3260: 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e    int nKey2, con
3270: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29  st void *pKey2.)
3280: 7b 0a 20 20 69 6e 74 20 72 20 3d 20 73 71 6c 69  {.  int r = sqli
3290: 74 65 33 53 74 72 4e 49 43 6d 70 28 0a 20 20 20  te3StrNICmp(.   
32a0: 20 20 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a     (const char *
32b0: 29 70 4b 65 79 31 2c 20 28 63 6f 6e 73 74 20 63  )pKey1, (const c
32c0: 68 61 72 20 2a 29 70 4b 65 79 32 2c 20 28 6e 4b  har *)pKey2, (nK
32d0: 65 79 31 3e 6e 4b 65 79 32 29 3f 6e 4b 65 79 31  ey1>nKey2)?nKey1
32e0: 3a 6e 4b 65 79 32 29 3b 0a 20 20 69 66 28 20 30  :nKey2);.  if( 0
32f0: 3d 3d 72 20 29 7b 0a 20 20 20 20 72 20 3d 20 6e  ==r ){.    r = n
3300: 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d 0a  Key1-nKey2;.  }.
3310: 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a 2f    return r;.}../
3320: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
3330: 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6d 6f 73  ROWID of the mos
3340: 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 0a  t recent insert.
3350: 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  */.sqlite_int64 
3360: 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73  sqlite3_last_ins
3370: 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 65  ert_rowid(sqlite
3380: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20   *db){.  return 
3390: 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d  db->lastRowid;.}
33a0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
33b0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61  he number of cha
33c0: 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74  nges in the most
33d0: 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20   recent call to 
33e0: 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a  sqlite3_exec()..
33f0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
3400: 68 61 6e 67 65 73 28 73 71 6c 69 74 65 20 2a 64  hanges(sqlite *d
3410: 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d  b){.  return db-
3420: 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a  >nChange;.}../*.
3430: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  ** Return the nu
3440: 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 20  mber of changes 
3450: 73 69 6e 63 65 20 74 68 65 20 64 61 74 61 62 61  since the databa
3460: 73 65 20 68 61 6e 64 6c 65 20 77 61 73 20 6f 70  se handle was op
3470: 65 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ened..*/.int sql
3480: 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e 67  ite3_total_chang
3490: 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  es(sqlite3 *db){
34a0: 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e 54  .  return db->nT
34b0: 6f 74 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f  otalChange;.}../
34c0: 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65 78  *.** Close an ex
34d0: 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20 64 61  isting SQLite da
34e0: 74 61 62 61 73 65 0a 2a 2f 0a 69 6e 74 20 73 71  tabase.*/.int sq
34f0: 6c 69 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c 69  lite3_close(sqli
3500: 74 65 20 2a 64 62 29 7b 0a 20 20 48 61 73 68 45  te *db){.  HashE
3510: 6c 65 6d 20 2a 69 3b 0a 20 20 69 6e 74 20 6a 3b  lem *i;.  int j;
3520: 0a 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20  ..  if( !db ){. 
3530: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
3540: 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49  _OK;.  }..  /* I
3550: 66 20 74 68 65 72 65 20 61 72 65 20 61 6e 79 20  f there are any 
3560: 6f 75 74 73 74 61 6e 64 69 6e 67 20 56 4d 73 2c  outstanding VMs,
3570: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42   return SQLITE_B
3580: 55 53 59 2e 20 2a 2f 0a 20 20 69 66 28 20 64 62  USY. */.  if( db
3590: 2d 3e 70 56 64 62 65 20 29 7b 0a 20 20 20 20 73  ->pVdbe ){.    s
35a0: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
35b0: 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a 20 20  SQLITE_BUSY, .  
35c0: 20 20 20 20 20 20 22 55 6e 61 62 6c 65 20 74 6f        "Unable to
35d0: 20 63 6c 6f 73 65 20 64 75 65 20 74 6f 20 75 6e   close due to un
35e0: 66 69 6e 61 6c 69 73 65 64 20 73 74 61 74 65 6d  finalised statem
35f0: 65 6e 74 73 22 29 3b 0a 20 20 20 20 72 65 74 75  ents");.    retu
3600: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a  rn SQLITE_BUSY;.
3610: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 21 73    }.  assert( !s
3620: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63  qlite3SafetyChec
3630: 6b 28 64 62 29 20 29 3b 0a 0a 20 20 2f 2a 20 46  k(db) );..  /* F
3640: 49 58 20 4d 45 3a 20 64 62 2d 3e 6d 61 67 69 63  IX ME: db->magic
3650: 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 53   may be set to S
3660: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53  QLITE_MAGIC_CLOS
3670: 45 44 20 69 66 20 74 68 65 20 64 61 74 61 62 61  ED if the databa
3680: 73 65 0a 20 20 2a 2a 20 63 61 6e 6e 6f 74 20 62  se.  ** cannot b
3690: 65 20 6f 70 65 6e 65 64 20 66 6f 72 20 73 6f 6d  e opened for som
36a0: 65 20 72 65 61 73 6f 6e 2e 20 53 6f 20 74 68 69  e reason. So thi
36b0: 73 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20  s routine needs 
36c0: 74 6f 20 72 75 6e 20 69 6e 0a 20 20 2a 2a 20 74  to run in.  ** t
36d0: 68 61 74 20 63 61 73 65 2e 20 42 75 74 20 6d 61  hat case. But ma
36e0: 79 62 65 20 74 68 65 72 65 20 73 68 6f 75 6c 64  ybe there should
36f0: 20 62 65 20 61 6e 20 65 78 74 72 61 20 6d 61 67   be an extra mag
3700: 69 63 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65  ic value for the
3710: 0a 20 20 2a 2a 20 22 66 61 69 6c 65 64 20 74 6f  .  ** "failed to
3720: 20 6f 70 65 6e 22 20 73 74 61 74 65 2e 0a 20 20   open" state..  
3730: 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 67  */.  if( db->mag
3740: 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43  ic!=SQLITE_MAGIC
3750: 5f 43 4c 4f 53 45 44 20 26 26 20 73 71 6c 69 74  _CLOSED && sqlit
3760: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29  e3SafetyOn(db) )
3770: 7b 0a 20 20 20 20 2f 2a 20 70 72 69 6e 74 66 28  {.    /* printf(
3780: 22 44 49 44 20 4e 4f 54 20 43 4c 4f 53 45 5c 6e  "DID NOT CLOSE\n
3790: 22 29 3b 20 66 66 6c 75 73 68 28 73 74 64 6f 75  "); fflush(stdou
37a0: 74 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 75 72  t); */.    retur
37b0: 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  n SQLITE_ERROR;.
37c0: 20 20 7d 0a 0a 20 20 66 6f 72 28 6a 3d 30 3b 20    }..  for(j=0; 
37d0: 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 7b  j<db->nDb; j++){
37e0: 0a 20 20 20 20 73 74 72 75 63 74 20 44 62 20 2a  .    struct Db *
37f0: 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62 5b 6a  pDb = &db->aDb[j
3800: 5d 3b 0a 20 20 20 20 69 66 28 20 70 44 62 2d 3e  ];.    if( pDb->
3810: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  pBt ){.      sql
3820: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70  ite3BtreeClose(p
3830: 44 62 2d 3e 70 42 74 29 3b 0a 20 20 20 20 20 20  Db->pBt);.      
3840: 70 44 62 2d 3e 70 42 74 20 3d 20 30 3b 0a 20 20  pDb->pBt = 0;.  
3850: 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65    }.  }.  sqlite
3860: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
3870: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 61  hema(db, 0);.  a
3880: 73 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 3c 3d  ssert( db->nDb<=
3890: 32 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64  2 );.  assert( d
38a0: 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 44 62 53  b->aDb==db->aDbS
38b0: 74 61 74 69 63 20 29 3b 0a 20 20 66 6f 72 28 69  tatic );.  for(i
38c0: 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74  =sqliteHashFirst
38d0: 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b 20 69 3b  (&db->aFunc); i;
38e0: 20 69 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78   i=sqliteHashNex
38f0: 74 28 69 29 29 7b 0a 20 20 20 20 46 75 6e 63 44  t(i)){.    FuncD
3900: 65 66 20 2a 70 46 75 6e 63 2c 20 2a 70 4e 65 78  ef *pFunc, *pNex
3910: 74 3b 0a 20 20 20 20 66 6f 72 28 70 46 75 6e 63  t;.    for(pFunc
3920: 20 3d 20 28 46 75 6e 63 44 65 66 2a 29 73 71 6c   = (FuncDef*)sql
3930: 69 74 65 48 61 73 68 44 61 74 61 28 69 29 3b 20  iteHashData(i); 
3940: 70 46 75 6e 63 3b 20 70 46 75 6e 63 3d 70 4e 65  pFunc; pFunc=pNe
3950: 78 74 29 7b 0a 20 20 20 20 20 20 70 4e 65 78 74  xt){.      pNext
3960: 20 3d 20 70 46 75 6e 63 2d 3e 70 4e 65 78 74 3b   = pFunc->pNext;
3970: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65  .      sqliteFre
3980: 65 28 70 46 75 6e 63 29 3b 0a 20 20 20 20 7d 0a  e(pFunc);.    }.
3990: 20 20 7d 0a 0a 20 20 66 6f 72 28 69 3d 73 71 6c    }..  for(i=sql
39a0: 69 74 65 48 61 73 68 46 69 72 73 74 28 26 64 62  iteHashFirst(&db
39b0: 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 20 69 3b 20  ->aCollSeq); i; 
39c0: 69 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 74  i=sqliteHashNext
39d0: 28 69 29 29 7b 0a 20 20 20 20 43 6f 6c 6c 53 65  (i)){.    CollSe
39e0: 71 20 2a 70 43 6f 6c 6c 20 3d 20 28 43 6f 6c 6c  q *pColl = (Coll
39f0: 53 65 71 20 2a 29 73 71 6c 69 74 65 48 61 73 68  Seq *)sqliteHash
3a00: 44 61 74 61 28 69 29 3b 0a 20 20 20 20 73 71 6c  Data(i);.    sql
3a10: 69 74 65 46 72 65 65 28 70 43 6f 6c 6c 29 3b 0a  iteFree(pColl);.
3a20: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 73    }.  sqlite3Has
3a30: 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 43 6f 6c  hClear(&db->aCol
3a40: 6c 53 65 71 29 3b 0a 0a 20 20 73 71 6c 69 74 65  lSeq);..  sqlite
3a50: 33 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e  3HashClear(&db->
3a60: 61 46 75 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65  aFunc);.  sqlite
3a70: 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54  3Error(db, SQLIT
3a80: 45 5f 4f 4b 2c 20 30 29 3b 20 2f 2a 20 44 65 61  E_OK, 0); /* Dea
3a90: 6c 6c 6f 63 61 74 65 73 20 61 6e 79 20 63 61 63  llocates any cac
3aa0: 68 65 64 20 65 72 72 6f 72 20 73 74 72 69 6e 67  hed error string
3ab0: 73 2e 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e  s. */.  if( db->
3ac0: 70 56 61 6c 75 65 20 29 7b 0a 20 20 20 20 73 71  pValue ){.    sq
3ad0: 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 64  lite3ValueFree(d
3ae0: 62 2d 3e 70 56 61 6c 75 65 29 3b 0a 20 20 7d 0a  b->pValue);.  }.
3af0: 20 20 69 66 28 20 64 62 2d 3e 70 45 72 72 20 29    if( db->pErr )
3b00: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 61 6c  {.    sqlite3Val
3b10: 75 65 46 72 65 65 28 64 62 2d 3e 70 45 72 72 29  ueFree(db->pErr)
3b20: 3b 0a 20 20 7d 0a 0a 20 20 64 62 2d 3e 6d 61 67  ;.  }..  db->mag
3b30: 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49  ic = SQLITE_MAGI
3b40: 43 5f 45 52 52 4f 52 3b 0a 20 20 73 71 6c 69 74  C_ERROR;.  sqlit
3b50: 65 46 72 65 65 28 64 62 29 3b 0a 20 20 72 65 74  eFree(db);.  ret
3b60: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
3b70: 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b  ../*.** Rollback
3b80: 20 61 6c 6c 20 64 61 74 61 62 61 73 65 20 66 69   all database fi
3b90: 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  les..*/.void sql
3ba0: 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28  ite3RollbackAll(
3bb0: 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 69  sqlite *db){.  i
3bc0: 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b  nt i;.  for(i=0;
3bd0: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
3be0: 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 44  {.    if( db->aD
3bf0: 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20 20 20 20  b[i].pBt ){.    
3c00: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f    sqlite3BtreeRo
3c10: 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44 62 5b 69  llback(db->aDb[i
3c20: 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20 20 64 62  ].pBt);.      db
3c30: 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72 61 6e 73  ->aDb[i].inTrans
3c40: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
3c50: 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e    sqlite3ResetIn
3c60: 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c  ternalSchema(db,
3c70: 20 30 29 3b 0a 20 20 2f 2a 20 73 71 6c 69 74 65   0);.  /* sqlite
3c80: 33 52 6f 6c 6c 62 61 63 6b 49 6e 74 65 72 6e 61  3RollbackInterna
3c90: 6c 43 68 61 6e 67 65 73 28 64 62 29 3b 20 2a 2f  lChanges(db); */
3ca0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
3cb0: 20 61 20 73 74 61 74 69 63 20 73 74 72 69 6e 67   a static string
3cc0: 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 20   that describes 
3cd0: 74 68 65 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f  the kind of erro
3ce0: 72 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74  r specified in t
3cf0: 68 65 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a  he.** argument..
3d00: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
3d10: 71 6c 69 74 65 33 45 72 72 53 74 72 28 69 6e 74  qlite3ErrStr(int
3d20: 20 72 63 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68   rc){.  const ch
3d30: 61 72 20 2a 7a 3b 0a 20 20 73 77 69 74 63 68 28  ar *z;.  switch(
3d40: 20 72 63 20 29 7b 0a 20 20 20 20 63 61 73 65 20   rc ){.    case 
3d50: 53 51 4c 49 54 45 5f 4f 4b 3a 20 20 20 20 20 20  SQLITE_OK:      
3d60: 20 20 20 7a 20 3d 20 22 6e 6f 74 20 61 6e 20 65     z = "not an e
3d70: 72 72 6f 72 22 3b 20 20 20 20 20 20 20 20 20 20  rror";          
3d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3d90: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3da0: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3a 20 20 20  SQLITE_ERROR:   
3db0: 20 20 20 7a 20 3d 20 22 53 51 4c 20 6c 6f 67 69     z = "SQL logi
3dc0: 63 20 65 72 72 6f 72 20 6f 72 20 6d 69 73 73 69  c error or missi
3dd0: 6e 67 20 64 61 74 61 62 61 73 65 22 3b 20 20 20  ng database";   
3de0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3df0: 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e 41 4c 3a  SQLITE_INTERNAL:
3e00: 20 20 20 7a 20 3d 20 22 69 6e 74 65 72 6e 61 6c     z = "internal
3e10: 20 53 51 4c 69 74 65 20 69 6d 70 6c 65 6d 65 6e   SQLite implemen
3e20: 74 61 74 69 6f 6e 20 66 6c 61 77 22 3b 20 20 20  tation flaw";   
3e30: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3e40: 53 51 4c 49 54 45 5f 50 45 52 4d 3a 20 20 20 20  SQLITE_PERM:    
3e50: 20 20 20 7a 20 3d 20 22 61 63 63 65 73 73 20 70     z = "access p
3e60: 65 72 6d 69 73 73 69 6f 6e 20 64 65 6e 69 65 64  ermission denied
3e70: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
3e80: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3e90: 53 51 4c 49 54 45 5f 41 42 4f 52 54 3a 20 20 20  SQLITE_ABORT:   
3ea0: 20 20 20 7a 20 3d 20 22 63 61 6c 6c 62 61 63 6b     z = "callback
3eb0: 20 72 65 71 75 65 73 74 65 64 20 71 75 65 72 79   requested query
3ec0: 20 61 62 6f 72 74 22 3b 20 20 20 20 20 20 20 20   abort";        
3ed0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3ee0: 53 51 4c 49 54 45 5f 42 55 53 59 3a 20 20 20 20  SQLITE_BUSY:    
3ef0: 20 20 20 7a 20 3d 20 22 64 61 74 61 62 61 73 65     z = "database
3f00: 20 69 73 20 6c 6f 63 6b 65 64 22 3b 20 20 20 20   is locked";    
3f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3f20: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3f30: 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 3a 20 20  SQLITE_LOCKED:  
3f40: 20 20 20 7a 20 3d 20 22 64 61 74 61 62 61 73 65     z = "database
3f50: 20 74 61 62 6c 65 20 69 73 20 6c 6f 63 6b 65 64   table is locked
3f60: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
3f70: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3f80: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3a 20 20 20  SQLITE_NOMEM:   
3f90: 20 20 20 7a 20 3d 20 22 6f 75 74 20 6f 66 20 6d     z = "out of m
3fa0: 65 6d 6f 72 79 22 3b 20 20 20 20 20 20 20 20 20  emory";         
3fb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3fc0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
3fd0: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3a  SQLITE_READONLY:
3fe0: 20 20 20 7a 20 3d 20 22 61 74 74 65 6d 70 74 20     z = "attempt 
3ff0: 74 6f 20 77 72 69 74 65 20 61 20 72 65 61 64 6f  to write a reado
4000: 6e 6c 79 20 64 61 74 61 62 61 73 65 22 3b 20 20  nly database";  
4010: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4020: 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54  SQLITE_INTERRUPT
4030: 3a 20 20 7a 20 3d 20 22 69 6e 74 65 72 72 75 70  :  z = "interrup
4040: 74 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20  ted";           
4050: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4060: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4070: 53 51 4c 49 54 45 5f 49 4f 45 52 52 3a 20 20 20  SQLITE_IOERR:   
4080: 20 20 20 7a 20 3d 20 22 64 69 73 6b 20 49 2f 4f     z = "disk I/O
4090: 20 65 72 72 6f 72 22 3b 20 20 20 20 20 20 20 20   error";        
40a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
40b0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
40c0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 3a 20  SQLITE_CORRUPT: 
40d0: 20 20 20 7a 20 3d 20 22 64 61 74 61 62 61 73 65     z = "database
40e0: 20 64 69 73 6b 20 69 6d 61 67 65 20 69 73 20 6d   disk image is m
40f0: 61 6c 66 6f 72 6d 65 64 22 3b 20 20 20 20 20 20  alformed";      
4100: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4110: 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 3a  SQLITE_NOTFOUND:
4120: 20 20 20 7a 20 3d 20 22 74 61 62 6c 65 20 6f 72     z = "table or
4130: 20 72 65 63 6f 72 64 20 6e 6f 74 20 66 6f 75 6e   record not foun
4140: 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  d";             
4150: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4160: 53 51 4c 49 54 45 5f 46 55 4c 4c 3a 20 20 20 20  SQLITE_FULL:    
4170: 20 20 20 7a 20 3d 20 22 64 61 74 61 62 61 73 65     z = "database
4180: 20 69 73 20 66 75 6c 6c 22 3b 20 20 20 20 20 20   is full";      
4190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
41a0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
41b0: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3a  SQLITE_CANTOPEN:
41c0: 20 20 20 7a 20 3d 20 22 75 6e 61 62 6c 65 20 74     z = "unable t
41d0: 6f 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20  o open database 
41e0: 66 69 6c 65 22 3b 20 20 20 20 20 20 20 20 20 20  file";          
41f0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4200: 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3a  SQLITE_PROTOCOL:
4210: 20 20 20 7a 20 3d 20 22 64 61 74 61 62 61 73 65     z = "database
4220: 20 6c 6f 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f   locking protoco
4230: 6c 20 66 61 69 6c 75 72 65 22 3b 20 20 20 20 20  l failure";     
4240: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4250: 53 51 4c 49 54 45 5f 45 4d 50 54 59 3a 20 20 20  SQLITE_EMPTY:   
4260: 20 20 20 7a 20 3d 20 22 74 61 62 6c 65 20 63 6f     z = "table co
4270: 6e 74 61 69 6e 73 20 6e 6f 20 64 61 74 61 22 3b  ntains no data";
4280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4290: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
42a0: 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 3a 20 20  SQLITE_SCHEMA:  
42b0: 20 20 20 7a 20 3d 20 22 64 61 74 61 62 61 73 65     z = "database
42c0: 20 73 63 68 65 6d 61 20 68 61 73 20 63 68 61 6e   schema has chan
42d0: 67 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20  ged";           
42e0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
42f0: 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3a 20 20  SQLITE_TOOBIG:  
4300: 20 20 20 7a 20 3d 20 22 74 6f 6f 20 6d 75 63 68     z = "too much
4310: 20 64 61 74 61 20 66 6f 72 20 6f 6e 65 20 74 61   data for one ta
4320: 62 6c 65 20 72 6f 77 22 3b 20 20 20 20 20 20 20  ble row";       
4330: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4340: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e  SQLITE_CONSTRAIN
4350: 54 3a 20 7a 20 3d 20 22 63 6f 6e 73 74 72 61 69  T: z = "constrai
4360: 6e 74 20 66 61 69 6c 65 64 22 3b 20 20 20 20 20  nt failed";     
4370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4380: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4390: 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 48 3a  SQLITE_MISMATCH:
43a0: 20 20 20 7a 20 3d 20 22 64 61 74 61 74 79 70 65     z = "datatype
43b0: 20 6d 69 73 6d 61 74 63 68 22 3b 20 20 20 20 20   mismatch";     
43c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
43d0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
43e0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3a 20 20  SQLITE_MISUSE:  
43f0: 20 20 20 7a 20 3d 20 22 6c 69 62 72 61 72 79 20     z = "library 
4400: 72 6f 75 74 69 6e 65 20 63 61 6c 6c 65 64 20 6f  routine called o
4410: 75 74 20 6f 66 20 73 65 71 75 65 6e 63 65 22 3b  ut of sequence";
4420: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4430: 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 3a 20 20 20  SQLITE_NOLFS:   
4440: 20 20 20 7a 20 3d 20 22 6b 65 72 6e 65 6c 20 6c     z = "kernel l
4450: 61 63 6b 73 20 6c 61 72 67 65 20 66 69 6c 65 20  acks large file 
4460: 73 75 70 70 6f 72 74 22 3b 20 20 20 20 20 20 20  support";       
4470: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4480: 53 51 4c 49 54 45 5f 41 55 54 48 3a 20 20 20 20  SQLITE_AUTH:    
4490: 20 20 20 7a 20 3d 20 22 61 75 74 68 6f 72 69 7a     z = "authoriz
44a0: 61 74 69 6f 6e 20 64 65 6e 69 65 64 22 3b 20 20  ation denied";  
44b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
44c0: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
44d0: 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 3a 20 20  SQLITE_FORMAT:  
44e0: 20 20 20 7a 20 3d 20 22 61 75 78 69 6c 69 61 72     z = "auxiliar
44f0: 79 20 64 61 74 61 62 61 73 65 20 66 6f 72 6d 61  y database forma
4500: 74 20 65 72 72 6f 72 22 3b 20 20 20 20 20 20 20  t error";       
4510: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4520: 53 51 4c 49 54 45 5f 52 41 4e 47 45 3a 20 20 20  SQLITE_RANGE:   
4530: 20 20 20 7a 20 3d 20 22 62 69 6e 64 20 69 6e 64     z = "bind ind
4540: 65 78 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 22  ex out of range"
4550: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
4560: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
4570: 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3a 20 20  SQLITE_NOTADB:  
4580: 20 20 20 7a 20 3d 20 22 66 69 6c 65 20 69 73 20     z = "file is 
4590: 65 6e 63 72 79 70 74 65 64 20 6f 72 20 69 73 20  encrypted or is 
45a0: 6e 6f 74 20 61 20 64 61 74 61 62 61 73 65 22 3b  not a database";
45b0: 62 72 65 61 6b 3b 0a 20 20 20 20 64 65 66 61 75  break;.    defau
45c0: 6c 74 3a 20 20 20 20 20 20 20 20 20 20 20 20 20  lt:             
45d0: 20 20 20 7a 20 3d 20 22 75 6e 6b 6e 6f 77 6e 20     z = "unknown 
45e0: 65 72 72 6f 72 22 3b 20 20 20 20 20 20 20 20 20  error";         
45f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4600: 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 72 65 74  break;.  }.  ret
4610: 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn z;.}../*.** 
4620: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6d 70  This routine imp
4630: 6c 65 6d 65 6e 74 73 20 61 20 62 75 73 79 20 63  lements a busy c
4640: 61 6c 6c 62 61 63 6b 20 74 68 61 74 20 73 6c 65  allback that sle
4650: 65 70 73 20 61 6e 64 20 74 72 69 65 73 0a 2a 2a  eps and tries.**
4660: 20 61 67 61 69 6e 20 75 6e 74 69 6c 20 61 20 74   again until a t
4670: 69 6d 65 6f 75 74 20 76 61 6c 75 65 20 69 73 20  imeout value is 
4680: 72 65 61 63 68 65 64 2e 20 20 54 68 65 20 74 69  reached.  The ti
4690: 6d 65 6f 75 74 20 76 61 6c 75 65 20 69 73 0a 2a  meout value is.*
46a0: 2a 20 61 6e 20 69 6e 74 65 67 65 72 20 6e 75 6d  * an integer num
46b0: 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f  ber of milliseco
46c0: 6e 64 73 20 70 61 73 73 65 64 20 69 6e 20 61 73  nds passed in as
46d0: 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72   the first.** ar
46e0: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69  gument..*/.stati
46f0: 63 20 69 6e 74 20 73 71 6c 69 74 65 44 65 66 61  c int sqliteDefa
4700: 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 28  ultBusyCallback(
4710: 0a 20 76 6f 69 64 20 2a 54 69 6d 65 6f 75 74 2c  . void *Timeout,
4720: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61             /* Ma
4730: 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20  ximum amount of 
4740: 74 69 6d 65 20 74 6f 20 77 61 69 74 20 2a 2f 0a  time to wait */.
4750: 20 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20   int count      
4760: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
4770: 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62  ber of times tab
4780: 6c 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 79  le has been busy
4790: 20 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54   */.){.#if SQLIT
47a0: 45 5f 4d 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d  E_MIN_SLEEP_MS==
47b0: 31 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  1.  static const
47c0: 20 63 68 61 72 20 64 65 6c 61 79 73 5b 5d 20 3d   char delays[] =
47d0: 0a 20 20 20 20 20 7b 20 31 2c 20 32 2c 20 35 2c  .     { 1, 2, 5,
47e0: 20 31 30 2c 20 31 35 2c 20 32 30 2c 20 32 35 2c   10, 15, 20, 25,
47f0: 20 32 35 2c 20 20 32 35 2c 20 20 35 30 2c 20 20   25,  25,  50,  
4800: 35 30 2c 20 20 35 30 2c 20 31 30 30 7d 3b 0a 20  50,  50, 100};. 
4810: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 68   static const sh
4820: 6f 72 74 20 69 6e 74 20 74 6f 74 61 6c 73 5b 5d  ort int totals[]
4830: 20 3d 0a 20 20 20 20 20 7b 20 30 2c 20 31 2c 20   =.     { 0, 1, 
4840: 33 2c 20 20 38 2c 20 31 38 2c 20 33 33 2c 20 35  3,  8, 18, 33, 5
4850: 33 2c 20 37 38 2c 20 31 30 33 2c 20 31 32 38 2c  3, 78, 103, 128,
4860: 20 31 37 38 2c 20 32 32 38 2c 20 32 38 37 7d 3b   178, 228, 287};
4870: 0a 23 20 64 65 66 69 6e 65 20 4e 44 45 4c 41 59  .# define NDELAY
4880: 20 28 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 29   (sizeof(delays)
4890: 2f 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 5b 30  /sizeof(delays[0
48a0: 5d 29 29 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75  ])).  int timeou
48b0: 74 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f 75 74  t = (int)Timeout
48c0: 3b 0a 20 20 69 6e 74 20 64 65 6c 61 79 2c 20 70  ;.  int delay, p
48d0: 72 69 6f 72 3b 0a 0a 20 20 69 66 28 20 63 6f 75  rior;..  if( cou
48e0: 6e 74 20 3c 3d 20 4e 44 45 4c 41 59 20 29 7b 0a  nt <= NDELAY ){.
48f0: 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61      delay = dela
4900: 79 73 5b 63 6f 75 6e 74 2d 31 5d 3b 0a 20 20 20  ys[count-1];.   
4910: 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b   prior = totals[
4920: 63 6f 75 6e 74 2d 31 5d 3b 0a 20 20 7d 65 6c 73  count-1];.  }els
4930: 65 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64  e{.    delay = d
4940: 65 6c 61 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b  elays[NDELAY-1];
4950: 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74  .    prior = tot
4960: 61 6c 73 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20  als[NDELAY-1] + 
4970: 64 65 6c 61 79 2a 28 63 6f 75 6e 74 2d 4e 44 45  delay*(count-NDE
4980: 4c 41 59 2d 31 29 3b 0a 20 20 7d 0a 20 20 69 66  LAY-1);.  }.  if
4990: 28 20 70 72 69 6f 72 20 2b 20 64 65 6c 61 79 20  ( prior + delay 
49a0: 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20  > timeout ){.   
49b0: 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75 74   delay = timeout
49c0: 20 2d 20 70 72 69 6f 72 3b 0a 20 20 20 20 69 66   - prior;.    if
49d0: 28 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 65 74  ( delay<=0 ) ret
49e0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c  urn 0;.  }.  sql
49f0: 69 74 65 33 4f 73 53 6c 65 65 70 28 64 65 6c 61  ite3OsSleep(dela
4a00: 79 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  y);.  return 1;.
4a10: 23 65 6c 73 65 0a 20 20 69 6e 74 20 74 69 6d 65  #else.  int time
4a20: 6f 75 74 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f  out = (int)Timeo
4a30: 75 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 6e 74  ut;.  if( (count
4a40: 2b 31 29 2a 31 30 30 30 20 3e 20 74 69 6d 65 6f  +1)*1000 > timeo
4a50: 75 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ut ){.    return
4a60: 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65   0;.  }.  sqlite
4a70: 33 4f 73 53 6c 65 65 70 28 31 30 30 30 29 3b 0a  3OsSleep(1000);.
4a80: 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64    return 1;.#end
4a90: 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  if.}../*.** This
4aa0: 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68   routine sets th
4ab0: 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20  e busy callback 
4ac0: 66 6f 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61  for an Sqlite da
4ad0: 74 61 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a  tabase to the.**
4ae0: 20 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20   given callback 
4af0: 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68  function with th
4b00: 65 20 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74  e given argument
4b10: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
4b20: 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20  _busy_handler(. 
4b30: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20   sqlite3 *db,.  
4b40: 69 6e 74 20 28 2a 78 42 75 73 79 29 28 76 6f 69  int (*xBusy)(voi
4b50: 64 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20  d*,int),.  void 
4b60: 2a 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d 3e 62  *pArg.){.  db->b
4b70: 75 73 79 48 61 6e 64 6c 65 72 2e 78 46 75 6e 63  usyHandler.xFunc
4b80: 20 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e   = xBusy;.  db->
4b90: 62 75 73 79 48 61 6e 64 6c 65 72 2e 70 41 72 67  busyHandler.pArg
4ba0: 20 3d 20 70 41 72 67 3b 0a 20 20 72 65 74 75 72   = pArg;.  retur
4bb0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
4bc0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
4bd0: 4d 49 54 5f 50 52 4f 47 52 45 53 53 5f 43 41 4c  MIT_PROGRESS_CAL
4be0: 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 54 68 69 73  LBACK./*.** This
4bf0: 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68   routine sets th
4c00: 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62  e progress callb
4c10: 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69 74  ack for an Sqlit
4c20: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68  e database to th
4c30: 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62  e.** given callb
4c40: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69 74  ack function wit
4c50: 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67 75  h the given argu
4c60: 6d 65 6e 74 2e 20 54 68 65 20 70 72 6f 67 72 65  ment. The progre
4c70: 73 73 20 63 61 6c 6c 62 61 63 6b 20 77 69 6c 6c  ss callback will
4c80: 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64 20 65  .** be invoked e
4c90: 76 65 72 79 20 6e 4f 70 73 20 6f 70 63 6f 64 65  very nOps opcode
4ca0: 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  s..*/.void sqlit
4cb0: 65 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e 64  e3_progress_hand
4cc0: 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a 64  ler(.  sqlite *d
4cd0: 62 2c 20 0a 20 20 69 6e 74 20 6e 4f 70 73 2c 0a  b, .  int nOps,.
4ce0: 20 20 69 6e 74 20 28 2a 78 50 72 6f 67 72 65 73    int (*xProgres
4cf0: 73 29 28 76 6f 69 64 2a 29 2c 20 0a 20 20 76 6f  s)(void*), .  vo
4d00: 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 69 66  id *pArg.){.  if
4d10: 28 20 6e 4f 70 73 3e 30 20 29 7b 0a 20 20 20 20  ( nOps>0 ){.    
4d20: 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d 20  db->xProgress = 
4d30: 78 50 72 6f 67 72 65 73 73 3b 0a 20 20 20 20 64  xProgress;.    d
4d40: 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20  b->nProgressOps 
4d50: 3d 20 6e 4f 70 73 3b 0a 20 20 20 20 64 62 2d 3e  = nOps;.    db->
4d60: 70 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20 70  pProgressArg = p
4d70: 41 72 67 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  Arg;.  }else{.  
4d80: 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20    db->xProgress 
4d90: 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 6e 50 72  = 0;.    db->nPr
4da0: 6f 67 72 65 73 73 4f 70 73 20 3d 20 30 3b 0a 20  ogressOps = 0;. 
4db0: 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 73     db->pProgress
4dc0: 41 72 67 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 23  Arg = 0;.  }.}.#
4dd0: 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68  endif.../*.** Th
4de0: 69 73 20 72 6f 75 74 69 6e 65 20 69 6e 73 74 61  is routine insta
4df0: 6c 6c 73 20 61 20 64 65 66 61 75 6c 74 20 62 75  lls a default bu
4e00: 73 79 20 68 61 6e 64 6c 65 72 20 74 68 61 74 20  sy handler that 
4e10: 77 61 69 74 73 20 66 6f 72 20 74 68 65 0a 2a 2a  waits for the.**
4e20: 20 73 70 65 63 69 66 69 65 64 20 6e 75 6d 62 65   specified numbe
4e30: 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64  r of millisecond
4e40: 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69  s before returni
4e50: 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ng 0..*/.int sql
4e60: 69 74 65 33 5f 62 75 73 79 5f 74 69 6d 65 6f 75  ite3_busy_timeou
4e70: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69  t(sqlite3 *db, i
4e80: 6e 74 20 6d 73 29 7b 0a 20 20 69 66 28 20 6d 73  nt ms){.  if( ms
4e90: 3e 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  >0 ){.    sqlite
4ea0: 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 64  3_busy_handler(d
4eb0: 62 2c 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74  b, sqliteDefault
4ec0: 42 75 73 79 43 61 6c 6c 62 61 63 6b 2c 20 28 76  BusyCallback, (v
4ed0: 6f 69 64 2a 29 6d 73 29 3b 0a 20 20 7d 65 6c 73  oid*)ms);.  }els
4ee0: 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 62  e{.    sqlite3_b
4ef0: 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20  usy_handler(db, 
4f00: 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74  0, 0);.  }.  ret
4f10: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
4f20: 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61 6e  ../*.** Cause an
4f30: 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61 74  y pending operat
4f40: 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20 69  ion to stop at i
4f50: 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70 6f  ts earliest oppo
4f60: 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69 64  rtunity..*/.void
4f70: 20 73 71 6c 69 74 65 33 5f 69 6e 74 65 72 72 75   sqlite3_interru
4f80: 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a  pt(sqlite *db){.
4f90: 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53    db->flags |= S
4fa0: 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b  QLITE_Interrupt;
4fb0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77  .}../*.** Window
4fc0: 73 20 73 79 73 74 65 6d 73 20 73 68 6f 75 6c 64  s systems should
4fd0: 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69   call this routi
4fe0: 6e 65 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f 72  ne to free memor
4ff0: 79 20 74 68 61 74 0a 2a 2a 20 69 73 20 72 65 74  y that.** is ret
5000: 75 72 6e 65 64 20 69 6e 20 74 68 65 20 69 6e 20  urned in the in 
5010: 74 68 65 20 65 72 72 6d 73 67 20 70 61 72 61 6d  the errmsg param
5020: 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 33 5f  eter of sqlite3_
5030: 6f 70 65 6e 28 29 20 77 68 65 6e 0a 2a 2a 20 53  open() when.** S
5040: 51 4c 69 74 65 20 69 73 20 61 20 44 4c 4c 2e 20  QLite is a DLL. 
5050: 20 46 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e   For some reason
5060: 2c 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 77 6f  , it does not wo
5070: 72 6b 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28  rk to call free(
5080: 29 0a 2a 2a 20 64 69 72 65 63 74 6c 79 2e 0a 2a  ).** directly..*
5090: 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 77  *.** Note that w
50a0: 65 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 66  e need to call f
50b0: 72 65 65 28 29 20 6e 6f 74 20 73 71 6c 69 74 65  ree() not sqlite
50c0: 46 72 65 65 28 29 20 68 65 72 65 2c 20 73 69 6e  Free() here, sin
50d0: 63 65 20 65 76 65 72 79 0a 2a 2a 20 73 74 72 69  ce every.** stri
50e0: 6e 67 20 74 68 61 74 20 69 73 20 65 78 70 6f 72  ng that is expor
50f0: 74 65 64 20 66 72 6f 6d 20 53 51 4c 69 74 65 20  ted from SQLite 
5100: 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65  should have alre
5110: 61 64 79 20 70 61 73 73 65 64 20 74 68 72 6f 75  ady passed throu
5120: 67 68 0a 2a 2a 20 73 71 6c 69 74 65 33 53 74 72  gh.** sqlite3Str
5130: 52 65 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f  Realloc()..*/.vo
5140: 69 64 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28  id sqlite3_free(
5150: 63 68 61 72 20 2a 70 29 7b 20 66 72 65 65 28 70  char *p){ free(p
5160: 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61  ); }../*.** Crea
5170: 74 65 20 6e 65 77 20 75 73 65 72 20 66 75 6e 63  te new user func
5180: 74 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71  tions..*/.int sq
5190: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e  lite3_create_fun
51a0: 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33  ction(.  sqlite3
51b0: 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68   *db,.  const ch
51c0: 61 72 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d  ar *zFunctionNam
51d0: 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20  e,.  int nArg,. 
51e0: 20 69 6e 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64   int enc,.  void
51f0: 20 2a 70 55 73 65 72 44 61 74 61 2c 0a 20 20 76   *pUserData,.  v
5200: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c  oid (*xFunc)(sql
5210: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e  ite3_context*,in
5220: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  t,sqlite3_value 
5230: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53  **),.  void (*xS
5240: 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e  tep)(sqlite3_con
5250: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65  text*,int,sqlite
5260: 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76  3_value **),.  v
5270: 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71  oid (*xFinal)(sq
5280: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a  lite3_context*).
5290: 29 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 3b  ){.  FuncDef *p;
52a0: 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 0a 20  .  int nName;.. 
52b0: 20 69 66 28 20 28 64 62 3d 3d 30 20 7c 7c 20 7a   if( (db==0 || z
52c0: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 3d 3d 30 20  FunctionName==0 
52d0: 7c 7c 20 73 71 6c 69 74 65 33 53 61 66 65 74 79  || sqlite3Safety
52e0: 43 68 65 63 6b 28 64 62 29 29 20 7c 7c 0a 20 20  Check(db)) ||.  
52f0: 20 20 20 20 28 78 46 75 6e 63 20 26 26 20 28 78      (xFunc && (x
5300: 46 69 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29  Final || xStep))
5310: 20 7c 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75   || .      (!xFu
5320: 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26  nc && (xFinal &&
5330: 20 21 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20   !xStep)) ||.   
5340: 20 20 20 28 21 78 46 75 6e 63 20 26 26 20 28 21     (!xFunc && (!
5350: 78 46 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29  xFinal && xStep)
5360: 29 20 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67  ) ||.      (nArg
5370: 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 31 32 37 29  <-1 || nArg>127)
5380: 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 35 3c 28   ||.      (255<(
5390: 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a  nName = strlen(z
53a0: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20  FunctionName))) 
53b0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
53c0: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a  LITE_ERROR;.  }.
53d0: 20 20 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54    .  /* If SQLIT
53e0: 45 5f 55 54 46 31 36 20 69 73 20 73 70 65 63 69  E_UTF16 is speci
53f0: 66 69 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f  fied as the enco
5400: 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73  ding type, trans
5410: 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74  form this.  ** t
5420: 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f  o one of SQLITE_
5430: 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54  UTF16LE or SQLIT
5440: 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e 67 20  E_UTF16BE using 
5450: 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f  the.  ** SQLITE_
5460: 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72  UTF16NATIVE macr
5470: 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20  o. SQLITE_UTF16 
5480: 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65  is not used inte
5490: 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2a 0a 20 20 2a  rnally..  **.  *
54a0: 2a 20 49 66 20 53 51 4c 49 54 45 5f 41 4e 59 20  * If SQLITE_ANY 
54b0: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 61 64  is specified, ad
54c0: 64 20 74 68 72 65 65 20 76 65 72 73 69 6f 6e 73  d three versions
54d0: 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e   of the function
54e0: 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 68 61 73  .  ** to the has
54f0: 68 20 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20  h table..  */.  
5500: 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f  if( enc==SQLITE_
5510: 55 54 46 31 36 20 29 7b 0a 20 20 20 20 65 6e 63  UTF16 ){.    enc
5520: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e   = SQLITE_UTF16N
5530: 41 54 49 56 45 3b 0a 20 20 7d 65 6c 73 65 20 69  ATIVE;.  }else i
5540: 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 41  f( enc==SQLITE_A
5550: 4e 59 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63  NY ){.    int rc
5560: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  ;.    rc = sqlit
5570: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69  e3_create_functi
5580: 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e  on(db, zFunction
5590: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49  Name, nArg, SQLI
55a0: 54 45 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20  TE_UTF8,.       
55b0: 20 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75    pUserData, xFu
55c0: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61  nc, xStep, xFina
55d0: 6c 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d  l);.    if( rc!=
55e0: 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75  SQLITE_OK ) retu
55f0: 72 6e 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20  rn rc;.    rc = 
5600: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66  sqlite3_create_f
5610: 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e  unction(db, zFun
5620: 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c  ctionName, nArg,
5630: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c   SQLITE_UTF16LE,
5640: 0a 20 20 20 20 20 20 20 20 70 55 73 65 72 44 61  .        pUserDa
5650: 74 61 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70  ta, xFunc, xStep
5660: 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69  , xFinal);.    i
5670: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
5680: 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20   ) return rc;.  
5690: 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55    enc = SQLITE_U
56a0: 54 46 31 36 42 45 3b 0a 20 20 7d 0a 0a 20 20 70  TF16BE;.  }..  p
56b0: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75   = sqlite3FindFu
56c0: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63  nction(db, zFunc
56d0: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c  tionName, nName,
56e0: 20 6e 41 72 67 2c 20 65 6e 63 2c 20 31 29 3b 0a   nArg, enc, 1);.
56f0: 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74    if( p==0 ) ret
5700: 75 72 6e 20 31 3b 0a 20 20 70 2d 3e 78 46 75 6e  urn 1;.  p->xFun
5710: 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 2d 3e  c = xFunc;.  p->
5720: 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b 0a 20  xStep = xStep;. 
5730: 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20   p->xFinalize = 
5740: 78 46 69 6e 61 6c 3b 0a 20 20 70 2d 3e 70 55 73  xFinal;.  p->pUs
5750: 65 72 44 61 74 61 20 3d 20 70 55 73 65 72 44 61  erData = pUserDa
5760: 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  ta;.  return SQL
5770: 49 54 45 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 73 71  ITE_OK;.}.int sq
5780: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e  lite3_create_fun
5790: 63 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74  ction16(.  sqlit
57a0: 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20  e3 *db,.  const 
57b0: 76 6f 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e  void *zFunctionN
57c0: 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c  ame,.  int nArg,
57d0: 0a 20 20 69 6e 74 20 65 54 65 78 74 52 65 70 2c  .  int eTextRep,
57e0: 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61  .  void *pUserDa
57f0: 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75  ta,.  void (*xFu
5800: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  nc)(sqlite3_cont
5810: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33  ext*,int,sqlite3
5820: 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69  _value**),.  voi
5830: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74  d (*xStep)(sqlit
5840: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c  e3_context*,int,
5850: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29  sqlite3_value**)
5860: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61  ,.  void (*xFina
5870: 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  l)(sqlite3_conte
5880: 78 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63  xt*).){.  int rc
5890: 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a  ;.  char const *
58a0: 7a 46 75 6e 63 38 3b 0a 0a 20 20 73 71 6c 69 74  zFunc8;..  sqlit
58b0: 65 33 5f 76 61 6c 75 65 20 2a 70 54 6d 70 20 3d  e3_value *pTmp =
58c0: 20 73 71 6c 69 74 65 33 47 65 74 54 72 61 6e 73   sqlite3GetTrans
58d0: 69 65 6e 74 56 61 6c 75 65 28 64 62 29 3b 0a 20  ientValue(db);. 
58e0: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74   sqlite3ValueSet
58f0: 53 74 72 28 70 54 6d 70 2c 20 2d 31 2c 20 7a 46  Str(pTmp, -1, zF
5900: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 53 51 4c  unctionName, SQL
5910: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c  ITE_UTF16NATIVE,
5920: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
5930: 20 20 7a 46 75 6e 63 38 20 3d 20 73 71 6c 69 74    zFunc8 = sqlit
5940: 65 33 56 61 6c 75 65 54 65 78 74 28 70 54 6d 70  e3ValueText(pTmp
5950: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a  , SQLITE_UTF8);.
5960: 0a 20 20 69 66 28 20 21 7a 46 75 6e 63 38 20 29  .  if( !zFunc8 )
5970: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
5980: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20  ITE_NOMEM;.  }. 
5990: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72   rc = sqlite3_cr
59a0: 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62  eate_function(db
59b0: 2c 20 7a 46 75 6e 63 38 2c 20 6e 41 72 67 2c 20  , zFunc8, nArg, 
59c0: 65 54 65 78 74 52 65 70 2c 20 0a 20 20 20 20 20  eTextRep, .     
59d0: 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e   pUserData, xFun
59e0: 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c  c, xStep, xFinal
59f0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
5a00: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65  }../*.** Registe
5a10: 72 20 61 20 74 72 61 63 65 20 66 75 6e 63 74 69  r a trace functi
5a20: 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 72  on.  The pArg fr
5a30: 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c  om the previousl
5a40: 79 20 72 65 67 69 73 74 65 72 65 64 20 74 72 61  y registered tra
5a50: 63 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65  ce.** is returne
5a60: 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c  d.  .**.** A NUL
5a70: 4c 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f 6e  L trace function
5a80: 20 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 74   means that no t
5a90: 72 61 63 69 6e 67 20 69 73 20 65 78 65 63 75 74  racing is execut
5aa0: 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a  es.  A non-NULL.
5ab0: 2a 2a 20 74 72 61 63 65 20 69 73 20 61 20 70 6f  ** trace is a po
5ac0: 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74  inter to a funct
5ad0: 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76 6f  ion that is invo
5ae0: 6b 65 64 20 61 74 20 74 68 65 20 73 74 61 72 74  ked at the start
5af0: 20 6f 66 20 65 61 63 68 0a 2a 2a 20 73 71 6c 69   of each.** sqli
5b00: 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 76  te3_exec()..*/.v
5b10: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 74 72 61  oid *sqlite3_tra
5b20: 63 65 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 76  ce(sqlite *db, v
5b30: 6f 69 64 20 28 2a 78 54 72 61 63 65 29 28 76 6f  oid (*xTrace)(vo
5b40: 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29  id*,const char*)
5b50: 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20  , void *pArg){. 
5b60: 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62   void *pOld = db
5b70: 2d 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20 64  ->pTraceArg;.  d
5b80: 62 2d 3e 78 54 72 61 63 65 20 3d 20 78 54 72 61  b->xTrace = xTra
5b90: 63 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 65  ce;.  db->pTrace
5ba0: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 65  Arg = pArg;.  re
5bb0: 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a  turn pOld;.}../*
5bc0: 2a 2a 20 45 58 50 45 52 49 4d 45 4e 54 41 4c 20  ** EXPERIMENTAL 
5bd0: 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 67 69 73 74  ***.**.** Regist
5be0: 65 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 6f  er a function to
5bf0: 20 62 65 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e   be invoked when
5c00: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63   a transaction c
5c10: 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a 20 49 66 20 65  omments..** If e
5c20: 69 74 68 65 72 20 66 75 6e 63 74 69 6f 6e 20 72  ither function r
5c30: 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c  eturns non-zero,
5c40: 20 74 68 65 6e 20 74 68 65 20 63 6f 6d 6d 69 74   then the commit
5c50: 20 62 65 63 6f 6d 65 73 20 61 0a 2a 2a 20 72 6f   becomes a.** ro
5c60: 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 20  llback..*/.void 
5c70: 2a 73 71 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 5f  *sqlite3_commit_
5c80: 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 20 2a  hook(.  sqlite *
5c90: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  db,             
5ca0: 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 20    /* Attach the 
5cb0: 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 74  hook to this dat
5cc0: 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 28  abase */.  int (
5cd0: 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64  *xCallback)(void
5ce0: 2a 29 2c 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e  *),  /* Function
5cf0: 20 74 6f 20 69 6e 76 6f 6b 65 20 6f 6e 20 65 61   to invoke on ea
5d00: 63 68 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 76  ch commit */.  v
5d10: 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 20  oid *pArg       
5d20: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75           /* Argu
5d30: 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63  ment to the func
5d40: 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69  tion */.){.  voi
5d50: 64 20 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 43  d *pOld = db->pC
5d60: 6f 6d 6d 69 74 41 72 67 3b 0a 20 20 64 62 2d 3e  ommitArg;.  db->
5d70: 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 20  xCommitCallback 
5d80: 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64  = xCallback;.  d
5d90: 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 20 3d 20  b->pCommitArg = 
5da0: 70 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 70  pArg;.  return p
5db0: 4f 6c 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54  Old;.}.../*.** T
5dc0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63  his routine is c
5dd0: 61 6c 6c 65 64 20 74 6f 20 63 72 65 61 74 65 20  alled to create 
5de0: 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20  a connection to 
5df0: 61 20 64 61 74 61 62 61 73 65 20 42 54 72 65 65  a database BTree
5e00: 0a 2a 2a 20 64 72 69 76 65 72 2e 20 20 49 66 20  .** driver.  If 
5e10: 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65  zFilename is the
5e20: 20 6e 61 6d 65 20 6f 66 20 61 20 66 69 6c 65 2c   name of a file,
5e30: 20 74 68 65 6e 20 74 68 61 74 20 66 69 6c 65 20   then that file 
5e40: 69 73 0a 2a 2a 20 6f 70 65 6e 65 64 20 61 6e 64  is.** opened and
5e50: 20 75 73 65 64 2e 20 20 49 66 20 7a 46 69 6c 65   used.  If zFile
5e60: 6e 61 6d 65 20 69 73 20 74 68 65 20 6d 61 67 69  name is the magi
5e70: 63 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a  c name ":memory:
5e80: 22 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 64 61  " then.** the da
5e90: 74 61 62 61 73 65 20 69 73 20 73 74 6f 72 65 64  tabase is stored
5ea0: 20 69 6e 20 6d 65 6d 6f 72 79 20 28 61 6e 64 20   in memory (and 
5eb0: 69 73 20 74 68 75 73 20 66 6f 72 67 6f 74 74 65  is thus forgotte
5ec0: 6e 20 61 73 20 73 6f 6f 6e 20 61 73 0a 2a 2a 20  n as soon as.** 
5ed0: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69  the connection i
5ee0: 73 20 63 6c 6f 73 65 64 2e 29 20 20 49 66 20 7a  s closed.)  If z
5ef0: 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 4c 4c  Filename is NULL
5f00: 20 74 68 65 6e 20 74 68 65 20 64 61 74 61 62 61   then the databa
5f10: 73 65 0a 2a 2a 20 69 73 20 66 6f 72 20 74 65 6d  se.** is for tem
5f20: 70 6f 72 61 72 79 20 75 73 65 20 6f 6e 6c 79 20  porary use only 
5f30: 61 6e 64 20 69 73 20 64 65 6c 65 74 65 64 20 61  and is deleted a
5f40: 73 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 63 6f  s soon as the co
5f50: 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 63  nnection.** is c
5f60: 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 74  losed..**.** A t
5f70: 65 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 73  emporary databas
5f80: 65 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20  e can be either 
5f90: 61 20 64 69 73 6b 20 66 69 6c 65 20 28 74 68 61  a disk file (tha
5fa0: 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c  t is automatical
5fb0: 6c 79 0a 2a 2a 20 64 65 6c 65 74 65 64 20 77 68  ly.** deleted wh
5fc0: 65 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20 63  en the file is c
5fd0: 6c 6f 73 65 64 29 20 6f 72 20 61 20 73 65 74 20  losed) or a set 
5fe0: 6f 66 20 72 65 64 2d 62 6c 61 63 6b 20 74 72 65  of red-black tre
5ff0: 65 73 20 68 65 6c 64 20 69 6e 20 6d 65 6d 6f 72  es held in memor
6000: 79 2c 0a 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20  y,.** depending 
6010: 6f 6e 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66  on the values of
6020: 20 74 68 65 20 54 45 4d 50 5f 53 54 4f 52 45 20   the TEMP_STORE 
6030: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6d 61 63  compile-time mac
6040: 72 6f 20 61 6e 64 20 74 68 65 0a 2a 2a 20 64 62  ro and the.** db
6050: 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 76 61 72  ->temp_store var
6060: 69 61 62 6c 65 2c 20 61 63 63 6f 72 64 69 6e 67  iable, according
6070: 20 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e   to the followin
6080: 67 20 63 68 61 72 74 3a 0a 2a 2a 0a 2a 2a 20 20  g chart:.**.**  
6090: 20 20 20 20 20 54 45 4d 50 5f 53 54 4f 52 45 20       TEMP_STORE 
60a0: 20 20 20 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f      db->temp_sto
60b0: 72 65 20 20 20 20 20 4c 6f 63 61 74 69 6f 6e 20  re     Location 
60c0: 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74  of temporary dat
60d0: 61 62 61 73 65 0a 2a 2a 20 20 20 20 20 20 20 2d  abase.**       -
60e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d  ---------     --
60f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20  ------------    
6100: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d   ---------------
6110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a  ---------------.
6120: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 30 20 20  **           0  
6130: 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 79               any
6140: 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c               fil
6150: 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 31  e.**           1
6160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6170: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66  1              f
6180: 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  ile.**          
6190: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20   1              
61a0: 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20    2             
61b0: 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20 20   memory.**      
61c0: 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20       1          
61d0: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20        0         
61e0: 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20 20       file.**    
61f0: 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20         2        
6200: 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20          1       
6210: 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20         file.**  
6220: 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20           2      
6230: 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20            2     
6240: 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a           memory.
6250: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 32 20 20  **           2  
6260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20                0 
6270: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d               mem
6280: 6f 72 79 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  ory.**          
6290: 20 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20   3              
62a0: 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 20 20   any            
62b0: 20 6d 65 6d 6f 72 79 0a 2a 2f 0a 69 6e 74 20 73   memory.*/.int s
62c0: 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74 6f  qlite3BtreeFacto
62d0: 72 79 28 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69  ry(.  const sqli
62e0: 74 65 20 2a 64 62 2c 09 20 20 20 20 2f 2a 20 4d  te *db,.    /* M
62f0: 61 69 6e 20 64 61 74 61 62 61 73 65 20 77 68 65  ain database whe
6300: 6e 20 6f 70 65 6e 69 6e 67 20 61 75 78 20 6f 74  n opening aux ot
6310: 68 65 72 77 69 73 65 20 30 20 2a 2f 0a 20 20 63  herwise 0 */.  c
6320: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65  onst char *zFile
6330: 6e 61 6d 65 2c 20 20 20 20 2f 2a 20 4e 61 6d 65  name,    /* Name
6340: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f 6e   of the file con
6350: 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 72 65  taining the BTre
6360: 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20  e database */.  
6370: 69 6e 74 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 2c  int omitJournal,
6380: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 66 20            /* if 
6390: 54 52 55 45 20 74 68 65 6e 20 64 6f 20 6e 6f 74  TRUE then do not
63a0: 20 6a 6f 75 72 6e 61 6c 20 74 68 69 73 20 66 69   journal this fi
63b0: 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 61 63  le */.  int nCac
63c0: 68 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  he,             
63d0: 20 20 2f 2a 20 48 6f 77 20 6d 61 6e 79 20 70 61    /* How many pa
63e0: 67 65 73 20 69 6e 20 74 68 65 20 70 61 67 65 20  ges in the page 
63f0: 63 61 63 68 65 20 2a 2f 0a 20 20 42 74 72 65 65  cache */.  Btree
6400: 20 2a 2a 70 70 42 74 72 65 65 20 20 20 20 20 20   **ppBtree      
6410: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20       /* Pointer 
6420: 74 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a  to new Btree obj
6430: 65 63 74 20 77 72 69 74 74 65 6e 20 68 65 72 65  ect written here
6440: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 62 74 72   */.){.  int btr
6450: 65 65 5f 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20  ee_flags = 0;.  
6460: 0a 20 20 61 73 73 65 72 74 28 20 70 70 42 74 72  .  assert( ppBtr
6470: 65 65 20 21 3d 20 30 29 3b 0a 20 20 69 66 28 20  ee != 0);.  if( 
6480: 6f 6d 69 74 4a 6f 75 72 6e 61 6c 20 29 7b 0a 20  omitJournal ){. 
6490: 20 20 20 62 74 72 65 65 5f 66 6c 61 67 73 20 7c     btree_flags |
64a0: 3d 20 42 54 52 45 45 5f 4f 4d 49 54 5f 4a 4f 55  = BTREE_OMIT_JOU
64b0: 52 4e 41 4c 3b 0a 20 20 7d 0a 20 20 69 66 28 20  RNAL;.  }.  if( 
64c0: 21 7a 46 69 6c 65 6e 61 6d 65 20 29 7b 0a 20 20  !zFilename ){.  
64d0: 20 20 62 74 72 65 65 5f 66 6c 61 67 73 20 7c 3d    btree_flags |=
64e0: 20 42 54 52 45 45 5f 4d 45 4d 4f 52 59 3b 0a 20   BTREE_MEMORY;. 
64f0: 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 73 71 6c   }..  return sql
6500: 69 74 65 33 42 74 72 65 65 4f 70 65 6e 28 7a 46  ite3BtreeOpen(zF
6510: 69 6c 65 6e 61 6d 65 2c 20 70 70 42 74 72 65 65  ilename, ppBtree
6520: 2c 20 6e 43 61 63 68 65 2c 20 62 74 72 65 65 5f  , nCache, btree_
6530: 66 6c 61 67 73 2c 0a 20 20 20 20 20 20 28 76 6f  flags,.      (vo
6540: 69 64 20 2a 29 26 64 62 2d 3e 62 75 73 79 48 61  id *)&db->busyHa
6550: 6e 64 6c 65 72 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ndler);.}../*.**
6560: 20 52 65 74 75 72 6e 20 55 54 46 2d 38 20 65 6e   Return UTF-8 en
6570: 63 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61  coded English la
6580: 6e 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69  nguage explanati
6590: 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72  on of the most r
65a0: 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a  ecent.** error..
65b0: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
65c0: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 73 71  qlite3_errmsg(sq
65d0: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66  lite3 *db){.  if
65e0: 28 20 21 64 62 20 7c 7c 20 21 64 62 2d 3e 70 45  ( !db || !db->pE
65f0: 72 72 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20  rr ){.    /* If 
6600: 64 62 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e  db is NULL, then
6610: 20 61 73 73 75 6d 65 20 74 68 61 74 20 61 20 6d   assume that a m
6620: 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 64  alloc() failed d
6630: 75 72 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a 20  uring an.    ** 
6640: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 63  sqlite3_open() c
6650: 61 6c 6c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  all..    */.    
6660: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72  return sqlite3Er
6670: 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 4f 4d 45  rStr(SQLITE_NOME
6680: 4d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 73  M);.  }.  if( !s
6690: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
66a0: 74 28 64 62 2d 3e 70 45 72 72 29 20 29 7b 0a 20  t(db->pErr) ){. 
66b0: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65     return sqlite
66c0: 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43  3ErrStr(db->errC
66d0: 6f 64 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  ode);.  }.  retu
66e0: 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  rn sqlite3_value
66f0: 5f 74 65 78 74 28 64 62 2d 3e 70 45 72 72 29 3b  _text(db->pErr);
6700: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
6710: 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20   UTF-16 encoded 
6720: 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65  English language
6730: 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20   explanation of 
6740: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a  the most recent.
6750: 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e  ** error..*/.con
6760: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  st void *sqlite3
6770: 5f 65 72 72 6d 73 67 31 36 28 73 71 6c 69 74 65  _errmsg16(sqlite
6780: 33 20 2a 64 62 29 7b 0a 20 20 2f 2a 20 42 65 63  3 *db){.  /* Bec
6790: 61 75 73 65 20 61 6c 6c 20 74 68 65 20 63 68 61  ause all the cha
67a0: 72 61 63 74 65 72 73 20 69 6e 20 74 68 65 20 73  racters in the s
67b0: 74 72 69 6e 67 20 61 72 65 20 69 6e 20 74 68 65  tring are in the
67c0: 20 75 6e 69 63 6f 64 65 0a 20 20 2a 2a 20 72 61   unicode.  ** ra
67d0: 6e 67 65 20 30 78 30 30 2d 30 78 46 46 2c 20 69  nge 0x00-0xFF, i
67e0: 66 20 77 65 20 70 61 64 20 74 68 65 20 62 69 67  f we pad the big
67f0: 2d 65 6e 64 69 61 6e 20 73 74 72 69 6e 67 20 77  -endian string w
6800: 69 74 68 20 61 20 0a 20 20 2a 2a 20 7a 65 72 6f  ith a .  ** zero
6810: 20 62 79 74 65 2c 20 77 65 20 63 61 6e 20 6f 62   byte, we can ob
6820: 74 61 69 6e 20 74 68 65 20 6c 69 74 74 6c 65 2d  tain the little-
6830: 65 6e 64 69 61 6e 20 73 74 72 69 6e 67 20 77 69  endian string wi
6840: 74 68 0a 20 20 2a 2a 20 26 62 69 67 5f 65 6e 64  th.  ** &big_end
6850: 69 61 6e 5b 31 5d 2e 0a 20 20 2a 2f 0a 20 20 73  ian[1]..  */.  s
6860: 74 61 74 69 63 20 63 68 61 72 20 6f 75 74 4f 66  tatic char outOf
6870: 4d 65 6d 42 65 5b 5d 20 3d 20 7b 0a 20 20 20 20  MemBe[] = {.    
6880: 30 2c 20 27 6f 27 2c 20 30 2c 20 27 75 27 2c 20  0, 'o', 0, 'u', 
6890: 30 2c 20 27 74 27 2c 20 30 2c 20 27 20 27 2c 20  0, 't', 0, ' ', 
68a0: 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20 30 2c 20  .    0, 'o', 0, 
68b0: 27 66 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20  'f', 0, ' ', .  
68c0: 20 20 30 2c 20 27 6d 27 2c 20 30 2c 20 27 65 27    0, 'm', 0, 'e'
68d0: 2c 20 30 2c 20 27 6d 27 2c 20 30 2c 20 27 6f 27  , 0, 'm', 0, 'o'
68e0: 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 27 79 27  , 0, 'r', 0, 'y'
68f0: 2c 20 30 2c 20 30 2c 20 30 0a 20 20 7d 3b 0a 0a  , 0, 0, 0.  };..
6900: 20 20 69 66 28 20 64 62 20 26 26 20 64 62 2d 3e    if( db && db->
6910: 70 45 72 72 20 29 7b 0a 20 20 20 20 69 66 28 20  pErr ){.    if( 
6920: 21 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  !sqlite3_value_t
6930: 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72 29 20  ext16(db->pErr) 
6940: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
6950: 56 61 6c 75 65 53 65 74 53 74 72 28 64 62 2d 3e  ValueSetStr(db->
6960: 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c 69 74 65  pErr, -1, sqlite
6970: 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43  3ErrStr(db->errC
6980: 6f 64 65 29 2c 0a 20 20 20 20 20 20 20 20 20 20  ode),.          
6990: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c  SQLITE_UTF8, SQL
69a0: 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20  ITE_STATIC);.   
69b0: 20 7d 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74   }.    if( sqlit
69c0: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28  e3_value_text16(
69d0: 64 62 2d 3e 70 45 72 72 29 20 29 7b 0a 20 20 20  db->pErr) ){.   
69e0: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65     return sqlite
69f0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64  3_value_text16(d
6a00: 62 2d 3e 70 45 72 72 29 3b 0a 20 20 20 20 7d 0a  b->pErr);.    }.
6a10: 20 20 7d 20 20 0a 0a 20 20 2f 2a 20 49 66 20 64    }  ..  /* If d
6a20: 62 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20  b is NULL, then 
6a30: 61 73 73 75 6d 65 20 74 68 61 74 20 61 20 6d 61  assume that a ma
6a40: 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 64 75  lloc() failed du
6a50: 72 69 6e 67 20 61 6e 0a 20 20 2a 2a 20 73 71 6c  ring an.  ** sql
6a60: 69 74 65 33 5f 6f 70 65 6e 28 29 20 63 61 6c 6c  ite3_open() call
6a70: 2e 20 57 65 20 68 61 76 65 20 61 20 73 74 61 74  . We have a stat
6a80: 69 63 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68  ic version of th
6a90: 65 20 73 74 72 69 6e 67 20 0a 20 20 2a 2a 20 22  e string .  ** "
6aa0: 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 20 65  out of memory" e
6ab0: 6e 63 6f 64 65 64 20 75 73 69 6e 67 20 55 54 46  ncoded using UTF
6ac0: 2d 31 36 20 6a 75 73 74 20 66 6f 72 20 74 68 69  -16 just for thi
6ad0: 73 20 70 75 72 70 6f 73 65 2e 0a 20 20 2a 2f 0a  s purpose..  */.
6ae0: 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a    return (void *
6af0: 29 28 26 6f 75 74 4f 66 4d 65 6d 42 65 5b 53 51  )(&outOfMemBe[SQ
6b00: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45  LITE_UTF16NATIVE
6b10: 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45  ==SQLITE_UTF16LE
6b20: 3f 31 3a 30 5d 29 3b 0a 7d 0a 0a 69 6e 74 20 73  ?1:0]);.}..int s
6b30: 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 73  qlite3_errcode(s
6b40: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69  qlite3 *db){.  i
6b50: 66 28 20 21 64 62 20 29 20 72 65 74 75 72 6e 20  f( !db ) return 
6b60: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
6b70: 72 65 74 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f  return db->errCo
6b80: 64 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65  de;.}../*.** Che
6b90: 63 6b 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65  ck schema cookie
6ba0: 73 20 69 6e 20 61 6c 6c 20 64 61 74 61 62 61 73  s in all databas
6bb0: 65 73 20 65 78 63 65 70 74 20 54 45 4d 50 2e 20  es except TEMP. 
6bc0: 20 49 66 20 61 6e 79 20 63 6f 6f 6b 69 65 20 69   If any cookie i
6bd0: 73 20 6f 75 74 0a 2a 2a 20 6f 66 20 64 61 74 65  s out.** of date
6be0: 2c 20 72 65 74 75 72 6e 20 30 2e 20 20 49 66 20  , return 0.  If 
6bf0: 61 6c 6c 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69  all schema cooki
6c00: 65 73 20 61 72 65 20 63 75 72 72 65 6e 74 2c 20  es are current, 
6c10: 72 65 74 75 72 6e 20 31 2e 0a 2a 2f 0a 73 74 61  return 1..*/.sta
6c20: 74 69 63 20 69 6e 74 20 73 63 68 65 6d 61 49 73  tic int schemaIs
6c30: 56 61 6c 69 64 28 73 71 6c 69 74 65 20 2a 64 62  Valid(sqlite *db
6c40: 29 7b 0a 20 20 69 6e 74 20 69 44 62 3b 0a 20 20  ){.  int iDb;.  
6c50: 69 6e 74 20 72 63 3b 0a 20 20 42 74 43 75 72 73  int rc;.  BtCurs
6c60: 6f 72 20 2a 63 75 72 54 65 6d 70 3b 0a 20 20 69  or *curTemp;.  i
6c70: 6e 74 20 63 6f 6f 6b 69 65 3b 0a 20 20 69 6e 74  nt cookie;.  int
6c80: 20 61 6c 6c 4f 6b 20 3d 20 31 3b 0a 0a 20 20 66   allOk = 1;..  f
6c90: 6f 72 28 69 44 62 3d 30 3b 20 61 6c 6c 4f 6b 20  or(iDb=0; allOk 
6ca0: 26 26 20 69 44 62 3c 64 62 2d 3e 6e 44 62 3b 20  && iDb<db->nDb; 
6cb0: 69 44 62 2b 2b 29 7b 0a 20 20 20 20 42 74 72 65  iDb++){.    Btre
6cc0: 65 20 2a 70 42 74 3b 0a 20 20 20 20 69 66 28 20  e *pBt;.    if( 
6cd0: 69 44 62 3d 3d 31 20 29 20 63 6f 6e 74 69 6e 75  iDb==1 ) continu
6ce0: 65 3b 0a 20 20 20 20 70 42 74 20 3d 20 64 62 2d  e;.    pBt = db-
6cf0: 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 3b 0a 20  >aDb[iDb].pBt;. 
6d00: 20 20 20 69 66 28 20 70 42 74 3d 3d 30 20 29 20     if( pBt==0 ) 
6d10: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 72 63  continue;.    rc
6d20: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43   = sqlite3BtreeC
6d30: 75 72 73 6f 72 28 70 42 74 2c 20 4d 41 53 54 45  ursor(pBt, MASTE
6d40: 52 5f 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 30 2c  R_ROOT, 0, 0, 0,
6d50: 20 26 63 75 72 54 65 6d 70 29 3b 0a 20 20 20 20   &curTemp);.    
6d60: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
6d70: 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  K ){.      rc = 
6d80: 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 4d  sqlite3BtreeGetM
6d90: 65 74 61 28 70 42 74 2c 20 31 2c 20 26 63 6f 6f  eta(pBt, 1, &coo
6da0: 6b 69 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20  kie);.      if( 
6db0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
6dc0: 20 63 6f 6f 6b 69 65 21 3d 64 62 2d 3e 61 44 62   cookie!=db->aDb
6dd0: 5b 69 44 62 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f  [iDb].schema_coo
6de0: 6b 69 65 20 29 7b 0a 20 20 20 20 20 20 20 20 61  kie ){.        a
6df0: 6c 6c 4f 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20  llOk = 0;.      
6e00: 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42  }.      sqlite3B
6e10: 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28  treeCloseCursor(
6e20: 63 75 72 54 65 6d 70 29 3b 0a 20 20 20 20 7d 0a  curTemp);.    }.
6e30: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 61 6c 6c    }.  return all
6e40: 4f 6b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d  Ok;.}../*.** Com
6e50: 70 69 6c 65 20 74 68 65 20 55 54 46 2d 38 20 65  pile the UTF-8 e
6e60: 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65  ncoded SQL state
6e70: 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20 61  ment zSql into a
6e80: 20 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64 6c   statement handl
6e90: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
6ea0: 33 5f 70 72 65 70 61 72 65 28 0a 20 20 73 71 6c  3_prepare(.  sql
6eb0: 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20  ite3 *db,       
6ec0: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61         /* Databa
6ed0: 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20  se handle. */.  
6ee0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c  const char *zSql
6ef0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46  ,         /* UTF
6f00: 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73  -8 encoded SQL s
6f10: 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69  tatement. */.  i
6f20: 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20  nt nBytes,      
6f30: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67           /* Leng
6f40: 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79  th of zSql in by
6f50: 74 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65  tes. */.  sqlite
6f60: 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c  3_stmt **ppStmt,
6f70: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f      /* OUT: A po
6f80: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65  inter to the pre
6f90: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
6fa0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 2a  */.  const char*
6fb0: 2a 20 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f  * pzTail       /
6fc0: 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61  * OUT: End of pa
6fd0: 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29  rsed string */.)
6fe0: 7b 0a 20 20 50 61 72 73 65 20 73 50 61 72 73 65  {.  Parse sParse
6ff0: 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73  ;.  char *zErrMs
7000: 67 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20  g = 0;.  int rc 
7010: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20  = SQLITE_OK;..  
7020: 61 73 73 65 72 74 28 20 70 70 53 74 6d 74 20 29  assert( ppStmt )
7030: 3b 0a 20 20 2a 70 70 53 74 6d 74 20 3d 20 30 3b  ;.  *ppStmt = 0;
7040: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61  .  if( sqlite3Sa
7050: 66 65 74 79 4f 6e 28 64 62 29 20 29 7b 0a 20 20  fetyOn(db) ){.  
7060: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49    rc = SQLITE_MI
7070: 53 55 53 45 3b 0a 20 20 20 20 67 6f 74 6f 20 70  SUSE;.    goto p
7080: 72 65 70 61 72 65 5f 6f 75 74 3b 0a 20 20 7d 0a  repare_out;.  }.
7090: 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72 73  .  memset(&sPars
70a0: 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 50 61  e, 0, sizeof(sPa
70b0: 72 73 65 29 29 3b 0a 20 20 73 50 61 72 73 65 2e  rse));.  sParse.
70c0: 64 62 20 3d 20 64 62 3b 0a 20 20 73 71 6c 69 74  db = db;.  sqlit
70d0: 65 33 52 75 6e 50 61 72 73 65 72 28 26 73 50 61  e3RunParser(&sPa
70e0: 72 73 65 2c 20 7a 53 71 6c 2c 20 26 7a 45 72 72  rse, zSql, &zErr
70f0: 4d 73 67 29 3b 0a 0a 20 20 69 66 28 20 64 62 2d  Msg);..  if( db-
7100: 3e 78 54 72 61 63 65 20 26 26 20 21 64 62 2d 3e  >xTrace && !db->
7110: 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20 20  init.busy ){.   
7120: 20 2f 2a 20 54 72 61 63 65 20 6f 6e 6c 79 20 74   /* Trace only t
7130: 68 65 20 73 74 61 74 6d 65 6e 74 20 74 68 61 74  he statment that
7140: 20 77 61 73 20 63 6f 6d 70 69 6c 65 64 2e 0a 20   was compiled.. 
7150: 20 20 20 2a 2a 20 4d 61 6b 65 20 61 20 63 6f 70     ** Make a cop
7160: 79 20 6f 66 20 74 68 61 74 20 70 61 72 74 20 6f  y of that part o
7170: 66 20 74 68 65 20 53 51 4c 20 73 74 72 69 6e 67  f the SQL string
7180: 20 73 69 6e 63 65 20 7a 53 51 4c 20 69 73 20 63   since zSQL is c
7190: 6f 6e 73 74 0a 20 20 20 20 2a 2a 20 61 6e 64 20  onst.    ** and 
71a0: 77 65 20 6d 75 73 74 20 70 61 73 73 20 61 20 7a  we must pass a z
71b0: 65 72 6f 20 74 65 72 6d 69 6e 61 74 65 64 20 73  ero terminated s
71c0: 74 72 69 6e 67 20 74 6f 20 74 68 65 20 74 72 61  tring to the tra
71d0: 63 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20  ce function.    
71e0: 2a 2a 20 54 68 65 20 63 6f 70 79 20 69 73 20 75  ** The copy is u
71f0: 6e 6e 65 63 65 73 73 61 72 79 20 69 66 20 74 68  nnecessary if th
7200: 65 20 74 61 69 6c 20 70 6f 69 6e 74 65 72 20 69  e tail pointer i
7210: 73 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 74 68  s pointing at th
7220: 65 0a 20 20 20 20 2a 2a 20 62 65 67 69 6e 6e 69  e.    ** beginni
7230: 67 20 6f 72 20 65 6e 64 20 6f 66 20 74 68 65 20  g or end of the 
7240: 53 51 4c 20 73 74 72 69 6e 67 2e 0a 20 20 20 20  SQL string..    
7250: 2a 2f 0a 20 20 20 20 69 66 28 20 73 50 61 72 73  */.    if( sPars
7260: 65 2e 7a 54 61 69 6c 20 26 26 20 73 50 61 72 73  e.zTail && sPars
7270: 65 2e 7a 54 61 69 6c 21 3d 7a 53 71 6c 20 26 26  e.zTail!=zSql &&
7280: 20 2a 73 50 61 72 73 65 2e 7a 54 61 69 6c 20 29   *sParse.zTail )
7290: 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 74 6d  {.      char *tm
72a0: 70 53 71 6c 20 3d 20 73 71 6c 69 74 65 53 74 72  pSql = sqliteStr
72b0: 4e 44 75 70 28 7a 53 71 6c 2c 20 73 50 61 72 73  NDup(zSql, sPars
72c0: 65 2e 7a 54 61 69 6c 20 2d 20 7a 53 71 6c 29 3b  e.zTail - zSql);
72d0: 0a 20 20 20 20 20 20 69 66 28 20 74 6d 70 53 71  .      if( tmpSq
72e0: 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 64 62 2d  l ){.        db-
72f0: 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54 72 61  >xTrace(db->pTra
7300: 63 65 41 72 67 2c 20 74 6d 70 53 71 6c 29 3b 0a  ceArg, tmpSql);.
7310: 20 20 20 20 20 20 20 20 66 72 65 65 28 74 6d 70          free(tmp
7320: 53 71 6c 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73  Sql);.      }els
7330: 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66  e{.        /* If
7340: 20 61 20 6d 65 6d 6f 72 79 20 65 72 72 6f 72 20   a memory error 
7350: 6f 63 63 75 72 72 65 64 20 64 75 72 69 6e 67 20  occurred during 
7360: 74 68 65 20 63 6f 70 79 2c 0a 20 20 20 20 20 20  the copy,.      
7370: 20 20 2a 2a 20 74 72 61 63 65 20 65 6e 74 69 72    ** trace entir
7380: 65 20 53 51 4c 20 73 74 72 69 6e 67 20 61 6e 64  e SQL string and
7390: 20 66 61 6c 6c 20 74 68 72 6f 75 67 68 20 74 6f   fall through to
73a0: 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20   the.        ** 
73b0: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66  sqlite3_malloc_f
73c0: 61 69 6c 65 64 20 74 65 73 74 20 74 6f 20 72 65  ailed test to re
73d0: 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72 2e 0a  port the error..
73e0: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20          */.     
73f0: 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28 64 62     db->xTrace(db
7400: 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 7a 53 71  ->pTraceArg, zSq
7410: 6c 29 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20  l); .      }.   
7420: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 64 62   }else{.      db
7430: 2d 3e 78 54 72 61 63 65 28 64 62 2d 3e 70 54 72  ->xTrace(db->pTr
7440: 61 63 65 41 72 67 2c 20 7a 53 71 6c 29 3b 20 0a  aceArg, zSql); .
7450: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
7460: 50 72 69 6e 74 20 61 20 63 6f 70 79 20 6f 66 20  Print a copy of 
7470: 53 51 4c 20 61 73 20 69 74 20 69 73 20 65 78 65  SQL as it is exe
7480: 63 75 74 65 64 20 69 66 20 74 68 65 20 53 51 4c  cuted if the SQL
7490: 5f 54 52 41 43 45 20 70 72 61 67 6d 61 20 69 73  _TRACE pragma is
74a0: 20 74 75 72 6e 65 64 0a 20 20 2a 2a 20 6f 6e 20   turned.  ** on 
74b0: 69 6e 20 64 65 62 75 67 67 69 6e 67 20 6d 6f 64  in debugging mod
74c0: 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53  e..  */.#ifdef S
74d0: 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 69 66  QLITE_DEBUG.  if
74e0: 28 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  ( (db->flags & S
74f0: 51 4c 49 54 45 5f 53 71 6c 54 72 61 63 65 29 21  QLITE_SqlTrace)!
7500: 3d 30 20 26 26 20 73 50 61 72 73 65 2e 7a 54 61  =0 && sParse.zTa
7510: 69 6c 20 26 26 20 73 50 61 72 73 65 2e 7a 54 61  il && sParse.zTa
7520: 69 6c 21 3d 7a 53 71 6c 20 29 7b 0a 20 20 20 20  il!=zSql ){.    
7530: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e  sqlite3DebugPrin
7540: 74 66 28 22 53 51 4c 2d 74 72 61 63 65 3a 20 25  tf("SQL-trace: %
7550: 2e 2a 73 5c 6e 22 2c 20 73 50 61 72 73 65 2e 7a  .*s\n", sParse.z
7560: 54 61 69 6c 20 2d 20 7a 53 71 6c 2c 20 7a 53 71  Tail - zSql, zSq
7570: 6c 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f  l);.  }.#endif /
7580: 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 2a  * SQLITE_DEBUG *
7590: 2f 0a 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65  /...  if( sqlite
75a0: 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20  3_malloc_failed 
75b0: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
75c0: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 73 71  TE_NOMEM;.    sq
75d0: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c  lite3RollbackAll
75e0: 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  (db);.    sqlite
75f0: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
7600: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 20  hema(db, 0);.   
7610: 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53   db->flags &= ~S
7620: 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b 0a 20  QLITE_InTrans;. 
7630: 20 20 20 67 6f 74 6f 20 70 72 65 70 61 72 65 5f     goto prepare_
7640: 6f 75 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73  out;.  }.  if( s
7650: 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49 54 45  Parse.rc==SQLITE
7660: 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65 2e 72  _DONE ) sParse.r
7670: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
7680: 20 69 66 28 20 73 50 61 72 73 65 2e 63 68 65 63   if( sParse.chec
7690: 6b 53 63 68 65 6d 61 20 26 26 20 21 73 63 68 65  kSchema && !sche
76a0: 6d 61 49 73 56 61 6c 69 64 28 64 62 29 20 29 7b  maIsValid(db) ){
76b0: 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63 20 3d  .    sParse.rc =
76c0: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 3b 0a   SQLITE_SCHEMA;.
76d0: 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72 73 65    }.  if( sParse
76e0: 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45  .rc==SQLITE_SCHE
76f0: 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  MA ){.    sqlite
7700: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
7710: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 7d  hema(db, 0);.  }
7720: 0a 20 20 69 66 28 20 70 7a 54 61 69 6c 20 29 20  .  if( pzTail ) 
7730: 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 72 73 65  *pzTail = sParse
7740: 2e 7a 54 61 69 6c 3b 0a 20 20 72 63 20 3d 20 73  .zTail;.  rc = s
7750: 50 61 72 73 65 2e 72 63 3b 0a 0a 20 20 69 66 28  Parse.rc;..  if(
7760: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
7770: 26 20 73 50 61 72 73 65 2e 70 56 64 62 65 20 26  & sParse.pVdbe &
7780: 26 20 73 50 61 72 73 65 2e 65 78 70 6c 61 69 6e  & sParse.explain
7790: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56   ){.    sqlite3V
77a0: 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 73 50  dbeSetNumCols(sP
77b0: 61 72 73 65 2e 70 56 64 62 65 2c 20 35 29 3b 0a  arse.pVdbe, 5);.
77c0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
77d0: 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65  etColName(sParse
77e0: 2e 70 56 64 62 65 2c 20 30 2c 20 22 61 64 64 72  .pVdbe, 0, "addr
77f0: 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20  ", P3_STATIC);. 
7800: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65     sqlite3VdbeSe
7810: 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e  tColName(sParse.
7820: 70 56 64 62 65 2c 20 31 2c 20 22 6f 70 63 6f 64  pVdbe, 1, "opcod
7830: 65 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a  e", P3_STATIC);.
7840: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
7850: 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65  etColName(sParse
7860: 2e 70 56 64 62 65 2c 20 32 2c 20 22 70 31 22 2c  .pVdbe, 2, "p1",
7870: 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20 20 20   P3_STATIC);.   
7880: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43   sqlite3VdbeSetC
7890: 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56  olName(sParse.pV
78a0: 64 62 65 2c 20 33 2c 20 22 70 32 22 2c 20 50 33  dbe, 3, "p2", P3
78b0: 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 73 71  _STATIC);.    sq
78c0: 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e  lite3VdbeSetColN
78d0: 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65  ame(sParse.pVdbe
78e0: 2c 20 34 2c 20 22 70 33 22 2c 20 50 33 5f 53 54  , 4, "p3", P3_ST
78f0: 41 54 49 43 29 3b 0a 20 20 7d 20 0a 0a 70 72 65  ATIC);.  } ..pre
7900: 70 61 72 65 5f 6f 75 74 3a 0a 20 20 69 66 28 20  pare_out:.  if( 
7910: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66  sqlite3SafetyOff
7920: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 63 20 3d  (db) ){.    rc =
7930: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
7940: 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51    }.  if( rc==SQ
7950: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a  LITE_OK ){.    *
7960: 70 70 53 74 6d 74 20 3d 20 28 73 71 6c 69 74 65  ppStmt = (sqlite
7970: 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70  3_stmt*)sParse.p
7980: 56 64 62 65 3b 0a 20 20 7d 65 6c 73 65 20 69 66  Vdbe;.  }else if
7990: 28 20 73 50 61 72 73 65 2e 70 56 64 62 65 20 29  ( sParse.pVdbe )
79a0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69  {.    sqlite3_fi
79b0: 6e 61 6c 69 7a 65 28 28 73 71 6c 69 74 65 33 5f  nalize((sqlite3_
79c0: 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70 56 64  stmt*)sParse.pVd
79d0: 62 65 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  be);.  }..  if( 
79e0: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 73  zErrMsg ){.    s
79f0: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
7a00: 72 63 2c 20 22 25 73 22 2c 20 7a 45 72 72 4d 73  rc, "%s", zErrMs
7a10: 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72  g);.    sqliteFr
7a20: 65 65 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d  ee(zErrMsg);.  }
7a30: 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65  else{.    sqlite
7a40: 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 30  3Error(db, rc, 0
7a50: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
7a60: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d  rc;.}../*.** Com
7a70: 70 69 6c 65 20 74 68 65 20 55 54 46 2d 31 36 20  pile the UTF-16 
7a80: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
7a90: 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20  ement zSql into 
7aa0: 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64  a statement hand
7ab0: 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  le..*/.int sqlit
7ac0: 65 33 5f 70 72 65 70 61 72 65 31 36 28 0a 20 20  e3_prepare16(.  
7ad0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
7ae0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
7af0: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f  abase handle. */
7b00: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
7b10: 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a  zSql,         /*
7b20: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53   UTF-8 encoded S
7b30: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f  QL statement. */
7b40: 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20  .  int nBytes,  
7b50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7b60: 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69  Length of zSql i
7b70: 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71  n bytes. */.  sq
7b80: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53  lite3_stmt **ppS
7b90: 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20  tmt,    /* OUT: 
7ba0: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  A pointer to the
7bb0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
7bc0: 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76  ent */.  const v
7bd0: 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20  oid **pzTail    
7be0: 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f     /* OUT: End o
7bf0: 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20  f parsed string 
7c00: 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 54 68 69 73 20  */.){.  /* This 
7c10: 66 75 6e 63 74 69 6f 6e 20 63 75 72 72 65 6e 74  function current
7c20: 6c 79 20 77 6f 72 6b 73 20 62 79 20 66 69 72 73  ly works by firs
7c30: 74 20 74 72 61 6e 73 66 6f 72 6d 69 6e 67 20 74  t transforming t
7c40: 68 65 20 55 54 46 2d 31 36 0a 20 20 2a 2a 20 65  he UTF-16.  ** e
7c50: 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 20 74 6f  ncoded string to
7c60: 20 55 54 46 2d 38 2c 20 74 68 65 6e 20 69 6e 76   UTF-8, then inv
7c70: 6f 6b 69 6e 67 20 73 71 6c 69 74 65 33 5f 70 72  oking sqlite3_pr
7c80: 65 70 61 72 65 28 29 2e 20 54 68 65 0a 20 20 2a  epare(). The.  *
7c90: 2a 20 74 72 69 63 6b 79 20 62 69 74 20 69 73 20  * tricky bit is 
7ca0: 66 69 67 75 72 69 6e 67 20 6f 75 74 20 74 68 65  figuring out the
7cb0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 72 65 74 75   pointer to retu
7cc0: 72 6e 20 69 6e 20 2a 70 7a 54 61 69 6c 2e 0a 20  rn in *pzTail.. 
7cd0: 20 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 74   */.  char const
7ce0: 20 2a 7a 53 71 6c 38 20 3d 20 30 3b 0a 20 20 63   *zSql8 = 0;.  c
7cf0: 68 61 72 20 63 6f 6e 73 74 20 2a 7a 54 61 69 6c  har const *zTail
7d00: 38 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b  8 = 0;.  int rc;
7d10: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  .  sqlite3_value
7d20: 20 2a 70 54 6d 70 3b 0a 0a 20 20 70 54 6d 70 20   *pTmp;..  pTmp 
7d30: 3d 20 73 71 6c 69 74 65 33 47 65 74 54 72 61 6e  = sqlite3GetTran
7d40: 73 69 65 6e 74 56 61 6c 75 65 28 64 62 29 3b 0a  sientValue(db);.
7d50: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65    sqlite3ValueSe
7d60: 74 53 74 72 28 70 54 6d 70 2c 20 2d 31 2c 20 7a  tStr(pTmp, -1, z
7d70: 53 71 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  Sql, SQLITE_UTF1
7d80: 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 54 45 5f  6NATIVE, SQLITE_
7d90: 53 54 41 54 49 43 29 3b 0a 20 20 7a 53 71 6c 38  STATIC);.  zSql8
7da0: 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54   = sqlite3ValueT
7db0: 65 78 74 28 70 54 6d 70 2c 20 53 51 4c 49 54 45  ext(pTmp, SQLITE
7dc0: 5f 55 54 46 38 29 3b 0a 20 20 69 66 28 20 21 7a  _UTF8);.  if( !z
7dd0: 53 71 6c 38 20 29 7b 0a 20 20 20 20 73 71 6c 69  Sql8 ){.    sqli
7de0: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c  te3Error(db, SQL
7df0: 49 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b 0a 20  ITE_NOMEM, 0);. 
7e00: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
7e10: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 63  _NOMEM;.  }.  rc
7e20: 20 3d 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61   = sqlite3_prepa
7e30: 72 65 28 64 62 2c 20 7a 53 71 6c 38 2c 20 2d 31  re(db, zSql8, -1
7e40: 2c 20 70 70 53 74 6d 74 2c 20 26 7a 54 61 69 6c  , ppStmt, &zTail
7e50: 38 29 3b 0a 0a 20 20 69 66 28 20 7a 54 61 69 6c  8);..  if( zTail
7e60: 38 20 26 26 20 70 7a 54 61 69 6c 20 29 7b 0a 20  8 && pzTail ){. 
7e70: 20 20 20 2f 2a 20 49 66 20 73 71 6c 69 74 65 33     /* If sqlite3
7e80: 5f 70 72 65 70 61 72 65 20 72 65 74 75 72 6e 73  _prepare returns
7e90: 20 61 20 74 61 69 6c 20 70 6f 69 6e 74 65 72 2c   a tail pointer,
7ea0: 20 77 65 20 63 61 6c 63 75 6c 61 74 65 20 74 68   we calculate th
7eb0: 65 0a 20 20 20 20 2a 2a 20 65 71 75 69 76 61 6c  e.    ** equival
7ec0: 65 6e 74 20 70 6f 69 6e 74 65 72 20 69 6e 74 6f  ent pointer into
7ed0: 20 74 68 65 20 55 54 46 2d 31 36 20 73 74 72 69   the UTF-16 stri
7ee0: 6e 67 20 62 79 20 63 6f 75 6e 74 69 6e 67 20 74  ng by counting t
7ef0: 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 20 20 2a  he unicode.    *
7f00: 2a 20 63 68 61 72 61 63 74 65 72 73 20 62 65 74  * characters bet
7f10: 77 65 65 6e 20 7a 53 71 6c 38 20 61 6e 64 20 7a  ween zSql8 and z
7f20: 54 61 69 6c 38 2c 20 61 6e 64 20 74 68 65 6e 20  Tail8, and then 
7f30: 72 65 74 75 72 6e 69 6e 67 20 61 20 70 6f 69 6e  returning a poin
7f40: 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 65 20 73  ter.    ** the s
7f50: 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68  ame number of ch
7f60: 61 72 61 63 74 65 72 73 20 69 6e 74 6f 20 74 68  aracters into th
7f70: 65 20 55 54 46 2d 31 36 20 73 74 72 69 6e 67 2e  e UTF-16 string.
7f80: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20  .    */.    int 
7f90: 63 68 61 72 73 5f 70 61 72 73 65 64 20 3d 20 73  chars_parsed = s
7fa0: 71 6c 69 74 65 33 75 74 66 38 43 68 61 72 4c 65  qlite3utf8CharLe
7fb0: 6e 28 7a 53 71 6c 38 2c 20 7a 54 61 69 6c 38 2d  n(zSql8, zTail8-
7fc0: 7a 53 71 6c 38 29 3b 0a 20 20 20 20 2a 70 7a 54  zSql8);.    *pzT
7fd0: 61 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53 71 6c  ail = (u8 *)zSql
7fe0: 20 2b 20 73 71 6c 69 74 65 33 75 74 66 31 36 42   + sqlite3utf16B
7ff0: 79 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63 68 61  yteLen(zSql, cha
8000: 72 73 5f 70 61 72 73 65 64 29 3b 0a 20 20 7d 0a  rs_parsed);.  }.
8010: 20 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d   .  return rc;.}
8020: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
8030: 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 77 6f  tine does the wo
8040: 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20 61 20  rk of opening a 
8050: 64 61 74 61 62 61 73 65 20 6f 6e 20 62 65 68 61  database on beha
8060: 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 65 33  lf of.** sqlite3
8070: 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 71 6c 69  _open() and sqli
8080: 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20 54 68  te3_open16(). Th
8090: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 6e  e database filen
80a0: 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65 22 20  ame "zFilename" 
80b0: 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20 65 6e   .** is UTF-8 en
80c0: 63 6f 64 65 64 2e 20 54 68 65 20 66 6f 75 72 74  coded. The fourt
80d0: 68 20 61 72 67 75 6d 65 6e 74 2c 20 22 64 65 66  h argument, "def
80e0: 5f 65 6e 63 22 20 69 73 20 6f 6e 65 20 6f 66 20  _enc" is one of 
80f0: 74 68 65 20 54 45 58 54 5f 2a 0a 2a 2a 20 6d 61  the TEXT_*.** ma
8100: 63 72 6f 73 20 66 72 6f 6d 20 73 71 6c 69 74 65  cros from sqlite
8110: 49 6e 74 2e 68 2e 20 49 66 20 77 65 20 65 6e 64  Int.h. If we end
8120: 20 75 70 20 63 72 65 61 74 69 6e 67 20 61 20 6e   up creating a n
8130: 65 77 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ew database file
8140: 0a 2a 2a 20 28 6e 6f 74 20 6f 70 65 6e 69 6e 67  .** (not opening
8150: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6f 6e 65   an existing one
8160: 29 2c 20 74 68 65 20 74 65 78 74 20 65 6e 63 6f  ), the text enco
8170: 64 69 6e 67 20 6f 66 20 74 68 65 20 64 61 74 61  ding of the data
8180: 62 61 73 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 20  base.** will be 
8190: 73 65 74 20 74 6f 20 74 68 69 73 20 76 61 6c 75  set to this valu
81a0: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
81b0: 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 0a 20   openDatabase(. 
81c0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69   const char *zFi
81d0: 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74 61 62  lename, /* Datab
81e0: 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55 54 46  ase filename UTF
81f0: 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20  -8 encoded */.  
8200: 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 20  sqlite3 **ppDb  
8210: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52         /* OUT: R
8220: 65 74 75 72 6e 65 64 20 64 61 74 61 62 61 73 65  eturned database
8230: 20 68 61 6e 64 6c 65 20 2a 2f 0a 29 7b 0a 20 20   handle */.){.  
8240: 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 69  sqlite3 *db;.  i
8250: 6e 74 20 72 63 2c 20 69 3b 0a 20 20 63 68 61 72  nt rc, i;.  char
8260: 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 0a   *zErrMsg = 0;..
8270: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68    /* Allocate th
8280: 65 20 73 71 6c 69 74 65 20 64 61 74 61 20 73 74  e sqlite data st
8290: 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 64 62 20  ructure */.  db 
82a0: 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20  = sqliteMalloc( 
82b0: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 29 20 29  sizeof(sqlite) )
82c0: 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 20  ;.  if( db==0 ) 
82d0: 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b  goto opendb_out;
82e0: 0a 20 20 64 62 2d 3e 70 72 69 6f 72 4e 65 77 52  .  db->priorNewR
82f0: 6f 77 69 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e  owid = 0;.  db->
8300: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d  magic = SQLITE_M
8310: 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64 62 2d  AGIC_BUSY;.  db-
8320: 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d 3e  >nDb = 2;.  db->
8330: 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 74 61  aDb = db->aDbSta
8340: 74 69 63 3b 0a 20 20 64 62 2d 3e 65 6e 63 20 3d  tic;.  db->enc =
8350: 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20   SQLITE_UTF8;.  
8360: 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d  db->autoCommit =
8370: 20 31 3b 0a 20 20 2f 2a 20 64 62 2d 3e 66 6c 61   1;.  /* db->fla
8380: 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 53 68 6f  gs |= SQLITE_Sho
8390: 72 74 43 6f 6c 4e 61 6d 65 73 3b 20 2a 2f 0a 20  rtColNames; */. 
83a0: 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74   sqlite3HashInit
83b0: 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 53 51 4c  (&db->aFunc, SQL
83c0: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
83d0: 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 48 61   0);.  sqlite3Ha
83e0: 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 43 6f 6c  shInit(&db->aCol
83f0: 6c 53 65 71 2c 20 53 51 4c 49 54 45 5f 48 41 53  lSeq, SQLITE_HAS
8400: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20  H_STRING, 0);.  
8410: 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e  for(i=0; i<db->n
8420: 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71  Db; i++){.    sq
8430: 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 64  lite3HashInit(&d
8440: 62 2d 3e 61 44 62 5b 69 5d 2e 74 62 6c 48 61 73  b->aDb[i].tblHas
8450: 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53  h, SQLITE_HASH_S
8460: 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 20 20 73  TRING, 0);.    s
8470: 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26  qlite3HashInit(&
8480: 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 64 78 48 61  db->aDb[i].idxHa
8490: 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f  sh, SQLITE_HASH_
84a0: 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 20 20  STRING, 0);.    
84b0: 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28  sqlite3HashInit(
84c0: 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 74 72 69 67  &db->aDb[i].trig
84d0: 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53  Hash, SQLITE_HAS
84e0: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20  H_STRING, 0);.  
84f0: 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69    sqlite3HashIni
8500: 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 61 46  t(&db->aDb[i].aF
8510: 4b 65 79 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  Key, SQLITE_HASH
8520: 5f 53 54 52 49 4e 47 2c 20 31 29 3b 0a 20 20 7d  _STRING, 1);.  }
8530: 0a 20 20 0a 20 20 2f 2a 20 41 64 64 20 74 68 65  .  .  /* Add the
8540: 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69   default collati
8550: 6f 6e 20 73 65 71 75 65 6e 63 65 20 42 49 4e 41  on sequence BINA
8560: 52 59 2e 20 42 49 4e 41 52 59 20 77 6f 72 6b 73  RY. BINARY works
8570: 20 66 6f 72 20 62 6f 74 68 20 55 54 46 2d 38 0a   for both UTF-8.
8580: 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d 31 36 2c    ** and UTF-16,
8590: 20 73 6f 20 61 64 64 20 61 20 76 65 72 73 69 6f   so add a versio
85a0: 6e 20 66 6f 72 20 65 61 63 68 20 74 6f 20 61 76  n for each to av
85b0: 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63 65 73 73  oid any unnecess
85c0: 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 65 72 73  ary.  ** convers
85d0: 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c 79 20 65  ions. The only e
85e0: 72 72 6f 72 20 74 68 61 74 20 63 61 6e 20 6f 63  rror that can oc
85f0: 63 75 72 20 68 65 72 65 20 69 73 20 61 20 6d 61  cur here is a ma
8600: 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2e 0a  lloc() failure..
8610: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 63    */.  sqlite3_c
8620: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
8630: 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51  db, "BINARY", SQ
8640: 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 62 69 6e  LITE_UTF8, 0,bin
8650: 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63  aryCollatingFunc
8660: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 72 65  );.  sqlite3_cre
8670: 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62  ate_collation(db
8680: 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49  , "BINARY", SQLI
8690: 54 45 5f 55 54 46 31 36 4c 45 2c 20 30 2c 62 69  TE_UTF16LE, 0,bi
86a0: 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75 6e  naryCollatingFun
86b0: 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 72  c);.  sqlite3_cr
86c0: 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64  eate_collation(d
86d0: 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c  b, "BINARY", SQL
86e0: 49 54 45 5f 55 54 46 31 36 42 45 2c 20 30 2c 62  ITE_UTF16BE, 0,b
86f0: 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75  inaryCollatingFu
8700: 6e 63 29 3b 0a 20 20 64 62 2d 3e 70 44 66 6c 74  nc);.  db->pDflt
8710: 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69  Coll = sqlite3Fi
8720: 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 64 62  ndCollSeq(db, db
8730: 2d 3e 65 6e 63 2c 20 22 42 49 4e 41 52 59 22 2c  ->enc, "BINARY",
8740: 20 36 2c 20 30 29 3b 0a 20 20 69 66 28 20 21 64   6, 0);.  if( !d
8750: 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 29 7b 0a  b->pDfltColl ){.
8760: 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 65 72 72      rc = db->err
8770: 43 6f 64 65 3b 0a 20 20 20 20 61 73 73 65 72 74  Code;.    assert
8780: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
8790: 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63  );.    db->magic
87a0: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f   = SQLITE_MAGIC_
87b0: 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f 74 6f  CLOSED;.    goto
87c0: 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d   opendb_out;.  }
87d0: 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64 20  ..  /* Also add 
87e0: 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69 6e 73  a UTF-8 case-ins
87f0: 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 74 69  ensitive collati
8800: 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f 0a  on sequence. */.
8810: 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65    sqlite3_create
8820: 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22  _collation(db, "
8830: 4e 4f 43 41 53 45 22 2c 20 53 51 4c 49 54 45 5f  NOCASE", SQLITE_
8840: 55 54 46 38 2c 20 30 2c 20 6e 6f 63 61 73 65 43  UTF8, 0, nocaseC
8850: 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 29 3b 0a 0a  ollatingFunc);..
8860: 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 61    /* Open the ba
8870: 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20 64  ckend database d
8880: 72 69 76 65 72 20 2a 2f 0a 20 20 69 66 28 20 7a  river */.  if( z
8890: 46 69 6c 65 6e 61 6d 65 5b 30 5d 3d 3d 27 3a 27  Filename[0]==':'
88a0: 20 26 26 20 73 74 72 63 6d 70 28 7a 46 69 6c 65   && strcmp(zFile
88b0: 6e 61 6d 65 2c 22 3a 6d 65 6d 6f 72 79 3a 22 29  name,":memory:")
88c0: 3d 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 74  ==0 ){.    db->t
88d0: 65 6d 70 5f 73 74 6f 72 65 20 3d 20 32 3b 0a 20  emp_store = 2;. 
88e0: 20 20 20 64 62 2d 3e 6e 4d 61 73 74 65 72 20 3d     db->nMaster =
88f0: 20 30 3b 20 20 20 20 2f 2a 20 44 69 73 61 62 6c   0;    /* Disabl
8900: 65 20 61 74 6f 6d 69 63 20 6d 75 6c 74 69 2d 66  e atomic multi-f
8910: 69 6c 65 20 63 6f 6d 6d 69 74 20 66 6f 72 20 3a  ile commit for :
8920: 6d 65 6d 6f 72 79 3a 20 2a 2f 0a 20 20 7d 65 6c  memory: */.  }el
8930: 73 65 7b 0a 20 20 20 20 64 62 2d 3e 6e 4d 61 73  se{.    db->nMas
8940: 74 65 72 20 3d 20 2d 31 3b 20 20 20 2f 2a 20 53  ter = -1;   /* S
8950: 69 7a 65 20 6f 66 20 6d 61 73 74 65 72 20 6a 6f  ize of master jo
8960: 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 20 69  urnal filename i
8970: 6e 69 74 69 61 6c 6c 79 20 75 6e 6b 6e 6f 77 6e  nitially unknown
8980: 20 2a 2f 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73   */.  }.  rc = s
8990: 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74 6f  qlite3BtreeFacto
89a0: 72 79 28 64 62 2c 20 7a 46 69 6c 65 6e 61 6d 65  ry(db, zFilename
89b0: 2c 20 30 2c 20 4d 41 58 5f 50 41 47 45 53 2c 20  , 0, MAX_PAGES, 
89c0: 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29  &db->aDb[0].pBt)
89d0: 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49  ;.  if( rc!=SQLI
89e0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
89f0: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63  ite3Error(db, rc
8a00: 2c 20 30 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61  , 0);.    db->ma
8a10: 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47  gic = SQLITE_MAG
8a20: 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67  IC_CLOSED;.    g
8a30: 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a  oto opendb_out;.
8a40: 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d    }.  db->aDb[0]
8a50: 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b  .zName = "main";
8a60: 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a 4e  .  db->aDb[1].zN
8a70: 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a 0a 20  ame = "temp";.. 
8a80: 20 2f 2a 20 52 65 67 69 73 74 65 72 20 61 6c 6c   /* Register all
8a90: 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69   built-in functi
8aa0: 6f 6e 73 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20  ons, but do not 
8ab0: 61 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20  attempt to read 
8ac0: 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73  the.  ** databas
8ad0: 65 20 73 63 68 65 6d 61 20 79 65 74 2e 20 54 68  e schema yet. Th
8ae0: 69 73 20 69 73 20 64 65 6c 61 79 65 64 20 75 6e  is is delayed un
8af0: 74 69 6c 20 74 68 65 20 66 69 72 73 74 20 74 69  til the first ti
8b00: 6d 65 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  me the database.
8b10: 20 20 2a 2a 20 69 73 20 61 63 63 65 73 73 65 64    ** is accessed
8b20: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ..  */.  sqlite3
8b30: 52 65 67 69 73 74 65 72 42 75 69 6c 74 69 6e 46  RegisterBuiltinF
8b40: 75 6e 63 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20  unctions(db);.  
8b50: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
8b60: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  K ){.    sqlite3
8b70: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45  Error(db, SQLITE
8b80: 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20 20 64 62 2d  _OK, 0);.    db-
8b90: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f  >magic = SQLITE_
8ba0: 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 7d 65  MAGIC_OPEN;.  }e
8bb0: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  lse{.    sqlite3
8bc0: 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 22 25  Error(db, rc, "%
8bd0: 73 22 2c 20 7a 45 72 72 4d 73 67 2c 20 30 29 3b  s", zErrMsg, 0);
8be0: 0a 20 20 20 20 69 66 28 20 7a 45 72 72 4d 73 67  .    if( zErrMsg
8bf0: 20 29 20 73 71 6c 69 74 65 46 72 65 65 28 7a 45   ) sqliteFree(zE
8c00: 72 72 4d 73 67 29 3b 0a 20 20 20 20 64 62 2d 3e  rrMsg);.    db->
8c10: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d  magic = SQLITE_M
8c20: 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 7d  AGIC_CLOSED;.  }
8c30: 0a 0a 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a 20 20  ..opendb_out:.  
8c40: 2a 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 72 65  *ppDb = db;.  re
8c50: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 65 72 72  turn sqlite3_err
8c60: 63 6f 64 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a  code(db);.}../*.
8c70: 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61  ** Open a new da
8c80: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a  tabase handle..*
8c90: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70  /.int sqlite3_op
8ca0: 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72  en(.  const char
8cb0: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20   *zFilename, .  
8cc0: 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 0a  sqlite3 **ppDb .
8cd0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e  ){.  return open
8ce0: 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e 61  Database(zFilena
8cf0: 6d 65 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a 2f 2a  me, ppDb);.}../*
8d00: 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64  .** Open a new d
8d10: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a  atabase handle..
8d20: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f  */.int sqlite3_o
8d30: 70 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74 20 76  pen16(.  const v
8d40: 6f 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20  oid *zFilename, 
8d50: 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44  .  sqlite3 **ppD
8d60: 62 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73  b.){.  char cons
8d70: 74 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b 20 20  t *zFilename8;  
8d80: 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 65 6e   /* zFilename en
8d90: 63 6f 64 65 64 20 69 6e 20 55 54 46 2d 38 20 69  coded in UTF-8 i
8da0: 6e 73 74 65 61 64 20 6f 66 20 55 54 46 2d 31 36  nstead of UTF-16
8db0: 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53   */.  int rc = S
8dc0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 73  QLITE_NOMEM;.  s
8dd0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
8de0: 61 6c 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70  al;..  assert( p
8df0: 70 44 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 3d  pDb );.  *ppDb =
8e00: 20 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c   0;.  pVal = sql
8e10: 69 74 65 33 56 61 6c 75 65 4e 65 77 28 29 3b 0a  ite3ValueNew();.
8e20: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65    sqlite3ValueSe
8e30: 74 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a  tStr(pVal, -1, z
8e40: 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45  Filename, SQLITE
8e50: 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51  _UTF16NATIVE, SQ
8e60: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20  LITE_STATIC);.  
8e70: 7a 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c  zFilename8 = sql
8e80: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56  ite3ValueText(pV
8e90: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29  al, SQLITE_UTF8)
8ea0: 3b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d  ;.  if( zFilenam
8eb0: 65 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f  e8 ){.    rc = o
8ec0: 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c  penDatabase(zFil
8ed0: 65 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b 0a 20  ename8, ppDb);. 
8ee0: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
8ef0: 45 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20 29 7b  E_OK && *ppDb ){
8f00: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 65  .      sqlite3_e
8f10: 78 65 63 28 2a 70 70 44 62 2c 20 22 50 52 41 47  xec(*ppDb, "PRAG
8f20: 4d 41 20 65 6e 63 6f 64 69 6e 67 20 3d 20 27 55  MA encoding = 'U
8f30: 54 46 2d 31 36 27 22 2c 20 30 2c 20 30 2c 20 30  TF-16'", 0, 0, 0
8f40: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69  );.    }.  }.  i
8f50: 66 28 20 70 56 61 6c 20 29 7b 0a 20 20 20 20 73  f( pVal ){.    s
8f60: 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28  qlite3ValueFree(
8f70: 70 56 61 6c 29 3b 0a 20 20 7d 0a 0a 20 20 72 65  pVal);.  }..  re
8f80: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
8f90: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
8fa0: 72 6f 75 74 69 6e 65 20 64 65 73 74 72 6f 79 73  routine destroys
8fb0: 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69   a virtual machi
8fc0: 6e 65 20 74 68 61 74 20 69 73 20 63 72 65 61 74  ne that is creat
8fd0: 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 73 71 6c  ed by.** the sql
8fe0: 69 74 65 33 5f 63 6f 6d 70 69 6c 65 28 29 20 72  ite3_compile() r
8ff0: 6f 75 74 69 6e 65 2e 20 54 68 65 20 69 6e 74 65  outine. The inte
9000: 67 65 72 20 72 65 74 75 72 6e 65 64 20 69 73 20  ger returned is 
9010: 61 6e 20 53 51 4c 49 54 45 5f 0a 2a 2a 20 73 75  an SQLITE_.** su
9020: 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20 63 6f  ccess/failure co
9030: 64 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65  de that describe
9040: 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20  s the result of 
9050: 65 78 65 63 75 74 69 6e 67 20 74 68 65 20 76 69  executing the vi
9060: 72 74 75 61 6c 0a 2a 2a 20 6d 61 63 68 69 6e 65  rtual.** machine
9070: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ..**.** This rou
9080: 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 65 72  tine sets the er
9090: 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 74 72  ror code and str
90a0: 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62 79 0a  ing returned by.
90b0: 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f  ** sqlite3_errco
90c0: 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f 65 72  de(), sqlite3_er
90d0: 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69 74  rmsg() and sqlit
90e0: 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e 0a 2a  e3_errmsg16()..*
90f0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 66 69  /.int sqlite3_fi
9100: 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 33 5f 73  nalize(sqlite3_s
9110: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 72  tmt *pStmt){.  r
9120: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62  eturn sqlite3Vdb
9130: 65 46 69 6e 61 6c 69 7a 65 28 28 56 64 62 65 2a  eFinalize((Vdbe*
9140: 29 70 53 74 6d 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  )pStmt);.}../*.*
9150: 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68 65 20  * Terminate the 
9160: 63 75 72 72 65 6e 74 20 65 78 65 63 75 74 69 6f  current executio
9170: 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 74 61 74  n of an SQL stat
9180: 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 65 74 20  ement and reset 
9190: 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 69 74  it.** back to it
91a0: 73 20 73 74 61 72 74 69 6e 67 20 73 74 61 74 65  s starting state
91b0: 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20   so that it can 
91c0: 62 65 20 72 65 75 73 65 64 2e 20 41 20 73 75 63  be reused. A suc
91d0: 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d 0a 2a  cess code from.*
91e0: 2a 20 74 68 65 20 70 72 69 6f 72 20 65 78 65 63  * the prior exec
91f0: 75 74 69 6f 6e 20 69 73 20 72 65 74 75 72 6e 65  ution is returne
9200: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  d..**.** This ro
9210: 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 65  utine sets the e
9220: 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 74  rror code and st
9230: 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62 79  ring returned by
9240: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 63  .** sqlite3_errc
9250: 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f 65  ode(), sqlite3_e
9260: 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69  rrmsg() and sqli
9270: 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e 0a  te3_errmsg16()..
9280: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 72  */.int sqlite3_r
9290: 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  eset(sqlite3_stm
92a0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74  t *pStmt){.  int
92b0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
92c0: 65 52 65 73 65 74 28 28 56 64 62 65 2a 29 70 53  eReset((Vdbe*)pS
92d0: 74 6d 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  tmt);.  sqlite3V
92e0: 64 62 65 4d 61 6b 65 52 65 61 64 79 28 28 56 64  dbeMakeReady((Vd
92f0: 62 65 2a 29 70 53 74 6d 74 2c 20 2d 31 2c 20 30  be*)pStmt, -1, 0
9300: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
9310: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65  }../*.** Registe
9320: 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f  r a new collatio
9330: 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20  n sequence with 
9340: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e  the database han
9350: 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73  dle db..*/.int s
9360: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f  qlite3_create_co
9370: 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74  llation(.  sqlit
9380: 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74  e3* db, .  const
9390: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20   char *zName, . 
93a0: 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69   int enc, .  voi
93b0: 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a  d* pCtx,.  int(*
93c0: 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c  xCompare)(void*,
93d0: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c  int,const void*,
93e0: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29  int,const void*)
93f0: 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70  .){.  CollSeq *p
9400: 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 72 63 20 3d  Coll;.  int rc =
9410: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 0a 20   SQLITE_OK;.  . 
9420: 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54   /* If SQLITE_UT
9430: 46 31 36 20 69 73 20 73 70 65 63 69 66 69 65 64  F16 is specified
9440: 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67   as the encoding
9450: 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d   type, transform
9460: 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e   this.  ** to on
9470: 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31  e of SQLITE_UTF1
9480: 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54  6LE or SQLITE_UT
9490: 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a  F16BE using the.
94a0: 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31    ** SQLITE_UTF1
94b0: 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53  6NATIVE macro. S
94c0: 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e  QLITE_UTF16 is n
94d0: 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c  ot used internal
94e0: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65  ly..  */.  if( e
94f0: 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36  nc==SQLITE_UTF16
9500: 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51   ){.    enc = SQ
9510: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45  LITE_UTF16NATIVE
9520: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 65 6e 63  ;.  }..  if( enc
9530: 21 3d 53 51 4c 49 54 45 5f 55 54 46 38 20 26 26  !=SQLITE_UTF8 &&
9540: 20 65 6e 63 21 3d 53 51 4c 49 54 45 5f 55 54 46   enc!=SQLITE_UTF
9550: 31 36 4c 45 20 26 26 20 65 6e 63 21 3d 53 51 4c  16LE && enc!=SQL
9560: 49 54 45 5f 55 54 46 31 36 42 45 20 29 7b 0a 20  ITE_UTF16BE ){. 
9570: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
9580: 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  db, SQLITE_ERROR
9590: 2c 20 0a 20 20 20 20 20 20 20 20 22 50 61 72 61  , .        "Para
95a0: 6d 20 33 20 74 6f 20 73 71 6c 69 74 65 33 5f 63  m 3 to sqlite3_c
95b0: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
95c0: 29 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 6f 66  ) must be one of
95d0: 20 22 0a 20 20 20 20 20 20 20 20 22 53 51 4c 49   ".        "SQLI
95e0: 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f  TE_UTF8, SQLITE_
95f0: 55 54 46 31 36 2c 20 53 51 4c 49 54 45 5f 55 54  UTF16, SQLITE_UT
9600: 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f  F16LE or SQLITE_
9610: 55 54 46 31 36 42 45 22 0a 20 20 20 20 29 3b 0a  UTF16BE".    );.
9620: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
9630: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 70  E_ERROR;.  }.  p
9640: 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69  Coll = sqlite3Fi
9650: 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75  ndCollSeq(db, (u
9660: 38 29 65 6e 63 2c 20 7a 4e 61 6d 65 2c 20 73 74  8)enc, zName, st
9670: 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 31 29 3b  rlen(zName), 1);
9680: 0a 20 20 69 66 28 20 30 3d 3d 70 43 6f 6c 6c 20  .  if( 0==pColl 
9690: 29 7b 0a 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ){.   rc = SQLIT
96a0: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73 65  E_NOMEM;.  }else
96b0: 7b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 78 43 6d  {.    pColl->xCm
96c0: 70 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a 20 20  p = xCompare;.  
96d0: 20 20 70 43 6f 6c 6c 2d 3e 70 55 73 65 72 20 3d    pColl->pUser =
96e0: 20 70 43 74 78 3b 0a 20 20 7d 0a 20 20 73 71 6c   pCtx;.  }.  sql
96f0: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63  ite3Error(db, rc
9700: 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  , 0);.  return r
9710: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69  c;.}../*.** Regi
9720: 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61  ster a new colla
9730: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69  tion sequence wi
9740: 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20  th the database 
9750: 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e  handle db..*/.in
9760: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65  t sqlite3_create
9770: 5f 63 6f 6c 6c 61 74 69 6f 6e 31 36 28 0a 20 20  _collation16(.  
9780: 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 20  sqlite3* db, .  
9790: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d  const char *zNam
97a0: 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a  e, .  int enc, .
97b0: 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20    void* pCtx,.  
97c0: 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 76  int(*xCompare)(v
97d0: 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76  oid*,int,const v
97e0: 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76  oid*,int,const v
97f0: 6f 69 64 2a 29 0a 29 7b 0a 20 20 63 68 61 72 20  oid*).){.  char 
9800: 63 6f 6e 73 74 20 2a 7a 4e 61 6d 65 38 3b 0a 20  const *zName8;. 
9810: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
9820: 70 54 6d 70 20 3d 20 73 71 6c 69 74 65 33 47 65  pTmp = sqlite3Ge
9830: 74 54 72 61 6e 73 69 65 6e 74 56 61 6c 75 65 28  tTransientValue(
9840: 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 61  db);.  sqlite3Va
9850: 6c 75 65 53 65 74 53 74 72 28 70 54 6d 70 2c 20  lueSetStr(pTmp, 
9860: 2d 31 2c 20 7a 4e 61 6d 65 2c 20 53 51 4c 49 54  -1, zName, SQLIT
9870: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53  E_UTF16NATIVE, S
9880: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
9890: 20 7a 4e 61 6d 65 38 20 3d 20 73 71 6c 69 74 65   zName8 = sqlite
98a0: 33 56 61 6c 75 65 54 65 78 74 28 70 54 6d 70 2c  3ValueText(pTmp,
98b0: 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 20   SQLITE_UTF8);. 
98c0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f   return sqlite3_
98d0: 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e  create_collation
98e0: 28 64 62 2c 20 7a 4e 61 6d 65 38 2c 20 65 6e 63  (db, zName8, enc
98f0: 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 65  , pCtx, xCompare
9900: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69  );.}../*.** Regi
9910: 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f 6e  ster a collation
9920: 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72   sequence factor
9930: 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 20  y callback with 
9940: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e  the database han
9950: 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c 61  dle.** db. Repla
9960: 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c  ce any previousl
9970: 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c 6c  y installed coll
9980: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66  ation sequence f
9990: 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73  actory..*/.int s
99a0: 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e  qlite3_collation
99b0: 5f 6e 65 65 64 65 64 28 0a 20 20 73 71 6c 69 74  _needed(.  sqlit
99c0: 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20  e3 *db, .  void 
99d0: 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c  *pCollNeededArg,
99e0: 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e   .  void(*xCollN
99f0: 65 65 64 65 64 29 28 76 6f 69 64 2a 2c 73 71 6c  eeded)(void*,sql
9a00: 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52  ite3*,int eTextR
9a10: 65 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 0a  ep,const char*).
9a20: 29 7b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65  ){.  db->xCollNe
9a30: 65 64 65 64 20 3d 20 78 43 6f 6c 6c 4e 65 65 64  eded = xCollNeed
9a40: 65 64 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e  ed;.  db->xCollN
9a50: 65 65 64 65 64 31 36 20 3d 20 30 3b 0a 20 20 64  eeded16 = 0;.  d
9a60: 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72  b->pCollNeededAr
9a70: 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41  g = pCollNeededA
9a80: 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  rg;.  return SQL
9a90: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
9aa0: 20 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c   Register a coll
9ab0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66  ation sequence f
9ac0: 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20  actory callback 
9ad0: 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73  with the databas
9ae0: 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20  e handle.** db. 
9af0: 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76  Replace any prev
9b00: 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64  iously installed
9b10: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65   collation seque
9b20: 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a  nce factory..*/.
9b30: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c  int sqlite3_coll
9b40: 61 74 69 6f 6e 5f 6e 65 65 64 65 64 31 36 28 0a  ation_needed16(.
9b50: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a    sqlite3 *db, .
9b60: 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65    void *pCollNee
9b70: 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28  dedArg, .  void(
9b80: 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 29 28  *xCollNeeded16)(
9b90: 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69  void*,sqlite3*,i
9ba0: 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73  nt eTextRep,cons
9bb0: 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 64 62  t void*).){.  db
9bc0: 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20  ->xCollNeeded = 
9bd0: 30 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65  0;.  db->xCollNe
9be0: 65 64 65 64 31 36 20 3d 20 78 43 6f 6c 6c 4e 65  eded16 = xCollNe
9bf0: 65 64 65 64 31 36 3b 0a 20 20 64 62 2d 3e 70 43  eded16;.  db->pC
9c00: 6f 6c 6c 4e 65 65 64 65 64 41 72 67 20 3d 20 70  ollNeededArg = p
9c10: 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a 20  CollNeededArg;. 
9c20: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
9c30: 4b 3b 0a 7d 0a                                   K;.}.