/ Hex Artifact Content
Login

Artifact c1d8d2022a65104c847880882fbce9ba32381530:


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 33 31 35 20 32 30 30 36 2f 30 31  ,v 1.315 2006/01
0280: 2f 30 35 20 31 33 3a 34 38 3a 32 39 20 64 61 6e  /05 13:48:29 dan
0290: 69 65 6c 6b 31 39 37 37 20 45 78 70 20 24 0a 2a  ielk1977 Exp $.*
02a0: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69  /.#include "sqli
02b0: 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64  teInt.h".#includ
02c0: 65 20 22 6f 73 2e 68 22 0a 23 69 6e 63 6c 75 64  e "os.h".#includ
02d0: 65 20 3c 63 74 79 70 65 2e 68 3e 0a 0a 2f 2a 0a  e <ctype.h>../*.
02e0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
02f0: 20 63 6f 6e 73 74 61 6e 74 20 76 61 6c 75 65 20   constant value 
0300: 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20 53  is used by the S
0310: 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 20  QLITE_BIGENDIAN 
0320: 61 6e 64 0a 2a 2a 20 53 51 4c 49 54 45 5f 4c 49  and.** SQLITE_LI
0330: 54 54 4c 45 45 4e 44 49 41 4e 20 6d 61 63 72 6f  TTLEENDIAN macro
0340: 73 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 69 6e 74 20  s..*/.const int 
0350: 73 71 6c 69 74 65 33 6f 6e 65 20 3d 20 31 3b 0a  sqlite3one = 1;.
0360: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76 65 72 73 69  ./*.** The versi
0370: 6f 6e 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72  on of the librar
0380: 79 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20  y.*/.const char 
0390: 72 63 73 69 64 33 5b 5d 20 3d 20 22 40 28 23 29  rcsid3[] = "@(#)
03a0: 20 5c 30 34 34 49 64 3a 20 53 51 4c 69 74 65 20   \044Id: SQLite 
03b0: 76 65 72 73 69 6f 6e 20 22 20 53 51 4c 49 54 45  version " SQLITE
03c0: 5f 56 45 52 53 49 4f 4e 20 22 20 24 22 3b 0a 63  _VERSION " $";.c
03d0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
03e0: 33 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51  3_version[] = SQ
03f0: 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 63 6f  LITE_VERSION;.co
0400: 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65  nst char *sqlite
0410: 33 5f 6c 69 62 76 65 72 73 69 6f 6e 28 76 6f 69  3_libversion(voi
0420: 64 29 7b 20 72 65 74 75 72 6e 20 73 71 6c 69 74  d){ return sqlit
0430: 65 33 5f 76 65 72 73 69 6f 6e 3b 20 7d 0a 69 6e  e3_version; }.in
0440: 74 20 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72  t sqlite3_libver
0450: 73 69 6f 6e 5f 6e 75 6d 62 65 72 28 76 6f 69 64  sion_number(void
0460: 29 7b 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  ){ return SQLITE
0470: 5f 56 45 52 53 49 4f 4e 5f 4e 55 4d 42 45 52 3b  _VERSION_NUMBER;
0480: 20 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69   }../*.** This i
0490: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f  s the default co
04a0: 6c 6c 61 74 69 6e 67 20 66 75 6e 63 74 69 6f 6e  llating function
04b0: 20 6e 61 6d 65 64 20 22 42 49 4e 41 52 59 22 20   named "BINARY" 
04c0: 77 68 69 63 68 20 69 73 20 61 6c 77 61 79 73 0a  which is always.
04d0: 2a 2a 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a 2f  ** available..*/
04e0: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 69 6e 43  .static int binC
04f0: 6f 6c 6c 46 75 6e 63 28 0a 20 20 76 6f 69 64 20  ollFunc(.  void 
0500: 2a 4e 6f 74 55 73 65 64 2c 0a 20 20 69 6e 74 20  *NotUsed,.  int 
0510: 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69  nKey1, const voi
0520: 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20  d *pKey1,.  int 
0530: 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69  nKey2, const voi
0540: 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e  d *pKey2.){.  in
0550: 74 20 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d 20 6e  t rc, n;.  n = n
0560: 4b 65 79 31 3c 6e 4b 65 79 32 20 3f 20 6e 4b 65  Key1<nKey2 ? nKe
0570: 79 31 20 3a 20 6e 4b 65 79 32 3b 0a 20 20 72 63  y1 : nKey2;.  rc
0580: 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79 31 2c   = memcmp(pKey1,
0590: 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20 69 66   pKey2, n);.  if
05a0: 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 72  ( rc==0 ){.    r
05b0: 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b 65 79  c = nKey1 - nKey
05c0: 32 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  2;.  }.  return 
05d0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6e 6f  rc;.}../*.** Ano
05e0: 74 68 65 72 20 62 75 69 6c 74 2d 69 6e 20 63 6f  ther built-in co
05f0: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65  llating sequence
0600: 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a 2a 0a 2a 2a  : NOCASE. .**.**
0610: 20 54 68 69 73 20 63 6f 6c 6c 61 74 69 6e 67 20   This collating 
0620: 73 65 71 75 65 6e 63 65 20 69 73 20 69 6e 74 65  sequence is inte
0630: 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20  nded to be used 
0640: 66 6f 72 20 22 63 61 73 65 20 69 6e 64 65 70 65  for "case indepe
0650: 6e 64 61 6e 74 0a 2a 2a 20 63 6f 6d 70 61 72 69  ndant.** compari
0660: 73 6f 6e 22 2e 20 53 51 4c 69 74 65 27 73 20 6b  son". SQLite's k
0670: 6e 6f 77 6c 65 64 67 65 20 6f 66 20 75 70 70 65  nowledge of uppe
0680: 72 20 61 6e 64 20 6c 6f 77 65 72 20 63 61 73 65  r and lower case
0690: 20 65 71 75 69 76 61 6c 65 6e 74 73 0a 2a 2a 20   equivalents.** 
06a0: 65 78 74 65 6e 64 73 20 6f 6e 6c 79 20 74 6f 20  extends only to 
06b0: 74 68 65 20 32 36 20 63 68 61 72 61 63 74 65 72  the 26 character
06c0: 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 45 6e  s used in the En
06d0: 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 2e 0a  glish language..
06e0: 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 20 6d 6f 6d  **.** At the mom
06f0: 65 6e 74 20 74 68 65 72 65 20 69 73 20 6f 6e 6c  ent there is onl
0700: 79 20 61 20 55 54 46 2d 38 20 69 6d 70 6c 65 6d  y a UTF-8 implem
0710: 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61  entation..*/.sta
0720: 74 69 63 20 69 6e 74 20 6e 6f 63 61 73 65 43 6f  tic int nocaseCo
0730: 6c 6c 61 74 69 6e 67 46 75 6e 63 28 0a 20 20 76  llatingFunc(.  v
0740: 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a 20 20  oid *NotUsed,.  
0750: 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74  int nKey1, const
0760: 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20   void *pKey1,.  
0770: 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74  int nKey2, const
0780: 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a   void *pKey2.){.
0790: 20 20 69 6e 74 20 72 20 3d 20 73 71 6c 69 74 65    int r = sqlite
07a0: 33 53 74 72 4e 49 43 6d 70 28 0a 20 20 20 20 20  3StrNICmp(.     
07b0: 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70   (const char *)p
07c0: 4b 65 79 31 2c 20 28 63 6f 6e 73 74 20 63 68 61  Key1, (const cha
07d0: 72 20 2a 29 70 4b 65 79 32 2c 20 28 6e 4b 65 79  r *)pKey2, (nKey
07e0: 31 3c 6e 4b 65 79 32 29 3f 6e 4b 65 79 31 3a 6e  1<nKey2)?nKey1:n
07f0: 4b 65 79 32 29 3b 0a 20 20 69 66 28 20 30 3d 3d  Key2);.  if( 0==
0800: 72 20 29 7b 0a 20 20 20 20 72 20 3d 20 6e 4b 65  r ){.    r = nKe
0810: 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 20  y1-nKey2;.  }.  
0820: 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a 2f 2a 0a  return r;.}../*.
0830: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 52 4f  ** Return the RO
0840: 57 49 44 20 6f 66 20 74 68 65 20 6d 6f 73 74 20  WID of the most 
0850: 72 65 63 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f  recent insert.*/
0860: 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 71  .sqlite_int64 sq
0870: 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73 65 72  lite3_last_inser
0880: 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 65 33 20  t_rowid(sqlite3 
0890: 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64  *db){.  return d
08a0: 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d 0a  b->lastRowid;.}.
08b0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
08c0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e  e number of chan
08d0: 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74 20  ges in the most 
08e0: 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20 73  recent call to s
08f0: 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a  qlite3_exec()..*
0900: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 68  /.int sqlite3_ch
0910: 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64  anges(sqlite3 *d
0920: 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d  b){.  return db-
0930: 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a  >nChange;.}../*.
0940: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  ** Return the nu
0950: 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 20  mber of changes 
0960: 73 69 6e 63 65 20 74 68 65 20 64 61 74 61 62 61  since the databa
0970: 73 65 20 68 61 6e 64 6c 65 20 77 61 73 20 6f 70  se handle was op
0980: 65 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ened..*/.int sql
0990: 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e 67  ite3_total_chang
09a0: 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  es(sqlite3 *db){
09b0: 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e 54  .  return db->nT
09c0: 6f 74 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f  otalChange;.}../
09d0: 2a 0a 2a 2a 20 46 72 65 65 20 61 20 73 63 68 65  *.** Free a sche
09e0: 6d 61 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f  ma structure..*/
09f0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 63 68  .void sqlite3Sch
0a00: 65 6d 61 46 72 65 65 28 76 6f 69 64 20 2a 70 29  emaFree(void *p)
0a10: 7b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  {.  sqliteFree(p
0a20: 29 3b 0a 7d 0a 0a 44 62 53 63 68 65 6d 61 20 2a  );.}..DbSchema *
0a30: 73 71 6c 69 74 65 33 53 63 68 65 6d 61 47 65 74  sqlite3SchemaGet
0a40: 28 42 74 72 65 65 20 2a 70 42 74 29 7b 0a 20 20  (Btree *pBt){.  
0a50: 44 62 53 63 68 65 6d 61 20 2a 20 70 3b 0a 20 20  DbSchema * p;.  
0a60: 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 70  if( pBt ){.    p
0a70: 20 3d 20 28 44 62 53 63 68 65 6d 61 20 2a 29 73   = (DbSchema *)s
0a80: 71 6c 69 74 65 33 42 74 72 65 65 53 63 68 65 6d  qlite3BtreeSchem
0a90: 61 28 70 42 74 2c 73 69 7a 65 6f 66 28 44 62 53  a(pBt,sizeof(DbS
0aa0: 63 68 65 6d 61 29 2c 73 71 6c 69 74 65 33 53 63  chema),sqlite3Sc
0ab0: 68 65 6d 61 46 72 65 65 29 3b 0a 20 20 7d 65 6c  hemaFree);.  }el
0ac0: 73 65 7b 0a 20 20 20 20 70 20 3d 20 28 44 62 53  se{.    p = (DbS
0ad0: 63 68 65 6d 61 20 2a 29 73 71 6c 69 74 65 4d 61  chema *)sqliteMa
0ae0: 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 44 62 53 63  lloc(sizeof(DbSc
0af0: 68 65 6d 61 29 29 3b 0a 20 20 7d 0a 20 20 69 66  hema));.  }.  if
0b00: 28 20 70 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ( p ){.    sqlit
0b10: 65 33 48 61 73 68 49 6e 69 74 28 26 70 2d 3e 74  e3HashInit(&p->t
0b20: 62 6c 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48  blHash, SQLITE_H
0b30: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
0b40: 20 20 20 20 73 71 6c 69 74 65 33 48 61 73 68 49      sqlite3HashI
0b50: 6e 69 74 28 26 70 2d 3e 69 64 78 48 61 73 68 2c  nit(&p->idxHash,
0b60: 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52   SQLITE_HASH_STR
0b70: 49 4e 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c  ING, 0);.    sql
0b80: 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 70 2d  ite3HashInit(&p-
0b90: 3e 74 72 69 67 48 61 73 68 2c 20 53 51 4c 49 54  >trigHash, SQLIT
0ba0: 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30  E_HASH_STRING, 0
0bb0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 48 61  );.    sqlite3Ha
0bc0: 73 68 49 6e 69 74 28 26 70 2d 3e 61 46 4b 65 79  shInit(&p->aFKey
0bd0: 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54  , SQLITE_HASH_ST
0be0: 52 49 4e 47 2c 20 31 29 3b 0a 20 20 7d 0a 20 20  RING, 1);.  }.  
0bf0: 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 69 6e 74  return p;.}..int
0c00: 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 54 6f   sqlite3SchemaTo
0c10: 49 6e 64 65 78 28 73 71 6c 69 74 65 33 20 2a 64  Index(sqlite3 *d
0c20: 62 2c 20 44 62 53 63 68 65 6d 61 20 2a 70 53 63  b, DbSchema *pSc
0c30: 68 65 6d 61 29 7b 0a 20 20 69 6e 74 20 69 20 3d  hema){.  int i =
0c40: 20 2d 31 30 30 30 30 30 30 3b 0a 0a 20 20 2f 2a   -1000000;..  /*
0c50: 20 49 66 20 70 53 63 68 65 6d 61 20 69 73 20 4e   If pSchema is N
0c60: 55 4c 4c 2c 20 74 68 65 6e 20 72 65 74 75 72 6e  ULL, then return
0c70: 20 2d 31 30 30 30 30 30 30 2e 20 54 68 69 73 20   -1000000. This 
0c80: 68 61 70 70 65 6e 73 20 77 68 65 6e 20 63 6f 64  happens when cod
0c90: 65 20 69 6e 20 0a 20 20 2a 2a 20 65 78 70 72 2e  e in .  ** expr.
0ca0: 63 20 69 73 20 74 72 79 69 6e 67 20 74 6f 20 72  c is trying to r
0cb0: 65 73 6f 6c 76 65 20 61 20 72 65 66 65 72 65 6e  esolve a referen
0cc0: 63 65 20 74 6f 20 61 20 74 72 61 6e 73 69 65 6e  ce to a transien
0cd0: 74 20 74 61 62 6c 65 20 28 69 2e 65 2e 20 6f 6e  t table (i.e. on
0ce0: 65 0a 20 20 2a 2a 20 63 72 65 61 74 65 64 20 62  e.  ** created b
0cf0: 79 20 61 20 73 75 62 2d 73 65 6c 65 63 74 29 2e  y a sub-select).
0d00: 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68   In this case th
0d10: 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 6f  e return value o
0d20: 66 20 74 68 69 73 20 0a 20 20 2a 2a 20 66 75 6e  f this .  ** fun
0d30: 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 6e 65 76  ction should nev
0d40: 65 72 20 62 65 20 75 73 65 64 2e 0a 20 20 2a 2a  er be used..  **
0d50: 0a 20 20 2a 2a 20 57 65 20 72 65 74 75 72 6e 20  .  ** We return 
0d60: 2d 31 30 30 30 30 30 30 20 69 6e 73 74 65 61 64  -1000000 instead
0d70: 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 75 73 75   of the more usu
0d80: 61 6c 20 2d 31 20 73 69 6d 70 6c 79 20 62 65 63  al -1 simply bec
0d90: 61 75 73 65 20 75 73 69 6e 67 0a 20 20 2a 2a 20  ause using.  ** 
0da0: 2d 31 30 30 30 30 30 30 20 61 73 20 69 6e 63 6f  -1000000 as inco
0db0: 72 72 65 63 74 6c 79 20 75 73 69 6e 67 20 2d 31  rrectly using -1
0dc0: 30 30 30 30 30 30 20 69 6e 64 65 78 20 69 6e 74  000000 index int
0dd0: 6f 20 64 62 2d 3e 61 44 62 5b 5d 20 69 73 20 6d  o db->aDb[] is m
0de0: 75 63 68 20 0a 20 20 2a 2a 20 6d 6f 72 65 20 6c  uch .  ** more l
0df0: 69 6b 65 6c 79 20 74 6f 20 63 61 75 73 65 20 61  ikely to cause a
0e00: 20 73 65 67 66 61 75 6c 74 20 74 68 61 6e 20 2d   segfault than -
0e10: 31 20 28 6f 66 20 63 6f 75 72 73 65 20 74 68 65  1 (of course the
0e20: 72 65 20 61 72 65 20 61 73 73 65 72 74 28 29 0a  re are assert().
0e30: 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 20    ** statements 
0e40: 74 6f 6f 2c 20 62 75 74 20 69 74 20 6e 65 76 65  too, but it neve
0e50: 72 20 68 75 72 74 73 20 74 6f 20 70 6c 61 79 20  r hurts to play 
0e60: 74 68 65 20 6f 64 64 73 29 2e 0a 20 20 2a 2f 0a  the odds)..  */.
0e70: 20 20 69 66 28 20 70 53 63 68 65 6d 61 20 29 7b    if( pSchema ){
0e80: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
0e90: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20  db->nDb; i++){. 
0ea0: 20 20 20 20 20 69 66 28 20 64 62 2d 3e 61 44 62       if( db->aDb
0eb0: 5b 69 5d 2e 70 53 63 68 65 6d 61 3d 3d 70 53 63  [i].pSchema==pSc
0ec0: 68 65 6d 61 20 29 7b 0a 20 20 20 20 20 20 20 20  hema ){.        
0ed0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20  break;.      }. 
0ee0: 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28     }.    assert(
0ef0: 20 69 3e 3d 30 20 26 26 69 3e 3d 30 20 26 26 20   i>=0 &&i>=0 && 
0f00: 20 69 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20 20   i<db->nDb );.  
0f10: 7d 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d 0a  }.  return i;.}.
0f20: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20  ./*.** Close an 
0f30: 65 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20  existing SQLite 
0f40: 64 61 74 61 62 61 73 65 0a 2a 2f 0a 69 6e 74 20  database.*/.int 
0f50: 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 73 71  sqlite3_close(sq
0f60: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 48 61  lite3 *db){.  Ha
0f70: 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 69 6e 74  shElem *i;.  int
0f80: 20 6a 3b 0a 0a 20 20 69 66 28 20 21 64 62 20 29   j;..  if( !db )
0f90: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
0fa0: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66  ITE_OK;.  }.  if
0fb0: 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 43  ( sqlite3SafetyC
0fc0: 68 65 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20  heck(db) ){.    
0fd0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
0fe0: 53 55 53 45 3b 0a 20 20 7d 0a 0a 23 69 66 64 65  SUSE;.  }..#ifde
0ff0: 66 20 53 51 4c 49 54 45 5f 53 53 45 0a 20 20 73  f SQLITE_SSE.  s
1000: 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28  qlite3_finalize(
1010: 64 62 2d 3e 70 46 65 74 63 68 29 3b 0a 23 65 6e  db->pFetch);.#en
1020: 64 69 66 20 0a 0a 20 20 2f 2a 20 49 66 20 74 68  dif ..  /* If th
1030: 65 72 65 20 61 72 65 20 61 6e 79 20 6f 75 74 73  ere are any outs
1040: 74 61 6e 64 69 6e 67 20 56 4d 73 2c 20 72 65 74  tanding VMs, ret
1050: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e  urn SQLITE_BUSY.
1060: 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 70 56   */.  if( db->pV
1070: 64 62 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  dbe ){.    sqlit
1080: 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49  e3Error(db, SQLI
1090: 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 20 20  TE_BUSY, .      
10a0: 20 20 22 55 6e 61 62 6c 65 20 74 6f 20 63 6c 6f    "Unable to clo
10b0: 73 65 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61  se due to unfina
10c0: 6c 69 73 65 64 20 73 74 61 74 65 6d 65 6e 74 73  lised statements
10d0: 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  ");.    return S
10e0: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a  QLITE_BUSY;.  }.
10f0: 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 74    assert( !sqlit
1100: 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 62  e3SafetyCheck(db
1110: 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 49 58 20 4d  ) );..  /* FIX M
1120: 45 3a 20 64 62 2d 3e 6d 61 67 69 63 20 6d 61 79  E: db->magic may
1130: 20 62 65 20 73 65 74 20 74 6f 20 53 51 4c 49 54   be set to SQLIT
1140: 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 69  E_MAGIC_CLOSED i
1150: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20  f the database. 
1160: 20 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 20 6f 70   ** cannot be op
1170: 65 6e 65 64 20 66 6f 72 20 73 6f 6d 65 20 72 65  ened for some re
1180: 61 73 6f 6e 2e 20 53 6f 20 74 68 69 73 20 72 6f  ason. So this ro
1190: 75 74 69 6e 65 20 6e 65 65 64 73 20 74 6f 20 72  utine needs to r
11a0: 75 6e 20 69 6e 0a 20 20 2a 2a 20 74 68 61 74 20  un in.  ** that 
11b0: 63 61 73 65 2e 20 42 75 74 20 6d 61 79 62 65 20  case. But maybe 
11c0: 74 68 65 72 65 20 73 68 6f 75 6c 64 20 62 65 20  there should be 
11d0: 61 6e 20 65 78 74 72 61 20 6d 61 67 69 63 20 76  an extra magic v
11e0: 61 6c 75 65 20 66 6f 72 20 74 68 65 0a 20 20 2a  alue for the.  *
11f0: 2a 20 22 66 61 69 6c 65 64 20 74 6f 20 6f 70 65  * "failed to ope
1200: 6e 22 20 73 74 61 74 65 2e 0a 20 20 2a 2f 0a 20  n" state..  */. 
1210: 20 69 66 28 20 64 62 2d 3e 6d 61 67 69 63 21 3d   if( db->magic!=
1220: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f  SQLITE_MAGIC_CLO
1230: 53 45 44 20 26 26 20 73 71 6c 69 74 65 33 53 61  SED && sqlite3Sa
1240: 66 65 74 79 4f 6e 28 64 62 29 20 29 7b 0a 20 20  fetyOn(db) ){.  
1250: 20 20 2f 2a 20 70 72 69 6e 74 66 28 22 44 49 44    /* printf("DID
1260: 20 4e 4f 54 20 43 4c 4f 53 45 5c 6e 22 29 3b 20   NOT CLOSE\n"); 
1270: 66 66 6c 75 73 68 28 73 74 64 6f 75 74 29 3b 20  fflush(stdout); 
1280: 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  */.    return SQ
1290: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a  LITE_ERROR;.  }.
12a0: 0a 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 63 6c  .  /* sqlite3_cl
12b0: 6f 73 65 28 29 20 6d 61 79 20 6e 6f 74 20 69 6e  ose() may not in
12c0: 76 6f 6b 65 20 73 71 6c 69 74 65 4d 61 6c 6c 6f  voke sqliteMallo
12d0: 63 28 29 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65  c(). */.  sqlite
12e0: 33 4d 61 6c 6c 6f 63 44 69 73 61 6c 6c 6f 77 28  3MallocDisallow(
12f0: 29 3b 0a 0a 20 20 66 6f 72 28 6a 3d 30 3b 20 6a  );..  for(j=0; j
1300: 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 7b 0a  <db->nDb; j++){.
1310: 20 20 20 20 73 74 72 75 63 74 20 44 62 20 2a 70      struct Db *p
1320: 44 62 20 3d 20 26 64 62 2d 3e 61 44 62 5b 6a 5d  Db = &db->aDb[j]
1330: 3b 0a 20 20 20 20 69 66 28 20 70 44 62 2d 3e 70  ;.    if( pDb->p
1340: 42 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  Bt ){.      sqli
1350: 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70 44  te3BtreeClose(pD
1360: 62 2d 3e 70 42 74 29 3b 0a 20 20 20 20 20 20 70  b->pBt);.      p
1370: 44 62 2d 3e 70 42 74 20 3d 20 30 3b 0a 20 20 20  Db->pBt = 0;.   
1380: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33   }.  }.  sqlite3
1390: 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68  ResetInternalSch
13a0: 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 61 73  ema(db, 0);.  as
13b0: 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 3c 3d 32  sert( db->nDb<=2
13c0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62   );.  assert( db
13d0: 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 44 62 53 74  ->aDb==db->aDbSt
13e0: 61 74 69 63 20 29 3b 0a 20 20 66 6f 72 28 69 3d  atic );.  for(i=
13f0: 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74 28  sqliteHashFirst(
1400: 26 64 62 2d 3e 61 46 75 6e 63 29 3b 20 69 3b 20  &db->aFunc); i; 
1410: 69 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 74  i=sqliteHashNext
1420: 28 69 29 29 7b 0a 20 20 20 20 46 75 6e 63 44 65  (i)){.    FuncDe
1430: 66 20 2a 70 46 75 6e 63 2c 20 2a 70 4e 65 78 74  f *pFunc, *pNext
1440: 3b 0a 20 20 20 20 66 6f 72 28 70 46 75 6e 63 20  ;.    for(pFunc 
1450: 3d 20 28 46 75 6e 63 44 65 66 2a 29 73 71 6c 69  = (FuncDef*)sqli
1460: 74 65 48 61 73 68 44 61 74 61 28 69 29 3b 20 70  teHashData(i); p
1470: 46 75 6e 63 3b 20 70 46 75 6e 63 3d 70 4e 65 78  Func; pFunc=pNex
1480: 74 29 7b 0a 20 20 20 20 20 20 70 4e 65 78 74 20  t){.      pNext 
1490: 3d 20 70 46 75 6e 63 2d 3e 70 4e 65 78 74 3b 0a  = pFunc->pNext;.
14a0: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
14b0: 28 70 46 75 6e 63 29 3b 0a 20 20 20 20 7d 0a 20  (pFunc);.    }. 
14c0: 20 7d 0a 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69   }..  for(i=sqli
14d0: 74 65 48 61 73 68 46 69 72 73 74 28 26 64 62 2d  teHashFirst(&db-
14e0: 3e 61 43 6f 6c 6c 53 65 71 29 3b 20 69 3b 20 69  >aCollSeq); i; i
14f0: 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 74 28  =sqliteHashNext(
1500: 69 29 29 7b 0a 20 20 20 20 43 6f 6c 6c 53 65 71  i)){.    CollSeq
1510: 20 2a 70 43 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53   *pColl = (CollS
1520: 65 71 20 2a 29 73 71 6c 69 74 65 48 61 73 68 44  eq *)sqliteHashD
1530: 61 74 61 28 69 29 3b 0a 20 20 20 20 73 71 6c 69  ata(i);.    sqli
1540: 74 65 46 72 65 65 28 70 43 6f 6c 6c 29 3b 0a 20  teFree(pColl);. 
1550: 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68   }.  sqlite3Hash
1560: 43 6c 65 61 72 28 26 64 62 2d 3e 61 43 6f 6c 6c  Clear(&db->aColl
1570: 53 65 71 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33  Seq);..  sqlite3
1580: 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 61  HashClear(&db->a
1590: 46 75 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65 33  Func);.  sqlite3
15a0: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45  Error(db, SQLITE
15b0: 5f 4f 4b 2c 20 30 29 3b 20 2f 2a 20 44 65 61 6c  _OK, 0); /* Deal
15c0: 6c 6f 63 61 74 65 73 20 61 6e 79 20 63 61 63 68  locates any cach
15d0: 65 64 20 65 72 72 6f 72 20 73 74 72 69 6e 67 73  ed error strings
15e0: 2e 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 70  . */.  if( db->p
15f0: 45 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  Err ){.    sqlit
1600: 65 33 56 61 6c 75 65 46 72 65 65 28 64 62 2d 3e  e3ValueFree(db->
1610: 70 45 72 72 29 3b 0a 20 20 7d 0a 0a 20 20 64 62  pErr);.  }..  db
1620: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
1630: 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 20 20  _MAGIC_ERROR;.  
1640: 73 71 6c 69 74 65 46 72 65 65 28 64 62 2d 3e 61  sqliteFree(db->a
1650: 44 62 5b 31 5d 2e 70 53 63 68 65 6d 61 29 3b 0a  Db[1].pSchema);.
1660: 20 20 73 71 6c 69 74 65 46 72 65 65 28 64 62 29    sqliteFree(db)
1670: 3b 0a 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  ;.  sqlite3Mallo
1680: 63 41 6c 6c 6f 77 28 29 3b 0a 20 20 72 65 74 75  cAllow();.  retu
1690: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
16a0: 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20  ./*.** Rollback 
16b0: 61 6c 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c  all database fil
16c0: 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  es..*/.void sqli
16d0: 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73  te3RollbackAll(s
16e0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69  qlite3 *db){.  i
16f0: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 69 6e 54 72  nt i;.  int inTr
1700: 61 6e 73 20 3d 20 30 3b 0a 20 20 66 6f 72 28 69  ans = 0;.  for(i
1710: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
1720: 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d  ++){.    if( db-
1730: 3e 61 44 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20  >aDb[i].pBt ){. 
1740: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33       if( sqlite3
1750: 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 64  BtreeIsInTrans(d
1760: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 29 20 29  b->aDb[i].pBt) )
1770: 7b 0a 20 20 20 20 20 20 20 20 69 6e 54 72 61 6e  {.        inTran
1780: 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20  s = 1;.      }. 
1790: 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65       sqlite3Btre
17a0: 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44  eRollback(db->aD
17b0: 62 5b 69 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20  b[i].pBt);.     
17c0: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72   db->aDb[i].inTr
17d0: 61 6e 73 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20  ans = 0;.    }. 
17e0: 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 66 6c 61   }.  if( db->fla
17f0: 67 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e  gs&SQLITE_Intern
1800: 43 68 61 6e 67 65 73 20 29 7b 0a 20 20 20 20 73  Changes ){.    s
1810: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72  qlite3ResetInter
1820: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29  nalSchema(db, 0)
1830: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 6f  ;.  }..  /* If o
1840: 6e 65 20 68 61 73 20 62 65 65 6e 20 63 6f 6e 66  ne has been conf
1850: 69 67 75 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74  igured, invoke t
1860: 68 65 20 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b  he rollback-hook
1870: 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69   callback */.  i
1880: 66 28 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b  f( db->xRollback
1890: 43 61 6c 6c 62 61 63 6b 20 26 26 20 28 69 6e 54  Callback && (inT
18a0: 72 61 6e 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74  rans || !db->aut
18b0: 6f 43 6f 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20  oCommit) ){.    
18c0: 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c  db->xRollbackCal
18d0: 6c 62 61 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62  lback(db->pRollb
18e0: 61 63 6b 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a  ackArg);.  }.}..
18f0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73  /*.** Return a s
1900: 74 61 74 69 63 20 73 74 72 69 6e 67 20 74 68 61  tatic string tha
1910: 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20  t describes the 
1920: 6b 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 73 70  kind of error sp
1930: 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 0a 2a  ecified in the.*
1940: 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63  * argument..*/.c
1950: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74  onst char *sqlit
1960: 65 33 45 72 72 53 74 72 28 69 6e 74 20 72 63 29  e3ErrStr(int rc)
1970: 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  {.  const char *
1980: 7a 3b 0a 20 20 73 77 69 74 63 68 28 20 72 63 20  z;.  switch( rc 
1990: 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49  ){.    case SQLI
19a0: 54 45 5f 52 4f 57 3a 0a 20 20 20 20 63 61 73 65  TE_ROW:.    case
19b0: 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3a 0a 20 20   SQLITE_DONE:.  
19c0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b    case SQLITE_OK
19d0: 3a 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22 6e  :         z = "n
19e0: 6f 74 20 61 6e 20 65 72 72 6f 72 22 3b 20 20 20  ot an error";   
19f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1a00: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1a10: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 52    case SQLITE_ER
1a20: 52 4f 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 53  ROR:      z = "S
1a30: 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f  QL logic error o
1a40: 72 20 6d 69 73 73 69 6e 67 20 64 61 74 61 62 61  r missing databa
1a50: 73 65 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20  se";   break;.  
1a60: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 45    case SQLITE_PE
1a70: 52 4d 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61  RM:       z = "a
1a80: 63 63 65 73 73 20 70 65 72 6d 69 73 73 69 6f 6e  ccess permission
1a90: 20 64 65 6e 69 65 64 22 3b 20 20 20 20 20 20 20   denied";       
1aa0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1ab0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42    case SQLITE_AB
1ac0: 4f 52 54 3a 20 20 20 20 20 20 7a 20 3d 20 22 63  ORT:      z = "c
1ad0: 61 6c 6c 62 61 63 6b 20 72 65 71 75 65 73 74 65  allback requeste
1ae0: 64 20 71 75 65 72 79 20 61 62 6f 72 74 22 3b 20  d query abort"; 
1af0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1b00: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55    case SQLITE_BU
1b10: 53 59 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64  SY:       z = "d
1b20: 61 74 61 62 61 73 65 20 69 73 20 6c 6f 63 6b 65  atabase is locke
1b30: 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  d";             
1b40: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1b50: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f    case SQLITE_LO
1b60: 43 4b 45 44 3a 20 20 20 20 20 7a 20 3d 20 22 64  CKED:     z = "d
1b70: 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 73  atabase table is
1b80: 20 6c 6f 63 6b 65 64 22 3b 20 20 20 20 20 20 20   locked";       
1b90: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1ba0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f    case SQLITE_NO
1bb0: 4d 45 4d 3a 20 20 20 20 20 20 7a 20 3d 20 22 6f  MEM:      z = "o
1bc0: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 3b 20 20  ut of memory";  
1bd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1be0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1bf0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 45    case SQLITE_RE
1c00: 41 44 4f 4e 4c 59 3a 20 20 20 7a 20 3d 20 22 61  ADONLY:   z = "a
1c10: 74 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65 20  ttempt to write 
1c20: 61 20 72 65 61 64 6f 6e 6c 79 20 64 61 74 61 62  a readonly datab
1c30: 61 73 65 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20  ase";  break;.  
1c40: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e    case SQLITE_IN
1c50: 54 45 52 52 55 50 54 3a 20 20 7a 20 3d 20 22 69  TERRUPT:  z = "i
1c60: 6e 74 65 72 72 75 70 74 65 64 22 3b 20 20 20 20  nterrupted";    
1c70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c80: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1c90: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f    case SQLITE_IO
1ca0: 45 52 52 3a 20 20 20 20 20 20 7a 20 3d 20 22 64  ERR:      z = "d
1cb0: 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72 22 3b 20  isk I/O error"; 
1cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1cd0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1ce0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f    case SQLITE_CO
1cf0: 52 52 55 50 54 3a 20 20 20 20 7a 20 3d 20 22 64  RRUPT:    z = "d
1d00: 61 74 61 62 61 73 65 20 64 69 73 6b 20 69 6d 61  atabase disk ima
1d10: 67 65 20 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22  ge is malformed"
1d20: 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  ;      break;.  
1d30: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 55    case SQLITE_FU
1d40: 4c 4c 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 64  LL:       z = "d
1d50: 61 74 61 62 61 73 65 20 6f 72 20 64 69 73 6b 20  atabase or disk 
1d60: 69 73 20 66 75 6c 6c 22 3b 20 20 20 20 20 20 20  is full";       
1d70: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1d80: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 41    case SQLITE_CA
1d90: 4e 54 4f 50 45 4e 3a 20 20 20 7a 20 3d 20 22 75  NTOPEN:   z = "u
1da0: 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61  nable to open da
1db0: 74 61 62 61 73 65 20 66 69 6c 65 22 3b 20 20 20  tabase file";   
1dc0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1dd0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 52    case SQLITE_PR
1de0: 4f 54 4f 43 4f 4c 3a 20 20 20 7a 20 3d 20 22 64  OTOCOL:   z = "d
1df0: 61 74 61 62 61 73 65 20 6c 6f 63 6b 69 6e 67 20  atabase locking 
1e00: 70 72 6f 74 6f 63 6f 6c 20 66 61 69 6c 75 72 65  protocol failure
1e10: 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  ";     break;.  
1e20: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 4d    case SQLITE_EM
1e30: 50 54 59 3a 20 20 20 20 20 20 7a 20 3d 20 22 74  PTY:      z = "t
1e40: 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f  able contains no
1e50: 20 64 61 74 61 22 3b 20 20 20 20 20 20 20 20 20   data";         
1e60: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1e70: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43    case SQLITE_SC
1e80: 48 45 4d 41 3a 20 20 20 20 20 7a 20 3d 20 22 64  HEMA:     z = "d
1e90: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 68  atabase schema h
1ea0: 61 73 20 63 68 61 6e 67 65 64 22 3b 20 20 20 20  as changed";    
1eb0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1ec0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f    case SQLITE_CO
1ed0: 4e 53 54 52 41 49 4e 54 3a 20 7a 20 3d 20 22 63  NSTRAINT: z = "c
1ee0: 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64  onstraint failed
1ef0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
1f00: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1f10: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49    case SQLITE_MI
1f20: 53 4d 41 54 43 48 3a 20 20 20 7a 20 3d 20 22 64  SMATCH:   z = "d
1f30: 61 74 61 74 79 70 65 20 6d 69 73 6d 61 74 63 68  atatype mismatch
1f40: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
1f50: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
1f60: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49    case SQLITE_MI
1f70: 53 55 53 45 3a 20 20 20 20 20 7a 20 3d 20 22 6c  SUSE:     z = "l
1f80: 69 62 72 61 72 79 20 72 6f 75 74 69 6e 65 20 63  ibrary routine c
1f90: 61 6c 6c 65 64 20 6f 75 74 20 6f 66 20 73 65 71  alled out of seq
1fa0: 75 65 6e 63 65 22 3b 62 72 65 61 6b 3b 0a 20 20  uence";break;.  
1fb0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f    case SQLITE_NO
1fc0: 4c 46 53 3a 20 20 20 20 20 20 7a 20 3d 20 22 6b  LFS:      z = "k
1fd0: 65 72 6e 65 6c 20 6c 61 63 6b 73 20 6c 61 72 67  ernel lacks larg
1fe0: 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74 22 3b  e file support";
1ff0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
2000: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 55    case SQLITE_AU
2010: 54 48 3a 20 20 20 20 20 20 20 7a 20 3d 20 22 61  TH:       z = "a
2020: 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 64 65 6e  uthorization den
2030: 69 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20  ied";           
2040: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
2050: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4f    case SQLITE_FO
2060: 52 4d 41 54 3a 20 20 20 20 20 7a 20 3d 20 22 61  RMAT:     z = "a
2070: 75 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73  uxiliary databas
2080: 65 20 66 6f 72 6d 61 74 20 65 72 72 6f 72 22 3b  e format error";
2090: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
20a0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 41    case SQLITE_RA
20b0: 4e 47 45 3a 20 20 20 20 20 20 7a 20 3d 20 22 62  NGE:      z = "b
20c0: 69 6e 64 20 6f 72 20 63 6f 6c 75 6d 6e 20 69 6e  ind or column in
20d0: 64 65 78 20 6f 75 74 20 6f 66 20 72 61 6e 67 65  dex out of range
20e0: 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  ";     break;.  
20f0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f    case SQLITE_NO
2100: 54 41 44 42 3a 20 20 20 20 20 7a 20 3d 20 22 66  TADB:     z = "f
2110: 69 6c 65 20 69 73 20 65 6e 63 72 79 70 74 65 64  ile is encrypted
2120: 20 6f 72 20 69 73 20 6e 6f 74 20 61 20 64 61 74   or is not a dat
2130: 61 62 61 73 65 22 3b 62 72 65 61 6b 3b 0a 20 20  abase";break;.  
2140: 20 20 64 65 66 61 75 6c 74 3a 20 20 20 20 20 20    default:      
2150: 20 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22 75            z = "u
2160: 6e 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 20 20  nknown error";  
2170: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2180: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
2190: 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a  }.  return z;.}.
21a0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
21b0: 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61  ine implements a
21c0: 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 74   busy callback t
21d0: 68 61 74 20 73 6c 65 65 70 73 20 61 6e 64 20 74  hat sleeps and t
21e0: 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e  ries.** again un
21f0: 74 69 6c 20 61 20 74 69 6d 65 6f 75 74 20 76 61  til a timeout va
2200: 6c 75 65 20 69 73 20 72 65 61 63 68 65 64 2e 20  lue is reached. 
2210: 20 54 68 65 20 74 69 6d 65 6f 75 74 20 76 61 6c   The timeout val
2220: 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65  ue is.** an inte
2230: 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69  ger number of mi
2240: 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61 73 73 65  lliseconds passe
2250: 64 20 69 6e 20 61 73 20 74 68 65 20 66 69 72 73  d in as the firs
2260: 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a  t.** argument..*
2270: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c  /.static int sql
2280: 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 43 61  iteDefaultBusyCa
2290: 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a 70  llback(. void *p
22a0: 74 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  tr,             
22b0: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f    /* Database co
22c0: 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 69 6e 74  nnection */. int
22d0: 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20 20 20   count          
22e0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
22f0: 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65 20 68  of times table h
2300: 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a 2f 0a  as been busy */.
2310: 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 49  ){.#if SQLITE_MI
2320: 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20 20  N_SLEEP_MS==1.  
2330: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20  static const u8 
2340: 64 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 20 20 20  delays[] =.     
2350: 7b 20 31 2c 20 32 2c 20 35 2c 20 31 30 2c 20 31  { 1, 2, 5, 10, 1
2360: 35 2c 20 32 30 2c 20 32 35 2c 20 32 35 2c 20 20  5, 20, 25, 25,  
2370: 32 35 2c 20 20 35 30 2c 20 20 35 30 2c 20 31 30  25,  50,  50, 10
2380: 30 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f  0 };.  static co
2390: 6e 73 74 20 75 38 20 74 6f 74 61 6c 73 5b 5d 20  nst u8 totals[] 
23a0: 3d 0a 20 20 20 20 20 7b 20 30 2c 20 31 2c 20 33  =.     { 0, 1, 3
23b0: 2c 20 20 38 2c 20 31 38 2c 20 33 33 2c 20 35 33  ,  8, 18, 33, 53
23c0: 2c 20 37 38 2c 20 31 30 33 2c 20 31 32 38 2c 20  , 78, 103, 128, 
23d0: 31 37 38 2c 20 32 32 38 20 7d 3b 0a 23 20 64 65  178, 228 };.# de
23e0: 66 69 6e 65 20 4e 44 45 4c 41 59 20 28 73 69 7a  fine NDELAY (siz
23f0: 65 6f 66 28 64 65 6c 61 79 73 29 2f 73 69 7a 65  eof(delays)/size
2400: 6f 66 28 64 65 6c 61 79 73 5b 30 5d 29 29 0a 20  of(delays[0])). 
2410: 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28   int timeout = (
2420: 28 73 71 6c 69 74 65 33 20 2a 29 70 74 72 29 2d  (sqlite3 *)ptr)-
2430: 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b 0a 20 20  >busyTimeout;.  
2440: 69 6e 74 20 64 65 6c 61 79 2c 20 70 72 69 6f 72  int delay, prior
2450: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 6f 75  ;..  assert( cou
2460: 6e 74 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20 63  nt>=0 );.  if( c
2470: 6f 75 6e 74 20 3c 20 4e 44 45 4c 41 59 20 29 7b  ount < NDELAY ){
2480: 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c  .    delay = del
2490: 61 79 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 20 20  ays[count];.    
24a0: 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 63  prior = totals[c
24b0: 6f 75 6e 74 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a  ount];.  }else{.
24c0: 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61      delay = dela
24d0: 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b 0a 20 20  ys[NDELAY-1];.  
24e0: 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73    prior = totals
24f0: 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20 64 65 6c  [NDELAY-1] + del
2500: 61 79 2a 28 63 6f 75 6e 74 2d 28 4e 44 45 4c 41  ay*(count-(NDELA
2510: 59 2d 31 29 29 3b 0a 20 20 7d 0a 20 20 69 66 28  Y-1));.  }.  if(
2520: 20 70 72 69 6f 72 20 2b 20 64 65 6c 61 79 20 3e   prior + delay >
2530: 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20   timeout ){.    
2540: 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75 74 20  delay = timeout 
2550: 2d 20 70 72 69 6f 72 3b 0a 20 20 20 20 69 66 28  - prior;.    if(
2560: 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 65 74 75   delay<=0 ) retu
2570: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  rn 0;.  }.  sqli
2580: 74 65 33 4f 73 2e 78 53 6c 65 65 70 28 64 65 6c  te3Os.xSleep(del
2590: 61 79 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b  ay);.  return 1;
25a0: 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 74 69 6d  .#else.  int tim
25b0: 65 6f 75 74 20 3d 20 28 28 73 71 6c 69 74 65 33  eout = ((sqlite3
25c0: 20 2a 29 70 74 72 29 2d 3e 62 75 73 79 54 69 6d   *)ptr)->busyTim
25d0: 65 6f 75 74 3b 0a 20 20 69 66 28 20 28 63 6f 75  eout;.  if( (cou
25e0: 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20 74 69 6d  nt+1)*1000 > tim
25f0: 65 6f 75 74 20 29 7b 0a 20 20 20 20 72 65 74 75  eout ){.    retu
2600: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  rn 0;.  }.  sqli
2610: 74 65 33 4f 73 2e 78 53 6c 65 65 70 28 31 30 30  te3Os.xSleep(100
2620: 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  0);.  return 1;.
2630: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  #endif.}../*.** 
2640: 49 6e 76 6f 6b 65 20 74 68 65 20 67 69 76 65 6e  Invoke the given
2650: 20 62 75 73 79 20 68 61 6e 64 6c 65 72 2e 0a 2a   busy handler..*
2660: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
2670: 65 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e  e is called when
2680: 20 61 6e 20 6f 70 65 72 61 74 69 6f 6e 20 66 61   an operation fa
2690: 69 6c 65 64 20 77 69 74 68 20 61 20 6c 6f 63 6b  iled with a lock
26a0: 2e 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 6f 75  ..** If this rou
26b0: 74 69 6e 65 20 72 65 74 75 72 6e 73 20 6e 6f 6e  tine returns non
26c0: 2d 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b 20  -zero, the lock 
26d0: 69 73 20 72 65 74 72 69 65 64 2e 20 20 49 66 20  is retried.  If 
26e0: 69 74 0a 2a 2a 20 72 65 74 75 72 6e 73 20 30 2c  it.** returns 0,
26f0: 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 61   the operation a
2700: 62 6f 72 74 73 20 77 69 74 68 20 61 6e 20 53 51  borts with an SQ
2710: 4c 49 54 45 5f 42 55 53 59 20 65 72 72 6f 72 2e  LITE_BUSY error.
2720: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49  .*/.int sqlite3I
2730: 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72  nvokeBusyHandler
2740: 28 42 75 73 79 48 61 6e 64 6c 65 72 20 2a 70 29  (BusyHandler *p)
2750: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66  {.  int rc;.  if
2760: 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 78 46 75  ( p==0 || p->xFu
2770: 6e 63 3d 3d 30 20 7c 7c 20 70 2d 3e 6e 42 75 73  nc==0 || p->nBus
2780: 79 3c 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  y<0 ) return 0;.
2790: 20 20 72 63 20 3d 20 70 2d 3e 78 46 75 6e 63 28    rc = p->xFunc(
27a0: 70 2d 3e 70 41 72 67 2c 20 70 2d 3e 6e 42 75 73  p->pArg, p->nBus
27b0: 79 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30 20  y);.  if( rc==0 
27c0: 29 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 79 20  ){.    p->nBusy 
27d0: 3d 20 2d 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  = -1;.  }else{. 
27e0: 20 20 20 70 2d 3e 6e 42 75 73 79 2b 2b 3b 0a 20     p->nBusy++;. 
27f0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 20   }.  return rc; 
2800: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
2810: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
2820: 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 66 6f  busy callback fo
2830: 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61  r an Sqlite data
2840: 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67  base to the.** g
2850: 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75  iven callback fu
2860: 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20  nction with the 
2870: 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 0a  given argument..
2880: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62  */.int sqlite3_b
2890: 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73  usy_handler(.  s
28a0: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 69 6e  qlite3 *db,.  in
28b0: 74 20 28 2a 78 42 75 73 79 29 28 76 6f 69 64 2a  t (*xBusy)(void*
28c0: 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a 70  ,int),.  void *p
28d0: 41 72 67 0a 29 7b 0a 20 20 69 66 28 20 73 71 6c  Arg.){.  if( sql
28e0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28  ite3SafetyCheck(
28f0: 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  db) ){.    retur
2900: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
2910: 0a 20 20 7d 0a 20 20 64 62 2d 3e 62 75 73 79 48  .  }.  db->busyH
2920: 61 6e 64 6c 65 72 2e 78 46 75 6e 63 20 3d 20 78  andler.xFunc = x
2930: 42 75 73 79 3b 0a 20 20 64 62 2d 3e 62 75 73 79  Busy;.  db->busy
2940: 48 61 6e 64 6c 65 72 2e 70 41 72 67 20 3d 20 70  Handler.pArg = p
2950: 41 72 67 3b 0a 20 20 64 62 2d 3e 62 75 73 79 48  Arg;.  db->busyH
2960: 61 6e 64 6c 65 72 2e 6e 42 75 73 79 20 3d 20 30  andler.nBusy = 0
2970: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
2980: 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66  E_OK;.}..#ifndef
2990: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f   SQLITE_OMIT_PRO
29a0: 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f  GRESS_CALLBACK./
29b0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
29c0: 65 20 73 65 74 73 20 74 68 65 20 70 72 6f 67 72  e sets the progr
29d0: 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72  ess callback for
29e0: 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61 62   an Sqlite datab
29f0: 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69  ase to the.** gi
2a00: 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e  ven callback fun
2a10: 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 67  ction with the g
2a20: 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54  iven argument. T
2a30: 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c  he progress call
2a40: 62 61 63 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 20  back will.** be 
2a50: 69 6e 76 6f 6b 65 64 20 65 76 65 72 79 20 6e 4f  invoked every nO
2a60: 70 73 20 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76  ps opcodes..*/.v
2a70: 6f 69 64 20 73 71 6c 69 74 65 33 5f 70 72 6f 67  oid sqlite3_prog
2a80: 72 65 73 73 5f 68 61 6e 64 6c 65 72 28 0a 20 20  ress_handler(.  
2a90: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20  sqlite3 *db, .  
2aa0: 69 6e 74 20 6e 4f 70 73 2c 0a 20 20 69 6e 74 20  int nOps,.  int 
2ab0: 28 2a 78 50 72 6f 67 72 65 73 73 29 28 76 6f 69  (*xProgress)(voi
2ac0: 64 2a 29 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41  d*), .  void *pA
2ad0: 72 67 0a 29 7b 0a 20 20 69 66 28 20 21 73 71 6c  rg.){.  if( !sql
2ae0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28  ite3SafetyCheck(
2af0: 64 62 29 20 29 7b 0a 20 20 20 20 69 66 28 20 6e  db) ){.    if( n
2b00: 4f 70 73 3e 30 20 29 7b 0a 20 20 20 20 20 20 64  Ops>0 ){.      d
2b10: 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d 20 78  b->xProgress = x
2b20: 50 72 6f 67 72 65 73 73 3b 0a 20 20 20 20 20 20  Progress;.      
2b30: 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73  db->nProgressOps
2b40: 20 3d 20 6e 4f 70 73 3b 0a 20 20 20 20 20 20 64   = nOps;.      d
2b50: 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 67 20  b->pProgressArg 
2b60: 3d 20 70 41 72 67 3b 0a 20 20 20 20 7d 65 6c 73  = pArg;.    }els
2b70: 65 7b 0a 20 20 20 20 20 20 64 62 2d 3e 78 50 72  e{.      db->xPr
2b80: 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 20  ogress = 0;.    
2b90: 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f    db->nProgressO
2ba0: 70 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 64 62  ps = 0;.      db
2bb0: 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 67 20 3d  ->pProgressArg =
2bc0: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a   0;.    }.  }.}.
2bd0: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54  #endif.../*.** T
2be0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6e 73 74  his routine inst
2bf0: 61 6c 6c 73 20 61 20 64 65 66 61 75 6c 74 20 62  alls a default b
2c00: 75 73 79 20 68 61 6e 64 6c 65 72 20 74 68 61 74  usy handler that
2c10: 20 77 61 69 74 73 20 66 6f 72 20 74 68 65 0a 2a   waits for the.*
2c20: 2a 20 73 70 65 63 69 66 69 65 64 20 6e 75 6d 62  * specified numb
2c30: 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e  er of millisecon
2c40: 64 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e  ds before return
2c50: 69 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ing 0..*/.int sq
2c60: 6c 69 74 65 33 5f 62 75 73 79 5f 74 69 6d 65 6f  lite3_busy_timeo
2c70: 75 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  ut(sqlite3 *db, 
2c80: 69 6e 74 20 6d 73 29 7b 0a 20 20 69 66 28 20 6d  int ms){.  if( m
2c90: 73 3e 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 62  s>0 ){.    db->b
2ca0: 75 73 79 54 69 6d 65 6f 75 74 20 3d 20 6d 73 3b  usyTimeout = ms;
2cb0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 62 75 73  .    sqlite3_bus
2cc0: 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 73 71  y_handler(db, sq
2cd0: 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 43  liteDefaultBusyC
2ce0: 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 2a 29  allback, (void*)
2cf0: 64 62 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  db);.  }else{.  
2d00: 20 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68    sqlite3_busy_h
2d10: 61 6e 64 6c 65 72 28 64 62 2c 20 30 2c 20 30 29  andler(db, 0, 0)
2d20: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53  ;.  }.  return S
2d30: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
2d40: 2a 2a 20 43 61 75 73 65 20 61 6e 79 20 70 65 6e  ** Cause any pen
2d50: 64 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e 20 74  ding operation t
2d60: 6f 20 73 74 6f 70 20 61 74 20 69 74 73 20 65 61  o stop at its ea
2d70: 72 6c 69 65 73 74 20 6f 70 70 6f 72 74 75 6e 69  rliest opportuni
2d80: 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ty..*/.void sqli
2d90: 74 65 33 5f 69 6e 74 65 72 72 75 70 74 28 73 71  te3_interrupt(sq
2da0: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66  lite3 *db){.  if
2db0: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79  ( !sqlite3Safety
2dc0: 43 68 65 63 6b 28 64 62 29 20 29 7b 0a 20 20 20  Check(db) ){.   
2dd0: 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51   db->flags |= SQ
2de0: 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b 0a  LITE_Interrupt;.
2df0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e    }.}../*.** Win
2e00: 64 6f 77 73 20 73 79 73 74 65 6d 73 20 73 68 6f  dows systems sho
2e10: 75 6c 64 20 63 61 6c 6c 20 74 68 69 73 20 72 6f  uld call this ro
2e20: 75 74 69 6e 65 20 74 6f 20 66 72 65 65 20 6d 65  utine to free me
2e30: 6d 6f 72 79 20 74 68 61 74 0a 2a 2a 20 69 73 20  mory that.** is 
2e40: 72 65 74 75 72 6e 65 64 20 69 6e 20 74 68 65 20  returned in the 
2e50: 69 6e 20 74 68 65 20 65 72 72 6d 73 67 20 70 61  in the errmsg pa
2e60: 72 61 6d 65 74 65 72 20 6f 66 20 73 71 6c 69 74  rameter of sqlit
2e70: 65 33 5f 6f 70 65 6e 28 29 20 77 68 65 6e 0a 2a  e3_open() when.*
2e80: 2a 20 53 51 4c 69 74 65 20 69 73 20 61 20 44 4c  * SQLite is a DL
2e90: 4c 2e 20 20 46 6f 72 20 73 6f 6d 65 20 72 65 61  L.  For some rea
2ea0: 73 6f 6e 2c 20 69 74 20 64 6f 65 73 20 6e 6f 74  son, it does not
2eb0: 20 77 6f 72 6b 20 74 6f 20 63 61 6c 6c 20 66 72   work to call fr
2ec0: 65 65 28 29 0a 2a 2a 20 64 69 72 65 63 74 6c 79  ee().** directly
2ed0: 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61  ..**.** Note tha
2ee0: 74 20 77 65 20 6e 65 65 64 20 74 6f 20 63 61 6c  t we need to cal
2ef0: 6c 20 66 72 65 65 28 29 20 6e 6f 74 20 73 71 6c  l free() not sql
2f00: 69 74 65 46 72 65 65 28 29 20 68 65 72 65 2e 0a  iteFree() here..
2f10: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  */.void sqlite3_
2f20: 66 72 65 65 28 63 68 61 72 20 2a 70 29 7b 20 66  free(char *p){ f
2f30: 72 65 65 28 70 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a  ree(p); }../*.**
2f40: 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 65 72   Create new user
2f50: 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 69   functions..*/.i
2f60: 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74  nt sqlite3_creat
2f70: 65 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71  e_function(.  sq
2f80: 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e  lite3 *db,.  con
2f90: 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 74 69  st char *zFuncti
2fa0: 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41  onName,.  int nA
2fb0: 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20  rg,.  int enc,. 
2fc0: 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61   void *pUserData
2fd0: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63  ,.  void (*xFunc
2fe0: 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  )(sqlite3_contex
2ff0: 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76  t*,int,sqlite3_v
3000: 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64  alue **),.  void
3010: 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65   (*xStep)(sqlite
3020: 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73  3_context*,int,s
3030: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29  qlite3_value **)
3040: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61  ,.  void (*xFina
3050: 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  l)(sqlite3_conte
3060: 78 74 2a 29 0a 29 7b 0a 20 20 46 75 6e 63 44 65  xt*).){.  FuncDe
3070: 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d  f *p;.  int nNam
3080: 65 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65  e;..  if( sqlite
3090: 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29  3SafetyCheck(db)
30a0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
30b0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
30c0: 7d 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 69 6f  }.  if( zFunctio
30d0: 6e 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 20 20  nName==0 ||.    
30e0: 20 20 28 78 46 75 6e 63 20 26 26 20 28 78 46 69    (xFunc && (xFi
30f0: 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 20 7c  nal || xStep)) |
3100: 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75 6e 63  | .      (!xFunc
3110: 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26 20 21   && (xFinal && !
3120: 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 20  xStep)) ||.     
3130: 20 28 21 78 46 75 6e 63 20 26 26 20 28 21 78 46   (!xFunc && (!xF
3140: 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29 29 20  inal && xStep)) 
3150: 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67 3c 2d  ||.      (nArg<-
3160: 31 20 7c 7c 20 6e 41 72 67 3e 31 32 37 29 20 7c  1 || nArg>127) |
3170: 7c 0a 20 20 20 20 20 20 28 32 35 35 3c 28 6e 4e  |.      (255<(nN
3180: 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a 46 75  ame = strlen(zFu
3190: 6e 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20 29 7b  nctionName))) ){
31a0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
31b0: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20  TE_ERROR;.  }.  
31c0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
31d0: 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 2f 2a 20  OMIT_UTF16.  /* 
31e0: 49 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20  If SQLITE_UTF16 
31f0: 69 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20  is specified as 
3200: 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 74 79 70  the encoding typ
3210: 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 69  e, transform thi
3220: 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66  s.  ** to one of
3230: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20   SQLITE_UTF16LE 
3240: 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42  or SQLITE_UTF16B
3250: 45 20 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a  E using the.  **
3260: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
3270: 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c 49 54  IVE macro. SQLIT
3280: 45 5f 55 54 46 31 36 20 69 73 20 6e 6f 74 20 75  E_UTF16 is not u
3290: 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a  sed internally..
32a0: 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 53 51 4c    **.  ** If SQL
32b0: 49 54 45 5f 41 4e 59 20 69 73 20 73 70 65 63 69  ITE_ANY is speci
32c0: 66 69 65 64 2c 20 61 64 64 20 74 68 72 65 65 20  fied, add three 
32d0: 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20  versions of the 
32e0: 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f  function.  ** to
32f0: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 2e   the hash table.
3300: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63 3d  .  */.  if( enc=
3310: 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 29 7b  =SQLITE_UTF16 ){
3320: 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54  .    enc = SQLIT
3330: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20  E_UTF16NATIVE;. 
3340: 20 7d 65 6c 73 65 20 69 66 28 20 65 6e 63 3d 3d   }else if( enc==
3350: 53 51 4c 49 54 45 5f 41 4e 59 20 29 7b 0a 20 20  SQLITE_ANY ){.  
3360: 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 72 63    int rc;.    rc
3370: 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74   = sqlite3_creat
3380: 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a  e_function(db, z
3390: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41  FunctionName, nA
33a0: 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c  rg, SQLITE_UTF8,
33b0: 0a 20 20 20 20 20 20 20 20 20 70 55 73 65 72 44  .         pUserD
33c0: 61 74 61 2c 20 78 46 75 6e 63 2c 20 78 53 74 65  ata, xFunc, xSte
33d0: 70 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20 20 20  p, xFinal);.    
33e0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
33f0: 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20  K ) return rc;. 
3400: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f     rc = sqlite3_
3410: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28  create_function(
3420: 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d  db, zFunctionNam
3430: 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f  e, nArg, SQLITE_
3440: 55 54 46 31 36 4c 45 2c 0a 20 20 20 20 20 20 20  UTF16LE,.       
3450: 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e   pUserData, xFun
3460: 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c  c, xStep, xFinal
3470: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53  );.    if( rc!=S
3480: 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72  QLITE_OK ) retur
3490: 6e 20 72 63 3b 0a 20 20 20 20 65 6e 63 20 3d 20  n rc;.    enc = 
34a0: 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b 0a  SQLITE_UTF16BE;.
34b0: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 20    }.#else.  enc 
34c0: 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 23  = SQLITE_UTF8;.#
34d0: 65 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 68  endif.  .  /* Ch
34e0: 65 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 69  eck if an existi
34f0: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 62  ng function is b
3500: 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e 20  eing overridden 
3510: 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 73  or deleted. If s
3520: 6f 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 72  o,.  ** and ther
3530: 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73  e are active VMs
3540: 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 51  , then return SQ
3550: 4c 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 20  LITE_BUSY. If a 
3560: 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73  function.  ** is
3570: 20 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65   being overridde
3580: 6e 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 68  n/deleted but th
3590: 65 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 76  ere are no activ
35a0: 65 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 65  e VMs, allow the
35b0: 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20  .  ** operation 
35c0: 74 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 20  to continue but 
35d0: 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 70  invalidate all p
35e0: 72 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65  recompiled state
35f0: 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 20  ments..  */.  p 
3600: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e  = sqlite3FindFun
3610: 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74  ction(db, zFunct
3620: 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20  ionName, nName, 
3630: 6e 41 72 67 2c 20 65 6e 63 2c 20 30 29 3b 0a 20  nArg, enc, 0);. 
3640: 20 69 66 28 20 70 20 26 26 20 70 2d 3e 69 50 72   if( p && p->iPr
3650: 65 66 45 6e 63 3d 3d 65 6e 63 20 26 26 20 70 2d  efEnc==enc && p-
3660: 3e 6e 41 72 67 3d 3d 6e 41 72 67 20 29 7b 0a 20  >nArg==nArg ){. 
3670: 20 20 20 69 66 28 20 64 62 2d 3e 61 63 74 69 76     if( db->activ
3680: 65 56 64 62 65 43 6e 74 20 29 7b 0a 20 20 20 20  eVdbeCnt ){.    
3690: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64    sqlite3Error(d
36a0: 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20  b, SQLITE_BUSY, 
36b0: 0a 20 20 20 20 20 20 20 20 22 55 6e 61 62 6c 65  .        "Unable
36c0: 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f 64 69 66   to delete/modif
36d0: 79 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20  y user-function 
36e0: 64 75 65 20 74 6f 20 61 63 74 69 76 65 20 73 74  due to active st
36f0: 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20  atements");.    
3700: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
3710: 42 55 53 59 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  BUSY;.    }else{
3720: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 78  .      sqlite3Ex
3730: 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74  pirePreparedStat
3740: 65 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20  ements(db);.    
3750: 7d 0a 20 20 7d 0a 0a 20 20 70 20 3d 20 73 71 6c  }.  }..  p = sql
3760: 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e  ite3FindFunction
3770: 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61  (db, zFunctionNa
3780: 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c  me, nName, nArg,
3790: 20 65 6e 63 2c 20 31 29 3b 0a 20 20 69 66 28 20   enc, 1);.  if( 
37a0: 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51  p==0 ) return SQ
37b0: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 70 2d  LITE_NOMEM;.  p-
37c0: 3e 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20 70 2d  >flags = 0;.  p-
37d0: 3e 78 46 75 6e 63 20 3d 20 78 46 75 6e 63 3b 0a  >xFunc = xFunc;.
37e0: 20 20 70 2d 3e 78 53 74 65 70 20 3d 20 78 53 74    p->xStep = xSt
37f0: 65 70 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69  ep;.  p->xFinali
3800: 7a 65 20 3d 20 78 46 69 6e 61 6c 3b 0a 20 20 70  ze = xFinal;.  p
3810: 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70 55  ->pUserData = pU
3820: 73 65 72 44 61 74 61 3b 0a 20 20 72 65 74 75 72  serData;.  retur
3830: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23  n SQLITE_OK;.}.#
3840: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
3850: 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71 6c  IT_UTF16.int sql
3860: 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63  ite3_create_func
3870: 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 65  tion16(.  sqlite
3880: 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 76  3 *db,.  const v
3890: 6f 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61  oid *zFunctionNa
38a0: 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a  me,.  int nArg,.
38b0: 20 20 69 6e 74 20 65 54 65 78 74 52 65 70 2c 0a    int eTextRep,.
38c0: 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74    void *pUserDat
38d0: 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e  a,.  void (*xFun
38e0: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  c)(sqlite3_conte
38f0: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f  xt*,int,sqlite3_
3900: 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64  value**),.  void
3910: 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65   (*xStep)(sqlite
3920: 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73  3_context*,int,s
3930: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c  qlite3_value**),
3940: 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c  .  void (*xFinal
3950: 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  )(sqlite3_contex
3960: 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b  t*).){.  int rc;
3970: 0a 20 20 63 68 61 72 20 2a 7a 46 75 6e 63 38 3b  .  char *zFunc8;
3980: 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53  ..  if( sqlite3S
3990: 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20 29  afetyCheck(db) )
39a0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
39b0: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a  ITE_MISUSE;.  }.
39c0: 20 20 7a 46 75 6e 63 38 20 3d 20 73 71 6c 69 74    zFunc8 = sqlit
39d0: 65 33 75 74 66 31 36 74 6f 38 28 7a 46 75 6e 63  e3utf16to8(zFunc
39e0: 74 69 6f 6e 4e 61 6d 65 2c 20 2d 31 29 3b 0a 20  tionName, -1);. 
39f0: 20 69 66 28 20 21 7a 46 75 6e 63 38 20 29 7b 0a   if( !zFunc8 ){.
3a00: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
3a10: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72  E_NOMEM;.  }.  r
3a20: 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65 61  c = sqlite3_crea
3a30: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20  te_function(db, 
3a40: 7a 46 75 6e 63 38 2c 20 6e 41 72 67 2c 20 65 54  zFunc8, nArg, eT
3a50: 65 78 74 52 65 70 2c 20 0a 20 20 20 20 20 20 70  extRep, .      p
3a60: 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c  UserData, xFunc,
3a70: 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b   xStep, xFinal);
3a80: 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 46  .  sqliteFree(zF
3a90: 75 6e 63 38 29 3b 0a 20 20 72 65 74 75 72 6e 20  unc8);.  return 
3aa0: 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 69  rc;.}.#endif..#i
3ab0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
3ac0: 54 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65  T_TRACE./*.** Re
3ad0: 67 69 73 74 65 72 20 61 20 74 72 61 63 65 20 66  gister a trace f
3ae0: 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41  unction.  The pA
3af0: 72 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76  rg from the prev
3b00: 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65  iously registere
3b10: 64 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65  d trace.** is re
3b20: 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20  turned.  .**.** 
3b30: 41 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e  A NULL trace fun
3b40: 63 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74  ction means that
3b50: 20 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65   no tracing is e
3b60: 78 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d  xecutes.  A non-
3b70: 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73  NULL.** trace is
3b80: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20   a pointer to a 
3b90: 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73  function that is
3ba0: 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20   invoked at the 
3bb0: 73 74 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a  start of each.**
3bc0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a   SQL statement..
3bd0: 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  */.void *sqlite3
3be0: 5f 74 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a  _trace(sqlite3 *
3bf0: 64 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63  db, void (*xTrac
3c00: 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63  e)(void*,const c
3c10: 68 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72  har*), void *pAr
3c20: 67 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64  g){.  void *pOld
3c30: 20 3d 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67   = db->pTraceArg
3c40: 3b 0a 20 20 64 62 2d 3e 78 54 72 61 63 65 20 3d  ;.  db->xTrace =
3c50: 20 78 54 72 61 63 65 3b 0a 20 20 64 62 2d 3e 70   xTrace;.  db->p
3c60: 54 72 61 63 65 41 72 67 20 3d 20 70 41 72 67 3b  TraceArg = pArg;
3c70: 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a  .  return pOld;.
3c80: 7d 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72  }./*.** Register
3c90: 20 61 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74   a profile funct
3ca0: 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66  ion.  The pArg f
3cb0: 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73  rom the previous
3cc0: 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 0a 2a  ly registered .*
3cd0: 2a 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69  * profile functi
3ce0: 6f 6e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20  on is returned. 
3cf0: 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c 20 70   .**.** A NULL p
3d00: 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20  rofile function 
3d10: 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 70 72  means that no pr
3d20: 6f 66 69 6c 69 6e 67 20 69 73 20 65 78 65 63 75  ofiling is execu
3d30: 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c  tes.  A non-NULL
3d40: 0a 2a 2a 20 70 72 6f 66 69 6c 65 20 69 73 20 61  .** profile is a
3d50: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75   pointer to a fu
3d60: 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69  nction that is i
3d70: 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 63 6f  nvoked at the co
3d80: 6e 63 6c 75 73 69 6f 6e 20 6f 66 0a 2a 2a 20 65  nclusion of.** e
3d90: 61 63 68 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ach SQL statemen
3da0: 74 20 74 68 61 74 20 69 73 20 72 75 6e 2e 0a 2a  t that is run..*
3db0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
3dc0: 70 72 6f 66 69 6c 65 28 0a 20 20 73 71 6c 69 74  profile(.  sqlit
3dd0: 65 33 20 2a 64 62 2c 0a 20 20 76 6f 69 64 20 28  e3 *db,.  void (
3de0: 2a 78 50 72 6f 66 69 6c 65 29 28 76 6f 69 64 2a  *xProfile)(void*
3df0: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c  ,const char*,sql
3e00: 69 74 65 5f 75 69 6e 74 36 34 29 2c 0a 20 20 76  ite_uint64),.  v
3e10: 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 76  oid *pArg.){.  v
3e20: 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e  oid *pOld = db->
3e30: 70 50 72 6f 66 69 6c 65 41 72 67 3b 0a 20 20 64  pProfileArg;.  d
3e40: 62 2d 3e 78 50 72 6f 66 69 6c 65 20 3d 20 78 50  b->xProfile = xP
3e50: 72 6f 66 69 6c 65 3b 0a 20 20 64 62 2d 3e 70 50  rofile;.  db->pP
3e60: 72 6f 66 69 6c 65 41 72 67 20 3d 20 70 41 72 67  rofileArg = pArg
3e70: 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b  ;.  return pOld;
3e80: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
3e90: 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 20 2a  ITE_OMIT_TRACE *
3ea0: 2f 0a 0a 2f 2a 2a 2a 20 45 58 50 45 52 49 4d 45  /../*** EXPERIME
3eb0: 4e 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52  NTAL ***.**.** R
3ec0: 65 67 69 73 74 65 72 20 61 20 66 75 6e 63 74 69  egister a functi
3ed0: 6f 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64  on to be invoked
3ee0: 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74   when a transact
3ef0: 69 6f 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a  ion comments..**
3f00: 20 49 66 20 74 68 65 20 69 6e 76 6f 6b 65 64 20   If the invoked 
3f10: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73  function returns
3f20: 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20   non-zero, then 
3f30: 74 68 65 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d  the commit becom
3f40: 65 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b  es a.** rollback
3f50: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
3f60: 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a  e3_commit_hook(.
3f70: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20    sqlite3 *db,  
3f80: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41              /* A
3f90: 74 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74  ttach the hook t
3fa0: 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20  o this database 
3fb0: 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c  */.  int (*xCall
3fc0: 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f  back)(void*),  /
3fd0: 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e  * Function to in
3fe0: 76 6f 6b 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d  voke on each com
3ff0: 6d 69 74 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70  mit */.  void *p
4000: 41 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20  Arg             
4010: 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74     /* Argument t
4020: 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a  o the function *
4030: 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c  /.){.  void *pOl
4040: 64 20 3d 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41  d = db->pCommitA
4050: 72 67 3b 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d 69  rg;.  db->xCommi
4060: 74 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c  tCallback = xCal
4070: 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f  lback;.  db->pCo
4080: 6d 6d 69 74 41 72 67 20 3d 20 70 41 72 67 3b 0a  mmitArg = pArg;.
4090: 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d    return pOld;.}
40a0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72  ../*.** Register
40b0: 20 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62   a callback to b
40c0: 65 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74  e invoked each t
40d0: 69 6d 65 20 61 20 72 6f 77 20 69 73 20 75 70 64  ime a row is upd
40e0: 61 74 65 64 2c 0a 2a 2a 20 69 6e 73 65 72 74 65  ated,.** inserte
40f0: 64 20 6f 72 20 64 65 6c 65 74 65 64 20 75 73 69  d or deleted usi
4100: 6e 67 20 74 68 69 73 20 64 61 74 61 62 61 73 65  ng this database
4110: 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a   connection..*/.
4120: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 75 70  void *sqlite3_up
4130: 64 61 74 65 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c  date_hook(.  sql
4140: 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20  ite3 *db,       
4150: 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68         /* Attach
4160: 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69   the hook to thi
4170: 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20  s database */.  
4180: 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b  void (*xCallback
4190: 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 68 61 72  )(void*,int,char
41a0: 20 63 6f 6e 73 74 20 2a 2c 63 68 61 72 20 63 6f   const *,char co
41b0: 6e 73 74 20 2a 2c 73 71 6c 69 74 65 5f 69 6e 74  nst *,sqlite_int
41c0: 36 34 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72  64),.  void *pAr
41d0: 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  g               
41e0: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20   /* Argument to 
41f0: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a  the function */.
4200: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 20  ){.  void *pRet 
4210: 3d 20 64 62 2d 3e 70 55 70 64 61 74 65 41 72 67  = db->pUpdateArg
4220: 3b 0a 20 20 64 62 2d 3e 78 55 70 64 61 74 65 43  ;.  db->xUpdateC
4230: 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62  allback = xCallb
4240: 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61  ack;.  db->pUpda
4250: 74 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20  teArg = pArg;.  
4260: 72 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a  return pRet;.}..
4270: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61  /*.** Register a
4280: 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20   callback to be 
4290: 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d  invoked each tim
42a0: 65 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  e a transaction 
42b0: 69 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63  is rolled.** bac
42c0: 6b 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61  k by this databa
42d0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a  se connection..*
42e0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
42f0: 72 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20  rollback_hook(. 
4300: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
4310: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74             /* At
4320: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f  tach the hook to
4330: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a   this database *
4340: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c  /.  void (*xCall
4350: 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 2f 2a  back)(void*), /*
4360: 20 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69   Callback functi
4370: 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41  on */.  void *pA
4380: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20  rg              
4390: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f    /* Argument to
43a0: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f   the function */
43b0: 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74  .){.  void *pRet
43c0: 20 3d 20 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b   = db->pRollback
43d0: 41 72 67 3b 0a 20 20 64 62 2d 3e 78 52 6f 6c 6c  Arg;.  db->xRoll
43e0: 62 61 63 6b 43 61 6c 6c 62 61 63 6b 20 3d 20 78  backCallback = x
43f0: 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e  Callback;.  db->
4400: 70 52 6f 6c 6c 62 61 63 6b 41 72 67 20 3d 20 70  pRollbackArg = p
4410: 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 70 52  Arg;.  return pR
4420: 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  et;.}../*.** Thi
4430: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c  s routine is cal
4440: 6c 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20  led to create a 
4450: 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61 20  connection to a 
4460: 64 61 74 61 62 61 73 65 20 42 54 72 65 65 0a 2a  database BTree.*
4470: 2a 20 64 72 69 76 65 72 2e 20 20 49 66 20 7a 46  * driver.  If zF
4480: 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 20 6e  ilename is the n
4490: 61 6d 65 20 6f 66 20 61 20 66 69 6c 65 2c 20 74  ame of a file, t
44a0: 68 65 6e 20 74 68 61 74 20 66 69 6c 65 20 69 73  hen that file is
44b0: 0a 2a 2a 20 6f 70 65 6e 65 64 20 61 6e 64 20 75  .** opened and u
44c0: 73 65 64 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61  sed.  If zFilena
44d0: 6d 65 20 69 73 20 74 68 65 20 6d 61 67 69 63 20  me is the magic 
44e0: 6e 61 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20  name ":memory:" 
44f0: 74 68 65 6e 0a 2a 2a 20 74 68 65 20 64 61 74 61  then.** the data
4500: 62 61 73 65 20 69 73 20 73 74 6f 72 65 64 20 69  base is stored i
4510: 6e 20 6d 65 6d 6f 72 79 20 28 61 6e 64 20 69 73  n memory (and is
4520: 20 74 68 75 73 20 66 6f 72 67 6f 74 74 65 6e 20   thus forgotten 
4530: 61 73 20 73 6f 6f 6e 20 61 73 0a 2a 2a 20 74 68  as soon as.** th
4540: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20  e connection is 
4550: 63 6c 6f 73 65 64 2e 29 20 20 49 66 20 7a 46 69  closed.)  If zFi
4560: 6c 65 6e 61 6d 65 20 69 73 20 4e 55 4c 4c 20 74  lename is NULL t
4570: 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  hen the database
4580: 0a 2a 2a 20 69 73 20 61 20 22 76 69 72 74 75 61  .** is a "virtua
4590: 6c 22 20 64 61 74 61 62 61 73 65 20 66 6f 72 20  l" database for 
45a0: 74 72 61 6e 73 69 65 6e 74 20 75 73 65 20 6f 6e  transient use on
45b0: 6c 79 20 61 6e 64 20 69 73 20 64 65 6c 65 74 65  ly and is delete
45c0: 64 20 61 73 0a 2a 2a 20 73 6f 6f 6e 20 61 73 20  d as.** soon as 
45d0: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69  the connection i
45e0: 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20  s closed..**.** 
45f0: 41 20 76 69 72 74 75 61 6c 20 64 61 74 61 62 61  A virtual databa
4600: 73 65 20 63 61 6e 20 62 65 20 65 69 74 68 65 72  se can be either
4610: 20 61 20 64 69 73 6b 20 66 69 6c 65 20 28 74 68   a disk file (th
4620: 61 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61  at is automatica
4630: 6c 6c 79 0a 2a 2a 20 64 65 6c 65 74 65 64 20 77  lly.** deleted w
4640: 68 65 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20  hen the file is 
4650: 63 6c 6f 73 65 64 29 20 6f 72 20 69 74 20 61 6e  closed) or it an
4660: 20 62 65 20 68 65 6c 64 20 65 6e 74 69 72 65 6c   be held entirel
4670: 79 20 69 6e 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20  y in memory,.** 
4680: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65  depending on the
4690: 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 54   values of the T
46a0: 45 4d 50 5f 53 54 4f 52 45 20 63 6f 6d 70 69 6c  EMP_STORE compil
46b0: 65 2d 74 69 6d 65 20 6d 61 63 72 6f 20 61 6e 64  e-time macro and
46c0: 20 74 68 65 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70   the.** db->temp
46d0: 5f 73 74 6f 72 65 20 76 61 72 69 61 62 6c 65 2c  _store variable,
46e0: 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68   according to th
46f0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72  e following char
4700: 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 54  t:.**.**       T
4710: 45 4d 50 5f 53 54 4f 52 45 20 20 20 20 20 64 62  EMP_STORE     db
4720: 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 20 20 20  ->temp_store    
4730: 20 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 65 6d   Location of tem
4740: 70 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 0a  porary database.
4750: 2a 2a 20 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d  **       -------
4760: 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d  ---     --------
4770: 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d  ------     -----
4780: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4790: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20  ---------.**    
47a0: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20         0        
47b0: 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20         any      
47c0: 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20         file.**  
47d0: 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20           1      
47e0: 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20            1     
47f0: 20 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a           file.**
4800: 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20             1    
4810: 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20              2   
4820: 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72             memor
4830: 79 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 31  y.**           1
4840: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4850: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66  0              f
4860: 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  ile.**          
4870: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20   2              
4880: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20    1             
4890: 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20   file.**        
48a0: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20     2            
48b0: 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20      2           
48c0: 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20     memory.**    
48d0: 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20         2        
48e0: 20 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20          0       
48f0: 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a         memory.**
4900: 20 20 20 20 20 20 20 20 20 20 20 33 20 20 20 20             3    
4910: 20 20 20 20 20 20 20 20 20 20 20 61 6e 79 20 20             any  
4920: 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72             memor
4930: 79 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  y.*/.int sqlite3
4940: 42 74 72 65 65 46 61 63 74 6f 72 79 28 0a 20 20  BtreeFactory(.  
4950: 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 20 2a 64  const sqlite3 *d
4960: 62 2c 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 69  b,        /* Mai
4970: 6e 20 64 61 74 61 62 61 73 65 20 77 68 65 6e 20  n database when 
4980: 6f 70 65 6e 69 6e 67 20 61 75 78 20 6f 74 68 65  opening aux othe
4990: 72 77 69 73 65 20 30 20 2a 2f 0a 20 20 63 6f 6e  rwise 0 */.  con
49a0: 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61  st char *zFilena
49b0: 6d 65 2c 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f  me,    /* Name o
49c0: 66 20 74 68 65 20 66 69 6c 65 20 63 6f 6e 74 61  f the file conta
49d0: 69 6e 69 6e 67 20 74 68 65 20 42 54 72 65 65 20  ining the BTree 
49e0: 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e  database */.  in
49f0: 74 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 2c 20 20  t omitJournal,  
4a00: 20 20 20 20 20 20 20 20 2f 2a 20 69 66 20 54 52          /* if TR
4a10: 55 45 20 74 68 65 6e 20 64 6f 20 6e 6f 74 20 6a  UE then do not j
4a20: 6f 75 72 6e 61 6c 20 74 68 69 73 20 66 69 6c 65  ournal this file
4a30: 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 61 63 68 65   */.  int nCache
4a40: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
4a50: 2f 2a 20 48 6f 77 20 6d 61 6e 79 20 70 61 67 65  /* How many page
4a60: 73 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61  s in the page ca
4a70: 63 68 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a  che */.  Btree *
4a80: 2a 70 70 42 74 72 65 65 20 20 20 20 20 20 20 20  *ppBtree        
4a90: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f     /* Pointer to
4aa0: 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 63   new Btree objec
4ab0: 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 2a  t written here *
4ac0: 2f 0a 29 7b 0a 20 20 69 6e 74 20 62 74 72 65 65  /.){.  int btree
4ad0: 5f 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20 69 6e  _flags = 0;.  in
4ae0: 74 20 72 63 3b 0a 20 20 0a 20 20 61 73 73 65 72  t rc;.  .  asser
4af0: 74 28 20 70 70 42 74 72 65 65 20 21 3d 20 30 29  t( ppBtree != 0)
4b00: 3b 0a 20 20 69 66 28 20 6f 6d 69 74 4a 6f 75 72  ;.  if( omitJour
4b10: 6e 61 6c 20 29 7b 0a 20 20 20 20 62 74 72 65 65  nal ){.    btree
4b20: 5f 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f  _flags |= BTREE_
4b30: 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20  OMIT_JOURNAL;.  
4b40: 7d 0a 20 20 69 66 28 20 64 62 2d 3e 66 6c 61 67  }.  if( db->flag
4b50: 73 20 26 20 53 51 4c 49 54 45 5f 4e 6f 52 65 61  s & SQLITE_NoRea
4b60: 64 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 62 74 72  dlock ){.    btr
4b70: 65 65 5f 66 6c 61 67 73 20 7c 3d 20 42 54 52 45  ee_flags |= BTRE
4b80: 45 5f 4e 4f 5f 52 45 41 44 4c 4f 43 4b 3b 0a 20  E_NO_READLOCK;. 
4b90: 20 7d 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61   }.  if( zFilena
4ba0: 6d 65 3d 3d 30 20 29 7b 0a 23 69 66 20 54 45 4d  me==0 ){.#if TEM
4bb0: 50 5f 53 54 4f 52 45 3d 3d 30 0a 20 20 20 20 2f  P_STORE==0.    /
4bc0: 2a 20 44 6f 20 6e 6f 74 68 69 6e 67 20 2a 2f 0a  * Do nothing */.
4bd0: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53  #endif.#ifndef S
4be0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52  QLITE_OMIT_MEMOR
4bf0: 59 44 42 0a 23 69 66 20 54 45 4d 50 5f 53 54 4f  YDB.#if TEMP_STO
4c00: 52 45 3d 3d 31 0a 20 20 20 20 69 66 28 20 64 62  RE==1.    if( db
4c10: 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 3d 3d 32 20  ->temp_store==2 
4c20: 29 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 3a  ) zFilename = ":
4c30: 6d 65 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64 69 66  memory:";.#endif
4c40: 0a 23 69 66 20 54 45 4d 50 5f 53 54 4f 52 45 3d  .#if TEMP_STORE=
4c50: 3d 32 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 74  =2.    if( db->t
4c60: 65 6d 70 5f 73 74 6f 72 65 21 3d 31 20 29 20 7a  emp_store!=1 ) z
4c70: 46 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d  Filename = ":mem
4c80: 6f 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 69  ory:";.#endif.#i
4c90: 66 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 33 0a  f TEMP_STORE==3.
4ca0: 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20      zFilename = 
4cb0: 22 3a 6d 65 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64  ":memory:";.#end
4cc0: 69 66 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  if.#endif /* SQL
4cd0: 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44  ITE_OMIT_MEMORYD
4ce0: 42 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d  B */.  }..  rc =
4cf0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 65   sqlite3BtreeOpe
4d00: 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 28 73 71  n(zFilename, (sq
4d10: 6c 69 74 65 33 20 2a 29 64 62 2c 20 70 70 42 74  lite3 *)db, ppBt
4d20: 72 65 65 2c 20 62 74 72 65 65 5f 66 6c 61 67 73  ree, btree_flags
4d30: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  );.  if( rc==SQL
4d40: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71  ITE_OK ){.    sq
4d50: 6c 69 74 65 33 42 74 72 65 65 53 65 74 42 75 73  lite3BtreeSetBus
4d60: 79 48 61 6e 64 6c 65 72 28 2a 70 70 42 74 72 65  yHandler(*ppBtre
4d70: 65 2c 20 28 76 6f 69 64 2a 29 26 64 62 2d 3e 62  e, (void*)&db->b
4d80: 75 73 79 48 61 6e 64 6c 65 72 29 3b 0a 20 20 20  usyHandler);.   
4d90: 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74   sqlite3BtreeSet
4da0: 43 61 63 68 65 53 69 7a 65 28 2a 70 70 42 74 72  CacheSize(*ppBtr
4db0: 65 65 2c 20 6e 43 61 63 68 65 29 3b 0a 20 20 7d  ee, nCache);.  }
4dc0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
4dd0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54  ./*.** Return UT
4de0: 46 2d 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c  F-8 encoded Engl
4df0: 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70  ish language exp
4e00: 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  lanation of the 
4e10: 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65  most recent.** e
4e20: 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63  rror..*/.const c
4e30: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72  har *sqlite3_err
4e40: 6d 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29  msg(sqlite3 *db)
4e50: 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  {.  const char *
4e60: 7a 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  z;.  if( sqlite3
4e70: 54 73 64 28 29 2d 3e 6d 61 6c 6c 6f 63 46 61 69  Tsd()->mallocFai
4e80: 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72  led ){.    retur
4e90: 6e 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28  n sqlite3ErrStr(
4ea0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20  SQLITE_NOMEM);. 
4eb0: 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33   }.  if( sqlite3
4ec0: 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20  SafetyCheck(db) 
4ed0: 7c 7c 20 64 62 2d 3e 65 72 72 43 6f 64 65 3d 3d  || db->errCode==
4ee0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 29 7b  SQLITE_MISUSE ){
4ef0: 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69  .    return sqli
4f00: 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 54 45  te3ErrStr(SQLITE
4f10: 5f 4d 49 53 55 53 45 29 3b 0a 20 20 7d 0a 20 20  _MISUSE);.  }.  
4f20: 7a 20 3d 20 28 63 68 61 72 2a 29 73 71 6c 69 74  z = (char*)sqlit
4f30: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62  e3_value_text(db
4f40: 2d 3e 70 45 72 72 29 3b 0a 20 20 69 66 28 20 7a  ->pErr);.  if( z
4f50: 3d 3d 30 20 29 7b 0a 20 20 20 20 7a 20 3d 20 73  ==0 ){.    z = s
4f60: 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 2d  qlite3ErrStr(db-
4f70: 3e 65 72 72 43 6f 64 65 29 3b 0a 20 20 7d 0a 20  >errCode);.  }. 
4f80: 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 23 69   return z;.}..#i
4f90: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
4fa0: 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65  T_UTF16./*.** Re
4fb0: 74 75 72 6e 20 55 54 46 2d 31 36 20 65 6e 63 6f  turn UTF-16 enco
4fc0: 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67  ded English lang
4fd0: 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e  uage explanation
4fe0: 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63   of the most rec
4ff0: 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f  ent.** error..*/
5000: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
5010: 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 73 71  ite3_errmsg16(sq
5020: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 2f 2a  lite3 *db){.  /*
5030: 20 42 65 63 61 75 73 65 20 61 6c 6c 20 74 68 65   Because all the
5040: 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 20 74   characters in t
5050: 68 65 20 73 74 72 69 6e 67 20 61 72 65 20 69 6e  he string are in
5060: 20 74 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 2a   the unicode.  *
5070: 2a 20 72 61 6e 67 65 20 30 78 30 30 2d 30 78 46  * range 0x00-0xF
5080: 46 2c 20 69 66 20 77 65 20 70 61 64 20 74 68 65  F, if we pad the
5090: 20 62 69 67 2d 65 6e 64 69 61 6e 20 73 74 72 69   big-endian stri
50a0: 6e 67 20 77 69 74 68 20 61 20 0a 20 20 2a 2a 20  ng with a .  ** 
50b0: 7a 65 72 6f 20 62 79 74 65 2c 20 77 65 20 63 61  zero byte, we ca
50c0: 6e 20 6f 62 74 61 69 6e 20 74 68 65 20 6c 69 74  n obtain the lit
50d0: 74 6c 65 2d 65 6e 64 69 61 6e 20 73 74 72 69 6e  tle-endian strin
50e0: 67 20 77 69 74 68 0a 20 20 2a 2a 20 26 62 69 67  g with.  ** &big
50f0: 5f 65 6e 64 69 61 6e 5b 31 5d 2e 0a 20 20 2a 2f  _endian[1]..  */
5100: 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .  static const 
5110: 63 68 61 72 20 6f 75 74 4f 66 4d 65 6d 42 65 5b  char outOfMemBe[
5120: 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6f 27  ] = {.    0, 'o'
5130: 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27  , 0, 'u', 0, 't'
5140: 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30  , 0, ' ', .    0
5150: 2c 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30  , 'o', 0, 'f', 0
5160: 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27  , ' ', .    0, '
5170: 6d 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27  m', 0, 'e', 0, '
5180: 6d 27 2c 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27  m', 0, 'o', 0, '
5190: 72 27 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20 30  r', 0, 'y', 0, 0
51a0: 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69  , 0.  };.  stati
51b0: 63 20 63 6f 6e 73 74 20 63 68 61 72 20 6d 69 73  c const char mis
51c0: 75 73 65 42 65 20 5b 5d 20 3d 20 7b 0a 20 20 20  useBe [] = {.   
51d0: 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 69 27 2c   0, 'l', 0, 'i',
51e0: 20 30 2c 20 27 62 27 2c 20 30 2c 20 27 72 27 2c   0, 'b', 0, 'r',
51f0: 20 30 2c 20 27 61 27 2c 20 30 2c 20 27 72 27 2c   0, 'a', 0, 'r',
5200: 20 30 2c 20 27 79 27 2c 20 30 2c 20 27 20 27 2c   0, 'y', 0, ' ',
5210: 20 0a 20 20 20 20 30 2c 20 27 72 27 2c 20 30 2c   .    0, 'r', 0,
5220: 20 27 6f 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c   'o', 0, 'u', 0,
5230: 20 27 74 27 2c 20 30 2c 20 27 69 27 2c 20 30 2c   't', 0, 'i', 0,
5240: 20 27 6e 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c   'n', 0, 'e', 0,
5250: 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 63   ' ', .    0, 'c
5260: 27 2c 20 30 2c 20 27 61 27 2c 20 30 2c 20 27 6c  ', 0, 'a', 0, 'l
5270: 27 2c 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 65  ', 0, 'l', 0, 'e
5280: 27 2c 20 30 2c 20 27 64 27 2c 20 30 2c 20 27 20  ', 0, 'd', 0, ' 
5290: 27 2c 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20  ', .    0, 'o', 
52a0: 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c 20  0, 'u', 0, 't', 
52b0: 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20  0, ' ', .    0, 
52c0: 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30 2c 20  'o', 0, 'f', 0, 
52d0: 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 73 27  ' ', .    0, 's'
52e0: 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 71 27  , 0, 'e', 0, 'q'
52f0: 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 65 27  , 0, 'u', 0, 'e'
5300: 2c 20 30 2c 20 27 6e 27 2c 20 30 2c 20 27 63 27  , 0, 'n', 0, 'c'
5310: 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 30 2c 20  , 0, 'e', 0, 0, 
5320: 30 0a 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 20  0.  };..  const 
5330: 76 6f 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 73  void *z;.  if( s
5340: 71 6c 69 74 65 33 54 73 64 28 29 2d 3e 6d 61 6c  qlite3Tsd()->mal
5350: 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20  locFailed ){.   
5360: 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a 29   return (void *)
5370: 28 26 6f 75 74 4f 66 4d 65 6d 42 65 5b 53 51 4c  (&outOfMemBe[SQL
5380: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3d  ITE_UTF16NATIVE=
5390: 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 3f  =SQLITE_UTF16LE?
53a0: 31 3a 30 5d 29 3b 0a 20 20 7d 0a 20 20 69 66 28  1:0]);.  }.  if(
53b0: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68   sqlite3SafetyCh
53c0: 65 63 6b 28 64 62 29 20 7c 7c 20 64 62 2d 3e 65  eck(db) || db->e
53d0: 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4d  rrCode==SQLITE_M
53e0: 49 53 55 53 45 20 29 7b 0a 20 20 20 20 72 65 74  ISUSE ){.    ret
53f0: 75 72 6e 20 28 76 6f 69 64 20 2a 29 28 26 6d 69  urn (void *)(&mi
5400: 73 75 73 65 42 65 5b 53 51 4c 49 54 45 5f 55 54  suseBe[SQLITE_UT
5410: 46 31 36 4e 41 54 49 56 45 3d 3d 53 51 4c 49 54  F16NATIVE==SQLIT
5420: 45 5f 55 54 46 31 36 4c 45 3f 31 3a 30 5d 29 3b  E_UTF16LE?1:0]);
5430: 0a 20 20 7d 0a 20 20 7a 20 3d 20 73 71 6c 69 74  .  }.  z = sqlit
5440: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28  e3_value_text16(
5450: 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 69 66 28  db->pErr);.  if(
5460: 20 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c   z==0 ){.    sql
5470: 69 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28  ite3ValueSetStr(
5480: 64 62 2d 3e 70 45 72 72 2c 20 2d 31 2c 20 73 71  db->pErr, -1, sq
5490: 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 2d 3e  lite3ErrStr(db->
54a0: 65 72 72 43 6f 64 65 29 2c 0a 20 20 20 20 20 20  errCode),.      
54b0: 20 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20     SQLITE_UTF8, 
54c0: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
54d0: 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f      z = sqlite3_
54e0: 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d  value_text16(db-
54f0: 3e 70 45 72 72 29 3b 0a 20 20 7d 0a 20 20 72 65  >pErr);.  }.  re
5500: 74 75 72 6e 20 7a 3b 0a 7d 0a 23 65 6e 64 69 66  turn z;.}.#endif
5510: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
5520: 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  UTF16 */../*.** 
5530: 52 65 74 75 72 6e 20 74 68 65 20 6d 6f 73 74 20  Return the most 
5540: 72 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f 64  recent error cod
5550: 65 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 61  e generated by a
5560: 6e 20 53 51 4c 69 74 65 20 72 6f 75 74 69 6e 65  n SQLite routine
5570: 2e 20 49 66 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20  . If NULL is.** 
5580: 70 61 73 73 65 64 20 74 6f 20 74 68 69 73 20 66  passed to this f
5590: 75 6e 63 74 69 6f 6e 2c 20 77 65 20 61 73 73 75  unction, we assu
55a0: 6d 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61  me a malloc() fa
55b0: 69 6c 65 64 20 64 75 72 69 6e 67 20 73 71 6c 69  iled during sqli
55c0: 74 65 33 5f 6f 70 65 6e 28 29 2e 0a 2a 2f 0a 69  te3_open()..*/.i
55d0: 6e 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f  nt sqlite3_errco
55e0: 64 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  de(sqlite3 *db){
55f0: 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 73 71  .  if( !db || sq
5600: 6c 69 74 65 33 54 73 64 28 29 2d 3e 6d 61 6c 6c  lite3Tsd()->mall
5610: 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20  ocFailed ){.    
5620: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
5630: 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73  MEM;.  }.  if( s
5640: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63  qlite3SafetyChec
5650: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74  k(db) ){.    ret
5660: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
5670: 45 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  E;.  }.  return 
5680: 64 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a  db->errCode;.}..
5690: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
56a0: 6e 65 20 64 6f 65 73 20 74 68 65 20 77 6f 72 6b  ne does the work
56b0: 20 6f 66 20 6f 70 65 6e 69 6e 67 20 61 20 64 61   of opening a da
56c0: 74 61 62 61 73 65 20 6f 6e 20 62 65 68 61 6c 66  tabase on behalf
56d0: 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f   of.** sqlite3_o
56e0: 70 65 6e 28 29 20 61 6e 64 20 73 71 6c 69 74 65  pen() and sqlite
56f0: 33 5f 6f 70 65 6e 31 36 28 29 2e 20 54 68 65 20  3_open16(). The 
5700: 64 61 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d  database filenam
5710: 65 20 22 7a 46 69 6c 65 6e 61 6d 65 22 20 20 0a  e "zFilename"  .
5720: 2a 2a 20 69 73 20 55 54 46 2d 38 20 65 6e 63 6f  ** is UTF-8 enco
5730: 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ded..*/.static i
5740: 6e 74 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28  nt openDatabase(
5750: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
5760: 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74  Filename, /* Dat
5770: 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55  abase filename U
5780: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a  TF-8 encoded */.
5790: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62    sqlite3 **ppDb
57a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
57b0: 20 52 65 74 75 72 6e 65 64 20 64 61 74 61 62 61   Returned databa
57c0: 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 29 7b 0a  se handle */.){.
57d0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20    sqlite3 *db;. 
57e0: 20 69 6e 74 20 72 63 3b 0a 20 20 43 6f 6c 6c 53   int rc;.  CollS
57f0: 65 71 20 2a 70 43 6f 6c 6c 3b 0a 0a 20 20 61 73  eq *pColl;..  as
5800: 73 65 72 74 28 20 21 73 71 6c 69 74 65 33 54 73  sert( !sqlite3Ts
5810: 64 28 29 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65  d()->mallocFaile
5820: 64 20 29 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63  d );..  /* Alloc
5830: 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 20 64  ate the sqlite d
5840: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 2a 2f  ata structure */
5850: 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 65 4d 61  .  db = sqliteMa
5860: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 73 71 6c  lloc( sizeof(sql
5870: 69 74 65 33 29 20 29 3b 0a 20 20 69 66 28 20 64  ite3) );.  if( d
5880: 62 3d 3d 30 20 29 20 67 6f 74 6f 20 6f 70 65 6e  b==0 ) goto open
5890: 64 62 5f 6f 75 74 3b 0a 20 20 64 62 2d 3e 70 72  db_out;.  db->pr
58a0: 69 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b  iorNewRowid = 0;
58b0: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53  .  db->magic = S
58c0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59  QLITE_MAGIC_BUSY
58d0: 3b 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b  ;.  db->nDb = 2;
58e0: 0a 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 2d  .  db->aDb = db-
58f0: 3e 61 44 62 53 74 61 74 69 63 3b 0a 20 20 64 62  >aDbStatic;.  db
5900: 2d 3e 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55  ->enc = SQLITE_U
5910: 54 46 38 3b 0a 20 20 64 62 2d 3e 61 75 74 6f 43  TF8;.  db->autoC
5920: 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 64 62 2d  ommit = 1;.  db-
5930: 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45  >flags |= SQLITE
5940: 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 3b 0a  _ShortColNames;.
5950: 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69    sqlite3HashIni
5960: 74 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 53 51  t(&db->aFunc, SQ
5970: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47  LITE_HASH_STRING
5980: 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 48  , 0);.  sqlite3H
5990: 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 43 6f  ashInit(&db->aCo
59a0: 6c 6c 53 65 71 2c 20 53 51 4c 49 54 45 5f 48 41  llSeq, SQLITE_HA
59b0: 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 0a  SH_STRING, 0);..
59c0: 23 69 66 20 30 0a 20 20 66 6f 72 28 69 3d 30 3b  #if 0.  for(i=0;
59d0: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
59e0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 48 61 73  {.    sqlite3Has
59f0: 68 49 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69  hInit(&db->aDb[i
5a00: 5d 2e 74 62 6c 48 61 73 68 2c 20 53 51 4c 49 54  ].tblHash, SQLIT
5a10: 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30  E_HASH_STRING, 0
5a20: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 48 61  );.    sqlite3Ha
5a30: 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b  shInit(&db->aDb[
5a40: 69 5d 2e 69 64 78 48 61 73 68 2c 20 53 51 4c 49  i].idxHash, SQLI
5a50: 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20  TE_HASH_STRING, 
5a60: 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 48  0);.    sqlite3H
5a70: 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 44 62  ashInit(&db->aDb
5a80: 5b 69 5d 2e 74 72 69 67 48 61 73 68 2c 20 53 51  [i].trigHash, SQ
5a90: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47  LITE_HASH_STRING
5aa0: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
5ab0: 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61  3HashInit(&db->a
5ac0: 44 62 5b 69 5d 2e 61 46 4b 65 79 2c 20 53 51 4c  Db[i].aFKey, SQL
5ad0: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
5ae0: 20 31 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a   1);.  }.#endif.
5af0: 20 20 0a 20 20 2f 2a 20 41 64 64 20 74 68 65 20    .  /* Add the 
5b00: 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6f  default collatio
5b10: 6e 20 73 65 71 75 65 6e 63 65 20 42 49 4e 41 52  n sequence BINAR
5b20: 59 2e 20 42 49 4e 41 52 59 20 77 6f 72 6b 73 20  Y. BINARY works 
5b30: 66 6f 72 20 62 6f 74 68 20 55 54 46 2d 38 0a 20  for both UTF-8. 
5b40: 20 2a 2a 20 61 6e 64 20 55 54 46 2d 31 36 2c 20   ** and UTF-16, 
5b50: 73 6f 20 61 64 64 20 61 20 76 65 72 73 69 6f 6e  so add a version
5b60: 20 66 6f 72 20 65 61 63 68 20 74 6f 20 61 76 6f   for each to avo
5b70: 69 64 20 61 6e 79 20 75 6e 6e 65 63 65 73 73 61  id any unnecessa
5b80: 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 65 72 73 69  ry.  ** conversi
5b90: 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c 79 20 65 72  ons. The only er
5ba0: 72 6f 72 20 74 68 61 74 20 63 61 6e 20 6f 63 63  ror that can occ
5bb0: 75 72 20 68 65 72 65 20 69 73 20 61 20 6d 61 6c  ur here is a mal
5bc0: 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2e 0a 20  loc() failure.. 
5bd0: 20 2a 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 65   */.  if( sqlite
5be0: 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69  3_create_collati
5bf0: 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c  on(db, "BINARY",
5c00: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c   SQLITE_UTF8, 0,
5c10: 62 69 6e 43 6f 6c 6c 46 75 6e 63 29 20 7c 7c 0a  binCollFunc) ||.
5c20: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 72        sqlite3_cr
5c30: 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64  eate_collation(d
5c40: 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c  b, "BINARY", SQL
5c50: 49 54 45 5f 55 54 46 31 36 2c 20 30 2c 62 69 6e  ITE_UTF16, 0,bin
5c60: 43 6f 6c 6c 46 75 6e 63 29 20 7c 7c 0a 20 20 20  CollFunc) ||.   
5c70: 20 20 20 28 64 62 2d 3e 70 44 66 6c 74 43 6f 6c     (db->pDfltCol
5c80: 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43  l = sqlite3FindC
5c90: 6f 6c 6c 53 65 71 28 64 62 2c 20 64 62 2d 3e 65  ollSeq(db, db->e
5ca0: 6e 63 2c 20 22 42 49 4e 41 52 59 22 2c 20 36 2c  nc, "BINARY", 6,
5cb0: 20 30 29 29 3d 3d 30 20 0a 20 20 29 7b 0a 20 20   0))==0 .  ){.  
5cc0: 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 63 72 65    /* sqlite3_cre
5cd0: 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 29 20  ate_collation() 
5ce0: 69 73 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 41  is an external A
5cf0: 50 49 2e 20 53 6f 20 74 68 65 20 6d 61 6c 6c 6f  PI. So the mallo
5d00: 63 46 61 69 6c 65 64 20 66 6c 61 67 0a 20 20 20  cFailed flag.   
5d10: 20 2a 2a 20 77 69 6c 6c 20 68 61 76 65 20 62 65   ** will have be
5d20: 65 6e 20 63 6c 65 61 72 65 64 20 62 65 66 6f 72  en cleared befor
5d30: 65 20 72 65 74 75 72 6e 69 6e 67 2e 20 53 6f 20  e returning. So 
5d40: 73 65 74 20 69 74 20 65 78 70 6c 69 63 69 74 6c  set it explicitl
5d50: 79 20 68 65 72 65 2e 0a 20 20 20 20 2a 2f 0a 20  y here..    */. 
5d60: 20 20 20 73 71 6c 69 74 65 33 54 73 64 28 29 2d     sqlite3Tsd()-
5d70: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20  >mallocFailed = 
5d80: 31 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63  1;.    db->magic
5d90: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f   = SQLITE_MAGIC_
5da0: 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f 74 6f  CLOSED;.    goto
5db0: 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d   opendb_out;.  }
5dc0: 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64 20  ..  /* Also add 
5dd0: 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69 6e 73  a UTF-8 case-ins
5de0: 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 74 69  ensitive collati
5df0: 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f 0a  on sequence. */.
5e00: 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65    sqlite3_create
5e10: 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22  _collation(db, "
5e20: 4e 4f 43 41 53 45 22 2c 20 53 51 4c 49 54 45 5f  NOCASE", SQLITE_
5e30: 55 54 46 38 2c 20 30 2c 20 6e 6f 63 61 73 65 43  UTF8, 0, nocaseC
5e40: 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 29 3b 0a 0a  ollatingFunc);..
5e50: 20 20 2f 2a 20 53 65 74 20 66 6c 61 67 73 20 6f    /* Set flags o
5e60: 6e 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 63  n the built-in c
5e70: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63  ollating sequenc
5e80: 65 73 20 2a 2f 0a 20 20 64 62 2d 3e 70 44 66 6c  es */.  db->pDfl
5e90: 74 43 6f 6c 6c 2d 3e 74 79 70 65 20 3d 20 53 51  tColl->type = SQ
5ea0: 4c 49 54 45 5f 43 4f 4c 4c 5f 42 49 4e 41 52 59  LITE_COLL_BINARY
5eb0: 3b 0a 20 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69  ;.  pColl = sqli
5ec0: 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64  te3FindCollSeq(d
5ed0: 62 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20  b, SQLITE_UTF8, 
5ee0: 22 4e 4f 43 41 53 45 22 2c 20 36 2c 20 30 29 3b  "NOCASE", 6, 0);
5ef0: 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 29 7b 0a  .  if( pColl ){.
5f00: 20 20 20 20 70 43 6f 6c 6c 2d 3e 74 79 70 65 20      pColl->type 
5f10: 3d 20 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 4e 4f  = SQLITE_COLL_NO
5f20: 43 41 53 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  CASE;.  }..  /* 
5f30: 4f 70 65 6e 20 74 68 65 20 62 61 63 6b 65 6e 64  Open the backend
5f40: 20 64 61 74 61 62 61 73 65 20 64 72 69 76 65 72   database driver
5f50: 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74   */.  rc = sqlit
5f60: 65 33 42 74 72 65 65 46 61 63 74 6f 72 79 28 64  e3BtreeFactory(d
5f70: 62 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 2c  b, zFilename, 0,
5f80: 20 4d 41 58 5f 50 41 47 45 53 2c 20 26 64 62 2d   MAX_PAGES, &db-
5f90: 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20  >aDb[0].pBt);.  
5fa0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
5fb0: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  K ){.    sqlite3
5fc0: 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 30 29  Error(db, rc, 0)
5fd0: 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 20  ;.    db->magic 
5fe0: 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43  = SQLITE_MAGIC_C
5ff0: 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f 74 6f 20  LOSED;.    goto 
6000: 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a  opendb_out;.  }.
6010: 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 53 63    db->aDb[0].pSc
6020: 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 63  hema = sqlite3Sc
6030: 68 65 6d 61 47 65 74 28 64 62 2d 3e 61 44 62 5b  hemaGet(db->aDb[
6040: 30 5d 2e 70 42 74 29 3b 0a 20 20 64 62 2d 3e 61  0].pBt);.  db->a
6050: 44 62 5b 31 5d 2e 70 53 63 68 65 6d 61 20 3d 20  Db[1].pSchema = 
6060: 73 71 6c 69 74 65 33 53 63 68 65 6d 61 47 65 74  sqlite3SchemaGet
6070: 28 30 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 64  (0);..  /* The d
6080: 65 66 61 75 6c 74 20 73 61 66 65 74 79 5f 6c 65  efault safety_le
6090: 76 65 6c 20 66 6f 72 20 74 68 65 20 6d 61 69 6e  vel for the main
60a0: 20 64 61 74 61 62 61 73 65 20 69 73 20 27 66 75   database is 'fu
60b0: 6c 6c 27 3b 20 66 6f 72 20 74 68 65 20 74 65 6d  ll'; for the tem
60c0: 70 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20  p.  ** database 
60d0: 69 74 20 69 73 20 27 4e 4f 4e 45 27 2e 20 54 68  it is 'NONE'. Th
60e0: 69 73 20 6d 61 74 63 68 65 73 20 74 68 65 20 70  is matches the p
60f0: 61 67 65 72 20 6c 61 79 65 72 20 64 65 66 61 75  ager layer defau
6100: 6c 74 73 2e 20 20 0a 20 20 2a 2f 0a 20 20 64 62  lts.  .  */.  db
6110: 2d 3e 61 44 62 5b 30 5d 2e 7a 4e 61 6d 65 20 3d  ->aDb[0].zName =
6120: 20 22 6d 61 69 6e 22 3b 0a 20 20 64 62 2d 3e 61   "main";.  db->a
6130: 44 62 5b 30 5d 2e 73 61 66 65 74 79 5f 6c 65 76  Db[0].safety_lev
6140: 65 6c 20 3d 20 33 3b 0a 23 69 66 6e 64 65 66 20  el = 3;.#ifndef 
6150: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50  SQLITE_OMIT_TEMP
6160: 44 42 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e  DB.  db->aDb[1].
6170: 7a 4e 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a  zName = "temp";.
6180: 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 73 61 66    db->aDb[1].saf
6190: 65 74 79 5f 6c 65 76 65 6c 20 3d 20 31 3b 0a 23  ety_level = 1;.#
61a0: 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 52 65 67 69  endif..  /* Regi
61b0: 73 74 65 72 20 61 6c 6c 20 62 75 69 6c 74 2d 69  ster all built-i
61c0: 6e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 62 75 74  n functions, but
61d0: 20 64 6f 20 6e 6f 74 20 61 74 74 65 6d 70 74 20   do not attempt 
61e0: 74 6f 20 72 65 61 64 20 74 68 65 0a 20 20 2a 2a  to read the.  **
61f0: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61   database schema
6200: 20 79 65 74 2e 20 54 68 69 73 20 69 73 20 64 65   yet. This is de
6210: 6c 61 79 65 64 20 75 6e 74 69 6c 20 74 68 65 20  layed until the 
6220: 66 69 72 73 74 20 74 69 6d 65 20 74 68 65 20 64  first time the d
6230: 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 69 73 20  atabase.  ** is 
6240: 61 63 63 65 73 73 65 64 2e 0a 20 20 2a 2f 0a 20  accessed..  */. 
6250: 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72   sqlite3Register
6260: 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73  BuiltinFunctions
6270: 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 45  (db);.  sqlite3E
6280: 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f  rror(db, SQLITE_
6290: 4f 4b 2c 20 30 29 3b 0a 20 20 64 62 2d 3e 6d 61  OK, 0);.  db->ma
62a0: 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47  gic = SQLITE_MAG
62b0: 49 43 5f 4f 50 45 4e 3b 0a 0a 6f 70 65 6e 64 62  IC_OPEN;..opendb
62c0: 5f 6f 75 74 3a 0a 20 20 69 66 28 20 53 51 4c 49  _out:.  if( SQLI
62d0: 54 45 5f 4e 4f 4d 45 4d 3d 3d 28 72 63 20 3d 20  TE_NOMEM==(rc = 
62e0: 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28  sqlite3_errcode(
62f0: 64 62 29 29 20 29 7b 0a 20 20 20 20 73 71 6c 69  db)) ){.    sqli
6300: 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20  te3_close(db);. 
6310: 20 20 20 64 62 20 3d 20 30 3b 0a 20 20 7d 0a 20     db = 0;.  }. 
6320: 20 2a 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 73   *ppDb = db;.  s
6330: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 43 6c 65 61  qlite3MallocClea
6340: 72 46 61 69 6c 65 64 28 29 3b 0a 20 20 72 65 74  rFailed();.  ret
6350: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
6360: 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 74 61   Open a new data
6370: 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a  base handle..*/.
6380: 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e  int sqlite3_open
6390: 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  (.  const char *
63a0: 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71  zFilename, .  sq
63b0: 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 0a 29 7b  lite3 **ppDb .){
63c0: 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e 44 61  .  return openDa
63d0: 74 61 62 61 73 65 28 7a 46 69 6c 65 6e 61 6d 65  tabase(zFilename
63e0: 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a 23 69 66 6e  , ppDb);.}..#ifn
63f0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
6400: 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e  UTF16./*.** Open
6410: 20 61 20 6e 65 77 20 64 61 74 61 62 61 73 65 20   a new database 
6420: 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73  handle..*/.int s
6430: 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 0a 20  qlite3_open16(. 
6440: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 46 69   const void *zFi
6450: 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71 6c 69 74  lename, .  sqlit
6460: 65 33 20 2a 2a 70 70 44 62 0a 29 7b 0a 20 20 63  e3 **ppDb.){.  c
6470: 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46 69 6c 65  har const *zFile
6480: 6e 61 6d 65 38 3b 20 20 20 2f 2a 20 7a 46 69 6c  name8;   /* zFil
6490: 65 6e 61 6d 65 20 65 6e 63 6f 64 65 64 20 69 6e  ename encoded in
64a0: 20 55 54 46 2d 38 20 69 6e 73 74 65 61 64 20 6f   UTF-8 instead o
64b0: 66 20 55 54 46 2d 31 36 20 2a 2f 0a 20 20 69 6e  f UTF-16 */.  in
64c0: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f  t rc = SQLITE_NO
64d0: 4d 45 4d 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76  MEM;.  sqlite3_v
64e0: 61 6c 75 65 20 2a 70 56 61 6c 3b 0a 0a 20 20 61  alue *pVal;..  a
64f0: 73 73 65 72 74 28 20 7a 46 69 6c 65 6e 61 6d 65  ssert( zFilename
6500: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 70   );.  assert( pp
6510: 44 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 3d 20  Db );.  *ppDb = 
6520: 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69  0;.  pVal = sqli
6530: 74 65 33 56 61 6c 75 65 4e 65 77 28 29 3b 0a 20  te3ValueNew();. 
6540: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74   sqlite3ValueSet
6550: 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a 46  Str(pVal, -1, zF
6560: 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f  ilename, SQLITE_
6570: 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c  UTF16NATIVE, SQL
6580: 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a  ITE_STATIC);.  z
6590: 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c 69  Filename8 = sqli
65a0: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61  te3ValueText(pVa
65b0: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b  l, SQLITE_UTF8);
65c0: 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65  .  if( zFilename
65d0: 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 70  8 ){.    rc = op
65e0: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65  enDatabase(zFile
65f0: 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b 0a 20 20  name8, ppDb);.  
6600: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
6610: 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20 29 7b 0a  _OK && *ppDb ){.
6620: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
6630: 65 33 5f 65 78 65 63 28 2a 70 70 44 62 2c 20 22  e3_exec(*ppDb, "
6640: 50 52 41 47 4d 41 20 65 6e 63 6f 64 69 6e 67 20  PRAGMA encoding 
6650: 3d 20 27 55 54 46 2d 31 36 27 22 2c 20 30 2c 20  = 'UTF-16'", 0, 
6660: 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  0, 0);.    }.  }
6670: 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74  else{.    assert
6680: 28 20 73 71 6c 69 74 65 33 54 73 64 28 29 2d 3e  ( sqlite3Tsd()->
6690: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a  mallocFailed );.
66a0: 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f      sqlite3Mallo
66b0: 63 43 6c 65 61 72 46 61 69 6c 65 64 28 29 3b 0a  cClearFailed();.
66c0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 61 6c    }.  sqlite3Val
66d0: 75 65 46 72 65 65 28 70 56 61 6c 29 3b 0a 0a 20  ueFree(pVal);.. 
66e0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65   return rc;.}.#e
66f0: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f  ndif /* SQLITE_O
6700: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a  MIT_UTF16 */../*
6710: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
6720: 67 20 72 6f 75 74 69 6e 65 20 64 65 73 74 72 6f  g routine destro
6730: 79 73 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63  ys a virtual mac
6740: 68 69 6e 65 20 74 68 61 74 20 69 73 20 63 72 65  hine that is cre
6750: 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 73  ated by.** the s
6760: 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 28 29  qlite3_compile()
6770: 20 72 6f 75 74 69 6e 65 2e 20 54 68 65 20 69 6e   routine. The in
6780: 74 65 67 65 72 20 72 65 74 75 72 6e 65 64 20 69  teger returned i
6790: 73 20 61 6e 20 53 51 4c 49 54 45 5f 0a 2a 2a 20  s an SQLITE_.** 
67a0: 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20  success/failure 
67b0: 63 6f 64 65 20 74 68 61 74 20 64 65 73 63 72 69  code that descri
67c0: 62 65 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f  bes the result o
67d0: 66 20 65 78 65 63 75 74 69 6e 67 20 74 68 65 20  f executing the 
67e0: 76 69 72 74 75 61 6c 0a 2a 2a 20 6d 61 63 68 69  virtual.** machi
67f0: 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  ne..**.** This r
6800: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
6810: 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73  error code and s
6820: 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62  tring returned b
6830: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72  y.** sqlite3_err
6840: 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f  code(), sqlite3_
6850: 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c  errmsg() and sql
6860: 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e  ite3_errmsg16().
6870: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
6880: 66 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 33  finalize(sqlite3
6890: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
68a0: 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 70   int rc;.  if( p
68b0: 53 74 6d 74 3d 3d 30 20 29 7b 0a 20 20 20 20 72  Stmt==0 ){.    r
68c0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
68d0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d   }else{.    rc =
68e0: 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e 61   sqlite3VdbeFina
68f0: 6c 69 7a 65 28 28 56 64 62 65 2a 29 70 53 74 6d  lize((Vdbe*)pStm
6900: 74 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  t);.  }.  return
6910: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65   rc;.}../*.** Te
6920: 72 6d 69 6e 61 74 65 20 74 68 65 20 63 75 72 72  rminate the curr
6930: 65 6e 74 20 65 78 65 63 75 74 69 6f 6e 20 6f 66  ent execution of
6940: 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e   an SQL statemen
6950: 74 20 61 6e 64 20 72 65 73 65 74 20 69 74 0a 2a  t and reset it.*
6960: 2a 20 62 61 63 6b 20 74 6f 20 69 74 73 20 73 74  * back to its st
6970: 61 72 74 69 6e 67 20 73 74 61 74 65 20 73 6f 20  arting state so 
6980: 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 20 72  that it can be r
6990: 65 75 73 65 64 2e 20 41 20 73 75 63 63 65 73 73  eused. A success
69a0: 20 63 6f 64 65 20 66 72 6f 6d 0a 2a 2a 20 74 68   code from.** th
69b0: 65 20 70 72 69 6f 72 20 65 78 65 63 75 74 69 6f  e prior executio
69c0: 6e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a  n is returned..*
69d0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
69e0: 65 20 73 65 74 73 20 74 68 65 20 65 72 72 6f 72  e sets the error
69f0: 20 63 6f 64 65 20 61 6e 64 20 73 74 72 69 6e 67   code and string
6a00: 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20   returned by.** 
6a10: 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28  sqlite3_errcode(
6a20: 29 2c 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73  ), sqlite3_errms
6a30: 67 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f  g() and sqlite3_
6a40: 65 72 72 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69  errmsg16()..*/.i
6a50: 6e 74 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74  nt sqlite3_reset
6a60: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
6a70: 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b  Stmt){.  int rc;
6a80: 0a 20 20 69 66 28 20 70 53 74 6d 74 3d 3d 30 20  .  if( pStmt==0 
6a90: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
6aa0: 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a  TE_OK;.  }else{.
6ab0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
6ac0: 56 64 62 65 52 65 73 65 74 28 28 56 64 62 65 2a  VdbeReset((Vdbe*
6ad0: 29 70 53 74 6d 74 29 3b 0a 20 20 20 20 73 71 6c  )pStmt);.    sql
6ae0: 69 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61 64  ite3VdbeMakeRead
6af0: 79 28 28 56 64 62 65 2a 29 70 53 74 6d 74 2c 20  y((Vdbe*)pStmt, 
6b00: 2d 31 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20  -1, 0, 0, 0);.  
6b10: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  }.  return rc;.}
6b20: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72  ../*.** Register
6b30: 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e   a new collation
6b40: 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 74   sequence with t
6b50: 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64  he database hand
6b60: 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71  le db..*/.int sq
6b70: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c  lite3_create_col
6b80: 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65  lation(.  sqlite
6b90: 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20  3* db, .  const 
6ba0: 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20  char *zName, .  
6bb0: 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64  int enc, .  void
6bc0: 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78  * pCtx,.  int(*x
6bd0: 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69  Compare)(void*,i
6be0: 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69  nt,const void*,i
6bf0: 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a  nt,const void*).
6c00: 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43  ){.  CollSeq *pC
6c10: 6f 6c 6c 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  oll;.  int rc = 
6c20: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 0a 20 20  SQLITE_OK;.  .  
6c30: 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74  if( sqlite3Safet
6c40: 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a 20 20  yCheck(db) ){.  
6c50: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
6c60: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 2f  MISUSE;.  }..  /
6c70: 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 46 31  * If SQLITE_UTF1
6c80: 36 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61  6 is specified a
6c90: 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 74  s the encoding t
6ca0: 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74  ype, transform t
6cb0: 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20  his.  ** to one 
6cc0: 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c  of SQLITE_UTF16L
6cd0: 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31  E or SQLITE_UTF1
6ce0: 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a 20 20  6BE using the.  
6cf0: 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e  ** SQLITE_UTF16N
6d00: 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c  ATIVE macro. SQL
6d10: 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e 6f 74  ITE_UTF16 is not
6d20: 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79   used internally
6d30: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63  ..  */.  if( enc
6d40: 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 29  ==SQLITE_UTF16 )
6d50: 7b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 4c 49  {.    enc = SQLI
6d60: 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a  TE_UTF16NATIVE;.
6d70: 20 20 7d 0a 0a 20 20 69 66 28 20 65 6e 63 21 3d    }..  if( enc!=
6d80: 53 51 4c 49 54 45 5f 55 54 46 38 20 26 26 20 65  SQLITE_UTF8 && e
6d90: 6e 63 21 3d 53 51 4c 49 54 45 5f 55 54 46 31 36  nc!=SQLITE_UTF16
6da0: 4c 45 20 26 26 20 65 6e 63 21 3d 53 51 4c 49 54  LE && enc!=SQLIT
6db0: 45 5f 55 54 46 31 36 42 45 20 29 7b 0a 20 20 20  E_UTF16BE ){.   
6dc0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
6dd0: 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 20  , SQLITE_ERROR, 
6de0: 0a 20 20 20 20 20 20 20 20 22 50 61 72 61 6d 20  .        "Param 
6df0: 33 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 72 65  3 to sqlite3_cre
6e00: 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 29 20  ate_collation() 
6e10: 6d 75 73 74 20 62 65 20 6f 6e 65 20 6f 66 20 22  must be one of "
6e20: 0a 20 20 20 20 20 20 20 20 22 53 51 4c 49 54 45  .        "SQLITE
6e30: 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 55 54  _UTF8, SQLITE_UT
6e40: 46 31 36 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  F16, SQLITE_UTF1
6e50: 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54  6LE or SQLITE_UT
6e60: 46 31 36 42 45 22 0a 20 20 20 20 29 3b 0a 20 20  F16BE".    );.  
6e70: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
6e80: 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  ERROR;.  }..  /*
6e90: 20 43 68 65 63 6b 20 69 66 20 74 68 69 73 20 63   Check if this c
6ea0: 61 6c 6c 20 69 73 20 72 65 6d 6f 76 69 6e 67 20  all is removing 
6eb0: 6f 72 20 72 65 70 6c 61 63 69 6e 67 20 61 6e 20  or replacing an 
6ec0: 65 78 69 73 74 69 6e 67 20 63 6f 6c 6c 61 74 69  existing collati
6ed0: 6f 6e 20 0a 20 20 2a 2a 20 73 65 71 75 65 6e 63  on .  ** sequenc
6ee0: 65 2e 20 49 66 20 73 6f 2c 20 61 6e 64 20 74 68  e. If so, and th
6ef0: 65 72 65 20 61 72 65 20 61 63 74 69 76 65 20 56  ere are active V
6f00: 4d 73 2c 20 72 65 74 75 72 6e 20 62 75 73 79 2e  Ms, return busy.
6f10: 20 49 66 20 74 68 65 72 65 0a 20 20 2a 2a 20 61   If there.  ** a
6f20: 72 65 20 6e 6f 20 61 63 74 69 76 65 20 56 4d 73  re no active VMs
6f30: 2c 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 79  , invalidate any
6f40: 20 70 72 65 2d 63 6f 6d 70 69 6c 65 64 20 73 74   pre-compiled st
6f50: 61 74 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20  atements..  */. 
6f60: 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33   pColl = sqlite3
6f70: 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20  FindCollSeq(db, 
6f80: 28 75 38 29 65 6e 63 2c 20 7a 4e 61 6d 65 2c 20  (u8)enc, zName, 
6f90: 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 30  strlen(zName), 0
6fa0: 29 3b 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 26  );.  if( pColl &
6fb0: 26 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 7b  & pColl->xCmp ){
6fc0: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 63 74  .    if( db->act
6fd0: 69 76 65 56 64 62 65 43 6e 74 20 29 7b 0a 20 20  iveVdbeCnt ){.  
6fe0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
6ff0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59  (db, SQLITE_BUSY
7000: 2c 20 0a 20 20 20 20 20 20 20 20 22 55 6e 61 62  , .        "Unab
7010: 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f 64  le to delete/mod
7020: 69 66 79 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65  ify collation se
7030: 71 75 65 6e 63 65 20 64 75 65 20 74 6f 20 61 63  quence due to ac
7040: 74 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22  tive statements"
7050: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
7060: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20  SQLITE_BUSY;.   
7070: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78   }.    sqlite3Ex
7080: 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74  pirePreparedStat
7090: 65 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 7d 0a  ements(db);.  }.
70a0: 0a 20 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74  .  pColl = sqlit
70b0: 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62  e3FindCollSeq(db
70c0: 2c 20 28 75 38 29 65 6e 63 2c 20 7a 4e 61 6d 65  , (u8)enc, zName
70d0: 2c 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c  , strlen(zName),
70e0: 20 31 29 3b 0a 20 20 69 66 28 20 30 3d 3d 70 43   1);.  if( 0==pC
70f0: 6f 6c 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  oll ){.    rc = 
7100: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
7110: 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43 6f 6c 6c  }else{.    pColl
7120: 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d 70 61 72  ->xCmp = xCompar
7130: 65 3b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 70 55  e;.    pColl->pU
7140: 73 65 72 20 3d 20 70 43 74 78 3b 0a 20 20 20 20  ser = pCtx;.    
7150: 70 43 6f 6c 6c 2d 3e 65 6e 63 20 3d 20 65 6e 63  pColl->enc = enc
7160: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 45  ;.  }.  sqlite3E
7170: 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 30 29 3b  rror(db, rc, 0);
7180: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
7190: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
71a0: 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a  OMIT_UTF16./*.**
71b0: 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 20   Register a new 
71c0: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e  collation sequen
71d0: 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74 61  ce with the data
71e0: 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a  base handle db..
71f0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
7200: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31  reate_collation1
7210: 36 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62  6(.  sqlite3* db
7220: 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  , .  const char 
7230: 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65  *zName, .  int e
7240: 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74  nc, .  void* pCt
7250: 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61  x,.  int(*xCompa
7260: 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f  re)(void*,int,co
7270: 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f  nst void*,int,co
7280: 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20  nst void*).){.  
7290: 63 68 61 72 20 2a 7a 4e 61 6d 65 38 3b 0a 20 20  char *zName8;.  
72a0: 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 73 71  int rc;.  if( sq
72b0: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b  lite3SafetyCheck
72c0: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75  (db) ){.    retu
72d0: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
72e0: 3b 0a 20 20 7d 0a 20 20 7a 4e 61 6d 65 38 20 3d  ;.  }.  zName8 =
72f0: 20 73 71 6c 69 74 65 33 75 74 66 31 36 74 6f 38   sqlite3utf16to8
7300: 28 7a 4e 61 6d 65 2c 20 2d 31 29 3b 0a 20 20 72  (zName, -1);.  r
7310: 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65 61  c = sqlite3_crea
7320: 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c  te_collation(db,
7330: 20 7a 4e 61 6d 65 38 2c 20 65 6e 63 2c 20 70 43   zName8, enc, pC
7340: 74 78 2c 20 78 43 6f 6d 70 61 72 65 29 3b 0a 20  tx, xCompare);. 
7350: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4e 61 6d   sqliteFree(zNam
7360: 65 38 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  e8);.  return rc
7370: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
7380: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20  LITE_OMIT_UTF16 
7390: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74  */../*.** Regist
73a0: 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 73  er a collation s
73b0: 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 20  equence factory 
73c0: 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 20 74 68  callback with th
73d0: 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  e database handl
73e0: 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c 61 63 65  e.** db. Replace
73f0: 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c 79 20   any previously 
7400: 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 74  installed collat
7410: 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63  ion sequence fac
7420: 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  tory..*/.int sql
7430: 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e  ite3_collation_n
7440: 65 65 64 65 64 28 0a 20 20 73 71 6c 69 74 65 33  eeded(.  sqlite3
7450: 20 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a 70   *db, .  void *p
7460: 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20 0a  CollNeededArg, .
7470: 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65    void(*xCollNee
7480: 64 65 64 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74  ded)(void*,sqlit
7490: 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70  e3*,int eTextRep
74a0: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 0a 29 7b  ,const char*).){
74b0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61  .  if( sqlite3Sa
74c0: 66 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b  fetyCheck(db) ){
74d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
74e0: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20  TE_MISUSE;.  }. 
74f0: 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64   db->xCollNeeded
7500: 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 65 64 3b 0a   = xCollNeeded;.
7510: 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65    db->xCollNeede
7520: 64 31 36 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 70  d16 = 0;.  db->p
7530: 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 20 3d 20  CollNeededArg = 
7540: 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a  pCollNeededArg;.
7550: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
7560: 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53  OK;.}..#ifndef S
7570: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
7580: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20  ./*.** Register 
7590: 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75  a collation sequ
75a0: 65 6e 63 65 20 66 61 63 74 6f 72 79 20 63 61 6c  ence factory cal
75b0: 6c 62 61 63 6b 20 77 69 74 68 20 74 68 65 20 64  lback with the d
75c0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a  atabase handle.*
75d0: 2a 20 64 62 2e 20 52 65 70 6c 61 63 65 20 61 6e  * db. Replace an
75e0: 79 20 70 72 65 76 69 6f 75 73 6c 79 20 69 6e 73  y previously ins
75f0: 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e  talled collation
7600: 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72   sequence factor
7610: 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  y..*/.int sqlite
7620: 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64  3_collation_need
7630: 65 64 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20  ed16(.  sqlite3 
7640: 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43  *db, .  void *pC
7650: 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20 0a 20  ollNeededArg, . 
7660: 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64   void(*xCollNeed
7670: 65 64 31 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69  ed16)(void*,sqli
7680: 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65  te3*,int eTextRe
7690: 70 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29  p,const void*).)
76a0: 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53  {.  if( sqlite3S
76b0: 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20 29  afetyCheck(db) )
76c0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
76d0: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a  ITE_MISUSE;.  }.
76e0: 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65    db->xCollNeede
76f0: 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 78 43 6f  d = 0;.  db->xCo
7700: 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 78 43 6f  llNeeded16 = xCo
7710: 6c 6c 4e 65 65 64 65 64 31 36 3b 0a 20 20 64 62  llNeeded16;.  db
7720: 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67  ->pCollNeededArg
7730: 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72   = pCollNeededAr
7740: 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  g;.  return SQLI
7750: 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20  TE_OK;.}.#endif 
7760: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  /* SQLITE_OMIT_U
7770: 54 46 31 36 20 2a 2f 0a 0a 23 69 66 6e 64 65 66  TF16 */..#ifndef
7780: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 4c 4f   SQLITE_OMIT_GLO
7790: 42 41 4c 52 45 43 4f 56 45 52 0a 2f 2a 0a 2a 2a  BALRECOVER./*.**
77a0: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
77b0: 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 68 72 6f  s now an anachro
77c0: 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 20 74 6f  nism. It used to
77d0: 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f   be used to reco
77e0: 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a 20 6d 61  ver from a.** ma
77f0: 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2c 20  lloc() failure, 
7800: 62 75 74 20 53 51 4c 69 74 65 20 6e 6f 77 20 64  but SQLite now d
7810: 6f 65 73 20 74 68 69 73 20 61 75 74 6f 6d 61 74  oes this automat
7820: 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73  ically..*/.int s
7830: 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c 5f 72 65  qlite3_global_re
7840: 63 6f 76 65 72 28 29 7b 0a 20 20 72 65 74 75 72  cover(){.  retur
7850: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23  n SQLITE_OK;.}.#
7860: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65 73  endif../*.** Tes
7870: 74 20 74 6f 20 73 65 65 20 77 68 65 74 68 65 72  t to see whether
7880: 20 6f 72 20 6e 6f 74 20 74 68 65 20 64 61 74 61   or not the data
7890: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
78a0: 69 73 20 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74  is in autocommit
78b0: 0a 2a 2a 20 6d 6f 64 65 2e 20 20 52 65 74 75 72  .** mode.  Retur
78c0: 6e 20 54 52 55 45 20 69 66 20 69 74 20 69 73 20  n TRUE if it is 
78d0: 61 6e 64 20 46 41 4c 53 45 20 69 66 20 6e 6f 74  and FALSE if not
78e0: 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f  .  Autocommit mo
78f0: 64 65 20 69 73 20 6f 6e 0a 2a 2a 20 62 79 20 64  de is on.** by d
7900: 65 66 61 75 6c 74 2e 20 20 41 75 74 6f 63 6f 6d  efault.  Autocom
7910: 6d 69 74 20 69 73 20 64 69 73 61 62 6c 65 64 20  mit is disabled 
7920: 62 79 20 61 20 42 45 47 49 4e 20 73 74 61 74 65  by a BEGIN state
7930: 6d 65 6e 74 20 61 6e 64 20 72 65 65 6e 61 62 6c  ment and reenabl
7940: 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 6e 65 78  ed.** by the nex
7950: 74 20 43 4f 4d 4d 49 54 20 6f 72 20 52 4f 4c 4c  t COMMIT or ROLL
7960: 42 41 43 4b 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a  BACK..**.*******
7970: 20 54 48 49 53 20 49 53 20 41 4e 20 45 58 50 45   THIS IS AN EXPE
7980: 52 49 4d 45 4e 54 41 4c 20 41 50 49 20 41 4e 44  RIMENTAL API AND
7990: 20 49 53 20 53 55 42 4a 45 43 54 20 54 4f 20 43   IS SUBJECT TO C
79a0: 48 41 4e 47 45 20 2a 2a 2a 2a 2a 2a 0a 2a 2f 0a  HANGE ******.*/.
79b0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 67 65 74 5f  int sqlite3_get_
79c0: 61 75 74 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74  autocommit(sqlit
79d0: 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72  e3 *db){.  retur
79e0: 6e 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74  n db->autoCommit
79f0: 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49  ;.}..#ifdef SQLI
7a00: 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 54  TE_DEBUG./*.** T
7a10: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75  he following rou
7a20: 74 69 6e 65 20 69 73 20 73 75 62 74 69 74 75 74  tine is subtitut
7a30: 65 64 20 66 6f 72 20 63 6f 6e 73 74 61 6e 74 20  ed for constant 
7a40: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 69  SQLITE_CORRUPT i
7a50: 6e 0a 2a 2a 20 64 65 62 75 67 67 69 6e 67 20 62  n.** debugging b
7a60: 75 69 6c 64 73 2e 20 20 54 68 69 73 20 70 72 6f  uilds.  This pro
7a70: 76 69 64 65 73 20 61 20 77 61 79 20 74 6f 20 73  vides a way to s
7a80: 65 74 20 61 20 62 72 65 61 6b 70 6f 69 6e 74 20  et a breakpoint 
7a90: 66 6f 72 20 77 68 65 6e 0a 2a 2a 20 63 6f 72 72  for when.** corr
7aa0: 75 70 74 69 6f 6e 20 69 73 20 66 69 72 73 74 20  uption is first 
7ab0: 64 65 74 65 63 74 65 64 2e 0a 2a 2f 0a 69 6e 74  detected..*/.int
7ac0: 20 73 71 6c 69 74 65 33 43 6f 72 72 75 70 74 28   sqlite3Corrupt(
7ad0: 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20  void){.  return 
7ae0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a  SQLITE_CORRUPT;.
7af0: 7d 0a 23 65 6e 64 69 66 0a                       }.#endif.