/ Hex Artifact Content
Login

Artifact 02c57c302ef738ff5b554953c12d8f919e501583:


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 55 74 69 6c 69 74  ******.** Utilit
0180: 79 20 66 75 6e 63 74 69 6f 6e 73 20 75 73 65 64  y functions used
0190: 20 74 68 72 6f 75 67 68 6f 75 74 20 73 71 6c 69   throughout sqli
01a0: 74 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66  te..**.** This f
01b0: 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 66 75 6e  ile contains fun
01c0: 63 74 69 6f 6e 73 20 66 6f 72 20 61 6c 6c 6f 63  ctions for alloc
01d0: 61 74 69 6e 67 20 6d 65 6d 6f 72 79 2c 20 63 6f  ating memory, co
01e0: 6d 70 61 72 69 6e 67 0a 2a 2a 20 73 74 72 69 6e  mparing.** strin
01f0: 67 73 2c 20 61 6e 64 20 73 74 75 66 66 20 6c 69  gs, and stuff li
0200: 6b 65 20 74 68 61 74 2e 0a 2a 2a 0a 2a 2a 20 24  ke that..**.** $
0210: 49 64 3a 20 75 74 69 6c 2e 63 2c 76 20 31 2e 32  Id: util.c,v 1.2
0220: 31 39 20 32 30 30 38 2f 30 34 2f 30 35 20 31 38  19 2008/04/05 18
0230: 3a 34 31 3a 34 33 20 64 72 68 20 45 78 70 20 24  :41:43 drh Exp $
0240: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
0250: 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c  liteInt.h".#incl
0260: 75 64 65 20 3c 73 74 64 61 72 67 2e 68 3e 0a 23  ude <stdarg.h>.#
0270: 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65 2e 68  include <ctype.h
0280: 3e 0a 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68  >.../*.** Set th
0290: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72  e most recent er
02a0: 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 65 72 72  ror code and err
02b0: 6f 72 20 73 74 72 69 6e 67 20 66 6f 72 20 74 68  or string for th
02c0: 65 20 73 71 6c 69 74 65 0a 2a 2a 20 68 61 6e 64  e sqlite.** hand
02d0: 6c 65 20 22 64 62 22 2e 20 54 68 65 20 65 72 72  le "db". The err
02e0: 6f 72 20 63 6f 64 65 20 69 73 20 73 65 74 20 74  or code is set t
02f0: 6f 20 22 65 72 72 5f 63 6f 64 65 22 2e 0a 2a 2a  o "err_code"..**
0300: 0a 2a 2a 20 49 66 20 69 74 20 69 73 20 6e 6f 74  .** If it is not
0310: 20 4e 55 4c 4c 2c 20 73 74 72 69 6e 67 20 7a 46   NULL, string zF
0320: 6f 72 6d 61 74 20 73 70 65 63 69 66 69 65 73 20  ormat specifies 
0330: 74 68 65 20 66 6f 72 6d 61 74 20 6f 66 20 74 68  the format of th
0340: 65 0a 2a 2a 20 65 72 72 6f 72 20 73 74 72 69 6e  e.** error strin
0350: 67 20 69 6e 20 74 68 65 20 73 74 79 6c 65 20 6f  g in the style o
0360: 66 20 74 68 65 20 70 72 69 6e 74 66 20 66 75 6e  f the printf fun
0370: 63 74 69 6f 6e 73 3a 20 54 68 65 20 66 6f 6c 6c  ctions: The foll
0380: 6f 77 69 6e 67 0a 2a 2a 20 66 6f 72 6d 61 74 20  owing.** format 
0390: 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 61  characters are a
03a0: 6c 6c 6f 77 65 64 3a 0a 2a 2a 0a 2a 2a 20 20 20  llowed:.**.**   
03b0: 20 20 20 25 73 20 20 20 20 20 20 49 6e 73 65 72     %s      Inser
03c0: 74 20 61 20 73 74 72 69 6e 67 0a 2a 2a 20 20 20  t a string.**   
03d0: 20 20 20 25 7a 20 20 20 20 20 20 41 20 73 74 72     %z      A str
03e0: 69 6e 67 20 74 68 61 74 20 73 68 6f 75 6c 64 20  ing that should 
03f0: 62 65 20 66 72 65 65 64 20 61 66 74 65 72 20 75  be freed after u
0400: 73 65 0a 2a 2a 20 20 20 20 20 20 25 64 20 20 20  se.**      %d   
0410: 20 20 20 49 6e 73 65 72 74 20 61 6e 20 69 6e 74     Insert an int
0420: 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 25 54 20  eger.**      %T 
0430: 20 20 20 20 20 49 6e 73 65 72 74 20 61 20 74 6f       Insert a to
0440: 6b 65 6e 0a 2a 2a 20 20 20 20 20 20 25 53 20 20  ken.**      %S  
0450: 20 20 20 20 49 6e 73 65 72 74 20 74 68 65 20 66      Insert the f
0460: 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20  irst element of 
0470: 61 20 53 72 63 4c 69 73 74 0a 2a 2a 0a 2a 2a 20  a SrcList.**.** 
0480: 7a 46 6f 72 6d 61 74 20 61 6e 64 20 61 6e 79 20  zFormat and any 
0490: 73 74 72 69 6e 67 20 74 6f 6b 65 6e 73 20 74 68  string tokens th
04a0: 61 74 20 66 6f 6c 6c 6f 77 20 69 74 20 61 72 65  at follow it are
04b0: 20 61 73 73 75 6d 65 64 20 74 6f 20 62 65 0a 2a   assumed to be.*
04c0: 2a 20 65 6e 63 6f 64 65 64 20 69 6e 20 55 54 46  * encoded in UTF
04d0: 2d 38 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 63 6c 65  -8..**.** To cle
04e0: 61 72 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65  ar the most rece
04f0: 6e 74 20 65 72 72 6f 72 20 66 6f 72 20 73 71 6c  nt error for sql
0500: 69 74 65 20 68 61 6e 64 6c 65 20 22 64 62 22 2c  ite handle "db",
0510: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 0a 2a 2a   sqlite3Error.**
0520: 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c 65   should be calle
0530: 64 20 77 69 74 68 20 65 72 72 5f 63 6f 64 65 20  d with err_code 
0540: 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b  set to SQLITE_OK
0550: 20 61 6e 64 20 7a 46 6f 72 6d 61 74 20 73 65 74   and zFormat set
0560: 0a 2a 2a 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2f 0a  .** to NULL..*/.
0570: 76 6f 69 64 20 73 71 6c 69 74 65 33 45 72 72 6f  void sqlite3Erro
0580: 72 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69  r(sqlite3 *db, i
0590: 6e 74 20 65 72 72 5f 63 6f 64 65 2c 20 63 6f 6e  nt err_code, con
05a0: 73 74 20 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74  st char *zFormat
05b0: 2c 20 2e 2e 2e 29 7b 0a 20 20 69 66 28 20 64 62  , ...){.  if( db
05c0: 20 26 26 20 28 64 62 2d 3e 70 45 72 72 20 7c 7c   && (db->pErr ||
05d0: 20 28 64 62 2d 3e 70 45 72 72 20 3d 20 73 71 6c   (db->pErr = sql
05e0: 69 74 65 33 56 61 6c 75 65 4e 65 77 28 64 62 29  ite3ValueNew(db)
05f0: 29 21 3d 30 29 20 29 7b 0a 20 20 20 20 64 62 2d  )!=0) ){.    db-
0600: 3e 65 72 72 43 6f 64 65 20 3d 20 65 72 72 5f 63  >errCode = err_c
0610: 6f 64 65 3b 0a 20 20 20 20 69 66 28 20 7a 46 6f  ode;.    if( zFo
0620: 72 6d 61 74 20 29 7b 0a 20 20 20 20 20 20 63 68  rmat ){.      ch
0630: 61 72 20 2a 7a 3b 0a 20 20 20 20 20 20 76 61 5f  ar *z;.      va_
0640: 6c 69 73 74 20 61 70 3b 0a 20 20 20 20 20 20 76  list ap;.      v
0650: 61 5f 73 74 61 72 74 28 61 70 2c 20 7a 46 6f 72  a_start(ap, zFor
0660: 6d 61 74 29 3b 0a 20 20 20 20 20 20 7a 20 3d 20  mat);.      z = 
0670: 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74 66 28  sqlite3VMPrintf(
0680: 64 62 2c 20 7a 46 6f 72 6d 61 74 2c 20 61 70 29  db, zFormat, ap)
0690: 3b 0a 20 20 20 20 20 20 76 61 5f 65 6e 64 28 61  ;.      va_end(a
06a0: 70 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  p);.      sqlite
06b0: 33 56 61 6c 75 65 53 65 74 53 74 72 28 64 62 2d  3ValueSetStr(db-
06c0: 3e 70 45 72 72 2c 20 2d 31 2c 20 7a 2c 20 53 51  >pErr, -1, z, SQ
06d0: 4c 49 54 45 5f 55 54 46 38 2c 20 73 71 6c 69 74  LITE_UTF8, sqlit
06e0: 65 33 5f 66 72 65 65 29 3b 0a 20 20 20 20 7d 65  e3_free);.    }e
06f0: 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  lse{.      sqlit
0700: 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 64 62  e3ValueSetStr(db
0710: 2d 3e 70 45 72 72 2c 20 30 2c 20 30 2c 20 53 51  ->pErr, 0, 0, SQ
0720: 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54  LITE_UTF8, SQLIT
0730: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 7d  E_STATIC);.    }
0740: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64  .  }.}../*.** Ad
0750: 64 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61  d an error messa
0760: 67 65 20 74 6f 20 70 50 61 72 73 65 2d 3e 7a 45  ge to pParse->zE
0770: 72 72 4d 73 67 20 61 6e 64 20 69 6e 63 72 65 6d  rrMsg and increm
0780: 65 6e 74 20 70 50 61 72 73 65 2d 3e 6e 45 72 72  ent pParse->nErr
0790: 2e 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  ..** The followi
07a0: 6e 67 20 66 6f 72 6d 61 74 74 69 6e 67 20 63 68  ng formatting ch
07b0: 61 72 61 63 74 65 72 73 20 61 72 65 20 61 6c 6c  aracters are all
07c0: 6f 77 65 64 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  owed:.**.**     
07d0: 20 25 73 20 20 20 20 20 20 49 6e 73 65 72 74 20   %s      Insert 
07e0: 61 20 73 74 72 69 6e 67 0a 2a 2a 20 20 20 20 20  a string.**     
07f0: 20 25 7a 20 20 20 20 20 20 41 20 73 74 72 69 6e   %z      A strin
0800: 67 20 74 68 61 74 20 73 68 6f 75 6c 64 20 62 65  g that should be
0810: 20 66 72 65 65 64 20 61 66 74 65 72 20 75 73 65   freed after use
0820: 0a 2a 2a 20 20 20 20 20 20 25 64 20 20 20 20 20  .**      %d     
0830: 20 49 6e 73 65 72 74 20 61 6e 20 69 6e 74 65 67   Insert an integ
0840: 65 72 0a 2a 2a 20 20 20 20 20 20 25 54 20 20 20  er.**      %T   
0850: 20 20 20 49 6e 73 65 72 74 20 61 20 74 6f 6b 65     Insert a toke
0860: 6e 0a 2a 2a 20 20 20 20 20 20 25 53 20 20 20 20  n.**      %S    
0870: 20 20 49 6e 73 65 72 74 20 74 68 65 20 66 69 72    Insert the fir
0880: 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 61 20  st element of a 
0890: 53 72 63 4c 69 73 74 0a 2a 2a 0a 2a 2a 20 54 68  SrcList.**.** Th
08a0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75  is function shou
08b0: 6c 64 20 62 65 20 75 73 65 64 20 74 6f 20 72 65  ld be used to re
08c0: 70 6f 72 74 20 61 6e 79 20 65 72 72 6f 72 20 74  port any error t
08d0: 68 61 74 20 6f 63 63 75 72 73 20 77 68 69 6c 73  hat occurs whils
08e0: 74 0a 2a 2a 20 63 6f 6d 70 69 6c 69 6e 67 20 61  t.** compiling a
08f0: 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  n SQL statement 
0900: 28 69 2e 65 2e 20 77 69 74 68 69 6e 20 73 71 6c  (i.e. within sql
0910: 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 29 2e  ite3_prepare()).
0920: 20 54 68 65 0a 2a 2a 20 6c 61 73 74 20 74 68 69   The.** last thi
0930: 6e 67 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  ng the sqlite3_p
0940: 72 65 70 61 72 65 28 29 20 66 75 6e 63 74 69 6f  repare() functio
0950: 6e 20 64 6f 65 73 20 69 73 20 63 6f 70 79 20 74  n does is copy t
0960: 68 65 20 65 72 72 6f 72 0a 2a 2a 20 73 74 6f 72  he error.** stor
0970: 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74  ed by this funct
0980: 69 6f 6e 20 69 6e 74 6f 20 74 68 65 20 64 61 74  ion into the dat
0990: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 75 73 69  abase handle usi
09a0: 6e 67 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28  ng sqlite3Error(
09b0: 29 2e 0a 2a 2a 20 46 75 6e 63 74 69 6f 6e 20 73  )..** Function s
09c0: 71 6c 69 74 65 33 45 72 72 6f 72 28 29 20 73 68  qlite3Error() sh
09d0: 6f 75 6c 64 20 62 65 20 75 73 65 64 20 64 75 72  ould be used dur
09e0: 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 20 65 78  ing statement ex
09f0: 65 63 75 74 69 6f 6e 0a 2a 2a 20 28 73 71 6c 69  ecution.** (sqli
0a00: 74 65 33 5f 73 74 65 70 28 29 20 65 74 63 2e 29  te3_step() etc.)
0a10: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
0a20: 33 45 72 72 6f 72 4d 73 67 28 50 61 72 73 65 20  3ErrorMsg(Parse 
0a30: 2a 70 50 61 72 73 65 2c 20 63 6f 6e 73 74 20 63  *pParse, const c
0a40: 68 61 72 20 2a 7a 46 6f 72 6d 61 74 2c 20 2e 2e  har *zFormat, ..
0a50: 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 70  .){.  va_list ap
0a60: 3b 0a 20 20 70 50 61 72 73 65 2d 3e 6e 45 72 72  ;.  pParse->nErr
0a70: 2b 2b 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72  ++;.  sqlite3_fr
0a80: 65 65 28 70 50 61 72 73 65 2d 3e 7a 45 72 72 4d  ee(pParse->zErrM
0a90: 73 67 29 3b 0a 20 20 76 61 5f 73 74 61 72 74 28  sg);.  va_start(
0aa0: 61 70 2c 20 7a 46 6f 72 6d 61 74 29 3b 0a 20 20  ap, zFormat);.  
0ab0: 70 50 61 72 73 65 2d 3e 7a 45 72 72 4d 73 67 20  pParse->zErrMsg 
0ac0: 3d 20 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74  = sqlite3VMPrint
0ad0: 66 28 70 50 61 72 73 65 2d 3e 64 62 2c 20 7a 46  f(pParse->db, zF
0ae0: 6f 72 6d 61 74 2c 20 61 70 29 3b 0a 20 20 76 61  ormat, ap);.  va
0af0: 5f 65 6e 64 28 61 70 29 3b 0a 20 20 69 66 28 20  _end(ap);.  if( 
0b00: 70 50 61 72 73 65 2d 3e 72 63 3d 3d 53 51 4c 49  pParse->rc==SQLI
0b10: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 50 61  TE_OK ){.    pPa
0b20: 72 73 65 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45  rse->rc = SQLITE
0b30: 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 7d 0a 0a 2f  _ERROR;.  }.}../
0b40: 2a 0a 2a 2a 20 43 6c 65 61 72 20 74 68 65 20 65  *.** Clear the e
0b50: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 6e 20  rror message in 
0b60: 70 50 61 72 73 65 2c 20 69 66 20 61 6e 79 0a 2a  pParse, if any.*
0b70: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 72  /.void sqlite3Er
0b80: 72 6f 72 43 6c 65 61 72 28 50 61 72 73 65 20 2a  rorClear(Parse *
0b90: 70 50 61 72 73 65 29 7b 0a 20 20 73 71 6c 69 74  pParse){.  sqlit
0ba0: 65 33 5f 66 72 65 65 28 70 50 61 72 73 65 2d 3e  e3_free(pParse->
0bb0: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 70 50 61 72  zErrMsg);.  pPar
0bc0: 73 65 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b  se->zErrMsg = 0;
0bd0: 0a 20 20 70 50 61 72 73 65 2d 3e 6e 45 72 72 20  .  pParse->nErr 
0be0: 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f  = 0;.}../*.** Co
0bf0: 6e 76 65 72 74 20 61 6e 20 53 51 4c 2d 73 74 79  nvert an SQL-sty
0c00: 6c 65 20 71 75 6f 74 65 64 20 73 74 72 69 6e 67  le quoted string
0c10: 20 69 6e 74 6f 20 61 20 6e 6f 72 6d 61 6c 20 73   into a normal s
0c20: 74 72 69 6e 67 20 62 79 20 72 65 6d 6f 76 69 6e  tring by removin
0c30: 67 0a 2a 2a 20 74 68 65 20 71 75 6f 74 65 20 63  g.** the quote c
0c40: 68 61 72 61 63 74 65 72 73 2e 20 20 54 68 65 20  haracters.  The 
0c50: 63 6f 6e 76 65 72 73 69 6f 6e 20 69 73 20 64 6f  conversion is do
0c60: 6e 65 20 69 6e 2d 70 6c 61 63 65 2e 20 20 49 66  ne in-place.  If
0c70: 20 74 68 65 0a 2a 2a 20 69 6e 70 75 74 20 64 6f   the.** input do
0c80: 65 73 20 6e 6f 74 20 62 65 67 69 6e 20 77 69 74  es not begin wit
0c90: 68 20 61 20 71 75 6f 74 65 20 63 68 61 72 61 63  h a quote charac
0ca0: 74 65 72 2c 20 74 68 65 6e 20 74 68 69 73 20 72  ter, then this r
0cb0: 6f 75 74 69 6e 65 0a 2a 2a 20 69 73 20 61 20 6e  outine.** is a n
0cc0: 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 32 30 30 32  o-op..**.** 2002
0cd0: 2d 46 65 62 2d 31 34 3a 20 54 68 69 73 20 72 6f  -Feb-14: This ro
0ce0: 75 74 69 6e 65 20 69 73 20 65 78 74 65 6e 64 65  utine is extende
0cf0: 64 20 74 6f 20 72 65 6d 6f 76 65 20 4d 53 2d 41  d to remove MS-A
0d00: 63 63 65 73 73 20 73 74 79 6c 65 0a 2a 2a 20 62  ccess style.** b
0d10: 72 61 63 6b 65 74 73 20 66 72 6f 6d 20 61 72 6f  rackets from aro
0d20: 75 6e 64 20 69 64 65 6e 74 69 66 65 72 73 2e 20  und identifers. 
0d30: 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 20 20 22   For example:  "
0d40: 5b 61 2d 62 2d 63 5d 22 20 62 65 63 6f 6d 65 73  [a-b-c]" becomes
0d50: 0a 2a 2a 20 22 61 2d 62 2d 63 22 2e 0a 2a 2f 0a  .** "a-b-c"..*/.
0d60: 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 71 75  void sqlite3Dequ
0d70: 6f 74 65 28 63 68 61 72 20 2a 7a 29 7b 0a 20 20  ote(char *z){.  
0d80: 69 6e 74 20 71 75 6f 74 65 3b 0a 20 20 69 6e 74  int quote;.  int
0d90: 20 69 2c 20 6a 3b 0a 20 20 69 66 28 20 7a 3d 3d   i, j;.  if( z==
0da0: 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 71 75  0 ) return;.  qu
0db0: 6f 74 65 20 3d 20 7a 5b 30 5d 3b 0a 20 20 73 77  ote = z[0];.  sw
0dc0: 69 74 63 68 28 20 71 75 6f 74 65 20 29 7b 0a 20  itch( quote ){. 
0dd0: 20 20 20 63 61 73 65 20 27 5c 27 27 3a 20 20 62     case '\'':  b
0de0: 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 27  reak;.    case '
0df0: 22 27 3a 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  "':   break;.   
0e00: 20 63 61 73 65 20 27 60 27 3a 20 20 20 62 72 65   case '`':   bre
0e10: 61 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ak;             
0e20: 20 20 20 2f 2a 20 46 6f 72 20 4d 79 53 51 4c 20     /* For MySQL 
0e30: 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 2a 2f  compatibility */
0e40: 0a 20 20 20 20 63 61 73 65 20 27 5b 27 3a 20 20  .    case '[':  
0e50: 20 71 75 6f 74 65 20 3d 20 27 5d 27 3b 20 20 62   quote = ']';  b
0e60: 72 65 61 6b 3b 20 20 2f 2a 20 46 6f 72 20 4d 53  reak;  /* For MS
0e70: 20 53 71 6c 53 65 72 76 65 72 20 63 6f 6d 70 61   SqlServer compa
0e80: 74 69 62 69 6c 69 74 79 20 2a 2f 0a 20 20 20 20  tibility */.    
0e90: 64 65 66 61 75 6c 74 3a 20 20 20 20 72 65 74 75  default:    retu
0ea0: 72 6e 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 69 3d  rn;.  }.  for(i=
0eb0: 31 2c 20 6a 3d 30 3b 20 7a 5b 69 5d 3b 20 69 2b  1, j=0; z[i]; i+
0ec0: 2b 29 7b 0a 20 20 20 20 69 66 28 20 7a 5b 69 5d  +){.    if( z[i]
0ed0: 3d 3d 71 75 6f 74 65 20 29 7b 0a 20 20 20 20 20  ==quote ){.     
0ee0: 20 69 66 28 20 7a 5b 69 2b 31 5d 3d 3d 71 75 6f   if( z[i+1]==quo
0ef0: 74 65 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 5b  te ){.        z[
0f00: 6a 2b 2b 5d 20 3d 20 71 75 6f 74 65 3b 0a 20 20  j++] = quote;.  
0f10: 20 20 20 20 20 20 69 2b 2b 3b 0a 20 20 20 20 20        i++;.     
0f20: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
0f30: 7a 5b 6a 2b 2b 5d 20 3d 20 30 3b 0a 20 20 20 20  z[j++] = 0;.    
0f40: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
0f50: 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20   }.    }else{.  
0f60: 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d 20 7a 5b 69      z[j++] = z[i
0f70: 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a  ];.    }.  }.}..
0f80: 2f 2a 20 41 6e 20 61 72 72 61 79 20 74 6f 20 6d  /* An array to m
0f90: 61 70 20 61 6c 6c 20 75 70 70 65 72 2d 63 61 73  ap all upper-cas
0fa0: 65 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 74  e characters int
0fb0: 6f 20 74 68 65 69 72 20 63 6f 72 72 65 73 70 6f  o their correspo
0fc0: 6e 64 69 6e 67 0a 2a 2a 20 6c 6f 77 65 72 2d 63  nding.** lower-c
0fd0: 61 73 65 20 63 68 61 72 61 63 74 65 72 2e 20 0a  ase character. .
0fe0: 2a 2f 0a 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  */.const unsigne
0ff0: 64 20 63 68 61 72 20 73 71 6c 69 74 65 33 55 70  d char sqlite3Up
1000: 70 65 72 54 6f 4c 6f 77 65 72 5b 5d 20 3d 20 7b  perToLower[] = {
1010: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 41  .#ifdef SQLITE_A
1020: 53 43 49 49 0a 20 20 20 20 20 20 30 2c 20 20 31  SCII.      0,  1
1030: 2c 20 20 32 2c 20 20 33 2c 20 20 34 2c 20 20 35  ,  2,  3,  4,  5
1040: 2c 20 20 36 2c 20 20 37 2c 20 20 38 2c 20 20 39  ,  6,  7,  8,  9
1050: 2c 20 31 30 2c 20 31 31 2c 20 31 32 2c 20 31 33  , 10, 11, 12, 13
1060: 2c 20 31 34 2c 20 31 35 2c 20 31 36 2c 20 31 37  , 14, 15, 16, 17
1070: 2c 0a 20 20 20 20 20 31 38 2c 20 31 39 2c 20 32  ,.     18, 19, 2
1080: 30 2c 20 32 31 2c 20 32 32 2c 20 32 33 2c 20 32  0, 21, 22, 23, 2
1090: 34 2c 20 32 35 2c 20 32 36 2c 20 32 37 2c 20 32  4, 25, 26, 27, 2
10a0: 38 2c 20 32 39 2c 20 33 30 2c 20 33 31 2c 20 33  8, 29, 30, 31, 3
10b0: 32 2c 20 33 33 2c 20 33 34 2c 20 33 35 2c 0a 20  2, 33, 34, 35,. 
10c0: 20 20 20 20 33 36 2c 20 33 37 2c 20 33 38 2c 20      36, 37, 38, 
10d0: 33 39 2c 20 34 30 2c 20 34 31 2c 20 34 32 2c 20  39, 40, 41, 42, 
10e0: 34 33 2c 20 34 34 2c 20 34 35 2c 20 34 36 2c 20  43, 44, 45, 46, 
10f0: 34 37 2c 20 34 38 2c 20 34 39 2c 20 35 30 2c 20  47, 48, 49, 50, 
1100: 35 31 2c 20 35 32 2c 20 35 33 2c 0a 20 20 20 20  51, 52, 53,.    
1110: 20 35 34 2c 20 35 35 2c 20 35 36 2c 20 35 37 2c   54, 55, 56, 57,
1120: 20 35 38 2c 20 35 39 2c 20 36 30 2c 20 36 31 2c   58, 59, 60, 61,
1130: 20 36 32 2c 20 36 33 2c 20 36 34 2c 20 39 37 2c   62, 63, 64, 97,
1140: 20 39 38 2c 20 39 39 2c 31 30 30 2c 31 30 31 2c   98, 99,100,101,
1150: 31 30 32 2c 31 30 33 2c 0a 20 20 20 20 31 30 34  102,103,.    104
1160: 2c 31 30 35 2c 31 30 36 2c 31 30 37 2c 31 30 38  ,105,106,107,108
1170: 2c 31 30 39 2c 31 31 30 2c 31 31 31 2c 31 31 32  ,109,110,111,112
1180: 2c 31 31 33 2c 31 31 34 2c 31 31 35 2c 31 31 36  ,113,114,115,116
1190: 2c 31 31 37 2c 31 31 38 2c 31 31 39 2c 31 32 30  ,117,118,119,120
11a0: 2c 31 32 31 2c 0a 20 20 20 20 31 32 32 2c 20 39  ,121,.    122, 9
11b0: 31 2c 20 39 32 2c 20 39 33 2c 20 39 34 2c 20 39  1, 92, 93, 94, 9
11c0: 35 2c 20 39 36 2c 20 39 37 2c 20 39 38 2c 20 39  5, 96, 97, 98, 9
11d0: 39 2c 31 30 30 2c 31 30 31 2c 31 30 32 2c 31 30  9,100,101,102,10
11e0: 33 2c 31 30 34 2c 31 30 35 2c 31 30 36 2c 31 30  3,104,105,106,10
11f0: 37 2c 0a 20 20 20 20 31 30 38 2c 31 30 39 2c 31  7,.    108,109,1
1200: 31 30 2c 31 31 31 2c 31 31 32 2c 31 31 33 2c 31  10,111,112,113,1
1210: 31 34 2c 31 31 35 2c 31 31 36 2c 31 31 37 2c 31  14,115,116,117,1
1220: 31 38 2c 31 31 39 2c 31 32 30 2c 31 32 31 2c 31  18,119,120,121,1
1230: 32 32 2c 31 32 33 2c 31 32 34 2c 31 32 35 2c 0a  22,123,124,125,.
1240: 20 20 20 20 31 32 36 2c 31 32 37 2c 31 32 38 2c      126,127,128,
1250: 31 32 39 2c 31 33 30 2c 31 33 31 2c 31 33 32 2c  129,130,131,132,
1260: 31 33 33 2c 31 33 34 2c 31 33 35 2c 31 33 36 2c  133,134,135,136,
1270: 31 33 37 2c 31 33 38 2c 31 33 39 2c 31 34 30 2c  137,138,139,140,
1280: 31 34 31 2c 31 34 32 2c 31 34 33 2c 0a 20 20 20  141,142,143,.   
1290: 20 31 34 34 2c 31 34 35 2c 31 34 36 2c 31 34 37   144,145,146,147
12a0: 2c 31 34 38 2c 31 34 39 2c 31 35 30 2c 31 35 31  ,148,149,150,151
12b0: 2c 31 35 32 2c 31 35 33 2c 31 35 34 2c 31 35 35  ,152,153,154,155
12c0: 2c 31 35 36 2c 31 35 37 2c 31 35 38 2c 31 35 39  ,156,157,158,159
12d0: 2c 31 36 30 2c 31 36 31 2c 0a 20 20 20 20 31 36  ,160,161,.    16
12e0: 32 2c 31 36 33 2c 31 36 34 2c 31 36 35 2c 31 36  2,163,164,165,16
12f0: 36 2c 31 36 37 2c 31 36 38 2c 31 36 39 2c 31 37  6,167,168,169,17
1300: 30 2c 31 37 31 2c 31 37 32 2c 31 37 33 2c 31 37  0,171,172,173,17
1310: 34 2c 31 37 35 2c 31 37 36 2c 31 37 37 2c 31 37  4,175,176,177,17
1320: 38 2c 31 37 39 2c 0a 20 20 20 20 31 38 30 2c 31  8,179,.    180,1
1330: 38 31 2c 31 38 32 2c 31 38 33 2c 31 38 34 2c 31  81,182,183,184,1
1340: 38 35 2c 31 38 36 2c 31 38 37 2c 31 38 38 2c 31  85,186,187,188,1
1350: 38 39 2c 31 39 30 2c 31 39 31 2c 31 39 32 2c 31  89,190,191,192,1
1360: 39 33 2c 31 39 34 2c 31 39 35 2c 31 39 36 2c 31  93,194,195,196,1
1370: 39 37 2c 0a 20 20 20 20 31 39 38 2c 31 39 39 2c  97,.    198,199,
1380: 32 30 30 2c 32 30 31 2c 32 30 32 2c 32 30 33 2c  200,201,202,203,
1390: 32 30 34 2c 32 30 35 2c 32 30 36 2c 32 30 37 2c  204,205,206,207,
13a0: 32 30 38 2c 32 30 39 2c 32 31 30 2c 32 31 31 2c  208,209,210,211,
13b0: 32 31 32 2c 32 31 33 2c 32 31 34 2c 32 31 35 2c  212,213,214,215,
13c0: 0a 20 20 20 20 32 31 36 2c 32 31 37 2c 32 31 38  .    216,217,218
13d0: 2c 32 31 39 2c 32 32 30 2c 32 32 31 2c 32 32 32  ,219,220,221,222
13e0: 2c 32 32 33 2c 32 32 34 2c 32 32 35 2c 32 32 36  ,223,224,225,226
13f0: 2c 32 32 37 2c 32 32 38 2c 32 32 39 2c 32 33 30  ,227,228,229,230
1400: 2c 32 33 31 2c 32 33 32 2c 32 33 33 2c 0a 20 20  ,231,232,233,.  
1410: 20 20 32 33 34 2c 32 33 35 2c 32 33 36 2c 32 33    234,235,236,23
1420: 37 2c 32 33 38 2c 32 33 39 2c 32 34 30 2c 32 34  7,238,239,240,24
1430: 31 2c 32 34 32 2c 32 34 33 2c 32 34 34 2c 32 34  1,242,243,244,24
1440: 35 2c 32 34 36 2c 32 34 37 2c 32 34 38 2c 32 34  5,246,247,248,24
1450: 39 2c 32 35 30 2c 32 35 31 2c 0a 20 20 20 20 32  9,250,251,.    2
1460: 35 32 2c 32 35 33 2c 32 35 34 2c 32 35 35 0a 23  52,253,254,255.#
1470: 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c  endif.#ifdef SQL
1480: 49 54 45 5f 45 42 43 44 49 43 0a 20 20 20 20 20  ITE_EBCDIC.     
1490: 20 30 2c 20 20 31 2c 20 20 32 2c 20 20 33 2c 20   0,  1,  2,  3, 
14a0: 20 34 2c 20 20 35 2c 20 20 36 2c 20 20 37 2c 20   4,  5,  6,  7, 
14b0: 20 38 2c 20 20 39 2c 20 31 30 2c 20 31 31 2c 20   8,  9, 10, 11, 
14c0: 31 32 2c 20 31 33 2c 20 31 34 2c 20 31 35 2c 20  12, 13, 14, 15, 
14d0: 2f 2a 20 30 78 20 2a 2f 0a 20 20 20 20 20 31 36  /* 0x */.     16
14e0: 2c 20 31 37 2c 20 31 38 2c 20 31 39 2c 20 32 30  , 17, 18, 19, 20
14f0: 2c 20 32 31 2c 20 32 32 2c 20 32 33 2c 20 32 34  , 21, 22, 23, 24
1500: 2c 20 32 35 2c 20 32 36 2c 20 32 37 2c 20 32 38  , 25, 26, 27, 28
1510: 2c 20 32 39 2c 20 33 30 2c 20 33 31 2c 20 2f 2a  , 29, 30, 31, /*
1520: 20 31 78 20 2a 2f 0a 20 20 20 20 20 33 32 2c 20   1x */.     32, 
1530: 33 33 2c 20 33 34 2c 20 33 35 2c 20 33 36 2c 20  33, 34, 35, 36, 
1540: 33 37 2c 20 33 38 2c 20 33 39 2c 20 34 30 2c 20  37, 38, 39, 40, 
1550: 34 31 2c 20 34 32 2c 20 34 33 2c 20 34 34 2c 20  41, 42, 43, 44, 
1560: 34 35 2c 20 34 36 2c 20 34 37 2c 20 2f 2a 20 32  45, 46, 47, /* 2
1570: 78 20 2a 2f 0a 20 20 20 20 20 34 38 2c 20 34 39  x */.     48, 49
1580: 2c 20 35 30 2c 20 35 31 2c 20 35 32 2c 20 35 33  , 50, 51, 52, 53
1590: 2c 20 35 34 2c 20 35 35 2c 20 35 36 2c 20 35 37  , 54, 55, 56, 57
15a0: 2c 20 35 38 2c 20 35 39 2c 20 36 30 2c 20 36 31  , 58, 59, 60, 61
15b0: 2c 20 36 32 2c 20 36 33 2c 20 2f 2a 20 33 78 20  , 62, 63, /* 3x 
15c0: 2a 2f 0a 20 20 20 20 20 36 34 2c 20 36 35 2c 20  */.     64, 65, 
15d0: 36 36 2c 20 36 37 2c 20 36 38 2c 20 36 39 2c 20  66, 67, 68, 69, 
15e0: 37 30 2c 20 37 31 2c 20 37 32 2c 20 37 33 2c 20  70, 71, 72, 73, 
15f0: 37 34 2c 20 37 35 2c 20 37 36 2c 20 37 37 2c 20  74, 75, 76, 77, 
1600: 37 38 2c 20 37 39 2c 20 2f 2a 20 34 78 20 2a 2f  78, 79, /* 4x */
1610: 0a 20 20 20 20 20 38 30 2c 20 38 31 2c 20 38 32  .     80, 81, 82
1620: 2c 20 38 33 2c 20 38 34 2c 20 38 35 2c 20 38 36  , 83, 84, 85, 86
1630: 2c 20 38 37 2c 20 38 38 2c 20 38 39 2c 20 39 30  , 87, 88, 89, 90
1640: 2c 20 39 31 2c 20 39 32 2c 20 39 33 2c 20 39 34  , 91, 92, 93, 94
1650: 2c 20 39 35 2c 20 2f 2a 20 35 78 20 2a 2f 0a 20  , 95, /* 5x */. 
1660: 20 20 20 20 39 36 2c 20 39 37 2c 20 36 36 2c 20      96, 97, 66, 
1670: 36 37 2c 20 36 38 2c 20 36 39 2c 20 37 30 2c 20  67, 68, 69, 70, 
1680: 37 31 2c 20 37 32 2c 20 37 33 2c 31 30 36 2c 31  71, 72, 73,106,1
1690: 30 37 2c 31 30 38 2c 31 30 39 2c 31 31 30 2c 31  07,108,109,110,1
16a0: 31 31 2c 20 2f 2a 20 36 78 20 2a 2f 0a 20 20 20  11, /* 6x */.   
16b0: 20 31 31 32 2c 20 38 31 2c 20 38 32 2c 20 38 33   112, 81, 82, 83
16c0: 2c 20 38 34 2c 20 38 35 2c 20 38 36 2c 20 38 37  , 84, 85, 86, 87
16d0: 2c 20 38 38 2c 20 38 39 2c 31 32 32 2c 31 32 33  , 88, 89,122,123
16e0: 2c 31 32 34 2c 31 32 35 2c 31 32 36 2c 31 32 37  ,124,125,126,127
16f0: 2c 20 2f 2a 20 37 78 20 2a 2f 0a 20 20 20 20 31  , /* 7x */.    1
1700: 32 38 2c 31 32 39 2c 31 33 30 2c 31 33 31 2c 31  28,129,130,131,1
1710: 33 32 2c 31 33 33 2c 31 33 34 2c 31 33 35 2c 31  32,133,134,135,1
1720: 33 36 2c 31 33 37 2c 31 33 38 2c 31 33 39 2c 31  36,137,138,139,1
1730: 34 30 2c 31 34 31 2c 31 34 32 2c 31 34 33 2c 20  40,141,142,143, 
1740: 2f 2a 20 38 78 20 2a 2f 0a 20 20 20 20 31 34 34  /* 8x */.    144
1750: 2c 31 34 35 2c 31 34 36 2c 31 34 37 2c 31 34 38  ,145,146,147,148
1760: 2c 31 34 39 2c 31 35 30 2c 31 35 31 2c 31 35 32  ,149,150,151,152
1770: 2c 31 35 33 2c 31 35 34 2c 31 35 35 2c 31 35 36  ,153,154,155,156
1780: 2c 31 35 37 2c 31 35 36 2c 31 35 39 2c 20 2f 2a  ,157,156,159, /*
1790: 20 39 78 20 2a 2f 0a 20 20 20 20 31 36 30 2c 31   9x */.    160,1
17a0: 36 31 2c 31 36 32 2c 31 36 33 2c 31 36 34 2c 31  61,162,163,164,1
17b0: 36 35 2c 31 36 36 2c 31 36 37 2c 31 36 38 2c 31  65,166,167,168,1
17c0: 36 39 2c 31 37 30 2c 31 37 31 2c 31 34 30 2c 31  69,170,171,140,1
17d0: 34 31 2c 31 34 32 2c 31 37 35 2c 20 2f 2a 20 41  41,142,175, /* A
17e0: 78 20 2a 2f 0a 20 20 20 20 31 37 36 2c 31 37 37  x */.    176,177
17f0: 2c 31 37 38 2c 31 37 39 2c 31 38 30 2c 31 38 31  ,178,179,180,181
1800: 2c 31 38 32 2c 31 38 33 2c 31 38 34 2c 31 38 35  ,182,183,184,185
1810: 2c 31 38 36 2c 31 38 37 2c 31 38 38 2c 31 38 39  ,186,187,188,189
1820: 2c 31 39 30 2c 31 39 31 2c 20 2f 2a 20 42 78 20  ,190,191, /* Bx 
1830: 2a 2f 0a 20 20 20 20 31 39 32 2c 31 32 39 2c 31  */.    192,129,1
1840: 33 30 2c 31 33 31 2c 31 33 32 2c 31 33 33 2c 31  30,131,132,133,1
1850: 33 34 2c 31 33 35 2c 31 33 36 2c 31 33 37 2c 32  34,135,136,137,2
1860: 30 32 2c 32 30 33 2c 32 30 34 2c 32 30 35 2c 32  02,203,204,205,2
1870: 30 36 2c 32 30 37 2c 20 2f 2a 20 43 78 20 2a 2f  06,207, /* Cx */
1880: 0a 20 20 20 20 32 30 38 2c 31 34 35 2c 31 34 36  .    208,145,146
1890: 2c 31 34 37 2c 31 34 38 2c 31 34 39 2c 31 35 30  ,147,148,149,150
18a0: 2c 31 35 31 2c 31 35 32 2c 31 35 33 2c 32 31 38  ,151,152,153,218
18b0: 2c 32 31 39 2c 32 32 30 2c 32 32 31 2c 32 32 32  ,219,220,221,222
18c0: 2c 32 32 33 2c 20 2f 2a 20 44 78 20 2a 2f 0a 20  ,223, /* Dx */. 
18d0: 20 20 20 32 32 34 2c 32 32 35 2c 31 36 32 2c 31     224,225,162,1
18e0: 36 33 2c 31 36 34 2c 31 36 35 2c 31 36 36 2c 31  63,164,165,166,1
18f0: 36 37 2c 31 36 38 2c 31 36 39 2c 32 33 32 2c 32  67,168,169,232,2
1900: 30 33 2c 32 30 34 2c 32 30 35 2c 32 30 36 2c 32  03,204,205,206,2
1910: 30 37 2c 20 2f 2a 20 45 78 20 2a 2f 0a 20 20 20  07, /* Ex */.   
1920: 20 32 33 39 2c 32 34 30 2c 32 34 31 2c 32 34 32   239,240,241,242
1930: 2c 32 34 33 2c 32 34 34 2c 32 34 35 2c 32 34 36  ,243,244,245,246
1940: 2c 32 34 37 2c 32 34 38 2c 32 34 39 2c 32 31 39  ,247,248,249,219
1950: 2c 32 32 30 2c 32 32 31 2c 32 32 32 2c 32 35 35  ,220,221,222,255
1960: 2c 20 2f 2a 20 46 78 20 2a 2f 0a 23 65 6e 64 69  , /* Fx */.#endi
1970: 66 0a 7d 3b 0a 23 64 65 66 69 6e 65 20 55 70 70  f.};.#define Upp
1980: 65 72 54 6f 4c 6f 77 65 72 20 73 71 6c 69 74 65  erToLower sqlite
1990: 33 55 70 70 65 72 54 6f 4c 6f 77 65 72 0a 0a 2f  3UpperToLower../
19a0: 2a 0a 2a 2a 20 53 6f 6d 65 20 73 79 73 74 65 6d  *.** Some system
19b0: 73 20 68 61 76 65 20 73 74 72 69 63 6d 70 28 29  s have stricmp()
19c0: 2e 20 20 4f 74 68 65 72 73 20 68 61 76 65 20 73  .  Others have s
19d0: 74 72 63 61 73 65 63 6d 70 28 29 2e 20 20 42 65  trcasecmp().  Be
19e0: 63 61 75 73 65 0a 2a 2a 20 74 68 65 72 65 20 69  cause.** there i
19f0: 73 20 6e 6f 20 63 6f 6e 73 69 73 74 65 6e 63 79  s no consistency
1a00: 2c 20 77 65 20 77 69 6c 6c 20 64 65 66 69 6e 65  , we will define
1a10: 20 6f 75 72 20 6f 77 6e 2e 0a 2a 2f 0a 69 6e 74   our own..*/.int
1a20: 20 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28   sqlite3StrICmp(
1a30: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4c 65 66  const char *zLef
1a40: 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  t, const char *z
1a50: 52 69 67 68 74 29 7b 0a 20 20 72 65 67 69 73 74  Right){.  regist
1a60: 65 72 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  er unsigned char
1a70: 20 2a 61 2c 20 2a 62 3b 0a 20 20 61 20 3d 20 28   *a, *b;.  a = (
1a80: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29  unsigned char *)
1a90: 7a 4c 65 66 74 3b 0a 20 20 62 20 3d 20 28 75 6e  zLeft;.  b = (un
1aa0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29 7a 52  signed char *)zR
1ab0: 69 67 68 74 3b 0a 20 20 77 68 69 6c 65 28 20 2a  ight;.  while( *
1ac0: 61 21 3d 30 20 26 26 20 55 70 70 65 72 54 6f 4c  a!=0 && UpperToL
1ad0: 6f 77 65 72 5b 2a 61 5d 3d 3d 55 70 70 65 72 54  ower[*a]==UpperT
1ae0: 6f 4c 6f 77 65 72 5b 2a 62 5d 29 7b 20 61 2b 2b  oLower[*b]){ a++
1af0: 3b 20 62 2b 2b 3b 20 7d 0a 20 20 72 65 74 75 72  ; b++; }.  retur
1b00: 6e 20 55 70 70 65 72 54 6f 4c 6f 77 65 72 5b 2a  n UpperToLower[*
1b10: 61 5d 20 2d 20 55 70 70 65 72 54 6f 4c 6f 77 65  a] - UpperToLowe
1b20: 72 5b 2a 62 5d 3b 0a 7d 0a 69 6e 74 20 73 71 6c  r[*b];.}.int sql
1b30: 69 74 65 33 53 74 72 4e 49 43 6d 70 28 63 6f 6e  ite3StrNICmp(con
1b40: 73 74 20 63 68 61 72 20 2a 7a 4c 65 66 74 2c 20  st char *zLeft, 
1b50: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 52 69 67  const char *zRig
1b60: 68 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65  ht, int N){.  re
1b70: 67 69 73 74 65 72 20 75 6e 73 69 67 6e 65 64 20  gister unsigned 
1b80: 63 68 61 72 20 2a 61 2c 20 2a 62 3b 0a 20 20 61  char *a, *b;.  a
1b90: 20 3d 20 28 75 6e 73 69 67 6e 65 64 20 63 68 61   = (unsigned cha
1ba0: 72 20 2a 29 7a 4c 65 66 74 3b 0a 20 20 62 20 3d  r *)zLeft;.  b =
1bb0: 20 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20   (unsigned char 
1bc0: 2a 29 7a 52 69 67 68 74 3b 0a 20 20 77 68 69 6c  *)zRight;.  whil
1bd0: 65 28 20 4e 2d 2d 20 3e 20 30 20 26 26 20 2a 61  e( N-- > 0 && *a
1be0: 21 3d 30 20 26 26 20 55 70 70 65 72 54 6f 4c 6f  !=0 && UpperToLo
1bf0: 77 65 72 5b 2a 61 5d 3d 3d 55 70 70 65 72 54 6f  wer[*a]==UpperTo
1c00: 4c 6f 77 65 72 5b 2a 62 5d 29 7b 20 61 2b 2b 3b  Lower[*b]){ a++;
1c10: 20 62 2b 2b 3b 20 7d 0a 20 20 72 65 74 75 72 6e   b++; }.  return
1c20: 20 4e 3c 30 20 3f 20 30 20 3a 20 55 70 70 65 72   N<0 ? 0 : Upper
1c30: 54 6f 4c 6f 77 65 72 5b 2a 61 5d 20 2d 20 55 70  ToLower[*a] - Up
1c40: 70 65 72 54 6f 4c 6f 77 65 72 5b 2a 62 5d 3b 0a  perToLower[*b];.
1c50: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
1c60: 54 52 55 45 20 69 66 20 7a 20 69 73 20 61 20 70  TRUE if z is a p
1c70: 75 72 65 20 6e 75 6d 65 72 69 63 20 73 74 72 69  ure numeric stri
1c80: 6e 67 2e 20 20 52 65 74 75 72 6e 20 46 41 4c 53  ng.  Return FALS
1c90: 45 20 69 66 20 74 68 65 0a 2a 2a 20 73 74 72 69  E if the.** stri
1ca0: 6e 67 20 63 6f 6e 74 61 69 6e 73 20 61 6e 79 20  ng contains any 
1cb0: 63 68 61 72 61 63 74 65 72 20 77 68 69 63 68 20  character which 
1cc0: 69 73 20 6e 6f 74 20 70 61 72 74 20 6f 66 20 61  is not part of a
1cd0: 20 6e 75 6d 62 65 72 2e 20 49 66 0a 2a 2a 20 74   number. If.** t
1ce0: 68 65 20 73 74 72 69 6e 67 20 69 73 20 6e 75 6d  he string is num
1cf0: 65 72 69 63 20 61 6e 64 20 63 6f 6e 74 61 69 6e  eric and contain
1d00: 73 20 74 68 65 20 27 2e 27 20 63 68 61 72 61 63  s the '.' charac
1d10: 74 65 72 2c 20 73 65 74 20 2a 72 65 61 6c 6e 75  ter, set *realnu
1d20: 6d 0a 2a 2a 20 74 6f 20 54 52 55 45 20 28 6f 74  m.** to TRUE (ot
1d30: 68 65 72 77 69 73 65 20 46 41 4c 53 45 29 2e 0a  herwise FALSE)..
1d40: 2a 2a 0a 2a 2a 20 41 6e 20 65 6d 70 74 79 20 73  **.** An empty s
1d50: 74 72 69 6e 67 20 69 73 20 63 6f 6e 73 69 64 65  tring is conside
1d60: 72 65 64 20 6e 6f 6e 2d 6e 75 6d 65 72 69 63 2e  red non-numeric.
1d70: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49  .*/.int sqlite3I
1d80: 73 4e 75 6d 62 65 72 28 63 6f 6e 73 74 20 63 68  sNumber(const ch
1d90: 61 72 20 2a 7a 2c 20 69 6e 74 20 2a 72 65 61 6c  ar *z, int *real
1da0: 6e 75 6d 2c 20 75 38 20 65 6e 63 29 7b 0a 20 20  num, u8 enc){.  
1db0: 69 6e 74 20 69 6e 63 72 20 3d 20 28 65 6e 63 3d  int incr = (enc=
1dc0: 3d 53 51 4c 49 54 45 5f 55 54 46 38 3f 31 3a 32  =SQLITE_UTF8?1:2
1dd0: 29 3b 0a 20 20 69 66 28 20 65 6e 63 3d 3d 53 51  );.  if( enc==SQ
1de0: 4c 49 54 45 5f 55 54 46 31 36 42 45 20 29 20 7a  LITE_UTF16BE ) z
1df0: 2b 2b 3b 0a 20 20 69 66 28 20 2a 7a 3d 3d 27 2d  ++;.  if( *z=='-
1e00: 27 20 7c 7c 20 2a 7a 3d 3d 27 2b 27 20 29 20 7a  ' || *z=='+' ) z
1e10: 20 2b 3d 20 69 6e 63 72 3b 0a 20 20 69 66 28 20   += incr;.  if( 
1e20: 21 69 73 64 69 67 69 74 28 2a 28 75 38 2a 29 7a  !isdigit(*(u8*)z
1e30: 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  ) ){.    return 
1e40: 30 3b 0a 20 20 7d 0a 20 20 7a 20 2b 3d 20 69 6e  0;.  }.  z += in
1e50: 63 72 3b 0a 20 20 69 66 28 20 72 65 61 6c 6e 75  cr;.  if( realnu
1e60: 6d 20 29 20 2a 72 65 61 6c 6e 75 6d 20 3d 20 30  m ) *realnum = 0
1e70: 3b 0a 20 20 77 68 69 6c 65 28 20 69 73 64 69 67  ;.  while( isdig
1e80: 69 74 28 2a 28 75 38 2a 29 7a 29 20 29 7b 20 7a  it(*(u8*)z) ){ z
1e90: 20 2b 3d 20 69 6e 63 72 3b 20 7d 0a 20 20 69 66   += incr; }.  if
1ea0: 28 20 2a 7a 3d 3d 27 2e 27 20 29 7b 0a 20 20 20  ( *z=='.' ){.   
1eb0: 20 7a 20 2b 3d 20 69 6e 63 72 3b 0a 20 20 20 20   z += incr;.    
1ec0: 69 66 28 20 21 69 73 64 69 67 69 74 28 2a 28 75  if( !isdigit(*(u
1ed0: 38 2a 29 7a 29 20 29 20 72 65 74 75 72 6e 20 30  8*)z) ) return 0
1ee0: 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 69 73 64  ;.    while( isd
1ef0: 69 67 69 74 28 2a 28 75 38 2a 29 7a 29 20 29 7b  igit(*(u8*)z) ){
1f00: 20 7a 20 2b 3d 20 69 6e 63 72 3b 20 7d 0a 20 20   z += incr; }.  
1f10: 20 20 69 66 28 20 72 65 61 6c 6e 75 6d 20 29 20    if( realnum ) 
1f20: 2a 72 65 61 6c 6e 75 6d 20 3d 20 31 3b 0a 20 20  *realnum = 1;.  
1f30: 7d 0a 20 20 69 66 28 20 2a 7a 3d 3d 27 65 27 20  }.  if( *z=='e' 
1f40: 7c 7c 20 2a 7a 3d 3d 27 45 27 20 29 7b 0a 20 20  || *z=='E' ){.  
1f50: 20 20 7a 20 2b 3d 20 69 6e 63 72 3b 0a 20 20 20    z += incr;.   
1f60: 20 69 66 28 20 2a 7a 3d 3d 27 2b 27 20 7c 7c 20   if( *z=='+' || 
1f70: 2a 7a 3d 3d 27 2d 27 20 29 20 7a 20 2b 3d 20 69  *z=='-' ) z += i
1f80: 6e 63 72 3b 0a 20 20 20 20 69 66 28 20 21 69 73  ncr;.    if( !is
1f90: 64 69 67 69 74 28 2a 28 75 38 2a 29 7a 29 20 29  digit(*(u8*)z) )
1fa0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 77   return 0;.    w
1fb0: 68 69 6c 65 28 20 69 73 64 69 67 69 74 28 2a 28  hile( isdigit(*(
1fc0: 75 38 2a 29 7a 29 20 29 7b 20 7a 20 2b 3d 20 69  u8*)z) ){ z += i
1fd0: 6e 63 72 3b 20 7d 0a 20 20 20 20 69 66 28 20 72  ncr; }.    if( r
1fe0: 65 61 6c 6e 75 6d 20 29 20 2a 72 65 61 6c 6e 75  ealnum ) *realnu
1ff0: 6d 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74  m = 1;.  }.  ret
2000: 75 72 6e 20 2a 7a 3d 3d 30 3b 0a 7d 0a 0a 2f 2a  urn *z==0;.}../*
2010: 0a 2a 2a 20 54 68 65 20 73 74 72 69 6e 67 20 7a  .** The string z
2020: 5b 5d 20 69 73 20 61 6e 20 61 73 63 69 69 20 72  [] is an ascii r
2030: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66  epresentation of
2040: 20 61 20 72 65 61 6c 20 6e 75 6d 62 65 72 2e 0a   a real number..
2050: 2a 2a 20 43 6f 6e 76 65 72 74 20 74 68 69 73 20  ** Convert this 
2060: 73 74 72 69 6e 67 20 74 6f 20 61 20 64 6f 75 62  string to a doub
2070: 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  le..**.** This r
2080: 6f 75 74 69 6e 65 20 61 73 73 75 6d 65 73 20 74  outine assumes t
2090: 68 61 74 20 7a 5b 5d 20 72 65 61 6c 6c 79 20 69  hat z[] really i
20a0: 73 20 61 20 76 61 6c 69 64 20 6e 75 6d 62 65 72  s a valid number
20b0: 2e 20 20 49 66 20 69 74 0a 2a 2a 20 69 73 20 6e  .  If it.** is n
20c0: 6f 74 2c 20 74 68 65 20 72 65 73 75 6c 74 20 69  ot, the result i
20d0: 73 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2a 0a  s undefined..**.
20e0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
20f0: 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 20  is used instead 
2100: 6f 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 61  of the library a
2110: 74 6f 66 28 29 20 66 75 6e 63 74 69 6f 6e 20 62  tof() function b
2120: 65 63 61 75 73 65 0a 2a 2a 20 74 68 65 20 6c 69  ecause.** the li
2130: 62 72 61 72 79 20 61 74 6f 66 28 29 20 6d 69 67  brary atof() mig
2140: 68 74 20 77 61 6e 74 20 74 6f 20 75 73 65 20 22  ht want to use "
2150: 2c 22 20 61 73 20 74 68 65 20 64 65 63 69 6d 61  ," as the decima
2160: 6c 20 70 6f 69 6e 74 20 69 6e 73 74 65 61 64 0a  l point instead.
2170: 2a 2a 20 6f 66 20 22 2e 22 20 64 65 70 65 6e 64  ** of "." depend
2180: 69 6e 67 20 6f 6e 20 68 6f 77 20 6c 6f 63 61 6c  ing on how local
2190: 65 20 69 73 20 73 65 74 2e 20 20 42 75 74 20 74  e is set.  But t
21a0: 68 61 74 20 77 6f 75 6c 64 20 63 61 75 73 65 20  hat would cause 
21b0: 70 72 6f 62 6c 65 6d 73 0a 2a 2a 20 66 6f 72 20  problems.** for 
21c0: 53 51 4c 2e 20 20 53 6f 20 74 68 69 73 20 72 6f  SQL.  So this ro
21d0: 75 74 69 6e 65 20 61 6c 77 61 79 73 20 75 73 65  utine always use
21e0: 73 20 22 2e 22 20 72 65 67 61 72 64 6c 65 73 73  s "." regardless
21f0: 20 6f 66 20 6c 6f 63 61 6c 65 2e 0a 2a 2f 0a 69   of locale..*/.i
2200: 6e 74 20 73 71 6c 69 74 65 33 41 74 6f 46 28 63  nt sqlite3AtoF(c
2210: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 64 6f  onst char *z, do
2220: 75 62 6c 65 20 2a 70 52 65 73 75 6c 74 29 7b 0a  uble *pResult){.
2230: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
2240: 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49  MIT_FLOATING_POI
2250: 4e 54 0a 20 20 69 6e 74 20 73 69 67 6e 20 3d 20  NT.  int sign = 
2260: 31 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  1;.  const char 
2270: 2a 7a 42 65 67 69 6e 20 3d 20 7a 3b 0a 20 20 4c  *zBegin = z;.  L
2280: 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 20 76  ONGDOUBLE_TYPE v
2290: 31 20 3d 20 30 2e 30 3b 0a 20 20 77 68 69 6c 65  1 = 0.0;.  while
22a0: 28 20 69 73 73 70 61 63 65 28 2a 28 75 38 2a 29  ( isspace(*(u8*)
22b0: 7a 29 20 29 20 7a 2b 2b 3b 0a 20 20 69 66 28 20  z) ) z++;.  if( 
22c0: 2a 7a 3d 3d 27 2d 27 20 29 7b 0a 20 20 20 20 73  *z=='-' ){.    s
22d0: 69 67 6e 20 3d 20 2d 31 3b 0a 20 20 20 20 7a 2b  ign = -1;.    z+
22e0: 2b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 2a  +;.  }else if( *
22f0: 7a 3d 3d 27 2b 27 20 29 7b 0a 20 20 20 20 7a 2b  z=='+' ){.    z+
2300: 2b 3b 0a 20 20 7d 0a 20 20 77 68 69 6c 65 28 20  +;.  }.  while( 
2310: 69 73 64 69 67 69 74 28 2a 28 75 38 2a 29 7a 29  isdigit(*(u8*)z)
2320: 20 29 7b 0a 20 20 20 20 76 31 20 3d 20 76 31 2a   ){.    v1 = v1*
2330: 31 30 2e 30 20 2b 20 28 2a 7a 20 2d 20 27 30 27  10.0 + (*z - '0'
2340: 29 3b 0a 20 20 20 20 7a 2b 2b 3b 0a 20 20 7d 0a  );.    z++;.  }.
2350: 20 20 69 66 28 20 2a 7a 3d 3d 27 2e 27 20 29 7b    if( *z=='.' ){
2360: 0a 20 20 20 20 4c 4f 4e 47 44 4f 55 42 4c 45 5f  .    LONGDOUBLE_
2370: 54 59 50 45 20 64 69 76 69 73 6f 72 20 3d 20 31  TYPE divisor = 1
2380: 2e 30 3b 0a 20 20 20 20 7a 2b 2b 3b 0a 20 20 20  .0;.    z++;.   
2390: 20 77 68 69 6c 65 28 20 69 73 64 69 67 69 74 28   while( isdigit(
23a0: 2a 28 75 38 2a 29 7a 29 20 29 7b 0a 20 20 20 20  *(u8*)z) ){.    
23b0: 20 20 76 31 20 3d 20 76 31 2a 31 30 2e 30 20 2b    v1 = v1*10.0 +
23c0: 20 28 2a 7a 20 2d 20 27 30 27 29 3b 0a 20 20 20   (*z - '0');.   
23d0: 20 20 20 64 69 76 69 73 6f 72 20 2a 3d 20 31 30     divisor *= 10
23e0: 2e 30 3b 0a 20 20 20 20 20 20 7a 2b 2b 3b 0a 20  .0;.      z++;. 
23f0: 20 20 20 7d 0a 20 20 20 20 76 31 20 2f 3d 20 64     }.    v1 /= d
2400: 69 76 69 73 6f 72 3b 0a 20 20 7d 0a 20 20 69 66  ivisor;.  }.  if
2410: 28 20 2a 7a 3d 3d 27 65 27 20 7c 7c 20 2a 7a 3d  ( *z=='e' || *z=
2420: 3d 27 45 27 20 29 7b 0a 20 20 20 20 69 6e 74 20  ='E' ){.    int 
2430: 65 73 69 67 6e 20 3d 20 31 3b 0a 20 20 20 20 69  esign = 1;.    i
2440: 6e 74 20 65 76 61 6c 20 3d 20 30 3b 0a 20 20 20  nt eval = 0;.   
2450: 20 4c 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45   LONGDOUBLE_TYPE
2460: 20 73 63 61 6c 65 20 3d 20 31 2e 30 3b 0a 20 20   scale = 1.0;.  
2470: 20 20 7a 2b 2b 3b 0a 20 20 20 20 69 66 28 20 2a    z++;.    if( *
2480: 7a 3d 3d 27 2d 27 20 29 7b 0a 20 20 20 20 20 20  z=='-' ){.      
2490: 65 73 69 67 6e 20 3d 20 2d 31 3b 0a 20 20 20 20  esign = -1;.    
24a0: 20 20 7a 2b 2b 3b 0a 20 20 20 20 7d 65 6c 73 65    z++;.    }else
24b0: 20 69 66 28 20 2a 7a 3d 3d 27 2b 27 20 29 7b 0a   if( *z=='+' ){.
24c0: 20 20 20 20 20 20 7a 2b 2b 3b 0a 20 20 20 20 7d        z++;.    }
24d0: 0a 20 20 20 20 77 68 69 6c 65 28 20 69 73 64 69  .    while( isdi
24e0: 67 69 74 28 2a 28 75 38 2a 29 7a 29 20 29 7b 0a  git(*(u8*)z) ){.
24f0: 20 20 20 20 20 20 65 76 61 6c 20 3d 20 65 76 61        eval = eva
2500: 6c 2a 31 30 20 2b 20 2a 7a 20 2d 20 27 30 27 3b  l*10 + *z - '0';
2510: 0a 20 20 20 20 20 20 7a 2b 2b 3b 0a 20 20 20 20  .      z++;.    
2520: 7d 0a 20 20 20 20 77 68 69 6c 65 28 20 65 76 61  }.    while( eva
2530: 6c 3e 3d 36 34 20 29 7b 20 73 63 61 6c 65 20 2a  l>=64 ){ scale *
2540: 3d 20 31 2e 30 65 2b 36 34 3b 20 65 76 61 6c 20  = 1.0e+64; eval 
2550: 2d 3d 20 36 34 3b 20 7d 0a 20 20 20 20 77 68 69  -= 64; }.    whi
2560: 6c 65 28 20 65 76 61 6c 3e 3d 31 36 20 29 7b 20  le( eval>=16 ){ 
2570: 73 63 61 6c 65 20 2a 3d 20 31 2e 30 65 2b 31 36  scale *= 1.0e+16
2580: 3b 20 65 76 61 6c 20 2d 3d 20 31 36 3b 20 7d 0a  ; eval -= 16; }.
2590: 20 20 20 20 77 68 69 6c 65 28 20 65 76 61 6c 3e      while( eval>
25a0: 3d 34 20 29 7b 20 73 63 61 6c 65 20 2a 3d 20 31  =4 ){ scale *= 1
25b0: 2e 30 65 2b 34 3b 20 65 76 61 6c 20 2d 3d 20 34  .0e+4; eval -= 4
25c0: 3b 20 7d 0a 20 20 20 20 77 68 69 6c 65 28 20 65  ; }.    while( e
25d0: 76 61 6c 3e 3d 31 20 29 7b 20 73 63 61 6c 65 20  val>=1 ){ scale 
25e0: 2a 3d 20 31 2e 30 65 2b 31 3b 20 65 76 61 6c 20  *= 1.0e+1; eval 
25f0: 2d 3d 20 31 3b 20 7d 0a 20 20 20 20 69 66 28 20  -= 1; }.    if( 
2600: 65 73 69 67 6e 3c 30 20 29 7b 0a 20 20 20 20 20  esign<0 ){.     
2610: 20 76 31 20 2f 3d 20 73 63 61 6c 65 3b 0a 20 20   v1 /= scale;.  
2620: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 76    }else{.      v
2630: 31 20 2a 3d 20 73 63 61 6c 65 3b 0a 20 20 20 20  1 *= scale;.    
2640: 7d 0a 20 20 7d 0a 20 20 2a 70 52 65 73 75 6c 74  }.  }.  *pResult
2650: 20 3d 20 73 69 67 6e 3c 30 20 3f 20 2d 76 31 20   = sign<0 ? -v1 
2660: 3a 20 76 31 3b 0a 20 20 72 65 74 75 72 6e 20 7a  : v1;.  return z
2670: 20 2d 20 7a 42 65 67 69 6e 3b 0a 23 65 6c 73 65   - zBegin;.#else
2680: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
2690: 33 41 74 6f 69 36 34 28 7a 2c 20 70 52 65 73 75  3Atoi64(z, pResu
26a0: 6c 74 29 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53  lt);.#endif /* S
26b0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54  QLITE_OMIT_FLOAT
26c0: 49 4e 47 5f 50 4f 49 4e 54 20 2a 2f 0a 7d 0a 0a  ING_POINT */.}..
26d0: 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72 65 20 74 68  /*.** Compare th
26e0: 65 20 31 39 2d 63 68 61 72 61 63 74 65 72 20 73  e 19-character s
26f0: 74 72 69 6e 67 20 7a 4e 75 6d 20 61 67 61 69 6e  tring zNum again
2700: 73 74 20 74 68 65 20 74 65 78 74 20 72 65 70 72  st the text repr
2710: 65 73 65 6e 74 61 74 69 6f 6e 0a 2a 2a 20 76 61  esentation.** va
2720: 6c 75 65 20 32 5e 36 33 3a 20 20 39 32 32 33 33  lue 2^63:  92233
2730: 37 32 30 33 36 38 35 34 37 37 35 38 30 38 2e 20  72036854775808. 
2740: 20 52 65 74 75 72 6e 20 6e 65 67 61 74 69 76 65   Return negative
2750: 2c 20 7a 65 72 6f 2c 20 6f 72 20 70 6f 73 69 74  , zero, or posit
2760: 69 76 65 0a 2a 2a 20 69 66 20 7a 4e 75 6d 20 69  ive.** if zNum i
2770: 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65 71 75  s less than, equ
2780: 61 6c 20 74 6f 2c 20 6f 72 20 67 72 65 61 74 65  al to, or greate
2790: 72 20 74 68 61 6e 20 74 68 65 20 73 74 72 69 6e  r than the strin
27a0: 67 2e 0a 2a 2a 0a 2a 2a 20 55 6e 6c 69 6b 65 20  g..**.** Unlike 
27b0: 6d 65 6d 63 6d 70 28 29 20 74 68 69 73 20 72 6f  memcmp() this ro
27c0: 75 74 69 6e 65 20 69 73 20 67 75 61 72 61 6e 74  utine is guarant
27d0: 65 65 64 20 74 6f 20 72 65 74 75 72 6e 20 74 68  eed to return th
27e0: 65 20 64 69 66 66 65 72 65 6e 63 65 0a 2a 2a 20  e difference.** 
27f0: 69 6e 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66  in the values of
2800: 20 74 68 65 20 6c 61 73 74 20 64 69 67 69 74 20   the last digit 
2810: 69 66 20 74 68 65 20 6f 6e 6c 79 20 64 69 66 66  if the only diff
2820: 65 72 65 6e 63 65 20 69 73 20 69 6e 20 74 68 65  erence is in the
2830: 0a 2a 2a 20 6c 61 73 74 20 64 69 67 69 74 2e 20  .** last digit. 
2840: 20 53 6f 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65   So, for example
2850: 2c 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 63 6f 6d  ,.**.**      com
2860: 70 61 72 65 32 70 6f 77 36 33 28 22 39 32 32 33  pare2pow63("9223
2870: 33 37 32 30 33 36 38 35 34 37 37 35 38 30 30 22  372036854775800"
2880: 29 0a 2a 2a 0a 2a 2a 20 77 69 6c 6c 20 72 65 74  ).**.** will ret
2890: 75 72 6e 20 2d 38 2e 0a 2a 2f 0a 73 74 61 74 69  urn -8..*/.stati
28a0: 63 20 69 6e 74 20 63 6f 6d 70 61 72 65 32 70 6f  c int compare2po
28b0: 77 36 33 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  w63(const char *
28c0: 7a 4e 75 6d 29 7b 0a 20 20 69 6e 74 20 63 3b 0a  zNum){.  int c;.
28d0: 20 20 63 20 3d 20 6d 65 6d 63 6d 70 28 7a 4e 75    c = memcmp(zNu
28e0: 6d 2c 22 39 32 32 33 33 37 32 30 33 36 38 35 34  m,"9223372036854
28f0: 37 37 35 38 30 22 2c 31 38 29 3b 0a 20 20 69 66  77580",18);.  if
2900: 28 20 63 3d 3d 30 20 29 7b 0a 20 20 20 20 63 20  ( c==0 ){.    c 
2910: 3d 20 7a 4e 75 6d 5b 31 38 5d 20 2d 20 27 38 27  = zNum[18] - '8'
2920: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 63  ;.  }.  return c
2930: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  ;.}.../*.** Retu
2940: 72 6e 20 54 52 55 45 20 69 66 20 7a 4e 75 6d 20  rn TRUE if zNum 
2950: 69 73 20 61 20 36 34 2d 62 69 74 20 73 69 67 6e  is a 64-bit sign
2960: 65 64 20 69 6e 74 65 67 65 72 20 61 6e 64 20 77  ed integer and w
2970: 72 69 74 65 0a 2a 2a 20 74 68 65 20 76 61 6c 75  rite.** the valu
2980: 65 20 6f 66 20 74 68 65 20 69 6e 74 65 67 65 72  e of the integer
2990: 20 69 6e 74 6f 20 2a 70 4e 75 6d 2e 20 20 49 66   into *pNum.  If
29a0: 20 7a 4e 75 6d 20 69 73 20 6e 6f 74 20 61 6e 20   zNum is not an 
29b0: 69 6e 74 65 67 65 72 0a 2a 2a 20 6f 72 20 69 73  integer.** or is
29c0: 20 61 6e 20 69 6e 74 65 67 65 72 20 74 68 61 74   an integer that
29d0: 20 69 73 20 74 6f 6f 20 6c 61 72 67 65 20 74 6f   is too large to
29e0: 20 62 65 20 65 78 70 72 65 73 73 65 64 20 77 69   be expressed wi
29f0: 74 68 20 36 34 20 62 69 74 73 2c 0a 2a 2a 20 74  th 64 bits,.** t
2a00: 68 65 6e 20 72 65 74 75 72 6e 20 66 61 6c 73 65  hen return false
2a10: 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69  ..**.** When thi
2a20: 73 20 72 6f 75 74 69 6e 65 20 77 61 73 20 6f 72  s routine was or
2a30: 69 67 69 6e 61 6c 6c 79 20 77 72 69 74 74 65 6e  iginally written
2a40: 20 69 74 20 64 65 61 6c 74 20 77 69 74 68 20 6f   it dealt with o
2a50: 6e 6c 79 0a 2a 2a 20 33 32 2d 62 69 74 20 6e 75  nly.** 32-bit nu
2a60: 6d 62 65 72 73 2e 20 20 41 74 20 74 68 61 74 20  mbers.  At that 
2a70: 74 69 6d 65 2c 20 69 74 20 77 61 73 20 6d 75 63  time, it was muc
2a80: 68 20 66 61 73 74 65 72 20 74 68 61 6e 20 74 68  h faster than th
2a90: 65 0a 2a 2a 20 61 74 6f 69 28 29 20 6c 69 62 72  e.** atoi() libr
2aa0: 61 72 79 20 72 6f 75 74 69 6e 65 20 69 6e 20 52  ary routine in R
2ab0: 65 64 48 61 74 20 37 2e 32 2e 0a 2a 2f 0a 69 6e  edHat 7.2..*/.in
2ac0: 74 20 73 71 6c 69 74 65 33 41 74 6f 69 36 34 28  t sqlite3Atoi64(
2ad0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 75 6d  const char *zNum
2ae0: 2c 20 69 36 34 20 2a 70 4e 75 6d 29 7b 0a 20 20  , i64 *pNum){.  
2af0: 69 36 34 20 76 20 3d 20 30 3b 0a 20 20 69 6e 74  i64 v = 0;.  int
2b00: 20 6e 65 67 3b 0a 20 20 69 6e 74 20 69 2c 20 63   neg;.  int i, c
2b10: 3b 0a 20 20 77 68 69 6c 65 28 20 69 73 73 70 61  ;.  while( isspa
2b20: 63 65 28 2a 28 75 38 2a 29 7a 4e 75 6d 29 20 29  ce(*(u8*)zNum) )
2b30: 20 7a 4e 75 6d 2b 2b 3b 0a 20 20 69 66 28 20 2a   zNum++;.  if( *
2b40: 7a 4e 75 6d 3d 3d 27 2d 27 20 29 7b 0a 20 20 20  zNum=='-' ){.   
2b50: 20 6e 65 67 20 3d 20 31 3b 0a 20 20 20 20 7a 4e   neg = 1;.    zN
2b60: 75 6d 2b 2b 3b 0a 20 20 7d 65 6c 73 65 20 69 66  um++;.  }else if
2b70: 28 20 2a 7a 4e 75 6d 3d 3d 27 2b 27 20 29 7b 0a  ( *zNum=='+' ){.
2b80: 20 20 20 20 6e 65 67 20 3d 20 30 3b 0a 20 20 20      neg = 0;.   
2b90: 20 7a 4e 75 6d 2b 2b 3b 0a 20 20 7d 65 6c 73 65   zNum++;.  }else
2ba0: 7b 0a 20 20 20 20 6e 65 67 20 3d 20 30 3b 0a 20  {.    neg = 0;. 
2bb0: 20 7d 0a 20 20 77 68 69 6c 65 28 20 7a 4e 75 6d   }.  while( zNum
2bc0: 5b 30 5d 3d 3d 27 30 27 20 29 7b 20 7a 4e 75 6d  [0]=='0' ){ zNum
2bd0: 2b 2b 3b 20 7d 20 2f 2a 20 53 6b 69 70 20 6f 76  ++; } /* Skip ov
2be0: 65 72 20 6c 65 61 64 69 6e 67 20 7a 65 72 6f 73  er leading zeros
2bf0: 2e 20 54 69 63 6b 65 74 20 23 32 34 35 34 20 2a  . Ticket #2454 *
2c00: 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 28 63 3d  /.  for(i=0; (c=
2c10: 7a 4e 75 6d 5b 69 5d 29 3e 3d 27 30 27 20 26 26  zNum[i])>='0' &&
2c20: 20 63 3c 3d 27 39 27 3b 20 69 2b 2b 29 7b 0a 20   c<='9'; i++){. 
2c30: 20 20 20 76 20 3d 20 76 2a 31 30 20 2b 20 63 20     v = v*10 + c 
2c40: 2d 20 27 30 27 3b 0a 20 20 7d 0a 20 20 2a 70 4e  - '0';.  }.  *pN
2c50: 75 6d 20 3d 20 6e 65 67 20 3f 20 2d 76 20 3a 20  um = neg ? -v : 
2c60: 76 3b 0a 20 20 69 66 28 20 63 21 3d 30 20 7c 7c  v;.  if( c!=0 ||
2c70: 20 69 3d 3d 30 20 7c 7c 20 69 3e 31 39 20 29 7b   i==0 || i>19 ){
2c80: 0a 20 20 20 20 2f 2a 20 7a 4e 75 6d 20 69 73 20  .    /* zNum is 
2c90: 65 6d 70 74 79 20 6f 72 20 63 6f 6e 74 61 69 6e  empty or contain
2ca0: 73 20 6e 6f 6e 2d 6e 75 6d 65 72 69 63 20 74 65  s non-numeric te
2cb0: 78 74 20 6f 72 20 69 73 20 6c 6f 6e 67 65 72 0a  xt or is longer.
2cc0: 20 20 20 20 2a 2a 20 74 68 61 6e 20 31 39 20 64      ** than 19 d
2cd0: 69 67 69 74 73 20 28 74 68 75 73 20 67 75 61 72  igits (thus guar
2ce0: 61 6e 74 69 6e 67 20 74 68 61 74 20 69 74 20 69  anting that it i
2cf0: 73 20 74 6f 6f 20 6c 61 72 67 65 29 20 2a 2f 0a  s too large) */.
2d00: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
2d10: 7d 65 6c 73 65 20 69 66 28 20 69 3c 31 39 20 29  }else if( i<19 )
2d20: 7b 0a 20 20 20 20 2f 2a 20 4c 65 73 73 20 74 68  {.    /* Less th
2d30: 61 6e 20 31 39 20 64 69 67 69 74 73 2c 20 73 6f  an 19 digits, so
2d40: 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 69 74   we know that it
2d50: 20 66 69 74 73 20 69 6e 20 36 34 20 62 69 74 73   fits in 64 bits
2d60: 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 31   */.    return 1
2d70: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f  ;.  }else{.    /
2d80: 2a 20 31 39 2d 64 69 67 69 74 20 6e 75 6d 62 65  * 19-digit numbe
2d90: 72 73 20 6d 75 73 74 20 62 65 20 6e 6f 20 6c 61  rs must be no la
2da0: 72 67 65 72 20 74 68 61 6e 20 39 32 32 33 33 37  rger than 922337
2db0: 32 30 33 36 38 35 34 37 37 35 38 30 37 20 69 66  2036854775807 if
2dc0: 20 70 6f 73 69 74 69 76 65 0a 20 20 20 20 2a 2a   positive.    **
2dd0: 20 6f 72 20 39 32 32 33 33 37 32 30 33 36 38 35   or 922337203685
2de0: 34 37 37 35 38 30 38 20 69 66 20 6e 65 67 61 74  4775808 if negat
2df0: 69 76 65 2e 20 20 4e 6f 74 65 20 74 68 61 74 20  ive.  Note that 
2e00: 39 32 32 33 33 37 32 30 33 36 38 35 34 36 36 35  9223372036854665
2e10: 38 30 38 0a 20 20 20 20 2a 2a 20 69 73 20 32 5e  808.    ** is 2^
2e20: 36 33 2e 20 2a 2f 0a 20 20 20 20 72 65 74 75 72  63. */.    retur
2e30: 6e 20 63 6f 6d 70 61 72 65 32 70 6f 77 36 33 28  n compare2pow63(
2e40: 7a 4e 75 6d 29 3c 6e 65 67 3b 0a 20 20 7d 0a 7d  zNum)<neg;.  }.}
2e50: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 74 72 69  ../*.** The stri
2e60: 6e 67 20 7a 4e 75 6d 20 72 65 70 72 65 73 65 6e  ng zNum represen
2e70: 74 73 20 61 6e 20 69 6e 74 65 67 65 72 2e 20 20  ts an integer.  
2e80: 54 68 65 72 65 20 6d 69 67 68 74 20 62 65 20 73  There might be s
2e90: 6f 6d 65 20 6f 74 68 65 72 0a 2a 2a 20 69 6e 66  ome other.** inf
2ea0: 6f 72 6d 61 74 69 6f 6e 20 66 6f 6c 6c 6f 77 69  ormation followi
2eb0: 6e 67 20 74 68 65 20 69 6e 74 65 67 65 72 20 74  ng the integer t
2ec0: 6f 6f 2c 20 62 75 74 20 74 68 61 74 20 70 61 72  oo, but that par
2ed0: 74 20 69 73 20 69 67 6e 6f 72 65 64 2e 0a 2a 2a  t is ignored..**
2ee0: 20 49 66 20 74 68 65 20 69 6e 74 65 67 65 72 20   If the integer 
2ef0: 74 68 61 74 20 74 68 65 20 70 72 65 66 69 78 20  that the prefix 
2f00: 6f 66 20 7a 4e 75 6d 20 72 65 70 72 65 73 65 6e  of zNum represen
2f10: 74 73 20 77 69 6c 6c 20 66 69 74 20 69 6e 20 61  ts will fit in a
2f20: 0a 2a 2a 20 36 34 2d 62 69 74 20 73 69 67 6e 65  .** 64-bit signe
2f30: 64 20 69 6e 74 65 67 65 72 2c 20 72 65 74 75 72  d integer, retur
2f40: 6e 20 54 52 55 45 2e 20 20 4f 74 68 65 72 77 69  n TRUE.  Otherwi
2f50: 73 65 20 72 65 74 75 72 6e 20 46 41 4c 53 45 2e  se return FALSE.
2f60: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
2f70: 69 6e 65 20 72 65 74 75 72 6e 73 20 46 41 4c 53  ine returns FALS
2f80: 45 20 66 6f 72 20 74 68 65 20 73 74 72 69 6e 67  E for the string
2f90: 20 2d 39 32 32 33 33 37 32 30 33 36 38 35 34 37   -92233720368547
2fa0: 37 35 38 30 38 20 65 76 65 6e 20 74 68 61 74 0a  75808 even that.
2fb0: 2a 2a 20 74 68 61 74 20 6e 75 6d 62 65 72 20 77  ** that number w
2fc0: 69 6c 6c 2c 20 69 6e 20 74 68 65 6f 72 79 20 66  ill, in theory f
2fd0: 69 74 20 69 6e 20 61 20 36 34 2d 62 69 74 20 69  it in a 64-bit i
2fe0: 6e 74 65 67 65 72 2e 20 20 50 6f 73 69 74 69 76  nteger.  Positiv
2ff0: 65 0a 2a 2a 20 39 32 32 33 33 37 33 30 33 36 38  e.** 92233730368
3000: 35 34 37 37 35 38 30 38 20 77 69 6c 6c 20 6e 6f  54775808 will no
3010: 74 20 66 69 74 20 69 6e 20 36 34 20 62 69 74 73  t fit in 64 bits
3020: 2e 20 20 53 6f 20 69 74 20 73 65 65 6d 73 20 73  .  So it seems s
3030: 61 66 65 72 20 74 6f 20 72 65 74 75 72 6e 0a 2a  afer to return.*
3040: 2a 20 66 61 6c 73 65 2e 0a 2a 2f 0a 69 6e 74 20  * false..*/.int 
3050: 73 71 6c 69 74 65 33 46 69 74 73 49 6e 36 34 42  sqlite3FitsIn64B
3060: 69 74 73 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  its(const char *
3070: 7a 4e 75 6d 2c 20 69 6e 74 20 6e 65 67 46 6c 61  zNum, int negFla
3080: 67 29 7b 0a 20 20 69 6e 74 20 69 2c 20 63 3b 0a  g){.  int i, c;.
3090: 20 20 69 6e 74 20 6e 65 67 20 3d 20 30 3b 0a 20    int neg = 0;. 
30a0: 20 69 66 28 20 2a 7a 4e 75 6d 3d 3d 27 2d 27 20   if( *zNum=='-' 
30b0: 29 7b 0a 20 20 20 20 6e 65 67 20 3d 20 31 3b 0a  ){.    neg = 1;.
30c0: 20 20 20 20 7a 4e 75 6d 2b 2b 3b 0a 20 20 7d 65      zNum++;.  }e
30d0: 6c 73 65 20 69 66 28 20 2a 7a 4e 75 6d 3d 3d 27  lse if( *zNum=='
30e0: 2b 27 20 29 7b 0a 20 20 20 20 7a 4e 75 6d 2b 2b  +' ){.    zNum++
30f0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 65 67 46  ;.  }.  if( negF
3100: 6c 61 67 20 29 20 6e 65 67 20 3d 20 31 2d 6e 65  lag ) neg = 1-ne
3110: 67 3b 0a 20 20 77 68 69 6c 65 28 20 2a 7a 4e 75  g;.  while( *zNu
3120: 6d 3d 3d 27 30 27 20 29 7b 0a 20 20 20 20 7a 4e  m=='0' ){.    zN
3130: 75 6d 2b 2b 3b 20 20 20 2f 2a 20 53 6b 69 70 20  um++;   /* Skip 
3140: 6c 65 61 64 69 6e 67 20 7a 65 72 6f 73 2e 20 20  leading zeros.  
3150: 54 69 63 6b 65 74 20 23 32 34 35 34 20 2a 2f 0a  Ticket #2454 */.
3160: 20 20 7d 0a 20 20 66 6f 72 28 69 3d 30 3b 20 28    }.  for(i=0; (
3170: 63 3d 7a 4e 75 6d 5b 69 5d 29 3e 3d 27 30 27 20  c=zNum[i])>='0' 
3180: 26 26 20 63 3c 3d 27 39 27 3b 20 69 2b 2b 29 7b  && c<='9'; i++){
3190: 7d 0a 20 20 69 66 28 20 69 3c 31 39 20 29 7b 0a  }.  if( i<19 ){.
31a0: 20 20 20 20 2f 2a 20 47 75 61 72 61 6e 74 65 65      /* Guarantee
31b0: 64 20 74 6f 20 66 69 74 20 69 66 20 6c 65 73 73  d to fit if less
31c0: 20 74 68 61 6e 20 31 39 20 64 69 67 69 74 73 20   than 19 digits 
31d0: 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b  */.    return 1;
31e0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 69 3e 31  .  }else if( i>1
31f0: 39 20 29 7b 0a 20 20 20 20 2f 2a 20 47 75 61 72  9 ){.    /* Guar
3200: 61 6e 74 65 65 64 20 74 6f 20 62 65 20 74 6f 6f  anteed to be too
3210: 20 62 69 67 20 69 66 20 67 72 65 61 74 65 72 20   big if greater 
3220: 74 68 61 6e 20 31 39 20 64 69 67 69 74 73 20 2a  than 19 digits *
3230: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a  /.    return 0;.
3240: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20    }else{.    /* 
3250: 43 6f 6d 70 61 72 65 20 61 67 61 69 6e 73 74 20  Compare against 
3260: 32 5e 36 33 2e 20 2a 2f 0a 20 20 20 20 72 65 74  2^63. */.    ret
3270: 75 72 6e 20 63 6f 6d 70 61 72 65 32 70 6f 77 36  urn compare2pow6
3280: 33 28 7a 4e 75 6d 29 3c 6e 65 67 3b 0a 20 20 7d  3(zNum)<neg;.  }
3290: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 7a 4e 75  .}../*.** If zNu
32a0: 6d 20 72 65 70 72 65 73 65 6e 74 73 20 61 6e 20  m represents an 
32b0: 69 6e 74 65 67 65 72 20 74 68 61 74 20 77 69 6c  integer that wil
32c0: 6c 20 66 69 74 20 69 6e 20 33 32 2d 62 69 74 73  l fit in 32-bits
32d0: 2c 20 74 68 65 6e 20 73 65 74 0a 2a 2a 20 2a 70  , then set.** *p
32e0: 56 61 6c 75 65 20 74 6f 20 74 68 61 74 20 69 6e  Value to that in
32f0: 74 65 67 65 72 20 61 6e 64 20 72 65 74 75 72 6e  teger and return
3300: 20 74 72 75 65 2e 20 20 4f 74 68 65 72 77 69 73   true.  Otherwis
3310: 65 20 72 65 74 75 72 6e 20 66 61 6c 73 65 2e 0a  e return false..
3320: 2a 2a 0a 2a 2a 20 41 6e 79 20 6e 6f 6e 2d 6e 75  **.** Any non-nu
3330: 6d 65 72 69 63 20 63 68 61 72 61 63 74 65 72 73  meric characters
3340: 20 74 68 61 74 20 66 6f 6c 6c 6f 77 69 6e 67 20   that following 
3350: 7a 4e 75 6d 20 61 72 65 20 69 67 6e 6f 72 65 64  zNum are ignored
3360: 2e 0a 2a 2a 20 54 68 69 73 20 69 73 20 64 69 66  ..** This is dif
3370: 66 65 72 65 6e 74 20 66 72 6f 6d 20 73 71 6c 69  ferent from sqli
3380: 74 65 33 41 74 6f 69 36 34 28 29 20 77 68 69 63  te3Atoi64() whic
3390: 68 20 72 65 71 75 69 72 65 73 20 74 68 65 0a 2a  h requires the.*
33a0: 2a 20 69 6e 70 75 74 20 6e 75 6d 62 65 72 20 74  * input number t
33b0: 6f 20 62 65 20 7a 65 72 6f 2d 74 65 72 6d 69 6e  o be zero-termin
33c0: 61 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ated..*/.int sql
33d0: 69 74 65 33 47 65 74 49 6e 74 33 32 28 63 6f 6e  ite3GetInt32(con
33e0: 73 74 20 63 68 61 72 20 2a 7a 4e 75 6d 2c 20 69  st char *zNum, i
33f0: 6e 74 20 2a 70 56 61 6c 75 65 29 7b 0a 20 20 73  nt *pValue){.  s
3400: 71 6c 69 74 65 5f 69 6e 74 36 34 20 76 20 3d 20  qlite_int64 v = 
3410: 30 3b 0a 20 20 69 6e 74 20 69 2c 20 63 3b 0a 20  0;.  int i, c;. 
3420: 20 69 6e 74 20 6e 65 67 20 3d 20 30 3b 0a 20 20   int neg = 0;.  
3430: 69 66 28 20 7a 4e 75 6d 5b 30 5d 3d 3d 27 2d 27  if( zNum[0]=='-'
3440: 20 29 7b 0a 20 20 20 20 6e 65 67 20 3d 20 31 3b   ){.    neg = 1;
3450: 0a 20 20 20 20 7a 4e 75 6d 2b 2b 3b 0a 20 20 7d  .    zNum++;.  }
3460: 65 6c 73 65 20 69 66 28 20 7a 4e 75 6d 5b 30 5d  else if( zNum[0]
3470: 3d 3d 27 2b 27 20 29 7b 0a 20 20 20 20 7a 4e 75  =='+' ){.    zNu
3480: 6d 2b 2b 3b 0a 20 20 7d 0a 20 20 77 68 69 6c 65  m++;.  }.  while
3490: 28 20 7a 4e 75 6d 5b 30 5d 3d 3d 27 30 27 20 29  ( zNum[0]=='0' )
34a0: 20 7a 4e 75 6d 2b 2b 3b 0a 20 20 66 6f 72 28 69   zNum++;.  for(i
34b0: 3d 30 3b 20 69 3c 31 31 20 26 26 20 28 63 20 3d  =0; i<11 && (c =
34c0: 20 7a 4e 75 6d 5b 69 5d 20 2d 20 27 30 27 29 3e   zNum[i] - '0')>
34d0: 3d 30 20 26 26 20 63 3c 3d 39 3b 20 69 2b 2b 29  =0 && c<=9; i++)
34e0: 7b 0a 20 20 20 20 76 20 3d 20 76 2a 31 30 20 2b  {.    v = v*10 +
34f0: 20 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68   c;.  }..  /* Th
3500: 65 20 6c 6f 6e 67 65 73 74 20 64 65 63 69 6d 61  e longest decima
3510: 6c 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e  l representation
3520: 20 6f 66 20 61 20 33 32 20 62 69 74 20 69 6e 74   of a 32 bit int
3530: 65 67 65 72 20 69 73 20 31 30 20 64 69 67 69 74  eger is 10 digit
3540: 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20  s:.  **.  **    
3550: 20 20 20 20 20 20 20 20 20 31 32 33 34 35 36 37           1234567
3560: 38 39 30 0a 20 20 2a 2a 20 20 20 20 20 32 5e 33  890.  **     2^3
3570: 31 20 2d 3e 20 32 31 34 37 34 38 33 36 34 38 0a  1 -> 2147483648.
3580: 20 20 2a 2f 0a 20 20 69 66 28 20 69 3e 31 30 20    */.  if( i>10 
3590: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
35a0: 0a 20 20 7d 0a 20 20 69 66 28 20 76 2d 6e 65 67  .  }.  if( v-neg
35b0: 3e 32 31 34 37 34 38 33 36 34 37 20 29 7b 0a 20  >2147483647 ){. 
35c0: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
35d0: 0a 20 20 69 66 28 20 6e 65 67 20 29 7b 0a 20 20  .  if( neg ){.  
35e0: 20 20 76 20 3d 20 2d 76 3b 0a 20 20 7d 0a 20 20    v = -v;.  }.  
35f0: 2a 70 56 61 6c 75 65 20 3d 20 28 69 6e 74 29 76  *pValue = (int)v
3600: 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a  ;.  return 1;.}.
3610: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76 61 72 69 61  ./*.** The varia
3620: 62 6c 65 2d 6c 65 6e 67 74 68 20 69 6e 74 65 67  ble-length integ
3630: 65 72 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 61  er encoding is a
3640: 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a  s follows:.**.**
3650: 20 4b 45 59 3a 0a 2a 2a 20 20 20 20 20 20 20 20   KEY:.**        
3660: 20 41 20 3d 20 30 78 78 78 78 78 78 78 20 20 20   A = 0xxxxxxx   
3670: 20 37 20 62 69 74 73 20 6f 66 20 64 61 74 61 20   7 bits of data 
3680: 61 6e 64 20 6f 6e 65 20 66 6c 61 67 20 62 69 74  and one flag bit
3690: 0a 2a 2a 20 20 20 20 20 20 20 20 20 42 20 3d 20  .**         B = 
36a0: 31 78 78 78 78 78 78 78 20 20 20 20 37 20 62 69  1xxxxxxx    7 bi
36b0: 74 73 20 6f 66 20 64 61 74 61 20 61 6e 64 20 6f  ts of data and o
36c0: 6e 65 20 66 6c 61 67 20 62 69 74 0a 2a 2a 20 20  ne flag bit.**  
36d0: 20 20 20 20 20 20 20 43 20 3d 20 78 78 78 78 78         C = xxxxx
36e0: 78 78 78 20 20 20 20 38 20 62 69 74 73 20 6f 66  xxx    8 bits of
36f0: 20 64 61 74 61 0a 2a 2a 0a 2a 2a 20 20 37 20 62   data.**.**  7 b
3700: 69 74 73 20 2d 20 41 0a 2a 2a 20 31 34 20 62 69  its - A.** 14 bi
3710: 74 73 20 2d 20 42 41 0a 2a 2a 20 32 31 20 62 69  ts - BA.** 21 bi
3720: 74 73 20 2d 20 42 42 41 0a 2a 2a 20 32 38 20 62  ts - BBA.** 28 b
3730: 69 74 73 20 2d 20 42 42 42 41 0a 2a 2a 20 33 35  its - BBBA.** 35
3740: 20 62 69 74 73 20 2d 20 42 42 42 42 41 0a 2a 2a   bits - BBBBA.**
3750: 20 34 32 20 62 69 74 73 20 2d 20 42 42 42 42 42   42 bits - BBBBB
3760: 41 0a 2a 2a 20 34 39 20 62 69 74 73 20 2d 20 42  A.** 49 bits - B
3770: 42 42 42 42 42 41 0a 2a 2a 20 35 36 20 62 69 74  BBBBBA.** 56 bit
3780: 73 20 2d 20 42 42 42 42 42 42 42 41 0a 2a 2a 20  s - BBBBBBBA.** 
3790: 36 34 20 62 69 74 73 20 2d 20 42 42 42 42 42 42  64 bits - BBBBBB
37a0: 42 42 43 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 57 72  BBC.*/../*.** Wr
37b0: 69 74 65 20 61 20 36 34 2d 62 69 74 20 76 61 72  ite a 64-bit var
37c0: 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 69 6e 74  iable-length int
37d0: 65 67 65 72 20 74 6f 20 6d 65 6d 6f 72 79 20 73  eger to memory s
37e0: 74 61 72 74 69 6e 67 20 61 74 20 70 5b 30 5d 2e  tarting at p[0].
37f0: 0a 2a 2a 20 54 68 65 20 6c 65 6e 67 74 68 20 6f  .** The length o
3800: 66 20 64 61 74 61 20 77 72 69 74 65 20 77 69 6c  f data write wil
3810: 6c 20 62 65 20 62 65 74 77 65 65 6e 20 31 20 61  l be between 1 a
3820: 6e 64 20 39 20 62 79 74 65 73 2e 20 20 54 68 65  nd 9 bytes.  The
3830: 20 6e 75 6d 62 65 72 0a 2a 2a 20 6f 66 20 62 79   number.** of by
3840: 74 65 73 20 77 72 69 74 74 65 6e 20 69 73 20 72  tes written is r
3850: 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 41  eturned..**.** A
3860: 20 76 61 72 69 61 62 6c 65 2d 6c 65 6e 67 74 68   variable-length
3870: 20 69 6e 74 65 67 65 72 20 63 6f 6e 73 69 73 74   integer consist
3880: 73 20 6f 66 20 74 68 65 20 6c 6f 77 65 72 20 37  s of the lower 7
3890: 20 62 69 74 73 20 6f 66 20 65 61 63 68 20 62 79   bits of each by
38a0: 74 65 0a 2a 2a 20 66 6f 72 20 61 6c 6c 20 62 79  te.** for all by
38b0: 74 65 73 20 74 68 61 74 20 68 61 76 65 20 74 68  tes that have th
38c0: 65 20 38 74 68 20 62 69 74 20 73 65 74 20 61 6e  e 8th bit set an
38d0: 64 20 6f 6e 65 20 62 79 74 65 20 77 69 74 68 20  d one byte with 
38e0: 74 68 65 20 38 74 68 0a 2a 2a 20 62 69 74 20 63  the 8th.** bit c
38f0: 6c 65 61 72 2e 20 20 45 78 63 65 70 74 2c 20 69  lear.  Except, i
3900: 66 20 77 65 20 67 65 74 20 74 6f 20 74 68 65 20  f we get to the 
3910: 39 74 68 20 62 79 74 65 2c 20 69 74 20 73 74 6f  9th byte, it sto
3920: 72 65 73 20 74 68 65 20 66 75 6c 6c 0a 2a 2a 20  res the full.** 
3930: 38 20 62 69 74 73 20 61 6e 64 20 69 73 20 74 68  8 bits and is th
3940: 65 20 6c 61 73 74 20 62 79 74 65 2e 0a 2a 2f 0a  e last byte..*/.
3950: 69 6e 74 20 73 71 6c 69 74 65 33 50 75 74 56 61  int sqlite3PutVa
3960: 72 69 6e 74 28 75 6e 73 69 67 6e 65 64 20 63 68  rint(unsigned ch
3970: 61 72 20 2a 70 2c 20 75 36 34 20 76 29 7b 0a 20  ar *p, u64 v){. 
3980: 20 69 6e 74 20 69 2c 20 6a 2c 20 6e 3b 0a 20 20   int i, j, n;.  
3990: 75 38 20 62 75 66 5b 31 30 5d 3b 0a 20 20 69 66  u8 buf[10];.  if
39a0: 28 20 76 20 26 20 28 28 28 75 36 34 29 30 78 66  ( v & (((u64)0xf
39b0: 66 30 30 30 30 30 30 29 3c 3c 33 32 29 20 29 7b  f000000)<<32) ){
39c0: 0a 20 20 20 20 70 5b 38 5d 20 3d 20 76 3b 0a 20  .    p[8] = v;. 
39d0: 20 20 20 76 20 3e 3e 3d 20 38 3b 0a 20 20 20 20     v >>= 8;.    
39e0: 66 6f 72 28 69 3d 37 3b 20 69 3e 3d 30 3b 20 69  for(i=7; i>=0; i
39f0: 2d 2d 29 7b 0a 20 20 20 20 20 20 70 5b 69 5d 20  --){.      p[i] 
3a00: 3d 20 28 76 20 26 20 30 78 37 66 29 20 7c 20 30  = (v & 0x7f) | 0
3a10: 78 38 30 3b 0a 20 20 20 20 20 20 76 20 3e 3e 3d  x80;.      v >>=
3a20: 20 37 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65   7;.    }.    re
3a30: 74 75 72 6e 20 39 3b 0a 20 20 7d 20 20 20 20 0a  turn 9;.  }    .
3a40: 20 20 6e 20 3d 20 30 3b 0a 20 20 64 6f 7b 0a 20    n = 0;.  do{. 
3a50: 20 20 20 62 75 66 5b 6e 2b 2b 5d 20 3d 20 28 76     buf[n++] = (v
3a60: 20 26 20 30 78 37 66 29 20 7c 20 30 78 38 30 3b   & 0x7f) | 0x80;
3a70: 0a 20 20 20 20 76 20 3e 3e 3d 20 37 3b 0a 20 20  .    v >>= 7;.  
3a80: 7d 77 68 69 6c 65 28 20 76 21 3d 30 20 29 3b 0a  }while( v!=0 );.
3a90: 20 20 62 75 66 5b 30 5d 20 26 3d 20 30 78 37 66    buf[0] &= 0x7f
3aa0: 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 3c 3d 39  ;.  assert( n<=9
3ab0: 20 29 3b 0a 20 20 66 6f 72 28 69 3d 30 2c 20 6a   );.  for(i=0, j
3ac0: 3d 6e 2d 31 3b 20 6a 3e 3d 30 3b 20 6a 2d 2d 2c  =n-1; j>=0; j--,
3ad0: 20 69 2b 2b 29 7b 0a 20 20 20 20 70 5b 69 5d 20   i++){.    p[i] 
3ae0: 3d 20 62 75 66 5b 6a 5d 3b 0a 20 20 7d 0a 20 20  = buf[j];.  }.  
3af0: 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a  return n;.}../*.
3b00: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
3b10: 69 73 20 61 20 66 61 73 74 65 72 20 76 65 72 73  is a faster vers
3b20: 69 6f 6e 20 6f 66 20 73 71 6c 69 74 65 33 50 75  ion of sqlite3Pu
3b30: 74 56 61 72 69 6e 74 28 29 20 74 68 61 74 20 6f  tVarint() that o
3b40: 6e 6c 79 0a 2a 2a 20 77 6f 72 6b 73 20 66 6f 72  nly.** works for
3b50: 20 33 32 2d 62 69 74 20 70 6f 73 69 74 69 76 65   32-bit positive
3b60: 20 69 6e 74 65 67 65 72 73 20 61 6e 64 20 77 68   integers and wh
3b70: 69 63 68 20 69 73 20 6f 70 74 69 6d 69 7a 65 64  ich is optimized
3b80: 20 66 6f 72 0a 2a 2a 20 74 68 65 20 63 6f 6d 6d   for.** the comm
3b90: 6f 6e 20 63 61 73 65 20 6f 66 20 73 6d 61 6c 6c  on case of small
3ba0: 20 69 6e 74 65 67 65 72 73 2e 0a 2a 2f 0a 69 6e   integers..*/.in
3bb0: 74 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 69  t sqlite3PutVari
3bc0: 6e 74 33 32 28 75 6e 73 69 67 6e 65 64 20 63 68  nt32(unsigned ch
3bd0: 61 72 20 2a 70 2c 20 75 33 32 20 76 29 7b 0a 20  ar *p, u32 v){. 
3be0: 20 69 66 28 20 28 76 20 26 20 7e 30 78 37 66 29   if( (v & ~0x7f)
3bf0: 3d 3d 30 20 29 7b 0a 20 20 20 20 70 5b 30 5d 20  ==0 ){.    p[0] 
3c00: 3d 20 76 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  = v;.    return 
3c10: 31 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 28  1;.  }else if( (
3c20: 76 20 26 20 7e 30 78 33 66 66 66 29 3d 3d 30 20  v & ~0x3fff)==0 
3c30: 29 7b 0a 20 20 20 20 70 5b 30 5d 20 3d 20 28 76  ){.    p[0] = (v
3c40: 3e 3e 37 29 20 7c 20 30 78 38 30 3b 0a 20 20 20  >>7) | 0x80;.   
3c50: 20 70 5b 31 5d 20 3d 20 76 20 26 20 30 78 37 66   p[1] = v & 0x7f
3c60: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 32 3b 0a  ;.    return 2;.
3c70: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74    }else{.    ret
3c80: 75 72 6e 20 73 71 6c 69 74 65 33 50 75 74 56 61  urn sqlite3PutVa
3c90: 72 69 6e 74 28 70 2c 20 76 29 3b 0a 20 20 7d 0a  rint(p, v);.  }.
3ca0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 20  }../*.** Read a 
3cb0: 36 34 2d 62 69 74 20 76 61 72 69 61 62 6c 65 2d  64-bit variable-
3cc0: 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 20 66  length integer f
3cd0: 72 6f 6d 20 6d 65 6d 6f 72 79 20 73 74 61 72 74  rom memory start
3ce0: 69 6e 67 20 61 74 20 70 5b 30 5d 2e 0a 2a 2a 20  ing at p[0]..** 
3cf0: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
3d00: 72 20 6f 66 20 62 79 74 65 73 20 72 65 61 64 2e  r of bytes read.
3d10: 20 20 54 68 65 20 76 61 6c 75 65 20 69 73 20 73    The value is s
3d20: 74 6f 72 65 64 20 69 6e 20 2a 76 2e 0a 2a 2f 0a  tored in *v..*/.
3d30: 69 6e 74 20 73 71 6c 69 74 65 33 47 65 74 56 61  int sqlite3GetVa
3d40: 72 69 6e 74 28 63 6f 6e 73 74 20 75 6e 73 69 67  rint(const unsig
3d50: 6e 65 64 20 63 68 61 72 20 2a 70 2c 20 75 36 34  ned char *p, u64
3d60: 20 2a 76 29 7b 0a 20 20 75 33 32 20 78 3b 0a 20   *v){.  u32 x;. 
3d70: 20 75 36 34 20 78 36 34 3b 0a 20 20 69 6e 74 20   u64 x64;.  int 
3d80: 6e 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68  n;.  unsigned ch
3d90: 61 72 20 63 3b 0a 20 20 69 66 28 20 28 28 63 20  ar c;.  if( ((c 
3da0: 3d 20 70 5b 30 5d 29 20 26 20 30 78 38 30 29 3d  = p[0]) & 0x80)=
3db0: 3d 30 20 29 7b 0a 20 20 20 20 2a 76 20 3d 20 63  =0 ){.    *v = c
3dc0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a  ;.    return 1;.
3dd0: 20 20 7d 0a 20 20 78 20 3d 20 63 20 26 20 30 78    }.  x = c & 0x
3de0: 37 66 3b 0a 20 20 69 66 28 20 28 28 63 20 3d 20  7f;.  if( ((c = 
3df0: 70 5b 31 5d 29 20 26 20 30 78 38 30 29 3d 3d 30  p[1]) & 0x80)==0
3e00: 20 29 7b 0a 20 20 20 20 2a 76 20 3d 20 28 78 3c   ){.    *v = (x<
3e10: 3c 37 29 20 7c 20 63 3b 0a 20 20 20 20 72 65 74  <7) | c;.    ret
3e20: 75 72 6e 20 32 3b 0a 20 20 7d 0a 20 20 78 20 3d  urn 2;.  }.  x =
3e30: 20 28 78 3c 3c 37 29 20 7c 20 28 63 26 30 78 37   (x<<7) | (c&0x7
3e40: 66 29 3b 0a 20 20 69 66 28 20 28 28 63 20 3d 20  f);.  if( ((c = 
3e50: 70 5b 32 5d 29 20 26 20 30 78 38 30 29 3d 3d 30  p[2]) & 0x80)==0
3e60: 20 29 7b 0a 20 20 20 20 2a 76 20 3d 20 28 78 3c   ){.    *v = (x<
3e70: 3c 37 29 20 7c 20 63 3b 0a 20 20 20 20 72 65 74  <7) | c;.    ret
3e80: 75 72 6e 20 33 3b 0a 20 20 7d 0a 20 20 78 20 3d  urn 3;.  }.  x =
3e90: 20 28 78 3c 3c 37 29 20 7c 20 28 63 26 30 78 37   (x<<7) | (c&0x7
3ea0: 66 29 3b 0a 20 20 69 66 28 20 28 28 63 20 3d 20  f);.  if( ((c = 
3eb0: 70 5b 33 5d 29 20 26 20 30 78 38 30 29 3d 3d 30  p[3]) & 0x80)==0
3ec0: 20 29 7b 0a 20 20 20 20 2a 76 20 3d 20 28 78 3c   ){.    *v = (x<
3ed0: 3c 37 29 20 7c 20 63 3b 0a 20 20 20 20 72 65 74  <7) | c;.    ret
3ee0: 75 72 6e 20 34 3b 0a 20 20 7d 0a 20 20 78 36 34  urn 4;.  }.  x64
3ef0: 20 3d 20 28 78 3c 3c 37 29 20 7c 20 28 63 26 30   = (x<<7) | (c&0
3f00: 78 37 66 29 3b 0a 20 20 6e 20 3d 20 34 3b 0a 20  x7f);.  n = 4;. 
3f10: 20 64 6f 7b 0a 20 20 20 20 63 20 3d 20 70 5b 6e   do{.    c = p[n
3f20: 2b 2b 5d 3b 0a 20 20 20 20 69 66 28 20 6e 3d 3d  ++];.    if( n==
3f30: 39 20 29 7b 0a 20 20 20 20 20 20 78 36 34 20 3d  9 ){.      x64 =
3f40: 20 28 78 36 34 3c 3c 38 29 20 7c 20 63 3b 0a 20   (x64<<8) | c;. 
3f50: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
3f60: 7d 0a 20 20 20 20 78 36 34 20 3d 20 28 78 36 34  }.    x64 = (x64
3f70: 3c 3c 37 29 20 7c 20 28 63 26 30 78 37 66 29 3b  <<7) | (c&0x7f);
3f80: 0a 20 20 7d 77 68 69 6c 65 28 20 28 63 20 26 20  .  }while( (c & 
3f90: 30 78 38 30 29 21 3d 30 20 29 3b 0a 20 20 2a 76  0x80)!=0 );.  *v
3fa0: 20 3d 20 78 36 34 3b 0a 20 20 72 65 74 75 72 6e   = x64;.  return
3fb0: 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61   n;.}../*.** Rea
3fc0: 64 20 61 20 33 32 2d 62 69 74 20 76 61 72 69 61  d a 32-bit varia
3fd0: 62 6c 65 2d 6c 65 6e 67 74 68 20 69 6e 74 65 67  ble-length integ
3fe0: 65 72 20 66 72 6f 6d 20 6d 65 6d 6f 72 79 20 73  er from memory s
3ff0: 74 61 72 74 69 6e 67 20 61 74 20 70 5b 30 5d 2e  tarting at p[0].
4000: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
4010: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 72  umber of bytes r
4020: 65 61 64 2e 20 20 54 68 65 20 76 61 6c 75 65 20  ead.  The value 
4030: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 2a 76 2e  is stored in *v.
4040: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 47  .*/.int sqlite3G
4050: 65 74 56 61 72 69 6e 74 33 32 28 63 6f 6e 73 74  etVarint32(const
4060: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
4070: 70 2c 20 75 33 32 20 2a 76 29 7b 0a 20 20 75 33  p, u32 *v){.  u3
4080: 32 20 78 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20  2 x;.  int n;.  
4090: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 63 3b  unsigned char c;
40a0: 0a 20 20 69 66 28 20 28 28 73 69 67 6e 65 64 20  .  if( ((signed 
40b0: 63 68 61 72 2a 29 70 29 5b 30 5d 3e 3d 30 20 29  char*)p)[0]>=0 )
40c0: 7b 0a 20 20 20 20 2a 76 20 3d 20 70 5b 30 5d 3b  {.    *v = p[0];
40d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20  .    return 1;. 
40e0: 20 7d 0a 20 20 78 20 3d 20 70 5b 30 5d 20 26 20   }.  x = p[0] & 
40f0: 30 78 37 66 3b 0a 20 20 69 66 28 20 28 28 73 69  0x7f;.  if( ((si
4100: 67 6e 65 64 20 63 68 61 72 2a 29 70 29 5b 31 5d  gned char*)p)[1]
4110: 3e 3d 30 20 29 7b 0a 20 20 20 20 2a 76 20 3d 20  >=0 ){.    *v = 
4120: 28 78 3c 3c 37 29 20 7c 20 70 5b 31 5d 3b 0a 20  (x<<7) | p[1];. 
4130: 20 20 20 72 65 74 75 72 6e 20 32 3b 0a 20 20 7d     return 2;.  }
4140: 0a 20 20 78 20 3d 20 28 78 3c 3c 37 29 20 7c 20  .  x = (x<<7) | 
4150: 28 70 5b 31 5d 20 26 20 30 78 37 66 29 3b 0a 20  (p[1] & 0x7f);. 
4160: 20 6e 20 3d 20 32 3b 0a 20 20 64 6f 7b 0a 20 20   n = 2;.  do{.  
4170: 20 20 78 20 3d 20 28 78 3c 3c 37 29 20 7c 20 28    x = (x<<7) | (
4180: 28 63 20 3d 20 70 5b 6e 2b 2b 5d 29 26 30 78 37  (c = p[n++])&0x7
4190: 66 29 3b 0a 20 20 7d 77 68 69 6c 65 28 20 28 63  f);.  }while( (c
41a0: 20 26 20 30 78 38 30 29 21 3d 30 20 26 26 20 6e   & 0x80)!=0 && n
41b0: 3c 39 20 29 3b 0a 20 20 2a 76 20 3d 20 78 3b 0a  <9 );.  *v = x;.
41c0: 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f    return n;.}../
41d0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
41e0: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  number of bytes 
41f0: 74 68 61 74 20 77 69 6c 6c 20 62 65 20 6e 65 65  that will be nee
4200: 64 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65  ded to store the
4210: 20 67 69 76 65 6e 0a 2a 2a 20 36 34 2d 62 69 74   given.** 64-bit
4220: 20 69 6e 74 65 67 65 72 2e 0a 2a 2f 0a 69 6e 74   integer..*/.int
4230: 20 73 71 6c 69 74 65 33 56 61 72 69 6e 74 4c 65   sqlite3VarintLe
4240: 6e 28 75 36 34 20 76 29 7b 0a 20 20 69 6e 74 20  n(u64 v){.  int 
4250: 69 20 3d 20 30 3b 0a 20 20 64 6f 7b 0a 20 20 20  i = 0;.  do{.   
4260: 20 69 2b 2b 3b 0a 20 20 20 20 76 20 3e 3e 3d 20   i++;.    v >>= 
4270: 37 3b 0a 20 20 7d 77 68 69 6c 65 28 20 76 21 3d  7;.  }while( v!=
4280: 30 20 26 26 20 69 3c 39 20 29 3b 0a 20 20 72 65  0 && i<9 );.  re
4290: 74 75 72 6e 20 69 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a  turn i;.}.../*.*
42a0: 2a 20 52 65 61 64 20 6f 72 20 77 72 69 74 65 20  * Read or write 
42b0: 61 20 66 6f 75 72 2d 62 79 74 65 20 62 69 67 2d  a four-byte big-
42c0: 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 76  endian integer v
42d0: 61 6c 75 65 2e 0a 2a 2f 0a 75 33 32 20 73 71 6c  alue..*/.u32 sql
42e0: 69 74 65 33 47 65 74 34 62 79 74 65 28 63 6f 6e  ite3Get4byte(con
42f0: 73 74 20 75 38 20 2a 70 29 7b 0a 20 20 72 65 74  st u8 *p){.  ret
4300: 75 72 6e 20 28 70 5b 30 5d 3c 3c 32 34 29 20 7c  urn (p[0]<<24) |
4310: 20 28 70 5b 31 5d 3c 3c 31 36 29 20 7c 20 28 70   (p[1]<<16) | (p
4320: 5b 32 5d 3c 3c 38 29 20 7c 20 70 5b 33 5d 3b 0a  [2]<<8) | p[3];.
4330: 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 75  }.void sqlite3Pu
4340: 74 34 62 79 74 65 28 75 6e 73 69 67 6e 65 64 20  t4byte(unsigned 
4350: 63 68 61 72 20 2a 70 2c 20 75 33 32 20 76 29 7b  char *p, u32 v){
4360: 0a 20 20 70 5b 30 5d 20 3d 20 76 3e 3e 32 34 3b  .  p[0] = v>>24;
4370: 0a 20 20 70 5b 31 5d 20 3d 20 76 3e 3e 31 36 3b  .  p[1] = v>>16;
4380: 0a 20 20 70 5b 32 5d 20 3d 20 76 3e 3e 38 3b 0a  .  p[2] = v>>8;.
4390: 20 20 70 5b 33 5d 20 3d 20 76 3b 0a 7d 0a 0a 0a    p[3] = v;.}...
43a0: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51  .#if !defined(SQ
43b0: 4c 49 54 45 5f 4f 4d 49 54 5f 42 4c 4f 42 5f 4c  LITE_OMIT_BLOB_L
43c0: 49 54 45 52 41 4c 29 20 7c 7c 20 64 65 66 69 6e  ITERAL) || defin
43d0: 65 64 28 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f  ed(SQLITE_HAS_CO
43e0: 44 45 43 29 0a 2f 2a 0a 2a 2a 20 54 72 61 6e 73  DEC)./*.** Trans
43f0: 6c 61 74 65 20 61 20 73 69 6e 67 6c 65 20 62 79  late a single by
4400: 74 65 20 6f 66 20 48 65 78 20 69 6e 74 6f 20 61  te of Hex into a
4410: 6e 20 69 6e 74 65 67 65 72 2e 0a 2a 2a 20 54 68  n integer..** Th
4420: 69 73 20 72 6f 75 74 69 6e 65 6e 20 6f 6e 6c 79  is routinen only
4430: 20 77 6f 72 6b 73 20 69 66 20 68 20 72 65 61 6c   works if h real
4440: 6c 79 20 69 73 20 61 20 76 61 6c 69 64 20 68 65  ly is a valid he
4450: 78 61 64 65 63 69 6d 61 6c 0a 2a 2a 20 63 68 61  xadecimal.** cha
4460: 72 61 63 74 65 72 3a 20 20 30 2e 2e 39 61 2e 2e  racter:  0..9a..
4470: 66 41 2e 2e 46 0a 2a 2f 0a 73 74 61 74 69 63 20  fA..F.*/.static 
4480: 69 6e 74 20 68 65 78 54 6f 49 6e 74 28 69 6e 74  int hexToInt(int
4490: 20 68 29 7b 0a 23 69 66 20 21 64 65 66 69 6e 65   h){.#if !define
44a0: 64 28 53 51 4c 49 54 45 5f 45 42 43 44 49 43 29  d(SQLITE_EBCDIC)
44b0: 0a 20 20 69 6e 74 20 78 20 3d 20 68 20 2d 20 27  .  int x = h - '
44c0: 30 27 3b 0a 20 20 69 66 28 20 78 3e 39 20 29 7b  0';.  if( x>9 ){
44d0: 0a 20 20 20 20 78 20 3d 20 28 68 20 2d 20 27 41  .    x = (h - 'A
44e0: 27 20 2b 20 31 30 29 20 26 20 30 78 66 3b 0a 20  ' + 10) & 0xf;. 
44f0: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 78 3e 3d   }.  assert( x>=
4500: 30 20 26 26 20 78 3c 3d 31 35 20 29 3b 0a 20 20  0 && x<=15 );.  
4510: 72 65 74 75 72 6e 20 78 3b 0a 23 65 6c 73 65 0a  return x;.#else.
4520: 20 20 69 66 28 20 68 3e 3d 27 30 27 20 26 26 20    if( h>='0' && 
4530: 68 3c 3d 27 39 27 20 29 7b 0a 20 20 20 20 72 65  h<='9' ){.    re
4540: 74 75 72 6e 20 68 20 2d 20 27 30 27 3b 0a 20 20  turn h - '0';.  
4550: 7d 65 6c 73 65 20 69 66 28 20 68 3e 3d 27 61 27  }else if( h>='a'
4560: 20 26 26 20 68 3c 3d 27 66 27 20 29 7b 0a 20 20   && h<='f' ){.  
4570: 20 20 72 65 74 75 72 6e 20 68 20 2d 20 27 61 27    return h - 'a'
4580: 20 2b 20 31 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a   + 10;.  }else{.
4590: 20 20 20 20 61 73 73 65 72 74 28 20 68 3e 3d 27      assert( h>='
45a0: 41 27 20 26 26 20 68 3c 3d 27 46 27 20 29 3b 0a  A' && h<='F' );.
45b0: 20 20 20 20 72 65 74 75 72 6e 20 68 20 2d 20 27      return h - '
45c0: 41 27 20 2b 20 31 30 3b 0a 20 20 7d 0a 23 65 6e  A' + 10;.  }.#en
45d0: 64 69 66 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20  dif.}.#endif /* 
45e0: 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 4c 4f  !SQLITE_OMIT_BLO
45f0: 42 5f 4c 49 54 45 52 41 4c 20 7c 7c 20 53 51 4c  B_LITERAL || SQL
4600: 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 20 2a 2f  ITE_HAS_CODEC */
4610: 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53  ..#if !defined(S
4620: 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 4c 4f 42 5f  QLITE_OMIT_BLOB_
4630: 4c 49 54 45 52 41 4c 29 20 7c 7c 20 64 65 66 69  LITERAL) || defi
4640: 6e 65 64 28 53 51 4c 49 54 45 5f 48 41 53 5f 43  ned(SQLITE_HAS_C
4650: 4f 44 45 43 29 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76  ODEC)./*.** Conv
4660: 65 72 74 20 61 20 42 4c 4f 42 20 6c 69 74 65 72  ert a BLOB liter
4670: 61 6c 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 22  al of the form "
4680: 78 27 68 68 68 68 68 68 27 22 20 69 6e 74 6f 20  x'hhhhhh'" into 
4690: 69 74 73 20 62 69 6e 61 72 79 0a 2a 2a 20 76 61  its binary.** va
46a0: 6c 75 65 2e 20 20 52 65 74 75 72 6e 20 61 20 70  lue.  Return a p
46b0: 6f 69 6e 74 65 72 20 74 6f 20 69 74 73 20 62 69  ointer to its bi
46c0: 6e 61 72 79 20 76 61 6c 75 65 2e 20 20 53 70 61  nary value.  Spa
46d0: 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 65 0a 2a  ce to hold the.*
46e0: 2a 20 62 69 6e 61 72 79 20 76 61 6c 75 65 20 68  * binary value h
46f0: 61 73 20 62 65 65 6e 20 6f 62 74 61 69 6e 65 64  as been obtained
4700: 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 20 61 6e 64   from malloc and
4710: 20 6d 75 73 74 20 62 65 20 66 72 65 65 64 20 62   must be freed b
4720: 79 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 69 6e 67  y.** the calling
4730: 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 76 6f 69   routine..*/.voi
4740: 64 20 2a 73 71 6c 69 74 65 33 48 65 78 54 6f 42  d *sqlite3HexToB
4750: 6c 6f 62 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  lob(sqlite3 *db,
4760: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20   const char *z, 
4770: 69 6e 74 20 6e 29 7b 0a 20 20 63 68 61 72 20 2a  int n){.  char *
4780: 7a 42 6c 6f 62 3b 0a 20 20 69 6e 74 20 69 3b 0a  zBlob;.  int i;.
4790: 0a 20 20 7a 42 6c 6f 62 20 3d 20 28 63 68 61 72  .  zBlob = (char
47a0: 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c   *)sqlite3DbMall
47b0: 6f 63 52 61 77 28 64 62 2c 20 6e 2f 32 20 2b 20  ocRaw(db, n/2 + 
47c0: 31 29 3b 0a 20 20 6e 2d 2d 3b 0a 20 20 69 66 28  1);.  n--;.  if(
47d0: 20 7a 42 6c 6f 62 20 29 7b 0a 20 20 20 20 66 6f   zBlob ){.    fo
47e0: 72 28 69 3d 30 3b 20 69 3c 6e 3b 20 69 2b 3d 32  r(i=0; i<n; i+=2
47f0: 29 7b 0a 20 20 20 20 20 20 7a 42 6c 6f 62 5b 69  ){.      zBlob[i
4800: 2f 32 5d 20 3d 20 28 68 65 78 54 6f 49 6e 74 28  /2] = (hexToInt(
4810: 7a 5b 69 5d 29 3c 3c 34 29 20 7c 20 68 65 78 54  z[i])<<4) | hexT
4820: 6f 49 6e 74 28 7a 5b 69 2b 31 5d 29 3b 0a 20 20  oInt(z[i+1]);.  
4830: 20 20 7d 0a 20 20 20 20 7a 42 6c 6f 62 5b 69 2f    }.    zBlob[i/
4840: 32 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65  2] = 0;.  }.  re
4850: 74 75 72 6e 20 7a 42 6c 6f 62 3b 0a 7d 0a 23 65  turn zBlob;.}.#e
4860: 6e 64 69 66 20 2f 2a 20 21 53 51 4c 49 54 45 5f  ndif /* !SQLITE_
4870: 4f 4d 49 54 5f 42 4c 4f 42 5f 4c 49 54 45 52 41  OMIT_BLOB_LITERA
4880: 4c 20 7c 7c 20 53 51 4c 49 54 45 5f 48 41 53 5f  L || SQLITE_HAS_
4890: 43 4f 44 45 43 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a  CODEC */.../*.**
48a0: 20 43 68 61 6e 67 65 20 74 68 65 20 73 71 6c 69   Change the sqli
48b0: 74 65 2e 6d 61 67 69 63 20 66 72 6f 6d 20 53 51  te.magic from SQ
48c0: 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 20  LITE_MAGIC_OPEN 
48d0: 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  to SQLITE_MAGIC_
48e0: 42 55 53 59 2e 0a 2a 2a 20 52 65 74 75 72 6e 20  BUSY..** Return 
48f0: 61 6e 20 65 72 72 6f 72 20 28 6e 6f 6e 2d 7a 65  an error (non-ze
4900: 72 6f 29 20 69 66 20 74 68 65 20 6d 61 67 69 63  ro) if the magic
4910: 20 77 61 73 20 6e 6f 74 20 53 51 4c 49 54 45 5f   was not SQLITE_
4920: 4d 41 47 49 43 5f 4f 50 45 4e 0a 2a 2a 20 77 68  MAGIC_OPEN.** wh
4930: 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  en this routine 
4940: 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a  is called..**.**
4950: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
4960: 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 65 6e 74   called when ent
4970: 65 72 69 6e 67 20 61 6e 20 53 51 4c 69 74 65 20  ering an SQLite 
4980: 41 50 49 2e 20 20 54 68 65 20 53 51 4c 49 54 45  API.  The SQLITE
4990: 5f 4d 41 47 49 43 5f 4f 50 45 4e 0a 2a 2a 20 76  _MAGIC_OPEN.** v
49a0: 61 6c 75 65 20 69 6e 64 69 63 61 74 65 73 20 74  alue indicates t
49b0: 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73 65  hat the database
49c0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 61 73 73   connection pass
49d0: 65 64 20 69 6e 74 6f 20 74 68 65 20 41 50 49 20  ed into the API 
49e0: 69 73 0a 2a 2a 20 6f 70 65 6e 20 61 6e 64 20 69  is.** open and i
49f0: 73 20 6e 6f 74 20 62 65 69 6e 67 20 75 73 65 64  s not being used
4a00: 20 62 79 20 61 6e 6f 74 68 65 72 20 74 68 72 65   by another thre
4a10: 61 64 2e 20 20 42 79 20 63 68 61 6e 67 69 6e 67  ad.  By changing
4a20: 20 74 68 65 20 76 61 6c 75 65 0a 2a 2a 20 74 6f   the value.** to
4a30: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55   SQLITE_MAGIC_BU
4a40: 53 59 20 77 65 20 69 6e 64 69 63 61 74 65 20 74  SY we indicate t
4a50: 68 61 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69  hat the connecti
4a60: 6f 6e 20 69 73 20 69 6e 20 75 73 65 2e 0a 2a 2a  on is in use..**
4a70: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66   sqlite3SafetyOf
4a80: 66 28 29 20 62 65 6c 6f 77 20 77 69 6c 6c 20 63  f() below will c
4a90: 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20  hange the value 
4aa0: 62 61 63 6b 20 74 6f 20 53 51 4c 49 54 45 5f 4d  back to SQLITE_M
4ab0: 41 47 49 43 5f 4f 50 45 4e 0a 2a 2a 20 77 68 65  AGIC_OPEN.** whe
4ac0: 6e 20 74 68 65 20 41 50 49 20 65 78 69 74 73 2e  n the API exits.
4ad0: 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75   .**.** This rou
4ae0: 74 69 6e 65 20 69 73 20 61 20 61 74 74 65 6d 70  tine is a attemp
4af0: 74 20 74 6f 20 64 65 74 65 63 74 20 69 66 20 74  t to detect if t
4b00: 77 6f 20 74 68 72 65 61 64 73 20 75 73 65 20 74  wo threads use t
4b10: 68 65 0a 2a 2a 20 73 61 6d 65 20 73 71 6c 69 74  he.** same sqlit
4b20: 65 2a 20 70 6f 69 6e 74 65 72 20 61 74 20 74 68  e* pointer at th
4b30: 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 54 68  e same time.  Th
4b40: 65 72 65 20 69 73 20 61 20 72 61 63 65 20 0a 2a  ere is a race .*
4b50: 2a 20 63 6f 6e 64 69 74 69 6f 6e 20 73 6f 20 69  * condition so i
4b60: 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 68  t is possible th
4b70: 61 74 20 74 68 65 20 65 72 72 6f 72 20 69 73 20  at the error is 
4b80: 6e 6f 74 20 64 65 74 65 63 74 65 64 2e 0a 2a 2a  not detected..**
4b90: 20 42 75 74 20 75 73 75 61 6c 6c 79 20 74 68 65   But usually the
4ba0: 20 70 72 6f 62 6c 65 6d 20 77 69 6c 6c 20 62 65   problem will be
4bb0: 20 73 65 65 6e 2e 20 20 54 68 65 20 72 65 73 75   seen.  The resu
4bc0: 6c 74 20 77 69 6c 6c 20 62 65 20 61 6e 0a 2a 2a  lt will be an.**
4bd0: 20 65 72 72 6f 72 20 77 68 69 63 68 20 63 61 6e   error which can
4be0: 20 62 65 20 75 73 65 64 20 74 6f 20 64 65 62 75   be used to debu
4bf0: 67 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f  g the applicatio
4c00: 6e 20 74 68 61 74 20 69 73 0a 2a 2a 20 75 73 69  n that is.** usi
4c10: 6e 67 20 53 51 4c 69 74 65 20 69 6e 63 6f 72 72  ng SQLite incorr
4c20: 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 54 69 63  ectly..**.** Tic
4c30: 6b 65 74 20 23 32 30 32 3a 20 20 49 66 20 64 62  ket #202:  If db
4c40: 2d 3e 6d 61 67 69 63 20 69 73 20 6e 6f 74 20 61  ->magic is not a
4c50: 20 76 61 6c 69 64 20 6f 70 65 6e 20 76 61 6c 75   valid open valu
4c60: 65 2c 20 74 61 6b 65 20 63 61 72 65 20 6e 6f 74  e, take care not
4c70: 0a 2a 2a 20 74 6f 20 6d 6f 64 69 66 79 20 74 68  .** to modify th
4c80: 65 20 64 62 20 73 74 72 75 63 74 75 72 65 20 61  e db structure a
4c90: 74 20 61 6c 6c 2e 20 20 49 74 20 63 6f 75 6c 64  t all.  It could
4ca0: 20 62 65 20 74 68 61 74 20 64 62 20 69 73 20 61   be that db is a
4cb0: 20 73 74 61 6c 65 0a 2a 2a 20 70 6f 69 6e 74 65   stale.** pointe
4cc0: 72 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72  r.  In other wor
4cd0: 64 73 2c 20 69 74 20 63 6f 75 6c 64 20 62 65 20  ds, it could be 
4ce0: 74 68 61 74 20 74 68 65 72 65 20 68 61 73 20 62  that there has b
4cf0: 65 65 6e 20 61 20 70 72 69 6f 72 0a 2a 2a 20 63  een a prior.** c
4d00: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 63  all to sqlite3_c
4d10: 6c 6f 73 65 28 64 62 29 20 61 6e 64 20 64 62 20  lose(db) and db 
4d20: 68 61 73 20 62 65 65 6e 20 64 65 61 6c 6c 6f 63  has been dealloc
4d30: 61 74 65 64 2e 20 20 41 6e 64 20 77 65 20 64 6f  ated.  And we do
4d40: 0a 2a 2a 20 6e 6f 74 20 77 61 6e 74 20 74 6f 20  .** not want to 
4d50: 77 72 69 74 65 20 69 6e 74 6f 20 64 65 61 6c 6c  write into deall
4d60: 6f 63 61 74 65 64 20 6d 65 6d 6f 72 79 2e 0a 2a  ocated memory..*
4d70: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  /.#ifdef SQLITE_
4d80: 44 45 42 55 47 0a 69 6e 74 20 73 71 6c 69 74 65  DEBUG.int sqlite
4d90: 33 53 61 66 65 74 79 4f 6e 28 73 71 6c 69 74 65  3SafetyOn(sqlite
4da0: 33 20 2a 64 62 29 7b 0a 20 20 69 66 28 20 64 62  3 *db){.  if( db
4db0: 2d 3e 6d 61 67 69 63 3d 3d 53 51 4c 49 54 45 5f  ->magic==SQLITE_
4dc0: 4d 41 47 49 43 5f 4f 50 45 4e 20 29 7b 0a 20 20  MAGIC_OPEN ){.  
4dd0: 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51    db->magic = SQ
4de0: 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 3b  LITE_MAGIC_BUSY;
4df0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
4e00: 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e 6d   }else if( db->m
4e10: 61 67 69 63 3d 3d 53 51 4c 49 54 45 5f 4d 41 47  agic==SQLITE_MAG
4e20: 49 43 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 64  IC_BUSY ){.    d
4e30: 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54  b->magic = SQLIT
4e40: 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 20  E_MAGIC_ERROR;. 
4e50: 20 20 20 64 62 2d 3e 75 31 2e 69 73 49 6e 74 65     db->u1.isInte
4e60: 72 72 75 70 74 65 64 20 3d 20 31 3b 0a 20 20 7d  rrupted = 1;.  }
4e70: 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a 23  .  return 1;.}.#
4e80: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 68 61  endif../*.** Cha
4e90: 6e 67 65 20 74 68 65 20 6d 61 67 69 63 20 66 72  nge the magic fr
4ea0: 6f 6d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  om SQLITE_MAGIC_
4eb0: 42 55 53 59 20 74 6f 20 53 51 4c 49 54 45 5f 4d  BUSY to SQLITE_M
4ec0: 41 47 49 43 5f 4f 50 45 4e 2e 0a 2a 2a 20 52 65  AGIC_OPEN..** Re
4ed0: 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 28 6e  turn an error (n
4ee0: 6f 6e 2d 7a 65 72 6f 29 20 69 66 20 74 68 65 20  on-zero) if the 
4ef0: 6d 61 67 69 63 20 77 61 73 20 6e 6f 74 20 53 51  magic was not SQ
4f00: 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 0a  LITE_MAGIC_BUSY.
4f10: 2a 2a 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75  ** when this rou
4f20: 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 0a  tine is called..
4f30: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  */.#ifdef SQLITE
4f40: 5f 44 45 42 55 47 0a 69 6e 74 20 73 71 6c 69 74  _DEBUG.int sqlit
4f50: 65 33 53 61 66 65 74 79 4f 66 66 28 73 71 6c 69  e3SafetyOff(sqli
4f60: 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66 28 20  te3 *db){.  if( 
4f70: 64 62 2d 3e 6d 61 67 69 63 3d 3d 53 51 4c 49 54  db->magic==SQLIT
4f80: 45 5f 4d 41 47 49 43 5f 42 55 53 59 20 29 7b 0a  E_MAGIC_BUSY ){.
4f90: 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20      db->magic = 
4fa0: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45  SQLITE_MAGIC_OPE
4fb0: 4e 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  N;.    return 0;
4fc0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62  .  }else{.    db
4fd0: 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45  ->magic = SQLITE
4fe0: 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 20 20  _MAGIC_ERROR;.  
4ff0: 20 20 64 62 2d 3e 75 31 2e 69 73 49 6e 74 65 72    db->u1.isInter
5000: 72 75 70 74 65 64 20 3d 20 31 3b 0a 20 20 20 20  rupted = 1;.    
5010: 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 7d 0a  return 1;.  }.}.
5020: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 68  #endif../*.** Ch
5030: 65 63 6b 20 74 6f 20 6d 61 6b 65 20 73 75 72 65  eck to make sure
5040: 20 77 65 20 68 61 76 65 20 61 20 76 61 6c 69 64   we have a valid
5050: 20 64 62 20 70 6f 69 6e 74 65 72 2e 20 20 54 68   db pointer.  Th
5060: 69 73 20 74 65 73 74 20 69 73 20 6e 6f 74 0a 2a  is test is not.*
5070: 2a 20 66 6f 6f 6c 70 72 6f 6f 66 20 62 75 74 20  * foolproof but 
5080: 69 74 20 64 6f 65 73 20 70 72 6f 76 69 64 65 20  it does provide 
5090: 73 6f 6d 65 20 6d 65 61 73 75 72 65 20 6f 66 20  some measure of 
50a0: 70 72 6f 74 65 63 74 69 6f 6e 20 61 67 61 69 6e  protection again
50b0: 73 74 0a 2a 2a 20 6d 69 73 75 73 65 20 6f 66 20  st.** misuse of 
50c0: 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 73 75  the interface su
50d0: 63 68 20 61 73 20 70 61 73 73 69 6e 67 20 69 6e  ch as passing in
50e0: 20 64 62 20 70 6f 69 6e 74 65 72 73 20 74 68 61   db pointers tha
50f0: 74 20 61 72 65 0a 2a 2a 20 4e 55 4c 4c 20 6f 72  t are.** NULL or
5100: 20 77 68 69 63 68 20 68 61 76 65 20 62 65 65 6e   which have been
5110: 20 70 72 65 76 69 6f 75 73 6c 79 20 63 6c 6f 73   previously clos
5120: 65 64 2e 20 20 49 66 20 74 68 69 73 20 72 6f 75  ed.  If this rou
5130: 74 69 6e 65 20 72 65 74 75 72 6e 73 0a 2a 2a 20  tine returns.** 
5140: 31 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20  1 it means that 
5150: 74 68 65 20 64 62 20 70 6f 69 6e 74 65 72 20 69  the db pointer i
5160: 73 20 76 61 6c 69 64 20 61 6e 64 20 30 20 69 66  s valid and 0 if
5170: 20 69 74 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62   it should not b
5180: 65 0a 2a 2a 20 64 65 72 65 66 65 72 65 6e 63 65  e.** dereference
5190: 64 20 66 6f 72 20 61 6e 79 20 72 65 61 73 6f 6e  d for any reason
51a0: 2e 20 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 66  .  The calling f
51b0: 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 69  unction should i
51c0: 6e 76 6f 6b 65 0a 2a 2a 20 53 51 4c 49 54 45 5f  nvoke.** SQLITE_
51d0: 4d 49 53 55 53 45 20 69 6d 6d 65 64 69 61 74 65  MISUSE immediate
51e0: 6c 79 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65  ly..**.** sqlite
51f0: 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 29  3SafetyCheckOk()
5200: 20 72 65 71 75 69 72 65 73 20 74 68 61 74 20 74   requires that t
5210: 68 65 20 64 62 20 70 6f 69 6e 74 65 72 20 62 65  he db pointer be
5220: 20 76 61 6c 69 64 20 66 6f 72 0a 2a 2a 20 75 73   valid for.** us
5230: 65 2e 20 20 73 71 6c 69 74 65 33 53 61 66 65 74  e.  sqlite3Safet
5240: 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 29  yCheckSickOrOk()
5250: 20 61 6c 6c 6f 77 73 20 61 20 64 62 20 70 6f 69   allows a db poi
5260: 6e 74 65 72 20 74 68 61 74 20 66 61 69 6c 65 64  nter that failed
5270: 20 74 6f 0a 2a 2a 20 6f 70 65 6e 20 70 72 6f 70   to.** open prop
5280: 65 72 6c 79 20 61 6e 64 20 69 73 20 6e 6f 74 20  erly and is not 
5290: 66 69 74 20 66 6f 72 20 67 65 6e 65 72 61 6c 20  fit for general 
52a0: 75 73 65 20 62 75 74 20 77 68 69 63 68 20 63 61  use but which ca
52b0: 6e 20 62 65 0a 2a 2a 20 75 73 65 64 20 61 73 20  n be.** used as 
52c0: 61 6e 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 73  an argument to s
52d0: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 29 20  qlite3_errmsg() 
52e0: 6f 72 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65  or sqlite3_close
52f0: 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ()..*/.int sqlit
5300: 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28  e3SafetyCheckOk(
5310: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20  sqlite3 *db){.  
5320: 69 6e 74 20 6d 61 67 69 63 3b 0a 20 20 69 66 28  int magic;.  if(
5330: 20 64 62 3d 3d 30 20 29 20 72 65 74 75 72 6e 20   db==0 ) return 
5340: 30 3b 0a 20 20 6d 61 67 69 63 20 3d 20 64 62 2d  0;.  magic = db-
5350: 3e 6d 61 67 69 63 3b 0a 20 20 69 66 28 20 6d 61  >magic;.  if( ma
5360: 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 47 49  gic!=SQLITE_MAGI
5370: 43 5f 4f 50 45 4e 20 26 26 0a 20 20 20 20 20 20  C_OPEN &&.      
5380: 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41  magic!=SQLITE_MA
5390: 47 49 43 5f 42 55 53 59 20 29 20 72 65 74 75 72  GIC_BUSY ) retur
53a0: 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b  n 0;.  return 1;
53b0: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 61  .}.int sqlite3Sa
53c0: 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f  fetyCheckSickOrO
53d0: 6b 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  k(sqlite3 *db){.
53e0: 20 20 69 6e 74 20 6d 61 67 69 63 3b 0a 20 20 69    int magic;.  i
53f0: 66 28 20 64 62 3d 3d 30 20 29 20 72 65 74 75 72  f( db==0 ) retur
5400: 6e 20 30 3b 0a 20 20 6d 61 67 69 63 20 3d 20 64  n 0;.  magic = d
5410: 62 2d 3e 6d 61 67 69 63 3b 0a 20 20 69 66 28 20  b->magic;.  if( 
5420: 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41  magic!=SQLITE_MA
5430: 47 49 43 5f 53 49 43 4b 20 26 26 0a 20 20 20 20  GIC_SICK &&.    
5440: 20 20 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f    magic!=SQLITE_
5450: 4d 41 47 49 43 5f 4f 50 45 4e 20 26 26 0a 20 20  MAGIC_OPEN &&.  
5460: 20 20 20 20 6d 61 67 69 63 21 3d 53 51 4c 49 54      magic!=SQLIT
5470: 45 5f 4d 41 47 49 43 5f 42 55 53 59 20 29 20 72  E_MAGIC_BUSY ) r
5480: 65 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 75 72  eturn 0;.  retur
5490: 6e 20 31 3b 0a 7d 0a                             n 1;.}.