/ Hex Artifact Content
Login

Artifact 9a42464c44a6532003391486e802e65e88789cfc:


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 33 34 20 32 30 30 36 2f 30 32  ,v 1.334 2006/02
0280: 2f 30 39 20 31 33 3a 34 33 3a 32 39 20 64 61 6e  /09 13:43: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: 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 5b  sqlite3_version[
03a0: 5d 20 3d 20 53 51 4c 49 54 45 5f 56 45 52 53 49  ] = SQLITE_VERSI
03b0: 4f 4e 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a  ON;.const char *
03c0: 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69  sqlite3_libversi
03d0: 6f 6e 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e  on(void){ return
03e0: 20 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e   sqlite3_version
03f0: 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ; }.int sqlite3_
0400: 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 65  libversion_numbe
0410: 72 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20  r(void){ return 
0420: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f 4e  SQLITE_VERSION_N
0430: 55 4d 42 45 52 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20  UMBER; }../*.** 
0440: 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61  This is the defa
0450: 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75  ult collating fu
0460: 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 20 22 42 49  nction named "BI
0470: 4e 41 52 59 22 20 77 68 69 63 68 20 69 73 20 61  NARY" which is a
0480: 6c 77 61 79 73 0a 2a 2a 20 61 76 61 69 6c 61 62  lways.** availab
0490: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
04a0: 74 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 28 0a 20  t binCollFunc(. 
04b0: 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a   void *NotUsed,.
04c0: 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e    int nKey1, con
04d0: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a  st void *pKey1,.
04e0: 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e    int nKey2, con
04f0: 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29  st void *pKey2.)
0500: 7b 0a 20 20 69 6e 74 20 72 63 2c 20 6e 3b 0a 20  {.  int rc, n;. 
0510: 20 6e 20 3d 20 6e 4b 65 79 31 3c 6e 4b 65 79 32   n = nKey1<nKey2
0520: 20 3f 20 6e 4b 65 79 31 20 3a 20 6e 4b 65 79 32   ? nKey1 : nKey2
0530: 3b 0a 20 20 72 63 20 3d 20 6d 65 6d 63 6d 70 28  ;.  rc = memcmp(
0540: 70 4b 65 79 31 2c 20 70 4b 65 79 32 2c 20 6e 29  pKey1, pKey2, n)
0550: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b  ;.  if( rc==0 ){
0560: 0a 20 20 20 20 72 63 20 3d 20 6e 4b 65 79 31 20  .    rc = nKey1 
0570: 2d 20 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 20 72  - nKey2;.  }.  r
0580: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
0590: 2a 2a 20 41 6e 6f 74 68 65 72 20 62 75 69 6c 74  ** Another built
05a0: 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65  -in collating se
05b0: 71 75 65 6e 63 65 3a 20 4e 4f 43 41 53 45 2e 20  quence: NOCASE. 
05c0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 6f 6c 6c  .**.** This coll
05d0: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69  ating sequence i
05e0: 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65  s intended to be
05f0: 20 75 73 65 64 20 66 6f 72 20 22 63 61 73 65 20   used for "case 
0600: 69 6e 64 65 70 65 6e 64 61 6e 74 0a 2a 2a 20 63  independant.** c
0610: 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 53 51 4c 69  omparison". SQLi
0620: 74 65 27 73 20 6b 6e 6f 77 6c 65 64 67 65 20 6f  te's knowledge o
0630: 66 20 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 65  f upper and lowe
0640: 72 20 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e  r case equivalen
0650: 74 73 0a 2a 2a 20 65 78 74 65 6e 64 73 20 6f 6e  ts.** extends on
0660: 6c 79 20 74 6f 20 74 68 65 20 32 36 20 63 68 61  ly to the 26 cha
0670: 72 61 63 74 65 72 73 20 75 73 65 64 20 69 6e 20  racters used in 
0680: 74 68 65 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67  the English lang
0690: 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74  uage..**.** At t
06a0: 68 65 20 6d 6f 6d 65 6e 74 20 74 68 65 72 65 20  he moment there 
06b0: 69 73 20 6f 6e 6c 79 20 61 20 55 54 46 2d 38 20  is only a UTF-8 
06c0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a  implementation..
06d0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f  */.static int no
06e0: 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e  caseCollatingFun
06f0: 63 28 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73  c(.  void *NotUs
0700: 65 64 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c  ed,.  int nKey1,
0710: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65   const void *pKe
0720: 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c  y1,.  int nKey2,
0730: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65   const void *pKe
0740: 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20  y2.){.  int r = 
0750: 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 28  sqlite3StrNICmp(
0760: 0a 20 20 20 20 20 20 28 63 6f 6e 73 74 20 63 68  .      (const ch
0770: 61 72 20 2a 29 70 4b 65 79 31 2c 20 28 63 6f 6e  ar *)pKey1, (con
0780: 73 74 20 63 68 61 72 20 2a 29 70 4b 65 79 32 2c  st char *)pKey2,
0790: 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 32 29 3f 6e   (nKey1<nKey2)?n
07a0: 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 69  Key1:nKey2);.  i
07b0: 66 28 20 30 3d 3d 72 20 29 7b 0a 20 20 20 20 72  f( 0==r ){.    r
07c0: 20 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a   = nKey1-nKey2;.
07d0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a    }.  return r;.
07e0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
07f0: 74 68 65 20 52 4f 57 49 44 20 6f 66 20 74 68 65  the ROWID of the
0800: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73   most recent ins
0810: 65 72 74 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e  ert.*/.sqlite_in
0820: 74 36 34 20 73 71 6c 69 74 65 33 5f 6c 61 73 74  t64 sqlite3_last
0830: 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71  _insert_rowid(sq
0840: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65  lite3 *db){.  re
0850: 74 75 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77  turn db->lastRow
0860: 69 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  id;.}../*.** Ret
0870: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
0880: 66 20 63 68 61 6e 67 65 73 20 69 6e 20 74 68 65  f changes in the
0890: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 61 6c   most recent cal
08a0: 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 65 78 65  l to sqlite3_exe
08b0: 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  c()..*/.int sqli
08c0: 74 65 33 5f 63 68 61 6e 67 65 73 28 73 71 6c 69  te3_changes(sqli
08d0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75  te3 *db){.  retu
08e0: 72 6e 20 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a  rn db->nChange;.
08f0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
0900: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68  the number of ch
0910: 61 6e 67 65 73 20 73 69 6e 63 65 20 74 68 65 20  anges since the 
0920: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  database handle 
0930: 77 61 73 20 6f 70 65 6e 65 64 2e 0a 2a 2f 0a 69  was opened..*/.i
0940: 6e 74 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c  nt sqlite3_total
0950: 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33  _changes(sqlite3
0960: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20   *db){.  return 
0970: 64 62 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e 67 65  db->nTotalChange
0980: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65  ;.}../*.** Close
0990: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c   an existing SQL
09a0: 69 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a  ite database.*/.
09b0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73  int sqlite3_clos
09c0: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  e(sqlite3 *db){.
09d0: 20 20 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20    HashElem *i;. 
09e0: 20 69 6e 74 20 6a 3b 0a 0a 20 20 69 66 28 20 21   int j;..  if( !
09f0: 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  db ){.    return
0a00: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a   SQLITE_OK;.  }.
0a10: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66    if( sqlite3Saf
0a20: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a  etyCheck(db) ){.
0a30: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
0a40: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 23  E_MISUSE;.  }..#
0a50: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 53 53 45  ifdef SQLITE_SSE
0a60: 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c  .  sqlite3_final
0a70: 69 7a 65 28 64 62 2d 3e 70 46 65 74 63 68 29 3b  ize(db->pFetch);
0a80: 0a 23 65 6e 64 69 66 20 0a 0a 20 20 2f 2a 20 49  .#endif ..  /* I
0a90: 66 20 74 68 65 72 65 20 61 72 65 20 61 6e 79 20  f there are any 
0aa0: 6f 75 74 73 74 61 6e 64 69 6e 67 20 56 4d 73 2c  outstanding VMs,
0ab0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42   return SQLITE_B
0ac0: 55 53 59 2e 20 2a 2f 0a 20 20 69 66 28 20 64 62  USY. */.  if( db
0ad0: 2d 3e 70 56 64 62 65 20 29 7b 0a 20 20 20 20 73  ->pVdbe ){.    s
0ae0: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
0af0: 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a 20 20  SQLITE_BUSY, .  
0b00: 20 20 20 20 20 20 22 55 6e 61 62 6c 65 20 74 6f        "Unable to
0b10: 20 63 6c 6f 73 65 20 64 75 65 20 74 6f 20 75 6e   close due to un
0b20: 66 69 6e 61 6c 69 73 65 64 20 73 74 61 74 65 6d  finalised statem
0b30: 65 6e 74 73 22 29 3b 0a 20 20 20 20 72 65 74 75  ents");.    retu
0b40: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a  rn SQLITE_BUSY;.
0b50: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 21 73    }.  assert( !s
0b60: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63  qlite3SafetyChec
0b70: 6b 28 64 62 29 20 29 3b 0a 0a 20 20 2f 2a 20 46  k(db) );..  /* F
0b80: 49 58 20 4d 45 3a 20 64 62 2d 3e 6d 61 67 69 63  IX ME: db->magic
0b90: 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 53   may be set to S
0ba0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53  QLITE_MAGIC_CLOS
0bb0: 45 44 20 69 66 20 74 68 65 20 64 61 74 61 62 61  ED if the databa
0bc0: 73 65 0a 20 20 2a 2a 20 63 61 6e 6e 6f 74 20 62  se.  ** cannot b
0bd0: 65 20 6f 70 65 6e 65 64 20 66 6f 72 20 73 6f 6d  e opened for som
0be0: 65 20 72 65 61 73 6f 6e 2e 20 53 6f 20 74 68 69  e reason. So thi
0bf0: 73 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20  s routine needs 
0c00: 74 6f 20 72 75 6e 20 69 6e 0a 20 20 2a 2a 20 74  to run in.  ** t
0c10: 68 61 74 20 63 61 73 65 2e 20 42 75 74 20 6d 61  hat case. But ma
0c20: 79 62 65 20 74 68 65 72 65 20 73 68 6f 75 6c 64  ybe there should
0c30: 20 62 65 20 61 6e 20 65 78 74 72 61 20 6d 61 67   be an extra mag
0c40: 69 63 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65  ic value for the
0c50: 0a 20 20 2a 2a 20 22 66 61 69 6c 65 64 20 74 6f  .  ** "failed to
0c60: 20 6f 70 65 6e 22 20 73 74 61 74 65 2e 0a 20 20   open" state..  
0c70: 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 67  */.  if( db->mag
0c80: 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43  ic!=SQLITE_MAGIC
0c90: 5f 43 4c 4f 53 45 44 20 26 26 20 73 71 6c 69 74  _CLOSED && sqlit
0ca0: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29  e3SafetyOn(db) )
0cb0: 7b 0a 20 20 20 20 2f 2a 20 70 72 69 6e 74 66 28  {.    /* printf(
0cc0: 22 44 49 44 20 4e 4f 54 20 43 4c 4f 53 45 5c 6e  "DID NOT CLOSE\n
0cd0: 22 29 3b 20 66 66 6c 75 73 68 28 73 74 64 6f 75  "); fflush(stdou
0ce0: 74 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 75 72  t); */.    retur
0cf0: 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  n SQLITE_ERROR;.
0d00: 20 20 7d 0a 0a 20 20 66 6f 72 28 6a 3d 30 3b 20    }..  for(j=0; 
0d10: 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 7b  j<db->nDb; j++){
0d20: 0a 20 20 20 20 73 74 72 75 63 74 20 44 62 20 2a  .    struct Db *
0d30: 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62 5b 6a  pDb = &db->aDb[j
0d40: 5d 3b 0a 20 20 20 20 69 66 28 20 70 44 62 2d 3e  ];.    if( pDb->
0d50: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  pBt ){.      sql
0d60: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70  ite3BtreeClose(p
0d70: 44 62 2d 3e 70 42 74 29 3b 0a 20 20 20 20 20 20  Db->pBt);.      
0d80: 70 44 62 2d 3e 70 42 74 20 3d 20 30 3b 0a 20 20  pDb->pBt = 0;.  
0d90: 20 20 20 20 69 66 28 20 6a 21 3d 31 20 29 7b 0a      if( j!=1 ){.
0da0: 20 20 20 20 20 20 20 20 70 44 62 2d 3e 70 53 63          pDb->pSc
0db0: 68 65 6d 61 20 3d 20 30 3b 0a 20 20 20 20 20 20  hema = 0;.      
0dc0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71  }.    }.  }.  sq
0dd0: 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e  lite3ResetIntern
0de0: 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b  alSchema(db, 0);
0df0: 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e  .  assert( db->n
0e00: 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72  Db<=2 );.  asser
0e10: 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e  t( db->aDb==db->
0e20: 61 44 62 53 74 61 74 69 63 20 29 3b 0a 20 20 66  aDbStatic );.  f
0e30: 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46  or(i=sqliteHashF
0e40: 69 72 73 74 28 26 64 62 2d 3e 61 46 75 6e 63 29  irst(&db->aFunc)
0e50: 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73  ; i; i=sqliteHas
0e60: 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 46  hNext(i)){.    F
0e70: 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c 20 2a  uncDef *pFunc, *
0e80: 70 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72 28 70  pNext;.    for(p
0e90: 46 75 6e 63 20 3d 20 28 46 75 6e 63 44 65 66 2a  Func = (FuncDef*
0ea0: 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28  )sqliteHashData(
0eb0: 69 29 3b 20 70 46 75 6e 63 3b 20 70 46 75 6e 63  i); pFunc; pFunc
0ec0: 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 70  =pNext){.      p
0ed0: 4e 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e 70 4e  Next = pFunc->pN
0ee0: 65 78 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  ext;.      sqlit
0ef0: 65 46 72 65 65 28 70 46 75 6e 63 29 3b 0a 20 20  eFree(pFunc);.  
0f00: 20 20 7d 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 69    }.  }..  for(i
0f10: 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74  =sqliteHashFirst
0f20: 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b  (&db->aCollSeq);
0f30: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68   i; i=sqliteHash
0f40: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43 6f  Next(i)){.    Co
0f50: 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28  llSeq *pColl = (
0f60: 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74 65  CollSeq *)sqlite
0f70: 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 20  HashData(i);.   
0f80: 20 73 71 6c 69 74 65 46 72 65 65 28 70 43 6f 6c   sqliteFree(pCol
0f90: 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  l);.  }.  sqlite
0fa0: 33 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e  3HashClear(&db->
0fb0: 61 43 6f 6c 6c 53 65 71 29 3b 0a 0a 20 20 73 71  aCollSeq);..  sq
0fc0: 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26  lite3HashClear(&
0fd0: 64 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 73 71  db->aFunc);.  sq
0fe0: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53  lite3Error(db, S
0ff0: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 2f 2a  QLITE_OK, 0); /*
1000: 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 6e 79   Deallocates any
1010: 20 63 61 63 68 65 64 20 65 72 72 6f 72 20 73 74   cached error st
1020: 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 28 20  rings. */.  if( 
1030: 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20  db->pErr ){.    
1040: 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65  sqlite3ValueFree
1050: 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 7d 0a  (db->pErr);.  }.
1060: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53  .  db->magic = S
1070: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f  QLITE_MAGIC_ERRO
1080: 52 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 74 65 6d  R;..  /* The tem
1090: 70 2d 64 61 74 61 62 61 73 65 20 73 63 68 65 6d  p-database schem
10a0: 61 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64  a is allocated d
10b0: 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20  ifferently from 
10c0: 74 68 65 20 6f 74 68 65 72 20 73 63 68 65 6d 61  the other schema
10d0: 0a 20 20 2a 2a 20 6f 62 6a 65 63 74 73 20 28 75  .  ** objects (u
10e0: 73 69 6e 67 20 73 71 6c 69 74 65 4d 61 6c 6c 6f  sing sqliteMallo
10f0: 63 28 29 20 64 69 72 65 63 74 6c 79 2c 20 69 6e  c() directly, in
1100: 73 74 65 61 64 20 6f 66 20 73 71 6c 69 74 65 33  stead of sqlite3
1110: 42 74 72 65 65 53 63 68 65 6d 61 28 29 29 2e 0a  BtreeSchema())..
1120: 20 20 2a 2a 20 53 6f 20 69 74 20 6e 65 65 64 73    ** So it needs
1130: 20 74 6f 20 62 65 20 66 72 65 65 64 20 68 65 72   to be freed her
1140: 65 2e 20 54 6f 64 6f 3a 20 57 68 79 20 6e 6f 74  e. Todo: Why not
1150: 20 72 6f 6c 6c 20 74 68 65 20 74 65 6d 70 20 73   roll the temp s
1160: 63 68 65 6d 61 20 69 6e 74 6f 0a 20 20 2a 2a 20  chema into.  ** 
1170: 74 68 65 20 73 61 6d 65 20 73 71 6c 69 74 65 4d  the same sqliteM
1180: 61 6c 6c 6f 63 28 29 20 61 73 20 74 68 65 20 6f  alloc() as the o
1190: 6e 65 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 65  ne that allocate
11a0: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a  s the database .
11b0: 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 3f 0a    ** structure?.
11c0: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 46 72 65    */.  sqliteFre
11d0: 65 28 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63  e(db->aDb[1].pSc
11e0: 68 65 6d 61 29 3b 0a 20 20 73 71 6c 69 74 65 46  hema);.  sqliteF
11f0: 72 65 65 28 64 62 29 3b 0a 20 20 73 71 6c 69 74  ree(db);.  sqlit
1200: 65 33 52 65 6c 65 61 73 65 54 68 72 65 61 64 44  e3ReleaseThreadD
1210: 61 74 61 28 29 3b 0a 20 20 72 65 74 75 72 6e 20  ata();.  return 
1220: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
1230: 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c  .** Rollback all
1240: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e   database files.
1250: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
1260: 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 6c 69  RollbackAll(sqli
1270: 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20  te3 *db){.  int 
1280: 69 3b 0a 20 20 69 6e 74 20 69 6e 54 72 61 6e 73  i;.  int inTrans
1290: 20 3d 20 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b   = 0;.  for(i=0;
12a0: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
12b0: 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 44  {.    if( db->aD
12c0: 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20 20 20 20  b[i].pBt ){.    
12d0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 74 72    if( sqlite3Btr
12e0: 65 65 49 73 49 6e 54 72 61 6e 73 28 64 62 2d 3e  eeIsInTrans(db->
12f0: 61 44 62 5b 69 5d 2e 70 42 74 29 20 29 7b 0a 20  aDb[i].pBt) ){. 
1300: 20 20 20 20 20 20 20 69 6e 54 72 61 6e 73 20 3d         inTrans =
1310: 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20   1;.      }.    
1320: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f    sqlite3BtreeRo
1330: 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44 62 5b 69  llback(db->aDb[i
1340: 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20 20 64 62  ].pBt);.      db
1350: 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72 61 6e 73  ->aDb[i].inTrans
1360: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
1370: 20 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 26    if( db->flags&
1380: 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61  SQLITE_InternCha
1390: 6e 67 65 73 20 29 7b 0a 20 20 20 20 73 71 6c 69  nges ){.    sqli
13a0: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
13b0: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
13c0: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 6f 6e 65 20   }..  /* If one 
13d0: 68 61 73 20 62 65 65 6e 20 63 6f 6e 66 69 67 75  has been configu
13e0: 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20  red, invoke the 
13f0: 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b 20 63 61  rollback-hook ca
1400: 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 66 28 20  llback */.  if( 
1410: 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c  db->xRollbackCal
1420: 6c 62 61 63 6b 20 26 26 20 28 69 6e 54 72 61 6e  lback && (inTran
1430: 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74 6f 43 6f  s || !db->autoCo
1440: 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20 64 62 2d  mmit) ){.    db-
1450: 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61  >xRollbackCallba
1460: 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b  ck(db->pRollback
1470: 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  Arg);.  }.}../*.
1480: 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 74  ** Return a stat
1490: 69 63 20 73 74 72 69 6e 67 20 74 68 61 74 20 64  ic string that d
14a0: 65 73 63 72 69 62 65 73 20 74 68 65 20 6b 69 6e  escribes the kin
14b0: 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 63 69  d of error speci
14c0: 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61  fied in the.** a
14d0: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73  rgument..*/.cons
14e0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 45  t char *sqlite3E
14f0: 72 72 53 74 72 28 69 6e 74 20 72 63 29 7b 0a 20  rrStr(int rc){. 
1500: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a   const char *z;.
1510: 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a    switch( rc ){.
1520: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f      case SQLITE_
1530: 52 4f 57 3a 0a 20 20 20 20 63 61 73 65 20 53 51  ROW:.    case SQ
1540: 4c 49 54 45 5f 44 4f 4e 45 3a 0a 20 20 20 20 63  LITE_DONE:.    c
1550: 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a 20 20  ase SQLITE_OK:  
1560: 20 20 20 20 20 20 20 7a 20 3d 20 22 6e 6f 74 20         z = "not 
1570: 61 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20 20  an error";      
1580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1590: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
15a0: 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  ase SQLITE_ERROR
15b0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 53 51 4c 20  :      z = "SQL 
15c0: 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72 20 6d  logic error or m
15d0: 69 73 73 69 6e 67 20 64 61 74 61 62 61 73 65 22  issing database"
15e0: 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63  ;   break;.    c
15f0: 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52 4d 3a  ase SQLITE_PERM:
1600: 20 20 20 20 20 20 20 7a 20 3d 20 22 61 63 63 65         z = "acce
1610: 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 20 64 65  ss permission de
1620: 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20 20 20  nied";          
1630: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1640: 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 54  ase SQLITE_ABORT
1650: 3a 20 20 20 20 20 20 7a 20 3d 20 22 63 61 6c 6c  :      z = "call
1660: 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 20 71  back requested q
1670: 75 65 72 79 20 61 62 6f 72 74 22 3b 20 20 20 20  uery abort";    
1680: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1690: 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 3a  ase SQLITE_BUSY:
16a0: 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61         z = "data
16b0: 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 3b  base is locked";
16c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
16d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
16e0: 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45  ase SQLITE_LOCKE
16f0: 44 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61  D:     z = "data
1700: 62 61 73 65 20 74 61 62 6c 65 20 69 73 20 6c 6f  base table is lo
1710: 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20 20  cked";          
1720: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1730: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  ase SQLITE_NOMEM
1740: 3a 20 20 20 20 20 20 7a 20 3d 20 22 6f 75 74 20  :      z = "out 
1750: 6f 66 20 6d 65 6d 6f 72 79 22 3b 20 20 20 20 20  of memory";     
1760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1770: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1780: 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f  ase SQLITE_READO
1790: 4e 4c 59 3a 20 20 20 7a 20 3d 20 22 61 74 74 65  NLY:   z = "atte
17a0: 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61 20 72  mpt to write a r
17b0: 65 61 64 6f 6e 6c 79 20 64 61 74 61 62 61 73 65  eadonly database
17c0: 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63  ";  break;.    c
17d0: 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52  ase SQLITE_INTER
17e0: 52 55 50 54 3a 20 20 7a 20 3d 20 22 69 6e 74 65  RUPT:  z = "inte
17f0: 72 72 75 70 74 65 64 22 3b 20 20 20 20 20 20 20  rrupted";       
1800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1810: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1820: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  ase SQLITE_IOERR
1830: 3a 20 20 20 20 20 20 7a 20 3d 20 22 64 69 73 6b  :      z = "disk
1840: 20 49 2f 4f 20 65 72 72 6f 72 22 3b 20 20 20 20   I/O error";    
1850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1860: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1870: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55  ase SQLITE_CORRU
1880: 50 54 3a 20 20 20 20 7a 20 3d 20 22 64 61 74 61  PT:    z = "data
1890: 62 61 73 65 20 64 69 73 6b 20 69 6d 61 67 65 20  base disk image 
18a0: 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22 3b 20 20  is malformed";  
18b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
18c0: 61 73 65 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3a  ase SQLITE_FULL:
18d0: 20 20 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61         z = "data
18e0: 62 61 73 65 20 6f 72 20 64 69 73 6b 20 69 73 20  base or disk is 
18f0: 66 75 6c 6c 22 3b 20 20 20 20 20 20 20 20 20 20  full";          
1900: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1910: 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f  ase SQLITE_CANTO
1920: 50 45 4e 3a 20 20 20 7a 20 3d 20 22 75 6e 61 62  PEN:   z = "unab
1930: 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62  le to open datab
1940: 61 73 65 20 66 69 6c 65 22 3b 20 20 20 20 20 20  ase file";      
1950: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1960: 61 73 65 20 53 51 4c 49 54 45 5f 50 52 4f 54 4f  ase SQLITE_PROTO
1970: 43 4f 4c 3a 20 20 20 7a 20 3d 20 22 64 61 74 61  COL:   z = "data
1980: 62 61 73 65 20 6c 6f 63 6b 69 6e 67 20 70 72 6f  base locking pro
1990: 74 6f 63 6f 6c 20 66 61 69 6c 75 72 65 22 3b 20  tocol failure"; 
19a0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
19b0: 61 73 65 20 53 51 4c 49 54 45 5f 45 4d 50 54 59  ase SQLITE_EMPTY
19c0: 3a 20 20 20 20 20 20 7a 20 3d 20 22 74 61 62 6c  :      z = "tabl
19d0: 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 64 61  e contains no da
19e0: 74 61 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ta";            
19f0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1a00: 61 73 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d  ase SQLITE_SCHEM
1a10: 41 3a 20 20 20 20 20 7a 20 3d 20 22 64 61 74 61  A:     z = "data
1a20: 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20  base schema has 
1a30: 63 68 61 6e 67 65 64 22 3b 20 20 20 20 20 20 20  changed";       
1a40: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1a50: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54  ase SQLITE_CONST
1a60: 52 41 49 4e 54 3a 20 7a 20 3d 20 22 63 6f 6e 73  RAINT: z = "cons
1a70: 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 3b 20  traint failed"; 
1a80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1a90: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1aa0: 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41  ase SQLITE_MISMA
1ab0: 54 43 48 3a 20 20 20 7a 20 3d 20 22 64 61 74 61  TCH:   z = "data
1ac0: 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22 3b 20  type mismatch"; 
1ad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ae0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1af0: 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  ase SQLITE_MISUS
1b00: 45 3a 20 20 20 20 20 7a 20 3d 20 22 6c 69 62 72  E:     z = "libr
1b10: 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c  ary routine call
1b20: 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e  ed out of sequen
1b30: 63 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 63  ce";break;.    c
1b40: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53  ase SQLITE_NOLFS
1b50: 3a 20 20 20 20 20 20 7a 20 3d 20 22 6b 65 72 6e  :      z = "kern
1b60: 65 6c 20 6c 61 63 6b 73 20 6c 61 72 67 65 20 66  el lacks large f
1b70: 69 6c 65 20 73 75 70 70 6f 72 74 22 3b 20 20 20  ile support";   
1b80: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1b90: 61 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48 3a  ase SQLITE_AUTH:
1ba0: 20 20 20 20 20 20 20 7a 20 3d 20 22 61 75 74 68         z = "auth
1bb0: 6f 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69 65 64  orization denied
1bc0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
1bd0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1be0: 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41  ase SQLITE_FORMA
1bf0: 54 3a 20 20 20 20 20 7a 20 3d 20 22 61 75 78 69  T:     z = "auxi
1c00: 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 20 66  liary database f
1c10: 6f 72 6d 61 74 20 65 72 72 6f 72 22 3b 20 20 20  ormat error";   
1c20: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1c30: 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  ase SQLITE_RANGE
1c40: 3a 20 20 20 20 20 20 7a 20 3d 20 22 62 69 6e 64  :      z = "bind
1c50: 20 6f 72 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78   or column index
1c60: 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 22 3b 20   out of range"; 
1c70: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63      break;.    c
1c80: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44  ase SQLITE_NOTAD
1c90: 42 3a 20 20 20 20 20 7a 20 3d 20 22 66 69 6c 65  B:     z = "file
1ca0: 20 69 73 20 65 6e 63 72 79 70 74 65 64 20 6f 72   is encrypted or
1cb0: 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61 62 61   is not a databa
1cc0: 73 65 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 64  se";break;.    d
1cd0: 65 66 61 75 6c 74 3a 20 20 20 20 20 20 20 20 20  efault:         
1ce0: 20 20 20 20 20 20 20 7a 20 3d 20 22 75 6e 6b 6e         z = "unkn
1cf0: 6f 77 6e 20 65 72 72 6f 72 22 3b 20 20 20 20 20  own error";     
1d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d10: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20      break;.  }. 
1d20: 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f 2a   return z;.}../*
1d30: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1d40: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62 75   implements a bu
1d50: 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61 74  sy callback that
1d60: 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69 65   sleeps and trie
1d70: 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69 6c  s.** again until
1d80: 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65   a timeout value
1d90: 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 54 68   is reached.  Th
1da0: 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20  e timeout value 
1db0: 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72  is.** an integer
1dc0: 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69   number of milli
1dd0: 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20 69  seconds passed i
1de0: 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a  n as the first.*
1df0: 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73  * argument..*/.s
1e00: 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65  tatic int sqlite
1e10: 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62  DefaultBusyCallb
1e20: 61 63 6b 28 0a 20 76 6f 69 64 20 2a 70 74 72 2c  ack(. void *ptr,
1e30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1e40: 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  * Database conne
1e50: 63 74 69 6f 6e 20 2a 2f 0a 20 69 6e 74 20 63 6f  ction */. int co
1e60: 75 6e 74 20 20 20 20 20 20 20 20 20 20 20 20 20  unt             
1e70: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
1e80: 74 69 6d 65 73 20 74 61 62 6c 65 20 68 61 73 20  times table has 
1e90: 62 65 65 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a  been busy */.){.
1ea0: 23 69 66 20 53 51 4c 49 54 45 5f 4d 49 4e 5f 53  #if SQLITE_MIN_S
1eb0: 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20 20 73 74 61  LEEP_MS==1.  sta
1ec0: 74 69 63 20 63 6f 6e 73 74 20 75 38 20 64 65 6c  tic const u8 del
1ed0: 61 79 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 31  ays[] =.     { 1
1ee0: 2c 20 32 2c 20 35 2c 20 31 30 2c 20 31 35 2c 20  , 2, 5, 10, 15, 
1ef0: 32 30 2c 20 32 35 2c 20 32 35 2c 20 20 32 35 2c  20, 25, 25,  25,
1f00: 20 20 35 30 2c 20 20 35 30 2c 20 31 30 30 20 7d    50,  50, 100 }
1f10: 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  ;.  static const
1f20: 20 75 38 20 74 6f 74 61 6c 73 5b 5d 20 3d 0a 20   u8 totals[] =. 
1f30: 20 20 20 20 7b 20 30 2c 20 31 2c 20 33 2c 20 20      { 0, 1, 3,  
1f40: 38 2c 20 31 38 2c 20 33 33 2c 20 35 33 2c 20 37  8, 18, 33, 53, 7
1f50: 38 2c 20 31 30 33 2c 20 31 32 38 2c 20 31 37 38  8, 103, 128, 178
1f60: 2c 20 32 32 38 20 7d 3b 0a 23 20 64 65 66 69 6e  , 228 };.# defin
1f70: 65 20 4e 44 45 4c 41 59 20 28 73 69 7a 65 6f 66  e NDELAY (sizeof
1f80: 28 64 65 6c 61 79 73 29 2f 73 69 7a 65 6f 66 28  (delays)/sizeof(
1f90: 64 65 6c 61 79 73 5b 30 5d 29 29 0a 20 20 69 6e  delays[0])).  in
1fa0: 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 28 73 71  t timeout = ((sq
1fb0: 6c 69 74 65 33 20 2a 29 70 74 72 29 2d 3e 62 75  lite3 *)ptr)->bu
1fc0: 73 79 54 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74  syTimeout;.  int
1fd0: 20 64 65 6c 61 79 2c 20 70 72 69 6f 72 3b 0a 0a   delay, prior;..
1fe0: 20 20 61 73 73 65 72 74 28 20 63 6f 75 6e 74 3e    assert( count>
1ff0: 3d 30 20 29 3b 0a 20 20 69 66 28 20 63 6f 75 6e  =0 );.  if( coun
2000: 74 20 3c 20 4e 44 45 4c 41 59 20 29 7b 0a 20 20  t < NDELAY ){.  
2010: 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73    delay = delays
2020: 5b 63 6f 75 6e 74 5d 3b 0a 20 20 20 20 70 72 69  [count];.    pri
2030: 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 63 6f 75 6e  or = totals[coun
2040: 74 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  t];.  }else{.   
2050: 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b   delay = delays[
2060: 4e 44 45 4c 41 59 2d 31 5d 3b 0a 20 20 20 20 70  NDELAY-1];.    p
2070: 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 4e 44  rior = totals[ND
2080: 45 4c 41 59 2d 31 5d 20 2b 20 64 65 6c 61 79 2a  ELAY-1] + delay*
2090: 28 63 6f 75 6e 74 2d 28 4e 44 45 4c 41 59 2d 31  (count-(NDELAY-1
20a0: 29 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 72  ));.  }.  if( pr
20b0: 69 6f 72 20 2b 20 64 65 6c 61 79 20 3e 20 74 69  ior + delay > ti
20c0: 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 64 65 6c  meout ){.    del
20d0: 61 79 20 3d 20 74 69 6d 65 6f 75 74 20 2d 20 70  ay = timeout - p
20e0: 72 69 6f 72 3b 0a 20 20 20 20 69 66 28 20 64 65  rior;.    if( de
20f0: 6c 61 79 3c 3d 30 20 29 20 72 65 74 75 72 6e 20  lay<=0 ) return 
2100: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  0;.  }.  sqlite3
2110: 4f 73 53 6c 65 65 70 28 64 65 6c 61 79 29 3b 0a  OsSleep(delay);.
2120: 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6c 73    return 1;.#els
2130: 65 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20  e.  int timeout 
2140: 3d 20 28 28 73 71 6c 69 74 65 33 20 2a 29 70 74  = ((sqlite3 *)pt
2150: 72 29 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b  r)->busyTimeout;
2160: 0a 20 20 69 66 28 20 28 63 6f 75 6e 74 2b 31 29  .  if( (count+1)
2170: 2a 31 30 30 30 20 3e 20 74 69 6d 65 6f 75 74 20  *1000 > timeout 
2180: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
2190: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73  .  }.  sqlite3Os
21a0: 53 6c 65 65 70 28 31 30 30 30 29 3b 0a 20 20 72  Sleep(1000);.  r
21b0: 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a  eturn 1;.#endif.
21c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20  }../*.** Invoke 
21d0: 74 68 65 20 67 69 76 65 6e 20 62 75 73 79 20 68  the given busy h
21e0: 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68  andler..**.** Th
21f0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61  is routine is ca
2200: 6c 6c 65 64 20 77 68 65 6e 20 61 6e 20 6f 70 65  lled when an ope
2210: 72 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 77 69  ration failed wi
2220: 74 68 20 61 20 6c 6f 63 6b 2e 0a 2a 2a 20 49 66  th a lock..** If
2230: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65   this routine re
2240: 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20  turns non-zero, 
2250: 74 68 65 20 6c 6f 63 6b 20 69 73 20 72 65 74 72  the lock is retr
2260: 69 65 64 2e 20 20 49 66 20 69 74 0a 2a 2a 20 72  ied.  If it.** r
2270: 65 74 75 72 6e 73 20 30 2c 20 74 68 65 20 6f 70  eturns 0, the op
2280: 65 72 61 74 69 6f 6e 20 61 62 6f 72 74 73 20 77  eration aborts w
2290: 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f 42 55  ith an SQLITE_BU
22a0: 53 59 20 65 72 72 6f 72 2e 0a 2a 2f 0a 69 6e 74  SY error..*/.int
22b0: 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 75   sqlite3InvokeBu
22c0: 73 79 48 61 6e 64 6c 65 72 28 42 75 73 79 48 61  syHandler(BusyHa
22d0: 6e 64 6c 65 72 20 2a 70 29 7b 0a 20 20 69 6e 74  ndler *p){.  int
22e0: 20 72 63 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20   rc;.  if( p==0 
22f0: 7c 7c 20 70 2d 3e 78 46 75 6e 63 3d 3d 30 20 7c  || p->xFunc==0 |
2300: 7c 20 70 2d 3e 6e 42 75 73 79 3c 30 20 29 20 72  | p->nBusy<0 ) r
2310: 65 74 75 72 6e 20 30 3b 0a 20 20 72 63 20 3d 20  eturn 0;.  rc = 
2320: 70 2d 3e 78 46 75 6e 63 28 70 2d 3e 70 41 72 67  p->xFunc(p->pArg
2330: 2c 20 70 2d 3e 6e 42 75 73 79 29 3b 0a 20 20 69  , p->nBusy);.  i
2340: 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20  f( rc==0 ){.    
2350: 70 2d 3e 6e 42 75 73 79 20 3d 20 2d 31 3b 0a 20  p->nBusy = -1;. 
2360: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 6e   }else{.    p->n
2370: 42 75 73 79 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65  Busy++;.  }.  re
2380: 74 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a 2f 2a 0a  turn rc; .}../*.
2390: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
23a0: 73 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61  sets the busy ca
23b0: 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71  llback for an Sq
23c0: 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f  lite database to
23d0: 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61   the.** given ca
23e0: 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20  llback function 
23f0: 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61  with the given a
2400: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20  rgument..*/.int 
2410: 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e  sqlite3_busy_han
2420: 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33 20  dler(.  sqlite3 
2430: 2a 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75  *db,.  int (*xBu
2440: 73 79 29 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a  sy)(void*,int),.
2450: 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a    void *pArg.){.
2460: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66    if( sqlite3Saf
2470: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a  etyCheck(db) ){.
2480: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
2490: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
24a0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e  db->busyHandler.
24b0: 78 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a 20  xFunc = xBusy;. 
24c0: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72   db->busyHandler
24d0: 2e 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20  .pArg = pArg;.  
24e0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e  db->busyHandler.
24f0: 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 72 65 74  nBusy = 0;.  ret
2500: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
2510: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ..#ifndef SQLITE
2520: 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 5f 43  _OMIT_PROGRESS_C
2530: 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 54 68  ALLBACK./*.** Th
2540: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20  is routine sets 
2550: 74 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c  the progress cal
2560: 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c  lback for an Sql
2570: 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20  ite database to 
2580: 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c  the.** given cal
2590: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77  lback function w
25a0: 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72  ith the given ar
25b0: 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 72 6f 67  gument. The prog
25c0: 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 77 69  ress callback wi
25d0: 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64  ll.** be invoked
25e0: 20 65 76 65 72 79 20 6e 4f 70 73 20 6f 70 63 6f   every nOps opco
25f0: 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  des..*/.void sql
2600: 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f 68 61  ite3_progress_ha
2610: 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33  ndler(.  sqlite3
2620: 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e 4f 70   *db, .  int nOp
2630: 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72 6f 67  s,.  int (*xProg
2640: 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20 0a 20  ress)(void*), . 
2650: 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20   void *pArg.){. 
2660: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66   if( !sqlite3Saf
2670: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 7b 0a  etyCheck(db) ){.
2680: 20 20 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 29      if( nOps>0 )
2690: 7b 0a 20 20 20 20 20 20 64 62 2d 3e 78 50 72 6f  {.      db->xPro
26a0: 67 72 65 73 73 20 3d 20 78 50 72 6f 67 72 65 73  gress = xProgres
26b0: 73 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6e 50 72  s;.      db->nPr
26c0: 6f 67 72 65 73 73 4f 70 73 20 3d 20 6e 4f 70 73  ogressOps = nOps
26d0: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 70 50 72 6f  ;.      db->pPro
26e0: 67 72 65 73 73 41 72 67 20 3d 20 70 41 72 67 3b  gressArg = pArg;
26f0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
2700: 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20    db->xProgress 
2710: 3d 20 30 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6e  = 0;.      db->n
2720: 50 72 6f 67 72 65 73 73 4f 70 73 20 3d 20 30 3b  ProgressOps = 0;
2730: 0a 20 20 20 20 20 20 64 62 2d 3e 70 50 72 6f 67  .      db->pProg
2740: 72 65 73 73 41 72 67 20 3d 20 30 3b 0a 20 20 20  ressArg = 0;.   
2750: 20 7d 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a   }.  }.}.#endif.
2760: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
2770: 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20  tine installs a 
2780: 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e  default busy han
2790: 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20  dler that waits 
27a0: 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69  for the.** speci
27b0: 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d  fied number of m
27c0: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f  illiseconds befo
27d0: 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a  re returning 0..
27e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62  */.int sqlite3_b
27f0: 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69  usy_timeout(sqli
2800: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29  te3 *db, int ms)
2810: 7b 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a  {.  if( ms>0 ){.
2820: 20 20 20 20 64 62 2d 3e 62 75 73 79 54 69 6d 65      db->busyTime
2830: 6f 75 74 20 3d 20 6d 73 3b 0a 20 20 20 20 73 71  out = ms;.    sq
2840: 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c  lite3_busy_handl
2850: 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65 66  er(db, sqliteDef
2860: 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b  aultBusyCallback
2870: 2c 20 28 76 6f 69 64 2a 29 64 62 29 3b 0a 20 20  , (void*)db);.  
2880: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74  }else{.    sqlit
2890: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28  e3_busy_handler(
28a0: 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20  db, 0, 0);.  }. 
28b0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
28c0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73  K;.}../*.** Caus
28d0: 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70  e any pending op
28e0: 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20  eration to stop 
28f0: 61 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20  at its earliest 
2900: 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a  opportunity..*/.
2910: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 6e 74  void sqlite3_int
2920: 65 72 72 75 70 74 28 73 71 6c 69 74 65 33 20 2a  errupt(sqlite3 *
2930: 64 62 29 7b 0a 20 20 69 66 28 20 21 73 71 6c 69  db){.  if( !sqli
2940: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64  te3SafetyCheck(d
2950: 62 29 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c  b) ){.    db->fl
2960: 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 49 6e  ags |= SQLITE_In
2970: 74 65 72 72 75 70 74 3b 0a 20 20 7d 0a 7d 0a 0a  terrupt;.  }.}..
2980: 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77 73 20 73 79  /*.** Windows sy
2990: 73 74 65 6d 73 20 73 68 6f 75 6c 64 20 63 61 6c  stems should cal
29a0: 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74  l this routine t
29b0: 6f 20 66 72 65 65 20 6d 65 6d 6f 72 79 20 74 68  o free memory th
29c0: 61 74 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65  at.** is returne
29d0: 64 20 69 6e 20 74 68 65 20 69 6e 20 74 68 65 20  d in the in the 
29e0: 65 72 72 6d 73 67 20 70 61 72 61 6d 65 74 65 72  errmsg parameter
29f0: 20 6f 66 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e   of sqlite3_open
2a00: 28 29 20 77 68 65 6e 0a 2a 2a 20 53 51 4c 69 74  () when.** SQLit
2a10: 65 20 69 73 20 61 20 44 4c 4c 2e 20 20 46 6f 72  e is a DLL.  For
2a20: 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c 20 69 74   some reason, it
2a30: 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 74   does not work t
2a40: 6f 20 63 61 6c 6c 20 66 72 65 65 28 29 0a 2a 2a  o call free().**
2a50: 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a   directly..**.**
2a60: 20 4e 6f 74 65 20 74 68 61 74 20 77 65 20 6e 65   Note that we ne
2a70: 65 64 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28  ed to call free(
2a80: 29 20 6e 6f 74 20 73 71 6c 69 74 65 46 72 65 65  ) not sqliteFree
2a90: 28 29 20 68 65 72 65 2e 0a 2a 2f 0a 76 6f 69 64  () here..*/.void
2aa0: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 63 68   sqlite3_free(ch
2ab0: 61 72 20 2a 70 29 7b 20 66 72 65 65 28 70 29 3b  ar *p){ free(p);
2ac0: 20 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66   }../*.** This f
2ad0: 75 6e 63 74 69 6f 6e 20 69 73 20 65 78 61 63 74  unction is exact
2ae0: 6c 79 20 74 68 65 20 73 61 6d 65 20 61 73 20 73  ly the same as s
2af0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75  qlite3_create_fu
2b00: 6e 63 74 69 6f 6e 28 29 2c 20 65 78 63 65 70 74  nction(), except
2b10: 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 73 20 64  .** that it is d
2b20: 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20 63 61  esigned to be ca
2b30: 6c 6c 65 64 20 62 79 20 69 6e 74 65 72 6e 61 6c  lled by internal
2b40: 20 63 6f 64 65 2e 20 54 68 65 20 64 69 66 66 65   code. The diffe
2b50: 72 65 6e 63 65 20 69 73 0a 2a 2a 20 74 68 61 74  rence is.** that
2b60: 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66   if a malloc() f
2b70: 61 69 6c 73 20 69 6e 20 73 71 6c 69 74 65 33 5f  ails in sqlite3_
2b80: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28  create_function(
2b90: 29 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65  ), an error code
2ba0: 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20  .** is returned 
2bb0: 61 6e 64 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61  and the mallocFa
2bc0: 69 6c 65 64 20 66 6c 61 67 20 63 6c 65 61 72 65  iled flag cleare
2bd0: 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  d. .*/.int sqlit
2be0: 65 33 43 72 65 61 74 65 46 75 6e 63 28 0a 20 20  e3CreateFunc(.  
2bf0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63  sqlite3 *db,.  c
2c00: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63  onst char *zFunc
2c10: 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20  tionName,.  int 
2c20: 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c  nArg,.  int enc,
2c30: 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61  .  void *pUserDa
2c40: 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75  ta,.  void (*xFu
2c50: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  nc)(sqlite3_cont
2c60: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33  ext*,int,sqlite3
2c70: 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f  _value **),.  vo
2c80: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69  id (*xStep)(sqli
2c90: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74  te3_context*,int
2ca0: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  ,sqlite3_value *
2cb0: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69  *),.  void (*xFi
2cc0: 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e  nal)(sqlite3_con
2cd0: 74 65 78 74 2a 29 0a 29 7b 0a 20 20 46 75 6e 63  text*).){.  Func
2ce0: 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e  Def *p;.  int nN
2cf0: 61 6d 65 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69  ame;..  if( sqli
2d00: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64  te3SafetyCheck(d
2d10: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  b) ){.    return
2d20: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
2d30: 20 20 7d 0a 20 20 69 66 28 20 7a 46 75 6e 63 74    }.  if( zFunct
2d40: 69 6f 6e 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20  ionName==0 ||.  
2d50: 20 20 20 20 28 78 46 75 6e 63 20 26 26 20 28 78      (xFunc && (x
2d60: 46 69 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29  Final || xStep))
2d70: 20 7c 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75   || .      (!xFu
2d80: 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26  nc && (xFinal &&
2d90: 20 21 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20   !xStep)) ||.   
2da0: 20 20 20 28 21 78 46 75 6e 63 20 26 26 20 28 21     (!xFunc && (!
2db0: 78 46 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29  xFinal && xStep)
2dc0: 29 20 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67  ) ||.      (nArg
2dd0: 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 31 32 37 29  <-1 || nArg>127)
2de0: 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 35 3c 28   ||.      (255<(
2df0: 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a  nName = strlen(z
2e00: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20  FunctionName))) 
2e10: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
2e20: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a  LITE_ERROR;.  }.
2e30: 20 20 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54    .#ifndef SQLIT
2e40: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 2f  E_OMIT_UTF16.  /
2e50: 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 46 31  * If SQLITE_UTF1
2e60: 36 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61  6 is specified a
2e70: 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 74  s the encoding t
2e80: 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74  ype, transform t
2e90: 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20  his.  ** to one 
2ea0: 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c  of SQLITE_UTF16L
2eb0: 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31  E or SQLITE_UTF1
2ec0: 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a 20 20  6BE using the.  
2ed0: 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e  ** SQLITE_UTF16N
2ee0: 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c  ATIVE macro. SQL
2ef0: 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e 6f 74  ITE_UTF16 is not
2f00: 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79   used internally
2f10: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 53  ..  **.  ** If S
2f20: 51 4c 49 54 45 5f 41 4e 59 20 69 73 20 73 70 65  QLITE_ANY is spe
2f30: 63 69 66 69 65 64 2c 20 61 64 64 20 74 68 72 65  cified, add thre
2f40: 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68  e versions of th
2f50: 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20  e function.  ** 
2f60: 74 6f 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  to the hash tabl
2f70: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 6e  e..  */.  if( en
2f80: 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20  c==SQLITE_UTF16 
2f90: 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 4c  ){.    enc = SQL
2fa0: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b  ITE_UTF16NATIVE;
2fb0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 65 6e 63  .  }else if( enc
2fc0: 3d 3d 53 51 4c 49 54 45 5f 41 4e 59 20 29 7b 0a  ==SQLITE_ANY ){.
2fd0: 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20      int rc;.    
2fe0: 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61  rc = sqlite3Crea
2ff0: 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63  teFunc(db, zFunc
3000: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20  tionName, nArg, 
3010: 53 51 4c 49 54 45 5f 55 54 46 38 2c 0a 20 20 20  SQLITE_UTF8,.   
3020: 20 20 20 20 20 20 70 55 73 65 72 44 61 74 61 2c        pUserData,
3030: 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78   xFunc, xStep, x
3040: 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 66 28 20  Final);.    if( 
3050: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc!=SQLITE_OK ) 
3060: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 72  return rc;.    r
3070: 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74  c = sqlite3Creat
3080: 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74  eFunc(db, zFunct
3090: 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53  ionName, nArg, S
30a0: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 0a 20  QLITE_UTF16LE,. 
30b0: 20 20 20 20 20 20 20 70 55 73 65 72 44 61 74 61         pUserData
30c0: 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20  , xFunc, xStep, 
30d0: 78 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 66 28  xFinal);.    if(
30e0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
30f0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
3100: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46  enc = SQLITE_UTF
3110: 31 36 42 45 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a  16BE;.  }.#else.
3120: 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55    enc = SQLITE_U
3130: 54 46 38 3b 0a 23 65 6e 64 69 66 0a 20 20 0a 20  TF8;.#endif.  . 
3140: 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 20   /* Check if an 
3150: 65 78 69 73 74 69 6e 67 20 66 75 6e 63 74 69 6f  existing functio
3160: 6e 20 69 73 20 62 65 69 6e 67 20 6f 76 65 72 72  n is being overr
3170: 69 64 64 65 6e 20 6f 72 20 64 65 6c 65 74 65 64  idden or deleted
3180: 2e 20 49 66 20 73 6f 2c 0a 20 20 2a 2a 20 61 6e  . If so,.  ** an
3190: 64 20 74 68 65 72 65 20 61 72 65 20 61 63 74 69  d there are acti
31a0: 76 65 20 56 4d 73 2c 20 74 68 65 6e 20 72 65 74  ve VMs, then ret
31b0: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e  urn SQLITE_BUSY.
31c0: 20 49 66 20 61 20 66 75 6e 63 74 69 6f 6e 0a 20   If a function. 
31d0: 20 2a 2a 20 69 73 20 62 65 69 6e 67 20 6f 76 65   ** is being ove
31e0: 72 72 69 64 64 65 6e 2f 64 65 6c 65 74 65 64 20  rridden/deleted 
31f0: 62 75 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f  but there are no
3200: 20 61 63 74 69 76 65 20 56 4d 73 2c 20 61 6c 6c   active VMs, all
3210: 6f 77 20 74 68 65 0a 20 20 2a 2a 20 6f 70 65 72  ow the.  ** oper
3220: 61 74 69 6f 6e 20 74 6f 20 63 6f 6e 74 69 6e 75  ation to continu
3230: 65 20 62 75 74 20 69 6e 76 61 6c 69 64 61 74 65  e but invalidate
3240: 20 61 6c 6c 20 70 72 65 63 6f 6d 70 69 6c 65 64   all precompiled
3250: 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20 2a   statements..  *
3260: 2f 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46  /.  p = sqlite3F
3270: 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20  indFunction(db, 
3280: 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e  zFunctionName, n
3290: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63 2c  Name, nArg, enc,
32a0: 20 30 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20   0);.  if( p && 
32b0: 70 2d 3e 69 50 72 65 66 45 6e 63 3d 3d 65 6e 63  p->iPrefEnc==enc
32c0: 20 26 26 20 70 2d 3e 6e 41 72 67 3d 3d 6e 41 72   && p->nArg==nAr
32d0: 67 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d  g ){.    if( db-
32e0: 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20 29  >activeVdbeCnt )
32f0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45  {.      sqlite3E
3300: 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f  rror(db, SQLITE_
3310: 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22  BUSY, .        "
3320: 55 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65  Unable to delete
3330: 2f 6d 6f 64 69 66 79 20 75 73 65 72 2d 66 75 6e  /modify user-fun
3340: 63 74 69 6f 6e 20 64 75 65 20 74 6f 20 61 63 74  ction due to act
3350: 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29  ive statements")
3360: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  ;.      assert( 
3370: 21 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61  !sqlite3MallocFa
3380: 69 6c 65 64 28 29 20 29 3b 0a 20 20 20 20 20 20  iled() );.      
3390: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55  return SQLITE_BU
33a0: 53 59 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  SY;.    }else{. 
33b0: 20 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 69       sqlite3Expi
33c0: 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 6d  rePreparedStatem
33d0: 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 7d 0a  ents(db);.    }.
33e0: 20 20 7d 0a 0a 20 20 70 20 3d 20 73 71 6c 69 74    }..  p = sqlit
33f0: 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64  e3FindFunction(d
3400: 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65  b, zFunctionName
3410: 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 65  , nName, nArg, e
3420: 6e 63 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 20  nc, 1);.  if( p 
3430: 29 7b 0a 20 20 20 20 70 2d 3e 66 6c 61 67 73 20  ){.    p->flags 
3440: 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 78 46 75 6e  = 0;.    p->xFun
3450: 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 20 20 70  c = xFunc;.    p
3460: 2d 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b  ->xStep = xStep;
3470: 0a 20 20 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a  .    p->xFinaliz
3480: 65 20 3d 20 78 46 69 6e 61 6c 3b 0a 20 20 20 20  e = xFinal;.    
3490: 70 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70  p->pUserData = p
34a0: 55 73 65 72 44 61 74 61 3b 0a 20 20 7d 0a 20 20  UserData;.  }.  
34b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
34c0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ;.}../*.** Creat
34d0: 65 20 6e 65 77 20 75 73 65 72 20 66 75 6e 63 74  e new user funct
34e0: 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ions..*/.int sql
34f0: 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63  ite3_create_func
3500: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 20  tion(.  sqlite3 
3510: 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61  *db,.  const cha
3520: 72 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65  r *zFunctionName
3530: 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20  ,.  int nArg,.  
3540: 69 6e 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20  int enc,.  void 
3550: 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75  *p,.  void (*xFu
3560: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  nc)(sqlite3_cont
3570: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33  ext*,int,sqlite3
3580: 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f  _value **),.  vo
3590: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69  id (*xStep)(sqli
35a0: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74  te3_context*,int
35b0: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  ,sqlite3_value *
35c0: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69  *),.  void (*xFi
35d0: 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e  nal)(sqlite3_con
35e0: 74 65 78 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20  text*).){.  int 
35f0: 72 63 3b 0a 20 20 61 73 73 65 72 74 28 20 21 73  rc;.  assert( !s
3600: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c  qlite3MallocFail
3610: 65 64 28 29 20 29 3b 0a 20 20 72 63 20 3d 20 73  ed() );.  rc = s
3620: 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63  qlite3CreateFunc
3630: 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61  (db, zFunctionNa
3640: 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70  me, nArg, enc, p
3650: 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20  , xFunc, xStep, 
3660: 78 46 69 6e 61 6c 29 3b 0a 0a 20 20 72 65 74 75  xFinal);..  retu
3670: 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69  rn sqlite3ApiExi
3680: 74 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 0a 23 69  t(db, rc);.}..#i
3690: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
36a0: 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71 6c 69  T_UTF16.int sqli
36b0: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74  te3_create_funct
36c0: 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 65 33  ion16(.  sqlite3
36d0: 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 76 6f   *db,.  const vo
36e0: 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d  id *zFunctionNam
36f0: 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20  e,.  int nArg,. 
3700: 20 69 6e 74 20 65 54 65 78 74 52 65 70 2c 0a 20   int eTextRep,. 
3710: 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64   void *p,.  void
3720: 20 28 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65   (*xFunc)(sqlite
3730: 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73  3_context*,int,s
3740: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c  qlite3_value**),
3750: 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29  .  void (*xStep)
3760: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
3770: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61  *,int,sqlite3_va
3780: 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28  lue**),.  void (
3790: 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33  *xFinal)(sqlite3
37a0: 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20  _context*).){.  
37b0: 69 6e 74 20 72 63 3b 0a 20 20 63 68 61 72 20 2a  int rc;.  char *
37c0: 7a 46 75 6e 63 38 3b 0a 20 20 61 73 73 65 72 74  zFunc8;.  assert
37d0: 28 20 21 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  ( !sqlite3Malloc
37e0: 46 61 69 6c 65 64 28 29 20 29 3b 0a 0a 20 20 7a  Failed() );..  z
37f0: 46 75 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 75  Func8 = sqlite3u
3800: 74 66 31 36 74 6f 38 28 7a 46 75 6e 63 74 69 6f  tf16to8(zFunctio
3810: 6e 4e 61 6d 65 2c 20 2d 31 29 3b 0a 20 20 72 63  nName, -1);.  rc
3820: 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65   = sqlite3Create
3830: 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 38 2c  Func(db, zFunc8,
3840: 20 6e 41 72 67 2c 20 65 54 65 78 74 52 65 70 2c   nArg, eTextRep,
3850: 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70   p, xFunc, xStep
3860: 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20 73 71 6c  , xFinal);.  sql
3870: 69 74 65 46 72 65 65 28 7a 46 75 6e 63 38 29 3b  iteFree(zFunc8);
3880: 0a 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  ..  return sqlit
3890: 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63  e3ApiExit(db, rc
38a0: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66  );.}.#endif..#if
38b0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
38c0: 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67  _TRACE./*.** Reg
38d0: 69 73 74 65 72 20 61 20 74 72 61 63 65 20 66 75  ister a trace fu
38e0: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72  nction.  The pAr
38f0: 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69  g from the previ
3900: 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64  ously registered
3910: 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74   trace.** is ret
3920: 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41  urned.  .**.** A
3930: 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63   NULL trace func
3940: 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20  tion means that 
3950: 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 78  no tracing is ex
3960: 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e  ecutes.  A non-N
3970: 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20  ULL.** trace is 
3980: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66  a pointer to a f
3990: 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20  unction that is 
39a0: 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73  invoked at the s
39b0: 74 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20  tart of each.** 
39c0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a  SQL statement..*
39d0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
39e0: 74 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a 64  trace(sqlite3 *d
39f0: 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65  b, void (*xTrace
3a00: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68  )(void*,const ch
3a10: 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 67  ar*), void *pArg
3a20: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20  ){.  void *pOld 
3a30: 3d 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 3b  = db->pTraceArg;
3a40: 0a 20 20 64 62 2d 3e 78 54 72 61 63 65 20 3d 20  .  db->xTrace = 
3a50: 78 54 72 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54  xTrace;.  db->pT
3a60: 72 61 63 65 41 72 67 20 3d 20 70 41 72 67 3b 0a  raceArg = pArg;.
3a70: 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d    return pOld;.}
3a80: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20  ./*.** Register 
3a90: 61 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69  a profile functi
3aa0: 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 72  on.  The pArg fr
3ab0: 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c  om the previousl
3ac0: 79 20 72 65 67 69 73 74 65 72 65 64 20 0a 2a 2a  y registered .**
3ad0: 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f   profile functio
3ae0: 6e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20  n is returned.  
3af0: 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c 20 70 72  .**.** A NULL pr
3b00: 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 6d  ofile function m
3b10: 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 70 72 6f  eans that no pro
3b20: 66 69 6c 69 6e 67 20 69 73 20 65 78 65 63 75 74  filing is execut
3b30: 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a  es.  A non-NULL.
3b40: 2a 2a 20 70 72 6f 66 69 6c 65 20 69 73 20 61 20  ** profile is a 
3b50: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e  pointer to a fun
3b60: 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e  ction that is in
3b70: 76 6f 6b 65 64 20 61 74 20 74 68 65 20 63 6f 6e  voked at the con
3b80: 63 6c 75 73 69 6f 6e 20 6f 66 0a 2a 2a 20 65 61  clusion of.** ea
3b90: 63 68 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ch SQL statement
3ba0: 20 74 68 61 74 20 69 73 20 72 75 6e 2e 0a 2a 2f   that is run..*/
3bb0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 70  .void *sqlite3_p
3bc0: 72 6f 66 69 6c 65 28 0a 20 20 73 71 6c 69 74 65  rofile(.  sqlite
3bd0: 33 20 2a 64 62 2c 0a 20 20 76 6f 69 64 20 28 2a  3 *db,.  void (*
3be0: 78 50 72 6f 66 69 6c 65 29 28 76 6f 69 64 2a 2c  xProfile)(void*,
3bf0: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c 69  const char*,sqli
3c00: 74 65 5f 75 69 6e 74 36 34 29 2c 0a 20 20 76 6f  te_uint64),.  vo
3c10: 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 76 6f  id *pArg.){.  vo
3c20: 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62 2d 3e 70  id *pOld = db->p
3c30: 50 72 6f 66 69 6c 65 41 72 67 3b 0a 20 20 64 62  ProfileArg;.  db
3c40: 2d 3e 78 50 72 6f 66 69 6c 65 20 3d 20 78 50 72  ->xProfile = xPr
3c50: 6f 66 69 6c 65 3b 0a 20 20 64 62 2d 3e 70 50 72  ofile;.  db->pPr
3c60: 6f 66 69 6c 65 41 72 67 20 3d 20 70 41 72 67 3b  ofileArg = pArg;
3c70: 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a  .  return pOld;.
3c80: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
3c90: 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 20 2a 2f  TE_OMIT_TRACE */
3ca0: 0a 0a 2f 2a 2a 2a 20 45 58 50 45 52 49 4d 45 4e  ../*** EXPERIMEN
3cb0: 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65  TAL ***.**.** Re
3cc0: 67 69 73 74 65 72 20 61 20 66 75 6e 63 74 69 6f  gister a functio
3cd0: 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20  n to be invoked 
3ce0: 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74 69  when a transacti
3cf0: 6f 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a 20  on comments..** 
3d00: 49 66 20 74 68 65 20 69 6e 76 6f 6b 65 64 20 66  If the invoked f
3d10: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20  unction returns 
3d20: 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 74  non-zero, then t
3d30: 68 65 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d 65  he commit become
3d40: 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2e  s a.** rollback.
3d50: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  .*/.void *sqlite
3d60: 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a 20  3_commit_hook(. 
3d70: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
3d80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74             /* At
3d90: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f  tach the hook to
3da0: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a   this database *
3db0: 2f 0a 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c 62  /.  int (*xCallb
3dc0: 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f 2a  ack)(void*),  /*
3dd0: 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76   Function to inv
3de0: 6f 6b 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d  oke on each comm
3df0: 69 74 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41  it */.  void *pA
3e00: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20  rg              
3e10: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f    /* Argument to
3e20: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f   the function */
3e30: 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64  .){.  void *pOld
3e40: 20 3d 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72   = db->pCommitAr
3e50: 67 3b 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 74  g;.  db->xCommit
3e60: 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c  Callback = xCall
3e70: 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d  back;.  db->pCom
3e80: 6d 69 74 41 72 67 20 3d 20 70 41 72 67 3b 0a 20  mitArg = pArg;. 
3e90: 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a   return pOld;.}.
3ea0: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20  ./*.** Register 
3eb0: 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65  a callback to be
3ec0: 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69   invoked each ti
3ed0: 6d 65 20 61 20 72 6f 77 20 69 73 20 75 70 64 61  me a row is upda
3ee0: 74 65 64 2c 0a 2a 2a 20 69 6e 73 65 72 74 65 64  ted,.** inserted
3ef0: 20 6f 72 20 64 65 6c 65 74 65 64 20 75 73 69 6e   or deleted usin
3f00: 67 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20  g this database 
3f10: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76  connection..*/.v
3f20: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 75 70 64  oid *sqlite3_upd
3f30: 61 74 65 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69  ate_hook(.  sqli
3f40: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20  te3 *db,        
3f50: 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20        /* Attach 
3f60: 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73  the hook to this
3f70: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 76   database */.  v
3f80: 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29  oid (*xCallback)
3f90: 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 68 61 72 20  (void*,int,char 
3fa0: 63 6f 6e 73 74 20 2a 2c 63 68 61 72 20 63 6f 6e  const *,char con
3fb0: 73 74 20 2a 2c 73 71 6c 69 74 65 5f 69 6e 74 36  st *,sqlite_int6
3fc0: 34 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67  4),.  void *pArg
3fd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3fe0: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74  /* Argument to t
3ff0: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29  he function */.)
4000: 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 20 3d  {.  void *pRet =
4010: 20 64 62 2d 3e 70 55 70 64 61 74 65 41 72 67 3b   db->pUpdateArg;
4020: 0a 20 20 64 62 2d 3e 78 55 70 64 61 74 65 43 61  .  db->xUpdateCa
4030: 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61  llback = xCallba
4040: 63 6b 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61 74  ck;.  db->pUpdat
4050: 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72  eArg = pArg;.  r
4060: 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f  eturn pRet;.}../
4070: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20  *.** Register a 
4080: 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69  callback to be i
4090: 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65  nvoked each time
40a0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
40b0: 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b  s rolled.** back
40c0: 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 73   by this databas
40d0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f  e connection..*/
40e0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72  .void *sqlite3_r
40f0: 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20 20  ollback_hook(.  
4100: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
4110: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74            /* Att
4120: 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20  ach the hook to 
4130: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f  this database */
4140: 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62  .  void (*xCallb
4150: 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 2f 2a 20  ack)(void*), /* 
4160: 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f  Callback functio
4170: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72  n */.  void *pAr
4180: 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  g               
4190: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20   /* Argument to 
41a0: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a  the function */.
41b0: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 20  ){.  void *pRet 
41c0: 3d 20 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41  = db->pRollbackA
41d0: 72 67 3b 0a 20 20 64 62 2d 3e 78 52 6f 6c 6c 62  rg;.  db->xRollb
41e0: 61 63 6b 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43  ackCallback = xC
41f0: 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70  allback;.  db->p
4200: 52 6f 6c 6c 62 61 63 6b 41 72 67 20 3d 20 70 41  RollbackArg = pA
4210: 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 70 52 65  rg;.  return pRe
4220: 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  t;.}../*.** This
4230: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c   routine is call
4240: 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 63  ed to create a c
4250: 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61 20 64  onnection to a d
4260: 61 74 61 62 61 73 65 20 42 54 72 65 65 0a 2a 2a  atabase BTree.**
4270: 20 64 72 69 76 65 72 2e 20 20 49 66 20 7a 46 69   driver.  If zFi
4280: 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 20 6e 61  lename is the na
4290: 6d 65 20 6f 66 20 61 20 66 69 6c 65 2c 20 74 68  me of a file, th
42a0: 65 6e 20 74 68 61 74 20 66 69 6c 65 20 69 73 0a  en that file is.
42b0: 2a 2a 20 6f 70 65 6e 65 64 20 61 6e 64 20 75 73  ** opened and us
42c0: 65 64 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d  ed.  If zFilenam
42d0: 65 20 69 73 20 74 68 65 20 6d 61 67 69 63 20 6e  e is the magic n
42e0: 61 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74  ame ":memory:" t
42f0: 68 65 6e 0a 2a 2a 20 74 68 65 20 64 61 74 61 62  hen.** the datab
4300: 61 73 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e  ase is stored in
4310: 20 6d 65 6d 6f 72 79 20 28 61 6e 64 20 69 73 20   memory (and is 
4320: 74 68 75 73 20 66 6f 72 67 6f 74 74 65 6e 20 61  thus forgotten a
4330: 73 20 73 6f 6f 6e 20 61 73 0a 2a 2a 20 74 68 65  s soon as.** the
4340: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63   connection is c
4350: 6c 6f 73 65 64 2e 29 20 20 49 66 20 7a 46 69 6c  losed.)  If zFil
4360: 65 6e 61 6d 65 20 69 73 20 4e 55 4c 4c 20 74 68  ename is NULL th
4370: 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  en the database.
4380: 2a 2a 20 69 73 20 61 20 22 76 69 72 74 75 61 6c  ** is a "virtual
4390: 22 20 64 61 74 61 62 61 73 65 20 66 6f 72 20 74  " database for t
43a0: 72 61 6e 73 69 65 6e 74 20 75 73 65 20 6f 6e 6c  ransient use onl
43b0: 79 20 61 6e 64 20 69 73 20 64 65 6c 65 74 65 64  y and is deleted
43c0: 20 61 73 0a 2a 2a 20 73 6f 6f 6e 20 61 73 20 74   as.** soon as t
43d0: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73  he connection is
43e0: 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 41   closed..**.** A
43f0: 20 76 69 72 74 75 61 6c 20 64 61 74 61 62 61 73   virtual databas
4400: 65 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20  e can be either 
4410: 61 20 64 69 73 6b 20 66 69 6c 65 20 28 74 68 61  a disk file (tha
4420: 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c  t is automatical
4430: 6c 79 0a 2a 2a 20 64 65 6c 65 74 65 64 20 77 68  ly.** deleted wh
4440: 65 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20 63  en the file is c
4450: 6c 6f 73 65 64 29 20 6f 72 20 69 74 20 61 6e 20  losed) or it an 
4460: 62 65 20 68 65 6c 64 20 65 6e 74 69 72 65 6c 79  be held entirely
4470: 20 69 6e 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 64   in memory,.** d
4480: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20  epending on the 
4490: 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 54 45  values of the TE
44a0: 4d 50 5f 53 54 4f 52 45 20 63 6f 6d 70 69 6c 65  MP_STORE compile
44b0: 2d 74 69 6d 65 20 6d 61 63 72 6f 20 61 6e 64 20  -time macro and 
44c0: 74 68 65 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 5f  the.** db->temp_
44d0: 73 74 6f 72 65 20 76 61 72 69 61 62 6c 65 2c 20  store variable, 
44e0: 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65  according to the
44f0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74   following chart
4500: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 54 45  :.**.**       TE
4510: 4d 50 5f 53 54 4f 52 45 20 20 20 20 20 64 62 2d  MP_STORE     db-
4520: 3e 74 65 6d 70 5f 73 74 6f 72 65 20 20 20 20 20  >temp_store     
4530: 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 65 6d 70  Location of temp
4540: 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 0a 2a  orary database.*
4550: 2a 20 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d  *       --------
4560: 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d  --     ---------
4570: 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d  -----     ------
4580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4590: 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20  --------.**     
45a0: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20        0         
45b0: 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20 20        any       
45c0: 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20        file.**   
45d0: 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20          1       
45e0: 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20           1      
45f0: 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20          file.** 
4600: 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20            1     
4610: 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20             2    
4620: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79            memory
4630: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 31 20  .**           1 
4640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30                 0
4650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69                fi
4660: 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  le.**           
4670: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  2               
4680: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20   1              
4690: 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20  file.**         
46a0: 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20    2             
46b0: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20     2            
46c0: 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20    memory.**     
46d0: 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20        2         
46e0: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20         0        
46f0: 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20        memory.** 
4700: 20 20 20 20 20 20 20 20 20 20 33 20 20 20 20 20            3     
4710: 20 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 20            any   
4720: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79            memory
4730: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42  .*/.int sqlite3B
4740: 74 72 65 65 46 61 63 74 6f 72 79 28 0a 20 20 63  treeFactory(.  c
4750: 6f 6e 73 74 20 73 71 6c 69 74 65 33 20 2a 64 62  onst sqlite3 *db
4760: 2c 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 69 6e  ,        /* Main
4770: 20 64 61 74 61 62 61 73 65 20 77 68 65 6e 20 6f   database when o
4780: 70 65 6e 69 6e 67 20 61 75 78 20 6f 74 68 65 72  pening aux other
4790: 77 69 73 65 20 30 20 2a 2f 0a 20 20 63 6f 6e 73  wise 0 */.  cons
47a0: 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d  t char *zFilenam
47b0: 65 2c 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66  e,    /* Name of
47c0: 20 74 68 65 20 66 69 6c 65 20 63 6f 6e 74 61 69   the file contai
47d0: 6e 69 6e 67 20 74 68 65 20 42 54 72 65 65 20 64  ning the BTree d
47e0: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74  atabase */.  int
47f0: 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 2c 20 20 20   omitJournal,   
4800: 20 20 20 20 20 20 20 2f 2a 20 69 66 20 54 52 55         /* if TRU
4810: 45 20 74 68 65 6e 20 64 6f 20 6e 6f 74 20 6a 6f  E then do not jo
4820: 75 72 6e 61 6c 20 74 68 69 73 20 66 69 6c 65 20  urnal this file 
4830: 2a 2f 0a 20 20 69 6e 74 20 6e 43 61 63 68 65 2c  */.  int nCache,
4840: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
4850: 2a 20 48 6f 77 20 6d 61 6e 79 20 70 61 67 65 73  * How many pages
4860: 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61 63   in the page cac
4870: 68 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 2a  he */.  Btree **
4880: 70 70 42 74 72 65 65 20 20 20 20 20 20 20 20 20  ppBtree         
4890: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20    /* Pointer to 
48a0: 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 63 74  new Btree object
48b0: 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 2a 2f   written here */
48c0: 0a 29 7b 0a 20 20 69 6e 74 20 62 74 72 65 65 5f  .){.  int btree_
48d0: 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20 69 6e 74  flags = 0;.  int
48e0: 20 72 63 3b 0a 20 20 0a 20 20 61 73 73 65 72 74   rc;.  .  assert
48f0: 28 20 70 70 42 74 72 65 65 20 21 3d 20 30 29 3b  ( ppBtree != 0);
4900: 0a 20 20 69 66 28 20 6f 6d 69 74 4a 6f 75 72 6e  .  if( omitJourn
4910: 61 6c 20 29 7b 0a 20 20 20 20 62 74 72 65 65 5f  al ){.    btree_
4920: 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f 4f  flags |= BTREE_O
4930: 4d 49 54 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 7d  MIT_JOURNAL;.  }
4940: 0a 20 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73  .  if( db->flags
4950: 20 26 20 53 51 4c 49 54 45 5f 4e 6f 52 65 61 64   & SQLITE_NoRead
4960: 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 62 74 72 65  lock ){.    btre
4970: 65 5f 66 6c 61 67 73 20 7c 3d 20 42 54 52 45 45  e_flags |= BTREE
4980: 5f 4e 4f 5f 52 45 41 44 4c 4f 43 4b 3b 0a 20 20  _NO_READLOCK;.  
4990: 7d 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d  }.  if( zFilenam
49a0: 65 3d 3d 30 20 29 7b 0a 23 69 66 20 54 45 4d 50  e==0 ){.#if TEMP
49b0: 5f 53 54 4f 52 45 3d 3d 30 0a 20 20 20 20 2f 2a  _STORE==0.    /*
49c0: 20 44 6f 20 6e 6f 74 68 69 6e 67 20 2a 2f 0a 23   Do nothing */.#
49d0: 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51  endif.#ifndef SQ
49e0: 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59  LITE_OMIT_MEMORY
49f0: 44 42 0a 23 69 66 20 54 45 4d 50 5f 53 54 4f 52  DB.#if TEMP_STOR
4a00: 45 3d 3d 31 0a 20 20 20 20 69 66 28 20 64 62 2d  E==1.    if( db-
4a10: 3e 74 65 6d 70 5f 73 74 6f 72 65 3d 3d 32 20 29  >temp_store==2 )
4a20: 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d   zFilename = ":m
4a30: 65 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a  emory:";.#endif.
4a40: 23 69 66 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d  #if TEMP_STORE==
4a50: 32 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 74 65  2.    if( db->te
4a60: 6d 70 5f 73 74 6f 72 65 21 3d 31 20 29 20 7a 46  mp_store!=1 ) zF
4a70: 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f  ilename = ":memo
4a80: 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 69 66  ry:";.#endif.#if
4a90: 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 33 0a 20   TEMP_STORE==3. 
4aa0: 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22     zFilename = "
4ab0: 3a 6d 65 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64 69  :memory:";.#endi
4ac0: 66 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  f.#endif /* SQLI
4ad0: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42  TE_OMIT_MEMORYDB
4ae0: 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20   */.  }..  rc = 
4af0: 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 65 6e  sqlite3BtreeOpen
4b00: 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 28 73 71 6c  (zFilename, (sql
4b10: 69 74 65 33 20 2a 29 64 62 2c 20 70 70 42 74 72  ite3 *)db, ppBtr
4b20: 65 65 2c 20 62 74 72 65 65 5f 66 6c 61 67 73 29  ee, btree_flags)
4b30: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  ;.  if( rc==SQLI
4b40: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
4b50: 69 74 65 33 42 74 72 65 65 53 65 74 42 75 73 79  ite3BtreeSetBusy
4b60: 48 61 6e 64 6c 65 72 28 2a 70 70 42 74 72 65 65  Handler(*ppBtree
4b70: 2c 20 28 76 6f 69 64 2a 29 26 64 62 2d 3e 62 75  , (void*)&db->bu
4b80: 73 79 48 61 6e 64 6c 65 72 29 3b 0a 20 20 20 20  syHandler);.    
4b90: 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 43  sqlite3BtreeSetC
4ba0: 61 63 68 65 53 69 7a 65 28 2a 70 70 42 74 72 65  acheSize(*ppBtre
4bb0: 65 2c 20 6e 43 61 63 68 65 29 3b 0a 20 20 7d 0a  e, nCache);.  }.
4bc0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
4bd0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46  /*.** Return UTF
4be0: 2d 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69  -8 encoded Engli
4bf0: 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c  sh language expl
4c00: 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d  anation of the m
4c10: 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72  ost recent.** er
4c20: 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68  ror..*/.const ch
4c30: 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d  ar *sqlite3_errm
4c40: 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  sg(sqlite3 *db){
4c50: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
4c60: 3b 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 73  ;.  if( !db || s
4c70: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c  qlite3MallocFail
4c80: 65 64 28 29 20 29 7b 0a 20 20 20 20 72 65 74 75  ed() ){.    retu
4c90: 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 74 72  rn sqlite3ErrStr
4ca0: 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a  (SQLITE_NOMEM);.
4cb0: 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65    }.  if( sqlite
4cc0: 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29  3SafetyCheck(db)
4cd0: 20 7c 7c 20 64 62 2d 3e 65 72 72 43 6f 64 65 3d   || db->errCode=
4ce0: 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 29  =SQLITE_MISUSE )
4cf0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c  {.    return sql
4d00: 69 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 54  ite3ErrStr(SQLIT
4d10: 45 5f 4d 49 53 55 53 45 29 3b 0a 20 20 7d 0a 20  E_MISUSE);.  }. 
4d20: 20 7a 20 3d 20 28 63 68 61 72 2a 29 73 71 6c 69   z = (char*)sqli
4d30: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 64  te3_value_text(d
4d40: 62 2d 3e 70 45 72 72 29 3b 0a 20 20 69 66 28 20  b->pErr);.  if( 
4d50: 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 7a 20 3d 20  z==0 ){.    z = 
4d60: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62  sqlite3ErrStr(db
4d70: 2d 3e 65 72 72 43 6f 64 65 29 3b 0a 20 20 7d 0a  ->errCode);.  }.
4d80: 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 23    return z;.}..#
4d90: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
4da0: 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52  IT_UTF16./*.** R
4db0: 65 74 75 72 6e 20 55 54 46 2d 31 36 20 65 6e 63  eturn UTF-16 enc
4dc0: 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 6e  oded English lan
4dd0: 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69 6f  guage explanatio
4de0: 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65  n of the most re
4df0: 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a  cent.** error..*
4e00: 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  /.const void *sq
4e10: 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 73  lite3_errmsg16(s
4e20: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 2f  qlite3 *db){.  /
4e30: 2a 20 42 65 63 61 75 73 65 20 61 6c 6c 20 74 68  * Because all th
4e40: 65 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 20  e characters in 
4e50: 74 68 65 20 73 74 72 69 6e 67 20 61 72 65 20 69  the string are i
4e60: 6e 20 74 68 65 20 75 6e 69 63 6f 64 65 0a 20 20  n the unicode.  
4e70: 2a 2a 20 72 61 6e 67 65 20 30 78 30 30 2d 30 78  ** range 0x00-0x
4e80: 46 46 2c 20 69 66 20 77 65 20 70 61 64 20 74 68  FF, if we pad th
4e90: 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 73 74 72  e big-endian str
4ea0: 69 6e 67 20 77 69 74 68 20 61 20 0a 20 20 2a 2a  ing with a .  **
4eb0: 20 7a 65 72 6f 20 62 79 74 65 2c 20 77 65 20 63   zero byte, we c
4ec0: 61 6e 20 6f 62 74 61 69 6e 20 74 68 65 20 6c 69  an obtain the li
4ed0: 74 74 6c 65 2d 65 6e 64 69 61 6e 20 73 74 72 69  ttle-endian stri
4ee0: 6e 67 20 77 69 74 68 0a 20 20 2a 2a 20 26 62 69  ng with.  ** &bi
4ef0: 67 5f 65 6e 64 69 61 6e 5b 31 5d 2e 0a 20 20 2a  g_endian[1]..  *
4f00: 2f 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  /.  static const
4f10: 20 63 68 61 72 20 6f 75 74 4f 66 4d 65 6d 42 65   char outOfMemBe
4f20: 5b 5d 20 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6f  [] = {.    0, 'o
4f30: 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74  ', 0, 'u', 0, 't
4f40: 27 2c 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20  ', 0, ' ', .    
4f50: 30 2c 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20  0, 'o', 0, 'f', 
4f60: 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20  0, ' ', .    0, 
4f70: 27 6d 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20  'm', 0, 'e', 0, 
4f80: 27 6d 27 2c 20 30 2c 20 27 6f 27 2c 20 30 2c 20  'm', 0, 'o', 0, 
4f90: 27 72 27 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20  'r', 0, 'y', 0, 
4fa0: 30 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74  0, 0.  };.  stat
4fb0: 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 6d 69  ic const char mi
4fc0: 73 75 73 65 42 65 20 5b 5d 20 3d 20 7b 0a 20 20  suseBe [] = {.  
4fd0: 20 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 69 27    0, 'l', 0, 'i'
4fe0: 2c 20 30 2c 20 27 62 27 2c 20 30 2c 20 27 72 27  , 0, 'b', 0, 'r'
4ff0: 2c 20 30 2c 20 27 61 27 2c 20 30 2c 20 27 72 27  , 0, 'a', 0, 'r'
5000: 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20 27 20 27  , 0, 'y', 0, ' '
5010: 2c 20 0a 20 20 20 20 30 2c 20 27 72 27 2c 20 30  , .    0, 'r', 0
5020: 2c 20 27 6f 27 2c 20 30 2c 20 27 75 27 2c 20 30  , 'o', 0, 'u', 0
5030: 2c 20 27 74 27 2c 20 30 2c 20 27 69 27 2c 20 30  , 't', 0, 'i', 0
5040: 2c 20 27 6e 27 2c 20 30 2c 20 27 65 27 2c 20 30  , 'n', 0, 'e', 0
5050: 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27  , ' ', .    0, '
5060: 63 27 2c 20 30 2c 20 27 61 27 2c 20 30 2c 20 27  c', 0, 'a', 0, '
5070: 6c 27 2c 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27  l', 0, 'l', 0, '
5080: 65 27 2c 20 30 2c 20 27 64 27 2c 20 30 2c 20 27  e', 0, 'd', 0, '
5090: 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c   ', .    0, 'o',
50a0: 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c   0, 'u', 0, 't',
50b0: 20 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c   0, ' ', .    0,
50c0: 20 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30 2c   'o', 0, 'f', 0,
50d0: 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 73   ' ', .    0, 's
50e0: 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 71  ', 0, 'e', 0, 'q
50f0: 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27 65  ', 0, 'u', 0, 'e
5100: 27 2c 20 30 2c 20 27 6e 27 2c 20 30 2c 20 27 63  ', 0, 'n', 0, 'c
5110: 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 30 2c  ', 0, 'e', 0, 0,
5120: 20 30 0a 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74   0.  };..  const
5130: 20 76 6f 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20   void *z;.  if( 
5140: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69  sqlite3MallocFai
5150: 6c 65 64 28 29 20 29 7b 0a 20 20 20 20 72 65 74  led() ){.    ret
5160: 75 72 6e 20 28 76 6f 69 64 20 2a 29 28 26 6f 75  urn (void *)(&ou
5170: 74 4f 66 4d 65 6d 42 65 5b 53 51 4c 49 54 45 5f  tOfMemBe[SQLITE_
5180: 55 54 46 31 36 4e 41 54 49 56 45 3d 3d 53 51 4c  UTF16NATIVE==SQL
5190: 49 54 45 5f 55 54 46 31 36 4c 45 3f 31 3a 30 5d  ITE_UTF16LE?1:0]
51a0: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c  );.  }.  if( sql
51b0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28  ite3SafetyCheck(
51c0: 64 62 29 20 7c 7c 20 64 62 2d 3e 65 72 72 43 6f  db) || db->errCo
51d0: 64 65 3d 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53  de==SQLITE_MISUS
51e0: 45 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  E ){.    return 
51f0: 28 76 6f 69 64 20 2a 29 28 26 6d 69 73 75 73 65  (void *)(&misuse
5200: 42 65 5b 53 51 4c 49 54 45 5f 55 54 46 31 36 4e  Be[SQLITE_UTF16N
5210: 41 54 49 56 45 3d 3d 53 51 4c 49 54 45 5f 55 54  ATIVE==SQLITE_UT
5220: 46 31 36 4c 45 3f 31 3a 30 5d 29 3b 0a 20 20 7d  F16LE?1:0]);.  }
5230: 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76  .  z = sqlite3_v
5240: 61 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d 3e  alue_text16(db->
5250: 70 45 72 72 29 3b 0a 20 20 69 66 28 20 7a 3d 3d  pErr);.  if( z==
5260: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  0 ){.    sqlite3
5270: 56 61 6c 75 65 53 65 74 53 74 72 28 64 62 2d 3e  ValueSetStr(db->
5280: 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c 69 74 65  pErr, -1, sqlite
5290: 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43  3ErrStr(db->errC
52a0: 6f 64 65 29 2c 0a 20 20 20 20 20 20 20 20 20 53  ode),.         S
52b0: 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49  QLITE_UTF8, SQLI
52c0: 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20  TE_STATIC);.    
52d0: 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  z = sqlite3_valu
52e0: 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72  e_text16(db->pEr
52f0: 72 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  r);.  }.  sqlite
5300: 33 41 70 69 45 78 69 74 28 30 2c 20 30 29 3b 0a  3ApiExit(0, 0);.
5310: 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 23 65    return z;.}.#e
5320: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f  ndif /* SQLITE_O
5330: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a  MIT_UTF16 */../*
5340: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d  .** Return the m
5350: 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72  ost recent error
5360: 20 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 20   code generated 
5370: 62 79 20 61 6e 20 53 51 4c 69 74 65 20 72 6f 75  by an SQLite rou
5380: 74 69 6e 65 2e 20 49 66 20 4e 55 4c 4c 20 69 73  tine. If NULL is
5390: 0a 2a 2a 20 70 61 73 73 65 64 20 74 6f 20 74 68  .** passed to th
53a0: 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 77 65 20  is function, we 
53b0: 61 73 73 75 6d 65 20 61 20 6d 61 6c 6c 6f 63 28  assume a malloc(
53c0: 29 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20  ) failed during 
53d0: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2e 0a  sqlite3_open()..
53e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65  */.int sqlite3_e
53f0: 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 2a  rrcode(sqlite3 *
5400: 64 62 29 7b 0a 20 20 69 66 28 20 21 64 62 20 7c  db){.  if( !db |
5410: 7c 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46  | sqlite3MallocF
5420: 61 69 6c 65 64 28 29 20 29 7b 0a 20 20 20 20 72  ailed() ){.    r
5430: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
5440: 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71  EM;.  }.  if( sq
5450: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b  lite3SafetyCheck
5460: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75  (db) ){.    retu
5470: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
5480: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64  ;.  }.  return d
5490: 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a 2f  b->errCode;.}../
54a0: 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65  *.** Create a ne
54b0: 77 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63  w collating func
54c0: 74 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 61 73  tion for databas
54d0: 65 20 22 64 62 22 2e 20 20 54 68 65 20 6e 61 6d  e "db".  The nam
54e0: 65 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 61 6e  e is zName.** an
54f0: 64 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 69  d the encoding i
5500: 73 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 69 63  s enc..*/.static
5510: 20 69 6e 74 20 63 72 65 61 74 65 43 6f 6c 6c 61   int createColla
5520: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a  tion(.  sqlite3*
5530: 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68   db, .  const ch
5540: 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e  ar *zName, .  in
5550: 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20  t enc, .  void* 
5560: 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f  pCtx,.  int(*xCo
5570: 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74  mpare)(void*,int
5580: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74  ,const void*,int
5590: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b  ,const void*).){
55a0: 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c  .  CollSeq *pCol
55b0: 6c 3b 0a 20 20 0a 20 20 69 66 28 20 73 71 6c 69  l;.  .  if( sqli
55c0: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64  te3SafetyCheck(d
55d0: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  b) ){.    return
55e0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
55f0: 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c    }..  /* If SQL
5600: 49 54 45 5f 55 54 46 31 36 20 69 73 20 73 70 65  ITE_UTF16 is spe
5610: 63 69 66 69 65 64 20 61 73 20 74 68 65 20 65 6e  cified as the en
5620: 63 6f 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61  coding type, tra
5630: 6e 73 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a  nsform this.  **
5640: 20 74 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54   to one of SQLIT
5650: 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c  E_UTF16LE or SQL
5660: 49 54 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e  ITE_UTF16BE usin
5670: 67 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54  g the.  ** SQLIT
5680: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61  E_UTF16NATIVE ma
5690: 63 72 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31  cro. SQLITE_UTF1
56a0: 36 20 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e  6 is not used in
56b0: 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20  ternally..  */. 
56c0: 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45   if( enc==SQLITE
56d0: 5f 55 54 46 31 36 20 29 7b 0a 20 20 20 20 65 6e  _UTF16 ){.    en
56e0: 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36  c = SQLITE_UTF16
56f0: 4e 41 54 49 56 45 3b 0a 20 20 7d 0a 0a 20 20 69  NATIVE;.  }..  i
5700: 66 28 20 65 6e 63 21 3d 53 51 4c 49 54 45 5f 55  f( enc!=SQLITE_U
5710: 54 46 38 20 26 26 20 65 6e 63 21 3d 53 51 4c 49  TF8 && enc!=SQLI
5720: 54 45 5f 55 54 46 31 36 4c 45 20 26 26 20 65 6e  TE_UTF16LE && en
5730: 63 21 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 42  c!=SQLITE_UTF16B
5740: 45 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  E ){.    sqlite3
5750: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45  Error(db, SQLITE
5760: 5f 45 52 52 4f 52 2c 20 0a 20 20 20 20 20 20 20  _ERROR, .       
5770: 20 22 50 61 72 61 6d 20 33 20 74 6f 20 73 71 6c   "Param 3 to sql
5780: 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c  ite3_create_coll
5790: 61 74 69 6f 6e 28 29 20 6d 75 73 74 20 62 65 20  ation() must be 
57a0: 6f 6e 65 20 6f 66 20 22 0a 20 20 20 20 20 20 20  one of ".       
57b0: 20 22 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53   "SQLITE_UTF8, S
57c0: 51 4c 49 54 45 5f 55 54 46 31 36 2c 20 53 51 4c  QLITE_UTF16, SQL
57d0: 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53  ITE_UTF16LE or S
57e0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 22 0a 20  QLITE_UTF16BE". 
57f0: 20 20 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e     );.    return
5800: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
5810: 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69   }..  /* Check i
5820: 66 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 72  f this call is r
5830: 65 6d 6f 76 69 6e 67 20 6f 72 20 72 65 70 6c 61  emoving or repla
5840: 63 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67  cing an existing
5850: 20 63 6f 6c 6c 61 74 69 6f 6e 20 0a 20 20 2a 2a   collation .  **
5860: 20 73 65 71 75 65 6e 63 65 2e 20 49 66 20 73 6f   sequence. If so
5870: 2c 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20  , and there are 
5880: 61 63 74 69 76 65 20 56 4d 73 2c 20 72 65 74 75  active VMs, retu
5890: 72 6e 20 62 75 73 79 2e 20 49 66 20 74 68 65 72  rn busy. If ther
58a0: 65 0a 20 20 2a 2a 20 61 72 65 20 6e 6f 20 61 63  e.  ** are no ac
58b0: 74 69 76 65 20 56 4d 73 2c 20 69 6e 76 61 6c 69  tive VMs, invali
58c0: 64 61 74 65 20 61 6e 79 20 70 72 65 2d 63 6f 6d  date any pre-com
58d0: 70 69 6c 65 64 20 73 74 61 74 65 6d 65 6e 74 73  piled statements
58e0: 2e 0a 20 20 2a 2f 0a 20 20 70 43 6f 6c 6c 20 3d  ..  */.  pColl =
58f0: 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c   sqlite3FindColl
5900: 53 65 71 28 64 62 2c 20 28 75 38 29 65 6e 63 2c  Seq(db, (u8)enc,
5910: 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65 6e 28 7a   zName, strlen(z
5920: 4e 61 6d 65 29 2c 20 30 29 3b 0a 20 20 69 66 28  Name), 0);.  if(
5930: 20 70 43 6f 6c 6c 20 26 26 20 70 43 6f 6c 6c 2d   pColl && pColl-
5940: 3e 78 43 6d 70 20 29 7b 0a 20 20 20 20 69 66 28  >xCmp ){.    if(
5950: 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43   db->activeVdbeC
5960: 6e 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  nt ){.      sqli
5970: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c  te3Error(db, SQL
5980: 49 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 20  ITE_BUSY, .     
5990: 20 20 20 22 55 6e 61 62 6c 65 20 74 6f 20 64 65     "Unable to de
59a0: 6c 65 74 65 2f 6d 6f 64 69 66 79 20 63 6f 6c 6c  lete/modify coll
59b0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 64  ation sequence d
59c0: 75 65 20 74 6f 20 61 63 74 69 76 65 20 73 74 61  ue to active sta
59d0: 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20 20  tements");.     
59e0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42   return SQLITE_B
59f0: 55 53 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  USY;.    }.    s
5a00: 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70  qlite3ExpirePrep
5a10: 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64  aredStatements(d
5a20: 62 29 3b 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 6c  b);.  }..  pColl
5a30: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f   = sqlite3FindCo
5a40: 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 65 6e  llSeq(db, (u8)en
5a50: 63 2c 20 7a 4e 61 6d 65 2c 20 73 74 72 6c 65 6e  c, zName, strlen
5a60: 28 7a 4e 61 6d 65 29 2c 20 31 29 3b 0a 20 20 69  (zName), 1);.  i
5a70: 66 28 20 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 20  f( pColl ){.    
5a80: 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 3d 20 78 43  pColl->xCmp = xC
5a90: 6f 6d 70 61 72 65 3b 0a 20 20 20 20 70 43 6f 6c  ompare;.    pCol
5aa0: 6c 2d 3e 70 55 73 65 72 20 3d 20 70 43 74 78 3b  l->pUser = pCtx;
5ab0: 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 65 6e 63 20  .    pColl->enc 
5ac0: 3d 20 65 6e 63 3b 0a 20 20 7d 0a 20 20 73 71 6c  = enc;.  }.  sql
5ad0: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51  ite3Error(db, SQ
5ae0: 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 72  LITE_OK, 0);.  r
5af0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
5b00: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  .}.../*.** This 
5b10: 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65  routine does the
5b20: 20 77 6f 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67   work of opening
5b30: 20 61 20 64 61 74 61 62 61 73 65 20 6f 6e 20 62   a database on b
5b40: 65 68 61 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69  ehalf of.** sqli
5b50: 74 65 33 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73  te3_open() and s
5b60: 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e  qlite3_open16().
5b70: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69   The database fi
5b80: 6c 65 6e 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d  lename "zFilenam
5b90: 65 22 20 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38  e"  .** is UTF-8
5ba0: 20 65 6e 63 6f 64 65 64 2e 0a 2a 2f 0a 73 74 61   encoded..*/.sta
5bb0: 74 69 63 20 69 6e 74 20 6f 70 65 6e 44 61 74 61  tic int openData
5bc0: 62 61 73 65 28 0a 20 20 63 6f 6e 73 74 20 63 68  base(.  const ch
5bd0: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 2f  ar *zFilename, /
5be0: 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 6e  * Database filen
5bf0: 61 6d 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65  ame UTF-8 encode
5c00: 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a  d */.  sqlite3 *
5c10: 2a 70 70 44 62 20 20 20 20 20 20 20 20 20 2f 2a  *ppDb         /*
5c20: 20 4f 55 54 3a 20 52 65 74 75 72 6e 65 64 20 64   OUT: Returned d
5c30: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a  atabase handle *
5c40: 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a  /.){.  sqlite3 *
5c50: 64 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  db;.  int rc;.  
5c60: 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 3b 0a  CollSeq *pColl;.
5c70: 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69  .  assert( !sqli
5c80: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28  te3MallocFailed(
5c90: 29 20 29 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63  ) );..  /* Alloc
5ca0: 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 20 64  ate the sqlite d
5cb0: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 2a 2f  ata structure */
5cc0: 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 65 4d 61  .  db = sqliteMa
5cd0: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 73 71 6c  lloc( sizeof(sql
5ce0: 69 74 65 33 29 20 29 3b 0a 20 20 69 66 28 20 64  ite3) );.  if( d
5cf0: 62 3d 3d 30 20 29 20 67 6f 74 6f 20 6f 70 65 6e  b==0 ) goto open
5d00: 64 62 5f 6f 75 74 3b 0a 20 20 64 62 2d 3e 70 72  db_out;.  db->pr
5d10: 69 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b  iorNewRowid = 0;
5d20: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53  .  db->magic = S
5d30: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59  QLITE_MAGIC_BUSY
5d40: 3b 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b  ;.  db->nDb = 2;
5d50: 0a 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 2d  .  db->aDb = db-
5d60: 3e 61 44 62 53 74 61 74 69 63 3b 0a 20 20 64 62  >aDbStatic;.  db
5d70: 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31  ->autoCommit = 1
5d80: 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d  ;.  db->flags |=
5d90: 20 53 51 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c   SQLITE_ShortCol
5da0: 4e 61 6d 65 73 3b 0a 20 20 73 71 6c 69 74 65 33  Names;.  sqlite3
5db0: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 46  HashInit(&db->aF
5dc0: 75 6e 63 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  unc, SQLITE_HASH
5dd0: 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73  _STRING, 0);.  s
5de0: 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26  qlite3HashInit(&
5df0: 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c 20 53 51  db->aCollSeq, SQ
5e00: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47  LITE_HASH_STRING
5e10: 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 41 64 64 20  , 0);..  /* Add 
5e20: 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c  the default coll
5e30: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 42  ation sequence B
5e40: 49 4e 41 52 59 2e 20 42 49 4e 41 52 59 20 77 6f  INARY. BINARY wo
5e50: 72 6b 73 20 66 6f 72 20 62 6f 74 68 20 55 54 46  rks for both UTF
5e60: 2d 38 0a 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d  -8.  ** and UTF-
5e70: 31 36 2c 20 73 6f 20 61 64 64 20 61 20 76 65 72  16, so add a ver
5e80: 73 69 6f 6e 20 66 6f 72 20 65 61 63 68 20 74 6f  sion for each to
5e90: 20 61 76 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63   avoid any unnec
5ea0: 65 73 73 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76  essary.  ** conv
5eb0: 65 72 73 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c  ersions. The onl
5ec0: 79 20 65 72 72 6f 72 20 74 68 61 74 20 63 61 6e  y error that can
5ed0: 20 6f 63 63 75 72 20 68 65 72 65 20 69 73 20 61   occur here is a
5ee0: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72   malloc() failur
5ef0: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 63 72  e..  */.  if( cr
5f00: 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62  eateCollation(db
5f10: 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49  , "BINARY", SQLI
5f20: 54 45 5f 55 54 46 38 2c 20 30 2c 20 62 69 6e 43  TE_UTF8, 0, binC
5f30: 6f 6c 6c 46 75 6e 63 29 20 7c 7c 0a 20 20 20 20  ollFunc) ||.    
5f40: 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f    createCollatio
5f50: 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20  n(db, "BINARY", 
5f60: 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20  SQLITE_UTF16BE, 
5f70: 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 29 20  0, binCollFunc) 
5f80: 7c 7c 0a 20 20 20 20 20 20 63 72 65 61 74 65 43  ||.      createC
5f90: 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 42 49  ollation(db, "BI
5fa0: 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 5f 55 54  NARY", SQLITE_UT
5fb0: 46 31 36 4c 45 2c 20 30 2c 20 62 69 6e 43 6f 6c  F16LE, 0, binCol
5fc0: 6c 46 75 6e 63 29 20 7c 7c 0a 20 20 20 20 20 20  lFunc) ||.      
5fd0: 28 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d  (db->pDfltColl =
5fe0: 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c   sqlite3FindColl
5ff0: 53 65 71 28 64 62 2c 20 53 51 4c 49 54 45 5f 55  Seq(db, SQLITE_U
6000: 54 46 38 2c 20 22 42 49 4e 41 52 59 22 2c 20 36  TF8, "BINARY", 6
6010: 2c 20 30 29 29 3d 3d 30 20 0a 20 20 29 7b 0a 20  , 0))==0 .  ){. 
6020: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74     assert( sqlit
6030: 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29  e3MallocFailed()
6040: 20 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69   );.    db->magi
6050: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43  c = SQLITE_MAGIC
6060: 5f 43 4c 4f 53 45 44 3b 0a 20 20 20 20 67 6f 74  _CLOSED;.    got
6070: 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20  o opendb_out;.  
6080: 7d 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64  }..  /* Also add
6090: 20 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69 6e   a UTF-8 case-in
60a0: 73 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 74  sensitive collat
60b0: 69 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f  ion sequence. */
60c0: 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69  .  createCollati
60d0: 6f 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c  on(db, "NOCASE",
60e0: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c   SQLITE_UTF8, 0,
60f0: 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67   nocaseCollating
6100: 46 75 6e 63 29 3b 0a 0a 20 20 2f 2a 20 53 65 74  Func);..  /* Set
6110: 20 66 6c 61 67 73 20 6f 6e 20 74 68 65 20 62 75   flags on the bu
6120: 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67  ilt-in collating
6130: 20 73 65 71 75 65 6e 63 65 73 20 2a 2f 0a 20 20   sequences */.  
6140: 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 2d 3e 74  db->pDfltColl->t
6150: 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 43 4f 4c  ype = SQLITE_COL
6160: 4c 5f 42 49 4e 41 52 59 3b 0a 20 20 70 43 6f 6c  L_BINARY;.  pCol
6170: 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43  l = sqlite3FindC
6180: 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c 49 54  ollSeq(db, SQLIT
6190: 45 5f 55 54 46 38 2c 20 22 4e 4f 43 41 53 45 22  E_UTF8, "NOCASE"
61a0: 2c 20 36 2c 20 30 29 3b 0a 20 20 69 66 28 20 70  , 6, 0);.  if( p
61b0: 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 70 43 6f 6c  Coll ){.    pCol
61c0: 6c 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45  l->type = SQLITE
61d0: 5f 43 4f 4c 4c 5f 4e 4f 43 41 53 45 3b 0a 20 20  _COLL_NOCASE;.  
61e0: 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65  }..  /* Open the
61f0: 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73   backend databas
6200: 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63  e driver */.  rc
6210: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 46   = sqlite3BtreeF
6220: 61 63 74 6f 72 79 28 64 62 2c 20 7a 46 69 6c 65  actory(db, zFile
6230: 6e 61 6d 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47  name, 0, MAX_PAG
6240: 45 53 2c 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e  ES, &db->aDb[0].
6250: 70 42 74 29 3b 0a 20 20 69 66 28 20 72 63 21 3d  pBt);.  if( rc!=
6260: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
6270: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
6280: 2c 20 72 63 2c 20 30 29 3b 0a 20 20 20 20 64 62  , rc, 0);.    db
6290: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
62a0: 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20  _MAGIC_CLOSED;. 
62b0: 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f     goto opendb_o
62c0: 75 74 3b 0a 20 20 7d 0a 23 69 66 6e 64 65 66 20  ut;.  }.#ifndef 
62d0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 52 53  SQLITE_OMIT_PARS
62e0: 45 52 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e  ER.  db->aDb[0].
62f0: 70 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65  pSchema = sqlite
6300: 33 53 63 68 65 6d 61 47 65 74 28 64 62 2d 3e 61  3SchemaGet(db->a
6310: 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 64 62  Db[0].pBt);.  db
6320: 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 6d 61  ->aDb[1].pSchema
6330: 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61   = sqlite3Schema
6340: 47 65 74 28 30 29 3b 0a 23 65 6e 64 69 66 0a 0a  Get(0);.#endif..
6350: 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 30 5d    if( db->aDb[0]
6360: 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20  .pSchema ){.    
6370: 45 4e 43 28 64 62 29 20 3d 20 53 51 4c 49 54 45  ENC(db) = SQLITE
6380: 5f 55 54 46 38 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  _UTF8;.  }..  /*
6390: 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 61 66   The default saf
63a0: 65 74 79 5f 6c 65 76 65 6c 20 66 6f 72 20 74 68  ety_level for th
63b0: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20  e main database 
63c0: 69 73 20 27 66 75 6c 6c 27 3b 20 66 6f 72 20 74  is 'full'; for t
63d0: 68 65 20 74 65 6d 70 0a 20 20 2a 2a 20 64 61 74  he temp.  ** dat
63e0: 61 62 61 73 65 20 69 74 20 69 73 20 27 4e 4f 4e  abase it is 'NON
63f0: 45 27 2e 20 54 68 69 73 20 6d 61 74 63 68 65 73  E'. This matches
6400: 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72   the pager layer
6410: 20 64 65 66 61 75 6c 74 73 2e 20 20 0a 20 20 2a   defaults.  .  *
6420: 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a  /.  db->aDb[0].z
6430: 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b 0a 20  Name = "main";. 
6440: 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 73 61 66 65   db->aDb[0].safe
6450: 74 79 5f 6c 65 76 65 6c 20 3d 20 33 3b 0a 23 69  ty_level = 3;.#i
6460: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
6470: 54 5f 54 45 4d 50 44 42 0a 20 20 64 62 2d 3e 61  T_TEMPDB.  db->a
6480: 44 62 5b 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22 74  Db[1].zName = "t
6490: 65 6d 70 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b  emp";.  db->aDb[
64a0: 31 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20  1].safety_level 
64b0: 3d 20 31 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f  = 1;.#endif..  /
64c0: 2a 20 52 65 67 69 73 74 65 72 20 61 6c 6c 20 62  * Register all b
64d0: 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e  uilt-in function
64e0: 73 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20 61 74  s, but do not at
64f0: 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68  tempt to read th
6500: 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20  e.  ** database 
6510: 73 63 68 65 6d 61 20 79 65 74 2e 20 54 68 69 73  schema yet. This
6520: 20 69 73 20 64 65 6c 61 79 65 64 20 75 6e 74 69   is delayed unti
6530: 6c 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65  l the first time
6540: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20   the database.  
6550: 2a 2a 20 69 73 20 61 63 63 65 73 73 65 64 2e 0a  ** is accessed..
6560: 20 20 2a 2f 0a 20 20 69 66 28 20 21 73 71 6c 69    */.  if( !sqli
6570: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28  te3MallocFailed(
6580: 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ) ){.    sqlite3
6590: 52 65 67 69 73 74 65 72 42 75 69 6c 74 69 6e 46  RegisterBuiltinF
65a0: 75 6e 63 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20  unctions(db);.  
65b0: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64    sqlite3Error(d
65c0: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29  b, SQLITE_OK, 0)
65d0: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6d 61 67 69  ;.  }.  db->magi
65e0: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43  c = SQLITE_MAGIC
65f0: 5f 4f 50 45 4e 3b 0a 0a 6f 70 65 6e 64 62 5f 6f  _OPEN;..opendb_o
6600: 75 74 3a 0a 20 20 69 66 28 20 53 51 4c 49 54 45  ut:.  if( SQLITE
6610: 5f 4e 4f 4d 45 4d 3d 3d 28 72 63 20 3d 20 73 71  _NOMEM==(rc = sq
6620: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 64 62  lite3_errcode(db
6630: 29 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  )) ){.    sqlite
6640: 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20  3_close(db);.   
6650: 20 64 62 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 2a   db = 0;.  }.  *
6660: 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 72 65 74  ppDb = db;.  ret
6670: 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78  urn sqlite3ApiEx
6680: 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a 0a 2f 2a  it(0, rc);.}../*
6690: 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64  .** Open a new d
66a0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a  atabase handle..
66b0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f  */.int sqlite3_o
66c0: 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61  pen(.  const cha
66d0: 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20  r *zFilename, . 
66e0: 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20   sqlite3 **ppDb 
66f0: 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 65  .){.  return ope
6700: 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e  nDatabase(zFilen
6710: 61 6d 65 2c 20 70 70 44 62 29 3b 0a 7d 0a 0a 23  ame, ppDb);.}..#
6720: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
6730: 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 4f  IT_UTF16./*.** O
6740: 70 65 6e 20 61 20 6e 65 77 20 64 61 74 61 62 61  pen a new databa
6750: 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e  se handle..*/.in
6760: 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36  t sqlite3_open16
6770: 28 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  (.  const void *
6780: 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71  zFilename, .  sq
6790: 6c 69 74 65 33 20 2a 2a 70 70 44 62 0a 29 7b 0a  lite3 **ppDb.){.
67a0: 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46    char const *zF
67b0: 69 6c 65 6e 61 6d 65 38 3b 20 20 20 2f 2a 20 7a  ilename8;   /* z
67c0: 46 69 6c 65 6e 61 6d 65 20 65 6e 63 6f 64 65 64  Filename encoded
67d0: 20 69 6e 20 55 54 46 2d 38 20 69 6e 73 74 65 61   in UTF-8 instea
67e0: 64 20 6f 66 20 55 54 46 2d 31 36 20 2a 2f 0a 20  d of UTF-16 */. 
67f0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
6800: 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76  _OK;.  sqlite3_v
6810: 61 6c 75 65 20 2a 70 56 61 6c 3b 0a 0a 20 20 61  alue *pVal;..  a
6820: 73 73 65 72 74 28 20 7a 46 69 6c 65 6e 61 6d 65  ssert( zFilename
6830: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 70   );.  assert( pp
6840: 44 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 3d 20  Db );.  *ppDb = 
6850: 30 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69  0;.  pVal = sqli
6860: 74 65 33 56 61 6c 75 65 4e 65 77 28 29 3b 0a 20  te3ValueNew();. 
6870: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74   sqlite3ValueSet
6880: 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a 46  Str(pVal, -1, zF
6890: 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f  ilename, SQLITE_
68a0: 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c  UTF16NATIVE, SQL
68b0: 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a  ITE_STATIC);.  z
68c0: 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c 69  Filename8 = sqli
68d0: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61  te3ValueText(pVa
68e0: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b  l, SQLITE_UTF8);
68f0: 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65  .  if( zFilename
6900: 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 70  8 ){.    rc = op
6910: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65  enDatabase(zFile
6920: 6e 61 6d 65 38 2c 20 70 70 44 62 29 3b 0a 20 20  name8, ppDb);.  
6930: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
6940: 5f 4f 4b 20 26 26 20 2a 70 70 44 62 20 29 7b 0a  _OK && *ppDb ){.
6950: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
6960: 65 33 5f 65 78 65 63 28 2a 70 70 44 62 2c 20 22  e3_exec(*ppDb, "
6970: 50 52 41 47 4d 41 20 65 6e 63 6f 64 69 6e 67 20  PRAGMA encoding 
6980: 3d 20 27 55 54 46 2d 31 36 27 22 2c 20 30 2c 20  = 'UTF-16'", 0, 
6990: 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28  0, 0);.      if(
69a0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
69b0: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
69c0: 33 5f 63 6c 6f 73 65 28 2a 70 70 44 62 29 3b 0a  3_close(*ppDb);.
69d0: 20 20 20 20 20 20 20 20 2a 70 70 44 62 20 3d 20          *ppDb = 
69e0: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  0;.      }.    }
69f0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 61  .  }.  sqlite3Va
6a00: 6c 75 65 46 72 65 65 28 70 56 61 6c 29 3b 0a 0a  lueFree(pVal);..
6a10: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
6a20: 41 70 69 45 78 69 74 28 30 2c 20 72 63 29 3b 0a  ApiExit(0, rc);.
6a30: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
6a40: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f  TE_OMIT_UTF16 */
6a50: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c  ../*.** The foll
6a60: 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 20 64 65  owing routine de
6a70: 73 74 72 6f 79 73 20 61 20 76 69 72 74 75 61 6c  stroys a virtual
6a80: 20 6d 61 63 68 69 6e 65 20 74 68 61 74 20 69 73   machine that is
6a90: 20 63 72 65 61 74 65 64 20 62 79 0a 2a 2a 20 74   created by.** t
6aa0: 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70 69  he sqlite3_compi
6ab0: 6c 65 28 29 20 72 6f 75 74 69 6e 65 2e 20 54 68  le() routine. Th
6ac0: 65 20 69 6e 74 65 67 65 72 20 72 65 74 75 72 6e  e integer return
6ad0: 65 64 20 69 73 20 61 6e 20 53 51 4c 49 54 45 5f  ed is an SQLITE_
6ae0: 0a 2a 2a 20 73 75 63 63 65 73 73 2f 66 61 69 6c  .** success/fail
6af0: 75 72 65 20 63 6f 64 65 20 74 68 61 74 20 64 65  ure code that de
6b00: 73 63 72 69 62 65 73 20 74 68 65 20 72 65 73 75  scribes the resu
6b10: 6c 74 20 6f 66 20 65 78 65 63 75 74 69 6e 67 20  lt of executing 
6b20: 74 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20 6d  the virtual.** m
6b30: 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  achine..**.** Th
6b40: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20  is routine sets 
6b50: 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 61  the error code a
6b60: 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 72 6e  nd string return
6b70: 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33  ed by.** sqlite3
6b80: 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 6c 69  _errcode(), sqli
6b90: 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e 64  te3_errmsg() and
6ba0: 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31   sqlite3_errmsg1
6bb0: 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  6()..*/.int sqli
6bc0: 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 73 71 6c  te3_finalize(sql
6bd0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
6be0: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69  ){.  int rc;.  i
6bf0: 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a 20  f( pStmt==0 ){. 
6c00: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f     rc = SQLITE_O
6c10: 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  K;.  }else{.    
6c20: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
6c30: 46 69 6e 61 6c 69 7a 65 28 28 56 64 62 65 2a 29  Finalize((Vdbe*)
6c40: 70 53 74 6d 74 29 3b 0a 20 20 7d 0a 20 20 72 65  pStmt);.  }.  re
6c50: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
6c60: 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68 65 20  * Terminate the 
6c70: 63 75 72 72 65 6e 74 20 65 78 65 63 75 74 69 6f  current executio
6c80: 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 74 61 74  n of an SQL stat
6c90: 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 65 74 20  ement and reset 
6ca0: 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 69 74  it.** back to it
6cb0: 73 20 73 74 61 72 74 69 6e 67 20 73 74 61 74 65  s starting state
6cc0: 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20   so that it can 
6cd0: 62 65 20 72 65 75 73 65 64 2e 20 41 20 73 75 63  be reused. A suc
6ce0: 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d 0a 2a  cess code from.*
6cf0: 2a 20 74 68 65 20 70 72 69 6f 72 20 65 78 65 63  * the prior exec
6d00: 75 74 69 6f 6e 20 69 73 20 72 65 74 75 72 6e 65  ution is returne
6d10: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  d..**.** This ro
6d20: 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 65  utine sets the e
6d30: 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 74  rror code and st
6d40: 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62 79  ring returned by
6d50: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 63  .** sqlite3_errc
6d60: 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f 65  ode(), sqlite3_e
6d70: 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69  rrmsg() and sqli
6d80: 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e 0a  te3_errmsg16()..
6d90: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 72  */.int sqlite3_r
6da0: 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  eset(sqlite3_stm
6db0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74  t *pStmt){.  int
6dc0: 20 72 63 3b 0a 20 20 69 66 28 20 70 53 74 6d 74   rc;.  if( pStmt
6dd0: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  ==0 ){.    rc = 
6de0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c  SQLITE_OK;.  }el
6df0: 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  se{.    rc = sql
6e00: 69 74 65 33 56 64 62 65 52 65 73 65 74 28 28 56  ite3VdbeReset((V
6e10: 64 62 65 2a 29 70 53 74 6d 74 29 3b 0a 20 20 20  dbe*)pStmt);.   
6e20: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65   sqlite3VdbeMake
6e30: 52 65 61 64 79 28 28 56 64 62 65 2a 29 70 53 74  Ready((Vdbe*)pSt
6e40: 6d 74 2c 20 2d 31 2c 20 30 2c 20 30 2c 20 30 29  mt, -1, 0, 0, 0)
6e50: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
6e60: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69  c;.}../*.** Regi
6e70: 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61  ster a new colla
6e80: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69  tion sequence wi
6e90: 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20  th the database 
6ea0: 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e  handle db..*/.in
6eb0: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65  t sqlite3_create
6ec0: 5f 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71  _collation(.  sq
6ed0: 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f  lite3* db, .  co
6ee0: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
6ef0: 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20   .  int enc, .  
6f00: 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e  void* pCtx,.  in
6f10: 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69  t(*xCompare)(voi
6f20: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69  d*,int,const voi
6f30: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69  d*,int,const voi
6f40: 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b  d*).){.  int rc;
6f50: 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69  .  assert( !sqli
6f60: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28  te3MallocFailed(
6f70: 29 20 29 3b 0a 20 20 72 63 20 3d 20 63 72 65 61  ) );.  rc = crea
6f80: 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20  teCollation(db, 
6f90: 7a 4e 61 6d 65 2c 20 65 6e 63 2c 20 70 43 74 78  zName, enc, pCtx
6fa0: 2c 20 78 43 6f 6d 70 61 72 65 29 3b 0a 20 20 72  , xCompare);.  r
6fb0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69  eturn sqlite3Api
6fc0: 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 7d 0a  Exit(db, rc);.}.
6fd0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
6fe0: 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a  OMIT_UTF16./*.**
6ff0: 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 20   Register a new 
7000: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e  collation sequen
7010: 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74 61  ce with the data
7020: 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a  base handle db..
7030: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
7040: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31  reate_collation1
7050: 36 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62  6(.  sqlite3* db
7060: 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  , .  const char 
7070: 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65  *zName, .  int e
7080: 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74  nc, .  void* pCt
7090: 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61  x,.  int(*xCompa
70a0: 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f  re)(void*,int,co
70b0: 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f  nst void*,int,co
70c0: 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20  nst void*).){.  
70d0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
70e0: 4f 4b 3b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d  OK;.  char *zNam
70f0: 65 38 3b 20 0a 20 20 61 73 73 65 72 74 28 20 21  e8; .  assert( !
7100: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69  sqlite3MallocFai
7110: 6c 65 64 28 29 20 29 3b 0a 20 20 7a 4e 61 6d 65  led() );.  zName
7120: 38 20 3d 20 73 71 6c 69 74 65 33 75 74 66 31 36  8 = sqlite3utf16
7130: 74 6f 38 28 7a 4e 61 6d 65 2c 20 2d 31 29 3b 0a  to8(zName, -1);.
7140: 20 20 69 66 28 20 7a 4e 61 6d 65 38 20 29 7b 0a    if( zName8 ){.
7150: 20 20 20 20 72 63 20 3d 20 63 72 65 61 74 65 43      rc = createC
7160: 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61  ollation(db, zNa
7170: 6d 65 38 2c 20 65 6e 63 2c 20 70 43 74 78 2c 20  me8, enc, pCtx, 
7180: 78 43 6f 6d 70 61 72 65 29 3b 0a 20 20 20 20 73  xCompare);.    s
7190: 71 6c 69 74 65 46 72 65 65 28 7a 4e 61 6d 65 38  qliteFree(zName8
71a0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
71b0: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64  sqlite3ApiExit(d
71c0: 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69 66  b, rc);.}.#endif
71d0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
71e0: 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  UTF16 */../*.** 
71f0: 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c 61  Register a colla
7200: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61  tion sequence fa
7210: 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 77  ctory callback w
7220: 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65  ith the database
7230: 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52   handle.** db. R
7240: 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 69  eplace any previ
7250: 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20  ously installed 
7260: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e  collation sequen
7270: 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69  ce factory..*/.i
7280: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61  nt sqlite3_colla
7290: 74 69 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 20 73  tion_needed(.  s
72a0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76  qlite3 *db, .  v
72b0: 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64  oid *pCollNeeded
72c0: 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43  Arg, .  void(*xC
72d0: 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 2a  ollNeeded)(void*
72e0: 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54  ,sqlite3*,int eT
72f0: 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 61  extRep,const cha
7300: 72 2a 29 0a 29 7b 0a 20 20 69 66 28 20 73 71 6c  r*).){.  if( sql
7310: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 28  ite3SafetyCheck(
7320: 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  db) ){.    retur
7330: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
7340: 0a 20 20 7d 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c  .  }.  db->xColl
7350: 4e 65 65 64 65 64 20 3d 20 78 43 6f 6c 6c 4e 65  Needed = xCollNe
7360: 65 64 65 64 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c  eded;.  db->xCol
7370: 6c 4e 65 65 64 65 64 31 36 20 3d 20 30 3b 0a 20  lNeeded16 = 0;. 
7380: 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64   db->pCollNeeded
7390: 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65  Arg = pCollNeede
73a0: 64 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53  dArg;.  return S
73b0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66  QLITE_OK;.}..#if
73c0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
73d0: 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67  _UTF16./*.** Reg
73e0: 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f  ister a collatio
73f0: 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f  n sequence facto
7400: 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68  ry callback with
7410: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61   the database ha
7420: 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c  ndle.** db. Repl
7430: 61 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73  ace any previous
7440: 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c  ly installed col
7450: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20  lation sequence 
7460: 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20  factory..*/.int 
7470: 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f  sqlite3_collatio
7480: 6e 5f 6e 65 65 64 65 64 31 36 28 0a 20 20 73 71  n_needed16(.  sq
7490: 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f  lite3 *db, .  vo
74a0: 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41  id *pCollNeededA
74b0: 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f  rg, .  void(*xCo
74c0: 6c 6c 4e 65 65 64 65 64 31 36 29 28 76 6f 69 64  llNeeded16)(void
74d0: 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65  *,sqlite3*,int e
74e0: 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 76 6f  TextRep,const vo
74f0: 69 64 2a 29 0a 29 7b 0a 20 20 69 66 28 20 73 71  id*).){.  if( sq
7500: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b  lite3SafetyCheck
7510: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75  (db) ){.    retu
7520: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
7530: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 78 43 6f 6c  ;.  }.  db->xCol
7540: 6c 4e 65 65 64 65 64 20 3d 20 30 3b 0a 20 20 64  lNeeded = 0;.  d
7550: 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36  b->xCollNeeded16
7560: 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36   = xCollNeeded16
7570: 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65  ;.  db->pCollNee
7580: 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65  dedArg = pCollNe
7590: 65 64 65 64 41 72 67 3b 0a 20 20 72 65 74 75 72  ededArg;.  retur
75a0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23  n SQLITE_OK;.}.#
75b0: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
75c0: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23  OMIT_UTF16 */..#
75d0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
75e0: 49 54 5f 47 4c 4f 42 41 4c 52 45 43 4f 56 45 52  IT_GLOBALRECOVER
75f0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
7600: 74 69 6f 6e 20 69 73 20 6e 6f 77 20 61 6e 20 61  tion is now an a
7610: 6e 61 63 68 72 6f 6e 69 73 6d 2e 20 49 74 20 75  nachronism. It u
7620: 73 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 74  sed to be used t
7630: 6f 20 72 65 63 6f 76 65 72 20 66 72 6f 6d 20 61  o recover from a
7640: 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69  .** malloc() fai
7650: 6c 75 72 65 2c 20 62 75 74 20 53 51 4c 69 74 65  lure, but SQLite
7660: 20 6e 6f 77 20 64 6f 65 73 20 74 68 69 73 20 61   now does this a
7670: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 2a 2f  utomatically..*/
7680: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 67 6c 6f  .int sqlite3_glo
7690: 62 61 6c 5f 72 65 63 6f 76 65 72 28 29 7b 0a 20  bal_recover(){. 
76a0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
76b0: 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  K;.}.#endif../*.
76c0: 2a 2a 20 54 65 73 74 20 74 6f 20 73 65 65 20 77  ** Test to see w
76d0: 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68  hether or not th
76e0: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  e database conne
76f0: 63 74 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 6f  ction is in auto
7700: 63 6f 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e 20  commit.** mode. 
7710: 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20   Return TRUE if 
7720: 69 74 20 69 73 20 61 6e 64 20 46 41 4c 53 45 20  it is and FALSE 
7730: 69 66 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f 6d  if not.  Autocom
7740: 6d 69 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a 2a  mit mode is on.*
7750: 2a 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41  * by default.  A
7760: 75 74 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 73  utocommit is dis
7770: 61 62 6c 65 64 20 62 79 20 61 20 42 45 47 49 4e  abled by a BEGIN
7780: 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72   statement and r
7790: 65 65 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 74  eenabled.** by t
77a0: 68 65 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 6f  he next COMMIT o
77b0: 72 20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2a 0a 2a  r ROLLBACK..**.*
77c0: 2a 2a 2a 2a 2a 2a 20 54 48 49 53 20 49 53 20 41  ****** THIS IS A
77d0: 4e 20 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 41  N EXPERIMENTAL A
77e0: 50 49 20 41 4e 44 20 49 53 20 53 55 42 4a 45 43  PI AND IS SUBJEC
77f0: 54 20 54 4f 20 43 48 41 4e 47 45 20 2a 2a 2a 2a  T TO CHANGE ****
7800: 2a 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  **.*/.int sqlite
7810: 33 5f 67 65 74 5f 61 75 74 6f 63 6f 6d 6d 69 74  3_get_autocommit
7820: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
7830: 20 72 65 74 75 72 6e 20 64 62 2d 3e 61 75 74 6f   return db->auto
7840: 43 6f 6d 6d 69 74 3b 0a 7d 0a 0a 23 69 66 64 65  Commit;.}..#ifde
7850: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f  f SQLITE_DEBUG./
7860: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
7870: 6e 67 20 72 6f 75 74 69 6e 65 20 69 73 20 73 75  ng routine is su
7880: 62 74 69 74 75 74 65 64 20 66 6f 72 20 63 6f 6e  btituted for con
7890: 73 74 61 6e 74 20 53 51 4c 49 54 45 5f 43 4f 52  stant SQLITE_COR
78a0: 52 55 50 54 20 69 6e 0a 2a 2a 20 64 65 62 75 67  RUPT in.** debug
78b0: 67 69 6e 67 20 62 75 69 6c 64 73 2e 20 20 54 68  ging builds.  Th
78c0: 69 73 20 70 72 6f 76 69 64 65 73 20 61 20 77 61  is provides a wa
78d0: 79 20 74 6f 20 73 65 74 20 61 20 62 72 65 61 6b  y to set a break
78e0: 70 6f 69 6e 74 20 66 6f 72 20 77 68 65 6e 0a 2a  point for when.*
78f0: 2a 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 73 20  * corruption is 
7900: 66 69 72 73 74 20 64 65 74 65 63 74 65 64 2e 0a  first detected..
7910: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f  */.int sqlite3Co
7920: 72 72 75 70 74 28 76 6f 69 64 29 7b 0a 20 20 72  rrupt(void){.  r
7930: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52  eturn SQLITE_COR
7940: 52 55 50 54 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a  RUPT;.}.#endif..
7950: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
7960: 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48  OMIT_SHARED_CACH
7970: 45 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f  E./*.** Enable o
7980: 72 20 64 69 73 61 62 6c 65 20 74 68 65 20 73 68  r disable the sh
7990: 61 72 65 64 20 70 61 67 65 72 20 61 6e 64 20 73  ared pager and s
79a0: 63 68 65 6d 61 20 66 65 61 74 75 72 65 73 20 66  chema features f
79b0: 6f 72 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e  or the.** curren
79c0: 74 20 74 68 72 65 61 64 2e 0a 2a 2a 0a 2a 2a 20  t thread..**.** 
79d0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 6f  This routine sho
79e0: 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c  uld only be call
79f0: 65 64 20 77 68 65 6e 20 74 68 65 72 65 20 61 72  ed when there ar
7a00: 65 20 6e 6f 20 6f 70 65 6e 0a 2a 2a 20 64 61 74  e no open.** dat
7a10: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
7a20: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  s..*/.int sqlite
7a30: 33 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f  3_enable_shared_
7a40: 63 61 63 68 65 28 69 6e 74 20 65 6e 61 62 6c 65  cache(int enable
7a50: 29 7b 0a 20 20 54 68 72 65 61 64 44 61 74 61 20  ){.  ThreadData 
7a60: 2a 70 54 64 20 3d 20 73 71 6c 69 74 65 33 54 68  *pTd = sqlite3Th
7a70: 72 65 61 64 44 61 74 61 28 29 3b 0a 20 20 69 66  readData();.  if
7a80: 28 20 70 54 64 20 29 7b 0a 20 20 20 20 2f 2a 20  ( pTd ){.    /* 
7a90: 49 74 20 69 73 20 6f 6e 6c 79 20 6c 65 67 61 6c  It is only legal
7aa0: 20 74 6f 20 63 61 6c 6c 20 73 71 6c 69 74 65 33   to call sqlite3
7ab0: 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63  _enable_shared_c
7ac0: 61 63 68 65 28 29 20 77 68 65 6e 20 74 68 65 72  ache() when ther
7ad0: 65 0a 20 20 20 20 2a 2a 20 61 72 65 20 6e 6f 20  e.    ** are no 
7ae0: 63 75 72 72 65 6e 74 6c 79 20 6f 70 65 6e 20 62  currently open b
7af0: 2d 74 72 65 65 73 20 74 68 61 74 20 77 65 72 65  -trees that were
7b00: 20 6f 70 65 6e 65 64 20 62 79 20 74 68 65 20 63   opened by the c
7b10: 61 6c 6c 69 6e 67 20 74 68 72 65 61 64 2e 0a 20  alling thread.. 
7b20: 20 20 20 2a 2a 20 54 68 69 73 20 63 6f 6e 64 69     ** This condi
7b30: 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 65 61 73  tion is only eas
7b40: 79 20 74 6f 20 64 65 74 65 63 74 20 69 66 20 74  y to detect if t
7b50: 68 65 20 73 68 61 72 65 64 2d 63 61 63 68 65 20  he shared-cache 
7b60: 77 65 72 65 20 0a 20 20 20 20 2a 2a 20 70 72 65  were .    ** pre
7b70: 76 69 6f 75 73 6c 79 20 65 6e 61 62 6c 65 64 20  viously enabled 
7b80: 28 61 6e 64 20 69 73 20 62 65 69 6e 67 20 64 69  (and is being di
7b90: 73 61 62 6c 65 64 29 2e 20 0a 20 20 20 20 2a 2f  sabled). .    */
7ba0: 0a 20 20 20 20 69 66 28 20 70 54 64 2d 3e 70 42  .    if( pTd->pB
7bb0: 74 72 65 65 20 26 26 20 21 65 6e 61 62 6c 65 20  tree && !enable 
7bc0: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  ){.      assert(
7bd0: 20 70 54 64 2d 3e 75 73 65 53 68 61 72 65 64 44   pTd->useSharedD
7be0: 61 74 61 20 29 3b 0a 20 20 20 20 20 20 72 65 74  ata );.      ret
7bf0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
7c00: 45 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 54  E;.    }..    pT
7c10: 64 2d 3e 75 73 65 53 68 61 72 65 64 44 61 74 61  d->useSharedData
7c20: 20 3d 20 65 6e 61 62 6c 65 3b 0a 20 20 20 20 73   = enable;.    s
7c30: 71 6c 69 74 65 33 52 65 6c 65 61 73 65 54 68 72  qlite3ReleaseThr
7c40: 65 61 64 44 61 74 61 28 29 3b 0a 20 20 7d 0a 20  eadData();.  }. 
7c50: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41   return sqlite3A
7c60: 70 69 45 78 69 74 28 30 2c 20 53 51 4c 49 54 45  piExit(0, SQLITE
7c70: 5f 4f 4b 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a  _OK);.}.#endif..
7c80: 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20  /*.** This is a 
7c90: 63 6f 6e 76 65 6e 69 65 6e 63 65 20 72 6f 75 74  convenience rout
7ca0: 69 6e 65 20 74 68 61 74 20 6d 61 6b 65 73 20 73  ine that makes s
7cb0: 75 72 65 20 74 68 61 74 20 61 6c 6c 20 74 68 72  ure that all thr
7cc0: 65 61 64 2d 73 70 65 63 69 66 69 63 0a 2a 2a 20  ead-specific.** 
7cd0: 64 61 74 61 20 66 6f 72 20 74 68 69 73 20 74 68  data for this th
7ce0: 72 65 61 64 20 68 61 73 20 62 65 65 6e 20 64 65  read has been de
7cf0: 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f 0a 76 6f  allocated..*/.vo
7d00: 69 64 20 73 71 6c 69 74 65 33 5f 74 68 72 65 61  id sqlite3_threa
7d10: 64 5f 63 6c 65 61 6e 75 70 28 76 6f 69 64 29 7b  d_cleanup(void){
7d20: 0a 20 20 54 68 72 65 61 64 44 61 74 61 20 2a 70  .  ThreadData *p
7d30: 54 64 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 68  Td = sqlite3OsTh
7d40: 72 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61  readSpecificData
7d50: 28 30 29 3b 0a 20 20 69 66 28 20 70 54 64 20 29  (0);.  if( pTd )
7d60: 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 54 64  {.    memset(pTd
7d70: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 2a 70 54 64  , 0, sizeof(*pTd
7d80: 29 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f  ));.    sqlite3O
7d90: 73 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44  sThreadSpecificD
7da0: 61 74 61 28 2d 31 29 3b 0a 20 20 7d 0a 7d 0a 0a  ata(-1);.  }.}..
7db0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 6d 65 74  /*.** Return met
7dc0: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62  a information ab
7dd0: 6f 75 74 20 61 20 73 70 65 63 69 66 69 63 20 63  out a specific c
7de0: 6f 6c 75 6d 6e 20 6f 66 20 61 20 64 61 74 61 62  olumn of a datab
7df0: 61 73 65 20 74 61 62 6c 65 2e 0a 2a 2a 20 53 65  ase table..** Se
7e00: 65 20 63 6f 6d 6d 65 6e 74 20 69 6e 20 73 71 6c  e comment in sql
7e10: 69 74 65 33 2e 68 20 28 73 71 6c 69 74 65 2e 68  ite3.h (sqlite.h
7e20: 2e 69 6e 29 20 66 6f 72 20 64 65 74 61 69 6c 73  .in) for details
7e30: 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49  ..*/.#ifdef SQLI
7e40: 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e  TE_ENABLE_COLUMN
7e50: 5f 4d 45 54 41 44 41 54 41 0a 69 6e 74 20 73 71  _METADATA.int sq
7e60: 6c 69 74 65 33 5f 74 61 62 6c 65 5f 63 6f 6c 75  lite3_table_colu
7e70: 6d 6e 5f 6d 65 74 61 64 61 74 61 28 0a 20 20 73  mn_metadata(.  s
7e80: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
7e90: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f             /* Co
7ea0: 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20  nnection handle 
7eb0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
7ec0: 2a 7a 44 62 4e 61 6d 65 2c 20 20 20 20 20 20 20  *zDbName,       
7ed0: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 6e 61 6d   /* Database nam
7ee0: 65 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63  e or NULL */.  c
7ef0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62 6c  onst char *zTabl
7f00: 65 4e 61 6d 65 2c 20 20 20 20 20 2f 2a 20 54 61  eName,     /* Ta
7f10: 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 6f  ble name */.  co
7f20: 6e 73 74 20 63 68 61 72 20 2a 7a 43 6f 6c 75 6d  nst char *zColum
7f30: 6e 4e 61 6d 65 2c 20 20 20 20 2f 2a 20 43 6f 6c  nName,    /* Col
7f40: 75 6d 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 68  umn name */.  ch
7f50: 61 72 20 63 6f 6e 73 74 20 2a 2a 70 7a 44 61 74  ar const **pzDat
7f60: 61 54 79 70 65 2c 20 20 20 20 2f 2a 20 4f 55 54  aType,    /* OUT
7f70: 50 55 54 3a 20 44 65 63 6c 61 72 65 64 20 64 61  PUT: Declared da
7f80: 74 61 20 74 79 70 65 20 2a 2f 0a 20 20 63 68 61  ta type */.  cha
7f90: 72 20 63 6f 6e 73 74 20 2a 2a 70 7a 43 6f 6c 6c  r const **pzColl
7fa0: 53 65 71 2c 20 20 20 20 20 2f 2a 20 4f 55 54 50  Seq,     /* OUTP
7fb0: 55 54 3a 20 43 6f 6c 6c 61 74 69 6f 6e 20 73 65  UT: Collation se
7fc0: 71 75 65 6e 63 65 20 6e 61 6d 65 20 2a 2f 0a 20  quence name */. 
7fd0: 20 69 6e 74 20 2a 70 4e 6f 74 4e 75 6c 6c 2c 20   int *pNotNull, 
7fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7ff0: 4f 55 54 50 55 54 3a 20 54 72 75 65 20 69 66 20  OUTPUT: True if 
8000: 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61  NOT NULL constra
8010: 69 6e 74 20 65 78 69 73 74 73 20 2a 2f 0a 20 20  int exists */.  
8020: 69 6e 74 20 2a 70 50 72 69 6d 61 72 79 4b 65 79  int *pPrimaryKey
8030: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f  ,           /* O
8040: 55 54 50 55 54 3a 20 54 72 75 65 20 69 66 20 63  UTPUT: True if c
8050: 6f 6c 75 6d 6e 20 70 61 72 74 20 6f 66 20 50 4b  olumn part of PK
8060: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 41 75 74 6f   */.  int *pAuto
8070: 69 6e 63 20 20 20 20 20 20 20 20 20 20 20 20 20  inc             
8080: 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75    /* OUTPUT: Tru
8090: 65 20 69 66 20 63 6f 6c 75 6d 73 20 69 73 20 61  e if colums is a
80a0: 75 74 6f 2d 69 6e 63 72 65 6d 65 6e 74 20 2a 2f  uto-increment */
80b0: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  .){.  int rc;.  
80c0: 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20  char *zErrMsg = 
80d0: 30 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62  0;.  Table *pTab
80e0: 20 3d 20 30 3b 0a 20 20 43 6f 6c 75 6d 6e 20 2a   = 0;.  Column *
80f0: 70 43 6f 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20  pCol = 0;.  int 
8100: 69 43 6f 6c 3b 0a 0a 20 20 63 68 61 72 20 63 6f  iCol;..  char co
8110: 6e 73 74 20 2a 7a 44 61 74 61 54 79 70 65 20 3d  nst *zDataType =
8120: 20 30 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74   0;.  char const
8130: 20 2a 7a 43 6f 6c 6c 53 65 71 20 3d 20 30 3b 0a   *zCollSeq = 0;.
8140: 20 20 69 6e 74 20 6e 6f 74 6e 75 6c 6c 20 3d 20    int notnull = 
8150: 30 3b 0a 20 20 69 6e 74 20 70 72 69 6d 61 72 79  0;.  int primary
8160: 6b 65 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 61  key = 0;.  int a
8170: 75 74 6f 69 6e 63 20 3d 20 30 3b 0a 0a 20 20 2f  utoinc = 0;..  /
8180: 2a 20 45 6e 73 75 72 65 20 74 68 65 20 64 61 74  * Ensure the dat
8190: 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73  abase schema has
81a0: 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 2a 2f 0a   been loaded */.
81b0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66    if( sqlite3Saf
81c0: 65 74 79 4f 6e 28 64 62 29 20 29 7b 0a 20 20 20  etyOn(db) ){.   
81d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
81e0: 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 72 63 20  ISUSE;.  }.  rc 
81f0: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64 62  = sqlite3Init(db
8200: 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69  , &zErrMsg);.  i
8210: 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63  f( SQLITE_OK!=rc
8220: 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72   ){.    goto err
8230: 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f  or_out;.  }..  /
8240: 2a 20 4c 6f 63 61 74 65 20 74 68 65 20 74 61 62  * Locate the tab
8250: 6c 65 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 2a  le in question *
8260: 2f 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74  /.  pTab = sqlit
8270: 65 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20  e3FindTable(db, 
8280: 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 7a 44 62 4e  zTableName, zDbN
8290: 61 6d 65 29 3b 0a 20 20 69 66 28 20 21 70 54 61  ame);.  if( !pTa
82a0: 62 20 7c 7c 20 70 54 61 62 2d 3e 70 53 65 6c 65  b || pTab->pSele
82b0: 63 74 20 29 7b 0a 20 20 20 20 70 54 61 62 20 3d  ct ){.    pTab =
82c0: 20 30 3b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72   0;.    goto err
82d0: 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f  or_out;.  }..  /
82e0: 2a 20 46 69 6e 64 20 74 68 65 20 63 6f 6c 75 6d  * Find the colum
82f0: 6e 20 66 6f 72 20 77 68 69 63 68 20 69 6e 66 6f  n for which info
8300: 20 69 73 20 72 65 71 75 65 73 74 65 64 20 2a 2f   is requested */
8310: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 73  .  if( sqlite3Is
8320: 52 6f 77 69 64 28 7a 43 6f 6c 75 6d 6e 4e 61 6d  Rowid(zColumnNam
8330: 65 29 20 29 7b 0a 20 20 20 20 69 43 6f 6c 20 3d  e) ){.    iCol =
8340: 20 70 54 61 62 2d 3e 69 50 4b 65 79 3b 0a 20 20   pTab->iPKey;.  
8350: 20 20 69 66 28 20 69 43 6f 6c 3e 3d 30 20 29 7b    if( iCol>=0 ){
8360: 0a 20 20 20 20 20 20 70 43 6f 6c 20 3d 20 26 70  .      pCol = &p
8370: 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b  Tab->aCol[iCol];
8380: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a  .    }.  }else{.
8390: 20 20 20 20 66 6f 72 28 69 43 6f 6c 3d 30 3b 20      for(iCol=0; 
83a0: 69 43 6f 6c 3c 70 54 61 62 2d 3e 6e 43 6f 6c 3b  iCol<pTab->nCol;
83b0: 20 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 20   iCol++){.      
83c0: 70 43 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43  pCol = &pTab->aC
83d0: 6f 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 20 20 20 20  ol[iCol];.      
83e0: 69 66 28 20 30 3d 3d 73 71 6c 69 74 65 33 53 74  if( 0==sqlite3St
83f0: 72 49 43 6d 70 28 70 43 6f 6c 2d 3e 7a 4e 61 6d  rICmp(pCol->zNam
8400: 65 2c 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20  e, zColumnName) 
8410: 29 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  ){.        break
8420: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
8430: 20 20 20 20 69 66 28 20 69 43 6f 6c 3d 3d 70 54      if( iCol==pT
8440: 61 62 2d 3e 6e 43 6f 6c 20 29 7b 0a 20 20 20 20  ab->nCol ){.    
8450: 20 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 20    pTab = 0;.    
8460: 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74    goto error_out
8470: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
8480: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
8490: 62 6c 6f 63 6b 20 73 74 6f 72 65 73 20 74 68 65  block stores the
84a0: 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f   meta informatio
84b0: 6e 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72  n that will be r
84c0: 65 74 75 72 6e 65 64 0a 20 20 2a 2a 20 74 6f 20  eturned.  ** to 
84d0: 74 68 65 20 63 61 6c 6c 65 72 20 69 6e 20 6c 6f  the caller in lo
84e0: 63 61 6c 20 76 61 72 69 61 62 6c 65 73 20 7a 44  cal variables zD
84f0: 61 74 61 54 79 70 65 2c 20 7a 43 6f 6c 6c 53 65  ataType, zCollSe
8500: 71 2c 20 6e 6f 74 6e 75 6c 6c 2c 20 70 72 69 6d  q, notnull, prim
8510: 61 72 79 6b 65 79 0a 20 20 2a 2a 20 61 6e 64 20  arykey.  ** and 
8520: 61 75 74 6f 69 6e 63 2e 20 41 74 20 74 68 69 73  autoinc. At this
8530: 20 70 6f 69 6e 74 20 74 68 65 72 65 20 61 72 65   point there are
8540: 20 74 77 6f 20 70 6f 73 73 69 62 69 6c 69 74 69   two possibiliti
8550: 65 73 3a 0a 20 20 2a 2a 20 0a 20 20 2a 2a 20 20  es:.  ** .  **  
8560: 20 20 20 31 2e 20 54 68 65 20 73 70 65 63 69 66     1. The specif
8570: 69 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20  ied column name 
8580: 77 61 73 20 72 6f 77 69 64 22 2c 20 22 6f 69 64  was rowid", "oid
8590: 22 20 6f 72 20 22 5f 72 6f 77 69 64 5f 22 20 0a  " or "_rowid_" .
85a0: 20 20 2a 2a 20 20 20 20 20 20 20 20 61 6e 64 20    **        and 
85b0: 74 68 65 72 65 20 69 73 20 6e 6f 20 65 78 70 6c  there is no expl
85c0: 69 63 69 74 6c 79 20 64 65 63 6c 61 72 65 64 20  icitly declared 
85d0: 49 50 4b 20 63 6f 6c 75 6d 6e 2e 20 0a 20 20 2a  IPK column. .  *
85e0: 2a 0a 20 20 2a 2a 20 20 20 20 20 32 2e 20 54 68  *.  **     2. Th
85f0: 65 20 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 61  e table is not a
8600: 20 76 69 65 77 20 61 6e 64 20 74 68 65 20 63 6f   view and the co
8610: 6c 75 6d 6e 20 6e 61 6d 65 20 69 64 65 6e 74 69  lumn name identi
8620: 66 69 65 64 20 61 6e 20 0a 20 20 2a 2a 20 20 20  fied an .  **   
8630: 20 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 20       explicitly 
8640: 64 65 63 6c 61 72 65 64 20 63 6f 6c 75 6d 6e 2e  declared column.
8650: 20 43 6f 70 79 20 6d 65 74 61 20 69 6e 66 6f 72   Copy meta infor
8660: 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 2a 70 43 6f  mation from *pCo
8670: 6c 2e 0a 20 20 2a 2f 20 0a 20 20 69 66 28 20 70  l..  */ .  if( p
8680: 43 6f 6c 20 29 7b 0a 20 20 20 20 7a 44 61 74 61  Col ){.    zData
8690: 54 79 70 65 20 3d 20 70 43 6f 6c 2d 3e 7a 54 79  Type = pCol->zTy
86a0: 70 65 3b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71  pe;.    zCollSeq
86b0: 20 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a   = pCol->zColl;.
86c0: 20 20 20 20 6e 6f 74 6e 75 6c 6c 20 3d 20 28 70      notnull = (p
86d0: 43 6f 6c 2d 3e 6e 6f 74 4e 75 6c 6c 3f 31 3a 30  Col->notNull?1:0
86e0: 29 3b 0a 20 20 20 20 70 72 69 6d 61 72 79 6b 65  );.    primaryke
86f0: 79 20 20 3d 20 28 70 43 6f 6c 2d 3e 69 73 50 72  y  = (pCol->isPr
8700: 69 6d 4b 65 79 3f 31 3a 30 29 3b 0a 20 20 20 20  imKey?1:0);.    
8710: 61 75 74 6f 69 6e 63 20 3d 20 28 28 70 54 61 62  autoinc = ((pTab
8720: 2d 3e 69 50 4b 65 79 3d 3d 69 43 6f 6c 20 26 26  ->iPKey==iCol &&
8730: 20 70 54 61 62 2d 3e 61 75 74 6f 49 6e 63 29 3f   pTab->autoInc)?
8740: 31 3a 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  1:0);.  }else{. 
8750: 20 20 20 7a 44 61 74 61 54 79 70 65 20 3d 20 22     zDataType = "
8760: 49 4e 54 45 47 45 52 22 3b 0a 20 20 20 20 70 72  INTEGER";.    pr
8770: 69 6d 61 72 79 6b 65 79 20 3d 20 31 3b 0a 20 20  imarykey = 1;.  
8780: 7d 0a 20 20 69 66 28 20 21 7a 43 6f 6c 6c 53 65  }.  if( !zCollSe
8790: 71 20 29 7b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65  q ){.    zCollSe
87a0: 71 20 3d 20 22 42 49 4e 41 52 59 22 3b 0a 20 20  q = "BINARY";.  
87b0: 7d 0a 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20  }..error_out:.  
87c0: 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74  if( sqlite3Safet
87d0: 79 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20  yOff(db) ){.    
87e0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55  rc = SQLITE_MISU
87f0: 53 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 68  SE;.  }..  /* Wh
8800: 65 74 68 65 72 20 74 68 65 20 66 75 6e 63 74 69  ether the functi
8810: 6f 6e 20 63 61 6c 6c 20 73 75 63 63 65 65 64 65  on call succeede
8820: 64 20 6f 72 20 66 61 69 6c 65 64 2c 20 73 65 74  d or failed, set
8830: 20 74 68 65 20 6f 75 74 70 75 74 20 70 61 72 61   the output para
8840: 6d 65 74 65 72 73 0a 20 20 2a 2a 20 74 6f 20 77  meters.  ** to w
8850: 68 61 74 65 76 65 72 20 74 68 65 69 72 20 6c 6f  hatever their lo
8860: 63 61 6c 20 63 6f 75 6e 74 65 72 70 61 72 74 73  cal counterparts
8870: 20 63 6f 6e 74 61 69 6e 2e 20 49 66 20 61 6e 20   contain. If an 
8880: 65 72 72 6f 72 20 64 69 64 20 6f 63 63 75 72 2c  error did occur,
8890: 0a 20 20 2a 2a 20 74 68 69 73 20 68 61 73 20 74  .  ** this has t
88a0: 68 65 20 65 66 66 65 63 74 20 6f 66 20 7a 65 72  he effect of zer
88b0: 6f 69 6e 67 20 61 6c 6c 20 6f 75 74 70 75 74 20  oing all output 
88c0: 70 61 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f  parameters..  */
88d0: 0a 20 20 69 66 28 20 70 7a 44 61 74 61 54 79 70  .  if( pzDataTyp
88e0: 65 20 29 20 2a 70 7a 44 61 74 61 54 79 70 65 20  e ) *pzDataType 
88f0: 3d 20 7a 44 61 74 61 54 79 70 65 3b 0a 20 20 69  = zDataType;.  i
8900: 66 28 20 70 7a 43 6f 6c 6c 53 65 71 20 29 20 2a  f( pzCollSeq ) *
8910: 70 7a 43 6f 6c 6c 53 65 71 20 3d 20 7a 43 6f 6c  pzCollSeq = zCol
8920: 6c 53 65 71 3b 0a 20 20 69 66 28 20 70 4e 6f 74  lSeq;.  if( pNot
8930: 4e 75 6c 6c 20 29 20 2a 70 4e 6f 74 4e 75 6c 6c  Null ) *pNotNull
8940: 20 3d 20 6e 6f 74 6e 75 6c 6c 3b 0a 20 20 69 66   = notnull;.  if
8950: 28 20 70 50 72 69 6d 61 72 79 4b 65 79 20 29 20  ( pPrimaryKey ) 
8960: 2a 70 50 72 69 6d 61 72 79 4b 65 79 20 3d 20 70  *pPrimaryKey = p
8970: 72 69 6d 61 72 79 6b 65 79 3b 0a 20 20 69 66 28  rimarykey;.  if(
8980: 20 70 41 75 74 6f 69 6e 63 20 29 20 2a 70 41 75   pAutoinc ) *pAu
8990: 74 6f 69 6e 63 20 3d 20 61 75 74 6f 69 6e 63 3b  toinc = autoinc;
89a0: 0a 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f  ..  if( SQLITE_O
89b0: 4b 3d 3d 72 63 20 26 26 20 21 70 54 61 62 20 29  K==rc && !pTab )
89c0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74  {.    sqlite3Set
89d0: 53 74 72 69 6e 67 28 26 7a 45 72 72 4d 73 67 2c  String(&zErrMsg,
89e0: 20 22 6e 6f 20 73 75 63 68 20 74 61 62 6c 65 20   "no such table 
89f0: 63 6f 6c 75 6d 6e 3a 20 22 2c 20 7a 54 61 62 6c  column: ", zTabl
8a00: 65 4e 61 6d 65 2c 20 22 2e 22 2c 20 0a 20 20 20  eName, ".", .   
8a10: 20 20 20 20 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65       zColumnName
8a20: 2c 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 53  , 0);.    rc = S
8a30: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d  QLITE_ERROR;.  }
8a40: 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28  .  sqlite3Error(
8a50: 64 62 2c 20 72 63 2c 20 28 7a 45 72 72 4d 73 67  db, rc, (zErrMsg
8a60: 3f 22 25 73 22 3a 30 29 2c 20 7a 45 72 72 4d 73  ?"%s":0), zErrMs
8a70: 67 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65  g);.  sqliteFree
8a80: 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74  (zErrMsg);.  ret
8a90: 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78  urn sqlite3ApiEx
8aa0: 69 74 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 23 65  it(db, rc);.}.#e
8ab0: 6e 64 69 66 0a 0a                                ndif..