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

Artifact 7d0293d9520688d47092ff48c1ed5254cd3c4474:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 4d 61 69 6e 20 66  ******.** Main f
0180: 69 6c 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69  ile for the SQLi
0190: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 54 68 65  te library.  The
01a0: 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 69   routines in thi
01b0: 73 20 66 69 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d  s file.** implem
01c0: 65 6e 74 20 74 68 65 20 70 72 6f 67 72 61 6d 6d  ent the programm
01d0: 65 72 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20  er interface to 
01e0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 52 6f  the library.  Ro
01f0: 75 74 69 6e 65 73 20 69 6e 0a 2a 2a 20 6f 74 68  utines in.** oth
0200: 65 72 20 66 69 6c 65 73 20 61 72 65 20 66 6f 72  er files are for
0210: 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 20 62 79   internal use by
0220: 20 53 51 4c 69 74 65 20 61 6e 64 20 73 68 6f 75   SQLite and shou
0230: 6c 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 63 63  ld not be.** acc
0240: 65 73 73 65 64 20 62 79 20 75 73 65 72 73 20 6f  essed by users o
0250: 66 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 2a  f the library..*
0260: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 69 6e 2e 63  *.** $Id: main.c
0270: 2c 76 20 31 2e 32 39 34 20 32 30 30 35 2f 30 36  ,v 1.294 2005/06
0280: 2f 31 34 20 30 32 3a 32 34 3a 33 32 20 64 72 68  /14 02:24:32 drh
0290: 20 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75   Exp $.*/.#inclu
02a0: 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22  de "sqliteInt.h"
02b0: 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22  .#include "os.h"
02c0: 0a 23 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65  .#include <ctype
02d0: 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66  .h>../*.** The f
02e0: 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6e 73 74 61 6e  ollowing constan
02f0: 74 20 76 61 6c 75 65 20 69 73 20 75 73 65 64 20  t value is used 
0300: 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f 42 49  by the SQLITE_BI
0310: 47 45 4e 44 49 41 4e 20 61 6e 64 0a 2a 2a 20 53  GENDIAN and.** S
0320: 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 49  QLITE_LITTLEENDI
0330: 41 4e 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a 63 6f  AN macros..*/.co
0340: 6e 73 74 20 69 6e 74 20 73 71 6c 69 74 65 33 6f  nst int sqlite3o
0350: 6e 65 20 3d 20 31 3b 0a 0a 23 69 66 6e 64 65 66  ne = 1;..#ifndef
0360: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 4c 4f   SQLITE_OMIT_GLO
0370: 42 41 4c 52 45 43 4f 56 45 52 0a 2f 2a 0a 2a 2a  BALRECOVER./*.**
0380: 20 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20   Linked list of 
0390: 61 6c 6c 20 6f 70 65 6e 20 64 61 74 61 62 61 73  all open databas
03a0: 65 20 68 61 6e 64 6c 65 73 2e 20 54 68 69 73 20  e handles. This 
03b0: 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20 0a  is used by the .
03c0: 2a 2a 20 73 71 6c 69 74 65 33 5f 67 6c 6f 62 61  ** sqlite3_globa
03d0: 6c 5f 72 65 63 6f 76 65 72 28 29 20 66 75 6e 63  l_recover() func
03e0: 74 69 6f 6e 2e 20 45 6e 74 72 69 65 73 20 61 72  tion. Entries ar
03f0: 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 6c  e added to the l
0400: 69 73 74 0a 2a 2a 20 62 79 20 6f 70 65 6e 44 61  ist.** by openDa
0410: 74 61 62 61 73 65 28 29 20 61 6e 64 20 72 65 6d  tabase() and rem
0420: 6f 76 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f  oved by sqlite3_
0430: 63 6c 6f 73 65 28 29 2e 0a 2a 2f 0a 73 74 61 74  close()..*/.stat
0440: 69 63 20 73 71 6c 69 74 65 33 20 2a 70 44 62 4c  ic sqlite3 *pDbL
0450: 69 73 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a  ist = 0;.#endif.
0460: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
0470: 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 20 0a 2a  OMIT_UTF16./* .*
0480: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 74 72 61  * Return the tra
0490: 6e 73 69 65 6e 74 20 73 71 6c 69 74 65 33 5f 76  nsient sqlite3_v
04a0: 61 6c 75 65 20 6f 62 6a 65 63 74 20 75 73 65 64  alue object used
04b0: 20 66 6f 72 20 65 6e 63 6f 64 69 6e 67 20 63 6f   for encoding co
04c0: 6e 76 65 72 73 69 6f 6e 73 0a 2a 2a 20 64 75 72  nversions.** dur
04d0: 69 6e 67 20 53 51 4c 20 63 6f 6d 70 69 6c 61 74  ing SQL compilat
04e0: 69 6f 6e 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f  ion..*/.sqlite3_
04f0: 76 61 6c 75 65 20 2a 73 71 6c 69 74 65 33 47 65  value *sqlite3Ge
0500: 74 54 72 61 6e 73 69 65 6e 74 56 61 6c 75 65 28  tTransientValue(
0510: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20  sqlite3 *db){.  
0520: 69 66 28 20 21 64 62 2d 3e 70 56 61 6c 75 65 20  if( !db->pValue 
0530: 29 7b 0a 20 20 20 20 64 62 2d 3e 70 56 61 6c 75  ){.    db->pValu
0540: 65 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65  e = sqlite3Value
0550: 4e 65 77 28 29 3b 0a 20 20 7d 0a 20 20 72 65 74  New();.  }.  ret
0560: 75 72 6e 20 64 62 2d 3e 70 56 61 6c 75 65 3b 0a  urn db->pValue;.
0570: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  }.#endif../*.** 
0580: 54 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74  The version of t
0590: 68 65 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63 6f  he library.*/.co
05a0: 6e 73 74 20 63 68 61 72 20 72 63 73 69 64 33 5b  nst char rcsid3[
05b0: 5d 20 3d 20 22 40 28 23 29 20 5c 30 34 34 49 64  ] = "@(#) \044Id
05c0: 3a 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  : SQLite version
05d0: 20 22 20 53 51 4c 49 54 45 5f 56 45 52 53 49 4f   " SQLITE_VERSIO
05e0: 4e 20 22 20 24 22 3b 0a 63 6f 6e 73 74 20 63 68  N " $";.const ch
05f0: 61 72 20 73 71 6c 69 74 65 33 5f 76 65 72 73 69  ar sqlite3_versi
0600: 6f 6e 5b 5d 20 3d 20 53 51 4c 49 54 45 5f 56 45  on[] = SQLITE_VE
0610: 52 53 49 4f 4e 3b 0a 63 6f 6e 73 74 20 63 68 61  RSION;.const cha
0620: 72 20 2a 73 71 6c 69 74 65 33 5f 6c 69 62 76 65  r *sqlite3_libve
0630: 72 73 69 6f 6e 28 76 6f 69 64 29 7b 20 72 65 74  rsion(void){ ret
0640: 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 65 72 73  urn sqlite3_vers
0650: 69 6f 6e 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74  ion; }.int sqlit
0660: 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75  e3_libversion_nu
0670: 6d 62 65 72 28 76 6f 69 64 29 7b 20 72 65 74 75  mber(void){ retu
0680: 72 6e 20 53 51 4c 49 54 45 5f 56 45 52 53 49 4f  rn SQLITE_VERSIO
0690: 4e 5f 4e 55 4d 42 45 52 3b 20 7d 0a 0a 2f 2a 0a  N_NUMBER; }../*.
06a0: 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 64  ** This is the d
06b0: 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67  efault collating
06c0: 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 20   function named 
06d0: 22 42 49 4e 41 52 59 22 20 77 68 69 63 68 20 69  "BINARY" which i
06e0: 73 20 61 6c 77 61 79 73 0a 2a 2a 20 61 76 61 69  s always.** avai
06f0: 6c 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  lable..*/.static
0700: 20 69 6e 74 20 62 69 6e 43 6f 6c 6c 46 75 6e 63   int binCollFunc
0710: 28 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65  (.  void *NotUse
0720: 64 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20  d,.  int nKey1, 
0730: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79  const void *pKey
0740: 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20  1,.  int nKey2, 
0750: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79  const void *pKey
0760: 32 0a 29 7b 0a 20 20 69 6e 74 20 72 63 2c 20 6e  2.){.  int rc, n
0770: 3b 0a 20 20 6e 20 3d 20 6e 4b 65 79 31 3c 6e 4b  ;.  n = nKey1<nK
0780: 65 79 32 20 3f 20 6e 4b 65 79 31 20 3a 20 6e 4b  ey2 ? nKey1 : nK
0790: 65 79 32 3b 0a 20 20 72 63 20 3d 20 6d 65 6d 63  ey2;.  rc = memc
07a0: 6d 70 28 70 4b 65 79 31 2c 20 70 4b 65 79 32 2c  mp(pKey1, pKey2,
07b0: 20 6e 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30   n);.  if( rc==0
07c0: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6e 4b 65   ){.    rc = nKe
07d0: 79 31 20 2d 20 6e 4b 65 79 32 3b 0a 20 20 7d 0a  y1 - nKey2;.  }.
07e0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
07f0: 2f 2a 0a 2a 2a 20 41 6e 6f 74 68 65 72 20 62 75  /*.** Another bu
0800: 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67  ilt-in collating
0810: 20 73 65 71 75 65 6e 63 65 3a 20 4e 4f 43 41 53   sequence: NOCAS
0820: 45 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63  E. .**.** This c
0830: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63  ollating sequenc
0840: 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f  e is intended to
0850: 20 62 65 20 75 73 65 64 20 66 6f 72 20 22 63 61   be used for "ca
0860: 73 65 20 69 6e 64 65 70 65 6e 64 61 6e 74 0a 2a  se independant.*
0870: 2a 20 63 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 53  * comparison". S
0880: 51 4c 69 74 65 27 73 20 6b 6e 6f 77 6c 65 64 67  QLite's knowledg
0890: 65 20 6f 66 20 75 70 70 65 72 20 61 6e 64 20 6c  e of upper and l
08a0: 6f 77 65 72 20 63 61 73 65 20 65 71 75 69 76 61  ower case equiva
08b0: 6c 65 6e 74 73 0a 2a 2a 20 65 78 74 65 6e 64 73  lents.** extends
08c0: 20 6f 6e 6c 79 20 74 6f 20 74 68 65 20 32 36 20   only to the 26 
08d0: 63 68 61 72 61 63 74 65 72 73 20 75 73 65 64 20  characters used 
08e0: 69 6e 20 74 68 65 20 45 6e 67 6c 69 73 68 20 6c  in the English l
08f0: 61 6e 67 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 41  anguage..**.** A
0900: 74 20 74 68 65 20 6d 6f 6d 65 6e 74 20 74 68 65  t the moment the
0910: 72 65 20 69 73 20 6f 6e 6c 79 20 61 20 55 54 46  re is only a UTF
0920: 2d 38 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  -8 implementatio
0930: 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  n..*/.static int
0940: 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67   nocaseCollating
0950: 46 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a 4e 6f  Func(.  void *No
0960: 74 55 73 65 64 2c 0a 20 20 69 6e 74 20 6e 4b 65  tUsed,.  int nKe
0970: 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  y1, const void *
0980: 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65  pKey1,.  int nKe
0990: 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  y2, const void *
09a0: 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72  pKey2.){.  int r
09b0: 20 3d 20 73 71 6c 69 74 65 33 53 74 72 4e 49 43   = sqlite3StrNIC
09c0: 6d 70 28 0a 20 20 20 20 20 20 28 63 6f 6e 73 74  mp(.      (const
09d0: 20 63 68 61 72 20 2a 29 70 4b 65 79 31 2c 20 28   char *)pKey1, (
09e0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70 4b 65  const char *)pKe
09f0: 79 32 2c 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 32  y2, (nKey1<nKey2
0a00: 29 3f 6e 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 0a  )?nKey1:nKey2);.
0a10: 20 20 69 66 28 20 30 3d 3d 72 20 29 7b 0a 20 20    if( 0==r ){.  
0a20: 20 20 72 20 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79    r = nKey1-nKey
0a30: 32 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  2;.  }.  return 
0a40: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  r;.}../*.** Retu
0a50: 72 6e 20 74 68 65 20 52 4f 57 49 44 20 6f 66 20  rn the ROWID of 
0a60: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20  the most recent 
0a70: 69 6e 73 65 72 74 0a 2a 2f 0a 73 71 6c 69 74 65  insert.*/.sqlite
0a80: 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6c  _int64 sqlite3_l
0a90: 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64  ast_insert_rowid
0aa0: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
0ab0: 20 72 65 74 75 72 6e 20 64 62 2d 3e 6c 61 73 74   return db->last
0ac0: 52 6f 77 69 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Rowid;.}../*.** 
0ad0: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
0ae0: 72 20 6f 66 20 63 68 61 6e 67 65 73 20 69 6e 20  r of changes in 
0af0: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20  the most recent 
0b00: 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f  call to sqlite3_
0b10: 65 78 65 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73  exec()..*/.int s
0b20: 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 28 73  qlite3_changes(s
0b30: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 72  qlite3 *db){.  r
0b40: 65 74 75 72 6e 20 64 62 2d 3e 6e 43 68 61 6e 67  eturn db->nChang
0b50: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  e;.}../*.** Retu
0b60: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  rn the number of
0b70: 20 63 68 61 6e 67 65 73 20 73 69 6e 63 65 20 74   changes since t
0b80: 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64  he database hand
0b90: 6c 65 20 77 61 73 20 6f 70 65 6e 65 64 2e 0a 2a  le was opened..*
0ba0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 6f  /.int sqlite3_to
0bb0: 74 61 6c 5f 63 68 61 6e 67 65 73 28 73 71 6c 69  tal_changes(sqli
0bc0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75  te3 *db){.  retu
0bd0: 72 6e 20 64 62 2d 3e 6e 54 6f 74 61 6c 43 68 61  rn db->nTotalCha
0be0: 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c  nge;.}../*.** Cl
0bf0: 6f 73 65 20 61 6e 20 65 78 69 73 74 69 6e 67 20  ose an existing 
0c00: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 0a  SQLite database.
0c10: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
0c20: 6c 6f 73 65 28 73 71 6c 69 74 65 33 20 2a 64 62  lose(sqlite3 *db
0c30: 29 7b 0a 20 20 48 61 73 68 45 6c 65 6d 20 2a 69  ){.  HashElem *i
0c40: 3b 0a 20 20 69 6e 74 20 6a 3b 0a 0a 20 20 69 66  ;.  int j;..  if
0c50: 28 20 21 64 62 20 29 7b 0a 20 20 20 20 72 65 74  ( !db ){.    ret
0c60: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
0c70: 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33   }.  if( sqlite3
0c80: 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20  SafetyCheck(db) 
0c90: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
0ca0: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d  LITE_MISUSE;.  }
0cb0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
0cc0: 53 53 45 0a 20 20 73 71 6c 69 74 65 33 5f 66 69  SSE.  sqlite3_fi
0cd0: 6e 61 6c 69 7a 65 28 64 62 2d 3e 70 46 65 74 63  nalize(db->pFetc
0ce0: 68 29 3b 0a 23 65 6e 64 69 66 20 0a 0a 20 20 2f  h);.#endif ..  /
0cf0: 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 61  * If there are a
0d00: 6e 79 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 56  ny outstanding V
0d10: 4d 73 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54  Ms, return SQLIT
0d20: 45 5f 42 55 53 59 2e 20 2a 2f 0a 20 20 69 66 28  E_BUSY. */.  if(
0d30: 20 64 62 2d 3e 70 56 64 62 65 20 29 7b 0a 20 20   db->pVdbe ){.  
0d40: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64    sqlite3Error(d
0d50: 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20  b, SQLITE_BUSY, 
0d60: 0a 20 20 20 20 20 20 20 20 22 55 6e 61 62 6c 65  .        "Unable
0d70: 20 74 6f 20 63 6c 6f 73 65 20 64 75 65 20 74 6f   to close due to
0d80: 20 75 6e 66 69 6e 61 6c 69 73 65 64 20 73 74 61   unfinalised sta
0d90: 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20 72  tements");.    r
0da0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53  eturn SQLITE_BUS
0db0: 59 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28  Y;.  }.  assert(
0dc0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43   !sqlite3SafetyC
0dd0: 68 65 63 6b 28 64 62 29 20 29 3b 0a 0a 20 20 2f  heck(db) );..  /
0de0: 2a 20 46 49 58 20 4d 45 3a 20 64 62 2d 3e 6d 61  * FIX ME: db->ma
0df0: 67 69 63 20 6d 61 79 20 62 65 20 73 65 74 20 74  gic may be set t
0e00: 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43  o SQLITE_MAGIC_C
0e10: 4c 4f 53 45 44 20 69 66 20 74 68 65 20 64 61 74  LOSED if the dat
0e20: 61 62 61 73 65 0a 20 20 2a 2a 20 63 61 6e 6e 6f  abase.  ** canno
0e30: 74 20 62 65 20 6f 70 65 6e 65 64 20 66 6f 72 20  t be opened for 
0e40: 73 6f 6d 65 20 72 65 61 73 6f 6e 2e 20 53 6f 20  some reason. So 
0e50: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 6e 65 65  this routine nee
0e60: 64 73 20 74 6f 20 72 75 6e 20 69 6e 0a 20 20 2a  ds to run in.  *
0e70: 2a 20 74 68 61 74 20 63 61 73 65 2e 20 42 75 74  * that case. But
0e80: 20 6d 61 79 62 65 20 74 68 65 72 65 20 73 68 6f   maybe there sho
0e90: 75 6c 64 20 62 65 20 61 6e 20 65 78 74 72 61 20  uld be an extra 
0ea0: 6d 61 67 69 63 20 76 61 6c 75 65 20 66 6f 72 20  magic value for 
0eb0: 74 68 65 0a 20 20 2a 2a 20 22 66 61 69 6c 65 64  the.  ** "failed
0ec0: 20 74 6f 20 6f 70 65 6e 22 20 73 74 61 74 65 2e   to open" state.
0ed0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e  .  */.  if( db->
0ee0: 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41  magic!=SQLITE_MA
0ef0: 47 49 43 5f 43 4c 4f 53 45 44 20 26 26 20 73 71  GIC_CLOSED && sq
0f00: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
0f10: 29 20 29 7b 0a 20 20 20 20 2f 2a 20 70 72 69 6e  ) ){.    /* prin
0f20: 74 66 28 22 44 49 44 20 4e 4f 54 20 43 4c 4f 53  tf("DID NOT CLOS
0f30: 45 5c 6e 22 29 3b 20 66 66 6c 75 73 68 28 73 74  E\n"); fflush(st
0f40: 64 6f 75 74 29 3b 20 2a 2f 0a 20 20 20 20 72 65  dout); */.    re
0f50: 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f  turn SQLITE_ERRO
0f60: 52 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 6a 3d  R;.  }..  for(j=
0f70: 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b  0; j<db->nDb; j+
0f80: 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 44  +){.    struct D
0f90: 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e 61 44  b *pDb = &db->aD
0fa0: 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 70 44  b[j];.    if( pD
0fb0: 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 20  b->pBt ){.      
0fc0: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73  sqlite3BtreeClos
0fd0: 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20 20  e(pDb->pBt);.   
0fe0: 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 30 3b     pDb->pBt = 0;
0ff0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c  .    }.  }.  sql
1000: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61  ite3ResetInterna
1010: 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a  lSchema(db, 0);.
1020: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e 44    assert( db->nD
1030: 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72 74  b<=2 );.  assert
1040: 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61  ( db->aDb==db->a
1050: 44 62 53 74 61 74 69 63 20 29 3b 0a 20 20 66 6f  DbStatic );.  fo
1060: 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69  r(i=sqliteHashFi
1070: 72 73 74 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b  rst(&db->aFunc);
1080: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68   i; i=sqliteHash
1090: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 46 75  Next(i)){.    Fu
10a0: 6e 63 44 65 66 20 2a 70 46 75 6e 63 2c 20 2a 70  ncDef *pFunc, *p
10b0: 4e 65 78 74 3b 0a 20 20 20 20 66 6f 72 28 70 46  Next;.    for(pF
10c0: 75 6e 63 20 3d 20 28 46 75 6e 63 44 65 66 2a 29  unc = (FuncDef*)
10d0: 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 69  sqliteHashData(i
10e0: 29 3b 20 70 46 75 6e 63 3b 20 70 46 75 6e 63 3d  ); pFunc; pFunc=
10f0: 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 70 4e  pNext){.      pN
1100: 65 78 74 20 3d 20 70 46 75 6e 63 2d 3e 70 4e 65  ext = pFunc->pNe
1110: 78 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  xt;.      sqlite
1120: 46 72 65 65 28 70 46 75 6e 63 29 3b 0a 20 20 20  Free(pFunc);.   
1130: 20 7d 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 69 3d   }.  }..  for(i=
1140: 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74 28  sqliteHashFirst(
1150: 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 20  &db->aCollSeq); 
1160: 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 4e  i; i=sqliteHashN
1170: 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43 6f 6c  ext(i)){.    Col
1180: 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28 43  lSeq *pColl = (C
1190: 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74 65 48  ollSeq *)sqliteH
11a0: 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 20 20  ashData(i);.    
11b0: 73 71 6c 69 74 65 46 72 65 65 28 70 43 6f 6c 6c  sqliteFree(pColl
11c0: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  );.  }.  sqlite3
11d0: 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 61  HashClear(&db->a
11e0: 43 6f 6c 6c 53 65 71 29 3b 0a 0a 20 20 73 71 6c  CollSeq);..  sql
11f0: 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 64  ite3HashClear(&d
1200: 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 73 71 6c  b->aFunc);.  sql
1210: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51  ite3Error(db, SQ
1220: 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 2f 2a 20  LITE_OK, 0); /* 
1230: 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 6e 79 20  Deallocates any 
1240: 63 61 63 68 65 64 20 65 72 72 6f 72 20 73 74 72  cached error str
1250: 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 28 20 64  ings. */.  if( d
1260: 62 2d 3e 70 56 61 6c 75 65 20 29 7b 0a 20 20 20  b->pValue ){.   
1270: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65   sqlite3ValueFre
1280: 65 28 64 62 2d 3e 70 56 61 6c 75 65 29 3b 0a 20  e(db->pValue);. 
1290: 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 70 45 72   }.  if( db->pEr
12a0: 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  r ){.    sqlite3
12b0: 56 61 6c 75 65 46 72 65 65 28 64 62 2d 3e 70 45  ValueFree(db->pE
12c0: 72 72 29 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65  rr);.  }..#ifnde
12d0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 4c  f SQLITE_OMIT_GL
12e0: 4f 42 41 4c 52 45 43 4f 56 45 52 0a 20 20 7b 0a  OBALRECOVER.  {.
12f0: 20 20 20 20 73 71 6c 69 74 65 33 20 2a 70 50 72      sqlite3 *pPr
1300: 65 76 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f  ev;.    sqlite3O
1310: 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20  sEnterMutex();. 
1320: 20 20 20 70 50 72 65 76 20 3d 20 70 44 62 4c 69     pPrev = pDbLi
1330: 73 74 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 70  st;.    while( p
1340: 50 72 65 76 20 26 26 20 70 50 72 65 76 2d 3e 70  Prev && pPrev->p
1350: 4e 65 78 74 21 3d 64 62 20 29 7b 0a 20 20 20 20  Next!=db ){.    
1360: 20 20 70 50 72 65 76 20 3d 20 70 50 72 65 76 2d    pPrev = pPrev-
1370: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20  >pNext;.    }.  
1380: 20 20 69 66 28 20 70 50 72 65 76 20 29 7b 0a 20    if( pPrev ){. 
1390: 20 20 20 20 20 70 50 72 65 76 2d 3e 70 4e 65 78       pPrev->pNex
13a0: 74 20 3d 20 64 62 2d 3e 70 4e 65 78 74 3b 0a 20  t = db->pNext;. 
13b0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
13c0: 61 73 73 65 72 74 28 20 70 44 62 4c 69 73 74 3d  assert( pDbList=
13d0: 3d 64 62 20 29 3b 0a 20 20 20 20 20 20 70 44 62  =db );.      pDb
13e0: 4c 69 73 74 20 3d 20 64 62 2d 3e 70 4e 65 78 74  List = db->pNext
13f0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
1400: 74 65 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 28  te3OsLeaveMutex(
1410: 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20  );.  }.#endif.. 
1420: 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c   db->magic = SQL
1430: 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b  ITE_MAGIC_ERROR;
1440: 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 64 62  .  sqliteFree(db
1450: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
1460: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
1470: 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 64 61 74  Rollback all dat
1480: 61 62 61 73 65 20 66 69 6c 65 73 2e 0a 2a 2f 0a  abase files..*/.
1490: 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c  void sqlite3Roll
14a0: 62 61 63 6b 41 6c 6c 28 73 71 6c 69 74 65 33 20  backAll(sqlite3 
14b0: 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20  *db){.  int i;. 
14c0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e   for(i=0; i<db->
14d0: 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69  nDb; i++){.    i
14e0: 66 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42  f( db->aDb[i].pB
14f0: 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  t ){.      sqlit
1500: 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28  e3BtreeRollback(
1510: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 29 3b  db->aDb[i].pBt);
1520: 0a 20 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69  .      db->aDb[i
1530: 5d 2e 69 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20  ].inTrans = 0;. 
1540: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74     }.  }.  sqlit
1550: 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53  e3ResetInternalS
1560: 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 7d 0a  chema(db, 0);.}.
1570: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20  ./*.** Return a 
1580: 73 74 61 74 69 63 20 73 74 72 69 6e 67 20 74 68  static string th
1590: 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65  at describes the
15a0: 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 73   kind of error s
15b0: 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 0a  pecified in the.
15c0: 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a  ** argument..*/.
15d0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69  const char *sqli
15e0: 74 65 33 45 72 72 53 74 72 28 69 6e 74 20 72 63  te3ErrStr(int rc
15f0: 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  ){.  const char 
1600: 2a 7a 3b 0a 20 20 73 77 69 74 63 68 28 20 72 63  *z;.  switch( rc
1610: 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c   ){.    case SQL
1620: 49 54 45 5f 52 4f 57 3a 0a 20 20 20 20 63 61 73  ITE_ROW:.    cas
1630: 65 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3a 0a 20  e SQLITE_DONE:. 
1640: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4f     case SQLITE_O
1650: 4b 3a 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22  K:         z = "
1660: 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 3b 20 20  not an error";  
1670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1680: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1690: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45     case SQLITE_E
16a0: 52 52 4f 52 3a 20 20 20 20 20 20 7a 20 3d 20 22  RROR:      z = "
16b0: 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 20  SQL logic error 
16c0: 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74 61 62  or missing datab
16d0: 61 73 65 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20  ase";   break;. 
16e0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49     case SQLITE_I
16f0: 4e 54 45 52 4e 41 4c 3a 20 20 20 7a 20 3d 20 22  NTERNAL:   z = "
1700: 69 6e 74 65 72 6e 61 6c 20 53 51 4c 69 74 65 20  internal SQLite 
1710: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66  implementation f
1720: 6c 61 77 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20  law";   break;. 
1730: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50     case SQLITE_P
1740: 45 52 4d 3a 20 20 20 20 20 20 20 7a 20 3d 20 22  ERM:       z = "
1750: 61 63 63 65 73 73 20 70 65 72 6d 69 73 73 69 6f  access permissio
1760: 6e 20 64 65 6e 69 65 64 22 3b 20 20 20 20 20 20  n denied";      
1770: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1780: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41     case SQLITE_A
1790: 42 4f 52 54 3a 20 20 20 20 20 20 7a 20 3d 20 22  BORT:      z = "
17a0: 63 61 6c 6c 62 61 63 6b 20 72 65 71 75 65 73 74  callback request
17b0: 65 64 20 71 75 65 72 79 20 61 62 6f 72 74 22 3b  ed query abort";
17c0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
17d0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42     case SQLITE_B
17e0: 55 53 59 3a 20 20 20 20 20 20 20 7a 20 3d 20 22  USY:       z = "
17f0: 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f 63 6b  database is lock
1800: 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ed";            
1810: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1820: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c     case SQLITE_L
1830: 4f 43 4b 45 44 3a 20 20 20 20 20 7a 20 3d 20 22  OCKED:     z = "
1840: 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 69  database table i
1850: 73 20 6c 6f 63 6b 65 64 22 3b 20 20 20 20 20 20  s locked";      
1860: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1870: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e     case SQLITE_N
1880: 4f 4d 45 4d 3a 20 20 20 20 20 20 7a 20 3d 20 22  OMEM:      z = "
1890: 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 3b 20  out of memory"; 
18a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
18b0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
18c0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52     case SQLITE_R
18d0: 45 41 44 4f 4e 4c 59 3a 20 20 20 7a 20 3d 20 22  EADONLY:   z = "
18e0: 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65  attempt to write
18f0: 20 61 20 72 65 61 64 6f 6e 6c 79 20 64 61 74 61   a readonly data
1900: 62 61 73 65 22 3b 20 20 62 72 65 61 6b 3b 0a 20  base";  break;. 
1910: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49     case SQLITE_I
1920: 4e 54 45 52 52 55 50 54 3a 20 20 7a 20 3d 20 22  NTERRUPT:  z = "
1930: 69 6e 74 65 72 72 75 70 74 65 64 22 3b 20 20 20  interrupted";   
1940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1950: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1960: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49     case SQLITE_I
1970: 4f 45 52 52 3a 20 20 20 20 20 20 7a 20 3d 20 22  OERR:      z = "
1980: 64 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72 22 3b  disk I/O error";
1990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
19a0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
19b0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43     case SQLITE_C
19c0: 4f 52 52 55 50 54 3a 20 20 20 20 7a 20 3d 20 22  ORRUPT:    z = "
19d0: 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 69 6d  database disk im
19e0: 61 67 65 20 69 73 20 6d 61 6c 66 6f 72 6d 65 64  age is malformed
19f0: 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ";      break;. 
1a00: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e     case SQLITE_N
1a10: 4f 54 46 4f 55 4e 44 3a 20 20 20 7a 20 3d 20 22  OTFOUND:   z = "
1a20: 74 61 62 6c 65 20 6f 72 20 72 65 63 6f 72 64 20  table or record 
1a30: 6e 6f 74 20 66 6f 75 6e 64 22 3b 20 20 20 20 20  not found";     
1a40: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1a50: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46     case SQLITE_F
1a60: 55 4c 4c 3a 20 20 20 20 20 20 20 7a 20 3d 20 22  ULL:       z = "
1a70: 64 61 74 61 62 61 73 65 20 69 73 20 66 75 6c 6c  database is full
1a80: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
1a90: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1aa0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43     case SQLITE_C
1ab0: 41 4e 54 4f 50 45 4e 3a 20 20 20 7a 20 3d 20 22  ANTOPEN:   z = "
1ac0: 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64  unable to open d
1ad0: 61 74 61 62 61 73 65 20 66 69 6c 65 22 3b 20 20  atabase file";  
1ae0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1af0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50     case SQLITE_P
1b00: 52 4f 54 4f 43 4f 4c 3a 20 20 20 7a 20 3d 20 22  ROTOCOL:   z = "
1b10: 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 69 6e 67  database locking
1b20: 20 70 72 6f 74 6f 63 6f 6c 20 66 61 69 6c 75 72   protocol failur
1b30: 65 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  e";     break;. 
1b40: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45     case SQLITE_E
1b50: 4d 50 54 59 3a 20 20 20 20 20 20 7a 20 3d 20 22  MPTY:      z = "
1b60: 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e  table contains n
1b70: 6f 20 64 61 74 61 22 3b 20 20 20 20 20 20 20 20  o data";        
1b80: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1b90: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53     case SQLITE_S
1ba0: 43 48 45 4d 41 3a 20 20 20 20 20 7a 20 3d 20 22  CHEMA:     z = "
1bb0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20  database schema 
1bc0: 68 61 73 20 63 68 61 6e 67 65 64 22 3b 20 20 20  has changed";   
1bd0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1be0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54     case SQLITE_T
1bf0: 4f 4f 42 49 47 3a 20 20 20 20 20 7a 20 3d 20 22  OOBIG:     z = "
1c00: 74 6f 6f 20 6d 75 63 68 20 64 61 74 61 20 66 6f  too much data fo
1c10: 72 20 6f 6e 65 20 74 61 62 6c 65 20 72 6f 77 22  r one table row"
1c20: 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;       break;. 
1c30: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43     case SQLITE_C
1c40: 4f 4e 53 54 52 41 49 4e 54 3a 20 7a 20 3d 20 22  ONSTRAINT: z = "
1c50: 63 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 6c 65  constraint faile
1c60: 64 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  d";             
1c70: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1c80: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d     case SQLITE_M
1c90: 49 53 4d 41 54 43 48 3a 20 20 20 7a 20 3d 20 22  ISMATCH:   z = "
1ca0: 64 61 74 61 74 79 70 65 20 6d 69 73 6d 61 74 63  datatype mismatc
1cb0: 68 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  h";             
1cc0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1cd0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d     case SQLITE_M
1ce0: 49 53 55 53 45 3a 20 20 20 20 20 7a 20 3d 20 22  ISUSE:     z = "
1cf0: 6c 69 62 72 61 72 79 20 72 6f 75 74 69 6e 65 20  library routine 
1d00: 63 61 6c 6c 65 64 20 6f 75 74 20 6f 66 20 73 65  called out of se
1d10: 71 75 65 6e 63 65 22 3b 62 72 65 61 6b 3b 0a 20  quence";break;. 
1d20: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e     case SQLITE_N
1d30: 4f 4c 46 53 3a 20 20 20 20 20 20 7a 20 3d 20 22  OLFS:      z = "
1d40: 6b 65 72 6e 65 6c 20 6c 61 63 6b 73 20 6c 61 72  kernel lacks lar
1d50: 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74 22  ge file support"
1d60: 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;       break;. 
1d70: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41     case SQLITE_A
1d80: 55 54 48 3a 20 20 20 20 20 20 20 7a 20 3d 20 22  UTH:       z = "
1d90: 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 64 65  authorization de
1da0: 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20 20 20  nied";          
1db0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1dc0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46     case SQLITE_F
1dd0: 4f 52 4d 41 54 3a 20 20 20 20 20 7a 20 3d 20 22  ORMAT:     z = "
1de0: 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 62 61  auxiliary databa
1df0: 73 65 20 66 6f 72 6d 61 74 20 65 72 72 6f 72 22  se format error"
1e00: 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;       break;. 
1e10: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52     case SQLITE_R
1e20: 41 4e 47 45 3a 20 20 20 20 20 20 7a 20 3d 20 22  ANGE:      z = "
1e30: 62 69 6e 64 20 6f 72 20 63 6f 6c 75 6d 6e 20 69  bind or column i
1e40: 6e 64 65 78 20 6f 75 74 20 6f 66 20 72 61 6e 67  ndex out of rang
1e50: 65 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  e";     break;. 
1e60: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e     case SQLITE_N
1e70: 4f 54 41 44 42 3a 20 20 20 20 20 7a 20 3d 20 22  OTADB:     z = "
1e80: 66 69 6c 65 20 69 73 20 65 6e 63 72 79 70 74 65  file is encrypte
1e90: 64 20 6f 72 20 69 73 20 6e 6f 74 20 61 20 64 61  d or is not a da
1ea0: 74 61 62 61 73 65 22 3b 62 72 65 61 6b 3b 0a 20  tabase";break;. 
1eb0: 20 20 20 64 65 66 61 75 6c 74 3a 20 20 20 20 20     default:     
1ec0: 20 20 20 20 20 20 20 20 20 20 20 7a 20 3d 20 22             z = "
1ed0: 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 20  unknown error"; 
1ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ef0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
1f00: 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d   }.  return z;.}
1f10: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
1f20: 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20  tine implements 
1f30: 61 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20  a busy callback 
1f40: 74 68 61 74 20 73 6c 65 65 70 73 20 61 6e 64 20  that sleeps and 
1f50: 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75  tries.** again u
1f60: 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 74 20 76  ntil a timeout v
1f70: 61 6c 75 65 20 69 73 20 72 65 61 63 68 65 64 2e  alue is reached.
1f80: 20 20 54 68 65 20 74 69 6d 65 6f 75 74 20 76 61    The timeout va
1f90: 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74  lue is.** an int
1fa0: 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d  eger number of m
1fb0: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61 73 73  illiseconds pass
1fc0: 65 64 20 69 6e 20 61 73 20 74 68 65 20 66 69 72  ed in as the fir
1fd0: 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a  st.** argument..
1fe0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71  */.static int sq
1ff0: 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 43  liteDefaultBusyC
2000: 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a  allback(. void *
2010: 70 74 72 2c 20 20 20 20 20 20 20 20 20 20 20 20  ptr,            
2020: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63     /* Database c
2030: 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 69 6e  onnection */. in
2040: 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20 20  t count         
2050: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
2060: 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65 20   of times table 
2070: 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a 2f  has been busy */
2080: 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d  .){.#if SQLITE_M
2090: 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20  IN_SLEEP_MS==1. 
20a0: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38   static const u8
20b0: 20 64 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 20 20   delays[] =.    
20c0: 20 7b 20 31 2c 20 32 2c 20 35 2c 20 31 30 2c 20   { 1, 2, 5, 10, 
20d0: 31 35 2c 20 32 30 2c 20 32 35 2c 20 32 35 2c 20  15, 20, 25, 25, 
20e0: 20 32 35 2c 20 20 35 30 2c 20 20 35 30 2c 20 31   25,  50,  50, 1
20f0: 30 30 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63  00 };.  static c
2100: 6f 6e 73 74 20 75 38 20 74 6f 74 61 6c 73 5b 5d  onst u8 totals[]
2110: 20 3d 0a 20 20 20 20 20 7b 20 30 2c 20 31 2c 20   =.     { 0, 1, 
2120: 33 2c 20 20 38 2c 20 31 38 2c 20 33 33 2c 20 35  3,  8, 18, 33, 5
2130: 33 2c 20 37 38 2c 20 31 30 33 2c 20 31 32 38 2c  3, 78, 103, 128,
2140: 20 31 37 38 2c 20 32 32 38 20 7d 3b 0a 23 20 64   178, 228 };.# d
2150: 65 66 69 6e 65 20 4e 44 45 4c 41 59 20 28 73 69  efine NDELAY (si
2160: 7a 65 6f 66 28 64 65 6c 61 79 73 29 2f 73 69 7a  zeof(delays)/siz
2170: 65 6f 66 28 64 65 6c 61 79 73 5b 30 5d 29 29 0a  eof(delays[0])).
2180: 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20    int timeout = 
2190: 28 28 73 71 6c 69 74 65 33 20 2a 29 70 74 72 29  ((sqlite3 *)ptr)
21a0: 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b 0a 20  ->busyTimeout;. 
21b0: 20 69 6e 74 20 64 65 6c 61 79 2c 20 70 72 69 6f   int delay, prio
21c0: 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 6f  r;..  assert( co
21d0: 75 6e 74 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20  unt>=0 );.  if( 
21e0: 63 6f 75 6e 74 20 3c 20 4e 44 45 4c 41 59 20 29  count < NDELAY )
21f0: 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65  {.    delay = de
2200: 6c 61 79 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 20  lays[count];.   
2210: 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b   prior = totals[
2220: 63 6f 75 6e 74 5d 3b 0a 20 20 7d 65 6c 73 65 7b  count];.  }else{
2230: 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c  .    delay = del
2240: 61 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b 0a 20  ays[NDELAY-1];. 
2250: 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c     prior = total
2260: 73 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20 64 65  s[NDELAY-1] + de
2270: 6c 61 79 2a 28 63 6f 75 6e 74 2d 28 4e 44 45 4c  lay*(count-(NDEL
2280: 41 59 2d 31 29 29 3b 0a 20 20 7d 0a 20 20 69 66  AY-1));.  }.  if
2290: 28 20 70 72 69 6f 72 20 2b 20 64 65 6c 61 79 20  ( prior + delay 
22a0: 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20  > timeout ){.   
22b0: 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75 74   delay = timeout
22c0: 20 2d 20 70 72 69 6f 72 3b 0a 20 20 20 20 69 66   - prior;.    if
22d0: 28 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 65 74  ( delay<=0 ) ret
22e0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c  urn 0;.  }.  sql
22f0: 69 74 65 33 4f 73 53 6c 65 65 70 28 64 65 6c 61  ite3OsSleep(dela
2300: 79 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  y);.  return 1;.
2310: 23 65 6c 73 65 0a 20 20 69 6e 74 20 74 69 6d 65  #else.  int time
2320: 6f 75 74 20 3d 20 28 28 73 71 6c 69 74 65 33 20  out = ((sqlite3 
2330: 2a 29 70 74 72 29 2d 3e 62 75 73 79 54 69 6d 65  *)ptr)->busyTime
2340: 6f 75 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 6e  out;.  if( (coun
2350: 74 2b 31 29 2a 31 30 30 30 20 3e 20 74 69 6d 65  t+1)*1000 > time
2360: 6f 75 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72  out ){.    retur
2370: 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  n 0;.  }.  sqlit
2380: 65 33 4f 73 53 6c 65 65 70 28 31 30 30 30 29 3b  e3OsSleep(1000);
2390: 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e  .  return 1;.#en
23a0: 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  dif.}../*.** Thi
23b0: 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74  s routine sets t
23c0: 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b  he busy callback
23d0: 20 66 6f 72 20 61 6e 20 53 71 6c 69 74 65 20 64   for an Sqlite d
23e0: 61 74 61 62 61 73 65 20 74 6f 20 74 68 65 0a 2a  atabase to the.*
23f0: 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b  * given callback
2400: 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74   function with t
2410: 68 65 20 67 69 76 65 6e 20 61 72 67 75 6d 65 6e  he given argumen
2420: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  t..*/.int sqlite
2430: 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a  3_busy_handler(.
2440: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20    sqlite3 *db,. 
2450: 20 69 6e 74 20 28 2a 78 42 75 73 79 29 28 76 6f   int (*xBusy)(vo
2460: 69 64 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64  id*,int),.  void
2470: 20 2a 70 41 72 67 0a 29 7b 0a 20 20 69 66 28 20   *pArg.){.  if( 
2480: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65  sqlite3SafetyChe
2490: 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65  ck(db) ){.    re
24a0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  turn SQLITE_MISU
24b0: 53 45 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 62 75  SE;.  }.  db->bu
24c0: 73 79 48 61 6e 64 6c 65 72 2e 78 46 75 6e 63 20  syHandler.xFunc 
24d0: 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e 62  = xBusy;.  db->b
24e0: 75 73 79 48 61 6e 64 6c 65 72 2e 70 41 72 67 20  usyHandler.pArg 
24f0: 3d 20 70 41 72 67 3b 0a 20 20 72 65 74 75 72 6e  = pArg;.  return
2500: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23   SQLITE_OK;.}..#
2510: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
2520: 49 54 5f 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c  IT_PROGRESS_CALL
2530: 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  BACK./*.** This 
2540: 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65  routine sets the
2550: 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61   progress callba
2560: 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69 74 65  ck for an Sqlite
2570: 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68 65   database to the
2580: 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62 61  .** given callba
2590: 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68  ck function with
25a0: 20 74 68 65 20 67 69 76 65 6e 20 61 72 67 75 6d   the given argum
25b0: 65 6e 74 2e 20 54 68 65 20 70 72 6f 67 72 65 73  ent. The progres
25c0: 73 20 63 61 6c 6c 62 61 63 6b 20 77 69 6c 6c 0a  s callback will.
25d0: 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64 20 65 76  ** be invoked ev
25e0: 65 72 79 20 6e 4f 70 73 20 6f 70 63 6f 64 65 73  ery nOps opcodes
25f0: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
2600: 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c  3_progress_handl
2610: 65 72 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  er(.  sqlite3 *d
2620: 62 2c 20 0a 20 20 69 6e 74 20 6e 4f 70 73 2c 0a  b, .  int nOps,.
2630: 20 20 69 6e 74 20 28 2a 78 50 72 6f 67 72 65 73    int (*xProgres
2640: 73 29 28 76 6f 69 64 2a 29 2c 20 0a 20 20 76 6f  s)(void*), .  vo
2650: 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 69 66  id *pArg.){.  if
2660: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79  ( !sqlite3Safety
2670: 43 68 65 63 6b 28 64 62 29 20 29 7b 0a 20 20 20  Check(db) ){.   
2680: 20 69 66 28 20 6e 4f 70 73 3e 30 20 29 7b 0a 20   if( nOps>0 ){. 
2690: 20 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 72 65       db->xProgre
26a0: 73 73 20 3d 20 78 50 72 6f 67 72 65 73 73 3b 0a  ss = xProgress;.
26b0: 20 20 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72        db->nProgr
26c0: 65 73 73 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a 20  essOps = nOps;. 
26d0: 20 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65       db->pProgre
26e0: 73 73 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20  ssArg = pArg;.  
26f0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 64    }else{.      d
2700: 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d 20 30  b->xProgress = 0
2710: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6e 50 72 6f  ;.      db->nPro
2720: 67 72 65 73 73 4f 70 73 20 3d 20 30 3b 0a 20 20  gressOps = 0;.  
2730: 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73      db->pProgres
2740: 73 41 72 67 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  sArg = 0;.    }.
2750: 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f    }.}.#endif.../
2760: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
2770: 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65 66  e installs a def
2780: 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c 65  ault busy handle
2790: 72 20 74 68 61 74 20 77 61 69 74 73 20 66 6f 72  r that waits for
27a0: 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 65   the.** specifie
27b0: 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c  d number of mill
27c0: 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20  iseconds before 
27d0: 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f 0a  returning 0..*/.
27e0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 75 73 79  int sqlite3_busy
27f0: 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65 33  _timeout(sqlite3
2800: 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20   *db, int ms){. 
2810: 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20   if( ms>0 ){.   
2820: 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74   db->busyTimeout
2830: 20 3d 20 6d 73 3b 0a 20 20 20 20 73 71 6c 69 74   = ms;.    sqlit
2840: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28  e3_busy_handler(
2850: 64 62 2c 20 73 71 6c 69 74 65 44 65 66 61 75 6c  db, sqliteDefaul
2860: 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 2c 20 28  tBusyCallback, (
2870: 76 6f 69 64 2a 29 64 62 29 3b 0a 20 20 7d 65 6c  void*)db);.  }el
2880: 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  se{.    sqlite3_
2890: 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c  busy_handler(db,
28a0: 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65   0, 0);.  }.  re
28b0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
28c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61  }../*.** Cause a
28d0: 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61  ny pending opera
28e0: 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20  tion to stop at 
28f0: 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70  its earliest opp
2900: 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69  ortunity..*/.voi
2910: 64 20 73 71 6c 69 74 65 33 5f 69 6e 74 65 72 72  d sqlite3_interr
2920: 75 70 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29  upt(sqlite3 *db)
2930: 7b 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33  {.  if( !sqlite3
2940: 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20  SafetyCheck(db) 
2950: 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67 73  ){.    db->flags
2960: 20 7c 3d 20 53 51 4c 49 54 45 5f 49 6e 74 65 72   |= SQLITE_Inter
2970: 72 75 70 74 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  rupt;.  }.}../*.
2980: 2a 2a 20 57 69 6e 64 6f 77 73 20 73 79 73 74 65  ** Windows syste
2990: 6d 73 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74  ms should call t
29a0: 68 69 73 20 72 6f 75 74 69 6e 65 20 74 6f 20 66  his routine to f
29b0: 72 65 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 0a  ree memory that.
29c0: 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20 69  ** is returned i
29d0: 6e 20 74 68 65 20 69 6e 20 74 68 65 20 65 72 72  n the in the err
29e0: 6d 73 67 20 70 61 72 61 6d 65 74 65 72 20 6f 66  msg parameter of
29f0: 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20   sqlite3_open() 
2a00: 77 68 65 6e 0a 2a 2a 20 53 51 4c 69 74 65 20 69  when.** SQLite i
2a10: 73 20 61 20 44 4c 4c 2e 20 20 46 6f 72 20 73 6f  s a DLL.  For so
2a20: 6d 65 20 72 65 61 73 6f 6e 2c 20 69 74 20 64 6f  me reason, it do
2a30: 65 73 20 6e 6f 74 20 77 6f 72 6b 20 74 6f 20 63  es not work to c
2a40: 61 6c 6c 20 66 72 65 65 28 29 0a 2a 2a 20 64 69  all free().** di
2a50: 72 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4e 6f  rectly..**.** No
2a60: 74 65 20 74 68 61 74 20 77 65 20 6e 65 65 64 20  te that we need 
2a70: 74 6f 20 63 61 6c 6c 20 66 72 65 65 28 29 20 6e  to call free() n
2a80: 6f 74 20 73 71 6c 69 74 65 46 72 65 65 28 29 20  ot sqliteFree() 
2a90: 68 65 72 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  here..*/.void sq
2aa0: 6c 69 74 65 33 5f 66 72 65 65 28 63 68 61 72 20  lite3_free(char 
2ab0: 2a 70 29 7b 20 66 72 65 65 28 70 29 3b 20 7d 0a  *p){ free(p); }.
2ac0: 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 6e 65  ./*.** Create ne
2ad0: 77 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 73  w user functions
2ae0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
2af0: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e  _create_function
2b00: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c  (.  sqlite3 *db,
2b10: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
2b20: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20  FunctionName,.  
2b30: 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20  int nArg,.  int 
2b40: 65 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 55 73  enc,.  void *pUs
2b50: 65 72 44 61 74 61 2c 0a 20 20 76 6f 69 64 20 28  erData,.  void (
2b60: 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f  *xFunc)(sqlite3_
2b70: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c  context*,int,sql
2b80: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a  ite3_value **),.
2b90: 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28    void (*xStep)(
2ba0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a  sqlite3_context*
2bb0: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c  ,int,sqlite3_val
2bc0: 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28  ue **),.  void (
2bd0: 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33  *xFinal)(sqlite3
2be0: 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20  _context*).){.  
2bf0: 46 75 6e 63 44 65 66 20 2a 70 3b 0a 20 20 69 6e  FuncDef *p;.  in
2c00: 74 20 6e 4e 61 6d 65 3b 0a 0a 20 20 69 66 28 20  t nName;..  if( 
2c10: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65  sqlite3SafetyChe
2c20: 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65  ck(db) ){.    re
2c30: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  turn SQLITE_MISU
2c40: 53 45 3b 0a 20 20 7d 0a 20 20 69 66 28 20 7a 46  SE;.  }.  if( zF
2c50: 75 6e 63 74 69 6f 6e 4e 61 6d 65 3d 3d 30 20 7c  unctionName==0 |
2c60: 7c 0a 20 20 20 20 20 20 28 78 46 75 6e 63 20 26  |.      (xFunc &
2c70: 26 20 28 78 46 69 6e 61 6c 20 7c 7c 20 78 53 74  & (xFinal || xSt
2c80: 65 70 29 29 20 7c 7c 20 0a 20 20 20 20 20 20 28  ep)) || .      (
2c90: 21 78 46 75 6e 63 20 26 26 20 28 78 46 69 6e 61  !xFunc && (xFina
2ca0: 6c 20 26 26 20 21 78 53 74 65 70 29 29 20 7c 7c  l && !xStep)) ||
2cb0: 0a 20 20 20 20 20 20 28 21 78 46 75 6e 63 20 26  .      (!xFunc &
2cc0: 26 20 28 21 78 46 69 6e 61 6c 20 26 26 20 78 53  & (!xFinal && xS
2cd0: 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 20 20 28  tep)) ||.      (
2ce0: 6e 41 72 67 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e  nArg<-1 || nArg>
2cf0: 31 32 37 29 20 7c 7c 0a 20 20 20 20 20 20 28 32  127) ||.      (2
2d00: 35 35 3c 28 6e 4e 61 6d 65 20 3d 20 73 74 72 6c  55<(nName = strl
2d10: 65 6e 28 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65  en(zFunctionName
2d20: 29 29 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ))) ){.    retur
2d30: 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  n SQLITE_ERROR;.
2d40: 20 20 7d 0a 20 20 0a 23 69 66 6e 64 65 66 20 53    }.  .#ifndef S
2d50: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
2d60: 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f  .  /* If SQLITE_
2d70: 55 54 46 31 36 20 69 73 20 73 70 65 63 69 66 69  UTF16 is specifi
2d80: 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69  ed as the encodi
2d90: 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f  ng type, transfo
2da0: 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20  rm this.  ** to 
2db0: 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54  one of SQLITE_UT
2dc0: 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f  F16LE or SQLITE_
2dd0: 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 68  UTF16BE using th
2de0: 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54  e.  ** SQLITE_UT
2df0: 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e  F16NATIVE macro.
2e00: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73   SQLITE_UTF16 is
2e10: 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e   not used intern
2e20: 61 6c 6c 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  ally..  **.  ** 
2e30: 49 66 20 53 51 4c 49 54 45 5f 41 4e 59 20 69 73  If SQLITE_ANY is
2e40: 20 73 70 65 63 69 66 69 65 64 2c 20 61 64 64 20   specified, add 
2e50: 74 68 72 65 65 20 76 65 72 73 69 6f 6e 73 20 6f  three versions o
2e60: 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 0a 20  f the function. 
2e70: 20 2a 2a 20 74 6f 20 74 68 65 20 68 61 73 68 20   ** to the hash 
2e80: 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66  table..  */.  if
2e90: 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54  ( enc==SQLITE_UT
2ea0: 46 31 36 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d  F16 ){.    enc =
2eb0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
2ec0: 49 56 45 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  IVE;.  }else if(
2ed0: 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 41 4e 59   enc==SQLITE_ANY
2ee0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a   ){.    int rc;.
2ef0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
2f00: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e  _create_function
2f10: 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61  (db, zFunctionNa
2f20: 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45  me, nArg, SQLITE
2f30: 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20 20 20  _UTF8,.         
2f40: 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63  pUserData, xFunc
2f50: 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29  , xStep, xFinal)
2f60: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
2f70: 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e  LITE_OK ) return
2f80: 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 73 71   rc;.    rc = sq
2f90: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e  lite3_create_fun
2fa0: 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74  ction(db, zFunct
2fb0: 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53  ionName, nArg, S
2fc0: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 0a 20  QLITE_UTF16LE,. 
2fd0: 20 20 20 20 20 20 20 70 55 73 65 72 44 61 74 61         pUserData
2fe0: 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20  , xFunc, xStep, 
2ff0: 78 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 66 28  xFinal);.    if(
3000: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
3010: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
3020: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46  enc = SQLITE_UTF
3030: 31 36 42 45 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a  16BE;.  }.#else.
3040: 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55    enc = SQLITE_U
3050: 54 46 38 3b 0a 23 65 6e 64 69 66 0a 20 20 0a 20  TF8;.#endif.  . 
3060: 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 20   /* Check if an 
3070: 65 78 69 73 74 69 6e 67 20 66 75 6e 63 74 69 6f  existing functio
3080: 6e 20 69 73 20 62 65 69 6e 67 20 6f 76 65 72 72  n is being overr
3090: 69 64 64 65 6e 20 6f 72 20 64 65 6c 65 74 65 64  idden or deleted
30a0: 2e 20 49 66 20 73 6f 2c 0a 20 20 2a 2a 20 61 6e  . If so,.  ** an
30b0: 64 20 74 68 65 72 65 20 61 72 65 20 61 63 74 69  d there are acti
30c0: 76 65 20 56 4d 73 2c 20 74 68 65 6e 20 72 65 74  ve VMs, then ret
30d0: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e  urn SQLITE_BUSY.
30e0: 20 49 66 20 61 20 66 75 6e 63 74 69 6f 6e 0a 20   If a function. 
30f0: 20 2a 2a 20 69 73 20 62 65 69 6e 67 20 6f 76 65   ** is being ove
3100: 72 72 69 64 64 65 6e 2f 64 65 6c 65 74 65 64 20  rridden/deleted 
3110: 62 75 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f  but there are no
3120: 20 61 63 74 69 76 65 20 56 4d 73 2c 20 61 6c 6c   active VMs, all
3130: 6f 77 20 74 68 65 0a 20 20 2a 2a 20 6f 70 65 72  ow the.  ** oper
3140: 61 74 69 6f 6e 20 74 6f 20 63 6f 6e 74 69 6e 75  ation to continu
3150: 65 20 62 75 74 20 69 6e 76 61 6c 69 64 61 74 65  e but invalidate
3160: 20 61 6c 6c 20 70 72 65 63 6f 6d 70 69 6c 65 64   all precompiled
3170: 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20 2a   statements..  *
3180: 2f 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46  /.  p = sqlite3F
3190: 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20  indFunction(db, 
31a0: 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e  zFunctionName, n
31b0: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63 2c  Name, nArg, enc,
31c0: 20 30 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20   0);.  if( p && 
31d0: 70 2d 3e 69 50 72 65 66 45 6e 63 3d 3d 65 6e 63  p->iPrefEnc==enc
31e0: 20 26 26 20 70 2d 3e 6e 41 72 67 3d 3d 6e 41 72   && p->nArg==nAr
31f0: 67 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d  g ){.    if( db-
3200: 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20 29  >activeVdbeCnt )
3210: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45  {.      sqlite3E
3220: 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f  rror(db, SQLITE_
3230: 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22  BUSY, .        "
3240: 55 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65  Unable to delete
3250: 2f 6d 6f 64 69 66 79 20 75 73 65 72 2d 66 75 6e  /modify user-fun
3260: 63 74 69 6f 6e 20 64 75 65 20 74 6f 20 61 63 74  ction due to act
3270: 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29  ive statements")
3280: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53  ;.      return S
3290: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20  QLITE_BUSY;.    
32a0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
32b0: 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72  ite3ExpirePrepar
32c0: 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29  edStatements(db)
32d0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70  ;.    }.  }..  p
32e0: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75   = sqlite3FindFu
32f0: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63  nction(db, zFunc
3300: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c  tionName, nName,
3310: 20 6e 41 72 67 2c 20 65 6e 63 2c 20 31 29 3b 0a   nArg, enc, 1);.
3320: 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74    if( p==0 ) ret
3330: 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  urn SQLITE_NOMEM
3340: 3b 0a 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20 78  ;.  p->xFunc = x
3350: 46 75 6e 63 3b 0a 20 20 70 2d 3e 78 53 74 65 70  Func;.  p->xStep
3360: 20 3d 20 78 53 74 65 70 3b 0a 20 20 70 2d 3e 78   = xStep;.  p->x
3370: 46 69 6e 61 6c 69 7a 65 20 3d 20 78 46 69 6e 61  Finalize = xFina
3380: 6c 3b 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74  l;.  p->pUserDat
3390: 61 20 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20  a = pUserData;. 
33a0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
33b0: 4b 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c  K;.}.#ifndef SQL
33c0: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 69  ITE_OMIT_UTF16.i
33d0: 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74  nt sqlite3_creat
33e0: 65 5f 66 75 6e 63 74 69 6f 6e 31 36 28 0a 20 20  e_function16(.  
33f0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63  sqlite3 *db,.  c
3400: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 46 75 6e 63  onst void *zFunc
3410: 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20  tionName,.  int 
3420: 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 54 65 78  nArg,.  int eTex
3430: 74 52 65 70 2c 0a 20 20 76 6f 69 64 20 2a 70 55  tRep,.  void *pU
3440: 73 65 72 44 61 74 61 2c 0a 20 20 76 6f 69 64 20  serData,.  void 
3450: 28 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33  (*xFunc)(sqlite3
3460: 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71  _context*,int,sq
3470: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a  lite3_value**),.
3480: 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28    void (*xStep)(
3490: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a  sqlite3_context*
34a0: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c  ,int,sqlite3_val
34b0: 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a  ue**),.  void (*
34c0: 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f  xFinal)(sqlite3_
34d0: 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 69  context*).){.  i
34e0: 6e 74 20 72 63 3b 0a 20 20 63 68 61 72 20 63 6f  nt rc;.  char co
34f0: 6e 73 74 20 2a 7a 46 75 6e 63 38 3b 0a 20 20 73  nst *zFunc8;.  s
3500: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 54  qlite3_value *pT
3510: 6d 70 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69 74  mp;..  if( sqlit
3520: 65 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 62  e3SafetyCheck(db
3530: 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  ) ){.    return 
3540: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20  SQLITE_MISUSE;. 
3550: 20 7d 0a 20 20 70 54 6d 70 20 3d 20 73 71 6c 69   }.  pTmp = sqli
3560: 74 65 33 47 65 74 54 72 61 6e 73 69 65 6e 74 56  te3GetTransientV
3570: 61 6c 75 65 28 64 62 29 3b 0a 20 20 73 71 6c 69  alue(db);.  sqli
3580: 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 70  te3ValueSetStr(p
3590: 54 6d 70 2c 20 2d 31 2c 20 7a 46 75 6e 63 74 69  Tmp, -1, zFuncti
35a0: 6f 6e 4e 61 6d 65 2c 20 53 51 4c 49 54 45 5f 55  onName, SQLITE_U
35b0: 54 46 31 36 4e 41 54 49 56 45 2c 53 51 4c 49 54  TF16NATIVE,SQLIT
35c0: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 46 75  E_STATIC);.  zFu
35d0: 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 56 61 6c  nc8 = sqlite3Val
35e0: 75 65 54 65 78 74 28 70 54 6d 70 2c 20 53 51 4c  ueText(pTmp, SQL
35f0: 49 54 45 5f 55 54 46 38 29 3b 0a 0a 20 20 69 66  ITE_UTF8);..  if
3600: 28 20 21 7a 46 75 6e 63 38 20 29 7b 0a 20 20 20  ( !zFunc8 ){.   
3610: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e   return SQLITE_N
3620: 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 63 20 3d  OMEM;.  }.  rc =
3630: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f   sqlite3_create_
3640: 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75  function(db, zFu
3650: 6e 63 38 2c 20 6e 41 72 67 2c 20 65 54 65 78 74  nc8, nArg, eText
3660: 52 65 70 2c 20 0a 20 20 20 20 20 20 70 55 73 65  Rep, .      pUse
3670: 72 44 61 74 61 2c 20 78 46 75 6e 63 2c 20 78 53  rData, xFunc, xS
3680: 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20  tep, xFinal);.  
3690: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e  return rc;.}.#en
36a0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73  dif../*.** Regis
36b0: 74 65 72 20 61 20 74 72 61 63 65 20 66 75 6e 63  ter a trace func
36c0: 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20  tion.  The pArg 
36d0: 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75  from the previou
36e0: 73 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 74  sly registered t
36f0: 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 75 72  race.** is retur
3700: 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e  ned.  .**.** A N
3710: 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 74 69  ULL trace functi
3720: 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f  on means that no
3730: 20 74 72 61 63 69 6e 67 20 69 73 20 65 78 65 63   tracing is exec
3740: 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c  utes.  A non-NUL
3750: 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 61 20  L.** trace is a 
3760: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e  pointer to a fun
3770: 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e  ction that is in
3780: 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73 74 61  voked at the sta
3790: 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 73 71  rt of each.** sq
37a0: 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a 2f  lite3_exec()..*/
37b0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 74  .void *sqlite3_t
37c0: 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a 64 62  race(sqlite3 *db
37d0: 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65 29  , void (*xTrace)
37e0: 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61  (void*,const cha
37f0: 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 29  r*), void *pArg)
3800: 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d  {.  void *pOld =
3810: 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 3b 0a   db->pTraceArg;.
3820: 20 20 64 62 2d 3e 78 54 72 61 63 65 20 3d 20 78    db->xTrace = x
3830: 54 72 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54 72  Trace;.  db->pTr
3840: 61 63 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20  aceArg = pArg;. 
3850: 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a   return pOld;.}.
3860: 0a 2f 2a 2a 2a 20 45 58 50 45 52 49 4d 45 4e 54  ./*** EXPERIMENT
3870: 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 67  AL ***.**.** Reg
3880: 69 73 74 65 72 20 61 20 66 75 6e 63 74 69 6f 6e  ister a function
3890: 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 77   to be invoked w
38a0: 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f  hen a transactio
38b0: 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a 2a 2a 20 49  n comments..** I
38c0: 66 20 65 69 74 68 65 72 20 66 75 6e 63 74 69 6f  f either functio
38d0: 6e 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65  n returns non-ze
38e0: 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6d  ro, then the com
38f0: 6d 69 74 20 62 65 63 6f 6d 65 73 20 61 0a 2a 2a  mit becomes a.**
3900: 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 76 6f   rollback..*/.vo
3910: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6d 6d  id *sqlite3_comm
3920: 69 74 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74  it_hook(.  sqlit
3930: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
3940: 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74       /* Attach t
3950: 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20  he hook to this 
3960: 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e  database */.  in
3970: 74 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76  t (*xCallback)(v
3980: 6f 69 64 2a 29 2c 20 20 2f 2a 20 46 75 6e 63 74  oid*),  /* Funct
3990: 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b 65 20 6f 6e  ion to invoke on
39a0: 20 65 61 63 68 20 63 6f 6d 6d 69 74 20 2a 2f 0a   each commit */.
39b0: 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20    void *pArg    
39c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41              /* A
39d0: 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66  rgument to the f
39e0: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20  unction */.){.  
39f0: 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64 62 2d  void *pOld = db-
3a00: 3e 70 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 20 64  >pCommitArg;.  d
3a10: 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61  b->xCommitCallba
3a20: 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a  ck = xCallback;.
3a30: 20 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67    db->pCommitArg
3a40: 20 3d 20 70 41 72 67 3b 0a 20 20 72 65 74 75 72   = pArg;.  retur
3a50: 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a  n pOld;.}.../*.*
3a60: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
3a70: 73 20 63 61 6c 6c 65 64 20 74 6f 20 63 72 65 61  s called to crea
3a80: 74 65 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  te a connection 
3a90: 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 42 54  to a database BT
3aa0: 72 65 65 0a 2a 2a 20 64 72 69 76 65 72 2e 20 20  ree.** driver.  
3ab0: 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20  If zFilename is 
3ac0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 66 69  the name of a fi
3ad0: 6c 65 2c 20 74 68 65 6e 20 74 68 61 74 20 66 69  le, then that fi
3ae0: 6c 65 20 69 73 0a 2a 2a 20 6f 70 65 6e 65 64 20  le is.** opened 
3af0: 61 6e 64 20 75 73 65 64 2e 20 20 49 66 20 7a 46  and used.  If zF
3b00: 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 20 6d  ilename is the m
3b10: 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f  agic name ":memo
3b20: 72 79 3a 22 20 74 68 65 6e 0a 2a 2a 20 74 68 65  ry:" then.** the
3b30: 20 64 61 74 61 62 61 73 65 20 69 73 20 73 74 6f   database is sto
3b40: 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 28 61  red in memory (a
3b50: 6e 64 20 69 73 20 74 68 75 73 20 66 6f 72 67 6f  nd is thus forgo
3b60: 74 74 65 6e 20 61 73 20 73 6f 6f 6e 20 61 73 0a  tten as soon as.
3b70: 2a 2a 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f  ** the connectio
3b80: 6e 20 69 73 20 63 6c 6f 73 65 64 2e 29 20 20 49  n is closed.)  I
3b90: 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e  f zFilename is N
3ba0: 55 4c 4c 20 74 68 65 6e 20 74 68 65 20 64 61 74  ULL then the dat
3bb0: 61 62 61 73 65 0a 2a 2a 20 69 73 20 66 6f 72 20  abase.** is for 
3bc0: 74 65 6d 70 6f 72 61 72 79 20 75 73 65 20 6f 6e  temporary use on
3bd0: 6c 79 20 61 6e 64 20 69 73 20 64 65 6c 65 74 65  ly and is delete
3be0: 64 20 61 73 20 73 6f 6f 6e 20 61 73 20 74 68 65  d as soon as the
3bf0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 69   connection.** i
3c00: 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20  s closed..**.** 
3c10: 41 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74 61  A temporary data
3c20: 62 61 73 65 20 63 61 6e 20 62 65 20 65 69 74 68  base can be eith
3c30: 65 72 20 61 20 64 69 73 6b 20 66 69 6c 65 20 28  er a disk file (
3c40: 74 68 61 74 20 69 73 20 61 75 74 6f 6d 61 74 69  that is automati
3c50: 63 61 6c 6c 79 0a 2a 2a 20 64 65 6c 65 74 65 64  cally.** deleted
3c60: 20 77 68 65 6e 20 74 68 65 20 66 69 6c 65 20 69   when the file i
3c70: 73 20 63 6c 6f 73 65 64 29 20 6f 72 20 61 20 73  s closed) or a s
3c80: 65 74 20 6f 66 20 72 65 64 2d 62 6c 61 63 6b 20  et of red-black 
3c90: 74 72 65 65 73 20 68 65 6c 64 20 69 6e 20 6d 65  trees held in me
3ca0: 6d 6f 72 79 2c 0a 2a 2a 20 64 65 70 65 6e 64 69  mory,.** dependi
3cb0: 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 73  ng on the values
3cc0: 20 6f 66 20 74 68 65 20 54 45 4d 50 5f 53 54 4f   of the TEMP_STO
3cd0: 52 45 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  RE compile-time 
3ce0: 6d 61 63 72 6f 20 61 6e 64 20 74 68 65 0a 2a 2a  macro and the.**
3cf0: 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20   db->temp_store 
3d00: 76 61 72 69 61 62 6c 65 2c 20 61 63 63 6f 72 64  variable, accord
3d10: 69 6e 67 20 74 6f 20 74 68 65 20 66 6f 6c 6c 6f  ing to the follo
3d20: 77 69 6e 67 20 63 68 61 72 74 3a 0a 2a 2a 0a 2a  wing chart:.**.*
3d30: 2a 20 20 20 20 20 20 20 54 45 4d 50 5f 53 54 4f  *       TEMP_STO
3d40: 52 45 20 20 20 20 20 64 62 2d 3e 74 65 6d 70 5f  RE     db->temp_
3d50: 73 74 6f 72 65 20 20 20 20 20 4c 6f 63 61 74 69  store     Locati
3d60: 6f 6e 20 6f 66 20 74 65 6d 70 6f 72 61 72 79 20  on of temporary 
3d70: 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 20  database.**     
3d80: 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20    ----------    
3d90: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20   -------------- 
3da0: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d      ------------
3db0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3dc0: 2d 2d 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  --.**           
3dd0: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0               
3de0: 61 6e 79 20 20 20 20 20 20 20 20 20 20 20 20 20  any             
3df0: 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20  file.**         
3e00: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20    1             
3e10: 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20     1            
3e20: 20 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20    file.**       
3e30: 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20      1           
3e40: 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20       2          
3e50: 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20      memory.**   
3e60: 20 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20          1       
3e70: 20 20 20 20 20 20 20 20 20 30 20 20 20 20 20 20           0      
3e80: 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20          file.** 
3e90: 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20            2     
3ea0: 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20             1    
3eb0: 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a            file.*
3ec0: 2a 20 20 20 20 20 20 20 20 20 20 20 32 20 20 20  *           2   
3ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20               2  
3ee0: 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f              memo
3ef0: 72 79 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  ry.**           
3f00: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  2               
3f10: 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20   0              
3f20: 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20 20 20  memory.**       
3f30: 20 20 20 20 33 20 20 20 20 20 20 20 20 20 20 20      3           
3f40: 20 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20      any         
3f50: 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2f 0a 69 6e      memory.*/.in
3f60: 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 46 61  t sqlite3BtreeFa
3f70: 63 74 6f 72 79 28 0a 20 20 63 6f 6e 73 74 20 73  ctory(.  const s
3f80: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
3f90: 20 20 20 2f 2a 20 4d 61 69 6e 20 64 61 74 61 62     /* Main datab
3fa0: 61 73 65 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67  ase when opening
3fb0: 20 61 75 78 20 6f 74 68 65 72 77 69 73 65 20 30   aux otherwise 0
3fc0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
3fd0: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 20 20   *zFilename,    
3fe0: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66  /* Name of the f
3ff0: 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74  ile containing t
4000: 68 65 20 42 54 72 65 65 20 64 61 74 61 62 61 73  he BTree databas
4010: 65 20 2a 2f 0a 20 20 69 6e 74 20 6f 6d 69 74 4a  e */.  int omitJ
4020: 6f 75 72 6e 61 6c 2c 20 20 20 20 20 20 20 20 20  ournal,         
4030: 20 2f 2a 20 69 66 20 54 52 55 45 20 74 68 65 6e   /* if TRUE then
4040: 20 64 6f 20 6e 6f 74 20 6a 6f 75 72 6e 61 6c 20   do not journal 
4050: 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 69  this file */.  i
4060: 6e 74 20 6e 43 61 63 68 65 2c 20 20 20 20 20 20  nt nCache,      
4070: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 6f 77 20           /* How 
4080: 6d 61 6e 79 20 70 61 67 65 73 20 69 6e 20 74 68  many pages in th
4090: 65 20 70 61 67 65 20 63 61 63 68 65 20 2a 2f 0a  e page cache */.
40a0: 20 20 42 74 72 65 65 20 2a 2a 70 70 42 74 72 65    Btree **ppBtre
40b0: 65 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50  e           /* P
40c0: 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 20 42 74  ointer to new Bt
40d0: 72 65 65 20 6f 62 6a 65 63 74 20 77 72 69 74 74  ree object writt
40e0: 65 6e 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20  en here */.){.  
40f0: 69 6e 74 20 62 74 72 65 65 5f 66 6c 61 67 73 20  int btree_flags 
4100: 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  = 0;.  int rc;. 
4110: 20 0a 20 20 61 73 73 65 72 74 28 20 70 70 42 74   .  assert( ppBt
4120: 72 65 65 20 21 3d 20 30 29 3b 0a 20 20 69 66 28  ree != 0);.  if(
4130: 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 20 29 7b 0a   omitJournal ){.
4140: 20 20 20 20 62 74 72 65 65 5f 66 6c 61 67 73 20      btree_flags 
4150: 7c 3d 20 42 54 52 45 45 5f 4f 4d 49 54 5f 4a 4f  |= BTREE_OMIT_JO
4160: 55 52 4e 41 4c 3b 0a 20 20 7d 0a 20 20 69 66 28  URNAL;.  }.  if(
4170: 20 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c   db->flags & SQL
4180: 49 54 45 5f 4e 6f 52 65 61 64 6c 6f 63 6b 20 29  ITE_NoReadlock )
4190: 7b 0a 20 20 20 20 62 74 72 65 65 5f 66 6c 61 67  {.    btree_flag
41a0: 73 20 7c 3d 20 42 54 52 45 45 5f 4e 4f 5f 52 45  s |= BTREE_NO_RE
41b0: 41 44 4c 4f 43 4b 3b 0a 20 20 7d 0a 20 20 69 66  ADLOCK;.  }.  if
41c0: 28 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 29  ( zFilename==0 )
41d0: 7b 0a 23 69 66 20 54 45 4d 50 5f 53 54 4f 52 45  {.#if TEMP_STORE
41e0: 3d 3d 30 0a 20 20 20 20 2f 2a 20 44 6f 20 6e 6f  ==0.    /* Do no
41f0: 74 68 69 6e 67 20 2a 2f 0a 23 65 6e 64 69 66 0a  thing */.#endif.
4200: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
4210: 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a 23 69 66  MIT_MEMORYDB.#if
4220: 20 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 31 0a 20   TEMP_STORE==1. 
4230: 20 20 20 69 66 28 20 64 62 2d 3e 74 65 6d 70 5f     if( db->temp_
4240: 73 74 6f 72 65 3d 3d 32 20 29 20 7a 46 69 6c 65  store==2 ) zFile
4250: 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f 72 79 3a  name = ":memory:
4260: 22 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 54 45  ";.#endif.#if TE
4270: 4d 50 5f 53 54 4f 52 45 3d 3d 32 0a 20 20 20 20  MP_STORE==2.    
4280: 69 66 28 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f  if( db->temp_sto
4290: 72 65 21 3d 31 20 29 20 7a 46 69 6c 65 6e 61 6d  re!=1 ) zFilenam
42a0: 65 20 3d 20 22 3a 6d 65 6d 6f 72 79 3a 22 3b 0a  e = ":memory:";.
42b0: 23 65 6e 64 69 66 0a 23 69 66 20 54 45 4d 50 5f  #endif.#if TEMP_
42c0: 53 54 4f 52 45 3d 3d 33 0a 20 20 20 20 7a 46 69  STORE==3.    zFi
42d0: 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f 72  lename = ":memor
42e0: 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 65 6e 64  y:";.#endif.#end
42f0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
4300: 54 5f 4d 45 4d 4f 52 59 44 42 20 2a 2f 0a 20 20  T_MEMORYDB */.  
4310: 7d 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  }..  rc = sqlite
4320: 33 42 74 72 65 65 4f 70 65 6e 28 7a 46 69 6c 65  3BtreeOpen(zFile
4330: 6e 61 6d 65 2c 20 70 70 42 74 72 65 65 2c 20 62  name, ppBtree, b
4340: 74 72 65 65 5f 66 6c 61 67 73 29 3b 0a 20 20 69  tree_flags);.  i
4350: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
4360: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42   ){.    sqlite3B
4370: 74 72 65 65 53 65 74 42 75 73 79 48 61 6e 64 6c  treeSetBusyHandl
4380: 65 72 28 2a 70 70 42 74 72 65 65 2c 20 28 76 6f  er(*ppBtree, (vo
4390: 69 64 2a 29 26 64 62 2d 3e 62 75 73 79 48 61 6e  id*)&db->busyHan
43a0: 64 6c 65 72 29 3b 0a 20 20 20 20 73 71 6c 69 74  dler);.    sqlit
43b0: 65 33 42 74 72 65 65 53 65 74 43 61 63 68 65 53  e3BtreeSetCacheS
43c0: 69 7a 65 28 2a 70 70 42 74 72 65 65 2c 20 6e 43  ize(*ppBtree, nC
43d0: 61 63 68 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74  ache);.  }.  ret
43e0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
43f0: 20 52 65 74 75 72 6e 20 55 54 46 2d 38 20 65 6e   Return UTF-8 en
4400: 63 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61  coded English la
4410: 6e 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69  nguage explanati
4420: 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72  on of the most r
4430: 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a  ecent.** error..
4440: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
4450: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 73 71  qlite3_errmsg(sq
4460: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 63 6f  lite3 *db){.  co
4470: 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 69  nst char *z;.  i
4480: 66 28 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f  f( sqlite3_mallo
4490: 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20  c_failed ){.    
44a0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72  return sqlite3Er
44b0: 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 4f 4d 45  rStr(SQLITE_NOME
44c0: 4d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71  M);.  }.  if( sq
44d0: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b  lite3SafetyCheck
44e0: 28 64 62 29 20 7c 7c 20 64 62 2d 3e 65 72 72 43  (db) || db->errC
44f0: 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4d 49 53 55  ode==SQLITE_MISU
4500: 53 45 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  SE ){.    return
4510: 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53   sqlite3ErrStr(S
4520: 51 4c 49 54 45 5f 4d 49 53 55 53 45 29 3b 0a 20  QLITE_MISUSE);. 
4530: 20 7d 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65 33   }.  z = sqlite3
4540: 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e  _value_text(db->
4550: 70 45 72 72 29 3b 0a 20 20 69 66 28 20 7a 3d 3d  pErr);.  if( z==
4560: 30 20 29 7b 0a 20 20 20 20 7a 20 3d 20 73 71 6c  0 ){.    z = sql
4570: 69 74 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65  ite3ErrStr(db->e
4580: 72 72 43 6f 64 65 29 3b 0a 20 20 7d 0a 20 20 72  rrCode);.  }.  r
4590: 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 23 69 66 6e  eturn z;.}..#ifn
45a0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
45b0: 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 74 75  UTF16./*.** Retu
45c0: 72 6e 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 65  rn UTF-16 encode
45d0: 64 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61  d English langua
45e0: 67 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f  ge explanation o
45f0: 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e  f the most recen
4600: 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63  t.** error..*/.c
4610: 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74  onst void *sqlit
4620: 65 33 5f 65 72 72 6d 73 67 31 36 28 73 71 6c 69  e3_errmsg16(sqli
4630: 74 65 33 20 2a 64 62 29 7b 0a 20 20 2f 2a 20 42  te3 *db){.  /* B
4640: 65 63 61 75 73 65 20 61 6c 6c 20 74 68 65 20 63  ecause all the c
4650: 68 61 72 61 63 74 65 72 73 20 69 6e 20 74 68 65  haracters in the
4660: 20 73 74 72 69 6e 67 20 61 72 65 20 69 6e 20 74   string are in t
4670: 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 2a 2a 20  he unicode.  ** 
4680: 72 61 6e 67 65 20 30 78 30 30 2d 30 78 46 46 2c  range 0x00-0xFF,
4690: 20 69 66 20 77 65 20 70 61 64 20 74 68 65 20 62   if we pad the b
46a0: 69 67 2d 65 6e 64 69 61 6e 20 73 74 72 69 6e 67  ig-endian string
46b0: 20 77 69 74 68 20 61 20 0a 20 20 2a 2a 20 7a 65   with a .  ** ze
46c0: 72 6f 20 62 79 74 65 2c 20 77 65 20 63 61 6e 20  ro byte, we can 
46d0: 6f 62 74 61 69 6e 20 74 68 65 20 6c 69 74 74 6c  obtain the littl
46e0: 65 2d 65 6e 64 69 61 6e 20 73 74 72 69 6e 67 20  e-endian string 
46f0: 77 69 74 68 0a 20 20 2a 2a 20 26 62 69 67 5f 65  with.  ** &big_e
4700: 6e 64 69 61 6e 5b 31 5d 2e 0a 20 20 2a 2f 0a 20  ndian[1]..  */. 
4710: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68   static const ch
4720: 61 72 20 6f 75 74 4f 66 4d 65 6d 42 65 5b 5d 20  ar outOfMemBe[] 
4730: 3d 20 7b 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20  = {.    0, 'o', 
4740: 30 2c 20 27 75 27 2c 20 30 2c 20 27 74 27 2c 20  0, 'u', 0, 't', 
4750: 30 2c 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20  0, ' ', .    0, 
4760: 27 6f 27 2c 20 30 2c 20 27 66 27 2c 20 30 2c 20  'o', 0, 'f', 0, 
4770: 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 6d 27  ' ', .    0, 'm'
4780: 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27 6d 27  , 0, 'e', 0, 'm'
4790: 2c 20 30 2c 20 27 6f 27 2c 20 30 2c 20 27 72 27  , 0, 'o', 0, 'r'
47a0: 2c 20 30 2c 20 27 79 27 2c 20 30 2c 20 30 2c 20  , 0, 'y', 0, 0, 
47b0: 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69 63 20  0.  };.  static 
47c0: 63 6f 6e 73 74 20 63 68 61 72 20 6d 69 73 75 73  const char misus
47d0: 65 42 65 20 5b 5d 20 3d 20 7b 0a 20 20 20 20 30  eBe [] = {.    0
47e0: 2c 20 27 6c 27 2c 20 30 2c 20 27 69 27 2c 20 30  , 'l', 0, 'i', 0
47f0: 2c 20 27 62 27 2c 20 30 2c 20 27 72 27 2c 20 30  , 'b', 0, 'r', 0
4800: 2c 20 27 61 27 2c 20 30 2c 20 27 72 27 2c 20 30  , 'a', 0, 'r', 0
4810: 2c 20 27 79 27 2c 20 30 2c 20 27 20 27 2c 20 0a  , 'y', 0, ' ', .
4820: 20 20 20 20 30 2c 20 27 72 27 2c 20 30 2c 20 27      0, 'r', 0, '
4830: 6f 27 2c 20 30 2c 20 27 75 27 2c 20 30 2c 20 27  o', 0, 'u', 0, '
4840: 74 27 2c 20 30 2c 20 27 69 27 2c 20 30 2c 20 27  t', 0, 'i', 0, '
4850: 6e 27 2c 20 30 2c 20 27 65 27 2c 20 30 2c 20 27  n', 0, 'e', 0, '
4860: 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 63 27 2c   ', .    0, 'c',
4870: 20 30 2c 20 27 61 27 2c 20 30 2c 20 27 6c 27 2c   0, 'a', 0, 'l',
4880: 20 30 2c 20 27 6c 27 2c 20 30 2c 20 27 65 27 2c   0, 'l', 0, 'e',
4890: 20 30 2c 20 27 64 27 2c 20 30 2c 20 27 20 27 2c   0, 'd', 0, ' ',
48a0: 20 0a 20 20 20 20 30 2c 20 27 6f 27 2c 20 30 2c   .    0, 'o', 0,
48b0: 20 27 75 27 2c 20 30 2c 20 27 74 27 2c 20 30 2c   'u', 0, 't', 0,
48c0: 20 27 20 27 2c 20 0a 20 20 20 20 30 2c 20 27 6f   ' ', .    0, 'o
48d0: 27 2c 20 30 2c 20 27 66 27 2c 20 30 2c 20 27 20  ', 0, 'f', 0, ' 
48e0: 27 2c 20 0a 20 20 20 20 30 2c 20 27 73 27 2c 20  ', .    0, 's', 
48f0: 30 2c 20 27 65 27 2c 20 30 2c 20 27 71 27 2c 20  0, 'e', 0, 'q', 
4900: 30 2c 20 27 75 27 2c 20 30 2c 20 27 65 27 2c 20  0, 'u', 0, 'e', 
4910: 30 2c 20 27 6e 27 2c 20 30 2c 20 27 63 27 2c 20  0, 'n', 0, 'c', 
4920: 30 2c 20 27 65 27 2c 20 30 2c 20 30 2c 20 30 0a  0, 'e', 0, 0, 0.
4930: 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 20 76 6f    };..  const vo
4940: 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 73 71 6c  id *z;.  if( sql
4950: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
4960: 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ed ){.    return
4970: 20 28 76 6f 69 64 20 2a 29 28 26 6f 75 74 4f 66   (void *)(&outOf
4980: 4d 65 6d 42 65 5b 53 51 4c 49 54 45 5f 55 54 46  MemBe[SQLITE_UTF
4990: 31 36 4e 41 54 49 56 45 3d 3d 53 51 4c 49 54 45  16NATIVE==SQLITE
49a0: 5f 55 54 46 31 36 4c 45 3f 31 3a 30 5d 29 3b 0a  _UTF16LE?1:0]);.
49b0: 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65    }.  if( sqlite
49c0: 33 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29  3SafetyCheck(db)
49d0: 20 7c 7c 20 64 62 2d 3e 65 72 72 43 6f 64 65 3d   || db->errCode=
49e0: 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 29  =SQLITE_MISUSE )
49f0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 76 6f  {.    return (vo
4a00: 69 64 20 2a 29 28 26 6d 69 73 75 73 65 42 65 5b  id *)(&misuseBe[
4a10: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49  SQLITE_UTF16NATI
4a20: 56 45 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36  VE==SQLITE_UTF16
4a30: 4c 45 3f 31 3a 30 5d 29 3b 0a 20 20 7d 0a 20 20  LE?1:0]);.  }.  
4a40: 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  z = sqlite3_valu
4a50: 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72  e_text16(db->pEr
4a60: 72 29 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29  r);.  if( z==0 )
4a70: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 61 6c  {.    sqlite3Val
4a80: 75 65 53 65 74 53 74 72 28 64 62 2d 3e 70 45 72  ueSetStr(db->pEr
4a90: 72 2c 20 2d 31 2c 20 73 71 6c 69 74 65 33 45 72  r, -1, sqlite3Er
4aa0: 72 53 74 72 28 64 62 2d 3e 65 72 72 43 6f 64 65  rStr(db->errCode
4ab0: 29 2c 0a 20 20 20 20 20 20 20 20 20 53 51 4c 49  ),.         SQLI
4ac0: 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f  TE_UTF8, SQLITE_
4ad0: 53 54 41 54 49 43 29 3b 0a 20 20 20 20 7a 20 3d  STATIC);.    z =
4ae0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
4af0: 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72 29 3b  ext16(db->pErr);
4b00: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b  .  }.  return z;
4b10: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
4b20: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
4b30: 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  /../*.** Return 
4b40: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20  the most recent 
4b50: 65 72 72 6f 72 20 63 6f 64 65 20 67 65 6e 65 72  error code gener
4b60: 61 74 65 64 20 62 79 20 61 6e 20 53 51 4c 69 74  ated by an SQLit
4b70: 65 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 69 6e  e routine..*/.in
4b80: 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64  t sqlite3_errcod
4b90: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  e(sqlite3 *db){.
4ba0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 6d 61    if( sqlite3_ma
4bb0: 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20  lloc_failed ){. 
4bc0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
4bd0: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66  _NOMEM;.  }.  if
4be0: 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 43  ( sqlite3SafetyC
4bf0: 68 65 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20  heck(db) ){.    
4c00: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
4c10: 53 55 53 45 3b 0a 20 20 7d 0a 20 20 72 65 74 75  SUSE;.  }.  retu
4c20: 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 65 3b 0a  rn db->errCode;.
4c30: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  }../*.** This ro
4c40: 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 77  utine does the w
4c50: 6f 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20 61  ork of opening a
4c60: 20 64 61 74 61 62 61 73 65 20 6f 6e 20 62 65 68   database on beh
4c70: 61 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 65  alf of.** sqlite
4c80: 33 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 71 6c  3_open() and sql
4c90: 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20 54  ite3_open16(). T
4ca0: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
4cb0: 6e 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65 22  name "zFilename"
4cc0: 20 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20 65    .** is UTF-8 e
4cd0: 6e 63 6f 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  ncoded..*/.stati
4ce0: 63 20 69 6e 74 20 6f 70 65 6e 44 61 74 61 62 61  c int openDataba
4cf0: 73 65 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72  se(.  const char
4d00: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a 20   *zFilename, /* 
4d10: 44 61 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d  Database filenam
4d20: 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20  e UTF-8 encoded 
4d30: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70  */.  sqlite3 **p
4d40: 70 44 62 20 20 20 20 20 20 20 20 20 2f 2a 20 4f  pDb         /* O
4d50: 55 54 3a 20 52 65 74 75 72 6e 65 64 20 64 61 74  UT: Returned dat
4d60: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a  abase handle */.
4d70: 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  ){.  sqlite3 *db
4d80: 3b 0a 20 20 69 6e 74 20 72 63 2c 20 69 3b 0a 0a  ;.  int rc, i;..
4d90: 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68    /* Allocate th
4da0: 65 20 73 71 6c 69 74 65 20 64 61 74 61 20 73 74  e sqlite data st
4db0: 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 64 62 20  ructure */.  db 
4dc0: 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20  = sqliteMalloc( 
4dd0: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 29 20  sizeof(sqlite3) 
4de0: 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29  );.  if( db==0 )
4df0: 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74   goto opendb_out
4e00: 3b 0a 20 20 64 62 2d 3e 70 72 69 6f 72 4e 65 77  ;.  db->priorNew
4e10: 52 6f 77 69 64 20 3d 20 30 3b 0a 20 20 64 62 2d  Rowid = 0;.  db-
4e20: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f  >magic = SQLITE_
4e30: 4d 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64 62  MAGIC_BUSY;.  db
4e40: 2d 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d  ->nDb = 2;.  db-
4e50: 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 74  >aDb = db->aDbSt
4e60: 61 74 69 63 3b 0a 20 20 64 62 2d 3e 65 6e 63 20  atic;.  db->enc 
4e70: 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20  = SQLITE_UTF8;. 
4e80: 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20   db->autoCommit 
4e90: 3d 20 31 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73  = 1;.  db->flags
4ea0: 20 7c 3d 20 53 51 4c 49 54 45 5f 53 68 6f 72 74   |= SQLITE_Short
4eb0: 43 6f 6c 4e 61 6d 65 73 3b 0a 20 20 73 71 6c 69  ColNames;.  sqli
4ec0: 74 65 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d  te3HashInit(&db-
4ed0: 3e 61 46 75 6e 63 2c 20 53 51 4c 49 54 45 5f 48  >aFunc, SQLITE_H
4ee0: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
4ef0: 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69    sqlite3HashIni
4f00: 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c  t(&db->aCollSeq,
4f10: 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52   SQLITE_HASH_STR
4f20: 49 4e 47 2c 20 30 29 3b 0a 20 20 66 6f 72 28 69  ING, 0);.  for(i
4f30: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
4f40: 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ++){.    sqlite3
4f50: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 44  HashInit(&db->aD
4f60: 62 5b 69 5d 2e 74 62 6c 48 61 73 68 2c 20 53 51  b[i].tblHash, SQ
4f70: 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47  LITE_HASH_STRING
4f80: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
4f90: 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61  3HashInit(&db->a
4fa0: 44 62 5b 69 5d 2e 69 64 78 48 61 73 68 2c 20 53  Db[i].idxHash, S
4fb0: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
4fc0: 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74  G, 0);.    sqlit
4fd0: 65 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e  e3HashInit(&db->
4fe0: 61 44 62 5b 69 5d 2e 74 72 69 67 48 61 73 68 2c  aDb[i].trigHash,
4ff0: 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52   SQLITE_HASH_STR
5000: 49 4e 47 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c  ING, 0);.    sql
5010: 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 64 62  ite3HashInit(&db
5020: 2d 3e 61 44 62 5b 69 5d 2e 61 46 4b 65 79 2c 20  ->aDb[i].aFKey, 
5030: 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49  SQLITE_HASH_STRI
5040: 4e 47 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 0a 20  NG, 1);.  }.  . 
5050: 20 2f 2a 20 41 64 64 20 74 68 65 20 64 65 66 61   /* Add the defa
5060: 75 6c 74 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65  ult collation se
5070: 71 75 65 6e 63 65 20 42 49 4e 41 52 59 2e 20 42  quence BINARY. B
5080: 49 4e 41 52 59 20 77 6f 72 6b 73 20 66 6f 72 20  INARY works for 
5090: 62 6f 74 68 20 55 54 46 2d 38 0a 20 20 2a 2a 20  both UTF-8.  ** 
50a0: 61 6e 64 20 55 54 46 2d 31 36 2c 20 73 6f 20 61  and UTF-16, so a
50b0: 64 64 20 61 20 76 65 72 73 69 6f 6e 20 66 6f 72  dd a version for
50c0: 20 65 61 63 68 20 74 6f 20 61 76 6f 69 64 20 61   each to avoid a
50d0: 6e 79 20 75 6e 6e 65 63 65 73 73 61 72 79 0a 20  ny unnecessary. 
50e0: 20 2a 2a 20 63 6f 6e 76 65 72 73 69 6f 6e 73 2e   ** conversions.
50f0: 20 54 68 65 20 6f 6e 6c 79 20 65 72 72 6f 72 20   The only error 
5100: 74 68 61 74 20 63 61 6e 20 6f 63 63 75 72 20 68  that can occur h
5110: 65 72 65 20 69 73 20 61 20 6d 61 6c 6c 6f 63 28  ere is a malloc(
5120: 29 20 66 61 69 6c 75 72 65 2e 0a 20 20 2a 2f 0a  ) failure..  */.
5130: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 63 72    if( sqlite3_cr
5140: 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64  eate_collation(d
5150: 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c  b, "BINARY", SQL
5160: 49 54 45 5f 55 54 46 38 2c 20 30 2c 62 69 6e 43  ITE_UTF8, 0,binC
5170: 6f 6c 6c 46 75 6e 63 29 20 7c 7c 0a 20 20 20 20  ollFunc) ||.    
5180: 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65    sqlite3_create
5190: 5f 63 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22  _collation(db, "
51a0: 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 5f  BINARY", SQLITE_
51b0: 55 54 46 31 36 2c 20 30 2c 62 69 6e 43 6f 6c 6c  UTF16, 0,binColl
51c0: 46 75 6e 63 29 20 7c 7c 0a 20 20 20 20 20 20 21  Func) ||.      !
51d0: 28 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d  (db->pDfltColl =
51e0: 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c   sqlite3FindColl
51f0: 53 65 71 28 64 62 2c 20 64 62 2d 3e 65 6e 63 2c  Seq(db, db->enc,
5200: 20 22 42 49 4e 41 52 59 22 2c 20 36 2c 20 30 29   "BINARY", 6, 0)
5210: 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 64 62  ) ){.    rc = db
5220: 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 20 20 61  ->errCode;.    a
5230: 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54  ssert( rc!=SQLIT
5240: 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 64 62 2d 3e  E_OK );.    db->
5250: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d  magic = SQLITE_M
5260: 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 20  AGIC_CLOSED;.   
5270: 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74   goto opendb_out
5280: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 6c 73 6f  ;.  }..  /* Also
5290: 20 61 64 64 20 61 20 55 54 46 2d 38 20 63 61 73   add a UTF-8 cas
52a0: 65 2d 69 6e 73 65 6e 73 69 74 69 76 65 20 63 6f  e-insensitive co
52b0: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65  llation sequence
52c0: 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 63  . */.  sqlite3_c
52d0: 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28  reate_collation(
52e0: 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c 20 53 51  db, "NOCASE", SQ
52f0: 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 20 6e 6f  LITE_UTF8, 0, no
5300: 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e  caseCollatingFun
5310: 63 29 3b 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74  c);..  /* Open t
5320: 68 65 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62  he backend datab
5330: 61 73 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20  ase driver */.  
5340: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
5350: 65 46 61 63 74 6f 72 79 28 64 62 2c 20 7a 46 69  eFactory(db, zFi
5360: 6c 65 6e 61 6d 65 2c 20 30 2c 20 4d 41 58 5f 50  lename, 0, MAX_P
5370: 41 47 45 53 2c 20 26 64 62 2d 3e 61 44 62 5b 30  AGES, &db->aDb[0
5380: 5d 2e 70 42 74 29 3b 0a 20 20 69 66 28 20 72 63  ].pBt);.  if( rc
5390: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
53a0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
53b0: 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20 20 20  db, rc, 0);.    
53c0: 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49  db->magic = SQLI
53d0: 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b  TE_MAGIC_CLOSED;
53e0: 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62  .    goto opendb
53f0: 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  _out;.  }..  /* 
5400: 54 68 65 20 64 65 66 61 75 6c 74 20 73 61 66 65  The default safe
5410: 74 79 5f 6c 65 76 65 6c 20 66 6f 72 20 74 68 65  ty_level for the
5420: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 69   main database i
5430: 73 20 27 66 75 6c 6c 27 3b 20 66 6f 72 20 74 68  s 'full'; for th
5440: 65 20 74 65 6d 70 0a 20 20 2a 2a 20 64 61 74 61  e temp.  ** data
5450: 62 61 73 65 20 69 74 20 69 73 20 27 4e 4f 4e 45  base it is 'NONE
5460: 27 2e 20 54 68 69 73 20 6d 61 74 63 68 65 73 20  '. This matches 
5470: 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 20  the pager layer 
5480: 64 65 66 61 75 6c 74 73 2e 20 20 0a 20 20 2a 2f  defaults.  .  */
5490: 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a 4e  .  db->aDb[0].zN
54a0: 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b 0a 20 20  ame = "main";.  
54b0: 64 62 2d 3e 61 44 62 5b 30 5d 2e 73 61 66 65 74  db->aDb[0].safet
54c0: 79 5f 6c 65 76 65 6c 20 3d 20 33 3b 0a 23 69 66  y_level = 3;.#if
54d0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
54e0: 5f 54 45 4d 50 44 42 0a 20 20 64 62 2d 3e 61 44  _TEMPDB.  db->aD
54f0: 62 5b 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22 74 65  b[1].zName = "te
5500: 6d 70 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31  mp";.  db->aDb[1
5510: 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d  ].safety_level =
5520: 20 31 3b 0a 23 65 6e 64 69 66 0a 0a 0a 20 20 2f   1;.#endif...  /
5530: 2a 20 52 65 67 69 73 74 65 72 20 61 6c 6c 20 62  * Register all b
5540: 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e  uilt-in function
5550: 73 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20 61 74  s, but do not at
5560: 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68  tempt to read th
5570: 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20  e.  ** database 
5580: 73 63 68 65 6d 61 20 79 65 74 2e 20 54 68 69 73  schema yet. This
5590: 20 69 73 20 64 65 6c 61 79 65 64 20 75 6e 74 69   is delayed unti
55a0: 6c 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65  l the first time
55b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20   the database.  
55c0: 2a 2a 20 69 73 20 61 63 63 65 73 73 65 64 2e 0a  ** is accessed..
55d0: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 52 65    */.  sqlite3Re
55e0: 67 69 73 74 65 72 42 75 69 6c 74 69 6e 46 75 6e  gisterBuiltinFun
55f0: 63 74 69 6f 6e 73 28 64 62 29 3b 0a 20 20 73 71  ctions(db);.  sq
5600: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53  lite3Error(db, S
5610: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20  QLITE_OK, 0);.  
5620: 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49  db->magic = SQLI
5630: 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 0a  TE_MAGIC_OPEN;..
5640: 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a 20 20 69 66  opendb_out:.  if
5650: 28 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64  ( sqlite3_errcod
5660: 65 28 64 62 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b  e(db)==SQLITE_OK
5670: 20 26 26 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c   && sqlite3_mall
5680: 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20  oc_failed ){.   
5690: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
56a0: 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2c 20  , SQLITE_NOMEM, 
56b0: 30 29 3b 0a 20 20 7d 0a 20 20 2a 70 70 44 62 20  0);.  }.  *ppDb 
56c0: 3d 20 64 62 3b 0a 23 69 66 6e 64 65 66 20 53 51  = db;.#ifndef SQ
56d0: 4c 49 54 45 5f 4f 4d 49 54 5f 47 4c 4f 42 41 4c  LITE_OMIT_GLOBAL
56e0: 52 45 43 4f 56 45 52 0a 20 20 69 66 28 20 64 62  RECOVER.  if( db
56f0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f   ){.    sqlite3O
5700: 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20  sEnterMutex();. 
5710: 20 20 20 64 62 2d 3e 70 4e 65 78 74 20 3d 20 70     db->pNext = p
5720: 44 62 4c 69 73 74 3b 0a 20 20 20 20 70 44 62 4c  DbList;.    pDbL
5730: 69 73 74 20 3d 20 64 62 3b 0a 20 20 20 20 73 71  ist = db;.    sq
5740: 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 74 65  lite3OsLeaveMute
5750: 78 28 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  x();.  }.#endif.
5760: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
5770: 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a 7d 0a  _errcode(db);.}.
5780: 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65  ./*.** Open a ne
5790: 77 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  w database handl
57a0: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
57b0: 33 5f 6f 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20  3_open(.  const 
57c0: 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c  char *zFilename,
57d0: 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70   .  sqlite3 **pp
57e0: 44 62 20 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20  Db .){.  return 
57f0: 6f 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69  openDatabase(zFi
5800: 6c 65 6e 61 6d 65 2c 20 70 70 44 62 29 3b 0a 7d  lename, ppDb);.}
5810: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ..#ifndef SQLITE
5820: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a  _OMIT_UTF16./*.*
5830: 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 74  * Open a new dat
5840: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f  abase handle..*/
5850: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65  .int sqlite3_ope
5860: 6e 31 36 28 0a 20 20 63 6f 6e 73 74 20 76 6f 69  n16(.  const voi
5870: 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20  d *zFilename, . 
5880: 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 0a   sqlite3 **ppDb.
5890: 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20  ){.  char const 
58a0: 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b 20 20 20 2f  *zFilename8;   /
58b0: 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 65 6e 63 6f  * zFilename enco
58c0: 64 65 64 20 69 6e 20 55 54 46 2d 38 20 69 6e 73  ded in UTF-8 ins
58d0: 74 65 61 64 20 6f 66 20 55 54 46 2d 31 36 20 2a  tead of UTF-16 *
58e0: 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  /.  int rc = SQL
58f0: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 73 71 6c  ITE_NOMEM;.  sql
5900: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c  ite3_value *pVal
5910: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 70 44  ;..  assert( ppD
5920: 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 3d 20 30  b );.  *ppDb = 0
5930: 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69 74  ;.  pVal = sqlit
5940: 65 33 56 61 6c 75 65 4e 65 77 28 29 3b 0a 20 20  e3ValueNew();.  
5950: 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53  sqlite3ValueSetS
5960: 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a 46 69  tr(pVal, -1, zFi
5970: 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f 55  lename, SQLITE_U
5980: 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c 49  TF16NATIVE, SQLI
5990: 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 46  TE_STATIC);.  zF
59a0: 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c 69 74  ilename8 = sqlit
59b0: 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c  e3ValueText(pVal
59c0: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a  , SQLITE_UTF8);.
59d0: 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 38    if( zFilename8
59e0: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 70 65   ){.    rc = ope
59f0: 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e  nDatabase(zFilen
5a00: 61 6d 65 38 2c 20 70 70 44 62 29 3b 0a 20 20 20  ame8, ppDb);.   
5a10: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
5a20: 4f 4b 20 26 26 20 2a 70 70 44 62 20 29 7b 0a 20  OK && *ppDb ){. 
5a30: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 65 78 65       sqlite3_exe
5a40: 63 28 2a 70 70 44 62 2c 20 22 50 52 41 47 4d 41  c(*ppDb, "PRAGMA
5a50: 20 65 6e 63 6f 64 69 6e 67 20 3d 20 27 55 54 46   encoding = 'UTF
5a60: 2d 31 36 27 22 2c 20 30 2c 20 30 2c 20 30 29 3b  -16'", 0, 0, 0);
5a70: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28  .    }.  }.  if(
5a80: 20 70 56 61 6c 20 29 7b 0a 20 20 20 20 73 71 6c   pVal ){.    sql
5a90: 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 70 56  ite3ValueFree(pV
5aa0: 61 6c 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75  al);.  }..  retu
5ab0: 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20  rn rc;.}.#endif 
5ac0: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  /* SQLITE_OMIT_U
5ad0: 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54  TF16 */../*.** T
5ae0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75  he following rou
5af0: 74 69 6e 65 20 64 65 73 74 72 6f 79 73 20 61 20  tine destroys a 
5b00: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20  virtual machine 
5b10: 74 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20  that is created 
5b20: 62 79 0a 2a 2a 20 74 68 65 20 73 71 6c 69 74 65  by.** the sqlite
5b30: 33 5f 63 6f 6d 70 69 6c 65 28 29 20 72 6f 75 74  3_compile() rout
5b40: 69 6e 65 2e 20 54 68 65 20 69 6e 74 65 67 65 72  ine. The integer
5b50: 20 72 65 74 75 72 6e 65 64 20 69 73 20 61 6e 20   returned is an 
5b60: 53 51 4c 49 54 45 5f 0a 2a 2a 20 73 75 63 63 65  SQLITE_.** succe
5b70: 73 73 2f 66 61 69 6c 75 72 65 20 63 6f 64 65 20  ss/failure code 
5b80: 74 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74  that describes t
5b90: 68 65 20 72 65 73 75 6c 74 20 6f 66 20 65 78 65  he result of exe
5ba0: 63 75 74 69 6e 67 20 74 68 65 20 76 69 72 74 75  cuting the virtu
5bb0: 61 6c 0a 2a 2a 20 6d 61 63 68 69 6e 65 2e 0a 2a  al.** machine..*
5bc0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
5bd0: 65 20 73 65 74 73 20 74 68 65 20 65 72 72 6f 72  e sets the error
5be0: 20 63 6f 64 65 20 61 6e 64 20 73 74 72 69 6e 67   code and string
5bf0: 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20   returned by.** 
5c00: 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28  sqlite3_errcode(
5c10: 29 2c 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73  ), sqlite3_errms
5c20: 67 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f  g() and sqlite3_
5c30: 65 72 72 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69  errmsg16()..*/.i
5c40: 6e 74 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c  nt sqlite3_final
5c50: 69 7a 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ize(sqlite3_stmt
5c60: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20   *pStmt){.  int 
5c70: 72 63 3b 0a 20 20 69 66 28 20 70 53 74 6d 74 3d  rc;.  if( pStmt=
5c80: 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53  =0 ){.    rc = S
5c90: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73  QLITE_OK;.  }els
5ca0: 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  e{.    rc = sqli
5cb0: 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28  te3VdbeFinalize(
5cc0: 28 56 64 62 65 2a 29 70 53 74 6d 74 29 3b 0a 20  (Vdbe*)pStmt);. 
5cd0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
5ce0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65 72 6d 69 6e 61  }../*.** Termina
5cf0: 74 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 65  te the current e
5d00: 78 65 63 75 74 69 6f 6e 20 6f 66 20 61 6e 20 53  xecution of an S
5d10: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64  QL statement and
5d20: 20 72 65 73 65 74 20 69 74 0a 2a 2a 20 62 61 63   reset it.** bac
5d30: 6b 20 74 6f 20 69 74 73 20 73 74 61 72 74 69 6e  k to its startin
5d40: 67 20 73 74 61 74 65 20 73 6f 20 74 68 61 74 20  g state so that 
5d50: 69 74 20 63 61 6e 20 62 65 20 72 65 75 73 65 64  it can be reused
5d60: 2e 20 41 20 73 75 63 63 65 73 73 20 63 6f 64 65  . A success code
5d70: 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 70 72 69   from.** the pri
5d80: 6f 72 20 65 78 65 63 75 74 69 6f 6e 20 69 73 20  or execution is 
5d90: 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20  returned..**.** 
5da0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74  This routine set
5db0: 73 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65  s the error code
5dc0: 20 61 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75   and string retu
5dd0: 72 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74  rned by.** sqlit
5de0: 65 33 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71  e3_errcode(), sq
5df0: 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61  lite3_errmsg() a
5e00: 6e 64 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73  nd sqlite3_errms
5e10: 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71  g16()..*/.int sq
5e20: 6c 69 74 65 33 5f 72 65 73 65 74 28 73 71 6c 69  lite3_reset(sqli
5e30: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29  te3_stmt *pStmt)
5e40: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66  {.  int rc;.  if
5e50: 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a 20 20  ( pStmt==0 ){.  
5e60: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b    rc = SQLITE_OK
5e70: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72  ;.  }else{.    r
5e80: 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 52  c = sqlite3VdbeR
5e90: 65 73 65 74 28 28 56 64 62 65 2a 29 70 53 74 6d  eset((Vdbe*)pStm
5ea0: 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56  t);.    sqlite3V
5eb0: 64 62 65 4d 61 6b 65 52 65 61 64 79 28 28 56 64  dbeMakeReady((Vd
5ec0: 62 65 2a 29 70 53 74 6d 74 2c 20 2d 31 2c 20 30  be*)pStmt, -1, 0
5ed0: 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a  , 0, 0, 0);.  }.
5ee0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
5ef0: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61  /*.** Register a
5f00: 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73   new collation s
5f10: 65 71 75 65 6e 63 65 20 77 69 74 68 20 74 68 65  equence with the
5f20: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
5f30: 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69   db..*/.int sqli
5f40: 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61  te3_create_colla
5f50: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a  tion(.  sqlite3*
5f60: 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68   db, .  const ch
5f70: 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e  ar *zName, .  in
5f80: 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20  t enc, .  void* 
5f90: 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f  pCtx,.  int(*xCo
5fa0: 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74  mpare)(void*,int
5fb0: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74  ,const void*,int
5fc0: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b  ,const void*).){
5fd0: 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c  .  CollSeq *pCol
5fe0: 6c 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  l;.  int rc = SQ
5ff0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 0a 20 20 69 66  LITE_OK;.  .  if
6000: 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 43  ( sqlite3SafetyC
6010: 68 65 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20  heck(db) ){.    
6020: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
6030: 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  SUSE;.  }..  /* 
6040: 49 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20  If SQLITE_UTF16 
6050: 69 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20  is specified as 
6060: 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 74 79 70  the encoding typ
6070: 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 69  e, transform thi
6080: 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66  s.  ** to one of
6090: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20   SQLITE_UTF16LE 
60a0: 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42  or SQLITE_UTF16B
60b0: 45 20 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a  E using the.  **
60c0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
60d0: 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c 49 54  IVE macro. SQLIT
60e0: 45 5f 55 54 46 31 36 20 69 73 20 6e 6f 74 20 75  E_UTF16 is not u
60f0: 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a  sed internally..
6100: 20 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63 3d 3d    */.  if( enc==
6110: 53 51 4c 49 54 45 5f 55 54 46 31 36 20 29 7b 0a  SQLITE_UTF16 ){.
6120: 20 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45      enc = SQLITE
6130: 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20  _UTF16NATIVE;.  
6140: 7d 0a 0a 20 20 69 66 28 20 65 6e 63 21 3d 53 51  }..  if( enc!=SQ
6150: 4c 49 54 45 5f 55 54 46 38 20 26 26 20 65 6e 63  LITE_UTF8 && enc
6160: 21 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45  !=SQLITE_UTF16LE
6170: 20 26 26 20 65 6e 63 21 3d 53 51 4c 49 54 45 5f   && enc!=SQLITE_
6180: 55 54 46 31 36 42 45 20 29 7b 0a 20 20 20 20 73  UTF16BE ){.    s
6190: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
61a0: 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 20 0a 20  SQLITE_ERROR, . 
61b0: 20 20 20 20 20 20 20 22 50 61 72 61 6d 20 33 20         "Param 3 
61c0: 74 6f 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74  to sqlite3_creat
61d0: 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 29 20 6d 75  e_collation() mu
61e0: 73 74 20 62 65 20 6f 6e 65 20 6f 66 20 22 0a 20  st be one of ". 
61f0: 20 20 20 20 20 20 20 22 53 51 4c 49 54 45 5f 55         "SQLITE_U
6200: 54 46 38 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  TF8, SQLITE_UTF1
6210: 36 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c  6, SQLITE_UTF16L
6220: 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31  E or SQLITE_UTF1
6230: 36 42 45 22 0a 20 20 20 20 29 3b 0a 20 20 20 20  6BE".    );.    
6240: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52  return SQLITE_ER
6250: 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43  ROR;.  }..  /* C
6260: 68 65 63 6b 20 69 66 20 74 68 69 73 20 63 61 6c  heck if this cal
6270: 6c 20 69 73 20 72 65 6d 6f 76 69 6e 67 20 6f 72  l is removing or
6280: 20 72 65 70 6c 61 63 69 6e 67 20 61 6e 20 65 78   replacing an ex
6290: 69 73 74 69 6e 67 20 63 6f 6c 6c 61 74 69 6f 6e  isting collation
62a0: 20 0a 20 20 2a 2a 20 73 65 71 75 65 6e 63 65 2e   .  ** sequence.
62b0: 20 49 66 20 73 6f 2c 20 61 6e 64 20 74 68 65 72   If so, and ther
62c0: 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73  e are active VMs
62d0: 2c 20 72 65 74 75 72 6e 20 62 75 73 79 2e 20 49  , return busy. I
62e0: 66 20 74 68 65 72 65 0a 20 20 2a 2a 20 61 72 65  f there.  ** are
62f0: 20 6e 6f 20 61 63 74 69 76 65 20 56 4d 73 2c 20   no active VMs, 
6300: 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 79 20 70  invalidate any p
6310: 72 65 2d 63 6f 6d 70 69 6c 65 64 20 73 74 61 74  re-compiled stat
6320: 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70  ements..  */.  p
6330: 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69  Coll = sqlite3Fi
6340: 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75  ndCollSeq(db, (u
6350: 38 29 65 6e 63 2c 20 7a 4e 61 6d 65 2c 20 73 74  8)enc, zName, st
6360: 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 30 29 3b  rlen(zName), 0);
6370: 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 26 26 20  .  if( pColl && 
6380: 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 7b 0a 20  pColl->xCmp ){. 
6390: 20 20 20 69 66 28 20 64 62 2d 3e 61 63 74 69 76     if( db->activ
63a0: 65 56 64 62 65 43 6e 74 20 29 7b 0a 20 20 20 20  eVdbeCnt ){.    
63b0: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64    sqlite3Error(d
63c0: 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20  b, SQLITE_BUSY, 
63d0: 0a 20 20 20 20 20 20 20 20 22 55 6e 61 62 6c 65  .        "Unable
63e0: 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f 64 69 66   to delete/modif
63f0: 79 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75  y collation sequ
6400: 65 6e 63 65 20 64 75 65 20 74 6f 20 61 63 74 69  ence due to acti
6410: 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29 3b  ve statements");
6420: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51  .      return SQ
6430: 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 7d  LITE_BUSY;.    }
6440: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 69  .    sqlite3Expi
6450: 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 6d  rePreparedStatem
6460: 65 6e 74 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20  ents(db);.  }.. 
6470: 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33   pColl = sqlite3
6480: 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20  FindCollSeq(db, 
6490: 28 75 38 29 65 6e 63 2c 20 7a 4e 61 6d 65 2c 20  (u8)enc, zName, 
64a0: 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 2c 20 31  strlen(zName), 1
64b0: 29 3b 0a 20 20 69 66 28 20 30 3d 3d 70 43 6f 6c  );.  if( 0==pCol
64c0: 6c 20 29 7b 0a 20 20 20 72 63 20 3d 20 53 51 4c  l ){.   rc = SQL
64d0: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c  ITE_NOMEM;.  }el
64e0: 73 65 7b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 78  se{.    pColl->x
64f0: 43 6d 70 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a  Cmp = xCompare;.
6500: 20 20 20 20 70 43 6f 6c 6c 2d 3e 70 55 73 65 72      pColl->pUser
6510: 20 3d 20 70 43 74 78 3b 0a 20 20 20 20 70 43 6f   = pCtx;.    pCo
6520: 6c 6c 2d 3e 65 6e 63 20 3d 20 65 6e 63 3b 0a 20  ll->enc = enc;. 
6530: 20 7d 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f   }.  sqlite3Erro
6540: 72 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20  r(db, rc, 0);.  
6550: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69  return rc;.}..#i
6560: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
6570: 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65  T_UTF16./*.** Re
6580: 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c  gister a new col
6590: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20  lation sequence 
65a0: 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73  with the databas
65b0: 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a  e handle db..*/.
65c0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61  int sqlite3_crea
65d0: 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31 36 28 0a  te_collation16(.
65e0: 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a    sqlite3* db, .
65f0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e    const char *zN
6600: 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c  ame, .  int enc,
6610: 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a   .  void* pCtx,.
6620: 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29    int(*xCompare)
6630: 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74  (void*,int,const
6640: 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74   void*,int,const
6650: 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 63 68 61   void*).){.  cha
6660: 72 20 63 6f 6e 73 74 20 2a 7a 4e 61 6d 65 38 3b  r const *zName8;
6670: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  .  sqlite3_value
6680: 20 2a 70 54 6d 70 3b 0a 20 20 69 66 28 20 73 71   *pTmp;.  if( sq
6690: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b  lite3SafetyCheck
66a0: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75  (db) ){.    retu
66b0: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
66c0: 3b 0a 20 20 7d 0a 20 20 70 54 6d 70 20 3d 20 73  ;.  }.  pTmp = s
66d0: 71 6c 69 74 65 33 47 65 74 54 72 61 6e 73 69 65  qlite3GetTransie
66e0: 6e 74 56 61 6c 75 65 28 64 62 29 3b 0a 20 20 73  ntValue(db);.  s
66f0: 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53 74  qlite3ValueSetSt
6700: 72 28 70 54 6d 70 2c 20 2d 31 2c 20 7a 4e 61 6d  r(pTmp, -1, zNam
6710: 65 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e  e, SQLITE_UTF16N
6720: 41 54 49 56 45 2c 20 53 51 4c 49 54 45 5f 53 54  ATIVE, SQLITE_ST
6730: 41 54 49 43 29 3b 0a 20 20 7a 4e 61 6d 65 38 20  ATIC);.  zName8 
6740: 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65  = sqlite3ValueTe
6750: 78 74 28 70 54 6d 70 2c 20 53 51 4c 49 54 45 5f  xt(pTmp, SQLITE_
6760: 55 54 46 38 29 3b 0a 20 20 72 65 74 75 72 6e 20  UTF8);.  return 
6770: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63  sqlite3_create_c
6780: 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61  ollation(db, zNa
6790: 6d 65 38 2c 20 65 6e 63 2c 20 70 43 74 78 2c 20  me8, enc, pCtx, 
67a0: 78 43 6f 6d 70 61 72 65 29 3b 0a 7d 0a 23 65 6e  xCompare);.}.#en
67b0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
67c0: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a  IT_UTF16 */../*.
67d0: 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 6f  ** Register a co
67e0: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65  llation sequence
67f0: 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63   factory callbac
6800: 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62  k with the datab
6810: 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62  ase handle.** db
6820: 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72  . Replace any pr
6830: 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c  eviously install
6840: 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71  ed collation seq
6850: 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a  uence factory..*
6860: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f  /.int sqlite3_co
6870: 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 28 0a  llation_needed(.
6880: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a    sqlite3 *db, .
6890: 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65    void *pCollNee
68a0: 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28  dedArg, .  void(
68b0: 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f  *xCollNeeded)(vo
68c0: 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74  id*,sqlite3*,int
68d0: 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20   eTextRep,const 
68e0: 63 68 61 72 2a 29 0a 29 7b 0a 20 20 69 66 28 20  char*).){.  if( 
68f0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65  sqlite3SafetyChe
6900: 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65  ck(db) ){.    re
6910: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  turn SQLITE_MISU
6920: 53 45 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 78 43  SE;.  }.  db->xC
6930: 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 78 43 6f 6c  ollNeeded = xCol
6940: 6c 4e 65 65 64 65 64 3b 0a 20 20 64 62 2d 3e 78  lNeeded;.  db->x
6950: 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 30  CollNeeded16 = 0
6960: 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65  ;.  db->pCollNee
6970: 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65  dedArg = pCollNe
6980: 65 64 65 64 41 72 67 3b 0a 20 20 72 65 74 75 72  ededArg;.  retur
6990: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
69a0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
69b0: 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20  MIT_UTF16./*.** 
69c0: 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c 61  Register a colla
69d0: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61  tion sequence fa
69e0: 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 77  ctory callback w
69f0: 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65  ith the database
6a00: 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52   handle.** db. R
6a10: 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 69  eplace any previ
6a20: 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20  ously installed 
6a30: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e  collation sequen
6a40: 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69  ce factory..*/.i
6a50: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61  nt sqlite3_colla
6a60: 74 69 6f 6e 5f 6e 65 65 64 65 64 31 36 28 0a 20  tion_needed16(. 
6a70: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20   sqlite3 *db, . 
6a80: 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64   void *pCollNeed
6a90: 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a  edArg, .  void(*
6aa0: 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 29 28 76  xCollNeeded16)(v
6ab0: 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e  oid*,sqlite3*,in
6ac0: 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74  t eTextRep,const
6ad0: 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 66 28   void*).){.  if(
6ae0: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68   sqlite3SafetyCh
6af0: 65 63 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72  eck(db) ){.    r
6b00: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
6b10: 55 53 45 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 78  USE;.  }.  db->x
6b20: 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 30 3b 0a  CollNeeded = 0;.
6b30: 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65    db->xCollNeede
6b40: 64 31 36 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 65  d16 = xCollNeede
6b50: 64 31 36 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c  d16;.  db->pColl
6b60: 4e 65 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c  NeededArg = pCol
6b70: 6c 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 72 65  lNeededArg;.  re
6b80: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
6b90: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
6ba0: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f  TE_OMIT_UTF16 */
6bb0: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ..#ifndef SQLITE
6bc0: 5f 4f 4d 49 54 5f 47 4c 4f 42 41 4c 52 45 43 4f  _OMIT_GLOBALRECO
6bd0: 56 45 52 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  VER./*.** This f
6be0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
6bf0: 64 20 74 6f 20 72 65 63 6f 76 65 72 20 66 72 6f  d to recover fro
6c00: 6d 20 61 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75  m a malloc failu
6c10: 72 65 20 74 68 61 74 20 6f 63 63 75 72 65 64 0a  re that occured.
6c20: 2a 2a 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65  ** within SQLite
6c30: 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75  . .**.** This fu
6c40: 6e 63 74 69 6f 6e 20 69 73 20 2a 6e 6f 74 2a 20  nction is *not* 
6c50: 74 68 72 65 61 64 73 61 66 65 2e 20 43 61 6c 6c  threadsafe. Call
6c60: 69 6e 67 20 74 68 69 73 20 66 72 6f 6d 20 77 69  ing this from wi
6c70: 74 68 69 6e 20 61 20 74 68 72 65 61 64 65 64 0a  thin a threaded.
6c80: 2a 2a 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 77  ** application w
6c90: 68 65 6e 20 74 68 72 65 61 64 73 20 6f 74 68 65  hen threads othe
6ca0: 72 20 74 68 61 6e 20 74 68 65 20 63 61 6c 6c 65  r than the calle
6cb0: 72 20 68 61 76 65 20 75 73 65 64 20 53 51 4c 69  r have used SQLi
6cc0: 74 65 20 69 73 20 0a 2a 2a 20 64 61 6e 67 65 72  te is .** danger
6cd0: 6f 75 73 20 61 6e 64 20 77 69 6c 6c 20 61 6c 6d  ous and will alm
6ce0: 6f 73 74 20 63 65 72 74 61 69 6e 6c 79 20 72 65  ost certainly re
6cf0: 73 75 6c 74 20 69 6e 20 6d 61 6c 66 75 6e 63 74  sult in malfunct
6d00: 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ions..*/.int sql
6d10: 69 74 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f  ite3_global_reco
6d20: 76 65 72 28 29 7b 0a 20 20 69 6e 74 20 72 63 20  ver(){.  int rc 
6d30: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20  = SQLITE_OK;..  
6d40: 69 66 28 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  if( sqlite3_mall
6d50: 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20  oc_failed ){.   
6d60: 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20   sqlite3 *db;.  
6d70: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 73 71 6c    int i;.    sql
6d80: 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c  ite3_malloc_fail
6d90: 65 64 20 3d 20 30 3b 0a 20 20 20 20 66 6f 72 28  ed = 0;.    for(
6da0: 64 62 3d 70 44 62 4c 69 73 74 3b 20 64 62 3b 20  db=pDbList; db; 
6db0: 64 62 3d 64 62 2d 3e 70 4e 65 78 74 20 29 7b 0a  db=db->pNext ){.
6dc0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 78 70        sqlite3Exp
6dd0: 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65  irePreparedState
6de0: 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 20  ments(db);.     
6df0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e   for(i=0; i<db->
6e00: 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  nDb; i++){.     
6e10: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
6e20: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
6e30: 20 20 20 20 20 20 20 20 69 66 28 20 70 42 74 20          if( pBt 
6e40: 26 26 20 28 72 63 3d 73 71 6c 69 74 65 33 42 74  && (rc=sqlite3Bt
6e50: 72 65 65 52 65 73 65 74 28 70 42 74 29 29 20 29  reeReset(pBt)) )
6e60: 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f  {.          goto
6e70: 20 72 65 63 6f 76 65 72 5f 6f 75 74 3b 0a 20 20   recover_out;.  
6e80: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 20        }.      } 
6e90: 0a 20 20 20 20 20 20 64 62 2d 3e 61 75 74 6f 43  .      db->autoC
6ea0: 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 20 20 7d  ommit = 1;.    }
6eb0: 0a 20 20 7d 0a 0a 72 65 63 6f 76 65 72 5f 6f 75  .  }..recover_ou
6ec0: 74 3a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c  t:.  if( rc!=SQL
6ed0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71  ITE_OK ){.    sq
6ee0: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 5f 66 61 69  lite3_malloc_fai
6ef0: 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72  led = 1;.  }.  r
6f00: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64  eturn rc;.}.#end
6f10: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 74  if../*.** Test t
6f20: 6f 20 73 65 65 20 77 68 65 74 68 65 72 20 6f 72  o see whether or
6f30: 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 61 73   not the databas
6f40: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20  e connection is 
6f50: 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 0a 2a 2a  in autocommit.**
6f60: 20 6d 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 54   mode.  Return T
6f70: 52 55 45 20 69 66 20 69 74 20 69 73 20 61 6e 64  RUE if it is and
6f80: 20 46 41 4c 53 45 20 69 66 20 6e 6f 74 2e 20 20   FALSE if not.  
6f90: 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 20  Autocommit mode 
6fa0: 69 73 20 6f 6e 0a 2a 2a 20 62 79 20 64 65 66 61  is on.** by defa
6fb0: 75 6c 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 74  ult.  Autocommit
6fc0: 20 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 20   is disabled by 
6fd0: 61 20 42 45 47 49 4e 20 73 74 61 74 65 6d 65 6e  a BEGIN statemen
6fe0: 74 20 61 6e 64 20 72 65 65 6e 61 62 6c 65 64 0a  t and reenabled.
6ff0: 2a 2a 20 62 79 20 74 68 65 20 6e 65 78 74 20 43  ** by the next C
7000: 4f 4d 4d 49 54 20 6f 72 20 52 4f 4c 4c 42 41 43  OMMIT or ROLLBAC
7010: 4b 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 20 54 48  K..**.******* TH
7020: 49 53 20 49 53 20 41 4e 20 45 58 50 45 52 49 4d  IS IS AN EXPERIM
7030: 45 4e 54 41 4c 20 41 50 49 20 41 4e 44 20 49 53  ENTAL API AND IS
7040: 20 53 55 42 4a 45 43 54 20 54 4f 20 43 48 41 4e   SUBJECT TO CHAN
7050: 47 45 20 2a 2a 2a 2a 2a 2a 0a 2a 2f 0a 69 6e 74  GE ******.*/.int
7060: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 74   sqlite3_get_aut
7070: 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20  ocommit(sqlite3 
7080: 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64  *db){.  return d
7090: 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 3b 0a 7d  b->autoCommit;.}
70a0: 0a                                               .