/ Hex Artifact Content
Login

Artifact 772bb74807d3485ce90c9347f5dfddec4a76ed9edd4cf6c58d2d79b9ce9064d6:


0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4d 61 72 63 68  /*.** 2008 March
0010: 20 31 39 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75   19.**.** The au
0020: 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63  thor disclaims c
0030: 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 73  opyright to this
0040: 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49   source code.  I
0050: 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20  n place of.** a 
0060: 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65  legal notice, he
0070: 72 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67  re is a blessing
0080: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79  :.**.**    May y
0090: 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e  ou do good and n
00a0: 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d  ot evil..**    M
00b0: 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67  ay you find forg
00c0: 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72  iveness for your
00d0: 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65  self and forgive
00e0: 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d   others..**    M
00f0: 61 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 65  ay you share fre
0100: 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e  ely, never takin
0110: 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20  g more than you 
0120: 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a  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 0a 2a 2a 20 43 6f 64 65 20 66 6f 72 20 74  **.** Code for t
0180: 65 73 74 69 6e 67 20 61 6c 6c 20 73 6f 72 74 73  esting all sorts
0190: 20 6f 66 20 53 51 4c 69 74 65 20 69 6e 74 65 72   of SQLite inter
01a0: 66 61 63 65 73 2e 20 20 54 68 69 73 20 63 6f 64  faces.  This cod
01b0: 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 73 20  e.** implements 
01c0: 6e 65 77 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e  new SQL function
01d0: 73 20 75 73 65 64 20 62 79 20 74 68 65 20 74 65  s used by the te
01e0: 73 74 20 73 63 72 69 70 74 73 2e 0a 2a 2f 0a 23  st scripts..*/.#
01f0: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 33  include "sqlite3
0200: 2e 68 22 0a 23 69 66 20 64 65 66 69 6e 65 64 28  .h".#if defined(
0210: 49 4e 43 4c 55 44 45 5f 53 51 4c 49 54 45 5f 54  INCLUDE_SQLITE_T
0220: 43 4c 5f 48 29 0a 23 20 20 69 6e 63 6c 75 64 65  CL_H).#  include
0230: 20 22 73 71 6c 69 74 65 5f 74 63 6c 2e 68 22 0a   "sqlite_tcl.h".
0240: 23 65 6c 73 65 0a 23 20 20 69 6e 63 6c 75 64 65  #else.#  include
0250: 20 22 74 63 6c 2e 68 22 0a 23 65 6e 64 69 66 0a   "tcl.h".#endif.
0260: 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 6c 69 62  #include <stdlib
0270: 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74  .h>.#include <st
0280: 72 69 6e 67 2e 68 3e 0a 23 69 6e 63 6c 75 64 65  ring.h>.#include
0290: 20 3c 61 73 73 65 72 74 2e 68 3e 0a 0a 23 69 6e   <assert.h>..#in
02a0: 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74  clude "sqliteInt
02b0: 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 76 64  .h".#include "vd
02c0: 62 65 49 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20  beInt.h"../*.** 
02d0: 41 6c 6c 6f 63 61 74 65 20 6e 42 79 74 65 20 62  Allocate nByte b
02e0: 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 75 73  ytes of space us
02f0: 69 6e 67 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  ing sqlite3_mall
0300: 6f 63 28 29 2e 20 49 66 20 74 68 65 0a 2a 2a 20  oc(). If the.** 
0310: 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73  allocation fails
0320: 2c 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f 72  , call sqlite3_r
0330: 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65  esult_error_nome
0340: 6d 28 29 20 74 6f 20 6e 6f 74 69 66 79 0a 2a 2a  m() to notify.**
0350: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61   the database ha
0360: 6e 64 6c 65 20 74 68 61 74 20 6d 61 6c 6c 6f 63  ndle that malloc
0370: 28 29 20 68 61 73 20 66 61 69 6c 65 64 2e 0a 2a  () has failed..*
0380: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 2a 74  /.static void *t
0390: 65 73 74 43 6f 6e 74 65 78 74 4d 61 6c 6c 6f 63  estContextMalloc
03a0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
03b0: 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20 6e   *context, int n
03c0: 42 79 74 65 29 7b 0a 20 20 63 68 61 72 20 2a 7a  Byte){.  char *z
03d0: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f   = sqlite3_mallo
03e0: 63 28 6e 42 79 74 65 29 3b 0a 20 20 69 66 28 20  c(nByte);.  if( 
03f0: 21 7a 20 26 26 20 6e 42 79 74 65 3e 30 20 29 7b  !z && nByte>0 ){
0400: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73  .    sqlite3_res
0410: 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65 6d 28  ult_error_nomem(
0420: 63 6f 6e 74 65 78 74 29 3b 0a 20 20 7d 0a 20 20  context);.  }.  
0430: 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f 2a 0a  return z;.}../*.
0440: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
0450: 20 67 65 6e 65 72 61 74 65 73 20 61 20 73 74 72   generates a str
0460: 69 6e 67 20 6f 66 20 72 61 6e 64 6f 6d 20 63 68  ing of random ch
0470: 61 72 61 63 74 65 72 73 2e 20 20 55 73 65 64 20  aracters.  Used 
0480: 66 6f 72 0a 2a 2a 20 67 65 6e 65 72 61 74 69 6e  for.** generatin
0490: 67 20 74 65 73 74 20 64 61 74 61 2e 0a 2a 2f 0a  g test data..*/.
04a0: 73 74 61 74 69 63 20 76 6f 69 64 20 72 61 6e 64  static void rand
04b0: 53 74 72 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  Str(sqlite3_cont
04c0: 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e  ext *context, in
04d0: 74 20 61 72 67 63 2c 20 73 71 6c 69 74 65 33 5f  t argc, sqlite3_
04e0: 76 61 6c 75 65 20 2a 2a 61 72 67 76 29 7b 0a 20  value **argv){. 
04f0: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 6e   static const un
0500: 73 69 67 6e 65 64 20 63 68 61 72 20 7a 53 72 63  signed char zSrc
0510: 5b 5d 20 3d 20 0a 20 20 20 20 20 22 61 62 63 64  [] = .     "abcd
0520: 65 66 67 68 69 6a 6b 6c 6d 6e 6f 70 71 72 73 74  efghijklmnopqrst
0530: 75 76 77 78 79 7a 22 0a 20 20 20 20 20 22 41 42  uvwxyz".     "AB
0540: 43 44 45 46 47 48 49 4a 4b 4c 4d 4e 4f 50 51 52  CDEFGHIJKLMNOPQR
0550: 53 54 55 56 57 58 59 5a 22 0a 20 20 20 20 20 22  STUVWXYZ".     "
0560: 30 31 32 33 34 35 36 37 38 39 22 0a 20 20 20 20  0123456789".    
0570: 20 22 2e 2d 21 2c 3a 2a 5e 2b 3d 5f 7c 3f 2f 3c   ".-!,:*^+=_|?/<
0580: 3e 20 22 3b 0a 20 20 69 6e 74 20 69 4d 69 6e 2c  > ";.  int iMin,
0590: 20 69 4d 61 78 2c 20 6e 2c 20 72 2c 20 69 3b 0a   iMax, n, r, i;.
05a0: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20    unsigned char 
05b0: 7a 42 75 66 5b 31 30 30 30 5d 3b 0a 0a 20 20 2f  zBuf[1000];..  /
05c0: 2a 20 49 74 20 75 73 65 64 20 74 6f 20 62 65 20  * It used to be 
05d0: 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 61 6c 6c  possible to call
05e0: 20 72 61 6e 64 73 74 72 28 29 20 77 69 74 68 20   randstr() with 
05f0: 61 6e 79 20 6e 75 6d 62 65 72 20 6f 66 20 61 72  any number of ar
0600: 67 75 6d 65 6e 74 73 2c 0a 20 20 2a 2a 20 62 75  guments,.  ** bu
0610: 74 20 6e 6f 77 20 69 74 20 69 73 20 72 65 67 69  t now it is regi
0620: 73 74 65 72 65 64 20 77 69 74 68 20 53 51 4c 69  stered with SQLi
0630: 74 65 20 61 73 20 72 65 71 75 69 72 69 6e 67 20  te as requiring 
0640: 65 78 61 63 74 6c 79 20 32 2e 0a 20 20 2a 2f 0a  exactly 2..  */.
0650: 20 20 61 73 73 65 72 74 28 61 72 67 63 3d 3d 32    assert(argc==2
0660: 29 3b 0a 0a 20 20 69 4d 69 6e 20 3d 20 73 71 6c  );..  iMin = sql
0670: 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 61  ite3_value_int(a
0680: 72 67 76 5b 30 5d 29 3b 0a 20 20 69 66 28 20 69  rgv[0]);.  if( i
0690: 4d 69 6e 3c 30 20 29 20 69 4d 69 6e 20 3d 20 30  Min<0 ) iMin = 0
06a0: 3b 0a 20 20 69 66 28 20 69 4d 69 6e 3e 3d 73 69  ;.  if( iMin>=si
06b0: 7a 65 6f 66 28 7a 42 75 66 29 20 29 20 69 4d 69  zeof(zBuf) ) iMi
06c0: 6e 20 3d 20 73 69 7a 65 6f 66 28 7a 42 75 66 29  n = sizeof(zBuf)
06d0: 2d 31 3b 0a 20 20 69 4d 61 78 20 3d 20 73 71 6c  -1;.  iMax = sql
06e0: 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 61  ite3_value_int(a
06f0: 72 67 76 5b 31 5d 29 3b 0a 20 20 69 66 28 20 69  rgv[1]);.  if( i
0700: 4d 61 78 3c 69 4d 69 6e 20 29 20 69 4d 61 78 20  Max<iMin ) iMax 
0710: 3d 20 69 4d 69 6e 3b 0a 20 20 69 66 28 20 69 4d  = iMin;.  if( iM
0720: 61 78 3e 3d 73 69 7a 65 6f 66 28 7a 42 75 66 29  ax>=sizeof(zBuf)
0730: 20 29 20 69 4d 61 78 20 3d 20 73 69 7a 65 6f 66   ) iMax = sizeof
0740: 28 7a 42 75 66 29 2d 31 3b 0a 20 20 6e 20 3d 20  (zBuf)-1;.  n = 
0750: 69 4d 69 6e 3b 0a 20 20 69 66 28 20 69 4d 61 78  iMin;.  if( iMax
0760: 3e 69 4d 69 6e 20 29 7b 0a 20 20 20 20 73 71 6c  >iMin ){.    sql
0770: 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28  ite3_randomness(
0780: 73 69 7a 65 6f 66 28 72 29 2c 20 26 72 29 3b 0a  sizeof(r), &r);.
0790: 20 20 20 20 72 20 26 3d 20 30 78 37 66 66 66 66      r &= 0x7ffff
07a0: 66 66 66 3b 0a 20 20 20 20 6e 20 2b 3d 20 72 25  fff;.    n += r%
07b0: 28 69 4d 61 78 20 2b 20 31 20 2d 20 69 4d 69 6e  (iMax + 1 - iMin
07c0: 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28  );.  }.  assert(
07d0: 20 6e 3c 73 69 7a 65 6f 66 28 7a 42 75 66 29 20   n<sizeof(zBuf) 
07e0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 72 61 6e  );.  sqlite3_ran
07f0: 64 6f 6d 6e 65 73 73 28 6e 2c 20 7a 42 75 66 29  domness(n, zBuf)
0800: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e  ;.  for(i=0; i<n
0810: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 7a 42 75 66  ; i++){.    zBuf
0820: 5b 69 5d 20 3d 20 7a 53 72 63 5b 7a 42 75 66 5b  [i] = zSrc[zBuf[
0830: 69 5d 25 28 73 69 7a 65 6f 66 28 7a 53 72 63 29  i]%(sizeof(zSrc)
0840: 2d 31 29 5d 3b 0a 20 20 7d 0a 20 20 7a 42 75 66  -1)];.  }.  zBuf
0850: 5b 6e 5d 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74  [n] = 0;.  sqlit
0860: 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63  e3_result_text(c
0870: 6f 6e 74 65 78 74 2c 20 28 63 68 61 72 2a 29 7a  ontext, (char*)z
0880: 42 75 66 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 54  Buf, n, SQLITE_T
0890: 52 41 4e 53 49 45 4e 54 29 3b 0a 7d 0a 0a 2f 2a  RANSIENT);.}../*
08a0: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
08b0: 67 20 74 77 6f 20 53 51 4c 20 66 75 6e 63 74 69  g two SQL functi
08c0: 6f 6e 73 20 61 72 65 20 75 73 65 64 20 74 6f 20  ons are used to 
08d0: 74 65 73 74 20 72 65 74 75 72 6e 69 6e 67 20 61  test returning a
08e0: 20 74 65 78 74 0a 2a 2a 20 72 65 73 75 6c 74 20   text.** result 
08f0: 77 69 74 68 20 61 20 64 65 73 74 72 75 63 74 6f  with a destructo
0900: 72 2e 20 46 75 6e 63 74 69 6f 6e 20 27 74 65 73  r. Function 'tes
0910: 74 5f 64 65 73 74 72 75 63 74 6f 72 27 20 74 61  t_destructor' ta
0920: 6b 65 73 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74  kes one argument
0930: 0a 2a 2a 20 61 6e 64 20 72 65 74 75 72 6e 73 20  .** and returns 
0940: 74 68 65 20 73 61 6d 65 20 61 72 67 75 6d 65 6e  the same argumen
0950: 74 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73  t interpreted as
0960: 20 54 45 58 54 2e 20 41 20 64 65 73 74 72 75 63   TEXT. A destruc
0970: 74 6f 72 20 69 73 0a 2a 2a 20 70 61 73 73 65 64  tor is.** passed
0980: 20 77 69 74 68 20 74 68 65 20 73 71 6c 69 74 65   with the sqlite
0990: 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 29 20  3_result_text() 
09a0: 63 61 6c 6c 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 20  call..**.** SQL 
09b0: 66 75 6e 63 74 69 6f 6e 20 27 74 65 73 74 5f 64  function 'test_d
09c0: 65 73 74 72 75 63 74 6f 72 5f 63 6f 75 6e 74 27  estructor_count'
09d0: 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d   returns the num
09e0: 62 65 72 20 6f 66 20 6f 75 74 73 74 61 6e 64 69  ber of outstandi
09f0: 6e 67 20 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f  ng .** allocatio
0a00: 6e 73 20 6d 61 64 65 20 62 79 20 27 74 65 73 74  ns made by 'test
0a10: 5f 64 65 73 74 72 75 63 74 6f 72 27 3b 0a 2a 2a  _destructor';.**
0a20: 0a 2a 2a 20 57 41 52 4e 49 4e 47 3a 20 4e 6f 74  .** WARNING: Not
0a30: 20 74 68 72 65 61 64 73 61 66 65 2e 0a 2a 2f 0a   threadsafe..*/.
0a40: 73 74 61 74 69 63 20 69 6e 74 20 74 65 73 74 5f  static int test_
0a50: 64 65 73 74 72 75 63 74 6f 72 5f 63 6f 75 6e 74  destructor_count
0a60: 5f 76 61 72 20 3d 20 30 3b 0a 73 74 61 74 69 63  _var = 0;.static
0a70: 20 76 6f 69 64 20 64 65 73 74 72 75 63 74 6f 72   void destructor
0a80: 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 63 68 61  (void *p){.  cha
0a90: 72 20 2a 7a 56 61 6c 20 3d 20 28 63 68 61 72 20  r *zVal = (char 
0aa0: 2a 29 70 3b 0a 20 20 61 73 73 65 72 74 28 7a 56  *)p;.  assert(zV
0ab0: 61 6c 29 3b 0a 20 20 7a 56 61 6c 2d 2d 3b 0a 20  al);.  zVal--;. 
0ac0: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 56   sqlite3_free(zV
0ad0: 61 6c 29 3b 0a 20 20 74 65 73 74 5f 64 65 73 74  al);.  test_dest
0ae0: 72 75 63 74 6f 72 5f 63 6f 75 6e 74 5f 76 61 72  ructor_count_var
0af0: 2d 2d 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69  --;.}.static voi
0b00: 64 20 74 65 73 74 5f 64 65 73 74 72 75 63 74 6f  d test_destructo
0b10: 72 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  r(.  sqlite3_con
0b20: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 69  text *pCtx, .  i
0b30: 6e 74 20 6e 41 72 67 2c 0a 20 20 73 71 6c 69 74  nt nArg,.  sqlit
0b40: 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a  e3_value **argv.
0b50: 29 7b 0a 20 20 63 68 61 72 20 2a 7a 56 61 6c 3b  ){.  char *zVal;
0b60: 0a 20 20 69 6e 74 20 6c 65 6e 3b 0a 20 20 0a 20  .  int len;.  . 
0b70: 20 74 65 73 74 5f 64 65 73 74 72 75 63 74 6f 72   test_destructor
0b80: 5f 63 6f 75 6e 74 5f 76 61 72 2b 2b 3b 0a 20 20  _count_var++;.  
0b90: 61 73 73 65 72 74 28 20 6e 41 72 67 3d 3d 31 20  assert( nArg==1 
0ba0: 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  );.  if( sqlite3
0bb0: 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67 76  _value_type(argv
0bc0: 5b 30 5d 29 3d 3d 53 51 4c 49 54 45 5f 4e 55 4c  [0])==SQLITE_NUL
0bd0: 4c 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 6c 65  L ) return;.  le
0be0: 6e 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  n = sqlite3_valu
0bf0: 65 5f 62 79 74 65 73 28 61 72 67 76 5b 30 5d 29  e_bytes(argv[0])
0c00: 3b 20 0a 20 20 7a 56 61 6c 20 3d 20 74 65 73 74  ; .  zVal = test
0c10: 43 6f 6e 74 65 78 74 4d 61 6c 6c 6f 63 28 70 43  ContextMalloc(pC
0c20: 74 78 2c 20 6c 65 6e 2b 33 29 3b 0a 20 20 69 66  tx, len+3);.  if
0c30: 28 20 21 7a 56 61 6c 20 29 7b 0a 20 20 20 20 72  ( !zVal ){.    r
0c40: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 7a 56 61  eturn;.  }.  zVa
0c50: 6c 5b 6c 65 6e 2b 31 5d 20 3d 20 30 3b 0a 20 20  l[len+1] = 0;.  
0c60: 7a 56 61 6c 5b 6c 65 6e 2b 32 5d 20 3d 20 30 3b  zVal[len+2] = 0;
0c70: 0a 20 20 7a 56 61 6c 2b 2b 3b 0a 20 20 6d 65 6d  .  zVal++;.  mem
0c80: 63 70 79 28 7a 56 61 6c 2c 20 73 71 6c 69 74 65  cpy(zVal, sqlite
0c90: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67  3_value_text(arg
0ca0: 76 5b 30 5d 29 2c 20 6c 65 6e 29 3b 0a 20 20 73  v[0]), len);.  s
0cb0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
0cc0: 78 74 28 70 43 74 78 2c 20 7a 56 61 6c 2c 20 2d  xt(pCtx, zVal, -
0cd0: 31 2c 20 64 65 73 74 72 75 63 74 6f 72 29 3b 0a  1, destructor);.
0ce0: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
0cf0: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 73 74 61 74  _OMIT_UTF16.stat
0d00: 69 63 20 76 6f 69 64 20 74 65 73 74 5f 64 65 73  ic void test_des
0d10: 74 72 75 63 74 6f 72 31 36 28 0a 20 20 73 71 6c  tructor16(.  sql
0d20: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
0d30: 74 78 2c 20 0a 20 20 69 6e 74 20 6e 41 72 67 2c  tx, .  int nArg,
0d40: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  .  sqlite3_value
0d50: 20 2a 2a 61 72 67 76 0a 29 7b 0a 20 20 63 68 61   **argv.){.  cha
0d60: 72 20 2a 7a 56 61 6c 3b 0a 20 20 69 6e 74 20 6c  r *zVal;.  int l
0d70: 65 6e 3b 0a 20 20 0a 20 20 74 65 73 74 5f 64 65  en;.  .  test_de
0d80: 73 74 72 75 63 74 6f 72 5f 63 6f 75 6e 74 5f 76  structor_count_v
0d90: 61 72 2b 2b 3b 0a 20 20 61 73 73 65 72 74 28 20  ar++;.  assert( 
0da0: 6e 41 72 67 3d 3d 31 20 29 3b 0a 20 20 69 66 28  nArg==1 );.  if(
0db0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
0dc0: 79 70 65 28 61 72 67 76 5b 30 5d 29 3d 3d 53 51  ype(argv[0])==SQ
0dd0: 4c 49 54 45 5f 4e 55 4c 4c 20 29 20 72 65 74 75  LITE_NULL ) retu
0de0: 72 6e 3b 0a 20 20 6c 65 6e 20 3d 20 73 71 6c 69  rn;.  len = sqli
0df0: 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31  te3_value_bytes1
0e00: 36 28 61 72 67 76 5b 30 5d 29 3b 20 0a 20 20 7a  6(argv[0]); .  z
0e10: 56 61 6c 20 3d 20 74 65 73 74 43 6f 6e 74 65 78  Val = testContex
0e20: 74 4d 61 6c 6c 6f 63 28 70 43 74 78 2c 20 6c 65  tMalloc(pCtx, le
0e30: 6e 2b 33 29 3b 0a 20 20 69 66 28 20 21 7a 56 61  n+3);.  if( !zVa
0e40: 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 3b  l ){.    return;
0e50: 0a 20 20 7d 0a 20 20 7a 56 61 6c 5b 6c 65 6e 2b  .  }.  zVal[len+
0e60: 31 5d 20 3d 20 30 3b 0a 20 20 7a 56 61 6c 5b 6c  1] = 0;.  zVal[l
0e70: 65 6e 2b 32 5d 20 3d 20 30 3b 0a 20 20 7a 56 61  en+2] = 0;.  zVa
0e80: 6c 2b 2b 3b 0a 20 20 6d 65 6d 63 70 79 28 7a 56  l++;.  memcpy(zV
0e90: 61 6c 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  al, sqlite3_valu
0ea0: 65 5f 74 65 78 74 31 36 28 61 72 67 76 5b 30 5d  e_text16(argv[0]
0eb0: 29 2c 20 6c 65 6e 29 3b 0a 20 20 73 71 6c 69 74  ), len);.  sqlit
0ec0: 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36  e3_result_text16
0ed0: 28 70 43 74 78 2c 20 7a 56 61 6c 2c 20 2d 31 2c  (pCtx, zVal, -1,
0ee0: 20 64 65 73 74 72 75 63 74 6f 72 29 3b 0a 7d 0a   destructor);.}.
0ef0: 23 65 6e 64 69 66 0a 73 74 61 74 69 63 20 76 6f  #endif.static vo
0f00: 69 64 20 74 65 73 74 5f 64 65 73 74 72 75 63 74  id test_destruct
0f10: 6f 72 5f 63 6f 75 6e 74 28 0a 20 20 73 71 6c 69  or_count(.  sqli
0f20: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
0f30: 78 2c 20 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a  x, .  int nArg,.
0f40: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20    sqlite3_value 
0f50: 2a 2a 61 72 67 76 0a 29 7b 0a 20 20 73 71 6c 69  **argv.){.  sqli
0f60: 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 28 70  te3_result_int(p
0f70: 43 74 78 2c 20 74 65 73 74 5f 64 65 73 74 72 75  Ctx, test_destru
0f80: 63 74 6f 72 5f 63 6f 75 6e 74 5f 76 61 72 29 3b  ctor_count_var);
0f90: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  .}../*.** The fo
0fa0: 6c 6c 6f 77 69 6e 67 20 61 67 67 72 65 67 61 74  llowing aggregat
0fb0: 65 20 66 75 6e 63 74 69 6f 6e 2c 20 74 65 73 74  e function, test
0fc0: 5f 61 67 67 5f 65 72 72 6d 73 67 31 36 28 29 2c  _agg_errmsg16(),
0fd0: 20 74 61 6b 65 73 20 7a 65 72 6f 20 0a 2a 2a 20   takes zero .** 
0fe0: 61 72 67 75 6d 65 6e 74 73 2e 20 49 74 20 72 65  arguments. It re
0ff0: 74 75 72 6e 73 20 74 68 65 20 74 65 78 74 20 76  turns the text v
1000: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79  alue returned by
1010: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 65 72 72   the sqlite3_err
1020: 6d 73 67 31 36 28 29 0a 2a 2a 20 41 50 49 20 66  msg16().** API f
1030: 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e  unction..*/.#ifn
1040: 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 54 45 53  def SQLITE_UNTES
1050: 54 41 42 4c 45 0a 76 6f 69 64 20 73 71 6c 69 74  TABLE.void sqlit
1060: 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c  e3BeginBenignMal
1070: 6c 6f 63 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20  loc(void);.void 
1080: 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e  sqlite3EndBenign
1090: 4d 61 6c 6c 6f 63 28 76 6f 69 64 29 3b 0a 23 65  Malloc(void);.#e
10a0: 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71  lse.  #define sq
10b0: 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e  lite3BeginBenign
10c0: 4d 61 6c 6c 6f 63 28 29 0a 20 20 23 64 65 66 69  Malloc().  #defi
10d0: 6e 65 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e  ne sqlite3EndBen
10e0: 69 67 6e 4d 61 6c 6c 6f 63 28 29 0a 23 65 6e 64  ignMalloc().#end
10f0: 69 66 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74  if.static void t
1100: 65 73 74 5f 61 67 67 5f 65 72 72 6d 73 67 31 36  est_agg_errmsg16
1110: 5f 73 74 65 70 28 73 71 6c 69 74 65 33 5f 63 6f  _step(sqlite3_co
1120: 6e 74 65 78 74 20 2a 61 2c 20 69 6e 74 20 62 2c  ntext *a, int b,
1130: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
1140: 63 29 7b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69  c){.}.static voi
1150: 64 20 74 65 73 74 5f 61 67 67 5f 65 72 72 6d 73  d test_agg_errms
1160: 67 31 36 5f 66 69 6e 61 6c 28 73 71 6c 69 74 65  g16_final(sqlite
1170: 33 5f 63 6f 6e 74 65 78 74 20 2a 63 74 78 29 7b  3_context *ctx){
1180: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
1190: 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 63 6f 6e  OMIT_UTF16.  con
11a0: 73 74 20 76 6f 69 64 20 2a 7a 3b 0a 20 20 73 71  st void *z;.  sq
11b0: 6c 69 74 65 33 20 2a 20 64 62 20 3d 20 73 71 6c  lite3 * db = sql
11c0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 5f 64 62 5f  ite3_context_db_
11d0: 68 61 6e 64 6c 65 28 63 74 78 29 3b 0a 20 20 73  handle(ctx);.  s
11e0: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65  qlite3_aggregate
11f0: 5f 63 6f 6e 74 65 78 74 28 63 74 78 2c 20 32 30  _context(ctx, 20
1200: 34 38 29 3b 0a 20 20 7a 20 3d 20 73 71 6c 69 74  48);.  z = sqlit
1210: 65 33 5f 65 72 72 6d 73 67 31 36 28 64 62 29 3b  e3_errmsg16(db);
1220: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
1230: 74 5f 74 65 78 74 31 36 28 63 74 78 2c 20 7a 2c  t_text16(ctx, z,
1240: 20 2d 31 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e   -1, SQLITE_TRAN
1250: 53 49 45 4e 54 29 3b 0a 23 65 6e 64 69 66 0a 7d  SIENT);.#endif.}
1260: 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 69 6e 65 73  ../*.** Routines
1270: 20 66 6f 72 20 74 65 73 74 69 6e 67 20 74 68 65   for testing the
1280: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 78   sqlite3_get_aux
1290: 64 61 74 61 28 29 20 61 6e 64 20 73 71 6c 69 74  data() and sqlit
12a0: 65 33 5f 73 65 74 5f 61 75 78 64 61 74 61 28 29  e3_set_auxdata()
12b0: 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2e 0a 2a  .** interface..*
12c0: 2a 0a 2a 2a 20 54 68 65 20 74 65 73 74 5f 61 75  *.** The test_au
12d0: 78 64 61 74 61 28 29 20 53 51 4c 20 66 75 6e 63  xdata() SQL func
12e0: 74 69 6f 6e 20 61 74 74 65 6d 70 74 73 20 74 6f  tion attempts to
12f0: 20 72 65 67 69 73 74 65 72 20 65 61 63 68 20 6f   register each o
1300: 66 20 69 74 73 20 61 72 67 75 6d 65 6e 74 73 0a  f its arguments.
1310: 2a 2a 20 61 73 20 61 75 78 69 6c 69 61 72 79 20  ** as auxiliary 
1320: 64 61 74 61 2e 20 20 49 66 20 74 68 65 72 65 20  data.  If there 
1330: 61 72 65 20 6e 6f 20 70 72 69 6f 72 20 72 65 67  are no prior reg
1340: 69 73 74 72 61 74 69 6f 6e 73 20 6f 66 20 61 75  istrations of au
1350: 78 20 64 61 74 61 20 66 6f 72 0a 2a 2a 20 74 68  x data for.** th
1360: 61 74 20 61 72 67 75 6d 65 6e 74 20 28 6d 65 61  at argument (mea
1370: 6e 69 6e 67 20 74 68 65 20 61 72 67 75 6d 65 6e  ning the argumen
1380: 74 20 69 73 20 6e 6f 74 20 61 20 63 6f 6e 73 74  t is not a const
1390: 61 6e 74 20 6f 72 20 74 68 69 73 20 69 73 20 69  ant or this is i
13a0: 74 73 20 66 69 72 73 74 0a 2a 2a 20 63 61 6c 6c  ts first.** call
13b0: 29 20 74 68 65 6e 20 74 68 65 20 72 65 73 75 6c  ) then the resul
13c0: 74 20 66 6f 72 20 74 68 61 74 20 61 72 67 75 6d  t for that argum
13d0: 65 6e 74 20 69 73 20 30 2e 20 20 49 66 20 74 68  ent is 0.  If th
13e0: 65 72 65 20 69 73 20 61 20 70 72 69 6f 72 0a 2a  ere is a prior.*
13f0: 2a 20 72 65 67 69 73 74 72 61 74 69 6f 6e 2c 20  * registration, 
1400: 74 68 65 20 72 65 73 75 6c 74 20 66 6f 72 20 74  the result for t
1410: 68 61 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20  hat argument is 
1420: 31 2e 20 20 54 68 65 20 6f 76 65 72 61 6c 6c 20  1.  The overall 
1430: 72 65 73 75 6c 74 0a 2a 2a 20 69 73 20 74 68 65  result.** is the
1440: 20 69 6e 64 69 76 69 64 75 61 6c 20 61 72 67 75   individual argu
1450: 6d 65 6e 74 20 72 65 73 75 6c 74 73 20 73 65 70  ment results sep
1460: 61 72 61 74 65 64 20 62 79 20 73 70 61 63 65 73  arated by spaces
1470: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
1480: 20 66 72 65 65 5f 74 65 73 74 5f 61 75 78 64 61   free_test_auxda
1490: 74 61 28 76 6f 69 64 20 2a 70 29 20 7b 73 71 6c  ta(void *p) {sql
14a0: 69 74 65 33 5f 66 72 65 65 28 70 29 3b 7d 0a 73  ite3_free(p);}.s
14b0: 74 61 74 69 63 20 76 6f 69 64 20 74 65 73 74 5f  tatic void test_
14c0: 61 75 78 64 61 74 61 28 0a 20 20 73 71 6c 69 74  auxdata(.  sqlit
14d0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
14e0: 2c 20 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20  , .  int nArg,. 
14f0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
1500: 2a 61 72 67 76 0a 29 7b 0a 20 20 69 6e 74 20 69  *argv.){.  int i
1510: 3b 0a 20 20 63 68 61 72 20 2a 7a 52 65 74 20 3d  ;.  char *zRet =
1520: 20 74 65 73 74 43 6f 6e 74 65 78 74 4d 61 6c 6c   testContextMall
1530: 6f 63 28 70 43 74 78 2c 20 6e 41 72 67 2a 32 29  oc(pCtx, nArg*2)
1540: 3b 0a 20 20 69 66 28 20 21 7a 52 65 74 20 29 20  ;.  if( !zRet ) 
1550: 72 65 74 75 72 6e 3b 0a 20 20 6d 65 6d 73 65 74  return;.  memset
1560: 28 7a 52 65 74 2c 20 30 2c 20 6e 41 72 67 2a 32  (zRet, 0, nArg*2
1570: 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  );.  for(i=0; i<
1580: 6e 41 72 67 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nArg; i++){.    
1590: 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 20 3d 20  char const *z = 
15a0: 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76  (char*)sqlite3_v
15b0: 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b 69  alue_text(argv[i
15c0: 5d 29 3b 0a 20 20 20 20 69 66 28 20 7a 20 29 7b  ]);.    if( z ){
15d0: 0a 20 20 20 20 20 20 69 6e 74 20 6e 3b 0a 20 20  .      int n;.  
15e0: 20 20 20 20 63 68 61 72 20 2a 7a 41 75 78 20 3d      char *zAux =
15f0: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 78   sqlite3_get_aux
1600: 64 61 74 61 28 70 43 74 78 2c 20 69 29 3b 0a 20  data(pCtx, i);. 
1610: 20 20 20 20 20 69 66 28 20 7a 41 75 78 20 29 7b       if( zAux ){
1620: 0a 20 20 20 20 20 20 20 20 7a 52 65 74 5b 69 2a  .        zRet[i*
1630: 32 5d 20 3d 20 27 31 27 3b 0a 20 20 20 20 20 20  2] = '1';.      
1640: 20 20 61 73 73 65 72 74 28 20 73 74 72 63 6d 70    assert( strcmp
1650: 28 7a 41 75 78 2c 7a 29 3d 3d 30 20 29 3b 0a 20  (zAux,z)==0 );. 
1660: 20 20 20 20 20 7d 65 6c 73 65 20 7b 0a 20 20 20       }else {.   
1670: 20 20 20 20 20 7a 52 65 74 5b 69 2a 32 5d 20 3d       zRet[i*2] =
1680: 20 27 30 27 3b 0a 20 20 20 20 20 20 7d 0a 20 20   '0';.      }.  
1690: 20 20 20 20 6e 20 3d 20 28 69 6e 74 29 73 74 72      n = (int)str
16a0: 6c 65 6e 28 7a 29 20 2b 20 31 3b 0a 20 20 20 20  len(z) + 1;.    
16b0: 20 20 7a 41 75 78 20 3d 20 74 65 73 74 43 6f 6e    zAux = testCon
16c0: 74 65 78 74 4d 61 6c 6c 6f 63 28 70 43 74 78 2c  textMalloc(pCtx,
16d0: 20 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20 7a   n);.      if( z
16e0: 41 75 78 20 29 7b 0a 20 20 20 20 20 20 20 20 6d  Aux ){.        m
16f0: 65 6d 63 70 79 28 7a 41 75 78 2c 20 7a 2c 20 6e  emcpy(zAux, z, n
1700: 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  );.        sqlit
1710: 65 33 5f 73 65 74 5f 61 75 78 64 61 74 61 28 70  e3_set_auxdata(p
1720: 43 74 78 2c 20 69 2c 20 7a 41 75 78 2c 20 66 72  Ctx, i, zAux, fr
1730: 65 65 5f 74 65 73 74 5f 61 75 78 64 61 74 61 29  ee_test_auxdata)
1740: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
1750: 7a 52 65 74 5b 69 2a 32 2b 31 5d 20 3d 20 27 20  zRet[i*2+1] = ' 
1760: 27 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73  ';.    }.  }.  s
1770: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
1780: 78 74 28 70 43 74 78 2c 20 7a 52 65 74 2c 20 32  xt(pCtx, zRet, 2
1790: 2a 6e 41 72 67 2d 31 2c 20 66 72 65 65 5f 74 65  *nArg-1, free_te
17a0: 73 74 5f 61 75 78 64 61 74 61 29 3b 0a 7d 0a 0a  st_auxdata);.}..
17b0: 2f 2a 0a 2a 2a 20 41 20 66 75 6e 63 74 69 6f 6e  /*.** A function
17c0: 20 74 6f 20 74 65 73 74 20 65 72 72 6f 72 20 72   to test error r
17d0: 65 70 6f 72 74 69 6e 67 20 66 72 6f 6d 20 75 73  eporting from us
17e0: 65 72 20 66 75 6e 63 74 69 6f 6e 73 2e 20 54 68  er functions. Th
17f0: 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 72  is function.** r
1800: 65 74 75 72 6e 73 20 61 20 63 6f 70 79 20 6f 66  eturns a copy of
1810: 20 69 74 73 20 66 69 72 73 74 20 61 72 67 75 6d   its first argum
1820: 65 6e 74 20 61 73 20 74 68 65 20 65 72 72 6f 72  ent as the error
1830: 20 6d 65 73 73 61 67 65 2e 20 20 49 66 20 74 68   message.  If th
1840: 65 0a 2a 2a 20 73 65 63 6f 6e 64 20 61 72 67 75  e.** second argu
1850: 6d 65 6e 74 20 65 78 69 73 74 73 2c 20 69 74 20  ment exists, it 
1860: 62 65 63 6f 6d 65 73 20 74 68 65 20 65 72 72 6f  becomes the erro
1870: 72 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69  r code..*/.stati
1880: 63 20 76 6f 69 64 20 74 65 73 74 5f 65 72 72 6f  c void test_erro
1890: 72 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  r(.  sqlite3_con
18a0: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 69  text *pCtx, .  i
18b0: 6e 74 20 6e 41 72 67 2c 0a 20 20 73 71 6c 69 74  nt nArg,.  sqlit
18c0: 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a  e3_value **argv.
18d0: 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73  ){.  sqlite3_res
18e0: 75 6c 74 5f 65 72 72 6f 72 28 70 43 74 78 2c 20  ult_error(pCtx, 
18f0: 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76  (char*)sqlite3_v
1900: 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b 30  alue_text(argv[0
1910: 5d 29 2c 20 2d 31 29 3b 0a 20 20 69 66 28 20 6e  ]), -1);.  if( n
1920: 41 72 67 3d 3d 32 20 29 7b 0a 20 20 20 20 73 71  Arg==2 ){.    sq
1930: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
1940: 6f 72 5f 63 6f 64 65 28 70 43 74 78 2c 20 73 71  or_code(pCtx, sq
1950: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28  lite3_value_int(
1960: 61 72 67 76 5b 31 5d 29 29 3b 0a 20 20 7d 0a 7d  argv[1]));.  }.}
1970: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
1980: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 63 6f  tation of the co
1990: 75 6e 74 65 72 28 58 29 20 66 75 6e 63 74 69 6f  unter(X) functio
19a0: 6e 2e 20 20 49 66 20 58 20 69 73 20 61 6e 20 69  n.  If X is an i
19b0: 6e 74 65 67 65 72 0a 2a 2a 20 63 6f 6e 73 74 61  nteger.** consta
19c0: 6e 74 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72  nt, then the fir
19d0: 73 74 20 69 6e 76 6f 63 61 74 69 6f 6e 20 77 69  st invocation wi
19e0: 6c 6c 20 72 65 74 75 72 6e 20 58 2e 20 20 54 68  ll return X.  Th
19f0: 65 20 73 65 63 6f 6e 64 20 58 2b 31 2e 0a 2a 2a  e second X+1..**
1a00: 20 61 6e 64 20 73 6f 20 66 6f 72 74 68 2e 20 20   and so forth.  
1a10: 43 61 6e 20 62 65 20 75 73 65 64 20 28 66 6f 72  Can be used (for
1a20: 20 65 78 61 6d 70 6c 65 29 20 74 6f 20 70 72 6f   example) to pro
1a30: 76 69 64 65 20 61 20 73 65 71 75 65 6e 63 65 20  vide a sequence 
1a40: 6e 75 6d 62 65 72 0a 2a 2a 20 69 6e 20 61 20 72  number.** in a r
1a50: 65 73 75 6c 74 20 73 65 74 2e 0a 2a 2f 0a 73 74  esult set..*/.st
1a60: 61 74 69 63 20 76 6f 69 64 20 63 6f 75 6e 74 65  atic void counte
1a70: 72 46 75 6e 63 28 0a 20 20 73 71 6c 69 74 65 33  rFunc(.  sqlite3
1a80: 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20  _context *pCtx, 
1a90: 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 63 6f    /* Function co
1aa0: 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 6e  ntext */.  int n
1ab0: 41 72 67 2c 20 20 20 20 20 20 20 20 20 20 20 20  Arg,            
1ac0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
1ad0: 20 66 75 6e 63 74 69 6f 6e 20 61 72 67 75 6d 65   function argume
1ae0: 6e 74 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  nts */.  sqlite3
1af0: 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 20 20 20  _value **argv   
1b00: 20 20 2f 2a 20 56 61 6c 75 65 73 20 66 6f 72 20    /* Values for 
1b10: 61 6c 6c 20 66 75 6e 63 74 69 6f 6e 20 61 72 67  all function arg
1b20: 75 6d 65 6e 74 73 20 2a 2f 0a 29 7b 0a 20 20 69  uments */.){.  i
1b30: 6e 74 20 2a 70 43 6f 75 6e 74 65 72 20 3d 20 28  nt *pCounter = (
1b40: 69 6e 74 2a 29 73 71 6c 69 74 65 33 5f 67 65 74  int*)sqlite3_get
1b50: 5f 61 75 78 64 61 74 61 28 70 43 74 78 2c 20 30  _auxdata(pCtx, 0
1b60: 29 3b 0a 20 20 69 66 28 20 70 43 6f 75 6e 74 65  );.  if( pCounte
1b70: 72 3d 3d 30 20 29 7b 0a 20 20 20 20 70 43 6f 75  r==0 ){.    pCou
1b80: 6e 74 65 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d  nter = sqlite3_m
1b90: 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 2a 70  alloc( sizeof(*p
1ba0: 43 6f 75 6e 74 65 72 29 20 29 3b 0a 20 20 20 20  Counter) );.    
1bb0: 69 66 28 20 70 43 6f 75 6e 74 65 72 3d 3d 30 20  if( pCounter==0 
1bc0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
1bd0: 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f  _result_error_no
1be0: 6d 65 6d 28 70 43 74 78 29 3b 0a 20 20 20 20 20  mem(pCtx);.     
1bf0: 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a 20   return;.    }. 
1c00: 20 20 20 2a 70 43 6f 75 6e 74 65 72 20 3d 20 73     *pCounter = s
1c10: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74  qlite3_value_int
1c20: 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20 73  (argv[0]);.    s
1c30: 71 6c 69 74 65 33 5f 73 65 74 5f 61 75 78 64 61  qlite3_set_auxda
1c40: 74 61 28 70 43 74 78 2c 20 30 2c 20 70 43 6f 75  ta(pCtx, 0, pCou
1c50: 6e 74 65 72 2c 20 73 71 6c 69 74 65 33 5f 66 72  nter, sqlite3_fr
1c60: 65 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  ee);.  }else{.  
1c70: 20 20 2b 2b 2a 70 43 6f 75 6e 74 65 72 3b 0a 20    ++*pCounter;. 
1c80: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73   }.  sqlite3_res
1c90: 75 6c 74 5f 69 6e 74 28 70 43 74 78 2c 20 2a 70  ult_int(pCtx, *p
1ca0: 43 6f 75 6e 74 65 72 29 3b 0a 7d 0a 0a 0a 2f 2a  Counter);.}.../*
1cb0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
1cc0: 6e 20 74 61 6b 65 73 20 74 77 6f 20 61 72 67 75  n takes two argu
1cd0: 6d 65 6e 74 73 2e 20 20 49 74 20 70 65 72 66 6f  ments.  It perfo
1ce0: 72 6d 61 6e 63 65 20 55 54 46 2d 38 2f 31 36 20  rmance UTF-8/16 
1cf0: 74 79 70 65 0a 2a 2a 20 63 6f 6e 76 65 72 73 69  type.** conversi
1d00: 6f 6e 73 20 6f 6e 20 74 68 65 20 66 69 72 73 74  ons on the first
1d10: 20 61 72 67 75 6d 65 6e 74 20 74 68 65 6e 20 72   argument then r
1d20: 65 74 75 72 6e 73 20 61 20 63 6f 70 79 20 6f 66  eturns a copy of
1d30: 20 74 68 65 20 73 65 63 6f 6e 64 0a 2a 2a 20 61   the second.** a
1d40: 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54  rgument..**.** T
1d50: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
1d60: 75 73 65 64 20 69 6e 20 63 61 73 65 73 20 73 75  used in cases su
1d70: 63 68 20 61 73 20 74 68 65 20 66 6f 6c 6c 6f 77  ch as the follow
1d80: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  ing:.**.**      
1d90: 53 45 4c 45 43 54 20 74 65 73 74 5f 69 73 6f 6c  SELECT test_isol
1da0: 61 74 69 6f 6e 28 78 2c 78 29 20 46 52 4f 4d 20  ation(x,x) FROM 
1db0: 74 31 3b 0a 2a 2a 0a 2a 2a 20 57 65 20 77 61 6e  t1;.**.** We wan
1dc0: 74 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74  t to verify that
1dd0: 20 74 68 65 20 74 79 70 65 20 63 6f 6e 76 65 72   the type conver
1de0: 73 69 6f 6e 73 20 74 68 61 74 20 6f 63 63 75 72  sions that occur
1df0: 20 6f 6e 20 74 68 65 0a 2a 2a 20 66 69 72 73 74   on the.** first
1e00: 20 61 72 67 75 6d 65 6e 74 20 64 6f 20 6e 6f 74   argument do not
1e10: 20 69 6e 76 61 6c 69 64 61 74 65 20 74 68 65 20   invalidate the 
1e20: 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2e  second argument.
1e30: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
1e40: 74 65 73 74 5f 69 73 6f 6c 61 74 69 6f 6e 28 0a  test_isolation(.
1e50: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
1e60: 74 20 2a 70 43 74 78 2c 20 0a 20 20 69 6e 74 20  t *pCtx, .  int 
1e70: 6e 41 72 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f  nArg,.  sqlite3_
1e80: 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a  value **argv.){.
1e90: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
1ea0: 4d 49 54 5f 55 54 46 31 36 0a 20 20 73 71 6c 69  MIT_UTF16.  sqli
1eb0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36  te3_value_text16
1ec0: 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 73 71 6c  (argv[0]);.  sql
1ed0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28  ite3_value_text(
1ee0: 61 72 67 76 5b 30 5d 29 3b 0a 20 20 73 71 6c 69  argv[0]);.  sqli
1ef0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36  te3_value_text16
1f00: 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 73 71 6c  (argv[0]);.  sql
1f10: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28  ite3_value_text(
1f20: 61 72 67 76 5b 30 5d 29 3b 0a 23 65 6e 64 69 66  argv[0]);.#endif
1f30: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
1f40: 74 5f 76 61 6c 75 65 28 70 43 74 78 2c 20 61 72  t_value(pCtx, ar
1f50: 67 76 5b 31 5d 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  gv[1]);.}../*.**
1f60: 20 49 6e 76 6f 6b 65 20 61 6e 20 53 51 4c 20 73   Invoke an SQL s
1f70: 74 61 74 65 6d 65 6e 74 20 72 65 63 75 72 73 69  tatement recursi
1f80: 76 65 6c 79 2e 20 20 54 68 65 20 66 75 6e 63 74  vely.  The funct
1f90: 69 6f 6e 20 72 65 73 75 6c 74 20 69 73 20 74 68  ion result is th
1fa0: 65 20 0a 2a 2a 20 66 69 72 73 74 20 63 6f 6c 75  e .** first colu
1fb0: 6d 6e 20 6f 66 20 74 68 65 20 66 69 72 73 74 20  mn of the first 
1fc0: 72 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c  row of the resul
1fd0: 74 20 73 65 74 2e 0a 2a 2f 0a 73 74 61 74 69 63  t set..*/.static
1fe0: 20 76 6f 69 64 20 74 65 73 74 5f 65 76 61 6c 28   void test_eval(
1ff0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
2000: 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 69 6e 74  xt *pCtx, .  int
2010: 20 6e 41 72 67 2c 0a 20 20 73 71 6c 69 74 65 33   nArg,.  sqlite3
2020: 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b  _value **argv.){
2030: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
2040: 2a 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20 72 63  *pStmt;.  int rc
2050: 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20  ;.  sqlite3 *db 
2060: 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  = sqlite3_contex
2070: 74 5f 64 62 5f 68 61 6e 64 6c 65 28 70 43 74 78  t_db_handle(pCtx
2080: 29 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  );.  const char 
2090: 2a 7a 53 71 6c 3b 0a 0a 20 20 7a 53 71 6c 20 3d  *zSql;..  zSql =
20a0: 20 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f   (char*)sqlite3_
20b0: 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b  value_text(argv[
20c0: 30 5d 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69  0]);.  rc = sqli
20d0: 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32 28 64  te3_prepare_v2(d
20e0: 62 2c 20 7a 53 71 6c 2c 20 2d 31 2c 20 26 70 53  b, zSql, -1, &pS
20f0: 74 6d 74 2c 20 30 29 3b 0a 20 20 69 66 28 20 72  tmt, 0);.  if( r
2100: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
2110: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
2120: 5f 73 74 65 70 28 70 53 74 6d 74 29 3b 0a 20 20  _step(pStmt);.  
2130: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
2140: 5f 52 4f 57 20 29 7b 0a 20 20 20 20 20 20 73 71  _ROW ){.      sq
2150: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c  lite3_result_val
2160: 75 65 28 70 43 74 78 2c 20 73 71 6c 69 74 65 33  ue(pCtx, sqlite3
2170: 5f 63 6f 6c 75 6d 6e 5f 76 61 6c 75 65 28 70 53  _column_value(pS
2180: 74 6d 74 2c 20 30 29 29 3b 0a 20 20 20 20 7d 0a  tmt, 0));.    }.
2190: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
21a0: 5f 66 69 6e 61 6c 69 7a 65 28 70 53 74 6d 74 29  _finalize(pStmt)
21b0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 20 29  ;.  }.  if( rc )
21c0: 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 45 72 72  {.    char *zErr
21d0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 53  ;.    assert( pS
21e0: 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 20 20 7a 45  tmt==0 );.    zE
21f0: 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72  rr = sqlite3_mpr
2200: 69 6e 74 66 28 22 73 71 6c 69 74 65 33 5f 70 72  intf("sqlite3_pr
2210: 65 70 61 72 65 5f 76 32 28 29 20 65 72 72 6f 72  epare_v2() error
2220: 3a 20 25 73 22 2c 73 71 6c 69 74 65 33 5f 65 72  : %s",sqlite3_er
2230: 72 6d 73 67 28 64 62 29 29 3b 0a 20 20 20 20 73  rmsg(db));.    s
2240: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
2250: 78 74 28 70 43 74 78 2c 20 7a 45 72 72 2c 20 2d  xt(pCtx, zErr, -
2260: 31 2c 20 73 71 6c 69 74 65 33 5f 66 72 65 65 29  1, sqlite3_free)
2270: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65  ;.    sqlite3_re
2280: 73 75 6c 74 5f 65 72 72 6f 72 5f 63 6f 64 65 28  sult_error_code(
2290: 70 43 74 78 2c 20 72 63 29 3b 0a 20 20 7d 0a 7d  pCtx, rc);.  }.}
22a0: 0a 0a 0a 2f 2a 0a 2a 2a 20 63 6f 6e 76 65 72 74  .../*.** convert
22b0: 20 6f 6e 65 20 63 68 61 72 61 63 74 65 72 20 66   one character f
22c0: 72 6f 6d 20 68 65 78 20 74 6f 20 62 69 6e 61 72  rom hex to binar
22d0: 79 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  y.*/.static int 
22e0: 74 65 73 74 48 65 78 43 68 61 72 28 63 68 61 72  testHexChar(char
22f0: 20 63 29 7b 0a 20 20 69 66 28 20 63 3e 3d 27 30   c){.  if( c>='0
2300: 27 20 26 26 20 63 3c 3d 27 39 27 20 29 7b 0a 20  ' && c<='9' ){. 
2310: 20 20 20 72 65 74 75 72 6e 20 63 20 2d 20 27 30     return c - '0
2320: 27 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 63  ';.  }else if( c
2330: 3e 3d 27 61 27 20 26 26 20 63 3c 3d 27 66 27 20  >='a' && c<='f' 
2340: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 63 20  ){.    return c 
2350: 2d 20 27 61 27 20 2b 20 31 30 3b 0a 20 20 7d 65  - 'a' + 10;.  }e
2360: 6c 73 65 20 69 66 28 20 63 3e 3d 27 41 27 20 26  lse if( c>='A' &
2370: 26 20 63 3c 3d 27 46 27 20 29 7b 0a 20 20 20 20  & c<='F' ){.    
2380: 72 65 74 75 72 6e 20 63 20 2d 20 27 41 27 20 2b  return c - 'A' +
2390: 20 31 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72   10;.  }.  retur
23a0: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f  n 0;.}../*.** Co
23b0: 6e 76 65 72 74 20 68 65 78 20 74 6f 20 62 69 6e  nvert hex to bin
23c0: 61 72 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ary..*/.static v
23d0: 6f 69 64 20 74 65 73 74 48 65 78 54 6f 42 69 6e  oid testHexToBin
23e0: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 49 6e  (const char *zIn
23f0: 2c 20 63 68 61 72 20 2a 7a 4f 75 74 29 7b 0a 20  , char *zOut){. 
2400: 20 77 68 69 6c 65 28 20 7a 49 6e 5b 30 5d 20 26   while( zIn[0] &
2410: 26 20 7a 49 6e 5b 31 5d 20 29 7b 0a 20 20 20 20  & zIn[1] ){.    
2420: 2a 28 7a 4f 75 74 2b 2b 29 20 3d 20 28 74 65 73  *(zOut++) = (tes
2430: 74 48 65 78 43 68 61 72 28 7a 49 6e 5b 30 5d 29  tHexChar(zIn[0])
2440: 3c 3c 34 29 20 2b 20 74 65 73 74 48 65 78 43 68  <<4) + testHexCh
2450: 61 72 28 7a 49 6e 5b 31 5d 29 3b 0a 20 20 20 20  ar(zIn[1]);.    
2460: 7a 49 6e 20 2b 3d 20 32 3b 0a 20 20 7d 0a 7d 0a  zIn += 2;.  }.}.
2470: 0a 2f 2a 0a 2a 2a 20 20 20 20 20 20 68 65 78 5f  ./*.**      hex_
2480: 74 6f 5f 75 74 66 31 36 62 65 28 48 45 58 29 0a  to_utf16be(HEX).
2490: 2a 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 74 68  **.** Convert th
24a0: 65 20 69 6e 70 75 74 20 73 74 72 69 6e 67 20 66  e input string f
24b0: 72 6f 6d 20 48 45 58 20 69 6e 74 6f 20 62 69 6e  rom HEX into bin
24c0: 61 72 79 2e 20 20 54 68 65 6e 20 72 65 74 75 72  ary.  Then retur
24d0: 6e 20 74 68 65 0a 2a 2a 20 72 65 73 75 6c 74 20  n the.** result 
24e0: 75 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 72 65  using sqlite3_re
24f0: 73 75 6c 74 5f 74 65 78 74 31 36 6c 65 28 29 2e  sult_text16le().
2500: 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  .*/.#ifndef SQLI
2510: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 73 74  TE_OMIT_UTF16.st
2520: 61 74 69 63 20 76 6f 69 64 20 74 65 73 74 48 65  atic void testHe
2530: 78 54 6f 55 74 66 31 36 62 65 28 0a 20 20 73 71  xToUtf16be(.  sq
2540: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
2550: 43 74 78 2c 20 0a 20 20 69 6e 74 20 6e 41 72 67  Ctx, .  int nArg
2560: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  ,.  sqlite3_valu
2570: 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20 20 69 6e  e **argv.){.  in
2580: 74 20 6e 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61  t n;.  const cha
2590: 72 20 2a 7a 49 6e 3b 0a 20 20 63 68 61 72 20 2a  r *zIn;.  char *
25a0: 7a 4f 75 74 3b 0a 20 20 61 73 73 65 72 74 28 20  zOut;.  assert( 
25b0: 6e 41 72 67 3d 3d 31 20 29 3b 0a 20 20 6e 20 3d  nArg==1 );.  n =
25c0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62   sqlite3_value_b
25d0: 79 74 65 73 28 61 72 67 76 5b 30 5d 29 3b 0a 20  ytes(argv[0]);. 
25e0: 20 7a 49 6e 20 3d 20 28 63 6f 6e 73 74 20 63 68   zIn = (const ch
25f0: 61 72 2a 29 73 71 6c 69 74 65 33 5f 76 61 6c 75  ar*)sqlite3_valu
2600: 65 5f 74 65 78 74 28 61 72 67 76 5b 30 5d 29 3b  e_text(argv[0]);
2610: 0a 20 20 7a 4f 75 74 20 3d 20 73 71 6c 69 74 65  .  zOut = sqlite
2620: 33 5f 6d 61 6c 6c 6f 63 28 20 6e 2f 32 20 29 3b  3_malloc( n/2 );
2630: 0a 20 20 69 66 28 20 7a 4f 75 74 3d 3d 30 20 29  .  if( zOut==0 )
2640: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65  {.    sqlite3_re
2650: 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65 6d  sult_error_nomem
2660: 28 70 43 74 78 29 3b 0a 20 20 7d 65 6c 73 65 7b  (pCtx);.  }else{
2670: 0a 20 20 20 20 74 65 73 74 48 65 78 54 6f 42 69  .    testHexToBi
2680: 6e 28 7a 49 6e 2c 20 7a 4f 75 74 29 3b 0a 20 20  n(zIn, zOut);.  
2690: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74    sqlite3_result
26a0: 5f 74 65 78 74 31 36 62 65 28 70 43 74 78 2c 20  _text16be(pCtx, 
26b0: 7a 4f 75 74 2c 20 6e 2f 32 2c 20 73 71 6c 69 74  zOut, n/2, sqlit
26c0: 65 33 5f 66 72 65 65 29 3b 0a 20 20 7d 0a 7d 0a  e3_free);.  }.}.
26d0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 20 20  #endif../*.**   
26e0: 20 20 20 68 65 78 5f 74 6f 5f 75 74 66 38 28 48     hex_to_utf8(H
26f0: 45 58 29 0a 2a 2a 0a 2a 2a 20 43 6f 6e 76 65 72  EX).**.** Conver
2700: 74 20 74 68 65 20 69 6e 70 75 74 20 73 74 72 69  t the input stri
2710: 6e 67 20 66 72 6f 6d 20 48 45 58 20 69 6e 74 6f  ng from HEX into
2720: 20 62 69 6e 61 72 79 2e 20 20 54 68 65 6e 20 72   binary.  Then r
2730: 65 74 75 72 6e 20 74 68 65 0a 2a 2a 20 72 65 73  eturn the.** res
2740: 75 6c 74 20 75 73 69 6e 67 20 73 71 6c 69 74 65  ult using sqlite
2750: 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 6c  3_result_text16l
2760: 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  e()..*/.static v
2770: 6f 69 64 20 74 65 73 74 48 65 78 54 6f 55 74 66  oid testHexToUtf
2780: 38 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  8(.  sqlite3_con
2790: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 69  text *pCtx, .  i
27a0: 6e 74 20 6e 41 72 67 2c 0a 20 20 73 71 6c 69 74  nt nArg,.  sqlit
27b0: 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a  e3_value **argv.
27c0: 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 63 6f  ){.  int n;.  co
27d0: 6e 73 74 20 63 68 61 72 20 2a 7a 49 6e 3b 0a 20  nst char *zIn;. 
27e0: 20 63 68 61 72 20 2a 7a 4f 75 74 3b 0a 20 20 61   char *zOut;.  a
27f0: 73 73 65 72 74 28 20 6e 41 72 67 3d 3d 31 20 29  ssert( nArg==1 )
2800: 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 5f  ;.  n = sqlite3_
2810: 76 61 6c 75 65 5f 62 79 74 65 73 28 61 72 67 76  value_bytes(argv
2820: 5b 30 5d 29 3b 0a 20 20 7a 49 6e 20 3d 20 28 63  [0]);.  zIn = (c
2830: 6f 6e 73 74 20 63 68 61 72 2a 29 73 71 6c 69 74  onst char*)sqlit
2840: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72  e3_value_text(ar
2850: 67 76 5b 30 5d 29 3b 0a 20 20 7a 4f 75 74 20 3d  gv[0]);.  zOut =
2860: 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28   sqlite3_malloc(
2870: 20 6e 2f 32 20 29 3b 0a 20 20 69 66 28 20 7a 4f   n/2 );.  if( zO
2880: 75 74 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c  ut==0 ){.    sql
2890: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f  ite3_result_erro
28a0: 72 5f 6e 6f 6d 65 6d 28 70 43 74 78 29 3b 0a 20  r_nomem(pCtx);. 
28b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 74 65 73 74   }else{.    test
28c0: 48 65 78 54 6f 42 69 6e 28 7a 49 6e 2c 20 7a 4f  HexToBin(zIn, zO
28d0: 75 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ut);.    sqlite3
28e0: 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 70 43 74  _result_text(pCt
28f0: 78 2c 20 7a 4f 75 74 2c 20 6e 2f 32 2c 20 73 71  x, zOut, n/2, sq
2900: 6c 69 74 65 33 5f 66 72 65 65 29 3b 0a 20 20 7d  lite3_free);.  }
2910: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 20 20 20 20 20 68  .}../*.**      h
2920: 65 78 5f 74 6f 5f 75 74 66 31 36 6c 65 28 48 45  ex_to_utf16le(HE
2930: 58 29 0a 2a 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74  X).**.** Convert
2940: 20 74 68 65 20 69 6e 70 75 74 20 73 74 72 69 6e   the input strin
2950: 67 20 66 72 6f 6d 20 48 45 58 20 69 6e 74 6f 20  g from HEX into 
2960: 62 69 6e 61 72 79 2e 20 20 54 68 65 6e 20 72 65  binary.  Then re
2970: 74 75 72 6e 20 74 68 65 0a 2a 2a 20 72 65 73 75  turn the.** resu
2980: 6c 74 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33  lt using sqlite3
2990: 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 6c 65  _result_text16le
29a0: 28 29 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53  ()..*/.#ifndef S
29b0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
29c0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74 65 73  .static void tes
29d0: 74 48 65 78 54 6f 55 74 66 31 36 6c 65 28 0a 20  tHexToUtf16le(. 
29e0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
29f0: 20 2a 70 43 74 78 2c 20 0a 20 20 69 6e 74 20 6e   *pCtx, .  int n
2a00: 41 72 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  Arg,.  sqlite3_v
2a10: 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20  alue **argv.){. 
2a20: 20 69 6e 74 20 6e 3b 0a 20 20 63 6f 6e 73 74 20   int n;.  const 
2a30: 63 68 61 72 20 2a 7a 49 6e 3b 0a 20 20 63 68 61  char *zIn;.  cha
2a40: 72 20 2a 7a 4f 75 74 3b 0a 20 20 61 73 73 65 72  r *zOut;.  asser
2a50: 74 28 20 6e 41 72 67 3d 3d 31 20 29 3b 0a 20 20  t( nArg==1 );.  
2a60: 6e 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  n = sqlite3_valu
2a70: 65 5f 62 79 74 65 73 28 61 72 67 76 5b 30 5d 29  e_bytes(argv[0])
2a80: 3b 0a 20 20 7a 49 6e 20 3d 20 28 63 6f 6e 73 74  ;.  zIn = (const
2a90: 20 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76   char*)sqlite3_v
2aa0: 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b 30  alue_text(argv[0
2ab0: 5d 29 3b 0a 20 20 7a 4f 75 74 20 3d 20 73 71 6c  ]);.  zOut = sql
2ac0: 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 6e 2f 32  ite3_malloc( n/2
2ad0: 20 29 3b 0a 20 20 69 66 28 20 7a 4f 75 74 3d 3d   );.  if( zOut==
2ae0: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  0 ){.    sqlite3
2af0: 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f  _result_error_no
2b00: 6d 65 6d 28 70 43 74 78 29 3b 0a 20 20 7d 65 6c  mem(pCtx);.  }el
2b10: 73 65 7b 0a 20 20 20 20 74 65 73 74 48 65 78 54  se{.    testHexT
2b20: 6f 42 69 6e 28 7a 49 6e 2c 20 7a 4f 75 74 29 3b  oBin(zIn, zOut);
2b30: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73  .    sqlite3_res
2b40: 75 6c 74 5f 74 65 78 74 31 36 6c 65 28 70 43 74  ult_text16le(pCt
2b50: 78 2c 20 7a 4f 75 74 2c 20 6e 2f 32 2c 20 73 71  x, zOut, n/2, sq
2b60: 6c 69 74 65 33 5f 66 72 65 65 29 3b 0a 20 20 7d  lite3_free);.  }
2b70: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  .}.#endif../*.**
2b80: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 3a 20 20   SQL function:  
2b90: 20 72 65 61 6c 32 68 65 78 28 58 29 0a 2a 2a 0a   real2hex(X).**.
2ba0: 2a 2a 20 49 66 20 61 72 67 75 6d 65 6e 74 20 58  ** If argument X
2bb0: 20 69 73 20 61 20 72 65 61 6c 20 6e 75 6d 62 65   is a real numbe
2bc0: 72 2c 20 74 68 65 6e 20 63 6f 6e 76 65 72 74 20  r, then convert 
2bd0: 69 74 20 69 6e 74 6f 20 61 20 73 74 72 69 6e 67  it into a string
2be0: 20 77 68 69 63 68 20 69 73 0a 2a 2a 20 74 68 65   which is.** the
2bf0: 20 62 69 67 2d 65 6e 64 69 61 6e 20 68 65 78 61   big-endian hexa
2c00: 64 65 63 69 6d 61 6c 20 72 65 70 72 65 73 65 6e  decimal represen
2c10: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 69 65  tation of the ie
2c20: 65 65 37 35 34 20 65 6e 63 6f 64 69 6e 67 20 6f  ee754 encoding o
2c30: 66 0a 2a 2a 20 74 68 61 74 20 6e 75 6d 62 65 72  f.** that number
2c40: 2e 20 20 49 66 20 58 20 69 73 20 6e 6f 74 20 61  .  If X is not a
2c50: 20 72 65 61 6c 20 6e 75 6d 62 65 72 2c 20 72 65   real number, re
2c60: 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74  turn NULL..*/.st
2c70: 61 74 69 63 20 76 6f 69 64 20 72 65 61 6c 32 68  atic void real2h
2c80: 65 78 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  ex(.  sqlite3_co
2c90: 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a  ntext *context,.
2ca0: 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71    int argc,.  sq
2cb0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
2cc0: 67 76 0a 29 7b 0a 20 20 75 6e 69 6f 6e 20 7b 0a  gv.){.  union {.
2cd0: 20 20 20 20 73 71 6c 69 74 65 33 5f 75 69 6e 74      sqlite3_uint
2ce0: 36 34 20 69 3b 0a 20 20 20 20 64 6f 75 62 6c 65  64 i;.    double
2cf0: 20 72 3b 0a 20 20 20 20 75 6e 73 69 67 6e 65 64   r;.    unsigned
2d00: 20 63 68 61 72 20 78 5b 38 5d 3b 0a 20 20 7d 20   char x[8];.  } 
2d10: 76 3b 0a 20 20 63 68 61 72 20 7a 4f 75 74 5b 32  v;.  char zOut[2
2d20: 30 5d 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  0];.  int i;.  i
2d30: 6e 74 20 62 69 67 45 6e 64 69 61 6e 3b 0a 20 20  nt bigEndian;.  
2d40: 76 2e 69 20 3d 20 31 3b 0a 20 20 62 69 67 45 6e  v.i = 1;.  bigEn
2d50: 64 69 61 6e 20 3d 20 76 2e 78 5b 30 5d 3d 3d 30  dian = v.x[0]==0
2d60: 3b 0a 20 20 76 2e 72 20 3d 20 73 71 6c 69 74 65  ;.  v.r = sqlite
2d70: 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 61  3_value_double(a
2d80: 72 67 76 5b 30 5d 29 3b 0a 20 20 66 6f 72 28 69  rgv[0]);.  for(i
2d90: 3d 30 3b 20 69 3c 38 3b 20 69 2b 2b 29 7b 0a 20  =0; i<8; i++){. 
2da0: 20 20 20 69 66 28 20 62 69 67 45 6e 64 69 61 6e     if( bigEndian
2db0: 20 29 7b 0a 20 20 20 20 20 20 7a 4f 75 74 5b 69   ){.      zOut[i
2dc0: 2a 32 5d 20 20 20 3d 20 22 30 31 32 33 34 35 36  *2]   = "0123456
2dd0: 37 38 39 61 62 63 64 65 66 22 5b 76 2e 78 5b 69  789abcdef"[v.x[i
2de0: 5d 3e 3e 34 5d 3b 0a 20 20 20 20 20 20 7a 4f 75  ]>>4];.      zOu
2df0: 74 5b 69 2a 32 2b 31 5d 20 3d 20 22 30 31 32 33  t[i*2+1] = "0123
2e00: 34 35 36 37 38 39 61 62 63 64 65 66 22 5b 76 2e  456789abcdef"[v.
2e10: 78 5b 69 5d 26 30 78 66 5d 3b 0a 20 20 20 20 7d  x[i]&0xf];.    }
2e20: 65 6c 73 65 7b 0a 20 20 20 20 20 20 7a 4f 75 74  else{.      zOut
2e30: 5b 31 34 2d 69 2a 32 5d 20 20 20 3d 20 22 30 31  [14-i*2]   = "01
2e40: 32 33 34 35 36 37 38 39 61 62 63 64 65 66 22 5b  23456789abcdef"[
2e50: 76 2e 78 5b 69 5d 3e 3e 34 5d 3b 0a 20 20 20 20  v.x[i]>>4];.    
2e60: 20 20 7a 4f 75 74 5b 31 34 2d 69 2a 32 2b 31 5d    zOut[14-i*2+1]
2e70: 20 3d 20 22 30 31 32 33 34 35 36 37 38 39 61 62   = "0123456789ab
2e80: 63 64 65 66 22 5b 76 2e 78 5b 69 5d 26 30 78 66  cdef"[v.x[i]&0xf
2e90: 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 7a  ];.    }.  }.  z
2ea0: 4f 75 74 5b 31 36 5d 20 3d 20 30 3b 0a 20 20 73  Out[16] = 0;.  s
2eb0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
2ec0: 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a 4f 75 74  xt(context, zOut
2ed0: 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f 54 52 41  , -1, SQLITE_TRA
2ee0: 4e 53 49 45 4e 54 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  NSIENT);.}../*.*
2ef0: 2a 20 20 20 20 20 74 65 73 74 5f 65 78 74 72 61  *     test_extra
2f00: 63 74 28 72 65 63 6f 72 64 2c 20 66 69 65 6c 64  ct(record, field
2f10: 29 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ).**.** This fun
2f20: 63 74 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 73  ction implements
2f30: 20 61 6e 20 53 51 4c 20 75 73 65 72 2d 66 75 6e   an SQL user-fun
2f40: 63 74 69 6f 6e 20 74 68 61 74 20 61 63 63 65 70  ction that accep
2f50: 74 73 20 61 20 62 6c 6f 62 0a 2a 2a 20 63 6f 6e  ts a blob.** con
2f60: 74 61 69 6e 69 6e 67 20 61 20 66 6f 72 6d 61 74  taining a format
2f70: 74 65 64 20 64 61 74 61 62 61 73 65 20 72 65 63  ted database rec
2f80: 6f 72 64 20 61 73 20 74 68 65 20 66 69 72 73 74  ord as the first
2f90: 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 0a 2a   argument. The.*
2fa0: 2a 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e  * second argumen
2fb0: 74 20 69 73 20 74 68 65 20 69 6e 64 65 78 20 6f  t is the index o
2fc0: 66 20 74 68 65 20 66 69 65 6c 64 20 77 69 74 68  f the field with
2fd0: 69 6e 20 74 68 61 74 20 72 65 63 6f 72 64 20 74  in that record t
2fe0: 6f 0a 2a 2a 20 65 78 74 72 61 63 74 20 61 6e 64  o.** extract and
2ff0: 20 72 65 74 75 72 6e 2e 0a 2a 2f 0a 73 74 61 74   return..*/.stat
3000: 69 63 20 76 6f 69 64 20 74 65 73 74 5f 65 78 74  ic void test_ext
3010: 72 61 63 74 28 0a 20 20 73 71 6c 69 74 65 33 5f  ract(.  sqlite3_
3020: 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74  context *context
3030: 2c 0a 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20  ,.  int argc,.  
3040: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
3050: 61 72 67 76 0a 29 7b 0a 20 20 73 71 6c 69 74 65  argv.){.  sqlite
3060: 33 20 2a 64 62 20 3d 20 73 71 6c 69 74 65 33 5f  3 *db = sqlite3_
3070: 63 6f 6e 74 65 78 74 5f 64 62 5f 68 61 6e 64 6c  context_db_handl
3080: 65 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 75 38  e(context);.  u8
3090: 20 2a 70 52 65 63 3b 0a 20 20 75 38 20 2a 70 45   *pRec;.  u8 *pE
30a0: 6e 64 48 64 72 3b 20 20 20 20 20 20 20 20 20 20  ndHdr;          
30b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69            /* Poi
30c0: 6e 74 73 20 74 6f 20 6f 6e 65 20 62 79 74 65 20  nts to one byte 
30d0: 70 61 73 74 20 72 65 63 6f 72 64 20 68 65 61 64  past record head
30e0: 65 72 20 2a 2f 0a 20 20 75 38 20 2a 70 48 64 72  er */.  u8 *pHdr
30f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
3100: 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65          /* Curre
3110: 6e 74 20 70 6f 69 6e 74 20 69 6e 20 72 65 63 6f  nt point in reco
3120: 72 64 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75  rd header */.  u
3130: 38 20 2a 70 42 6f 64 79 3b 20 20 20 20 20 20 20  8 *pBody;       
3140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
3150: 2a 20 43 75 72 72 65 6e 74 20 70 6f 69 6e 74 20  * Current point 
3160: 69 6e 20 72 65 63 6f 72 64 20 64 61 74 61 20 2a  in record data *
3170: 2f 0a 20 20 75 36 34 20 6e 48 64 72 3b 20 20 20  /.  u64 nHdr;   
3180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3190: 20 20 20 20 2f 2a 20 42 79 74 65 73 20 69 6e 20      /* Bytes in 
31a0: 72 65 63 6f 72 64 20 68 65 61 64 65 72 20 2a 2f  record header */
31b0: 0a 20 20 69 6e 74 20 69 49 64 78 3b 20 20 20 20  .  int iIdx;    
31c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
31d0: 20 20 20 2f 2a 20 52 65 71 75 69 72 65 64 20 66     /* Required f
31e0: 69 65 6c 64 20 2a 2f 0a 20 20 69 6e 74 20 69 43  ield */.  int iC
31f0: 75 72 72 65 6e 74 20 3d 20 30 3b 20 20 20 20 20  urrent = 0;     
3200: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72            /* Cur
3210: 72 65 6e 74 20 66 69 65 6c 64 20 2a 2f 0a 0a 20  rent field */.. 
3220: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 32   assert( argc==2
3230: 20 29 3b 0a 20 20 70 52 65 63 20 3d 20 28 75 38   );.  pRec = (u8
3240: 2a 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  *)sqlite3_value_
3250: 62 6c 6f 62 28 61 72 67 76 5b 30 5d 29 3b 0a 20  blob(argv[0]);. 
3260: 20 69 49 64 78 20 3d 20 73 71 6c 69 74 65 33 5f   iIdx = sqlite3_
3270: 76 61 6c 75 65 5f 69 6e 74 28 61 72 67 76 5b 31  value_int(argv[1
3280: 5d 29 3b 0a 0a 20 20 70 48 64 72 20 3d 20 70 52  ]);..  pHdr = pR
3290: 65 63 20 2b 20 73 71 6c 69 74 65 33 47 65 74 56  ec + sqlite3GetV
32a0: 61 72 69 6e 74 28 70 52 65 63 2c 20 26 6e 48 64  arint(pRec, &nHd
32b0: 72 29 3b 0a 20 20 70 42 6f 64 79 20 3d 20 70 45  r);.  pBody = pE
32c0: 6e 64 48 64 72 20 3d 20 26 70 52 65 63 5b 6e 48  ndHdr = &pRec[nH
32d0: 64 72 5d 3b 0a 0a 20 20 66 6f 72 28 69 43 75 72  dr];..  for(iCur
32e0: 72 65 6e 74 3d 30 3b 20 70 48 64 72 3c 70 45 6e  rent=0; pHdr<pEn
32f0: 64 48 64 72 20 26 26 20 69 43 75 72 72 65 6e 74  dHdr && iCurrent
3300: 3c 3d 69 49 64 78 3b 20 69 43 75 72 72 65 6e 74  <=iIdx; iCurrent
3310: 2b 2b 29 7b 0a 20 20 20 20 75 36 34 20 69 53 65  ++){.    u64 iSe
3320: 72 69 61 6c 54 79 70 65 3b 0a 20 20 20 20 4d 65  rialType;.    Me
3330: 6d 20 6d 65 6d 3b 0a 0a 20 20 20 20 6d 65 6d 73  m mem;..    mems
3340: 65 74 28 26 6d 65 6d 2c 20 30 2c 20 73 69 7a 65  et(&mem, 0, size
3350: 6f 66 28 6d 65 6d 29 29 3b 0a 20 20 20 20 6d 65  of(mem));.    me
3360: 6d 2e 64 62 20 3d 20 64 62 3b 0a 20 20 20 20 6d  m.db = db;.    m
3370: 65 6d 2e 65 6e 63 20 3d 20 45 4e 43 28 64 62 29  em.enc = ENC(db)
3380: 3b 0a 20 20 20 20 70 48 64 72 20 2b 3d 20 73 71  ;.    pHdr += sq
3390: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 28 70  lite3GetVarint(p
33a0: 48 64 72 2c 20 26 69 53 65 72 69 61 6c 54 79 70  Hdr, &iSerialTyp
33b0: 65 29 3b 0a 20 20 20 20 70 42 6f 64 79 20 2b 3d  e);.    pBody +=
33c0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
33d0: 61 6c 47 65 74 28 70 42 6f 64 79 2c 20 28 75 33  alGet(pBody, (u3
33e0: 32 29 69 53 65 72 69 61 6c 54 79 70 65 2c 20 26  2)iSerialType, &
33f0: 6d 65 6d 29 3b 0a 0a 20 20 20 20 69 66 28 20 69  mem);..    if( i
3400: 43 75 72 72 65 6e 74 3d 3d 69 49 64 78 20 29 7b  Current==iIdx ){
3410: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72  .      sqlite3_r
3420: 65 73 75 6c 74 5f 76 61 6c 75 65 28 63 6f 6e 74  esult_value(cont
3430: 65 78 74 2c 20 26 6d 65 6d 29 3b 0a 20 20 20 20  ext, &mem);.    
3440: 7d 0a 0a 20 20 20 20 69 66 28 20 6d 65 6d 2e 73  }..    if( mem.s
3450: 7a 4d 61 6c 6c 6f 63 20 29 20 73 71 6c 69 74 65  zMalloc ) sqlite
3460: 33 44 62 46 72 65 65 28 64 62 2c 20 6d 65 6d 2e  3DbFree(db, mem.
3470: 7a 4d 61 6c 6c 6f 63 29 3b 0a 20 20 7d 0a 7d 0a  zMalloc);.  }.}.
3480: 0a 2f 2a 0a 2a 2a 20 20 20 20 20 20 74 65 73 74  ./*.**      test
3490: 5f 64 65 63 6f 64 65 28 72 65 63 6f 72 64 29 0a  _decode(record).
34a0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  **.** This funct
34b0: 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61  ion implements a
34c0: 6e 20 53 51 4c 20 75 73 65 72 2d 66 75 6e 63 74  n SQL user-funct
34d0: 69 6f 6e 20 74 68 61 74 20 61 63 63 65 70 74 73  ion that accepts
34e0: 20 61 20 62 6c 6f 62 0a 2a 2a 20 63 6f 6e 74 61   a blob.** conta
34f0: 69 6e 69 6e 67 20 61 20 66 6f 72 6d 61 74 74 65  ining a formatte
3500: 64 20 64 61 74 61 62 61 73 65 20 72 65 63 6f 72  d database recor
3510: 64 20 61 73 20 69 74 73 20 6f 6e 6c 79 20 61 72  d as its only ar
3520: 67 75 6d 65 6e 74 2e 20 49 74 20 72 65 74 75 72  gument. It retur
3530: 6e 73 0a 2a 2a 20 61 20 74 63 6c 20 6c 69 73 74  ns.** a tcl list
3540: 20 28 74 79 70 65 20 53 51 4c 49 54 45 5f 54 45   (type SQLITE_TE
3550: 58 54 29 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65  XT) containing e
3560: 61 63 68 20 6f 66 20 74 68 65 20 76 61 6c 75 65  ach of the value
3570: 73 20 73 74 6f 72 65 64 0a 2a 2a 20 69 6e 20 74  s stored.** in t
3580: 68 65 20 72 65 63 6f 72 64 2e 0a 2a 2f 0a 73 74  he record..*/.st
3590: 61 74 69 63 20 76 6f 69 64 20 74 65 73 74 5f 64  atic void test_d
35a0: 65 63 6f 64 65 28 0a 20 20 73 71 6c 69 74 65 33  ecode(.  sqlite3
35b0: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
35c0: 74 2c 0a 20 20 69 6e 74 20 61 72 67 63 2c 0a 20  t,.  int argc,. 
35d0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
35e0: 2a 61 72 67 76 0a 29 7b 0a 20 20 73 71 6c 69 74  *argv.){.  sqlit
35f0: 65 33 20 2a 64 62 20 3d 20 73 71 6c 69 74 65 33  e3 *db = sqlite3
3600: 5f 63 6f 6e 74 65 78 74 5f 64 62 5f 68 61 6e 64  _context_db_hand
3610: 6c 65 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 75  le(context);.  u
3620: 38 20 2a 70 52 65 63 3b 0a 20 20 75 38 20 2a 70  8 *pRec;.  u8 *p
3630: 45 6e 64 48 64 72 3b 20 20 20 20 20 20 20 20 20  EndHdr;         
3640: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f             /* Po
3650: 69 6e 74 73 20 74 6f 20 6f 6e 65 20 62 79 74 65  ints to one byte
3660: 20 70 61 73 74 20 72 65 63 6f 72 64 20 68 65 61   past record hea
3670: 64 65 72 20 2a 2f 0a 20 20 75 38 20 2a 70 48 64  der */.  u8 *pHd
3680: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  r;              
3690: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72           /* Curr
36a0: 65 6e 74 20 70 6f 69 6e 74 20 69 6e 20 72 65 63  ent point in rec
36b0: 6f 72 64 20 68 65 61 64 65 72 20 2a 2f 0a 20 20  ord header */.  
36c0: 75 38 20 2a 70 42 6f 64 79 3b 20 20 20 20 20 20  u8 *pBody;      
36d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
36e0: 2f 2a 20 43 75 72 72 65 6e 74 20 70 6f 69 6e 74  /* Current point
36f0: 20 69 6e 20 72 65 63 6f 72 64 20 64 61 74 61 20   in record data 
3700: 2a 2f 0a 20 20 75 36 34 20 6e 48 64 72 3b 20 20  */.  u64 nHdr;  
3710: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3720: 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 69 6e       /* Bytes in
3730: 20 72 65 63 6f 72 64 20 68 65 61 64 65 72 20 2a   record header *
3740: 2f 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70 52 65  /.  Tcl_Obj *pRe
3750: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
3760: 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 76 61      /* Return va
3770: 6c 75 65 20 2a 2f 0a 0a 20 20 70 52 65 74 20 3d  lue */..  pRet =
3780: 20 54 63 6c 5f 4e 65 77 4f 62 6a 28 29 3b 0a 20   Tcl_NewObj();. 
3790: 20 54 63 6c 5f 49 6e 63 72 52 65 66 43 6f 75 6e   Tcl_IncrRefCoun
37a0: 74 28 70 52 65 74 29 3b 0a 0a 20 20 61 73 73 65  t(pRet);..  asse
37b0: 72 74 28 20 61 72 67 63 3d 3d 31 20 29 3b 0a 20  rt( argc==1 );. 
37c0: 20 70 52 65 63 20 3d 20 28 75 38 2a 29 73 71 6c   pRec = (u8*)sql
37d0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28  ite3_value_blob(
37e0: 61 72 67 76 5b 30 5d 29 3b 0a 0a 20 20 70 48 64  argv[0]);..  pHd
37f0: 72 20 3d 20 70 52 65 63 20 2b 20 73 71 6c 69 74  r = pRec + sqlit
3800: 65 33 47 65 74 56 61 72 69 6e 74 28 70 52 65 63  e3GetVarint(pRec
3810: 2c 20 26 6e 48 64 72 29 3b 0a 20 20 70 42 6f 64  , &nHdr);.  pBod
3820: 79 20 3d 20 70 45 6e 64 48 64 72 20 3d 20 26 70  y = pEndHdr = &p
3830: 52 65 63 5b 6e 48 64 72 5d 3b 0a 20 20 77 68 69  Rec[nHdr];.  whi
3840: 6c 65 28 20 70 48 64 72 3c 70 45 6e 64 48 64 72  le( pHdr<pEndHdr
3850: 20 29 7b 0a 20 20 20 20 54 63 6c 5f 4f 62 6a 20   ){.    Tcl_Obj 
3860: 2a 70 56 61 6c 20 3d 20 30 3b 0a 20 20 20 20 75  *pVal = 0;.    u
3870: 36 34 20 69 53 65 72 69 61 6c 54 79 70 65 3b 0a  64 iSerialType;.
3880: 20 20 20 20 4d 65 6d 20 6d 65 6d 3b 0a 0a 20 20      Mem mem;..  
3890: 20 20 6d 65 6d 73 65 74 28 26 6d 65 6d 2c 20 30    memset(&mem, 0
38a0: 2c 20 73 69 7a 65 6f 66 28 6d 65 6d 29 29 3b 0a  , sizeof(mem));.
38b0: 20 20 20 20 6d 65 6d 2e 64 62 20 3d 20 64 62 3b      mem.db = db;
38c0: 0a 20 20 20 20 6d 65 6d 2e 65 6e 63 20 3d 20 45  .    mem.enc = E
38d0: 4e 43 28 64 62 29 3b 0a 20 20 20 20 70 48 64 72  NC(db);.    pHdr
38e0: 20 2b 3d 20 73 71 6c 69 74 65 33 47 65 74 56 61   += sqlite3GetVa
38f0: 72 69 6e 74 28 70 48 64 72 2c 20 26 69 53 65 72  rint(pHdr, &iSer
3900: 69 61 6c 54 79 70 65 29 3b 0a 20 20 20 20 70 42  ialType);.    pB
3910: 6f 64 79 20 2b 3d 20 73 71 6c 69 74 65 33 56 64  ody += sqlite3Vd
3920: 62 65 53 65 72 69 61 6c 47 65 74 28 70 42 6f 64  beSerialGet(pBod
3930: 79 2c 20 28 75 33 32 29 69 53 65 72 69 61 6c 54  y, (u32)iSerialT
3940: 79 70 65 2c 20 26 6d 65 6d 29 3b 0a 0a 20 20 20  ype, &mem);..   
3950: 20 73 77 69 74 63 68 28 20 73 71 6c 69 74 65 33   switch( sqlite3
3960: 5f 76 61 6c 75 65 5f 74 79 70 65 28 26 6d 65 6d  _value_type(&mem
3970: 29 20 29 7b 0a 20 20 20 20 20 20 63 61 73 65 20  ) ){.      case 
3980: 53 51 4c 49 54 45 5f 54 45 58 54 3a 0a 20 20 20  SQLITE_TEXT:.   
3990: 20 20 20 20 20 70 56 61 6c 20 3d 20 54 63 6c 5f       pVal = Tcl_
39a0: 4e 65 77 53 74 72 69 6e 67 4f 62 6a 28 28 63 6f  NewStringObj((co
39b0: 6e 73 74 20 63 68 61 72 2a 29 73 71 6c 69 74 65  nst char*)sqlite
39c0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 26 6d 65  3_value_text(&me
39d0: 6d 29 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 20  m), -1);.       
39e0: 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 20 20 63   break;..      c
39f0: 61 73 65 20 53 51 4c 49 54 45 5f 42 4c 4f 42 3a  ase SQLITE_BLOB:
3a00: 20 7b 0a 20 20 20 20 20 20 20 20 63 68 61 72 20   {.        char 
3a10: 68 65 78 64 69 67 69 74 5b 5d 20 3d 20 7b 0a 20  hexdigit[] = {. 
3a20: 20 20 20 20 20 20 20 20 20 27 30 27 2c 20 27 31           '0', '1
3a30: 27 2c 20 27 32 27 2c 20 27 33 27 2c 20 27 34 27  ', '2', '3', '4'
3a40: 2c 20 27 35 27 2c 20 27 36 27 2c 20 27 37 27 2c  , '5', '6', '7',
3a50: 0a 20 20 20 20 20 20 20 20 20 20 27 38 27 2c 20  .          '8', 
3a60: 27 39 27 2c 20 27 61 27 2c 20 27 62 27 2c 20 27  '9', 'a', 'b', '
3a70: 63 27 2c 20 27 64 27 2c 20 27 65 27 2c 20 27 66  c', 'd', 'e', 'f
3a80: 27 0a 20 20 20 20 20 20 20 20 7d 3b 0a 20 20 20  '.        };.   
3a90: 20 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c       int n = sql
3aa0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73  ite3_value_bytes
3ab0: 28 26 6d 65 6d 29 3b 0a 20 20 20 20 20 20 20 20  (&mem);.        
3ac0: 75 38 20 2a 7a 20 3d 20 28 75 38 2a 29 73 71 6c  u8 *z = (u8*)sql
3ad0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28  ite3_value_blob(
3ae0: 26 6d 65 6d 29 3b 0a 20 20 20 20 20 20 20 20 69  &mem);.        i
3af0: 6e 74 20 69 3b 0a 20 20 20 20 20 20 20 20 70 56  nt i;.        pV
3b00: 61 6c 20 3d 20 54 63 6c 5f 4e 65 77 53 74 72 69  al = Tcl_NewStri
3b10: 6e 67 4f 62 6a 28 22 78 27 22 2c 20 2d 31 29 3b  ngObj("x'", -1);
3b20: 0a 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30  .        for(i=0
3b30: 3b 20 69 3c 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20  ; i<n; i++){.   
3b40: 20 20 20 20 20 20 20 63 68 61 72 20 68 65 78 5b         char hex[
3b50: 33 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 68 65  3];.          he
3b60: 78 5b 30 5d 20 3d 20 68 65 78 64 69 67 69 74 5b  x[0] = hexdigit[
3b70: 28 28 7a 5b 69 5d 20 3e 3e 20 34 29 20 26 20 30  ((z[i] >> 4) & 0
3b80: 78 30 46 29 5d 3b 0a 20 20 20 20 20 20 20 20 20  x0F)];.         
3b90: 20 68 65 78 5b 31 5d 20 3d 20 68 65 78 64 69 67   hex[1] = hexdig
3ba0: 69 74 5b 28 7a 5b 69 5d 20 26 20 30 78 30 46 29  it[(z[i] & 0x0F)
3bb0: 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 68 65 78  ];.          hex
3bc0: 5b 32 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20  [2] = '\0';.    
3bd0: 20 20 20 20 20 20 54 63 6c 5f 41 70 70 65 6e 64        Tcl_Append
3be0: 53 74 72 69 6e 67 73 54 6f 4f 62 6a 28 70 56 61  StringsToObj(pVa
3bf0: 6c 2c 20 68 65 78 2c 20 30 29 3b 0a 20 20 20 20  l, hex, 0);.    
3c00: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 54 63      }.        Tc
3c10: 6c 5f 41 70 70 65 6e 64 53 74 72 69 6e 67 73 54  l_AppendStringsT
3c20: 6f 4f 62 6a 28 70 56 61 6c 2c 20 22 27 22 2c 20  oObj(pVal, "'", 
3c30: 30 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61  0);.        brea
3c40: 6b 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20  k;.      }..    
3c50: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4c    case SQLITE_FL
3c60: 4f 41 54 3a 0a 20 20 20 20 20 20 20 20 70 56 61  OAT:.        pVa
3c70: 6c 20 3d 20 54 63 6c 5f 4e 65 77 44 6f 75 62 6c  l = Tcl_NewDoubl
3c80: 65 4f 62 6a 28 73 71 6c 69 74 65 33 5f 76 61 6c  eObj(sqlite3_val
3c90: 75 65 5f 64 6f 75 62 6c 65 28 26 6d 65 6d 29 29  ue_double(&mem))
3ca0: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
3cb0: 0a 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c  ..      case SQL
3cc0: 49 54 45 5f 49 4e 54 45 47 45 52 3a 0a 20 20 20  ITE_INTEGER:.   
3cd0: 20 20 20 20 20 70 56 61 6c 20 3d 20 54 63 6c 5f       pVal = Tcl_
3ce0: 4e 65 77 57 69 64 65 49 6e 74 4f 62 6a 28 73 71  NewWideIntObj(sq
3cf0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 36  lite3_value_int6
3d00: 34 28 26 6d 65 6d 29 29 3b 0a 20 20 20 20 20 20  4(&mem));.      
3d10: 20 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 20 20    break;..      
3d20: 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 55 4c 4c  case SQLITE_NULL
3d30: 3a 0a 20 20 20 20 20 20 20 20 70 56 61 6c 20 3d  :.        pVal =
3d40: 20 54 63 6c 5f 4e 65 77 53 74 72 69 6e 67 4f 62   Tcl_NewStringOb
3d50: 6a 28 22 4e 55 4c 4c 22 2c 20 2d 31 29 3b 0a 20  j("NULL", -1);. 
3d60: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20         break;.. 
3d70: 20 20 20 20 20 64 65 66 61 75 6c 74 3a 0a 20 20       default:.  
3d80: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 30 20        assert( 0 
3d90: 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 54 63  );.    }..    Tc
3da0: 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65 6e 64 45  l_ListObjAppendE
3db0: 6c 65 6d 65 6e 74 28 30 2c 20 70 52 65 74 2c 20  lement(0, pRet, 
3dc0: 70 56 61 6c 29 3b 0a 0a 20 20 20 20 69 66 28 20  pVal);..    if( 
3dd0: 6d 65 6d 2e 73 7a 4d 61 6c 6c 6f 63 20 29 7b 0a  mem.szMalloc ){.
3de0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46        sqlite3DbF
3df0: 72 65 65 28 64 62 2c 20 6d 65 6d 2e 7a 4d 61 6c  ree(db, mem.zMal
3e00: 6c 6f 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  loc);.    }.  }.
3e10: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
3e20: 74 5f 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20  t_text(context, 
3e30: 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 28 70 52  Tcl_GetString(pR
3e40: 65 74 29 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f  et), -1, SQLITE_
3e50: 54 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 54 63  TRANSIENT);.  Tc
3e60: 6c 5f 44 65 63 72 52 65 66 43 6f 75 6e 74 28 70  l_DecrRefCount(p
3e70: 52 65 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 20  Ret);.}../*.**  
3e80: 20 20 20 20 20 74 65 73 74 5f 7a 65 72 6f 62 6c       test_zerobl
3e90: 6f 62 28 4e 29 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ob(N).**.** The 
3ea0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  implementation o
3eb0: 66 20 73 63 61 6c 61 72 20 53 51 4c 20 66 75 6e  f scalar SQL fun
3ec0: 63 74 69 6f 6e 20 22 74 65 73 74 5f 7a 65 72 6f  ction "test_zero
3ed0: 62 6c 6f 62 28 29 22 2e 20 54 68 69 73 20 69 73  blob()". This is
3ee0: 0a 2a 2a 20 73 69 6d 69 6c 61 72 20 74 6f 20 74  .** similar to t
3ef0: 68 65 20 62 75 69 6c 74 2d 69 6e 20 7a 65 72 6f  he built-in zero
3f00: 62 6c 6f 62 28 29 20 66 75 6e 63 74 69 6f 6e 2c  blob() function,
3f10: 20 65 78 63 65 70 74 20 74 68 61 74 20 69 74 20   except that it 
3f20: 64 6f 65 73 20 6e 6f 74 0a 2a 2a 20 63 68 65 63  does not.** chec
3f30: 6b 20 74 68 61 74 20 74 68 65 20 69 6e 74 65 67  k that the integ
3f40: 65 72 20 70 61 72 61 6d 65 74 65 72 20 69 73 20  er parameter is 
3f50: 77 69 74 68 69 6e 20 72 61 6e 67 65 20 62 65 66  within range bef
3f60: 6f 72 65 20 70 61 73 73 69 6e 67 20 69 74 0a 2a  ore passing it.*
3f70: 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f 72 65 73  * to sqlite3_res
3f80: 75 6c 74 5f 7a 65 72 6f 62 6c 6f 62 28 29 2e 0a  ult_zeroblob()..
3f90: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74  */.static void t
3fa0: 65 73 74 5f 7a 65 72 6f 62 6c 6f 62 28 0a 20 20  est_zeroblob(.  
3fb0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
3fc0: 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20  *context,.  int 
3fd0: 61 72 67 63 2c 0a 20 20 73 71 6c 69 74 65 33 5f  argc,.  sqlite3_
3fe0: 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a  value **argv.){.
3ff0: 20 20 69 6e 74 20 6e 5a 65 72 6f 20 3d 20 73 71    int nZero = sq
4000: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28  lite3_value_int(
4010: 61 72 67 76 5b 30 5d 29 3b 0a 20 20 73 71 6c 69  argv[0]);.  sqli
4020: 74 65 33 5f 72 65 73 75 6c 74 5f 7a 65 72 6f 62  te3_result_zerob
4030: 6c 6f 62 28 63 6f 6e 74 65 78 74 2c 20 6e 5a 65  lob(context, nZe
4040: 72 6f 29 3b 0a 7d 0a 0a 2f 2a 20 20 20 20 20 20  ro);.}../*      
4050: 20 20 20 74 65 73 74 5f 67 65 74 73 75 62 74 79     test_getsubty
4060: 70 65 28 56 29 0a 2a 2a 0a 2a 2a 20 52 65 74 75  pe(V).**.** Retu
4070: 72 6e 20 74 68 65 20 73 75 62 74 79 70 65 20 66  rn the subtype f
4080: 6f 72 20 76 61 6c 75 65 20 56 2e 0a 2a 2f 0a 73  or value V..*/.s
4090: 74 61 74 69 63 20 76 6f 69 64 20 74 65 73 74 5f  tatic void test_
40a0: 67 65 74 73 75 62 74 79 70 65 28 0a 20 20 73 71  getsubtype(.  sq
40b0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63  lite3_context *c
40c0: 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20 61 72  ontext,.  int ar
40d0: 67 63 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61  gc,.  sqlite3_va
40e0: 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20 20  lue **argv.){.  
40f0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69  sqlite3_result_i
4100: 6e 74 28 63 6f 6e 74 65 78 74 2c 20 28 69 6e 74  nt(context, (int
4110: 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 73  )sqlite3_value_s
4120: 75 62 74 79 70 65 28 61 72 67 76 5b 30 5d 29 29  ubtype(argv[0]))
4130: 3b 0a 7d 0a 0a 2f 2a 20 20 20 20 20 20 20 20 20  ;.}../*         
4140: 74 65 73 74 5f 73 65 74 73 75 62 74 79 70 65 28  test_setsubtype(
4150: 56 2c 20 54 29 0a 2a 2a 0a 2a 2a 20 52 65 74 75  V, T).**.** Retu
4160: 72 6e 20 74 68 65 20 76 61 6c 75 65 20 56 20 77  rn the value V w
4170: 69 74 68 20 69 74 73 20 73 75 62 74 79 70 65 20  ith its subtype 
4180: 63 68 61 6e 67 65 64 20 74 6f 20 54 0a 2a 2f 0a  changed to T.*/.
4190: 73 74 61 74 69 63 20 76 6f 69 64 20 74 65 73 74  static void test
41a0: 5f 73 65 74 73 75 62 74 79 70 65 28 0a 20 20 73  _setsubtype(.  s
41b0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
41c0: 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20 61  context,.  int a
41d0: 72 67 63 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  rgc,.  sqlite3_v
41e0: 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20  alue **argv.){. 
41f0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
4200: 76 61 6c 75 65 28 63 6f 6e 74 65 78 74 2c 20 61  value(context, a
4210: 72 67 76 5b 30 5d 29 3b 0a 20 20 73 71 6c 69 74  rgv[0]);.  sqlit
4220: 65 33 5f 72 65 73 75 6c 74 5f 73 75 62 74 79 70  e3_result_subtyp
4230: 65 28 63 6f 6e 74 65 78 74 2c 20 28 75 6e 73 69  e(context, (unsi
4240: 67 6e 65 64 20 69 6e 74 29 73 71 6c 69 74 65 33  gned int)sqlite3
4250: 5f 76 61 6c 75 65 5f 69 6e 74 28 61 72 67 76 5b  _value_int(argv[
4260: 31 5d 29 29 3b 0a 7d 0a 0a 73 74 61 74 69 63 20  1]));.}..static 
4270: 69 6e 74 20 72 65 67 69 73 74 65 72 54 65 73 74  int registerTest
4280: 46 75 6e 63 74 69 6f 6e 73 28 0a 20 20 73 71 6c  Functions(.  sql
4290: 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 68 61 72  ite3 *db,.  char
42a0: 20 2a 2a 70 7a 45 72 72 4d 73 67 2c 0a 20 20 63   **pzErrMsg,.  c
42b0: 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 61 70 69  onst sqlite3_api
42c0: 5f 72 6f 75 74 69 6e 65 73 20 2a 70 54 68 75 6e  _routines *pThun
42d0: 6b 0a 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f  k.){.  static co
42e0: 6e 73 74 20 73 74 72 75 63 74 20 7b 0a 20 20 20  nst struct {.   
42f0: 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 0a 20    char *zName;. 
4300: 20 20 20 20 73 69 67 6e 65 64 20 63 68 61 72 20      signed char 
4310: 6e 41 72 67 3b 0a 20 20 20 20 20 75 6e 73 69 67  nArg;.     unsig
4320: 6e 65 64 20 69 6e 74 20 65 54 65 78 74 52 65 70  ned int eTextRep
4330: 3b 20 2f 2a 20 31 3a 20 55 54 46 2d 31 36 2e 20  ; /* 1: UTF-16. 
4340: 20 30 3a 20 55 54 46 2d 38 20 2a 2f 0a 20 20 20   0: UTF-8 */.   
4350: 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28    void (*xFunc)(
4360: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a  sqlite3_context*
4370: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c  ,int,sqlite3_val
4380: 75 65 20 2a 2a 29 3b 0a 20 20 7d 20 61 46 75 6e  ue **);.  } aFun
4390: 63 73 5b 5d 20 3d 20 7b 0a 20 20 20 20 7b 20 22  cs[] = {.    { "
43a0: 72 61 6e 64 73 74 72 22 2c 20 20 20 20 20 20 20  randstr",       
43b0: 20 20 20 20 20 20 20 20 32 2c 20 53 51 4c 49 54          2, SQLIT
43c0: 45 5f 55 54 46 38 2c 20 72 61 6e 64 53 74 72 20  E_UTF8, randStr 
43d0: 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 74 65 73     },.    { "tes
43e0: 74 5f 64 65 73 74 72 75 63 74 6f 72 22 2c 20 20  t_destructor",  
43f0: 20 20 20 20 20 31 2c 20 53 51 4c 49 54 45 5f 55       1, SQLITE_U
4400: 54 46 38 2c 20 74 65 73 74 5f 64 65 73 74 72 75  TF8, test_destru
4410: 63 74 6f 72 7d 2c 0a 23 69 66 6e 64 65 66 20 53  ctor},.#ifndef S
4420: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
4430: 0a 20 20 20 20 7b 20 22 74 65 73 74 5f 64 65 73  .    { "test_des
4440: 74 72 75 63 74 6f 72 31 36 22 2c 20 20 20 20 20  tructor16",     
4450: 31 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20  1, SQLITE_UTF8, 
4460: 74 65 73 74 5f 64 65 73 74 72 75 63 74 6f 72 31  test_destructor1
4470: 36 7d 2c 0a 20 20 20 20 7b 20 22 68 65 78 5f 74  6},.    { "hex_t
4480: 6f 5f 75 74 66 31 36 62 65 22 2c 20 20 20 20 20  o_utf16be",     
4490: 20 20 20 31 2c 20 53 51 4c 49 54 45 5f 55 54 46     1, SQLITE_UTF
44a0: 38 2c 20 74 65 73 74 48 65 78 54 6f 55 74 66 31  8, testHexToUtf1
44b0: 36 62 65 7d 2c 0a 20 20 20 20 7b 20 22 68 65 78  6be},.    { "hex
44c0: 5f 74 6f 5f 75 74 66 31 36 6c 65 22 2c 20 20 20  _to_utf16le",   
44d0: 20 20 20 20 20 31 2c 20 53 51 4c 49 54 45 5f 55       1, SQLITE_U
44e0: 54 46 38 2c 20 74 65 73 74 48 65 78 54 6f 55 74  TF8, testHexToUt
44f0: 66 31 36 6c 65 7d 2c 0a 23 65 6e 64 69 66 0a 20  f16le},.#endif. 
4500: 20 20 20 7b 20 22 68 65 78 5f 74 6f 5f 75 74 66     { "hex_to_utf
4510: 38 22 2c 20 20 20 20 20 20 20 20 20 20 20 31 2c  8",           1,
4520: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 74 65   SQLITE_UTF8, te
4530: 73 74 48 65 78 54 6f 55 74 66 38 7d 2c 0a 20 20  stHexToUtf8},.  
4540: 20 20 7b 20 22 74 65 73 74 5f 64 65 73 74 72 75    { "test_destru
4550: 63 74 6f 72 5f 63 6f 75 6e 74 22 2c 20 30 2c 20  ctor_count", 0, 
4560: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 74 65 73  SQLITE_UTF8, tes
4570: 74 5f 64 65 73 74 72 75 63 74 6f 72 5f 63 6f 75  t_destructor_cou
4580: 6e 74 7d 2c 0a 20 20 20 20 7b 20 22 74 65 73 74  nt},.    { "test
4590: 5f 61 75 78 64 61 74 61 22 2c 20 20 20 20 20 20  _auxdata",      
45a0: 20 20 20 2d 31 2c 20 53 51 4c 49 54 45 5f 55 54     -1, SQLITE_UT
45b0: 46 38 2c 20 74 65 73 74 5f 61 75 78 64 61 74 61  F8, test_auxdata
45c0: 7d 2c 0a 20 20 20 20 7b 20 22 74 65 73 74 5f 65  },.    { "test_e
45d0: 72 72 6f 72 22 2c 20 20 20 20 20 20 20 20 20 20  rror",          
45e0: 20 20 31 2c 20 53 51 4c 49 54 45 5f 55 54 46 38    1, SQLITE_UTF8
45f0: 2c 20 74 65 73 74 5f 65 72 72 6f 72 7d 2c 0a 20  , test_error},. 
4600: 20 20 20 7b 20 22 74 65 73 74 5f 65 72 72 6f 72     { "test_error
4610: 22 2c 20 20 20 20 20 20 20 20 20 20 20 20 32 2c  ",            2,
4620: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 74 65   SQLITE_UTF8, te
4630: 73 74 5f 65 72 72 6f 72 7d 2c 0a 20 20 20 20 7b  st_error},.    {
4640: 20 22 74 65 73 74 5f 65 76 61 6c 22 2c 20 20 20   "test_eval",   
4650: 20 20 20 20 20 20 20 20 20 20 31 2c 20 53 51 4c            1, SQL
4660: 49 54 45 5f 55 54 46 38 2c 20 74 65 73 74 5f 65  ITE_UTF8, test_e
4670: 76 61 6c 7d 2c 0a 20 20 20 20 7b 20 22 74 65 73  val},.    { "tes
4680: 74 5f 69 73 6f 6c 61 74 69 6f 6e 22 2c 20 20 20  t_isolation",   
4690: 20 20 20 20 20 32 2c 20 53 51 4c 49 54 45 5f 55       2, SQLITE_U
46a0: 54 46 38 2c 20 74 65 73 74 5f 69 73 6f 6c 61 74  TF8, test_isolat
46b0: 69 6f 6e 7d 2c 0a 20 20 20 20 7b 20 22 74 65 73  ion},.    { "tes
46c0: 74 5f 63 6f 75 6e 74 65 72 22 2c 20 20 20 20 20  t_counter",     
46d0: 20 20 20 20 20 31 2c 20 53 51 4c 49 54 45 5f 55       1, SQLITE_U
46e0: 54 46 38 2c 20 63 6f 75 6e 74 65 72 46 75 6e 63  TF8, counterFunc
46f0: 7d 2c 0a 20 20 20 20 7b 20 22 72 65 61 6c 32 68  },.    { "real2h
4700: 65 78 22 2c 20 20 20 20 20 20 20 20 20 20 20 20  ex",            
4710: 20 20 31 2c 20 53 51 4c 49 54 45 5f 55 54 46 38    1, SQLITE_UTF8
4720: 2c 20 72 65 61 6c 32 68 65 78 7d 2c 0a 20 20 20  , real2hex},.   
4730: 20 7b 20 22 74 65 73 74 5f 64 65 63 6f 64 65 22   { "test_decode"
4740: 2c 20 20 20 20 20 20 20 20 20 20 20 31 2c 20 53  ,           1, S
4750: 51 4c 49 54 45 5f 55 54 46 38 2c 20 74 65 73 74  QLITE_UTF8, test
4760: 5f 64 65 63 6f 64 65 7d 2c 0a 20 20 20 20 7b 20  _decode},.    { 
4770: 22 74 65 73 74 5f 65 78 74 72 61 63 74 22 2c 20  "test_extract", 
4780: 20 20 20 20 20 20 20 20 20 32 2c 20 53 51 4c 49           2, SQLI
4790: 54 45 5f 55 54 46 38 2c 20 74 65 73 74 5f 65 78  TE_UTF8, test_ex
47a0: 74 72 61 63 74 7d 2c 0a 20 20 20 20 7b 20 22 74  tract},.    { "t
47b0: 65 73 74 5f 7a 65 72 6f 62 6c 6f 62 22 2c 20 20  est_zeroblob",  
47c0: 31 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 7c 53  1, SQLITE_UTF8|S
47d0: 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53  QLITE_DETERMINIS
47e0: 54 49 43 2c 20 74 65 73 74 5f 7a 65 72 6f 62 6c  TIC, test_zerobl
47f0: 6f 62 7d 2c 0a 20 20 20 20 7b 20 22 74 65 73 74  ob},.    { "test
4800: 5f 67 65 74 73 75 62 74 79 70 65 22 2c 20 20 20  _getsubtype",   
4810: 20 20 20 20 31 2c 20 53 51 4c 49 54 45 5f 55 54      1, SQLITE_UT
4820: 46 38 2c 20 74 65 73 74 5f 67 65 74 73 75 62 74  F8, test_getsubt
4830: 79 70 65 7d 2c 0a 20 20 20 20 7b 20 22 74 65 73  ype},.    { "tes
4840: 74 5f 73 65 74 73 75 62 74 79 70 65 22 2c 20 20  t_setsubtype",  
4850: 20 20 20 20 20 32 2c 20 53 51 4c 49 54 45 5f 55       2, SQLITE_U
4860: 54 46 38 2c 20 74 65 73 74 5f 73 65 74 73 75 62  TF8, test_setsub
4870: 74 79 70 65 7d 2c 0a 20 20 7d 3b 0a 20 20 69 6e  type},.  };.  in
4880: 74 20 69 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b  t i;..  for(i=0;
4890: 20 69 3c 73 69 7a 65 6f 66 28 61 46 75 6e 63 73   i<sizeof(aFuncs
48a0: 29 2f 73 69 7a 65 6f 66 28 61 46 75 6e 63 73 5b  )/sizeof(aFuncs[
48b0: 30 5d 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73  0]); i++){.    s
48c0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75  qlite3_create_fu
48d0: 6e 63 74 69 6f 6e 28 64 62 2c 20 61 46 75 6e 63  nction(db, aFunc
48e0: 73 5b 69 5d 2e 7a 4e 61 6d 65 2c 20 61 46 75 6e  s[i].zName, aFun
48f0: 63 73 5b 69 5d 2e 6e 41 72 67 2c 0a 20 20 20 20  cs[i].nArg,.    
4900: 20 20 20 20 61 46 75 6e 63 73 5b 69 5d 2e 65 54      aFuncs[i].eT
4910: 65 78 74 52 65 70 2c 20 30 2c 20 61 46 75 6e 63  extRep, 0, aFunc
4920: 73 5b 69 5d 2e 78 46 75 6e 63 2c 20 30 2c 20 30  s[i].xFunc, 0, 0
4930: 29 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65  );.  }..  sqlite
4940: 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f  3_create_functio
4950: 6e 28 64 62 2c 20 22 74 65 73 74 5f 61 67 67 5f  n(db, "test_agg_
4960: 65 72 72 6d 73 67 31 36 22 2c 20 30 2c 20 53 51  errmsg16", 0, SQ
4970: 4c 49 54 45 5f 41 4e 59 2c 20 30 2c 20 30 2c 20  LITE_ANY, 0, 0, 
4980: 0a 20 20 20 20 20 20 74 65 73 74 5f 61 67 67 5f  .      test_agg_
4990: 65 72 72 6d 73 67 31 36 5f 73 74 65 70 2c 20 74  errmsg16_step, t
49a0: 65 73 74 5f 61 67 67 5f 65 72 72 6d 73 67 31 36  est_agg_errmsg16
49b0: 5f 66 69 6e 61 6c 29 3b 0a 20 20 20 20 20 20 0a  _final);.      .
49c0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
49d0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 43 4c  OK;.}../*.** TCL
49e0: 43 4d 44 3a 20 20 61 75 74 6f 69 6e 73 74 61 6c  CMD:  autoinstal
49f0: 6c 5f 74 65 73 74 5f 66 75 6e 63 74 69 6f 6e 73  l_test_functions
4a00: 0a 2a 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68  .**.** Invoke th
4a10: 69 73 20 54 43 4c 20 63 6f 6d 6d 61 6e 64 20 74  is TCL command t
4a20: 6f 20 75 73 65 20 73 71 6c 69 74 65 33 5f 61 75  o use sqlite3_au
4a30: 74 6f 5f 65 78 74 65 6e 73 69 6f 6e 28 29 20 74  to_extension() t
4a40: 6f 20 63 61 75 73 65 0a 2a 2a 20 74 68 65 20 73  o cause.** the s
4a50: 74 61 6e 64 61 72 64 20 73 65 74 20 6f 66 20 74  tandard set of t
4a60: 65 73 74 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f  est functions to
4a70: 20 62 65 20 6c 6f 61 64 65 64 20 69 6e 74 6f 20   be loaded into 
4a80: 65 61 63 68 20 6e 65 77 0a 2a 2a 20 64 61 74 61  each new.** data
4a90: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e  base connection.
4aa0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53  .*/.static int S
4ab0: 51 4c 49 54 45 5f 54 43 4c 41 50 49 20 61 75 74  QLITE_TCLAPI aut
4ac0: 6f 69 6e 73 74 61 6c 6c 5f 74 65 73 74 5f 66 75  oinstall_test_fu
4ad0: 6e 63 73 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c  ncs(.  void * cl
4ae0: 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c 5f  ientData,.  Tcl_
4af0: 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a  Interp *interp,.
4b00: 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63    int objc,.  Tc
4b10: 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a  l_Obj *CONST obj
4b20: 76 5b 5d 0a 29 7b 0a 20 20 65 78 74 65 72 6e 20  v[].){.  extern 
4b30: 69 6e 74 20 4d 64 35 5f 52 65 67 69 73 74 65 72  int Md5_Register
4b40: 28 73 71 6c 69 74 65 33 20 2a 2c 20 63 68 61 72  (sqlite3 *, char
4b50: 20 2a 2a 2c 20 63 6f 6e 73 74 20 73 71 6c 69 74   **, const sqlit
4b60: 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65 73 20  e3_api_routines 
4b70: 2a 29 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 73  *);.  int rc = s
4b80: 71 6c 69 74 65 33 5f 61 75 74 6f 5f 65 78 74 65  qlite3_auto_exte
4b90: 6e 73 69 6f 6e 28 28 76 6f 69 64 28 2a 29 28 76  nsion((void(*)(v
4ba0: 6f 69 64 29 29 72 65 67 69 73 74 65 72 54 65 73  oid))registerTes
4bb0: 74 46 75 6e 63 74 69 6f 6e 73 29 3b 0a 20 20 69  tFunctions);.  i
4bc0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
4bd0: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
4be0: 69 74 65 33 5f 61 75 74 6f 5f 65 78 74 65 6e 73  ite3_auto_extens
4bf0: 69 6f 6e 28 28 76 6f 69 64 28 2a 29 28 76 6f 69  ion((void(*)(voi
4c00: 64 29 29 4d 64 35 5f 52 65 67 69 73 74 65 72 29  d))Md5_Register)
4c10: 3b 0a 20 20 7d 0a 20 20 54 63 6c 5f 53 65 74 4f  ;.  }.  Tcl_SetO
4c20: 62 6a 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c  bjResult(interp,
4c30: 20 54 63 6c 5f 4e 65 77 49 6e 74 4f 62 6a 28 72   Tcl_NewIntObj(r
4c40: 63 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 54 43  c));.  return TC
4c50: 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  L_OK;.}../*.** A
4c60: 20 62 6f 67 75 73 20 73 74 65 70 20 66 75 6e 63   bogus step func
4c70: 74 69 6f 6e 20 61 6e 64 20 66 69 6e 61 6c 69 7a  tion and finaliz
4c80: 65 72 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a  er function..*/.
4c90: 73 74 61 74 69 63 20 76 6f 69 64 20 74 53 74 65  static void tSte
4ca0: 70 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  p(sqlite3_contex
4cb0: 74 20 2a 61 2c 20 69 6e 74 20 62 2c 20 73 71 6c  t *a, int b, sql
4cc0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 63 29 7b  ite3_value **c){
4cd0: 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74 46  }.static void tF
4ce0: 69 6e 61 6c 28 73 71 6c 69 74 65 33 5f 63 6f 6e  inal(sqlite3_con
4cf0: 74 65 78 74 20 2a 61 29 7b 7d 0a 0a 0a 2f 2a 0a  text *a){}.../*.
4d00: 2a 2a 20 74 63 6c 63 6d 64 3a 20 20 61 62 75 73  ** tclcmd:  abus
4d10: 65 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f  e_create_functio
4d20: 6e 0a 2a 2a 0a 2a 2a 20 4d 61 6b 65 20 76 61 72  n.**.** Make var
4d30: 69 6f 75 73 20 63 61 6c 6c 73 20 74 6f 20 73 71  ious calls to sq
4d40: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e  lite3_create_fun
4d50: 63 74 69 6f 6e 20 74 68 61 74 20 64 6f 20 6e 6f  ction that do no
4d60: 74 20 68 61 76 65 20 76 61 6c 69 64 0a 2a 2a 20  t have valid.** 
4d70: 70 61 72 61 6d 65 74 65 72 73 2e 20 20 56 65 72  parameters.  Ver
4d80: 69 66 79 20 74 68 61 74 20 74 68 65 20 65 72 72  ify that the err
4d90: 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20  or condition is 
4da0: 64 65 74 65 63 74 65 64 20 61 6e 64 20 72 65 70  detected and rep
4db0: 6f 72 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  orted..*/.static
4dc0: 20 69 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41   int SQLITE_TCLA
4dd0: 50 49 20 61 62 75 73 65 5f 63 72 65 61 74 65 5f  PI abuse_create_
4de0: 66 75 6e 63 74 69 6f 6e 28 0a 20 20 76 6f 69 64  function(.  void
4df0: 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20   * clientData,. 
4e00: 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74   Tcl_Interp *int
4e10: 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c  erp,.  int objc,
4e20: 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53  .  Tcl_Obj *CONS
4e30: 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 65 78  T objv[].){.  ex
4e40: 74 65 72 6e 20 69 6e 74 20 67 65 74 44 62 50 6f  tern int getDbPo
4e50: 69 6e 74 65 72 28 54 63 6c 5f 49 6e 74 65 72 70  inter(Tcl_Interp
4e60: 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20  *, const char*, 
4e70: 73 71 6c 69 74 65 33 2a 2a 29 3b 0a 20 20 73 71  sqlite3**);.  sq
4e80: 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 69 6e 74  lite3 *db;.  int
4e90: 20 72 63 3b 0a 20 20 69 6e 74 20 6d 78 41 72 67   rc;.  int mxArg
4ea0: 3b 0a 0a 20 20 69 66 28 20 67 65 74 44 62 50 6f  ;..  if( getDbPo
4eb0: 69 6e 74 65 72 28 69 6e 74 65 72 70 2c 20 54 63  inter(interp, Tc
4ec0: 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76  l_GetString(objv
4ed0: 5b 31 5d 29 2c 20 26 64 62 29 20 29 20 72 65 74  [1]), &db) ) ret
4ee0: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 0a  urn TCL_ERROR;..
4ef0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63    rc = sqlite3_c
4f00: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64  reate_function(d
4f10: 62 2c 20 22 74 78 22 2c 20 31 2c 20 53 51 4c 49  b, "tx", 1, SQLI
4f20: 54 45 5f 55 54 46 38 2c 20 30 2c 20 74 53 74 65  TE_UTF8, 0, tSte
4f30: 70 2c 74 53 74 65 70 2c 74 46 69 6e 61 6c 29 3b  p,tStep,tFinal);
4f40: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  .  if( rc!=SQLIT
4f50: 45 5f 4d 49 53 55 53 45 20 29 20 67 6f 74 6f 20  E_MISUSE ) goto 
4f60: 61 62 75 73 65 5f 65 72 72 3b 0a 0a 20 20 72 63  abuse_err;..  rc
4f70: 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74   = sqlite3_creat
4f80: 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 22  e_function(db, "
4f90: 74 78 22 2c 20 31 2c 20 53 51 4c 49 54 45 5f 55  tx", 1, SQLITE_U
4fa0: 54 46 38 2c 20 30 2c 20 74 53 74 65 70 2c 20 74  TF8, 0, tStep, t
4fb0: 53 74 65 70 2c 20 30 29 3b 0a 20 20 69 66 28 20  Step, 0);.  if( 
4fc0: 72 63 21 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53  rc!=SQLITE_MISUS
4fd0: 45 20 29 20 67 6f 74 6f 20 61 62 75 73 65 5f 65  E ) goto abuse_e
4fe0: 72 72 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69  rr;..  rc = sqli
4ff0: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74  te3_create_funct
5000: 69 6f 6e 28 64 62 2c 20 22 74 78 22 2c 20 31 2c  ion(db, "tx", 1,
5010: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c   SQLITE_UTF8, 0,
5020: 20 74 53 74 65 70 2c 20 30 2c 20 74 46 69 6e 61   tStep, 0, tFina
5030: 6c 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51  l);.  if( rc!=SQ
5040: 4c 49 54 45 5f 4d 49 53 55 53 45 29 20 67 6f 74  LITE_MISUSE) got
5050: 6f 20 61 62 75 73 65 5f 65 72 72 3b 0a 0a 20 20  o abuse_err;..  
5060: 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72 65  rc = sqlite3_cre
5070: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c  ate_function(db,
5080: 20 22 74 78 22 2c 20 31 2c 20 53 51 4c 49 54 45   "tx", 1, SQLITE
5090: 5f 55 54 46 38 2c 20 30 2c 20 30 2c 20 30 2c 20  _UTF8, 0, 0, 0, 
50a0: 74 46 69 6e 61 6c 29 3b 0a 20 20 69 66 28 20 72  tFinal);.  if( r
50b0: 63 21 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  c!=SQLITE_MISUSE
50c0: 20 29 20 67 6f 74 6f 20 61 62 75 73 65 5f 65 72   ) goto abuse_er
50d0: 72 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  r;..  rc = sqlit
50e0: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69  e3_create_functi
50f0: 6f 6e 28 64 62 2c 20 22 74 78 22 2c 20 31 2c 20  on(db, "tx", 1, 
5100: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 20  SQLITE_UTF8, 0, 
5110: 30 2c 20 74 53 74 65 70 2c 20 30 29 3b 0a 20 20  0, tStep, 0);.  
5120: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4d  if( rc!=SQLITE_M
5130: 49 53 55 53 45 20 29 20 67 6f 74 6f 20 61 62 75  ISUSE ) goto abu
5140: 73 65 5f 65 72 72 3b 0a 0a 20 20 72 63 20 3d 20  se_err;..  rc = 
5150: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66  sqlite3_create_f
5160: 75 6e 63 74 69 6f 6e 28 64 62 2c 20 22 74 78 22  unction(db, "tx"
5170: 2c 20 2d 32 2c 20 53 51 4c 49 54 45 5f 55 54 46  , -2, SQLITE_UTF
5180: 38 2c 20 30 2c 20 74 53 74 65 70 2c 20 30 2c 20  8, 0, tStep, 0, 
5190: 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51  0);.  if( rc!=SQ
51a0: 4c 49 54 45 5f 4d 49 53 55 53 45 20 29 20 67 6f  LITE_MISUSE ) go
51b0: 74 6f 20 61 62 75 73 65 5f 65 72 72 3b 0a 0a 20  to abuse_err;.. 
51c0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 72   rc = sqlite3_cr
51d0: 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62  eate_function(db
51e0: 2c 20 22 74 78 22 2c 20 31 32 38 2c 20 53 51 4c  , "tx", 128, SQL
51f0: 49 54 45 5f 55 54 46 38 2c 20 30 2c 20 74 53 74  ITE_UTF8, 0, tSt
5200: 65 70 2c 20 30 2c 20 30 29 3b 0a 20 20 69 66 28  ep, 0, 0);.  if(
5210: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4d 49 53 55   rc!=SQLITE_MISU
5220: 53 45 20 29 20 67 6f 74 6f 20 61 62 75 73 65 5f  SE ) goto abuse_
5230: 65 72 72 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c  err;..  rc = sql
5240: 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63  ite3_create_func
5250: 74 69 6f 6e 28 64 62 2c 20 22 66 75 6e 63 78 78  tion(db, "funcxx
5260: 22 0a 20 20 20 20 20 20 20 22 5f 31 32 33 34 35  ".       "_12345
5270: 36 37 38 39 5f 31 32 33 34 35 36 37 38 39 5f 31  6789_123456789_1
5280: 32 33 34 35 36 37 38 39 5f 31 32 33 34 35 36 37  23456789_1234567
5290: 38 39 5f 31 32 33 34 35 36 37 38 39 22 0a 20 20  89_123456789".  
52a0: 20 20 20 20 20 22 5f 31 32 33 34 35 36 37 38 39       "_123456789
52b0: 5f 31 32 33 34 35 36 37 38 39 5f 31 32 33 34 35  _123456789_12345
52c0: 36 37 38 39 5f 31 32 33 34 35 36 37 38 39 5f 31  6789_123456789_1
52d0: 32 33 34 35 36 37 38 39 22 0a 20 20 20 20 20 20  23456789".      
52e0: 20 22 5f 31 32 33 34 35 36 37 38 39 5f 31 32 33   "_123456789_123
52f0: 34 35 36 37 38 39 5f 31 32 33 34 35 36 37 38 39  456789_123456789
5300: 5f 31 32 33 34 35 36 37 38 39 5f 31 32 33 34 35  _123456789_12345
5310: 36 37 38 39 22 0a 20 20 20 20 20 20 20 22 5f 31  6789".       "_1
5320: 32 33 34 35 36 37 38 39 5f 31 32 33 34 35 36 37  23456789_1234567
5330: 38 39 5f 31 32 33 34 35 36 37 38 39 5f 31 32 33  89_123456789_123
5340: 34 35 36 37 38 39 5f 31 32 33 34 35 36 37 38 39  456789_123456789
5350: 22 0a 20 20 20 20 20 20 20 22 5f 31 32 33 34 35  ".       "_12345
5360: 36 37 38 39 5f 31 32 33 34 35 36 37 38 39 5f 31  6789_123456789_1
5370: 32 33 34 35 36 37 38 39 5f 31 32 33 34 35 36 37  23456789_1234567
5380: 38 39 5f 31 32 33 34 35 36 37 38 39 22 2c 0a 20  89_123456789",. 
5390: 20 20 20 20 20 20 31 2c 20 53 51 4c 49 54 45 5f        1, SQLITE_
53a0: 55 54 46 38 2c 20 30 2c 20 74 53 74 65 70 2c 20  UTF8, 0, tStep, 
53b0: 30 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21  0, 0);.  if( rc!
53c0: 3d 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 29  =SQLITE_MISUSE )
53d0: 20 67 6f 74 6f 20 61 62 75 73 65 5f 65 72 72 3b   goto abuse_err;
53e0: 0a 0a 20 20 2f 2a 20 54 68 69 73 20 6c 61 73 74  ..  /* This last
53f0: 20 66 75 6e 63 74 69 6f 6e 20 72 65 67 69 73 74   function regist
5400: 72 61 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 63  ration should ac
5410: 74 75 61 6c 6c 79 20 77 6f 72 6b 2e 20 20 47 65  tually work.  Ge
5420: 6e 65 72 61 74 65 0a 20 20 2a 2a 20 61 20 6e 6f  nerate.  ** a no
5430: 2d 6f 70 20 66 75 6e 63 74 69 6f 6e 20 28 74 68  -op function (th
5440: 61 74 20 61 6c 77 61 79 73 20 72 65 74 75 72 6e  at always return
5450: 73 20 4e 55 4c 4c 29 20 61 6e 64 20 77 68 69 63  s NULL) and whic
5460: 68 20 68 61 73 20 74 68 65 0a 20 20 2a 2a 20 6d  h has the.  ** m
5470: 61 78 69 6d 75 6d 2d 6c 65 6e 67 74 68 20 66 75  aximum-length fu
5480: 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 61 6e 64 20  nction name and 
5490: 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62  the maximum numb
54a0: 65 72 20 6f 66 20 70 61 72 61 6d 65 74 65 72 73  er of parameters
54b0: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ..  */.  sqlite3
54c0: 5f 6c 69 6d 69 74 28 64 62 2c 20 53 51 4c 49 54  _limit(db, SQLIT
54d0: 45 5f 4c 49 4d 49 54 5f 46 55 4e 43 54 49 4f 4e  E_LIMIT_FUNCTION
54e0: 5f 41 52 47 2c 20 31 30 30 30 30 29 3b 0a 20 20  _ARG, 10000);.  
54f0: 6d 78 41 72 67 20 3d 20 73 71 6c 69 74 65 33 5f  mxArg = sqlite3_
5500: 6c 69 6d 69 74 28 64 62 2c 20 53 51 4c 49 54 45  limit(db, SQLITE
5510: 5f 4c 49 4d 49 54 5f 46 55 4e 43 54 49 4f 4e 5f  _LIMIT_FUNCTION_
5520: 41 52 47 2c 20 2d 31 29 3b 0a 20 20 72 63 20 3d  ARG, -1);.  rc =
5530: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f   sqlite3_create_
5540: 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 22 6e 75  function(db, "nu
5550: 6c 6c 78 22 0a 20 20 20 20 20 20 20 22 5f 31 32  llx".       "_12
5560: 33 34 35 36 37 38 39 5f 31 32 33 34 35 36 37 38  3456789_12345678
5570: 39 5f 31 32 33 34 35 36 37 38 39 5f 31 32 33 34  9_123456789_1234
5580: 35 36 37 38 39 5f 31 32 33 34 35 36 37 38 39 22  56789_123456789"
5590: 0a 20 20 20 20 20 20 20 22 5f 31 32 33 34 35 36  .       "_123456
55a0: 37 38 39 5f 31 32 33 34 35 36 37 38 39 5f 31 32  789_123456789_12
55b0: 33 34 35 36 37 38 39 5f 31 32 33 34 35 36 37 38  3456789_12345678
55c0: 39 5f 31 32 33 34 35 36 37 38 39 22 0a 20 20 20  9_123456789".   
55d0: 20 20 20 20 22 5f 31 32 33 34 35 36 37 38 39 5f      "_123456789_
55e0: 31 32 33 34 35 36 37 38 39 5f 31 32 33 34 35 36  123456789_123456
55f0: 37 38 39 5f 31 32 33 34 35 36 37 38 39 5f 31 32  789_123456789_12
5600: 33 34 35 36 37 38 39 22 0a 20 20 20 20 20 20 20  3456789".       
5610: 22 5f 31 32 33 34 35 36 37 38 39 5f 31 32 33 34  "_123456789_1234
5620: 35 36 37 38 39 5f 31 32 33 34 35 36 37 38 39 5f  56789_123456789_
5630: 31 32 33 34 35 36 37 38 39 5f 31 32 33 34 35 36  123456789_123456
5640: 37 38 39 22 0a 20 20 20 20 20 20 20 22 5f 31 32  789".       "_12
5650: 33 34 35 36 37 38 39 5f 31 32 33 34 35 36 37 38  3456789_12345678
5660: 39 5f 31 32 33 34 35 36 37 38 39 5f 31 32 33 34  9_123456789_1234
5670: 35 36 37 38 39 5f 31 32 33 34 35 36 37 38 39 22  56789_123456789"
5680: 2c 0a 20 20 20 20 20 20 20 6d 78 41 72 67 2c 20  ,.       mxArg, 
5690: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 20  SQLITE_UTF8, 0, 
56a0: 74 53 74 65 70 2c 20 30 2c 20 30 29 3b 0a 20 20  tStep, 0, 0);.  
56b0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
56c0: 4b 20 29 20 67 6f 74 6f 20 61 62 75 73 65 5f 65  K ) goto abuse_e
56d0: 72 72 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  rr;.            
56e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
56f0: 20 20 20 20 0a 20 20 72 65 74 75 72 6e 20 54 43      .  return TC
5700: 4c 5f 4f 4b 3b 0a 0a 61 62 75 73 65 5f 65 72 72  L_OK;..abuse_err
5710: 3a 0a 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65  :.  Tcl_AppendRe
5720: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 22 73 71  sult(interp, "sq
5730: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e  lite3_create_fun
5740: 63 74 69 6f 6e 20 61 62 75 73 65 64 20 74 65 73  ction abused tes
5750: 74 20 66 61 69 6c 65 64 22 2c 20 0a 20 20 20 20  t failed", .    
5760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28                 (
5770: 63 68 61 72 2a 29 30 29 3b 0a 20 20 72 65 74 75  char*)0);.  retu
5780: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 7d 0a  rn TCL_ERROR;.}.
5790: 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 75  ../*.** SQLite u
57a0: 73 65 72 20 64 65 66 69 6e 65 64 20 66 75 6e 63  ser defined func
57b0: 74 69 6f 6e 20 74 6f 20 75 73 65 20 77 69 74 68  tion to use with
57c0: 20 6d 61 74 63 68 69 6e 66 6f 28 29 20 74 6f 20   matchinfo() to 
57d0: 63 61 6c 63 75 6c 61 74 65 20 74 68 65 0a 2a 2a  calculate the.**
57e0: 20 72 65 6c 65 76 61 6e 63 79 20 6f 66 20 61 6e   relevancy of an
57f0: 20 46 54 53 20 6d 61 74 63 68 2e 20 54 68 65 20   FTS match. The 
5800: 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 69  value returned i
5810: 73 20 74 68 65 20 72 65 6c 65 76 61 6e 63 79 20  s the relevancy 
5820: 73 63 6f 72 65 0a 2a 2a 20 28 61 20 72 65 61 6c  score.** (a real
5830: 20 76 61 6c 75 65 20 67 72 65 61 74 65 72 20 74   value greater t
5840: 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20  han or equal to 
5850: 7a 65 72 6f 29 2e 20 41 20 6c 61 72 67 65 72 20  zero). A larger 
5860: 76 61 6c 75 65 20 69 6e 64 69 63 61 74 65 73 20  value indicates 
5870: 0a 2a 2a 20 61 20 6d 6f 72 65 20 72 65 6c 65 76  .** a more relev
5880: 61 6e 74 20 64 6f 63 75 6d 65 6e 74 2e 0a 2a 2a  ant document..**
5890: 0a 2a 2a 20 54 68 65 20 6f 76 65 72 61 6c 6c 20  .** The overall 
58a0: 72 65 6c 65 76 61 6e 63 79 20 72 65 74 75 72 6e  relevancy return
58b0: 65 64 20 69 73 20 74 68 65 20 73 75 6d 20 6f 66  ed is the sum of
58c0: 20 74 68 65 20 72 65 6c 65 76 61 6e 63 69 65 73   the relevancies
58d0: 20 6f 66 20 65 61 63 68 20 0a 2a 2a 20 63 6f 6c   of each .** col
58e0: 75 6d 6e 20 76 61 6c 75 65 20 69 6e 20 74 68 65  umn value in the
58f0: 20 46 54 53 20 74 61 62 6c 65 2e 20 54 68 65 20   FTS table. The 
5900: 72 65 6c 65 76 61 6e 63 79 20 6f 66 20 61 20 63  relevancy of a c
5910: 6f 6c 75 6d 6e 20 76 61 6c 75 65 20 69 73 20 74  olumn value is t
5920: 68 65 0a 2a 2a 20 73 75 6d 20 6f 66 20 74 68 65  he.** sum of the
5930: 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6f 72 20 65   following for e
5940: 61 63 68 20 72 65 70 6f 72 74 61 62 6c 65 20 70  ach reportable p
5950: 68 72 61 73 65 20 69 6e 20 74 68 65 20 46 54 53  hrase in the FTS
5960: 20 71 75 65 72 79 3a 0a 2a 2a 0a 2a 2a 20 20 20   query:.**.**   
5970: 28 3c 68 69 74 20 63 6f 75 6e 74 3e 20 2f 20 3c  (<hit count> / <
5980: 67 6c 6f 62 61 6c 20 68 69 74 20 63 6f 75 6e 74  global hit count
5990: 3e 29 20 2a 20 3c 63 6f 6c 75 6d 6e 20 77 65 69  >) * <column wei
59a0: 67 68 74 3e 0a 2a 2a 0a 2a 2a 20 77 68 65 72 65  ght>.**.** where
59b0: 20 3c 68 69 74 20 63 6f 75 6e 74 3e 20 69 73 20   <hit count> is 
59c0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e  the number of in
59d0: 73 74 61 6e 63 65 73 20 6f 66 20 74 68 65 20 70  stances of the p
59e0: 68 72 61 73 65 20 69 6e 20 74 68 65 0a 2a 2a 20  hrase in the.** 
59f0: 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 20 6f 66 20  column value of 
5a00: 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77 20  the current row 
5a10: 61 6e 64 20 3c 67 6c 6f 62 61 6c 20 68 69 74 20  and <global hit 
5a20: 63 6f 75 6e 74 3e 20 69 73 20 74 68 65 20 6e 75  count> is the nu
5a30: 6d 62 65 72 0a 2a 2a 20 6f 66 20 69 6e 73 74 61  mber.** of insta
5a40: 6e 63 65 73 20 6f 66 20 74 68 65 20 70 68 72 61  nces of the phra
5a50: 73 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20 63  se in the same c
5a60: 6f 6c 75 6d 6e 20 6f 66 20 61 6c 6c 20 72 6f 77  olumn of all row
5a70: 73 20 69 6e 20 74 68 65 20 46 54 53 0a 2a 2a 20  s in the FTS.** 
5a80: 74 61 62 6c 65 2e 20 54 68 65 20 3c 63 6f 6c 75  table. The <colu
5a90: 6d 6e 20 77 65 69 67 68 74 3e 20 69 73 20 61 20  mn weight> is a 
5aa0: 77 65 69 67 68 74 69 6e 67 20 66 61 63 74 6f 72  weighting factor
5ab0: 20 61 73 73 69 67 6e 65 64 20 74 6f 20 65 61 63   assigned to eac
5ac0: 68 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 62 79 20 74  h.** column by t
5ad0: 68 65 20 63 61 6c 6c 65 72 20 28 73 65 65 20 62  he caller (see b
5ae0: 65 6c 6f 77 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  elow)..**.** The
5af0: 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20   first argument 
5b00: 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  to this function
5b10: 20 6d 75 73 74 20 62 65 20 74 68 65 20 72 65 74   must be the ret
5b20: 75 72 6e 20 76 61 6c 75 65 20 6f 66 20 74 68 65  urn value of the
5b30: 20 46 54 53 20 0a 2a 2a 20 6d 61 74 63 68 69 6e   FTS .** matchin
5b40: 66 6f 28 29 20 66 75 6e 63 74 69 6f 6e 2e 20 46  fo() function. F
5b50: 6f 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 6d 75  ollowing this mu
5b60: 73 74 20 62 65 20 6f 6e 65 20 61 72 67 75 6d 65  st be one argume
5b70: 6e 74 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75  nt for each colu
5b80: 6d 6e 20 0a 2a 2a 20 6f 66 20 74 68 65 20 46 54  mn .** of the FT
5b90: 53 20 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 69  S table containi
5ba0: 6e 67 20 61 20 6e 75 6d 65 72 69 63 20 77 65 69  ng a numeric wei
5bb0: 67 68 74 20 66 61 63 74 6f 72 20 66 6f 72 20 74  ght factor for t
5bc0: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  he corresponding
5bd0: 20 0a 2a 2a 20 63 6f 6c 75 6d 6e 2e 20 45 78 61   .** column. Exa
5be0: 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  mple:.**.**     
5bf0: 43 52 45 41 54 45 20 56 49 52 54 55 41 4c 20 54  CREATE VIRTUAL T
5c00: 41 42 4c 45 20 64 6f 63 75 6d 65 6e 74 73 20 55  ABLE documents U
5c10: 53 49 4e 47 20 66 74 73 33 28 74 69 74 6c 65 2c  SING fts3(title,
5c20: 20 63 6f 6e 74 65 6e 74 29 0a 2a 2a 0a 2a 2a 20   content).**.** 
5c30: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 71 75  The following qu
5c40: 65 72 79 20 72 65 74 75 72 6e 73 20 74 68 65 20  ery returns the 
5c50: 64 6f 63 69 64 73 20 6f 66 20 64 6f 63 75 6d 65  docids of docume
5c60: 6e 74 73 20 74 68 61 74 20 6d 61 74 63 68 20 74  nts that match t
5c70: 68 65 20 66 75 6c 6c 2d 74 65 78 74 0a 2a 2a 20  he full-text.** 
5c80: 71 75 65 72 79 20 3c 71 75 65 72 79 3e 20 73 6f  query <query> so
5c90: 72 74 65 64 20 66 72 6f 6d 20 6d 6f 73 74 20 74  rted from most t
5ca0: 6f 20 6c 65 61 73 74 20 72 65 6c 65 76 61 6e 74  o least relevant
5cb0: 2e 20 57 68 65 6e 20 63 61 6c 63 75 6c 61 74 69  . When calculati
5cc0: 6e 67 0a 2a 2a 20 72 65 6c 65 76 61 6e 63 65 2c  ng.** relevance,
5cd0: 20 71 75 65 72 79 20 74 65 72 6d 20 69 6e 73 74   query term inst
5ce0: 61 6e 63 65 73 20 69 6e 20 74 68 65 20 27 74 69  ances in the 'ti
5cf0: 74 6c 65 27 20 63 6f 6c 75 6d 6e 20 61 72 65 20  tle' column are 
5d00: 67 69 76 65 6e 20 74 77 69 63 65 20 74 68 65 0a  given twice the.
5d10: 2a 2a 20 77 65 69 67 68 74 69 6e 67 20 6f 66 20  ** weighting of 
5d20: 74 68 6f 73 65 20 69 6e 20 74 68 65 20 27 63 6f  those in the 'co
5d30: 6e 74 65 6e 74 27 20 63 6f 6c 75 6d 6e 2e 0a 2a  ntent' column..*
5d40: 2a 0a 2a 2a 20 20 20 20 20 53 45 4c 45 43 54 20  *.**     SELECT 
5d50: 64 6f 63 69 64 20 46 52 4f 4d 20 64 6f 63 75 6d  docid FROM docum
5d60: 65 6e 74 73 20 0a 2a 2a 20 20 20 20 20 57 48 45  ents .**     WHE
5d70: 52 45 20 64 6f 63 75 6d 65 6e 74 73 20 4d 41 54  RE documents MAT
5d80: 43 48 20 3c 71 75 65 72 79 3e 20 0a 2a 2a 20 20  CH <query> .**  
5d90: 20 20 20 4f 52 44 45 52 20 42 59 20 72 61 6e 6b     ORDER BY rank
5da0: 28 6d 61 74 63 68 69 6e 66 6f 28 64 6f 63 75 6d  (matchinfo(docum
5db0: 65 6e 74 73 29 2c 20 31 2e 30 2c 20 30 2e 35 29  ents), 1.0, 0.5)
5dc0: 20 44 45 53 43 0a 2a 2f 0a 73 74 61 74 69 63 20   DESC.*/.static 
5dd0: 76 6f 69 64 20 72 61 6e 6b 66 75 6e 63 28 73 71  void rankfunc(sq
5de0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
5df0: 43 74 78 2c 20 69 6e 74 20 6e 56 61 6c 2c 20 73  Ctx, int nVal, s
5e00: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61  qlite3_value **a
5e10: 70 56 61 6c 29 7b 0a 20 20 69 6e 74 20 2a 61 4d  pVal){.  int *aM
5e20: 61 74 63 68 69 6e 66 6f 3b 20 20 20 20 20 20 20  atchinfo;       
5e30: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75           /* Retu
5e40: 72 6e 20 76 61 6c 75 65 20 6f 66 20 6d 61 74 63  rn value of matc
5e50: 68 69 6e 66 6f 28 29 20 2a 2f 0a 20 20 69 6e 74  hinfo() */.  int
5e60: 20 6e 4d 61 74 63 68 69 6e 66 6f 3b 20 20 20 20   nMatchinfo;    
5e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5e80: 4e 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e  Number of elemen
5e90: 74 73 20 69 6e 20 61 4d 61 74 63 68 69 6e 66 6f  ts in aMatchinfo
5ea0: 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 6f 6c  [] */.  int nCol
5eb0: 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20   = 0;           
5ec0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
5ed0: 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20  r of columns in 
5ee0: 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69  the table */.  i
5ef0: 6e 74 20 6e 50 68 72 61 73 65 20 3d 20 30 3b 20  nt nPhrase = 0; 
5f00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5f10: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 68 72 61  * Number of phra
5f20: 73 65 73 20 69 6e 20 74 68 65 20 71 75 65 72 79  ses in the query
5f30: 20 2a 2f 0a 20 20 69 6e 74 20 69 50 68 72 61 73   */.  int iPhras
5f40: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
5f50: 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74        /* Current
5f60: 20 70 68 72 61 73 65 20 2a 2f 0a 20 20 64 6f 75   phrase */.  dou
5f70: 62 6c 65 20 73 63 6f 72 65 20 3d 20 30 2e 30 3b  ble score = 0.0;
5f80: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5f90: 56 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20  Value to return 
5fa0: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 69  */..  assert( si
5fb0: 7a 65 6f 66 28 69 6e 74 29 3d 3d 34 20 29 3b 0a  zeof(int)==4 );.
5fc0: 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 68 61 74  .  /* Check that
5fd0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 61   the number of a
5fe0: 72 67 75 6d 65 6e 74 73 20 70 61 73 73 65 64 20  rguments passed 
5ff0: 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  to this function
6000: 20 69 73 20 63 6f 72 72 65 63 74 2e 0a 20 20 2a   is correct..  *
6010: 2a 20 49 66 20 6e 6f 74 2c 20 6a 75 6d 70 20 74  * If not, jump t
6020: 6f 20 77 72 6f 6e 67 5f 6e 75 6d 62 65 72 5f 61  o wrong_number_a
6030: 72 67 73 2e 20 53 65 74 20 61 4d 61 74 63 68 69  rgs. Set aMatchi
6040: 6e 66 6f 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20  nfo to point to 
6050: 74 68 65 20 61 72 72 61 79 0a 20 20 2a 2a 20 6f  the array.  ** o
6060: 66 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67  f unsigned integ
6070: 65 72 20 76 61 6c 75 65 73 20 72 65 74 75 72 6e  er values return
6080: 65 64 20 62 79 20 46 54 53 20 66 75 6e 63 74 69  ed by FTS functi
6090: 6f 6e 20 6d 61 74 63 68 69 6e 66 6f 2e 20 53 65  on matchinfo. Se
60a0: 74 0a 20 20 2a 2a 20 6e 50 68 72 61 73 65 20 74  t.  ** nPhrase t
60b0: 6f 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 6e 75  o contain the nu
60c0: 6d 62 65 72 20 6f 66 20 72 65 70 6f 72 74 61 62  mber of reportab
60d0: 6c 65 20 70 68 72 61 73 65 73 20 69 6e 20 74 68  le phrases in th
60e0: 65 20 75 73 65 72 73 20 66 75 6c 6c 2d 74 65 78  e users full-tex
60f0: 74 0a 20 20 2a 2a 20 71 75 65 72 79 2c 20 61 6e  t.  ** query, an
6100: 64 20 6e 43 6f 6c 20 74 6f 20 74 68 65 20 6e 75  d nCol to the nu
6110: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
6120: 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 20 54 68  in the table. Th
6130: 65 6e 20 63 68 65 63 6b 20 74 68 61 74 20 74 68  en check that th
6140: 65 0a 20 20 2a 2a 20 73 69 7a 65 20 6f 66 20 74  e.  ** size of t
6150: 68 65 20 6d 61 74 63 68 69 6e 66 6f 20 62 6c 6f  he matchinfo blo
6160: 62 20 69 73 20 61 73 20 65 78 70 65 63 74 65 64  b is as expected
6170: 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72 6f  . Return an erro
6180: 72 20 69 66 20 69 74 20 69 73 20 6e 6f 74 2e 0a  r if it is not..
6190: 20 20 2a 2f 0a 20 20 69 66 28 20 6e 56 61 6c 3c    */.  if( nVal<
61a0: 31 20 29 20 67 6f 74 6f 20 77 72 6f 6e 67 5f 6e  1 ) goto wrong_n
61b0: 75 6d 62 65 72 5f 61 72 67 73 3b 0a 20 20 61 4d  umber_args;.  aM
61c0: 61 74 63 68 69 6e 66 6f 20 3d 20 28 75 6e 73 69  atchinfo = (unsi
61d0: 67 6e 65 64 20 69 6e 74 20 2a 29 73 71 6c 69 74  gned int *)sqlit
61e0: 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 61 70  e3_value_blob(ap
61f0: 56 61 6c 5b 30 5d 29 3b 0a 20 20 6e 4d 61 74 63  Val[0]);.  nMatc
6200: 68 69 6e 66 6f 20 3d 20 73 71 6c 69 74 65 33 5f  hinfo = sqlite3_
6210: 76 61 6c 75 65 5f 62 79 74 65 73 28 61 70 56 61  value_bytes(apVa
6220: 6c 5b 30 5d 29 20 2f 20 73 69 7a 65 6f 66 28 69  l[0]) / sizeof(i
6230: 6e 74 29 3b 0a 20 20 69 66 28 20 6e 4d 61 74 63  nt);.  if( nMatc
6240: 68 69 6e 66 6f 3e 3d 32 20 29 7b 0a 20 20 20 20  hinfo>=2 ){.    
6250: 6e 50 68 72 61 73 65 20 3d 20 61 4d 61 74 63 68  nPhrase = aMatch
6260: 69 6e 66 6f 5b 30 5d 3b 0a 20 20 20 20 6e 43 6f  info[0];.    nCo
6270: 6c 20 3d 20 61 4d 61 74 63 68 69 6e 66 6f 5b 31  l = aMatchinfo[1
6280: 5d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 4d 61  ];.  }.  if( nMa
6290: 74 63 68 69 6e 66 6f 21 3d 28 32 2b 33 2a 6e 43  tchinfo!=(2+3*nC
62a0: 6f 6c 2a 6e 50 68 72 61 73 65 29 20 29 7b 0a 20  ol*nPhrase) ){. 
62b0: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
62c0: 74 5f 65 72 72 6f 72 28 70 43 74 78 2c 0a 20 20  t_error(pCtx,.  
62d0: 20 20 20 20 20 20 22 69 6e 76 61 6c 69 64 20 6d        "invalid m
62e0: 61 74 63 68 69 6e 66 6f 20 62 6c 6f 62 20 70 61  atchinfo blob pa
62f0: 73 73 65 64 20 74 6f 20 66 75 6e 63 74 69 6f 6e  ssed to function
6300: 20 72 61 6e 6b 28 29 22 2c 20 2d 31 29 3b 0a 20   rank()", -1);. 
6310: 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20     return;.  }. 
6320: 20 69 66 28 20 6e 56 61 6c 21 3d 28 31 2b 6e 43   if( nVal!=(1+nC
6330: 6f 6c 29 20 29 20 67 6f 74 6f 20 77 72 6f 6e 67  ol) ) goto wrong
6340: 5f 6e 75 6d 62 65 72 5f 61 72 67 73 3b 0a 0a 20  _number_args;.. 
6350: 20 2f 2a 20 49 74 65 72 61 74 65 20 74 68 72 6f   /* Iterate thro
6360: 75 67 68 20 65 61 63 68 20 70 68 72 61 73 65 20  ugh each phrase 
6370: 69 6e 20 74 68 65 20 75 73 65 72 73 20 71 75 65  in the users que
6380: 72 79 2e 20 2a 2f 0a 20 20 66 6f 72 28 69 50 68  ry. */.  for(iPh
6390: 72 61 73 65 3d 30 3b 20 69 50 68 72 61 73 65 3c  rase=0; iPhrase<
63a0: 6e 50 68 72 61 73 65 3b 20 69 50 68 72 61 73 65  nPhrase; iPhrase
63b0: 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 69 43 6f  ++){.    int iCo
63c0: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  l;              
63d0: 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e         /* Curren
63e0: 74 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 0a 20 20 20  t column */..   
63f0: 20 2f 2a 20 4e 6f 77 20 69 74 65 72 61 74 65 20   /* Now iterate 
6400: 74 68 72 6f 75 67 68 20 65 61 63 68 20 63 6f 6c  through each col
6410: 75 6d 6e 20 69 6e 20 74 68 65 20 75 73 65 72 73  umn in the users
6420: 20 71 75 65 72 79 2e 20 46 6f 72 20 65 61 63 68   query. For each
6430: 20 63 6f 6c 75 6d 6e 2c 0a 20 20 20 20 2a 2a 20   column,.    ** 
6440: 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 72 65  increment the re
6450: 6c 65 76 61 6e 63 79 20 73 63 6f 72 65 20 62 79  levancy score by
6460: 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20  :.    **.    ** 
6470: 20 20 28 3c 68 69 74 20 63 6f 75 6e 74 3e 20 2f    (<hit count> /
6480: 20 3c 67 6c 6f 62 61 6c 20 68 69 74 20 63 6f 75   <global hit cou
6490: 6e 74 3e 29 20 2a 20 3c 63 6f 6c 75 6d 6e 20 77  nt>) * <column w
64a0: 65 69 67 68 74 3e 0a 20 20 20 20 2a 2a 0a 20 20  eight>.    **.  
64b0: 20 20 2a 2a 20 61 50 68 72 61 73 65 69 6e 66 6f    ** aPhraseinfo
64c0: 5b 5d 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65  [] points to the
64d0: 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 64 61   start of the da
64e0: 74 61 20 66 6f 72 20 70 68 72 61 73 65 20 69 50  ta for phrase iP
64f0: 68 72 61 73 65 2e 20 53 6f 0a 20 20 20 20 2a 2a  hrase. So.    **
6500: 20 74 68 65 20 68 69 74 20 63 6f 75 6e 74 20 61   the hit count a
6510: 6e 64 20 67 6c 6f 62 61 6c 20 68 69 74 20 63 6f  nd global hit co
6520: 75 6e 74 73 20 66 6f 72 20 65 61 63 68 20 63 6f  unts for each co
6530: 6c 75 6d 6e 20 61 72 65 20 66 6f 75 6e 64 20 69  lumn are found i
6540: 6e 20 0a 20 20 20 20 2a 2a 20 61 50 68 72 61 73  n .    ** aPhras
6550: 65 69 6e 66 6f 5b 69 43 6f 6c 2a 33 5d 20 61 6e  einfo[iCol*3] an
6560: 64 20 61 50 68 72 61 73 65 69 6e 66 6f 5b 69 43  d aPhraseinfo[iC
6570: 6f 6c 2a 33 2b 31 5d 2c 20 72 65 73 70 65 63 74  ol*3+1], respect
6580: 69 76 65 6c 79 2e 0a 20 20 20 20 2a 2f 0a 20 20  ively..    */.  
6590: 20 20 69 6e 74 20 2a 61 50 68 72 61 73 65 69 6e    int *aPhrasein
65a0: 66 6f 20 3d 20 26 61 4d 61 74 63 68 69 6e 66 6f  fo = &aMatchinfo
65b0: 5b 32 20 2b 20 69 50 68 72 61 73 65 2a 6e 43 6f  [2 + iPhrase*nCo
65c0: 6c 2a 33 5d 3b 0a 20 20 20 20 66 6f 72 28 69 43  l*3];.    for(iC
65d0: 6f 6c 3d 30 3b 20 69 43 6f 6c 3c 6e 43 6f 6c 3b  ol=0; iCol<nCol;
65e0: 20 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 20   iCol++){.      
65f0: 69 6e 74 20 6e 48 69 74 43 6f 75 6e 74 20 3d 20  int nHitCount = 
6600: 61 50 68 72 61 73 65 69 6e 66 6f 5b 33 2a 69 43  aPhraseinfo[3*iC
6610: 6f 6c 5d 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e  ol];.      int n
6620: 47 6c 6f 62 61 6c 48 69 74 43 6f 75 6e 74 20 3d  GlobalHitCount =
6630: 20 61 50 68 72 61 73 65 69 6e 66 6f 5b 33 2a 69   aPhraseinfo[3*i
6640: 43 6f 6c 2b 31 5d 3b 0a 20 20 20 20 20 20 64 6f  Col+1];.      do
6650: 75 62 6c 65 20 77 65 69 67 68 74 20 3d 20 73 71  uble weight = sq
6660: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62  lite3_value_doub
6670: 6c 65 28 61 70 56 61 6c 5b 69 43 6f 6c 2b 31 5d  le(apVal[iCol+1]
6680: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 48 69  );.      if( nHi
6690: 74 43 6f 75 6e 74 3e 30 20 29 7b 0a 20 20 20 20  tCount>0 ){.    
66a0: 20 20 20 20 73 63 6f 72 65 20 2b 3d 20 28 28 64      score += ((d
66b0: 6f 75 62 6c 65 29 6e 48 69 74 43 6f 75 6e 74 20  ouble)nHitCount 
66c0: 2f 20 28 64 6f 75 62 6c 65 29 6e 47 6c 6f 62 61  / (double)nGloba
66d0: 6c 48 69 74 43 6f 75 6e 74 29 20 2a 20 77 65 69  lHitCount) * wei
66e0: 67 68 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  ght;.      }.   
66f0: 20 7d 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65   }.  }..  sqlite
6700: 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28  3_result_double(
6710: 70 43 74 78 2c 20 73 63 6f 72 65 29 3b 0a 20 20  pCtx, score);.  
6720: 72 65 74 75 72 6e 3b 0a 0a 20 20 2f 2a 20 4a 75  return;..  /* Ju
6730: 6d 70 20 68 65 72 65 20 69 66 20 74 68 65 20 77  mp here if the w
6740: 72 6f 6e 67 20 6e 75 6d 62 65 72 20 6f 66 20 61  rong number of a
6750: 72 67 75 6d 65 6e 74 73 20 61 72 65 20 70 61 73  rguments are pas
6760: 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63  sed to this func
6770: 74 69 6f 6e 20 2a 2f 0a 77 72 6f 6e 67 5f 6e 75  tion */.wrong_nu
6780: 6d 62 65 72 5f 61 72 67 73 3a 0a 20 20 73 71 6c  mber_args:.  sql
6790: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f  ite3_result_erro
67a0: 72 28 70 43 74 78 2c 20 22 77 72 6f 6e 67 20 6e  r(pCtx, "wrong n
67b0: 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e  umber of argumen
67c0: 74 73 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20 72  ts to function r
67d0: 61 6e 6b 28 29 22 2c 20 2d 31 29 3b 0a 7d 0a 0a  ank()", -1);.}..
67e0: 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54  static int SQLIT
67f0: 45 5f 54 43 4c 41 50 49 20 69 6e 73 74 61 6c 6c  E_TCLAPI install
6800: 5f 66 74 73 33 5f 72 61 6e 6b 5f 66 75 6e 63 74  _fts3_rank_funct
6810: 69 6f 6e 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c  ion(.  void * cl
6820: 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c 5f  ientData,.  Tcl_
6830: 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a  Interp *interp,.
6840: 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63    int objc,.  Tc
6850: 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a  l_Obj *CONST obj
6860: 76 5b 5d 0a 29 7b 0a 20 20 65 78 74 65 72 6e 20  v[].){.  extern 
6870: 69 6e 74 20 67 65 74 44 62 50 6f 69 6e 74 65 72  int getDbPointer
6880: 28 54 63 6c 5f 49 6e 74 65 72 70 2a 2c 20 63 6f  (Tcl_Interp*, co
6890: 6e 73 74 20 63 68 61 72 2a 2c 20 73 71 6c 69 74  nst char*, sqlit
68a0: 65 33 2a 2a 29 3b 0a 20 20 73 71 6c 69 74 65 33  e3**);.  sqlite3
68b0: 20 2a 64 62 3b 0a 0a 20 20 69 66 28 20 6f 62 6a   *db;..  if( obj
68c0: 63 21 3d 32 20 29 7b 0a 20 20 20 20 54 63 6c 5f  c!=2 ){.    Tcl_
68d0: 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74  WrongNumArgs(int
68e0: 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 44  erp, 1, objv, "D
68f0: 42 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  B");.    return 
6900: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a  TCL_ERROR;.  }..
6910: 20 20 69 66 28 20 67 65 74 44 62 50 6f 69 6e 74    if( getDbPoint
6920: 65 72 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 47  er(interp, Tcl_G
6930: 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d  etString(objv[1]
6940: 29 2c 20 26 64 62 29 20 29 20 72 65 74 75 72 6e  ), &db) ) return
6950: 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 73 71   TCL_ERROR;.  sq
6960: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e  lite3_create_fun
6970: 63 74 69 6f 6e 28 64 62 2c 20 22 72 61 6e 6b 22  ction(db, "rank"
6980: 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f 55 54 46  , -1, SQLITE_UTF
6990: 38 2c 20 30 2c 20 72 61 6e 6b 66 75 6e 63 2c 20  8, 0, rankfunc, 
69a0: 30 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20  0, 0);.  return 
69b0: 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a  TCL_OK;.}.../*.*
69c0: 2a 20 52 65 67 69 73 74 65 72 20 63 6f 6d 6d 61  * Register comma
69d0: 6e 64 73 20 77 69 74 68 20 74 68 65 20 54 43 4c  nds with the TCL
69e0: 20 69 6e 74 65 72 70 72 65 74 65 72 2e 0a 2a 2f   interpreter..*/
69f0: 0a 69 6e 74 20 53 71 6c 69 74 65 74 65 73 74 5f  .int Sqlitetest_
6a00: 66 75 6e 63 5f 49 6e 69 74 28 54 63 6c 5f 49 6e  func_Init(Tcl_In
6a10: 74 65 72 70 20 2a 69 6e 74 65 72 70 29 7b 0a 20  terp *interp){. 
6a20: 20 73 74 61 74 69 63 20 73 74 72 75 63 74 20 7b   static struct {
6a30: 0a 20 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d  .     char *zNam
6a40: 65 3b 0a 20 20 20 20 20 54 63 6c 5f 4f 62 6a 43  e;.     Tcl_ObjC
6a50: 6d 64 50 72 6f 63 20 2a 78 50 72 6f 63 3b 0a 20  mdProc *xProc;. 
6a60: 20 7d 20 61 4f 62 6a 43 6d 64 5b 5d 20 3d 20 7b   } aObjCmd[] = {
6a70: 0a 20 20 20 20 20 7b 20 22 61 75 74 6f 69 6e 73  .     { "autoins
6a80: 74 61 6c 6c 5f 74 65 73 74 5f 66 75 6e 63 74 69  tall_test_functi
6a90: 6f 6e 73 22 2c 20 20 20 20 61 75 74 6f 69 6e 73  ons",    autoins
6aa0: 74 61 6c 6c 5f 74 65 73 74 5f 66 75 6e 63 73 20  tall_test_funcs 
6ab0: 7d 2c 0a 20 20 20 20 20 7b 20 22 61 62 75 73 65  },.     { "abuse
6ac0: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e  _create_function
6ad0: 22 2c 20 20 20 20 20 20 20 20 20 61 62 75 73 65  ",         abuse
6ae0: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e  _create_function
6af0: 20 20 7d 2c 0a 20 20 20 20 20 7b 20 22 69 6e 73    },.     { "ins
6b00: 74 61 6c 6c 5f 66 74 73 33 5f 72 61 6e 6b 5f 66  tall_fts3_rank_f
6b10: 75 6e 63 74 69 6f 6e 22 2c 20 20 20 20 69 6e 73  unction",    ins
6b20: 74 61 6c 6c 5f 66 74 73 33 5f 72 61 6e 6b 5f 66  tall_fts3_rank_f
6b30: 75 6e 63 74 69 6f 6e 20 20 7d 2c 0a 20 20 7d 3b  unction  },.  };
6b40: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 65 78 74 65  .  int i;.  exte
6b50: 72 6e 20 69 6e 74 20 4d 64 35 5f 52 65 67 69 73  rn int Md5_Regis
6b60: 74 65 72 28 73 71 6c 69 74 65 33 20 2a 2c 20 63  ter(sqlite3 *, c
6b70: 68 61 72 20 2a 2a 2c 20 63 6f 6e 73 74 20 73 71  har **, const sq
6b80: 6c 69 74 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e  lite3_api_routin
6b90: 65 73 20 2a 29 3b 0a 0a 20 20 66 6f 72 28 69 3d  es *);..  for(i=
6ba0: 30 3b 20 69 3c 73 69 7a 65 6f 66 28 61 4f 62 6a  0; i<sizeof(aObj
6bb0: 43 6d 64 29 2f 73 69 7a 65 6f 66 28 61 4f 62 6a  Cmd)/sizeof(aObj
6bc0: 43 6d 64 5b 30 5d 29 3b 20 69 2b 2b 29 7b 0a 20  Cmd[0]); i++){. 
6bd0: 20 20 20 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a     Tcl_CreateObj
6be0: 43 6f 6d 6d 61 6e 64 28 69 6e 74 65 72 70 2c 20  Command(interp, 
6bf0: 61 4f 62 6a 43 6d 64 5b 69 5d 2e 7a 4e 61 6d 65  aObjCmd[i].zName
6c00: 2c 20 61 4f 62 6a 43 6d 64 5b 69 5d 2e 78 50 72  , aObjCmd[i].xPr
6c10: 6f 63 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20  oc, 0, 0);.  }. 
6c20: 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c   sqlite3_initial
6c30: 69 7a 65 28 29 3b 0a 20 20 73 71 6c 69 74 65 33  ize();.  sqlite3
6c40: 5f 61 75 74 6f 5f 65 78 74 65 6e 73 69 6f 6e 28  _auto_extension(
6c50: 28 76 6f 69 64 28 2a 29 28 76 6f 69 64 29 29 72  (void(*)(void))r
6c60: 65 67 69 73 74 65 72 54 65 73 74 46 75 6e 63 74  egisterTestFunct
6c70: 69 6f 6e 73 29 3b 0a 20 20 73 71 6c 69 74 65 33  ions);.  sqlite3
6c80: 5f 61 75 74 6f 5f 65 78 74 65 6e 73 69 6f 6e 28  _auto_extension(
6c90: 28 76 6f 69 64 28 2a 29 28 76 6f 69 64 29 29 4d  (void(*)(void))M
6ca0: 64 35 5f 52 65 67 69 73 74 65 72 29 3b 0a 20 20  d5_Register);.  
6cb0: 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d  return TCL_OK;.}
6cc0: 0a                                               .