sqllogictest
Hex Artifact Content
Not logged in

Artifact cf85c701bc25da1a0ee4d8d39bcbe1357d05bb3d:


0000: 2f 2a 0a 2a 2a 20 43 6f 70 79 72 69 67 68 74 20  /*.** Copyright 
0010: 28 63 29 20 32 30 30 38 20 44 2e 20 52 69 63 68  (c) 2008 D. Rich
0020: 61 72 64 20 48 69 70 70 0a 2a 2a 0a 2a 2a 20 54  ard Hipp.**.** T
0030: 68 69 73 20 70 72 6f 67 72 61 6d 20 69 73 20 66  his program is f
0040: 72 65 65 20 73 6f 66 74 77 61 72 65 3b 20 79 6f  ree software; yo
0050: 75 20 63 61 6e 20 72 65 64 69 73 74 72 69 62 75  u can redistribu
0060: 74 65 20 69 74 20 61 6e 64 2f 6f 72 0a 2a 2a 20  te it and/or.** 
0070: 6d 6f 64 69 66 79 20 69 74 20 75 6e 64 65 72 20  modify it under 
0080: 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65  the terms of the
0090: 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62   GNU General Pub
00a0: 6c 69 63 0a 2a 2a 20 4c 69 63 65 6e 73 65 20 76  lic.** License v
00b0: 65 72 73 69 6f 6e 20 32 20 61 73 20 70 75 62 6c  ersion 2 as publ
00c0: 69 73 68 65 64 20 62 79 20 74 68 65 20 46 72 65  ished by the Fre
00d0: 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64  e Software Found
00e0: 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  ation..**.** Thi
00f0: 73 20 70 72 6f 67 72 61 6d 20 69 73 20 64 69 73  s program is dis
0100: 74 72 69 62 75 74 65 64 20 69 6e 20 74 68 65 20  tributed in the 
0110: 68 6f 70 65 20 74 68 61 74 20 69 74 20 77 69 6c  hope that it wil
0120: 6c 20 62 65 20 75 73 65 66 75 6c 2c 0a 2a 2a 20  l be useful,.** 
0130: 62 75 74 20 57 49 54 48 4f 55 54 20 41 4e 59 20  but WITHOUT ANY 
0140: 57 41 52 52 41 4e 54 59 3b 20 77 69 74 68 6f 75  WARRANTY; withou
0150: 74 20 65 76 65 6e 20 74 68 65 20 69 6d 70 6c 69  t even the impli
0160: 65 64 20 77 61 72 72 61 6e 74 79 20 6f 66 0a 2a  ed warranty of.*
0170: 2a 20 4d 45 52 43 48 41 4e 54 41 42 49 4c 49 54  * MERCHANTABILIT
0180: 59 20 6f 72 20 46 49 54 4e 45 53 53 20 46 4f 52  Y or FITNESS FOR
0190: 20 41 20 50 41 52 54 49 43 55 4c 41 52 20 50 55   A PARTICULAR PU
01a0: 52 50 4f 53 45 2e 20 20 53 65 65 20 74 68 65 20  RPOSE.  See the 
01b0: 47 4e 55 0a 2a 2a 20 47 65 6e 65 72 61 6c 20 50  GNU.** General P
01c0: 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 66 6f  ublic License fo
01d0: 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a  r more details..
01e0: 2a 2a 20 0a 2a 2a 20 59 6f 75 20 73 68 6f 75 6c  ** .** You shoul
01f0: 64 20 68 61 76 65 20 72 65 63 65 69 76 65 64 20  d have received 
0200: 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 47 4e  a copy of the GN
0210: 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63  U General Public
0220: 0a 2a 2a 20 4c 69 63 65 6e 73 65 20 61 6c 6f 6e  .** License alon
0230: 67 20 77 69 74 68 20 74 68 69 73 20 6c 69 62 72  g with this libr
0240: 61 72 79 3b 20 69 66 20 6e 6f 74 2c 20 77 72 69  ary; if not, wri
0250: 74 65 20 74 6f 20 74 68 65 0a 2a 2a 20 46 72 65  te to the.** Fre
0260: 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64  e Software Found
0270: 61 74 69 6f 6e 2c 20 49 6e 63 2e 2c 20 35 39 20  ation, Inc., 59 
0280: 54 65 6d 70 6c 65 20 50 6c 61 63 65 20 2d 20 53  Temple Place - S
0290: 75 69 74 65 20 33 33 30 2c 0a 2a 2a 20 42 6f 73  uite 330,.** Bos
02a0: 74 6f 6e 2c 20 4d 41 20 20 30 32 31 31 31 2d 31  ton, MA  02111-1
02b0: 33 30 37 2c 20 55 53 41 2e 0a 2a 2a 0a 2a 2a 20  307, USA..**.** 
02c0: 41 75 74 68 6f 72 20 63 6f 6e 74 61 63 74 20 69  Author contact i
02d0: 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 20 20  nformation:.**  
02e0: 20 64 72 68 40 68 77 61 63 69 2e 63 6f 6d 0a 2a   drh@hwaci.com.*
02f0: 2a 20 20 20 68 74 74 70 3a 2f 2f 77 77 77 2e 68  *   http://www.h
0300: 77 61 63 69 2e 63 6f 6d 2f 64 72 68 2f 0a 2a 2a  waci.com/drh/.**
0310: 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  .***************
0320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0350: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0360: 0a 2a 2a 20 48 65 72 65 20 62 65 67 69 6e 73 20  .** Here begins 
0370: 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  the implementati
0380: 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65  on of the SQLite
0390: 20 44 62 45 6e 67 69 6e 65 20 6f 62 6a 65 63 74   DbEngine object
03a0: 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 69 73  ..**.** Use this
03b0: 20 69 6e 74 65 72 66 61 63 65 20 61 73 20 61 20   interface as a 
03c0: 6d 6f 64 65 6c 20 66 6f 72 20 6f 74 68 65 72 20  model for other 
03d0: 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20  database engine 
03e0: 69 6e 74 65 72 66 61 63 65 73 2e 0a 2a 2f 0a 23  interfaces..*/.#
03f0: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 33  include "sqlite3
0400: 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 3c 63 74  .h".#include <ct
0410: 79 70 65 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20  ype.h>.#include 
0420: 3c 73 74 64 69 6f 2e 68 3e 0a 0a 2f 2a 0a 2a 2a  <stdio.h>../*.**
0430: 20 54 68 65 20 53 51 4c 69 74 65 20 64 61 74 61   The SQLite data
0440: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
0450: 6f 62 6a 65 63 74 0a 2a 2f 0a 74 79 70 65 64 65  object.*/.typede
0460: 66 20 73 74 72 75 63 74 20 53 51 4c 69 74 65 43  f struct SQLiteC
0470: 6f 6e 6e 20 53 51 4c 69 74 65 43 6f 6e 6e 3b 0a  onn SQLiteConn;.
0480: 73 74 72 75 63 74 20 53 51 4c 69 74 65 43 6f 6e  struct SQLiteCon
0490: 6e 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  n {.  sqlite3 *d
04a0: 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  b;            /*
04b0: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 63 6f   The database co
04c0: 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 6e  nnection */.  un
04d0: 73 69 67 6e 65 64 20 66 6c 61 67 73 3b 20 20 20  signed flags;   
04e0: 20 20 20 20 20 20 2f 2a 20 56 61 72 69 6f 75 73        /* Various
04f0: 20 66 6c 61 67 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a   flags */.};../*
0500: 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75  .** Allowed valu
0510: 65 73 20 66 6f 72 20 53 51 4c 69 74 65 43 6f 6e  es for SQLiteCon
0520: 6e 2e 66 6c 61 67 73 0a 2a 2f 0a 23 64 65 66 69  n.flags.*/.#defi
0530: 6e 65 20 46 47 5f 49 4e 54 45 47 52 49 54 59 5f  ne FG_INTEGRITY_
0540: 43 48 45 43 4b 20 20 30 78 30 30 30 31 20 20 20  CHECK  0x0001   
0550: 20 2f 2a 20 52 75 6e 20 50 52 41 47 4d 41 20 69   /* Run PRAGMA i
0560: 6e 74 65 67 72 69 74 79 5f 63 68 65 63 6b 20 2a  ntegrity_check *
0570: 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 53 6b 69 70 20 66  /.../*.** Skip f
0580: 6f 72 77 61 72 64 20 6f 76 65 72 20 77 68 69 74  orward over whit
0590: 65 73 70 61 63 65 20 69 6e 20 61 20 73 74 72 69  espace in a stri
05a0: 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f  ng..*/.static co
05b0: 6e 73 74 20 63 68 61 72 20 2a 73 6b 69 70 57 68  nst char *skipWh
05c0: 69 74 65 73 70 61 63 65 28 63 6f 6e 73 74 20 63  itespace(const c
05d0: 68 61 72 20 2a 7a 29 7b 0a 20 20 77 68 69 6c 65  har *z){.  while
05e0: 28 20 69 73 73 70 61 63 65 28 2a 7a 29 20 29 7b  ( isspace(*z) ){
05f0: 20 7a 2b 2b 3b 20 7d 0a 20 20 72 65 74 75 72 6e   z++; }.  return
0600: 20 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6b 69   z;.}../*.** Ski
0610: 70 20 66 6f 72 77 61 72 64 20 74 6f 20 74 68 65  p forward to the
0620: 20 65 6e 64 20 6f 66 20 61 20 73 74 72 69 6e 67   end of a string
0630: 20 6f 72 20 70 61 73 74 20 74 68 65 20 6e 65 78   or past the nex
0640: 74 20 22 3b 22 20 63 68 61 72 61 63 74 65 72 0a  t ";" character.
0650: 2a 2a 20 69 6e 20 74 68 65 20 73 74 72 69 6e 67  ** in the string
0660: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73  ..*/.static cons
0670: 74 20 63 68 61 72 20 2a 73 6b 69 70 54 6f 4e 65  t char *skipToNe
0680: 78 74 50 61 72 61 6d 65 74 65 72 28 63 6f 6e 73  xtParameter(cons
0690: 74 20 63 68 61 72 20 2a 7a 29 7b 0a 20 20 77 68  t char *z){.  wh
06a0: 69 6c 65 28 20 7a 5b 30 5d 20 26 26 20 7a 5b 30  ile( z[0] && z[0
06b0: 5d 21 3d 27 3b 27 20 29 7b 20 7a 2b 2b 3b 20 7d  ]!=';' ){ z++; }
06c0: 0a 20 20 69 66 28 20 7a 5b 30 5d 3d 3d 27 3b 27  .  if( z[0]==';'
06d0: 20 29 20 7a 2b 2b 3b 0a 20 20 72 65 74 75 72 6e   ) z++;.  return
06e0: 20 73 6b 69 70 57 68 69 74 65 73 70 61 63 65 28   skipWhitespace(
06f0: 7a 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  z);.}../*.** Thi
0700: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c  s routine is cal
0710: 6c 65 64 20 74 6f 20 6f 70 65 6e 20 61 20 63 6f  led to open a co
0720: 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61 20 6e 65  nnection to a ne
0730: 77 2c 20 65 6d 70 74 79 20 64 61 74 61 62 61 73  w, empty databas
0740: 65 2e 0a 2a 2a 20 54 68 65 20 7a 43 6f 6e 6e 65  e..** The zConne
0750: 63 74 53 74 72 20 61 72 67 75 6d 65 6e 74 20 69  ctStr argument i
0760: 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74  s the value of t
0770: 68 65 20 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 63  he -connection c
0780: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 0a 2a 2a 20 6f  ommand-line.** o
0790: 70 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73 20  ption.  This is 
07a0: 69 6e 74 65 6e 64 65 64 20 74 6f 20 63 6f 6e 74  intended to cont
07b0: 61 69 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ain information 
07c0: 6f 6e 20 68 6f 77 20 74 6f 20 63 6f 6e 6e 65 63  on how to connec
07d0: 74 20 74 6f 0a 2a 2a 20 74 68 65 20 64 61 74 61  t to.** the data
07e0: 62 61 73 65 20 65 6e 67 69 6e 65 2e 20 20 54 68  base engine.  Th
07f0: 65 20 7a 43 6f 6e 6e 65 63 74 53 74 72 20 61 72  e zConnectStr ar
0800: 67 75 6d 65 6e 74 20 77 69 6c 6c 20 62 65 20 4e  gument will be N
0810: 55 4c 4c 20 69 66 20 74 68 65 72 65 0a 2a 2a 20  ULL if there.** 
0820: 69 73 20 6e 6f 20 2d 63 6f 6e 6e 65 63 74 69 6f  is no -connectio
0830: 6e 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64  n on the command
0840: 2d 6c 69 6e 65 2e 20 20 49 6e 20 74 68 65 20 63  -line.  In the c
0850: 61 73 65 20 6f 66 20 53 51 4c 69 74 65 2c 20 74  ase of SQLite, t
0860: 68 65 0a 2a 2a 20 7a 43 6f 6e 6e 65 63 74 53 74  he.** zConnectSt
0870: 72 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66  r is the name of
0880: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
0890: 6c 65 20 74 6f 20 6f 70 65 6e 2e 0a 2a 2a 0a 2a  le to open..**.*
08a0: 2a 20 41 6e 20 6f 62 6a 65 63 74 20 74 68 61 74  * An object that
08b0: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 6e   describes the n
08c0: 65 77 6c 79 20 6f 70 65 6e 65 64 20 61 6e 64 20  ewly opened and 
08d0: 69 6e 69 74 69 61 6c 69 7a 65 64 20 64 61 74 61  initialized data
08e0: 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69  base.** connecti
08f0: 6f 6e 20 69 73 20 72 65 74 75 72 6e 65 64 20 62  on is returned b
0900: 79 20 77 72 69 74 69 6e 67 20 69 6e 74 6f 20 2a  y writing into *
0910: 70 70 43 6f 6e 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68  ppConn..**.** Th
0920: 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72  is routine retur
0930: 6e 73 20 30 20 6f 6e 20 73 75 63 63 65 73 73 20  ns 0 on success 
0940: 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f 20 69 66 20  and non-zero if 
0950: 74 68 65 72 65 20 61 72 65 20 61 6e 79 20 65 72  there are any er
0960: 72 6f 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  rors..*/.static 
0970: 69 6e 74 20 73 71 6c 69 74 65 43 6f 6e 6e 65 63  int sqliteConnec
0980: 74 28 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73  t(.  void *NotUs
0990: 65 64 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ed,             
09a0: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 66 72 6f   /* Argument fro
09b0: 6d 20 44 62 45 6e 67 69 6e 65 20 6f 62 6a 65 63  m DbEngine objec
09c0: 74 2e 20 20 4e 6f 74 20 75 73 65 64 20 2a 2f 0a  t.  Not used */.
09d0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43    const char *zC
09e0: 6f 6e 6e 65 63 74 53 74 72 2c 20 20 20 20 2f 2a  onnectStr,    /*
09f0: 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 73 74 72 69   Connection stri
0a00: 6e 67 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 2a 70  ng */.  void **p
0a10: 70 43 6f 6e 6e 2c 20 20 20 20 20 20 20 20 20 20  pConn,          
0a20: 20 20 20 20 2f 2a 20 57 72 69 74 65 20 63 6f 6d      /* Write com
0a30: 70 6c 65 74 65 64 20 63 6f 6e 6e 65 63 74 69 6f  pleted connectio
0a40: 6e 20 68 65 72 65 20 2a 2f 0a 20 20 63 6f 6e 73  n here */.  cons
0a50: 74 20 63 68 61 72 20 2a 7a 50 61 72 61 6d 20 20  t char *zParam  
0a60: 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65          /* Value
0a70: 20 6f 66 20 74 68 65 20 2d 70 61 72 61 6d 65 74   of the -paramet
0a80: 65 72 73 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65  ers command-line
0a90: 20 6f 70 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20   option */.){.  
0aa0: 69 6e 74 20 72 63 3b 0a 20 20 53 51 4c 69 74 65  int rc;.  SQLite
0ab0: 43 6f 6e 6e 20 2a 70 3b 0a 0a 20 20 2f 2a 20 49  Conn *p;..  /* I
0ac0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  f the database f
0ad0: 69 6c 65 6e 61 6d 65 20 69 73 20 64 65 66 69 6e  ilename is defin
0ae0: 65 64 20 61 6e 64 20 74 68 65 20 64 61 74 61 62  ed and the datab
0af0: 61 73 65 20 61 6c 72 65 61 64 79 20 65 78 69 73  ase already exis
0b00: 74 73 2c 0a 20 20 2a 2a 20 74 68 65 6e 20 64 65  ts,.  ** then de
0b10: 6c 65 74 65 20 74 68 65 20 64 61 74 61 62 61 73  lete the databas
0b20: 65 20 62 65 66 6f 72 65 20 77 65 20 73 74 61 72  e before we star
0b30: 74 2c 20 74 68 75 73 20 72 65 73 65 74 74 69 6e  t, thus resettin
0b40: 67 20 69 74 20 74 6f 20 61 6e 0a 20 20 2a 2a 20  g it to an.  ** 
0b50: 65 6d 70 74 79 20 64 61 74 61 62 61 73 65 2e 0a  empty database..
0b60: 20 20 2a 2f 0a 20 20 69 66 28 20 7a 43 6f 6e 6e    */.  if( zConn
0b70: 65 63 74 53 74 72 3d 3d 30 20 29 20 7a 43 6f 6e  ectStr==0 ) zCon
0b80: 6e 65 63 74 53 74 72 20 3d 20 22 74 65 73 74 2e  nectStr = "test.
0b90: 64 62 22 3b 0a 20 20 69 66 28 20 7a 43 6f 6e 6e  db";.  if( zConn
0ba0: 65 63 74 53 74 72 20 26 26 20 7a 43 6f 6e 6e 65  ectStr && zConne
0bb0: 63 74 53 74 72 5b 30 5d 20 29 7b 0a 23 69 66 6e  ctStr[0] ){.#ifn
0bc0: 64 65 66 20 5f 57 49 4e 33 32 0a 20 20 20 20 75  def _WIN32.    u
0bd0: 6e 6c 69 6e 6b 28 7a 43 6f 6e 6e 65 63 74 53 74  nlink(zConnectSt
0be0: 72 29 3b 0a 23 65 6c 73 65 0a 20 20 20 20 5f 75  r);.#else.    _u
0bf0: 6e 6c 69 6e 6b 28 7a 43 6f 6e 6e 65 63 74 53 74  nlink(zConnectSt
0c00: 72 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 0a  r);.#endif.  }..
0c10: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61    p = sqlite3_ma
0c20: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 2a 70 29  lloc( sizeof(*p)
0c30: 20 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29   );.  if( p==0 )
0c40: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a  {.    return 1;.
0c50: 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20    }.  memset(p, 
0c60: 30 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a  0, sizeof(*p));.
0c70: 0a 20 20 2f 2a 20 4f 70 65 6e 20 61 20 63 6f 6e  .  /* Open a con
0c80: 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 6e  nection to the n
0c90: 65 77 20 64 61 74 61 62 61 73 65 2e 0a 20 20 2a  ew database..  *
0ca0: 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  /.  rc = sqlite3
0cb0: 5f 6f 70 65 6e 28 7a 43 6f 6e 6e 65 63 74 53 74  _open(zConnectSt
0cc0: 72 2c 20 26 70 2d 3e 64 62 29 3b 0a 20 20 69 66  r, &p->db);.  if
0cd0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
0ce0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66  ){.    sqlite3_f
0cf0: 72 65 65 28 70 29 3b 0a 20 20 20 20 72 65 74 75  ree(p);.    retu
0d00: 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20  rn 1;.  }.  if( 
0d10: 7a 50 61 72 61 6d 20 29 7b 0a 20 20 20 20 7a 50  zParam ){.    zP
0d20: 61 72 61 6d 20 3d 20 73 6b 69 70 57 68 69 74 65  aram = skipWhite
0d30: 73 70 61 63 65 28 7a 50 61 72 61 6d 29 3b 0a 20  space(zParam);. 
0d40: 20 20 20 77 68 69 6c 65 28 20 7a 50 61 72 61 6d     while( zParam
0d50: 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 69 66 28  [0] ){.      if(
0d60: 20 73 74 72 6e 63 6d 70 28 7a 50 61 72 61 6d 2c   strncmp(zParam,
0d70: 20 22 6f 70 74 69 6d 69 7a 65 72 3d 22 2c 20 31   "optimizer=", 1
0d80: 30 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  0)==0 ){.       
0d90: 20 69 6e 74 20 78 20 3d 20 61 74 6f 69 28 26 7a   int x = atoi(&z
0da0: 50 61 72 61 6d 5b 31 30 5d 29 3b 0a 20 20 20 20  Param[10]);.    
0db0: 20 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74      sqlite3_test
0dc0: 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f  _control(SQLITE_
0dd0: 54 45 53 54 43 54 52 4c 5f 4f 50 54 49 4d 49 5a  TESTCTRL_OPTIMIZ
0de0: 41 54 49 4f 4e 53 2c 20 70 2d 3e 64 62 2c 20 78  ATIONS, p->db, x
0df0: 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69  );.      }else i
0e00: 66 28 20 73 74 72 6e 63 6d 70 28 7a 50 61 72 61  f( strncmp(zPara
0e10: 6d 2c 20 22 69 6e 74 65 67 72 69 74 79 5f 63 68  m, "integrity_ch
0e20: 65 63 6b 22 2c 20 31 35 29 3d 3d 30 20 29 7b 0a  eck", 15)==0 ){.
0e30: 20 20 20 20 20 20 20 20 70 2d 3e 66 6c 61 67 73          p->flags
0e40: 20 7c 3d 20 46 47 5f 49 4e 54 45 47 52 49 54 59   |= FG_INTEGRITY
0e50: 5f 43 48 45 43 4b 3b 0a 20 20 20 20 20 20 7d 65  _CHECK;.      }e
0e60: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 66 70 72  lse{.        fpr
0e70: 69 6e 74 66 28 73 74 64 65 72 72 2c 20 22 75 6e  intf(stderr, "un
0e80: 6b 6e 6f 77 6e 20 70 61 72 61 6d 65 74 65 72 3a  known parameter:
0e90: 20 5b 25 73 5d 5c 6e 22 2c 20 7a 50 61 72 61 6d   [%s]\n", zParam
0ea0: 29 3b 0a 20 20 20 20 20 20 20 20 65 78 69 74 28  );.        exit(
0eb0: 31 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  1);.      }.    
0ec0: 20 20 7a 50 61 72 61 6d 20 3d 20 73 6b 69 70 54    zParam = skipT
0ed0: 6f 4e 65 78 74 50 61 72 61 6d 65 74 65 72 28 7a  oNextParameter(z
0ee0: 50 61 72 61 6d 29 3b 0a 20 20 20 20 7d 0a 20 20  Param);.    }.  
0ef0: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 65 78 65 63  }.  sqlite3_exec
0f00: 28 70 2d 3e 64 62 2c 20 22 50 52 41 47 4d 41 20  (p->db, "PRAGMA 
0f10: 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 4f 46 46 22  synchronous=OFF"
0f20: 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20 2a 70  , 0, 0, 0);.  *p
0f30: 70 43 6f 6e 6e 20 3d 20 28 76 6f 69 64 2a 29 70  pConn = (void*)p
0f40: 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 20 20 0a  ;.  return 0;  .
0f50: 7d 0a 0a 2f 2a 0a 2a 2a 20 45 76 61 6c 75 61 74  }../*.** Evaluat
0f60: 65 20 74 68 65 20 73 69 6e 67 6c 65 20 53 51 4c  e the single SQL
0f70: 20 73 74 61 74 65 6d 65 6e 74 20 67 69 76 65 6e   statement given
0f80: 20 69 6e 20 7a 53 71 6c 2e 20 20 52 65 74 75 72   in zSql.  Retur
0f90: 6e 20 30 20 6f 6e 20 73 75 63 63 65 73 73 2e 0a  n 0 on success..
0fa0: 2a 2a 20 72 65 74 75 72 6e 20 6e 6f 6e 2d 7a 65  ** return non-ze
0fb0: 72 6f 20 69 66 20 61 6e 79 20 65 72 72 6f 72 20  ro if any error 
0fc0: 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74 69  occurs..*/.stati
0fd0: 63 20 69 6e 74 20 73 71 6c 69 74 65 53 74 61 74  c int sqliteStat
0fe0: 65 6d 65 6e 74 28 0a 20 20 76 6f 69 64 20 2a 70  ement(.  void *p
0ff0: 43 6f 6e 6e 2c 20 20 20 20 20 20 20 20 20 20 20  Conn,           
1000: 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69       /* Connecti
1010: 6f 6e 20 63 72 65 61 74 65 64 20 62 79 20 78 43  on created by xC
1020: 6f 6e 6e 65 63 74 20 2a 2f 0a 20 20 63 6f 6e 73  onnect */.  cons
1030: 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20  t char *zSql,   
1040: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 20 73          /* SQL s
1050: 74 61 74 65 6d 65 6e 74 20 74 6f 20 65 76 61 6c  tatement to eval
1060: 75 61 74 65 20 2a 2f 0a 20 20 69 6e 74 20 62 51  uate */.  int bQ
1070: 75 69 65 74 20 20 20 20 20 20 20 20 20 20 20 20  uiet            
1080: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f        /* True to
1090: 20 73 75 70 70 72 65 73 73 20 70 72 69 6e 74 69   suppress printi
10a0: 6e 67 20 65 72 72 6f 72 73 2e 20 2a 2f 0a 29 7b  ng errors. */.){
10b0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 53 51 4c  .  int rc;.  SQL
10c0: 69 74 65 43 6f 6e 6e 20 2a 70 3b 0a 20 20 0a 0a  iteConn *p;.  ..
10d0: 20 20 70 20 3d 20 28 53 51 4c 69 74 65 43 6f 6e    p = (SQLiteCon
10e0: 6e 2a 29 70 43 6f 6e 6e 3b 0a 20 20 72 63 20 3d  n*)pConn;.  rc =
10f0: 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 70 2d   sqlite3_exec(p-
1100: 3e 64 62 2c 20 7a 53 71 6c 2c 20 30 2c 20 30 2c  >db, zSql, 0, 0,
1110: 20 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53   0);.  if( rc==S
1120: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 28 70 2d 3e  QLITE_OK && (p->
1130: 66 6c 61 67 73 20 26 20 46 47 5f 49 4e 54 45 47  flags & FG_INTEG
1140: 52 49 54 59 5f 43 48 45 43 4b 29 21 3d 30 20 29  RITY_CHECK)!=0 )
1150: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 74  {.    sqlite3_st
1160: 6d 74 20 2a 70 53 74 6d 74 3b 0a 20 20 20 20 72  mt *pStmt;.    r
1170: 63 20 3d 20 73 71 6c 69 74 65 33 5f 70 72 65 70  c = sqlite3_prep
1180: 61 72 65 5f 76 32 28 70 2d 3e 64 62 2c 20 22 50  are_v2(p->db, "P
1190: 52 41 47 4d 41 20 69 6e 74 65 67 72 69 74 79 5f  RAGMA integrity_
11a0: 63 68 65 63 6b 3b 22 2c 20 2d 31 2c 20 26 70 53  check;", -1, &pS
11b0: 74 6d 74 2c 20 30 29 3b 0a 20 20 20 20 69 66 28  tmt, 0);.    if(
11c0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
11d0: 7b 0a 20 20 20 20 20 20 66 70 72 69 6e 74 66 28  {.      fprintf(
11e0: 73 74 64 65 72 72 2c 20 22 63 61 6e 6e 6f 74 20  stderr, "cannot 
11f0: 70 72 65 70 61 72 65 20 69 6e 74 65 67 72 69 74  prepare integrit
1200: 79 5f 63 68 65 63 6b 5c 6e 22 29 3b 0a 20 20 20  y_check\n");.   
1210: 20 20 20 72 63 20 3d 20 31 3b 0a 20 20 20 20 7d     rc = 1;.    }
1220: 65 6c 73 65 7b 0a 20 20 20 20 20 20 63 68 61 72  else{.      char
1230: 20 2a 7a 3b 0a 20 20 20 20 20 20 69 66 28 20 73   *z;.      if( s
1240: 71 6c 69 74 65 33 5f 73 74 65 70 28 70 53 74 6d  qlite3_step(pStm
1250: 74 29 21 3d 53 51 4c 49 54 45 5f 52 4f 57 20 29  t)!=SQLITE_ROW )
1260: 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74  {.        fprint
1270: 66 28 73 74 64 65 72 72 2c 20 22 63 61 6e 6e 6f  f(stderr, "canno
1280: 74 20 72 75 6e 20 69 6e 74 65 67 72 69 74 79 5f  t run integrity_
1290: 63 68 65 63 6b 5c 6e 22 29 3b 0a 20 20 20 20 20  check\n");.     
12a0: 20 20 20 72 63 20 3d 20 31 3b 0a 20 20 20 20 20     rc = 1;.     
12b0: 20 7d 65 6c 73 65 20 69 66 28 20 28 7a 20 3d 20   }else if( (z = 
12c0: 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 63  (char*)sqlite3_c
12d0: 6f 6c 75 6d 6e 5f 74 65 78 74 28 70 53 74 6d 74  olumn_text(pStmt
12e0: 2c 30 29 29 3d 3d 30 0a 20 20 20 20 20 20 20 20  ,0))==0.        
12f0: 20 20 20 20 7c 7c 20 73 74 72 63 6d 70 28 7a 2c      || strcmp(z,
1300: 22 6f 6b 22 29 21 3d 30 0a 20 20 20 20 20 20 29  "ok")!=0.      )
1310: 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74  {.        fprint
1320: 66 28 73 74 64 65 72 72 2c 20 22 69 6e 74 65 67  f(stderr, "integ
1330: 72 69 74 79 5f 63 68 65 63 6b 20 72 65 74 75 72  rity_check retur
1340: 6e 73 3a 20 25 73 5c 6e 22 2c 20 7a 29 3b 0a 20  ns: %s\n", z);. 
1350: 20 20 20 20 20 20 20 72 63 20 3d 20 31 3b 0a 20         rc = 1;. 
1360: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
1370: 20 20 20 20 72 63 20 3d 20 30 3b 0a 20 20 20 20      rc = 0;.    
1380: 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65    }.      sqlite
1390: 33 5f 66 69 6e 61 6c 69 7a 65 28 70 53 74 6d 74  3_finalize(pStmt
13a0: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  );.    }.  }.  r
13b0: 65 74 75 72 6e 20 72 63 21 3d 53 51 4c 49 54 45  eturn rc!=SQLITE
13c0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 74  _OK;.}../*.** St
13d0: 72 75 63 74 75 72 65 20 75 73 65 64 20 74 6f 20  ructure used to 
13e0: 61 63 63 75 6d 75 6c 61 74 65 20 61 20 72 65 73  accumulate a res
13f0: 75 6c 74 20 73 65 74 2e 0a 2a 2f 0a 74 79 70 65  ult set..*/.type
1400: 64 65 66 20 73 74 72 75 63 74 20 52 65 73 41 63  def struct ResAc
1410: 63 75 6d 20 52 65 73 41 63 63 75 6d 3b 0a 73 74  cum ResAccum;.st
1420: 72 75 63 74 20 52 65 73 41 63 63 75 6d 20 7b 0a  ruct ResAccum {.
1430: 20 20 63 68 61 72 20 2a 2a 61 7a 56 61 6c 75 65    char **azValue
1440: 3b 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20  ;   /* Array of 
1450: 70 6f 69 6e 74 65 72 73 20 74 6f 20 76 61 6c 75  pointers to valu
1460: 65 73 2c 20 65 61 63 68 20 6d 61 6c 6c 6f 63 65  es, each malloce
1470: 64 20 73 65 70 61 72 61 74 65 6c 79 20 2a 2f 0a  d separately */.
1480: 20 20 69 6e 74 20 6e 41 6c 6c 6f 63 3b 20 20 20    int nAlloc;   
1490: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
14a0: 20 73 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 65 64   slots allocated
14b0: 20 69 6e 20 61 7a 56 61 6c 75 65 20 2a 2f 0a 20   in azValue */. 
14c0: 20 69 6e 74 20 6e 55 73 65 64 3b 20 20 20 20 20   int nUsed;     
14d0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
14e0: 73 6c 6f 74 73 20 69 6e 20 61 7a 56 61 6c 75 65  slots in azValue
14f0: 20 75 73 65 64 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a   used */.};../*.
1500: 2a 2a 20 41 70 70 65 6e 64 20 61 20 76 61 6c 75  ** Append a valu
1510: 65 20 74 6f 20 61 20 72 65 73 75 6c 74 20 73 65  e to a result se
1520: 74 2e 20 20 7a 56 61 6c 75 65 20 69 73 20 63 6f  t.  zValue is co
1530: 70 69 65 64 20 69 6e 74 6f 20 6d 65 6d 6f 72 79  pied into memory
1540: 20 6f 62 74 61 69 6e 65 64 0a 2a 2a 20 66 72 6f   obtained.** fro
1550: 6d 20 6d 61 6c 6c 6f 63 2e 20 20 4f 72 20 69 66  m malloc.  Or if
1560: 20 7a 56 61 6c 75 65 20 69 73 20 4e 55 4c 4c 2c   zValue is NULL,
1570: 20 74 68 65 6e 20 61 20 4e 55 4c 4c 20 70 6f 69   then a NULL poi
1580: 6e 74 65 72 20 69 73 20 61 70 70 65 6e 64 65 64  nter is appended
1590: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
15a0: 20 61 70 70 65 6e 64 56 61 6c 75 65 28 52 65 73   appendValue(Res
15b0: 41 63 63 75 6d 20 2a 70 2c 20 63 6f 6e 73 74 20  Accum *p, const 
15c0: 63 68 61 72 20 2a 7a 56 61 6c 75 65 29 7b 0a 20  char *zValue){. 
15d0: 20 63 68 61 72 20 2a 7a 3b 0a 20 20 69 66 28 20   char *z;.  if( 
15e0: 7a 56 61 6c 75 65 20 29 7b 0a 20 20 20 20 7a 20  zValue ){.    z 
15f0: 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74  = sqlite3_mprint
1600: 66 28 22 25 73 22 2c 20 7a 56 61 6c 75 65 29 3b  f("%s", zValue);
1610: 0a 20 20 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b  .    if( z==0 ){
1620: 0a 20 20 20 20 20 20 66 70 72 69 6e 74 66 28 73  .      fprintf(s
1630: 74 64 65 72 72 2c 20 22 6f 75 74 20 6f 66 20 6d  tderr, "out of m
1640: 65 6d 6f 72 79 20 61 74 20 25 73 3a 25 64 5c 6e  emory at %s:%d\n
1650: 22 2c 20 5f 5f 46 49 4c 45 5f 5f 2c 5f 5f 4c 49  ", __FILE__,__LI
1660: 4e 45 5f 5f 29 3b 0a 20 20 20 20 20 20 65 78 69  NE__);.      exi
1670: 74 28 31 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65  t(1);.    }.  }e
1680: 6c 73 65 7b 0a 20 20 20 20 7a 20 3d 20 30 3b 0a  lse{.    z = 0;.
1690: 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e 6e 55 73    }.  if( p->nUs
16a0: 65 64 3e 3d 70 2d 3e 6e 41 6c 6c 6f 63 20 29 7b  ed>=p->nAlloc ){
16b0: 0a 20 20 20 20 63 68 61 72 20 2a 2a 61 7a 3b 0a  .    char **az;.
16c0: 20 20 20 20 70 2d 3e 6e 41 6c 6c 6f 63 20 2b 3d      p->nAlloc +=
16d0: 20 32 30 30 3b 0a 20 20 20 20 61 7a 20 3d 20 73   200;.    az = s
16e0: 71 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 70  qlite3_realloc(p
16f0: 2d 3e 61 7a 56 61 6c 75 65 2c 20 70 2d 3e 6e 41  ->azValue, p->nA
1700: 6c 6c 6f 63 2a 73 69 7a 65 6f 66 28 70 2d 3e 61  lloc*sizeof(p->a
1710: 7a 56 61 6c 75 65 5b 30 5d 29 29 3b 0a 20 20 20  zValue[0]));.   
1720: 20 69 66 28 20 61 7a 3d 3d 30 20 29 7b 0a 20 20   if( az==0 ){.  
1730: 20 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 65      fprintf(stde
1740: 72 72 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f  rr, "out of memo
1750: 72 79 20 61 74 20 25 73 3a 25 64 5c 6e 22 2c 20  ry at %s:%d\n", 
1760: 5f 5f 46 49 4c 45 5f 5f 2c 5f 5f 4c 49 4e 45 5f  __FILE__,__LINE_
1770: 5f 29 3b 0a 20 20 20 20 20 20 65 78 69 74 28 31  _);.      exit(1
1780: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e  );.    }.    p->
1790: 61 7a 56 61 6c 75 65 20 3d 20 61 7a 3b 0a 20 20  azValue = az;.  
17a0: 7d 0a 20 20 70 2d 3e 61 7a 56 61 6c 75 65 5b 70  }.  p->azValue[p
17b0: 2d 3e 6e 55 73 65 64 2b 2b 5d 20 3d 20 7a 3b 0a  ->nUsed++] = z;.
17c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 6e  }../*.** This in
17d0: 74 65 72 66 61 63 65 20 72 75 6e 73 20 61 20 71  terface runs a q
17e0: 75 65 72 79 20 61 6e 64 20 61 63 63 75 6d 75 6c  uery and accumul
17f0: 61 74 65 73 20 74 68 65 20 72 65 73 75 6c 74 73  ates the results
1800: 20 69 6e 74 6f 20 61 6e 20 61 72 72 61 79 0a 2a   into an array.*
1810: 2a 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f  * of pointers to
1820: 20 73 74 72 69 6e 67 73 2e 20 20 2a 70 61 7a 52   strings.  *pazR
1830: 65 73 75 6c 74 20 69 73 20 6d 61 64 65 20 74 6f  esult is made to
1840: 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 72 65   point to the re
1850: 73 75 6c 74 69 6e 67 0a 2a 2a 20 61 72 72 61 79  sulting.** array
1860: 20 61 6e 64 20 2a 70 6e 52 65 73 75 6c 74 20 69   and *pnResult i
1870: 73 20 73 65 74 20 74 6f 20 74 68 65 20 6e 75 6d  s set to the num
1880: 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20  ber of elements 
1890: 69 6e 20 74 68 65 20 61 72 72 61 79 2e 0a 2a 2a  in the array..**
18a0: 0a 2a 2a 20 4e 55 4c 4c 20 76 61 6c 75 65 73 20  .** NULL values 
18b0: 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73 65  in the result se
18c0: 74 20 73 68 6f 75 6c 64 20 62 65 20 72 65 70 72  t should be repr
18d0: 65 73 65 6e 74 65 64 20 62 79 20 61 20 73 74 72  esented by a str
18e0: 69 6e 67 20 22 4e 55 4c 4c 22 2e 0a 2a 2a 20 45  ing "NULL"..** E
18f0: 6d 70 74 79 20 73 74 72 69 6e 67 73 20 73 68 6f  mpty strings sho
1900: 75 6c 64 20 62 65 20 73 68 6f 77 6e 20 61 73 20  uld be shown as 
1910: 22 28 65 6d 70 74 79 29 22 2e 20 20 55 6e 70 72  "(empty)".  Unpr
1920: 69 6e 74 61 62 6c 65 20 61 6e 64 0a 2a 2a 20 63  intable and.** c
1930: 6f 6e 74 72 6f 6c 20 63 68 61 72 61 63 74 65 72  ontrol character
1940: 73 20 73 68 6f 75 6c 64 20 62 65 20 72 65 6e 64  s should be rend
1950: 65 72 65 64 20 61 73 20 22 40 22 2e 0a 2a 2a 0a  ered as "@"..**.
1960: 2a 2a 20 52 65 74 75 72 6e 20 30 20 6f 6e 20 73  ** Return 0 on s
1970: 75 63 63 65 73 73 20 61 6e 64 20 31 20 69 66 20  uccess and 1 if 
1980: 74 68 65 72 65 20 69 73 20 61 6e 20 65 72 72 6f  there is an erro
1990: 72 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 6e 65  r.  It is not ne
19a0: 63 65 73 73 61 72 79 0a 2a 2a 20 74 6f 20 69 6e  cessary.** to in
19b0: 69 74 69 61 6c 69 7a 65 20 2a 70 61 7a 52 65 73  itialize *pazRes
19c0: 75 6c 74 20 6f 72 20 2a 70 6e 52 65 73 75 6c 74  ult or *pnResult
19d0: 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   if an error occ
19e0: 75 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  urs..*/.static i
19f0: 6e 74 20 73 71 6c 69 74 65 51 75 65 72 79 28 0a  nt sqliteQuery(.
1a00: 20 20 76 6f 69 64 20 2a 70 43 6f 6e 6e 2c 20 20    void *pConn,  
1a10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1a20: 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 63 72 65 61   Connection crea
1a30: 74 65 64 20 62 79 20 78 43 6f 6e 6e 65 63 74 20  ted by xConnect 
1a40: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
1a50: 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 20  *zSql,          
1a60: 20 2f 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e   /* SQL statemen
1a70: 74 20 74 6f 20 65 76 61 6c 75 61 74 65 20 2a 2f  t to evaluate */
1a80: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
1a90: 54 79 70 65 2c 20 20 20 20 20 20 20 20 20 20 2f  Type,          /
1aa0: 2a 20 4f 6e 65 20 63 68 61 72 61 63 74 65 72 20  * One character 
1ab0: 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20  for each column 
1ac0: 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a 20 20 63  of result */.  c
1ad0: 68 61 72 20 2a 2a 2a 70 61 7a 52 65 73 75 6c 74  har ***pazResult
1ae0: 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 45  ,          /* RE
1af0: 54 55 52 4e 3a 20 20 41 72 72 61 79 20 6f 66 20  TURN:  Array of 
1b00: 72 65 73 75 6c 74 20 76 61 6c 75 65 73 20 2a 2f  result values */
1b10: 0a 20 20 69 6e 74 20 2a 70 6e 52 65 73 75 6c 74  .  int *pnResult
1b20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1b30: 2a 20 52 45 54 55 52 4e 3a 20 20 4e 75 6d 62 65  * RETURN:  Numbe
1b40: 72 20 6f 66 20 72 65 73 75 6c 74 20 76 61 6c 75  r of result valu
1b50: 65 73 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74  es */.){.  sqlit
1b60: 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20  e3 *db;         
1b70: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61         /* The da
1b80: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
1b90: 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73  n */.  sqlite3_s
1ba0: 74 6d 74 20 2a 70 53 74 6d 74 3b 20 20 20 20 20  tmt *pStmt;     
1bb0: 20 20 20 2f 2a 20 50 72 65 70 61 72 65 64 20 73     /* Prepared s
1bc0: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 6e  tatement */.  in
1bd0: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20  t rc;           
1be0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73            /* Res
1bf0: 75 6c 74 20 63 6f 64 65 20 66 72 6f 6d 20 73 75  ult code from su
1c00: 62 72 6f 75 74 69 6e 65 20 63 61 6c 6c 73 20 2a  broutine calls *
1c10: 2f 0a 20 20 52 65 73 41 63 63 75 6d 20 72 65 73  /.  ResAccum res
1c20: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1c30: 2f 2a 20 71 75 65 72 79 20 72 65 73 75 6c 74 20  /* query result 
1c40: 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a 2f 0a 20  accumulator */. 
1c50: 20 53 51 4c 69 74 65 43 6f 6e 6e 20 2a 70 3b 20   SQLiteConn *p; 
1c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1c70: 54 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e  The database con
1c80: 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 68 61  nection */.  cha
1c90: 72 20 7a 42 75 66 66 65 72 5b 32 30 30 5d 3b 20  r zBuffer[200]; 
1ca0: 20 20 20 20 20 20 20 20 20 2f 2a 20 42 75 66 66           /* Buff
1cb0: 65 72 20 74 6f 20 72 65 6e 64 65 72 20 6e 75 6d  er to render num
1cc0: 62 65 72 73 20 2a 2f 0a 0a 20 20 6d 65 6d 73 65  bers */..  memse
1cd0: 74 28 26 72 65 73 2c 20 30 2c 20 73 69 7a 65 6f  t(&res, 0, sizeo
1ce0: 66 28 72 65 73 29 29 3b 0a 20 20 70 20 3d 20 28  f(res));.  p = (
1cf0: 53 51 4c 69 74 65 43 6f 6e 6e 2a 29 70 43 6f 6e  SQLiteConn*)pCon
1d00: 6e 3b 0a 20 20 64 62 20 3d 20 70 2d 3e 64 62 3b  n;.  db = p->db;
1d10: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f  .  rc = sqlite3_
1d20: 70 72 65 70 61 72 65 5f 76 32 28 64 62 2c 20 7a  prepare_v2(db, z
1d30: 53 71 6c 2c 20 2d 31 2c 20 26 70 53 74 6d 74 2c  Sql, -1, &pStmt,
1d40: 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53   0);.  if( rc!=S
1d50: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
1d60: 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65  sqlite3_finalize
1d70: 28 70 53 74 6d 74 29 3b 0a 20 20 20 20 72 65 74  (pStmt);.    ret
1d80: 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 69 66 28  urn 1;.  }.  if(
1d90: 20 73 74 72 6c 65 6e 28 7a 54 79 70 65 29 21 3d   strlen(zType)!=
1da0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63  sqlite3_column_c
1db0: 6f 75 6e 74 28 70 53 74 6d 74 29 20 29 7b 0a 20  ount(pStmt) ){. 
1dc0: 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 65 72     fprintf(stder
1dd0: 72 2c 20 22 77 72 6f 6e 67 20 6e 75 6d 62 65 72  r, "wrong number
1de0: 20 6f 66 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d   of result colum
1df0: 6e 73 3a 20 65 78 70 65 63 74 65 64 20 25 64 20  ns: expected %d 
1e00: 62 75 74 20 67 6f 74 20 25 64 5c 6e 22 2c 0a 20  but got %d\n",. 
1e10: 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 74 29             (int)
1e20: 73 74 72 6c 65 6e 28 7a 54 79 70 65 29 2c 20 73  strlen(zType), s
1e30: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f  qlite3_column_co
1e40: 75 6e 74 28 70 53 74 6d 74 29 29 3b 0a 20 20 20  unt(pStmt));.   
1e50: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 20   return 1;.  }. 
1e60: 20 77 68 69 6c 65 28 20 73 71 6c 69 74 65 33 5f   while( sqlite3_
1e70: 73 74 65 70 28 70 53 74 6d 74 29 3d 3d 53 51 4c  step(pStmt)==SQL
1e80: 49 54 45 5f 52 4f 57 20 29 7b 0a 20 20 20 20 69  ITE_ROW ){.    i
1e90: 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d  nt i;.    for(i=
1ea0: 30 3b 20 7a 54 79 70 65 5b 69 5d 3b 20 69 2b 2b  0; zType[i]; i++
1eb0: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c  ){.      if( sql
1ec0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65  ite3_column_type
1ed0: 28 70 53 74 6d 74 2c 20 69 29 3d 3d 53 51 4c 49  (pStmt, i)==SQLI
1ee0: 54 45 5f 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 20  TE_NULL ){.     
1ef0: 20 20 20 61 70 70 65 6e 64 56 61 6c 75 65 28 26     appendValue(&
1f00: 72 65 73 2c 20 22 4e 55 4c 4c 22 29 3b 0a 20 20  res, "NULL");.  
1f10: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
1f20: 20 20 20 73 77 69 74 63 68 28 20 7a 54 79 70 65     switch( zType
1f30: 5b 69 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 20  [i] ){.         
1f40: 20 63 61 73 65 20 27 54 27 3a 20 7b 0a 20 20 20   case 'T': {.   
1f50: 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63           const c
1f60: 68 61 72 20 2a 7a 56 61 6c 75 65 20 3d 20 28 63  har *zValue = (c
1f70: 6f 6e 73 74 20 63 68 61 72 2a 29 73 71 6c 69 74  onst char*)sqlit
1f80: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 70  e3_column_text(p
1f90: 53 74 6d 74 2c 20 69 29 3b 0a 20 20 20 20 20 20  Stmt, i);.      
1fa0: 20 20 20 20 20 20 63 68 61 72 20 2a 7a 3b 0a 20        char *z;. 
1fb0: 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 7a             if( z
1fc0: 56 61 6c 75 65 5b 30 5d 3d 3d 30 20 29 20 7a 56  Value[0]==0 ) zV
1fd0: 61 6c 75 65 20 3d 20 22 28 65 6d 70 74 79 29 22  alue = "(empty)"
1fe0: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 70  ;.            ap
1ff0: 70 65 6e 64 56 61 6c 75 65 28 26 72 65 73 2c 20  pendValue(&res, 
2000: 7a 56 61 6c 75 65 29 3b 0a 0a 20 20 20 20 20 20  zValue);..      
2010: 20 20 20 20 20 20 2f 2a 20 43 6f 6e 76 65 72 74        /* Convert
2020: 20 6e 6f 6e 2d 70 72 69 6e 74 69 6e 67 20 61 6e   non-printing an
2030: 64 20 63 6f 6e 74 72 6f 6c 20 63 68 61 72 61 63  d control charac
2040: 74 65 72 73 20 74 6f 20 27 40 27 20 2a 2f 0a 20  ters to '@' */. 
2050: 20 20 20 20 20 20 20 20 20 20 20 7a 20 3d 20 72             z = r
2060: 65 73 2e 61 7a 56 61 6c 75 65 5b 72 65 73 2e 6e  es.azValue[res.n
2070: 55 73 65 64 2d 31 5d 3b 0a 20 20 20 20 20 20 20  Used-1];.       
2080: 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a 20 29       while( *z )
2090: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  {.              
20a0: 69 66 28 20 2a 7a 3c 27 20 27 20 7c 7c 20 2a 7a  if( *z<' ' || *z
20b0: 3e 27 7e 27 20 29 7b 20 2a 7a 20 3d 20 27 40 27  >'~' ){ *z = '@'
20c0: 3b 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20  ; }.            
20d0: 20 20 7a 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20    z++;.         
20e0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20     }.           
20f0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
2100: 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 63 61    }.          ca
2110: 73 65 20 27 49 27 3a 20 7b 0a 20 20 20 20 20 20  se 'I': {.      
2120: 20 20 20 20 20 20 69 6e 74 20 69 69 20 3d 20 73        int ii = s
2130: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e  qlite3_column_in
2140: 74 28 70 53 74 6d 74 2c 20 69 29 3b 0a 20 20 20  t(pStmt, i);.   
2150: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
2160: 5f 73 6e 70 72 69 6e 74 66 28 73 69 7a 65 6f 66  _snprintf(sizeof
2170: 28 7a 42 75 66 66 65 72 29 2c 20 7a 42 75 66 66  (zBuffer), zBuff
2180: 65 72 2c 20 22 25 64 22 2c 20 69 69 29 3b 0a 20  er, "%d", ii);. 
2190: 20 20 20 20 20 20 20 20 20 20 20 61 70 70 65 6e             appen
21a0: 64 56 61 6c 75 65 28 26 72 65 73 2c 20 7a 42 75  dValue(&res, zBu
21b0: 66 66 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20  ffer);.         
21c0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
21d0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20      }.          
21e0: 63 61 73 65 20 27 52 27 3a 20 7b 0a 20 20 20 20  case 'R': {.    
21f0: 20 20 20 20 20 20 20 20 64 6f 75 62 6c 65 20 72          double r
2200: 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d   = sqlite3_colum
2210: 6e 5f 64 6f 75 62 6c 65 28 70 53 74 6d 74 2c 20  n_double(pStmt, 
2220: 69 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  i);.            
2230: 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66  sqlite3_snprintf
2240: 28 73 69 7a 65 6f 66 28 7a 42 75 66 66 65 72 29  (sizeof(zBuffer)
2250: 2c 20 7a 42 75 66 66 65 72 2c 20 22 25 2e 33 66  , zBuffer, "%.3f
2260: 22 2c 20 72 29 3b 0a 20 20 20 20 20 20 20 20 20  ", r);.         
2270: 20 20 20 61 70 70 65 6e 64 56 61 6c 75 65 28 26     appendValue(&
2280: 72 65 73 2c 20 7a 42 75 66 66 65 72 29 3b 0a 20  res, zBuffer);. 
2290: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b             break
22a0: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  ;.          }.  
22b0: 20 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a          default:
22c0: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73   {.            s
22d0: 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28  qlite3_finalize(
22e0: 70 53 74 6d 74 29 3b 0a 20 20 20 20 20 20 20 20  pStmt);.        
22f0: 20 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 65      fprintf(stde
2300: 72 72 2c 20 22 75 6e 6b 6e 6f 77 6e 20 63 68 61  rr, "unknown cha
2310: 72 61 63 74 65 72 20 69 6e 20 74 79 70 65 2d 73  racter in type-s
2320: 74 72 69 6e 67 3a 20 25 63 5c 6e 22 2c 20 7a 54  tring: %c\n", zT
2330: 79 70 65 5b 69 5d 29 3b 0a 20 20 20 20 20 20 20  ype[i]);.       
2340: 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20       return 1;. 
2350: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20           }.     
2360: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
2370: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33   }.  }.  sqlite3
2380: 5f 66 69 6e 61 6c 69 7a 65 28 70 53 74 6d 74 29  _finalize(pStmt)
2390: 3b 0a 20 20 2a 70 61 7a 52 65 73 75 6c 74 20 3d  ;.  *pazResult =
23a0: 20 72 65 73 2e 61 7a 56 61 6c 75 65 3b 0a 20 20   res.azValue;.  
23b0: 2a 70 6e 52 65 73 75 6c 74 20 3d 20 72 65 73 2e  *pnResult = res.
23c0: 6e 55 73 65 64 3b 0a 20 20 72 65 74 75 72 6e 20  nUsed;.  return 
23d0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  0;.}../*.** This
23e0: 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 63 61   interface is ca
23f0: 6c 6c 65 64 20 74 6f 20 66 72 65 65 20 74 68 65  lled to free the
2400: 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 77 61 73   memory that was
2410: 20 72 65 74 75 72 6e 65 64 0a 2a 2a 20 62 79 20   returned.** by 
2420: 78 51 75 65 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 74  xQuery..**.** It
2430: 20 6d 69 67 68 74 20 62 65 20 74 68 65 20 63 61   might be the ca
2440: 73 65 20 74 68 61 74 20 6e 52 65 73 75 6c 74 3d  se that nResult=
2450: 3d 30 20 6f 72 20 61 7a 52 65 73 75 6c 74 3d 3d  =0 or azResult==
2460: 30 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  0..*/.static int
2470: 20 73 71 6c 69 74 65 46 72 65 65 52 65 73 75 6c   sqliteFreeResul
2480: 74 73 28 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6e  ts(.  void *pCon
2490: 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  n,              
24a0: 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20    /* Connection 
24b0: 63 72 65 61 74 65 64 20 62 79 20 78 43 6f 6e 6e  created by xConn
24c0: 65 63 74 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a  ect */.  char **
24d0: 61 7a 52 65 73 75 6c 74 2c 20 20 20 20 20 20 20  azResult,       
24e0: 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65 73 75       /* The resu
24f0: 6c 74 73 20 74 6f 20 62 65 20 66 72 65 65 64 20  lts to be freed 
2500: 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 73 75 6c 74  */.  int nResult
2510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2520: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 6f   /* Number of ro
2530: 77 73 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a  ws of result */.
2540: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f  ){.  int i;.  fo
2550: 72 28 69 3d 30 3b 20 69 3c 6e 52 65 73 75 6c 74  r(i=0; i<nResult
2560: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69  ; i++){.    sqli
2570: 74 65 33 5f 66 72 65 65 28 61 7a 52 65 73 75 6c  te3_free(azResul
2580: 74 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20 73 71 6c  t[i]);.  }.  sql
2590: 69 74 65 33 5f 66 72 65 65 28 61 7a 52 65 73 75  ite3_free(azResu
25a0: 6c 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b  lt);.  return 0;
25b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
25c0: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64  outine is called
25d0: 20 74 6f 20 63 6c 6f 73 65 20 61 20 63 6f 6e 6e   to close a conn
25e0: 65 63 74 69 6f 6e 20 70 72 65 76 69 6f 75 73 6c  ection previousl
25f0: 79 20 6f 70 65 6e 65 64 0a 2a 2a 20 62 79 20 78  y opened.** by x
2600: 43 6f 6e 6e 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54  Connect..**.** T
2610: 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 61 79 20  his routine may 
2620: 6f 72 20 6d 61 79 20 6e 6f 74 20 64 65 6c 65 74  or may not delet
2630: 65 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20  e the database. 
2640: 20 57 68 69 63 68 65 76 65 72 20 77 61 79 0a 2a   Whichever way.*
2650: 2a 20 69 74 20 77 6f 72 6b 73 2c 20 73 74 65 70  * it works, step
2660: 73 20 73 68 6f 75 6c 64 20 62 65 20 74 61 6b 65  s should be take
2670: 6e 20 74 6f 20 61 76 6f 69 64 20 61 6e 20 61 63  n to avoid an ac
2680: 63 75 6d 75 6c 61 74 69 6f 6e 20 6f 66 20 6c 65  cumulation of le
2690: 66 74 2d 6f 76 65 72 0a 2a 2a 20 64 61 74 61 62  ft-over.** datab
26a0: 61 73 65 20 66 69 6c 65 73 2e 20 20 49 66 20 74  ase files.  If t
26b0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 64  he database is d
26c0: 65 6c 65 74 65 64 20 68 65 72 65 2c 20 74 68 61  eleted here, tha
26d0: 74 20 69 73 20 6f 6e 65 20 61 70 70 72 6f 61 63  t is one approac
26e0: 68 2e 0a 2a 2a 20 54 68 65 20 6f 74 68 65 72 20  h..** The other 
26f0: 61 70 70 72 6f 61 63 68 20 69 73 20 74 6f 20 64  approach is to d
2700: 65 6c 65 74 65 20 6c 65 66 74 2d 6f 76 65 72 20  elete left-over 
2710: 64 61 74 61 62 61 73 65 73 20 69 6e 20 74 68 65  databases in the
2720: 20 78 43 6f 6e 6e 65 63 74 0a 2a 2a 20 6d 65 74   xConnect.** met
2730: 68 6f 64 2e 20 20 54 68 65 20 53 51 4c 69 74 65  hod.  The SQLite
2740: 20 69 6e 74 65 72 66 61 63 65 20 74 61 6b 65 73   interface takes
2750: 20 74 68 65 20 6c 61 74 74 65 72 20 61 70 70 72   the latter appr
2760: 6f 61 63 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  oach..*/.static 
2770: 69 6e 74 20 73 71 6c 69 74 65 44 69 73 63 6f 6e  int sqliteDiscon
2780: 6e 65 63 74 28 0a 20 20 76 6f 69 64 20 2a 70 43  nect(.  void *pC
2790: 6f 6e 6e 20 20 20 20 20 20 20 20 20 20 20 20 20  onn             
27a0: 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f      /* Connectio
27b0: 6e 20 63 72 65 61 74 65 64 20 62 79 20 78 43 6f  n created by xCo
27c0: 6e 6e 65 63 74 20 2a 2f 0a 29 7b 0a 20 20 53 51  nnect */.){.  SQ
27d0: 4c 69 74 65 43 6f 6e 6e 20 2a 70 20 3d 20 28 53  LiteConn *p = (S
27e0: 51 4c 69 74 65 43 6f 6e 6e 2a 29 70 43 6f 6e 6e  QLiteConn*)pConn
27f0: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63  ;.  int rc;.  rc
2800: 20 3d 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65   = sqlite3_close
2810: 28 70 2d 3e 64 62 29 3b 0a 20 20 73 71 6c 69 74  (p->db);.  sqlit
2820: 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 69 66  e3_free(p);.  if
2830: 28 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79  ( sqlite3_memory
2840: 5f 75 73 65 64 28 29 3e 30 20 29 7b 0a 20 20 20  _used()>0 ){.   
2850: 20 66 70 72 69 6e 74 66 28 73 74 64 65 72 72 2c   fprintf(stderr,
2860: 20 22 6d 65 6d 6f 72 79 20 6c 65 61 6b 20 61 66   "memory leak af
2870: 74 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 63  ter connection c
2880: 6c 6f 73 65 5c 6e 22 29 3b 0a 20 20 20 20 72 63  lose\n");.    rc
2890: 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75   = 1;.  }.  retu
28a0: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
28b0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
28c0: 63 61 6c 6c 65 64 20 74 6f 20 72 65 74 75 72 6e  called to return
28d0: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65   the name of the
28e0: 20 44 42 20 65 6e 67 69 6e 65 0a 2a 2a 20 75 73   DB engine.** us
28f0: 65 64 20 62 79 20 74 68 65 20 63 6f 6e 6e 65 63  ed by the connec
2900: 74 69 6f 6e 20 70 43 6f 6e 6e 2e 20 20 54 68 69  tion pConn.  Thi
2910: 73 20 6e 61 6d 65 20 6d 61 79 20 6f 72 20 6d 61  s name may or ma
2920: 79 20 6e 6f 74 0a 2a 2a 20 62 65 20 74 68 65 20  y not.** be the 
2930: 73 61 6d 65 20 61 73 20 73 70 65 63 69 66 69 65  same as specifie
2940: 64 20 69 6e 20 74 68 65 20 44 62 45 6e 67 69 6e  d in the DbEngin
2950: 65 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a  e structure..**.
2960: 2a 2a 20 54 68 65 6e 20 72 65 74 75 72 6e 65 64  ** Then returned
2970: 20 44 42 20 6e 61 6d 65 20 64 6f 65 73 20 6e 6f   DB name does no
2980: 74 20 68 61 76 65 20 74 6f 20 62 65 20 66 72 65  t have to be fre
2990: 65 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 64  ed by the called
29a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ..**.** This rou
29b0: 74 69 6e 65 20 73 68 6f 75 6c 64 20 62 65 20 63  tine should be c
29c0: 61 6c 6c 65 64 20 6f 6e 6c 79 20 61 66 74 65 72  alled only after
29d0: 20 61 20 76 61 6c 69 64 20 63 6f 6e 6e 65 63 74   a valid connect
29e0: 69 6f 6e 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20  ion.** has been 
29f0: 65 73 74 61 62 6c 69 68 65 64 20 77 69 74 68 20  establihed with 
2a00: 78 43 6f 6e 6e 65 63 74 2e 0a 2a 2a 0a 2a 2a 20  xConnect..**.** 
2a10: 46 6f 72 20 4f 44 42 43 20 63 6f 6e 6e 65 63 74  For ODBC connect
2a20: 69 6f 6e 73 2c 20 74 68 65 20 65 6e 67 69 6e 65  ions, the engine
2a30: 20 6e 61 6d 65 20 69 73 20 72 65 73 6f 6c 76 65   name is resolve
2a40: 64 20 62 79 20 74 68 65 20 0a 2a 2a 20 64 72 69  d by the .** dri
2a50: 76 65 72 20 6d 61 6e 61 67 65 72 20 61 66 74 65  ver manager afte
2a60: 72 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69  r a connection i
2a70: 73 20 6d 61 64 65 2e 0a 2a 2f 0a 73 74 61 74 69  s made..*/.stati
2a80: 63 20 69 6e 74 20 73 71 6c 69 74 65 47 65 74 45  c int sqliteGetE
2a90: 6e 67 69 6e 65 4e 61 6d 65 28 0a 20 20 76 6f 69  ngineName(.  voi
2aa0: 64 20 2a 70 43 6f 6e 6e 2c 20 20 20 20 20 20 20  d *pConn,       
2ab0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e           /* Conn
2ac0: 65 63 74 69 6f 6e 20 63 72 65 61 74 65 64 20 62  ection created b
2ad0: 79 20 78 43 6f 6e 6e 65 63 74 20 2a 2f 0a 20 20  y xConnect */.  
2ae0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 7a 4e 61  const char **zNa
2af0: 6d 65 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53  me          /* S
2b00: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 20  QL statement to 
2b10: 65 76 61 6c 75 61 74 65 20 2a 2f 0a 29 7b 0a 20  evaluate */.){. 
2b20: 20 73 74 61 74 69 63 20 63 68 61 72 20 2a 7a 44   static char *zD
2b30: 6d 62 73 4e 61 6d 65 20 3d 20 22 53 51 4c 69 74  mbsName = "SQLit
2b40: 65 22 3b 0a 20 20 2a 7a 4e 61 6d 65 20 3d 20 7a  e";.  *zName = z
2b50: 44 6d 62 73 4e 61 6d 65 3b 0a 20 20 72 65 74 75  DmbsName;.  retu
2b60: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  rn 0;.}../*.** T
2b70: 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 67 69  his routine regi
2b80: 73 74 65 72 73 20 74 68 65 20 53 51 4c 69 74 65  sters the SQLite
2b90: 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65   database engine
2ba0: 20 77 69 74 68 20 74 68 65 20 6d 61 69 6e 0a 2a   with the main.*
2bb0: 2a 20 64 72 69 76 65 72 2e 20 20 4e 65 77 20 64  * driver.  New d
2bc0: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20 69  atabase engine i
2bd0: 6e 74 65 72 66 61 63 65 73 20 73 68 6f 75 6c 64  nterfaces should
2be0: 20 68 61 76 65 20 61 20 73 69 6e 67 6c 65 0a 2a   have a single.*
2bf0: 2a 20 72 6f 75 74 69 6e 65 20 73 69 6d 69 6c 61  * routine simila
2c00: 72 20 74 6f 20 74 68 69 73 20 6f 6e 65 2e 20 20  r to this one.  
2c10: 54 68 65 20 6d 61 69 6e 28 29 20 66 75 6e 63 74  The main() funct
2c20: 69 6f 6e 20 62 65 6c 6f 77 20 73 68 6f 75 6c 64  ion below should
2c30: 20 62 65 0a 2a 2a 20 6d 6f 64 69 66 69 65 64 20   be.** modified 
2c40: 74 6f 20 63 61 6c 6c 20 74 68 61 74 20 72 6f 75  to call that rou
2c50: 74 69 6e 65 20 75 70 6f 6e 20 73 74 61 72 74 75  tine upon startu
2c60: 70 2e 0a 2a 2f 0a 76 6f 69 64 20 72 65 67 69 73  p..*/.void regis
2c70: 74 65 72 53 71 6c 69 74 65 28 76 6f 69 64 29 7b  terSqlite(void){
2c80: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 69 73 20  .  /*.  ** This 
2c90: 69 73 20 74 68 65 20 6f 62 6a 65 63 74 20 74 68  is the object th
2ca0: 61 74 20 64 65 66 69 6e 65 73 20 74 68 65 20 64  at defines the d
2cb0: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20 69  atabase engine i
2cc0: 6e 74 65 72 66 61 63 65 2e 0a 20 20 2a 2f 0a 20  nterface..  */. 
2cd0: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 44 62   static const Db
2ce0: 45 6e 67 69 6e 65 20 73 71 6c 69 74 65 44 62 45  Engine sqliteDbE
2cf0: 6e 67 69 6e 65 20 3d 20 7b 0a 20 20 20 20 20 22  ngine = {.     "
2d00: 53 51 4c 69 74 65 22 2c 20 20 20 20 20 20 20 20  SQLite",        
2d10: 20 20 20 20 20 2f 2a 20 7a 4e 61 6d 65 20 2a 2f       /* zName */
2d20: 0a 20 20 20 20 20 30 2c 20 20 20 20 20 20 20 20  .     0,        
2d30: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70              /* p
2d40: 41 75 78 44 61 74 61 20 2a 2f 0a 20 20 20 20 20  AuxData */.     
2d50: 73 71 6c 69 74 65 43 6f 6e 6e 65 63 74 2c 20 20  sqliteConnect,  
2d60: 20 20 20 20 20 20 2f 2a 20 78 43 6f 6e 6e 65 63        /* xConnec
2d70: 74 20 2a 2f 0a 20 20 20 20 20 73 71 6c 69 74 65  t */.     sqlite
2d80: 47 65 74 45 6e 67 69 6e 65 4e 61 6d 65 2c 20 20  GetEngineName,  
2d90: 2f 2a 20 78 47 65 74 45 6e 67 69 6e 65 4e 61 6d  /* xGetEngineNam
2da0: 65 20 2a 2f 0a 20 20 20 20 20 73 71 6c 69 74 65  e */.     sqlite
2db0: 53 74 61 74 65 6d 65 6e 74 2c 20 20 20 20 20 20  Statement,      
2dc0: 2f 2a 20 78 53 74 61 74 65 6d 65 6e 74 20 2a 2f  /* xStatement */
2dd0: 0a 20 20 20 20 20 73 71 6c 69 74 65 51 75 65 72  .     sqliteQuer
2de0: 79 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78  y,          /* x
2df0: 51 75 65 72 79 20 2a 2f 0a 20 20 20 20 20 73 71  Query */.     sq
2e00: 6c 69 74 65 46 72 65 65 52 65 73 75 6c 74 73 2c  liteFreeResults,
2e10: 20 20 20 20 2f 2a 20 78 46 72 65 65 52 65 73 75      /* xFreeResu
2e20: 6c 74 73 20 2a 2f 0a 20 20 20 20 20 73 71 6c 69  lts */.     sqli
2e30: 74 65 44 69 73 63 6f 6e 6e 65 63 74 20 20 20 20  teDisconnect    
2e40: 20 20 2f 2a 20 78 44 69 73 63 6f 6e 6e 65 63 74    /* xDisconnect
2e50: 20 2a 2f 0a 20 20 7d 3b 0a 20 20 73 71 6c 6c 6f   */.  };.  sqllo
2e60: 67 69 63 74 65 73 74 52 65 67 69 73 74 65 72 45  gictestRegisterE
2e70: 6e 67 69 6e 65 28 26 73 71 6c 69 74 65 44 62 45  ngine(&sqliteDbE
2e80: 6e 67 69 6e 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ngine);.}../*.**
2e90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45  ************** E
2ea0: 6e 64 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65  nd of the SQLite
2eb0: 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65   database engine
2ec0: 20 69 6e 74 65 72 66 61 63 65 20 2a 2a 2a 2a 2a   interface *****
2ed0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a  ************.***
2ee0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2ef0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2f00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2f10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2f20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a              **********/.