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

Artifact cece44ee1d4427185e4ac85ddec79f31ac26965a:


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 41 20 54 43 4c 20  ******.** A TCL 
0180: 49 6e 74 65 72 66 61 63 65 20 74 6f 20 53 51 4c  Interface to SQL
0190: 69 74 65 0a 2a 2a 0a 2a 2a 20 24 49 64 3a 20 74  ite.**.** $Id: t
01a0: 63 6c 73 71 6c 69 74 65 2e 63 2c 76 20 31 2e 39  clsqlite.c,v 1.9
01b0: 38 20 32 30 30 34 2f 30 37 2f 32 36 20 31 32 3a  8 2004/07/26 12:
01c0: 32 34 3a 32 33 20 64 72 68 20 45 78 70 20 24 0a  24:23 drh Exp $.
01d0: 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 4f 5f 54 43  */.#ifndef NO_TC
01e0: 4c 20 20 20 20 20 2f 2a 20 4f 6d 69 74 20 74 68  L     /* Omit th
01f0: 69 73 20 77 68 6f 6c 65 20 66 69 6c 65 20 69 66  is whole file if
0200: 20 54 43 4c 20 69 73 20 75 6e 61 76 61 69 6c 61   TCL is unavaila
0210: 62 6c 65 20 2a 2f 0a 0a 23 69 6e 63 6c 75 64 65  ble */..#include
0220: 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23   "sqliteInt.h".#
0230: 69 6e 63 6c 75 64 65 20 22 74 63 6c 2e 68 22 0a  include "tcl.h".
0240: 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 6c 69 62  #include <stdlib
0250: 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74  .h>.#include <st
0260: 72 69 6e 67 2e 68 3e 0a 23 69 6e 63 6c 75 64 65  ring.h>.#include
0270: 20 3c 61 73 73 65 72 74 2e 68 3e 0a 0a 2f 2a 0a   <assert.h>../*.
0280: 2a 2a 20 49 66 20 54 43 4c 20 75 73 65 73 20 55  ** If TCL uses U
0290: 54 46 2d 38 20 61 6e 64 20 53 51 4c 69 74 65 20  TF-8 and SQLite 
02a0: 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 74 6f  is configured to
02b0: 20 75 73 65 20 69 73 6f 38 38 35 39 2c 20 74 68   use iso8859, th
02c0: 65 6e 20 77 65 0a 2a 2a 20 68 61 76 65 20 74 6f  en we.** have to
02d0: 20 64 6f 20 61 20 74 72 61 6e 73 6c 61 74 69 6f   do a translatio
02e0: 6e 20 77 68 65 6e 20 67 6f 69 6e 67 20 62 65 74  n when going bet
02f0: 77 65 65 6e 20 74 68 65 20 74 77 6f 2e 20 20 53  ween the two.  S
0300: 65 74 20 74 68 65 20 0a 2a 2a 20 55 54 46 5f 54  et the .** UTF_T
0310: 52 41 4e 53 4c 41 54 49 4f 4e 5f 4e 45 45 44 45  RANSLATION_NEEDE
0320: 44 20 6d 61 63 72 6f 20 74 6f 20 69 6e 64 69 63  D macro to indic
0330: 61 74 65 20 74 68 61 74 20 77 65 20 6e 65 65 64  ate that we need
0340: 20 74 6f 20 64 6f 0a 2a 2a 20 74 68 69 73 20 74   to do.** this t
0350: 72 61 6e 73 6c 61 74 69 6f 6e 2e 20 20 0a 2a 2f  ranslation.  .*/
0360: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 54 43 4c  .#if defined(TCL
0370: 5f 55 54 46 5f 4d 41 58 29 20 26 26 20 21 64 65  _UTF_MAX) && !de
0380: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 55 54 46  fined(SQLITE_UTF
0390: 38 29 0a 23 20 64 65 66 69 6e 65 20 55 54 46 5f  8).# define UTF_
03a0: 54 52 41 4e 53 4c 41 54 49 4f 4e 5f 4e 45 45 44  TRANSLATION_NEED
03b0: 45 44 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  ED 1.#endif../*.
03c0: 2a 2a 20 4e 65 77 20 53 51 4c 20 66 75 6e 63 74  ** New SQL funct
03d0: 69 6f 6e 73 20 63 61 6e 20 62 65 20 63 72 65 61  ions can be crea
03e0: 74 65 64 20 61 73 20 54 43 4c 20 73 63 72 69 70  ted as TCL scrip
03f0: 74 73 2e 20 20 45 61 63 68 20 73 75 63 68 20 66  ts.  Each such f
0400: 75 6e 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 64 65  unction.** is de
0410: 73 63 72 69 62 65 64 20 62 79 20 61 6e 20 69 6e  scribed by an in
0420: 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f  stance of the fo
0430: 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72  llowing structur
0440: 65 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74  e..*/.typedef st
0450: 72 75 63 74 20 53 71 6c 46 75 6e 63 20 53 71 6c  ruct SqlFunc Sql
0460: 46 75 6e 63 3b 0a 73 74 72 75 63 74 20 53 71 6c  Func;.struct Sql
0470: 46 75 6e 63 20 7b 0a 20 20 54 63 6c 5f 49 6e 74  Func {.  Tcl_Int
0480: 65 72 70 20 2a 69 6e 74 65 72 70 3b 20 20 20 2f  erp *interp;   /
0490: 2a 20 54 68 65 20 54 43 4c 20 69 6e 74 65 72 70  * The TCL interp
04a0: 72 65 74 20 74 6f 20 65 78 65 63 75 74 65 20 74  ret to execute t
04b0: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20  he function */. 
04c0: 20 63 68 61 72 20 2a 7a 53 63 72 69 70 74 3b 20   char *zScript; 
04d0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 63         /* The sc
04e0: 72 69 70 74 20 74 6f 20 62 65 20 72 75 6e 20 2a  ript to be run *
04f0: 2f 0a 20 20 53 71 6c 46 75 6e 63 20 2a 70 4e 65  /.  SqlFunc *pNe
0500: 78 74 3b 20 20 20 20 20 20 20 2f 2a 20 4e 65 78  xt;       /* Nex
0510: 74 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 74 68  t function on th
0520: 65 20 6c 69 73 74 20 6f 66 20 74 68 65 6d 20 61  e list of them a
0530: 6c 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20  ll */.};../*.** 
0540: 4e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65  New collation se
0550: 71 75 65 6e 63 65 73 20 66 75 6e 63 74 69 6f 6e  quences function
0560: 20 63 61 6e 20 62 65 20 63 72 65 61 74 65 64 20   can be created 
0570: 61 73 20 54 43 4c 20 73 63 72 69 70 74 73 2e 20  as TCL scripts. 
0580: 20 45 61 63 68 20 73 75 63 68 0a 2a 2a 20 66 75   Each such.** fu
0590: 6e 63 74 69 6f 6e 20 69 73 20 64 65 73 63 72 69  nction is descri
05a0: 62 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61 6e  bed by an instan
05b0: 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  ce of the follow
05c0: 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a  ing structure..*
05d0: 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  /.typedef struct
05e0: 20 53 71 6c 43 6f 6c 6c 61 74 65 20 53 71 6c 43   SqlCollate SqlC
05f0: 6f 6c 6c 61 74 65 3b 0a 73 74 72 75 63 74 20 53  ollate;.struct S
0600: 71 6c 43 6f 6c 6c 61 74 65 20 7b 0a 20 20 54 63  qlCollate {.  Tc
0610: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
0620: 3b 20 20 20 2f 2a 20 54 68 65 20 54 43 4c 20 69  ;   /* The TCL i
0630: 6e 74 65 72 70 72 65 74 20 74 6f 20 65 78 65 63  nterpret to exec
0640: 75 74 65 20 74 68 65 20 66 75 6e 63 74 69 6f 6e  ute the function
0650: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 53 63 72   */.  char *zScr
0660: 69 70 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 54  ipt;        /* T
0670: 68 65 20 73 63 72 69 70 74 20 74 6f 20 62 65 20  he script to be 
0680: 72 75 6e 20 2a 2f 0a 20 20 53 71 6c 43 6f 6c 6c  run */.  SqlColl
0690: 61 74 65 20 2a 70 4e 65 78 74 3b 20 20 20 20 20  ate *pNext;     
06a0: 20 20 2f 2a 20 4e 65 78 74 20 66 75 6e 63 74 69    /* Next functi
06b0: 6f 6e 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 6f  on on the list o
06c0: 66 20 74 68 65 6d 20 61 6c 6c 20 2a 2f 0a 7d 3b  f them all */.};
06d0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 72 65 20 69 73  ../*.** There is
06e0: 20 6f 6e 65 20 69 6e 73 74 61 6e 63 65 20 6f 66   one instance of
06f0: 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20   this structure 
0700: 66 6f 72 20 65 61 63 68 20 53 51 4c 69 74 65 20  for each SQLite 
0710: 64 61 74 61 62 61 73 65 0a 2a 2a 20 74 68 61 74  database.** that
0720: 20 68 61 73 20 62 65 65 6e 20 6f 70 65 6e 65 64   has been opened
0730: 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 54   by the SQLite T
0740: 43 4c 20 69 6e 74 65 72 66 61 63 65 2e 0a 2a 2f  CL interface..*/
0750: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
0760: 53 71 6c 69 74 65 44 62 20 53 71 6c 69 74 65 44  SqliteDb SqliteD
0770: 62 3b 0a 73 74 72 75 63 74 20 53 71 6c 69 74 65  b;.struct Sqlite
0780: 44 62 20 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64  Db {.  sqlite *d
0790: 62 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  b;           /* 
07a0: 54 68 65 20 22 72 65 61 6c 22 20 64 61 74 61 62  The "real" datab
07b0: 61 73 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f  ase structure */
07c0: 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69  .  Tcl_Interp *i
07d0: 6e 74 65 72 70 3b 20 20 20 2f 2a 20 54 68 65 20  nterp;   /* The 
07e0: 69 6e 74 65 72 70 72 65 74 65 72 20 75 73 65 64  interpreter used
07f0: 20 66 6f 72 20 74 68 69 73 20 64 61 74 61 62 61   for this databa
0800: 73 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 42  se */.  char *zB
0810: 75 73 79 3b 20 20 20 20 20 20 20 20 20 20 2f 2a  usy;          /*
0820: 20 54 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61   The busy callba
0830: 63 6b 20 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20  ck routine */.  
0840: 63 68 61 72 20 2a 7a 43 6f 6d 6d 69 74 3b 20 20  char *zCommit;  
0850: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 6f 6d        /* The com
0860: 6d 69 74 20 68 6f 6f 6b 20 63 61 6c 6c 62 61 63  mit hook callbac
0870: 6b 20 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 63  k routine */.  c
0880: 68 61 72 20 2a 7a 54 72 61 63 65 3b 20 20 20 20  har *zTrace;    
0890: 20 20 20 20 20 2f 2a 20 54 68 65 20 74 72 61 63       /* The trac
08a0: 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69  e callback routi
08b0: 6e 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 50  ne */.  char *zP
08c0: 72 6f 67 72 65 73 73 3b 20 20 20 20 20 20 2f 2a  rogress;      /*
08d0: 20 54 68 65 20 70 72 6f 67 72 65 73 73 20 63 61   The progress ca
08e0: 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20 2a  llback routine *
08f0: 2f 0a 20 20 63 68 61 72 20 2a 7a 41 75 74 68 3b  /.  char *zAuth;
0900: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
0910: 20 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 63   authorization c
0920: 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20  allback routine 
0930: 2a 2f 0a 20 20 53 71 6c 46 75 6e 63 20 2a 70 46  */.  SqlFunc *pF
0940: 75 6e 63 3b 20 20 20 20 20 20 20 2f 2a 20 4c 69  unc;       /* Li
0950: 73 74 20 6f 66 20 53 51 4c 20 66 75 6e 63 74 69  st of SQL functi
0960: 6f 6e 73 20 2a 2f 0a 20 20 53 71 6c 43 6f 6c 6c  ons */.  SqlColl
0970: 61 74 65 20 2a 70 43 6f 6c 6c 61 74 65 3b 20 2f  ate *pCollate; /
0980: 2a 20 4c 69 73 74 20 6f 66 20 53 51 4c 20 63 6f  * List of SQL co
0990: 6c 6c 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e  llation function
09a0: 73 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20  s */.  int rc;  
09b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
09c0: 52 65 74 75 72 6e 20 63 6f 64 65 20 6f 66 20 6d  Return code of m
09d0: 6f 73 74 20 72 65 63 65 6e 74 20 73 71 6c 69 74  ost recent sqlit
09e0: 65 33 5f 65 78 65 63 28 29 20 2a 2f 0a 20 20 54  e3_exec() */.  T
09f0: 63 6c 5f 4f 62 6a 20 2a 70 43 6f 6c 6c 61 74 65  cl_Obj *pCollate
0a00: 4e 65 65 64 65 64 3b 20 20 2f 2a 20 43 6f 6c 6c  Needed;  /* Coll
0a10: 61 74 69 6f 6e 20 6e 65 65 64 65 64 20 73 63 72  ation needed scr
0a20: 69 70 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  ipt */.};../*.**
0a30: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   An instance of 
0a40: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 70  this structure p
0a50: 61 73 73 65 73 20 69 6e 66 6f 72 6d 61 74 69 6f  asses informatio
0a60: 6e 20 74 68 72 75 20 74 68 65 20 73 71 6c 69 74  n thru the sqlit
0a70: 65 0a 2a 2a 20 6c 6f 67 69 63 20 66 72 6f 6d 20  e.** logic from 
0a80: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 54 43 4c  the original TCL
0a90: 20 63 6f 6d 6d 61 6e 64 20 69 6e 74 6f 20 74 68   command into th
0aa0: 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69  e callback routi
0ab0: 6e 65 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73  ne..*/.typedef s
0ac0: 74 72 75 63 74 20 43 61 6c 6c 62 61 63 6b 44 61  truct CallbackDa
0ad0: 74 61 20 43 61 6c 6c 62 61 63 6b 44 61 74 61 3b  ta CallbackData;
0ae0: 0a 73 74 72 75 63 74 20 43 61 6c 6c 62 61 63 6b  .struct Callback
0af0: 44 61 74 61 20 7b 0a 20 20 54 63 6c 5f 49 6e 74  Data {.  Tcl_Int
0b00: 65 72 70 20 2a 69 6e 74 65 72 70 3b 20 20 20 20  erp *interp;    
0b10: 20 20 20 2f 2a 20 54 68 65 20 54 43 4c 20 69 6e     /* The TCL in
0b20: 74 65 72 70 72 65 74 65 72 20 2a 2f 0a 20 20 63  terpreter */.  c
0b30: 68 61 72 20 2a 7a 41 72 72 61 79 3b 20 20 20 20  har *zArray;    
0b40: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
0b50: 61 72 72 61 79 20 69 6e 74 6f 20 77 68 69 63 68  array into which
0b60: 20 64 61 74 61 20 69 73 20 77 72 69 74 74 65 6e   data is written
0b70: 20 2a 2f 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70   */.  Tcl_Obj *p
0b80: 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 20  Code;           
0b90: 2f 2a 20 54 68 65 20 63 6f 64 65 20 74 6f 20 65  /* The code to e
0ba0: 78 65 63 75 74 65 20 66 6f 72 20 65 61 63 68 20  xecute for each 
0bb0: 72 6f 77 20 2a 2f 0a 20 20 69 6e 74 20 6f 6e 63  row */.  int onc
0bc0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
0bd0: 20 20 20 2f 2a 20 53 65 74 20 66 6f 72 20 66 69     /* Set for fi
0be0: 72 73 74 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 6c  rst callback onl
0bf0: 79 20 2a 2f 0a 20 20 69 6e 74 20 74 63 6c 5f 72  y */.  int tcl_r
0c00: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  c;              
0c10: 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20   /* Return code 
0c20: 66 72 6f 6d 20 54 43 4c 20 73 63 72 69 70 74 20  from TCL script 
0c30: 2a 2f 0a 20 20 69 6e 74 20 6e 43 6f 6c 4e 61 6d  */.  int nColNam
0c40: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  e;             /
0c50: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72  * Number of entr
0c60: 69 65 73 20 69 6e 20 74 68 65 20 61 7a 43 6f 6c  ies in the azCol
0c70: 4e 61 6d 65 5b 5d 20 61 72 72 61 79 20 2a 2f 0a  Name[] array */.
0c80: 20 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 4e 61    char **azColNa
0c90: 6d 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 43  me;         /* C
0ca0: 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 74 72 61 6e  olumn names tran
0cb0: 73 6c 61 74 65 64 20 74 6f 20 55 54 46 2d 38 20  slated to UTF-8 
0cc0: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  */.};../*.** Thi
0cd0: 73 20 69 73 20 61 20 73 65 63 6f 6e 64 20 61 6c  s is a second al
0ce0: 74 65 72 6e 61 74 69 76 65 20 63 61 6c 6c 62 61  ternative callba
0cf0: 63 6b 20 66 6f 72 20 64 61 74 61 62 61 73 65 20  ck for database 
0d00: 71 75 65 72 69 65 73 2e 20 20 41 20 74 68 65 0a  queries.  A the.
0d10: 2a 2a 20 66 69 72 73 74 20 63 6f 6c 75 6d 6e 20  ** first column 
0d20: 6f 66 20 74 68 65 20 66 69 72 73 74 20 72 6f 77  of the first row
0d30: 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 69   of the result i
0d40: 73 20 6d 61 64 65 20 74 68 65 20 54 43 4c 20 72  s made the TCL r
0d50: 65 73 75 6c 74 2e 0a 2a 2f 0a 73 74 61 74 69 63  esult..*/.static
0d60: 20 69 6e 74 20 44 62 45 76 61 6c 43 61 6c 6c 62   int DbEvalCallb
0d70: 61 63 6b 33 28 0a 20 20 76 6f 69 64 20 2a 63 6c  ack3(.  void *cl
0d80: 69 65 6e 74 44 61 74 61 2c 20 20 20 20 20 20 2f  ientData,      /
0d90: 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66  * An instance of
0da0: 20 43 61 6c 6c 62 61 63 6b 44 61 74 61 20 2a 2f   CallbackData */
0db0: 0a 20 20 69 6e 74 20 6e 43 6f 6c 2c 20 20 20 20  .  int nCol,    
0dc0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
0dd0: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69  ber of columns i
0de0: 6e 20 74 68 65 20 72 65 73 75 6c 74 20 2a 2f 0a  n the result */.
0df0: 20 20 63 68 61 72 20 2a 2a 20 61 7a 43 6f 6c 2c    char ** azCol,
0e00: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61           /* Data
0e10: 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e   for each column
0e20: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 20 61 7a   */.  char ** az
0e30: 4e 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  N            /* 
0e40: 4e 61 6d 65 20 66 6f 72 20 65 61 63 68 20 63 6f  Name for each co
0e50: 6c 75 6d 6e 20 2a 2f 0a 29 7b 0a 20 20 54 63 6c  lumn */.){.  Tcl
0e60: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 20  _Interp *interp 
0e70: 3d 20 28 54 63 6c 5f 49 6e 74 65 72 70 2a 29 63  = (Tcl_Interp*)c
0e80: 6c 69 65 6e 74 44 61 74 61 3b 0a 20 20 54 63 6c  lientData;.  Tcl
0e90: 5f 4f 62 6a 20 2a 70 45 6c 65 6d 3b 0a 20 20 69  _Obj *pElem;.  i
0ea0: 66 28 20 61 7a 43 6f 6c 3d 3d 30 20 29 20 72 65  f( azCol==0 ) re
0eb0: 74 75 72 6e 20 31 3b 0a 20 20 69 66 28 20 6e 43  turn 1;.  if( nC
0ec0: 6f 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 31  ol==0 ) return 1
0ed0: 3b 0a 23 69 66 64 65 66 20 55 54 46 5f 54 52 41  ;.#ifdef UTF_TRA
0ee0: 4e 53 4c 41 54 49 4f 4e 5f 4e 45 45 44 45 44 0a  NSLATION_NEEDED.
0ef0: 20 20 7b 0a 20 20 20 20 54 63 6c 5f 44 53 74 72    {.    Tcl_DStr
0f00: 69 6e 67 20 64 43 6f 6c 3b 0a 20 20 20 20 54 63  ing dCol;.    Tc
0f10: 6c 5f 44 53 74 72 69 6e 67 49 6e 69 74 28 26 64  l_DStringInit(&d
0f20: 43 6f 6c 29 3b 0a 20 20 20 20 54 63 6c 5f 45 78  Col);.    Tcl_Ex
0f30: 74 65 72 6e 61 6c 54 6f 55 74 66 44 53 74 72 69  ternalToUtfDStri
0f40: 6e 67 28 4e 55 4c 4c 2c 20 61 7a 43 6f 6c 5b 30  ng(NULL, azCol[0
0f50: 5d 2c 20 2d 31 2c 20 26 64 43 6f 6c 29 3b 0a 20  ], -1, &dCol);. 
0f60: 20 20 20 70 45 6c 65 6d 20 3d 20 54 63 6c 5f 4e     pElem = Tcl_N
0f70: 65 77 53 74 72 69 6e 67 4f 62 6a 28 54 63 6c 5f  ewStringObj(Tcl_
0f80: 44 53 74 72 69 6e 67 56 61 6c 75 65 28 26 64 43  DStringValue(&dC
0f90: 6f 6c 29 2c 20 2d 31 29 3b 0a 20 20 20 20 54 63  ol), -1);.    Tc
0fa0: 6c 5f 44 53 74 72 69 6e 67 46 72 65 65 28 26 64  l_DStringFree(&d
0fb0: 43 6f 6c 29 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a  Col);.  }.#else.
0fc0: 20 20 70 45 6c 65 6d 20 3d 20 54 63 6c 5f 4e 65    pElem = Tcl_Ne
0fd0: 77 53 74 72 69 6e 67 4f 62 6a 28 61 7a 43 6f 6c  wStringObj(azCol
0fe0: 5b 30 5d 2c 20 2d 31 29 3b 0a 23 65 6e 64 69 66  [0], -1);.#endif
0ff0: 0a 20 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73  .  Tcl_SetObjRes
1000: 75 6c 74 28 69 6e 74 65 72 70 2c 20 70 45 6c 65  ult(interp, pEle
1010: 6d 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  m);.  return 1;.
1020: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c 65 64 20  }../*.** Called 
1030: 77 68 65 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64  when the command
1040: 20 69 73 20 64 65 6c 65 74 65 64 2e 0a 2a 2f 0a   is deleted..*/.
1050: 73 74 61 74 69 63 20 76 6f 69 64 20 44 62 44 65  static void DbDe
1060: 6c 65 74 65 43 6d 64 28 76 6f 69 64 20 2a 64 62  leteCmd(void *db
1070: 29 7b 0a 20 20 53 71 6c 69 74 65 44 62 20 2a 70  ){.  SqliteDb *p
1080: 44 62 20 3d 20 28 53 71 6c 69 74 65 44 62 2a 29  Db = (SqliteDb*)
1090: 64 62 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 6c  db;.  sqlite3_cl
10a0: 6f 73 65 28 70 44 62 2d 3e 64 62 29 3b 0a 20 20  ose(pDb->db);.  
10b0: 77 68 69 6c 65 28 20 70 44 62 2d 3e 70 46 75 6e  while( pDb->pFun
10c0: 63 20 29 7b 0a 20 20 20 20 53 71 6c 46 75 6e 63  c ){.    SqlFunc
10d0: 20 2a 70 46 75 6e 63 20 3d 20 70 44 62 2d 3e 70   *pFunc = pDb->p
10e0: 46 75 6e 63 3b 0a 20 20 20 20 70 44 62 2d 3e 70  Func;.    pDb->p
10f0: 46 75 6e 63 20 3d 20 70 46 75 6e 63 2d 3e 70 4e  Func = pFunc->pN
1100: 65 78 74 3b 0a 20 20 20 20 54 63 6c 5f 46 72 65  ext;.    Tcl_Fre
1110: 65 28 28 63 68 61 72 2a 29 70 46 75 6e 63 29 3b  e((char*)pFunc);
1120: 0a 20 20 7d 0a 20 20 77 68 69 6c 65 28 20 70 44  .  }.  while( pD
1130: 62 2d 3e 70 43 6f 6c 6c 61 74 65 20 29 7b 0a 20  b->pCollate ){. 
1140: 20 20 20 53 71 6c 43 6f 6c 6c 61 74 65 20 2a 70     SqlCollate *p
1150: 43 6f 6c 6c 61 74 65 20 3d 20 70 44 62 2d 3e 70  Collate = pDb->p
1160: 43 6f 6c 6c 61 74 65 3b 0a 20 20 20 20 70 44 62  Collate;.    pDb
1170: 2d 3e 70 43 6f 6c 6c 61 74 65 20 3d 20 70 43 6f  ->pCollate = pCo
1180: 6c 6c 61 74 65 2d 3e 70 4e 65 78 74 3b 0a 20 20  llate->pNext;.  
1190: 20 20 54 63 6c 5f 46 72 65 65 28 28 63 68 61 72    Tcl_Free((char
11a0: 2a 29 70 43 6f 6c 6c 61 74 65 29 3b 0a 20 20 7d  *)pCollate);.  }
11b0: 0a 20 20 69 66 28 20 70 44 62 2d 3e 7a 42 75 73  .  if( pDb->zBus
11c0: 79 20 29 7b 0a 20 20 20 20 54 63 6c 5f 46 72 65  y ){.    Tcl_Fre
11d0: 65 28 70 44 62 2d 3e 7a 42 75 73 79 29 3b 0a 20  e(pDb->zBusy);. 
11e0: 20 7d 0a 20 20 69 66 28 20 70 44 62 2d 3e 7a 54   }.  if( pDb->zT
11f0: 72 61 63 65 20 29 7b 0a 20 20 20 20 54 63 6c 5f  race ){.    Tcl_
1200: 46 72 65 65 28 70 44 62 2d 3e 7a 54 72 61 63 65  Free(pDb->zTrace
1210: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 44 62  );.  }.  if( pDb
1220: 2d 3e 7a 41 75 74 68 20 29 7b 0a 20 20 20 20 54  ->zAuth ){.    T
1230: 63 6c 5f 46 72 65 65 28 70 44 62 2d 3e 7a 41 75  cl_Free(pDb->zAu
1240: 74 68 29 3b 0a 20 20 7d 0a 20 20 54 63 6c 5f 46  th);.  }.  Tcl_F
1250: 72 65 65 28 28 63 68 61 72 2a 29 70 44 62 29 3b  ree((char*)pDb);
1260: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
1270: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64  outine is called
1280: 20 77 68 65 6e 20 61 20 64 61 74 61 62 61 73 65   when a database
1290: 20 66 69 6c 65 20 69 73 20 6c 6f 63 6b 65 64 20   file is locked 
12a0: 77 68 69 6c 65 20 74 72 79 69 6e 67 0a 2a 2a 20  while trying.** 
12b0: 74 6f 20 65 78 65 63 75 74 65 20 53 51 4c 2e 0a  to execute SQL..
12c0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 44 62  */.static int Db
12d0: 42 75 73 79 48 61 6e 64 6c 65 72 28 76 6f 69 64  BusyHandler(void
12e0: 20 2a 63 64 2c 20 69 6e 74 20 6e 54 72 69 65 73   *cd, int nTries
12f0: 29 7b 0a 20 20 53 71 6c 69 74 65 44 62 20 2a 70  ){.  SqliteDb *p
1300: 44 62 20 3d 20 28 53 71 6c 69 74 65 44 62 2a 29  Db = (SqliteDb*)
1310: 63 64 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  cd;.  int rc;.  
1320: 63 68 61 72 20 7a 56 61 6c 5b 33 30 5d 3b 0a 20  char zVal[30];. 
1330: 20 63 68 61 72 20 2a 7a 43 6d 64 3b 0a 20 20 54   char *zCmd;.  T
1340: 63 6c 5f 44 53 74 72 69 6e 67 20 63 6d 64 3b 0a  cl_DString cmd;.
1350: 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e 67 49 6e  .  Tcl_DStringIn
1360: 69 74 28 26 63 6d 64 29 3b 0a 20 20 54 63 6c 5f  it(&cmd);.  Tcl_
1370: 44 53 74 72 69 6e 67 41 70 70 65 6e 64 28 26 63  DStringAppend(&c
1380: 6d 64 2c 20 70 44 62 2d 3e 7a 42 75 73 79 2c 20  md, pDb->zBusy, 
1390: 2d 31 29 3b 0a 20 20 73 70 72 69 6e 74 66 28 7a  -1);.  sprintf(z
13a0: 56 61 6c 2c 20 22 25 64 22 2c 20 6e 54 72 69 65  Val, "%d", nTrie
13b0: 73 29 3b 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e  s);.  Tcl_DStrin
13c0: 67 41 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 26  gAppendElement(&
13d0: 63 6d 64 2c 20 7a 56 61 6c 29 3b 0a 20 20 7a 43  cmd, zVal);.  zC
13e0: 6d 64 20 3d 20 54 63 6c 5f 44 53 74 72 69 6e 67  md = Tcl_DString
13f0: 56 61 6c 75 65 28 26 63 6d 64 29 3b 0a 20 20 72  Value(&cmd);.  r
1400: 63 20 3d 20 54 63 6c 5f 45 76 61 6c 28 70 44 62  c = Tcl_Eval(pDb
1410: 2d 3e 69 6e 74 65 72 70 2c 20 7a 43 6d 64 29 3b  ->interp, zCmd);
1420: 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e 67 46 72  .  Tcl_DStringFr
1430: 65 65 28 26 63 6d 64 29 3b 0a 20 20 69 66 28 20  ee(&cmd);.  if( 
1440: 72 63 21 3d 54 43 4c 5f 4f 4b 20 7c 7c 20 61 74  rc!=TCL_OK || at
1450: 6f 69 28 54 63 6c 5f 47 65 74 53 74 72 69 6e 67  oi(Tcl_GetString
1460: 52 65 73 75 6c 74 28 70 44 62 2d 3e 69 6e 74 65  Result(pDb->inte
1470: 72 70 29 29 20 29 7b 0a 20 20 20 20 72 65 74 75  rp)) ){.    retu
1480: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75  rn 0;.  }.  retu
1490: 72 6e 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  rn 1;.}../*.** T
14a0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 69  his routine is i
14b0: 6e 76 6f 6b 65 64 20 61 73 20 74 68 65 20 27 70  nvoked as the 'p
14c0: 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b  rogress callback
14d0: 27 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61  ' for the databa
14e0: 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  se..*/.static in
14f0: 74 20 44 62 50 72 6f 67 72 65 73 73 48 61 6e 64  t DbProgressHand
1500: 6c 65 72 28 76 6f 69 64 20 2a 63 64 29 7b 0a 20  ler(void *cd){. 
1510: 20 53 71 6c 69 74 65 44 62 20 2a 70 44 62 20 3d   SqliteDb *pDb =
1520: 20 28 53 71 6c 69 74 65 44 62 2a 29 63 64 3b 0a   (SqliteDb*)cd;.
1530: 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73    int rc;..  ass
1540: 65 72 74 28 20 70 44 62 2d 3e 7a 50 72 6f 67 72  ert( pDb->zProgr
1550: 65 73 73 20 29 3b 0a 20 20 72 63 20 3d 20 54 63  ess );.  rc = Tc
1560: 6c 5f 45 76 61 6c 28 70 44 62 2d 3e 69 6e 74 65  l_Eval(pDb->inte
1570: 72 70 2c 20 70 44 62 2d 3e 7a 50 72 6f 67 72 65  rp, pDb->zProgre
1580: 73 73 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 54  ss);.  if( rc!=T
1590: 43 4c 5f 4f 4b 20 7c 7c 20 61 74 6f 69 28 54 63  CL_OK || atoi(Tc
15a0: 6c 5f 47 65 74 53 74 72 69 6e 67 52 65 73 75 6c  l_GetStringResul
15b0: 74 28 70 44 62 2d 3e 69 6e 74 65 72 70 29 29 20  t(pDb->interp)) 
15c0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b  ){.    return 1;
15d0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b  .  }.  return 0;
15e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
15f0: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64  outine is called
1600: 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 74   by the SQLite t
1610: 72 61 63 65 20 68 61 6e 64 6c 65 72 20 77 68 65  race handler whe
1620: 6e 65 76 65 72 20 61 20 6e 65 77 0a 2a 2a 20 62  never a new.** b
1630: 6c 6f 63 6b 20 6f 66 20 53 51 4c 20 69 73 20 65  lock of SQL is e
1640: 78 65 63 75 74 65 64 2e 20 20 54 68 65 20 54 43  xecuted.  The TC
1650: 4c 20 73 63 72 69 70 74 20 69 6e 20 70 44 62 2d  L script in pDb-
1660: 3e 7a 54 72 61 63 65 20 69 73 20 65 78 65 63 75  >zTrace is execu
1670: 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ted..*/.static v
1680: 6f 69 64 20 44 62 54 72 61 63 65 48 61 6e 64 6c  oid DbTraceHandl
1690: 65 72 28 76 6f 69 64 20 2a 63 64 2c 20 63 6f 6e  er(void *cd, con
16a0: 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 29 7b 0a  st char *zSql){.
16b0: 20 20 53 71 6c 69 74 65 44 62 20 2a 70 44 62 20    SqliteDb *pDb 
16c0: 3d 20 28 53 71 6c 69 74 65 44 62 2a 29 63 64 3b  = (SqliteDb*)cd;
16d0: 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e 67 20 73  .  Tcl_DString s
16e0: 74 72 3b 0a 0a 20 20 54 63 6c 5f 44 53 74 72 69  tr;..  Tcl_DStri
16f0: 6e 67 49 6e 69 74 28 26 73 74 72 29 3b 0a 20 20  ngInit(&str);.  
1700: 54 63 6c 5f 44 53 74 72 69 6e 67 41 70 70 65 6e  Tcl_DStringAppen
1710: 64 28 26 73 74 72 2c 20 70 44 62 2d 3e 7a 54 72  d(&str, pDb->zTr
1720: 61 63 65 2c 20 2d 31 29 3b 0a 20 20 54 63 6c 5f  ace, -1);.  Tcl_
1730: 44 53 74 72 69 6e 67 41 70 70 65 6e 64 45 6c 65  DStringAppendEle
1740: 6d 65 6e 74 28 26 73 74 72 2c 20 7a 53 71 6c 29  ment(&str, zSql)
1750: 3b 0a 20 20 54 63 6c 5f 45 76 61 6c 28 70 44 62  ;.  Tcl_Eval(pDb
1760: 2d 3e 69 6e 74 65 72 70 2c 20 54 63 6c 5f 44 53  ->interp, Tcl_DS
1770: 74 72 69 6e 67 56 61 6c 75 65 28 26 73 74 72 29  tringValue(&str)
1780: 29 3b 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e 67  );.  Tcl_DString
1790: 46 72 65 65 28 26 73 74 72 29 3b 0a 20 20 54 63  Free(&str);.  Tc
17a0: 6c 5f 52 65 73 65 74 52 65 73 75 6c 74 28 70 44  l_ResetResult(pD
17b0: 62 2d 3e 69 6e 74 65 72 70 29 3b 0a 7d 0a 0a 2f  b->interp);.}../
17c0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
17d0: 65 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e  e is called when
17e0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
17f0: 73 20 63 6f 6d 6d 69 74 74 65 64 2e 20 20 54 68  s committed.  Th
1800: 65 0a 2a 2a 20 54 43 4c 20 73 63 72 69 70 74 20  e.** TCL script 
1810: 69 6e 20 70 44 62 2d 3e 7a 43 6f 6d 6d 69 74 20  in pDb->zCommit 
1820: 69 73 20 65 78 65 63 75 74 65 64 2e 20 20 49 66  is executed.  If
1830: 20 69 74 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d   it returns non-
1840: 7a 65 72 6f 20 6f 72 0a 2a 2a 20 69 66 20 69 74  zero or.** if it
1850: 20 74 68 72 6f 77 73 20 61 6e 20 65 78 63 65 70   throws an excep
1860: 74 69 6f 6e 2c 20 74 68 65 20 74 72 61 6e 73 61  tion, the transa
1870: 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c 65 64 20  ction is rolled 
1880: 62 61 63 6b 20 69 6e 73 74 65 61 64 0a 2a 2a 20  back instead.** 
1890: 6f 66 20 62 65 69 6e 67 20 63 6f 6d 6d 69 74 74  of being committ
18a0: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ed..*/.static in
18b0: 74 20 44 62 43 6f 6d 6d 69 74 48 61 6e 64 6c 65  t DbCommitHandle
18c0: 72 28 76 6f 69 64 20 2a 63 64 29 7b 0a 20 20 53  r(void *cd){.  S
18d0: 71 6c 69 74 65 44 62 20 2a 70 44 62 20 3d 20 28  qliteDb *pDb = (
18e0: 53 71 6c 69 74 65 44 62 2a 29 63 64 3b 0a 20 20  SqliteDb*)cd;.  
18f0: 69 6e 74 20 72 63 3b 0a 0a 20 20 72 63 20 3d 20  int rc;..  rc = 
1900: 54 63 6c 5f 45 76 61 6c 28 70 44 62 2d 3e 69 6e  Tcl_Eval(pDb->in
1910: 74 65 72 70 2c 20 70 44 62 2d 3e 7a 43 6f 6d 6d  terp, pDb->zComm
1920: 69 74 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 54  it);.  if( rc!=T
1930: 43 4c 5f 4f 4b 20 7c 7c 20 61 74 6f 69 28 54 63  CL_OK || atoi(Tc
1940: 6c 5f 47 65 74 53 74 72 69 6e 67 52 65 73 75 6c  l_GetStringResul
1950: 74 28 70 44 62 2d 3e 69 6e 74 65 72 70 29 29 20  t(pDb->interp)) 
1960: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b  ){.    return 1;
1970: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b  .  }.  return 0;
1980: 0a 7d 0a 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .}..static void 
1990: 74 63 6c 43 6f 6c 6c 61 74 65 4e 65 65 64 65 64  tclCollateNeeded
19a0: 28 0a 20 20 76 6f 69 64 20 2a 70 43 74 78 2c 0a  (.  void *pCtx,.
19b0: 20 20 73 71 6c 69 74 65 20 2a 64 62 2c 0a 20 20    sqlite *db,.  
19c0: 69 6e 74 20 65 6e 63 2c 0a 20 20 63 6f 6e 73 74  int enc,.  const
19d0: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 0a 29 7b 0a   char *zName.){.
19e0: 20 20 53 71 6c 69 74 65 44 62 20 2a 70 44 62 20    SqliteDb *pDb 
19f0: 3d 20 28 53 71 6c 69 74 65 44 62 20 2a 29 70 43  = (SqliteDb *)pC
1a00: 74 78 3b 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70  tx;.  Tcl_Obj *p
1a10: 53 63 72 69 70 74 20 3d 20 54 63 6c 5f 44 75 70  Script = Tcl_Dup
1a20: 6c 69 63 61 74 65 4f 62 6a 28 70 44 62 2d 3e 70  licateObj(pDb->p
1a30: 43 6f 6c 6c 61 74 65 4e 65 65 64 65 64 29 3b 0a  CollateNeeded);.
1a40: 20 20 54 63 6c 5f 49 6e 63 72 52 65 66 43 6f 75    Tcl_IncrRefCou
1a50: 6e 74 28 70 53 63 72 69 70 74 29 3b 0a 20 20 54  nt(pScript);.  T
1a60: 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65 6e 64  cl_ListObjAppend
1a70: 45 6c 65 6d 65 6e 74 28 30 2c 20 70 53 63 72 69  Element(0, pScri
1a80: 70 74 2c 20 54 63 6c 5f 4e 65 77 53 74 72 69 6e  pt, Tcl_NewStrin
1a90: 67 4f 62 6a 28 7a 4e 61 6d 65 2c 20 2d 31 29 29  gObj(zName, -1))
1aa0: 3b 0a 20 20 54 63 6c 5f 45 76 61 6c 4f 62 6a 45  ;.  Tcl_EvalObjE
1ab0: 78 28 70 44 62 2d 3e 69 6e 74 65 72 70 2c 20 70  x(pDb->interp, p
1ac0: 53 63 72 69 70 74 2c 20 30 29 3b 0a 20 20 54 63  Script, 0);.  Tc
1ad0: 6c 5f 44 65 63 72 52 65 66 43 6f 75 6e 74 28 70  l_DecrRefCount(p
1ae0: 53 63 72 69 70 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  Script);.}../*.*
1af0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
1b00: 73 20 63 61 6c 6c 65 64 20 74 6f 20 65 76 61 6c  s called to eval
1b10: 75 61 74 65 20 61 6e 20 53 51 4c 20 63 6f 6c 6c  uate an SQL coll
1b20: 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 69  ation function i
1b30: 6d 70 6c 65 6d 65 6e 74 65 64 0a 2a 2a 20 75 73  mplemented.** us
1b40: 69 6e 67 20 54 43 4c 20 73 63 72 69 70 74 2e 0a  ing TCL script..
1b50: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 74 63  */.static int tc
1b60: 6c 53 71 6c 43 6f 6c 6c 61 74 65 28 0a 20 20 76  lSqlCollate(.  v
1b70: 6f 69 64 20 2a 70 43 74 78 2c 0a 20 20 69 6e 74  oid *pCtx,.  int
1b80: 20 6e 41 2c 0a 20 20 63 6f 6e 73 74 20 76 6f 69   nA,.  const voi
1b90: 64 20 2a 7a 41 2c 0a 20 20 69 6e 74 20 6e 42 2c  d *zA,.  int nB,
1ba0: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a  .  const void *z
1bb0: 42 0a 29 7b 0a 20 20 53 71 6c 43 6f 6c 6c 61 74  B.){.  SqlCollat
1bc0: 65 20 2a 70 20 3d 20 28 53 71 6c 43 6f 6c 6c 61  e *p = (SqlColla
1bd0: 74 65 20 2a 29 70 43 74 78 3b 0a 20 20 54 63 6c  te *)pCtx;.  Tcl
1be0: 5f 4f 62 6a 20 2a 70 43 6d 64 3b 0a 0a 20 20 70  _Obj *pCmd;..  p
1bf0: 43 6d 64 20 3d 20 54 63 6c 5f 4e 65 77 53 74 72  Cmd = Tcl_NewStr
1c00: 69 6e 67 4f 62 6a 28 70 2d 3e 7a 53 63 72 69 70  ingObj(p->zScrip
1c10: 74 2c 20 2d 31 29 3b 0a 20 20 54 63 6c 5f 49 6e  t, -1);.  Tcl_In
1c20: 63 72 52 65 66 43 6f 75 6e 74 28 70 43 6d 64 29  crRefCount(pCmd)
1c30: 3b 0a 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41  ;.  Tcl_ListObjA
1c40: 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 70 2d 3e  ppendElement(p->
1c50: 69 6e 74 65 72 70 2c 20 70 43 6d 64 2c 20 54 63  interp, pCmd, Tc
1c60: 6c 5f 4e 65 77 53 74 72 69 6e 67 4f 62 6a 28 7a  l_NewStringObj(z
1c70: 41 2c 20 6e 41 29 29 3b 0a 20 20 54 63 6c 5f 4c  A, nA));.  Tcl_L
1c80: 69 73 74 4f 62 6a 41 70 70 65 6e 64 45 6c 65 6d  istObjAppendElem
1c90: 65 6e 74 28 70 2d 3e 69 6e 74 65 72 70 2c 20 70  ent(p->interp, p
1ca0: 43 6d 64 2c 20 54 63 6c 5f 4e 65 77 53 74 72 69  Cmd, Tcl_NewStri
1cb0: 6e 67 4f 62 6a 28 7a 42 2c 20 6e 42 29 29 3b 0a  ngObj(zB, nB));.
1cc0: 20 20 54 63 6c 5f 45 76 61 6c 4f 62 6a 45 78 28    Tcl_EvalObjEx(
1cd0: 70 2d 3e 69 6e 74 65 72 70 2c 20 70 43 6d 64 2c  p->interp, pCmd,
1ce0: 20 30 29 3b 0a 20 20 54 63 6c 5f 44 65 63 72 52   0);.  Tcl_DecrR
1cf0: 65 66 43 6f 75 6e 74 28 70 43 6d 64 29 3b 0a 20  efCount(pCmd);. 
1d00: 20 72 65 74 75 72 6e 20 28 61 74 6f 69 28 54 63   return (atoi(Tc
1d10: 6c 5f 47 65 74 53 74 72 69 6e 67 52 65 73 75 6c  l_GetStringResul
1d20: 74 28 70 2d 3e 69 6e 74 65 72 70 29 29 29 3b 0a  t(p->interp)));.
1d30: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  }../*.** This ro
1d40: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20  utine is called 
1d50: 74 6f 20 65 76 61 6c 75 61 74 65 20 61 6e 20 53  to evaluate an S
1d60: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 6d 70 6c  QL function impl
1d70: 65 6d 65 6e 74 65 64 0a 2a 2a 20 75 73 69 6e 67  emented.** using
1d80: 20 54 43 4c 20 73 63 72 69 70 74 2e 0a 2a 2f 0a   TCL script..*/.
1d90: 73 74 61 74 69 63 20 76 6f 69 64 20 74 63 6c 53  static void tclS
1da0: 71 6c 46 75 6e 63 28 73 71 6c 69 74 65 33 5f 63  qlFunc(sqlite3_c
1db0: 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c  ontext *context,
1dc0: 20 69 6e 74 20 61 72 67 63 2c 20 73 71 6c 69 74   int argc, sqlit
1dd0: 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 29  e3_value **argv)
1de0: 7b 0a 20 20 53 71 6c 46 75 6e 63 20 2a 70 20 3d  {.  SqlFunc *p =
1df0: 20 73 71 6c 69 74 65 33 5f 75 73 65 72 5f 64 61   sqlite3_user_da
1e00: 74 61 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 54  ta(context);.  T
1e10: 63 6c 5f 44 53 74 72 69 6e 67 20 63 6d 64 3b 0a  cl_DString cmd;.
1e20: 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 72    int i;.  int r
1e30: 63 3b 0a 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e  c;..  Tcl_DStrin
1e40: 67 49 6e 69 74 28 26 63 6d 64 29 3b 0a 20 20 54  gInit(&cmd);.  T
1e50: 63 6c 5f 44 53 74 72 69 6e 67 41 70 70 65 6e 64  cl_DStringAppend
1e60: 28 26 63 6d 64 2c 20 70 2d 3e 7a 53 63 72 69 70  (&cmd, p->zScrip
1e70: 74 2c 20 2d 31 29 3b 0a 20 20 66 6f 72 28 69 3d  t, -1);.  for(i=
1e80: 30 3b 20 69 3c 61 72 67 63 3b 20 69 2b 2b 29 7b  0; i<argc; i++){
1e90: 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f  .    if( SQLITE_
1ea0: 4e 55 4c 4c 3d 3d 73 71 6c 69 74 65 33 5f 76 61  NULL==sqlite3_va
1eb0: 6c 75 65 5f 74 79 70 65 28 61 72 67 76 5b 69 5d  lue_type(argv[i]
1ec0: 29 20 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f 44  ) ){.      Tcl_D
1ed0: 53 74 72 69 6e 67 41 70 70 65 6e 64 45 6c 65 6d  StringAppendElem
1ee0: 65 6e 74 28 26 63 6d 64 2c 20 22 22 29 3b 0a 20  ent(&cmd, "");. 
1ef0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
1f00: 54 63 6c 5f 44 53 74 72 69 6e 67 41 70 70 65 6e  Tcl_DStringAppen
1f10: 64 45 6c 65 6d 65 6e 74 28 26 63 6d 64 2c 20 73  dElement(&cmd, s
1f20: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
1f30: 74 28 61 72 67 76 5b 69 5d 29 29 3b 0a 20 20 20  t(argv[i]));.   
1f40: 20 7d 0a 20 20 7d 0a 20 20 72 63 20 3d 20 54 63   }.  }.  rc = Tc
1f50: 6c 5f 45 76 61 6c 28 70 2d 3e 69 6e 74 65 72 70  l_Eval(p->interp
1f60: 2c 20 54 63 6c 5f 44 53 74 72 69 6e 67 56 61 6c  , Tcl_DStringVal
1f70: 75 65 28 26 63 6d 64 29 29 3b 0a 20 20 69 66 28  ue(&cmd));.  if(
1f80: 20 72 63 20 29 7b 0a 20 20 20 20 73 71 6c 69 74   rc ){.    sqlit
1f90: 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28  e3_result_error(
1fa0: 63 6f 6e 74 65 78 74 2c 20 54 63 6c 5f 47 65 74  context, Tcl_Get
1fb0: 53 74 72 69 6e 67 52 65 73 75 6c 74 28 70 2d 3e  StringResult(p->
1fc0: 69 6e 74 65 72 70 29 2c 20 2d 31 29 3b 20 0a 20  interp), -1); . 
1fd0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69   }else{.    sqli
1fe0: 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28  te3_result_text(
1ff0: 63 6f 6e 74 65 78 74 2c 20 54 63 6c 5f 47 65 74  context, Tcl_Get
2000: 53 74 72 69 6e 67 52 65 73 75 6c 74 28 70 2d 3e  StringResult(p->
2010: 69 6e 74 65 72 70 29 2c 20 2d 31 2c 20 0a 20 20  interp), -1, .  
2020: 20 20 20 20 20 20 53 51 4c 49 54 45 5f 54 52 41        SQLITE_TRA
2030: 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 0a 7d 0a 23  NSIENT);.  }.}.#
2040: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
2050: 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e  IT_AUTHORIZATION
2060: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74  ./*.** This is t
2070: 68 65 20 61 75 74 68 65 6e 74 69 63 61 74 69 6f  he authenticatio
2080: 6e 20 66 75 6e 63 74 69 6f 6e 2e 20 20 49 74 20  n function.  It 
2090: 61 70 70 65 6e 64 73 20 74 68 65 20 61 75 74 68  appends the auth
20a0: 65 6e 74 69 63 61 74 69 6f 6e 0a 2a 2a 20 74 79  entication.** ty
20b0: 70 65 20 63 6f 64 65 20 61 6e 64 20 74 68 65 20  pe code and the 
20c0: 74 77 6f 20 61 72 67 75 6d 65 6e 74 73 20 74 6f  two arguments to
20d0: 20 7a 43 6d 64 5b 5d 20 74 68 65 6e 20 69 6e 76   zCmd[] then inv
20e0: 6f 6b 65 73 20 74 68 65 20 72 65 73 75 6c 74 0a  okes the result.
20f0: 2a 2a 20 6f 6e 20 74 68 65 20 69 6e 74 65 72 70  ** on the interp
2100: 72 65 74 65 72 2e 20 20 54 68 65 20 72 65 70 6c  reter.  The repl
2110: 79 20 69 73 20 65 78 61 6d 69 6e 65 64 20 74 6f  y is examined to
2120: 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 74 68   determine if th
2130: 65 0a 2a 2a 20 61 75 74 68 65 6e 74 69 63 61 74  e.** authenticat
2140: 69 6f 6e 20 66 61 69 6c 73 20 6f 72 20 73 75 63  ion fails or suc
2150: 63 65 65 64 73 2e 0a 2a 2f 0a 73 74 61 74 69 63  ceeds..*/.static
2160: 20 69 6e 74 20 61 75 74 68 5f 63 61 6c 6c 62 61   int auth_callba
2170: 63 6b 28 0a 20 20 76 6f 69 64 20 2a 70 41 72 67  ck(.  void *pArg
2180: 2c 0a 20 20 69 6e 74 20 63 6f 64 65 2c 0a 20 20  ,.  int code,.  
2190: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 41 72 67  const char *zArg
21a0: 31 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  1,.  const char 
21b0: 2a 7a 41 72 67 32 2c 0a 20 20 63 6f 6e 73 74 20  *zArg2,.  const 
21c0: 63 68 61 72 20 2a 7a 41 72 67 33 2c 0a 20 20 63  char *zArg3,.  c
21d0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 41 72 67 34  onst char *zArg4
21e0: 0a 29 7b 0a 20 20 63 68 61 72 20 2a 7a 43 6f 64  .){.  char *zCod
21f0: 65 3b 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e 67  e;.  Tcl_DString
2200: 20 73 74 72 3b 0a 20 20 69 6e 74 20 72 63 3b 0a   str;.  int rc;.
2210: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 52    const char *zR
2220: 65 70 6c 79 3b 0a 20 20 53 71 6c 69 74 65 44 62  eply;.  SqliteDb
2230: 20 2a 70 44 62 20 3d 20 28 53 71 6c 69 74 65 44   *pDb = (SqliteD
2240: 62 2a 29 70 41 72 67 3b 0a 0a 20 20 73 77 69 74  b*)pArg;..  swit
2250: 63 68 28 20 63 6f 64 65 20 29 7b 0a 20 20 20 20  ch( code ){.    
2260: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 50 59  case SQLITE_COPY
2270: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20                : 
2280: 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 43 4f  zCode="SQLITE_CO
2290: 50 59 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20  PY"; break;.    
22a0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 52 45 41  case SQLITE_CREA
22b0: 54 45 5f 49 4e 44 45 58 20 20 20 20 20 20 3a 20  TE_INDEX      : 
22c0: 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 43 52  zCode="SQLITE_CR
22d0: 45 41 54 45 5f 49 4e 44 45 58 22 3b 20 62 72 65  EATE_INDEX"; bre
22e0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
22f0: 49 54 45 5f 43 52 45 41 54 45 5f 54 41 42 4c 45  ITE_CREATE_TABLE
2300: 20 20 20 20 20 20 3a 20 7a 43 6f 64 65 3d 22 53        : zCode="S
2310: 51 4c 49 54 45 5f 43 52 45 41 54 45 5f 54 41 42  QLITE_CREATE_TAB
2320: 4c 45 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20  LE"; break;.    
2330: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 52 45 41  case SQLITE_CREA
2340: 54 45 5f 54 45 4d 50 5f 49 4e 44 45 58 20 3a 20  TE_TEMP_INDEX : 
2350: 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 43 52  zCode="SQLITE_CR
2360: 45 41 54 45 5f 54 45 4d 50 5f 49 4e 44 45 58 22  EATE_TEMP_INDEX"
2370: 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73  ; break;.    cas
2380: 65 20 53 51 4c 49 54 45 5f 43 52 45 41 54 45 5f  e SQLITE_CREATE_
2390: 54 45 4d 50 5f 54 41 42 4c 45 20 3a 20 7a 43 6f  TEMP_TABLE : zCo
23a0: 64 65 3d 22 53 51 4c 49 54 45 5f 43 52 45 41 54  de="SQLITE_CREAT
23b0: 45 5f 54 45 4d 50 5f 54 41 42 4c 45 22 3b 20 62  E_TEMP_TABLE"; b
23c0: 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53  reak;.    case S
23d0: 51 4c 49 54 45 5f 43 52 45 41 54 45 5f 54 45 4d  QLITE_CREATE_TEM
23e0: 50 5f 54 52 49 47 47 45 52 3a 20 7a 43 6f 64 65  P_TRIGGER: zCode
23f0: 3d 22 53 51 4c 49 54 45 5f 43 52 45 41 54 45 5f  ="SQLITE_CREATE_
2400: 54 45 4d 50 5f 54 52 49 47 47 45 52 22 3b 20 62  TEMP_TRIGGER"; b
2410: 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53  reak;.    case S
2420: 51 4c 49 54 45 5f 43 52 45 41 54 45 5f 54 45 4d  QLITE_CREATE_TEM
2430: 50 5f 56 49 45 57 20 20 3a 20 7a 43 6f 64 65 3d  P_VIEW  : zCode=
2440: 22 53 51 4c 49 54 45 5f 43 52 45 41 54 45 5f 54  "SQLITE_CREATE_T
2450: 45 4d 50 5f 56 49 45 57 22 3b 20 62 72 65 61 6b  EMP_VIEW"; break
2460: 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  ;.    case SQLIT
2470: 45 5f 43 52 45 41 54 45 5f 54 52 49 47 47 45 52  E_CREATE_TRIGGER
2480: 20 20 20 20 3a 20 7a 43 6f 64 65 3d 22 53 51 4c      : zCode="SQL
2490: 49 54 45 5f 43 52 45 41 54 45 5f 54 52 49 47 47  ITE_CREATE_TRIGG
24a0: 45 52 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20  ER"; break;.    
24b0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 52 45 41  case SQLITE_CREA
24c0: 54 45 5f 56 49 45 57 20 20 20 20 20 20 20 3a 20  TE_VIEW       : 
24d0: 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 43 52  zCode="SQLITE_CR
24e0: 45 41 54 45 5f 56 49 45 57 22 3b 20 62 72 65 61  EATE_VIEW"; brea
24f0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49  k;.    case SQLI
2500: 54 45 5f 44 45 4c 45 54 45 20 20 20 20 20 20 20  TE_DELETE       
2510: 20 20 20 20 20 3a 20 7a 43 6f 64 65 3d 22 53 51       : zCode="SQ
2520: 4c 49 54 45 5f 44 45 4c 45 54 45 22 3b 20 62 72  LITE_DELETE"; br
2530: 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51  eak;.    case SQ
2540: 4c 49 54 45 5f 44 52 4f 50 5f 49 4e 44 45 58 20  LITE_DROP_INDEX 
2550: 20 20 20 20 20 20 20 3a 20 7a 43 6f 64 65 3d 22         : zCode="
2560: 53 51 4c 49 54 45 5f 44 52 4f 50 5f 49 4e 44 45  SQLITE_DROP_INDE
2570: 58 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 63  X"; break;.    c
2580: 61 73 65 20 53 51 4c 49 54 45 5f 44 52 4f 50 5f  ase SQLITE_DROP_
2590: 54 41 42 4c 45 20 20 20 20 20 20 20 20 3a 20 7a  TABLE        : z
25a0: 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 44 52 4f  Code="SQLITE_DRO
25b0: 50 5f 54 41 42 4c 45 22 3b 20 62 72 65 61 6b 3b  P_TABLE"; break;
25c0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
25d0: 5f 44 52 4f 50 5f 54 45 4d 50 5f 49 4e 44 45 58  _DROP_TEMP_INDEX
25e0: 20 20 20 3a 20 7a 43 6f 64 65 3d 22 53 51 4c 49     : zCode="SQLI
25f0: 54 45 5f 44 52 4f 50 5f 54 45 4d 50 5f 49 4e 44  TE_DROP_TEMP_IND
2600: 45 58 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20  EX"; break;.    
2610: 63 61 73 65 20 53 51 4c 49 54 45 5f 44 52 4f 50  case SQLITE_DROP
2620: 5f 54 45 4d 50 5f 54 41 42 4c 45 20 20 20 3a 20  _TEMP_TABLE   : 
2630: 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 44 52  zCode="SQLITE_DR
2640: 4f 50 5f 54 45 4d 50 5f 54 41 42 4c 45 22 3b 20  OP_TEMP_TABLE"; 
2650: 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20  break;.    case 
2660: 53 51 4c 49 54 45 5f 44 52 4f 50 5f 54 45 4d 50  SQLITE_DROP_TEMP
2670: 5f 54 52 49 47 47 45 52 20 3a 20 7a 43 6f 64 65  _TRIGGER : zCode
2680: 3d 22 53 51 4c 49 54 45 5f 44 52 4f 50 5f 54 45  ="SQLITE_DROP_TE
2690: 4d 50 5f 54 52 49 47 47 45 52 22 3b 20 62 72 65  MP_TRIGGER"; bre
26a0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
26b0: 49 54 45 5f 44 52 4f 50 5f 54 45 4d 50 5f 56 49  ITE_DROP_TEMP_VI
26c0: 45 57 20 20 20 20 3a 20 7a 43 6f 64 65 3d 22 53  EW    : zCode="S
26d0: 51 4c 49 54 45 5f 44 52 4f 50 5f 54 45 4d 50 5f  QLITE_DROP_TEMP_
26e0: 56 49 45 57 22 3b 20 62 72 65 61 6b 3b 0a 20 20  VIEW"; break;.  
26f0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 44 52    case SQLITE_DR
2700: 4f 50 5f 54 52 49 47 47 45 52 20 20 20 20 20 20  OP_TRIGGER      
2710: 3a 20 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f  : zCode="SQLITE_
2720: 44 52 4f 50 5f 54 52 49 47 47 45 52 22 3b 20 62  DROP_TRIGGER"; b
2730: 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53  reak;.    case S
2740: 51 4c 49 54 45 5f 44 52 4f 50 5f 56 49 45 57 20  QLITE_DROP_VIEW 
2750: 20 20 20 20 20 20 20 20 3a 20 7a 43 6f 64 65 3d          : zCode=
2760: 22 53 51 4c 49 54 45 5f 44 52 4f 50 5f 56 49 45  "SQLITE_DROP_VIE
2770: 57 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 63  W"; break;.    c
2780: 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 53 45 52  ase SQLITE_INSER
2790: 54 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 7a  T            : z
27a0: 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 49 4e 53  Code="SQLITE_INS
27b0: 45 52 54 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20  ERT"; break;.   
27c0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 52 41   case SQLITE_PRA
27d0: 47 4d 41 20 20 20 20 20 20 20 20 20 20 20 20 3a  GMA            :
27e0: 20 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 50   zCode="SQLITE_P
27f0: 52 41 47 4d 41 22 3b 20 62 72 65 61 6b 3b 0a 20  RAGMA"; break;. 
2800: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52     case SQLITE_R
2810: 45 41 44 20 20 20 20 20 20 20 20 20 20 20 20 20  EAD             
2820: 20 3a 20 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45   : zCode="SQLITE
2830: 5f 52 45 41 44 22 3b 20 62 72 65 61 6b 3b 0a 20  _READ"; break;. 
2840: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53     case SQLITE_S
2850: 45 4c 45 43 54 20 20 20 20 20 20 20 20 20 20 20  ELECT           
2860: 20 3a 20 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45   : zCode="SQLITE
2870: 5f 53 45 4c 45 43 54 22 3b 20 62 72 65 61 6b 3b  _SELECT"; break;
2880: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
2890: 5f 54 52 41 4e 53 41 43 54 49 4f 4e 20 20 20 20  _TRANSACTION    
28a0: 20 20 20 3a 20 7a 43 6f 64 65 3d 22 53 51 4c 49     : zCode="SQLI
28b0: 54 45 5f 54 52 41 4e 53 41 43 54 49 4f 4e 22 3b  TE_TRANSACTION";
28c0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65   break;.    case
28d0: 20 53 51 4c 49 54 45 5f 55 50 44 41 54 45 20 20   SQLITE_UPDATE  
28e0: 20 20 20 20 20 20 20 20 20 20 3a 20 7a 43 6f 64            : zCod
28f0: 65 3d 22 53 51 4c 49 54 45 5f 55 50 44 41 54 45  e="SQLITE_UPDATE
2900: 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 61  "; break;.    ca
2910: 73 65 20 53 51 4c 49 54 45 5f 41 54 54 41 43 48  se SQLITE_ATTACH
2920: 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 7a 43              : zC
2930: 6f 64 65 3d 22 53 51 4c 49 54 45 5f 41 54 54 41  ode="SQLITE_ATTA
2940: 43 48 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20  CH"; break;.    
2950: 63 61 73 65 20 53 51 4c 49 54 45 5f 44 45 54 41  case SQLITE_DETA
2960: 43 48 20 20 20 20 20 20 20 20 20 20 20 20 3a 20  CH            : 
2970: 7a 43 6f 64 65 3d 22 53 51 4c 49 54 45 5f 44 45  zCode="SQLITE_DE
2980: 54 41 43 48 22 3b 20 62 72 65 61 6b 3b 0a 20 20  TACH"; break;.  
2990: 20 20 64 65 66 61 75 6c 74 20 20 20 20 20 20 20    default       
29a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
29b0: 3a 20 7a 43 6f 64 65 3d 22 3f 3f 3f 3f 22 3b 20  : zCode="????"; 
29c0: 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 54 63 6c  break;.  }.  Tcl
29d0: 5f 44 53 74 72 69 6e 67 49 6e 69 74 28 26 73 74  _DStringInit(&st
29e0: 72 29 3b 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e  r);.  Tcl_DStrin
29f0: 67 41 70 70 65 6e 64 28 26 73 74 72 2c 20 70 44  gAppend(&str, pD
2a00: 62 2d 3e 7a 41 75 74 68 2c 20 2d 31 29 3b 0a 20  b->zAuth, -1);. 
2a10: 20 54 63 6c 5f 44 53 74 72 69 6e 67 41 70 70 65   Tcl_DStringAppe
2a20: 6e 64 45 6c 65 6d 65 6e 74 28 26 73 74 72 2c 20  ndElement(&str, 
2a30: 7a 43 6f 64 65 29 3b 0a 20 20 54 63 6c 5f 44 53  zCode);.  Tcl_DS
2a40: 74 72 69 6e 67 41 70 70 65 6e 64 45 6c 65 6d 65  tringAppendEleme
2a50: 6e 74 28 26 73 74 72 2c 20 7a 41 72 67 31 20 3f  nt(&str, zArg1 ?
2a60: 20 7a 41 72 67 31 20 3a 20 22 22 29 3b 0a 20 20   zArg1 : "");.  
2a70: 54 63 6c 5f 44 53 74 72 69 6e 67 41 70 70 65 6e  Tcl_DStringAppen
2a80: 64 45 6c 65 6d 65 6e 74 28 26 73 74 72 2c 20 7a  dElement(&str, z
2a90: 41 72 67 32 20 3f 20 7a 41 72 67 32 20 3a 20 22  Arg2 ? zArg2 : "
2aa0: 22 29 3b 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e  ");.  Tcl_DStrin
2ab0: 67 41 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 26  gAppendElement(&
2ac0: 73 74 72 2c 20 7a 41 72 67 33 20 3f 20 7a 41 72  str, zArg3 ? zAr
2ad0: 67 33 20 3a 20 22 22 29 3b 0a 20 20 54 63 6c 5f  g3 : "");.  Tcl_
2ae0: 44 53 74 72 69 6e 67 41 70 70 65 6e 64 45 6c 65  DStringAppendEle
2af0: 6d 65 6e 74 28 26 73 74 72 2c 20 7a 41 72 67 34  ment(&str, zArg4
2b00: 20 3f 20 7a 41 72 67 34 20 3a 20 22 22 29 3b 0a   ? zArg4 : "");.
2b10: 20 20 72 63 20 3d 20 54 63 6c 5f 47 6c 6f 62 61    rc = Tcl_Globa
2b20: 6c 45 76 61 6c 28 70 44 62 2d 3e 69 6e 74 65 72  lEval(pDb->inter
2b30: 70 2c 20 54 63 6c 5f 44 53 74 72 69 6e 67 56 61  p, Tcl_DStringVa
2b40: 6c 75 65 28 26 73 74 72 29 29 3b 0a 20 20 54 63  lue(&str));.  Tc
2b50: 6c 5f 44 53 74 72 69 6e 67 46 72 65 65 28 26 73  l_DStringFree(&s
2b60: 74 72 29 3b 0a 20 20 7a 52 65 70 6c 79 20 3d 20  tr);.  zReply = 
2b70: 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 52 65 73  Tcl_GetStringRes
2b80: 75 6c 74 28 70 44 62 2d 3e 69 6e 74 65 72 70 29  ult(pDb->interp)
2b90: 3b 0a 20 20 69 66 28 20 73 74 72 63 6d 70 28 7a  ;.  if( strcmp(z
2ba0: 52 65 70 6c 79 2c 22 53 51 4c 49 54 45 5f 4f 4b  Reply,"SQLITE_OK
2bb0: 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20  ")==0 ){.    rc 
2bc0: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  = SQLITE_OK;.  }
2bd0: 65 6c 73 65 20 69 66 28 20 73 74 72 63 6d 70 28  else if( strcmp(
2be0: 7a 52 65 70 6c 79 2c 22 53 51 4c 49 54 45 5f 44  zReply,"SQLITE_D
2bf0: 45 4e 59 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20  ENY")==0 ){.    
2c00: 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 45 4e 59  rc = SQLITE_DENY
2c10: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 73 74  ;.  }else if( st
2c20: 72 63 6d 70 28 7a 52 65 70 6c 79 2c 22 53 51 4c  rcmp(zReply,"SQL
2c30: 49 54 45 5f 49 47 4e 4f 52 45 22 29 3d 3d 30 20  ITE_IGNORE")==0 
2c40: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
2c50: 54 45 5f 49 47 4e 4f 52 45 3b 0a 20 20 7d 65 6c  TE_IGNORE;.  }el
2c60: 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 39 39 39  se{.    rc = 999
2c70: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
2c80: 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53  c;.}.#endif /* S
2c90: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f  QLITE_OMIT_AUTHO
2ca0: 52 49 5a 41 54 49 4f 4e 20 2a 2f 0a 0a 2f 2a 0a  RIZATION */../*.
2cb0: 2a 2a 20 7a 54 65 78 74 20 69 73 20 61 20 70 6f  ** zText is a po
2cc0: 69 6e 74 65 72 20 74 6f 20 74 65 78 74 20 6f 62  inter to text ob
2cd0: 74 61 69 6e 65 64 20 76 69 61 20 61 6e 20 73 71  tained via an sq
2ce0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78  lite3_result_tex
2cf0: 74 28 29 0a 2a 2a 20 6f 72 20 73 69 6d 69 6c 61  t().** or simila
2d00: 72 20 69 6e 74 65 72 66 61 63 65 2e 20 54 68 69  r interface. Thi
2d10: 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 6e  s routine return
2d20: 73 20 61 20 54 63 6c 20 73 74 72 69 6e 67 20 6f  s a Tcl string o
2d30: 62 6a 65 63 74 2c 20 0a 2a 2a 20 72 65 66 65 72  bject, .** refer
2d40: 65 6e 63 65 20 63 6f 75 6e 74 20 73 65 74 20 74  ence count set t
2d50: 6f 20 30 2c 20 63 6f 6e 74 61 69 6e 69 6e 67 20  o 0, containing 
2d60: 74 68 65 20 74 65 78 74 2e 20 49 66 20 61 20 74  the text. If a t
2d70: 72 61 6e 73 6c 61 74 69 6f 6e 0a 2a 2a 20 62 65  ranslation.** be
2d80: 74 77 65 65 6e 20 69 73 6f 38 38 35 39 20 61 6e  tween iso8859 an
2d90: 64 20 55 54 46 2d 38 20 69 73 20 72 65 71 75 69  d UTF-8 is requi
2da0: 72 65 64 2c 20 69 74 20 69 73 20 70 72 65 66 6f  red, it is prefo
2db0: 72 6d 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  rmed..*/.static 
2dc0: 54 63 6c 5f 4f 62 6a 20 2a 64 62 54 65 78 74 54  Tcl_Obj *dbTextT
2dd0: 6f 4f 62 6a 28 63 68 61 72 20 63 6f 6e 73 74 20  oObj(char const 
2de0: 2a 7a 54 65 78 74 29 7b 0a 20 20 54 63 6c 5f 4f  *zText){.  Tcl_O
2df0: 62 6a 20 2a 70 56 61 6c 3b 0a 23 69 66 64 65 66  bj *pVal;.#ifdef
2e00: 20 55 54 46 5f 54 52 41 4e 53 4c 41 54 49 4f 4e   UTF_TRANSLATION
2e10: 5f 4e 45 45 44 45 44 0a 20 20 54 63 6c 5f 44 53  _NEEDED.  Tcl_DS
2e20: 74 72 69 6e 67 20 64 43 6f 6c 3b 0a 20 20 54 63  tring dCol;.  Tc
2e30: 6c 5f 44 53 74 72 69 6e 67 49 6e 69 74 28 26 64  l_DStringInit(&d
2e40: 43 6f 6c 29 3b 0a 20 20 54 63 6c 5f 45 78 74 65  Col);.  Tcl_Exte
2e50: 72 6e 61 6c 54 6f 55 74 66 44 53 74 72 69 6e 67  rnalToUtfDString
2e60: 28 4e 55 4c 4c 2c 20 7a 54 65 78 74 2c 20 2d 31  (NULL, zText, -1
2e70: 2c 20 26 64 43 6f 6c 29 3b 0a 20 20 70 56 61 6c  , &dCol);.  pVal
2e80: 20 3d 20 54 63 6c 5f 4e 65 77 53 74 72 69 6e 67   = Tcl_NewString
2e90: 4f 62 6a 28 54 63 6c 5f 44 53 74 72 69 6e 67 56  Obj(Tcl_DStringV
2ea0: 61 6c 75 65 28 26 64 43 6f 6c 29 2c 20 2d 31 29  alue(&dCol), -1)
2eb0: 3b 0a 20 20 54 63 6c 5f 44 53 74 72 69 6e 67 46  ;.  Tcl_DStringF
2ec0: 72 65 65 28 26 64 43 6f 6c 29 3b 0a 23 65 6c 73  ree(&dCol);.#els
2ed0: 65 0a 20 20 70 56 61 6c 20 3d 20 54 63 6c 5f 4e  e.  pVal = Tcl_N
2ee0: 65 77 53 74 72 69 6e 67 4f 62 6a 28 7a 54 65 78  ewStringObj(zTex
2ef0: 74 2c 20 2d 31 29 3b 0a 23 65 6e 64 69 66 0a 20  t, -1);.#endif. 
2f00: 20 72 65 74 75 72 6e 20 70 56 61 6c 3b 0a 7d 0a   return pVal;.}.
2f10: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 22 73 71 6c 69  ./*.** The "sqli
2f20: 74 65 22 20 63 6f 6d 6d 61 6e 64 20 62 65 6c 6f  te" command belo
2f30: 77 20 63 72 65 61 74 65 73 20 61 20 6e 65 77 20  w creates a new 
2f40: 54 63 6c 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20  Tcl command for 
2f50: 65 61 63 68 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69  each.** connecti
2f60: 6f 6e 20 69 74 20 6f 70 65 6e 73 20 74 6f 20 61  on it opens to a
2f70: 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  n SQLite databas
2f80: 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65  e.  This routine
2f90: 20 69 73 20 69 6e 76 6f 6b 65 64 0a 2a 2a 20 77   is invoked.** w
2fa0: 68 65 6e 65 76 65 72 20 6f 6e 65 20 6f 66 20 74  henever one of t
2fb0: 68 6f 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2d  hose connection-
2fc0: 73 70 65 63 69 66 69 63 20 63 6f 6d 6d 61 6e 64  specific command
2fd0: 73 20 69 73 20 65 78 65 63 75 74 65 64 0a 2a 2a  s is executed.**
2fe0: 20 69 6e 20 54 63 6c 2e 20 20 46 6f 72 20 65 78   in Tcl.  For ex
2ff0: 61 6d 70 6c 65 2c 20 69 66 20 79 6f 75 20 72 75  ample, if you ru
3000: 6e 20 54 63 6c 20 63 6f 64 65 20 6c 69 6b 65 20  n Tcl code like 
3010: 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  this:.**.**     
3020: 20 20 73 71 6c 69 74 65 20 64 62 31 20 20 22 6d    sqlite db1  "m
3030: 79 5f 64 61 74 61 62 61 73 65 22 0a 2a 2a 20 20  y_database".**  
3040: 20 20 20 20 20 64 62 31 20 63 6c 6f 73 65 0a 2a       db1 close.*
3050: 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 63  *.** The first c
3060: 6f 6d 6d 61 6e 64 20 6f 70 65 6e 73 20 61 20 63  ommand opens a c
3070: 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65  onnection to the
3080: 20 22 6d 79 5f 64 61 74 61 62 61 73 65 22 20 64   "my_database" d
3090: 61 74 61 62 61 73 65 0a 2a 2a 20 61 6e 64 20 63  atabase.** and c
30a0: 61 6c 6c 73 20 74 68 61 74 20 63 6f 6e 6e 65 63  alls that connec
30b0: 74 69 6f 6e 20 22 64 62 31 22 2e 20 20 54 68 65  tion "db1".  The
30c0: 20 73 65 63 6f 6e 64 20 63 6f 6d 6d 61 6e 64 20   second command 
30d0: 63 61 75 73 65 73 20 74 68 69 73 0a 2a 2a 20 73  causes this.** s
30e0: 75 62 72 6f 75 74 69 6e 65 20 74 6f 20 62 65 20  ubroutine to be 
30f0: 69 6e 76 6f 6b 65 64 2e 0a 2a 2f 0a 73 74 61 74  invoked..*/.stat
3100: 69 63 20 69 6e 74 20 44 62 4f 62 6a 43 6d 64 28  ic int DbObjCmd(
3110: 76 6f 69 64 20 2a 63 64 2c 20 54 63 6c 5f 49 6e  void *cd, Tcl_In
3120: 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 20 69 6e  terp *interp, in
3130: 74 20 6f 62 6a 63 2c 54 63 6c 5f 4f 62 6a 20 2a  t objc,Tcl_Obj *
3140: 63 6f 6e 73 74 2a 6f 62 6a 76 29 7b 0a 20 20 53  const*objv){.  S
3150: 71 6c 69 74 65 44 62 20 2a 70 44 62 20 3d 20 28  qliteDb *pDb = (
3160: 53 71 6c 69 74 65 44 62 2a 29 63 64 3b 0a 20 20  SqliteDb*)cd;.  
3170: 69 6e 74 20 63 68 6f 69 63 65 3b 0a 20 20 69 6e  int choice;.  in
3180: 74 20 72 63 20 3d 20 54 43 4c 5f 4f 4b 3b 0a 20  t rc = TCL_OK;. 
3190: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68   static const ch
31a0: 61 72 20 2a 44 42 5f 73 74 72 73 5b 5d 20 3d 20  ar *DB_strs[] = 
31b0: 7b 0a 20 20 20 20 22 61 75 74 68 6f 72 69 7a 65  {.    "authorize
31c0: 72 22 2c 20 20 20 20 20 20 20 20 20 22 62 75 73  r",         "bus
31d0: 79 22 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  y",             
31e0: 20 22 63 68 61 6e 67 65 73 22 2c 0a 20 20 20 20   "changes",.    
31f0: 22 63 6c 6f 73 65 22 2c 20 20 20 20 20 20 20 20  "close",        
3200: 20 20 20 20 20 20 22 63 6f 6c 6c 61 74 65 22 2c        "collate",
3210: 20 20 20 20 20 20 20 20 20 20 20 22 63 6f 6c 6c             "coll
3220: 61 74 69 6f 6e 5f 6e 65 65 64 65 64 22 2c 0a 20  ation_needed",. 
3230: 20 20 20 22 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 22     "commit_hook"
3240: 2c 20 20 20 20 20 20 20 20 22 63 6f 6d 70 6c 65  ,        "comple
3250: 74 65 22 2c 20 20 20 20 20 20 20 20 20 20 22 65  te",          "e
3260: 72 72 6f 72 63 6f 64 65 22 2c 0a 20 20 20 20 22  rrorcode",.    "
3270: 65 76 61 6c 22 2c 20 20 20 20 20 20 20 20 20 20  eval",          
3280: 20 20 20 20 20 22 66 75 6e 63 74 69 6f 6e 22 2c       "function",
3290: 20 20 20 20 20 20 20 20 20 20 22 6c 61 73 74 5f            "last_
32a0: 69 6e 73 65 72 74 5f 72 6f 77 69 64 22 2c 0a 20  insert_rowid",. 
32b0: 20 20 20 22 6f 6e 65 63 6f 6c 75 6d 6e 22 2c 20     "onecolumn", 
32c0: 20 20 20 20 20 20 20 20 20 22 70 72 6f 67 72 65           "progre
32d0: 73 73 22 2c 20 20 20 20 20 20 20 20 20 20 22 72  ss",          "r
32e0: 65 6b 65 79 22 2c 0a 20 20 20 20 22 74 69 6d 65  ekey",.    "time
32f0: 6f 75 74 22 2c 20 20 20 20 20 20 20 20 20 20 20  out",           
3300: 20 22 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73 22   "total_changes"
3310: 2c 20 20 20 20 20 22 74 72 61 63 65 22 2c 0a 20  ,     "trace",. 
3320: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20     0            
3330: 20 20 20 20 20 20 20 20 0a 20 20 7d 3b 0a 20 20          .  };.  
3340: 65 6e 75 6d 20 44 42 5f 65 6e 75 6d 20 7b 0a 20  enum DB_enum {. 
3350: 20 20 20 44 42 5f 41 55 54 48 4f 52 49 5a 45 52     DB_AUTHORIZER
3360: 2c 20 20 20 20 20 20 20 20 44 42 5f 42 55 53 59  ,        DB_BUSY
3370: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 44 42  ,             DB
3380: 5f 43 48 41 4e 47 45 53 2c 0a 20 20 20 20 44 42  _CHANGES,.    DB
3390: 5f 43 4c 4f 53 45 2c 20 20 20 20 20 20 20 20 20  _CLOSE,         
33a0: 20 20 20 20 44 42 5f 43 4f 4c 4c 41 54 45 2c 20      DB_COLLATE, 
33b0: 20 20 20 20 20 20 20 20 20 44 42 5f 43 4f 4c 4c           DB_COLL
33c0: 41 54 49 4f 4e 5f 4e 45 45 44 45 44 2c 0a 20 20  ATION_NEEDED,.  
33d0: 20 20 44 42 5f 43 4f 4d 4d 49 54 5f 48 4f 4f 4b    DB_COMMIT_HOOK
33e0: 2c 20 20 20 20 20 20 20 44 42 5f 43 4f 4d 50 4c  ,       DB_COMPL
33f0: 45 54 45 2c 20 20 20 20 20 20 20 20 20 44 42 5f  ETE,         DB_
3400: 45 52 52 4f 52 43 4f 44 45 2c 0a 20 20 20 20 44  ERRORCODE,.    D
3410: 42 5f 45 56 41 4c 2c 20 20 20 20 20 20 20 20 20  B_EVAL,         
3420: 20 20 20 20 20 44 42 5f 46 55 4e 43 54 49 4f 4e       DB_FUNCTION
3430: 2c 20 20 20 20 20 20 20 20 20 44 42 5f 4c 41 53  ,         DB_LAS
3440: 54 5f 49 4e 53 45 52 54 5f 52 4f 57 49 44 2c 0a  T_INSERT_ROWID,.
3450: 20 20 20 20 44 42 5f 4f 4e 45 43 4f 4c 55 4d 4e      DB_ONECOLUMN
3460: 2c 20 20 20 20 20 20 20 20 20 44 42 5f 50 52 4f  ,         DB_PRO
3470: 47 52 45 53 53 2c 20 20 20 20 20 20 20 20 20 44  GRESS,         D
3480: 42 5f 52 45 4b 45 59 2c 0a 20 20 20 20 44 42 5f  B_REKEY,.    DB_
3490: 54 49 4d 45 4f 55 54 2c 20 20 20 20 20 20 20 20  TIMEOUT,        
34a0: 20 20 20 44 42 5f 54 4f 54 41 4c 5f 43 48 41 4e     DB_TOTAL_CHAN
34b0: 47 45 53 2c 20 20 20 20 44 42 5f 54 52 41 43 45  GES,    DB_TRACE
34c0: 2c 0a 20 20 7d 3b 0a 0a 20 20 69 66 28 20 6f 62  ,.  };..  if( ob
34d0: 6a 63 3c 32 20 29 7b 0a 20 20 20 20 54 63 6c 5f  jc<2 ){.    Tcl_
34e0: 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74  WrongNumArgs(int
34f0: 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 53  erp, 1, objv, "S
3500: 55 42 43 4f 4d 4d 41 4e 44 20 2e 2e 2e 22 29 3b  UBCOMMAND ...");
3510: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
3520: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28  ERROR;.  }.  if(
3530: 20 54 63 6c 5f 47 65 74 49 6e 64 65 78 46 72 6f   Tcl_GetIndexFro
3540: 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a  mObj(interp, obj
3550: 76 5b 31 5d 2c 20 44 42 5f 73 74 72 73 2c 20 22  v[1], DB_strs, "
3560: 6f 70 74 69 6f 6e 22 2c 20 30 2c 20 26 63 68 6f  option", 0, &cho
3570: 69 63 65 29 20 29 7b 0a 20 20 20 20 72 65 74 75  ice) ){.    retu
3580: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
3590: 7d 0a 0a 20 20 73 77 69 74 63 68 28 20 28 65 6e  }..  switch( (en
35a0: 75 6d 20 44 42 5f 65 6e 75 6d 29 63 68 6f 69 63  um DB_enum)choic
35b0: 65 20 29 7b 0a 0a 20 20 2f 2a 20 20 20 20 24 64  e ){..  /*    $d
35c0: 62 20 61 75 74 68 6f 72 69 7a 65 72 20 3f 43 41  b authorizer ?CA
35d0: 4c 4c 42 41 43 4b 3f 0a 20 20 2a 2a 0a 20 20 2a  LLBACK?.  **.  *
35e0: 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 67 69 76  * Invoke the giv
35f0: 65 6e 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 61  en callback to a
3600: 75 74 68 6f 72 69 7a 65 20 65 61 63 68 20 53 51  uthorize each SQ
3610: 4c 20 6f 70 65 72 61 74 69 6f 6e 20 61 73 20 69  L operation as i
3620: 74 20 69 73 0a 20 20 2a 2a 20 63 6f 6d 70 69 6c  t is.  ** compil
3630: 65 64 2e 20 20 35 20 61 72 67 75 6d 65 6e 74 73  ed.  5 arguments
3640: 20 61 72 65 20 61 70 70 65 6e 64 65 64 20 74 6f   are appended to
3650: 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 62 65   the callback be
3660: 66 6f 72 65 20 69 74 20 69 73 0a 20 20 2a 2a 20  fore it is.  ** 
3670: 69 6e 76 6f 6b 65 64 3a 0a 20 20 2a 2a 0a 20 20  invoked:.  **.  
3680: 2a 2a 20 20 20 28 31 29 20 54 68 65 20 61 75 74  **   (1) The aut
3690: 68 6f 72 69 7a 61 74 69 6f 6e 20 74 79 70 65 20  horization type 
36a0: 28 65 78 3a 20 53 51 4c 49 54 45 5f 43 52 45 41  (ex: SQLITE_CREA
36b0: 54 45 5f 54 41 42 4c 45 2c 20 53 51 4c 49 54 45  TE_TABLE, SQLITE
36c0: 5f 49 4e 53 45 52 54 2c 20 2e 2e 2e 29 0a 20 20  _INSERT, ...).  
36d0: 2a 2a 20 20 20 28 32 29 20 46 69 72 73 74 20 64  **   (2) First d
36e0: 65 73 63 72 69 70 74 69 76 65 20 6e 61 6d 65 20  escriptive name 
36f0: 28 64 65 70 65 6e 64 73 20 6f 6e 20 61 75 74 68  (depends on auth
3700: 6f 72 69 7a 61 74 69 6f 6e 20 74 79 70 65 29 0a  orization type).
3710: 20 20 2a 2a 20 20 20 28 33 29 20 53 65 63 6f 6e    **   (3) Secon
3720: 64 20 64 65 73 63 72 69 70 74 69 76 65 20 6e 61  d descriptive na
3730: 6d 65 0a 20 20 2a 2a 20 20 20 28 34 29 20 4e 61  me.  **   (4) Na
3740: 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  me of the databa
3750: 73 65 20 28 65 78 3a 20 22 6d 61 69 6e 22 2c 20  se (ex: "main", 
3760: 22 74 65 6d 70 22 29 0a 20 20 2a 2a 20 20 20 28  "temp").  **   (
3770: 35 29 20 4e 61 6d 65 20 6f 66 20 74 72 69 67 67  5) Name of trigg
3780: 65 72 20 74 68 61 74 20 69 73 20 64 6f 69 6e 67  er that is doing
3790: 20 74 68 65 20 61 63 63 65 73 73 0a 20 20 2a 2a   the access.  **
37a0: 0a 20 20 2a 2a 20 54 68 65 20 63 61 6c 6c 62 61  .  ** The callba
37b0: 63 6b 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e  ck should return
37c0: 20 6f 6e 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f   on of the follo
37d0: 77 69 6e 67 20 73 74 72 69 6e 67 73 3a 20 53 51  wing strings: SQ
37e0: 4c 49 54 45 5f 4f 4b 2c 0a 20 20 2a 2a 20 53 51  LITE_OK,.  ** SQ
37f0: 4c 49 54 45 5f 49 47 4e 4f 52 45 2c 20 6f 72 20  LITE_IGNORE, or 
3800: 53 51 4c 49 54 45 5f 44 45 4e 59 2e 20 20 41 6e  SQLITE_DENY.  An
3810: 79 20 6f 74 68 65 72 20 72 65 74 75 72 6e 20 76  y other return v
3820: 61 6c 75 65 20 69 73 20 61 6e 20 65 72 72 6f 72  alue is an error
3830: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 74  ..  **.  ** If t
3840: 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 69 6e  his method is in
3850: 76 6f 6b 65 64 20 77 69 74 68 20 6e 6f 20 61 72  voked with no ar
3860: 67 75 6d 65 6e 74 73 2c 20 74 68 65 20 63 75 72  guments, the cur
3870: 72 65 6e 74 20 61 75 74 68 6f 72 69 7a 61 74 69  rent authorizati
3880: 6f 6e 0a 20 20 2a 2a 20 63 61 6c 6c 62 61 63 6b  on.  ** callback
3890: 20 73 74 72 69 6e 67 20 69 73 20 72 65 74 75 72   string is retur
38a0: 6e 65 64 2e 0a 20 20 2a 2f 0a 20 20 63 61 73 65  ned..  */.  case
38b0: 20 44 42 5f 41 55 54 48 4f 52 49 5a 45 52 3a 20   DB_AUTHORIZER: 
38c0: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  {.#ifdef SQLITE_
38d0: 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49  OMIT_AUTHORIZATI
38e0: 4f 4e 0a 20 20 20 20 54 63 6c 5f 41 70 70 65 6e  ON.    Tcl_Appen
38f0: 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20  dResult(interp, 
3900: 22 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 6e  "authorization n
3910: 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20  ot available in 
3920: 74 68 69 73 20 62 75 69 6c 64 22 2c 20 30 29 3b  this build", 0);
3930: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
3940: 45 52 52 4f 52 3b 0a 23 65 6c 73 65 0a 20 20 20  ERROR;.#else.   
3950: 20 69 66 28 20 6f 62 6a 63 3e 33 20 29 7b 0a 20   if( objc>3 ){. 
3960: 20 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75       Tcl_WrongNu
3970: 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20 32 2c  mArgs(interp, 2,
3980: 20 6f 62 6a 76 2c 20 22 3f 43 41 4c 4c 42 41 43   objv, "?CALLBAC
3990: 4b 3f 22 29 3b 0a 20 20 20 20 20 20 72 65 74 75  K?");.      retu
39a0: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
39b0: 20 20 7d 65 6c 73 65 20 69 66 28 20 6f 62 6a 63    }else if( objc
39c0: 3d 3d 32 20 29 7b 0a 20 20 20 20 20 20 69 66 28  ==2 ){.      if(
39d0: 20 70 44 62 2d 3e 7a 41 75 74 68 20 29 7b 0a 20   pDb->zAuth ){. 
39e0: 20 20 20 20 20 20 20 54 63 6c 5f 41 70 70 65 6e         Tcl_Appen
39f0: 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20  dResult(interp, 
3a00: 70 44 62 2d 3e 7a 41 75 74 68 2c 20 30 29 3b 0a  pDb->zAuth, 0);.
3a10: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73        }.    }els
3a20: 65 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 7a  e{.      char *z
3a30: 41 75 74 68 3b 0a 20 20 20 20 20 20 69 6e 74 20  Auth;.      int 
3a40: 6c 65 6e 3b 0a 20 20 20 20 20 20 69 66 28 20 70  len;.      if( p
3a50: 44 62 2d 3e 7a 41 75 74 68 20 29 7b 0a 20 20 20  Db->zAuth ){.   
3a60: 20 20 20 20 20 54 63 6c 5f 46 72 65 65 28 70 44       Tcl_Free(pD
3a70: 62 2d 3e 7a 41 75 74 68 29 3b 0a 20 20 20 20 20  b->zAuth);.     
3a80: 20 7d 0a 20 20 20 20 20 20 7a 41 75 74 68 20 3d   }.      zAuth =
3a90: 20 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 46 72   Tcl_GetStringFr
3aa0: 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 32 5d 2c 20 26  omObj(objv[2], &
3ab0: 6c 65 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20  len);.      if( 
3ac0: 7a 41 75 74 68 20 26 26 20 6c 65 6e 3e 30 20 29  zAuth && len>0 )
3ad0: 7b 0a 20 20 20 20 20 20 20 20 70 44 62 2d 3e 7a  {.        pDb->z
3ae0: 41 75 74 68 20 3d 20 54 63 6c 5f 41 6c 6c 6f 63  Auth = Tcl_Alloc
3af0: 28 20 6c 65 6e 20 2b 20 31 20 29 3b 0a 20 20 20  ( len + 1 );.   
3b00: 20 20 20 20 20 73 74 72 63 70 79 28 70 44 62 2d       strcpy(pDb-
3b10: 3e 7a 41 75 74 68 2c 20 7a 41 75 74 68 29 3b 0a  >zAuth, zAuth);.
3b20: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
3b30: 20 20 20 20 20 70 44 62 2d 3e 7a 41 75 74 68 20       pDb->zAuth 
3b40: 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  = 0;.      }.   
3b50: 20 20 20 69 66 28 20 70 44 62 2d 3e 7a 41 75 74     if( pDb->zAut
3b60: 68 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44 62  h ){.        pDb
3b70: 2d 3e 69 6e 74 65 72 70 20 3d 20 69 6e 74 65 72  ->interp = inter
3b80: 70 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  p;.        sqlit
3b90: 65 33 5f 73 65 74 5f 61 75 74 68 6f 72 69 7a 65  e3_set_authorize
3ba0: 72 28 70 44 62 2d 3e 64 62 2c 20 61 75 74 68 5f  r(pDb->db, auth_
3bb0: 63 61 6c 6c 62 61 63 6b 2c 20 70 44 62 29 3b 0a  callback, pDb);.
3bc0: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
3bd0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 73 65 74       sqlite3_set
3be0: 5f 61 75 74 68 6f 72 69 7a 65 72 28 70 44 62 2d  _authorizer(pDb-
3bf0: 3e 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20  >db, 0, 0);.    
3c00: 20 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66    }.    }.#endif
3c10: 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a  .    break;.  }.
3c20: 0a 20 20 2f 2a 20 20 20 20 24 64 62 20 62 75 73  .  /*    $db bus
3c30: 79 20 3f 43 41 4c 4c 42 41 43 4b 3f 0a 20 20 2a  y ?CALLBACK?.  *
3c40: 2a 0a 20 20 2a 2a 20 49 6e 76 6f 6b 65 20 74 68  *.  ** Invoke th
3c50: 65 20 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b  e given callback
3c60: 20 69 66 20 61 6e 20 53 51 4c 20 73 74 61 74 65   if an SQL state
3c70: 6d 65 6e 74 20 61 74 74 65 6d 70 74 73 20 74 6f  ment attempts to
3c80: 20 6f 70 65 6e 0a 20 20 2a 2a 20 61 20 6c 6f 63   open.  ** a loc
3c90: 6b 65 64 20 64 61 74 61 62 61 73 65 20 66 69 6c  ked database fil
3ca0: 65 2e 0a 20 20 2a 2f 0a 20 20 63 61 73 65 20 44  e..  */.  case D
3cb0: 42 5f 42 55 53 59 3a 20 7b 0a 20 20 20 20 69 66  B_BUSY: {.    if
3cc0: 28 20 6f 62 6a 63 3e 33 20 29 7b 0a 20 20 20 20  ( objc>3 ){.    
3cd0: 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72    Tcl_WrongNumAr
3ce0: 67 73 28 69 6e 74 65 72 70 2c 20 32 2c 20 6f 62  gs(interp, 2, ob
3cf0: 6a 76 2c 20 22 43 41 4c 4c 42 41 43 4b 22 29 3b  jv, "CALLBACK");
3d00: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54 43  .      return TC
3d10: 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 65 6c  L_ERROR;.    }el
3d20: 73 65 20 69 66 28 20 6f 62 6a 63 3d 3d 32 20 29  se if( objc==2 )
3d30: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 44 62 2d  {.      if( pDb-
3d40: 3e 7a 42 75 73 79 20 29 7b 0a 20 20 20 20 20 20  >zBusy ){.      
3d50: 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75    Tcl_AppendResu
3d60: 6c 74 28 69 6e 74 65 72 70 2c 20 70 44 62 2d 3e  lt(interp, pDb->
3d70: 7a 42 75 73 79 2c 20 30 29 3b 0a 20 20 20 20 20  zBusy, 0);.     
3d80: 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20   }.    }else{.  
3d90: 20 20 20 20 63 68 61 72 20 2a 7a 42 75 73 79 3b      char *zBusy;
3da0: 0a 20 20 20 20 20 20 69 6e 74 20 6c 65 6e 3b 0a  .      int len;.
3db0: 20 20 20 20 20 20 69 66 28 20 70 44 62 2d 3e 7a        if( pDb->z
3dc0: 42 75 73 79 20 29 7b 0a 20 20 20 20 20 20 20 20  Busy ){.        
3dd0: 54 63 6c 5f 46 72 65 65 28 70 44 62 2d 3e 7a 42  Tcl_Free(pDb->zB
3de0: 75 73 79 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  usy);.      }.  
3df0: 20 20 20 20 7a 42 75 73 79 20 3d 20 54 63 6c 5f      zBusy = Tcl_
3e00: 47 65 74 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a  GetStringFromObj
3e10: 28 6f 62 6a 76 5b 32 5d 2c 20 26 6c 65 6e 29 3b  (objv[2], &len);
3e20: 0a 20 20 20 20 20 20 69 66 28 20 7a 42 75 73 79  .      if( zBusy
3e30: 20 26 26 20 6c 65 6e 3e 30 20 29 7b 0a 20 20 20   && len>0 ){.   
3e40: 20 20 20 20 20 70 44 62 2d 3e 7a 42 75 73 79 20       pDb->zBusy 
3e50: 3d 20 54 63 6c 5f 41 6c 6c 6f 63 28 20 6c 65 6e  = Tcl_Alloc( len
3e60: 20 2b 20 31 20 29 3b 0a 20 20 20 20 20 20 20 20   + 1 );.        
3e70: 73 74 72 63 70 79 28 70 44 62 2d 3e 7a 42 75 73  strcpy(pDb->zBus
3e80: 79 2c 20 7a 42 75 73 79 29 3b 0a 20 20 20 20 20  y, zBusy);.     
3e90: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
3ea0: 70 44 62 2d 3e 7a 42 75 73 79 20 3d 20 30 3b 0a  pDb->zBusy = 0;.
3eb0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
3ec0: 28 20 70 44 62 2d 3e 7a 42 75 73 79 20 29 7b 0a  ( pDb->zBusy ){.
3ed0: 20 20 20 20 20 20 20 20 70 44 62 2d 3e 69 6e 74          pDb->int
3ee0: 65 72 70 20 3d 20 69 6e 74 65 72 70 3b 0a 20 20  erp = interp;.  
3ef0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 62 75        sqlite3_bu
3f00: 73 79 5f 68 61 6e 64 6c 65 72 28 70 44 62 2d 3e  sy_handler(pDb->
3f10: 64 62 2c 20 44 62 42 75 73 79 48 61 6e 64 6c 65  db, DbBusyHandle
3f20: 72 2c 20 70 44 62 29 3b 0a 20 20 20 20 20 20 7d  r, pDb);.      }
3f30: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71  else{.        sq
3f40: 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c  lite3_busy_handl
3f50: 65 72 28 70 44 62 2d 3e 64 62 2c 20 30 2c 20 30  er(pDb->db, 0, 0
3f60: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  );.      }.    }
3f70: 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a  .    break;.  }.
3f80: 0a 20 20 2f 2a 20 20 20 20 24 64 62 20 70 72 6f  .  /*    $db pro
3f90: 67 72 65 73 73 20 3f 4e 20 43 41 4c 4c 42 41 43  gress ?N CALLBAC
3fa0: 4b 3f 0a 20 20 2a 2a 20 0a 20 20 2a 2a 20 49 6e  K?.  ** .  ** In
3fb0: 76 6f 6b 65 20 74 68 65 20 67 69 76 65 6e 20 63  voke the given c
3fc0: 61 6c 6c 62 61 63 6b 20 65 76 65 72 79 20 4e 20  allback every N 
3fd0: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20  virtual machine 
3fe0: 6f 70 63 6f 64 65 73 20 77 68 69 6c 65 20 65 78  opcodes while ex
3ff0: 65 63 75 74 69 6e 67 0a 20 20 2a 2a 20 71 75 65  ecuting.  ** que
4000: 72 69 65 73 2e 0a 20 20 2a 2f 0a 20 20 63 61 73  ries..  */.  cas
4010: 65 20 44 42 5f 50 52 4f 47 52 45 53 53 3a 20 7b  e DB_PROGRESS: {
4020: 0a 20 20 20 20 69 66 28 20 6f 62 6a 63 3d 3d 32  .    if( objc==2
4030: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 44   ){.      if( pD
4040: 62 2d 3e 7a 50 72 6f 67 72 65 73 73 20 29 7b 0a  b->zProgress ){.
4050: 20 20 20 20 20 20 20 20 54 63 6c 5f 41 70 70 65          Tcl_Appe
4060: 6e 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c  ndResult(interp,
4070: 20 70 44 62 2d 3e 7a 50 72 6f 67 72 65 73 73 2c   pDb->zProgress,
4080: 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20   0);.      }.   
4090: 20 7d 65 6c 73 65 20 69 66 28 20 6f 62 6a 63 3d   }else if( objc=
40a0: 3d 34 20 29 7b 0a 20 20 20 20 20 20 63 68 61 72  =4 ){.      char
40b0: 20 2a 7a 50 72 6f 67 72 65 73 73 3b 0a 20 20 20   *zProgress;.   
40c0: 20 20 20 69 6e 74 20 6c 65 6e 3b 0a 20 20 20 20     int len;.    
40d0: 20 20 69 6e 74 20 4e 3b 0a 20 20 20 20 20 20 69    int N;.      i
40e0: 66 28 20 54 43 4c 5f 4f 4b 21 3d 54 63 6c 5f 47  f( TCL_OK!=Tcl_G
40f0: 65 74 49 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74  etIntFromObj(int
4100: 65 72 70 2c 20 6f 62 6a 76 5b 32 5d 2c 20 26 4e  erp, objv[2], &N
4110: 29 20 29 7b 0a 09 72 65 74 75 72 6e 20 54 43 4c  ) ){..return TCL
4120: 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 7d 3b  _ERROR;.      };
4130: 0a 20 20 20 20 20 20 69 66 28 20 70 44 62 2d 3e  .      if( pDb->
4140: 7a 50 72 6f 67 72 65 73 73 20 29 7b 0a 20 20 20  zProgress ){.   
4150: 20 20 20 20 20 54 63 6c 5f 46 72 65 65 28 70 44       Tcl_Free(pD
4160: 62 2d 3e 7a 50 72 6f 67 72 65 73 73 29 3b 0a 20  b->zProgress);. 
4170: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7a 50 72       }.      zPr
4180: 6f 67 72 65 73 73 20 3d 20 54 63 6c 5f 47 65 74  ogress = Tcl_Get
4190: 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62  StringFromObj(ob
41a0: 6a 76 5b 33 5d 2c 20 26 6c 65 6e 29 3b 0a 20 20  jv[3], &len);.  
41b0: 20 20 20 20 69 66 28 20 7a 50 72 6f 67 72 65 73      if( zProgres
41c0: 73 20 26 26 20 6c 65 6e 3e 30 20 29 7b 0a 20 20  s && len>0 ){.  
41d0: 20 20 20 20 20 20 70 44 62 2d 3e 7a 50 72 6f 67        pDb->zProg
41e0: 72 65 73 73 20 3d 20 54 63 6c 5f 41 6c 6c 6f 63  ress = Tcl_Alloc
41f0: 28 20 6c 65 6e 20 2b 20 31 20 29 3b 0a 20 20 20  ( len + 1 );.   
4200: 20 20 20 20 20 73 74 72 63 70 79 28 70 44 62 2d       strcpy(pDb-
4210: 3e 7a 50 72 6f 67 72 65 73 73 2c 20 7a 50 72 6f  >zProgress, zPro
4220: 67 72 65 73 73 29 3b 0a 20 20 20 20 20 20 7d 65  gress);.      }e
4230: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 44 62  lse{.        pDb
4240: 2d 3e 7a 50 72 6f 67 72 65 73 73 20 3d 20 30 3b  ->zProgress = 0;
4250: 0a 20 20 20 20 20 20 7d 0a 23 69 66 6e 64 65 66  .      }.#ifndef
4260: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f   SQLITE_OMIT_PRO
4270: 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 20  GRESS_CALLBACK. 
4280: 20 20 20 20 20 69 66 28 20 70 44 62 2d 3e 7a 50       if( pDb->zP
4290: 72 6f 67 72 65 73 73 20 29 7b 0a 20 20 20 20 20  rogress ){.     
42a0: 20 20 20 70 44 62 2d 3e 69 6e 74 65 72 70 20 3d     pDb->interp =
42b0: 20 69 6e 74 65 72 70 3b 0a 20 20 20 20 20 20 20   interp;.       
42c0: 20 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73   sqlite3_progres
42d0: 73 5f 68 61 6e 64 6c 65 72 28 70 44 62 2d 3e 64  s_handler(pDb->d
42e0: 62 2c 20 4e 2c 20 44 62 50 72 6f 67 72 65 73 73  b, N, DbProgress
42f0: 48 61 6e 64 6c 65 72 2c 20 70 44 62 29 3b 0a 20  Handler, pDb);. 
4300: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
4310: 20 20 20 20 73 71 6c 69 74 65 33 5f 70 72 6f 67      sqlite3_prog
4320: 72 65 73 73 5f 68 61 6e 64 6c 65 72 28 70 44 62  ress_handler(pDb
4330: 2d 3e 64 62 2c 20 30 2c 20 30 2c 20 30 29 3b 0a  ->db, 0, 0, 0);.
4340: 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20        }.#endif. 
4350: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
4360: 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73  Tcl_WrongNumArgs
4370: 28 69 6e 74 65 72 70 2c 20 32 2c 20 6f 62 6a 76  (interp, 2, objv
4380: 2c 20 22 4e 20 43 41 4c 4c 42 41 43 4b 22 29 3b  , "N CALLBACK");
4390: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54 43  .      return TC
43a0: 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20  L_ERROR;.    }. 
43b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 0a 20     break;.  }.. 
43c0: 20 2f 2a 20 20 20 20 20 24 64 62 20 63 68 61 6e   /*     $db chan
43d0: 67 65 73 0a 20 20 2a 2a 0a 20 20 2a 2a 20 52 65  ges.  **.  ** Re
43e0: 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20  turn the number 
43f0: 6f 66 20 72 6f 77 73 20 74 68 61 74 20 77 65 72  of rows that wer
4400: 65 20 6d 6f 64 69 66 69 65 64 2c 20 69 6e 73 65  e modified, inse
4410: 72 74 65 64 2c 20 6f 72 20 64 65 6c 65 74 65 64  rted, or deleted
4420: 20 62 79 0a 20 20 2a 2a 20 74 68 65 20 6d 6f 73   by.  ** the mos
4430: 74 20 72 65 63 65 6e 74 20 49 4e 53 45 52 54 2c  t recent INSERT,
4440: 20 55 50 44 41 54 45 20 6f 72 20 44 45 4c 45 54   UPDATE or DELET
4450: 45 20 73 74 61 74 65 6d 65 6e 74 2c 20 6e 6f 74  E statement, not
4460: 20 69 6e 63 6c 75 64 69 6e 67 20 0a 20 20 2a 2a   including .  **
4470: 20 61 6e 79 20 63 68 61 6e 67 65 73 20 6d 61 64   any changes mad
4480: 65 20 62 79 20 74 72 69 67 67 65 72 20 70 72 6f  e by trigger pro
4490: 67 72 61 6d 73 2e 0a 20 20 2a 2f 0a 20 20 63 61  grams..  */.  ca
44a0: 73 65 20 44 42 5f 43 48 41 4e 47 45 53 3a 20 7b  se DB_CHANGES: {
44b0: 0a 20 20 20 20 54 63 6c 5f 4f 62 6a 20 2a 70 52  .    Tcl_Obj *pR
44c0: 65 73 75 6c 74 3b 0a 20 20 20 20 69 66 28 20 6f  esult;.    if( o
44d0: 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20 20 20 20  bjc!=2 ){.      
44e0: 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73  Tcl_WrongNumArgs
44f0: 28 69 6e 74 65 72 70 2c 20 32 2c 20 6f 62 6a 76  (interp, 2, objv
4500: 2c 20 22 22 29 3b 0a 20 20 20 20 20 20 72 65 74  , "");.      ret
4510: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
4520: 20 20 20 7d 0a 20 20 20 20 70 52 65 73 75 6c 74     }.    pResult
4530: 20 3d 20 54 63 6c 5f 47 65 74 4f 62 6a 52 65 73   = Tcl_GetObjRes
4540: 75 6c 74 28 69 6e 74 65 72 70 29 3b 0a 20 20 20  ult(interp);.   
4550: 20 54 63 6c 5f 53 65 74 49 6e 74 4f 62 6a 28 70   Tcl_SetIntObj(p
4560: 52 65 73 75 6c 74 2c 20 73 71 6c 69 74 65 33 5f  Result, sqlite3_
4570: 63 68 61 6e 67 65 73 28 70 44 62 2d 3e 64 62 29  changes(pDb->db)
4580: 29 3b 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  );.    break;.  
4590: 7d 0a 0a 20 20 2f 2a 20 20 20 20 24 64 62 20 63  }..  /*    $db c
45a0: 6c 6f 73 65 0a 20 20 2a 2a 0a 20 20 2a 2a 20 53  lose.  **.  ** S
45b0: 68 75 74 64 6f 77 6e 20 74 68 65 20 64 61 74 61  hutdown the data
45c0: 62 61 73 65 0a 20 20 2a 2f 0a 20 20 63 61 73 65  base.  */.  case
45d0: 20 44 42 5f 43 4c 4f 53 45 3a 20 7b 0a 20 20 20   DB_CLOSE: {.   
45e0: 20 54 63 6c 5f 44 65 6c 65 74 65 43 6f 6d 6d 61   Tcl_DeleteComma
45f0: 6e 64 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 47  nd(interp, Tcl_G
4600: 65 74 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a 28  etStringFromObj(
4610: 6f 62 6a 76 5b 30 5d 2c 20 30 29 29 3b 0a 20 20  objv[0], 0));.  
4620: 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 0a 20 20    break;.  }..  
4630: 2f 2a 20 20 20 20 24 64 62 20 63 6f 6d 6d 69 74  /*    $db commit
4640: 5f 68 6f 6f 6b 20 3f 43 41 4c 4c 42 41 43 4b 3f  _hook ?CALLBACK?
4650: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 6e 76 6f 6b  .  **.  ** Invok
4660: 65 20 74 68 65 20 67 69 76 65 6e 20 63 61 6c 6c  e the given call
4670: 62 61 63 6b 20 6a 75 73 74 20 62 65 66 6f 72 65  back just before
4680: 20 63 6f 6d 6d 69 74 74 69 6e 67 20 65 76 65 72   committing ever
4690: 79 20 53 51 4c 20 74 72 61 6e 73 61 63 74 69 6f  y SQL transactio
46a0: 6e 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65 20 63  n..  ** If the c
46b0: 61 6c 6c 62 61 63 6b 20 74 68 72 6f 77 73 20 61  allback throws a
46c0: 6e 20 65 78 63 65 70 74 69 6f 6e 20 6f 72 20 72  n exception or r
46d0: 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c  eturns non-zero,
46e0: 20 74 68 65 6e 20 74 68 65 0a 20 20 2a 2a 20 74   then the.  ** t
46f0: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 62  ransaction is ab
4700: 6f 72 74 65 64 2e 20 20 49 66 20 43 41 4c 4c 42  orted.  If CALLB
4710: 41 43 4b 20 69 73 20 61 6e 20 65 6d 70 74 79 20  ACK is an empty 
4720: 73 74 72 69 6e 67 2c 20 74 68 65 20 63 61 6c 6c  string, the call
4730: 62 61 63 6b 0a 20 20 2a 2a 20 69 73 20 64 69 73  back.  ** is dis
4740: 61 62 6c 65 64 2e 0a 20 20 2a 2f 0a 20 20 63 61  abled..  */.  ca
4750: 73 65 20 44 42 5f 43 4f 4d 4d 49 54 5f 48 4f 4f  se DB_COMMIT_HOO
4760: 4b 3a 20 7b 0a 20 20 20 20 69 66 28 20 6f 62 6a  K: {.    if( obj
4770: 63 3e 33 20 29 7b 0a 20 20 20 20 20 20 54 63 6c  c>3 ){.      Tcl
4780: 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e  _WrongNumArgs(in
4790: 74 65 72 70 2c 20 32 2c 20 6f 62 6a 76 2c 20 22  terp, 2, objv, "
47a0: 3f 43 41 4c 4c 42 41 43 4b 3f 22 29 3b 0a 20 20  ?CALLBACK?");.  
47b0: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
47c0: 52 52 4f 52 3b 0a 20 20 20 20 7d 65 6c 73 65 20  RROR;.    }else 
47d0: 69 66 28 20 6f 62 6a 63 3d 3d 32 20 29 7b 0a 20  if( objc==2 ){. 
47e0: 20 20 20 20 20 69 66 28 20 70 44 62 2d 3e 7a 43       if( pDb->zC
47f0: 6f 6d 6d 69 74 20 29 7b 0a 20 20 20 20 20 20 20  ommit ){.       
4800: 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c   Tcl_AppendResul
4810: 74 28 69 6e 74 65 72 70 2c 20 70 44 62 2d 3e 7a  t(interp, pDb->z
4820: 43 6f 6d 6d 69 74 2c 20 30 29 3b 0a 20 20 20 20  Commit, 0);.    
4830: 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20    }.    }else{. 
4840: 20 20 20 20 20 63 68 61 72 20 2a 7a 43 6f 6d 6d       char *zComm
4850: 69 74 3b 0a 20 20 20 20 20 20 69 6e 74 20 6c 65  it;.      int le
4860: 6e 3b 0a 20 20 20 20 20 20 69 66 28 20 70 44 62  n;.      if( pDb
4870: 2d 3e 7a 43 6f 6d 6d 69 74 20 29 7b 0a 20 20 20  ->zCommit ){.   
4880: 20 20 20 20 20 54 63 6c 5f 46 72 65 65 28 70 44       Tcl_Free(pD
4890: 62 2d 3e 7a 43 6f 6d 6d 69 74 29 3b 0a 20 20 20  b->zCommit);.   
48a0: 20 20 20 7d 0a 20 20 20 20 20 20 7a 43 6f 6d 6d     }.      zComm
48b0: 69 74 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69  it = Tcl_GetStri
48c0: 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 32  ngFromObj(objv[2
48d0: 5d 2c 20 26 6c 65 6e 29 3b 0a 20 20 20 20 20 20  ], &len);.      
48e0: 69 66 28 20 7a 43 6f 6d 6d 69 74 20 26 26 20 6c  if( zCommit && l
48f0: 65 6e 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20  en>0 ){.        
4900: 70 44 62 2d 3e 7a 43 6f 6d 6d 69 74 20 3d 20 54  pDb->zCommit = T
4910: 63 6c 5f 41 6c 6c 6f 63 28 20 6c 65 6e 20 2b 20  cl_Alloc( len + 
4920: 31 20 29 3b 0a 20 20 20 20 20 20 20 20 73 74 72  1 );.        str
4930: 63 70 79 28 70 44 62 2d 3e 7a 43 6f 6d 6d 69 74  cpy(pDb->zCommit
4940: 2c 20 7a 43 6f 6d 6d 69 74 29 3b 0a 20 20 20 20  , zCommit);.    
4950: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
4960: 20 70 44 62 2d 3e 7a 43 6f 6d 6d 69 74 20 3d 20   pDb->zCommit = 
4970: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  0;.      }.     
4980: 20 69 66 28 20 70 44 62 2d 3e 7a 43 6f 6d 6d 69   if( pDb->zCommi
4990: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44 62  t ){.        pDb
49a0: 2d 3e 69 6e 74 65 72 70 20 3d 20 69 6e 74 65 72  ->interp = inter
49b0: 70 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  p;.        sqlit
49c0: 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 70  e3_commit_hook(p
49d0: 44 62 2d 3e 64 62 2c 20 44 62 43 6f 6d 6d 69 74  Db->db, DbCommit
49e0: 48 61 6e 64 6c 65 72 2c 20 70 44 62 29 3b 0a 20  Handler, pDb);. 
49f0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
4a00: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6d 6d      sqlite3_comm
4a10: 69 74 5f 68 6f 6f 6b 28 70 44 62 2d 3e 64 62 2c  it_hook(pDb->db,
4a20: 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a   0, 0);.      }.
4a30: 20 20 20 20 7d 0a 20 20 20 20 62 72 65 61 6b 3b      }.    break;
4a40: 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20  .  }..  /*.  ** 
4a50: 20 20 20 20 24 64 62 20 63 6f 6c 6c 61 74 65 20      $db collate 
4a60: 4e 41 4d 45 20 53 43 52 49 50 54 0a 20 20 2a 2a  NAME SCRIPT.  **
4a70: 0a 20 20 2a 2a 20 43 72 65 61 74 65 20 61 20 6e  .  ** Create a n
4a80: 65 77 20 53 51 4c 20 63 6f 6c 6c 61 74 69 6f 6e  ew SQL collation
4a90: 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 65 64   function called
4aa0: 20 4e 41 4d 45 2e 20 20 57 68 65 6e 65 76 65 72   NAME.  Whenever
4ab0: 0a 20 20 2a 2a 20 74 68 61 74 20 66 75 6e 63 74  .  ** that funct
4ac0: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 69  ion is called, i
4ad0: 6e 76 6f 6b 65 20 53 43 52 49 50 54 20 74 6f 20  nvoke SCRIPT to 
4ae0: 65 76 61 6c 75 61 74 65 20 74 68 65 20 66 75 6e  evaluate the fun
4af0: 63 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 63 61  ction..  */.  ca
4b00: 73 65 20 44 42 5f 43 4f 4c 4c 41 54 45 3a 20 7b  se DB_COLLATE: {
4b10: 0a 20 20 20 20 53 71 6c 43 6f 6c 6c 61 74 65 20  .    SqlCollate 
4b20: 2a 70 43 6f 6c 6c 61 74 65 3b 0a 20 20 20 20 63  *pCollate;.    c
4b30: 68 61 72 20 2a 7a 4e 61 6d 65 3b 0a 20 20 20 20  har *zName;.    
4b40: 63 68 61 72 20 2a 7a 53 63 72 69 70 74 3b 0a 20  char *zScript;. 
4b50: 20 20 20 69 6e 74 20 6e 53 63 72 69 70 74 3b 0a     int nScript;.
4b60: 20 20 20 20 69 66 28 20 6f 62 6a 63 21 3d 34 20      if( objc!=4 
4b70: 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f 57 72 6f  ){.      Tcl_Wro
4b80: 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70  ngNumArgs(interp
4b90: 2c 20 32 2c 20 6f 62 6a 76 2c 20 22 4e 41 4d 45  , 2, objv, "NAME
4ba0: 20 53 43 52 49 50 54 22 29 3b 0a 20 20 20 20 20   SCRIPT");.     
4bb0: 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f   return TCL_ERRO
4bc0: 52 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 4e 61  R;.    }.    zNa
4bd0: 6d 65 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69  me = Tcl_GetStri
4be0: 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 32  ngFromObj(objv[2
4bf0: 5d 2c 20 30 29 3b 0a 20 20 20 20 7a 53 63 72 69  ], 0);.    zScri
4c00: 70 74 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69  pt = Tcl_GetStri
4c10: 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 33  ngFromObj(objv[3
4c20: 5d 2c 20 26 6e 53 63 72 69 70 74 29 3b 0a 20 20  ], &nScript);.  
4c30: 20 20 70 43 6f 6c 6c 61 74 65 20 3d 20 28 53 71    pCollate = (Sq
4c40: 6c 43 6f 6c 6c 61 74 65 2a 29 54 63 6c 5f 41 6c  lCollate*)Tcl_Al
4c50: 6c 6f 63 28 20 73 69 7a 65 6f 66 28 2a 70 43 6f  loc( sizeof(*pCo
4c60: 6c 6c 61 74 65 29 20 2b 20 6e 53 63 72 69 70 74  llate) + nScript
4c70: 20 2b 20 31 20 29 3b 0a 20 20 20 20 69 66 28 20   + 1 );.    if( 
4c80: 70 43 6f 6c 6c 61 74 65 3d 3d 30 20 29 20 72 65  pCollate==0 ) re
4c90: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
4ca0: 20 20 20 20 70 43 6f 6c 6c 61 74 65 2d 3e 69 6e      pCollate->in
4cb0: 74 65 72 70 20 3d 20 69 6e 74 65 72 70 3b 0a 20  terp = interp;. 
4cc0: 20 20 20 70 43 6f 6c 6c 61 74 65 2d 3e 70 4e 65     pCollate->pNe
4cd0: 78 74 20 3d 20 70 44 62 2d 3e 70 43 6f 6c 6c 61  xt = pDb->pColla
4ce0: 74 65 3b 0a 20 20 20 20 70 43 6f 6c 6c 61 74 65  te;.    pCollate
4cf0: 2d 3e 7a 53 63 72 69 70 74 20 3d 20 28 63 68 61  ->zScript = (cha
4d00: 72 2a 29 26 70 43 6f 6c 6c 61 74 65 5b 31 5d 3b  r*)&pCollate[1];
4d10: 0a 20 20 20 20 70 44 62 2d 3e 70 43 6f 6c 6c 61  .    pDb->pColla
4d20: 74 65 20 3d 20 70 43 6f 6c 6c 61 74 65 3b 0a 20  te = pCollate;. 
4d30: 20 20 20 73 74 72 63 70 79 28 70 43 6f 6c 6c 61     strcpy(pColla
4d40: 74 65 2d 3e 7a 53 63 72 69 70 74 2c 20 7a 53 63  te->zScript, zSc
4d50: 72 69 70 74 29 3b 0a 20 20 20 20 69 66 28 20 73  ript);.    if( s
4d60: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f  qlite3_create_co
4d70: 6c 6c 61 74 69 6f 6e 28 70 44 62 2d 3e 64 62 2c  llation(pDb->db,
4d80: 20 7a 4e 61 6d 65 2c 20 53 51 4c 49 54 45 5f 55   zName, SQLITE_U
4d90: 54 46 38 2c 20 0a 20 20 20 20 20 20 20 20 70 43  TF8, .        pC
4da0: 6f 6c 6c 61 74 65 2c 20 74 63 6c 53 71 6c 43 6f  ollate, tclSqlCo
4db0: 6c 6c 61 74 65 29 20 29 7b 0a 20 20 20 20 20 20  llate) ){.      
4dc0: 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52  return TCL_ERROR
4dd0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 62 72 65 61  ;.    }.    brea
4de0: 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a  k;.  }..  /*.  *
4df0: 2a 20 20 20 20 20 24 64 62 20 63 6f 6c 6c 61 74  *     $db collat
4e00: 69 6f 6e 5f 6e 65 65 64 65 64 20 53 43 52 49 50  ion_needed SCRIP
4e10: 54 0a 20 20 2a 2a 0a 20 20 2a 2a 20 43 72 65 61  T.  **.  ** Crea
4e20: 74 65 20 61 20 6e 65 77 20 53 51 4c 20 63 6f 6c  te a new SQL col
4e30: 6c 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 20  lation function 
4e40: 63 61 6c 6c 65 64 20 4e 41 4d 45 2e 20 20 57 68  called NAME.  Wh
4e50: 65 6e 65 76 65 72 0a 20 20 2a 2a 20 74 68 61 74  enever.  ** that
4e60: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
4e70: 6c 65 64 2c 20 69 6e 76 6f 6b 65 20 53 43 52 49  led, invoke SCRI
4e80: 50 54 20 74 6f 20 65 76 61 6c 75 61 74 65 20 74  PT to evaluate t
4e90: 68 65 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a  he function..  *
4ea0: 2f 0a 20 20 63 61 73 65 20 44 42 5f 43 4f 4c 4c  /.  case DB_COLL
4eb0: 41 54 49 4f 4e 5f 4e 45 45 44 45 44 3a 20 7b 0a  ATION_NEEDED: {.
4ec0: 20 20 20 20 69 66 28 20 6f 62 6a 63 21 3d 33 20      if( objc!=3 
4ed0: 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f 57 72 6f  ){.      Tcl_Wro
4ee0: 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70  ngNumArgs(interp
4ef0: 2c 20 32 2c 20 6f 62 6a 76 2c 20 22 53 43 52 49  , 2, objv, "SCRI
4f00: 50 54 22 29 3b 0a 20 20 20 20 20 20 72 65 74 75  PT");.      retu
4f10: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
4f20: 20 20 7d 0a 20 20 20 20 69 66 28 20 70 44 62 2d    }.    if( pDb-
4f30: 3e 70 43 6f 6c 6c 61 74 65 4e 65 65 64 65 64 20  >pCollateNeeded 
4f40: 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f 44 65 63  ){.      Tcl_Dec
4f50: 72 52 65 66 43 6f 75 6e 74 28 70 44 62 2d 3e 70  rRefCount(pDb->p
4f60: 43 6f 6c 6c 61 74 65 4e 65 65 64 65 64 29 3b 0a  CollateNeeded);.
4f70: 20 20 20 20 7d 0a 20 20 20 20 70 44 62 2d 3e 70      }.    pDb->p
4f80: 43 6f 6c 6c 61 74 65 4e 65 65 64 65 64 20 3d 20  CollateNeeded = 
4f90: 54 63 6c 5f 44 75 70 6c 69 63 61 74 65 4f 62 6a  Tcl_DuplicateObj
4fa0: 28 6f 62 6a 76 5b 32 5d 29 3b 0a 20 20 20 20 54  (objv[2]);.    T
4fb0: 63 6c 5f 49 6e 63 72 52 65 66 43 6f 75 6e 74 28  cl_IncrRefCount(
4fc0: 70 44 62 2d 3e 70 43 6f 6c 6c 61 74 65 4e 65 65  pDb->pCollateNee
4fd0: 64 65 64 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  ded);.    sqlite
4fe0: 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64  3_collation_need
4ff0: 65 64 28 70 44 62 2d 3e 64 62 2c 20 70 44 62 2c  ed(pDb->db, pDb,
5000: 20 74 63 6c 43 6f 6c 6c 61 74 65 4e 65 65 64 65   tclCollateNeede
5010: 64 29 3b 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20  d);.    break;. 
5020: 20 7d 0a 0a 20 20 2f 2a 20 20 20 20 24 64 62 20   }..  /*    $db 
5030: 63 6f 6d 70 6c 65 74 65 20 53 51 4c 0a 20 20 2a  complete SQL.  *
5040: 2a 0a 20 20 2a 2a 20 52 65 74 75 72 6e 20 54 52  *.  ** Return TR
5050: 55 45 20 69 66 20 53 51 4c 20 69 73 20 61 20 63  UE if SQL is a c
5060: 6f 6d 70 6c 65 74 65 20 53 51 4c 20 73 74 61 74  omplete SQL stat
5070: 65 6d 65 6e 74 2e 20 20 52 65 74 75 72 6e 20 46  ement.  Return F
5080: 41 4c 53 45 20 69 66 0a 20 20 2a 2a 20 61 64 64  ALSE if.  ** add
5090: 69 74 69 6f 6e 61 6c 20 6c 69 6e 65 73 20 6f 66  itional lines of
50a0: 20 69 6e 70 75 74 20 61 72 65 20 6e 65 65 64 65   input are neede
50b0: 64 2e 20 20 54 68 69 73 20 69 73 20 73 69 6d 69  d.  This is simi
50c0: 6c 61 72 20 74 6f 20 74 68 65 0a 20 20 2a 2a 20  lar to the.  ** 
50d0: 62 75 69 6c 74 2d 69 6e 20 22 69 6e 66 6f 20 63  built-in "info c
50e0: 6f 6d 70 6c 65 74 65 22 20 63 6f 6d 6d 61 6e 64  omplete" command
50f0: 20 6f 66 20 54 63 6c 2e 0a 20 20 2a 2f 0a 20 20   of Tcl..  */.  
5100: 63 61 73 65 20 44 42 5f 43 4f 4d 50 4c 45 54 45  case DB_COMPLETE
5110: 3a 20 7b 0a 20 20 20 20 54 63 6c 5f 4f 62 6a 20  : {.    Tcl_Obj 
5120: 2a 70 52 65 73 75 6c 74 3b 0a 20 20 20 20 69 6e  *pResult;.    in
5130: 74 20 69 73 43 6f 6d 70 6c 65 74 65 3b 0a 20 20  t isComplete;.  
5140: 20 20 69 66 28 20 6f 62 6a 63 21 3d 33 20 29 7b    if( objc!=3 ){
5150: 0a 20 20 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67  .      Tcl_Wrong
5160: 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20  NumArgs(interp, 
5170: 32 2c 20 6f 62 6a 76 2c 20 22 53 51 4c 22 29 3b  2, objv, "SQL");
5180: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54 43  .      return TC
5190: 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20  L_ERROR;.    }. 
51a0: 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20     isComplete = 
51b0: 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65  sqlite3_complete
51c0: 28 20 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 46  ( Tcl_GetStringF
51d0: 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 32 5d 2c 20  romObj(objv[2], 
51e0: 30 29 20 29 3b 0a 20 20 20 20 70 52 65 73 75 6c  0) );.    pResul
51f0: 74 20 3d 20 54 63 6c 5f 47 65 74 4f 62 6a 52 65  t = Tcl_GetObjRe
5200: 73 75 6c 74 28 69 6e 74 65 72 70 29 3b 0a 20 20  sult(interp);.  
5210: 20 20 54 63 6c 5f 53 65 74 42 6f 6f 6c 65 61 6e    Tcl_SetBoolean
5220: 4f 62 6a 28 70 52 65 73 75 6c 74 2c 20 69 73 43  Obj(pResult, isC
5230: 6f 6d 70 6c 65 74 65 29 3b 0a 20 20 20 20 62 72  omplete);.    br
5240: 65 61 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20  eak;.  }..  /*. 
5250: 20 2a 2a 20 20 20 20 24 64 62 20 65 72 72 6f 72   **    $db error
5260: 63 6f 64 65 0a 20 20 2a 2a 0a 20 20 2a 2a 20 52  code.  **.  ** R
5270: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 65 72 69  eturn the numeri
5280: 63 20 65 72 72 6f 72 20 63 6f 64 65 20 74 68 61  c error code tha
5290: 74 20 77 61 73 20 72 65 74 75 72 6e 65 64 20 62  t was returned b
52a0: 79 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e  y the most recen
52b0: 74 0a 20 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 73  t.  ** call to s
52c0: 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 20  qlite3_exec().. 
52d0: 20 2a 2f 0a 20 20 63 61 73 65 20 44 42 5f 45 52   */.  case DB_ER
52e0: 52 4f 52 43 4f 44 45 3a 20 7b 0a 20 20 20 20 54  RORCODE: {.    T
52f0: 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74 28  cl_SetObjResult(
5300: 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65 77 49  interp, Tcl_NewI
5310: 6e 74 4f 62 6a 28 73 71 6c 69 74 65 33 5f 65 72  ntObj(sqlite3_er
5320: 72 63 6f 64 65 28 70 44 62 2d 3e 64 62 29 29 29  rcode(pDb->db)))
5330: 3b 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d  ;.    break;.  }
5340: 0a 20 20 20 0a 20 20 2f 2a 0a 20 20 2a 2a 20 20  .   .  /*.  **  
5350: 20 20 24 64 62 20 65 76 61 6c 20 24 73 71 6c 20    $db eval $sql 
5360: 3f 61 72 72 61 79 20 7b 20 20 2e 2e 2e 63 6f 64  ?array {  ...cod
5370: 65 2e 2e 2e 20 7d 3f 0a 20 20 2a 2a 0a 20 20 2a  e... }?.  **.  *
5380: 2a 20 54 68 65 20 53 51 4c 20 73 74 61 74 65 6d  * The SQL statem
5390: 65 6e 74 20 69 6e 20 24 73 71 6c 20 69 73 20 65  ent in $sql is e
53a0: 76 61 6c 75 61 74 65 64 2e 20 20 46 6f 72 20 65  valuated.  For e
53b0: 61 63 68 20 72 6f 77 2c 20 74 68 65 20 76 61 6c  ach row, the val
53c0: 75 65 73 20 61 72 65 0a 20 20 2a 2a 20 70 6c 61  ues are.  ** pla
53d0: 63 65 64 20 69 6e 20 65 6c 65 6d 65 6e 74 73 20  ced in elements 
53e0: 6f 66 20 74 68 65 20 61 72 72 61 79 20 6e 61 6d  of the array nam
53f0: 65 64 20 22 61 72 72 61 79 22 20 61 6e 64 20 2e  ed "array" and .
5400: 2e 2e 63 6f 64 65 2e 2e 2e 20 69 73 20 65 78 65  ..code... is exe
5410: 63 75 74 65 64 2e 0a 20 20 2a 2a 20 49 66 20 22  cuted..  ** If "
5420: 61 72 72 61 79 22 20 61 6e 64 20 22 63 6f 64 65  array" and "code
5430: 22 20 61 72 65 20 6f 6d 69 74 74 65 64 2c 20 74  " are omitted, t
5440: 68 65 6e 20 6e 6f 20 63 61 6c 6c 62 61 63 6b 20  hen no callback 
5450: 69 73 20 65 76 65 72 79 20 69 6e 76 6f 6b 65 64  is every invoked
5460: 2e 0a 20 20 2a 2a 20 49 66 20 22 61 72 72 61 79  ..  ** If "array
5470: 22 20 69 73 20 61 6e 20 65 6d 70 74 79 20 73 74  " is an empty st
5480: 72 69 6e 67 2c 20 74 68 65 6e 20 74 68 65 20 76  ring, then the v
5490: 61 6c 75 65 73 20 61 72 65 20 70 6c 61 63 65 64  alues are placed
54a0: 20 69 6e 20 76 61 72 69 61 62 6c 65 73 0a 20 20   in variables.  
54b0: 2a 2a 20 74 68 61 74 20 68 61 76 65 20 74 68 65  ** that have the
54c0: 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 74 68   same name as th
54d0: 65 20 66 69 65 6c 64 73 20 65 78 74 72 61 63 74  e fields extract
54e0: 65 64 20 62 79 20 74 68 65 20 71 75 65 72 79 2e  ed by the query.
54f0: 0a 20 20 2a 2f 0a 20 20 63 61 73 65 20 44 42 5f  .  */.  case DB_
5500: 45 56 41 4c 3a 20 7b 0a 20 20 20 20 63 68 61 72  EVAL: {.    char
5510: 20 63 6f 6e 73 74 20 2a 7a 53 71 6c 3b 0a 20 20   const *zSql;.  
5520: 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4c    char const *zL
5530: 65 66 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  eft;.    sqlite3
5540: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 3b 0a 0a 20  _stmt *pStmt;.. 
5550: 20 20 20 54 63 6c 5f 4f 62 6a 20 2a 70 52 65 74     Tcl_Obj *pRet
5560: 20 3d 20 54 63 6c 5f 4e 65 77 4f 62 6a 28 29 3b   = Tcl_NewObj();
5570: 0a 20 20 20 20 54 63 6c 5f 49 6e 63 72 52 65 66  .    Tcl_IncrRef
5580: 43 6f 75 6e 74 28 70 52 65 74 29 3b 0a 0a 20 20  Count(pRet);..  
5590: 20 20 69 66 28 20 6f 62 6a 63 21 3d 35 20 26 26    if( objc!=5 &&
55a0: 20 6f 62 6a 63 21 3d 33 20 29 7b 0a 20 20 20 20   objc!=3 ){.    
55b0: 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72    Tcl_WrongNumAr
55c0: 67 73 28 69 6e 74 65 72 70 2c 20 32 2c 20 6f 62  gs(interp, 2, ob
55d0: 6a 76 2c 20 22 53 51 4c 20 3f 41 52 52 41 59 2d  jv, "SQL ?ARRAY-
55e0: 4e 41 4d 45 20 43 4f 44 45 3f 22 29 3b 0a 20 20  NAME CODE?");.  
55f0: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
5600: 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 0a 20 20 20  RROR;.    }..   
5610: 20 7a 53 71 6c 20 3d 20 54 63 6c 5f 47 65 74 53   zSql = Tcl_GetS
5620: 74 72 69 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62 6a  tringFromObj(obj
5630: 76 5b 32 5d 2c 20 30 29 3b 0a 20 20 20 20 77 68  v[2], 0);.    wh
5640: 69 6c 65 28 20 7a 53 71 6c 5b 30 5d 20 29 7b 0a  ile( zSql[0] ){.
5650: 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 0a        int i;.  .
5660: 20 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 45        if( SQLITE
5670: 5f 4f 4b 21 3d 73 71 6c 69 74 65 33 5f 70 72 65  _OK!=sqlite3_pre
5680: 70 61 72 65 28 70 44 62 2d 3e 64 62 2c 20 7a 53  pare(pDb->db, zS
5690: 71 6c 2c 20 2d 31 2c 20 26 70 53 74 6d 74 2c 20  ql, -1, &pStmt, 
56a0: 26 7a 4c 65 66 74 29 20 29 7b 0a 20 20 20 20 20  &zLeft) ){.     
56b0: 20 20 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73     Tcl_SetObjRes
56c0: 75 6c 74 28 69 6e 74 65 72 70 2c 20 64 62 54 65  ult(interp, dbTe
56d0: 78 74 54 6f 4f 62 6a 28 73 71 6c 69 74 65 33 5f  xtToObj(sqlite3_
56e0: 65 72 72 6d 73 67 28 70 44 62 2d 3e 64 62 29 29  errmsg(pDb->db))
56f0: 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  );.        rc = 
5700: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20  TCL_ERROR;.     
5710: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
5720: 7d 0a 20 20 0a 20 20 20 20 20 20 69 66 28 20 70  }.  .      if( p
5730: 53 74 6d 74 20 26 26 20 6f 62 6a 63 3d 3d 35 20  Stmt && objc==5 
5740: 29 7b 0a 20 20 20 20 20 20 20 20 54 63 6c 5f 4f  ){.        Tcl_O
5750: 62 6a 20 2a 70 43 6f 6c 4c 69 73 74 20 3d 20 54  bj *pColList = T
5760: 63 6c 5f 4e 65 77 4f 62 6a 28 29 3b 0a 20 20 20  cl_NewObj();.   
5770: 20 20 20 20 20 54 63 6c 5f 49 6e 63 72 52 65 66       Tcl_IncrRef
5780: 43 6f 75 6e 74 28 70 43 6f 6c 4c 69 73 74 29 3b  Count(pColList);
5790: 0a 0a 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d  ..        for(i=
57a0: 30 3b 20 69 3c 73 71 6c 69 74 65 33 5f 63 6f 6c  0; i<sqlite3_col
57b0: 75 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29  umn_count(pStmt)
57c0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20  ; i++){.        
57d0: 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70    Tcl_ListObjApp
57e0: 65 6e 64 45 6c 65 6d 65 6e 74 28 69 6e 74 65 72  endElement(inter
57f0: 70 2c 20 70 43 6f 6c 4c 69 73 74 2c 0a 20 20 20  p, pColList,.   
5800: 20 20 20 20 20 20 20 20 20 20 20 64 62 54 65 78             dbTex
5810: 74 54 6f 4f 62 6a 28 73 71 6c 69 74 65 33 5f 63  tToObj(sqlite3_c
5820: 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 70 53 74 6d 74  olumn_name(pStmt
5830: 2c 20 69 29 29 0a 20 20 20 20 20 20 20 20 20 20  , i)).          
5840: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
5850: 20 20 20 20 20 54 63 6c 5f 4f 62 6a 53 65 74 56       Tcl_ObjSetV
5860: 61 72 32 28 69 6e 74 65 72 70 2c 6f 62 6a 76 5b  ar2(interp,objv[
5870: 33 5d 2c 54 63 6c 5f 4e 65 77 53 74 72 69 6e 67  3],Tcl_NewString
5880: 4f 62 6a 28 22 2a 22 2c 2d 31 29 2c 70 43 6f 6c  Obj("*",-1),pCol
5890: 4c 69 73 74 2c 30 29 3b 0a 20 20 20 20 20 20 7d  List,0);.      }
58a0: 0a 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 70  ..      while( p
58b0: 53 74 6d 74 20 26 26 20 53 51 4c 49 54 45 5f 52  Stmt && SQLITE_R
58c0: 4f 57 3d 3d 73 71 6c 69 74 65 33 5f 73 74 65 70  OW==sqlite3_step
58d0: 28 70 53 74 6d 74 29 20 29 7b 0a 20 20 20 20 20  (pStmt) ){.     
58e0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73 71     for(i=0; i<sq
58f0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75  lite3_column_cou
5900: 6e 74 28 70 53 74 6d 74 29 3b 20 69 2b 2b 29 7b  nt(pStmt); i++){
5910: 0a 20 20 20 20 20 20 20 20 20 20 54 63 6c 5f 4f  .          Tcl_O
5920: 62 6a 20 2a 70 56 61 6c 3b 0a 20 20 20 20 20 20  bj *pVal;.      
5930: 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 20 2f      .          /
5940: 2a 20 53 65 74 20 70 56 61 6c 20 74 6f 20 63 6f  * Set pVal to co
5950: 6e 74 61 69 6e 20 74 68 65 20 69 27 74 68 20 63  ntain the i'th c
5960: 6f 6c 75 6d 6e 20 6f 66 20 74 68 69 73 20 72 6f  olumn of this ro
5970: 77 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20  w. */.          
5980: 69 66 28 20 53 51 4c 49 54 45 5f 42 4c 4f 42 21  if( SQLITE_BLOB!
5990: 3d 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  =sqlite3_column_
59a0: 74 79 70 65 28 70 53 74 6d 74 2c 20 69 29 20 29  type(pStmt, i) )
59b0: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 56  {.            pV
59c0: 61 6c 20 3d 20 64 62 54 65 78 74 54 6f 4f 62 6a  al = dbTextToObj
59d0: 28 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  (sqlite3_column_
59e0: 74 65 78 74 28 70 53 74 6d 74 2c 20 69 29 29 3b  text(pStmt, i));
59f0: 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65  .          }else
5a00: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e  {.            in
5a10: 74 20 62 79 74 65 73 20 3d 20 73 71 6c 69 74 65  t bytes = sqlite
5a20: 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 28 70  3_column_bytes(p
5a30: 53 74 6d 74 2c 20 69 29 3b 0a 20 20 20 20 20 20  Stmt, i);.      
5a40: 20 20 20 20 20 20 70 56 61 6c 20 3d 20 54 63 6c        pVal = Tcl
5a50: 5f 4e 65 77 42 79 74 65 41 72 72 61 79 4f 62 6a  _NewByteArrayObj
5a60: 28 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  (sqlite3_column_
5a70: 62 6c 6f 62 28 70 53 74 6d 74 2c 20 69 29 2c 20  blob(pStmt, i), 
5a80: 62 79 74 65 73 29 3b 0a 20 20 20 20 20 20 20 20  bytes);.        
5a90: 20 20 7d 0a 20 20 0a 20 20 20 20 20 20 20 20 20    }.  .         
5aa0: 20 69 66 28 20 6f 62 6a 63 3d 3d 35 20 29 7b 0a   if( objc==5 ){.
5ab0: 20 20 20 20 20 20 20 20 20 20 20 20 54 63 6c 5f              Tcl_
5ac0: 4f 62 6a 20 2a 70 4e 61 6d 65 20 3d 20 64 62 54  Obj *pName = dbT
5ad0: 65 78 74 54 6f 4f 62 6a 28 73 71 6c 69 74 65 33  extToObj(sqlite3
5ae0: 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 70 53 74  _column_name(pSt
5af0: 6d 74 2c 20 69 29 29 3b 0a 20 20 20 20 20 20 20  mt, i));.       
5b00: 20 20 20 20 20 54 63 6c 5f 49 6e 63 72 52 65 66       Tcl_IncrRef
5b10: 43 6f 75 6e 74 28 70 4e 61 6d 65 29 3b 0a 20 20  Count(pName);.  
5b20: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 21 73            if( !s
5b30: 74 72 63 6d 70 28 22 22 2c 20 54 63 6c 5f 47 65  trcmp("", Tcl_Ge
5b40: 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b 33 5d 29  tString(objv[3])
5b50: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  ) ){.           
5b60: 20 20 20 54 63 6c 5f 4f 62 6a 53 65 74 56 61 72     Tcl_ObjSetVar
5b70: 32 28 69 6e 74 65 72 70 2c 20 70 4e 61 6d 65 2c  2(interp, pName,
5b80: 20 30 2c 20 70 56 61 6c 2c 20 30 29 3b 0a 20 20   0, pVal, 0);.  
5b90: 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b            }else{
5ba0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54  .              T
5bb0: 63 6c 5f 4f 62 6a 53 65 74 56 61 72 32 28 69 6e  cl_ObjSetVar2(in
5bc0: 74 65 72 70 2c 20 6f 62 6a 76 5b 33 5d 2c 20 70  terp, objv[3], p
5bd0: 4e 61 6d 65 2c 20 70 56 61 6c 2c 20 30 29 3b 0a  Name, pVal, 0);.
5be0: 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20              }.  
5bf0: 20 20 20 20 20 20 20 20 20 20 54 63 6c 5f 44 65            Tcl_De
5c00: 63 72 52 65 66 43 6f 75 6e 74 28 70 4e 61 6d 65  crRefCount(pName
5c10: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c  );.          }el
5c20: 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20  se{.            
5c30: 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65 6e  Tcl_ListObjAppen
5c40: 64 45 6c 65 6d 65 6e 74 28 69 6e 74 65 72 70 2c  dElement(interp,
5c50: 20 70 52 65 74 2c 20 70 56 61 6c 29 3b 0a 20 20   pRet, pVal);.  
5c60: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
5c70: 20 20 7d 0a 20 20 0a 20 20 20 20 20 20 20 20 69    }.  .        i
5c80: 66 28 20 6f 62 6a 63 3d 3d 35 20 29 7b 0a 20 20  f( objc==5 ){.  
5c90: 20 20 20 20 20 20 20 20 72 63 20 3d 20 54 63 6c          rc = Tcl
5ca0: 5f 45 76 61 6c 4f 62 6a 45 78 28 69 6e 74 65 72  _EvalObjEx(inter
5cb0: 70 2c 20 6f 62 6a 76 5b 34 5d 2c 20 30 29 3b 0a  p, objv[4], 0);.
5cc0: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63            if( rc
5cd0: 21 3d 54 43 4c 5f 45 52 52 4f 52 20 29 20 72 63  !=TCL_ERROR ) rc
5ce0: 20 3d 20 54 43 4c 5f 4f 4b 3b 0a 20 20 20 20 20   = TCL_OK;.     
5cf0: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
5d00: 20 20 20 20 0a 20 20 20 20 20 20 69 66 28 20 70      .      if( p
5d10: 53 74 6d 74 20 26 26 20 53 51 4c 49 54 45 5f 53  Stmt && SQLITE_S
5d20: 43 48 45 4d 41 3d 3d 73 71 6c 69 74 65 33 5f 66  CHEMA==sqlite3_f
5d30: 69 6e 61 6c 69 7a 65 28 70 53 74 6d 74 29 20 29  inalize(pStmt) )
5d40: 7b 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e  {.        contin
5d50: 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 0a 20  ue;.      }.  . 
5d60: 20 20 20 20 20 69 66 28 20 70 53 74 6d 74 20 26       if( pStmt &
5d70: 26 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 73 71 6c  & SQLITE_OK!=sql
5d80: 69 74 65 33 5f 65 72 72 63 6f 64 65 28 70 44 62  ite3_errcode(pDb
5d90: 2d 3e 64 62 29 20 29 7b 0a 20 20 20 20 20 20 20  ->db) ){.       
5da0: 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c   Tcl_SetObjResul
5db0: 74 28 69 6e 74 65 72 70 2c 20 64 62 54 65 78 74  t(interp, dbText
5dc0: 54 6f 4f 62 6a 28 73 71 6c 69 74 65 33 5f 65 72  ToObj(sqlite3_er
5dd0: 72 6d 73 67 28 70 44 62 2d 3e 64 62 29 29 29 3b  rmsg(pDb->db)));
5de0: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 54 43  .        rc = TC
5df0: 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 20  L_ERROR;.       
5e00: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a   break;.      }.
5e10: 0a 20 20 20 20 20 20 7a 53 71 6c 20 3d 20 7a 4c  .      zSql = zL
5e20: 65 66 74 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  eft;.    }..    
5e30: 69 66 28 20 72 63 3d 3d 54 43 4c 5f 4f 4b 20 29  if( rc==TCL_OK )
5e40: 7b 0a 20 20 20 20 20 20 54 63 6c 5f 53 65 74 4f  {.      Tcl_SetO
5e50: 62 6a 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c  bjResult(interp,
5e60: 20 70 52 65 74 29 3b 0a 20 20 20 20 7d 0a 20 20   pRet);.    }.  
5e70: 20 20 54 63 6c 5f 44 65 63 72 52 65 66 43 6f 75    Tcl_DecrRefCou
5e80: 6e 74 28 70 52 65 74 29 3b 0a 0a 20 20 20 20 62  nt(pRet);..    b
5e90: 72 65 61 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 0a  reak;.  }..  /*.
5ea0: 20 20 2a 2a 20 20 20 20 20 24 64 62 20 66 75 6e    **     $db fun
5eb0: 63 74 69 6f 6e 20 4e 41 4d 45 20 53 43 52 49 50  ction NAME SCRIP
5ec0: 54 0a 20 20 2a 2a 0a 20 20 2a 2a 20 43 72 65 61  T.  **.  ** Crea
5ed0: 74 65 20 61 20 6e 65 77 20 53 51 4c 20 66 75 6e  te a new SQL fun
5ee0: 63 74 69 6f 6e 20 63 61 6c 6c 65 64 20 4e 41 4d  ction called NAM
5ef0: 45 2e 20 20 57 68 65 6e 65 76 65 72 20 74 68 61  E.  Whenever tha
5f00: 74 20 66 75 6e 63 74 69 6f 6e 20 69 73 0a 20 20  t function is.  
5f10: 2a 2a 20 63 61 6c 6c 65 64 2c 20 69 6e 76 6f 6b  ** called, invok
5f20: 65 20 53 43 52 49 50 54 20 74 6f 20 65 76 61 6c  e SCRIPT to eval
5f30: 75 61 74 65 20 74 68 65 20 66 75 6e 63 74 69 6f  uate the functio
5f40: 6e 2e 0a 20 20 2a 2f 0a 20 20 63 61 73 65 20 44  n..  */.  case D
5f50: 42 5f 46 55 4e 43 54 49 4f 4e 3a 20 7b 0a 20 20  B_FUNCTION: {.  
5f60: 20 20 53 71 6c 46 75 6e 63 20 2a 70 46 75 6e 63    SqlFunc *pFunc
5f70: 3b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d  ;.    char *zNam
5f80: 65 3b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53 63  e;.    char *zSc
5f90: 72 69 70 74 3b 0a 20 20 20 20 69 6e 74 20 6e 53  ript;.    int nS
5fa0: 63 72 69 70 74 3b 0a 20 20 20 20 69 66 28 20 6f  cript;.    if( o
5fb0: 62 6a 63 21 3d 34 20 29 7b 0a 20 20 20 20 20 20  bjc!=4 ){.      
5fc0: 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73  Tcl_WrongNumArgs
5fd0: 28 69 6e 74 65 72 70 2c 20 32 2c 20 6f 62 6a 76  (interp, 2, objv
5fe0: 2c 20 22 4e 41 4d 45 20 53 43 52 49 50 54 22 29  , "NAME SCRIPT")
5ff0: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54  ;.      return T
6000: 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a  CL_ERROR;.    }.
6010: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 54 63 6c 5f      zName = Tcl_
6020: 47 65 74 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a  GetStringFromObj
6030: 28 6f 62 6a 76 5b 32 5d 2c 20 30 29 3b 0a 20 20  (objv[2], 0);.  
6040: 20 20 7a 53 63 72 69 70 74 20 3d 20 54 63 6c 5f    zScript = Tcl_
6050: 47 65 74 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a  GetStringFromObj
6060: 28 6f 62 6a 76 5b 33 5d 2c 20 26 6e 53 63 72 69  (objv[3], &nScri
6070: 70 74 29 3b 0a 20 20 20 20 70 46 75 6e 63 20 3d  pt);.    pFunc =
6080: 20 28 53 71 6c 46 75 6e 63 2a 29 54 63 6c 5f 41   (SqlFunc*)Tcl_A
6090: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 2a 70 46  lloc( sizeof(*pF
60a0: 75 6e 63 29 20 2b 20 6e 53 63 72 69 70 74 20 2b  unc) + nScript +
60b0: 20 31 20 29 3b 0a 20 20 20 20 69 66 28 20 70 46   1 );.    if( pF
60c0: 75 6e 63 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  unc==0 ) return 
60d0: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 70  TCL_ERROR;.    p
60e0: 46 75 6e 63 2d 3e 69 6e 74 65 72 70 20 3d 20 69  Func->interp = i
60f0: 6e 74 65 72 70 3b 0a 20 20 20 20 70 46 75 6e 63  nterp;.    pFunc
6100: 2d 3e 70 4e 65 78 74 20 3d 20 70 44 62 2d 3e 70  ->pNext = pDb->p
6110: 46 75 6e 63 3b 0a 20 20 20 20 70 46 75 6e 63 2d  Func;.    pFunc-
6120: 3e 7a 53 63 72 69 70 74 20 3d 20 28 63 68 61 72  >zScript = (char
6130: 2a 29 26 70 46 75 6e 63 5b 31 5d 3b 0a 20 20 20  *)&pFunc[1];.   
6140: 20 70 44 62 2d 3e 70 46 75 6e 63 20 3d 20 70 46   pDb->pFunc = pF
6150: 75 6e 63 3b 0a 20 20 20 20 73 74 72 63 70 79 28  unc;.    strcpy(
6160: 70 46 75 6e 63 2d 3e 7a 53 63 72 69 70 74 2c 20  pFunc->zScript, 
6170: 7a 53 63 72 69 70 74 29 3b 0a 20 20 20 20 72 63  zScript);.    rc
6180: 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74   = sqlite3_creat
6190: 65 5f 66 75 6e 63 74 69 6f 6e 28 70 44 62 2d 3e  e_function(pDb->
61a0: 64 62 2c 20 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53  db, zName, -1, S
61b0: 51 4c 49 54 45 5f 55 54 46 38 2c 0a 20 20 20 20  QLITE_UTF8,.    
61c0: 20 20 20 20 70 46 75 6e 63 2c 20 74 63 6c 53 71      pFunc, tclSq
61d0: 6c 46 75 6e 63 2c 20 30 2c 20 30 29 3b 0a 20 20  lFunc, 0, 0);.  
61e0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
61f0: 5f 4f 4b 20 29 20 72 63 20 3d 20 54 43 4c 5f 45  _OK ) rc = TCL_E
6200: 52 52 4f 52 3b 0a 20 20 20 20 62 72 65 61 6b 3b  RROR;.    break;
6210: 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20  .  }..  /*.  ** 
6220: 20 20 20 20 24 64 62 20 6c 61 73 74 5f 69 6e 73      $db last_ins
6230: 65 72 74 5f 72 6f 77 69 64 20 0a 20 20 2a 2a 0a  ert_rowid .  **.
6240: 20 20 2a 2a 20 52 65 74 75 72 6e 20 61 6e 20 69    ** Return an i
6250: 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20  nteger which is 
6260: 74 68 65 20 52 4f 57 49 44 20 66 6f 72 20 74 68  the ROWID for th
6270: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e  e most recent in
6280: 73 65 72 74 2e 0a 20 20 2a 2f 0a 20 20 63 61 73  sert..  */.  cas
6290: 65 20 44 42 5f 4c 41 53 54 5f 49 4e 53 45 52 54  e DB_LAST_INSERT
62a0: 5f 52 4f 57 49 44 3a 20 7b 0a 20 20 20 20 54 63  _ROWID: {.    Tc
62b0: 6c 5f 4f 62 6a 20 2a 70 52 65 73 75 6c 74 3b 0a  l_Obj *pResult;.
62c0: 20 20 20 20 69 6e 74 20 72 6f 77 69 64 3b 0a 20      int rowid;. 
62d0: 20 20 20 69 66 28 20 6f 62 6a 63 21 3d 32 20 29     if( objc!=2 )
62e0: 7b 0a 20 20 20 20 20 20 54 63 6c 5f 57 72 6f 6e  {.      Tcl_Wron
62f0: 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c  gNumArgs(interp,
6300: 20 32 2c 20 6f 62 6a 76 2c 20 22 22 29 3b 0a 20   2, objv, "");. 
6310: 20 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f       return TCL_
6320: 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20 20 20  ERROR;.    }.   
6330: 20 72 6f 77 69 64 20 3d 20 73 71 6c 69 74 65 33   rowid = sqlite3
6340: 5f 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77  _last_insert_row
6350: 69 64 28 70 44 62 2d 3e 64 62 29 3b 0a 20 20 20  id(pDb->db);.   
6360: 20 70 52 65 73 75 6c 74 20 3d 20 54 63 6c 5f 47   pResult = Tcl_G
6370: 65 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65  etObjResult(inte
6380: 72 70 29 3b 0a 20 20 20 20 54 63 6c 5f 53 65 74  rp);.    Tcl_Set
6390: 49 6e 74 4f 62 6a 28 70 52 65 73 75 6c 74 2c 20  IntObj(pResult, 
63a0: 72 6f 77 69 64 29 3b 0a 20 20 20 20 62 72 65 61  rowid);.    brea
63b0: 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a  k;.  }..  /*.  *
63c0: 2a 20 20 20 20 20 24 64 62 20 6f 6e 65 63 6f 6c  *     $db onecol
63d0: 75 6d 6e 20 53 51 4c 0a 20 20 2a 2a 0a 20 20 2a  umn SQL.  **.  *
63e0: 2a 20 52 65 74 75 72 6e 20 61 20 73 69 6e 67 6c  * Return a singl
63f0: 65 20 63 6f 6c 75 6d 6e 20 66 72 6f 6d 20 61 20  e column from a 
6400: 73 69 6e 67 6c 65 20 72 6f 77 20 6f 66 20 74 68  single row of th
6410: 65 20 67 69 76 65 6e 20 53 51 4c 20 71 75 65 72  e given SQL quer
6420: 79 2e 0a 20 20 2a 2f 0a 20 20 63 61 73 65 20 44  y..  */.  case D
6430: 42 5f 4f 4e 45 43 4f 4c 55 4d 4e 3a 20 7b 0a 20  B_ONECOLUMN: {. 
6440: 20 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20     char *zSql;. 
6450: 20 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67     char *zErrMsg
6460: 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 6f 62   = 0;.    if( ob
6470: 6a 63 21 3d 33 20 29 7b 0a 20 20 20 20 20 20 54  jc!=3 ){.      T
6480: 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28  cl_WrongNumArgs(
6490: 69 6e 74 65 72 70 2c 20 32 2c 20 6f 62 6a 76 2c  interp, 2, objv,
64a0: 20 22 53 51 4c 22 29 3b 0a 20 20 20 20 20 20 72   "SQL");.      r
64b0: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
64c0: 0a 20 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 20  .    }.    zSql 
64d0: 3d 20 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 46  = Tcl_GetStringF
64e0: 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 32 5d 2c 20  romObj(objv[2], 
64f0: 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  0);.    rc = sql
6500: 69 74 65 33 5f 65 78 65 63 28 70 44 62 2d 3e 64  ite3_exec(pDb->d
6510: 62 2c 20 7a 53 71 6c 2c 20 44 62 45 76 61 6c 43  b, zSql, DbEvalC
6520: 61 6c 6c 62 61 63 6b 33 2c 20 69 6e 74 65 72 70  allback3, interp
6530: 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  , &zErrMsg);.   
6540: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
6550: 41 42 4f 52 54 20 29 7b 0a 20 20 20 20 20 20 72  ABORT ){.      r
6560: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
6570: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 7a 45 72     }else if( zEr
6580: 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 54 63  rMsg ){.      Tc
6590: 6c 5f 53 65 74 52 65 73 75 6c 74 28 69 6e 74 65  l_SetResult(inte
65a0: 72 70 2c 20 7a 45 72 72 4d 73 67 2c 20 54 43 4c  rp, zErrMsg, TCL
65b0: 5f 56 4f 4c 41 54 49 4c 45 29 3b 0a 20 20 20 20  _VOLATILE);.    
65c0: 20 20 66 72 65 65 28 7a 45 72 72 4d 73 67 29 3b    free(zErrMsg);
65d0: 0a 20 20 20 20 20 20 72 63 20 3d 20 54 43 4c 5f  .      rc = TCL_
65e0: 45 52 52 4f 52 3b 0a 20 20 20 20 7d 65 6c 73 65  ERROR;.    }else
65f0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
6600: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f  OK ){.      Tcl_
6610: 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69 6e 74  AppendResult(int
6620: 65 72 70 2c 20 73 71 6c 69 74 65 33 45 72 72 53  erp, sqlite3ErrS
6630: 74 72 28 72 63 29 2c 20 30 29 3b 0a 20 20 20 20  tr(rc), 0);.    
6640: 20 20 72 63 20 3d 20 54 43 4c 5f 45 52 52 4f 52    rc = TCL_ERROR
6650: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 62 72 65 61  ;.    }.    brea
6660: 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a  k;.  }..  /*.  *
6670: 2a 20 20 20 20 20 24 64 62 20 72 65 6b 65 79 20  *     $db rekey 
6680: 4b 45 59 0a 20 20 2a 2a 0a 20 20 2a 2a 20 43 68  KEY.  **.  ** Ch
6690: 61 6e 67 65 20 74 68 65 20 65 6e 63 72 79 70 74  ange the encrypt
66a0: 69 6f 6e 20 6b 65 79 20 6f 6e 20 74 68 65 20 63  ion key on the c
66b0: 75 72 72 65 6e 74 6c 79 20 6f 70 65 6e 20 64 61  urrently open da
66c0: 74 61 62 61 73 65 2e 0a 20 20 2a 2f 0a 20 20 63  tabase..  */.  c
66d0: 61 73 65 20 44 42 5f 52 45 4b 45 59 3a 20 7b 0a  ase DB_REKEY: {.
66e0: 20 20 20 20 69 6e 74 20 6e 4b 65 79 3b 0a 20 20      int nKey;.  
66f0: 20 20 76 6f 69 64 20 2a 70 4b 65 79 3b 0a 20 20    void *pKey;.  
6700: 20 20 69 66 28 20 6f 62 6a 63 21 3d 33 20 29 7b    if( objc!=3 ){
6710: 0a 20 20 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67  .      Tcl_Wrong
6720: 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20  NumArgs(interp, 
6730: 32 2c 20 6f 62 6a 76 2c 20 22 4b 45 59 22 29 3b  2, objv, "KEY");
6740: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54 43  .      return TC
6750: 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20  L_ERROR;.    }. 
6760: 20 20 20 70 4b 65 79 20 3d 20 54 63 6c 5f 47 65     pKey = Tcl_Ge
6770: 74 42 79 74 65 41 72 72 61 79 46 72 6f 6d 4f 62  tByteArrayFromOb
6780: 6a 28 6f 62 6a 76 5b 32 5d 2c 20 26 6e 4b 65 79  j(objv[2], &nKey
6790: 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  );.#ifdef SQLITE
67a0: 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 20 20 72  _HAS_CODEC.    r
67b0: 63 20 3d 20 73 71 6c 69 74 65 33 5f 72 65 6b 65  c = sqlite3_reke
67c0: 79 28 70 44 62 2d 3e 64 62 2c 20 70 4b 65 79 2c  y(pDb->db, pKey,
67d0: 20 6e 4b 65 79 29 3b 0a 20 20 20 20 69 66 28 20   nKey);.    if( 
67e0: 72 63 20 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f  rc ){.      Tcl_
67f0: 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69 6e 74  AppendResult(int
6800: 65 72 70 2c 20 73 71 6c 69 74 65 33 45 72 72 53  erp, sqlite3ErrS
6810: 74 72 28 72 63 29 2c 20 30 29 3b 0a 20 20 20 20  tr(rc), 0);.    
6820: 20 20 72 63 20 3d 20 54 43 4c 5f 45 52 52 4f 52    rc = TCL_ERROR
6830: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20  ;.    }.#endif. 
6840: 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 0a 20     break;.  }.. 
6850: 20 2f 2a 0a 20 20 2a 2a 20 20 20 20 20 24 64 62   /*.  **     $db
6860: 20 74 69 6d 65 6f 75 74 20 4d 49 4c 4c 45 53 45   timeout MILLESE
6870: 43 4f 4e 44 53 0a 20 20 2a 2a 0a 20 20 2a 2a 20  CONDS.  **.  ** 
6880: 44 65 6c 61 79 20 66 6f 72 20 74 68 65 20 6e 75  Delay for the nu
6890: 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63  mber of millisec
68a0: 6f 6e 64 73 20 73 70 65 63 69 66 69 65 64 20 77  onds specified w
68b0: 68 65 6e 20 61 20 66 69 6c 65 20 69 73 20 6c 6f  hen a file is lo
68c0: 63 6b 65 64 2e 0a 20 20 2a 2f 0a 20 20 63 61 73  cked..  */.  cas
68d0: 65 20 44 42 5f 54 49 4d 45 4f 55 54 3a 20 7b 0a  e DB_TIMEOUT: {.
68e0: 20 20 20 20 69 6e 74 20 6d 73 3b 0a 20 20 20 20      int ms;.    
68f0: 69 66 28 20 6f 62 6a 63 21 3d 33 20 29 7b 0a 20  if( objc!=3 ){. 
6900: 20 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75       Tcl_WrongNu
6910: 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20 32 2c  mArgs(interp, 2,
6920: 20 6f 62 6a 76 2c 20 22 4d 49 4c 4c 49 53 45 43   objv, "MILLISEC
6930: 4f 4e 44 53 22 29 3b 0a 20 20 20 20 20 20 72 65  ONDS");.      re
6940: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
6950: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 54 63      }.    if( Tc
6960: 6c 5f 47 65 74 49 6e 74 46 72 6f 6d 4f 62 6a 28  l_GetIntFromObj(
6970: 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 32 5d 2c  interp, objv[2],
6980: 20 26 6d 73 29 20 29 20 72 65 74 75 72 6e 20 54   &ms) ) return T
6990: 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 73 71  CL_ERROR;.    sq
69a0: 6c 69 74 65 33 5f 62 75 73 79 5f 74 69 6d 65 6f  lite3_busy_timeo
69b0: 75 74 28 70 44 62 2d 3e 64 62 2c 20 6d 73 29 3b  ut(pDb->db, ms);
69c0: 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a  .    break;.  }.
69d0: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 20 20 20 20 24  .  /*.  **     $
69e0: 64 62 20 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73  db total_changes
69f0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 52 65 74 75 72  .  **.  ** Retur
6a00: 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  n the number of 
6a10: 72 6f 77 73 20 74 68 61 74 20 77 65 72 65 20 6d  rows that were m
6a20: 6f 64 69 66 69 65 64 2c 20 69 6e 73 65 72 74 65  odified, inserte
6a30: 64 2c 20 6f 72 20 64 65 6c 65 74 65 64 20 0a 20  d, or deleted . 
6a40: 20 2a 2a 20 73 69 6e 63 65 20 74 68 65 20 64 61   ** since the da
6a50: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 77 61  tabase handle wa
6a60: 73 20 63 72 65 61 74 65 64 2e 0a 20 20 2a 2f 0a  s created..  */.
6a70: 20 20 63 61 73 65 20 44 42 5f 54 4f 54 41 4c 5f    case DB_TOTAL_
6a80: 43 48 41 4e 47 45 53 3a 20 7b 0a 20 20 20 20 54  CHANGES: {.    T
6a90: 63 6c 5f 4f 62 6a 20 2a 70 52 65 73 75 6c 74 3b  cl_Obj *pResult;
6aa0: 0a 20 20 20 20 69 66 28 20 6f 62 6a 63 21 3d 32  .    if( objc!=2
6ab0: 20 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f 57 72   ){.      Tcl_Wr
6ac0: 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72  ongNumArgs(inter
6ad0: 70 2c 20 32 2c 20 6f 62 6a 76 2c 20 22 22 29 3b  p, 2, objv, "");
6ae0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54 43  .      return TC
6af0: 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20  L_ERROR;.    }. 
6b00: 20 20 20 70 52 65 73 75 6c 74 20 3d 20 54 63 6c     pResult = Tcl
6b10: 5f 47 65 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e  _GetObjResult(in
6b20: 74 65 72 70 29 3b 0a 20 20 20 20 54 63 6c 5f 53  terp);.    Tcl_S
6b30: 65 74 49 6e 74 4f 62 6a 28 70 52 65 73 75 6c 74  etIntObj(pResult
6b40: 2c 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c 5f  , sqlite3_total_
6b50: 63 68 61 6e 67 65 73 28 70 44 62 2d 3e 64 62 29  changes(pDb->db)
6b60: 29 3b 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  );.    break;.  
6b70: 7d 0a 0a 20 20 2f 2a 20 20 20 20 24 64 62 20 74  }..  /*    $db t
6b80: 72 61 63 65 20 3f 43 41 4c 4c 42 41 43 4b 3f 0a  race ?CALLBACK?.
6b90: 20 20 2a 2a 0a 20 20 2a 2a 20 4d 61 6b 65 20 61    **.  ** Make a
6ba0: 72 72 61 6e 67 65 6d 65 6e 74 73 20 74 6f 20 69  rrangements to i
6bb0: 6e 76 6f 6b 65 20 74 68 65 20 43 41 4c 4c 42 41  nvoke the CALLBA
6bc0: 43 4b 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 65  CK routine for e
6bd0: 61 63 68 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ach SQL statemen
6be0: 74 0a 20 20 2a 2a 20 74 68 61 74 20 69 73 20 65  t.  ** that is e
6bf0: 78 65 63 75 74 65 64 2e 20 20 54 68 65 20 74 65  xecuted.  The te
6c00: 78 74 20 6f 66 20 74 68 65 20 53 51 4c 20 69 73  xt of the SQL is
6c10: 20 61 70 70 65 6e 64 65 64 20 74 6f 20 43 41 4c   appended to CAL
6c20: 4c 42 41 43 4b 20 62 65 66 6f 72 65 0a 20 20 2a  LBACK before.  *
6c30: 2a 20 69 74 20 69 73 20 65 78 65 63 75 74 65 64  * it is executed
6c40: 2e 0a 20 20 2a 2f 0a 20 20 63 61 73 65 20 44 42  ..  */.  case DB
6c50: 5f 54 52 41 43 45 3a 20 7b 0a 20 20 20 20 69 66  _TRACE: {.    if
6c60: 28 20 6f 62 6a 63 3e 33 20 29 7b 0a 20 20 20 20  ( objc>3 ){.    
6c70: 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72    Tcl_WrongNumAr
6c80: 67 73 28 69 6e 74 65 72 70 2c 20 32 2c 20 6f 62  gs(interp, 2, ob
6c90: 6a 76 2c 20 22 3f 43 41 4c 4c 42 41 43 4b 3f 22  jv, "?CALLBACK?"
6ca0: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
6cb0: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d  TCL_ERROR;.    }
6cc0: 65 6c 73 65 20 69 66 28 20 6f 62 6a 63 3d 3d 32  else if( objc==2
6cd0: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 44   ){.      if( pD
6ce0: 62 2d 3e 7a 54 72 61 63 65 20 29 7b 0a 20 20 20  b->zTrace ){.   
6cf0: 20 20 20 20 20 54 63 6c 5f 41 70 70 65 6e 64 52       Tcl_AppendR
6d00: 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 70 44  esult(interp, pD
6d10: 62 2d 3e 7a 54 72 61 63 65 2c 20 30 29 3b 0a 20  b->zTrace, 0);. 
6d20: 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65       }.    }else
6d30: 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 7a 54  {.      char *zT
6d40: 72 61 63 65 3b 0a 20 20 20 20 20 20 69 6e 74 20  race;.      int 
6d50: 6c 65 6e 3b 0a 20 20 20 20 20 20 69 66 28 20 70  len;.      if( p
6d60: 44 62 2d 3e 7a 54 72 61 63 65 20 29 7b 0a 20 20  Db->zTrace ){.  
6d70: 20 20 20 20 20 20 54 63 6c 5f 46 72 65 65 28 70        Tcl_Free(p
6d80: 44 62 2d 3e 7a 54 72 61 63 65 29 3b 0a 20 20 20  Db->zTrace);.   
6d90: 20 20 20 7d 0a 20 20 20 20 20 20 7a 54 72 61 63     }.      zTrac
6da0: 65 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69 6e  e = Tcl_GetStrin
6db0: 67 46 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 32 5d  gFromObj(objv[2]
6dc0: 2c 20 26 6c 65 6e 29 3b 0a 20 20 20 20 20 20 69  , &len);.      i
6dd0: 66 28 20 7a 54 72 61 63 65 20 26 26 20 6c 65 6e  f( zTrace && len
6de0: 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44  >0 ){.        pD
6df0: 62 2d 3e 7a 54 72 61 63 65 20 3d 20 54 63 6c 5f  b->zTrace = Tcl_
6e00: 41 6c 6c 6f 63 28 20 6c 65 6e 20 2b 20 31 20 29  Alloc( len + 1 )
6e10: 3b 0a 20 20 20 20 20 20 20 20 73 74 72 63 70 79  ;.        strcpy
6e20: 28 70 44 62 2d 3e 7a 54 72 61 63 65 2c 20 7a 54  (pDb->zTrace, zT
6e30: 72 61 63 65 29 3b 0a 20 20 20 20 20 20 7d 65 6c  race);.      }el
6e40: 73 65 7b 0a 20 20 20 20 20 20 20 20 70 44 62 2d  se{.        pDb-
6e50: 3e 7a 54 72 61 63 65 20 3d 20 30 3b 0a 20 20 20  >zTrace = 0;.   
6e60: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70     }.      if( p
6e70: 44 62 2d 3e 7a 54 72 61 63 65 20 29 7b 0a 20 20  Db->zTrace ){.  
6e80: 20 20 20 20 20 20 70 44 62 2d 3e 69 6e 74 65 72        pDb->inter
6e90: 70 20 3d 20 69 6e 74 65 72 70 3b 0a 20 20 20 20  p = interp;.    
6ea0: 20 20 20 20 73 71 6c 69 74 65 33 5f 74 72 61 63      sqlite3_trac
6eb0: 65 28 70 44 62 2d 3e 64 62 2c 20 44 62 54 72 61  e(pDb->db, DbTra
6ec0: 63 65 48 61 6e 64 6c 65 72 2c 20 70 44 62 29 3b  ceHandler, pDb);
6ed0: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  .      }else{.  
6ee0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 74 72        sqlite3_tr
6ef0: 61 63 65 28 70 44 62 2d 3e 64 62 2c 20 30 2c 20  ace(pDb->db, 0, 
6f00: 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  0);.      }.    
6f10: 7d 0a 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d  }.    break;.  }
6f20: 0a 0a 20 20 7d 20 2f 2a 20 45 6e 64 20 6f 66 20  ..  } /* End of 
6f30: 74 68 65 20 53 57 49 54 43 48 20 73 74 61 74 65  the SWITCH state
6f40: 6d 65 6e 74 20 2a 2f 0a 20 20 72 65 74 75 72 6e  ment */.  return
6f50: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 20 20   rc;.}../*.**   
6f60: 73 71 6c 69 74 65 20 44 42 4e 41 4d 45 20 46 49  sqlite DBNAME FI
6f70: 4c 45 4e 41 4d 45 20 3f 4d 4f 44 45 3f 20 3f 2d  LENAME ?MODE? ?-
6f80: 6b 65 79 20 4b 45 59 3f 0a 2a 2a 0a 2a 2a 20 54  key KEY?.**.** T
6f90: 68 69 73 20 69 73 20 74 68 65 20 6d 61 69 6e 20  his is the main 
6fa0: 54 63 6c 20 63 6f 6d 6d 61 6e 64 2e 20 20 57 68  Tcl command.  Wh
6fb0: 65 6e 20 74 68 65 20 22 73 71 6c 69 74 65 22 20  en the "sqlite" 
6fc0: 54 63 6c 20 63 6f 6d 6d 61 6e 64 20 69 73 0a 2a  Tcl command is.*
6fd0: 2a 20 69 6e 76 6f 6b 65 64 2c 20 74 68 69 73 20  * invoked, this 
6fe0: 72 6f 75 74 69 6e 65 20 72 75 6e 73 20 74 6f 20  routine runs to 
6ff0: 70 72 6f 63 65 73 73 20 74 68 61 74 20 63 6f 6d  process that com
7000: 6d 61 6e 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  mand..**.** The 
7010: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2c 20  first argument, 
7020: 44 42 4e 41 4d 45 2c 20 69 73 20 61 6e 20 61 72  DBNAME, is an ar
7030: 62 69 74 72 61 72 79 20 6e 61 6d 65 20 66 6f 72  bitrary name for
7040: 20 61 20 6e 65 77 0a 2a 2a 20 64 61 74 61 62 61   a new.** databa
7050: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20  se connection.  
7060: 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 63 72 65  This command cre
7070: 61 74 65 73 20 61 20 6e 65 77 20 63 6f 6d 6d 61  ates a new comma
7080: 6e 64 20 6e 61 6d 65 64 0a 2a 2a 20 44 42 4e 41  nd named.** DBNA
7090: 4d 45 20 74 68 61 74 20 69 73 20 75 73 65 64 20  ME that is used 
70a0: 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 68 61 74 20  to control that 
70b0: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 54 68 65  connection.  The
70c0: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e   database.** con
70d0: 6e 65 63 74 69 6f 6e 20 69 73 20 64 65 6c 65 74  nection is delet
70e0: 65 64 20 77 68 65 6e 20 74 68 65 20 44 42 4e 41  ed when the DBNA
70f0: 4d 45 20 63 6f 6d 6d 61 6e 64 20 69 73 20 64 65  ME command is de
7100: 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  leted..**.** The
7110: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
7120: 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20   is the name of 
7130: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 74 68  the directory th
7140: 61 74 20 63 6f 6e 74 61 69 6e 73 0a 2a 2a 20 74  at contains.** t
7150: 68 65 20 73 71 6c 69 74 65 20 64 61 74 61 62 61  he sqlite databa
7160: 73 65 20 74 68 61 74 20 69 73 20 74 6f 20 62 65  se that is to be
7170: 20 61 63 63 65 73 73 65 64 2e 0a 2a 2a 0a 2a 2a   accessed..**.**
7180: 20 46 6f 72 20 74 65 73 74 69 6e 67 20 70 75 72   For testing pur
7190: 70 6f 73 65 73 2c 20 77 65 20 61 6c 73 6f 20 73  poses, we also s
71a0: 75 70 70 6f 72 74 20 74 68 65 20 66 6f 6c 6c 6f  upport the follo
71b0: 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 73 71 6c  wing:.**.**  sql
71c0: 69 74 65 20 2d 65 6e 63 6f 64 69 6e 67 0a 2a 2a  ite -encoding.**
71d0: 0a 2a 2a 20 20 20 20 20 20 20 52 65 74 75 72 6e  .**       Return
71e0: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 75 73   the encoding us
71f0: 65 64 20 62 79 20 4c 49 4b 45 20 61 6e 64 20 47  ed by LIKE and G
7200: 4c 4f 42 20 6f 70 65 72 61 74 6f 72 73 2e 20 20  LOB operators.  
7210: 43 68 6f 69 63 65 73 0a 2a 2a 20 20 20 20 20 20  Choices.**      
7220: 20 61 72 65 20 55 54 46 2d 38 20 61 6e 64 20 69   are UTF-8 and i
7230: 73 6f 38 38 35 39 2e 0a 2a 2a 0a 2a 2a 20 20 73  so8859..**.**  s
7240: 71 6c 69 74 65 20 2d 76 65 72 73 69 6f 6e 0a 2a  qlite -version.*
7250: 2a 0a 2a 2a 20 20 20 20 20 20 20 52 65 74 75 72  *.**       Retur
7260: 6e 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6e 75  n the version nu
7270: 6d 62 65 72 20 6f 66 20 74 68 65 20 53 51 4c 69  mber of the SQLi
7280: 74 65 20 6c 69 62 72 61 72 79 2e 0a 2a 2a 0a 2a  te library..**.*
7290: 2a 20 20 73 71 6c 69 74 65 20 2d 74 63 6c 2d 75  *  sqlite -tcl-u
72a0: 73 65 73 2d 75 74 66 0a 2a 2a 0a 2a 2a 20 20 20  ses-utf.**.**   
72b0: 20 20 20 20 52 65 74 75 72 6e 20 22 31 22 20 69      Return "1" i
72c0: 66 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20  f compiled with 
72d0: 61 20 54 63 6c 20 75 73 65 73 20 55 54 46 2d 38  a Tcl uses UTF-8
72e0: 2e 20 20 52 65 74 75 72 6e 20 22 30 22 20 69 66  .  Return "0" if
72f0: 0a 2a 2a 20 20 20 20 20 20 20 6e 6f 74 2e 20 20  .**       not.  
7300: 55 73 65 64 20 62 79 20 74 65 73 74 73 20 74 6f  Used by tests to
7310: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 6c   make sure the l
7320: 69 62 72 61 72 79 20 77 61 73 20 63 6f 6d 70 69  ibrary was compi
7330: 6c 65 64 20 0a 2a 2a 20 20 20 20 20 20 20 63 6f  led .**       co
7340: 72 72 65 63 74 6c 79 2e 0a 2a 2f 0a 73 74 61 74  rrectly..*/.stat
7350: 69 63 20 69 6e 74 20 44 62 4d 61 69 6e 28 76 6f  ic int DbMain(vo
7360: 69 64 20 2a 63 64 2c 20 54 63 6c 5f 49 6e 74 65  id *cd, Tcl_Inte
7370: 72 70 20 2a 69 6e 74 65 72 70 2c 20 69 6e 74 20  rp *interp, int 
7380: 6f 62 6a 63 2c 54 63 6c 5f 4f 62 6a 20 2a 63 6f  objc,Tcl_Obj *co
7390: 6e 73 74 2a 6f 62 6a 76 29 7b 0a 20 20 53 71 6c  nst*objv){.  Sql
73a0: 69 74 65 44 62 20 2a 70 3b 0a 20 20 76 6f 69 64  iteDb *p;.  void
73b0: 20 2a 70 4b 65 79 20 3d 20 30 3b 0a 20 20 69 6e   *pKey = 0;.  in
73c0: 74 20 6e 4b 65 79 20 3d 20 30 3b 0a 20 20 63 6f  t nKey = 0;.  co
73d0: 6e 73 74 20 63 68 61 72 20 2a 7a 41 72 67 3b 0a  nst char *zArg;.
73e0: 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 3b    char *zErrMsg;
73f0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
7400: 46 69 6c 65 3b 0a 20 20 63 68 61 72 20 7a 42 75  File;.  char zBu
7410: 66 5b 38 30 5d 3b 0a 20 20 69 66 28 20 6f 62 6a  f[80];.  if( obj
7420: 63 3d 3d 32 20 29 7b 0a 20 20 20 20 7a 41 72 67  c==2 ){.    zArg
7430: 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69 6e 67   = Tcl_GetString
7440: 46 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 31 5d 2c  FromObj(objv[1],
7450: 20 30 29 3b 0a 20 20 20 20 69 66 28 20 73 74 72   0);.    if( str
7460: 63 6d 70 28 7a 41 72 67 2c 22 2d 76 65 72 73 69  cmp(zArg,"-versi
7470: 6f 6e 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20  on")==0 ){.     
7480: 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c   Tcl_AppendResul
7490: 74 28 69 6e 74 65 72 70 2c 73 71 6c 69 74 65 33  t(interp,sqlite3
74a0: 5f 76 65 72 73 69 6f 6e 2c 30 29 3b 0a 20 20 20  _version,0);.   
74b0: 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b     return TCL_OK
74c0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20  ;.    }.    if( 
74d0: 73 74 72 63 6d 70 28 7a 41 72 67 2c 22 2d 68 61  strcmp(zArg,"-ha
74e0: 73 2d 63 6f 64 65 63 22 29 3d 3d 30 20 29 7b 0a  s-codec")==0 ){.
74f0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41  #ifdef SQLITE_HA
7500: 53 5f 43 4f 44 45 43 0a 20 20 20 20 20 20 54 63  S_CODEC.      Tc
7510: 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69  l_AppendResult(i
7520: 6e 74 65 72 70 2c 22 31 22 2c 30 29 3b 0a 23 65  nterp,"1",0);.#e
7530: 6c 73 65 0a 20 20 20 20 20 20 54 63 6c 5f 41 70  lse.      Tcl_Ap
7540: 70 65 6e 64 52 65 73 75 6c 74 28 69 6e 74 65 72  pendResult(inter
7550: 70 2c 22 30 22 2c 30 29 3b 0a 23 65 6e 64 69 66  p,"0",0);.#endif
7560: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54 43  .      return TC
7570: 4c 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  L_OK;.    }.    
7580: 69 66 28 20 73 74 72 63 6d 70 28 7a 41 72 67 2c  if( strcmp(zArg,
7590: 22 2d 74 63 6c 2d 75 73 65 73 2d 75 74 66 22 29  "-tcl-uses-utf")
75a0: 3d 3d 30 20 29 7b 0a 23 69 66 64 65 66 20 54 43  ==0 ){.#ifdef TC
75b0: 4c 5f 55 54 46 5f 4d 41 58 0a 20 20 20 20 20 20  L_UTF_MAX.      
75c0: 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74  Tcl_AppendResult
75d0: 28 69 6e 74 65 72 70 2c 22 31 22 2c 30 29 3b 0a  (interp,"1",0);.
75e0: 23 65 6c 73 65 0a 20 20 20 20 20 20 54 63 6c 5f  #else.      Tcl_
75f0: 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69 6e 74  AppendResult(int
7600: 65 72 70 2c 22 30 22 2c 30 29 3b 0a 23 65 6e 64  erp,"0",0);.#end
7610: 69 66 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  if.      return 
7620: 54 43 4c 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20  TCL_OK;.    }.  
7630: 7d 0a 20 20 69 66 28 20 6f 62 6a 63 3d 3d 35 20  }.  if( objc==5 
7640: 7c 7c 20 6f 62 6a 63 3d 3d 36 20 29 7b 0a 20 20  || objc==6 ){.  
7650: 20 20 7a 41 72 67 20 3d 20 54 63 6c 5f 47 65 74    zArg = Tcl_Get
7660: 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62  StringFromObj(ob
7670: 6a 76 5b 6f 62 6a 63 2d 32 5d 2c 20 30 29 3b 0a  jv[objc-2], 0);.
7680: 20 20 20 20 69 66 28 20 73 74 72 63 6d 70 28 7a      if( strcmp(z
7690: 41 72 67 2c 22 2d 6b 65 79 22 29 3d 3d 30 20 29  Arg,"-key")==0 )
76a0: 7b 0a 20 20 20 20 20 20 70 4b 65 79 20 3d 20 54  {.      pKey = T
76b0: 63 6c 5f 47 65 74 42 79 74 65 41 72 72 61 79 46  cl_GetByteArrayF
76c0: 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 6f 62 6a 63  romObj(objv[objc
76d0: 2d 31 5d 2c 20 26 6e 4b 65 79 29 3b 0a 20 20 20  -1], &nKey);.   
76e0: 20 20 20 6f 62 6a 63 20 2d 3d 20 32 3b 0a 20 20     objc -= 2;.  
76f0: 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6f 62    }.  }.  if( ob
7700: 6a 63 21 3d 33 20 26 26 20 6f 62 6a 63 21 3d 34  jc!=3 && objc!=4
7710: 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72 6f 6e   ){.    Tcl_Wron
7720: 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c  gNumArgs(interp,
7730: 20 31 2c 20 6f 62 6a 76 2c 20 0a 23 69 66 64 65   1, objv, .#ifde
7740: 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44  f SQLITE_HAS_COD
7750: 45 43 0a 20 20 20 20 20 20 22 48 41 4e 44 4c 45  EC.      "HANDLE
7760: 20 46 49 4c 45 4e 41 4d 45 20 3f 2d 6b 65 79 20   FILENAME ?-key 
7770: 43 4f 44 45 43 2d 4b 45 59 3f 22 0a 23 65 6c 73  CODEC-KEY?".#els
7780: 65 0a 20 20 20 20 20 20 22 48 41 4e 44 4c 45 20  e.      "HANDLE 
7790: 46 49 4c 45 4e 41 4d 45 20 3f 4d 4f 44 45 3f 22  FILENAME ?MODE?"
77a0: 0a 23 65 6e 64 69 66 0a 20 20 20 20 29 3b 0a 20  .#endif.    );. 
77b0: 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52     return TCL_ER
77c0: 52 4f 52 3b 0a 20 20 7d 0a 20 20 7a 45 72 72 4d  ROR;.  }.  zErrM
77d0: 73 67 20 3d 20 30 3b 0a 20 20 70 20 3d 20 28 53  sg = 0;.  p = (S
77e0: 71 6c 69 74 65 44 62 2a 29 54 63 6c 5f 41 6c 6c  qliteDb*)Tcl_All
77f0: 6f 63 28 20 73 69 7a 65 6f 66 28 2a 70 29 20 29  oc( sizeof(*p) )
7800: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 7b 0a  ;.  if( p==0 ){.
7810: 20 20 20 20 54 63 6c 5f 53 65 74 52 65 73 75 6c      Tcl_SetResul
7820: 74 28 69 6e 74 65 72 70 2c 20 22 6d 61 6c 6c 6f  t(interp, "mallo
7830: 63 20 66 61 69 6c 65 64 22 2c 20 54 43 4c 5f 53  c failed", TCL_S
7840: 54 41 54 49 43 29 3b 0a 20 20 20 20 72 65 74 75  TATIC);.    retu
7850: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
7860: 7d 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c  }.  memset(p, 0,
7870: 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20 20   sizeof(*p));.  
7880: 7a 46 69 6c 65 20 3d 20 54 63 6c 5f 47 65 74 53  zFile = Tcl_GetS
7890: 74 72 69 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62 6a  tringFromObj(obj
78a0: 76 5b 32 5d 2c 20 30 29 3b 0a 20 20 73 71 6c 69  v[2], 0);.  sqli
78b0: 74 65 33 5f 6f 70 65 6e 28 7a 46 69 6c 65 2c 20  te3_open(zFile, 
78c0: 26 70 2d 3e 64 62 29 3b 0a 20 20 69 66 28 20 53  &p->db);.  if( S
78d0: 51 4c 49 54 45 5f 4f 4b 21 3d 73 71 6c 69 74 65  QLITE_OK!=sqlite
78e0: 33 5f 65 72 72 63 6f 64 65 28 70 2d 3e 64 62 29  3_errcode(p->db)
78f0: 20 29 7b 0a 20 20 20 20 7a 45 72 72 4d 73 67 20   ){.    zErrMsg 
7900: 3d 20 73 74 72 64 75 70 28 73 71 6c 69 74 65 33  = strdup(sqlite3
7910: 5f 65 72 72 6d 73 67 28 70 2d 3e 64 62 29 29 3b  _errmsg(p->db));
7920: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6c 6f  .    sqlite3_clo
7930: 73 65 28 70 2d 3e 64 62 29 3b 0a 20 20 20 20 70  se(p->db);.    p
7940: 2d 3e 64 62 20 3d 20 30 3b 0a 20 20 7d 0a 23 69  ->db = 0;.  }.#i
7950: 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41 53 5f  fdef SQLITE_HAS_
7960: 43 4f 44 45 43 0a 20 20 73 71 6c 69 74 65 33 5f  CODEC.  sqlite3_
7970: 6b 65 79 28 70 2d 3e 64 62 2c 20 70 4b 65 79 2c  key(p->db, pKey,
7980: 20 6e 4b 65 79 29 3b 0a 23 65 6e 64 69 66 0a 20   nKey);.#endif. 
7990: 20 69 66 28 20 70 2d 3e 64 62 3d 3d 30 20 29 7b   if( p->db==0 ){
79a0: 0a 20 20 20 20 54 63 6c 5f 53 65 74 52 65 73 75  .    Tcl_SetResu
79b0: 6c 74 28 69 6e 74 65 72 70 2c 20 7a 45 72 72 4d  lt(interp, zErrM
79c0: 73 67 2c 20 54 43 4c 5f 56 4f 4c 41 54 49 4c 45  sg, TCL_VOLATILE
79d0: 29 3b 0a 20 20 20 20 54 63 6c 5f 46 72 65 65 28  );.    Tcl_Free(
79e0: 28 63 68 61 72 2a 29 70 29 3b 0a 20 20 20 20 66  (char*)p);.    f
79f0: 72 65 65 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20  ree(zErrMsg);.  
7a00: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
7a10: 4f 52 3b 0a 20 20 7d 0a 20 20 7a 41 72 67 20 3d  OR;.  }.  zArg =
7a20: 20 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 46 72   Tcl_GetStringFr
7a30: 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 31 5d 2c 20 30  omObj(objv[1], 0
7a40: 29 3b 0a 20 20 54 63 6c 5f 43 72 65 61 74 65 4f  );.  Tcl_CreateO
7a50: 62 6a 43 6f 6d 6d 61 6e 64 28 69 6e 74 65 72 70  bjCommand(interp
7a60: 2c 20 7a 41 72 67 2c 20 44 62 4f 62 6a 43 6d 64  , zArg, DbObjCmd
7a70: 2c 20 28 63 68 61 72 2a 29 70 2c 20 44 62 44 65  , (char*)p, DbDe
7a80: 6c 65 74 65 43 6d 64 29 3b 0a 0a 20 20 2f 2a 20  leteCmd);..  /* 
7a90: 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65  The return value
7aa0: 20 69 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66   is the value of
7ab0: 20 74 68 65 20 73 71 6c 69 74 65 2a 20 70 6f 69   the sqlite* poi
7ac0: 6e 74 65 72 0a 20 20 2a 2f 0a 20 20 73 70 72 69  nter.  */.  spri
7ad0: 6e 74 66 28 7a 42 75 66 2c 20 22 25 70 22 2c 20  ntf(zBuf, "%p", 
7ae0: 70 2d 3e 64 62 29 3b 0a 20 20 69 66 28 20 73 74  p->db);.  if( st
7af0: 72 6e 63 6d 70 28 7a 42 75 66 2c 22 30 78 22 2c  rncmp(zBuf,"0x",
7b00: 32 29 20 29 7b 0a 20 20 20 20 73 70 72 69 6e 74  2) ){.    sprint
7b10: 66 28 7a 42 75 66 2c 20 22 30 78 25 70 22 2c 20  f(zBuf, "0x%p", 
7b20: 70 2d 3e 64 62 29 3b 0a 20 20 7d 0a 20 20 54 63  p->db);.  }.  Tc
7b30: 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69  l_AppendResult(i
7b40: 6e 74 65 72 70 2c 20 7a 42 75 66 2c 20 30 29 3b  nterp, zBuf, 0);
7b50: 0a 0a 20 20 2f 2a 20 49 66 20 63 6f 6d 70 69 6c  ..  /* If compil
7b60: 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f 54  ed with SQLITE_T
7b70: 45 53 54 20 74 75 72 6e 65 64 20 6f 6e 2c 20 74  EST turned on, t
7b80: 68 65 6e 20 72 65 67 69 73 74 65 72 20 74 68 65  hen register the
7b90: 20 22 6d 64 35 73 75 6d 22 0a 20 20 2a 2a 20 53   "md5sum".  ** S
7ba0: 51 4c 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a  QL function..  *
7bb0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  /.#ifdef SQLITE_
7bc0: 54 45 53 54 0a 20 20 7b 0a 20 20 20 20 65 78 74  TEST.  {.    ext
7bd0: 65 72 6e 20 76 6f 69 64 20 4d 64 35 5f 52 65 67  ern void Md5_Reg
7be0: 69 73 74 65 72 28 73 71 6c 69 74 65 2a 29 3b 0a  ister(sqlite*);.
7bf0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
7c00: 42 55 47 0a 20 20 20 20 69 6e 74 20 6d 61 6c 6c  BUG.    int mall
7c10: 6f 63 66 61 69 6c 20 3d 20 73 71 6c 69 74 65 33  ocfail = sqlite3
7c20: 5f 69 4d 61 6c 6c 6f 63 46 61 69 6c 3b 0a 20 20  _iMallocFail;.  
7c30: 20 20 73 71 6c 69 74 65 33 5f 69 4d 61 6c 6c 6f    sqlite3_iMallo
7c40: 63 46 61 69 6c 20 3d 20 30 3b 0a 23 65 6e 64 69  cFail = 0;.#endi
7c50: 66 0a 20 20 20 20 4d 64 35 5f 52 65 67 69 73 74  f.    Md5_Regist
7c60: 65 72 28 70 2d 3e 64 62 29 3b 0a 23 69 66 64 65  er(p->db);.#ifde
7c70: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20  f SQLITE_DEBUG. 
7c80: 20 20 20 73 71 6c 69 74 65 33 5f 69 4d 61 6c 6c     sqlite3_iMall
7c90: 6f 63 46 61 69 6c 20 3d 20 6d 61 6c 6c 6f 63 66  ocFail = mallocf
7ca0: 61 69 6c 3b 0a 23 65 6e 64 69 66 0a 20 20 20 7d  ail;.#endif.   }
7cb0: 0a 23 65 6e 64 69 66 20 20 0a 20 20 70 2d 3e 69  .#endif  .  p->i
7cc0: 6e 74 65 72 70 20 3d 20 69 6e 74 65 72 70 3b 0a  nterp = interp;.
7cd0: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b    return TCL_OK;
7ce0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64  .}../*.** Provid
7cf0: 65 20 61 20 64 75 6d 6d 79 20 54 63 6c 5f 49 6e  e a dummy Tcl_In
7d00: 69 74 53 74 75 62 73 20 69 66 20 77 65 20 61 72  itStubs if we ar
7d10: 65 20 75 73 69 6e 67 20 74 68 69 73 20 61 73 20  e using this as 
7d20: 61 20 73 74 61 74 69 63 0a 2a 2a 20 6c 69 62 72  a static.** libr
7d30: 61 72 79 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20  ary..*/.#ifndef 
7d40: 55 53 45 5f 54 43 4c 5f 53 54 55 42 53 0a 23 20  USE_TCL_STUBS.# 
7d50: 75 6e 64 65 66 20 20 54 63 6c 5f 49 6e 69 74 53  undef  Tcl_InitS
7d60: 74 75 62 73 0a 23 20 64 65 66 69 6e 65 20 54 63  tubs.# define Tc
7d70: 6c 5f 49 6e 69 74 53 74 75 62 73 28 61 2c 62 2c  l_InitStubs(a,b,
7d80: 63 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  c).#endif../*.**
7d90: 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 69 73   Initialize this
7da0: 20 6d 6f 64 75 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54   module..**.** T
7db0: 68 69 73 20 54 63 6c 20 6d 6f 64 75 6c 65 20 63  his Tcl module c
7dc0: 6f 6e 74 61 69 6e 73 20 6f 6e 6c 79 20 61 20 73  ontains only a s
7dd0: 69 6e 67 6c 65 20 6e 65 77 20 54 63 6c 20 63 6f  ingle new Tcl co
7de0: 6d 6d 61 6e 64 20 6e 61 6d 65 64 20 22 73 71 6c  mmand named "sql
7df0: 69 74 65 22 2e 0a 2a 2a 20 28 48 65 6e 63 65 20  ite"..** (Hence 
7e00: 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 61 6d 65  there is no name
7e10: 73 70 61 63 65 2e 20 20 54 68 65 72 65 20 69 73  space.  There is
7e20: 20 6e 6f 20 70 6f 69 6e 74 20 69 6e 20 75 73 69   no point in usi
7e30: 6e 67 20 61 20 6e 61 6d 65 73 70 61 63 65 0a 2a  ng a namespace.*
7e40: 2a 20 69 66 20 74 68 65 20 65 78 74 65 6e 73 69  * if the extensi
7e50: 6f 6e 20 6f 6e 6c 79 20 73 75 70 70 6c 69 65 73  on only supplies
7e60: 20 6f 6e 65 20 6e 65 77 20 6e 61 6d 65 21 29 20   one new name!) 
7e70: 20 54 68 65 20 22 73 71 6c 69 74 65 22 20 63 6f   The "sqlite" co
7e80: 6d 6d 61 6e 64 20 69 73 0a 2a 2a 20 75 73 65 64  mmand is.** used
7e90: 20 74 6f 20 6f 70 65 6e 20 61 20 6e 65 77 20 53   to open a new S
7ea0: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 20  QLite database. 
7eb0: 20 53 65 65 20 74 68 65 20 44 62 4d 61 69 6e 28   See the DbMain(
7ec0: 29 20 72 6f 75 74 69 6e 65 20 61 62 6f 76 65 0a  ) routine above.
7ed0: 2a 2a 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61  ** for additiona
7ee0: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a  l information..*
7ef0: 2f 0a 69 6e 74 20 53 71 6c 69 74 65 33 5f 49 6e  /.int Sqlite3_In
7f00: 69 74 28 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69  it(Tcl_Interp *i
7f10: 6e 74 65 72 70 29 7b 0a 20 20 54 63 6c 5f 49 6e  nterp){.  Tcl_In
7f20: 69 74 53 74 75 62 73 28 69 6e 74 65 72 70 2c 20  itStubs(interp, 
7f30: 22 38 2e 30 22 2c 20 30 29 3b 0a 20 20 54 63 6c  "8.0", 0);.  Tcl
7f40: 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d 6d 61 6e  _CreateObjComman
7f50: 64 28 69 6e 74 65 72 70 2c 20 22 73 71 6c 69 74  d(interp, "sqlit
7f60: 65 33 22 2c 20 28 54 63 6c 5f 4f 62 6a 43 6d 64  e3", (Tcl_ObjCmd
7f70: 50 72 6f 63 2a 29 44 62 4d 61 69 6e 2c 20 30 2c  Proc*)DbMain, 0,
7f80: 20 30 29 3b 0a 20 20 54 63 6c 5f 50 6b 67 50 72   0);.  Tcl_PkgPr
7f90: 6f 76 69 64 65 28 69 6e 74 65 72 70 2c 20 22 73  ovide(interp, "s
7fa0: 71 6c 69 74 65 33 22 2c 20 22 33 2e 30 22 29 3b  qlite3", "3.0");
7fb0: 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b  .  return TCL_OK
7fc0: 3b 0a 7d 0a 69 6e 74 20 54 63 6c 73 71 6c 69 74  ;.}.int Tclsqlit
7fd0: 65 33 5f 49 6e 69 74 28 54 63 6c 5f 49 6e 74 65  e3_Init(Tcl_Inte
7fe0: 72 70 20 2a 69 6e 74 65 72 70 29 7b 0a 20 20 54  rp *interp){.  T
7ff0: 63 6c 5f 49 6e 69 74 53 74 75 62 73 28 69 6e 74  cl_InitStubs(int
8000: 65 72 70 2c 20 22 38 2e 30 22 2c 20 30 29 3b 0a  erp, "8.0", 0);.
8010: 20 20 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43    Tcl_CreateObjC
8020: 6f 6d 6d 61 6e 64 28 69 6e 74 65 72 70 2c 20 22  ommand(interp, "
8030: 73 71 6c 69 74 65 33 22 2c 20 28 54 63 6c 5f 4f  sqlite3", (Tcl_O
8040: 62 6a 43 6d 64 50 72 6f 63 2a 29 44 62 4d 61 69  bjCmdProc*)DbMai
8050: 6e 2c 20 30 2c 20 30 29 3b 0a 20 20 54 63 6c 5f  n, 0, 0);.  Tcl_
8060: 50 6b 67 50 72 6f 76 69 64 65 28 69 6e 74 65 72  PkgProvide(inter
8070: 70 2c 20 22 73 71 6c 69 74 65 33 22 2c 20 22 33  p, "sqlite3", "3
8080: 2e 30 22 29 3b 0a 20 20 72 65 74 75 72 6e 20 54  .0");.  return T
8090: 43 4c 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 53 71 6c  CL_OK;.}.int Sql
80a0: 69 74 65 33 5f 53 61 66 65 49 6e 69 74 28 54 63  ite3_SafeInit(Tc
80b0: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
80c0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  ){.  return TCL_
80d0: 4f 4b 3b 0a 7d 0a 69 6e 74 20 54 63 6c 73 71 6c  OK;.}.int Tclsql
80e0: 69 74 65 33 5f 53 61 66 65 49 6e 69 74 28 54 63  ite3_SafeInit(Tc
80f0: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
8100: 29 7b 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  ){.  return TCL_
8110: 4f 4b 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 54 43  OK;.}..#ifdef TC
8120: 4c 53 48 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  LSH./***********
8130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8170: 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 64 65 20 74  **.** The code t
8180: 68 61 74 20 66 6f 6c 6c 6f 77 73 20 69 73 20 75  hat follows is u
8190: 73 65 64 20 74 6f 20 62 75 69 6c 64 20 73 74 61  sed to build sta
81a0: 6e 64 61 6c 6f 6e 65 20 54 43 4c 20 69 6e 74 65  ndalone TCL inte
81b0: 72 70 72 65 74 65 72 73 0a 2a 2f 0a 0a 2f 2a 0a  rpreters.*/../*.
81c0: 2a 2a 20 49 66 20 74 68 65 20 6d 61 63 72 6f 20  ** If the macro 
81d0: 54 43 4c 53 48 20 69 73 20 6f 6e 65 2c 20 74 68  TCLSH is one, th
81e0: 65 6e 20 70 75 74 20 69 6e 20 63 6f 64 65 20 74  en put in code t
81f0: 68 69 73 20 66 6f 72 20 74 68 65 0a 2a 2a 20 22  his for the.** "
8200: 6d 61 69 6e 22 20 72 6f 75 74 69 6e 65 20 74 68  main" routine th
8210: 61 74 20 77 69 6c 6c 20 69 6e 69 74 69 61 6c 69  at will initiali
8220: 7a 65 20 54 63 6c 20 61 6e 64 20 74 61 6b 65 20  ze Tcl and take 
8230: 69 6e 70 75 74 20 66 72 6f 6d 0a 2a 2a 20 73 74  input from.** st
8240: 61 6e 64 61 72 64 20 69 6e 70 75 74 2e 0a 2a 2f  andard input..*/
8250: 0a 23 69 66 20 54 43 4c 53 48 3d 3d 31 0a 73 74  .#if TCLSH==1.st
8260: 61 74 69 63 20 63 68 61 72 20 7a 4d 61 69 6e 6c  atic char zMainl
8270: 6f 6f 70 5b 5d 20 3d 0a 20 20 22 73 65 74 20 6c  oop[] =.  "set l
8280: 69 6e 65 20 7b 7d 5c 6e 22 0a 20 20 22 77 68 69  ine {}\n".  "whi
8290: 6c 65 20 7b 21 5b 65 6f 66 20 73 74 64 69 6e 5d  le {![eof stdin]
82a0: 7d 20 7b 5c 6e 22 0a 20 20 20 20 22 69 66 20 7b  } {\n".    "if {
82b0: 24 6c 69 6e 65 21 3d 5c 22 5c 22 7d 20 7b 5c 6e  $line!=\"\"} {\n
82c0: 22 0a 20 20 20 20 20 20 22 70 75 74 73 20 2d 6e  ".      "puts -n
82d0: 6f 6e 65 77 6c 69 6e 65 20 5c 22 3e 20 5c 22 5c  onewline \"> \"\
82e0: 6e 22 0a 20 20 20 20 22 7d 20 65 6c 73 65 20 7b  n".    "} else {
82f0: 5c 6e 22 0a 20 20 20 20 20 20 22 70 75 74 73 20  \n".      "puts 
8300: 2d 6e 6f 6e 65 77 6c 69 6e 65 20 5c 22 25 20 5c  -nonewline \"% \
8310: 22 5c 6e 22 0a 20 20 20 20 22 7d 5c 6e 22 0a 20  "\n".    "}\n". 
8320: 20 20 20 22 66 6c 75 73 68 20 73 74 64 6f 75 74     "flush stdout
8330: 5c 6e 22 0a 20 20 20 20 22 61 70 70 65 6e 64 20  \n".    "append 
8340: 6c 69 6e 65 20 5b 67 65 74 73 20 73 74 64 69 6e  line [gets stdin
8350: 5d 5c 6e 22 0a 20 20 20 20 22 69 66 20 7b 5b 69  ]\n".    "if {[i
8360: 6e 66 6f 20 63 6f 6d 70 6c 65 74 65 20 24 6c 69  nfo complete $li
8370: 6e 65 5d 7d 20 7b 5c 6e 22 0a 20 20 20 20 20 20  ne]} {\n".      
8380: 22 69 66 20 7b 5b 63 61 74 63 68 20 7b 75 70 6c  "if {[catch {upl
8390: 65 76 65 6c 20 23 30 20 24 6c 69 6e 65 7d 20 72  evel #0 $line} r
83a0: 65 73 75 6c 74 5d 7d 20 7b 5c 6e 22 0a 20 20 20  esult]} {\n".   
83b0: 20 20 20 20 20 22 70 75 74 73 20 73 74 64 65 72       "puts stder
83c0: 72 20 5c 22 45 72 72 6f 72 3a 20 24 72 65 73 75  r \"Error: $resu
83d0: 6c 74 5c 22 5c 6e 22 0a 20 20 20 20 20 20 22 7d  lt\"\n".      "}
83e0: 20 65 6c 73 65 69 66 20 7b 24 72 65 73 75 6c 74   elseif {$result
83f0: 21 3d 5c 22 5c 22 7d 20 7b 5c 6e 22 0a 20 20 20  !=\"\"} {\n".   
8400: 20 20 20 20 20 22 70 75 74 73 20 24 72 65 73 75       "puts $resu
8410: 6c 74 5c 6e 22 0a 20 20 20 20 20 20 22 7d 5c 6e  lt\n".      "}\n
8420: 22 0a 20 20 20 20 20 20 22 73 65 74 20 6c 69 6e  ".      "set lin
8430: 65 20 7b 7d 5c 6e 22 0a 20 20 20 20 22 7d 20 65  e {}\n".    "} e
8440: 6c 73 65 20 7b 5c 6e 22 0a 20 20 20 20 20 20 22  lse {\n".      "
8450: 61 70 70 65 6e 64 20 6c 69 6e 65 20 5c 5c 6e 5c  append line \\n\
8460: 6e 22 0a 20 20 20 20 22 7d 5c 6e 22 0a 20 20 22  n".    "}\n".  "
8470: 7d 5c 6e 22 0a 3b 0a 23 65 6e 64 69 66 0a 0a 2f  }\n".;.#endif../
8480: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6d 61 63 72  *.** If the macr
8490: 6f 20 54 43 4c 53 48 20 69 73 20 74 77 6f 2c 20  o TCLSH is two, 
84a0: 74 68 65 6e 20 67 65 74 20 74 68 65 20 6d 61 69  then get the mai
84b0: 6e 20 6c 6f 6f 70 20 63 6f 64 65 20 6f 75 74 20  n loop code out 
84c0: 6f 66 0a 2a 2a 20 74 68 65 20 73 65 70 61 72 61  of.** the separa
84d0: 74 65 20 66 69 6c 65 20 22 73 70 61 63 65 61 6e  te file "spacean
84e0: 61 6c 5f 74 63 6c 2e 68 22 2e 0a 2a 2f 0a 23 69  al_tcl.h"..*/.#i
84f0: 66 20 54 43 4c 53 48 3d 3d 32 0a 73 74 61 74 69  f TCLSH==2.stati
8500: 63 20 63 68 61 72 20 7a 4d 61 69 6e 6c 6f 6f 70  c char zMainloop
8510: 5b 5d 20 3d 20 0a 23 69 6e 63 6c 75 64 65 20 22  [] = .#include "
8520: 73 70 61 63 65 61 6e 61 6c 5f 74 63 6c 2e 68 22  spaceanal_tcl.h"
8530: 0a 3b 0a 23 65 6e 64 69 66 0a 0a 23 64 65 66 69  .;.#endif..#defi
8540: 6e 65 20 54 43 4c 53 48 5f 4d 41 49 4e 20 6d 61  ne TCLSH_MAIN ma
8550: 69 6e 20 20 20 2f 2a 20 4e 65 65 64 65 64 20 74  in   /* Needed t
8560: 6f 20 66 61 6b 65 20 6f 75 74 20 6d 6b 74 63 6c  o fake out mktcl
8570: 61 70 70 20 2a 2f 0a 69 6e 74 20 54 43 4c 53 48  app */.int TCLSH
8580: 5f 4d 41 49 4e 28 69 6e 74 20 61 72 67 63 2c 20  _MAIN(int argc, 
8590: 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20  char **argv){.  
85a0: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
85b0: 72 70 3b 0a 20 20 54 63 6c 5f 46 69 6e 64 45 78  rp;.  Tcl_FindEx
85c0: 65 63 75 74 61 62 6c 65 28 61 72 67 76 5b 30 5d  ecutable(argv[0]
85d0: 29 3b 0a 20 20 69 6e 74 65 72 70 20 3d 20 54 63  );.  interp = Tc
85e0: 6c 5f 43 72 65 61 74 65 49 6e 74 65 72 70 28 29  l_CreateInterp()
85f0: 3b 0a 20 20 53 71 6c 69 74 65 33 5f 49 6e 69 74  ;.  Sqlite3_Init
8600: 28 69 6e 74 65 72 70 29 3b 0a 23 69 66 64 65 66  (interp);.#ifdef
8610: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 7b   SQLITE_TEST.  {
8620: 0a 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20  .    extern int 
8630: 53 71 6c 69 74 65 74 65 73 74 31 5f 49 6e 69 74  Sqlitetest1_Init
8640: 28 54 63 6c 5f 49 6e 74 65 72 70 2a 29 3b 0a 20  (Tcl_Interp*);. 
8650: 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 53 71     extern int Sq
8660: 6c 69 74 65 74 65 73 74 32 5f 49 6e 69 74 28 54  litetest2_Init(T
8670: 63 6c 5f 49 6e 74 65 72 70 2a 29 3b 0a 20 20 20  cl_Interp*);.   
8680: 20 65 78 74 65 72 6e 20 69 6e 74 20 53 71 6c 69   extern int Sqli
8690: 74 65 74 65 73 74 33 5f 49 6e 69 74 28 54 63 6c  tetest3_Init(Tcl
86a0: 5f 49 6e 74 65 72 70 2a 29 3b 0a 20 20 20 20 65  _Interp*);.    e
86b0: 78 74 65 72 6e 20 69 6e 74 20 53 71 6c 69 74 65  xtern int Sqlite
86c0: 74 65 73 74 34 5f 49 6e 69 74 28 54 63 6c 5f 49  test4_Init(Tcl_I
86d0: 6e 74 65 72 70 2a 29 3b 0a 20 20 20 20 65 78 74  nterp*);.    ext
86e0: 65 72 6e 20 69 6e 74 20 53 71 6c 69 74 65 74 65  ern int Sqlitete
86f0: 73 74 35 5f 49 6e 69 74 28 54 63 6c 5f 49 6e 74  st5_Init(Tcl_Int
8700: 65 72 70 2a 29 3b 0a 20 20 20 20 65 78 74 65 72  erp*);.    exter
8710: 6e 20 69 6e 74 20 4d 64 35 5f 49 6e 69 74 28 54  n int Md5_Init(T
8720: 63 6c 5f 49 6e 74 65 72 70 2a 29 3b 0a 20 20 20  cl_Interp*);.   
8730: 20 53 71 6c 69 74 65 74 65 73 74 31 5f 49 6e 69   Sqlitetest1_Ini
8740: 74 28 69 6e 74 65 72 70 29 3b 0a 20 20 20 20 53  t(interp);.    S
8750: 71 6c 69 74 65 74 65 73 74 32 5f 49 6e 69 74 28  qlitetest2_Init(
8760: 69 6e 74 65 72 70 29 3b 0a 20 20 20 20 53 71 6c  interp);.    Sql
8770: 69 74 65 74 65 73 74 33 5f 49 6e 69 74 28 69 6e  itetest3_Init(in
8780: 74 65 72 70 29 3b 0a 20 20 20 20 53 71 6c 69 74  terp);.    Sqlit
8790: 65 74 65 73 74 34 5f 49 6e 69 74 28 69 6e 74 65  etest4_Init(inte
87a0: 72 70 29 3b 0a 20 20 20 20 53 71 6c 69 74 65 74  rp);.    Sqlitet
87b0: 65 73 74 35 5f 49 6e 69 74 28 69 6e 74 65 72 70  est5_Init(interp
87c0: 29 3b 0a 20 20 20 20 4d 64 35 5f 49 6e 69 74 28  );.    Md5_Init(
87d0: 69 6e 74 65 72 70 29 3b 0a 20 20 7d 0a 23 65 6e  interp);.  }.#en
87e0: 64 69 66 0a 20 20 69 66 28 20 61 72 67 63 3e 3d  dif.  if( argc>=
87f0: 32 20 7c 7c 20 54 43 4c 53 48 3d 3d 32 20 29 7b  2 || TCLSH==2 ){
8800: 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20  .    int i;.    
8810: 54 63 6c 5f 53 65 74 56 61 72 28 69 6e 74 65 72  Tcl_SetVar(inter
8820: 70 2c 22 61 72 67 76 30 22 2c 61 72 67 76 5b 31  p,"argv0",argv[1
8830: 5d 2c 54 43 4c 5f 47 4c 4f 42 41 4c 5f 4f 4e 4c  ],TCL_GLOBAL_ONL
8840: 59 29 3b 0a 20 20 20 20 54 63 6c 5f 53 65 74 56  Y);.    Tcl_SetV
8850: 61 72 28 69 6e 74 65 72 70 2c 22 61 72 67 76 22  ar(interp,"argv"
8860: 2c 20 22 22 2c 20 54 43 4c 5f 47 4c 4f 42 41 4c  , "", TCL_GLOBAL
8870: 5f 4f 4e 4c 59 29 3b 0a 20 20 20 20 66 6f 72 28  _ONLY);.    for(
8880: 69 3d 32 3b 20 69 3c 61 72 67 63 3b 20 69 2b 2b  i=2; i<argc; i++
8890: 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f 53 65 74  ){.      Tcl_Set
88a0: 56 61 72 28 69 6e 74 65 72 70 2c 20 22 61 72 67  Var(interp, "arg
88b0: 76 22 2c 20 61 72 67 76 5b 69 5d 2c 0a 20 20 20  v", argv[i],.   
88c0: 20 20 20 20 20 20 20 54 43 4c 5f 47 4c 4f 42 41         TCL_GLOBA
88d0: 4c 5f 4f 4e 4c 59 20 7c 20 54 43 4c 5f 4c 49 53  L_ONLY | TCL_LIS
88e0: 54 5f 45 4c 45 4d 45 4e 54 20 7c 20 54 43 4c 5f  T_ELEMENT | TCL_
88f0: 41 50 50 45 4e 44 5f 56 41 4c 55 45 29 3b 0a 20  APPEND_VALUE);. 
8900: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 54 43 4c     }.    if( TCL
8910: 53 48 3d 3d 31 20 26 26 20 54 63 6c 5f 45 76 61  SH==1 && Tcl_Eva
8920: 6c 46 69 6c 65 28 69 6e 74 65 72 70 2c 20 61 72  lFile(interp, ar
8930: 67 76 5b 31 5d 29 21 3d 54 43 4c 5f 4f 4b 20 29  gv[1])!=TCL_OK )
8940: 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68  {.      const ch
8950: 61 72 20 2a 7a 49 6e 66 6f 20 3d 20 54 63 6c 5f  ar *zInfo = Tcl_
8960: 47 65 74 56 61 72 28 69 6e 74 65 72 70 2c 20 22  GetVar(interp, "
8970: 65 72 72 6f 72 49 6e 66 6f 22 2c 20 54 43 4c 5f  errorInfo", TCL_
8980: 47 4c 4f 42 41 4c 5f 4f 4e 4c 59 29 3b 0a 20 20  GLOBAL_ONLY);.  
8990: 20 20 20 20 69 66 28 20 7a 49 6e 66 6f 3d 3d 30      if( zInfo==0
89a0: 20 29 20 7a 49 6e 66 6f 20 3d 20 69 6e 74 65 72   ) zInfo = inter
89b0: 70 2d 3e 72 65 73 75 6c 74 3b 0a 20 20 20 20 20  p->result;.     
89c0: 20 66 70 72 69 6e 74 66 28 73 74 64 65 72 72 2c   fprintf(stderr,
89d0: 22 25 73 3a 20 25 73 5c 6e 22 2c 20 2a 61 72 67  "%s: %s\n", *arg
89e0: 76 2c 20 7a 49 6e 66 6f 29 3b 0a 20 20 20 20 20  v, zInfo);.     
89f0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d   return 1;.    }
8a00: 0a 20 20 7d 0a 20 20 69 66 28 20 61 72 67 63 3c  .  }.  if( argc<
8a10: 3d 31 20 7c 7c 20 54 43 4c 53 48 3d 3d 32 20 29  =1 || TCLSH==2 )
8a20: 7b 0a 20 20 20 20 54 63 6c 5f 47 6c 6f 62 61 6c  {.    Tcl_Global
8a30: 45 76 61 6c 28 69 6e 74 65 72 70 2c 20 7a 4d 61  Eval(interp, zMa
8a40: 69 6e 6c 6f 6f 70 29 3b 0a 20 20 7d 0a 20 20 72  inloop);.  }.  r
8a50: 65 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e 64 69  eturn 0;.}.#endi
8a60: 66 20 2f 2a 20 54 43 4c 53 48 20 2a 2f 0a 0a 23  f /* TCLSH */..#
8a70: 65 6e 64 69 66 20 2f 2a 20 21 64 65 66 69 6e 65  endif /* !define
8a80: 64 28 4e 4f 5f 54 43 4c 29 20 2a 2f 0a           d(NO_TCL) */.