/ Hex Artifact Content
Login

Artifact 447db2fb6121360814afd725ee93c22d6eef8e7f:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 4d 61 69 6e 20 66  ******.** Main f
0180: 69 6c 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69  ile for the SQLi
0190: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 54 68 65  te library.  The
01a0: 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 69   routines in thi
01b0: 73 20 66 69 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d  s file.** implem
01c0: 65 6e 74 20 74 68 65 20 70 72 6f 67 72 61 6d 6d  ent the programm
01d0: 65 72 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20  er interface to 
01e0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 52 6f  the library.  Ro
01f0: 75 74 69 6e 65 73 20 69 6e 0a 2a 2a 20 6f 74 68  utines in.** oth
0200: 65 72 20 66 69 6c 65 73 20 61 72 65 20 66 6f 72  er files are for
0210: 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 20 62 79   internal use by
0220: 20 53 51 4c 69 74 65 20 61 6e 64 20 73 68 6f 75   SQLite and shou
0230: 6c 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 63 63  ld not be.** acc
0240: 65 73 73 65 64 20 62 79 20 75 73 65 72 73 20 6f  essed by users o
0250: 66 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 2a  f the library..*
0260: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 69 6e 2e 63  *.** $Id: main.c
0270: 2c 76 20 31 2e 32 34 36 20 32 30 30 34 2f 30 37  ,v 1.246 2004/07
0280: 2f 32 32 20 30 31 3a 31 39 3a 33 35 20 64 72 68  /22 01:19:35 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 69  ar *zExtra){.  i
0510: 66 28 20 21 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  f( !sqlite3_mall
0520: 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20  oc_failed ){.   
0530: 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e   sqlite3SetStrin
0540: 67 28 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73  g(pData->pzErrMs
0550: 67 2c 20 22 6d 61 6c 66 6f 72 6d 65 64 20 64 61  g, "malformed da
0560: 74 61 62 61 73 65 20 73 63 68 65 6d 61 22 2c 0a  tabase schema",.
0570: 20 20 20 20 20 20 20 7a 45 78 74 72 61 21 3d 30         zExtra!=0
0580: 20 26 26 20 7a 45 78 74 72 61 5b 30 5d 21 3d 30   && zExtra[0]!=0
0590: 20 3f 20 22 20 2d 20 22 20 3a 20 28 63 68 61 72   ? " - " : (char
05a0: 2a 29 30 2c 20 7a 45 78 74 72 61 2c 20 28 63 68  *)0, zExtra, (ch
05b0: 61 72 2a 29 30 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  ar*)0);.  }.}../
05c0: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65  *.** This is the
05d0: 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e   callback routin
05e0: 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65 20 74  e for the code t
05f0: 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 20  hat initializes 
0600: 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e  the.** database.
0610: 20 20 53 65 65 20 73 71 6c 69 74 65 33 49 6e 69    See sqlite3Ini
0620: 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20 61 64  t() below for ad
0630: 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61  ditional informa
0640: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68  tion..**.** Each
0650: 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69   callback contai
0660: 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ns the following
0670: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a   information:.**
0680: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 30 5d 20  .**     argv[0] 
0690: 3d 20 22 74 61 62 6c 65 22 20 6f 72 20 22 69 6e  = "table" or "in
06a0: 64 65 78 22 20 6f 72 20 22 76 69 65 77 22 20 6f  dex" or "view" o
06b0: 72 20 22 74 72 69 67 67 65 72 22 0a 2a 2a 20 20  r "trigger".**  
06c0: 20 20 20 61 72 67 76 5b 31 5d 20 3d 20 6e 61 6d     argv[1] = nam
06d0: 65 20 6f 66 20 74 68 69 6e 67 20 62 65 69 6e 67  e of thing being
06e0: 20 63 72 65 61 74 65 64 0a 2a 2a 20 20 20 20 20   created.**     
06f0: 61 72 67 76 5b 32 5d 20 3d 20 72 6f 6f 74 20 70  argv[2] = root p
0700: 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74  age number for t
0710: 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20  able or index.  
0720: 4e 55 4c 4c 20 66 6f 72 20 74 72 69 67 67 65 72  NULL for trigger
0730: 20 6f 72 20 76 69 65 77 2e 0a 2a 2a 20 20 20 20   or view..**    
0740: 20 61 72 67 76 5b 33 5d 20 3d 20 53 51 4c 20 74   argv[3] = SQL t
0750: 65 78 74 20 66 6f 72 20 74 68 65 20 43 52 45 41  ext for the CREA
0760: 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a  TE statement..**
0770: 20 20 20 20 20 61 72 67 76 5b 34 5d 20 3d 20 22       argv[4] = "
0780: 31 22 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79  1" for temporary
0790: 20 66 69 6c 65 73 2c 20 22 30 22 20 66 6f 72 20   files, "0" for 
07a0: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2c 20 22  main database, "
07b0: 32 22 20 6f 72 20 6d 6f 72 65 0a 2a 2a 20 20 20  2" or more.**   
07c0: 20 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 20              for 
07d0: 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 62 61  auxiliary databa
07e0: 73 65 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2f 0a  se files..**.*/.
07f0: 73 74 61 74 69 63 0a 69 6e 74 20 73 71 6c 69 74  static.int sqlit
0800: 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76  e3InitCallback(v
0810: 6f 69 64 20 2a 70 49 6e 69 74 2c 20 69 6e 74 20  oid *pInit, int 
0820: 61 72 67 63 2c 20 63 68 61 72 20 2a 2a 61 72 67  argc, char **arg
0830: 76 2c 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 4e  v, char **azColN
0840: 61 6d 65 29 7b 0a 20 20 49 6e 69 74 44 61 74 61  ame){.  InitData
0850: 20 2a 70 44 61 74 61 20 3d 20 28 49 6e 69 74 44   *pData = (InitD
0860: 61 74 61 2a 29 70 49 6e 69 74 3b 0a 20 20 69 6e  ata*)pInit;.  in
0870: 74 20 6e 45 72 72 20 3d 20 30 3b 0a 0a 20 20 61  t nErr = 0;..  a
0880: 73 73 65 72 74 28 20 61 72 67 63 3d 3d 35 20 29  ssert( argc==5 )
0890: 3b 0a 20 20 69 66 28 20 61 72 67 76 3d 3d 30 20  ;.  if( argv==0 
08a0: 29 20 72 65 74 75 72 6e 20 30 3b 20 20 20 2f 2a  ) return 0;   /*
08b0: 20 4d 69 67 68 74 20 68 61 70 70 65 6e 20 69 66   Might happen if
08c0: 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43 41   EMPTY_RESULT_CA
08d0: 4c 4c 42 41 43 4b 53 20 61 72 65 20 6f 6e 20 2a  LLBACKS are on *
08e0: 2f 0a 20 20 69 66 28 20 61 72 67 76 5b 30 5d 3d  /.  if( argv[0]=
08f0: 3d 30 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70  =0 ){.    corrup
0900: 74 53 63 68 65 6d 61 28 70 44 61 74 61 2c 20 30  tSchema(pData, 0
0910: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b  );.    return 1;
0920: 0a 20 20 7d 0a 20 20 73 77 69 74 63 68 28 20 61  .  }.  switch( a
0930: 72 67 76 5b 30 5d 5b 30 5d 20 29 7b 0a 20 20 20  rgv[0][0] ){.   
0940: 20 63 61 73 65 20 27 76 27 3a 0a 20 20 20 20 63   case 'v':.    c
0950: 61 73 65 20 27 69 27 3a 0a 20 20 20 20 63 61 73  ase 'i':.    cas
0960: 65 20 27 74 27 3a 20 7b 20 20 2f 2a 20 43 52 45  e 't': {  /* CRE
0970: 41 54 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54  ATE TABLE, CREAT
0980: 45 20 49 4e 44 45 58 2c 20 6f 72 20 43 52 45 41  E INDEX, or CREA
0990: 54 45 20 56 49 45 57 20 73 74 61 74 65 6d 65 6e  TE VIEW statemen
09a0: 74 73 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69  ts */.      sqli
09b0: 74 65 20 2a 64 62 20 3d 20 70 44 61 74 61 2d 3e  te *db = pData->
09c0: 64 62 3b 0a 20 20 20 20 20 20 69 66 28 20 61 72  db;.      if( ar
09d0: 67 76 5b 32 5d 3d 3d 30 20 7c 7c 20 61 72 67 76  gv[2]==0 || argv
09e0: 5b 34 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  [4]==0 ){.      
09f0: 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28    corruptSchema(
0a00: 70 44 61 74 61 2c 20 30 29 3b 0a 20 20 20 20 20  pData, 0);.     
0a10: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20     return 1;.   
0a20: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 61     }.      if( a
0a30: 72 67 76 5b 33 5d 20 26 26 20 61 72 67 76 5b 33  rgv[3] && argv[3
0a40: 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 20 20  ][0] ){.        
0a50: 2f 2a 20 43 61 6c 6c 20 74 68 65 20 70 61 72 73  /* Call the pars
0a60: 65 72 20 74 6f 20 70 72 6f 63 65 73 73 20 61 20  er to process a 
0a70: 43 52 45 41 54 45 20 54 41 42 4c 45 2c 20 49 4e  CREATE TABLE, IN
0a80: 44 45 58 20 6f 72 20 56 49 45 57 2e 0a 20 20 20  DEX or VIEW..   
0a90: 20 20 20 20 20 2a 2a 20 42 75 74 20 62 65 63 61       ** But beca
0aa0: 75 73 65 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73  use db->init.bus
0ab0: 79 20 69 73 20 73 65 74 20 74 6f 20 31 2c 20 6e  y is set to 1, n
0ac0: 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73 20 67  o VDBE code is g
0ad0: 65 6e 65 72 61 74 65 64 0a 20 20 20 20 20 20 20  enerated.       
0ae0: 20 2a 2a 20 6f 72 20 65 78 65 63 75 74 65 64 2e   ** or executed.
0af0: 20 20 41 6c 6c 20 74 68 65 20 70 61 72 73 65 72    All the parser
0b00: 20 64 6f 65 73 20 69 73 20 62 75 69 6c 64 20 74   does is build t
0b10: 68 65 20 69 6e 74 65 72 6e 61 6c 20 64 61 74 61  he internal data
0b20: 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 72 75  .        ** stru
0b30: 63 74 75 72 65 73 20 74 68 61 74 20 64 65 73 63  ctures that desc
0b40: 72 69 62 65 20 74 68 65 20 74 61 62 6c 65 2c 20  ribe the table, 
0b50: 69 6e 64 65 78 2c 20 6f 72 20 76 69 65 77 2e 0a  index, or view..
0b60: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20          */.     
0b70: 20 20 20 63 68 61 72 20 2a 7a 45 72 72 3b 0a 20     char *zErr;. 
0b80: 20 20 20 20 20 20 20 69 6e 74 20 72 63 3b 0a 20         int rc;. 
0b90: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 64         assert( d
0ba0: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a  b->init.busy );.
0bb0: 20 20 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74          db->init
0bc0: 2e 69 44 62 20 3d 20 61 74 6f 69 28 61 72 67 76  .iDb = atoi(argv
0bd0: 5b 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 61 73  [4]);.        as
0be0: 73 65 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 69  sert( db->init.i
0bf0: 44 62 3e 3d 30 20 26 26 20 64 62 2d 3e 69 6e 69  Db>=0 && db->ini
0c00: 74 2e 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b  t.iDb<db->nDb );
0c10: 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 69 6e 69  .        db->ini
0c20: 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 61 74 6f 69  t.newTnum = atoi
0c30: 28 61 72 67 76 5b 32 5d 29 3b 0a 20 20 20 20 20  (argv[2]);.     
0c40: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f     rc = sqlite3_
0c50: 65 78 65 63 28 64 62 2c 20 61 72 67 76 5b 33 5d  exec(db, argv[3]
0c60: 2c 20 30 2c 20 30 2c 20 26 7a 45 72 72 29 3b 0a  , 0, 0, &zErr);.
0c70: 20 20 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74          db->init
0c80: 2e 69 44 62 20 3d 20 30 3b 0a 20 20 20 20 20 20  .iDb = 0;.      
0c90: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21    if( SQLITE_OK!
0ca0: 3d 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20  =rc ){.         
0cb0: 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70   corruptSchema(p
0cc0: 44 61 74 61 2c 20 7a 45 72 72 29 3b 0a 20 20 20  Data, zErr);.   
0cd0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66         sqlite3_f
0ce0: 72 65 65 28 7a 45 72 72 29 3b 0a 20 20 20 20 20  ree(zErr);.     
0cf0: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
0d00: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
0d10: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f  }else{.        /
0d20: 2a 20 49 66 20 74 68 65 20 53 51 4c 20 63 6f 6c  * If the SQL col
0d30: 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20 69 74 20  umn is blank it 
0d40: 6d 65 61 6e 73 20 74 68 69 73 20 69 73 20 61 6e  means this is an
0d50: 20 69 6e 64 65 78 20 74 68 61 74 0a 20 20 20 20   index that.    
0d60: 20 20 20 20 2a 2a 20 77 61 73 20 63 72 65 61 74      ** was creat
0d70: 65 64 20 74 6f 20 62 65 20 74 68 65 20 50 52 49  ed to be the PRI
0d80: 4d 41 52 59 20 4b 45 59 20 6f 72 20 74 6f 20 66  MARY KEY or to f
0d90: 75 6c 66 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a  ulfill a UNIQUE.
0da0: 20 20 20 20 20 20 20 20 2a 2a 20 63 6f 6e 73 74          ** const
0db0: 72 61 69 6e 74 20 66 6f 72 20 61 20 43 52 45 41  raint for a CREA
0dc0: 54 45 20 54 41 42 4c 45 2e 20 20 54 68 65 20 69  TE TABLE.  The i
0dd0: 6e 64 65 78 20 73 68 6f 75 6c 64 20 68 61 76 65  ndex should have
0de0: 20 61 6c 72 65 61 64 79 0a 20 20 20 20 20 20 20   already.       
0df0: 20 2a 2a 20 62 65 65 6e 20 63 72 65 61 74 65 64   ** been created
0e00: 20 77 68 65 6e 20 77 65 20 70 72 6f 63 65 73 73   when we process
0e10: 65 64 20 74 68 65 20 43 52 45 41 54 45 20 54 41  ed the CREATE TA
0e20: 42 4c 45 2e 20 20 41 6c 6c 20 77 65 20 68 61 76  BLE.  All we hav
0e30: 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20  e.        ** to 
0e40: 64 6f 20 68 65 72 65 20 69 73 20 72 65 63 6f 72  do here is recor
0e50: 64 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20  d the root page 
0e60: 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 61 74 20  number for that 
0e70: 69 6e 64 65 78 2e 0a 20 20 20 20 20 20 20 20 2a  index..        *
0e80: 2f 0a 20 20 20 20 20 20 20 20 69 6e 74 20 69 44  /.        int iD
0e90: 62 3b 0a 20 20 20 20 20 20 20 20 49 6e 64 65 78  b;.        Index
0ea0: 20 2a 70 49 6e 64 65 78 3b 0a 0a 20 20 20 20 20   *pIndex;..     
0eb0: 20 20 20 69 44 62 20 3d 20 61 74 6f 69 28 61 72     iDb = atoi(ar
0ec0: 67 76 5b 34 5d 29 3b 0a 20 20 20 20 20 20 20 20  gv[4]);.        
0ed0: 61 73 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26  assert( iDb>=0 &
0ee0: 26 20 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b  & iDb<db->nDb );
0ef0: 0a 20 20 20 20 20 20 20 20 70 49 6e 64 65 78 20  .        pIndex 
0f00: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 64  = sqlite3FindInd
0f10: 65 78 28 64 62 2c 20 61 72 67 76 5b 31 5d 2c 20  ex(db, argv[1], 
0f20: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61  db->aDb[iDb].zNa
0f30: 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28  me);.        if(
0f40: 20 70 49 6e 64 65 78 3d 3d 30 20 7c 7c 20 70 49   pIndex==0 || pI
0f50: 6e 64 65 78 2d 3e 74 6e 75 6d 21 3d 30 20 29 7b  ndex->tnum!=0 ){
0f60: 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68  .          /* Th
0f70: 69 73 20 63 61 6e 20 6f 63 63 75 72 20 69 66 20  is can occur if 
0f80: 74 68 65 72 65 20 65 78 69 73 74 73 20 61 6e 20  there exists an 
0f90: 69 6e 64 65 78 20 6f 6e 20 61 20 54 45 4d 50 20  index on a TEMP 
0fa0: 74 61 62 6c 65 20 77 68 69 63 68 0a 20 20 20 20  table which.    
0fb0: 20 20 20 20 20 20 2a 2a 20 68 61 73 20 74 68 65        ** has the
0fc0: 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 61 6e   same name as an
0fd0: 6f 74 68 65 72 20 69 6e 64 65 78 20 6f 6e 20 61  other index on a
0fe0: 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e 64 65 78   permanent index
0ff0: 2e 20 20 53 69 6e 63 65 0a 20 20 20 20 20 20 20  .  Since.       
1000: 20 20 20 2a 2a 20 74 68 65 20 70 65 72 6d 61 6e     ** the perman
1010: 65 6e 74 20 74 61 62 6c 65 20 69 73 20 68 69 64  ent table is hid
1020: 64 65 6e 20 62 79 20 74 68 65 20 54 45 4d 50 20  den by the TEMP 
1030: 74 61 62 6c 65 2c 20 77 65 20 63 61 6e 20 61 6c  table, we can al
1040: 73 6f 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20  so.          ** 
1050: 73 61 66 65 6c 79 20 69 67 6e 6f 72 65 20 74 68  safely ignore th
1060: 65 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20 70  e index on the p
1070: 65 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 2e 0a  ermanent table..
1080: 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20            */.   
1090: 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 4e 6f 74         /* Do Not
10a0: 68 69 6e 67 20 2a 2f 3b 0a 20 20 20 20 20 20 20  hing */;.       
10b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
10c0: 20 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 20 3d    pIndex->tnum =
10d0: 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a   atoi(argv[2]);.
10e0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
10f0: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 62 72 65 61  }.    }.    brea
1100: 6b 3b 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20  k;.    default: 
1110: 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20  {.      /* This 
1120: 63 61 6e 20 6e 6f 74 20 68 61 70 70 65 6e 21 20  can not happen! 
1130: 2a 2f 0a 20 20 20 20 20 20 6e 45 72 72 20 3d 20  */.      nErr = 
1140: 31 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  1;.      assert(
1150: 20 6e 45 72 72 3d 3d 30 20 29 3b 0a 20 20 20 20   nErr==0 );.    
1160: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e  }.  }.  return n
1170: 45 72 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74  Err;.}../*.** At
1180: 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68  tempt to read th
1190: 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d  e database schem
11a0: 61 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65  a and initialize
11b0: 20 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64 61 74   internal.** dat
11c0: 61 20 73 74 72 75 63 74 75 72 65 73 20 66 6f 72  a structures for
11d0: 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61   a single databa
11e0: 73 65 20 66 69 6c 65 2e 20 20 54 68 65 20 69 6e  se file.  The in
11f0: 64 65 78 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61  dex of the.** da
1200: 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 67  tabase file is g
1210: 69 76 65 6e 20 62 79 20 69 44 62 2e 20 20 69 44  iven by iDb.  iD
1220: 62 3d 3d 30 20 69 73 20 75 73 65 64 20 66 6f 72  b==0 is used for
1230: 20 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 64 61 74   the main.** dat
1240: 61 62 61 73 65 2e 20 20 69 44 62 3d 3d 31 20 73  abase.  iDb==1 s
1250: 68 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 75  hould never be u
1260: 73 65 64 2e 20 20 69 44 62 3e 3d 32 20 69 73 20  sed.  iDb>=2 is 
1270: 75 73 65 64 20 66 6f 72 0a 2a 2a 20 61 75 78 69  used for.** auxi
1280: 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 73 2e  liary databases.
1290: 20 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20    Return one of 
12a0: 74 68 65 20 53 51 4c 49 54 45 5f 20 65 72 72 6f  the SQLITE_ erro
12b0: 72 20 63 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e  r codes to.** in
12c0: 64 69 63 61 74 65 20 73 75 63 63 65 73 73 20 6f  dicate success o
12d0: 72 20 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 74  r failure..*/.st
12e0: 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33  atic int sqlite3
12f0: 49 6e 69 74 4f 6e 65 28 73 71 6c 69 74 65 20 2a  InitOne(sqlite *
1300: 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 63 68 61  db, int iDb, cha
1310: 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20  r **pzErrMsg){. 
1320: 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 43 75 72   int rc;.  BtCur
1330: 73 6f 72 20 2a 63 75 72 4d 61 69 6e 3b 0a 20 20  sor *curMain;.  
1340: 69 6e 74 20 73 69 7a 65 3b 0a 20 20 54 61 62 6c  int size;.  Tabl
1350: 65 20 2a 70 54 61 62 3b 0a 20 20 63 68 61 72 20  e *pTab;.  char 
1360: 63 6f 6e 73 74 20 2a 61 7a 41 72 67 5b 36 5d 3b  const *azArg[6];
1370: 0a 20 20 63 68 61 72 20 7a 44 62 4e 75 6d 5b 33  .  char zDbNum[3
1380: 30 5d 3b 0a 20 20 69 6e 74 20 6d 65 74 61 5b 31  0];.  int meta[1
1390: 30 5d 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69  0];.  InitData i
13a0: 6e 69 74 44 61 74 61 3b 0a 20 20 63 68 61 72 20  nitData;.  char 
13b0: 63 6f 6e 73 74 20 2a 7a 4d 61 73 74 65 72 53 63  const *zMasterSc
13c0: 68 65 6d 61 3b 0a 20 20 63 68 61 72 20 63 6f 6e  hema;.  char con
13d0: 73 74 20 2a 7a 4d 61 73 74 65 72 4e 61 6d 65 3b  st *zMasterName;
13e0: 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20  ..  /*.  ** The 
13f0: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20  master database 
1400: 74 61 62 6c 65 20 68 61 73 20 61 20 73 74 72 75  table has a stru
1410: 63 74 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a  cture like this.
1420: 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68    */.  static ch
1430: 61 72 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61  ar master_schema
1440: 5b 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41  [] = .     "CREA
1450: 54 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f  TE TABLE sqlite_
1460: 6d 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20  master(\n".     
1470: 22 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22  "  type text,\n"
1480: 0a 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65  .     "  name te
1490: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74  xt,\n".     "  t
14a0: 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22  bl_name text,\n"
14b0: 0a 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67  .     "  rootpag
14c0: 65 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20  e integer,\n".  
14d0: 20 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e     "  sql text\n
14e0: 22 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 20  ".     ")".  ;. 
14f0: 20 73 74 61 74 69 63 20 63 68 61 72 20 74 65 6d   static char tem
1500: 70 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b  p_master_schema[
1510: 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54  ] = .     "CREAT
1520: 45 20 54 45 4d 50 20 54 41 42 4c 45 20 73 71 6c  E TEMP TABLE sql
1530: 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 28  ite_temp_master(
1540: 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70 65  \n".     "  type
1550: 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22   text,\n".     "
1560: 20 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a    name text,\n".
1570: 20 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65       "  tbl_name
1580: 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22   text,\n".     "
1590: 20 20 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67    rootpage integ
15a0: 65 72 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73  er,\n".     "  s
15b0: 71 6c 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20  ql text\n".     
15c0: 22 29 22 0a 20 20 3b 0a 0a 20 20 61 73 73 65 72  ")".  ;..  asser
15d0: 74 28 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62  t( iDb>=0 && iDb
15e0: 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 0a 20 20 2f  <db->nDb );..  /
15f0: 2a 20 7a 4d 61 73 74 65 72 53 63 68 65 6d 61 20  * zMasterSchema 
1600: 61 6e 64 20 7a 49 6e 69 74 53 63 72 69 70 74 20  and zInitScript 
1610: 61 72 65 20 73 65 74 20 74 6f 20 70 6f 69 6e 74  are set to point
1620: 20 61 74 20 74 68 65 20 6d 61 73 74 65 72 20 73   at the master s
1630: 63 68 65 6d 61 0a 20 20 2a 2a 20 61 6e 64 20 69  chema.  ** and i
1640: 6e 69 74 69 61 6c 69 73 61 74 69 6f 6e 20 73 63  nitialisation sc
1650: 72 69 70 74 20 61 70 70 72 6f 70 72 69 61 74 65  ript appropriate
1660: 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 73   for the databas
1670: 65 20 62 65 69 6e 67 0a 20 20 2a 2a 20 69 6e 69  e being.  ** ini
1680: 74 69 61 6c 69 73 65 64 2e 20 7a 4d 61 73 74 65  tialised. zMaste
1690: 72 4e 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d  rName is the nam
16a0: 65 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20  e of the master 
16b0: 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66  table..  */.  if
16c0: 28 20 69 44 62 3d 3d 31 20 29 7b 0a 20 20 20 20  ( iDb==1 ){.    
16d0: 7a 4d 61 73 74 65 72 53 63 68 65 6d 61 20 3d 20  zMasterSchema = 
16e0: 74 65 6d 70 5f 6d 61 73 74 65 72 5f 73 63 68 65  temp_master_sche
16f0: 6d 61 3b 0a 20 20 20 20 7a 4d 61 73 74 65 72 4e  ma;.    zMasterN
1700: 61 6d 65 20 3d 20 54 45 4d 50 5f 4d 41 53 54 45  ame = TEMP_MASTE
1710: 52 5f 4e 41 4d 45 3b 0a 20 20 7d 65 6c 73 65 7b  R_NAME;.  }else{
1720: 0a 20 20 20 20 7a 4d 61 73 74 65 72 53 63 68 65  .    zMasterSche
1730: 6d 61 20 3d 20 6d 61 73 74 65 72 5f 73 63 68 65  ma = master_sche
1740: 6d 61 3b 0a 20 20 20 20 7a 4d 61 73 74 65 72 4e  ma;.    zMasterN
1750: 61 6d 65 20 3d 20 4d 41 53 54 45 52 5f 4e 41 4d  ame = MASTER_NAM
1760: 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 6f 6e  E;.  }..  /* Con
1770: 73 74 72 75 63 74 20 74 68 65 20 73 63 68 65 6d  struct the schem
1780: 61 20 74 61 62 6c 65 73 2e 20 20 2a 2f 0a 20 20  a tables.  */.  
1790: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66  sqlite3SafetyOff
17a0: 28 64 62 29 3b 0a 20 20 61 7a 41 72 67 5b 30 5d  (db);.  azArg[0]
17b0: 20 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 61 7a   = "table";.  az
17c0: 41 72 67 5b 31 5d 20 3d 20 7a 4d 61 73 74 65 72  Arg[1] = zMaster
17d0: 4e 61 6d 65 3b 0a 20 20 61 7a 41 72 67 5b 32 5d  Name;.  azArg[2]
17e0: 20 3d 20 22 31 22 3b 0a 20 20 61 7a 41 72 67 5b   = "1";.  azArg[
17f0: 33 5d 20 3d 20 7a 4d 61 73 74 65 72 53 63 68 65  3] = zMasterSche
1800: 6d 61 3b 0a 20 20 73 70 72 69 6e 74 66 28 7a 44  ma;.  sprintf(zD
1810: 62 4e 75 6d 2c 20 22 25 64 22 2c 20 69 44 62 29  bNum, "%d", iDb)
1820: 3b 0a 20 20 61 7a 41 72 67 5b 34 5d 20 3d 20 7a  ;.  azArg[4] = z
1830: 44 62 4e 75 6d 3b 0a 20 20 61 7a 41 72 67 5b 35  DbNum;.  azArg[5
1840: 5d 20 3d 20 30 3b 0a 20 20 69 6e 69 74 44 61 74  ] = 0;.  initDat
1850: 61 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69  a.db = db;.  ini
1860: 74 44 61 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d  tData.pzErrMsg =
1870: 20 70 7a 45 72 72 4d 73 67 3b 0a 20 20 72 63 20   pzErrMsg;.  rc 
1880: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c  = sqlite3InitCal
1890: 6c 62 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c  lback(&initData,
18a0: 20 35 2c 20 28 63 68 61 72 20 2a 2a 29 61 7a 41   5, (char **)azA
18b0: 72 67 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63  rg, 0);.  if( rc
18c0: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
18d0: 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79     sqlite3Safety
18e0: 4f 6e 28 64 62 29 3b 0a 20 20 20 20 72 65 74 75  On(db);.    retu
18f0: 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 54 61  rn rc;.  }.  pTa
1900: 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 54  b = sqlite3FindT
1910: 61 62 6c 65 28 64 62 2c 20 7a 4d 61 73 74 65 72  able(db, zMaster
1920: 4e 61 6d 65 2c 20 64 62 2d 3e 61 44 62 5b 69 44  Name, db->aDb[iD
1930: 62 5d 2e 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28  b].zName);.  if(
1940: 20 70 54 61 62 20 29 7b 0a 20 20 20 20 70 54 61   pTab ){.    pTa
1950: 62 2d 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b  b->readOnly = 1;
1960: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 53 61  .  }.  sqlite3Sa
1970: 66 65 74 79 4f 6e 28 64 62 29 3b 0a 0a 20 20 2f  fetyOn(db);..  /
1980: 2a 20 43 72 65 61 74 65 20 61 20 63 75 72 73 6f  * Create a curso
1990: 72 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 64 61  r to hold the da
19a0: 74 61 62 61 73 65 20 6f 70 65 6e 0a 20 20 2a 2f  tabase open.  */
19b0: 0a 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69  .  if( db->aDb[i
19c0: 44 62 5d 2e 70 42 74 3d 3d 30 20 29 20 72 65 74  Db].pBt==0 ) ret
19d0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
19e0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
19f0: 65 65 43 75 72 73 6f 72 28 64 62 2d 3e 61 44 62  eeCursor(db->aDb
1a00: 5b 69 44 62 5d 2e 70 42 74 2c 20 4d 41 53 54 45  [iDb].pBt, MASTE
1a10: 52 5f 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 30 2c  R_ROOT, 0, 0, 0,
1a20: 20 26 63 75 72 4d 61 69 6e 29 3b 0a 20 20 69 66   &curMain);.  if
1a30: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
1a40: 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f 45 4d  && rc!=SQLITE_EM
1a50: 50 54 59 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  PTY ){.    sqlit
1a60: 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  e3SetString(pzEr
1a70: 72 4d 73 67 2c 20 73 71 6c 69 74 65 33 45 72 72  rMsg, sqlite3Err
1a80: 53 74 72 28 72 63 29 2c 20 28 63 68 61 72 2a 29  Str(rc), (char*)
1a90: 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72  0);.    return r
1aa0: 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 47 65 74  c;.  }..  /* Get
1ab0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d 65   the database me
1ac0: 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a  ta information..
1ad0: 20 20 2a 2a 0a 20 20 2a 2a 20 4d 65 74 61 20 76    **.  ** Meta v
1ae0: 61 6c 75 65 73 20 61 72 65 20 61 73 20 66 6f 6c  alues are as fol
1af0: 6c 6f 77 73 3a 0a 20 20 2a 2a 20 20 20 20 6d 65  lows:.  **    me
1b00: 74 61 5b 30 5d 20 20 20 53 63 68 65 6d 61 20 63  ta[0]   Schema c
1b10: 6f 6f 6b 69 65 2e 20 20 43 68 61 6e 67 65 73 20  ookie.  Changes 
1b20: 77 69 74 68 20 65 61 63 68 20 73 63 68 65 6d 61  with each schema
1b30: 20 63 68 61 6e 67 65 2e 0a 20 20 2a 2a 20 20 20   change..  **   
1b40: 20 6d 65 74 61 5b 31 5d 20 20 20 46 69 6c 65 20   meta[1]   File 
1b50: 66 6f 72 6d 61 74 20 6f 66 20 73 63 68 65 6d 61  format of schema
1b60: 20 6c 61 79 65 72 2e 0a 20 20 2a 2a 20 20 20 20   layer..  **    
1b70: 6d 65 74 61 5b 32 5d 20 20 20 53 69 7a 65 20 6f  meta[2]   Size o
1b80: 66 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65  f the page cache
1b90: 2e 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 33  ..  **    meta[3
1ba0: 5d 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34  ].  **    meta[4
1bb0: 5d 20 20 20 44 62 20 74 65 78 74 20 65 6e 63 6f  ]   Db text enco
1bc0: 64 69 6e 67 2e 20 31 3a 55 54 46 2d 38 20 33 3a  ding. 1:UTF-8 3:
1bd0: 55 54 46 2d 31 36 20 4c 45 20 34 3a 55 54 46 2d  UTF-16 LE 4:UTF-
1be0: 31 36 20 42 45 0a 20 20 2a 2a 20 20 20 20 6d 65  16 BE.  **    me
1bf0: 74 61 5b 35 5d 0a 20 20 2a 2a 20 20 20 20 6d 65  ta[5].  **    me
1c00: 74 61 5b 36 5d 20 20 20 0a 20 20 2a 2a 20 20 20  ta[6]   .  **   
1c10: 20 6d 65 74 61 5b 37 5d 0a 20 20 2a 2a 20 20 20   meta[7].  **   
1c20: 20 6d 65 74 61 5b 38 5d 0a 20 20 2a 2a 20 20 20   meta[8].  **   
1c30: 20 6d 65 74 61 5b 39 5d 0a 20 20 2a 2a 0a 20 20   meta[9].  **.  
1c40: 2a 2a 20 4e 6f 74 65 3a 20 54 68 65 20 68 61 73  ** Note: The has
1c50: 68 20 64 65 66 69 6e 65 64 20 53 51 4c 49 54 45  h defined SQLITE
1c60: 5f 55 54 46 2a 20 73 79 6d 62 6f 6c 73 20 69 6e  _UTF* symbols in
1c70: 20 73 71 6c 69 74 65 49 6e 74 2e 68 20 63 6f 72   sqliteInt.h cor
1c80: 72 65 73 70 6f 6e 64 20 74 6f 0a 20 20 2a 2a 20  respond to.  ** 
1c90: 74 68 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c  the possible val
1ca0: 75 65 73 20 6f 66 20 6d 65 74 61 5b 34 5d 2e 0a  ues of meta[4]..
1cb0: 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53    */.  if( rc==S
1cc0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
1cd0: 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69  int i;.    for(i
1ce0: 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  =0; rc==SQLITE_O
1cf0: 4b 20 26 26 20 69 3c 73 69 7a 65 6f 66 28 6d 65  K && i<sizeof(me
1d00: 74 61 29 2f 73 69 7a 65 6f 66 28 6d 65 74 61 5b  ta)/sizeof(meta[
1d10: 30 5d 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  0]); i++){.     
1d20: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
1d30: 65 65 47 65 74 4d 65 74 61 28 64 62 2d 3e 61 44  eeGetMeta(db->aD
1d40: 62 5b 69 44 62 5d 2e 70 42 74 2c 20 69 2b 31 2c  b[iDb].pBt, i+1,
1d50: 20 28 75 33 32 20 2a 29 26 6d 65 74 61 5b 69 5d   (u32 *)&meta[i]
1d60: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28  );.    }.    if(
1d70: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c   rc ){.      sql
1d80: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a  ite3SetString(pz
1d90: 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 33 45  ErrMsg, sqlite3E
1da0: 72 72 53 74 72 28 72 63 29 2c 20 28 63 68 61 72  rrStr(rc), (char
1db0: 2a 29 30 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  *)0);.      sqli
1dc0: 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72  te3BtreeCloseCur
1dd0: 73 6f 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20  sor(curMain);.  
1de0: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
1df0: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20     }.  }else{.  
1e00: 20 20 6d 65 6d 73 65 74 28 6d 65 74 61 2c 20 30    memset(meta, 0
1e10: 2c 20 73 69 7a 65 6f 66 28 6d 65 74 61 29 29 3b  , sizeof(meta));
1e20: 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 69  .  }.  db->aDb[i
1e30: 44 62 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69  Db].schema_cooki
1e40: 65 20 3d 20 6d 65 74 61 5b 30 5d 3b 0a 0a 20 20  e = meta[0];..  
1e50: 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20 61 20  /* If opening a 
1e60: 6e 6f 6e 2d 65 6d 70 74 79 20 64 61 74 61 62 61  non-empty databa
1e70: 73 65 2c 20 63 68 65 63 6b 20 74 68 65 20 74 65  se, check the te
1e80: 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20 46 6f 72  xt encoding. For
1e90: 20 74 68 65 0a 20 20 2a 2a 20 6d 61 69 6e 20 64   the.  ** main d
1ea0: 61 74 61 62 61 73 65 2c 20 73 65 74 20 73 71 6c  atabase, set sql
1eb0: 69 74 65 33 2e 65 6e 63 20 74 6f 20 74 68 65 20  ite3.enc to the 
1ec0: 65 6e 63 6f 64 69 6e 67 20 6f 66 20 74 68 65 20  encoding of the 
1ed0: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2e 0a 20  main database.. 
1ee0: 20 2a 2a 20 46 6f 72 20 61 6e 20 61 74 74 61 63   ** For an attac
1ef0: 68 65 64 20 64 62 2c 20 69 74 20 69 73 20 61 6e  hed db, it is an
1f00: 20 65 72 72 6f 72 20 69 66 20 74 68 65 20 65 6e   error if the en
1f10: 63 6f 64 69 6e 67 20 69 73 20 6e 6f 74 20 74 68  coding is not th
1f20: 65 20 73 61 6d 65 0a 20 20 2a 2a 20 61 73 20 73  e same.  ** as s
1f30: 71 6c 69 74 65 33 2e 65 6e 63 2e 0a 20 20 2a 2f  qlite3.enc..  */
1f40: 0a 20 20 69 66 28 20 6d 65 74 61 5b 34 5d 20 29  .  if( meta[4] )
1f50: 7b 20 20 2f 2a 20 74 65 78 74 20 65 6e 63 6f 64  {  /* text encod
1f60: 69 6e 67 20 2a 2f 0a 20 20 20 20 69 66 28 20 69  ing */.    if( i
1f70: 44 62 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f  Db==0 ){.      /
1f80: 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20 74 68 65  * If opening the
1f90: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2c 20   main database, 
1fa0: 73 65 74 20 64 62 2d 3e 65 6e 63 2e 20 2a 2f 0a  set db->enc. */.
1fb0: 20 20 20 20 20 20 64 62 2d 3e 65 6e 63 20 3d 20        db->enc = 
1fc0: 28 75 38 29 6d 65 74 61 5b 34 5d 3b 0a 20 20 20  (u8)meta[4];.   
1fd0: 20 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c     db->pDfltColl
1fe0: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f   = sqlite3FindCo
1ff0: 6c 6c 53 65 71 28 64 62 2c 20 64 62 2d 3e 65 6e  llSeq(db, db->en
2000: 63 2c 20 22 42 49 4e 41 52 59 22 2c 20 36 2c 20  c, "BINARY", 6, 
2010: 30 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  0);.    }else{. 
2020: 20 20 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69       /* If openi
2030: 6e 67 20 61 6e 20 61 74 74 61 63 68 65 64 20 64  ng an attached d
2040: 61 74 61 62 61 73 65 2c 20 74 68 65 20 65 6e 63  atabase, the enc
2050: 6f 64 69 6e 67 20 6d 75 63 68 20 6d 61 74 63 68  oding much match
2060: 20 64 62 2d 3e 65 6e 63 20 2a 2f 0a 20 20 20 20   db->enc */.    
2070: 20 20 69 66 28 20 6d 65 74 61 5b 34 5d 21 3d 64    if( meta[4]!=d
2080: 62 2d 3e 65 6e 63 20 29 7b 0a 20 20 20 20 20 20  b->enc ){.      
2090: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c    sqlite3BtreeCl
20a0: 6f 73 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69  oseCursor(curMai
20b0: 6e 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  n);.        sqli
20c0: 74 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45  te3SetString(pzE
20d0: 72 72 4d 73 67 2c 20 22 61 74 74 61 63 68 65 64  rrMsg, "attached
20e0: 20 64 61 74 61 62 61 73 65 73 20 6d 75 73 74 20   databases must 
20f0: 75 73 65 20 74 68 65 20 73 61 6d 65 22 0a 20 20  use the same".  
2100: 20 20 20 20 20 20 20 20 20 20 22 20 74 65 78 74            " text
2110: 20 65 6e 63 6f 64 69 6e 67 20 61 73 20 6d 61 69   encoding as mai
2120: 6e 20 64 61 74 61 62 61 73 65 22 2c 20 28 63 68  n database", (ch
2130: 61 72 2a 29 30 29 3b 0a 20 20 20 20 20 20 20 20  ar*)0);.        
2140: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52  return SQLITE_ER
2150: 52 4f 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  ROR;.      }.   
2160: 20 7d 0a 20 20 7d 0a 0a 20 20 73 69 7a 65 20 3d   }.  }..  size =
2170: 20 6d 65 74 61 5b 32 5d 3b 0a 20 20 69 66 28 20   meta[2];.  if( 
2180: 73 69 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20  size==0 ){ size 
2190: 3d 20 4d 41 58 5f 50 41 47 45 53 3b 20 7d 0a 20  = MAX_PAGES; }. 
21a0: 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 63 61   db->aDb[iDb].ca
21b0: 63 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b  che_size = size;
21c0: 0a 0a 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29  ..  if( iDb==0 )
21d0: 7b 0a 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f 66  {.    db->file_f
21e0: 6f 72 6d 61 74 20 3d 20 6d 65 74 61 5b 31 5d 3b  ormat = meta[1];
21f0: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 66 69 6c  .    if( db->fil
2200: 65 5f 66 6f 72 6d 61 74 3d 3d 30 20 29 7b 0a 20  e_format==0 ){. 
2210: 20 20 20 20 20 2f 2a 20 54 68 69 73 20 68 61 70       /* This hap
2220: 70 65 6e 73 20 69 66 20 74 68 65 20 64 61 74 61  pens if the data
2230: 62 61 73 65 20 77 61 73 20 69 6e 69 74 69 61 6c  base was initial
2240: 6c 79 20 65 6d 70 74 79 20 2a 2f 0a 20 20 20 20  ly empty */.    
2250: 20 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61    db->file_forma
2260: 74 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d  t = 1;.    }.  }
2270: 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 20 66 69 6c  ..  /*.  **  fil
2280: 65 5f 66 6f 72 6d 61 74 3d 3d 31 20 20 20 20 56  e_format==1    V
2290: 65 72 73 69 6f 6e 20 33 2e 30 2e 30 2e 0a 20 20  ersion 3.0.0..  
22a0: 2a 2f 0a 20 20 69 66 28 20 6d 65 74 61 5b 31 5d  */.  if( meta[1]
22b0: 3e 31 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  >1 ){.    sqlite
22c0: 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f  3BtreeCloseCurso
22d0: 72 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 20 20  r(curMain);.    
22e0: 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67  sqlite3SetString
22f0: 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e 73 75  (pzErrMsg, "unsu
2300: 70 70 6f 72 74 65 64 20 66 69 6c 65 20 66 6f 72  pported file for
2310: 6d 61 74 22 2c 20 28 63 68 61 72 2a 29 30 29 3b  mat", (char*)0);
2320: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
2330: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20  TE_ERROR;.  }.. 
2340: 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74   sqlite3BtreeSet
2350: 43 61 63 68 65 53 69 7a 65 28 64 62 2d 3e 61 44  CacheSize(db->aD
2360: 62 5b 69 44 62 5d 2e 70 42 74 2c 20 64 62 2d 3e  b[iDb].pBt, db->
2370: 61 44 62 5b 69 44 62 5d 2e 63 61 63 68 65 5f 73  aDb[iDb].cache_s
2380: 69 7a 65 29 3b 0a 0a 20 20 2f 2a 20 52 65 61 64  ize);..  /* Read
2390: 20 74 68 65 20 73 63 68 65 6d 61 20 69 6e 66 6f   the schema info
23a0: 72 6d 61 74 69 6f 6e 20 6f 75 74 20 6f 66 20 74  rmation out of t
23b0: 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73  he schema tables
23c0: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
23d0: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b  db->init.busy );
23e0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
23f0: 45 5f 45 4d 50 54 59 20 29 7b 0a 20 20 20 20 2f  E_EMPTY ){.    /
2400: 2a 20 46 6f 72 20 61 6e 20 65 6d 70 74 79 20 64  * For an empty d
2410: 61 74 61 62 61 73 65 2c 20 74 68 65 72 65 20 69  atabase, there i
2420: 73 20 6e 6f 74 68 69 6e 67 20 74 6f 20 72 65 61  s nothing to rea
2430: 64 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51  d */.    rc = SQ
2440: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65  LITE_OK;.  }else
2450: 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53 71 6c  {.    char *zSql
2460: 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65   = 0;.    sqlite
2470: 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a  3SafetyOff(db);.
2480: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
2490: 72 69 6e 67 28 26 7a 53 71 6c 2c 20 0a 20 20 20  ring(&zSql, .   
24a0: 20 20 20 20 20 22 53 45 4c 45 43 54 20 74 79 70       "SELECT typ
24b0: 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67  e, name, rootpag
24c0: 65 2c 20 73 71 6c 2c 20 22 2c 20 7a 44 62 4e 75  e, sql, ", zDbNu
24d0: 6d 2c 20 22 20 46 52 4f 4d 20 5c 22 22 2c 0a 20  m, " FROM \"",. 
24e0: 20 20 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69         db->aDb[i
24f0: 44 62 5d 2e 7a 4e 61 6d 65 2c 20 22 5c 22 2e 22  Db].zName, "\"."
2500: 2c 20 7a 4d 61 73 74 65 72 4e 61 6d 65 2c 20 28  , zMasterName, (
2510: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 63  char*)0);.    rc
2520: 20 3d 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28   = sqlite3_exec(
2530: 64 62 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65  db, zSql, sqlite
2540: 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26  3InitCallback, &
2550: 69 6e 69 74 44 61 74 61 2c 20 30 29 3b 0a 20 20  initData, 0);.  
2560: 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 53 71    sqliteFree(zSq
2570: 6c 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53  l);.    sqlite3S
2580: 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 20  afetyOn(db);.   
2590: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
25a0: 73 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e  seCursor(curMain
25b0: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c  );.  }.  if( sql
25c0: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
25d0: 65 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ed ){.    sqlite
25e0: 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72  3SetString(pzErr
25f0: 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d  Msg, "out of mem
2600: 6f 72 79 22 2c 20 28 63 68 61 72 2a 29 30 29 3b  ory", (char*)0);
2610: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
2620: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69  _NOMEM;.    sqli
2630: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
2640: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
2650: 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c   }.  if( rc==SQL
2660: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 44 62  ITE_OK ){.    Db
2670: 53 65 74 50 72 6f 70 65 72 74 79 28 64 62 2c 20  SetProperty(db, 
2680: 69 44 62 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f  iDb, DB_SchemaLo
2690: 61 64 65 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  aded);.  }else{.
26a0: 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74      sqlite3Reset
26b0: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64  InternalSchema(d
26c0: 62 2c 20 69 44 62 29 3b 0a 20 20 7d 0a 20 20 72  b, iDb);.  }.  r
26d0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
26e0: 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 61 6c  ** Initialize al
26f0: 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73  l database files
2700: 20 2d 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61   - the main data
2710: 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 20 66  base file, the f
2720: 69 6c 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73  ile.** used to s
2730: 74 6f 72 65 20 74 65 6d 70 6f 72 61 72 79 20 74  tore temporary t
2740: 61 62 6c 65 73 2c 20 61 6e 64 20 61 6e 79 20 61  ables, and any a
2750: 64 64 69 74 69 6f 6e 61 6c 20 64 61 74 61 62 61  dditional databa
2760: 73 65 20 66 69 6c 65 73 0a 2a 2a 20 63 72 65 61  se files.** crea
2770: 74 65 64 20 75 73 69 6e 67 20 41 54 54 41 43 48  ted using ATTACH
2780: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 52 65   statements.  Re
2790: 74 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63  turn a success c
27a0: 6f 64 65 2e 20 20 49 66 20 61 6e 0a 2a 2a 20 65  ode.  If an.** e
27b0: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 77 72 69  rror occurs, wri
27c0: 74 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  te an error mess
27d0: 61 67 65 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d  age into *pzErrM
27e0: 73 67 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20  sg..**.** After 
27f0: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
2800: 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65  initialized, the
2810: 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69   SQLITE_Initiali
2820: 7a 65 64 0a 2a 2a 20 62 69 74 20 69 73 20 73 65  zed.** bit is se
2830: 74 20 69 6e 20 74 68 65 20 66 6c 61 67 73 20 66  t in the flags f
2840: 69 65 6c 64 20 6f 66 20 74 68 65 20 73 71 6c 69  ield of the sqli
2850: 74 65 20 73 74 72 75 63 74 75 72 65 2e 20 0a 2a  te structure. .*
2860: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 69  /.int sqlite3Ini
2870: 74 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 63 68  t(sqlite *db, ch
2880: 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a  ar **pzErrMsg){.
2890: 20 20 69 6e 74 20 69 2c 20 72 63 3b 0a 20 20 0a    int i, rc;.  .
28a0: 20 20 69 66 28 20 64 62 2d 3e 69 6e 69 74 2e 62    if( db->init.b
28b0: 75 73 79 20 29 20 72 65 74 75 72 6e 20 53 51 4c  usy ) return SQL
28c0: 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74  ITE_OK;.  assert
28d0: 28 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  ( (db->flags & S
28e0: 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65  QLITE_Initialize
28f0: 64 29 3d 3d 30 20 29 3b 0a 20 20 72 63 20 3d 20  d)==0 );.  rc = 
2900: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 64 62 2d  SQLITE_OK;.  db-
2910: 3e 69 6e 69 74 2e 62 75 73 79 20 3d 20 31 3b 0a  >init.busy = 1;.
2920: 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53    for(i=0; rc==S
2930: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62  QLITE_OK && i<db
2940: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nDb; i++){.   
2950: 20 69 66 28 20 44 62 48 61 73 50 72 6f 70 65 72   if( DbHasProper
2960: 74 79 28 64 62 2c 20 69 2c 20 44 42 5f 53 63 68  ty(db, i, DB_Sch
2970: 65 6d 61 4c 6f 61 64 65 64 29 20 7c 7c 20 69 3d  emaLoaded) || i=
2980: 3d 31 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20  =1 ) continue;. 
2990: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49     rc = sqlite3I
29a0: 6e 69 74 4f 6e 65 28 64 62 2c 20 69 2c 20 70 7a  nitOne(db, i, pz
29b0: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 69 66 28  ErrMsg);.    if(
29c0: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c   rc ){.      sql
29d0: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61  ite3ResetInterna
29e0: 6c 53 63 68 65 6d 61 28 64 62 2c 20 69 29 3b 0a  lSchema(db, i);.
29f0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
2a00: 4f 6e 63 65 20 61 6c 6c 20 74 68 65 20 6f 74 68  Once all the oth
2a10: 65 72 20 64 61 74 61 62 61 73 65 73 20 68 61 76  er databases hav
2a20: 65 20 62 65 65 6e 20 69 6e 69 74 69 61 6c 69 73  e been initialis
2a30: 65 64 2c 20 6c 6f 61 64 20 74 68 65 20 73 63 68  ed, load the sch
2a40: 65 6d 61 0a 20 20 2a 2a 20 66 6f 72 20 74 68 65  ema.  ** for the
2a50: 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 2e 20   TEMP database. 
2a60: 54 68 69 73 20 69 73 20 6c 6f 61 64 65 64 20 6c  This is loaded l
2a70: 61 73 74 2c 20 61 73 20 74 68 65 20 54 45 4d 50  ast, as the TEMP
2a80: 20 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 73   database.  ** s
2a90: 63 68 65 6d 61 20 6d 61 79 20 63 6f 6e 74 61 69  chema may contai
2aa0: 6e 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20  n references to 
2ab0: 6f 62 6a 65 63 74 73 20 69 6e 20 6f 74 68 65 72  objects in other
2ac0: 20 64 61 74 61 62 61 73 65 73 2e 0a 20 20 2a 2f   databases..  */
2ad0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
2ae0: 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 6e 44 62 3e  E_OK && db->nDb>
2af0: 31 20 26 26 20 21 44 62 48 61 73 50 72 6f 70 65  1 && !DbHasPrope
2b00: 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53 63  rty(db, 1, DB_Sc
2b10: 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 7b 0a 20  hemaLoaded) ){. 
2b20: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49     rc = sqlite3I
2b30: 6e 69 74 4f 6e 65 28 64 62 2c 20 31 2c 20 70 7a  nitOne(db, 1, pz
2b40: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 69 66 28  ErrMsg);.    if(
2b50: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 73 71 6c   rc ){.      sql
2b60: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61  ite3ResetInterna
2b70: 6c 53 63 68 65 6d 61 28 64 62 2c 20 31 29 3b 0a  lSchema(db, 1);.
2b80: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 64 62 2d      }.  }..  db-
2b90: 3e 69 6e 69 74 2e 62 75 73 79 20 3d 20 30 3b 0a  >init.busy = 0;.
2ba0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
2bb0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66  _OK ){.    db->f
2bc0: 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 49  lags |= SQLITE_I
2bd0: 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 20 20 20 20  nitialized;.    
2be0: 73 71 6c 69 74 65 33 43 6f 6d 6d 69 74 49 6e 74  sqlite3CommitInt
2bf0: 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29  ernalChanges(db)
2c00: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 21  ;.  }..  if( rc!
2c10: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
2c20: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e    db->flags &= ~
2c30: 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a  SQLITE_Initializ
2c40: 65 64 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  ed;.  }.  return
2c50: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68   rc;.}../*.** Th
2c60: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20  is routine is a 
2c70: 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 64 61 74  no-op if the dat
2c80: 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20  abase schema is 
2c90: 61 6c 72 65 61 64 79 20 69 6e 69 74 69 61 6c 69  already initiali
2ca0: 73 65 64 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73  sed..** Otherwis
2cb0: 65 2c 20 74 68 65 20 73 63 68 65 6d 61 20 69 73  e, the schema is
2cc0: 20 6c 6f 61 64 65 64 2e 20 41 6e 20 65 72 72 6f   loaded. An erro
2cd0: 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e  r code is return
2ce0: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
2cf0: 65 33 52 65 61 64 53 63 68 65 6d 61 28 50 61 72  e3ReadSchema(Par
2d00: 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20 20 69  se *pParse){.  i
2d10: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
2d20: 4b 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  K;.  sqlite3 *db
2d30: 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a 20   = pParse->db;. 
2d40: 20 69 66 28 20 21 64 62 2d 3e 69 6e 69 74 2e 62   if( !db->init.b
2d50: 75 73 79 20 29 7b 0a 20 20 20 20 69 66 28 20 28  usy ){.    if( (
2d60: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
2d70: 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 3d  TE_Initialized)=
2d80: 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d  =0 ){.      rc =
2d90: 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64 62 2c   sqlite3Init(db,
2da0: 20 26 70 50 61 72 73 65 2d 3e 7a 45 72 72 4d 73   &pParse->zErrMs
2db0: 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  g);.    }.  }.  
2dc0: 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49  assert( rc!=SQLI
2dd0: 54 45 5f 4f 4b 20 7c 7c 20 28 64 62 2d 3e 66 6c  TE_OK || (db->fl
2de0: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49 6e 69  ags & SQLITE_Ini
2df0: 74 69 61 6c 69 7a 65 64 29 7c 7c 64 62 2d 3e 69  tialized)||db->i
2e00: 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20 20 69 66  nit.busy );.  if
2e10: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
2e20: 29 7b 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 72  ){.    pParse->r
2e30: 63 20 3d 20 72 63 3b 0a 20 20 20 20 70 50 61 72  c = rc;.    pPar
2e40: 73 65 2d 3e 6e 45 72 72 2b 2b 3b 0a 20 20 7d 0a  se->nErr++;.  }.
2e50: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
2e60: 2f 2a 0a 2a 2a 20 54 68 65 20 76 65 72 73 69 6f  /*.** The versio
2e70: 6e 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72 79  n of the library
2e80: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 72  .*/.const char r
2e90: 63 73 69 64 33 5b 5d 20 3d 20 22 40 28 23 29 20  csid3[] = "@(#) 
2ea0: 5c 30 34 34 49 64 3a 20 53 51 4c 69 74 65 20 76  \044Id: SQLite v
2eb0: 65 72 73 69 6f 6e 20 22 20 53 51 4c 49 54 45 5f  ersion " SQLITE_
2ec0: 56 45 52 53 49 4f 4e 20 22 20 24 22 3b 0a 63 6f  VERSION " $";.co
2ed0: 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 33  nst char sqlite3
2ee0: 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c  _version[] = SQL
2ef0: 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a  ITE_VERSION;../*
2f00: 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20  .** This is the 
2f10: 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e  default collatin
2f20: 67 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64  g function named
2f30: 20 22 42 49 4e 41 52 59 22 20 77 68 69 63 68 20   "BINARY" which 
2f40: 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 61 76 61  is always.** ava
2f50: 69 6c 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69  ilable..*/.stati
2f60: 63 20 69 6e 74 20 62 69 6e 61 72 79 43 6f 6c 6c  c int binaryColl
2f70: 61 74 69 6e 67 46 75 6e 63 28 0a 20 20 76 6f 69  atingFunc(.  voi
2f80: 64 20 2a 4e 6f 74 55 73 65 64 2c 0a 20 20 69 6e  d *NotUsed,.  in
2f90: 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76  t nKey1, const v
2fa0: 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e  oid *pKey1,.  in
2fb0: 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76  t nKey2, const v
2fc0: 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20  oid *pKey2.){.  
2fd0: 69 6e 74 20 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d  int rc, n;.  n =
2fe0: 20 6e 4b 65 79 31 3c 6e 4b 65 79 32 20 3f 20 6e   nKey1<nKey2 ? n
2ff0: 4b 65 79 31 20 3a 20 6e 4b 65 79 32 3b 0a 20 20  Key1 : nKey2;.  
3000: 72 63 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79  rc = memcmp(pKey
3010: 31 2c 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20  1, pKey2, n);.  
3020: 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20  if( rc==0 ){.   
3030: 20 72 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b   rc = nKey1 - nK
3040: 65 79 32 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  ey2;.  }.  retur
3050: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  n rc;.}../*.** A
3060: 6e 6f 74 68 65 72 20 62 75 69 6c 74 2d 69 6e 20  nother built-in 
3070: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e  collating sequen
3080: 63 65 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a 2a 0a  ce: NOCASE. .**.
3090: 2a 2a 20 54 68 69 73 20 63 6f 6c 6c 61 74 69 6e  ** This collatin
30a0: 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 69 6e  g sequence is in
30b0: 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65  tended to be use
30c0: 64 20 66 6f 72 20 22 63 61 73 65 20 69 6e 64 65  d for "case inde
30d0: 70 65 6e 64 61 6e 74 0a 2a 2a 20 63 6f 6d 70 61  pendant.** compa
30e0: 72 69 73 6f 6e 22 2e 20 53 51 4c 69 74 65 27 73  rison". SQLite's
30f0: 20 6b 6e 6f 77 6c 65 64 67 65 20 6f 66 20 75 70   knowledge of up
3100: 70 65 72 20 61 6e 64 20 6c 6f 77 65 72 20 63 61  per and lower ca
3110: 73 65 20 65 71 75 69 76 61 6c 65 6e 74 73 0a 2a  se equivalents.*
3120: 2a 20 65 78 74 65 6e 64 73 20 6f 6e 6c 79 20 74  * extends only t
3130: 6f 20 74 68 65 20 32 36 20 63 68 61 72 61 63 74  o the 26 charact
3140: 65 72 73 20 75 73 65 64 20 69 6e 20 74 68 65 20  ers used in the 
3150: 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65  English language
3160: 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 20 6d  ..**.** At the m
3170: 6f 6d 65 6e 74 20 74 68 65 72 65 20 69 73 20 6f  oment there is o
3180: 6e 6c 79 20 61 20 55 54 46 2d 38 20 69 6d 70 6c  nly a UTF-8 impl
3190: 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 73  ementation..*/.s
31a0: 74 61 74 69 63 20 69 6e 74 20 6e 6f 63 61 73 65  tatic int nocase
31b0: 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 28 0a 20  CollatingFunc(. 
31c0: 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a   void *NotUsed,.
31d0: 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e    int nKey1, con
31e0: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a  st void *pKey1,.
31f0: 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e    int nKey2, con
3200: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29  st void *pKey2.)
3210: 7b 0a 20 20 69 6e 74 20 72 20 3d 20 73 71 6c 69  {.  int r = sqli
3220: 74 65 33 53 74 72 4e 49 43 6d 70 28 0a 20 20 20  te3StrNICmp(.   
3230: 20 20 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a     (const char *
3240: 29 70 4b 65 79 31 2c 20 28 63 6f 6e 73 74 20 63  )pKey1, (const c
3250: 68 61 72 20 2a 29 70 4b 65 79 32 2c 20 28 6e 4b  har *)pKey2, (nK
3260: 65 79 31 3e 6e 4b 65 79 32 29 3f 6e 4b 65 79 31  ey1>nKey2)?nKey1
3270: 3a 6e 4b 65 79 32 29 3b 0a 20 20 69 66 28 20 30  :nKey2);.  if( 0
3280: 3d 3d 72 20 29 7b 0a 20 20 20 20 72 20 3d 20 6e  ==r ){.    r = n
3290: 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d 0a  Key1-nKey2;.  }.
32a0: 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a 2f    return r;.}../
32b0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
32c0: 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6d 6f 73  ROWID of the mos
32d0: 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 0a  t recent insert.
32e0: 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  */.sqlite_int64 
32f0: 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73  sqlite3_last_ins
3300: 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 65  ert_rowid(sqlite
3310: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20   *db){.  return 
3320: 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d  db->lastRowid;.}
3330: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
3340: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61  he number of cha
3350: 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74  nges in the most
3360: 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20   recent call to 
3370: 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a  sqlite3_exec()..
3380: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
3390: 68 61 6e 67 65 73 28 73 71 6c 69 74 65 20 2a 64  hanges(sqlite *d
33a0: 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d  b){.  return db-
33b0: 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a  >nChange;.}../*.
33c0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  ** Return the nu
33d0: 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 20  mber of changes 
33e0: 73 69 6e 63 65 20 74 68 65 20 64 61 74 61 62 61  since the databa
33f0: 73 65 20 68 61 6e 64 6c 65 20 77 61 73 20 6f 70  se handle was op
3400: 65 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ened..*/.int sql
3410: 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e 67  ite3_total_chang
3420: 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  es(sqlite3 *db){
3430: 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e 54  .  return db->nT
3440: 6f 74 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f  otalChange;.}../
3450: 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65 78  *.** Close an ex
3460: 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20 64 61  isting SQLite da
3470: 74 61 62 61 73 65 0a 2a 2f 0a 69 6e 74 20 73 71  tabase.*/.int sq
3480: 6c 69 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c 69  lite3_close(sqli
3490: 74 65 20 2a 64 62 29 7b 0a 20 20 48 61 73 68 45  te *db){.  HashE
34a0: 6c 65 6d 20 2a 69 3b 0a 20 20 69 6e 74 20 6a 3b  lem *i;.  int j;
34b0: 0a 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20  ..  if( !db ){. 
34c0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
34d0: 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  _OK;.  }..  if( 
34e0: 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54  db->magic!=SQLIT
34f0: 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 26  E_MAGIC_CLOSED &
3500: 26 20 0a 20 20 20 20 20 20 64 62 2d 3e 6d 61 67  & .      db->mag
3510: 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43  ic!=SQLITE_MAGIC
3520: 5f 4f 50 45 4e 20 26 26 0a 20 20 20 20 20 20 64  _OPEN &&.      d
3530: 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45  b->magic!=SQLITE
3540: 5f 4d 41 47 49 43 5f 42 55 53 59 0a 20 20 29 7b  _MAGIC_BUSY.  ){
3550: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
3560: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a  TE_MISUSE;.  }..
3570: 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72    /* If there ar
3580: 65 20 61 6e 79 20 6f 75 74 73 74 61 6e 64 69 6e  e any outstandin
3590: 67 20 56 4d 73 2c 20 72 65 74 75 72 6e 20 53 51  g VMs, return SQ
35a0: 4c 49 54 45 5f 42 55 53 59 2e 20 2a 2f 0a 20 20  LITE_BUSY. */.  
35b0: 69 66 28 20 64 62 2d 3e 70 56 64 62 65 20 29 7b  if( db->pVdbe ){
35c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
35d0: 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53  r(db, SQLITE_BUS
35e0: 59 2c 20 0a 20 20 20 20 20 20 20 20 22 55 6e 61  Y, .        "Una
35f0: 62 6c 65 20 74 6f 20 63 6c 6f 73 65 20 64 75 65  ble to close due
3600: 20 74 6f 20 75 6e 66 69 6e 61 6c 69 73 65 64 20   to unfinalised 
3610: 73 74 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20  statements");.  
3620: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
3630: 42 55 53 59 3b 0a 20 20 7d 0a 20 20 61 73 73 65  BUSY;.  }.  asse
3640: 72 74 28 20 21 73 71 6c 69 74 65 33 53 61 66 65  rt( !sqlite3Safe
3650: 74 79 43 68 65 63 6b 28 64 62 29 20 29 3b 0a 0a  tyCheck(db) );..
3660: 20 20 2f 2a 20 46 49 58 20 4d 45 3a 20 64 62 2d    /* FIX ME: db-
3670: 3e 6d 61 67 69 63 20 6d 61 79 20 62 65 20 73 65  >magic may be se
3680: 74 20 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49  t to SQLITE_MAGI
3690: 43 5f 43 4c 4f 53 45 44 20 69 66 20 74 68 65 20  C_CLOSED if the 
36a0: 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 63 61  database.  ** ca
36b0: 6e 6e 6f 74 20 62 65 20 6f 70 65 6e 65 64 20 66  nnot be opened f
36c0: 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2e 20  or some reason. 
36d0: 53 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  So this routine 
36e0: 6e 65 65 64 73 20 74 6f 20 72 75 6e 20 69 6e 0a  needs to run in.
36f0: 20 20 2a 2a 20 74 68 61 74 20 63 61 73 65 2e 20    ** that case. 
3700: 42 75 74 20 6d 61 79 62 65 20 74 68 65 72 65 20  But maybe there 
3710: 73 68 6f 75 6c 64 20 62 65 20 61 6e 20 65 78 74  should be an ext
3720: 72 61 20 6d 61 67 69 63 20 76 61 6c 75 65 20 66  ra magic value f
3730: 6f 72 20 74 68 65 0a 20 20 2a 2a 20 22 66 61 69  or the.  ** "fai
3740: 6c 65 64 20 74 6f 20 6f 70 65 6e 22 20 73 74 61  led to open" sta
3750: 74 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64  te..  */.  if( d
3760: 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45  b->magic!=SQLITE
3770: 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 26 26  _MAGIC_CLOSED &&
3780: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e   sqlite3SafetyOn
3790: 28 64 62 29 20 29 7b 0a 20 20 20 20 2f 2a 20 70  (db) ){.    /* p
37a0: 72 69 6e 74 66 28 22 44 49 44 20 4e 4f 54 20 43  rintf("DID NOT C
37b0: 4c 4f 53 45 5c 6e 22 29 3b 20 66 66 6c 75 73 68  LOSE\n"); fflush
37c0: 28 73 74 64 6f 75 74 29 3b 20 2a 2f 0a 20 20 20  (stdout); */.   
37d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
37e0: 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72  RROR;.  }..  for
37f0: 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b  (j=0; j<db->nDb;
3800: 20 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63   j++){.    struc
3810: 74 20 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d  t Db *pDb = &db-
3820: 3e 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28  >aDb[j];.    if(
3830: 20 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20   pDb->pBt ){.   
3840: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
3850: 6c 6f 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a  lose(pDb->pBt);.
3860: 20 20 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d        pDb->pBt =
3870: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20   0;.    }.  }.  
3880: 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65  sqlite3ResetInte
3890: 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30  rnalSchema(db, 0
38a0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d  );.  assert( db-
38b0: 3e 6e 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73  >nDb<=2 );.  ass
38c0: 65 72 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62  ert( db->aDb==db
38d0: 2d 3e 61 44 62 53 74 61 74 69 63 20 29 3b 0a 20  ->aDbStatic );. 
38e0: 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73   for(i=sqliteHas
38f0: 68 46 69 72 73 74 28 26 64 62 2d 3e 61 46 75 6e  hFirst(&db->aFun
3900: 63 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48  c); i; i=sqliteH
3910: 61 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20  ashNext(i)){.   
3920: 20 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c   FuncDef *pFunc,
3930: 20 2a 70 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72   *pNext;.    for
3940: 28 70 46 75 6e 63 20 3d 20 28 46 75 6e 63 44 65  (pFunc = (FuncDe
3950: 66 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 74  f*)sqliteHashDat
3960: 61 28 69 29 3b 20 70 46 75 6e 63 3b 20 70 46 75  a(i); pFunc; pFu
3970: 6e 63 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 20  nc=pNext){.     
3980: 20 70 4e 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e   pNext = pFunc->
3990: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 73 71 6c  pNext;.      sql
39a0: 69 74 65 46 72 65 65 28 70 46 75 6e 63 29 3b 0a  iteFree(pFunc);.
39b0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 66 6f 72      }.  }..  for
39c0: 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72  (i=sqliteHashFir
39d0: 73 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71  st(&db->aCollSeq
39e0: 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61  ); i; i=sqliteHa
39f0: 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20  shNext(i)){.    
3a00: 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d  CollSeq *pColl =
3a10: 20 28 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69   (CollSeq *)sqli
3a20: 74 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20  teHashData(i);. 
3a30: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 43     sqliteFree(pC
3a40: 6f 6c 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  oll);.  }.  sqli
3a50: 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 64 62  te3HashClear(&db
3a60: 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 0a 0a 20 20  ->aCollSeq);..  
3a70: 73 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72  sqlite3HashClear
3a80: 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20  (&db->aFunc);.  
3a90: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c  sqlite3Error(db,
3aa0: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20   SQLITE_OK, 0); 
3ab0: 2f 2a 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61  /* Deallocates a
3ac0: 6e 79 20 63 61 63 68 65 64 20 65 72 72 6f 72 20  ny cached error 
3ad0: 73 74 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66  strings. */.  if
3ae0: 28 20 64 62 2d 3e 70 56 61 6c 75 65 20 29 7b 0a  ( db->pValue ){.
3af0: 20 20 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65      sqlite3Value
3b00: 46 72 65 65 28 64 62 2d 3e 70 56 61 6c 75 65 29  Free(db->pValue)
3b10: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e  ;.  }.  if( db->
3b20: 70 45 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69  pErr ){.    sqli
3b30: 74 65 33 56 61 6c 75 65 46 72 65 65 28 64 62 2d  te3ValueFree(db-
3b40: 3e 70 45 72 72 29 3b 0a 20 20 7d 0a 0a 20 20 64  >pErr);.  }..  d
3b50: 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54  b->magic = SQLIT
3b60: 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 20  E_MAGIC_ERROR;. 
3b70: 20 73 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b   sqliteFree(db);
3b80: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
3b90: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f  _OK;.}../*.** Ro
3ba0: 6c 6c 62 61 63 6b 20 61 6c 6c 20 64 61 74 61 62  llback all datab
3bb0: 61 73 65 20 66 69 6c 65 73 2e 0a 2a 2f 0a 76 6f  ase files..*/.vo
3bc0: 69 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61  id sqlite3Rollba
3bd0: 63 6b 41 6c 6c 28 73 71 6c 69 74 65 20 2a 64 62  ckAll(sqlite *db
3be0: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f  ){.  int i;.  fo
3bf0: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62  r(i=0; i<db->nDb
3c00: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20  ; i++){.    if( 
3c10: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 20 29  db->aDb[i].pBt )
3c20: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42  {.      sqlite3B
3c30: 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d  treeRollback(db-
3c40: 3e 61 44 62 5b 69 5d 2e 70 42 74 29 3b 0a 20 20  >aDb[i].pBt);.  
3c50: 20 20 20 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 69      db->aDb[i].i
3c60: 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 20 20  nTrans = 0;.    
3c70: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 52  }.  }.  sqlite3R
3c80: 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65  esetInternalSche
3c90: 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 2f 2a 20  ma(db, 0);.  /* 
3ca0: 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 49  sqlite3RollbackI
3cb0: 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64  nternalChanges(d
3cc0: 62 29 3b 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  b); */.}../*.** 
3cd0: 52 65 74 75 72 6e 20 61 20 73 74 61 74 69 63 20  Return a static 
3ce0: 73 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 63  string that desc
3cf0: 72 69 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f  ribes the kind o
3d00: 66 20 65 72 72 6f 72 20 73 70 65 63 69 66 69 65  f error specifie
3d10: 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75  d in the.** argu
3d20: 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63  ment..*/.const c
3d30: 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53  har *sqlite3ErrS
3d40: 74 72 28 69 6e 74 20 72 63 29 7b 0a 20 20 63 6f  tr(int rc){.  co
3d50: 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 73  nst char *z;.  s
3d60: 77 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20 20  witch( rc ){.   
3d70: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a   case SQLITE_OK:
3d80: 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22 6e 6f           z = "no
3d90: 74 20 61 6e 20 65 72 72 6f 72 22 3b 20 20 20 20  t an error";    
3da0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3db0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3dc0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52   case SQLITE_ERR
3dd0: 4f 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 53 51  OR:      z = "SQ
3de0: 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72  L logic error or
3df0: 20 6d 69 73 73 69 6e 67 20 64 61 74 61 62 61 73   missing databas
3e00: 65 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  e";   break;.   
3e10: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54   case SQLITE_INT
3e20: 45 52 4e 41 4c 3a 20 20 20 7a 20 3d 20 22 69 6e  ERNAL:   z = "in
3e30: 74 65 72 6e 61 6c 20 53 51 4c 69 74 65 20 69 6d  ternal SQLite im
3e40: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66 6c 61  plementation fla
3e50: 77 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  w";   break;.   
3e60: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52   case SQLITE_PER
3e70: 4d 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61 63  M:       z = "ac
3e80: 63 65 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 20  cess permission 
3e90: 64 65 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20  denied";        
3ea0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3eb0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f   case SQLITE_ABO
3ec0: 52 54 3a 20 20 20 20 20 20 7a 20 3d 20 22 63 61  RT:      z = "ca
3ed0: 6c 6c 62 61 63 6b 20 72 65 71 75 65 73 74 65 64  llback requested
3ee0: 20 71 75 65 72 79 20 61 62 6f 72 74 22 3b 20 20   query abort";  
3ef0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3f00: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53   case SQLITE_BUS
3f10: 59 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61  Y:       z = "da
3f20: 74 61 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64  tabase is locked
3f30: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
3f40: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3f50: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43   case SQLITE_LOC
3f60: 4b 45 44 3a 20 20 20 20 20 7a 20 3d 20 22 64 61  KED:     z = "da
3f70: 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 73 20  tabase table is 
3f80: 6c 6f 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20  locked";        
3f90: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3fa0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d   case SQLITE_NOM
3fb0: 45 4d 3a 20 20 20 20 20 20 7a 20 3d 20 22 6f 75  EM:      z = "ou
3fc0: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 3b 20 20 20  t of memory";   
3fd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3fe0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3ff0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41   case SQLITE_REA
4000: 44 4f 4e 4c 59 3a 20 20 20 7a 20 3d 20 22 61 74  DONLY:   z = "at
4010: 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61  tempt to write a
4020: 20 72 65 61 64 6f 6e 6c 79 20 64 61 74 61 62 61   readonly databa
4030: 73 65 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20  se";  break;.   
4040: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54   case SQLITE_INT
4050: 45 52 52 55 50 54 3a 20 20 7a 20 3d 20 22 69 6e  ERRUPT:  z = "in
4060: 74 65 72 72 75 70 74 65 64 22 3b 20 20 20 20 20  terrupted";     
4070: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4080: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4090: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45   case SQLITE_IOE
40a0: 52 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 64 69  RR:      z = "di
40b0: 73 6b 20 49 2f 4f 20 65 72 72 6f 72 22 3b 20 20  sk I/O error";  
40c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
40d0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
40e0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52   case SQLITE_COR
40f0: 52 55 50 54 3a 20 20 20 20 7a 20 3d 20 22 64 61  RUPT:    z = "da
4100: 74 61 62 61 73 65 20 64 69 73 6b 20 69 6d 61 67  tabase disk imag
4110: 65 20 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22 3b  e is malformed";
4120: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4130: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54   case SQLITE_NOT
4140: 46 4f 55 4e 44 3a 20 20 20 7a 20 3d 20 22 74 61  FOUND:   z = "ta
4150: 62 6c 65 20 6f 72 20 72 65 63 6f 72 64 20 6e 6f  ble or record no
4160: 74 20 66 6f 75 6e 64 22 3b 20 20 20 20 20 20 20  t found";       
4170: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4180: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 55 4c   case SQLITE_FUL
4190: 4c 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61  L:       z = "da
41a0: 74 61 62 61 73 65 20 69 73 20 66 75 6c 6c 22 3b  tabase is full";
41b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
41c0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
41d0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e   case SQLITE_CAN
41e0: 54 4f 50 45 4e 3a 20 20 20 7a 20 3d 20 22 75 6e  TOPEN:   z = "un
41f0: 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74  able to open dat
4200: 61 62 61 73 65 20 66 69 6c 65 22 3b 20 20 20 20  abase file";    
4210: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4220: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 52 4f   case SQLITE_PRO
4230: 54 4f 43 4f 4c 3a 20 20 20 7a 20 3d 20 22 64 61  TOCOL:   z = "da
4240: 74 61 62 61 73 65 20 6c 6f 63 6b 69 6e 67 20 70  tabase locking p
4250: 72 6f 74 6f 63 6f 6c 20 66 61 69 6c 75 72 65 22  rotocol failure"
4260: 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  ;     break;.   
4270: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 4d 50   case SQLITE_EMP
4280: 54 59 3a 20 20 20 20 20 20 7a 20 3d 20 22 74 61  TY:      z = "ta
4290: 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20  ble contains no 
42a0: 64 61 74 61 22 3b 20 20 20 20 20 20 20 20 20 20  data";          
42b0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
42c0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 48   case SQLITE_SCH
42d0: 45 4d 41 3a 20 20 20 20 20 7a 20 3d 20 22 64 61  EMA:     z = "da
42e0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61  tabase schema ha
42f0: 73 20 63 68 61 6e 67 65 64 22 3b 20 20 20 20 20  s changed";     
4300: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4310: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 4f 4f   case SQLITE_TOO
4320: 42 49 47 3a 20 20 20 20 20 7a 20 3d 20 22 74 6f  BIG:     z = "to
4330: 6f 20 6d 75 63 68 20 64 61 74 61 20 66 6f 72 20  o much data for 
4340: 6f 6e 65 20 74 61 62 6c 65 20 72 6f 77 22 3b 20  one table row"; 
4350: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4360: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e   case SQLITE_CON
4370: 53 54 52 41 49 4e 54 3a 20 7a 20 3d 20 22 63 6f  STRAINT: z = "co
4380: 6e 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22  nstraint failed"
4390: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
43a0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
43b0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53   case SQLITE_MIS
43c0: 4d 41 54 43 48 3a 20 20 20 7a 20 3d 20 22 64 61  MATCH:   z = "da
43d0: 74 61 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22  tatype mismatch"
43e0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
43f0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4400: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53   case SQLITE_MIS
4410: 55 53 45 3a 20 20 20 20 20 7a 20 3d 20 22 6c 69  USE:     z = "li
4420: 62 72 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61  brary routine ca
4430: 6c 6c 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75  lled out of sequ
4440: 65 6e 63 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20  ence";break;.   
4450: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c   case SQLITE_NOL
4460: 46 53 3a 20 20 20 20 20 20 7a 20 3d 20 22 6b 65  FS:      z = "ke
4470: 72 6e 65 6c 20 6c 61 63 6b 73 20 6c 61 72 67 65  rnel lacks large
4480: 20 66 69 6c 65 20 73 75 70 70 6f 72 74 22 3b 20   file support"; 
4490: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
44a0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 55 54   case SQLITE_AUT
44b0: 48 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61 75  H:       z = "au
44c0: 74 68 6f 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69  thorization deni
44d0: 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ed";            
44e0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
44f0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52   case SQLITE_FOR
4500: 4d 41 54 3a 20 20 20 20 20 7a 20 3d 20 22 61 75  MAT:     z = "au
4510: 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73 65  xiliary database
4520: 20 66 6f 72 6d 61 74 20 65 72 72 6f 72 22 3b 20   format error"; 
4530: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4540: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e   case SQLITE_RAN
4550: 47 45 3a 20 20 20 20 20 20 7a 20 3d 20 22 62 69  GE:      z = "bi
4560: 6e 64 20 69 6e 64 65 78 20 6f 75 74 20 6f 66 20  nd index out of 
4570: 72 61 6e 67 65 22 3b 20 20 20 20 20 20 20 20 20  range";         
4580: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4590: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54   case SQLITE_NOT
45a0: 41 44 42 3a 20 20 20 20 20 7a 20 3d 20 22 66 69  ADB:     z = "fi
45b0: 6c 65 20 69 73 20 65 6e 63 72 79 70 74 65 64 20  le is encrypted 
45c0: 6f 72 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61  or is not a data
45d0: 62 61 73 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20  base";break;.   
45e0: 20 64 65 66 61 75 6c 74 3a 20 20 20 20 20 20 20   default:       
45f0: 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22 75 6e           z = "un
4600: 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 20 20 20  known error";   
4610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4620: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d        break;.  }
4630: 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a  .  return z;.}..
4640: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
4650: 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20  ne implements a 
4660: 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68  busy callback th
4670: 61 74 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72  at sleeps and tr
4680: 69 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74  ies.** again unt
4690: 69 6c 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c  il a timeout val
46a0: 75 65 20 69 73 20 72 65 61 63 68 65 64 2e 20 20  ue is reached.  
46b0: 54 68 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75  The timeout valu
46c0: 65 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67  e is.** an integ
46d0: 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c  er number of mil
46e0: 6c 69 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64  liseconds passed
46f0: 20 69 6e 20 61 73 20 74 68 65 20 66 69 72 73 74   in as the first
4700: 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f  .** argument..*/
4710: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69  .static int sqli
4720: 74 65 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c  teDefaultBusyCal
4730: 6c 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a 54 69  lback(. void *Ti
4740: 6d 65 6f 75 74 2c 20 20 20 20 20 20 20 20 20 20  meout,          
4750: 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f 75   /* Maximum amou
4760: 6e 74 20 6f 66 20 74 69 6d 65 20 74 6f 20 77 61  nt of time to wa
4770: 69 74 20 2a 2f 0a 20 69 6e 74 20 63 6f 75 6e 74  it */. int count
4780: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4790: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d  /* Number of tim
47a0: 65 73 20 74 61 62 6c 65 20 68 61 73 20 62 65 65  es table has bee
47b0: 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a 23 69 66  n busy */.){.#if
47c0: 20 53 51 4c 49 54 45 5f 4d 49 4e 5f 53 4c 45 45   SQLITE_MIN_SLEE
47d0: 50 5f 4d 53 3d 3d 31 0a 20 20 73 74 61 74 69 63  P_MS==1.  static
47e0: 20 63 6f 6e 73 74 20 63 68 61 72 20 64 65 6c 61   const char dela
47f0: 79 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 31 2c  ys[] =.     { 1,
4800: 20 32 2c 20 35 2c 20 31 30 2c 20 31 35 2c 20 32   2, 5, 10, 15, 2
4810: 30 2c 20 32 35 2c 20 32 35 2c 20 20 32 35 2c 20  0, 25, 25,  25, 
4820: 20 35 30 2c 20 20 35 30 2c 20 20 35 30 2c 20 31   50,  50,  50, 1
4830: 30 30 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f  00};.  static co
4840: 6e 73 74 20 73 68 6f 72 74 20 69 6e 74 20 74 6f  nst short int to
4850: 74 61 6c 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20  tals[] =.     { 
4860: 30 2c 20 31 2c 20 33 2c 20 20 38 2c 20 31 38 2c  0, 1, 3,  8, 18,
4870: 20 33 33 2c 20 35 33 2c 20 37 38 2c 20 31 30 33   33, 53, 78, 103
4880: 2c 20 31 32 38 2c 20 31 37 38 2c 20 32 32 38 2c  , 128, 178, 228,
4890: 20 32 38 37 7d 3b 0a 23 20 64 65 66 69 6e 65 20   287};.# define 
48a0: 4e 44 45 4c 41 59 20 28 73 69 7a 65 6f 66 28 64  NDELAY (sizeof(d
48b0: 65 6c 61 79 73 29 2f 73 69 7a 65 6f 66 28 64 65  elays)/sizeof(de
48c0: 6c 61 79 73 5b 30 5d 29 29 0a 20 20 69 6e 74 20  lays[0])).  int 
48d0: 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54  timeout = (int)T
48e0: 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 64 65  imeout;.  int de
48f0: 6c 61 79 2c 20 70 72 69 6f 72 3b 0a 0a 20 20 69  lay, prior;..  i
4900: 66 28 20 63 6f 75 6e 74 20 3c 3d 20 4e 44 45 4c  f( count <= NDEL
4910: 41 59 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20  AY ){.    delay 
4920: 3d 20 64 65 6c 61 79 73 5b 63 6f 75 6e 74 2d 31  = delays[count-1
4930: 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74  ];.    prior = t
4940: 6f 74 61 6c 73 5b 63 6f 75 6e 74 2d 31 5d 3b 0a  otals[count-1];.
4950: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 65 6c    }else{.    del
4960: 61 79 20 3d 20 64 65 6c 61 79 73 5b 4e 44 45 4c  ay = delays[NDEL
4970: 41 59 2d 31 5d 3b 0a 20 20 20 20 70 72 69 6f 72  AY-1];.    prior
4980: 20 3d 20 74 6f 74 61 6c 73 5b 4e 44 45 4c 41 59   = totals[NDELAY
4990: 2d 31 5d 20 2b 20 64 65 6c 61 79 2a 28 63 6f 75  -1] + delay*(cou
49a0: 6e 74 2d 4e 44 45 4c 41 59 2d 31 29 3b 0a 20 20  nt-NDELAY-1);.  
49b0: 7d 0a 20 20 69 66 28 20 70 72 69 6f 72 20 2b 20  }.  if( prior + 
49c0: 64 65 6c 61 79 20 3e 20 74 69 6d 65 6f 75 74 20  delay > timeout 
49d0: 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 74  ){.    delay = t
49e0: 69 6d 65 6f 75 74 20 2d 20 70 72 69 6f 72 3b 0a  imeout - prior;.
49f0: 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c 3d 30      if( delay<=0
4a00: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d   ) return 0;.  }
4a10: 0a 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65  .  sqlite3OsSlee
4a20: 70 28 64 65 6c 61 79 29 3b 0a 20 20 72 65 74 75  p(delay);.  retu
4a30: 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69 6e  rn 1;.#else.  in
4a40: 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74  t timeout = (int
4a50: 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20  )Timeout;.  if( 
4a60: 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e  (count+1)*1000 >
4a70: 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20   timeout ){.    
4a80: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
4a90: 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 31  sqlite3OsSleep(1
4aa0: 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31  000);.  return 1
4ab0: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a  ;.#endif.}../*.*
4ac0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
4ad0: 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61 6c  ets the busy cal
4ae0: 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c  lback for an Sql
4af0: 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20  ite database to 
4b00: 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c  the.** given cal
4b10: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77  lback function w
4b20: 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72  ith the given ar
4b30: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73  gument..*/.int s
4b40: 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64  qlite3_busy_hand
4b50: 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33 20 2a  ler(.  sqlite3 *
4b60: 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73  db,.  int (*xBus
4b70: 79 29 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a 20  y)(void*,int),. 
4b80: 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20   void *pArg.){. 
4b90: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72   db->busyHandler
4ba0: 2e 78 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a  .xFunc = xBusy;.
4bb0: 20 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65    db->busyHandle
4bc0: 72 2e 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20  r.pArg = pArg;. 
4bd0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
4be0: 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51  K;.}..#ifndef SQ
4bf0: 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45  LITE_OMIT_PROGRE
4c00: 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a  SS_CALLBACK./*.*
4c10: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
4c20: 65 74 73 20 74 68 65 20 70 72 6f 67 72 65 73 73  ets the progress
4c30: 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e   callback for an
4c40: 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65   Sqlite database
4c50: 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e   to the.** given
4c60: 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69   callback functi
4c70: 6f 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65  on with the give
4c80: 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20  n argument. The 
4c90: 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63  progress callbac
4ca0: 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76  k will.** be inv
4cb0: 6f 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20  oked every nOps 
4cc0: 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64  opcodes..*/.void
4cd0: 20 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73   sqlite3_progres
4ce0: 73 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c  s_handler(.  sql
4cf0: 69 74 65 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20  ite *db, .  int 
4d00: 6e 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50  nOps,.  int (*xP
4d10: 72 6f 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c  rogress)(void*),
4d20: 20 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29   .  void *pArg.)
4d30: 7b 0a 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 29  {.  if( nOps>0 )
4d40: 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 72  {.    db->xProgr
4d50: 65 73 73 20 3d 20 78 50 72 6f 67 72 65 73 73 3b  ess = xProgress;
4d60: 0a 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65  .    db->nProgre
4d70: 73 73 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a 20 20  ssOps = nOps;.  
4d80: 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 41    db->pProgressA
4d90: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d 65 6c  rg = pArg;.  }el
4da0: 73 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f  se{.    db->xPro
4db0: 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 20 64  gress = 0;.    d
4dc0: 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20  b->nProgressOps 
4dd0: 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72  = 0;.    db->pPr
4de0: 6f 67 72 65 73 73 41 72 67 20 3d 20 30 3b 0a 20  ogressArg = 0;. 
4df0: 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a   }.}.#endif.../*
4e00: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
4e10: 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65 66 61   installs a defa
4e20: 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c 65 72  ult busy handler
4e30: 20 74 68 61 74 20 77 61 69 74 73 20 66 6f 72 20   that waits for 
4e40: 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 65 64  the.** specified
4e50: 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69   number of milli
4e60: 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20 72  seconds before r
4e70: 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f 0a 69  eturning 0..*/.i
4e80: 6e 74 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f  nt sqlite3_busy_
4e90: 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65 33 20  timeout(sqlite3 
4ea0: 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20 20  *db, int ms){.  
4eb0: 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20 20  if( ms>0 ){.    
4ec0: 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e  sqlite3_busy_han
4ed0: 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44  dler(db, sqliteD
4ee0: 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61  efaultBusyCallba
4ef0: 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a  ck, (void*)ms);.
4f00: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
4f10: 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65  ite3_busy_handle
4f20: 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d  r(db, 0, 0);.  }
4f30: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
4f40: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61  _OK;.}../*.** Ca
4f50: 75 73 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20  use any pending 
4f60: 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f  operation to sto
4f70: 70 20 61 74 20 69 74 73 20 65 61 72 6c 69 65 73  p at its earlies
4f80: 74 20 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a  t opportunity..*
4f90: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69  /.void sqlite3_i
4fa0: 6e 74 65 72 72 75 70 74 28 73 71 6c 69 74 65 20  nterrupt(sqlite 
4fb0: 2a 64 62 29 7b 0a 20 20 64 62 2d 3e 66 6c 61 67  *db){.  db->flag
4fc0: 73 20 7c 3d 20 53 51 4c 49 54 45 5f 49 6e 74 65  s |= SQLITE_Inte
4fd0: 72 72 75 70 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rrupt;.}../*.** 
4fe0: 57 69 6e 64 6f 77 73 20 73 79 73 74 65 6d 73 20  Windows systems 
4ff0: 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74 68 69 73  should call this
5000: 20 72 6f 75 74 69 6e 65 20 74 6f 20 66 72 65 65   routine to free
5010: 20 6d 65 6d 6f 72 79 20 74 68 61 74 0a 2a 2a 20   memory that.** 
5020: 69 73 20 72 65 74 75 72 6e 65 64 20 69 6e 20 74  is returned in t
5030: 68 65 20 69 6e 20 74 68 65 20 65 72 72 6d 73 67  he in the errmsg
5040: 20 70 61 72 61 6d 65 74 65 72 20 6f 66 20 73 71   parameter of sq
5050: 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 77 68 65  lite3_open() whe
5060: 6e 0a 2a 2a 20 53 51 4c 69 74 65 20 69 73 20 61  n.** SQLite is a
5070: 20 44 4c 4c 2e 20 20 46 6f 72 20 73 6f 6d 65 20   DLL.  For some 
5080: 72 65 61 73 6f 6e 2c 20 69 74 20 64 6f 65 73 20  reason, it does 
5090: 6e 6f 74 20 77 6f 72 6b 20 74 6f 20 63 61 6c 6c  not work to call
50a0: 20 66 72 65 65 28 29 0a 2a 2a 20 64 69 72 65 63   free().** direc
50b0: 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20  tly..**.** Note 
50c0: 74 68 61 74 20 77 65 20 6e 65 65 64 20 74 6f 20  that we need to 
50d0: 63 61 6c 6c 20 66 72 65 65 28 29 20 6e 6f 74 20  call free() not 
50e0: 73 71 6c 69 74 65 46 72 65 65 28 29 20 68 65 72  sqliteFree() her
50f0: 65 2c 20 73 69 6e 63 65 20 65 76 65 72 79 0a 2a  e, since every.*
5100: 2a 20 73 74 72 69 6e 67 20 74 68 61 74 20 69 73  * string that is
5110: 20 65 78 70 6f 72 74 65 64 20 66 72 6f 6d 20 53   exported from S
5120: 51 4c 69 74 65 20 73 68 6f 75 6c 64 20 68 61 76  QLite should hav
5130: 65 20 61 6c 72 65 61 64 79 20 70 61 73 73 65 64  e already passed
5140: 20 74 68 72 6f 75 67 68 0a 2a 2a 20 73 71 6c 69   through.** sqli
5150: 74 65 33 53 74 72 52 65 61 6c 6c 6f 63 28 29 2e  te3StrRealloc().
5160: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
5170: 5f 66 72 65 65 28 63 68 61 72 20 2a 70 29 7b 20  _free(char *p){ 
5180: 66 72 65 65 28 70 29 3b 20 7d 0a 0a 2f 2a 0a 2a  free(p); }../*.*
5190: 2a 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 65  * Create new use
51a0: 72 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a  r functions..*/.
51b0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61  int sqlite3_crea
51c0: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 20 73  te_function(.  s
51d0: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f  qlite3 *db,.  co
51e0: 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 74  nst char *zFunct
51f0: 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e  ionName,.  int n
5200: 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a  Arg,.  int enc,.
5210: 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74    void *pUserDat
5220: 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e  a,.  void (*xFun
5230: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  c)(sqlite3_conte
5240: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f  xt*,int,sqlite3_
5250: 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69  value **),.  voi
5260: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74  d (*xStep)(sqlit
5270: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c  e3_context*,int,
5280: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
5290: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e  ),.  void (*xFin
52a0: 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  al)(sqlite3_cont
52b0: 65 78 74 2a 29 0a 29 7b 0a 20 20 46 75 6e 63 44  ext*).){.  FuncD
52c0: 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e 61  ef *p;.  int nNa
52d0: 6d 65 3b 0a 0a 20 20 69 66 28 20 28 64 62 3d 3d  me;..  if( (db==
52e0: 30 20 7c 7c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61  0 || zFunctionNa
52f0: 6d 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33  me==0 || sqlite3
5300: 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 29  SafetyCheck(db))
5310: 20 7c 7c 0a 20 20 20 20 20 20 28 78 46 75 6e 63   ||.      (xFunc
5320: 20 26 26 20 28 78 46 69 6e 61 6c 20 7c 7c 20 78   && (xFinal || x
5330: 53 74 65 70 29 29 20 7c 7c 20 0a 20 20 20 20 20  Step)) || .     
5340: 20 28 21 78 46 75 6e 63 20 26 26 20 28 78 46 69   (!xFunc && (xFi
5350: 6e 61 6c 20 26 26 20 21 78 53 74 65 70 29 29 20  nal && !xStep)) 
5360: 7c 7c 0a 20 20 20 20 20 20 28 21 78 46 75 6e 63  ||.      (!xFunc
5370: 20 26 26 20 28 21 78 46 69 6e 61 6c 20 26 26 20   && (!xFinal && 
5380: 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 20  xStep)) ||.     
5390: 20 28 6e 41 72 67 3c 2d 31 20 7c 7c 20 6e 41 72   (nArg<-1 || nAr
53a0: 67 3e 31 32 37 29 20 7c 7c 0a 20 20 20 20 20 20  g>127) ||.      
53b0: 28 32 35 35 3c 28 6e 4e 61 6d 65 20 3d 20 73 74  (255<(nName = st
53c0: 72 6c 65 6e 28 7a 46 75 6e 63 74 69 6f 6e 4e 61  rlen(zFunctionNa
53d0: 6d 65 29 29 29 20 29 7b 0a 20 20 20 20 72 65 74  me))) ){.    ret
53e0: 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  urn SQLITE_ERROR
53f0: 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 49 66  ;.  }.  .  /* If
5400: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73   SQLITE_UTF16 is
5410: 20 73 70 65 63 69 66 69 65 64 20 61 73 20 74 68   specified as th
5420: 65 20 65 6e 63 6f 64 69 6e 67 20 74 79 70 65 2c  e encoding type,
5430: 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 69 73 0a   transform this.
5440: 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66 20 53    ** to one of S
5450: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72  QLITE_UTF16LE or
5460: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20   SQLITE_UTF16BE 
5470: 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 53  using the.  ** S
5480: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56  QLITE_UTF16NATIV
5490: 45 20 6d 61 63 72 6f 2e 20 53 51 4c 49 54 45 5f  E macro. SQLITE_
54a0: 55 54 46 31 36 20 69 73 20 6e 6f 74 20 75 73 65  UTF16 is not use
54b0: 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 20  d internally..  
54c0: 2a 2a 0a 20 20 2a 2a 20 49 66 20 53 51 4c 49 54  **.  ** If SQLIT
54d0: 45 5f 41 4e 59 20 69 73 20 73 70 65 63 69 66 69  E_ANY is specifi
54e0: 65 64 2c 20 61 64 64 20 74 68 72 65 65 20 76 65  ed, add three ve
54f0: 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 66 75  rsions of the fu
5500: 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 74  nction.  ** to t
5510: 68 65 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 20  he hash table.. 
5520: 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63 3d 3d 53   */.  if( enc==S
5530: 51 4c 49 54 45 5f 55 54 46 31 36 20 29 7b 0a 20  QLITE_UTF16 ){. 
5540: 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f     enc = SQLITE_
5550: 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d  UTF16NATIVE;.  }
5560: 65 6c 73 65 20 69 66 28 20 65 6e 63 3d 3d 53 51  else if( enc==SQ
5570: 4c 49 54 45 5f 41 4e 59 20 29 7b 0a 20 20 20 20  LITE_ANY ){.    
5580: 69 6e 74 20 72 63 3b 0a 20 20 20 20 72 63 20 3d  int rc;.    rc =
5590: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f   sqlite3_create_
55a0: 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75  function(db, zFu
55b0: 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67  nctionName, nArg
55c0: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 0a 20  , SQLITE_UTF8,. 
55d0: 20 20 20 20 20 20 20 20 70 55 73 65 72 44 61 74          pUserDat
55e0: 61 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c  a, xFunc, xStep,
55f0: 20 78 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 66   xFinal);.    if
5600: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
5610: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20  ) return rc;.   
5620: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72   rc = sqlite3_cr
5630: 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62  eate_function(db
5640: 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c  , zFunctionName,
5650: 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54   nArg, SQLITE_UT
5660: 46 31 36 4c 45 2c 0a 20 20 20 20 20 20 20 20 70  F16LE,.        p
5670: 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c  UserData, xFunc,
5680: 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b   xStep, xFinal);
5690: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c  .    if( rc!=SQL
56a0: 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20  ITE_OK ) return 
56b0: 72 63 3b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51  rc;.    enc = SQ
56c0: 4c 49 54 45 5f 55 54 46 31 36 42 45 3b 0a 20 20  LITE_UTF16BE;.  
56d0: 7d 0a 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33  }..  p = sqlite3
56e0: 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c  FindFunction(db,
56f0: 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20   zFunctionName, 
5700: 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63  nName, nArg, enc
5710: 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30  , 1);.  if( p==0
5720: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45   ) return SQLITE
5730: 5f 4e 4f 4d 45 4d 3b 0a 20 20 70 2d 3e 78 46 75  _NOMEM;.  p->xFu
5740: 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 2d  nc = xFunc;.  p-
5750: 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b 0a  >xStep = xStep;.
5760: 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d    p->xFinalize =
5770: 20 78 46 69 6e 61 6c 3b 0a 20 20 70 2d 3e 70 55   xFinal;.  p->pU
5780: 73 65 72 44 61 74 61 20 3d 20 70 55 73 65 72 44  serData = pUserD
5790: 61 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  ata;.  return SQ
57a0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 73  LITE_OK;.}.int s
57b0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75  qlite3_create_fu
57c0: 6e 63 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69  nction16(.  sqli
57d0: 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74  te3 *db,.  const
57e0: 20 76 6f 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e   void *zFunction
57f0: 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67  Name,.  int nArg
5800: 2c 0a 20 20 69 6e 74 20 65 54 65 78 74 52 65 70  ,.  int eTextRep
5810: 2c 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44  ,.  void *pUserD
5820: 61 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46  ata,.  void (*xF
5830: 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e  unc)(sqlite3_con
5840: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65  text*,int,sqlite
5850: 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f  3_value**),.  vo
5860: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69  id (*xStep)(sqli
5870: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74  te3_context*,int
5880: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a  ,sqlite3_value**
5890: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e  ),.  void (*xFin
58a0: 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  al)(sqlite3_cont
58b0: 65 78 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72  ext*).){.  int r
58c0: 63 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20  c;.  char const 
58d0: 2a 7a 46 75 6e 63 38 3b 0a 0a 20 20 73 71 6c 69  *zFunc8;..  sqli
58e0: 74 65 33 5f 76 61 6c 75 65 20 2a 70 54 6d 70 20  te3_value *pTmp 
58f0: 3d 20 73 71 6c 69 74 65 33 47 65 74 54 72 61 6e  = sqlite3GetTran
5900: 73 69 65 6e 74 56 61 6c 75 65 28 64 62 29 3b 0a  sientValue(db);.
5910: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65    sqlite3ValueSe
5920: 74 53 74 72 28 70 54 6d 70 2c 20 2d 31 2c 20 7a  tStr(pTmp, -1, z
5930: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 53 51  FunctionName, SQ
5940: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45  LITE_UTF16NATIVE
5950: 2c 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b  ,SQLITE_STATIC);
5960: 0a 20 20 7a 46 75 6e 63 38 20 3d 20 73 71 6c 69  .  zFunc8 = sqli
5970: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 54 6d  te3ValueText(pTm
5980: 70 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b  p, SQLITE_UTF8);
5990: 0a 0a 20 20 69 66 28 20 21 7a 46 75 6e 63 38 20  ..  if( !zFunc8 
59a0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
59b0: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a  LITE_NOMEM;.  }.
59c0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63    rc = sqlite3_c
59d0: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64  reate_function(d
59e0: 62 2c 20 7a 46 75 6e 63 38 2c 20 6e 41 72 67 2c  b, zFunc8, nArg,
59f0: 20 65 54 65 78 74 52 65 70 2c 20 0a 20 20 20 20   eTextRep, .    
5a00: 20 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75    pUserData, xFu
5a10: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61  nc, xStep, xFina
5a20: 6c 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  l);.  return rc;
5a30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74  .}../*.** Regist
5a40: 65 72 20 61 20 74 72 61 63 65 20 66 75 6e 63 74  er a trace funct
5a50: 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66  ion.  The pArg f
5a60: 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73  rom the previous
5a70: 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 74 72  ly registered tr
5a80: 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e  ace.** is return
5a90: 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55  ed.  .**.** A NU
5aa0: 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f  LL trace functio
5ab0: 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f 20  n means that no 
5ac0: 74 72 61 63 69 6e 67 20 69 73 20 65 78 65 63 75  tracing is execu
5ad0: 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c  tes.  A non-NULL
5ae0: 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 61 20 70  .** trace is a p
5af0: 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63  ointer to a func
5b00: 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76  tion that is inv
5b10: 6f 6b 65 64 20 61 74 20 74 68 65 20 73 74 61 72  oked at the star
5b20: 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 73 71 6c  t of each.** sql
5b30: 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a  ite3_exec()..*/.
5b40: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 74 72  void *sqlite3_tr
5b50: 61 63 65 28 73 71 6c 69 74 65 20 2a 64 62 2c 20  ace(sqlite *db, 
5b60: 76 6f 69 64 20 28 2a 78 54 72 61 63 65 29 28 76  void (*xTrace)(v
5b70: 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a  oid*,const char*
5b80: 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a  ), void *pArg){.
5b90: 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64    void *pOld = d
5ba0: 62 2d 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20  b->pTraceArg;.  
5bb0: 64 62 2d 3e 78 54 72 61 63 65 20 3d 20 78 54 72  db->xTrace = xTr
5bc0: 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63  ace;.  db->pTrac
5bd0: 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72  eArg = pArg;.  r
5be0: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f  eturn pOld;.}../
5bf0: 2a 2a 2a 20 45 58 50 45 52 49 4d 45 4e 54 41 4c  *** EXPERIMENTAL
5c00: 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 67 69 73   ***.**.** Regis
5c10: 74 65 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 74  ter a function t
5c20: 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 77 68 65  o be invoked whe
5c30: 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  n a transaction 
5c40: 63 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a 20 49 66 20  comments..** If 
5c50: 65 69 74 68 65 72 20 66 75 6e 63 74 69 6f 6e 20  either function 
5c60: 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f  returns non-zero
5c70: 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6d 6d 69  , then the commi
5c80: 74 20 62 65 63 6f 6d 65 73 20 61 0a 2a 2a 20 72  t becomes a.** r
5c90: 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64  ollback..*/.void
5ca0: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6d 6d 69 74   *sqlite3_commit
5cb0: 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 20  _hook(.  sqlite 
5cc0: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
5cd0: 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65     /* Attach the
5ce0: 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61   hook to this da
5cf0: 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20  tabase */.  int 
5d00: 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69  (*xCallback)(voi
5d10: 64 2a 29 2c 20 20 2f 2a 20 46 75 6e 63 74 69 6f  d*),  /* Functio
5d20: 6e 20 74 6f 20 69 6e 76 6f 6b 65 20 6f 6e 20 65  n to invoke on e
5d30: 61 63 68 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20  ach commit */.  
5d40: 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 20  void *pArg      
5d50: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67            /* Arg
5d60: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e  ument to the fun
5d70: 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f  ction */.){.  vo
5d80: 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e 70  id *pOld = db->p
5d90: 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 20 64 62 2d  CommitArg;.  db-
5da0: 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b  >xCommitCallback
5db0: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20   = xCallback;.  
5dc0: 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 20 3d  db->pCommitArg =
5dd0: 20 70 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20   pArg;.  return 
5de0: 70 4f 6c 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  pOld;.}.../*.** 
5df0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
5e00: 63 61 6c 6c 65 64 20 74 6f 20 63 72 65 61 74 65  called to create
5e10: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f   a connection to
5e20: 20 61 20 64 61 74 61 62 61 73 65 20 42 54 72 65   a database BTre
5e30: 65 0a 2a 2a 20 64 72 69 76 65 72 2e 20 20 49 66  e.** driver.  If
5e40: 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68   zFilename is th
5e50: 65 20 6e 61 6d 65 20 6f 66 20 61 20 66 69 6c 65  e name of a file
5e60: 2c 20 74 68 65 6e 20 74 68 61 74 20 66 69 6c 65  , then that file
5e70: 20 69 73 0a 2a 2a 20 6f 70 65 6e 65 64 20 61 6e   is.** opened an
5e80: 64 20 75 73 65 64 2e 20 20 49 66 20 7a 46 69 6c  d used.  If zFil
5e90: 65 6e 61 6d 65 20 69 73 20 74 68 65 20 6d 61 67  ename is the mag
5ea0: 69 63 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f 72 79  ic name ":memory
5eb0: 3a 22 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 64  :" then.** the d
5ec0: 61 74 61 62 61 73 65 20 69 73 20 73 74 6f 72 65  atabase is store
5ed0: 64 20 69 6e 20 6d 65 6d 6f 72 79 20 28 61 6e 64  d in memory (and
5ee0: 20 69 73 20 74 68 75 73 20 66 6f 72 67 6f 74 74   is thus forgott
5ef0: 65 6e 20 61 73 20 73 6f 6f 6e 20 61 73 0a 2a 2a  en as soon as.**
5f00: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20   the connection 
5f10: 69 73 20 63 6c 6f 73 65 64 2e 29 20 20 49 66 20  is closed.)  If 
5f20: 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 4c  zFilename is NUL
5f30: 4c 20 74 68 65 6e 20 74 68 65 20 64 61 74 61 62  L then the datab
5f40: 61 73 65 0a 2a 2a 20 69 73 20 66 6f 72 20 74 65  ase.** is for te
5f50: 6d 70 6f 72 61 72 79 20 75 73 65 20 6f 6e 6c 79  mporary use only
5f60: 20 61 6e 64 20 69 73 20 64 65 6c 65 74 65 64 20   and is deleted 
5f70: 61 73 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 63  as soon as the c
5f80: 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 69 73 20  onnection.** is 
5f90: 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 20  closed..**.** A 
5fa0: 74 65 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61  temporary databa
5fb0: 73 65 20 63 61 6e 20 62 65 20 65 69 74 68 65 72  se can be either
5fc0: 20 61 20 64 69 73 6b 20 66 69 6c 65 20 28 74 68   a disk file (th
5fd0: 61 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61  at is automatica
5fe0: 6c 6c 79 0a 2a 2a 20 64 65 6c 65 74 65 64 20 77  lly.** deleted w
5ff0: 68 65 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20  hen the file is 
6000: 63 6c 6f 73 65 64 29 20 6f 72 20 61 20 73 65 74  closed) or a set
6010: 20 6f 66 20 72 65 64 2d 62 6c 61 63 6b 20 74 72   of red-black tr
6020: 65 65 73 20 68 65 6c 64 20 69 6e 20 6d 65 6d 6f  ees held in memo
6030: 72 79 2c 0a 2a 2a 20 64 65 70 65 6e 64 69 6e 67  ry,.** depending
6040: 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 73 20 6f   on the values o
6050: 66 20 74 68 65 20 54 45 4d 50 5f 53 54 4f 52 45  f the TEMP_STORE
6060: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6d 61   compile-time ma
6070: 63 72 6f 20 61 6e 64 20 74 68 65 0a 2a 2a 20 64  cro and the.** d
6080: 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 76 61  b->temp_store va
6090: 72 69 61 62 6c 65 2c 20 61 63 63 6f 72 64 69 6e  riable, accordin
60a0: 67 20 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69  g to the followi
60b0: 6e 67 20 63 68 61 72 74 3a 0a 2a 2a 0a 2a 2a 20  ng chart:.**.** 
60c0: 20 20 20 20 20 20 54 45 4d 50 5f 53 54 4f 52 45        TEMP_STORE
60d0: 20 20 20 20 20 64 62 2d 3e 74 65 6d 70 5f 73 74       db->temp_st
60e0: 6f 72 65 20 20 20 20 20 4c 6f 63 61 74 69 6f 6e  ore     Location
60f0: 20 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 64 61   of temporary da
6100: 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 20 20 20  tabase.**       
6110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d  ----------     -
6120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20  -------------   
6130: 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d    --------------
6140: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6150: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 30 20  .**           0 
6160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e                an
6170: 79 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69  y             fi
6180: 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  le.**           
6190: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1               
61a0: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20   1              
61b0: 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20  file.**         
61c0: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20    1             
61d0: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20     2            
61e0: 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20    memory.**     
61f0: 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20        1         
6200: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20         0        
6210: 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20        file.**   
6220: 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20          2       
6230: 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20           1      
6240: 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20          file.** 
6250: 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20            2     
6260: 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20             2    
6270: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79            memory
6280: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 32 20  .**           2 
6290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30                 0
62a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65                me
62b0: 6d 6f 72 79 0a 2a 2a 20 20 20 20 20 20 20 20 20  mory.**         
62c0: 20 20 33 20 20 20 20 20 20 20 20 20 20 20 20 20    3             
62d0: 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 20    any           
62e0: 20 20 6d 65 6d 6f 72 79 0a 2a 2f 0a 69 6e 74 20    memory.*/.int 
62f0: 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74  sqlite3BtreeFact
6300: 6f 72 79 28 0a 20 20 63 6f 6e 73 74 20 73 71 6c  ory(.  const sql
6310: 69 74 65 20 2a 64 62 2c 09 20 20 20 20 2f 2a 20  ite *db,.    /* 
6320: 4d 61 69 6e 20 64 61 74 61 62 61 73 65 20 77 68  Main database wh
6330: 65 6e 20 6f 70 65 6e 69 6e 67 20 61 75 78 20 6f  en opening aux o
6340: 74 68 65 72 77 69 73 65 20 30 20 2a 2f 0a 20 20  therwise 0 */.  
6350: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c  const char *zFil
6360: 65 6e 61 6d 65 2c 20 20 20 20 2f 2a 20 4e 61 6d  ename,    /* Nam
6370: 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f  e of the file co
6380: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 72  ntaining the BTr
6390: 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20  ee database */. 
63a0: 20 69 6e 74 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c   int omitJournal
63b0: 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 66  ,          /* if
63c0: 20 54 52 55 45 20 74 68 65 6e 20 64 6f 20 6e 6f   TRUE then do no
63d0: 74 20 6a 6f 75 72 6e 61 6c 20 74 68 69 73 20 66  t journal this f
63e0: 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 61  ile */.  int nCa
63f0: 63 68 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  che,            
6400: 20 20 20 2f 2a 20 48 6f 77 20 6d 61 6e 79 20 70     /* How many p
6410: 61 67 65 73 20 69 6e 20 74 68 65 20 70 61 67 65  ages in the page
6420: 20 63 61 63 68 65 20 2a 2f 0a 20 20 42 74 72 65   cache */.  Btre
6430: 65 20 2a 2a 70 70 42 74 72 65 65 20 20 20 20 20  e **ppBtree     
6440: 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72        /* Pointer
6450: 20 74 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62   to new Btree ob
6460: 6a 65 63 74 20 77 72 69 74 74 65 6e 20 68 65 72  ject written her
6470: 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 62 74  e */.){.  int bt
6480: 72 65 65 5f 66 6c 61 67 73 20 3d 20 30 3b 0a 20  ree_flags = 0;. 
6490: 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 75   int rc;.  int u
64a0: 73 65 4d 65 6d 20 3d 20 30 3b 0a 20 20 0a 20 20  seMem = 0;.  .  
64b0: 61 73 73 65 72 74 28 20 70 70 42 74 72 65 65 20  assert( ppBtree 
64c0: 21 3d 20 30 29 3b 0a 20 20 69 66 28 20 6f 6d 69  != 0);.  if( omi
64d0: 74 4a 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20  tJournal ){.    
64e0: 62 74 72 65 65 5f 66 6c 61 67 73 20 7c 3d 20 42  btree_flags |= B
64f0: 54 52 45 45 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41  TREE_OMIT_JOURNA
6500: 4c 3b 0a 20 20 7d 0a 20 20 69 66 28 20 7a 46 69  L;.  }.  if( zFi
6510: 6c 65 6e 61 6d 65 3d 3d 30 20 29 7b 0a 23 69 66  lename==0 ){.#if
6520: 6e 64 65 66 20 54 45 4d 50 5f 53 54 4f 52 45 0a  ndef TEMP_STORE.
6530: 23 20 64 65 66 69 6e 65 20 54 45 4d 50 5f 53 54  # define TEMP_ST
6540: 4f 52 45 20 32 0a 23 65 6e 64 69 66 0a 23 69 66  ORE 2.#endif.#if
6550: 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 30 0a 20   TEMP_STORE==0. 
6560: 20 20 20 75 73 65 4d 65 6d 20 3d 20 30 3b 0a 23     useMem = 0;.#
6570: 65 6e 64 69 66 0a 23 69 66 20 54 45 4d 50 5f 53  endif.#if TEMP_S
6580: 54 4f 52 45 3d 3d 31 0a 20 20 20 20 75 73 65 4d  TORE==1.    useM
6590: 65 6d 20 3d 20 64 62 2d 3e 74 65 6d 70 5f 73 74  em = db->temp_st
65a0: 6f 72 65 3d 3d 32 3b 0a 23 65 6e 64 69 66 0a 23  ore==2;.#endif.#
65b0: 69 66 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 32  if TEMP_STORE==2
65c0: 0a 20 20 20 20 75 73 65 4d 65 6d 20 3d 20 64 62  .    useMem = db
65d0: 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 21 3d 31 3b  ->temp_store!=1;
65e0: 0a 23 65 6e 64 69 66 0a 23 69 66 20 54 45 4d 50  .#endif.#if TEMP
65f0: 5f 53 54 4f 52 45 3d 3d 33 0a 20 20 20 20 75 73  _STORE==3.    us
6600: 65 4d 65 6d 20 3d 20 31 3b 0a 23 65 6e 64 69 66  eMem = 1;.#endif
6610: 0a 20 20 7d 0a 20 20 69 66 28 20 28 7a 46 69 6c  .  }.  if( (zFil
6620: 65 6e 61 6d 65 20 26 26 20 73 74 72 63 6d 70 28  ename && strcmp(
6630: 7a 46 69 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d  zFilename, ":mem
6640: 6f 72 79 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20  ory:")==0).     
6650: 20 20 20 20 7c 7c 20 28 7a 46 69 6c 65 6e 61 6d      || (zFilenam
6660: 65 3d 3d 30 20 26 26 20 75 73 65 4d 65 6d 29 20  e==0 && useMem) 
6670: 29 7b 0a 20 20 20 20 62 74 72 65 65 5f 66 6c 61  ){.    btree_fla
6680: 67 73 20 7c 3d 20 42 54 52 45 45 5f 4d 45 4d 4f  gs |= BTREE_MEMO
6690: 52 59 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20  RY;.  }..  rc = 
66a0: 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 65 6e  sqlite3BtreeOpen
66b0: 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 70 42 74  (zFilename, ppBt
66c0: 72 65 65 2c 20 62 74 72 65 65 5f 66 6c 61 67 73  ree, btree_flags
66d0: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  );.  if( rc==SQL
66e0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71  ITE_OK ){.    sq
66f0: 6c 69 74 65 33 42 74 72 65 65 53 65 74 42 75 73  lite3BtreeSetBus
6700: 79 48 61 6e 64 6c 65 72 28 2a 70 70 42 74 72 65  yHandler(*ppBtre
6710: 65 2c 20 28 76 6f 69 64 2a 29 26 64 62 2d 3e 62  e, (void*)&db->b
6720: 75 73 79 48 61 6e 64 6c 65 72 29 3b 0a 20 20 20  usyHandler);.   
6730: 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74   sqlite3BtreeSet
6740: 43 61 63 68 65 53 69 7a 65 28 2a 70 70 42 74 72  CacheSize(*ppBtr
6750: 65 65 2c 20 6e 43 61 63 68 65 29 3b 0a 20 20 7d  ee, nCache);.  }
6760: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
6770: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54  ./*.** Return UT
6780: 46 2d 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c  F-8 encoded Engl
6790: 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70  ish language exp
67a0: 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  lanation of the 
67b0: 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65  most recent.** e
67c0: 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63  rror..*/.const c
67d0: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72  har *sqlite3_err
67e0: 6d 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29  msg(sqlite3 *db)
67f0: 7b 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 21  {.  if( !db || !
6800: 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20  db->pErr ){.    
6810: 2f 2a 20 49 66 20 64 62 20 69 73 20 4e 55 4c 4c  /* If db is NULL
6820: 2c 20 74 68 65 6e 20 61 73 73 75 6d 65 20 74 68  , then assume th
6830: 61 74 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61  at a malloc() fa
6840: 69 6c 65 64 20 64 75 72 69 6e 67 20 61 6e 0a 20  iled during an. 
6850: 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70     ** sqlite3_op
6860: 65 6e 28 29 20 63 61 6c 6c 2e 0a 20 20 20 20 2a  en() call..    *
6870: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c  /.    return sql
6880: 69 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 54  ite3ErrStr(SQLIT
6890: 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20  E_NOMEM);.  }.  
68a0: 69 66 28 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53  if( db->magic!=S
68b0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e  QLITE_MAGIC_OPEN
68c0: 20 26 26 20 0a 20 20 20 20 20 20 64 62 2d 3e 6d   && .      db->m
68d0: 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47  agic!=SQLITE_MAG
68e0: 49 43 5f 42 55 53 59 20 26 26 0a 20 20 20 20 20  IC_BUSY &&.     
68f0: 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49   db->magic!=SQLI
6900: 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20  TE_MAGIC_CLOSED 
6910: 0a 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  .  ){.    return
6920: 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53   sqlite3ErrStr(S
6930: 51 4c 49 54 45 5f 4d 49 53 55 53 45 29 3b 0a 20  QLITE_MISUSE);. 
6940: 20 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65   }.  if( !sqlite
6950: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62 2d  3_value_text(db-
6960: 3e 70 45 72 72 29 20 29 7b 0a 20 20 20 20 72 65  >pErr) ){.    re
6970: 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53  turn sqlite3ErrS
6980: 74 72 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 3b  tr(db->errCode);
6990: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 73 71  .  }.  return sq
69a0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
69b0: 28 64 62 2d 3e 70 45 72 72 29 3b 0a 7d 0a 0a 2f  (db->pErr);.}../
69c0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 2d  *.** Return UTF-
69d0: 31 36 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69  16 encoded Engli
69e0: 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c  sh language expl
69f0: 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d  anation of the m
6a00: 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72  ost recent.** er
6a10: 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f  ror..*/.const vo
6a20: 69 64 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d  id *sqlite3_errm
6a30: 73 67 31 36 28 73 71 6c 69 74 65 33 20 2a 64 62  sg16(sqlite3 *db
6a40: 29 7b 0a 20 20 2f 2a 20 42 65 63 61 75 73 65 20  ){.  /* Because 
6a50: 61 6c 6c 20 74 68 65 20 63 68 61 72 61 63 74 65  all the characte
6a60: 72 73 20 69 6e 20 74 68 65 20 73 74 72 69 6e 67  rs in the string
6a70: 20 61 72 65 20 69 6e 20 74 68 65 20 75 6e 69 63   are in the unic
6a80: 6f 64 65 0a 20 20 2a 2a 20 72 61 6e 67 65 20 30  ode.  ** range 0
6a90: 78 30 30 2d 30 78 46 46 2c 20 69 66 20 77 65 20  x00-0xFF, if we 
6aa0: 70 61 64 20 74 68 65 20 62 69 67 2d 65 6e 64 69  pad the big-endi
6ab0: 61 6e 20 73 74 72 69 6e 67 20 77 69 74 68 20 61  an string with a
6ac0: 20 0a 20 20 2a 2a 20 7a 65 72 6f 20 62 79 74 65   .  ** zero byte
6ad0: 2c 20 77 65 20 63 61 6e 20 6f 62 74 61 69 6e 20  , we can obtain 
6ae0: 74 68 65 20 6c 69 74 74 6c 65 2d 65 6e 64 69 61  the little-endia
6af0: 6e 20 73 74 72 69 6e 67 20 77 69 74 68 0a 20 20  n string with.  
6b00: 2a 2a 20 26 62 69 67 5f 65 6e 64 69 61 6e 5b 31  ** &big_endian[1
6b10: 5d 2e 0a 20 20 2a 2f 0a 20 20 73 74 61 74 69 63  ]..  */.  static
6b20: 20 63 68 61 72 20 6f 75 74 4f 66 4d 65 6d 42 65   char outOfMemBe
6b30: 5b 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6f  [] = {.    0, 'o
6b40: 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74  ', 0, 'u', 0, 't
6b50: 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20  ', 0, ' ', .    
6b60: 30 2c 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20  0, 'o', 0, 'f', 
6b70: 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20  0, ' ', .    0, 
6b80: 27 6d 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20  'm', 0, 'e', 0, 
6b90: 27 6d 27 2c 20 30 2c 20 27 6f 27 2c 20 30 2c 20  'm', 0, 'o', 0, 
6ba0: 27 72 27 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20  'r', 0, 'y', 0, 
6bb0: 30 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74  0, 0.  };.  stat
6bc0: 69 63 20 63 68 61 72 20 6d 69 73 75 73 65 42 65  ic char misuseBe
6bd0: 20 5b 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27   [] = {.    0, '
6be0: 6c 27 2c 20 30 2c 20 27 69 27 2c 20 30 2c 20 27  l', 0, 'i', 0, '
6bf0: 62 27 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 27  b', 0, 'r', 0, '
6c00: 61 27 2c 20 30 2c 20 27 72 27 2c 20 30 2c 20 27  a', 0, 'r', 0, '
6c10: 79 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20  y', 0, ' ', .   
6c20: 20 30 2c 20 27 72 27 2c 20 30 2c 20 27 6f 27 2c   0, 'r', 0, 'o',
6c30: 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c   0, 'u', 0, 't',
6c40: 20 30 2c 20 27 69 27 2c 20 30 2c 20 27 6e 27 2c   0, 'i', 0, 'n',
6c50: 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 20 27 2c   0, 'e', 0, ' ',
6c60: 20 0a 20 20 20 20 30 2c 20 27 63 27 2c 20 30 2c   .    0, 'c', 0,
6c70: 20 27 61 27 2c 20 30 2c 20 27 6c 27 2c 20 30 2c   'a', 0, 'l', 0,
6c80: 20 27 6c 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c   'l', 0, 'e', 0,
6c90: 20 27 64 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20   'd', 0, ' ', . 
6ca0: 20 20 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27 75     0, 'o', 0, 'u
6cb0: 27 2c 20 30 2c 20 27 74 27 2c 20 30 2c 20 27 20  ', 0, 't', 0, ' 
6cc0: 27 2c 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20  ', .    0, 'o', 
6cd0: 30 2c 20 27 66 27 2c 20 30 2c 20 27 20 27 2c 20  0, 'f', 0, ' ', 
6ce0: 0a 20 20 20 20 30 2c 20 27 73 27 2c 20 30 2c 20  .    0, 's', 0, 
6cf0: 27 65 27 2c 20 30 2c 20 27 71 27 2c 20 30 2c 20  'e', 0, 'q', 0, 
6d00: 27 75 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20  'u', 0, 'e', 0, 
6d10: 27 6e 27 2c 20 30 2c 20 27 63 27 2c 20 30 2c 20  'n', 0, 'c', 0, 
6d20: 27 65 27 2c 20 30 2c 20 30 2c 20 30 0a 20 20 7d  'e', 0, 0, 0.  }
6d30: 3b 0a 0a 20 20 69 66 28 20 64 62 20 26 26 20 64  ;..  if( db && d
6d40: 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20 69  b->pErr ){.    i
6d50: 66 28 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51  f( db->magic!=SQ
6d60: 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 20  LITE_MAGIC_OPEN 
6d70: 26 26 20 0a 20 20 20 20 20 20 20 20 64 62 2d 3e  && .        db->
6d80: 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41  magic!=SQLITE_MA
6d90: 47 49 43 5f 42 55 53 59 20 26 26 0a 20 20 20 20  GIC_BUSY &&.    
6da0: 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53      db->magic!=S
6db0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53  QLITE_MAGIC_CLOS
6dc0: 45 44 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20  ED .    ){.     
6dd0: 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a 29   return (void *)
6de0: 28 26 6d 69 73 75 73 65 42 65 5b 53 51 4c 49 54  (&misuseBe[SQLIT
6df0: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3d 3d 53  E_UTF16NATIVE==S
6e00: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 3f 31 3a  QLITE_UTF16LE?1:
6e10: 30 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  0]);.    }.    i
6e20: 66 28 20 21 73 71 6c 69 74 65 33 5f 76 61 6c 75  f( !sqlite3_valu
6e30: 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72  e_text16(db->pEr
6e40: 72 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  r) ){.      sqli
6e50: 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 64  te3ValueSetStr(d
6e60: 62 2d 3e 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c  b->pErr, -1, sql
6e70: 69 74 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65  ite3ErrStr(db->e
6e80: 72 72 43 6f 64 65 29 2c 0a 20 20 20 20 20 20 20  rrCode),.       
6e90: 20 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20     SQLITE_UTF8, 
6ea0: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
6eb0: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 73 71      }.    if( sq
6ec0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
6ed0: 31 36 28 64 62 2d 3e 70 45 72 72 29 20 29 7b 0a  16(db->pErr) ){.
6ee0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c        return sql
6ef0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
6f00: 36 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 20  6(db->pErr);.   
6f10: 20 7d 0a 20 20 7d 20 20 0a 0a 20 20 2f 2a 20 49   }.  }  ..  /* I
6f20: 66 20 64 62 20 69 73 20 4e 55 4c 4c 2c 20 74 68  f db is NULL, th
6f30: 65 6e 20 61 73 73 75 6d 65 20 74 68 61 74 20 61  en assume that a
6f40: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64   malloc() failed
6f50: 20 64 75 72 69 6e 67 20 61 6e 0a 20 20 2a 2a 20   during an.  ** 
6f60: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 63  sqlite3_open() c
6f70: 61 6c 6c 2e 20 57 65 20 68 61 76 65 20 61 20 73  all. We have a s
6f80: 74 61 74 69 63 20 76 65 72 73 69 6f 6e 20 6f 66  tatic version of
6f90: 20 74 68 65 20 73 74 72 69 6e 67 20 0a 20 20 2a   the string .  *
6fa0: 2a 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79  * "out of memory
6fb0: 22 20 65 6e 63 6f 64 65 64 20 75 73 69 6e 67 20  " encoded using 
6fc0: 55 54 46 2d 31 36 20 6a 75 73 74 20 66 6f 72 20  UTF-16 just for 
6fd0: 74 68 69 73 20 70 75 72 70 6f 73 65 2e 0a 20 20  this purpose..  
6fe0: 2a 2f 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69  */.  return (voi
6ff0: 64 20 2a 29 28 26 6f 75 74 4f 66 4d 65 6d 42 65  d *)(&outOfMemBe
7000: 5b 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54  [SQLITE_UTF16NAT
7010: 49 56 45 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31  IVE==SQLITE_UTF1
7020: 36 4c 45 3f 31 3a 30 5d 29 3b 0a 7d 0a 0a 69 6e  6LE?1:0]);.}..in
7030: 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64  t sqlite3_errcod
7040: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  e(sqlite3 *db){.
7050: 20 20 69 66 28 20 21 64 62 20 29 20 72 65 74 75    if( !db ) retu
7060: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b  rn SQLITE_NOMEM;
7070: 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 65 72  .  return db->er
7080: 72 43 6f 64 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rCode;.}../*.** 
7090: 43 68 65 63 6b 20 73 63 68 65 6d 61 20 63 6f 6f  Check schema coo
70a0: 6b 69 65 73 20 69 6e 20 61 6c 6c 20 64 61 74 61  kies in all data
70b0: 62 61 73 65 73 2e 20 20 49 66 20 61 6e 79 20 63  bases.  If any c
70c0: 6f 6f 6b 69 65 20 69 73 20 6f 75 74 0a 2a 2a 20  ookie is out.** 
70d0: 6f 66 20 64 61 74 65 2c 20 72 65 74 75 72 6e 20  of date, return 
70e0: 30 2e 20 20 49 66 20 61 6c 6c 20 73 63 68 65 6d  0.  If all schem
70f0: 61 20 63 6f 6f 6b 69 65 73 20 61 72 65 20 63 75  a cookies are cu
7100: 72 72 65 6e 74 2c 20 72 65 74 75 72 6e 20 31 2e  rrent, return 1.
7110: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73  .*/.static int s
7120: 63 68 65 6d 61 49 73 56 61 6c 69 64 28 73 71 6c  chemaIsValid(sql
7130: 69 74 65 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20  ite *db){.  int 
7140: 69 44 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  iDb;.  int rc;. 
7150: 20 42 74 43 75 72 73 6f 72 20 2a 63 75 72 54 65   BtCursor *curTe
7160: 6d 70 3b 0a 20 20 69 6e 74 20 63 6f 6f 6b 69 65  mp;.  int cookie
7170: 3b 0a 20 20 69 6e 74 20 61 6c 6c 4f 6b 20 3d 20  ;.  int allOk = 
7180: 31 3b 0a 0a 20 20 66 6f 72 28 69 44 62 3d 30 3b  1;..  for(iDb=0;
7190: 20 61 6c 6c 4f 6b 20 26 26 20 69 44 62 3c 64 62   allOk && iDb<db
71a0: 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b 29 7b 0a 20  ->nDb; iDb++){. 
71b0: 20 20 20 42 74 72 65 65 20 2a 70 42 74 3b 0a 20     Btree *pBt;. 
71c0: 20 20 20 70 42 74 20 3d 20 64 62 2d 3e 61 44 62     pBt = db->aDb
71d0: 5b 69 44 62 5d 2e 70 42 74 3b 0a 20 20 20 20 69  [iDb].pBt;.    i
71e0: 66 28 20 70 42 74 3d 3d 30 20 29 20 63 6f 6e 74  f( pBt==0 ) cont
71f0: 69 6e 75 65 3b 0a 20 20 20 20 72 63 20 3d 20 73  inue;.    rc = s
7200: 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f  qlite3BtreeCurso
7210: 72 28 70 42 74 2c 20 4d 41 53 54 45 52 5f 52 4f  r(pBt, MASTER_RO
7220: 4f 54 2c 20 30 2c 20 30 2c 20 30 2c 20 26 63 75  OT, 0, 0, 0, &cu
7230: 72 54 65 6d 70 29 3b 0a 20 20 20 20 69 66 28 20  rTemp);.    if( 
7240: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
7250: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
7260: 74 65 33 42 74 72 65 65 47 65 74 4d 65 74 61 28  te3BtreeGetMeta(
7270: 70 42 74 2c 20 31 2c 20 28 75 33 32 20 2a 29 26  pBt, 1, (u32 *)&
7280: 63 6f 6f 6b 69 65 29 3b 0a 20 20 20 20 20 20 69  cookie);.      i
7290: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
72a0: 20 26 26 20 63 6f 6f 6b 69 65 21 3d 64 62 2d 3e   && cookie!=db->
72b0: 61 44 62 5b 69 44 62 5d 2e 73 63 68 65 6d 61 5f  aDb[iDb].schema_
72c0: 63 6f 6f 6b 69 65 20 29 7b 0a 20 20 20 20 20 20  cookie ){.      
72d0: 20 20 61 6c 6c 4f 6b 20 3d 20 30 3b 0a 20 20 20    allOk = 0;.   
72e0: 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74     }.      sqlit
72f0: 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73  e3BtreeCloseCurs
7300: 6f 72 28 63 75 72 54 65 6d 70 29 3b 0a 20 20 20  or(curTemp);.   
7310: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
7320: 61 6c 6c 4f 6b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  allOk;.}../*.** 
7330: 43 6f 6d 70 69 6c 65 20 74 68 65 20 55 54 46 2d  Compile the UTF-
7340: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
7350: 61 74 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74  atement zSql int
7360: 6f 20 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61  o a statement ha
7370: 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ndle..*/.int sql
7380: 69 74 65 33 5f 70 72 65 70 61 72 65 28 0a 20 20  ite3_prepare(.  
7390: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
73a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
73b0: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f  abase handle. */
73c0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
73d0: 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20  Sql,         /* 
73e0: 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51  UTF-8 encoded SQ
73f0: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a  L statement. */.
7400: 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20    int nBytes,   
7410: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c              /* L
7420: 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e  ength of zSql in
7430: 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71 6c   bytes. */.  sql
7440: 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74  ite3_stmt **ppSt
7450: 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41  mt,    /* OUT: A
7460: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
7470: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
7480: 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  nt */.  const ch
7490: 61 72 2a 2a 20 70 7a 54 61 69 6c 20 20 20 20 20  ar** pzTail     
74a0: 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66    /* OUT: End of
74b0: 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20 2a   parsed string *
74c0: 2f 0a 29 7b 0a 20 20 50 61 72 73 65 20 73 50 61  /.){.  Parse sPa
74d0: 72 73 65 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72  rse;.  char *zEr
74e0: 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69 6e 74 20  rMsg = 0;.  int 
74f0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
7500: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 6d  .  if( sqlite3_m
7510: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a  alloc_failed ){.
7520: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
7530: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a 20 20  E_NOMEM;.  }..  
7540: 61 73 73 65 72 74 28 20 70 70 53 74 6d 74 20 29  assert( ppStmt )
7550: 3b 0a 20 20 2a 70 70 53 74 6d 74 20 3d 20 30 3b  ;.  *ppStmt = 0;
7560: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61  .  if( sqlite3Sa
7570: 66 65 74 79 4f 6e 28 64 62 29 20 29 7b 0a 20 20  fetyOn(db) ){.  
7580: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
7590: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 6d  MISUSE;.  }..  m
75a0: 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20 30  emset(&sParse, 0
75b0: 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29  , sizeof(sParse)
75c0: 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 62 20 3d  );.  sParse.db =
75d0: 20 64 62 3b 0a 20 20 73 71 6c 69 74 65 33 52 75   db;.  sqlite3Ru
75e0: 6e 50 61 72 73 65 72 28 26 73 50 61 72 73 65 2c  nParser(&sParse,
75f0: 20 7a 53 71 6c 2c 20 26 7a 45 72 72 4d 73 67 29   zSql, &zErrMsg)
7600: 3b 0a 0a 20 20 69 66 28 20 64 62 2d 3e 78 54 72  ;..  if( db->xTr
7610: 61 63 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 74  ace && !db->init
7620: 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 2f 2a 20  .busy ){.    /* 
7630: 54 72 61 63 65 20 6f 6e 6c 79 20 74 68 65 20 73  Trace only the s
7640: 74 61 74 6d 65 6e 74 20 74 68 61 74 20 77 61 73  tatment that was
7650: 20 63 6f 6d 70 69 6c 65 64 2e 0a 20 20 20 20 2a   compiled..    *
7660: 2a 20 4d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66  * Make a copy of
7670: 20 74 68 61 74 20 70 61 72 74 20 6f 66 20 74 68   that part of th
7680: 65 20 53 51 4c 20 73 74 72 69 6e 67 20 73 69 6e  e SQL string sin
7690: 63 65 20 7a 53 51 4c 20 69 73 20 63 6f 6e 73 74  ce zSQL is const
76a0: 0a 20 20 20 20 2a 2a 20 61 6e 64 20 77 65 20 6d  .    ** and we m
76b0: 75 73 74 20 70 61 73 73 20 61 20 7a 65 72 6f 20  ust pass a zero 
76c0: 74 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69 6e  terminated strin
76d0: 67 20 74 6f 20 74 68 65 20 74 72 61 63 65 20 66  g to the trace f
76e0: 75 6e 63 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 54  unction.    ** T
76f0: 68 65 20 63 6f 70 79 20 69 73 20 75 6e 6e 65 63  he copy is unnec
7700: 65 73 73 61 72 79 20 69 66 20 74 68 65 20 74 61  essary if the ta
7710: 69 6c 20 70 6f 69 6e 74 65 72 20 69 73 20 70 6f  il pointer is po
7720: 69 6e 74 69 6e 67 20 61 74 20 74 68 65 0a 20 20  inting at the.  
7730: 20 20 2a 2a 20 62 65 67 69 6e 6e 69 67 20 6f 72    ** beginnig or
7740: 20 65 6e 64 20 6f 66 20 74 68 65 20 53 51 4c 20   end of the SQL 
7750: 73 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20  string..    */. 
7760: 20 20 20 69 66 28 20 73 50 61 72 73 65 2e 7a 54     if( sParse.zT
7770: 61 69 6c 20 26 26 20 73 50 61 72 73 65 2e 7a 54  ail && sParse.zT
7780: 61 69 6c 21 3d 7a 53 71 6c 20 26 26 20 2a 73 50  ail!=zSql && *sP
7790: 61 72 73 65 2e 7a 54 61 69 6c 20 29 7b 0a 20 20  arse.zTail ){.  
77a0: 20 20 20 20 63 68 61 72 20 2a 74 6d 70 53 71 6c      char *tmpSql
77b0: 20 3d 20 73 71 6c 69 74 65 53 74 72 4e 44 75 70   = sqliteStrNDup
77c0: 28 7a 53 71 6c 2c 20 73 50 61 72 73 65 2e 7a 54  (zSql, sParse.zT
77d0: 61 69 6c 20 2d 20 7a 53 71 6c 29 3b 0a 20 20 20  ail - zSql);.   
77e0: 20 20 20 69 66 28 20 74 6d 70 53 71 6c 20 29 7b     if( tmpSql ){
77f0: 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 78 54 72  .        db->xTr
7800: 61 63 65 28 64 62 2d 3e 70 54 72 61 63 65 41 72  ace(db->pTraceAr
7810: 67 2c 20 74 6d 70 53 71 6c 29 3b 0a 20 20 20 20  g, tmpSql);.    
7820: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 74      sqliteFree(t
7830: 6d 70 53 71 6c 29 3b 0a 20 20 20 20 20 20 7d 65  mpSql);.      }e
7840: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20  lse{.        /* 
7850: 49 66 20 61 20 6d 65 6d 6f 72 79 20 65 72 72 6f  If a memory erro
7860: 72 20 6f 63 63 75 72 72 65 64 20 64 75 72 69 6e  r occurred durin
7870: 67 20 74 68 65 20 63 6f 70 79 2c 0a 20 20 20 20  g the copy,.    
7880: 20 20 20 20 2a 2a 20 74 72 61 63 65 20 65 6e 74      ** trace ent
7890: 69 72 65 20 53 51 4c 20 73 74 72 69 6e 67 20 61  ire SQL string a
78a0: 6e 64 20 66 61 6c 6c 20 74 68 72 6f 75 67 68 20  nd fall through 
78b0: 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a  to the.        *
78c0: 2a 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  * sqlite3_malloc
78d0: 5f 66 61 69 6c 65 64 20 74 65 73 74 20 74 6f 20  _failed test to 
78e0: 72 65 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72  report the error
78f0: 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20  ..        */.   
7900: 20 20 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28       db->xTrace(
7910: 64 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 7a  db->pTraceArg, z
7920: 53 71 6c 29 3b 20 0a 20 20 20 20 20 20 7d 0a 20  Sql); .      }. 
7930: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
7940: 64 62 2d 3e 78 54 72 61 63 65 28 64 62 2d 3e 70  db->xTrace(db->p
7950: 54 72 61 63 65 41 72 67 2c 20 7a 53 71 6c 29 3b  TraceArg, zSql);
7960: 20 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f   .    }.  }..  /
7970: 2a 20 50 72 69 6e 74 20 61 20 63 6f 70 79 20 6f  * Print a copy o
7980: 66 20 53 51 4c 20 61 73 20 69 74 20 69 73 20 65  f SQL as it is e
7990: 78 65 63 75 74 65 64 20 69 66 20 74 68 65 20 53  xecuted if the S
79a0: 51 4c 5f 54 52 41 43 45 20 70 72 61 67 6d 61 20  QL_TRACE pragma 
79b0: 69 73 20 74 75 72 6e 65 64 0a 20 20 2a 2a 20 6f  is turned.  ** o
79c0: 6e 20 69 6e 20 64 65 62 75 67 67 69 6e 67 20 6d  n in debugging m
79d0: 6f 64 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66  ode..  */.#ifdef
79e0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20   SQLITE_DEBUG.  
79f0: 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 20 26  if( (db->flags &
7a00: 20 53 51 4c 49 54 45 5f 53 71 6c 54 72 61 63 65   SQLITE_SqlTrace
7a10: 29 21 3d 30 20 26 26 20 73 50 61 72 73 65 2e 7a  )!=0 && sParse.z
7a20: 54 61 69 6c 20 26 26 20 73 50 61 72 73 65 2e 7a  Tail && sParse.z
7a30: 54 61 69 6c 21 3d 7a 53 71 6c 20 29 7b 0a 20 20  Tail!=zSql ){.  
7a40: 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72    sqlite3DebugPr
7a50: 69 6e 74 66 28 22 53 51 4c 2d 74 72 61 63 65 3a  intf("SQL-trace:
7a60: 20 25 2e 2a 73 5c 6e 22 2c 20 73 50 61 72 73 65   %.*s\n", sParse
7a70: 2e 7a 54 61 69 6c 20 2d 20 7a 53 71 6c 2c 20 7a  .zTail - zSql, z
7a80: 53 71 6c 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  Sql);.  }.#endif
7a90: 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47   /* SQLITE_DEBUG
7aa0: 20 2a 2f 0a 0a 0a 20 20 69 66 28 20 73 71 6c 69   */...  if( sqli
7ab0: 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65  te3_malloc_faile
7ac0: 64 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51  d ){.    rc = SQ
7ad0: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
7ae0: 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41  sqlite3RollbackA
7af0: 6c 6c 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69  ll(db);.    sqli
7b00: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
7b10: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
7b20: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20     db->flags &= 
7b30: 7e 53 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b  ~SQLITE_InTrans;
7b40: 0a 20 20 20 20 67 6f 74 6f 20 70 72 65 70 61 72  .    goto prepar
7b50: 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 69 66 28  e_out;.  }.  if(
7b60: 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49   sParse.rc==SQLI
7b70: 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65  TE_DONE ) sParse
7b80: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  .rc = SQLITE_OK;
7b90: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 63 68  .  if( sParse.ch
7ba0: 65 63 6b 53 63 68 65 6d 61 20 26 26 20 21 73 63  eckSchema && !sc
7bb0: 68 65 6d 61 49 73 56 61 6c 69 64 28 64 62 29 20  hemaIsValid(db) 
7bc0: 29 7b 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63  ){.    sParse.rc
7bd0: 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41   = SQLITE_SCHEMA
7be0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72  ;.  }.  if( sPar
7bf0: 73 65 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43  se.rc==SQLITE_SC
7c00: 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c 69  HEMA ){.    sqli
7c10: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
7c20: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
7c30: 20 7d 0a 20 20 69 66 28 20 70 7a 54 61 69 6c 20   }.  if( pzTail 
7c40: 29 20 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 72  ) *pzTail = sPar
7c50: 73 65 2e 7a 54 61 69 6c 3b 0a 20 20 72 63 20 3d  se.zTail;.  rc =
7c60: 20 73 50 61 72 73 65 2e 72 63 3b 0a 0a 20 20 69   sParse.rc;..  i
7c70: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
7c80: 20 26 26 20 73 50 61 72 73 65 2e 70 56 64 62 65   && sParse.pVdbe
7c90: 20 26 26 20 73 50 61 72 73 65 2e 65 78 70 6c 61   && sParse.expla
7ca0: 69 6e 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  in ){.    sqlite
7cb0: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
7cc0: 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 35 29  sParse.pVdbe, 5)
7cd0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
7ce0: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72  eSetColName(sPar
7cf0: 73 65 2e 70 56 64 62 65 2c 20 30 2c 20 22 61 64  se.pVdbe, 0, "ad
7d00: 64 72 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b  dr", P3_STATIC);
7d10: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
7d20: 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73  SetColName(sPars
7d30: 65 2e 70 56 64 62 65 2c 20 31 2c 20 22 6f 70 63  e.pVdbe, 1, "opc
7d40: 6f 64 65 22 2c 20 50 33 5f 53 54 41 54 49 43 29  ode", P3_STATIC)
7d50: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
7d60: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72  eSetColName(sPar
7d70: 73 65 2e 70 56 64 62 65 2c 20 32 2c 20 22 70 31  se.pVdbe, 2, "p1
7d80: 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20  ", P3_STATIC);. 
7d90: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65     sqlite3VdbeSe
7da0: 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e  tColName(sParse.
7db0: 70 56 64 62 65 2c 20 33 2c 20 22 70 32 22 2c 20  pVdbe, 3, "p2", 
7dc0: 50 33 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20  P3_STATIC);.    
7dd0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f  sqlite3VdbeSetCo
7de0: 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64  lName(sParse.pVd
7df0: 62 65 2c 20 34 2c 20 22 70 33 22 2c 20 50 33 5f  be, 4, "p3", P3_
7e00: 53 54 41 54 49 43 29 3b 0a 20 20 7d 20 0a 0a 70  STATIC);.  } ..p
7e10: 72 65 70 61 72 65 5f 6f 75 74 3a 0a 20 20 69 66  repare_out:.  if
7e20: 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f  ( sqlite3SafetyO
7e30: 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20 72 63  ff(db) ){.    rc
7e40: 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45   = SQLITE_MISUSE
7e50: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d  ;.  }.  if( rc==
7e60: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
7e70: 20 2a 70 70 53 74 6d 74 20 3d 20 28 73 71 6c 69   *ppStmt = (sqli
7e80: 74 65 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65  te3_stmt*)sParse
7e90: 2e 70 56 64 62 65 3b 0a 20 20 7d 65 6c 73 65 20  .pVdbe;.  }else 
7ea0: 69 66 28 20 73 50 61 72 73 65 2e 70 56 64 62 65  if( sParse.pVdbe
7eb0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
7ec0: 66 69 6e 61 6c 69 7a 65 28 28 73 71 6c 69 74 65  finalize((sqlite
7ed0: 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70  3_stmt*)sParse.p
7ee0: 56 64 62 65 29 3b 0a 20 20 7d 0a 0a 20 20 69 66  Vdbe);.  }..  if
7ef0: 28 20 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20  ( zErrMsg ){.   
7f00: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
7f10: 2c 20 72 63 2c 20 22 25 73 22 2c 20 7a 45 72 72  , rc, "%s", zErr
7f20: 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Msg);.    sqlite
7f30: 46 72 65 65 28 7a 45 72 72 4d 73 67 29 3b 0a 20  Free(zErrMsg);. 
7f40: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69   }else{.    sqli
7f50: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c  te3Error(db, rc,
7f60: 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72   0);.  }.  retur
7f70: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  n rc;.}../*.** C
7f80: 6f 6d 70 69 6c 65 20 74 68 65 20 55 54 46 2d 31  ompile the UTF-1
7f90: 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  6 encoded SQL st
7fa0: 61 74 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74  atement zSql int
7fb0: 6f 20 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61  o a statement ha
7fc0: 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ndle..*/.int sql
7fd0: 69 74 65 33 5f 70 72 65 70 61 72 65 31 36 28 0a  ite3_prepare16(.
7fe0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20    sqlite3 *db,  
7ff0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
8000: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20  atabase handle. 
8010: 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  */ .  const void
8020: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20   *zSql,         
8030: 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64  /* UTF-8 encoded
8040: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20   SQL statement. 
8050: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c  */.  int nBytes,
8060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
8070: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c  * Length of zSql
8080: 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20   in bytes. */.  
8090: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70  sqlite3_stmt **p
80a0: 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54  pStmt,    /* OUT
80b0: 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  : A pointer to t
80c0: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
80d0: 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74  ement */.  const
80e0: 20 76 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 20   void **pzTail  
80f0: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64       /* OUT: End
8100: 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 6e   of parsed strin
8110: 67 20 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 54 68 69  g */.){.  /* Thi
8120: 73 20 66 75 6e 63 74 69 6f 6e 20 63 75 72 72 65  s function curre
8130: 6e 74 6c 79 20 77 6f 72 6b 73 20 62 79 20 66 69  ntly works by fi
8140: 72 73 74 20 74 72 61 6e 73 66 6f 72 6d 69 6e 67  rst transforming
8150: 20 74 68 65 20 55 54 46 2d 31 36 0a 20 20 2a 2a   the UTF-16.  **
8160: 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 20   encoded string 
8170: 74 6f 20 55 54 46 2d 38 2c 20 74 68 65 6e 20 69  to UTF-8, then i
8180: 6e 76 6f 6b 69 6e 67 20 73 71 6c 69 74 65 33 5f  nvoking sqlite3_
8190: 70 72 65 70 61 72 65 28 29 2e 20 54 68 65 0a 20  prepare(). The. 
81a0: 20 2a 2a 20 74 72 69 63 6b 79 20 62 69 74 20 69   ** tricky bit i
81b0: 73 20 66 69 67 75 72 69 6e 67 20 6f 75 74 20 74  s figuring out t
81c0: 68 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 72 65  he pointer to re
81d0: 74 75 72 6e 20 69 6e 20 2a 70 7a 54 61 69 6c 2e  turn in *pzTail.
81e0: 0a 20 20 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e  .  */.  char con
81f0: 73 74 20 2a 7a 53 71 6c 38 20 3d 20 30 3b 0a 20  st *zSql8 = 0;. 
8200: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 54 61   char const *zTa
8210: 69 6c 38 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72  il8 = 0;.  int r
8220: 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c  c;.  sqlite3_val
8230: 75 65 20 2a 70 54 6d 70 3b 0a 0a 20 20 70 54 6d  ue *pTmp;..  pTm
8240: 70 20 3d 20 73 71 6c 69 74 65 33 47 65 74 54 72  p = sqlite3GetTr
8250: 61 6e 73 69 65 6e 74 56 61 6c 75 65 28 64 62 29  ansientValue(db)
8260: 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65  ;.  sqlite3Value
8270: 53 65 74 53 74 72 28 70 54 6d 70 2c 20 2d 31 2c  SetStr(pTmp, -1,
8280: 20 7a 53 71 6c 2c 20 53 51 4c 49 54 45 5f 55 54   zSql, SQLITE_UT
8290: 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 54  F16NATIVE, SQLIT
82a0: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 53 71  E_STATIC);.  zSq
82b0: 6c 38 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75  l8 = sqlite3Valu
82c0: 65 54 65 78 74 28 70 54 6d 70 2c 20 53 51 4c 49  eText(pTmp, SQLI
82d0: 54 45 5f 55 54 46 38 29 3b 0a 20 20 69 66 28 20  TE_UTF8);.  if( 
82e0: 21 7a 53 71 6c 38 20 29 7b 0a 20 20 20 20 73 71  !zSql8 ){.    sq
82f0: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53  lite3Error(db, S
8300: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b  QLITE_NOMEM, 0);
8310: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
8320: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20  TE_NOMEM;.  }.  
8330: 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 70 72 65  rc = sqlite3_pre
8340: 70 61 72 65 28 64 62 2c 20 7a 53 71 6c 38 2c 20  pare(db, zSql8, 
8350: 2d 31 2c 20 70 70 53 74 6d 74 2c 20 26 7a 54 61  -1, ppStmt, &zTa
8360: 69 6c 38 29 3b 0a 0a 20 20 69 66 28 20 7a 54 61  il8);..  if( zTa
8370: 69 6c 38 20 26 26 20 70 7a 54 61 69 6c 20 29 7b  il8 && pzTail ){
8380: 0a 20 20 20 20 2f 2a 20 49 66 20 73 71 6c 69 74  .    /* If sqlit
8390: 65 33 5f 70 72 65 70 61 72 65 20 72 65 74 75 72  e3_prepare retur
83a0: 6e 73 20 61 20 74 61 69 6c 20 70 6f 69 6e 74 65  ns a tail pointe
83b0: 72 2c 20 77 65 20 63 61 6c 63 75 6c 61 74 65 20  r, we calculate 
83c0: 74 68 65 0a 20 20 20 20 2a 2a 20 65 71 75 69 76  the.    ** equiv
83d0: 61 6c 65 6e 74 20 70 6f 69 6e 74 65 72 20 69 6e  alent pointer in
83e0: 74 6f 20 74 68 65 20 55 54 46 2d 31 36 20 73 74  to the UTF-16 st
83f0: 72 69 6e 67 20 62 79 20 63 6f 75 6e 74 69 6e 67  ring by counting
8400: 20 74 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 20   the unicode.   
8410: 20 2a 2a 20 63 68 61 72 61 63 74 65 72 73 20 62   ** characters b
8420: 65 74 77 65 65 6e 20 7a 53 71 6c 38 20 61 6e 64  etween zSql8 and
8430: 20 7a 54 61 69 6c 38 2c 20 61 6e 64 20 74 68 65   zTail8, and the
8440: 6e 20 72 65 74 75 72 6e 69 6e 67 20 61 20 70 6f  n returning a po
8450: 69 6e 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 65  inter.    ** the
8460: 20 73 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20   same number of 
8470: 63 68 61 72 61 63 74 65 72 73 20 69 6e 74 6f 20  characters into 
8480: 74 68 65 20 55 54 46 2d 31 36 20 73 74 72 69 6e  the UTF-16 strin
8490: 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e  g..    */.    in
84a0: 74 20 63 68 61 72 73 5f 70 61 72 73 65 64 20 3d  t chars_parsed =
84b0: 20 73 71 6c 69 74 65 33 75 74 66 38 43 68 61 72   sqlite3utf8Char
84c0: 4c 65 6e 28 7a 53 71 6c 38 2c 20 7a 54 61 69 6c  Len(zSql8, zTail
84d0: 38 2d 7a 53 71 6c 38 29 3b 0a 20 20 20 20 2a 70  8-zSql8);.    *p
84e0: 7a 54 61 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53  zTail = (u8 *)zS
84f0: 71 6c 20 2b 20 73 71 6c 69 74 65 33 75 74 66 31  ql + sqlite3utf1
8500: 36 42 79 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63  6ByteLen(zSql, c
8510: 68 61 72 73 5f 70 61 72 73 65 64 29 3b 0a 20 20  hars_parsed);.  
8520: 7d 0a 20 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  }. .  return rc;
8530: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
8540: 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20  outine does the 
8550: 77 6f 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20  work of opening 
8560: 61 20 64 61 74 61 62 61 73 65 20 6f 6e 20 62 65  a database on be
8570: 68 61 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74  half of.** sqlit
8580: 65 33 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 71  e3_open() and sq
8590: 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20  lite3_open16(). 
85a0: 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  The database fil
85b0: 65 6e 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65  ename "zFilename
85c0: 22 20 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20  "  .** is UTF-8 
85d0: 65 6e 63 6f 64 65 64 2e 20 54 68 65 20 66 6f 75  encoded. The fou
85e0: 72 74 68 20 61 72 67 75 6d 65 6e 74 2c 20 22 64  rth argument, "d
85f0: 65 66 5f 65 6e 63 22 20 69 73 20 6f 6e 65 20 6f  ef_enc" is one o
8600: 66 20 74 68 65 20 54 45 58 54 5f 2a 0a 2a 2a 20  f the TEXT_*.** 
8610: 6d 61 63 72 6f 73 20 66 72 6f 6d 20 73 71 6c 69  macros from sqli
8620: 74 65 49 6e 74 2e 68 2e 20 49 66 20 77 65 20 65  teInt.h. If we e
8630: 6e 64 20 75 70 20 63 72 65 61 74 69 6e 67 20 61  nd up creating a
8640: 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 66 69   new database fi
8650: 6c 65 0a 2a 2a 20 28 6e 6f 74 20 6f 70 65 6e 69  le.** (not openi
8660: 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6f  ng an existing o
8670: 6e 65 29 2c 20 74 68 65 20 74 65 78 74 20 65 6e  ne), the text en
8680: 63 6f 64 69 6e 67 20 6f 66 20 74 68 65 20 64 61  coding of the da
8690: 74 61 62 61 73 65 0a 2a 2a 20 77 69 6c 6c 20 62  tabase.** will b
86a0: 65 20 73 65 74 20 74 6f 20 74 68 69 73 20 76 61  e set to this va
86b0: 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  lue..*/.static i
86c0: 6e 74 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28  nt openDatabase(
86d0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
86e0: 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74  Filename, /* Dat
86f0: 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55  abase filename U
8700: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a  TF-8 encoded */.
8710: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62    sqlite3 **ppDb
8720: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
8730: 20 52 65 74 75 72 6e 65 64 20 64 61 74 61 62 61   Returned databa
8740: 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 29 7b 0a  se handle */.){.
8750: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20    sqlite3 *db;. 
8760: 20 69 6e 74 20 72 63 2c 20 69 3b 0a 20 20 63 68   int rc, i;.  ch
8770: 61 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b  ar *zErrMsg = 0;
8780: 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20  ..  /* Allocate 
8790: 74 68 65 20 73 71 6c 69 74 65 20 64 61 74 61 20  the sqlite data 
87a0: 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 64  structure */.  d
87b0: 62 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63  b = sqliteMalloc
87c0: 28 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 29  ( sizeof(sqlite)
87d0: 20 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20   );.  if( db==0 
87e0: 29 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75  ) goto opendb_ou
87f0: 74 3b 0a 20 20 64 62 2d 3e 70 72 69 6f 72 4e 65  t;.  db->priorNe
8800: 77 52 6f 77 69 64 20 3d 20 30 3b 0a 20 20 64 62  wRowid = 0;.  db
8810: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
8820: 5f 4d 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64  _MAGIC_BUSY;.  d
8830: 62 2d 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62  b->nDb = 2;.  db
8840: 2d 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53  ->aDb = db->aDbS
8850: 74 61 74 69 63 3b 0a 20 20 64 62 2d 3e 65 6e 63  tatic;.  db->enc
8860: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a   = SQLITE_UTF8;.
8870: 20 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74    db->autoCommit
8880: 20 3d 20 31 3b 0a 20 20 2f 2a 20 64 62 2d 3e 66   = 1;.  /* db->f
8890: 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 53  lags |= SQLITE_S
88a0: 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 3b 20 2a 2f  hortColNames; */
88b0: 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e  .  sqlite3HashIn
88c0: 69 74 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 53  it(&db->aFunc, S
88d0: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
88e0: 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 33  G, 0);.  sqlite3
88f0: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 43  HashInit(&db->aC
8900: 6f 6c 6c 53 65 71 2c 20 53 51 4c 49 54 45 5f 48  ollSeq, SQLITE_H
8910: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
8920: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d    for(i=0; i<db-
8930: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  >nDb; i++){.    
8940: 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28  sqlite3HashInit(
8950: 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 74 62 6c 48  &db->aDb[i].tblH
8960: 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  ash, SQLITE_HASH
8970: 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 20  _STRING, 0);.   
8980: 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74   sqlite3HashInit
8990: 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 64 78  (&db->aDb[i].idx
89a0: 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53  Hash, SQLITE_HAS
89b0: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20  H_STRING, 0);.  
89c0: 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69    sqlite3HashIni
89d0: 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e 74 72  t(&db->aDb[i].tr
89e0: 69 67 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48  igHash, SQLITE_H
89f0: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
8a00: 20 20 20 20 73 71 6c 69 74 65 33 48 61 73 68 49      sqlite3HashI
8a10: 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e  nit(&db->aDb[i].
8a20: 61 46 4b 65 79 2c 20 53 51 4c 49 54 45 5f 48 41  aFKey, SQLITE_HA
8a30: 53 48 5f 53 54 52 49 4e 47 2c 20 31 29 3b 0a 20  SH_STRING, 1);. 
8a40: 20 7d 0a 20 20 0a 20 20 2f 2a 20 41 64 64 20 74   }.  .  /* Add t
8a50: 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61  he default colla
8a60: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 42 49  tion sequence BI
8a70: 4e 41 52 59 2e 20 42 49 4e 41 52 59 20 77 6f 72  NARY. BINARY wor
8a80: 6b 73 20 66 6f 72 20 62 6f 74 68 20 55 54 46 2d  ks for both UTF-
8a90: 38 0a 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d 31  8.  ** and UTF-1
8aa0: 36 2c 20 73 6f 20 61 64 64 20 61 20 76 65 72 73  6, so add a vers
8ab0: 69 6f 6e 20 66 6f 72 20 65 61 63 68 20 74 6f 20  ion for each to 
8ac0: 61 76 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63 65  avoid any unnece
8ad0: 73 73 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 65  ssary.  ** conve
8ae0: 72 73 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c 79  rsions. The only
8af0: 20 65 72 72 6f 72 20 74 68 61 74 20 63 61 6e 20   error that can 
8b00: 6f 63 63 75 72 20 68 65 72 65 20 69 73 20 61 20  occur here is a 
8b10: 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65  malloc() failure
8b20: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ..  */.  sqlite3
8b30: 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f  _create_collatio
8b40: 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20  n(db, "BINARY", 
8b50: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 62  SQLITE_UTF8, 0,b
8b60: 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46 75  inaryCollatingFu
8b70: 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63  nc);.  sqlite3_c
8b80: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
8b90: 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51  db, "BINARY", SQ
8ba0: 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 30 2c  LITE_UTF16LE, 0,
8bb0: 62 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67 46  binaryCollatingF
8bc0: 75 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f  unc);.  sqlite3_
8bd0: 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e  create_collation
8be0: 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53  (db, "BINARY", S
8bf0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 30  QLITE_UTF16BE, 0
8c00: 2c 62 69 6e 61 72 79 43 6f 6c 6c 61 74 69 6e 67  ,binaryCollating
8c10: 46 75 6e 63 29 3b 0a 20 20 64 62 2d 3e 70 44 66  Func);.  db->pDf
8c20: 6c 74 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33  ltColl = sqlite3
8c30: 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20  FindCollSeq(db, 
8c40: 64 62 2d 3e 65 6e 63 2c 20 22 42 49 4e 41 52 59  db->enc, "BINARY
8c50: 22 2c 20 36 2c 20 30 29 3b 0a 20 20 69 66 28 20  ", 6, 0);.  if( 
8c60: 21 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 29  !db->pDfltColl )
8c70: 7b 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 65  {.    rc = db->e
8c80: 72 72 43 6f 64 65 3b 0a 20 20 20 20 61 73 73 65  rrCode;.    asse
8c90: 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  rt( rc!=SQLITE_O
8ca0: 4b 20 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67  K );.    db->mag
8cb0: 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49  ic = SQLITE_MAGI
8cc0: 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f  C_CLOSED;.    go
8cd0: 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20  to opendb_out;. 
8ce0: 20 7d 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64   }..  /* Also ad
8cf0: 64 20 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69  d a UTF-8 case-i
8d00: 6e 73 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61  nsensitive colla
8d10: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a  tion sequence. *
8d20: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61  /.  sqlite3_crea
8d30: 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c  te_collation(db,
8d40: 20 22 4e 4f 43 41 53 45 22 2c 20 53 51 4c 49 54   "NOCASE", SQLIT
8d50: 45 5f 55 54 46 38 2c 20 30 2c 20 6e 6f 63 61 73  E_UTF8, 0, nocas
8d60: 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 29 3b  eCollatingFunc);
8d70: 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20  ..  /* Open the 
8d80: 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65  backend database
8d90: 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 20   driver */.  rc 
8da0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 61  = sqlite3BtreeFa
8db0: 63 74 6f 72 79 28 64 62 2c 20 7a 46 69 6c 65 6e  ctory(db, zFilen
8dc0: 61 6d 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47 45  ame, 0, MAX_PAGE
8dd0: 53 2c 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70  S, &db->aDb[0].p
8de0: 42 74 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53  Bt);.  if( rc!=S
8df0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
8e00: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c  sqlite3Error(db,
8e10: 20 72 63 2c 20 30 29 3b 0a 20 20 20 20 64 62 2d   rc, 0);.    db-
8e20: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f  >magic = SQLITE_
8e30: 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20  MAGIC_CLOSED;.  
8e40: 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75    goto opendb_ou
8e50: 74 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62  t;.  }.  db->aDb
8e60: 5b 30 5d 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69  [0].zName = "mai
8e70: 6e 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d  n";.  db->aDb[1]
8e80: 2e 7a 4e 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b  .zName = "temp";
8e90: 0a 0a 20 20 2f 2a 20 54 68 65 20 64 65 66 61 75  ..  /* The defau
8ea0: 6c 74 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 20  lt safety_level 
8eb0: 66 6f 72 20 74 68 65 20 6d 61 69 6e 20 64 61 74  for the main dat
8ec0: 61 62 61 73 65 20 69 73 20 27 66 75 6c 6c 27 20  abase is 'full' 
8ed0: 66 6f 72 20 74 68 65 20 74 65 6d 70 0a 20 20 2a  for the temp.  *
8ee0: 2a 20 64 61 74 61 62 61 73 65 20 69 74 20 69 73  * database it is
8ef0: 20 27 4e 4f 4e 45 27 2e 20 54 68 69 73 20 6d 61   'NONE'. This ma
8f00: 74 63 68 65 73 20 74 68 65 20 70 61 67 65 72 20  tches the pager 
8f10: 6c 61 79 65 72 20 64 65 66 61 75 6c 74 73 2e 20  layer defaults. 
8f20: 20 2a 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d   */.  db->aDb[0]
8f30: 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20  .safety_level = 
8f40: 33 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e  3;.  db->aDb[1].
8f50: 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 31  safety_level = 1
8f60: 3b 0a 0a 20 20 2f 2a 20 52 65 67 69 73 74 65 72  ;..  /* Register
8f70: 20 61 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 66 75   all built-in fu
8f80: 6e 63 74 69 6f 6e 73 2c 20 62 75 74 20 64 6f 20  nctions, but do 
8f90: 6e 6f 74 20 61 74 74 65 6d 70 74 20 74 6f 20 72  not attempt to r
8fa0: 65 61 64 20 74 68 65 0a 20 20 2a 2a 20 64 61 74  ead the.  ** dat
8fb0: 61 62 61 73 65 20 73 63 68 65 6d 61 20 79 65 74  abase schema yet
8fc0: 2e 20 54 68 69 73 20 69 73 20 64 65 6c 61 79 65  . This is delaye
8fd0: 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73  d until the firs
8fe0: 74 20 74 69 6d 65 20 74 68 65 20 64 61 74 61 62  t time the datab
8ff0: 61 73 65 0a 20 20 2a 2a 20 69 73 20 61 63 63 65  ase.  ** is acce
9000: 73 73 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c  ssed..  */.  sql
9010: 69 74 65 33 52 65 67 69 73 74 65 72 42 75 69 6c  ite3RegisterBuil
9020: 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 64 62 29  tinFunctions(db)
9030: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  ;.  if( rc==SQLI
9040: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
9050: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51  ite3Error(db, SQ
9060: 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20  LITE_OK, 0);.   
9070: 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c   db->magic = SQL
9080: 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a  ITE_MAGIC_OPEN;.
9090: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
90a0: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63  ite3Error(db, rc
90b0: 2c 20 22 25 73 22 2c 20 7a 45 72 72 4d 73 67 2c  , "%s", zErrMsg,
90c0: 20 30 29 3b 0a 20 20 20 20 69 66 28 20 7a 45 72   0);.    if( zEr
90d0: 72 4d 73 67 20 29 20 73 71 6c 69 74 65 46 72 65  rMsg ) sqliteFre
90e0: 65 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  e(zErrMsg);.    
90f0: 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49  db->magic = SQLI
9100: 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b  TE_MAGIC_CLOSED;
9110: 0a 20 20 7d 0a 0a 6f 70 65 6e 64 62 5f 6f 75 74  .  }..opendb_out
9120: 3a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f  :.  if( sqlite3_
9130: 65 72 72 63 6f 64 65 28 64 62 29 3d 3d 53 51 4c  errcode(db)==SQL
9140: 49 54 45 5f 4f 4b 20 26 26 20 73 71 6c 69 74 65  ITE_OK && sqlite
9150: 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20  3_malloc_failed 
9160: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72  ){.    sqlite3Er
9170: 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4e  ror(db, SQLITE_N
9180: 4f 4d 45 4d 2c 20 30 29 3b 0a 20 20 7d 0a 20 20  OMEM, 0);.  }.  
9190: 2a 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 72 65  *ppDb = db;.  re
91a0: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 65 72 72  turn sqlite3_err
91b0: 63 6f 64 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a  code(db);.}../*.
91c0: 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61  ** Open a new da
91d0: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a  tabase handle..*
91e0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70  /.int sqlite3_op
91f0: 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72  en(.  const char
9200: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20   *zFilename, .  
9210: 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 0a  sqlite3 **ppDb .
9220: 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e  ){.  return open
9230: 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e 61  Database(zFilena
9240: 6d 65 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a 2f 2a  me, ppDb);.}../*
9250: 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64  .** Open a new d
9260: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a  atabase handle..
9270: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f  */.int sqlite3_o
9280: 70 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74 20 76  pen16(.  const v
9290: 6f 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20  oid *zFilename, 
92a0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44  .  sqlite3 **ppD
92b0: 62 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73  b.){.  char cons
92c0: 74 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b 20 20  t *zFilename8;  
92d0: 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 65 6e   /* zFilename en
92e0: 63 6f 64 65 64 20 69 6e 20 55 54 46 2d 38 20 69  coded in UTF-8 i
92f0: 6e 73 74 65 61 64 20 6f 66 20 55 54 46 2d 31 36  nstead of UTF-16
9300: 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53   */.  int rc = S
9310: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 73  QLITE_NOMEM;.  s
9320: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
9330: 61 6c 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70  al;..  assert( p
9340: 70 44 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 3d  pDb );.  *ppDb =
9350: 20 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c   0;.  pVal = sql
9360: 69 74 65 33 56 61 6c 75 65 4e 65 77 28 29 3b 0a  ite3ValueNew();.
9370: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65    sqlite3ValueSe
9380: 74 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a  tStr(pVal, -1, z
9390: 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45  Filename, SQLITE
93a0: 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51  _UTF16NATIVE, SQ
93b0: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20  LITE_STATIC);.  
93c0: 7a 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c  zFilename8 = sql
93d0: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56  ite3ValueText(pV
93e0: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29  al, SQLITE_UTF8)
93f0: 3b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d  ;.  if( zFilenam
9400: 65 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f  e8 ){.    rc = o
9410: 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c  penDatabase(zFil
9420: 65 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b 0a 20  ename8, ppDb);. 
9430: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
9440: 45 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20 29 7b  E_OK && *ppDb ){
9450: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 65  .      sqlite3_e
9460: 78 65 63 28 2a 70 70 44 62 2c 20 22 50 52 41 47  xec(*ppDb, "PRAG
9470: 4d 41 20 65 6e 63 6f 64 69 6e 67 20 3d 20 27 55  MA encoding = 'U
9480: 54 46 2d 31 36 27 22 2c 20 30 2c 20 30 2c 20 30  TF-16'", 0, 0, 0
9490: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69  );.    }.  }.  i
94a0: 66 28 20 70 56 61 6c 20 29 7b 0a 20 20 20 20 73  f( pVal ){.    s
94b0: 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28  qlite3ValueFree(
94c0: 70 56 61 6c 29 3b 0a 20 20 7d 0a 0a 20 20 72 65  pVal);.  }..  re
94d0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
94e0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
94f0: 72 6f 75 74 69 6e 65 20 64 65 73 74 72 6f 79 73  routine destroys
9500: 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69   a virtual machi
9510: 6e 65 20 74 68 61 74 20 69 73 20 63 72 65 61 74  ne that is creat
9520: 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 73 71 6c  ed by.** the sql
9530: 69 74 65 33 5f 63 6f 6d 70 69 6c 65 28 29 20 72  ite3_compile() r
9540: 6f 75 74 69 6e 65 2e 20 54 68 65 20 69 6e 74 65  outine. The inte
9550: 67 65 72 20 72 65 74 75 72 6e 65 64 20 69 73 20  ger returned is 
9560: 61 6e 20 53 51 4c 49 54 45 5f 0a 2a 2a 20 73 75  an SQLITE_.** su
9570: 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20 63 6f  ccess/failure co
9580: 64 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65  de that describe
9590: 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20  s the result of 
95a0: 65 78 65 63 75 74 69 6e 67 20 74 68 65 20 76 69  executing the vi
95b0: 72 74 75 61 6c 0a 2a 2a 20 6d 61 63 68 69 6e 65  rtual.** machine
95c0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ..**.** This rou
95d0: 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 65 72  tine sets the er
95e0: 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 74 72  ror code and str
95f0: 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62 79 0a  ing returned by.
9600: 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f  ** sqlite3_errco
9610: 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f 65 72  de(), sqlite3_er
9620: 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69 74  rmsg() and sqlit
9630: 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e 0a 2a  e3_errmsg16()..*
9640: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 66 69  /.int sqlite3_fi
9650: 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 33 5f 73  nalize(sqlite3_s
9660: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 72  tmt *pStmt){.  r
9670: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62  eturn sqlite3Vdb
9680: 65 46 69 6e 61 6c 69 7a 65 28 28 56 64 62 65 2a  eFinalize((Vdbe*
9690: 29 70 53 74 6d 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  )pStmt);.}../*.*
96a0: 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68 65 20  * Terminate the 
96b0: 63 75 72 72 65 6e 74 20 65 78 65 63 75 74 69 6f  current executio
96c0: 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 74 61 74  n of an SQL stat
96d0: 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 65 74 20  ement and reset 
96e0: 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 69 74  it.** back to it
96f0: 73 20 73 74 61 72 74 69 6e 67 20 73 74 61 74 65  s starting state
9700: 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20   so that it can 
9710: 62 65 20 72 65 75 73 65 64 2e 20 41 20 73 75 63  be reused. A suc
9720: 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d 0a 2a  cess code from.*
9730: 2a 20 74 68 65 20 70 72 69 6f 72 20 65 78 65 63  * the prior exec
9740: 75 74 69 6f 6e 20 69 73 20 72 65 74 75 72 6e 65  ution is returne
9750: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  d..**.** This ro
9760: 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 65  utine sets the e
9770: 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 74  rror code and st
9780: 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62 79  ring returned by
9790: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 63  .** sqlite3_errc
97a0: 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f 65  ode(), sqlite3_e
97b0: 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69  rrmsg() and sqli
97c0: 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e 0a  te3_errmsg16()..
97d0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 72  */.int sqlite3_r
97e0: 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  eset(sqlite3_stm
97f0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74  t *pStmt){.  int
9800: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
9810: 65 52 65 73 65 74 28 28 56 64 62 65 2a 29 70 53  eReset((Vdbe*)pS
9820: 74 6d 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  tmt);.  sqlite3V
9830: 64 62 65 4d 61 6b 65 52 65 61 64 79 28 28 56 64  dbeMakeReady((Vd
9840: 62 65 2a 29 70 53 74 6d 74 2c 20 2d 31 2c 20 30  be*)pStmt, -1, 0
9850: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
9860: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65  }../*.** Registe
9870: 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f  r a new collatio
9880: 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20  n sequence with 
9890: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e  the database han
98a0: 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73  dle db..*/.int s
98b0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f  qlite3_create_co
98c0: 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74  llation(.  sqlit
98d0: 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74  e3* db, .  const
98e0: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20   char *zName, . 
98f0: 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69   int enc, .  voi
9900: 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a  d* pCtx,.  int(*
9910: 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c  xCompare)(void*,
9920: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c  int,const void*,
9930: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29  int,const void*)
9940: 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70  .){.  CollSeq *p
9950: 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 72 63 20 3d  Coll;.  int rc =
9960: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 0a 20   SQLITE_OK;.  . 
9970: 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54   /* If SQLITE_UT
9980: 46 31 36 20 69 73 20 73 70 65 63 69 66 69 65 64  F16 is specified
9990: 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67   as the encoding
99a0: 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d   type, transform
99b0: 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e   this.  ** to on
99c0: 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31  e of SQLITE_UTF1
99d0: 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54  6LE or SQLITE_UT
99e0: 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a  F16BE using the.
99f0: 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31    ** SQLITE_UTF1
9a00: 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53  6NATIVE macro. S
9a10: 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e  QLITE_UTF16 is n
9a20: 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c  ot used internal
9a30: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65  ly..  */.  if( e
9a40: 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36  nc==SQLITE_UTF16
9a50: 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51   ){.    enc = SQ
9a60: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45  LITE_UTF16NATIVE
9a70: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 65 6e 63  ;.  }..  if( enc
9a80: 21 3d 53 51 4c 49 54 45 5f 55 54 46 38 20 26 26  !=SQLITE_UTF8 &&
9a90: 20 65 6e 63 21 3d 53 51 4c 49 54 45 5f 55 54 46   enc!=SQLITE_UTF
9aa0: 31 36 4c 45 20 26 26 20 65 6e 63 21 3d 53 51 4c  16LE && enc!=SQL
9ab0: 49 54 45 5f 55 54 46 31 36 42 45 20 29 7b 0a 20  ITE_UTF16BE ){. 
9ac0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
9ad0: 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  db, SQLITE_ERROR
9ae0: 2c 20 0a 20 20 20 20 20 20 20 20 22 50 61 72 61  , .        "Para
9af0: 6d 20 33 20 74 6f 20 73 71 6c 69 74 65 33 5f 63  m 3 to sqlite3_c
9b00: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
9b10: 29 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 6f 66  ) must be one of
9b20: 20 22 0a 20 20 20 20 20 20 20 20 22 53 51 4c 49   ".        "SQLI
9b30: 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f  TE_UTF8, SQLITE_
9b40: 55 54 46 31 36 2c 20 53 51 4c 49 54 45 5f 55 54  UTF16, SQLITE_UT
9b50: 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f  F16LE or SQLITE_
9b60: 55 54 46 31 36 42 45 22 0a 20 20 20 20 29 3b 0a  UTF16BE".    );.
9b70: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
9b80: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 70  E_ERROR;.  }.  p
9b90: 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69  Coll = sqlite3Fi
9ba0: 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75  ndCollSeq(db, (u
9bb0: 38 29 65 6e 63 2c 20 7a 4e 61 6d 65 2c 20 73 74  8)enc, zName, st
9bc0: 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 31 29 3b  rlen(zName), 1);
9bd0: 0a 20 20 69 66 28 20 30 3d 3d 70 43 6f 6c 6c 20  .  if( 0==pColl 
9be0: 29 7b 0a 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ){.   rc = SQLIT
9bf0: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73 65  E_NOMEM;.  }else
9c00: 7b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 78 43 6d  {.    pColl->xCm
9c10: 70 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a 20 20  p = xCompare;.  
9c20: 20 20 70 43 6f 6c 6c 2d 3e 70 55 73 65 72 20 3d    pColl->pUser =
9c30: 20 70 43 74 78 3b 0a 20 20 20 20 70 43 6f 6c 6c   pCtx;.    pColl
9c40: 2d 3e 65 6e 63 20 3d 20 65 6e 63 3b 0a 20 20 7d  ->enc = enc;.  }
9c50: 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28  .  sqlite3Error(
9c60: 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20 72 65  db, rc, 0);.  re
9c70: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
9c80: 2a 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77  * Register a new
9c90: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65   collation seque
9ca0: 6e 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74  nce with the dat
9cb0: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e  abase handle db.
9cc0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
9cd0: 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e  create_collation
9ce0: 31 36 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64  16(.  sqlite3* d
9cf0: 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72  b, .  const char
9d00: 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20   *zName, .  int 
9d10: 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43  enc, .  void* pC
9d20: 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70  tx,.  int(*xComp
9d30: 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63  are)(void*,int,c
9d40: 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63  onst void*,int,c
9d50: 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20  onst void*).){. 
9d60: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4e 61   char const *zNa
9d70: 6d 65 38 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76  me8;.  sqlite3_v
9d80: 61 6c 75 65 20 2a 70 54 6d 70 20 3d 20 73 71 6c  alue *pTmp = sql
9d90: 69 74 65 33 47 65 74 54 72 61 6e 73 69 65 6e 74  ite3GetTransient
9da0: 56 61 6c 75 65 28 64 62 29 3b 0a 20 20 73 71 6c  Value(db);.  sql
9db0: 69 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28  ite3ValueSetStr(
9dc0: 70 54 6d 70 2c 20 2d 31 2c 20 7a 4e 61 6d 65 2c  pTmp, -1, zName,
9dd0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
9de0: 49 56 45 2c 20 53 51 4c 49 54 45 5f 53 54 41 54  IVE, SQLITE_STAT
9df0: 49 43 29 3b 0a 20 20 7a 4e 61 6d 65 38 20 3d 20  IC);.  zName8 = 
9e00: 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74  sqlite3ValueText
9e10: 28 70 54 6d 70 2c 20 53 51 4c 49 54 45 5f 55 54  (pTmp, SQLITE_UT
9e20: 46 38 29 3b 0a 20 20 72 65 74 75 72 6e 20 73 71  F8);.  return sq
9e30: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c  lite3_create_col
9e40: 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65  lation(db, zName
9e50: 38 2c 20 65 6e 63 2c 20 70 43 74 78 2c 20 78 43  8, enc, pCtx, xC
9e60: 6f 6d 70 61 72 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  ompare);.}../*.*
9e70: 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c  * Register a col
9e80: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20  lation sequence 
9e90: 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b  factory callback
9ea0: 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61   with the databa
9eb0: 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e  se handle.** db.
9ec0: 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65   Replace any pre
9ed0: 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65  viously installe
9ee0: 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75  d collation sequ
9ef0: 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f  ence factory..*/
9f00: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c  .int sqlite3_col
9f10: 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 28 0a 20  lation_needed(. 
9f20: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20   sqlite3 *db, . 
9f30: 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64   void *pCollNeed
9f40: 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a  edArg, .  void(*
9f50: 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69  xCollNeeded)(voi
9f60: 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20  d*,sqlite3*,int 
9f70: 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 63  eTextRep,const c
9f80: 68 61 72 2a 29 0a 29 7b 0a 20 20 64 62 2d 3e 78  har*).){.  db->x
9f90: 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 78 43 6f  CollNeeded = xCo
9fa0: 6c 6c 4e 65 65 64 65 64 3b 0a 20 20 64 62 2d 3e  llNeeded;.  db->
9fb0: 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20  xCollNeeded16 = 
9fc0: 30 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65  0;.  db->pCollNe
9fd0: 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e  ededArg = pCollN
9fe0: 65 65 64 65 64 41 72 67 3b 0a 20 20 72 65 74 75  eededArg;.  retu
9ff0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
a000: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20  ./*.** Register 
a010: 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75  a collation sequ
a020: 65 6e 63 65 20 66 61 63 74 6f 72 79 20 63 61 6c  ence factory cal
a030: 6c 62 61 63 6b 20 77 69 74 68 20 74 68 65 20 64  lback with the d
a040: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a  atabase handle.*
a050: 2a 20 64 62 2e 20 52 65 70 6c 61 63 65 20 61 6e  * db. Replace an
a060: 79 20 70 72 65 76 69 6f 75 73 6c 79 20 69 6e 73  y previously ins
a070: 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e  talled collation
a080: 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72   sequence factor
a090: 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  y..*/.int sqlite
a0a0: 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64  3_collation_need
a0b0: 65 64 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20  ed16(.  sqlite3 
a0c0: 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43  *db, .  void *pC
a0d0: 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20 0a 20  ollNeededArg, . 
a0e0: 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64   void(*xCollNeed
a0f0: 65 64 31 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69  ed16)(void*,sqli
a100: 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65  te3*,int eTextRe
a110: 70 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29  p,const void*).)
a120: 7b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65  {.  db->xCollNee
a130: 64 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 78  ded = 0;.  db->x
a140: 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 78  CollNeeded16 = x
a150: 43 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a 20 20  CollNeeded16;.  
a160: 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41  db->pCollNeededA
a170: 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64  rg = pCollNeeded
a180: 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  Arg;.  return SQ
a190: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a                 LITE_OK;.}.