/ Hex Artifact Content
Login

Artifact 8854b7a234b4272a78941fcc899c117d1839cd4e:


0000: 2f 2a 0a 2a 2a 20 32 30 30 32 20 46 65 62 72 75  /*.** 2002 Febru
0010: 61 72 79 20 32 33 0a 2a 2a 0a 2a 2a 20 54 68 65  ary 23.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69  *****.** This fi
0180: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20  le contains the 
0190: 43 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74  C functions that
01a0: 20 69 6d 70 6c 65 6d 65 6e 74 20 76 61 72 69 6f   implement vario
01b0: 75 73 20 53 51 4c 0a 2a 2a 20 66 75 6e 63 74 69  us SQL.** functi
01c0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2e 20 20  ons of SQLite.  
01d0: 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 69 73 20  .**.** There is 
01e0: 6f 6e 6c 79 20 6f 6e 65 20 65 78 70 6f 72 74 65  only one exporte
01f0: 64 20 73 79 6d 62 6f 6c 20 69 6e 20 74 68 69 73  d symbol in this
0200: 20 66 69 6c 65 20 2d 20 74 68 65 20 66 75 6e 63   file - the func
0210: 74 69 6f 6e 0a 2a 2a 20 73 71 6c 69 74 65 52 65  tion.** sqliteRe
0220: 67 69 73 74 65 72 42 75 69 6c 64 69 6e 46 75 6e  gisterBuildinFun
0230: 63 74 69 6f 6e 73 28 29 20 66 6f 75 6e 64 20 61  ctions() found a
0240: 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f 66 20  t the bottom of 
0250: 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 20 41 6c 6c  the file..** All
0260: 20 6f 74 68 65 72 20 63 6f 64 65 20 68 61 73 20   other code has 
0270: 66 69 6c 65 20 73 63 6f 70 65 2e 0a 2a 2f 0a 23  file scope..*/.#
0280: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49  include "sqliteI
0290: 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 3c  nt.h".#include <
02a0: 73 74 64 6c 69 62 2e 68 3e 0a 23 69 6e 63 6c 75  stdlib.h>.#inclu
02b0: 64 65 20 3c 61 73 73 65 72 74 2e 68 3e 0a 23 69  de <assert.h>.#i
02c0: 6e 63 6c 75 64 65 20 22 76 64 62 65 49 6e 74 2e  nclude "vdbeInt.
02d0: 68 22 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  h"../*.** Return
02e0: 20 74 68 65 20 63 6f 6c 6c 61 74 69 6e 67 20 66   the collating f
02f0: 75 6e 63 74 69 6f 6e 20 61 73 73 6f 63 69 61 74  unction associat
0300: 65 64 20 77 69 74 68 20 61 20 66 75 6e 63 74 69  ed with a functi
0310: 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 43 6f  on..*/.static Co
0320: 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 47 65  llSeq *sqlite3Ge
0330: 74 46 75 6e 63 43 6f 6c 6c 53 65 71 28 73 71 6c  tFuncCollSeq(sql
0340: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f  ite3_context *co
0350: 6e 74 65 78 74 29 7b 0a 20 20 72 65 74 75 72 6e  ntext){.  return
0360: 20 63 6f 6e 74 65 78 74 2d 3e 70 43 6f 6c 6c 3b   context->pColl;
0370: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
0380: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
0390: 6e 6f 6e 2d 61 67 67 72 65 67 61 74 65 20 6d 69  non-aggregate mi
03a0: 6e 28 29 20 61 6e 64 20 6d 61 78 28 29 20 66 75  n() and max() fu
03b0: 6e 63 74 69 6f 6e 73 0a 2a 2f 0a 73 74 61 74 69  nctions.*/.stati
03c0: 63 20 76 6f 69 64 20 6d 69 6e 6d 61 78 46 75 6e  c void minmaxFun
03d0: 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  c(.  sqlite3_con
03e0: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a 20  text *context,. 
03f0: 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71 6c   int argc,.  sql
0400: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67  ite3_value **arg
0410: 76 0a 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  v.){.  int i;.  
0420: 69 6e 74 20 6d 61 73 6b 3b 20 20 20 20 2f 2a 20  int mask;    /* 
0430: 30 20 66 6f 72 20 6d 69 6e 28 29 20 6f 72 20 30  0 for min() or 0
0440: 78 66 66 66 66 66 66 66 66 20 66 6f 72 20 6d 61  xffffffff for ma
0450: 78 28 29 20 2a 2f 0a 20 20 69 6e 74 20 69 42 65  x() */.  int iBe
0460: 73 74 3b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70  st;.  CollSeq *p
0470: 43 6f 6c 6c 3b 0a 0a 20 20 61 73 73 65 72 74 28  Coll;..  assert(
0480: 20 61 72 67 63 3e 31 20 29 3b 0a 20 20 6d 61 73   argc>1 );.  mas
0490: 6b 20 3d 20 73 71 6c 69 74 65 33 5f 75 73 65 72  k = sqlite3_user
04a0: 5f 64 61 74 61 28 63 6f 6e 74 65 78 74 29 3d 3d  _data(context)==
04b0: 30 20 3f 20 30 20 3a 20 2d 31 3b 0a 20 20 70 43  0 ? 0 : -1;.  pC
04c0: 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 47 65 74  oll = sqlite3Get
04d0: 46 75 6e 63 43 6f 6c 6c 53 65 71 28 63 6f 6e 74  FuncCollSeq(cont
04e0: 65 78 74 29 3b 0a 20 20 61 73 73 65 72 74 28 20  ext);.  assert( 
04f0: 70 43 6f 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72  pColl );.  asser
0500: 74 28 20 6d 61 73 6b 3d 3d 2d 31 20 7c 7c 20 6d  t( mask==-1 || m
0510: 61 73 6b 3d 3d 30 20 29 3b 0a 20 20 69 42 65 73  ask==0 );.  iBes
0520: 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 73 71 6c  t = 0;.  if( sql
0530: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
0540: 61 72 67 76 5b 30 5d 29 3d 3d 53 51 4c 49 54 45  argv[0])==SQLITE
0550: 5f 4e 55 4c 4c 20 29 20 72 65 74 75 72 6e 3b 0a  _NULL ) return;.
0560: 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 61 72 67    for(i=1; i<arg
0570: 63 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28  c; i++){.    if(
0580: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
0590: 79 70 65 28 61 72 67 76 5b 69 5d 29 3d 3d 53 51  ype(argv[i])==SQ
05a0: 4c 49 54 45 5f 4e 55 4c 4c 20 29 20 72 65 74 75  LITE_NULL ) retu
05b0: 72 6e 3b 0a 20 20 20 20 69 66 28 20 28 73 71 6c  rn;.    if( (sql
05c0: 69 74 65 33 4d 65 6d 43 6f 6d 70 61 72 65 28 61  ite3MemCompare(a
05d0: 72 67 76 5b 69 42 65 73 74 5d 2c 20 61 72 67 76  rgv[iBest], argv
05e0: 5b 69 5d 2c 20 70 43 6f 6c 6c 29 5e 6d 61 73 6b  [i], pColl)^mask
05f0: 29 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 74 65  )>=0 ){.      te
0600: 73 74 63 61 73 65 28 20 6d 61 73 6b 3d 3d 30 20  stcase( mask==0 
0610: 29 3b 0a 20 20 20 20 20 20 69 42 65 73 74 20 3d  );.      iBest =
0620: 20 69 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20   i;.    }.  }.  
0630: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 76  sqlite3_result_v
0640: 61 6c 75 65 28 63 6f 6e 74 65 78 74 2c 20 61 72  alue(context, ar
0650: 67 76 5b 69 42 65 73 74 5d 29 3b 0a 7d 0a 0a 2f  gv[iBest]);.}../
0660: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
0670: 74 79 70 65 20 6f 66 20 74 68 65 20 61 72 67 75  type of the argu
0680: 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ment..*/.static 
0690: 76 6f 69 64 20 74 79 70 65 6f 66 46 75 6e 63 28  void typeofFunc(
06a0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
06b0: 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69  xt *context,.  i
06c0: 6e 74 20 4e 6f 74 55 73 65 64 2c 0a 20 20 73 71  nt NotUsed,.  sq
06d0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
06e0: 67 76 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68  gv.){.  const ch
06f0: 61 72 20 2a 7a 20 3d 20 30 3b 0a 20 20 55 4e 55  ar *z = 0;.  UNU
0700: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f  SED_PARAMETER(No
0710: 74 55 73 65 64 29 3b 0a 20 20 73 77 69 74 63 68  tUsed);.  switch
0720: 28 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ( sqlite3_value_
0730: 74 79 70 65 28 61 72 67 76 5b 30 5d 29 20 29 7b  type(argv[0]) ){
0740: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
0750: 5f 49 4e 54 45 47 45 52 3a 20 7a 20 3d 20 22 69  _INTEGER: z = "i
0760: 6e 74 65 67 65 72 22 3b 20 62 72 65 61 6b 3b 0a  nteger"; break;.
0770: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f      case SQLITE_
0780: 54 45 58 54 3a 20 20 20 20 7a 20 3d 20 22 74 65  TEXT:    z = "te
0790: 78 74 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20  xt";    break;. 
07a0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46     case SQLITE_F
07b0: 4c 4f 41 54 3a 20 20 20 7a 20 3d 20 22 72 65 61  LOAT:   z = "rea
07c0: 6c 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  l";    break;.  
07d0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 4c    case SQLITE_BL
07e0: 4f 42 3a 20 20 20 20 7a 20 3d 20 22 62 6c 6f 62  OB:    z = "blob
07f0: 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20  ";    break;.   
0800: 20 64 65 66 61 75 6c 74 3a 20 20 20 20 20 20 20   default:       
0810: 20 20 20 20 20 20 7a 20 3d 20 22 6e 75 6c 6c 22        z = "null"
0820: 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a  ;    break;.  }.
0830: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74    sqlite3_result
0840: 5f 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a  _text(context, z
0850: 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f 53 54 41  , -1, SQLITE_STA
0860: 54 49 43 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  TIC);.}.../*.** 
0870: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
0880: 66 20 74 68 65 20 6c 65 6e 67 74 68 28 29 20 66  f the length() f
0890: 75 6e 63 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69  unction.*/.stati
08a0: 63 20 76 6f 69 64 20 6c 65 6e 67 74 68 46 75 6e  c void lengthFun
08b0: 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  c(.  sqlite3_con
08c0: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a 20  text *context,. 
08d0: 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71 6c   int argc,.  sql
08e0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67  ite3_value **arg
08f0: 76 0a 29 7b 0a 20 20 69 6e 74 20 6c 65 6e 3b 0a  v.){.  int len;.
0900: 0a 20 20 61 73 73 65 72 74 28 20 61 72 67 63 3d  .  assert( argc=
0910: 3d 31 20 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50  =1 );.  UNUSED_P
0920: 41 52 41 4d 45 54 45 52 28 61 72 67 63 29 3b 0a  ARAMETER(argc);.
0930: 20 20 73 77 69 74 63 68 28 20 73 71 6c 69 74 65    switch( sqlite
0940: 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67  3_value_type(arg
0950: 76 5b 30 5d 29 20 29 7b 0a 20 20 20 20 63 61 73  v[0]) ){.    cas
0960: 65 20 53 51 4c 49 54 45 5f 42 4c 4f 42 3a 0a 20  e SQLITE_BLOB:. 
0970: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49     case SQLITE_I
0980: 4e 54 45 47 45 52 3a 0a 20 20 20 20 63 61 73 65  NTEGER:.    case
0990: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 3a 20 7b   SQLITE_FLOAT: {
09a0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72  .      sqlite3_r
09b0: 65 73 75 6c 74 5f 69 6e 74 28 63 6f 6e 74 65 78  esult_int(contex
09c0: 74 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  t, sqlite3_value
09d0: 5f 62 79 74 65 73 28 61 72 67 76 5b 30 5d 29 29  _bytes(argv[0]))
09e0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;.      break;. 
09f0: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51     }.    case SQ
0a00: 4c 49 54 45 5f 54 45 58 54 3a 20 7b 0a 20 20 20  LITE_TEXT: {.   
0a10: 20 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65     const unsigne
0a20: 64 20 63 68 61 72 20 2a 7a 20 3d 20 73 71 6c 69  d char *z = sqli
0a30: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61  te3_value_text(a
0a40: 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 69  rgv[0]);.      i
0a50: 66 28 20 7a 3d 3d 30 20 29 20 72 65 74 75 72 6e  f( z==0 ) return
0a60: 3b 0a 20 20 20 20 20 20 6c 65 6e 20 3d 20 30 3b  ;.      len = 0;
0a70: 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a  .      while( *z
0a80: 20 29 7b 0a 20 20 20 20 20 20 20 20 6c 65 6e 2b   ){.        len+
0a90: 2b 3b 0a 20 20 20 20 20 20 20 20 53 51 4c 49 54  +;.        SQLIT
0aa0: 45 5f 53 4b 49 50 5f 55 54 46 38 28 7a 29 3b 0a  E_SKIP_UTF8(z);.
0ab0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71        }.      sq
0ac0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74  lite3_result_int
0ad0: 28 63 6f 6e 74 65 78 74 2c 20 6c 65 6e 29 3b 0a  (context, len);.
0ae0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
0af0: 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20   }.    default: 
0b00: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  {.      sqlite3_
0b10: 72 65 73 75 6c 74 5f 6e 75 6c 6c 28 63 6f 6e 74  result_null(cont
0b20: 65 78 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61  ext);.      brea
0b30: 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a  k;.    }.  }.}..
0b40: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
0b50: 74 69 6f 6e 20 6f 66 20 74 68 65 20 61 62 73 28  tion of the abs(
0b60: 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a  ) function..**.*
0b70: 2a 20 49 4d 50 3a 20 52 2d 32 33 39 37 39 2d 32  * IMP: R-23979-2
0b80: 36 38 35 35 20 54 68 65 20 61 62 73 28 58 29 20  6855 The abs(X) 
0b90: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73  function returns
0ba0: 20 74 68 65 20 61 62 73 6f 6c 75 74 65 20 76 61   the absolute va
0bb0: 6c 75 65 20 6f 66 0a 2a 2a 20 74 68 65 20 6e 75  lue of.** the nu
0bc0: 6d 65 72 69 63 20 61 72 67 75 6d 65 6e 74 20 58  meric argument X
0bd0: 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  . .*/.static voi
0be0: 64 20 61 62 73 46 75 6e 63 28 73 71 6c 69 74 65  d absFunc(sqlite
0bf0: 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65  3_context *conte
0c00: 78 74 2c 20 69 6e 74 20 61 72 67 63 2c 20 73 71  xt, int argc, sq
0c10: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
0c20: 67 76 29 7b 0a 20 20 61 73 73 65 72 74 28 20 61  gv){.  assert( a
0c30: 72 67 63 3d 3d 31 20 29 3b 0a 20 20 55 4e 55 53  rgc==1 );.  UNUS
0c40: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 61 72 67  ED_PARAMETER(arg
0c50: 63 29 3b 0a 20 20 73 77 69 74 63 68 28 20 73 71  c);.  switch( sq
0c60: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65  lite3_value_type
0c70: 28 61 72 67 76 5b 30 5d 29 20 29 7b 0a 20 20 20  (argv[0]) ){.   
0c80: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54   case SQLITE_INT
0c90: 45 47 45 52 3a 20 7b 0a 20 20 20 20 20 20 69 36  EGER: {.      i6
0ca0: 34 20 69 56 61 6c 20 3d 20 73 71 6c 69 74 65 33  4 iVal = sqlite3
0cb0: 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 61 72 67  _value_int64(arg
0cc0: 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 69 66 28  v[0]);.      if(
0cd0: 20 69 56 61 6c 3c 30 20 29 7b 0a 20 20 20 20 20   iVal<0 ){.     
0ce0: 20 20 20 69 66 28 20 28 69 56 61 6c 3c 3c 31 29     if( (iVal<<1)
0cf0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20  ==0 ){.         
0d00: 20 2f 2a 20 49 4d 50 3a 20 52 2d 33 35 34 36 30   /* IMP: R-35460
0d10: 2d 31 35 30 38 34 20 49 66 20 58 20 69 73 20 74  -15084 If X is t
0d20: 68 65 20 69 6e 74 65 67 65 72 20 2d 39 32 32 33  he integer -9223
0d30: 33 37 32 30 33 36 38 35 34 37 37 35 38 30 37 20  372036854775807 
0d40: 74 68 65 6e 0a 20 20 20 20 20 20 20 20 20 20 2a  then.          *
0d50: 2a 20 61 62 73 28 58 29 20 74 68 72 6f 77 73 20  * abs(X) throws 
0d60: 61 6e 20 69 6e 74 65 67 65 72 20 6f 76 65 72 66  an integer overf
0d70: 6c 6f 77 20 65 72 72 6f 72 20 73 69 6e 63 65 20  low error since 
0d80: 74 68 65 72 65 20 69 73 20 6e 6f 0a 20 20 20 20  there is no.    
0d90: 20 20 20 20 20 20 2a 2a 20 65 71 75 69 76 61 6c        ** equival
0da0: 65 6e 74 20 70 6f 73 69 74 69 76 65 20 36 34 2d  ent positive 64-
0db0: 62 69 74 20 74 77 6f 20 63 6f 6d 70 6c 65 6d 65  bit two compleme
0dc0: 6e 74 20 76 61 6c 75 65 2e 20 2a 2f 0a 20 20 20  nt value. */.   
0dd0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72         sqlite3_r
0de0: 65 73 75 6c 74 5f 65 72 72 6f 72 28 63 6f 6e 74  esult_error(cont
0df0: 65 78 74 2c 20 22 69 6e 74 65 67 65 72 20 6f 76  ext, "integer ov
0e00: 65 72 66 6c 6f 77 22 2c 20 2d 31 29 3b 0a 20 20  erflow", -1);.  
0e10: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 3b 0a          return;.
0e20: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
0e30: 20 20 69 56 61 6c 20 3d 20 2d 69 56 61 6c 3b 0a    iVal = -iVal;.
0e40: 20 20 20 20 20 20 7d 20 0a 20 20 20 20 20 20 73        } .      s
0e50: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e  qlite3_result_in
0e60: 74 36 34 28 63 6f 6e 74 65 78 74 2c 20 69 56 61  t64(context, iVa
0e70: 6c 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b  l);.      break;
0e80: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20  .    }.    case 
0e90: 53 51 4c 49 54 45 5f 4e 55 4c 4c 3a 20 7b 0a 20  SQLITE_NULL: {. 
0ea0: 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 33       /* IMP: R-3
0eb0: 37 34 33 34 2d 31 39 39 32 39 20 41 62 73 28 58  7434-19929 Abs(X
0ec0: 29 20 72 65 74 75 72 6e 73 20 4e 55 4c 4c 20 69  ) returns NULL i
0ed0: 66 20 58 20 69 73 20 4e 55 4c 4c 2e 20 2a 2f 0a  f X is NULL. */.
0ee0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65        sqlite3_re
0ef0: 73 75 6c 74 5f 6e 75 6c 6c 28 63 6f 6e 74 65 78  sult_null(contex
0f00: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b  t);.      break;
0f10: 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75  .    }.    defau
0f20: 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 42  lt: {.      /* B
0f30: 65 63 61 75 73 65 20 73 71 6c 69 74 65 33 5f 76  ecause sqlite3_v
0f40: 61 6c 75 65 5f 64 6f 75 62 6c 65 28 29 20 72 65  alue_double() re
0f50: 74 75 72 6e 73 20 30 2e 30 20 69 66 20 74 68 65  turns 0.0 if the
0f60: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 74   argument is not
0f70: 0a 20 20 20 20 20 20 2a 2a 20 73 6f 6d 65 74 68  .      ** someth
0f80: 69 6e 67 20 74 68 61 74 20 63 61 6e 20 62 65 20  ing that can be 
0f90: 63 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61  converted into a
0fa0: 20 6e 75 6d 62 65 72 2c 20 77 65 20 68 61 76 65   number, we have
0fb0: 3a 0a 20 20 20 20 20 20 2a 2a 20 49 4d 50 3a 20  :.      ** IMP: 
0fc0: 52 2d 35 37 33 32 36 2d 33 31 35 34 31 20 41 62  R-57326-31541 Ab
0fd0: 73 28 58 29 20 72 65 74 75 72 6e 20 30 2e 30 20  s(X) return 0.0 
0fe0: 69 66 20 58 20 69 73 20 61 20 73 74 72 69 6e 67  if X is a string
0ff0: 20 6f 72 20 62 6c 6f 62 20 74 68 61 74 0a 20 20   or blob that.  
1000: 20 20 20 20 2a 2a 20 63 61 6e 6e 6f 74 20 62 65      ** cannot be
1010: 20 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 61 20   converted to a 
1020: 6e 75 6d 65 72 69 63 20 76 61 6c 75 65 2e 20 0a  numeric value. .
1030: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 64        */.      d
1040: 6f 75 62 6c 65 20 72 56 61 6c 20 3d 20 73 71 6c  ouble rVal = sql
1050: 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c  ite3_value_doubl
1060: 65 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20  e(argv[0]);.    
1070: 20 20 69 66 28 20 72 56 61 6c 3c 30 20 29 20 72    if( rVal<0 ) r
1080: 56 61 6c 20 3d 20 2d 72 56 61 6c 3b 0a 20 20 20  Val = -rVal;.   
1090: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
10a0: 74 5f 64 6f 75 62 6c 65 28 63 6f 6e 74 65 78 74  t_double(context
10b0: 2c 20 72 56 61 6c 29 3b 0a 20 20 20 20 20 20 62  , rVal);.      b
10c0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  reak;.    }.  }.
10d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
10e0: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
10f0: 75 62 73 74 72 28 29 20 66 75 6e 63 74 69 6f 6e  ubstr() function
1100: 2e 0a 2a 2a 0a 2a 2a 20 73 75 62 73 74 72 28 78  ..**.** substr(x
1110: 2c 70 31 2c 70 32 29 20 20 72 65 74 75 72 6e 73  ,p1,p2)  returns
1120: 20 70 32 20 63 68 61 72 61 63 74 65 72 73 20 6f   p2 characters o
1130: 66 20 78 5b 5d 20 62 65 67 69 6e 6e 69 6e 67 20  f x[] beginning 
1140: 77 69 74 68 20 70 31 2e 0a 2a 2a 20 70 31 20 69  with p1..** p1 i
1150: 73 20 31 2d 69 6e 64 65 78 65 64 2e 20 20 53 6f  s 1-indexed.  So
1160: 20 73 75 62 73 74 72 28 78 2c 31 2c 31 29 20 72   substr(x,1,1) r
1170: 65 74 75 72 6e 73 20 74 68 65 20 66 69 72 73 74  eturns the first
1180: 20 63 68 61 72 61 63 74 65 72 0a 2a 2a 20 6f 66   character.** of
1190: 20 78 2e 20 20 49 66 20 78 20 69 73 20 74 65 78   x.  If x is tex
11a0: 74 2c 20 74 68 65 6e 20 77 65 20 61 63 74 75 61  t, then we actua
11b0: 6c 6c 79 20 63 6f 75 6e 74 20 55 54 46 2d 38 20  lly count UTF-8 
11c0: 63 68 61 72 61 63 74 65 72 73 2e 0a 2a 2a 20 49  characters..** I
11d0: 66 20 78 20 69 73 20 61 20 62 6c 6f 62 2c 20 74  f x is a blob, t
11e0: 68 65 6e 20 77 65 20 63 6f 75 6e 74 20 62 79 74  hen we count byt
11f0: 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 31 20  es..**.** If p1 
1200: 69 73 20 6e 65 67 61 74 69 76 65 2c 20 74 68 65  is negative, the
1210: 6e 20 77 65 20 62 65 67 69 6e 20 61 62 73 28 70  n we begin abs(p
1220: 31 29 20 66 72 6f 6d 20 74 68 65 20 65 6e 64 20  1) from the end 
1230: 6f 66 20 78 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 49 66  of x[]..**.** If
1240: 20 70 32 20 69 73 20 6e 65 67 61 74 69 76 65 2c   p2 is negative,
1250: 20 72 65 74 75 72 6e 20 74 68 65 20 70 32 20 63   return the p2 c
1260: 68 61 72 61 63 74 65 72 73 20 70 72 65 63 65 65  haracters precee
1270: 64 69 6e 67 20 70 31 2e 0a 2a 2f 0a 73 74 61 74  ding p1..*/.stat
1280: 69 63 20 76 6f 69 64 20 73 75 62 73 74 72 46 75  ic void substrFu
1290: 6e 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  nc(.  sqlite3_co
12a0: 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a  ntext *context,.
12b0: 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71    int argc,.  sq
12c0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
12d0: 67 76 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 75 6e  gv.){.  const un
12e0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 7a 3b 0a  signed char *z;.
12f0: 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64    const unsigned
1300: 20 63 68 61 72 20 2a 7a 32 3b 0a 20 20 69 6e 74   char *z2;.  int
1310: 20 6c 65 6e 3b 0a 20 20 69 6e 74 20 70 30 74 79   len;.  int p0ty
1320: 70 65 3b 0a 20 20 69 36 34 20 70 31 2c 20 70 32  pe;.  i64 p1, p2
1330: 3b 0a 20 20 69 6e 74 20 6e 65 67 50 32 20 3d 20  ;.  int negP2 = 
1340: 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 61 72  0;..  assert( ar
1350: 67 63 3d 3d 33 20 7c 7c 20 61 72 67 63 3d 3d 32  gc==3 || argc==2
1360: 20 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65   );.  if( sqlite
1370: 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67  3_value_type(arg
1380: 76 5b 31 5d 29 3d 3d 53 51 4c 49 54 45 5f 4e 55  v[1])==SQLITE_NU
1390: 4c 4c 0a 20 20 20 7c 7c 20 28 61 72 67 63 3d 3d  LL.   || (argc==
13a0: 33 20 26 26 20 73 71 6c 69 74 65 33 5f 76 61 6c  3 && sqlite3_val
13b0: 75 65 5f 74 79 70 65 28 61 72 67 76 5b 32 5d 29  ue_type(argv[2])
13c0: 3d 3d 53 51 4c 49 54 45 5f 4e 55 4c 4c 29 0a 20  ==SQLITE_NULL). 
13d0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a   ){.    return;.
13e0: 20 20 7d 0a 20 20 70 30 74 79 70 65 20 3d 20 73    }.  p0type = s
13f0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
1400: 65 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 70 31  e(argv[0]);.  p1
1410: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
1420: 5f 69 6e 74 28 61 72 67 76 5b 31 5d 29 3b 0a 20  _int(argv[1]);. 
1430: 20 69 66 28 20 70 30 74 79 70 65 3d 3d 53 51 4c   if( p0type==SQL
1440: 49 54 45 5f 42 4c 4f 42 20 29 7b 0a 20 20 20 20  ITE_BLOB ){.    
1450: 6c 65 6e 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  len = sqlite3_va
1460: 6c 75 65 5f 62 79 74 65 73 28 61 72 67 76 5b 30  lue_bytes(argv[0
1470: 5d 29 3b 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69  ]);.    z = sqli
1480: 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 61  te3_value_blob(a
1490: 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20 69 66 28  rgv[0]);.    if(
14a0: 20 7a 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a   z==0 ) return;.
14b0: 20 20 20 20 61 73 73 65 72 74 28 20 6c 65 6e 3d      assert( len=
14c0: 3d 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62  =sqlite3_value_b
14d0: 79 74 65 73 28 61 72 67 76 5b 30 5d 29 20 29 3b  ytes(argv[0]) );
14e0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 20  .  }else{.    z 
14f0: 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  = sqlite3_value_
1500: 74 65 78 74 28 61 72 67 76 5b 30 5d 29 3b 0a 20  text(argv[0]);. 
1510: 20 20 20 69 66 28 20 7a 3d 3d 30 20 29 20 72 65     if( z==0 ) re
1520: 74 75 72 6e 3b 0a 20 20 20 20 6c 65 6e 20 3d 20  turn;.    len = 
1530: 30 3b 0a 20 20 20 20 69 66 28 20 70 31 3c 30 20  0;.    if( p1<0 
1540: 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 7a 32 3d  ){.      for(z2=
1550: 7a 3b 20 2a 7a 32 3b 20 6c 65 6e 2b 2b 29 7b 0a  z; *z2; len++){.
1560: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
1570: 4b 49 50 5f 55 54 46 38 28 7a 32 29 3b 0a 20 20  KIP_UTF8(z2);.  
1580: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
1590: 20 20 69 66 28 20 61 72 67 63 3d 3d 33 20 29 7b    if( argc==3 ){
15a0: 0a 20 20 20 20 70 32 20 3d 20 73 71 6c 69 74 65  .    p2 = sqlite
15b0: 33 5f 76 61 6c 75 65 5f 69 6e 74 28 61 72 67 76  3_value_int(argv
15c0: 5b 32 5d 29 3b 0a 20 20 20 20 69 66 28 20 70 32  [2]);.    if( p2
15d0: 3c 30 20 29 7b 0a 20 20 20 20 20 20 70 32 20 3d  <0 ){.      p2 =
15e0: 20 2d 70 32 3b 0a 20 20 20 20 20 20 6e 65 67 50   -p2;.      negP
15f0: 32 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d  2 = 1;.    }.  }
1600: 65 6c 73 65 7b 0a 20 20 20 20 70 32 20 3d 20 73  else{.    p2 = s
1610: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 5f 64  qlite3_context_d
1620: 62 5f 68 61 6e 64 6c 65 28 63 6f 6e 74 65 78 74  b_handle(context
1630: 29 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45  )->aLimit[SQLITE
1640: 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54 48 5d 3b 0a  _LIMIT_LENGTH];.
1650: 20 20 7d 0a 20 20 69 66 28 20 70 31 3c 30 20 29    }.  if( p1<0 )
1660: 7b 0a 20 20 20 20 70 31 20 2b 3d 20 6c 65 6e 3b  {.    p1 += len;
1670: 0a 20 20 20 20 69 66 28 20 70 31 3c 30 20 29 7b  .    if( p1<0 ){
1680: 0a 20 20 20 20 20 20 70 32 20 2b 3d 20 70 31 3b  .      p2 += p1;
1690: 0a 20 20 20 20 20 20 69 66 28 20 70 32 3c 30 20  .      if( p2<0 
16a0: 29 20 70 32 20 3d 20 30 3b 0a 20 20 20 20 20 20  ) p2 = 0;.      
16b0: 70 31 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20  p1 = 0;.    }.  
16c0: 7d 65 6c 73 65 20 69 66 28 20 70 31 3e 30 20 29  }else if( p1>0 )
16d0: 7b 0a 20 20 20 20 70 31 2d 2d 3b 0a 20 20 7d 65  {.    p1--;.  }e
16e0: 6c 73 65 20 69 66 28 20 70 32 3e 30 20 29 7b 0a  lse if( p2>0 ){.
16f0: 20 20 20 20 70 32 2d 2d 3b 0a 20 20 7d 0a 20 20      p2--;.  }.  
1700: 69 66 28 20 6e 65 67 50 32 20 29 7b 0a 20 20 20  if( negP2 ){.   
1710: 20 70 31 20 2d 3d 20 70 32 3b 0a 20 20 20 20 69   p1 -= p2;.    i
1720: 66 28 20 70 31 3c 30 20 29 7b 0a 20 20 20 20 20  f( p1<0 ){.     
1730: 20 70 32 20 2b 3d 20 70 31 3b 0a 20 20 20 20 20   p2 += p1;.     
1740: 20 70 31 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20   p1 = 0;.    }. 
1750: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 31 3e   }.  assert( p1>
1760: 3d 30 20 26 26 20 70 32 3e 3d 30 20 29 3b 0a 20  =0 && p2>=0 );. 
1770: 20 69 66 28 20 70 30 74 79 70 65 21 3d 53 51 4c   if( p0type!=SQL
1780: 49 54 45 5f 42 4c 4f 42 20 29 7b 0a 20 20 20 20  ITE_BLOB ){.    
1790: 77 68 69 6c 65 28 20 2a 7a 20 26 26 20 70 31 20  while( *z && p1 
17a0: 29 7b 0a 20 20 20 20 20 20 53 51 4c 49 54 45 5f  ){.      SQLITE_
17b0: 53 4b 49 50 5f 55 54 46 38 28 7a 29 3b 0a 20 20  SKIP_UTF8(z);.  
17c0: 20 20 20 20 70 31 2d 2d 3b 0a 20 20 20 20 7d 0a      p1--;.    }.
17d0: 20 20 20 20 66 6f 72 28 7a 32 3d 7a 3b 20 2a 7a      for(z2=z; *z
17e0: 32 20 26 26 20 70 32 3b 20 70 32 2d 2d 29 7b 0a  2 && p2; p2--){.
17f0: 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53 4b 49        SQLITE_SKI
1800: 50 5f 55 54 46 38 28 7a 32 29 3b 0a 20 20 20 20  P_UTF8(z2);.    
1810: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65  }.    sqlite3_re
1820: 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e 74 65 78  sult_text(contex
1830: 74 2c 20 28 63 68 61 72 2a 29 7a 2c 20 28 69 6e  t, (char*)z, (in
1840: 74 29 28 7a 32 2d 7a 29 2c 20 53 51 4c 49 54 45  t)(z2-z), SQLITE
1850: 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 7d  _TRANSIENT);.  }
1860: 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 70 31  else{.    if( p1
1870: 2b 70 32 3e 6c 65 6e 20 29 7b 0a 20 20 20 20 20  +p2>len ){.     
1880: 20 70 32 20 3d 20 6c 65 6e 2d 70 31 3b 0a 20 20   p2 = len-p1;.  
1890: 20 20 20 20 69 66 28 20 70 32 3c 30 20 29 20 70      if( p2<0 ) p
18a0: 32 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20  2 = 0;.    }.   
18b0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
18c0: 62 6c 6f 62 28 63 6f 6e 74 65 78 74 2c 20 28 63  blob(context, (c
18d0: 68 61 72 2a 29 26 7a 5b 70 31 5d 2c 20 28 69 6e  har*)&z[p1], (in
18e0: 74 29 70 32 2c 20 53 51 4c 49 54 45 5f 54 52 41  t)p2, SQLITE_TRA
18f0: 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 0a 7d 0a 0a  NSIENT);.  }.}..
1900: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
1910: 74 69 6f 6e 20 6f 66 20 74 68 65 20 72 6f 75 6e  tion of the roun
1920: 64 28 29 20 66 75 6e 63 74 69 6f 6e 0a 2a 2f 0a  d() function.*/.
1930: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
1940: 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49  MIT_FLOATING_POI
1950: 4e 54 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72  NT.static void r
1960: 6f 75 6e 64 46 75 6e 63 28 73 71 6c 69 74 65 33  oundFunc(sqlite3
1970: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
1980: 74 2c 20 69 6e 74 20 61 72 67 63 2c 20 73 71 6c  t, int argc, sql
1990: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67  ite3_value **arg
19a0: 76 29 7b 0a 20 20 69 6e 74 20 6e 20 3d 20 30 3b  v){.  int n = 0;
19b0: 0a 20 20 64 6f 75 62 6c 65 20 72 3b 0a 20 20 63  .  double r;.  c
19c0: 68 61 72 20 2a 7a 42 75 66 3b 0a 20 20 61 73 73  har *zBuf;.  ass
19d0: 65 72 74 28 20 61 72 67 63 3d 3d 31 20 7c 7c 20  ert( argc==1 || 
19e0: 61 72 67 63 3d 3d 32 20 29 3b 0a 20 20 69 66 28  argc==2 );.  if(
19f0: 20 61 72 67 63 3d 3d 32 20 29 7b 0a 20 20 20 20   argc==2 ){.    
1a00: 69 66 28 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 3d  if( SQLITE_NULL=
1a10: 3d 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  =sqlite3_value_t
1a20: 79 70 65 28 61 72 67 76 5b 31 5d 29 20 29 20 72  ype(argv[1]) ) r
1a30: 65 74 75 72 6e 3b 0a 20 20 20 20 6e 20 3d 20 73  eturn;.    n = s
1a40: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74  qlite3_value_int
1a50: 28 61 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20 69  (argv[1]);.    i
1a60: 66 28 20 6e 3e 33 30 20 29 20 6e 20 3d 20 33 30  f( n>30 ) n = 30
1a70: 3b 0a 20 20 20 20 69 66 28 20 6e 3c 30 20 29 20  ;.    if( n<0 ) 
1a80: 6e 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28  n = 0;.  }.  if(
1a90: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
1aa0: 79 70 65 28 61 72 67 76 5b 30 5d 29 3d 3d 53 51  ype(argv[0])==SQ
1ab0: 4c 49 54 45 5f 4e 55 4c 4c 20 29 20 72 65 74 75  LITE_NULL ) retu
1ac0: 72 6e 3b 0a 20 20 72 20 3d 20 73 71 6c 69 74 65  rn;.  r = sqlite
1ad0: 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 61  3_value_double(a
1ae0: 72 67 76 5b 30 5d 29 3b 0a 20 20 2f 2a 20 49 66  rgv[0]);.  /* If
1af0: 20 59 3d 3d 30 20 61 6e 64 20 58 20 77 69 6c 6c   Y==0 and X will
1b00: 20 66 69 74 20 69 6e 20 61 20 36 34 2d 62 69 74   fit in a 64-bit
1b10: 20 69 6e 74 2c 0a 20 20 2a 2a 20 68 61 6e 64 6c   int,.  ** handl
1b20: 65 20 74 68 65 20 72 6f 75 6e 64 69 6e 67 20 64  e the rounding d
1b30: 69 72 65 63 74 6c 79 2c 0a 20 20 2a 2a 20 6f 74  irectly,.  ** ot
1b40: 68 65 72 77 69 73 65 20 75 73 65 20 70 72 69 6e  herwise use prin
1b50: 74 66 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e  tf..  */.  if( n
1b60: 3d 3d 30 20 26 26 20 72 3e 3d 30 20 26 26 20 72  ==0 && r>=0 && r
1b70: 3c 4c 41 52 47 45 53 54 5f 49 4e 54 36 34 2d 31  <LARGEST_INT64-1
1b80: 20 29 7b 0a 20 20 20 20 72 20 3d 20 28 64 6f 75   ){.    r = (dou
1b90: 62 6c 65 29 28 28 73 71 6c 69 74 65 5f 69 6e 74  ble)((sqlite_int
1ba0: 36 34 29 28 72 2b 30 2e 35 29 29 3b 0a 20 20 7d  64)(r+0.5));.  }
1bb0: 65 6c 73 65 20 69 66 28 20 6e 3d 3d 30 20 26 26  else if( n==0 &&
1bc0: 20 72 3c 30 20 26 26 20 28 2d 72 29 3c 4c 41 52   r<0 && (-r)<LAR
1bd0: 47 45 53 54 5f 49 4e 54 36 34 2d 31 20 29 7b 0a  GEST_INT64-1 ){.
1be0: 20 20 20 20 72 20 3d 20 2d 28 64 6f 75 62 6c 65      r = -(double
1bf0: 29 28 28 73 71 6c 69 74 65 5f 69 6e 74 36 34 29  )((sqlite_int64)
1c00: 28 28 2d 72 29 2b 30 2e 35 29 29 3b 0a 20 20 7d  ((-r)+0.5));.  }
1c10: 65 6c 73 65 7b 0a 20 20 20 20 7a 42 75 66 20 3d  else{.    zBuf =
1c20: 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66   sqlite3_mprintf
1c30: 28 22 25 2e 2a 66 22 2c 6e 2c 72 29 3b 0a 20 20  ("%.*f",n,r);.  
1c40: 20 20 69 66 28 20 7a 42 75 66 3d 3d 30 20 29 7b    if( zBuf==0 ){
1c50: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72  .      sqlite3_r
1c60: 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65  esult_error_nome
1c70: 6d 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 20 20  m(context);.    
1c80: 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a    return;.    }.
1c90: 20 20 20 20 73 71 6c 69 74 65 33 41 74 6f 46 28      sqlite3AtoF(
1ca0: 7a 42 75 66 2c 20 26 72 29 3b 0a 20 20 20 20 73  zBuf, &r);.    s
1cb0: 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 42 75 66  qlite3_free(zBuf
1cc0: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  );.  }.  sqlite3
1cd0: 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28 63  _result_double(c
1ce0: 6f 6e 74 65 78 74 2c 20 72 29 3b 0a 7d 0a 23 65  ontext, r);.}.#e
1cf0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f  ndif../*.** Allo
1d00: 63 61 74 65 20 6e 42 79 74 65 20 62 79 74 65 73  cate nByte bytes
1d10: 20 6f 66 20 73 70 61 63 65 20 75 73 69 6e 67 20   of space using 
1d20: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29  sqlite3_malloc()
1d30: 2e 20 49 66 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f  . If the.** allo
1d40: 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c 20 63 61  cation fails, ca
1d50: 6c 6c 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  ll sqlite3_resul
1d60: 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65 6d 28 29 20  t_error_nomem() 
1d70: 74 6f 20 6e 6f 74 69 66 79 0a 2a 2a 20 74 68 65  to notify.** the
1d80: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
1d90: 20 74 68 61 74 20 6d 61 6c 6c 6f 63 28 29 20 68   that malloc() h
1da0: 61 73 20 66 61 69 6c 65 64 20 61 6e 64 20 72 65  as failed and re
1db0: 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2a 20 49 66  turn NULL..** If
1dc0: 20 6e 42 79 74 65 20 69 73 20 6c 61 72 67 65 72   nByte is larger
1dd0: 20 74 68 61 6e 20 74 68 65 20 6d 61 78 69 6d 75   than the maximu
1de0: 6d 20 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62  m string or blob
1df0: 20 6c 65 6e 67 74 68 2c 20 74 68 65 6e 0a 2a 2a   length, then.**
1e00: 20 72 61 69 73 65 20 61 6e 20 53 51 4c 49 54 45   raise an SQLITE
1e10: 5f 54 4f 4f 42 49 47 20 65 78 63 65 70 74 69 6f  _TOOBIG exceptio
1e20: 6e 20 61 6e 64 20 72 65 74 75 72 6e 20 4e 55 4c  n and return NUL
1e30: 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  L..*/.static voi
1e40: 64 20 2a 63 6f 6e 74 65 78 74 4d 61 6c 6c 6f 63  d *contextMalloc
1e50: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
1e60: 20 2a 63 6f 6e 74 65 78 74 2c 20 69 36 34 20 6e   *context, i64 n
1e70: 42 79 74 65 29 7b 0a 20 20 63 68 61 72 20 2a 7a  Byte){.  char *z
1e80: 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20  ;.  sqlite3 *db 
1e90: 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  = sqlite3_contex
1ea0: 74 5f 64 62 5f 68 61 6e 64 6c 65 28 63 6f 6e 74  t_db_handle(cont
1eb0: 65 78 74 29 3b 0a 20 20 61 73 73 65 72 74 28 20  ext);.  assert( 
1ec0: 6e 42 79 74 65 3e 30 20 29 3b 0a 20 20 74 65 73  nByte>0 );.  tes
1ed0: 74 63 61 73 65 28 20 6e 42 79 74 65 3d 3d 64 62  tcase( nByte==db
1ee0: 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f  ->aLimit[SQLITE_
1ef0: 4c 49 4d 49 54 5f 4c 45 4e 47 54 48 5d 20 29 3b  LIMIT_LENGTH] );
1f00: 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e 42 79  .  testcase( nBy
1f10: 74 65 3d 3d 64 62 2d 3e 61 4c 69 6d 69 74 5b 53  te==db->aLimit[S
1f20: 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47  QLITE_LIMIT_LENG
1f30: 54 48 5d 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e  TH]+1 );.  if( n
1f40: 42 79 74 65 3e 64 62 2d 3e 61 4c 69 6d 69 74 5b  Byte>db->aLimit[
1f50: 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e  SQLITE_LIMIT_LEN
1f60: 47 54 48 5d 20 29 7b 0a 20 20 20 20 73 71 6c 69  GTH] ){.    sqli
1f70: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72  te3_result_error
1f80: 5f 74 6f 6f 62 69 67 28 63 6f 6e 74 65 78 74 29  _toobig(context)
1f90: 3b 0a 20 20 20 20 7a 20 3d 20 30 3b 0a 20 20 7d  ;.    z = 0;.  }
1fa0: 65 6c 73 65 7b 0a 20 20 20 20 7a 20 3d 20 73 71  else{.    z = sq
1fb0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 28 69 6e 74  lite3Malloc((int
1fc0: 29 6e 42 79 74 65 29 3b 0a 20 20 20 20 69 66 28  )nByte);.    if(
1fd0: 20 21 7a 20 29 7b 0a 20 20 20 20 20 20 73 71 6c   !z ){.      sql
1fe0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f  ite3_result_erro
1ff0: 72 5f 6e 6f 6d 65 6d 28 63 6f 6e 74 65 78 74 29  r_nomem(context)
2000: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
2010: 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  turn z;.}../*.**
2020: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
2030: 6f 66 20 74 68 65 20 75 70 70 65 72 28 29 20 61  of the upper() a
2040: 6e 64 20 6c 6f 77 65 72 28 29 20 53 51 4c 20 66  nd lower() SQL f
2050: 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 61  unctions..*/.sta
2060: 74 69 63 20 76 6f 69 64 20 75 70 70 65 72 46 75  tic void upperFu
2070: 6e 63 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  nc(sqlite3_conte
2080: 78 74 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74  xt *context, int
2090: 20 61 72 67 63 2c 20 73 71 6c 69 74 65 33 5f 76   argc, sqlite3_v
20a0: 61 6c 75 65 20 2a 2a 61 72 67 76 29 7b 0a 20 20  alue **argv){.  
20b0: 63 68 61 72 20 2a 7a 31 3b 0a 20 20 63 6f 6e 73  char *z1;.  cons
20c0: 74 20 63 68 61 72 20 2a 7a 32 3b 0a 20 20 69 6e  t char *z2;.  in
20d0: 74 20 69 2c 20 6e 3b 0a 20 20 55 4e 55 53 45 44  t i, n;.  UNUSED
20e0: 5f 50 41 52 41 4d 45 54 45 52 28 61 72 67 63 29  _PARAMETER(argc)
20f0: 3b 0a 20 20 7a 32 20 3d 20 28 63 68 61 72 2a 29  ;.  z2 = (char*)
2100: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
2110: 78 74 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 6e  xt(argv[0]);.  n
2120: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
2130: 5f 62 79 74 65 73 28 61 72 67 76 5b 30 5d 29 3b  _bytes(argv[0]);
2140: 0a 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68 61  .  /* Verify tha
2150: 74 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 5f 62  t the call to _b
2160: 79 74 65 73 28 29 20 64 6f 65 73 20 6e 6f 74 20  ytes() does not 
2170: 69 6e 76 61 6c 69 64 61 74 65 20 74 68 65 20 5f  invalidate the _
2180: 74 65 78 74 28 29 20 70 6f 69 6e 74 65 72 20 2a  text() pointer *
2190: 2f 0a 20 20 61 73 73 65 72 74 28 20 7a 32 3d 3d  /.  assert( z2==
21a0: 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76  (char*)sqlite3_v
21b0: 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b 30  alue_text(argv[0
21c0: 5d 29 20 29 3b 0a 20 20 69 66 28 20 7a 32 20 29  ]) );.  if( z2 )
21d0: 7b 0a 20 20 20 20 7a 31 20 3d 20 63 6f 6e 74 65  {.    z1 = conte
21e0: 78 74 4d 61 6c 6c 6f 63 28 63 6f 6e 74 65 78 74  xtMalloc(context
21f0: 2c 20 28 28 69 36 34 29 6e 29 2b 31 29 3b 0a 20  , ((i64)n)+1);. 
2200: 20 20 20 69 66 28 20 7a 31 20 29 7b 0a 20 20 20     if( z1 ){.   
2210: 20 20 20 6d 65 6d 63 70 79 28 7a 31 2c 20 7a 32     memcpy(z1, z2
2220: 2c 20 6e 2b 31 29 3b 0a 20 20 20 20 20 20 66 6f  , n+1);.      fo
2230: 72 28 69 3d 30 3b 20 7a 31 5b 69 5d 3b 20 69 2b  r(i=0; z1[i]; i+
2240: 2b 29 7b 0a 20 20 20 20 20 20 20 20 7a 31 5b 69  +){.        z1[i
2250: 5d 20 3d 20 28 63 68 61 72 29 73 71 6c 69 74 65  ] = (char)sqlite
2260: 33 54 6f 75 70 70 65 72 28 7a 31 5b 69 5d 29 3b  3Toupper(z1[i]);
2270: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73  .      }.      s
2280: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
2290: 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a 31 2c 20  xt(context, z1, 
22a0: 2d 31 2c 20 73 71 6c 69 74 65 33 5f 66 72 65 65  -1, sqlite3_free
22b0: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 73  );.    }.  }.}.s
22c0: 74 61 74 69 63 20 76 6f 69 64 20 6c 6f 77 65 72  tatic void lower
22d0: 46 75 6e 63 28 73 71 6c 69 74 65 33 5f 63 6f 6e  Func(sqlite3_con
22e0: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 20 69  text *context, i
22f0: 6e 74 20 61 72 67 63 2c 20 73 71 6c 69 74 65 33  nt argc, sqlite3
2300: 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 29 7b 0a  _value **argv){.
2310: 20 20 75 38 20 2a 7a 31 3b 0a 20 20 63 6f 6e 73    u8 *z1;.  cons
2320: 74 20 63 68 61 72 20 2a 7a 32 3b 0a 20 20 69 6e  t char *z2;.  in
2330: 74 20 69 2c 20 6e 3b 0a 20 20 55 4e 55 53 45 44  t i, n;.  UNUSED
2340: 5f 50 41 52 41 4d 45 54 45 52 28 61 72 67 63 29  _PARAMETER(argc)
2350: 3b 0a 20 20 7a 32 20 3d 20 28 63 68 61 72 2a 29  ;.  z2 = (char*)
2360: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
2370: 78 74 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 6e  xt(argv[0]);.  n
2380: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
2390: 5f 62 79 74 65 73 28 61 72 67 76 5b 30 5d 29 3b  _bytes(argv[0]);
23a0: 0a 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68 61  .  /* Verify tha
23b0: 74 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 5f 62  t the call to _b
23c0: 79 74 65 73 28 29 20 64 6f 65 73 20 6e 6f 74 20  ytes() does not 
23d0: 69 6e 76 61 6c 69 64 61 74 65 20 74 68 65 20 5f  invalidate the _
23e0: 74 65 78 74 28 29 20 70 6f 69 6e 74 65 72 20 2a  text() pointer *
23f0: 2f 0a 20 20 61 73 73 65 72 74 28 20 7a 32 3d 3d  /.  assert( z2==
2400: 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76  (char*)sqlite3_v
2410: 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b 30  alue_text(argv[0
2420: 5d 29 20 29 3b 0a 20 20 69 66 28 20 7a 32 20 29  ]) );.  if( z2 )
2430: 7b 0a 20 20 20 20 7a 31 20 3d 20 63 6f 6e 74 65  {.    z1 = conte
2440: 78 74 4d 61 6c 6c 6f 63 28 63 6f 6e 74 65 78 74  xtMalloc(context
2450: 2c 20 28 28 69 36 34 29 6e 29 2b 31 29 3b 0a 20  , ((i64)n)+1);. 
2460: 20 20 20 69 66 28 20 7a 31 20 29 7b 0a 20 20 20     if( z1 ){.   
2470: 20 20 20 6d 65 6d 63 70 79 28 7a 31 2c 20 7a 32     memcpy(z1, z2
2480: 2c 20 6e 2b 31 29 3b 0a 20 20 20 20 20 20 66 6f  , n+1);.      fo
2490: 72 28 69 3d 30 3b 20 7a 31 5b 69 5d 3b 20 69 2b  r(i=0; z1[i]; i+
24a0: 2b 29 7b 0a 20 20 20 20 20 20 20 20 7a 31 5b 69  +){.        z1[i
24b0: 5d 20 3d 20 73 71 6c 69 74 65 33 54 6f 6c 6f 77  ] = sqlite3Tolow
24c0: 65 72 28 7a 31 5b 69 5d 29 3b 0a 20 20 20 20 20  er(z1[i]);.     
24d0: 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33   }.      sqlite3
24e0: 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e  _result_text(con
24f0: 74 65 78 74 2c 20 28 63 68 61 72 20 2a 29 7a 31  text, (char *)z1
2500: 2c 20 2d 31 2c 20 73 71 6c 69 74 65 33 5f 66 72  , -1, sqlite3_fr
2510: 65 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d  ee);.    }.  }.}
2520: 0a 0a 0a 23 69 66 20 30 20 20 2f 2a 20 54 68 69  ...#if 0  /* Thi
2530: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 65  s function is ne
2540: 76 65 72 20 75 73 65 64 2e 20 2a 2f 0a 2f 2a 0a  ver used. */./*.
2550: 2a 2a 20 54 68 65 20 43 4f 41 4c 45 53 43 45 28  ** The COALESCE(
2560: 29 20 61 6e 64 20 49 46 4e 55 4c 4c 28 29 20 66  ) and IFNULL() f
2570: 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 20 74 6f  unctions used to
2580: 20 62 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20   be implemented 
2590: 61 73 20 73 68 6f 77 6e 0a 2a 2a 20 68 65 72 65  as shown.** here
25a0: 2e 20 20 42 75 74 20 6e 6f 77 20 74 68 65 79 20  .  But now they 
25b0: 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20  are implemented 
25c0: 61 73 20 56 44 42 45 20 63 6f 64 65 20 73 6f 20  as VDBE code so 
25d0: 74 68 61 74 20 75 6e 75 73 65 64 20 61 72 67 75  that unused argu
25e0: 6d 65 6e 74 73 0a 2a 2a 20 64 6f 20 6e 6f 74 20  ments.** do not 
25f0: 68 61 76 65 20 74 6f 20 62 65 20 63 6f 6d 70 75  have to be compu
2600: 74 65 64 2e 20 20 54 68 69 73 20 6c 65 67 61 63  ted.  This legac
2610: 79 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  y implementation
2620: 20 69 73 20 72 65 74 61 69 6e 65 64 20 61 73 0a   is retained as.
2630: 2a 2a 20 63 6f 6d 6d 65 6e 74 2e 0a 2a 2f 0a 2f  ** comment..*/./
2640: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
2650: 69 6f 6e 20 6f 66 20 74 68 65 20 49 46 4e 55 4c  ion of the IFNUL
2660: 4c 28 29 2c 20 4e 56 4c 28 29 2c 20 61 6e 64 20  L(), NVL(), and 
2670: 43 4f 41 4c 45 53 43 45 28 29 20 66 75 6e 63 74  COALESCE() funct
2680: 69 6f 6e 73 2e 20 20 0a 2a 2a 20 41 6c 6c 20 74  ions.  .** All t
2690: 68 72 65 65 20 64 6f 20 74 68 65 20 73 61 6d 65  hree do the same
26a0: 20 74 68 69 6e 67 2e 20 20 54 68 65 79 20 72 65   thing.  They re
26b0: 74 75 72 6e 20 74 68 65 20 66 69 72 73 74 20 6e  turn the first n
26c0: 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 61 72 67 75 6d  on-NULL.** argum
26d0: 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ent..*/.static v
26e0: 6f 69 64 20 69 66 6e 75 6c 6c 46 75 6e 63 28 0a  oid ifnullFunc(.
26f0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
2700: 74 20 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e  t *context,.  in
2710: 74 20 61 72 67 63 2c 0a 20 20 73 71 6c 69 74 65  t argc,.  sqlite
2720: 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29  3_value **argv.)
2730: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72  {.  int i;.  for
2740: 28 69 3d 30 3b 20 69 3c 61 72 67 63 3b 20 69 2b  (i=0; i<argc; i+
2750: 2b 29 7b 0a 20 20 20 20 69 66 28 20 53 51 4c 49  +){.    if( SQLI
2760: 54 45 5f 4e 55 4c 4c 21 3d 73 71 6c 69 74 65 33  TE_NULL!=sqlite3
2770: 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67 76  _value_type(argv
2780: 5b 69 5d 29 20 29 7b 0a 20 20 20 20 20 20 73 71  [i]) ){.      sq
2790: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c  lite3_result_val
27a0: 75 65 28 63 6f 6e 74 65 78 74 2c 20 61 72 67 76  ue(context, argv
27b0: 5b 69 5d 29 3b 0a 20 20 20 20 20 20 62 72 65 61  [i]);.      brea
27c0: 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 23  k;.    }.  }.}.#
27d0: 65 6e 64 69 66 20 2f 2a 20 4e 4f 54 20 55 53 45  endif /* NOT USE
27e0: 44 20 2a 2f 0a 23 64 65 66 69 6e 65 20 69 66 6e  D */.#define ifn
27f0: 75 6c 6c 46 75 6e 63 20 76 65 72 73 69 6f 6e 46  ullFunc versionF
2800: 75 6e 63 20 20 20 2f 2a 20 53 75 62 73 74 69 74  unc   /* Substit
2810: 75 74 65 20 66 75 6e 63 74 69 6f 6e 20 2d 20 6e  ute function - n
2820: 65 76 65 72 20 63 61 6c 6c 65 64 20 2a 2f 0a 0a  ever called */..
2830: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
2840: 74 69 6f 6e 20 6f 66 20 72 61 6e 64 6f 6d 28 29  tion of random()
2850: 2e 20 20 52 65 74 75 72 6e 20 61 20 72 61 6e 64  .  Return a rand
2860: 6f 6d 20 69 6e 74 65 67 65 72 2e 20 20 0a 2a 2f  om integer.  .*/
2870: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 61 6e  .static void ran
2880: 64 6f 6d 46 75 6e 63 28 0a 20 20 73 71 6c 69 74  domFunc(.  sqlit
2890: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74  e3_context *cont
28a0: 65 78 74 2c 0a 20 20 69 6e 74 20 4e 6f 74 55 73  ext,.  int NotUs
28b0: 65 64 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61  ed,.  sqlite3_va
28c0: 6c 75 65 20 2a 2a 4e 6f 74 55 73 65 64 32 0a 29  lue **NotUsed2.)
28d0: 7b 0a 20 20 73 71 6c 69 74 65 5f 69 6e 74 36 34  {.  sqlite_int64
28e0: 20 72 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52   r;.  UNUSED_PAR
28f0: 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64 2c  AMETER2(NotUsed,
2900: 20 4e 6f 74 55 73 65 64 32 29 3b 0a 20 20 73 71   NotUsed2);.  sq
2910: 6c 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73  lite3_randomness
2920: 28 73 69 7a 65 6f 66 28 72 29 2c 20 26 72 29 3b  (sizeof(r), &r);
2930: 0a 20 20 69 66 28 20 72 3c 30 20 29 7b 0a 20 20  .  if( r<0 ){.  
2940: 20 20 2f 2a 20 57 65 20 6e 65 65 64 20 74 6f 20    /* We need to 
2950: 70 72 65 76 65 6e 74 20 61 20 72 61 6e 64 6f 6d  prevent a random
2960: 20 6e 75 6d 62 65 72 20 6f 66 20 30 78 38 30 30   number of 0x800
2970: 30 30 30 30 30 30 30 30 30 30 30 30 30 20 0a 20  0000000000000 . 
2980: 20 20 20 2a 2a 20 28 6f 72 20 2d 39 32 32 33 33     ** (or -92233
2990: 37 32 30 33 36 38 35 34 37 37 35 38 30 38 29 20  72036854775808) 
29a0: 73 69 6e 63 65 20 77 68 65 6e 20 79 6f 75 20 64  since when you d
29b0: 6f 20 61 62 73 28 29 20 6f 66 20 74 68 61 74 0a  o abs() of that.
29c0: 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66      ** number of
29d0: 20 79 6f 75 20 67 65 74 20 74 68 65 20 73 61 6d   you get the sam
29e0: 65 20 76 61 6c 75 65 20 62 61 63 6b 20 61 67 61  e value back aga
29f0: 69 6e 2e 20 20 54 6f 20 64 6f 20 74 68 69 73 0a  in.  To do this.
2a00: 20 20 20 20 2a 2a 20 69 6e 20 61 20 77 61 79 20      ** in a way 
2a10: 74 68 61 74 20 69 73 20 74 65 73 74 61 62 6c 65  that is testable
2a20: 2c 20 6d 61 73 6b 20 74 68 65 20 73 69 67 6e 20  , mask the sign 
2a30: 62 69 74 20 6f 66 66 20 6f 66 20 6e 65 67 61 74  bit off of negat
2a40: 69 76 65 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65  ive.    ** value
2a50: 73 2c 20 72 65 73 75 6c 74 69 6e 67 20 69 6e 20  s, resulting in 
2a60: 61 20 70 6f 73 69 74 69 76 65 20 76 61 6c 75 65  a positive value
2a70: 2e 20 20 54 68 65 6e 20 74 61 6b 65 20 74 68 65  .  Then take the
2a80: 20 0a 20 20 20 20 2a 2a 20 32 73 20 63 6f 6d 70   .    ** 2s comp
2a90: 6c 65 6d 65 6e 74 20 6f 66 20 74 68 61 74 20 70  lement of that p
2aa0: 6f 73 69 74 69 76 65 20 76 61 6c 75 65 2e 20 20  ositive value.  
2ab0: 54 68 65 20 65 6e 64 20 72 65 73 75 6c 74 20 63  The end result c
2ac0: 61 6e 0a 20 20 20 20 2a 2a 20 74 68 65 72 65 66  an.    ** theref
2ad0: 6f 72 65 20 62 65 20 6e 6f 20 6c 65 73 73 20 74  ore be no less t
2ae0: 68 61 6e 20 2d 39 32 32 33 33 37 32 30 33 36 38  han -92233720368
2af0: 35 34 37 37 35 38 30 37 2e 0a 20 20 20 20 2a 2f  54775807..    */
2b00: 0a 20 20 20 20 72 20 3d 20 2d 28 72 20 5e 20 28  .    r = -(r ^ (
2b10: 28 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29  ((sqlite3_int64)
2b20: 31 29 3c 3c 36 33 29 29 3b 0a 20 20 7d 0a 20 20  1)<<63));.  }.  
2b30: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69  sqlite3_result_i
2b40: 6e 74 36 34 28 63 6f 6e 74 65 78 74 2c 20 72 29  nt64(context, r)
2b50: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  ;.}../*.** Imple
2b60: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 72 61 6e  mentation of ran
2b70: 64 6f 6d 62 6c 6f 62 28 4e 29 2e 20 20 52 65 74  domblob(N).  Ret
2b80: 75 72 6e 20 61 20 72 61 6e 64 6f 6d 20 62 6c 6f  urn a random blo
2b90: 62 0a 2a 2a 20 74 68 61 74 20 69 73 20 4e 20 62  b.** that is N b
2ba0: 79 74 65 73 20 6c 6f 6e 67 2e 0a 2a 2f 0a 73 74  ytes long..*/.st
2bb0: 61 74 69 63 20 76 6f 69 64 20 72 61 6e 64 6f 6d  atic void random
2bc0: 42 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33 5f  Blob(.  sqlite3_
2bd0: 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74  context *context
2be0: 2c 0a 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20  ,.  int argc,.  
2bf0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
2c00: 61 72 67 76 0a 29 7b 0a 20 20 69 6e 74 20 6e 3b  argv.){.  int n;
2c10: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  .  unsigned char
2c20: 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 61   *p;.  assert( a
2c30: 72 67 63 3d 3d 31 20 29 3b 0a 20 20 55 4e 55 53  rgc==1 );.  UNUS
2c40: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 61 72 67  ED_PARAMETER(arg
2c50: 63 29 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65  c);.  n = sqlite
2c60: 33 5f 76 61 6c 75 65 5f 69 6e 74 28 61 72 67 76  3_value_int(argv
2c70: 5b 30 5d 29 3b 0a 20 20 69 66 28 20 6e 3c 31 20  [0]);.  if( n<1 
2c80: 29 7b 0a 20 20 20 20 6e 20 3d 20 31 3b 0a 20 20  ){.    n = 1;.  
2c90: 7d 0a 20 20 70 20 3d 20 63 6f 6e 74 65 78 74 4d  }.  p = contextM
2ca0: 61 6c 6c 6f 63 28 63 6f 6e 74 65 78 74 2c 20 6e  alloc(context, n
2cb0: 29 3b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20  );.  if( p ){.  
2cc0: 20 20 73 71 6c 69 74 65 33 5f 72 61 6e 64 6f 6d    sqlite3_random
2cd0: 6e 65 73 73 28 6e 2c 20 70 29 3b 0a 20 20 20 20  ness(n, p);.    
2ce0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 62  sqlite3_result_b
2cf0: 6c 6f 62 28 63 6f 6e 74 65 78 74 2c 20 28 63 68  lob(context, (ch
2d00: 61 72 2a 29 70 2c 20 6e 2c 20 73 71 6c 69 74 65  ar*)p, n, sqlite
2d10: 33 5f 66 72 65 65 29 3b 0a 20 20 7d 0a 7d 0a 0a  3_free);.  }.}..
2d20: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
2d30: 74 69 6f 6e 20 6f 66 20 74 68 65 20 6c 61 73 74  tion of the last
2d40: 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 29 20  _insert_rowid() 
2d50: 53 51 4c 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54  SQL function.  T
2d60: 68 65 20 72 65 74 75 72 6e 0a 2a 2a 20 76 61 6c  he return.** val
2d70: 75 65 20 69 73 20 74 68 65 20 73 61 6d 65 20 61  ue is the same a
2d80: 73 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6c 61  s the sqlite3_la
2d90: 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28  st_insert_rowid(
2da0: 29 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 2e 0a  ) API function..
2db0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6c  */.static void l
2dc0: 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64  ast_insert_rowid
2dd0: 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74  (.  sqlite3_cont
2de0: 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 20 0a 20  ext *context, . 
2df0: 20 69 6e 74 20 4e 6f 74 55 73 65 64 2c 20 0a 20   int NotUsed, . 
2e00: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
2e10: 2a 4e 6f 74 55 73 65 64 32 0a 29 7b 0a 20 20 73  *NotUsed2.){.  s
2e20: 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 73 71 6c  qlite3 *db = sql
2e30: 69 74 65 33 5f 63 6f 6e 74 65 78 74 5f 64 62 5f  ite3_context_db_
2e40: 68 61 6e 64 6c 65 28 63 6f 6e 74 65 78 74 29 3b  handle(context);
2e50: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45  .  UNUSED_PARAME
2e60: 54 45 52 32 28 4e 6f 74 55 73 65 64 2c 20 4e 6f  TER2(NotUsed, No
2e70: 74 55 73 65 64 32 29 3b 0a 20 20 2f 2a 20 49 4d  tUsed2);.  /* IM
2e80: 50 3a 20 52 2d 35 31 35 31 33 2d 31 32 30 32 36  P: R-51513-12026
2e90: 20 54 68 65 20 6c 61 73 74 5f 69 6e 73 65 72 74   The last_insert
2ea0: 5f 72 6f 77 69 64 28 29 20 53 51 4c 20 66 75 6e  _rowid() SQL fun
2eb0: 63 74 69 6f 6e 20 69 73 20 61 0a 20 20 2a 2a 20  ction is a.  ** 
2ec0: 77 72 61 70 70 65 72 20 61 72 6f 75 6e 64 20 74  wrapper around t
2ed0: 68 65 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f  he sqlite3_last_
2ee0: 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 29 20 43  insert_rowid() C
2ef0: 2f 43 2b 2b 20 69 6e 74 65 72 66 61 63 65 0a 20  /C++ interface. 
2f00: 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 2a 2f   ** function. */
2f10: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
2f20: 74 5f 69 6e 74 36 34 28 63 6f 6e 74 65 78 74 2c  t_int64(context,
2f30: 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e   sqlite3_last_in
2f40: 73 65 72 74 5f 72 6f 77 69 64 28 64 62 29 29 3b  sert_rowid(db));
2f50: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
2f60: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
2f70: 63 68 61 6e 67 65 73 28 29 20 53 51 4c 20 66 75  changes() SQL fu
2f80: 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 4d  nction..**.** IM
2f90: 50 3a 20 52 2d 36 32 30 37 33 2d 31 31 32 30 39  P: R-62073-11209
2fa0: 20 54 68 65 20 63 68 61 6e 67 65 73 28 29 20 53   The changes() S
2fb0: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61  QL function is a
2fc0: 20 77 72 61 70 70 65 72 0a 2a 2a 20 61 72 6f 75   wrapper.** arou
2fd0: 6e 64 20 74 68 65 20 73 71 6c 69 74 65 33 5f 63  nd the sqlite3_c
2fe0: 68 61 6e 67 65 73 28 29 20 43 2f 43 2b 2b 20 66  hanges() C/C++ f
2ff0: 75 6e 63 74 69 6f 6e 20 61 6e 64 20 68 65 6e 63  unction and henc
3000: 65 20 66 6f 6c 6c 6f 77 73 20 74 68 65 20 73 61  e follows the sa
3010: 6d 65 0a 2a 2a 20 72 75 6c 65 73 20 66 6f 72 20  me.** rules for 
3020: 63 6f 75 6e 74 69 6e 67 20 63 68 61 6e 67 65 73  counting changes
3030: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
3040: 20 63 68 61 6e 67 65 73 28 0a 20 20 73 71 6c 69   changes(.  sqli
3050: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e  te3_context *con
3060: 74 65 78 74 2c 0a 20 20 69 6e 74 20 4e 6f 74 55  text,.  int NotU
3070: 73 65 64 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  sed,.  sqlite3_v
3080: 61 6c 75 65 20 2a 2a 4e 6f 74 55 73 65 64 32 0a  alue **NotUsed2.
3090: 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  ){.  sqlite3 *db
30a0: 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65   = sqlite3_conte
30b0: 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 63 6f 6e  xt_db_handle(con
30c0: 74 65 78 74 29 3b 0a 20 20 55 4e 55 53 45 44 5f  text);.  UNUSED_
30d0: 50 41 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73  PARAMETER2(NotUs
30e0: 65 64 2c 20 4e 6f 74 55 73 65 64 32 29 3b 0a 20  ed, NotUsed2);. 
30f0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
3100: 69 6e 74 28 63 6f 6e 74 65 78 74 2c 20 73 71 6c  int(context, sql
3110: 69 74 65 33 5f 63 68 61 6e 67 65 73 28 64 62 29  ite3_changes(db)
3120: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  );.}../*.** Impl
3130: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
3140: 65 20 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73 28  e total_changes(
3150: 29 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 2e 20  ) SQL function. 
3160: 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   The return valu
3170: 65 20 69 73 0a 2a 2a 20 74 68 65 20 73 61 6d 65  e is.** the same
3180: 20 61 73 20 74 68 65 20 73 71 6c 69 74 65 33 5f   as the sqlite3_
3190: 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73 28 29 20  total_changes() 
31a0: 41 50 49 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f  API function..*/
31b0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74 6f 74  .static void tot
31c0: 61 6c 5f 63 68 61 6e 67 65 73 28 0a 20 20 73 71  al_changes(.  sq
31d0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63  lite3_context *c
31e0: 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20 4e 6f  ontext,.  int No
31f0: 74 55 73 65 64 2c 0a 20 20 73 71 6c 69 74 65 33  tUsed,.  sqlite3
3200: 5f 76 61 6c 75 65 20 2a 2a 4e 6f 74 55 73 65 64  _value **NotUsed
3210: 32 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a  2.){.  sqlite3 *
3220: 64 62 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e  db = sqlite3_con
3230: 74 65 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 63  text_db_handle(c
3240: 6f 6e 74 65 78 74 29 3b 0a 20 20 55 4e 55 53 45  ontext);.  UNUSE
3250: 44 5f 50 41 52 41 4d 45 54 45 52 32 28 4e 6f 74  D_PARAMETER2(Not
3260: 55 73 65 64 2c 20 4e 6f 74 55 73 65 64 32 29 3b  Used, NotUsed2);
3270: 0a 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 32 37  .  /* IMP: R-527
3280: 35 36 2d 34 31 39 39 33 20 54 68 69 73 20 66 75  56-41993 This fu
3290: 6e 63 74 69 6f 6e 20 69 73 20 61 20 77 72 61 70  nction is a wrap
32a0: 70 65 72 20 61 72 6f 75 6e 64 20 74 68 65 0a 20  per around the. 
32b0: 20 2a 2a 20 73 71 6c 69 74 65 33 5f 74 6f 74 61   ** sqlite3_tota
32c0: 6c 5f 63 68 61 6e 67 65 73 28 29 20 43 2f 43 2b  l_changes() C/C+
32d0: 2b 20 69 6e 74 65 72 66 61 63 65 2e 20 2a 2f 0a  + interface. */.
32e0: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74    sqlite3_result
32f0: 5f 69 6e 74 28 63 6f 6e 74 65 78 74 2c 20 73 71  _int(context, sq
3300: 6c 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e  lite3_total_chan
3310: 67 65 73 28 64 62 29 29 3b 0a 7d 0a 0a 2f 2a 0a  ges(db));.}../*.
3320: 2a 2a 20 41 20 73 74 72 75 63 74 75 72 65 20 64  ** A structure d
3330: 65 66 69 6e 69 6e 67 20 68 6f 77 20 74 6f 20 64  efining how to d
3340: 6f 20 47 4c 4f 42 2d 73 74 79 6c 65 20 63 6f 6d  o GLOB-style com
3350: 70 61 72 69 73 6f 6e 73 2e 0a 2a 2f 0a 73 74 72  parisons..*/.str
3360: 75 63 74 20 63 6f 6d 70 61 72 65 49 6e 66 6f 20  uct compareInfo 
3370: 7b 0a 20 20 75 38 20 6d 61 74 63 68 41 6c 6c 3b  {.  u8 matchAll;
3380: 0a 20 20 75 38 20 6d 61 74 63 68 4f 6e 65 3b 0a  .  u8 matchOne;.
3390: 20 20 75 38 20 6d 61 74 63 68 53 65 74 3b 0a 20    u8 matchSet;. 
33a0: 20 75 38 20 6e 6f 43 61 73 65 3b 0a 7d 3b 0a 0a   u8 noCase;.};..
33b0: 2f 2a 0a 2a 2a 20 46 6f 72 20 4c 49 4b 45 20 61  /*.** For LIKE a
33c0: 6e 64 20 47 4c 4f 42 20 6d 61 74 63 68 69 6e 67  nd GLOB matching
33d0: 20 6f 6e 20 45 42 43 44 49 43 20 6d 61 63 68 69   on EBCDIC machi
33e0: 6e 65 73 2c 20 61 73 73 75 6d 65 20 74 68 61 74  nes, assume that
33f0: 20 65 76 65 72 79 0a 2a 2a 20 63 68 61 72 61 63   every.** charac
3400: 74 65 72 20 69 73 20 65 78 61 63 74 6c 79 20 6f  ter is exactly o
3410: 6e 65 20 62 79 74 65 20 69 6e 20 73 69 7a 65 2e  ne byte in size.
3420: 20 20 41 6c 73 6f 2c 20 61 6c 6c 20 63 68 61 72    Also, all char
3430: 61 63 74 65 72 73 20 61 72 65 0a 2a 2a 20 61 62  acters are.** ab
3440: 6c 65 20 74 6f 20 70 61 72 74 69 63 69 70 61 74  le to participat
3450: 65 20 69 6e 20 75 70 70 65 72 2d 63 61 73 65 2d  e in upper-case-
3460: 74 6f 2d 6c 6f 77 65 72 2d 63 61 73 65 20 6d 61  to-lower-case ma
3470: 70 70 69 6e 67 73 20 69 6e 20 45 42 43 44 49 43  ppings in EBCDIC
3480: 0a 2a 2a 20 77 68 65 72 65 61 73 20 6f 6e 6c 79  .** whereas only
3490: 20 63 68 61 72 61 63 74 65 72 73 20 6c 65 73 73   characters less
34a0: 20 74 68 61 6e 20 30 78 38 30 20 64 6f 20 69 6e   than 0x80 do in
34b0: 20 41 53 43 49 49 2e 0a 2a 2f 0a 23 69 66 20 64   ASCII..*/.#if d
34c0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 42  efined(SQLITE_EB
34d0: 43 44 49 43 29 0a 23 20 64 65 66 69 6e 65 20 73  CDIC).# define s
34e0: 71 6c 69 74 65 33 55 74 66 38 52 65 61 64 28 41  qlite3Utf8Read(A
34f0: 2c 43 29 20 20 20 20 28 2a 28 41 2b 2b 29 29 0a  ,C)    (*(A++)).
3500: 23 20 64 65 66 69 6e 65 20 47 6c 6f 67 55 70 70  # define GlogUpp
3510: 65 72 54 6f 4c 6f 77 65 72 28 41 29 20 20 20 20  erToLower(A)    
3520: 20 41 20 3d 20 73 71 6c 69 74 65 33 55 70 70 65   A = sqlite3Uppe
3530: 72 54 6f 4c 6f 77 65 72 5b 41 5d 0a 23 65 6c 73  rToLower[A].#els
3540: 65 0a 23 20 64 65 66 69 6e 65 20 47 6c 6f 67 55  e.# define GlogU
3550: 70 70 65 72 54 6f 4c 6f 77 65 72 28 41 29 20 20  pperToLower(A)  
3560: 20 20 20 69 66 28 20 41 3c 30 78 38 30 20 29 7b     if( A<0x80 ){
3570: 20 41 20 3d 20 73 71 6c 69 74 65 33 55 70 70 65   A = sqlite3Uppe
3580: 72 54 6f 4c 6f 77 65 72 5b 41 5d 3b 20 7d 0a 23  rToLower[A]; }.#
3590: 65 6e 64 69 66 0a 0a 73 74 61 74 69 63 20 63 6f  endif..static co
35a0: 6e 73 74 20 73 74 72 75 63 74 20 63 6f 6d 70 61  nst struct compa
35b0: 72 65 49 6e 66 6f 20 67 6c 6f 62 49 6e 66 6f 20  reInfo globInfo 
35c0: 3d 20 7b 20 27 2a 27 2c 20 27 3f 27 2c 20 27 5b  = { '*', '?', '[
35d0: 27 2c 20 30 20 7d 3b 0a 2f 2a 20 54 68 65 20 63  ', 0 };./* The c
35e0: 6f 72 72 65 63 74 20 53 51 4c 2d 39 32 20 62 65  orrect SQL-92 be
35f0: 68 61 76 69 6f 72 20 69 73 20 66 6f 72 20 74 68  havior is for th
3600: 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72 20  e LIKE operator 
3610: 74 6f 20 69 67 6e 6f 72 65 0a 2a 2a 20 63 61 73  to ignore.** cas
3620: 65 2e 20 20 54 68 75 73 20 20 27 61 27 20 4c 49  e.  Thus  'a' LI
3630: 4b 45 20 27 41 27 20 77 6f 75 6c 64 20 62 65 20  KE 'A' would be 
3640: 74 72 75 65 2e 20 2a 2f 0a 73 74 61 74 69 63 20  true. */.static 
3650: 63 6f 6e 73 74 20 73 74 72 75 63 74 20 63 6f 6d  const struct com
3660: 70 61 72 65 49 6e 66 6f 20 6c 69 6b 65 49 6e 66  pareInfo likeInf
3670: 6f 4e 6f 72 6d 20 3d 20 7b 20 27 25 27 2c 20 27  oNorm = { '%', '
3680: 5f 27 2c 20 20 20 30 2c 20 31 20 7d 3b 0a 2f 2a  _',   0, 1 };./*
3690: 20 49 66 20 53 51 4c 49 54 45 5f 43 41 53 45 5f   If SQLITE_CASE_
36a0: 53 45 4e 53 49 54 49 56 45 5f 4c 49 4b 45 20 69  SENSITIVE_LIKE i
36b0: 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20  s defined, then 
36c0: 74 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  the LIKE operato
36d0: 72 0a 2a 2a 20 69 73 20 63 61 73 65 20 73 65 6e  r.** is case sen
36e0: 73 69 74 69 76 65 20 63 61 75 73 69 6e 67 20 27  sitive causing '
36f0: 61 27 20 4c 49 4b 45 20 27 41 27 20 74 6f 20 62  a' LIKE 'A' to b
3700: 65 20 66 61 6c 73 65 20 2a 2f 0a 73 74 61 74 69  e false */.stati
3710: 63 20 63 6f 6e 73 74 20 73 74 72 75 63 74 20 63  c const struct c
3720: 6f 6d 70 61 72 65 49 6e 66 6f 20 6c 69 6b 65 49  ompareInfo likeI
3730: 6e 66 6f 41 6c 74 20 3d 20 7b 20 27 25 27 2c 20  nfoAlt = { '%', 
3740: 27 5f 27 2c 20 20 20 30 2c 20 30 20 7d 3b 0a 0a  '_',   0, 0 };..
3750: 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72 65 20 74 77  /*.** Compare tw
3760: 6f 20 55 54 46 2d 38 20 73 74 72 69 6e 67 73 20  o UTF-8 strings 
3770: 66 6f 72 20 65 71 75 61 6c 69 74 79 20 77 68 65  for equality whe
3780: 72 65 20 74 68 65 20 66 69 72 73 74 20 73 74 72  re the first str
3790: 69 6e 67 20 63 61 6e 0a 2a 2a 20 70 6f 74 65 6e  ing can.** poten
37a0: 74 69 61 6c 6c 79 20 62 65 20 61 20 22 67 6c 6f  tially be a "glo
37b0: 62 22 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 20  b" expression.  
37c0: 52 65 74 75 72 6e 20 74 72 75 65 20 28 31 29 20  Return true (1) 
37d0: 69 66 20 74 68 65 79 0a 2a 2a 20 61 72 65 20 74  if they.** are t
37e0: 68 65 20 73 61 6d 65 20 61 6e 64 20 66 61 6c 73  he same and fals
37f0: 65 20 28 30 29 20 69 66 20 74 68 65 79 20 61 72  e (0) if they ar
3800: 65 20 64 69 66 66 65 72 65 6e 74 2e 0a 2a 2a 0a  e different..**.
3810: 2a 2a 20 47 6c 6f 62 62 69 6e 67 20 72 75 6c 65  ** Globbing rule
3820: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 27 2a  s:.**.**      '*
3830: 27 20 20 20 20 20 20 20 4d 61 74 63 68 65 73 20  '       Matches 
3840: 61 6e 79 20 73 65 71 75 65 6e 63 65 20 6f 66 20  any sequence of 
3850: 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 63 68 61  zero or more cha
3860: 72 61 63 74 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 20  racters..**.**  
3870: 20 20 20 20 27 3f 27 20 20 20 20 20 20 20 4d 61      '?'       Ma
3880: 74 63 68 65 73 20 65 78 61 63 74 6c 79 20 6f 6e  tches exactly on
3890: 65 20 63 68 61 72 61 63 74 65 72 2e 0a 2a 2a 0a  e character..**.
38a0: 2a 2a 20 20 20 20 20 5b 2e 2e 2e 5d 20 20 20 20  **     [...]    
38b0: 20 20 4d 61 74 63 68 65 73 20 6f 6e 65 20 63 68    Matches one ch
38c0: 61 72 61 63 74 65 72 20 66 72 6f 6d 20 74 68 65  aracter from the
38d0: 20 65 6e 63 6c 6f 73 65 64 20 6c 69 73 74 20 6f   enclosed list o
38e0: 66 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  f.**            
38f0: 20 20 20 20 63 68 61 72 61 63 74 65 72 73 2e 0a      characters..
3900: 2a 2a 0a 2a 2a 20 20 20 20 20 5b 5e 2e 2e 2e 5d  **.**     [^...]
3910: 20 20 20 20 20 4d 61 74 63 68 65 73 20 6f 6e 65       Matches one
3920: 20 63 68 61 72 61 63 74 65 72 20 6e 6f 74 20 69   character not i
3930: 6e 20 74 68 65 20 65 6e 63 6c 6f 73 65 64 20 6c  n the enclosed l
3940: 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 57 69 74 68 20  ist..**.** With 
3950: 74 68 65 20 5b 2e 2e 2e 5d 20 61 6e 64 20 5b 5e  the [...] and [^
3960: 2e 2e 2e 5d 20 6d 61 74 63 68 69 6e 67 2c 20 61  ...] matching, a
3970: 20 27 5d 27 20 63 68 61 72 61 63 74 65 72 20 63   ']' character c
3980: 61 6e 20 62 65 20 69 6e 63 6c 75 64 65 64 0a 2a  an be included.*
3990: 2a 20 69 6e 20 74 68 65 20 6c 69 73 74 20 62 79  * in the list by
39a0: 20 6d 61 6b 69 6e 67 20 69 74 20 74 68 65 20 66   making it the f
39b0: 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 61  irst character a
39c0: 66 74 65 72 20 27 5b 27 20 6f 72 20 27 5e 27 2e  fter '[' or '^'.
39d0: 20 20 41 0a 2a 2a 20 72 61 6e 67 65 20 6f 66 20    A.** range of 
39e0: 63 68 61 72 61 63 74 65 72 73 20 63 61 6e 20 62  characters can b
39f0: 65 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e  e specified usin
3a00: 67 20 27 2d 27 2e 20 20 45 78 61 6d 70 6c 65 3a  g '-'.  Example:
3a10: 0a 2a 2a 20 22 5b 61 2d 7a 5d 22 20 6d 61 74 63  .** "[a-z]" matc
3a20: 68 65 73 20 61 6e 79 20 73 69 6e 67 6c 65 20 6c  hes any single l
3a30: 6f 77 65 72 2d 63 61 73 65 20 6c 65 74 74 65 72  ower-case letter
3a40: 2e 20 20 54 6f 20 6d 61 74 63 68 20 61 20 27 2d  .  To match a '-
3a50: 27 2c 20 6d 61 6b 65 0a 2a 2a 20 69 74 20 74 68  ', make.** it th
3a60: 65 20 6c 61 73 74 20 63 68 61 72 61 63 74 65 72  e last character
3a70: 20 69 6e 20 74 68 65 20 6c 69 73 74 2e 0a 2a 2a   in the list..**
3a80: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
3a90: 20 69 73 20 75 73 75 61 6c 6c 79 20 71 75 69 63   is usually quic
3aa0: 6b 2c 20 62 75 74 20 63 61 6e 20 62 65 20 4e 2a  k, but can be N*
3ab0: 2a 32 20 69 6e 20 74 68 65 20 77 6f 72 73 74 20  *2 in the worst 
3ac0: 63 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 48 69 6e 74  case..**.** Hint
3ad0: 73 3a 20 74 6f 20 6d 61 74 63 68 20 27 2a 27 20  s: to match '*' 
3ae0: 6f 72 20 27 3f 27 2c 20 70 75 74 20 74 68 65 6d  or '?', put them
3af0: 20 69 6e 20 22 5b 5d 22 2e 20 20 4c 69 6b 65 20   in "[]".  Like 
3b00: 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  this:.**.**     
3b10: 20 20 20 20 61 62 63 5b 2a 5d 78 79 7a 20 20 20      abc[*]xyz   
3b20: 20 20 20 20 20 4d 61 74 63 68 65 73 20 22 61 62       Matches "ab
3b30: 63 2a 78 79 7a 22 20 6f 6e 6c 79 0a 2a 2f 0a 73  c*xyz" only.*/.s
3b40: 74 61 74 69 63 20 69 6e 74 20 70 61 74 74 65 72  tatic int patter
3b50: 6e 43 6f 6d 70 61 72 65 28 0a 20 20 63 6f 6e 73  nCompare(.  cons
3b60: 74 20 75 38 20 2a 7a 50 61 74 74 65 72 6e 2c 20  t u8 *zPattern, 
3b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
3b80: 54 68 65 20 67 6c 6f 62 20 70 61 74 74 65 72 6e  The glob pattern
3b90: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 75 38 20 2a   */.  const u8 *
3ba0: 7a 53 74 72 69 6e 67 2c 20 20 20 20 20 20 20 20  zString,        
3bb0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 74         /* The st
3bc0: 72 69 6e 67 20 74 6f 20 63 6f 6d 70 61 72 65 20  ring to compare 
3bd0: 61 67 61 69 6e 73 74 20 74 68 65 20 67 6c 6f 62  against the glob
3be0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 73 74 72 75   */.  const stru
3bf0: 63 74 20 63 6f 6d 70 61 72 65 49 6e 66 6f 20 2a  ct compareInfo *
3c00: 70 49 6e 66 6f 2c 20 2f 2a 20 49 6e 66 6f 72 6d  pInfo, /* Inform
3c10: 61 74 69 6f 6e 20 61 62 6f 75 74 20 68 6f 77 20  ation about how 
3c20: 74 6f 20 64 6f 20 74 68 65 20 63 6f 6d 70 61 72  to do the compar
3c30: 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 6e 74  e */.  const int
3c40: 20 65 73 63 20 20 20 20 20 20 20 20 20 20 20 20   esc            
3c50: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 65          /* The e
3c60: 73 63 61 70 65 20 63 68 61 72 61 63 74 65 72 20  scape character 
3c70: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 63 2c 20 63  */.){.  int c, c
3c80: 32 3b 0a 20 20 69 6e 74 20 69 6e 76 65 72 74 3b  2;.  int invert;
3c90: 0a 20 20 69 6e 74 20 73 65 65 6e 3b 0a 20 20 75  .  int seen;.  u
3ca0: 38 20 6d 61 74 63 68 4f 6e 65 20 3d 20 70 49 6e  8 matchOne = pIn
3cb0: 66 6f 2d 3e 6d 61 74 63 68 4f 6e 65 3b 0a 20 20  fo->matchOne;.  
3cc0: 75 38 20 6d 61 74 63 68 41 6c 6c 20 3d 20 70 49  u8 matchAll = pI
3cd0: 6e 66 6f 2d 3e 6d 61 74 63 68 41 6c 6c 3b 0a 20  nfo->matchAll;. 
3ce0: 20 75 38 20 6d 61 74 63 68 53 65 74 20 3d 20 70   u8 matchSet = p
3cf0: 49 6e 66 6f 2d 3e 6d 61 74 63 68 53 65 74 3b 0a  Info->matchSet;.
3d00: 20 20 75 38 20 6e 6f 43 61 73 65 20 3d 20 70 49    u8 noCase = pI
3d10: 6e 66 6f 2d 3e 6e 6f 43 61 73 65 3b 20 0a 20 20  nfo->noCase; .  
3d20: 69 6e 74 20 70 72 65 76 45 73 63 61 70 65 20 3d  int prevEscape =
3d30: 20 30 3b 20 20 20 20 20 2f 2a 20 54 72 75 65 20   0;     /* True 
3d40: 69 66 20 74 68 65 20 70 72 65 76 69 6f 75 73 20  if the previous 
3d50: 63 68 61 72 61 63 74 65 72 20 77 61 73 20 27 65  character was 'e
3d60: 73 63 61 70 65 27 20 2a 2f 0a 0a 20 20 77 68 69  scape' */..  whi
3d70: 6c 65 28 20 28 63 20 3d 20 73 71 6c 69 74 65 33  le( (c = sqlite3
3d80: 55 74 66 38 52 65 61 64 28 7a 50 61 74 74 65 72  Utf8Read(zPatter
3d90: 6e 2c 26 7a 50 61 74 74 65 72 6e 29 29 21 3d 30  n,&zPattern))!=0
3da0: 20 29 7b 0a 20 20 20 20 69 66 28 20 21 70 72 65   ){.    if( !pre
3db0: 76 45 73 63 61 70 65 20 26 26 20 63 3d 3d 6d 61  vEscape && c==ma
3dc0: 74 63 68 41 6c 6c 20 29 7b 0a 20 20 20 20 20 20  tchAll ){.      
3dd0: 77 68 69 6c 65 28 20 28 63 3d 73 71 6c 69 74 65  while( (c=sqlite
3de0: 33 55 74 66 38 52 65 61 64 28 7a 50 61 74 74 65  3Utf8Read(zPatte
3df0: 72 6e 2c 26 7a 50 61 74 74 65 72 6e 29 29 20 3d  rn,&zPattern)) =
3e00: 3d 20 6d 61 74 63 68 41 6c 6c 0a 20 20 20 20 20  = matchAll.     
3e10: 20 20 20 20 20 20 20 20 20 20 7c 7c 20 63 20 3d            || c =
3e20: 3d 20 6d 61 74 63 68 4f 6e 65 20 29 7b 0a 20 20  = matchOne ){.  
3e30: 20 20 20 20 20 20 69 66 28 20 63 3d 3d 6d 61 74        if( c==mat
3e40: 63 68 4f 6e 65 20 26 26 20 73 71 6c 69 74 65 33  chOne && sqlite3
3e50: 55 74 66 38 52 65 61 64 28 7a 53 74 72 69 6e 67  Utf8Read(zString
3e60: 2c 20 26 7a 53 74 72 69 6e 67 29 3d 3d 30 20 29  , &zString)==0 )
3e70: 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75  {.          retu
3e80: 72 6e 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a  rn 0;.        }.
3e90: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
3ea0: 28 20 63 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  ( c==0 ){.      
3eb0: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20    return 1;.    
3ec0: 20 20 7d 65 6c 73 65 20 69 66 28 20 63 3d 3d 65    }else if( c==e
3ed0: 73 63 20 29 7b 0a 20 20 20 20 20 20 20 20 63 20  sc ){.        c 
3ee0: 3d 20 73 71 6c 69 74 65 33 55 74 66 38 52 65 61  = sqlite3Utf8Rea
3ef0: 64 28 7a 50 61 74 74 65 72 6e 2c 20 26 7a 50 61  d(zPattern, &zPa
3f00: 74 74 65 72 6e 29 3b 0a 20 20 20 20 20 20 20 20  ttern);.        
3f10: 69 66 28 20 63 3d 3d 30 20 29 7b 0a 20 20 20 20  if( c==0 ){.    
3f20: 20 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a        return 0;.
3f30: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
3f40: 7d 65 6c 73 65 20 69 66 28 20 63 3d 3d 6d 61 74  }else if( c==mat
3f50: 63 68 53 65 74 20 29 7b 0a 20 20 20 20 20 20 20  chSet ){.       
3f60: 20 61 73 73 65 72 74 28 20 65 73 63 3d 3d 30 20   assert( esc==0 
3f70: 29 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68  );         /* Th
3f80: 69 73 20 69 73 20 47 4c 4f 42 2c 20 6e 6f 74 20  is is GLOB, not 
3f90: 4c 49 4b 45 20 2a 2f 0a 20 20 20 20 20 20 20 20  LIKE */.        
3fa0: 61 73 73 65 72 74 28 20 6d 61 74 63 68 53 65 74  assert( matchSet
3fb0: 3c 30 78 38 30 20 29 3b 20 20 2f 2a 20 27 5b 27  <0x80 );  /* '['
3fc0: 20 69 73 20 61 20 73 69 6e 67 6c 65 2d 62 79 74   is a single-byt
3fd0: 65 20 63 68 61 72 61 63 74 65 72 20 2a 2f 0a 20  e character */. 
3fe0: 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a         while( *z
3ff0: 53 74 72 69 6e 67 20 26 26 20 70 61 74 74 65 72  String && patter
4000: 6e 43 6f 6d 70 61 72 65 28 26 7a 50 61 74 74 65  nCompare(&zPatte
4010: 72 6e 5b 2d 31 5d 2c 7a 53 74 72 69 6e 67 2c 70  rn[-1],zString,p
4020: 49 6e 66 6f 2c 65 73 63 29 3d 3d 30 20 29 7b 0a  Info,esc)==0 ){.
4030: 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45            SQLITE
4040: 5f 53 4b 49 50 5f 55 54 46 38 28 7a 53 74 72 69  _SKIP_UTF8(zStri
4050: 6e 67 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  ng);.        }. 
4060: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 2a 7a         return *z
4070: 53 74 72 69 6e 67 21 3d 30 3b 0a 20 20 20 20 20  String!=0;.     
4080: 20 7d 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20   }.      while( 
4090: 28 63 32 20 3d 20 73 71 6c 69 74 65 33 55 74 66  (c2 = sqlite3Utf
40a0: 38 52 65 61 64 28 7a 53 74 72 69 6e 67 2c 26 7a  8Read(zString,&z
40b0: 53 74 72 69 6e 67 29 29 21 3d 30 20 29 7b 0a 20  String))!=0 ){. 
40c0: 20 20 20 20 20 20 20 69 66 28 20 6e 6f 43 61 73         if( noCas
40d0: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 47  e ){.          G
40e0: 6c 6f 67 55 70 70 65 72 54 6f 4c 6f 77 65 72 28  logUpperToLower(
40f0: 63 32 29 3b 0a 20 20 20 20 20 20 20 20 20 20 47  c2);.          G
4100: 6c 6f 67 55 70 70 65 72 54 6f 4c 6f 77 65 72 28  logUpperToLower(
4110: 63 29 3b 0a 20 20 20 20 20 20 20 20 20 20 77 68  c);.          wh
4120: 69 6c 65 28 20 63 32 20 21 3d 20 30 20 26 26 20  ile( c2 != 0 && 
4130: 63 32 20 21 3d 20 63 20 29 7b 0a 20 20 20 20 20  c2 != c ){.     
4140: 20 20 20 20 20 20 20 63 32 20 3d 20 73 71 6c 69         c2 = sqli
4150: 74 65 33 55 74 66 38 52 65 61 64 28 7a 53 74 72  te3Utf8Read(zStr
4160: 69 6e 67 2c 20 26 7a 53 74 72 69 6e 67 29 3b 0a  ing, &zString);.
4170: 20 20 20 20 20 20 20 20 20 20 20 20 47 6c 6f 67              Glog
4180: 55 70 70 65 72 54 6f 4c 6f 77 65 72 28 63 32 29  UpperToLower(c2)
4190: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  ;.          }.  
41a0: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
41b0: 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 63 32         while( c2
41c0: 20 21 3d 20 30 20 26 26 20 63 32 20 21 3d 20 63   != 0 && c2 != c
41d0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
41e0: 63 32 20 3d 20 73 71 6c 69 74 65 33 55 74 66 38  c2 = sqlite3Utf8
41f0: 52 65 61 64 28 7a 53 74 72 69 6e 67 2c 20 26 7a  Read(zString, &z
4200: 53 74 72 69 6e 67 29 3b 0a 20 20 20 20 20 20 20  String);.       
4210: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20     }.        }. 
4220: 20 20 20 20 20 20 20 69 66 28 20 63 32 3d 3d 30         if( c2==0
4230: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20   ) return 0;.   
4240: 20 20 20 20 20 69 66 28 20 70 61 74 74 65 72 6e       if( pattern
4250: 43 6f 6d 70 61 72 65 28 7a 50 61 74 74 65 72 6e  Compare(zPattern
4260: 2c 7a 53 74 72 69 6e 67 2c 70 49 6e 66 6f 2c 65  ,zString,pInfo,e
4270: 73 63 29 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  sc) ) return 1;.
4280: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65        }.      re
4290: 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d 65 6c 73  turn 0;.    }els
42a0: 65 20 69 66 28 20 21 70 72 65 76 45 73 63 61 70  e if( !prevEscap
42b0: 65 20 26 26 20 63 3d 3d 6d 61 74 63 68 4f 6e 65  e && c==matchOne
42c0: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 71   ){.      if( sq
42d0: 6c 69 74 65 33 55 74 66 38 52 65 61 64 28 7a 53  lite3Utf8Read(zS
42e0: 74 72 69 6e 67 2c 20 26 7a 53 74 72 69 6e 67 29  tring, &zString)
42f0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72  ==0 ){.        r
4300: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20 7d  eturn 0;.      }
4310: 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 63  .    }else if( c
4320: 3d 3d 6d 61 74 63 68 53 65 74 20 29 7b 0a 20 20  ==matchSet ){.  
4330: 20 20 20 20 69 6e 74 20 70 72 69 6f 72 5f 63 20      int prior_c 
4340: 3d 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65 72  = 0;.      asser
4350: 74 28 20 65 73 63 3d 3d 30 20 29 3b 20 20 20 20  t( esc==0 );    
4360: 2f 2a 20 54 68 69 73 20 6f 6e 6c 79 20 6f 63 63  /* This only occ
4370: 75 72 73 20 66 6f 72 20 47 4c 4f 42 2c 20 6e 6f  urs for GLOB, no
4380: 74 20 4c 49 4b 45 20 2a 2f 0a 20 20 20 20 20 20  t LIKE */.      
4390: 73 65 65 6e 20 3d 20 30 3b 0a 20 20 20 20 20 20  seen = 0;.      
43a0: 69 6e 76 65 72 74 20 3d 20 30 3b 0a 20 20 20 20  invert = 0;.    
43b0: 20 20 63 20 3d 20 73 71 6c 69 74 65 33 55 74 66    c = sqlite3Utf
43c0: 38 52 65 61 64 28 7a 53 74 72 69 6e 67 2c 20 26  8Read(zString, &
43d0: 7a 53 74 72 69 6e 67 29 3b 0a 20 20 20 20 20 20  zString);.      
43e0: 69 66 28 20 63 3d 3d 30 20 29 20 72 65 74 75 72  if( c==0 ) retur
43f0: 6e 20 30 3b 0a 20 20 20 20 20 20 63 32 20 3d 20  n 0;.      c2 = 
4400: 73 71 6c 69 74 65 33 55 74 66 38 52 65 61 64 28  sqlite3Utf8Read(
4410: 7a 50 61 74 74 65 72 6e 2c 20 26 7a 50 61 74 74  zPattern, &zPatt
4420: 65 72 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20  ern);.      if( 
4430: 63 32 3d 3d 27 5e 27 20 29 7b 0a 20 20 20 20 20  c2=='^' ){.     
4440: 20 20 20 69 6e 76 65 72 74 20 3d 20 31 3b 0a 20     invert = 1;. 
4450: 20 20 20 20 20 20 20 63 32 20 3d 20 73 71 6c 69         c2 = sqli
4460: 74 65 33 55 74 66 38 52 65 61 64 28 7a 50 61 74  te3Utf8Read(zPat
4470: 74 65 72 6e 2c 20 26 7a 50 61 74 74 65 72 6e 29  tern, &zPattern)
4480: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
4490: 69 66 28 20 63 32 3d 3d 27 5d 27 20 29 7b 0a 20  if( c2==']' ){. 
44a0: 20 20 20 20 20 20 20 69 66 28 20 63 3d 3d 27 5d         if( c==']
44b0: 27 20 29 20 73 65 65 6e 20 3d 20 31 3b 0a 20 20  ' ) seen = 1;.  
44c0: 20 20 20 20 20 20 63 32 20 3d 20 73 71 6c 69 74        c2 = sqlit
44d0: 65 33 55 74 66 38 52 65 61 64 28 7a 50 61 74 74  e3Utf8Read(zPatt
44e0: 65 72 6e 2c 20 26 7a 50 61 74 74 65 72 6e 29 3b  ern, &zPattern);
44f0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 77  .      }.      w
4500: 68 69 6c 65 28 20 63 32 20 26 26 20 63 32 21 3d  hile( c2 && c2!=
4510: 27 5d 27 20 29 7b 0a 20 20 20 20 20 20 20 20 69  ']' ){.        i
4520: 66 28 20 63 32 3d 3d 27 2d 27 20 26 26 20 7a 50  f( c2=='-' && zP
4530: 61 74 74 65 72 6e 5b 30 5d 21 3d 27 5d 27 20 26  attern[0]!=']' &
4540: 26 20 7a 50 61 74 74 65 72 6e 5b 30 5d 21 3d 30  & zPattern[0]!=0
4550: 20 26 26 20 70 72 69 6f 72 5f 63 3e 30 20 29 7b   && prior_c>0 ){
4560: 0a 20 20 20 20 20 20 20 20 20 20 63 32 20 3d 20  .          c2 = 
4570: 73 71 6c 69 74 65 33 55 74 66 38 52 65 61 64 28  sqlite3Utf8Read(
4580: 7a 50 61 74 74 65 72 6e 2c 20 26 7a 50 61 74 74  zPattern, &zPatt
4590: 65 72 6e 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ern);.          
45a0: 69 66 28 20 63 3e 3d 70 72 69 6f 72 5f 63 20 26  if( c>=prior_c &
45b0: 26 20 63 3c 3d 63 32 20 29 20 73 65 65 6e 20 3d  & c<=c2 ) seen =
45c0: 20 31 3b 0a 20 20 20 20 20 20 20 20 20 20 70 72   1;.          pr
45d0: 69 6f 72 5f 63 20 3d 20 30 3b 0a 20 20 20 20 20  ior_c = 0;.     
45e0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
45f0: 20 20 20 20 69 66 28 20 63 3d 3d 63 32 20 29 7b      if( c==c2 ){
4600: 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 65 65  .            see
4610: 6e 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 20  n = 1;.         
4620: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 72 69   }.          pri
4630: 6f 72 5f 63 20 3d 20 63 32 3b 0a 20 20 20 20 20  or_c = c2;.     
4640: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 63 32 20     }.        c2 
4650: 3d 20 73 71 6c 69 74 65 33 55 74 66 38 52 65 61  = sqlite3Utf8Rea
4660: 64 28 7a 50 61 74 74 65 72 6e 2c 20 26 7a 50 61  d(zPattern, &zPa
4670: 74 74 65 72 6e 29 3b 0a 20 20 20 20 20 20 7d 0a  ttern);.      }.
4680: 20 20 20 20 20 20 69 66 28 20 63 32 3d 3d 30 20        if( c2==0 
4690: 7c 7c 20 28 73 65 65 6e 20 5e 20 69 6e 76 65 72  || (seen ^ inver
46a0: 74 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  t)==0 ){.       
46b0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20   return 0;.     
46c0: 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28   }.    }else if(
46d0: 20 65 73 63 3d 3d 63 20 26 26 20 21 70 72 65 76   esc==c && !prev
46e0: 45 73 63 61 70 65 20 29 7b 0a 20 20 20 20 20 20  Escape ){.      
46f0: 70 72 65 76 45 73 63 61 70 65 20 3d 20 31 3b 0a  prevEscape = 1;.
4700: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
4710: 20 63 32 20 3d 20 73 71 6c 69 74 65 33 55 74 66   c2 = sqlite3Utf
4720: 38 52 65 61 64 28 7a 53 74 72 69 6e 67 2c 20 26  8Read(zString, &
4730: 7a 53 74 72 69 6e 67 29 3b 0a 20 20 20 20 20 20  zString);.      
4740: 69 66 28 20 6e 6f 43 61 73 65 20 29 7b 0a 20 20  if( noCase ){.  
4750: 20 20 20 20 20 20 47 6c 6f 67 55 70 70 65 72 54        GlogUpperT
4760: 6f 4c 6f 77 65 72 28 63 29 3b 0a 20 20 20 20 20  oLower(c);.     
4770: 20 20 20 47 6c 6f 67 55 70 70 65 72 54 6f 4c 6f     GlogUpperToLo
4780: 77 65 72 28 63 32 29 3b 0a 20 20 20 20 20 20 7d  wer(c2);.      }
4790: 0a 20 20 20 20 20 20 69 66 28 20 63 21 3d 63 32  .      if( c!=c2
47a0: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75   ){.        retu
47b0: 72 6e 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20  rn 0;.      }.  
47c0: 20 20 20 20 70 72 65 76 45 73 63 61 70 65 20 3d      prevEscape =
47d0: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20   0;.    }.  }.  
47e0: 72 65 74 75 72 6e 20 2a 7a 53 74 72 69 6e 67 3d  return *zString=
47f0: 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 75  =0;.}../*.** Cou
4800: 6e 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  nt the number of
4810: 20 74 69 6d 65 73 20 74 68 61 74 20 74 68 65 20   times that the 
4820: 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72 20 28 6f  LIKE operator (o
4830: 72 20 47 4c 4f 42 20 77 68 69 63 68 20 69 73 0a  r GLOB which is.
4840: 2a 2a 20 6a 75 73 74 20 61 20 76 61 72 69 61 74  ** just a variat
4850: 69 6f 6e 20 6f 66 20 4c 49 4b 45 29 20 67 65 74  ion of LIKE) get
4860: 73 20 63 61 6c 6c 65 64 2e 20 20 54 68 69 73 20  s called.  This 
4870: 69 73 20 75 73 65 64 20 66 6f 72 20 74 65 73 74  is used for test
4880: 69 6e 67 0a 2a 2a 20 6f 6e 6c 79 2e 0a 2a 2f 0a  ing.** only..*/.
4890: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
48a0: 53 54 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c  ST.int sqlite3_l
48b0: 69 6b 65 5f 63 6f 75 6e 74 20 3d 20 30 3b 0a 23  ike_count = 0;.#
48c0: 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d  endif.../*.** Im
48d0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
48e0: 74 68 65 20 6c 69 6b 65 28 29 20 53 51 4c 20 66  the like() SQL f
48f0: 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 20 66  unction.  This f
4900: 75 6e 63 74 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e  unction implemen
4910: 74 73 0a 2a 2a 20 74 68 65 20 62 75 69 6c 64 2d  ts.** the build-
4920: 69 6e 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72  in LIKE operator
4930: 2e 20 20 54 68 65 20 66 69 72 73 74 20 61 72 67  .  The first arg
4940: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e  ument to the fun
4950: 63 74 69 6f 6e 20 69 73 20 74 68 65 0a 2a 2a 20  ction is the.** 
4960: 70 61 74 74 65 72 6e 20 61 6e 64 20 74 68 65 20  pattern and the 
4970: 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20  second argument 
4980: 69 73 20 74 68 65 20 73 74 72 69 6e 67 2e 20 20  is the string.  
4990: 53 6f 2c 20 74 68 65 20 53 51 4c 20 73 74 61 74  So, the SQL stat
49a0: 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a 20 20 20  ements:.**.**   
49b0: 20 20 20 20 41 20 4c 49 4b 45 20 42 0a 2a 2a 0a      A LIKE B.**.
49c0: 2a 2a 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65  ** is implemente
49d0: 64 20 61 73 20 6c 69 6b 65 28 42 2c 41 29 2e 0a  d as like(B,A)..
49e0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 61 6d 65 20  **.** This same 
49f0: 66 75 6e 63 74 69 6f 6e 20 28 77 69 74 68 20 61  function (with a
4a00: 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6d 70 61   different compa
4a10: 72 65 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65  reInfo structure
4a20: 29 20 63 6f 6d 70 75 74 65 73 0a 2a 2a 20 74 68  ) computes.** th
4a30: 65 20 47 4c 4f 42 20 6f 70 65 72 61 74 6f 72 2e  e GLOB operator.
4a40: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
4a50: 6c 69 6b 65 46 75 6e 63 28 0a 20 20 73 71 6c 69  likeFunc(.  sqli
4a60: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e  te3_context *con
4a70: 74 65 78 74 2c 20 0a 20 20 69 6e 74 20 61 72 67  text, .  int arg
4a80: 63 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 76 61  c, .  sqlite3_va
4a90: 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20 20  lue **argv.){.  
4aa0: 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63  const unsigned c
4ab0: 68 61 72 20 2a 7a 41 2c 20 2a 7a 42 3b 0a 20 20  har *zA, *zB;.  
4ac0: 69 6e 74 20 65 73 63 61 70 65 20 3d 20 30 3b 0a  int escape = 0;.
4ad0: 20 20 69 6e 74 20 6e 50 61 74 3b 0a 20 20 73 71    int nPat;.  sq
4ae0: 6c 69 74 65 33 20 2a 64 62 20 3d 20 73 71 6c 69  lite3 *db = sqli
4af0: 74 65 33 5f 63 6f 6e 74 65 78 74 5f 64 62 5f 68  te3_context_db_h
4b00: 61 6e 64 6c 65 28 63 6f 6e 74 65 78 74 29 3b 0a  andle(context);.
4b10: 0a 20 20 7a 42 20 3d 20 73 71 6c 69 74 65 33 5f  .  zB = sqlite3_
4b20: 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b  value_text(argv[
4b30: 30 5d 29 3b 0a 20 20 7a 41 20 3d 20 73 71 6c 69  0]);.  zA = sqli
4b40: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61  te3_value_text(a
4b50: 72 67 76 5b 31 5d 29 3b 0a 0a 20 20 2f 2a 20 4c  rgv[1]);..  /* L
4b60: 69 6d 69 74 20 74 68 65 20 6c 65 6e 67 74 68 20  imit the length 
4b70: 6f 66 20 74 68 65 20 4c 49 4b 45 20 6f 72 20 47  of the LIKE or G
4b80: 4c 4f 42 20 70 61 74 74 65 72 6e 20 74 6f 20 61  LOB pattern to a
4b90: 76 6f 69 64 20 70 72 6f 62 6c 65 6d 73 0a 20 20  void problems.  
4ba0: 2a 2a 20 6f 66 20 64 65 65 70 20 72 65 63 75 72  ** of deep recur
4bb0: 73 69 6f 6e 20 61 6e 64 20 4e 2a 4e 20 62 65 68  sion and N*N beh
4bc0: 61 76 69 6f 72 20 69 6e 20 70 61 74 74 65 72 6e  avior in pattern
4bd0: 43 6f 6d 70 61 72 65 28 29 2e 0a 20 20 2a 2f 0a  Compare()..  */.
4be0: 20 20 6e 50 61 74 20 3d 20 73 71 6c 69 74 65 33    nPat = sqlite3
4bf0: 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 61 72 67  _value_bytes(arg
4c00: 76 5b 30 5d 29 3b 0a 20 20 74 65 73 74 63 61 73  v[0]);.  testcas
4c10: 65 28 20 6e 50 61 74 3d 3d 64 62 2d 3e 61 4c 69  e( nPat==db->aLi
4c20: 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54  mit[SQLITE_LIMIT
4c30: 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45  _LIKE_PATTERN_LE
4c40: 4e 47 54 48 5d 20 29 3b 0a 20 20 74 65 73 74 63  NGTH] );.  testc
4c50: 61 73 65 28 20 6e 50 61 74 3d 3d 64 62 2d 3e 61  ase( nPat==db->a
4c60: 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d  Limit[SQLITE_LIM
4c70: 49 54 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f  IT_LIKE_PATTERN_
4c80: 4c 45 4e 47 54 48 5d 2b 31 20 29 3b 0a 20 20 69  LENGTH]+1 );.  i
4c90: 66 28 20 6e 50 61 74 20 3e 20 64 62 2d 3e 61 4c  f( nPat > db->aL
4ca0: 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49  imit[SQLITE_LIMI
4cb0: 54 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c  T_LIKE_PATTERN_L
4cc0: 45 4e 47 54 48 5d 20 29 7b 0a 20 20 20 20 73 71  ENGTH] ){.    sq
4cd0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
4ce0: 6f 72 28 63 6f 6e 74 65 78 74 2c 20 22 4c 49 4b  or(context, "LIK
4cf0: 45 20 6f 72 20 47 4c 4f 42 20 70 61 74 74 65 72  E or GLOB patter
4d00: 6e 20 74 6f 6f 20 63 6f 6d 70 6c 65 78 22 2c 20  n too complex", 
4d10: 2d 31 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b  -1);.    return;
4d20: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 7a  .  }.  assert( z
4d30: 42 3d 3d 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  B==sqlite3_value
4d40: 5f 74 65 78 74 28 61 72 67 76 5b 30 5d 29 20 29  _text(argv[0]) )
4d50: 3b 20 20 2f 2a 20 45 6e 63 6f 64 69 6e 67 20 64  ;  /* Encoding d
4d60: 69 64 20 6e 6f 74 20 63 68 61 6e 67 65 20 2a 2f  id not change */
4d70: 0a 0a 20 20 69 66 28 20 61 72 67 63 3d 3d 33 20  ..  if( argc==3 
4d80: 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 65 73  ){.    /* The es
4d90: 63 61 70 65 20 63 68 61 72 61 63 74 65 72 20 73  cape character s
4da0: 74 72 69 6e 67 20 6d 75 73 74 20 63 6f 6e 73 69  tring must consi
4db0: 73 74 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 55  st of a single U
4dc0: 54 46 2d 38 20 63 68 61 72 61 63 74 65 72 2e 0a  TF-8 character..
4dd0: 20 20 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 65      ** Otherwise
4de0: 2c 20 72 65 74 75 72 6e 20 61 6e 20 65 72 72 6f  , return an erro
4df0: 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 6f  r..    */.    co
4e00: 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61  nst unsigned cha
4e10: 72 20 2a 7a 45 73 63 20 3d 20 73 71 6c 69 74 65  r *zEsc = sqlite
4e20: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67  3_value_text(arg
4e30: 76 5b 32 5d 29 3b 0a 20 20 20 20 69 66 28 20 7a  v[2]);.    if( z
4e40: 45 73 63 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  Esc==0 ) return;
4e50: 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33  .    if( sqlite3
4e60: 55 74 66 38 43 68 61 72 4c 65 6e 28 28 63 68 61  Utf8CharLen((cha
4e70: 72 2a 29 7a 45 73 63 2c 20 2d 31 29 21 3d 31 20  r*)zEsc, -1)!=1 
4e80: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
4e90: 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 63 6f  _result_error(co
4ea0: 6e 74 65 78 74 2c 20 0a 20 20 20 20 20 20 20 20  ntext, .        
4eb0: 20 20 22 45 53 43 41 50 45 20 65 78 70 72 65 73    "ESCAPE expres
4ec0: 73 69 6f 6e 20 6d 75 73 74 20 62 65 20 61 20 73  sion must be a s
4ed0: 69 6e 67 6c 65 20 63 68 61 72 61 63 74 65 72 22  ingle character"
4ee0: 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 72 65 74  , -1);.      ret
4ef0: 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 65  urn;.    }.    e
4f00: 73 63 61 70 65 20 3d 20 73 71 6c 69 74 65 33 55  scape = sqlite3U
4f10: 74 66 38 52 65 61 64 28 7a 45 73 63 2c 20 26 7a  tf8Read(zEsc, &z
4f20: 45 73 63 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Esc);.  }.  if( 
4f30: 7a 41 20 26 26 20 7a 42 20 29 7b 0a 20 20 20 20  zA && zB ){.    
4f40: 73 74 72 75 63 74 20 63 6f 6d 70 61 72 65 49 6e  struct compareIn
4f50: 66 6f 20 2a 70 49 6e 66 6f 20 3d 20 73 71 6c 69  fo *pInfo = sqli
4f60: 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28 63 6f  te3_user_data(co
4f70: 6e 74 65 78 74 29 3b 0a 23 69 66 64 65 66 20 53  ntext);.#ifdef S
4f80: 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 20 20 73  QLITE_TEST.    s
4f90: 71 6c 69 74 65 33 5f 6c 69 6b 65 5f 63 6f 75 6e  qlite3_like_coun
4fa0: 74 2b 2b 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  t++;.#endif.    
4fb0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73  .    sqlite3_res
4fc0: 75 6c 74 5f 69 6e 74 28 63 6f 6e 74 65 78 74 2c  ult_int(context,
4fd0: 20 70 61 74 74 65 72 6e 43 6f 6d 70 61 72 65 28   patternCompare(
4fe0: 7a 42 2c 20 7a 41 2c 20 70 49 6e 66 6f 2c 20 65  zB, zA, pInfo, e
4ff0: 73 63 61 70 65 29 29 3b 0a 20 20 7d 0a 7d 0a 0a  scape));.  }.}..
5000: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
5010: 74 69 6f 6e 20 6f 66 20 74 68 65 20 4e 55 4c 4c  tion of the NULL
5020: 49 46 28 78 2c 79 29 20 66 75 6e 63 74 69 6f 6e  IF(x,y) function
5030: 2e 20 20 54 68 65 20 72 65 73 75 6c 74 20 69 73  .  The result is
5040: 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72   the first.** ar
5050: 67 75 6d 65 6e 74 20 69 66 20 74 68 65 20 61 72  gument if the ar
5060: 67 75 6d 65 6e 74 73 20 61 72 65 20 64 69 66 66  guments are diff
5070: 65 72 65 6e 74 2e 20 20 54 68 65 20 72 65 73 75  erent.  The resu
5080: 6c 74 20 69 73 20 4e 55 4c 4c 20 69 66 20 74 68  lt is NULL if th
5090: 65 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 73 20 61  e.** arguments a
50a0: 72 65 20 65 71 75 61 6c 20 74 6f 20 65 61 63 68  re equal to each
50b0: 20 6f 74 68 65 72 2e 0a 2a 2f 0a 73 74 61 74 69   other..*/.stati
50c0: 63 20 76 6f 69 64 20 6e 75 6c 6c 69 66 46 75 6e  c void nullifFun
50d0: 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  c(.  sqlite3_con
50e0: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a 20  text *context,. 
50f0: 20 69 6e 74 20 4e 6f 74 55 73 65 64 2c 0a 20 20   int NotUsed,.  
5100: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
5110: 61 72 67 76 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65  argv.){.  CollSe
5120: 71 20 2a 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74  q *pColl = sqlit
5130: 65 33 47 65 74 46 75 6e 63 43 6f 6c 6c 53 65 71  e3GetFuncCollSeq
5140: 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 55 4e 55  (context);.  UNU
5150: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f  SED_PARAMETER(No
5160: 74 55 73 65 64 29 3b 0a 20 20 69 66 28 20 73 71  tUsed);.  if( sq
5170: 6c 69 74 65 33 4d 65 6d 43 6f 6d 70 61 72 65 28  lite3MemCompare(
5180: 61 72 67 76 5b 30 5d 2c 20 61 72 67 76 5b 31 5d  argv[0], argv[1]
5190: 2c 20 70 43 6f 6c 6c 29 21 3d 30 20 29 7b 0a 20  , pColl)!=0 ){. 
51a0: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
51b0: 74 5f 76 61 6c 75 65 28 63 6f 6e 74 65 78 74 2c  t_value(context,
51c0: 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20 7d 0a 7d   argv[0]);.  }.}
51d0: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
51e0: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71  tation of the sq
51f0: 6c 69 74 65 5f 76 65 72 73 69 6f 6e 28 29 20 66  lite_version() f
5200: 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 72 65  unction.  The re
5210: 73 75 6c 74 20 69 73 20 74 68 65 20 76 65 72 73  sult is the vers
5220: 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 53 51  ion.** of the SQ
5230: 4c 69 74 65 20 6c 69 62 72 61 72 79 20 74 68 61  Lite library tha
5240: 74 20 69 73 20 72 75 6e 6e 69 6e 67 2e 0a 2a 2f  t is running..*/
5250: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 76 65 72  .static void ver
5260: 73 69 6f 6e 46 75 6e 63 28 0a 20 20 73 71 6c 69  sionFunc(.  sqli
5270: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e  te3_context *con
5280: 74 65 78 74 2c 0a 20 20 69 6e 74 20 4e 6f 74 55  text,.  int NotU
5290: 73 65 64 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  sed,.  sqlite3_v
52a0: 61 6c 75 65 20 2a 2a 4e 6f 74 55 73 65 64 32 0a  alue **NotUsed2.
52b0: 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41  ){.  UNUSED_PARA
52c0: 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64 2c 20  METER2(NotUsed, 
52d0: 4e 6f 74 55 73 65 64 32 29 3b 0a 20 20 2f 2a 20  NotUsed2);.  /* 
52e0: 49 4d 50 3a 20 52 2d 34 38 36 39 39 2d 34 38 36  IMP: R-48699-486
52f0: 31 37 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  17 This function
5300: 20 69 73 20 61 6e 20 53 51 4c 20 77 72 61 70 70   is an SQL wrapp
5310: 65 72 20 61 72 6f 75 6e 64 20 74 68 65 0a 20 20  er around the.  
5320: 2a 2a 20 73 71 6c 69 74 65 33 5f 6c 69 62 76 65  ** sqlite3_libve
5330: 72 73 69 6f 6e 28 29 20 43 2d 69 6e 74 65 72 66  rsion() C-interf
5340: 61 63 65 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65  ace. */.  sqlite
5350: 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f  3_result_text(co
5360: 6e 74 65 78 74 2c 20 73 71 6c 69 74 65 33 5f 6c  ntext, sqlite3_l
5370: 69 62 76 65 72 73 69 6f 6e 28 29 2c 20 2d 31 2c  ibversion(), -1,
5380: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
5390: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
53a0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
53b0: 73 71 6c 69 74 65 5f 73 6f 75 72 63 65 5f 69 64  sqlite_source_id
53c0: 28 29 20 66 75 6e 63 74 69 6f 6e 2e 20 54 68 65  () function. The
53d0: 20 72 65 73 75 6c 74 20 69 73 20 61 20 73 74 72   result is a str
53e0: 69 6e 67 0a 2a 2a 20 74 68 61 74 20 69 64 65 6e  ing.** that iden
53f0: 74 69 66 69 65 73 20 74 68 65 20 70 61 72 74 69  tifies the parti
5400: 63 75 6c 61 72 20 76 65 72 73 69 6f 6e 20 6f 66  cular version of
5410: 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65   the source code
5420: 20 75 73 65 64 20 74 6f 20 62 75 69 6c 64 0a 2a   used to build.*
5430: 2a 20 53 51 4c 69 74 65 2e 0a 2a 2f 0a 73 74 61  * SQLite..*/.sta
5440: 74 69 63 20 76 6f 69 64 20 73 6f 75 72 63 65 69  tic void sourcei
5450: 64 46 75 6e 63 28 0a 20 20 73 71 6c 69 74 65 33  dFunc(.  sqlite3
5460: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
5470: 74 2c 0a 20 20 69 6e 74 20 4e 6f 74 55 73 65 64  t,.  int NotUsed
5480: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  ,.  sqlite3_valu
5490: 65 20 2a 2a 4e 6f 74 55 73 65 64 32 0a 29 7b 0a  e **NotUsed2.){.
54a0: 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54    UNUSED_PARAMET
54b0: 45 52 32 28 4e 6f 74 55 73 65 64 2c 20 4e 6f 74  ER2(NotUsed, Not
54c0: 55 73 65 64 32 29 3b 0a 20 20 2f 2a 20 49 4d 50  Used2);.  /* IMP
54d0: 3a 20 52 2d 32 34 34 37 30 2d 33 31 31 33 36 20  : R-24470-31136 
54e0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
54f0: 20 61 6e 20 53 51 4c 20 77 72 61 70 70 65 72 20   an SQL wrapper 
5500: 61 72 6f 75 6e 64 20 74 68 65 0a 20 20 2a 2a 20  around the.  ** 
5510: 73 71 6c 69 74 65 33 5f 73 6f 75 72 63 65 69 64  sqlite3_sourceid
5520: 28 29 20 43 20 69 6e 74 65 72 66 61 63 65 2e 20  () C interface. 
5530: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73  */.  sqlite3_res
5540: 75 6c 74 5f 74 65 78 74 28 63 6f 6e 74 65 78 74  ult_text(context
5550: 2c 20 73 71 6c 69 74 65 33 5f 73 6f 75 72 63 65  , sqlite3_source
5560: 69 64 28 29 2c 20 2d 31 2c 20 53 51 4c 49 54 45  id(), -1, SQLITE
5570: 5f 53 54 41 54 49 43 29 3b 0a 7d 0a 0a 2f 2a 0a  _STATIC);.}../*.
5580: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
5590: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 5f  n of the sqlite_
55a0: 63 6f 6d 70 69 6c 65 5f 6f 70 74 73 28 29 20 66  compile_opts() f
55b0: 75 6e 63 74 69 6f 6e 2e 20 54 68 65 20 72 65 73  unction. The res
55c0: 75 6c 74 20 69 73 20 61 20 73 74 72 69 6e 67 0a  ult is a string.
55d0: 2a 2a 20 74 68 61 74 20 69 64 65 6e 74 69 66 69  ** that identifi
55e0: 65 73 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20  es the compiler 
55f0: 6f 70 74 69 6f 6e 73 20 75 73 65 64 20 74 6f 20  options used to 
5600: 62 75 69 6c 64 20 53 51 4c 69 74 65 2e 0a 2a 2f  build SQLite..*/
5610: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f 6d  .static void com
5620: 70 69 6c 65 6f 70 74 73 46 75 6e 63 28 0a 20 20  pileoptsFunc(.  
5630: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
5640: 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20  *context,.  int 
5650: 4e 6f 74 55 73 65 64 2c 0a 20 20 73 71 6c 69 74  NotUsed,.  sqlit
5660: 65 33 5f 76 61 6c 75 65 20 2a 2a 4e 6f 74 55 73  e3_value **NotUs
5670: 65 64 32 0a 29 7b 0a 20 20 55 4e 55 53 45 44 5f  ed2.){.  UNUSED_
5680: 50 41 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73  PARAMETER2(NotUs
5690: 65 64 2c 20 4e 6f 74 55 73 65 64 32 29 3b 0a 20  ed, NotUsed2);. 
56a0: 20 2f 2a 20 49 4d 50 3a 20 52 2d 78 78 78 78 20   /* IMP: R-xxxx 
56b0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
56c0: 20 61 6e 20 53 51 4c 20 77 72 61 70 70 65 72 20   an SQL wrapper 
56d0: 61 72 6f 75 6e 64 20 74 68 65 0a 20 20 2a 2a 20  around the.  ** 
56e0: 73 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 6f  sqlite3_compileo
56f0: 70 74 73 28 29 20 43 20 69 6e 74 65 72 66 61 63  pts() C interfac
5700: 65 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  e. */.  sqlite3_
5710: 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e 74  result_text(cont
5720: 65 78 74 2c 20 73 71 6c 69 74 65 33 5f 63 6f 6d  ext, sqlite3_com
5730: 70 69 6c 65 6f 70 74 73 28 29 2c 20 2d 31 2c 20  pileopts(), -1, 
5740: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
5750: 7d 0a 0a 2f 2a 20 41 72 72 61 79 20 66 6f 72 20  }../* Array for 
5760: 63 6f 6e 76 65 72 74 69 6e 67 20 66 72 6f 6d 20  converting from 
5770: 68 61 6c 66 2d 62 79 74 65 73 20 28 6e 79 62 62  half-bytes (nybb
5780: 6c 65 73 29 20 69 6e 74 6f 20 41 53 43 49 49 20  les) into ASCII 
5790: 68 65 78 0a 2a 2a 20 64 69 67 69 74 73 2e 20 2a  hex.** digits. *
57a0: 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63  /.static const c
57b0: 68 61 72 20 68 65 78 64 69 67 69 74 73 5b 5d 20  har hexdigits[] 
57c0: 3d 20 7b 0a 20 20 27 30 27 2c 20 27 31 27 2c 20  = {.  '0', '1', 
57d0: 27 32 27 2c 20 27 33 27 2c 20 27 34 27 2c 20 27  '2', '3', '4', '
57e0: 35 27 2c 20 27 36 27 2c 20 27 37 27 2c 0a 20 20  5', '6', '7',.  
57f0: 27 38 27 2c 20 27 39 27 2c 20 27 41 27 2c 20 27  '8', '9', 'A', '
5800: 42 27 2c 20 27 43 27 2c 20 27 44 27 2c 20 27 45  B', 'C', 'D', 'E
5810: 27 2c 20 27 46 27 20 0a 7d 3b 0a 0a 2f 2a 0a 2a  ', 'F' .};../*.*
5820: 2a 20 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 2d  * EXPERIMENTAL -
5830: 20 54 68 69 73 20 69 73 20 6e 6f 74 20 61 6e 20   This is not an 
5840: 6f 66 66 69 63 69 61 6c 20 66 75 6e 63 74 69 6f  official functio
5850: 6e 2e 20 20 54 68 65 20 69 6e 74 65 72 66 61 63  n.  The interfac
5860: 65 20 6d 61 79 0a 2a 2a 20 63 68 61 6e 67 65 2e  e may.** change.
5870: 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20    This function 
5880: 6d 61 79 20 64 69 73 61 70 70 65 61 72 2e 20 20  may disappear.  
5890: 44 6f 20 6e 6f 74 20 77 72 69 74 65 20 63 6f 64  Do not write cod
58a0: 65 20 74 68 61 74 20 64 65 70 65 6e 64 73 0a 2a  e that depends.*
58b0: 2a 20 6f 6e 20 74 68 69 73 20 66 75 6e 63 74 69  * on this functi
58c0: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  on..**.** Implem
58d0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
58e0: 51 55 4f 54 45 28 29 20 66 75 6e 63 74 69 6f 6e  QUOTE() function
58f0: 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  .  This function
5900: 20 74 61 6b 65 73 20 61 20 73 69 6e 67 6c 65 0a   takes a single.
5910: 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 66  ** argument.  If
5920: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73   the argument is
5930: 20 6e 75 6d 65 72 69 63 2c 20 74 68 65 20 72 65   numeric, the re
5940: 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 74 68  turn value is th
5950: 65 20 73 61 6d 65 20 61 73 0a 2a 2a 20 74 68 65  e same as.** the
5960: 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 66 20 74   argument.  If t
5970: 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 4e  he argument is N
5980: 55 4c 4c 2c 20 74 68 65 20 72 65 74 75 72 6e 20  ULL, the return 
5990: 76 61 6c 75 65 20 69 73 20 74 68 65 20 73 74 72  value is the str
59a0: 69 6e 67 0a 2a 2a 20 22 4e 55 4c 4c 22 2e 20 20  ing.** "NULL".  
59b0: 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 20 61  Otherwise, the a
59c0: 72 67 75 6d 65 6e 74 20 69 73 20 65 6e 63 6c 6f  rgument is enclo
59d0: 73 65 64 20 69 6e 20 73 69 6e 67 6c 65 20 71 75  sed in single qu
59e0: 6f 74 65 73 20 77 69 74 68 0a 2a 2a 20 73 69 6e  otes with.** sin
59f0: 67 6c 65 2d 71 75 6f 74 65 20 65 73 63 61 70 65  gle-quote escape
5a00: 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  s..*/.static voi
5a10: 64 20 71 75 6f 74 65 46 75 6e 63 28 73 71 6c 69  d quoteFunc(sqli
5a20: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e  te3_context *con
5a30: 74 65 78 74 2c 20 69 6e 74 20 61 72 67 63 2c 20  text, int argc, 
5a40: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
5a50: 61 72 67 76 29 7b 0a 20 20 61 73 73 65 72 74 28  argv){.  assert(
5a60: 20 61 72 67 63 3d 3d 31 20 29 3b 0a 20 20 55 4e   argc==1 );.  UN
5a70: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 61  USED_PARAMETER(a
5a80: 72 67 63 29 3b 0a 20 20 73 77 69 74 63 68 28 20  rgc);.  switch( 
5a90: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79  sqlite3_value_ty
5aa0: 70 65 28 61 72 67 76 5b 30 5d 29 20 29 7b 0a 20  pe(argv[0]) ){. 
5ab0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49     case SQLITE_I
5ac0: 4e 54 45 47 45 52 3a 0a 20 20 20 20 63 61 73 65  NTEGER:.    case
5ad0: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 3a 20 7b   SQLITE_FLOAT: {
5ae0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72  .      sqlite3_r
5af0: 65 73 75 6c 74 5f 76 61 6c 75 65 28 63 6f 6e 74  esult_value(cont
5b00: 65 78 74 2c 20 61 72 67 76 5b 30 5d 29 3b 0a 20  ext, argv[0]);. 
5b10: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
5b20: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  }.    case SQLIT
5b30: 45 5f 42 4c 4f 42 3a 20 7b 0a 20 20 20 20 20 20  E_BLOB: {.      
5b40: 63 68 61 72 20 2a 7a 54 65 78 74 20 3d 20 30 3b  char *zText = 0;
5b50: 0a 20 20 20 20 20 20 63 68 61 72 20 63 6f 6e 73  .      char cons
5b60: 74 20 2a 7a 42 6c 6f 62 20 3d 20 73 71 6c 69 74  t *zBlob = sqlit
5b70: 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 61 72  e3_value_blob(ar
5b80: 67 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 69 6e  gv[0]);.      in
5b90: 74 20 6e 42 6c 6f 62 20 3d 20 73 71 6c 69 74 65  t nBlob = sqlite
5ba0: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 61 72  3_value_bytes(ar
5bb0: 67 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 61 73  gv[0]);.      as
5bc0: 73 65 72 74 28 20 7a 42 6c 6f 62 3d 3d 73 71 6c  sert( zBlob==sql
5bd0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28  ite3_value_blob(
5be0: 61 72 67 76 5b 30 5d 29 20 29 3b 20 2f 2a 20 4e  argv[0]) ); /* N
5bf0: 6f 20 65 6e 63 6f 64 69 6e 67 20 63 68 61 6e 67  o encoding chang
5c00: 65 20 2a 2f 0a 20 20 20 20 20 20 7a 54 65 78 74  e */.      zText
5c10: 20 3d 20 28 63 68 61 72 20 2a 29 63 6f 6e 74 65   = (char *)conte
5c20: 78 74 4d 61 6c 6c 6f 63 28 63 6f 6e 74 65 78 74  xtMalloc(context
5c30: 2c 20 28 32 2a 28 69 36 34 29 6e 42 6c 6f 62 29  , (2*(i64)nBlob)
5c40: 2b 34 29 3b 20 0a 20 20 20 20 20 20 69 66 28 20  +4); .      if( 
5c50: 7a 54 65 78 74 20 29 7b 0a 20 20 20 20 20 20 20  zText ){.       
5c60: 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 20 20   int i;.        
5c70: 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 42 6c 6f 62  for(i=0; i<nBlob
5c80: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20  ; i++){.        
5c90: 20 20 7a 54 65 78 74 5b 28 69 2a 32 29 2b 32 5d    zText[(i*2)+2]
5ca0: 20 3d 20 68 65 78 64 69 67 69 74 73 5b 28 7a 42   = hexdigits[(zB
5cb0: 6c 6f 62 5b 69 5d 3e 3e 34 29 26 30 78 30 46 5d  lob[i]>>4)&0x0F]
5cc0: 3b 0a 20 20 20 20 20 20 20 20 20 20 7a 54 65 78  ;.          zTex
5cd0: 74 5b 28 69 2a 32 29 2b 33 5d 20 3d 20 68 65 78  t[(i*2)+3] = hex
5ce0: 64 69 67 69 74 73 5b 28 7a 42 6c 6f 62 5b 69 5d  digits[(zBlob[i]
5cf0: 29 26 30 78 30 46 5d 3b 0a 20 20 20 20 20 20 20  )&0x0F];.       
5d00: 20 7d 0a 20 20 20 20 20 20 20 20 7a 54 65 78 74   }.        zText
5d10: 5b 28 6e 42 6c 6f 62 2a 32 29 2b 32 5d 20 3d 20  [(nBlob*2)+2] = 
5d20: 27 5c 27 27 3b 0a 20 20 20 20 20 20 20 20 7a 54  '\'';.        zT
5d30: 65 78 74 5b 28 6e 42 6c 6f 62 2a 32 29 2b 33 5d  ext[(nBlob*2)+3]
5d40: 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 20   = '\0';.       
5d50: 20 7a 54 65 78 74 5b 30 5d 20 3d 20 27 58 27 3b   zText[0] = 'X';
5d60: 0a 20 20 20 20 20 20 20 20 7a 54 65 78 74 5b 31  .        zText[1
5d70: 5d 20 3d 20 27 5c 27 27 3b 0a 20 20 20 20 20 20  ] = '\'';.      
5d80: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74    sqlite3_result
5d90: 5f 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a  _text(context, z
5da0: 54 65 78 74 2c 20 2d 31 2c 20 53 51 4c 49 54 45  Text, -1, SQLITE
5db0: 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 20  _TRANSIENT);.   
5dc0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65       sqlite3_fre
5dd0: 65 28 7a 54 65 78 74 29 3b 0a 20 20 20 20 20 20  e(zText);.      
5de0: 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  }.      break;. 
5df0: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51     }.    case SQ
5e00: 4c 49 54 45 5f 54 45 58 54 3a 20 7b 0a 20 20 20  LITE_TEXT: {.   
5e10: 20 20 20 69 6e 74 20 69 2c 6a 3b 0a 20 20 20 20     int i,j;.    
5e20: 20 20 75 36 34 20 6e 3b 0a 20 20 20 20 20 20 63    u64 n;.      c
5e30: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
5e40: 61 72 20 2a 7a 41 72 67 20 3d 20 73 71 6c 69 74  ar *zArg = sqlit
5e50: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72  e3_value_text(ar
5e60: 67 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 63 68  gv[0]);.      ch
5e70: 61 72 20 2a 7a 3b 0a 0a 20 20 20 20 20 20 69 66  ar *z;..      if
5e80: 28 20 7a 41 72 67 3d 3d 30 20 29 20 72 65 74 75  ( zArg==0 ) retu
5e90: 72 6e 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d  rn;.      for(i=
5ea0: 30 2c 20 6e 3d 30 3b 20 7a 41 72 67 5b 69 5d 3b  0, n=0; zArg[i];
5eb0: 20 69 2b 2b 29 7b 20 69 66 28 20 7a 41 72 67 5b   i++){ if( zArg[
5ec0: 69 5d 3d 3d 27 5c 27 27 20 29 20 6e 2b 2b 3b 20  i]=='\'' ) n++; 
5ed0: 7d 0a 20 20 20 20 20 20 7a 20 3d 20 63 6f 6e 74  }.      z = cont
5ee0: 65 78 74 4d 61 6c 6c 6f 63 28 63 6f 6e 74 65 78  extMalloc(contex
5ef0: 74 2c 20 28 28 69 36 34 29 69 29 2b 28 28 69 36  t, ((i64)i)+((i6
5f00: 34 29 6e 29 2b 33 29 3b 0a 20 20 20 20 20 20 69  4)n)+3);.      i
5f10: 66 28 20 7a 20 29 7b 0a 20 20 20 20 20 20 20 20  f( z ){.        
5f20: 7a 5b 30 5d 20 3d 20 27 5c 27 27 3b 0a 20 20 20  z[0] = '\'';.   
5f30: 20 20 20 20 20 66 6f 72 28 69 3d 30 2c 20 6a 3d       for(i=0, j=
5f40: 31 3b 20 7a 41 72 67 5b 69 5d 3b 20 69 2b 2b 29  1; zArg[i]; i++)
5f50: 7b 0a 20 20 20 20 20 20 20 20 20 20 7a 5b 6a 2b  {.          z[j+
5f60: 2b 5d 20 3d 20 7a 41 72 67 5b 69 5d 3b 0a 20 20  +] = zArg[i];.  
5f70: 20 20 20 20 20 20 20 20 69 66 28 20 7a 41 72 67          if( zArg
5f80: 5b 69 5d 3d 3d 27 5c 27 27 20 29 7b 0a 20 20 20  [i]=='\'' ){.   
5f90: 20 20 20 20 20 20 20 20 20 7a 5b 6a 2b 2b 5d 20           z[j++] 
5fa0: 3d 20 27 5c 27 27 3b 0a 20 20 20 20 20 20 20 20  = '\'';.        
5fb0: 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20    }.        }.  
5fc0: 20 20 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d 20 27        z[j++] = '
5fd0: 5c 27 27 3b 0a 20 20 20 20 20 20 20 20 7a 5b 6a  \'';.        z[j
5fe0: 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 73  ] = 0;.        s
5ff0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
6000: 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a 2c 20 6a  xt(context, z, j
6010: 2c 20 73 71 6c 69 74 65 33 5f 66 72 65 65 29 3b  , sqlite3_free);
6020: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62  .      }.      b
6030: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
6040: 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20  default: {.     
6050: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
6060: 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67 76  _value_type(argv
6070: 5b 30 5d 29 3d 3d 53 51 4c 49 54 45 5f 4e 55 4c  [0])==SQLITE_NUL
6080: 4c 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  L );.      sqlit
6090: 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63  e3_result_text(c
60a0: 6f 6e 74 65 78 74 2c 20 22 4e 55 4c 4c 22 2c 20  ontext, "NULL", 
60b0: 34 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43  4, SQLITE_STATIC
60c0: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  );.      break;.
60d0: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a      }.  }.}../*.
60e0: 2a 2a 20 54 68 65 20 68 65 78 28 29 20 66 75 6e  ** The hex() fun
60f0: 63 74 69 6f 6e 2e 20 20 49 6e 74 65 72 70 72 65  ction.  Interpre
6100: 74 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 61  t the argument a
6110: 73 20 61 20 62 6c 6f 62 2e 20 20 52 65 74 75 72  s a blob.  Retur
6120: 6e 0a 2a 2a 20 61 20 68 65 78 61 64 65 63 69 6d  n.** a hexadecim
6130: 61 6c 20 72 65 6e 64 65 72 69 6e 67 20 61 73 20  al rendering as 
6140: 74 65 78 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  text..*/.static 
6150: 76 6f 69 64 20 68 65 78 46 75 6e 63 28 0a 20 20  void hexFunc(.  
6160: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
6170: 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20  *context,.  int 
6180: 61 72 67 63 2c 0a 20 20 73 71 6c 69 74 65 33 5f  argc,.  sqlite3_
6190: 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a  value **argv.){.
61a0: 20 20 69 6e 74 20 69 2c 20 6e 3b 0a 20 20 63 6f    int i, n;.  co
61b0: 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61  nst unsigned cha
61c0: 72 20 2a 70 42 6c 6f 62 3b 0a 20 20 63 68 61 72  r *pBlob;.  char
61d0: 20 2a 7a 48 65 78 2c 20 2a 7a 3b 0a 20 20 61 73   *zHex, *z;.  as
61e0: 73 65 72 74 28 20 61 72 67 63 3d 3d 31 20 29 3b  sert( argc==1 );
61f0: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45  .  UNUSED_PARAME
6200: 54 45 52 28 61 72 67 63 29 3b 0a 20 20 70 42 6c  TER(argc);.  pBl
6210: 6f 62 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c  ob = sqlite3_val
6220: 75 65 5f 62 6c 6f 62 28 61 72 67 76 5b 30 5d 29  ue_blob(argv[0])
6230: 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 5f  ;.  n = sqlite3_
6240: 76 61 6c 75 65 5f 62 79 74 65 73 28 61 72 67 76  value_bytes(argv
6250: 5b 30 5d 29 3b 0a 20 20 61 73 73 65 72 74 28 20  [0]);.  assert( 
6260: 70 42 6c 6f 62 3d 3d 73 71 6c 69 74 65 33 5f 76  pBlob==sqlite3_v
6270: 61 6c 75 65 5f 62 6c 6f 62 28 61 72 67 76 5b 30  alue_blob(argv[0
6280: 5d 29 20 29 3b 20 20 2f 2a 20 4e 6f 20 65 6e 63  ]) );  /* No enc
6290: 6f 64 69 6e 67 20 63 68 61 6e 67 65 20 2a 2f 0a  oding change */.
62a0: 20 20 7a 20 3d 20 7a 48 65 78 20 3d 20 63 6f 6e    z = zHex = con
62b0: 74 65 78 74 4d 61 6c 6c 6f 63 28 63 6f 6e 74 65  textMalloc(conte
62c0: 78 74 2c 20 28 28 69 36 34 29 6e 29 2a 32 20 2b  xt, ((i64)n)*2 +
62d0: 20 31 29 3b 0a 20 20 69 66 28 20 7a 48 65 78 20   1);.  if( zHex 
62e0: 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  ){.    for(i=0; 
62f0: 69 3c 6e 3b 20 69 2b 2b 2c 20 70 42 6c 6f 62 2b  i<n; i++, pBlob+
6300: 2b 29 7b 0a 20 20 20 20 20 20 75 6e 73 69 67 6e  +){.      unsign
6310: 65 64 20 63 68 61 72 20 63 20 3d 20 2a 70 42 6c  ed char c = *pBl
6320: 6f 62 3b 0a 20 20 20 20 20 20 2a 28 7a 2b 2b 29  ob;.      *(z++)
6330: 20 3d 20 68 65 78 64 69 67 69 74 73 5b 28 63 3e   = hexdigits[(c>
6340: 3e 34 29 26 30 78 66 5d 3b 0a 20 20 20 20 20 20  >4)&0xf];.      
6350: 2a 28 7a 2b 2b 29 20 3d 20 68 65 78 64 69 67 69  *(z++) = hexdigi
6360: 74 73 5b 63 26 30 78 66 5d 3b 0a 20 20 20 20 7d  ts[c&0xf];.    }
6370: 0a 20 20 20 20 2a 7a 20 3d 20 30 3b 0a 20 20 20  .    *z = 0;.   
6380: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
6390: 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a 48  text(context, zH
63a0: 65 78 2c 20 6e 2a 32 2c 20 73 71 6c 69 74 65 33  ex, n*2, sqlite3
63b0: 5f 66 72 65 65 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  _free);.  }.}../
63c0: 2a 0a 2a 2a 20 54 68 65 20 7a 65 72 6f 62 6c 6f  *.** The zeroblo
63d0: 62 28 4e 29 20 66 75 6e 63 74 69 6f 6e 20 72 65  b(N) function re
63e0: 74 75 72 6e 73 20 61 20 7a 65 72 6f 2d 66 69 6c  turns a zero-fil
63f0: 6c 65 64 20 62 6c 6f 62 20 6f 66 20 73 69 7a 65  led blob of size
6400: 20 4e 20 62 79 74 65 73 2e 0a 2a 2f 0a 73 74 61   N bytes..*/.sta
6410: 74 69 63 20 76 6f 69 64 20 7a 65 72 6f 62 6c 6f  tic void zeroblo
6420: 62 46 75 6e 63 28 0a 20 20 73 71 6c 69 74 65 33  bFunc(.  sqlite3
6430: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
6440: 74 2c 0a 20 20 69 6e 74 20 61 72 67 63 2c 0a 20  t,.  int argc,. 
6450: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
6460: 2a 61 72 67 76 0a 29 7b 0a 20 20 69 36 34 20 6e  *argv.){.  i64 n
6470: 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20  ;.  sqlite3 *db 
6480: 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  = sqlite3_contex
6490: 74 5f 64 62 5f 68 61 6e 64 6c 65 28 63 6f 6e 74  t_db_handle(cont
64a0: 65 78 74 29 3b 0a 20 20 61 73 73 65 72 74 28 20  ext);.  assert( 
64b0: 61 72 67 63 3d 3d 31 20 29 3b 0a 20 20 55 4e 55  argc==1 );.  UNU
64c0: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 61 72  SED_PARAMETER(ar
64d0: 67 63 29 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 74  gc);.  n = sqlit
64e0: 65 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 61  e3_value_int64(a
64f0: 72 67 76 5b 30 5d 29 3b 0a 20 20 74 65 73 74 63  rgv[0]);.  testc
6500: 61 73 65 28 20 6e 3d 3d 64 62 2d 3e 61 4c 69 6d  ase( n==db->aLim
6510: 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f  it[SQLITE_LIMIT_
6520: 4c 45 4e 47 54 48 5d 20 29 3b 0a 20 20 74 65 73  LENGTH] );.  tes
6530: 74 63 61 73 65 28 20 6e 3d 3d 64 62 2d 3e 61 4c  tcase( n==db->aL
6540: 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49  imit[SQLITE_LIMI
6550: 54 5f 4c 45 4e 47 54 48 5d 2b 31 20 29 3b 0a 20  T_LENGTH]+1 );. 
6560: 20 69 66 28 20 6e 3e 64 62 2d 3e 61 4c 69 6d 69   if( n>db->aLimi
6570: 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c  t[SQLITE_LIMIT_L
6580: 45 4e 47 54 48 5d 20 29 7b 0a 20 20 20 20 73 71  ENGTH] ){.    sq
6590: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
65a0: 6f 72 5f 74 6f 6f 62 69 67 28 63 6f 6e 74 65 78  or_toobig(contex
65b0: 74 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  t);.  }else{.   
65c0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
65d0: 7a 65 72 6f 62 6c 6f 62 28 63 6f 6e 74 65 78 74  zeroblob(context
65e0: 2c 20 28 69 6e 74 29 6e 29 3b 20 2f 2a 20 49 4d  , (int)n); /* IM
65f0: 50 3a 20 52 2d 30 30 32 39 33 2d 36 34 39 39 34  P: R-00293-64994
6600: 20 2a 2f 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a   */.  }.}../*.**
6610: 20 54 68 65 20 72 65 70 6c 61 63 65 28 29 20 66   The replace() f
6620: 75 6e 63 74 69 6f 6e 2e 20 20 54 68 72 65 65 20  unction.  Three 
6630: 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 61 6c  arguments are al
6640: 6c 20 73 74 72 69 6e 67 73 3a 20 63 61 6c 6c 0a  l strings: call.
6650: 2a 2a 20 74 68 65 6d 20 41 2c 20 42 2c 20 61 6e  ** them A, B, an
6660: 64 20 43 2e 20 54 68 65 20 72 65 73 75 6c 74 20  d C. The result 
6670: 69 73 20 61 6c 73 6f 20 61 20 73 74 72 69 6e 67  is also a string
6680: 20 77 68 69 63 68 20 69 73 20 64 65 72 69 76 65   which is derive
6690: 64 0a 2a 2a 20 66 72 6f 6d 20 41 20 62 79 20 72  d.** from A by r
66a0: 65 70 6c 61 63 69 6e 67 20 65 76 65 72 79 20 6f  eplacing every o
66b0: 63 63 75 72 61 6e 63 65 20 6f 66 20 42 20 77 69  ccurance of B wi
66c0: 74 68 20 43 2e 20 20 54 68 65 20 6d 61 74 63 68  th C.  The match
66d0: 0a 2a 2a 20 6d 75 73 74 20 62 65 20 65 78 61 63  .** must be exac
66e0: 74 2e 20 20 43 6f 6c 6c 61 74 69 6e 67 20 73 65  t.  Collating se
66f0: 71 75 65 6e 63 65 73 20 61 72 65 20 6e 6f 74 20  quences are not 
6700: 75 73 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  used..*/.static 
6710: 76 6f 69 64 20 72 65 70 6c 61 63 65 46 75 6e 63  void replaceFunc
6720: 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74  (.  sqlite3_cont
6730: 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a 20 20  ext *context,.  
6740: 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71 6c 69  int argc,.  sqli
6750: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76  te3_value **argv
6760: 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69  .){.  const unsi
6770: 67 6e 65 64 20 63 68 61 72 20 2a 7a 53 74 72 3b  gned char *zStr;
6780: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 69          /* The i
6790: 6e 70 75 74 20 73 74 72 69 6e 67 20 41 20 2a 2f  nput string A */
67a0: 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  .  const unsigne
67b0: 64 20 63 68 61 72 20 2a 7a 50 61 74 74 65 72 6e  d char *zPattern
67c0: 3b 20 20 20 20 2f 2a 20 54 68 65 20 70 61 74 74  ;    /* The patt
67d0: 65 72 6e 20 73 74 72 69 6e 67 20 42 20 2a 2f 0a  ern string B */.
67e0: 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64    const unsigned
67f0: 20 63 68 61 72 20 2a 7a 52 65 70 3b 20 20 20 20   char *zRep;    
6800: 20 20 20 20 2f 2a 20 54 68 65 20 72 65 70 6c 61      /* The repla
6810: 63 65 6d 65 6e 74 20 73 74 72 69 6e 67 20 43 20  cement string C 
6820: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68  */.  unsigned ch
6830: 61 72 20 2a 7a 4f 75 74 3b 20 20 20 20 20 20 20  ar *zOut;       
6840: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 75         /* The ou
6850: 74 70 75 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 53  tput */.  int nS
6860: 74 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  tr;             
6870: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 7a 53     /* Size of zS
6880: 74 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 74  tr */.  int nPat
6890: 74 65 72 6e 3b 20 20 20 20 20 20 20 20 20 20 20  tern;           
68a0: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 7a 50 61 74   /* Size of zPat
68b0: 74 65 72 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 52  tern */.  int nR
68c0: 65 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ep;             
68d0: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 7a 52     /* Size of zR
68e0: 65 70 20 2a 2f 0a 20 20 69 36 34 20 6e 4f 75 74  ep */.  i64 nOut
68f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
6900: 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 73 69 7a 65   /* Maximum size
6910: 20 6f 66 20 7a 4f 75 74 20 2a 2f 0a 20 20 69 6e   of zOut */.  in
6920: 74 20 6c 6f 6f 70 4c 69 6d 69 74 3b 20 20 20 20  t loopLimit;    
6930: 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 7a         /* Last z
6940: 53 74 72 5b 5d 20 74 68 61 74 20 6d 69 67 68 74  Str[] that might
6950: 20 6d 61 74 63 68 20 7a 50 61 74 74 65 72 6e 5b   match zPattern[
6960: 5d 20 2a 2f 0a 20 20 69 6e 74 20 69 2c 20 6a 3b  ] */.  int i, j;
6970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6980: 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 73  /* Loop counters
6990: 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 61   */..  assert( a
69a0: 72 67 63 3d 3d 33 20 29 3b 0a 20 20 55 4e 55 53  rgc==3 );.  UNUS
69b0: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 61 72 67  ED_PARAMETER(arg
69c0: 63 29 3b 0a 20 20 7a 53 74 72 20 3d 20 73 71 6c  c);.  zStr = sql
69d0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28  ite3_value_text(
69e0: 61 72 67 76 5b 30 5d 29 3b 0a 20 20 69 66 28 20  argv[0]);.  if( 
69f0: 7a 53 74 72 3d 3d 30 20 29 20 72 65 74 75 72 6e  zStr==0 ) return
6a00: 3b 0a 20 20 6e 53 74 72 20 3d 20 73 71 6c 69 74  ;.  nStr = sqlit
6a10: 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 61  e3_value_bytes(a
6a20: 72 67 76 5b 30 5d 29 3b 0a 20 20 61 73 73 65 72  rgv[0]);.  asser
6a30: 74 28 20 7a 53 74 72 3d 3d 73 71 6c 69 74 65 33  t( zStr==sqlite3
6a40: 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76  _value_text(argv
6a50: 5b 30 5d 29 20 29 3b 20 20 2f 2a 20 4e 6f 20 65  [0]) );  /* No e
6a60: 6e 63 6f 64 69 6e 67 20 63 68 61 6e 67 65 20 2a  ncoding change *
6a70: 2f 0a 20 20 7a 50 61 74 74 65 72 6e 20 3d 20 73  /.  zPattern = s
6a80: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
6a90: 74 28 61 72 67 76 5b 31 5d 29 3b 0a 20 20 69 66  t(argv[1]);.  if
6aa0: 28 20 7a 50 61 74 74 65 72 6e 3d 3d 30 20 29 7b  ( zPattern==0 ){
6ab0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c  .    assert( sql
6ac0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
6ad0: 61 72 67 76 5b 31 5d 29 3d 3d 53 51 4c 49 54 45  argv[1])==SQLITE
6ae0: 5f 4e 55 4c 4c 0a 20 20 20 20 20 20 20 20 20 20  _NULL.          
6af0: 20 20 7c 7c 20 73 71 6c 69 74 65 33 5f 63 6f 6e    || sqlite3_con
6b00: 74 65 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 63  text_db_handle(c
6b10: 6f 6e 74 65 78 74 29 2d 3e 6d 61 6c 6c 6f 63 46  ontext)->mallocF
6b20: 61 69 6c 65 64 20 29 3b 0a 20 20 20 20 72 65 74  ailed );.    ret
6b30: 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28 20 7a  urn;.  }.  if( z
6b40: 50 61 74 74 65 72 6e 5b 30 5d 3d 3d 30 20 29 7b  Pattern[0]==0 ){
6b50: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c  .    assert( sql
6b60: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
6b70: 61 72 67 76 5b 31 5d 29 21 3d 53 51 4c 49 54 45  argv[1])!=SQLITE
6b80: 5f 4e 55 4c 4c 20 29 3b 0a 20 20 20 20 73 71 6c  _NULL );.    sql
6b90: 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75  ite3_result_valu
6ba0: 65 28 63 6f 6e 74 65 78 74 2c 20 61 72 67 76 5b  e(context, argv[
6bb0: 30 5d 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b  0]);.    return;
6bc0: 0a 20 20 7d 0a 20 20 6e 50 61 74 74 65 72 6e 20  .  }.  nPattern 
6bd0: 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  = sqlite3_value_
6be0: 62 79 74 65 73 28 61 72 67 76 5b 31 5d 29 3b 0a  bytes(argv[1]);.
6bf0: 20 20 61 73 73 65 72 74 28 20 7a 50 61 74 74 65    assert( zPatte
6c00: 72 6e 3d 3d 73 71 6c 69 74 65 33 5f 76 61 6c 75  rn==sqlite3_valu
6c10: 65 5f 74 65 78 74 28 61 72 67 76 5b 31 5d 29 20  e_text(argv[1]) 
6c20: 29 3b 20 20 2f 2a 20 4e 6f 20 65 6e 63 6f 64 69  );  /* No encodi
6c30: 6e 67 20 63 68 61 6e 67 65 20 2a 2f 0a 20 20 7a  ng change */.  z
6c40: 52 65 70 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  Rep = sqlite3_va
6c50: 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b 32 5d  lue_text(argv[2]
6c60: 29 3b 0a 20 20 69 66 28 20 7a 52 65 70 3d 3d 30  );.  if( zRep==0
6c70: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 6e 52 65   ) return;.  nRe
6c80: 70 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  p = sqlite3_valu
6c90: 65 5f 62 79 74 65 73 28 61 72 67 76 5b 32 5d 29  e_bytes(argv[2])
6ca0: 3b 0a 20 20 61 73 73 65 72 74 28 20 7a 52 65 70  ;.  assert( zRep
6cb0: 3d 3d 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ==sqlite3_value_
6cc0: 74 65 78 74 28 61 72 67 76 5b 32 5d 29 20 29 3b  text(argv[2]) );
6cd0: 0a 20 20 6e 4f 75 74 20 3d 20 6e 53 74 72 20 2b  .  nOut = nStr +
6ce0: 20 31 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 4f   1;.  assert( nO
6cf0: 75 74 3c 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45  ut<SQLITE_MAX_LE
6d00: 4e 47 54 48 20 29 3b 0a 20 20 7a 4f 75 74 20 3d  NGTH );.  zOut =
6d10: 20 63 6f 6e 74 65 78 74 4d 61 6c 6c 6f 63 28 63   contextMalloc(c
6d20: 6f 6e 74 65 78 74 2c 20 28 69 36 34 29 6e 4f 75  ontext, (i64)nOu
6d30: 74 29 3b 0a 20 20 69 66 28 20 7a 4f 75 74 3d 3d  t);.  if( zOut==
6d40: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 3b  0 ){.    return;
6d50: 0a 20 20 7d 0a 20 20 6c 6f 6f 70 4c 69 6d 69 74  .  }.  loopLimit
6d60: 20 3d 20 6e 53 74 72 20 2d 20 6e 50 61 74 74 65   = nStr - nPatte
6d70: 72 6e 3b 20 20 0a 20 20 66 6f 72 28 69 3d 6a 3d  rn;  .  for(i=j=
6d80: 30 3b 20 69 3c 3d 6c 6f 6f 70 4c 69 6d 69 74 3b  0; i<=loopLimit;
6d90: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 7a   i++){.    if( z
6da0: 53 74 72 5b 69 5d 21 3d 7a 50 61 74 74 65 72 6e  Str[i]!=zPattern
6db0: 5b 30 5d 20 7c 7c 20 6d 65 6d 63 6d 70 28 26 7a  [0] || memcmp(&z
6dc0: 53 74 72 5b 69 5d 2c 20 7a 50 61 74 74 65 72 6e  Str[i], zPattern
6dd0: 2c 20 6e 50 61 74 74 65 72 6e 29 20 29 7b 0a 20  , nPattern) ){. 
6de0: 20 20 20 20 20 7a 4f 75 74 5b 6a 2b 2b 5d 20 3d       zOut[j++] =
6df0: 20 7a 53 74 72 5b 69 5d 3b 0a 20 20 20 20 7d 65   zStr[i];.    }e
6e00: 6c 73 65 7b 0a 20 20 20 20 20 20 75 38 20 2a 7a  lse{.      u8 *z
6e10: 4f 6c 64 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  Old;.      sqlit
6e20: 65 33 20 2a 64 62 20 3d 20 73 71 6c 69 74 65 33  e3 *db = sqlite3
6e30: 5f 63 6f 6e 74 65 78 74 5f 64 62 5f 68 61 6e 64  _context_db_hand
6e40: 6c 65 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 20  le(context);.   
6e50: 20 20 20 6e 4f 75 74 20 2b 3d 20 6e 52 65 70 20     nOut += nRep 
6e60: 2d 20 6e 50 61 74 74 65 72 6e 3b 0a 20 20 20 20  - nPattern;.    
6e70: 20 20 74 65 73 74 63 61 73 65 28 20 6e 4f 75 74    testcase( nOut
6e80: 2d 31 3d 3d 64 62 2d 3e 61 4c 69 6d 69 74 5b 53  -1==db->aLimit[S
6e90: 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47  QLITE_LIMIT_LENG
6ea0: 54 48 5d 20 29 3b 0a 20 20 20 20 20 20 74 65 73  TH] );.      tes
6eb0: 74 63 61 73 65 28 20 6e 4f 75 74 2d 32 3d 3d 64  tcase( nOut-2==d
6ec0: 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45  b->aLimit[SQLITE
6ed0: 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54 48 5d 20 29  _LIMIT_LENGTH] )
6ee0: 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 4f 75 74  ;.      if( nOut
6ef0: 2d 31 3e 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51  -1>db->aLimit[SQ
6f00: 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54  LITE_LIMIT_LENGT
6f10: 48 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71  H] ){.        sq
6f20: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
6f30: 6f 72 5f 74 6f 6f 62 69 67 28 63 6f 6e 74 65 78  or_toobig(contex
6f40: 74 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  t);.        sqli
6f50: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 4f  te3DbFree(db, zO
6f60: 75 74 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74  ut);.        ret
6f70: 75 72 6e 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  urn;.      }.   
6f80: 20 20 20 7a 4f 6c 64 20 3d 20 7a 4f 75 74 3b 0a     zOld = zOut;.
6f90: 20 20 20 20 20 20 7a 4f 75 74 20 3d 20 73 71 6c        zOut = sql
6fa0: 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 7a 4f 75  ite3_realloc(zOu
6fb0: 74 2c 20 28 69 6e 74 29 6e 4f 75 74 29 3b 0a 20  t, (int)nOut);. 
6fc0: 20 20 20 20 20 69 66 28 20 7a 4f 75 74 3d 3d 30       if( zOut==0
6fd0: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69   ){.        sqli
6fe0: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72  te3_result_error
6ff0: 5f 6e 6f 6d 65 6d 28 63 6f 6e 74 65 78 74 29 3b  _nomem(context);
7000: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
7010: 44 62 46 72 65 65 28 64 62 2c 20 7a 4f 6c 64 29  DbFree(db, zOld)
7020: 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  ;.        return
7030: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
7040: 6d 65 6d 63 70 79 28 26 7a 4f 75 74 5b 6a 5d 2c  memcpy(&zOut[j],
7050: 20 7a 52 65 70 2c 20 6e 52 65 70 29 3b 0a 20 20   zRep, nRep);.  
7060: 20 20 20 20 6a 20 2b 3d 20 6e 52 65 70 3b 0a 20      j += nRep;. 
7070: 20 20 20 20 20 69 20 2b 3d 20 6e 50 61 74 74 65       i += nPatte
7080: 72 6e 2d 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  rn-1;.    }.  }.
7090: 20 20 61 73 73 65 72 74 28 20 6a 2b 6e 53 74 72    assert( j+nStr
70a0: 2d 69 2b 31 3d 3d 6e 4f 75 74 20 29 3b 0a 20 20  -i+1==nOut );.  
70b0: 6d 65 6d 63 70 79 28 26 7a 4f 75 74 5b 6a 5d 2c  memcpy(&zOut[j],
70c0: 20 26 7a 53 74 72 5b 69 5d 2c 20 6e 53 74 72 2d   &zStr[i], nStr-
70d0: 69 29 3b 0a 20 20 6a 20 2b 3d 20 6e 53 74 72 20  i);.  j += nStr 
70e0: 2d 20 69 3b 0a 20 20 61 73 73 65 72 74 28 20 6a  - i;.  assert( j
70f0: 3c 3d 6e 4f 75 74 20 29 3b 0a 20 20 7a 4f 75 74  <=nOut );.  zOut
7100: 5b 6a 5d 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74  [j] = 0;.  sqlit
7110: 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63  e3_result_text(c
7120: 6f 6e 74 65 78 74 2c 20 28 63 68 61 72 2a 29 7a  ontext, (char*)z
7130: 4f 75 74 2c 20 6a 2c 20 73 71 6c 69 74 65 33 5f  Out, j, sqlite3_
7140: 66 72 65 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  free);.}../*.** 
7150: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
7160: 66 20 74 68 65 20 54 52 49 4d 28 29 2c 20 4c 54  f the TRIM(), LT
7170: 52 49 4d 28 29 2c 20 61 6e 64 20 52 54 52 49 4d  RIM(), and RTRIM
7180: 28 29 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a  () functions..**
7190: 20 54 68 65 20 75 73 65 72 64 61 74 61 20 69 73   The userdata is
71a0: 20 30 78 31 20 66 6f 72 20 6c 65 66 74 20 74 72   0x1 for left tr
71b0: 69 6d 2c 20 30 78 32 20 66 6f 72 20 72 69 67 68  im, 0x2 for righ
71c0: 74 20 74 72 69 6d 2c 20 30 78 33 20 66 6f 72 20  t trim, 0x3 for 
71d0: 62 6f 74 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  both..*/.static 
71e0: 76 6f 69 64 20 74 72 69 6d 46 75 6e 63 28 0a 20  void trimFunc(. 
71f0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
7200: 20 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74   *context,.  int
7210: 20 61 72 67 63 2c 0a 20 20 73 71 6c 69 74 65 33   argc,.  sqlite3
7220: 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b  _value **argv.){
7230: 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  .  const unsigne
7240: 64 20 63 68 61 72 20 2a 7a 49 6e 3b 20 20 20 20  d char *zIn;    
7250: 20 20 20 20 20 2f 2a 20 49 6e 70 75 74 20 73 74       /* Input st
7260: 72 69 6e 67 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  ring */.  const 
7270: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 7a  unsigned char *z
7280: 43 68 61 72 53 65 74 3b 20 20 20 20 2f 2a 20 53  CharSet;    /* S
7290: 65 74 20 6f 66 20 63 68 61 72 61 63 74 65 72 73  et of characters
72a0: 20 74 6f 20 74 72 69 6d 20 2a 2f 0a 20 20 69 6e   to trim */.  in
72b0: 74 20 6e 49 6e 3b 20 20 20 20 20 20 20 20 20 20  t nIn;          
72c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
72d0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74  /* Number of byt
72e0: 65 73 20 69 6e 20 69 6e 70 75 74 20 2a 2f 0a 20  es in input */. 
72f0: 20 69 6e 74 20 66 6c 61 67 73 3b 20 20 20 20 20   int flags;     
7300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7310: 20 20 20 2f 2a 20 31 3a 20 74 72 69 6d 6c 65 66     /* 1: trimlef
7320: 74 20 20 32 3a 20 74 72 69 6d 72 69 67 68 74 20  t  2: trimright 
7330: 20 33 3a 20 74 72 69 6d 20 2a 2f 0a 20 20 69 6e   3: trim */.  in
7340: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20  t i;            
7350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7360: 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20  /* Loop counter 
7370: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68  */.  unsigned ch
7380: 61 72 20 2a 61 4c 65 6e 20 3d 20 30 3b 20 20 20  ar *aLen = 0;   
7390: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68         /* Length
73a0: 20 6f 66 20 65 61 63 68 20 63 68 61 72 61 63 74   of each charact
73b0: 65 72 20 69 6e 20 7a 43 68 61 72 53 65 74 20 2a  er in zCharSet *
73c0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61  /.  unsigned cha
73d0: 72 20 2a 2a 61 7a 43 68 61 72 20 3d 20 30 3b 20  r **azChar = 0; 
73e0: 20 20 20 20 20 20 2f 2a 20 49 6e 64 69 76 69 64        /* Individ
73f0: 75 61 6c 20 63 68 61 72 61 63 74 65 72 73 20 69  ual characters i
7400: 6e 20 7a 43 68 61 72 53 65 74 20 2a 2f 0a 20 20  n zCharSet */.  
7410: 69 6e 74 20 6e 43 68 61 72 3b 20 20 20 20 20 20  int nChar;      
7420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7430: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63    /* Number of c
7440: 68 61 72 61 63 74 65 72 73 20 69 6e 20 7a 43 68  haracters in zCh
7450: 61 72 53 65 74 20 2a 2f 0a 0a 20 20 69 66 28 20  arSet */..  if( 
7460: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79  sqlite3_value_ty
7470: 70 65 28 61 72 67 76 5b 30 5d 29 3d 3d 53 51 4c  pe(argv[0])==SQL
7480: 49 54 45 5f 4e 55 4c 4c 20 29 7b 0a 20 20 20 20  ITE_NULL ){.    
7490: 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 7a 49  return;.  }.  zI
74a0: 6e 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  n = sqlite3_valu
74b0: 65 5f 74 65 78 74 28 61 72 67 76 5b 30 5d 29 3b  e_text(argv[0]);
74c0: 0a 20 20 69 66 28 20 7a 49 6e 3d 3d 30 20 29 20  .  if( zIn==0 ) 
74d0: 72 65 74 75 72 6e 3b 0a 20 20 6e 49 6e 20 3d 20  return;.  nIn = 
74e0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79  sqlite3_value_by
74f0: 74 65 73 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20  tes(argv[0]);.  
7500: 61 73 73 65 72 74 28 20 7a 49 6e 3d 3d 73 71 6c  assert( zIn==sql
7510: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28  ite3_value_text(
7520: 61 72 67 76 5b 30 5d 29 20 29 3b 0a 20 20 69 66  argv[0]) );.  if
7530: 28 20 61 72 67 63 3d 3d 31 20 29 7b 0a 20 20 20  ( argc==1 ){.   
7540: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 6e   static const un
7550: 73 69 67 6e 65 64 20 63 68 61 72 20 6c 65 6e 4f  signed char lenO
7560: 6e 65 5b 5d 20 3d 20 7b 20 31 20 7d 3b 0a 20 20  ne[] = { 1 };.  
7570: 20 20 73 74 61 74 69 63 20 75 6e 73 69 67 6e 65    static unsigne
7580: 64 20 63 68 61 72 20 2a 20 63 6f 6e 73 74 20 61  d char * const a
7590: 7a 4f 6e 65 5b 5d 20 3d 20 7b 20 28 75 38 2a 29  zOne[] = { (u8*)
75a0: 22 20 22 20 7d 3b 0a 20 20 20 20 6e 43 68 61 72  " " };.    nChar
75b0: 20 3d 20 31 3b 0a 20 20 20 20 61 4c 65 6e 20 3d   = 1;.    aLen =
75c0: 20 28 75 38 2a 29 6c 65 6e 4f 6e 65 3b 0a 20 20   (u8*)lenOne;.  
75d0: 20 20 61 7a 43 68 61 72 20 3d 20 28 75 6e 73 69    azChar = (unsi
75e0: 67 6e 65 64 20 63 68 61 72 20 2a 2a 29 61 7a 4f  gned char **)azO
75f0: 6e 65 3b 0a 20 20 20 20 7a 43 68 61 72 53 65 74  ne;.    zCharSet
7600: 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66   = 0;.  }else if
7610: 28 20 28 7a 43 68 61 72 53 65 74 20 3d 20 73 71  ( (zCharSet = sq
7620: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
7630: 28 61 72 67 76 5b 31 5d 29 29 3d 3d 30 20 29 7b  (argv[1]))==0 ){
7640: 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d  .    return;.  }
7650: 65 6c 73 65 7b 0a 20 20 20 20 63 6f 6e 73 74 20  else{.    const 
7660: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 7a  unsigned char *z
7670: 3b 0a 20 20 20 20 66 6f 72 28 7a 3d 7a 43 68 61  ;.    for(z=zCha
7680: 72 53 65 74 2c 20 6e 43 68 61 72 3d 30 3b 20 2a  rSet, nChar=0; *
7690: 7a 3b 20 6e 43 68 61 72 2b 2b 29 7b 0a 20 20 20  z; nChar++){.   
76a0: 20 20 20 53 51 4c 49 54 45 5f 53 4b 49 50 5f 55     SQLITE_SKIP_U
76b0: 54 46 38 28 7a 29 3b 0a 20 20 20 20 7d 0a 20 20  TF8(z);.    }.  
76c0: 20 20 69 66 28 20 6e 43 68 61 72 3e 30 20 29 7b    if( nChar>0 ){
76d0: 0a 20 20 20 20 20 20 61 7a 43 68 61 72 20 3d 20  .      azChar = 
76e0: 63 6f 6e 74 65 78 74 4d 61 6c 6c 6f 63 28 63 6f  contextMalloc(co
76f0: 6e 74 65 78 74 2c 20 28 28 69 36 34 29 6e 43 68  ntext, ((i64)nCh
7700: 61 72 29 2a 28 73 69 7a 65 6f 66 28 63 68 61 72  ar)*(sizeof(char
7710: 2a 29 2b 31 29 29 3b 0a 20 20 20 20 20 20 69 66  *)+1));.      if
7720: 28 20 61 7a 43 68 61 72 3d 3d 30 20 29 7b 0a 20  ( azChar==0 ){. 
7730: 20 20 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20         return;. 
7740: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 4c 65       }.      aLe
7750: 6e 20 3d 20 28 75 6e 73 69 67 6e 65 64 20 63 68  n = (unsigned ch
7760: 61 72 2a 29 26 61 7a 43 68 61 72 5b 6e 43 68 61  ar*)&azChar[nCha
7770: 72 5d 3b 0a 20 20 20 20 20 20 66 6f 72 28 7a 3d  r];.      for(z=
7780: 7a 43 68 61 72 53 65 74 2c 20 6e 43 68 61 72 3d  zCharSet, nChar=
7790: 30 3b 20 2a 7a 3b 20 6e 43 68 61 72 2b 2b 29 7b  0; *z; nChar++){
77a0: 0a 20 20 20 20 20 20 20 20 61 7a 43 68 61 72 5b  .        azChar[
77b0: 6e 43 68 61 72 5d 20 3d 20 28 75 6e 73 69 67 6e  nChar] = (unsign
77c0: 65 64 20 63 68 61 72 20 2a 29 7a 3b 0a 20 20 20  ed char *)z;.   
77d0: 20 20 20 20 20 53 51 4c 49 54 45 5f 53 4b 49 50       SQLITE_SKIP
77e0: 5f 55 54 46 38 28 7a 29 3b 0a 20 20 20 20 20 20  _UTF8(z);.      
77f0: 20 20 61 4c 65 6e 5b 6e 43 68 61 72 5d 20 3d 20    aLen[nChar] = 
7800: 28 75 38 29 28 7a 20 2d 20 61 7a 43 68 61 72 5b  (u8)(z - azChar[
7810: 6e 43 68 61 72 5d 29 3b 0a 20 20 20 20 20 20 7d  nChar]);.      }
7820: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28  .    }.  }.  if(
7830: 20 6e 43 68 61 72 3e 30 20 29 7b 0a 20 20 20 20   nChar>0 ){.    
7840: 66 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 5f 50  flags = SQLITE_P
7850: 54 52 5f 54 4f 5f 49 4e 54 28 73 71 6c 69 74 65  TR_TO_INT(sqlite
7860: 33 5f 75 73 65 72 5f 64 61 74 61 28 63 6f 6e 74  3_user_data(cont
7870: 65 78 74 29 29 3b 0a 20 20 20 20 69 66 28 20 66  ext));.    if( f
7880: 6c 61 67 73 20 26 20 31 20 29 7b 0a 20 20 20 20  lags & 1 ){.    
7890: 20 20 77 68 69 6c 65 28 20 6e 49 6e 3e 30 20 29    while( nIn>0 )
78a0: 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6c 65  {.        int le
78b0: 6e 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 66  n = 0;.        f
78c0: 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 68 61 72 3b  or(i=0; i<nChar;
78d0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20   i++){.         
78e0: 20 6c 65 6e 20 3d 20 61 4c 65 6e 5b 69 5d 3b 0a   len = aLen[i];.
78f0: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 6c 65            if( le
7900: 6e 3c 3d 6e 49 6e 20 26 26 20 6d 65 6d 63 6d 70  n<=nIn && memcmp
7910: 28 7a 49 6e 2c 20 61 7a 43 68 61 72 5b 69 5d 2c  (zIn, azChar[i],
7920: 20 6c 65 6e 29 3d 3d 30 20 29 20 62 72 65 61 6b   len)==0 ) break
7930: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
7940: 20 20 20 20 69 66 28 20 69 3e 3d 6e 43 68 61 72      if( i>=nChar
7950: 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20   ) break;.      
7960: 20 20 7a 49 6e 20 2b 3d 20 6c 65 6e 3b 0a 20 20    zIn += len;.  
7970: 20 20 20 20 20 20 6e 49 6e 20 2d 3d 20 6c 65 6e        nIn -= len
7980: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
7990: 20 20 20 20 69 66 28 20 66 6c 61 67 73 20 26 20      if( flags & 
79a0: 32 20 29 7b 0a 20 20 20 20 20 20 77 68 69 6c 65  2 ){.      while
79b0: 28 20 6e 49 6e 3e 30 20 29 7b 0a 20 20 20 20 20  ( nIn>0 ){.     
79c0: 20 20 20 69 6e 74 20 6c 65 6e 20 3d 20 30 3b 0a     int len = 0;.
79d0: 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b          for(i=0;
79e0: 20 69 3c 6e 43 68 61 72 3b 20 69 2b 2b 29 7b 0a   i<nChar; i++){.
79f0: 20 20 20 20 20 20 20 20 20 20 6c 65 6e 20 3d 20            len = 
7a00: 61 4c 65 6e 5b 69 5d 3b 0a 20 20 20 20 20 20 20  aLen[i];.       
7a10: 20 20 20 69 66 28 20 6c 65 6e 3c 3d 6e 49 6e 20     if( len<=nIn 
7a20: 26 26 20 6d 65 6d 63 6d 70 28 26 7a 49 6e 5b 6e  && memcmp(&zIn[n
7a30: 49 6e 2d 6c 65 6e 5d 2c 61 7a 43 68 61 72 5b 69  In-len],azChar[i
7a40: 5d 2c 6c 65 6e 29 3d 3d 30 20 29 20 62 72 65 61  ],len)==0 ) brea
7a50: 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  k;.        }.   
7a60: 20 20 20 20 20 69 66 28 20 69 3e 3d 6e 43 68 61       if( i>=nCha
7a70: 72 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20  r ) break;.     
7a80: 20 20 20 6e 49 6e 20 2d 3d 20 6c 65 6e 3b 0a 20     nIn -= len;. 
7a90: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
7aa0: 20 69 66 28 20 7a 43 68 61 72 53 65 74 20 29 7b   if( zCharSet ){
7ab0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66  .      sqlite3_f
7ac0: 72 65 65 28 61 7a 43 68 61 72 29 3b 0a 20 20 20  ree(azChar);.   
7ad0: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33   }.  }.  sqlite3
7ae0: 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e  _result_text(con
7af0: 74 65 78 74 2c 20 28 63 68 61 72 2a 29 7a 49 6e  text, (char*)zIn
7b00: 2c 20 6e 49 6e 2c 20 53 51 4c 49 54 45 5f 54 52  , nIn, SQLITE_TR
7b10: 41 4e 53 49 45 4e 54 29 3b 0a 7d 0a 0a 0a 2f 2a  ANSIENT);.}.../*
7b20: 20 49 4d 50 3a 20 52 2d 32 35 33 36 31 2d 31 36   IMP: R-25361-16
7b30: 31 35 30 20 54 68 69 73 20 66 75 6e 63 74 69 6f  150 This functio
7b40: 6e 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72 6f  n is omitted fro
7b50: 6d 20 53 51 4c 69 74 65 20 62 79 20 64 65 66 61  m SQLite by defa
7b60: 75 6c 74 2e 20 49 74 0a 2a 2a 20 69 73 20 6f 6e  ult. It.** is on
7b70: 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 69 66 20  ly available if 
7b80: 74 68 65 20 53 51 4c 49 54 45 5f 53 4f 55 4e 44  the SQLITE_SOUND
7b90: 45 58 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  EX compile-time 
7ba0: 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 0a 2a  option is used.*
7bb0: 2a 20 77 68 65 6e 20 53 51 4c 69 74 65 20 69 73  * when SQLite is
7bc0: 20 62 75 69 6c 74 2e 0a 2a 2f 0a 23 69 66 64 65   built..*/.#ifde
7bd0: 66 20 53 51 4c 49 54 45 5f 53 4f 55 4e 44 45 58  f SQLITE_SOUNDEX
7be0: 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 74  ./*.** Compute t
7bf0: 68 65 20 73 6f 75 6e 64 65 78 20 65 6e 63 6f 64  he soundex encod
7c00: 69 6e 67 20 6f 66 20 61 20 77 6f 72 64 2e 0a 2a  ing of a word..*
7c10: 2a 0a 2a 2a 20 49 4d 50 3a 20 52 2d 35 39 37 38  *.** IMP: R-5978
7c20: 32 2d 30 30 30 37 32 20 54 68 65 20 73 6f 75 6e  2-00072 The soun
7c30: 64 65 78 28 58 29 20 66 75 6e 63 74 69 6f 6e 20  dex(X) function 
7c40: 72 65 74 75 72 6e 73 20 61 20 73 74 72 69 6e 67  returns a string
7c50: 20 74 68 61 74 20 69 73 20 74 68 65 0a 2a 2a 20   that is the.** 
7c60: 73 6f 75 6e 64 65 78 20 65 6e 63 6f 64 69 6e 67  soundex encoding
7c70: 20 6f 66 20 74 68 65 20 73 74 72 69 6e 67 20 58   of the string X
7c80: 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  . .*/.static voi
7c90: 64 20 73 6f 75 6e 64 65 78 46 75 6e 63 28 0a 20  d soundexFunc(. 
7ca0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
7cb0: 20 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74   *context,.  int
7cc0: 20 61 72 67 63 2c 0a 20 20 73 71 6c 69 74 65 33   argc,.  sqlite3
7cd0: 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b  _value **argv.){
7ce0: 0a 20 20 63 68 61 72 20 7a 52 65 73 75 6c 74 5b  .  char zResult[
7cf0: 38 5d 3b 0a 20 20 63 6f 6e 73 74 20 75 38 20 2a  8];.  const u8 *
7d00: 7a 49 6e 3b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b  zIn;.  int i, j;
7d10: 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .  static const 
7d20: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 69 43  unsigned char iC
7d30: 6f 64 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 30 2c  ode[] = {.    0,
7d40: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20   0, 0, 0, 0, 0, 
7d50: 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  0, 0, 0, 0, 0, 0
7d60: 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 0a 20 20  , 0, 0, 0, 0,.  
7d70: 20 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c    0, 0, 0, 0, 0,
7d80: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20   0, 0, 0, 0, 0, 
7d90: 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  0, 0, 0, 0, 0, 0
7da0: 2c 0a 20 20 20 20 30 2c 20 30 2c 20 30 2c 20 30  ,.    0, 0, 0, 0
7db0: 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c  , 0, 0, 0, 0, 0,
7dc0: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20   0, 0, 0, 0, 0, 
7dd0: 30 2c 20 30 2c 0a 20 20 20 20 30 2c 20 30 2c 20  0, 0,.    0, 0, 
7de0: 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  0, 0, 0, 0, 0, 0
7df0: 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c  , 0, 0, 0, 0, 0,
7e00: 20 30 2c 20 30 2c 20 30 2c 0a 20 20 20 20 30 2c   0, 0, 0,.    0,
7e10: 20 30 2c 20 31 2c 20 32 2c 20 33 2c 20 30 2c 20   0, 1, 2, 3, 0, 
7e20: 31 2c 20 32 2c 20 30 2c 20 30 2c 20 32 2c 20 32  1, 2, 0, 0, 2, 2
7e30: 2c 20 34 2c 20 35 2c 20 35 2c 20 30 2c 0a 20 20  , 4, 5, 5, 0,.  
7e40: 20 20 31 2c 20 32 2c 20 36 2c 20 32 2c 20 33 2c    1, 2, 6, 2, 3,
7e50: 20 30 2c 20 31 2c 20 30 2c 20 32 2c 20 30 2c 20   0, 1, 0, 2, 0, 
7e60: 32 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  2, 0, 0, 0, 0, 0
7e70: 2c 0a 20 20 20 20 30 2c 20 30 2c 20 31 2c 20 32  ,.    0, 0, 1, 2
7e80: 2c 20 33 2c 20 30 2c 20 31 2c 20 32 2c 20 30 2c  , 3, 0, 1, 2, 0,
7e90: 20 30 2c 20 32 2c 20 32 2c 20 34 2c 20 35 2c 20   0, 2, 2, 4, 5, 
7ea0: 35 2c 20 30 2c 0a 20 20 20 20 31 2c 20 32 2c 20  5, 0,.    1, 2, 
7eb0: 36 2c 20 32 2c 20 33 2c 20 30 2c 20 31 2c 20 30  6, 2, 3, 0, 1, 0
7ec0: 2c 20 32 2c 20 30 2c 20 32 2c 20 30 2c 20 30 2c  , 2, 0, 2, 0, 0,
7ed0: 20 30 2c 20 30 2c 20 30 2c 0a 20 20 7d 3b 0a 20   0, 0, 0,.  };. 
7ee0: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 31   assert( argc==1
7ef0: 20 29 3b 0a 20 20 7a 49 6e 20 3d 20 28 75 38 2a   );.  zIn = (u8*
7f00: 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  )sqlite3_value_t
7f10: 65 78 74 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20  ext(argv[0]);.  
7f20: 69 66 28 20 7a 49 6e 3d 3d 30 20 29 20 7a 49 6e  if( zIn==0 ) zIn
7f30: 20 3d 20 28 75 38 2a 29 22 22 3b 0a 20 20 66 6f   = (u8*)"";.  fo
7f40: 72 28 69 3d 30 3b 20 7a 49 6e 5b 69 5d 20 26 26  r(i=0; zIn[i] &&
7f50: 20 21 73 71 6c 69 74 65 33 49 73 61 6c 70 68 61   !sqlite3Isalpha
7f60: 28 7a 49 6e 5b 69 5d 29 3b 20 69 2b 2b 29 7b 7d  (zIn[i]); i++){}
7f70: 0a 20 20 69 66 28 20 7a 49 6e 5b 69 5d 20 29 7b  .  if( zIn[i] ){
7f80: 0a 20 20 20 20 75 38 20 70 72 65 76 63 6f 64 65  .    u8 prevcode
7f90: 20 3d 20 69 43 6f 64 65 5b 7a 49 6e 5b 69 5d 26   = iCode[zIn[i]&
7fa0: 30 78 37 66 5d 3b 0a 20 20 20 20 7a 52 65 73 75  0x7f];.    zResu
7fb0: 6c 74 5b 30 5d 20 3d 20 73 71 6c 69 74 65 33 54  lt[0] = sqlite3T
7fc0: 6f 75 70 70 65 72 28 7a 49 6e 5b 69 5d 29 3b 0a  oupper(zIn[i]);.
7fd0: 20 20 20 20 66 6f 72 28 6a 3d 31 3b 20 6a 3c 34      for(j=1; j<4
7fe0: 20 26 26 20 7a 49 6e 5b 69 5d 3b 20 69 2b 2b 29   && zIn[i]; i++)
7ff0: 7b 0a 20 20 20 20 20 20 69 6e 74 20 63 6f 64 65  {.      int code
8000: 20 3d 20 69 43 6f 64 65 5b 7a 49 6e 5b 69 5d 26   = iCode[zIn[i]&
8010: 30 78 37 66 5d 3b 0a 20 20 20 20 20 20 69 66 28  0x7f];.      if(
8020: 20 63 6f 64 65 3e 30 20 29 7b 0a 20 20 20 20 20   code>0 ){.     
8030: 20 20 20 69 66 28 20 63 6f 64 65 21 3d 70 72 65     if( code!=pre
8040: 76 63 6f 64 65 20 29 7b 0a 20 20 20 20 20 20 20  vcode ){.       
8050: 20 20 20 70 72 65 76 63 6f 64 65 20 3d 20 63 6f     prevcode = co
8060: 64 65 3b 0a 20 20 20 20 20 20 20 20 20 20 7a 52  de;.          zR
8070: 65 73 75 6c 74 5b 6a 2b 2b 5d 20 3d 20 63 6f 64  esult[j++] = cod
8080: 65 20 2b 20 27 30 27 3b 0a 20 20 20 20 20 20 20  e + '0';.       
8090: 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a   }.      }else{.
80a0: 20 20 20 20 20 20 20 20 70 72 65 76 63 6f 64 65          prevcode
80b0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20   = 0;.      }.  
80c0: 20 20 7d 0a 20 20 20 20 77 68 69 6c 65 28 20 6a    }.    while( j
80d0: 3c 34 20 29 7b 0a 20 20 20 20 20 20 7a 52 65 73  <4 ){.      zRes
80e0: 75 6c 74 5b 6a 2b 2b 5d 20 3d 20 27 30 27 3b 0a  ult[j++] = '0';.
80f0: 20 20 20 20 7d 0a 20 20 20 20 7a 52 65 73 75 6c      }.    zResul
8100: 74 5b 6a 5d 20 3d 20 30 3b 0a 20 20 20 20 73 71  t[j] = 0;.    sq
8110: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78  lite3_result_tex
8120: 74 28 63 6f 6e 74 65 78 74 2c 20 7a 52 65 73 75  t(context, zResu
8130: 6c 74 2c 20 34 2c 20 53 51 4c 49 54 45 5f 54 52  lt, 4, SQLITE_TR
8140: 41 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 65 6c 73  ANSIENT);.  }els
8150: 65 7b 0a 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52  e{.    /* IMP: R
8160: 2d 36 34 38 39 34 2d 35 30 33 32 31 20 54 68 65  -64894-50321 The
8170: 20 73 74 72 69 6e 67 20 22 3f 30 30 30 22 20 69   string "?000" i
8180: 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68  s returned if th
8190: 65 20 61 72 67 75 6d 65 6e 74 0a 20 20 20 20 2a  e argument.    *
81a0: 2a 20 69 73 20 4e 55 4c 4c 20 6f 72 20 63 6f 6e  * is NULL or con
81b0: 74 61 69 6e 73 20 6e 6f 20 41 53 43 49 49 20 61  tains no ASCII a
81c0: 6c 70 68 61 62 65 74 69 63 20 63 68 61 72 61 63  lphabetic charac
81d0: 74 65 72 73 2e 20 2a 2f 0a 20 20 20 20 73 71 6c  ters. */.    sql
81e0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74  ite3_result_text
81f0: 28 63 6f 6e 74 65 78 74 2c 20 22 3f 30 30 30 22  (context, "?000"
8200: 2c 20 34 2c 20 53 51 4c 49 54 45 5f 53 54 41 54  , 4, SQLITE_STAT
8210: 49 43 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69  IC);.  }.}.#endi
8220: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 53 4f 55 4e  f /* SQLITE_SOUN
8230: 44 45 58 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20  DEX */..#ifndef 
8240: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44  SQLITE_OMIT_LOAD
8250: 5f 45 58 54 45 4e 53 49 4f 4e 0a 2f 2a 0a 2a 2a  _EXTENSION./*.**
8260: 20 41 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74   A function that
8270: 20 6c 6f 61 64 73 20 61 20 73 68 61 72 65 64 2d   loads a shared-
8280: 6c 69 62 72 61 72 79 20 65 78 74 65 6e 73 69 6f  library extensio
8290: 6e 20 74 68 65 6e 20 72 65 74 75 72 6e 73 20 4e  n then returns N
82a0: 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ULL..*/.static v
82b0: 6f 69 64 20 6c 6f 61 64 45 78 74 28 73 71 6c 69  oid loadExt(sqli
82c0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e  te3_context *con
82d0: 74 65 78 74 2c 20 69 6e 74 20 61 72 67 63 2c 20  text, int argc, 
82e0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
82f0: 61 72 67 76 29 7b 0a 20 20 63 6f 6e 73 74 20 63  argv){.  const c
8300: 68 61 72 20 2a 7a 46 69 6c 65 20 3d 20 28 63 6f  har *zFile = (co
8310: 6e 73 74 20 63 68 61 72 20 2a 29 73 71 6c 69 74  nst char *)sqlit
8320: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72  e3_value_text(ar
8330: 67 76 5b 30 5d 29 3b 0a 20 20 63 6f 6e 73 74 20  gv[0]);.  const 
8340: 63 68 61 72 20 2a 7a 50 72 6f 63 3b 0a 20 20 73  char *zProc;.  s
8350: 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 73 71 6c  qlite3 *db = sql
8360: 69 74 65 33 5f 63 6f 6e 74 65 78 74 5f 64 62 5f  ite3_context_db_
8370: 68 61 6e 64 6c 65 28 63 6f 6e 74 65 78 74 29 3b  handle(context);
8380: 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67  .  char *zErrMsg
8390: 20 3d 20 30 3b 0a 0a 20 20 69 66 28 20 61 72 67   = 0;..  if( arg
83a0: 63 3d 3d 32 20 29 7b 0a 20 20 20 20 7a 50 72 6f  c==2 ){.    zPro
83b0: 63 20 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 20  c = (const char 
83c0: 2a 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  *)sqlite3_value_
83d0: 74 65 78 74 28 61 72 67 76 5b 31 5d 29 3b 0a 20  text(argv[1]);. 
83e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 50 72 6f   }else{.    zPro
83f0: 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28  c = 0;.  }.  if(
8400: 20 7a 46 69 6c 65 20 26 26 20 73 71 6c 69 74 65   zFile && sqlite
8410: 33 5f 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e  3_load_extension
8420: 28 64 62 2c 20 7a 46 69 6c 65 2c 20 7a 50 72 6f  (db, zFile, zPro
8430: 63 2c 20 26 7a 45 72 72 4d 73 67 29 20 29 7b 0a  c, &zErrMsg) ){.
8440: 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75      sqlite3_resu
8450: 6c 74 5f 65 72 72 6f 72 28 63 6f 6e 74 65 78 74  lt_error(context
8460: 2c 20 7a 45 72 72 4d 73 67 2c 20 2d 31 29 3b 0a  , zErrMsg, -1);.
8470: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
8480: 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 7d  (zErrMsg);.  }.}
8490: 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20  .#endif.../*.** 
84a0: 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  An instance of t
84b0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72  he following str
84c0: 75 63 74 75 72 65 20 68 6f 6c 64 73 20 74 68 65  ucture holds the
84d0: 20 63 6f 6e 74 65 78 74 20 6f 66 20 61 0a 2a 2a   context of a.**
84e0: 20 73 75 6d 28 29 20 6f 72 20 61 76 67 28 29 20   sum() or avg() 
84f0: 61 67 67 72 65 67 61 74 65 20 63 6f 6d 70 75 74  aggregate comput
8500: 61 74 69 6f 6e 2e 0a 2a 2f 0a 74 79 70 65 64 65  ation..*/.typede
8510: 66 20 73 74 72 75 63 74 20 53 75 6d 43 74 78 20  f struct SumCtx 
8520: 53 75 6d 43 74 78 3b 0a 73 74 72 75 63 74 20 53  SumCtx;.struct S
8530: 75 6d 43 74 78 20 7b 0a 20 20 64 6f 75 62 6c 65  umCtx {.  double
8540: 20 72 53 75 6d 3b 20 20 20 20 20 20 2f 2a 20 46   rSum;      /* F
8550: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 73 75  loating point su
8560: 6d 20 2a 2f 0a 20 20 69 36 34 20 69 53 75 6d 3b  m */.  i64 iSum;
8570: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 74 65           /* Inte
8580: 67 65 72 20 73 75 6d 20 2a 2f 20 20 20 0a 20 20  ger sum */   .  
8590: 69 36 34 20 63 6e 74 3b 20 20 20 20 20 20 20 20  i64 cnt;        
85a0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65    /* Number of e
85b0: 6c 65 6d 65 6e 74 73 20 73 75 6d 6d 65 64 20 2a  lements summed *
85c0: 2f 0a 20 20 75 38 20 6f 76 65 72 66 6c 6f 77 3b  /.  u8 overflow;
85d0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
85e0: 20 69 6e 74 65 67 65 72 20 6f 76 65 72 66 6c 6f   integer overflo
85f0: 77 20 73 65 65 6e 20 2a 2f 0a 20 20 75 38 20 61  w seen */.  u8 a
8600: 70 70 72 6f 78 3b 20 20 20 20 20 20 20 20 2f 2a  pprox;        /*
8610: 20 54 72 75 65 20 69 66 20 6e 6f 6e 2d 69 6e 74   True if non-int
8620: 65 67 65 72 20 76 61 6c 75 65 20 77 61 73 20 69  eger value was i
8630: 6e 70 75 74 20 74 6f 20 74 68 65 20 73 75 6d 20  nput to the sum 
8640: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75  */.};../*.** Rou
8650: 74 69 6e 65 73 20 75 73 65 64 20 74 6f 20 63 6f  tines used to co
8660: 6d 70 75 74 65 20 74 68 65 20 73 75 6d 2c 20 61  mpute the sum, a
8670: 76 65 72 61 67 65 2c 20 61 6e 64 20 74 6f 74 61  verage, and tota
8680: 6c 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 53 55 4d  l..**.** The SUM
8690: 28 29 20 66 75 6e 63 74 69 6f 6e 20 66 6f 6c 6c  () function foll
86a0: 6f 77 73 20 74 68 65 20 28 62 72 6f 6b 65 6e 29  ows the (broken)
86b0: 20 53 51 4c 20 73 74 61 6e 64 61 72 64 20 77 68   SQL standard wh
86c0: 69 63 68 20 6d 65 61 6e 73 0a 2a 2a 20 74 68 61  ich means.** tha
86d0: 74 20 69 74 20 72 65 74 75 72 6e 73 20 4e 55 4c  t it returns NUL
86e0: 4c 20 69 66 20 69 74 20 73 75 6d 73 20 6f 76 65  L if it sums ove
86f0: 72 20 6e 6f 20 69 6e 70 75 74 73 2e 20 20 54 4f  r no inputs.  TO
8700: 54 41 4c 20 72 65 74 75 72 6e 73 0a 2a 2a 20 30  TAL returns.** 0
8710: 2e 30 20 69 6e 20 74 68 61 74 20 63 61 73 65 2e  .0 in that case.
8720: 20 20 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 54    In addition, T
8730: 4f 54 41 4c 20 61 6c 77 61 79 73 20 72 65 74 75  OTAL always retu
8740: 72 6e 73 20 61 20 66 6c 6f 61 74 20 77 68 65 72  rns a float wher
8750: 65 0a 2a 2a 20 53 55 4d 20 6d 69 67 68 74 20 72  e.** SUM might r
8760: 65 74 75 72 6e 20 61 6e 20 69 6e 74 65 67 65 72  eturn an integer
8770: 20 69 66 20 69 74 20 6e 65 76 65 72 20 65 6e 63   if it never enc
8780: 6f 75 6e 74 65 72 73 20 61 20 66 6c 6f 61 74 69  ounters a floati
8790: 6e 67 20 70 6f 69 6e 74 0a 2a 2a 20 76 61 6c 75  ng point.** valu
87a0: 65 2e 20 20 54 4f 54 41 4c 20 6e 65 76 65 72 20  e.  TOTAL never 
87b0: 66 61 69 6c 73 2c 20 62 75 74 20 53 55 4d 20 6d  fails, but SUM m
87c0: 69 67 68 74 20 74 68 72 6f 75 67 68 20 61 6e 20  ight through an 
87d0: 65 78 63 65 70 74 69 6f 6e 20 69 66 0a 2a 2a 20  exception if.** 
87e0: 69 74 20 6f 76 65 72 66 6c 6f 77 73 20 61 6e 20  it overflows an 
87f0: 69 6e 74 65 67 65 72 2e 0a 2a 2f 0a 73 74 61 74  integer..*/.stat
8800: 69 63 20 76 6f 69 64 20 73 75 6d 53 74 65 70 28  ic void sumStep(
8810: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
8820: 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61 72  *context, int ar
8830: 67 63 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  gc, sqlite3_valu
8840: 65 20 2a 2a 61 72 67 76 29 7b 0a 20 20 53 75 6d  e **argv){.  Sum
8850: 43 74 78 20 2a 70 3b 0a 20 20 69 6e 74 20 74 79  Ctx *p;.  int ty
8860: 70 65 3b 0a 20 20 61 73 73 65 72 74 28 20 61 72  pe;.  assert( ar
8870: 67 63 3d 3d 31 20 29 3b 0a 20 20 55 4e 55 53 45  gc==1 );.  UNUSE
8880: 44 5f 50 41 52 41 4d 45 54 45 52 28 61 72 67 63  D_PARAMETER(argc
8890: 29 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33  );.  p = sqlite3
88a0: 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65  _aggregate_conte
88b0: 78 74 28 63 6f 6e 74 65 78 74 2c 20 73 69 7a 65  xt(context, size
88c0: 6f 66 28 2a 70 29 29 3b 0a 20 20 74 79 70 65 20  of(*p));.  type 
88d0: 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  = sqlite3_value_
88e0: 6e 75 6d 65 72 69 63 5f 74 79 70 65 28 61 72 67  numeric_type(arg
88f0: 76 5b 30 5d 29 3b 0a 20 20 69 66 28 20 70 20 26  v[0]);.  if( p &
8900: 26 20 74 79 70 65 21 3d 53 51 4c 49 54 45 5f 4e  & type!=SQLITE_N
8910: 55 4c 4c 20 29 7b 0a 20 20 20 20 70 2d 3e 63 6e  ULL ){.    p->cn
8920: 74 2b 2b 3b 0a 20 20 20 20 69 66 28 20 74 79 70  t++;.    if( typ
8930: 65 3d 3d 53 51 4c 49 54 45 5f 49 4e 54 45 47 45  e==SQLITE_INTEGE
8940: 52 20 29 7b 0a 20 20 20 20 20 20 69 36 34 20 76  R ){.      i64 v
8950: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
8960: 5f 69 6e 74 36 34 28 61 72 67 76 5b 30 5d 29 3b  _int64(argv[0]);
8970: 0a 20 20 20 20 20 20 70 2d 3e 72 53 75 6d 20 2b  .      p->rSum +
8980: 3d 20 76 3b 0a 20 20 20 20 20 20 69 66 28 20 28  = v;.      if( (
8990: 70 2d 3e 61 70 70 72 6f 78 7c 70 2d 3e 6f 76 65  p->approx|p->ove
89a0: 72 66 6c 6f 77 29 3d 3d 30 20 29 7b 0a 20 20 20  rflow)==0 ){.   
89b0: 20 20 20 20 20 69 36 34 20 69 4e 65 77 53 75 6d       i64 iNewSum
89c0: 20 3d 20 70 2d 3e 69 53 75 6d 20 2b 20 76 3b 0a   = p->iSum + v;.
89d0: 20 20 20 20 20 20 20 20 69 6e 74 20 73 31 20 3d          int s1 =
89e0: 20 28 69 6e 74 29 28 70 2d 3e 69 53 75 6d 20 3e   (int)(p->iSum >
89f0: 3e 20 28 73 69 7a 65 6f 66 28 69 36 34 29 2a 38  > (sizeof(i64)*8
8a00: 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 20 69 6e  -1));.        in
8a10: 74 20 73 32 20 3d 20 28 69 6e 74 29 28 76 20 20  t s2 = (int)(v  
8a20: 20 20 20 20 20 3e 3e 20 28 73 69 7a 65 6f 66 28       >> (sizeof(
8a30: 69 36 34 29 2a 38 2d 31 29 29 3b 0a 20 20 20 20  i64)*8-1));.    
8a40: 20 20 20 20 69 6e 74 20 73 33 20 3d 20 28 69 6e      int s3 = (in
8a50: 74 29 28 69 4e 65 77 53 75 6d 20 3e 3e 20 28 73  t)(iNewSum >> (s
8a60: 69 7a 65 6f 66 28 69 36 34 29 2a 38 2d 31 29 29  izeof(i64)*8-1))
8a70: 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 6f 76 65  ;.        p->ove
8a80: 72 66 6c 6f 77 20 3d 20 28 28 73 31 26 73 32 26  rflow = ((s1&s2&
8a90: 7e 73 33 29 20 7c 20 28 7e 73 31 26 7e 73 32 26  ~s3) | (~s1&~s2&
8aa0: 73 33 29 29 3f 31 3a 30 3b 0a 20 20 20 20 20 20  s3))?1:0;.      
8ab0: 20 20 70 2d 3e 69 53 75 6d 20 3d 20 69 4e 65 77    p->iSum = iNew
8ac0: 53 75 6d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  Sum;.      }.   
8ad0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 2d   }else{.      p-
8ae0: 3e 72 53 75 6d 20 2b 3d 20 73 71 6c 69 74 65 33  >rSum += sqlite3
8af0: 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 61 72  _value_double(ar
8b00: 67 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 70 2d  gv[0]);.      p-
8b10: 3e 61 70 70 72 6f 78 20 3d 20 31 3b 0a 20 20 20  >approx = 1;.   
8b20: 20 7d 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20   }.  }.}.static 
8b30: 76 6f 69 64 20 73 75 6d 46 69 6e 61 6c 69 7a 65  void sumFinalize
8b40: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
8b50: 20 2a 63 6f 6e 74 65 78 74 29 7b 0a 20 20 53 75   *context){.  Su
8b60: 6d 43 74 78 20 2a 70 3b 0a 20 20 70 20 3d 20 73  mCtx *p;.  p = s
8b70: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65  qlite3_aggregate
8b80: 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74  _context(context
8b90: 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 20 26 26  , 0);.  if( p &&
8ba0: 20 70 2d 3e 63 6e 74 3e 30 20 29 7b 0a 20 20 20   p->cnt>0 ){.   
8bb0: 20 69 66 28 20 70 2d 3e 6f 76 65 72 66 6c 6f 77   if( p->overflow
8bc0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
8bd0: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 63  3_result_error(c
8be0: 6f 6e 74 65 78 74 2c 22 69 6e 74 65 67 65 72 20  ontext,"integer 
8bf0: 6f 76 65 72 66 6c 6f 77 22 2c 2d 31 29 3b 0a 20  overflow",-1);. 
8c00: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e     }else if( p->
8c10: 61 70 70 72 6f 78 20 29 7b 0a 20 20 20 20 20 20  approx ){.      
8c20: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 64  sqlite3_result_d
8c30: 6f 75 62 6c 65 28 63 6f 6e 74 65 78 74 2c 20 70  ouble(context, p
8c40: 2d 3e 72 53 75 6d 29 3b 0a 20 20 20 20 7d 65 6c  ->rSum);.    }el
8c50: 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  se{.      sqlite
8c60: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 28 63  3_result_int64(c
8c70: 6f 6e 74 65 78 74 2c 20 70 2d 3e 69 53 75 6d 29  ontext, p->iSum)
8c80: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 73 74  ;.    }.  }.}.st
8c90: 61 74 69 63 20 76 6f 69 64 20 61 76 67 46 69 6e  atic void avgFin
8ca0: 61 6c 69 7a 65 28 73 71 6c 69 74 65 33 5f 63 6f  alize(sqlite3_co
8cb0: 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 29 7b  ntext *context){
8cc0: 0a 20 20 53 75 6d 43 74 78 20 2a 70 3b 0a 20 20  .  SumCtx *p;.  
8cd0: 70 20 3d 20 73 71 6c 69 74 65 33 5f 61 67 67 72  p = sqlite3_aggr
8ce0: 65 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f  egate_context(co
8cf0: 6e 74 65 78 74 2c 20 30 29 3b 0a 20 20 69 66 28  ntext, 0);.  if(
8d00: 20 70 20 26 26 20 70 2d 3e 63 6e 74 3e 30 20 29   p && p->cnt>0 )
8d10: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65  {.    sqlite3_re
8d20: 73 75 6c 74 5f 64 6f 75 62 6c 65 28 63 6f 6e 74  sult_double(cont
8d30: 65 78 74 2c 20 70 2d 3e 72 53 75 6d 2f 28 64 6f  ext, p->rSum/(do
8d40: 75 62 6c 65 29 70 2d 3e 63 6e 74 29 3b 0a 20 20  uble)p->cnt);.  
8d50: 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20  }.}.static void 
8d60: 74 6f 74 61 6c 46 69 6e 61 6c 69 7a 65 28 73 71  totalFinalize(sq
8d70: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63  lite3_context *c
8d80: 6f 6e 74 65 78 74 29 7b 0a 20 20 53 75 6d 43 74  ontext){.  SumCt
8d90: 78 20 2a 70 3b 0a 20 20 70 20 3d 20 73 71 6c 69  x *p;.  p = sqli
8da0: 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f  te3_aggregate_co
8db0: 6e 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 30  ntext(context, 0
8dc0: 29 3b 0a 20 20 2f 2a 20 28 64 6f 75 62 6c 65 29  );.  /* (double)
8dd0: 30 20 49 6e 20 63 61 73 65 20 6f 66 20 53 51 4c  0 In case of SQL
8de0: 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e  ITE_OMIT_FLOATIN
8df0: 47 5f 50 4f 49 4e 54 2e 2e 2e 20 2a 2f 0a 20 20  G_POINT... */.  
8e00: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 64  sqlite3_result_d
8e10: 6f 75 62 6c 65 28 63 6f 6e 74 65 78 74 2c 20 70  ouble(context, p
8e20: 20 3f 20 70 2d 3e 72 53 75 6d 20 3a 20 28 64 6f   ? p->rSum : (do
8e30: 75 62 6c 65 29 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  uble)0);.}../*.*
8e40: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
8e50: 73 74 72 75 63 74 75 72 65 20 6b 65 65 70 73 20  structure keeps 
8e60: 74 72 61 63 6b 20 6f 66 20 73 74 61 74 65 20 69  track of state i
8e70: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 20 74  nformation for t
8e80: 68 65 0a 2a 2a 20 63 6f 75 6e 74 28 29 20 61 67  he.** count() ag
8e90: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
8ea0: 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72  ..*/.typedef str
8eb0: 75 63 74 20 43 6f 75 6e 74 43 74 78 20 43 6f 75  uct CountCtx Cou
8ec0: 6e 74 43 74 78 3b 0a 73 74 72 75 63 74 20 43 6f  ntCtx;.struct Co
8ed0: 75 6e 74 43 74 78 20 7b 0a 20 20 69 36 34 20 6e  untCtx {.  i64 n
8ee0: 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74  ;.};../*.** Rout
8ef0: 69 6e 65 73 20 74 6f 20 69 6d 70 6c 65 6d 65 6e  ines to implemen
8f00: 74 20 74 68 65 20 63 6f 75 6e 74 28 29 20 61 67  t the count() ag
8f10: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
8f20: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
8f30: 20 63 6f 75 6e 74 53 74 65 70 28 73 71 6c 69 74   countStep(sqlit
8f40: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74  e3_context *cont
8f50: 65 78 74 2c 20 69 6e 74 20 61 72 67 63 2c 20 73  ext, int argc, s
8f60: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61  qlite3_value **a
8f70: 72 67 76 29 7b 0a 20 20 43 6f 75 6e 74 43 74 78  rgv){.  CountCtx
8f80: 20 2a 70 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74   *p;.  p = sqlit
8f90: 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e  e3_aggregate_con
8fa0: 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 73 69  text(context, si
8fb0: 7a 65 6f 66 28 2a 70 29 29 3b 0a 20 20 69 66 28  zeof(*p));.  if(
8fc0: 20 28 61 72 67 63 3d 3d 30 20 7c 7c 20 53 51 4c   (argc==0 || SQL
8fd0: 49 54 45 5f 4e 55 4c 4c 21 3d 73 71 6c 69 74 65  ITE_NULL!=sqlite
8fe0: 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67  3_value_type(arg
8ff0: 76 5b 30 5d 29 29 20 26 26 20 70 20 29 7b 0a 20  v[0])) && p ){. 
9000: 20 20 20 70 2d 3e 6e 2b 2b 3b 0a 20 20 7d 0a 0a     p->n++;.  }..
9010: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
9020: 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 20  MIT_DEPRECATED. 
9030: 20 2f 2a 20 54 68 65 20 73 71 6c 69 74 65 33 5f   /* The sqlite3_
9040: 61 67 67 72 65 67 61 74 65 5f 63 6f 75 6e 74 28  aggregate_count(
9050: 29 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 64 65  ) function is de
9060: 70 72 65 63 61 74 65 64 2e 20 20 42 75 74 20 6a  precated.  But j
9070: 75 73 74 20 74 6f 20 6d 61 6b 65 0a 20 20 2a 2a  ust to make.  **
9080: 20 73 75 72 65 20 69 74 20 73 74 69 6c 6c 20 6f   sure it still o
9090: 70 65 72 61 74 65 73 20 63 6f 72 72 65 63 74 6c  perates correctl
90a0: 79 2c 20 76 65 72 69 66 79 20 74 68 61 74 20 69  y, verify that i
90b0: 74 73 20 63 6f 75 6e 74 20 61 67 72 65 65 73 20  ts count agrees 
90c0: 77 69 74 68 20 6f 75 72 20 0a 20 20 2a 2a 20 69  with our .  ** i
90d0: 6e 74 65 72 6e 61 6c 20 63 6f 75 6e 74 20 77 68  nternal count wh
90e0: 65 6e 20 75 73 69 6e 67 20 63 6f 75 6e 74 28 2a  en using count(*
90f0: 29 20 61 6e 64 20 77 68 65 6e 20 74 68 65 20 74  ) and when the t
9100: 6f 74 61 6c 20 63 6f 75 6e 74 20 63 61 6e 20 62  otal count can b
9110: 65 0a 20 20 2a 2a 20 65 78 70 72 65 73 73 65 64  e.  ** expressed
9120: 20 61 73 20 61 20 33 32 2d 62 69 74 20 69 6e 74   as a 32-bit int
9130: 65 67 65 72 2e 20 2a 2f 0a 20 20 61 73 73 65 72  eger. */.  asser
9140: 74 28 20 61 72 67 63 3d 3d 31 20 7c 7c 20 70 3d  t( argc==1 || p=
9150: 3d 30 20 7c 7c 20 70 2d 3e 6e 3e 30 78 37 66 66  =0 || p->n>0x7ff
9160: 66 66 66 66 66 0a 20 20 20 20 20 20 20 20 20 20  fffff.          
9170: 7c 7c 20 70 2d 3e 6e 3d 3d 73 71 6c 69 74 65 33  || p->n==sqlite3
9180: 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 75 6e 74  _aggregate_count
9190: 28 63 6f 6e 74 65 78 74 29 20 29 3b 0a 23 65 6e  (context) );.#en
91a0: 64 69 66 0a 7d 20 20 20 0a 73 74 61 74 69 63 20  dif.}   .static 
91b0: 76 6f 69 64 20 63 6f 75 6e 74 46 69 6e 61 6c 69  void countFinali
91c0: 7a 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  ze(sqlite3_conte
91d0: 78 74 20 2a 63 6f 6e 74 65 78 74 29 7b 0a 20 20  xt *context){.  
91e0: 43 6f 75 6e 74 43 74 78 20 2a 70 3b 0a 20 20 70  CountCtx *p;.  p
91f0: 20 3d 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65   = sqlite3_aggre
9200: 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f 6e  gate_context(con
9210: 74 65 78 74 2c 20 30 29 3b 0a 20 20 73 71 6c 69  text, 0);.  sqli
9220: 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34  te3_result_int64
9230: 28 63 6f 6e 74 65 78 74 2c 20 70 20 3f 20 70 2d  (context, p ? p-
9240: 3e 6e 20 3a 20 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  >n : 0);.}../*.*
9250: 2a 20 52 6f 75 74 69 6e 65 73 20 74 6f 20 69 6d  * Routines to im
9260: 70 6c 65 6d 65 6e 74 20 6d 69 6e 28 29 20 61 6e  plement min() an
9270: 64 20 6d 61 78 28 29 20 61 67 67 72 65 67 61 74  d max() aggregat
9280: 65 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a  e functions..*/.
9290: 73 74 61 74 69 63 20 76 6f 69 64 20 6d 69 6e 6d  static void minm
92a0: 61 78 53 74 65 70 28 0a 20 20 73 71 6c 69 74 65  axStep(.  sqlite
92b0: 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65  3_context *conte
92c0: 78 74 2c 20 0a 20 20 69 6e 74 20 4e 6f 74 55 73  xt, .  int NotUs
92d0: 65 64 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 76  ed, .  sqlite3_v
92e0: 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20  alue **argv.){. 
92f0: 20 4d 65 6d 20 2a 70 41 72 67 20 20 3d 20 28 4d   Mem *pArg  = (M
9300: 65 6d 20 2a 29 61 72 67 76 5b 30 5d 3b 0a 20 20  em *)argv[0];.  
9310: 4d 65 6d 20 2a 70 42 65 73 74 3b 0a 20 20 55 4e  Mem *pBest;.  UN
9320: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e  USED_PARAMETER(N
9330: 6f 74 55 73 65 64 29 3b 0a 0a 20 20 69 66 28 20  otUsed);..  if( 
9340: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79  sqlite3_value_ty
9350: 70 65 28 61 72 67 76 5b 30 5d 29 3d 3d 53 51 4c  pe(argv[0])==SQL
9360: 49 54 45 5f 4e 55 4c 4c 20 29 20 72 65 74 75 72  ITE_NULL ) retur
9370: 6e 3b 0a 20 20 70 42 65 73 74 20 3d 20 28 4d 65  n;.  pBest = (Me
9380: 6d 20 2a 29 73 71 6c 69 74 65 33 5f 61 67 67 72  m *)sqlite3_aggr
9390: 65 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f  egate_context(co
93a0: 6e 74 65 78 74 2c 20 73 69 7a 65 6f 66 28 2a 70  ntext, sizeof(*p
93b0: 42 65 73 74 29 29 3b 0a 20 20 69 66 28 20 21 70  Best));.  if( !p
93c0: 42 65 73 74 20 29 20 72 65 74 75 72 6e 3b 0a 0a  Best ) return;..
93d0: 20 20 69 66 28 20 70 42 65 73 74 2d 3e 66 6c 61    if( pBest->fla
93e0: 67 73 20 29 7b 0a 20 20 20 20 69 6e 74 20 6d 61  gs ){.    int ma
93f0: 78 3b 0a 20 20 20 20 69 6e 74 20 63 6d 70 3b 0a  x;.    int cmp;.
9400: 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f      CollSeq *pCo
9410: 6c 6c 20 3d 20 73 71 6c 69 74 65 33 47 65 74 46  ll = sqlite3GetF
9420: 75 6e 63 43 6f 6c 6c 53 65 71 28 63 6f 6e 74 65  uncCollSeq(conte
9430: 78 74 29 3b 0a 20 20 20 20 2f 2a 20 54 68 69 73  xt);.    /* This
9440: 20 73 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 69   step function i
9450: 73 20 75 73 65 64 20 66 6f 72 20 62 6f 74 68 20  s used for both 
9460: 74 68 65 20 6d 69 6e 28 29 20 61 6e 64 20 6d 61  the min() and ma
9470: 78 28 29 20 61 67 67 72 65 67 61 74 65 73 2c 0a  x() aggregates,.
9480: 20 20 20 20 2a 2a 20 74 68 65 20 6f 6e 6c 79 20      ** the only 
9490: 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65  difference betwe
94a0: 65 6e 20 74 68 65 20 74 77 6f 20 62 65 69 6e 67  en the two being
94b0: 20 74 68 61 74 20 74 68 65 20 73 65 6e 73 65 20   that the sense 
94c0: 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 6f  of the.    ** co
94d0: 6d 70 61 72 69 73 6f 6e 20 69 73 20 69 6e 76 65  mparison is inve
94e0: 72 74 65 64 2e 20 46 6f 72 20 74 68 65 20 6d 61  rted. For the ma
94f0: 78 28 29 20 61 67 67 72 65 67 61 74 65 2c 20 74  x() aggregate, t
9500: 68 65 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65  he.    ** sqlite
9510: 33 5f 75 73 65 72 5f 64 61 74 61 28 29 20 66 75  3_user_data() fu
9520: 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 28  nction returns (
9530: 76 6f 69 64 20 2a 29 2d 31 2e 20 46 6f 72 20 6d  void *)-1. For m
9540: 69 6e 28 29 20 69 74 0a 20 20 20 20 2a 2a 20 72  in() it.    ** r
9550: 65 74 75 72 6e 73 20 28 76 6f 69 64 20 2a 29 64  eturns (void *)d
9560: 62 2c 20 77 68 65 72 65 20 64 62 20 69 73 20 74  b, where db is t
9570: 68 65 20 73 71 6c 69 74 65 33 2a 20 64 61 74 61  he sqlite3* data
9580: 62 61 73 65 20 70 6f 69 6e 74 65 72 2e 0a 20 20  base pointer..  
9590: 20 20 2a 2a 20 54 68 65 72 65 66 6f 72 65 20 74    ** Therefore t
95a0: 68 65 20 6e 65 78 74 20 73 74 61 74 65 6d 65 6e  he next statemen
95b0: 74 20 73 65 74 73 20 76 61 72 69 61 62 6c 65 20  t sets variable 
95c0: 27 6d 61 78 27 20 74 6f 20 31 20 66 6f 72 20 74  'max' to 1 for t
95d0: 68 65 20 6d 61 78 28 29 0a 20 20 20 20 2a 2a 20  he max().    ** 
95e0: 61 67 67 72 65 67 61 74 65 2c 20 6f 72 20 30 20  aggregate, or 0 
95f0: 66 6f 72 20 6d 69 6e 28 29 2e 0a 20 20 20 20 2a  for min()..    *
9600: 2f 0a 20 20 20 20 6d 61 78 20 3d 20 73 71 6c 69  /.    max = sqli
9610: 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28 63 6f  te3_user_data(co
9620: 6e 74 65 78 74 29 21 3d 30 3b 0a 20 20 20 20 63  ntext)!=0;.    c
9630: 6d 70 20 3d 20 73 71 6c 69 74 65 33 4d 65 6d 43  mp = sqlite3MemC
9640: 6f 6d 70 61 72 65 28 70 42 65 73 74 2c 20 70 41  ompare(pBest, pA
9650: 72 67 2c 20 70 43 6f 6c 6c 29 3b 0a 20 20 20 20  rg, pColl);.    
9660: 69 66 28 20 28 6d 61 78 20 26 26 20 63 6d 70 3c  if( (max && cmp<
9670: 30 29 20 7c 7c 20 28 21 6d 61 78 20 26 26 20 63  0) || (!max && c
9680: 6d 70 3e 30 29 20 29 7b 0a 20 20 20 20 20 20 73  mp>0) ){.      s
9690: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6f 70  qlite3VdbeMemCop
96a0: 79 28 70 42 65 73 74 2c 20 70 41 72 67 29 3b 0a  y(pBest, pArg);.
96b0: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20      }.  }else{. 
96c0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
96d0: 6d 43 6f 70 79 28 70 42 65 73 74 2c 20 70 41 72  mCopy(pBest, pAr
96e0: 67 29 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63  g);.  }.}.static
96f0: 20 76 6f 69 64 20 6d 69 6e 4d 61 78 46 69 6e 61   void minMaxFina
9700: 6c 69 7a 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e  lize(sqlite3_con
9710: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 29 7b 0a  text *context){.
9720: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20    sqlite3_value 
9730: 2a 70 52 65 73 3b 0a 20 20 70 52 65 73 20 3d 20  *pRes;.  pRes = 
9740: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  (sqlite3_value *
9750: 29 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61  )sqlite3_aggrega
9760: 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65  te_context(conte
9770: 78 74 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 52  xt, 0);.  if( pR
9780: 65 73 20 29 7b 0a 20 20 20 20 69 66 28 20 41 4c  es ){.    if( AL
9790: 57 41 59 53 28 70 52 65 73 2d 3e 66 6c 61 67 73  WAYS(pRes->flags
97a0: 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ) ){.      sqlit
97b0: 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75 65 28  e3_result_value(
97c0: 63 6f 6e 74 65 78 74 2c 20 70 52 65 73 29 3b 0a  context, pRes);.
97d0: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
97e0: 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28  3VdbeMemRelease(
97f0: 70 52 65 73 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  pRes);.  }.}../*
9800: 0a 2a 2a 20 67 72 6f 75 70 5f 63 6f 6e 63 61 74  .** group_concat
9810: 28 45 58 50 52 2c 20 3f 53 45 50 41 52 41 54 4f  (EXPR, ?SEPARATO
9820: 52 3f 29 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  R?).*/.static vo
9830: 69 64 20 67 72 6f 75 70 43 6f 6e 63 61 74 53 74  id groupConcatSt
9840: 65 70 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  ep(.  sqlite3_co
9850: 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a  ntext *context,.
9860: 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71    int argc,.  sq
9870: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
9880: 67 76 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68  gv.){.  const ch
9890: 61 72 20 2a 7a 56 61 6c 3b 0a 20 20 53 74 72 41  ar *zVal;.  StrA
98a0: 63 63 75 6d 20 2a 70 41 63 63 75 6d 3b 0a 20 20  ccum *pAccum;.  
98b0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 65 70  const char *zSep
98c0: 3b 0a 20 20 69 6e 74 20 6e 56 61 6c 2c 20 6e 53  ;.  int nVal, nS
98d0: 65 70 3b 0a 20 20 61 73 73 65 72 74 28 20 61 72  ep;.  assert( ar
98e0: 67 63 3d 3d 31 20 7c 7c 20 61 72 67 63 3d 3d 32  gc==1 || argc==2
98f0: 20 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65   );.  if( sqlite
9900: 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67  3_value_type(arg
9910: 76 5b 30 5d 29 3d 3d 53 51 4c 49 54 45 5f 4e 55  v[0])==SQLITE_NU
9920: 4c 4c 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 70  LL ) return;.  p
9930: 41 63 63 75 6d 20 3d 20 28 53 74 72 41 63 63 75  Accum = (StrAccu
9940: 6d 2a 29 73 71 6c 69 74 65 33 5f 61 67 67 72 65  m*)sqlite3_aggre
9950: 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f 6e  gate_context(con
9960: 74 65 78 74 2c 20 73 69 7a 65 6f 66 28 2a 70 41  text, sizeof(*pA
9970: 63 63 75 6d 29 29 3b 0a 0a 20 20 69 66 28 20 70  ccum));..  if( p
9980: 41 63 63 75 6d 20 29 7b 0a 20 20 20 20 73 71 6c  Accum ){.    sql
9990: 69 74 65 33 20 2a 64 62 20 3d 20 73 71 6c 69 74  ite3 *db = sqlit
99a0: 65 33 5f 63 6f 6e 74 65 78 74 5f 64 62 5f 68 61  e3_context_db_ha
99b0: 6e 64 6c 65 28 63 6f 6e 74 65 78 74 29 3b 0a 20  ndle(context);. 
99c0: 20 20 20 69 6e 74 20 66 69 72 73 74 54 65 72 6d     int firstTerm
99d0: 20 3d 20 70 41 63 63 75 6d 2d 3e 75 73 65 4d 61   = pAccum->useMa
99e0: 6c 6c 6f 63 3d 3d 30 3b 0a 20 20 20 20 70 41 63  lloc==0;.    pAc
99f0: 63 75 6d 2d 3e 75 73 65 4d 61 6c 6c 6f 63 20 3d  cum->useMalloc =
9a00: 20 31 3b 0a 20 20 20 20 70 41 63 63 75 6d 2d 3e   1;.    pAccum->
9a10: 6d 78 41 6c 6c 6f 63 20 3d 20 64 62 2d 3e 61 4c  mxAlloc = db->aL
9a20: 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49  imit[SQLITE_LIMI
9a30: 54 5f 4c 45 4e 47 54 48 5d 3b 0a 20 20 20 20 69  T_LENGTH];.    i
9a40: 66 28 20 21 66 69 72 73 74 54 65 72 6d 20 29 7b  f( !firstTerm ){
9a50: 0a 20 20 20 20 20 20 69 66 28 20 61 72 67 63 3d  .      if( argc=
9a60: 3d 32 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 53  =2 ){.        zS
9a70: 65 70 20 3d 20 28 63 68 61 72 2a 29 73 71 6c 69  ep = (char*)sqli
9a80: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61  te3_value_text(a
9a90: 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20 20 20 20  rgv[1]);.       
9aa0: 20 6e 53 65 70 20 3d 20 73 71 6c 69 74 65 33 5f   nSep = sqlite3_
9ab0: 76 61 6c 75 65 5f 62 79 74 65 73 28 61 72 67 76  value_bytes(argv
9ac0: 5b 31 5d 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73  [1]);.      }els
9ad0: 65 7b 0a 20 20 20 20 20 20 20 20 7a 53 65 70 20  e{.        zSep 
9ae0: 3d 20 22 2c 22 3b 0a 20 20 20 20 20 20 20 20 6e  = ",";.        n
9af0: 53 65 70 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d  Sep = 1;.      }
9b00: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74  .      sqlite3St
9b10: 72 41 63 63 75 6d 41 70 70 65 6e 64 28 70 41 63  rAccumAppend(pAc
9b20: 63 75 6d 2c 20 7a 53 65 70 2c 20 6e 53 65 70 29  cum, zSep, nSep)
9b30: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 56 61 6c  ;.    }.    zVal
9b40: 20 3d 20 28 63 68 61 72 2a 29 73 71 6c 69 74 65   = (char*)sqlite
9b50: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67  3_value_text(arg
9b60: 76 5b 30 5d 29 3b 0a 20 20 20 20 6e 56 61 6c 20  v[0]);.    nVal 
9b70: 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  = sqlite3_value_
9b80: 62 79 74 65 73 28 61 72 67 76 5b 30 5d 29 3b 0a  bytes(argv[0]);.
9b90: 20 20 20 20 73 71 6c 69 74 65 33 53 74 72 41 63      sqlite3StrAc
9ba0: 63 75 6d 41 70 70 65 6e 64 28 70 41 63 63 75 6d  cumAppend(pAccum
9bb0: 2c 20 7a 56 61 6c 2c 20 6e 56 61 6c 29 3b 0a 20  , zVal, nVal);. 
9bc0: 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64   }.}.static void
9bd0: 20 67 72 6f 75 70 43 6f 6e 63 61 74 46 69 6e 61   groupConcatFina
9be0: 6c 69 7a 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e  lize(sqlite3_con
9bf0: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 29 7b 0a  text *context){.
9c00: 20 20 53 74 72 41 63 63 75 6d 20 2a 70 41 63 63    StrAccum *pAcc
9c10: 75 6d 3b 0a 20 20 70 41 63 63 75 6d 20 3d 20 73  um;.  pAccum = s
9c20: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65  qlite3_aggregate
9c30: 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74  _context(context
9c40: 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 41 63 63  , 0);.  if( pAcc
9c50: 75 6d 20 29 7b 0a 20 20 20 20 69 66 28 20 70 41  um ){.    if( pA
9c60: 63 63 75 6d 2d 3e 74 6f 6f 42 69 67 20 29 7b 0a  ccum->tooBig ){.
9c70: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65        sqlite3_re
9c80: 73 75 6c 74 5f 65 72 72 6f 72 5f 74 6f 6f 62 69  sult_error_toobi
9c90: 67 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 20 20  g(context);.    
9ca0: 7d 65 6c 73 65 20 69 66 28 20 70 41 63 63 75 6d  }else if( pAccum
9cb0: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29  ->mallocFailed )
9cc0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  {.      sqlite3_
9cd0: 72 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d  result_error_nom
9ce0: 65 6d 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 20  em(context);.   
9cf0: 20 7d 65 6c 73 65 7b 20 20 20 20 0a 20 20 20 20   }else{    .    
9d00: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74    sqlite3_result
9d10: 5f 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 73  _text(context, s
9d20: 71 6c 69 74 65 33 53 74 72 41 63 63 75 6d 46 69  qlite3StrAccumFi
9d30: 6e 69 73 68 28 70 41 63 63 75 6d 29 2c 20 2d 31  nish(pAccum), -1
9d40: 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  , .             
9d50: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c               sql
9d60: 69 74 65 33 5f 66 72 65 65 29 3b 0a 20 20 20 20  ite3_free);.    
9d70: 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  }.  }.}../*.** T
9d80: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 67  his function reg
9d90: 69 73 74 65 72 65 64 20 61 6c 6c 20 6f 66 20 74  istered all of t
9da0: 68 65 20 61 62 6f 76 65 20 43 20 66 75 6e 63 74  he above C funct
9db0: 69 6f 6e 73 20 61 73 20 53 51 4c 0a 2a 2a 20 66  ions as SQL.** f
9dc0: 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 69 73 20  unctions.  This 
9dd0: 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 6f 6e  should be the on
9de0: 6c 79 20 72 6f 75 74 69 6e 65 20 69 6e 20 74 68  ly routine in th
9df0: 69 73 20 66 69 6c 65 20 77 69 74 68 0a 2a 2a 20  is file with.** 
9e00: 65 78 74 65 72 6e 61 6c 20 6c 69 6e 6b 61 67 65  external linkage
9e10: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
9e20: 33 52 65 67 69 73 74 65 72 42 75 69 6c 74 69 6e  3RegisterBuiltin
9e30: 46 75 6e 63 74 69 6f 6e 73 28 73 71 6c 69 74 65  Functions(sqlite
9e40: 33 20 2a 64 62 29 7b 0a 23 69 66 6e 64 65 66 20  3 *db){.#ifndef 
9e50: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45  SQLITE_OMIT_ALTE
9e60: 52 54 41 42 4c 45 0a 20 20 73 71 6c 69 74 65 33  RTABLE.  sqlite3
9e70: 41 6c 74 65 72 46 75 6e 63 74 69 6f 6e 73 28 64  AlterFunctions(d
9e80: 62 29 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28  b);.#endif.  if(
9e90: 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c   !db->mallocFail
9ea0: 65 64 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63  ed ){.    int rc
9eb0: 20 3d 20 73 71 6c 69 74 65 33 5f 6f 76 65 72 6c   = sqlite3_overl
9ec0: 6f 61 64 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c  oad_function(db,
9ed0: 20 22 4d 41 54 43 48 22 2c 20 32 29 3b 0a 20 20   "MATCH", 2);.  
9ee0: 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51    assert( rc==SQ
9ef0: 4c 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 72 63  LITE_NOMEM || rc
9f00: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20  ==SQLITE_OK );. 
9f10: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
9f20: 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20  E_NOMEM ){.     
9f30: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65   db->mallocFaile
9f40: 64 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d  d = 1;.    }.  }
9f50: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68  .}../*.** Set th
9f60: 65 20 4c 49 4b 45 4f 50 54 20 66 6c 61 67 20 6f  e LIKEOPT flag o
9f70: 6e 20 74 68 65 20 32 2d 61 72 67 75 6d 65 6e 74  n the 2-argument
9f80: 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74   function with t
9f90: 68 65 20 67 69 76 65 6e 20 6e 61 6d 65 2e 0a 2a  he given name..*
9fa0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73 65  /.static void se
9fb0: 74 4c 69 6b 65 4f 70 74 46 6c 61 67 28 73 71 6c  tLikeOptFlag(sql
9fc0: 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20  ite3 *db, const 
9fd0: 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 75 38 20  char *zName, u8 
9fe0: 66 6c 61 67 56 61 6c 29 7b 0a 20 20 46 75 6e 63  flagVal){.  Func
9ff0: 44 65 66 20 2a 70 44 65 66 3b 0a 20 20 70 44 65  Def *pDef;.  pDe
a000: 66 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46  f = sqlite3FindF
a010: 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d  unction(db, zNam
a020: 65 2c 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e  e, sqlite3Strlen
a030: 33 30 28 7a 4e 61 6d 65 29 2c 0a 20 20 20 20 20  30(zName),.     
a040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a050: 20 20 20 20 20 20 20 20 32 2c 20 53 51 4c 49 54          2, SQLIT
a060: 45 5f 55 54 46 38 2c 20 30 29 3b 0a 20 20 69 66  E_UTF8, 0);.  if
a070: 28 20 41 4c 57 41 59 53 28 70 44 65 66 29 20 29  ( ALWAYS(pDef) )
a080: 7b 0a 20 20 20 20 70 44 65 66 2d 3e 66 6c 61 67  {.    pDef->flag
a090: 73 20 3d 20 66 6c 61 67 56 61 6c 3b 0a 20 20 7d  s = flagVal;.  }
a0a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74  .}../*.** Regist
a0b0: 65 72 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 20  er the built-in 
a0c0: 4c 49 4b 45 20 61 6e 64 20 47 4c 4f 42 20 66 75  LIKE and GLOB fu
a0d0: 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65 20 63 61  nctions.  The ca
a0e0: 73 65 53 65 6e 73 69 74 69 76 65 0a 2a 2a 20 70  seSensitive.** p
a0f0: 61 72 61 6d 65 74 65 72 20 64 65 74 65 72 6d 69  arameter determi
a100: 6e 65 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e  nes whether or n
a110: 6f 74 20 74 68 65 20 4c 49 4b 45 20 6f 70 65 72  ot the LIKE oper
a120: 61 74 6f 72 20 69 73 20 63 61 73 65 0a 2a 2a 20  ator is case.** 
a130: 73 65 6e 73 69 74 69 76 65 2e 20 20 47 4c 4f 42  sensitive.  GLOB
a140: 20 69 73 20 61 6c 77 61 79 73 20 63 61 73 65 20   is always case 
a150: 73 65 6e 73 69 74 69 76 65 2e 0a 2a 2f 0a 76 6f  sensitive..*/.vo
a160: 69 64 20 73 71 6c 69 74 65 33 52 65 67 69 73 74  id sqlite3Regist
a170: 65 72 4c 69 6b 65 46 75 6e 63 74 69 6f 6e 73 28  erLikeFunctions(
a180: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74  sqlite3 *db, int
a190: 20 63 61 73 65 53 65 6e 73 69 74 69 76 65 29 7b   caseSensitive){
a1a0: 0a 20 20 73 74 72 75 63 74 20 63 6f 6d 70 61 72  .  struct compar
a1b0: 65 49 6e 66 6f 20 2a 70 49 6e 66 6f 3b 0a 20 20  eInfo *pInfo;.  
a1c0: 69 66 28 20 63 61 73 65 53 65 6e 73 69 74 69 76  if( caseSensitiv
a1d0: 65 20 29 7b 0a 20 20 20 20 70 49 6e 66 6f 20 3d  e ){.    pInfo =
a1e0: 20 28 73 74 72 75 63 74 20 63 6f 6d 70 61 72 65   (struct compare
a1f0: 49 6e 66 6f 2a 29 26 6c 69 6b 65 49 6e 66 6f 41  Info*)&likeInfoA
a200: 6c 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  lt;.  }else{.   
a210: 20 70 49 6e 66 6f 20 3d 20 28 73 74 72 75 63 74   pInfo = (struct
a220: 20 63 6f 6d 70 61 72 65 49 6e 66 6f 2a 29 26 6c   compareInfo*)&l
a230: 69 6b 65 49 6e 66 6f 4e 6f 72 6d 3b 0a 20 20 7d  ikeInfoNorm;.  }
a240: 0a 20 20 73 71 6c 69 74 65 33 43 72 65 61 74 65  .  sqlite3Create
a250: 46 75 6e 63 28 64 62 2c 20 22 6c 69 6b 65 22 2c  Func(db, "like",
a260: 20 32 2c 20 53 51 4c 49 54 45 5f 41 4e 59 2c 20   2, SQLITE_ANY, 
a270: 70 49 6e 66 6f 2c 20 6c 69 6b 65 46 75 6e 63 2c  pInfo, likeFunc,
a280: 20 30 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65   0, 0);.  sqlite
a290: 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20  3CreateFunc(db, 
a2a0: 22 6c 69 6b 65 22 2c 20 33 2c 20 53 51 4c 49 54  "like", 3, SQLIT
a2b0: 45 5f 41 4e 59 2c 20 70 49 6e 66 6f 2c 20 6c 69  E_ANY, pInfo, li
a2c0: 6b 65 46 75 6e 63 2c 20 30 2c 20 30 29 3b 0a 20  keFunc, 0, 0);. 
a2d0: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75   sqlite3CreateFu
a2e0: 6e 63 28 64 62 2c 20 22 67 6c 6f 62 22 2c 20 32  nc(db, "glob", 2
a2f0: 2c 20 53 51 4c 49 54 45 5f 41 4e 59 2c 20 0a 20  , SQLITE_ANY, . 
a300: 20 20 20 20 20 28 73 74 72 75 63 74 20 63 6f 6d       (struct com
a310: 70 61 72 65 49 6e 66 6f 2a 29 26 67 6c 6f 62 49  pareInfo*)&globI
a320: 6e 66 6f 2c 20 6c 69 6b 65 46 75 6e 63 2c 20 30  nfo, likeFunc, 0
a330: 2c 30 29 3b 0a 20 20 73 65 74 4c 69 6b 65 4f 70  ,0);.  setLikeOp
a340: 74 46 6c 61 67 28 64 62 2c 20 22 67 6c 6f 62 22  tFlag(db, "glob"
a350: 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 49  , SQLITE_FUNC_LI
a360: 4b 45 20 7c 20 53 51 4c 49 54 45 5f 46 55 4e 43  KE | SQLITE_FUNC
a370: 5f 43 41 53 45 29 3b 0a 20 20 73 65 74 4c 69 6b  _CASE);.  setLik
a380: 65 4f 70 74 46 6c 61 67 28 64 62 2c 20 22 6c 69  eOptFlag(db, "li
a390: 6b 65 22 2c 20 0a 20 20 20 20 20 20 63 61 73 65  ke", .      case
a3a0: 53 65 6e 73 69 74 69 76 65 20 3f 20 28 53 51 4c  Sensitive ? (SQL
a3b0: 49 54 45 5f 46 55 4e 43 5f 4c 49 4b 45 20 7c 20  ITE_FUNC_LIKE | 
a3c0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 41 53 45  SQLITE_FUNC_CASE
a3d0: 29 20 3a 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f  ) : SQLITE_FUNC_
a3e0: 4c 49 4b 45 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  LIKE);.}../*.** 
a3f0: 70 45 78 70 72 20 70 6f 69 6e 74 73 20 74 6f 20  pExpr points to 
a400: 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 77 68  an expression wh
a410: 69 63 68 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61  ich implements a
a420: 20 66 75 6e 63 74 69 6f 6e 2e 20 20 49 66 0a 2a   function.  If.*
a430: 2a 20 69 74 20 69 73 20 61 70 70 72 6f 70 72 69  * it is appropri
a440: 61 74 65 20 74 6f 20 61 70 70 6c 79 20 74 68 65  ate to apply the
a450: 20 4c 49 4b 45 20 6f 70 74 69 6d 69 7a 61 74 69   LIKE optimizati
a460: 6f 6e 20 74 6f 20 74 68 61 74 20 66 75 6e 63 74  on to that funct
a470: 69 6f 6e 0a 2a 2a 20 74 68 65 6e 20 73 65 74 20  ion.** then set 
a480: 61 57 63 5b 30 5d 20 74 68 72 6f 75 67 68 20 61  aWc[0] through a
a490: 57 63 5b 32 5d 20 74 6f 20 74 68 65 20 77 69 6c  Wc[2] to the wil
a4a0: 64 63 61 72 64 20 63 68 61 72 61 63 74 65 72 73  dcard characters
a4b0: 20 61 6e 64 0a 2a 2a 20 72 65 74 75 72 6e 20 54   and.** return T
a4c0: 52 55 45 2e 20 20 49 66 20 74 68 65 20 66 75 6e  RUE.  If the fun
a4d0: 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 61 20 4c  ction is not a L
a4e0: 49 4b 45 2d 73 74 79 6c 65 20 66 75 6e 63 74 69  IKE-style functi
a4f0: 6f 6e 20 74 68 65 6e 0a 2a 2a 20 72 65 74 75 72  on then.** retur
a500: 6e 20 46 41 4c 53 45 2e 0a 2a 2f 0a 69 6e 74 20  n FALSE..*/.int 
a510: 73 71 6c 69 74 65 33 49 73 4c 69 6b 65 46 75 6e  sqlite3IsLikeFun
a520: 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 20 2a 64  ction(sqlite3 *d
a530: 62 2c 20 45 78 70 72 20 2a 70 45 78 70 72 2c 20  b, Expr *pExpr, 
a540: 69 6e 74 20 2a 70 49 73 4e 6f 63 61 73 65 2c 20  int *pIsNocase, 
a550: 63 68 61 72 20 2a 61 57 63 29 7b 0a 20 20 46 75  char *aWc){.  Fu
a560: 6e 63 44 65 66 20 2a 70 44 65 66 3b 0a 20 20 69  ncDef *pDef;.  i
a570: 66 28 20 70 45 78 70 72 2d 3e 6f 70 21 3d 54 4b  f( pExpr->op!=TK
a580: 5f 46 55 4e 43 54 49 4f 4e 20 0a 20 20 20 7c 7c  _FUNCTION .   ||
a590: 20 21 70 45 78 70 72 2d 3e 78 2e 70 4c 69 73 74   !pExpr->x.pList
a5a0: 20 0a 20 20 20 7c 7c 20 70 45 78 70 72 2d 3e 78   .   || pExpr->x
a5b0: 2e 70 4c 69 73 74 2d 3e 6e 45 78 70 72 21 3d 32  .pList->nExpr!=2
a5c0: 0a 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  .  ){.    return
a5d0: 20 30 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74   0;.  }.  assert
a5e0: 28 20 21 45 78 70 72 48 61 73 50 72 6f 70 65 72  ( !ExprHasProper
a5f0: 74 79 28 70 45 78 70 72 2c 20 45 50 5f 78 49 73  ty(pExpr, EP_xIs
a600: 53 65 6c 65 63 74 29 20 29 3b 0a 20 20 70 44 65  Select) );.  pDe
a610: 66 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46  f = sqlite3FindF
a620: 75 6e 63 74 69 6f 6e 28 64 62 2c 20 70 45 78 70  unction(db, pExp
a630: 72 2d 3e 75 2e 7a 54 6f 6b 65 6e 2c 20 0a 20 20  r->u.zToken, .  
a640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a650: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
a660: 65 33 53 74 72 6c 65 6e 33 30 28 70 45 78 70 72  e3Strlen30(pExpr
a670: 2d 3e 75 2e 7a 54 6f 6b 65 6e 29 2c 0a 20 20 20  ->u.zToken),.   
a680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a690: 20 20 20 20 20 20 20 20 20 20 32 2c 20 53 51 4c            2, SQL
a6a0: 49 54 45 5f 55 54 46 38 2c 20 30 29 3b 0a 20 20  ITE_UTF8, 0);.  
a6b0: 69 66 28 20 4e 45 56 45 52 28 70 44 65 66 3d 3d  if( NEVER(pDef==
a6c0: 30 29 20 7c 7c 20 28 70 44 65 66 2d 3e 66 6c 61  0) || (pDef->fla
a6d0: 67 73 20 26 20 53 51 4c 49 54 45 5f 46 55 4e 43  gs & SQLITE_FUNC
a6e0: 5f 4c 49 4b 45 29 3d 3d 30 20 29 7b 0a 20 20 20  _LIKE)==0 ){.   
a6f0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a   return 0;.  }..
a700: 20 20 2f 2a 20 54 68 65 20 6d 65 6d 63 70 79 28    /* The memcpy(
a710: 29 20 73 74 61 74 65 6d 65 6e 74 20 61 73 73 75  ) statement assu
a720: 6d 65 73 20 74 68 61 74 20 74 68 65 20 77 69 6c  mes that the wil
a730: 64 63 61 72 64 20 63 68 61 72 61 63 74 65 72 73  dcard characters
a740: 20 61 72 65 0a 20 20 2a 2a 20 74 68 65 20 66 69   are.  ** the fi
a750: 72 73 74 20 74 68 72 65 65 20 73 74 61 74 65 6d  rst three statem
a760: 65 6e 74 73 20 69 6e 20 74 68 65 20 63 6f 6d 70  ents in the comp
a770: 61 72 65 49 6e 66 6f 20 73 74 72 75 63 74 75 72  areInfo structur
a780: 65 2e 20 20 54 68 65 0a 20 20 2a 2a 20 61 73 73  e.  The.  ** ass
a790: 65 72 74 73 28 29 20 74 68 61 74 20 66 6f 6c 6c  erts() that foll
a7a0: 6f 77 20 76 65 72 69 66 79 20 74 68 61 74 20 61  ow verify that a
a7b0: 73 73 75 6d 70 74 69 6f 6e 0a 20 20 2a 2f 0a 20  ssumption.  */. 
a7c0: 20 6d 65 6d 63 70 79 28 61 57 63 2c 20 70 44 65   memcpy(aWc, pDe
a7d0: 66 2d 3e 70 55 73 65 72 44 61 74 61 2c 20 33 29  f->pUserData, 3)
a7e0: 3b 0a 20 20 61 73 73 65 72 74 28 20 28 63 68 61  ;.  assert( (cha
a7f0: 72 2a 29 26 6c 69 6b 65 49 6e 66 6f 41 6c 74 20  r*)&likeInfoAlt 
a800: 3d 3d 20 28 63 68 61 72 2a 29 26 6c 69 6b 65 49  == (char*)&likeI
a810: 6e 66 6f 41 6c 74 2e 6d 61 74 63 68 41 6c 6c 20  nfoAlt.matchAll 
a820: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 26 28 28  );.  assert( &((
a830: 63 68 61 72 2a 29 26 6c 69 6b 65 49 6e 66 6f 41  char*)&likeInfoA
a840: 6c 74 29 5b 31 5d 20 3d 3d 20 28 63 68 61 72 2a  lt)[1] == (char*
a850: 29 26 6c 69 6b 65 49 6e 66 6f 41 6c 74 2e 6d 61  )&likeInfoAlt.ma
a860: 74 63 68 4f 6e 65 20 29 3b 0a 20 20 61 73 73 65  tchOne );.  asse
a870: 72 74 28 20 26 28 28 63 68 61 72 2a 29 26 6c 69  rt( &((char*)&li
a880: 6b 65 49 6e 66 6f 41 6c 74 29 5b 32 5d 20 3d 3d  keInfoAlt)[2] ==
a890: 20 28 63 68 61 72 2a 29 26 6c 69 6b 65 49 6e 66   (char*)&likeInf
a8a0: 6f 41 6c 74 2e 6d 61 74 63 68 53 65 74 20 29 3b  oAlt.matchSet );
a8b0: 0a 20 20 2a 70 49 73 4e 6f 63 61 73 65 20 3d 20  .  *pIsNocase = 
a8c0: 28 70 44 65 66 2d 3e 66 6c 61 67 73 20 26 20 53  (pDef->flags & S
a8d0: 51 4c 49 54 45 5f 46 55 4e 43 5f 43 41 53 45 29  QLITE_FUNC_CASE)
a8e0: 3d 3d 30 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b  ==0;.  return 1;
a8f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 61 6c  .}../*.** All al
a900: 6c 20 6f 66 20 74 68 65 20 46 75 6e 63 44 65 66  l of the FuncDef
a910: 20 73 74 72 75 63 74 75 72 65 73 20 69 6e 20 74   structures in t
a920: 68 65 20 61 42 75 69 6c 74 69 6e 46 75 6e 63 5b  he aBuiltinFunc[
a930: 5d 20 61 72 72 61 79 20 61 62 6f 76 65 0a 2a 2a  ] array above.**
a940: 20 74 6f 20 74 68 65 20 67 6c 6f 62 61 6c 20 66   to the global f
a950: 75 6e 63 74 69 6f 6e 20 68 61 73 68 20 74 61 62  unction hash tab
a960: 6c 65 2e 20 20 54 68 69 73 20 6f 63 63 75 72 73  le.  This occurs
a970: 20 61 74 20 73 74 61 72 74 2d 74 69 6d 65 20 28   at start-time (
a980: 61 73 0a 2a 2a 20 61 20 63 6f 6e 73 65 71 75 65  as.** a conseque
a990: 6e 63 65 20 6f 66 20 63 61 6c 6c 69 6e 67 20 73  nce of calling s
a9a0: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a  qlite3_initializ
a9b0: 65 28 29 29 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65  e())..**.** Afte
a9c0: 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72  r this routine r
a9d0: 75 6e 73 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  uns.*/.void sqli
a9e0: 74 65 33 52 65 67 69 73 74 65 72 47 6c 6f 62 61  te3RegisterGloba
a9f0: 6c 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29  lFunctions(void)
aa00: 7b 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20  {.  /*.  ** The 
aa10: 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 72 61 79 20  following array 
aa20: 68 6f 6c 64 73 20 46 75 6e 63 44 65 66 20 73 74  holds FuncDef st
aa30: 72 75 63 74 75 72 65 73 20 66 6f 72 20 61 6c 6c  ructures for all
aa40: 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e   of the function
aa50: 73 0a 20 20 2a 2a 20 64 65 66 69 6e 65 64 20 69  s.  ** defined i
aa60: 6e 20 74 68 69 73 20 66 69 6c 65 2e 0a 20 20 2a  n this file..  *
aa70: 2a 0a 20 20 2a 2a 20 54 68 65 20 61 72 72 61 79  *.  ** The array
aa80: 20 63 61 6e 6e 6f 74 20 62 65 20 63 6f 6e 73 74   cannot be const
aa90: 61 6e 74 20 73 69 6e 63 65 20 63 68 61 6e 67 65  ant since change
aaa0: 73 20 61 72 65 20 6d 61 64 65 20 74 6f 20 74 68  s are made to th
aab0: 65 0a 20 20 2a 2a 20 46 75 6e 63 44 65 66 2e 70  e.  ** FuncDef.p
aac0: 48 61 73 68 20 65 6c 65 6d 65 6e 74 73 20 61 74  Hash elements at
aad0: 20 73 74 61 72 74 2d 74 69 6d 65 2e 20 20 54 68   start-time.  Th
aae0: 65 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20 74 68  e elements of th
aaf0: 69 73 20 61 72 72 61 79 0a 20 20 2a 2a 20 61 72  is array.  ** ar
ab00: 65 20 72 65 61 64 2d 6f 6e 6c 79 20 61 66 74 65  e read-only afte
ab10: 72 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e  r initialization
ab20: 20 69 73 20 63 6f 6d 70 6c 65 74 65 2e 0a 20 20   is complete..  
ab30: 2a 2f 0a 20 20 73 74 61 74 69 63 20 53 51 4c 49  */.  static SQLI
ab40: 54 45 5f 57 53 44 20 46 75 6e 63 44 65 66 20 61  TE_WSD FuncDef a
ab50: 42 75 69 6c 74 69 6e 46 75 6e 63 5b 5d 20 3d 20  BuiltinFunc[] = 
ab60: 7b 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 6c  {.    FUNCTION(l
ab70: 74 72 69 6d 2c 20 20 20 20 20 20 20 20 20 20 20  trim,           
ab80: 20 20 20 31 2c 20 31 2c 20 30 2c 20 74 72 69 6d     1, 1, 0, trim
ab90: 46 75 6e 63 20 20 20 20 20 20 20 20 20 29 2c 0a  Func         ),.
aba0: 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 6c 74 72      FUNCTION(ltr
abb0: 69 6d 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  im,             
abc0: 20 32 2c 20 31 2c 20 30 2c 20 74 72 69 6d 46 75   2, 1, 0, trimFu
abd0: 6e 63 20 20 20 20 20 20 20 20 20 29 2c 0a 20 20  nc         ),.  
abe0: 20 20 46 55 4e 43 54 49 4f 4e 28 72 74 72 69 6d    FUNCTION(rtrim
abf0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31  ,              1
ac00: 2c 20 32 2c 20 30 2c 20 74 72 69 6d 46 75 6e 63  , 2, 0, trimFunc
ac10: 20 20 20 20 20 20 20 20 20 29 2c 0a 20 20 20 20           ),.    
ac20: 46 55 4e 43 54 49 4f 4e 28 72 74 72 69 6d 2c 20  FUNCTION(rtrim, 
ac30: 20 20 20 20 20 20 20 20 20 20 20 20 20 32 2c 20               2, 
ac40: 32 2c 20 30 2c 20 74 72 69 6d 46 75 6e 63 20 20  2, 0, trimFunc  
ac50: 20 20 20 20 20 20 20 29 2c 0a 20 20 20 20 46 55         ),.    FU
ac60: 4e 43 54 49 4f 4e 28 74 72 69 6d 2c 20 20 20 20  NCTION(trim,    
ac70: 20 20 20 20 20 20 20 20 20 20 20 31 2c 20 33 2c             1, 3,
ac80: 20 30 2c 20 74 72 69 6d 46 75 6e 63 20 20 20 20   0, trimFunc    
ac90: 20 20 20 20 20 29 2c 0a 20 20 20 20 46 55 4e 43       ),.    FUNC
aca0: 54 49 4f 4e 28 74 72 69 6d 2c 20 20 20 20 20 20  TION(trim,      
acb0: 20 20 20 20 20 20 20 20 20 32 2c 20 33 2c 20 30           2, 3, 0
acc0: 2c 20 74 72 69 6d 46 75 6e 63 20 20 20 20 20 20  , trimFunc      
acd0: 20 20 20 29 2c 0a 20 20 20 20 46 55 4e 43 54 49     ),.    FUNCTI
ace0: 4f 4e 28 6d 69 6e 2c 20 20 20 20 20 20 20 20 20  ON(min,         
acf0: 20 20 20 20 20 20 2d 31 2c 20 30 2c 20 31 2c 20        -1, 0, 1, 
ad00: 6d 69 6e 6d 61 78 46 75 6e 63 20 20 20 20 20 20  minmaxFunc      
ad10: 20 29 2c 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e   ),.    FUNCTION
ad20: 28 6d 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20  (min,           
ad30: 20 20 20 20 20 30 2c 20 30 2c 20 31 2c 20 30 20       0, 0, 1, 0 
ad40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 29                 )
ad50: 2c 0a 20 20 20 20 41 47 47 52 45 47 41 54 45 28  ,.    AGGREGATE(
ad60: 6d 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20  min,            
ad70: 20 20 20 31 2c 20 30 2c 20 31 2c 20 6d 69 6e 6d     1, 0, 1, minm
ad80: 61 78 53 74 65 70 2c 20 20 20 20 20 20 6d 69 6e  axStep,      min
ad90: 4d 61 78 46 69 6e 61 6c 69 7a 65 20 29 2c 0a 20  MaxFinalize ),. 
ada0: 20 20 20 46 55 4e 43 54 49 4f 4e 28 6d 61 78 2c     FUNCTION(max,
adb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d                 -
adc0: 31 2c 20 31 2c 20 31 2c 20 6d 69 6e 6d 61 78 46  1, 1, 1, minmaxF
add0: 75 6e 63 20 20 20 20 20 20 20 29 2c 0a 20 20 20  unc       ),.   
ade0: 20 46 55 4e 43 54 49 4f 4e 28 6d 61 78 2c 20 20   FUNCTION(max,  
adf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 2c                0,
ae00: 20 31 2c 20 31 2c 20 30 20 20 20 20 20 20 20 20   1, 1, 0        
ae10: 20 20 20 20 20 20 20 20 29 2c 0a 20 20 20 20 41          ),.    A
ae20: 47 47 52 45 47 41 54 45 28 6d 61 78 2c 20 20 20  GGREGATE(max,   
ae30: 20 20 20 20 20 20 20 20 20 20 20 20 31 2c 20 31              1, 1
ae40: 2c 20 31 2c 20 6d 69 6e 6d 61 78 53 74 65 70 2c  , 1, minmaxStep,
ae50: 20 20 20 20 20 20 6d 69 6e 4d 61 78 46 69 6e 61        minMaxFina
ae60: 6c 69 7a 65 20 29 2c 0a 20 20 20 20 46 55 4e 43  lize ),.    FUNC
ae70: 54 49 4f 4e 28 74 79 70 65 6f 66 2c 20 20 20 20  TION(typeof,    
ae80: 20 20 20 20 20 20 20 20 20 31 2c 20 30 2c 20 30           1, 0, 0
ae90: 2c 20 74 79 70 65 6f 66 46 75 6e 63 20 20 20 20  , typeofFunc    
aea0: 20 20 20 29 2c 0a 20 20 20 20 46 55 4e 43 54 49     ),.    FUNCTI
aeb0: 4f 4e 28 6c 65 6e 67 74 68 2c 20 20 20 20 20 20  ON(length,      
aec0: 20 20 20 20 20 20 20 31 2c 20 30 2c 20 30 2c 20         1, 0, 0, 
aed0: 6c 65 6e 67 74 68 46 75 6e 63 20 20 20 20 20 20  lengthFunc      
aee0: 20 29 2c 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e   ),.    FUNCTION
aef0: 28 73 75 62 73 74 72 2c 20 20 20 20 20 20 20 20  (substr,        
af00: 20 20 20 20 20 32 2c 20 30 2c 20 30 2c 20 73 75       2, 0, 0, su
af10: 62 73 74 72 46 75 6e 63 20 20 20 20 20 20 20 29  bstrFunc       )
af20: 2c 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 73  ,.    FUNCTION(s
af30: 75 62 73 74 72 2c 20 20 20 20 20 20 20 20 20 20  ubstr,          
af40: 20 20 20 33 2c 20 30 2c 20 30 2c 20 73 75 62 73     3, 0, 0, subs
af50: 74 72 46 75 6e 63 20 20 20 20 20 20 20 29 2c 0a  trFunc       ),.
af60: 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 61 62 73      FUNCTION(abs
af70: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
af80: 20 31 2c 20 30 2c 20 30 2c 20 61 62 73 46 75 6e   1, 0, 0, absFun
af90: 63 20 20 20 20 20 20 20 20 20 20 29 2c 0a 23 69  c          ),.#i
afa0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
afb0: 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54  T_FLOATING_POINT
afc0: 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 72 6f  .    FUNCTION(ro
afd0: 75 6e 64 2c 20 20 20 20 20 20 20 20 20 20 20 20  und,            
afe0: 20 20 31 2c 20 30 2c 20 30 2c 20 72 6f 75 6e 64    1, 0, 0, round
aff0: 46 75 6e 63 20 20 20 20 20 20 20 20 29 2c 0a 20  Func        ),. 
b000: 20 20 20 46 55 4e 43 54 49 4f 4e 28 72 6f 75 6e     FUNCTION(roun
b010: 64 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  d,              
b020: 32 2c 20 30 2c 20 30 2c 20 72 6f 75 6e 64 46 75  2, 0, 0, roundFu
b030: 6e 63 20 20 20 20 20 20 20 20 29 2c 0a 23 65 6e  nc        ),.#en
b040: 64 69 66 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e  dif.    FUNCTION
b050: 28 75 70 70 65 72 2c 20 20 20 20 20 20 20 20 20  (upper,         
b060: 20 20 20 20 20 31 2c 20 30 2c 20 30 2c 20 75 70       1, 0, 0, up
b070: 70 65 72 46 75 6e 63 20 20 20 20 20 20 20 20 29  perFunc        )
b080: 2c 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 6c  ,.    FUNCTION(l
b090: 6f 77 65 72 2c 20 20 20 20 20 20 20 20 20 20 20  ower,           
b0a0: 20 20 20 31 2c 20 30 2c 20 30 2c 20 6c 6f 77 65     1, 0, 0, lowe
b0b0: 72 46 75 6e 63 20 20 20 20 20 20 20 20 29 2c 0a  rFunc        ),.
b0c0: 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 63 6f 61      FUNCTION(coa
b0d0: 6c 65 73 63 65 2c 20 20 20 20 20 20 20 20 20 20  lesce,          
b0e0: 20 31 2c 20 30 2c 20 30 2c 20 30 20 20 20 20 20   1, 0, 0, 0     
b0f0: 20 20 20 20 20 20 20 20 20 20 20 29 2c 0a 20 20             ),.  
b100: 20 20 46 55 4e 43 54 49 4f 4e 28 63 6f 61 6c 65    FUNCTION(coale
b110: 73 63 65 2c 20 20 20 20 20 20 20 20 20 20 20 30  sce,           0
b120: 2c 20 30 2c 20 30 2c 20 30 20 20 20 20 20 20 20  , 0, 0, 0       
b130: 20 20 20 20 20 20 20 20 20 29 2c 0a 2f 2a 20 20           ),./*  
b140: 46 55 4e 43 54 49 4f 4e 28 63 6f 61 6c 65 73 63  FUNCTION(coalesc
b150: 65 2c 20 20 20 20 20 20 20 20 20 20 2d 31 2c 20  e,          -1, 
b160: 30 2c 20 30 2c 20 69 66 6e 75 6c 6c 46 75 6e 63  0, 0, ifnullFunc
b170: 20 20 20 20 20 20 20 29 2c 20 2a 2f 0a 20 20 20         ), */.   
b180: 20 7b 2d 31 2c 53 51 4c 49 54 45 5f 55 54 46 38   {-1,SQLITE_UTF8
b190: 2c 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 41  ,SQLITE_FUNC_COA
b1a0: 4c 45 53 43 45 2c 30 2c 30 2c 69 66 6e 75 6c 6c  LESCE,0,0,ifnull
b1b0: 46 75 6e 63 2c 30 2c 30 2c 22 63 6f 61 6c 65 73  Func,0,0,"coales
b1c0: 63 65 22 2c 30 7d 2c 0a 20 20 20 20 46 55 4e 43  ce",0},.    FUNC
b1d0: 54 49 4f 4e 28 68 65 78 2c 20 20 20 20 20 20 20  TION(hex,       
b1e0: 20 20 20 20 20 20 20 20 20 31 2c 20 30 2c 20 30           1, 0, 0
b1f0: 2c 20 68 65 78 46 75 6e 63 20 20 20 20 20 20 20  , hexFunc       
b200: 20 20 20 29 2c 0a 2f 2a 20 20 46 55 4e 43 54 49     ),./*  FUNCTI
b210: 4f 4e 28 69 66 6e 75 6c 6c 2c 20 20 20 20 20 20  ON(ifnull,      
b220: 20 20 20 20 20 20 20 32 2c 20 30 2c 20 30 2c 20         2, 0, 0, 
b230: 69 66 6e 75 6c 6c 46 75 6e 63 20 20 20 20 20 20  ifnullFunc      
b240: 20 29 2c 20 2a 2f 0a 20 20 20 20 7b 32 2c 53 51   ), */.    {2,SQ
b250: 4c 49 54 45 5f 55 54 46 38 2c 53 51 4c 49 54 45  LITE_UTF8,SQLITE
b260: 5f 46 55 4e 43 5f 43 4f 41 4c 45 53 43 45 2c 30  _FUNC_COALESCE,0
b270: 2c 30 2c 69 66 6e 75 6c 6c 46 75 6e 63 2c 30 2c  ,0,ifnullFunc,0,
b280: 30 2c 22 69 66 6e 75 6c 6c 22 2c 30 7d 2c 0a 20  0,"ifnull",0},. 
b290: 20 20 20 46 55 4e 43 54 49 4f 4e 28 72 61 6e 64     FUNCTION(rand
b2a0: 6f 6d 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  om,             
b2b0: 30 2c 20 30 2c 20 30 2c 20 72 61 6e 64 6f 6d 46  0, 0, 0, randomF
b2c0: 75 6e 63 20 20 20 20 20 20 20 29 2c 0a 20 20 20  unc       ),.   
b2d0: 20 46 55 4e 43 54 49 4f 4e 28 72 61 6e 64 6f 6d   FUNCTION(random
b2e0: 62 6c 6f 62 2c 20 20 20 20 20 20 20 20 20 31 2c  blob,         1,
b2f0: 20 30 2c 20 30 2c 20 72 61 6e 64 6f 6d 42 6c 6f   0, 0, randomBlo
b300: 62 20 20 20 20 20 20 20 29 2c 0a 20 20 20 20 46  b       ),.    F
b310: 55 4e 43 54 49 4f 4e 28 6e 75 6c 6c 69 66 2c 20  UNCTION(nullif, 
b320: 20 20 20 20 20 20 20 20 20 20 20 20 32 2c 20 30              2, 0
b330: 2c 20 31 2c 20 6e 75 6c 6c 69 66 46 75 6e 63 20  , 1, nullifFunc 
b340: 20 20 20 20 20 20 29 2c 0a 20 20 20 20 46 55 4e        ),.    FUN
b350: 43 54 49 4f 4e 28 73 71 6c 69 74 65 5f 76 65 72  CTION(sqlite_ver
b360: 73 69 6f 6e 2c 20 20 20 20 20 30 2c 20 30 2c 20  sion,     0, 0, 
b370: 30 2c 20 76 65 72 73 69 6f 6e 46 75 6e 63 20 20  0, versionFunc  
b380: 20 20 20 20 29 2c 0a 20 20 20 20 46 55 4e 43 54      ),.    FUNCT
b390: 49 4f 4e 28 73 71 6c 69 74 65 5f 73 6f 75 72 63  ION(sqlite_sourc
b3a0: 65 5f 69 64 2c 20 20 20 30 2c 20 30 2c 20 30 2c  e_id,   0, 0, 0,
b3b0: 20 73 6f 75 72 63 65 69 64 46 75 6e 63 20 20 20   sourceidFunc   
b3c0: 20 20 29 2c 0a 20 20 20 20 46 55 4e 43 54 49 4f    ),.    FUNCTIO
b3d0: 4e 28 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c 65  N(sqlite_compile
b3e0: 5f 6f 70 74 73 2c 30 2c 20 30 2c 20 30 2c 20 63  _opts,0, 0, 0, c
b3f0: 6f 6d 70 69 6c 65 6f 70 74 73 46 75 6e 63 20 20  ompileoptsFunc  
b400: 29 2c 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e 28  ),.    FUNCTION(
b410: 71 75 6f 74 65 2c 20 20 20 20 20 20 20 20 20 20  quote,          
b420: 20 20 20 20 31 2c 20 30 2c 20 30 2c 20 71 75 6f      1, 0, 0, quo
b430: 74 65 46 75 6e 63 20 20 20 20 20 20 20 20 29 2c  teFunc        ),
b440: 0a 20 20 20 20 46 55 4e 43 54 49 4f 4e 28 6c 61  .    FUNCTION(la
b450: 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 2c  st_insert_rowid,
b460: 20 20 30 2c 20 30 2c 20 30 2c 20 6c 61 73 74 5f    0, 0, 0, last_
b470: 69 6e 73 65 72 74 5f 72 6f 77 69 64 29 2c 0a 20  insert_rowid),. 
b480: 20 20 20 46 55 4e 43 54 49 4f 4e 28 63 68 61 6e     FUNCTION(chan
b490: 67 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20  ges,            
b4a0: 30 2c 20 30 2c 20 30 2c 20 63 68 61 6e 67 65 73  0, 0, 0, changes
b4b0: 20 20 20 20 20 20 20 20 20 20 29 2c 0a 20 20 20            ),.   
b4c0: 20 46 55 4e 43 54 49 4f 4e 28 74 6f 74 61 6c 5f   FUNCTION(total_
b4d0: 63 68 61 6e 67 65 73 2c 20 20 20 20 20 20 30 2c  changes,      0,
b4e0: 20 30 2c 20 30 2c 20 74 6f 74 61 6c 5f 63 68 61   0, 0, total_cha
b4f0: 6e 67 65 73 20 20 20 20 29 2c 0a 20 20 20 20 46  nges    ),.    F
b500: 55 4e 43 54 49 4f 4e 28 72 65 70 6c 61 63 65 2c  UNCTION(replace,
b510: 20 20 20 20 20 20 20 20 20 20 20 20 33 2c 20 30              3, 0
b520: 2c 20 30 2c 20 72 65 70 6c 61 63 65 46 75 6e 63  , 0, replaceFunc
b530: 20 20 20 20 20 20 29 2c 0a 20 20 20 20 46 55 4e        ),.    FUN
b540: 43 54 49 4f 4e 28 7a 65 72 6f 62 6c 6f 62 2c 20  CTION(zeroblob, 
b550: 20 20 20 20 20 20 20 20 20 20 31 2c 20 30 2c 20            1, 0, 
b560: 30 2c 20 7a 65 72 6f 62 6c 6f 62 46 75 6e 63 20  0, zeroblobFunc 
b570: 20 20 20 20 29 2c 0a 20 20 23 69 66 64 65 66 20      ),.  #ifdef 
b580: 53 51 4c 49 54 45 5f 53 4f 55 4e 44 45 58 0a 20  SQLITE_SOUNDEX. 
b590: 20 20 20 46 55 4e 43 54 49 4f 4e 28 73 6f 75 6e     FUNCTION(soun
b5a0: 64 65 78 2c 20 20 20 20 20 20 20 20 20 20 20 20  dex,            
b5b0: 31 2c 20 30 2c 20 30 2c 20 73 6f 75 6e 64 65 78  1, 0, 0, soundex
b5c0: 46 75 6e 63 20 20 20 20 20 20 29 2c 0a 20 20 23  Func      ),.  #
b5d0: 65 6e 64 69 66 0a 20 20 23 69 66 6e 64 65 66 20  endif.  #ifndef 
b5e0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44  SQLITE_OMIT_LOAD
b5f0: 5f 45 58 54 45 4e 53 49 4f 4e 0a 20 20 20 20 46  _EXTENSION.    F
b600: 55 4e 43 54 49 4f 4e 28 6c 6f 61 64 5f 65 78 74  UNCTION(load_ext
b610: 65 6e 73 69 6f 6e 2c 20 20 20 20 20 31 2c 20 30  ension,     1, 0
b620: 2c 20 30 2c 20 6c 6f 61 64 45 78 74 20 20 20 20  , 0, loadExt    
b630: 20 20 20 20 20 20 29 2c 0a 20 20 20 20 46 55 4e        ),.    FUN
b640: 43 54 49 4f 4e 28 6c 6f 61 64 5f 65 78 74 65 6e  CTION(load_exten
b650: 73 69 6f 6e 2c 20 20 20 20 20 32 2c 20 30 2c 20  sion,     2, 0, 
b660: 30 2c 20 6c 6f 61 64 45 78 74 20 20 20 20 20 20  0, loadExt      
b670: 20 20 20 20 29 2c 0a 20 20 23 65 6e 64 69 66 0a      ),.  #endif.
b680: 20 20 20 20 41 47 47 52 45 47 41 54 45 28 73 75      AGGREGATE(su
b690: 6d 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  m,              
b6a0: 20 31 2c 20 30 2c 20 30 2c 20 73 75 6d 53 74 65   1, 0, 0, sumSte
b6b0: 70 2c 20 20 20 20 20 20 20 20 20 73 75 6d 46 69  p,         sumFi
b6c0: 6e 61 6c 69 7a 65 20 20 20 20 29 2c 0a 20 20 20  nalize    ),.   
b6d0: 20 41 47 47 52 45 47 41 54 45 28 74 6f 74 61 6c   AGGREGATE(total
b6e0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 31 2c  ,             1,
b6f0: 20 30 2c 20 30 2c 20 73 75 6d 53 74 65 70 2c 20   0, 0, sumStep, 
b700: 20 20 20 20 20 20 20 20 74 6f 74 61 6c 46 69 6e          totalFin
b710: 61 6c 69 7a 65 20 20 20 20 29 2c 0a 20 20 20 20  alize    ),.    
b720: 41 47 47 52 45 47 41 54 45 28 61 76 67 2c 20 20  AGGREGATE(avg,  
b730: 20 20 20 20 20 20 20 20 20 20 20 20 20 31 2c 20               1, 
b740: 30 2c 20 30 2c 20 73 75 6d 53 74 65 70 2c 20 20  0, 0, sumStep,  
b750: 20 20 20 20 20 20 20 61 76 67 46 69 6e 61 6c 69         avgFinali
b760: 7a 65 20 20 20 20 29 2c 0a 20 2f 2a 20 41 47 47  ze    ),. /* AGG
b770: 52 45 47 41 54 45 28 63 6f 75 6e 74 2c 20 20 20  REGATE(count,   
b780: 20 20 20 20 20 20 20 20 20 20 30 2c 20 30 2c 20            0, 0, 
b790: 30 2c 20 63 6f 75 6e 74 53 74 65 70 2c 20 20 20  0, countStep,   
b7a0: 20 20 20 20 63 6f 75 6e 74 46 69 6e 61 6c 69 7a      countFinaliz
b7b0: 65 20 20 29 2c 20 2a 2f 0a 20 20 20 20 7b 30 2c  e  ), */.    {0,
b7c0: 53 51 4c 49 54 45 5f 55 54 46 38 2c 53 51 4c 49  SQLITE_UTF8,SQLI
b7d0: 54 45 5f 46 55 4e 43 5f 43 4f 55 4e 54 2c 30 2c  TE_FUNC_COUNT,0,
b7e0: 30 2c 30 2c 63 6f 75 6e 74 53 74 65 70 2c 63 6f  0,0,countStep,co
b7f0: 75 6e 74 46 69 6e 61 6c 69 7a 65 2c 22 63 6f 75  untFinalize,"cou
b800: 6e 74 22 2c 30 7d 2c 0a 20 20 20 20 41 47 47 52  nt",0},.    AGGR
b810: 45 47 41 54 45 28 63 6f 75 6e 74 2c 20 20 20 20  EGATE(count,    
b820: 20 20 20 20 20 20 20 20 20 31 2c 20 30 2c 20 30           1, 0, 0
b830: 2c 20 63 6f 75 6e 74 53 74 65 70 2c 20 20 20 20  , countStep,    
b840: 20 20 20 63 6f 75 6e 74 46 69 6e 61 6c 69 7a 65     countFinalize
b850: 20 20 29 2c 0a 20 20 20 20 41 47 47 52 45 47 41    ),.    AGGREGA
b860: 54 45 28 67 72 6f 75 70 5f 63 6f 6e 63 61 74 2c  TE(group_concat,
b870: 20 20 20 20 20 20 31 2c 20 30 2c 20 30 2c 20 67        1, 0, 0, g
b880: 72 6f 75 70 43 6f 6e 63 61 74 53 74 65 70 2c 20  roupConcatStep, 
b890: 67 72 6f 75 70 43 6f 6e 63 61 74 46 69 6e 61 6c  groupConcatFinal
b8a0: 69 7a 65 29 2c 0a 20 20 20 20 41 47 47 52 45 47  ize),.    AGGREG
b8b0: 41 54 45 28 67 72 6f 75 70 5f 63 6f 6e 63 61 74  ATE(group_concat
b8c0: 2c 20 20 20 20 20 20 32 2c 20 30 2c 20 30 2c 20  ,      2, 0, 0, 
b8d0: 67 72 6f 75 70 43 6f 6e 63 61 74 53 74 65 70 2c  groupConcatStep,
b8e0: 20 67 72 6f 75 70 43 6f 6e 63 61 74 46 69 6e 61   groupConcatFina
b8f0: 6c 69 7a 65 29 2c 0a 20 20 0a 20 20 20 20 4c 49  lize),.  .    LI
b900: 4b 45 46 55 4e 43 28 67 6c 6f 62 2c 20 32 2c 20  KEFUNC(glob, 2, 
b910: 26 67 6c 6f 62 49 6e 66 6f 2c 20 53 51 4c 49 54  &globInfo, SQLIT
b920: 45 5f 46 55 4e 43 5f 4c 49 4b 45 7c 53 51 4c 49  E_FUNC_LIKE|SQLI
b930: 54 45 5f 46 55 4e 43 5f 43 41 53 45 29 2c 0a 20  TE_FUNC_CASE),. 
b940: 20 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 43   #ifdef SQLITE_C
b950: 41 53 45 5f 53 45 4e 53 49 54 49 56 45 5f 4c 49  ASE_SENSITIVE_LI
b960: 4b 45 0a 20 20 20 20 4c 49 4b 45 46 55 4e 43 28  KE.    LIKEFUNC(
b970: 6c 69 6b 65 2c 20 32 2c 20 26 6c 69 6b 65 49 6e  like, 2, &likeIn
b980: 66 6f 41 6c 74 2c 20 53 51 4c 49 54 45 5f 46 55  foAlt, SQLITE_FU
b990: 4e 43 5f 4c 49 4b 45 7c 53 51 4c 49 54 45 5f 46  NC_LIKE|SQLITE_F
b9a0: 55 4e 43 5f 43 41 53 45 29 2c 0a 20 20 20 20 4c  UNC_CASE),.    L
b9b0: 49 4b 45 46 55 4e 43 28 6c 69 6b 65 2c 20 33 2c  IKEFUNC(like, 3,
b9c0: 20 26 6c 69 6b 65 49 6e 66 6f 41 6c 74 2c 20 53   &likeInfoAlt, S
b9d0: 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 49 4b 45 7c  QLITE_FUNC_LIKE|
b9e0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 41 53 45  SQLITE_FUNC_CASE
b9f0: 29 2c 0a 20 20 23 65 6c 73 65 0a 20 20 20 20 4c  ),.  #else.    L
ba00: 49 4b 45 46 55 4e 43 28 6c 69 6b 65 2c 20 32 2c  IKEFUNC(like, 2,
ba10: 20 26 6c 69 6b 65 49 6e 66 6f 4e 6f 72 6d 2c 20   &likeInfoNorm, 
ba20: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 49 4b 45  SQLITE_FUNC_LIKE
ba30: 29 2c 0a 20 20 20 20 4c 49 4b 45 46 55 4e 43 28  ),.    LIKEFUNC(
ba40: 6c 69 6b 65 2c 20 33 2c 20 26 6c 69 6b 65 49 6e  like, 3, &likeIn
ba50: 66 6f 4e 6f 72 6d 2c 20 53 51 4c 49 54 45 5f 46  foNorm, SQLITE_F
ba60: 55 4e 43 5f 4c 49 4b 45 29 2c 0a 20 20 23 65 6e  UNC_LIKE),.  #en
ba70: 64 69 66 0a 20 20 7d 3b 0a 0a 20 20 69 6e 74 20  dif.  };..  int 
ba80: 69 3b 0a 20 20 46 75 6e 63 44 65 66 48 61 73 68  i;.  FuncDefHash
ba90: 20 2a 70 48 61 73 68 20 3d 20 26 47 4c 4f 42 41   *pHash = &GLOBA
baa0: 4c 28 46 75 6e 63 44 65 66 48 61 73 68 2c 20 73  L(FuncDefHash, s
bab0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 46 75 6e 63  qlite3GlobalFunc
bac0: 74 69 6f 6e 73 29 3b 0a 20 20 46 75 6e 63 44 65  tions);.  FuncDe
bad0: 66 20 2a 61 46 75 6e 63 20 3d 20 28 46 75 6e 63  f *aFunc = (Func
bae0: 44 65 66 2a 29 26 47 4c 4f 42 41 4c 28 46 75 6e  Def*)&GLOBAL(Fun
baf0: 63 44 65 66 2c 20 61 42 75 69 6c 74 69 6e 46 75  cDef, aBuiltinFu
bb00: 6e 63 29 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b  nc);..  for(i=0;
bb10: 20 69 3c 41 72 72 61 79 53 69 7a 65 28 61 42 75   i<ArraySize(aBu
bb20: 69 6c 74 69 6e 46 75 6e 63 29 3b 20 69 2b 2b 29  iltinFunc); i++)
bb30: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 46 75 6e  {.    sqlite3Fun
bb40: 63 44 65 66 49 6e 73 65 72 74 28 70 48 61 73 68  cDefInsert(pHash
bb50: 2c 20 26 61 46 75 6e 63 5b 69 5d 29 3b 0a 20 20  , &aFunc[i]);.  
bb60: 7d 0a 20 20 73 71 6c 69 74 65 33 52 65 67 69 73  }.  sqlite3Regis
bb70: 74 65 72 44 61 74 65 54 69 6d 65 46 75 6e 63 74  terDateTimeFunct
bb80: 69 6f 6e 73 28 29 3b 0a 7d 0a                    ions();.}.