/ Hex Artifact Content
Login

Artifact a58fef26514e26f49312785d2fde370e3a8a85a4:


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 2a 0a 2a  file scope..**.*
0280: 2a 20 24 49 64 3a 20 66 75 6e 63 2e 63 2c 76 20  * $Id: func.c,v 
0290: 31 2e 36 37 20 32 30 30 34 2f 30 36 2f 31 32 20  1.67 2004/06/12 
02a0: 30 30 3a 34 32 3a 33 35 20 64 61 6e 69 65 6c 6b  00:42:35 danielk
02b0: 31 39 37 37 20 45 78 70 20 24 0a 2a 2f 0a 23 69  1977 Exp $.*/.#i
02c0: 6e 63 6c 75 64 65 20 3c 63 74 79 70 65 2e 68 3e  nclude <ctype.h>
02d0: 0a 23 69 6e 63 6c 75 64 65 20 3c 6d 61 74 68 2e  .#include <math.
02e0: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 64  h>.#include <std
02f0: 6c 69 62 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20  lib.h>.#include 
0300: 3c 61 73 73 65 72 74 2e 68 3e 0a 23 69 6e 63 6c  <assert.h>.#incl
0310: 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68  ude "sqliteInt.h
0320: 22 0a 23 69 6e 63 6c 75 64 65 20 22 76 64 62 65  ".#include "vdbe
0330: 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20  Int.h".#include 
0340: 22 6f 73 2e 68 22 0a 0a 73 74 61 74 69 63 20 43  "os.h"..static C
0350: 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 47  ollSeq *sqlite3G
0360: 65 74 46 75 6e 63 43 6f 6c 6c 53 65 71 28 73 71  etFuncCollSeq(sq
0370: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63  lite3_context *c
0380: 6f 6e 74 65 78 74 29 7b 0a 20 20 72 65 74 75 72  ontext){.  retur
0390: 6e 20 63 6f 6e 74 65 78 74 2d 3e 70 43 6f 6c 6c  n context->pColl
03a0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  ;.}../*.** Imple
03b0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
03c0: 20 6e 6f 6e 2d 61 67 67 72 65 67 61 74 65 20 6d   non-aggregate m
03d0: 69 6e 28 29 20 61 6e 64 20 6d 61 78 28 29 20 66  in() and max() f
03e0: 75 6e 63 74 69 6f 6e 73 0a 2a 2f 0a 73 74 61 74  unctions.*/.stat
03f0: 69 63 20 76 6f 69 64 20 6d 69 6e 6d 61 78 46 75  ic void minmaxFu
0400: 6e 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  nc(.  sqlite3_co
0410: 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a  ntext *context,.
0420: 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71    int argc,.  sq
0430: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
0440: 67 76 0a 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20  gv.){.  int i;. 
0450: 20 69 6e 74 20 6d 61 73 6b 3b 20 20 20 20 2f 2a   int mask;    /*
0460: 20 30 20 66 6f 72 20 6d 69 6e 28 29 20 6f 72 20   0 for min() or 
0470: 30 78 66 66 66 66 66 66 66 66 20 66 6f 72 20 6d  0xffffffff for m
0480: 61 78 28 29 20 2a 2f 0a 20 20 69 6e 74 20 69 42  ax() */.  int iB
0490: 65 73 74 3b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a  est;.  CollSeq *
04a0: 70 43 6f 6c 6c 3b 0a 0a 20 20 69 66 28 20 61 72  pColl;..  if( ar
04b0: 67 63 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a  gc==0 ) return;.
04c0: 20 20 6d 61 73 6b 20 3d 20 28 69 6e 74 29 73 71    mask = (int)sq
04d0: 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28  lite3_user_data(
04e0: 63 6f 6e 74 65 78 74 29 3b 0a 20 20 70 43 6f 6c  context);.  pCol
04f0: 6c 20 3d 20 73 71 6c 69 74 65 33 47 65 74 46 75  l = sqlite3GetFu
0500: 6e 63 43 6f 6c 6c 53 65 71 28 63 6f 6e 74 65 78  ncCollSeq(contex
0510: 74 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43  t);.  assert( pC
0520: 6f 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28  oll );.  assert(
0530: 20 6d 61 73 6b 3d 3d 2d 31 20 7c 7c 20 6d 61 73   mask==-1 || mas
0540: 6b 3d 3d 30 20 29 3b 0a 20 20 69 42 65 73 74 20  k==0 );.  iBest 
0550: 3d 20 30 3b 0a 20 20 69 66 28 20 73 71 6c 69 74  = 0;.  if( sqlit
0560: 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72  e3_value_type(ar
0570: 67 76 5b 30 5d 29 3d 3d 53 51 4c 49 54 45 5f 4e  gv[0])==SQLITE_N
0580: 55 4c 4c 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  ULL ) return;.  
0590: 66 6f 72 28 69 3d 31 3b 20 69 3c 61 72 67 63 3b  for(i=1; i<argc;
05a0: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 73   i++){.    if( s
05b0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
05c0: 65 28 61 72 67 76 5b 69 5d 29 3d 3d 53 51 4c 49  e(argv[i])==SQLI
05d0: 54 45 5f 4e 55 4c 4c 20 29 20 72 65 74 75 72 6e  TE_NULL ) return
05e0: 3b 0a 20 20 20 20 69 66 28 20 28 73 71 6c 69 74  ;.    if( (sqlit
05f0: 65 33 4d 65 6d 43 6f 6d 70 61 72 65 28 61 72 67  e3MemCompare(arg
0600: 76 5b 69 42 65 73 74 5d 2c 20 61 72 67 76 5b 69  v[iBest], argv[i
0610: 5d 2c 20 70 43 6f 6c 6c 29 5e 6d 61 73 6b 29 3e  ], pColl)^mask)>
0620: 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 42 65 73  =0 ){.      iBes
0630: 74 20 3d 20 69 3b 0a 20 20 20 20 7d 0a 20 20 7d  t = i;.    }.  }
0640: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
0650: 74 5f 76 61 6c 75 65 28 63 6f 6e 74 65 78 74 2c  t_value(context,
0660: 20 61 72 67 76 5b 69 42 65 73 74 5d 29 3b 0a 7d   argv[iBest]);.}
0670: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
0680: 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 61  he type of the a
0690: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74  rgument..*/.stat
06a0: 69 63 20 76 6f 69 64 20 74 79 70 65 6f 66 46 75  ic void typeofFu
06b0: 6e 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  nc(.  sqlite3_co
06c0: 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a  ntext *context,.
06d0: 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71    int argc,.  sq
06e0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
06f0: 67 76 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68  gv.){.  const ch
0700: 61 72 20 2a 7a 20 3d 20 30 3b 0a 20 20 73 77 69  ar *z = 0;.  swi
0710: 74 63 68 28 20 73 71 6c 69 74 65 33 5f 76 61 6c  tch( sqlite3_val
0720: 75 65 5f 74 79 70 65 28 61 72 67 76 5b 30 5d 29  ue_type(argv[0])
0730: 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c   ){.    case SQL
0740: 49 54 45 5f 4e 55 4c 4c 3a 20 20 20 20 7a 20 3d  ITE_NULL:    z =
0750: 20 22 6e 75 6c 6c 22 3b 20 20 20 20 62 72 65 61   "null";    brea
0760: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49  k;.    case SQLI
0770: 54 45 5f 49 4e 54 45 47 45 52 3a 20 7a 20 3d 20  TE_INTEGER: z = 
0780: 22 69 6e 74 65 67 65 72 22 3b 20 62 72 65 61 6b  "integer"; break
0790: 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  ;.    case SQLIT
07a0: 45 5f 54 45 58 54 3a 20 20 20 20 7a 20 3d 20 22  E_TEXT:    z = "
07b0: 74 65 78 74 22 3b 20 20 20 20 62 72 65 61 6b 3b  text";    break;
07c0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
07d0: 5f 46 4c 4f 41 54 3a 20 20 20 7a 20 3d 20 22 72  _FLOAT:   z = "r
07e0: 65 61 6c 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a  eal";    break;.
07f0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f      case SQLITE_
0800: 42 4c 4f 42 3a 20 20 20 20 7a 20 3d 20 22 62 6c  BLOB:    z = "bl
0810: 6f 62 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20  ob";    break;. 
0820: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73   }.  sqlite3_res
0830: 75 6c 74 5f 74 65 78 74 28 63 6f 6e 74 65 78 74  ult_text(context
0840: 2c 20 7a 2c 20 2d 31 2c 20 30 29 3b 0a 7d 0a 0a  , z, -1, 0);.}..
0850: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
0860: 74 69 6f 6e 20 6f 66 20 74 68 65 20 6c 65 6e 67  tion of the leng
0870: 74 68 28 29 20 66 75 6e 63 74 69 6f 6e 0a 2a 2f  th() function.*/
0880: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6c 65 6e  .static void len
0890: 67 74 68 46 75 6e 63 28 0a 20 20 73 71 6c 69 74  gthFunc(.  sqlit
08a0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74  e3_context *cont
08b0: 65 78 74 2c 0a 20 20 69 6e 74 20 61 72 67 63 2c  ext,.  int argc,
08c0: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  .  sqlite3_value
08d0: 20 2a 2a 61 72 67 76 0a 29 7b 0a 20 20 69 6e 74   **argv.){.  int
08e0: 20 6c 65 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28   len;..  assert(
08f0: 20 61 72 67 63 3d 3d 31 20 29 3b 0a 20 20 73 77   argc==1 );.  sw
0900: 69 74 63 68 28 20 73 71 6c 69 74 65 33 5f 76 61  itch( sqlite3_va
0910: 6c 75 65 5f 74 79 70 65 28 61 72 67 76 5b 30 5d  lue_type(argv[0]
0920: 29 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51  ) ){.    case SQ
0930: 4c 49 54 45 5f 42 4c 4f 42 3a 0a 20 20 20 20 63  LITE_BLOB:.    c
0940: 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 47  ase SQLITE_INTEG
0950: 45 52 3a 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ER:.    case SQL
0960: 49 54 45 5f 46 4c 4f 41 54 3a 20 7b 0a 20 20 20  ITE_FLOAT: {.   
0970: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
0980: 74 5f 69 6e 74 28 63 6f 6e 74 65 78 74 2c 20 73  t_int(context, s
0990: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74  qlite3_value_byt
09a0: 65 73 28 61 72 67 76 5b 30 5d 29 29 3b 0a 20 20  es(argv[0]));.  
09b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
09c0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
09d0: 5f 54 45 58 54 3a 20 7b 0a 20 20 20 20 20 20 63  _TEXT: {.      c
09e0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 73  onst char *z = s
09f0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
0a00: 74 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20  t(argv[0]);.    
0a10: 20 20 66 6f 72 28 6c 65 6e 3d 30 3b 20 2a 7a 3b    for(len=0; *z;
0a20: 20 7a 2b 2b 29 7b 20 69 66 28 20 28 30 78 63 30   z++){ if( (0xc0
0a30: 26 2a 7a 29 21 3d 30 78 38 30 20 29 20 6c 65 6e  &*z)!=0x80 ) len
0a40: 2b 2b 3b 20 7d 0a 20 20 20 20 20 20 73 71 6c 69  ++; }.      sqli
0a50: 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 28 63  te3_result_int(c
0a60: 6f 6e 74 65 78 74 2c 20 6c 65 6e 29 3b 0a 20 20  ontext, len);.  
0a70: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
0a80: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a  .    default: {.
0a90: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65        sqlite3_re
0aa0: 73 75 6c 74 5f 6e 75 6c 6c 28 63 6f 6e 74 65 78  sult_null(contex
0ab0: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b  t);.      break;
0ac0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a  .    }.  }.}../*
0ad0: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69  .** Implementati
0ae0: 6f 6e 20 6f 66 20 74 68 65 20 61 62 73 28 29 20  on of the abs() 
0af0: 66 75 6e 63 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74  function.*/.stat
0b00: 69 63 20 76 6f 69 64 20 61 62 73 46 75 6e 63 28  ic void absFunc(
0b10: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
0b20: 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61 72  *context, int ar
0b30: 67 63 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  gc, sqlite3_valu
0b40: 65 20 2a 2a 61 72 67 76 29 7b 0a 20 20 61 73 73  e **argv){.  ass
0b50: 65 72 74 28 20 61 72 67 63 3d 3d 31 20 29 3b 0a  ert( argc==1 );.
0b60: 20 20 73 77 69 74 63 68 28 20 73 71 6c 69 74 65    switch( sqlite
0b70: 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67  3_value_type(arg
0b80: 76 5b 30 5d 29 20 29 7b 0a 20 20 20 20 63 61 73  v[0]) ){.    cas
0b90: 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52  e SQLITE_INTEGER
0ba0: 3a 20 7b 0a 20 20 20 20 20 20 69 36 34 20 69 56  : {.      i64 iV
0bb0: 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c  al = sqlite3_val
0bc0: 75 65 5f 69 6e 74 36 34 28 61 72 67 76 5b 30 5d  ue_int64(argv[0]
0bd0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 56 61  );.      if( iVa
0be0: 6c 3c 30 20 29 20 69 56 61 6c 20 3d 20 69 56 61  l<0 ) iVal = iVa
0bf0: 6c 20 2a 20 2d 31 3b 0a 20 20 20 20 20 20 73 71  l * -1;.      sq
0c00: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74  lite3_result_int
0c10: 36 34 28 63 6f 6e 74 65 78 74 2c 20 69 56 61 6c  64(context, iVal
0c20: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  );.      break;.
0c30: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53      }.    case S
0c40: 51 4c 49 54 45 5f 4e 55 4c 4c 3a 20 7b 0a 20 20  QLITE_NULL: {.  
0c50: 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75      sqlite3_resu
0c60: 6c 74 5f 6e 75 6c 6c 28 63 6f 6e 74 65 78 74 29  lt_null(context)
0c70: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;.      break;. 
0c80: 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74     }.    default
0c90: 3a 20 7b 0a 20 20 20 20 20 20 64 6f 75 62 6c 65  : {.      double
0ca0: 20 72 56 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f   rVal = sqlite3_
0cb0: 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 61 72 67  value_double(arg
0cc0: 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 69 66 28  v[0]);.      if(
0cd0: 20 72 56 61 6c 3c 30 20 29 20 72 56 61 6c 20 3d   rVal<0 ) rVal =
0ce0: 20 72 56 61 6c 20 2a 20 2d 31 2e 30 3b 0a 20 20   rVal * -1.0;.  
0cf0: 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75      sqlite3_resu
0d00: 6c 74 5f 64 6f 75 62 6c 65 28 63 6f 6e 74 65 78  lt_double(contex
0d10: 74 2c 20 72 56 61 6c 29 3b 0a 20 20 20 20 20 20  t, rVal);.      
0d20: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d  break;.    }.  }
0d30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
0d40: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
0d50: 73 75 62 73 74 72 28 29 20 66 75 6e 63 74 69 6f  substr() functio
0d60: 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  n.*/.static void
0d70: 20 73 75 62 73 74 72 46 75 6e 63 28 0a 20 20 73   substrFunc(.  s
0d80: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0d90: 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20 61  context,.  int a
0da0: 72 67 63 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  rgc,.  sqlite3_v
0db0: 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20  alue **argv.){. 
0dc0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a   const char *z;.
0dd0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 32    const char *z2
0de0: 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74  ;.  int i;.  int
0df0: 20 70 31 2c 20 70 32 2c 20 6c 65 6e 3b 0a 0a 20   p1, p2, len;.. 
0e00: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 33   assert( argc==3
0e10: 20 29 3b 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65   );.  z = sqlite
0e20: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67  3_value_text(arg
0e30: 76 5b 30 5d 29 3b 0a 20 20 69 66 28 20 7a 3d 3d  v[0]);.  if( z==
0e40: 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 70 31  0 ) return;.  p1
0e50: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
0e60: 5f 69 6e 74 28 61 72 67 76 5b 31 5d 29 3b 0a 20  _int(argv[1]);. 
0e70: 20 70 32 20 3d 20 73 71 6c 69 74 65 33 5f 76 61   p2 = sqlite3_va
0e80: 6c 75 65 5f 69 6e 74 28 61 72 67 76 5b 32 5d 29  lue_int(argv[2])
0e90: 3b 0a 20 20 66 6f 72 28 6c 65 6e 3d 30 2c 20 7a  ;.  for(len=0, z
0ea0: 32 3d 7a 3b 20 2a 7a 32 3b 20 7a 32 2b 2b 29 7b  2=z; *z2; z2++){
0eb0: 20 69 66 28 20 28 30 78 63 30 26 2a 7a 32 29 21   if( (0xc0&*z2)!
0ec0: 3d 30 78 38 30 20 29 20 6c 65 6e 2b 2b 3b 20 7d  =0x80 ) len++; }
0ed0: 0a 20 20 69 66 28 20 70 31 3c 30 20 29 7b 0a 20  .  if( p1<0 ){. 
0ee0: 20 20 20 70 31 20 2b 3d 20 6c 65 6e 3b 0a 20 20     p1 += len;.  
0ef0: 20 20 69 66 28 20 70 31 3c 30 20 29 7b 0a 20 20    if( p1<0 ){.  
0f00: 20 20 20 20 70 32 20 2b 3d 20 70 31 3b 0a 20 20      p2 += p1;.  
0f10: 20 20 20 20 70 31 20 3d 20 30 3b 0a 20 20 20 20      p1 = 0;.    
0f20: 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 31  }.  }else if( p1
0f30: 3e 30 20 29 7b 0a 20 20 20 20 70 31 2d 2d 3b 0a  >0 ){.    p1--;.
0f40: 20 20 7d 0a 20 20 69 66 28 20 70 31 2b 70 32 3e    }.  if( p1+p2>
0f50: 6c 65 6e 20 29 7b 0a 20 20 20 20 70 32 20 3d 20  len ){.    p2 = 
0f60: 6c 65 6e 2d 70 31 3b 0a 20 20 7d 0a 20 20 66 6f  len-p1;.  }.  fo
0f70: 72 28 69 3d 30 3b 20 69 3c 70 31 20 26 26 20 7a  r(i=0; i<p1 && z
0f80: 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69  [i]; i++){.    i
0f90: 66 28 20 28 7a 5b 69 5d 26 30 78 63 30 29 3d 3d  f( (z[i]&0xc0)==
0fa0: 30 78 38 30 20 29 20 70 31 2b 2b 3b 0a 20 20 7d  0x80 ) p1++;.  }
0fb0: 0a 20 20 77 68 69 6c 65 28 20 7a 5b 69 5d 20 26  .  while( z[i] &
0fc0: 26 20 28 7a 5b 69 5d 26 30 78 63 30 29 3d 3d 30  & (z[i]&0xc0)==0
0fd0: 78 38 30 20 29 7b 20 69 2b 2b 3b 20 70 31 2b 2b  x80 ){ i++; p1++
0fe0: 3b 20 7d 0a 20 20 66 6f 72 28 3b 20 69 3c 70 31  ; }.  for(; i<p1
0ff0: 2b 70 32 20 26 26 20 7a 5b 69 5d 3b 20 69 2b 2b  +p2 && z[i]; i++
1000: 29 7b 0a 20 20 20 20 69 66 28 20 28 7a 5b 69 5d  ){.    if( (z[i]
1010: 26 30 78 63 30 29 3d 3d 30 78 38 30 20 29 20 70  &0xc0)==0x80 ) p
1020: 32 2b 2b 3b 0a 20 20 7d 0a 20 20 77 68 69 6c 65  2++;.  }.  while
1030: 28 20 7a 5b 69 5d 20 26 26 20 28 7a 5b 69 5d 26  ( z[i] && (z[i]&
1040: 30 78 63 30 29 3d 3d 30 78 38 30 20 29 7b 20 69  0xc0)==0x80 ){ i
1050: 2b 2b 3b 20 70 32 2b 2b 3b 20 7d 0a 20 20 69 66  ++; p2++; }.  if
1060: 28 20 70 32 3c 30 20 29 20 70 32 20 3d 20 30 3b  ( p2<0 ) p2 = 0;
1070: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
1080: 74 5f 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20  t_text(context, 
1090: 26 7a 5b 70 31 5d 2c 20 70 32 2c 20 31 29 3b 0a  &z[p1], p2, 1);.
10a0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
10b0: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 72  ntation of the r
10c0: 6f 75 6e 64 28 29 20 66 75 6e 63 74 69 6f 6e 0a  ound() function.
10d0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72  */.static void r
10e0: 6f 75 6e 64 46 75 6e 63 28 73 71 6c 69 74 65 33  oundFunc(sqlite3
10f0: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
1100: 74 2c 20 69 6e 74 20 61 72 67 63 2c 20 73 71 6c  t, int argc, sql
1110: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67  ite3_value **arg
1120: 76 29 7b 0a 20 20 69 6e 74 20 6e 20 3d 20 30 3b  v){.  int n = 0;
1130: 0a 20 20 64 6f 75 62 6c 65 20 72 3b 0a 20 20 63  .  double r;.  c
1140: 68 61 72 20 7a 42 75 66 5b 31 30 30 5d 3b 0a 20  har zBuf[100];. 
1150: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 31   assert( argc==1
1160: 20 7c 7c 20 61 72 67 63 3d 3d 32 20 29 3b 0a 20   || argc==2 );. 
1170: 20 69 66 28 20 61 72 67 63 3d 3d 32 20 29 7b 0a   if( argc==2 ){.
1180: 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4e      if( SQLITE_N
1190: 55 4c 4c 3d 3d 73 71 6c 69 74 65 33 5f 76 61 6c  ULL==sqlite3_val
11a0: 75 65 5f 74 79 70 65 28 61 72 67 76 5b 31 5d 29  ue_type(argv[1])
11b0: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 6e   ) return;.    n
11c0: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
11d0: 5f 69 6e 74 28 61 72 67 76 5b 31 5d 29 3b 0a 20  _int(argv[1]);. 
11e0: 20 20 20 69 66 28 20 6e 3e 33 30 20 29 20 6e 20     if( n>30 ) n 
11f0: 3d 20 33 30 3b 0a 20 20 20 20 69 66 28 20 6e 3c  = 30;.    if( n<
1200: 30 20 29 20 6e 20 3d 20 30 3b 0a 20 20 7d 0a 20  0 ) n = 0;.  }. 
1210: 20 69 66 28 20 53 51 4c 49 54 45 5f 4e 55 4c 4c   if( SQLITE_NULL
1220: 3d 3d 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ==sqlite3_value_
1230: 74 79 70 65 28 61 72 67 76 5b 30 5d 29 20 29 20  type(argv[0]) ) 
1240: 72 65 74 75 72 6e 3b 0a 20 20 72 20 3d 20 73 71  return;.  r = sq
1250: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62  lite3_value_doub
1260: 6c 65 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 73  le(argv[0]);.  s
1270: 70 72 69 6e 74 66 28 7a 42 75 66 2c 22 25 2e 2a  printf(zBuf,"%.*
1280: 66 22 2c 6e 2c 72 29 3b 0a 20 20 73 71 6c 69 74  f",n,r);.  sqlit
1290: 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63  e3_result_text(c
12a0: 6f 6e 74 65 78 74 2c 20 7a 42 75 66 2c 20 2d 31  ontext, zBuf, -1
12b0: 2c 20 31 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  , 1);.}../*.** I
12c0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
12d0: 20 74 68 65 20 75 70 70 65 72 28 29 20 61 6e 64   the upper() and
12e0: 20 6c 6f 77 65 72 28 29 20 53 51 4c 20 66 75 6e   lower() SQL fun
12f0: 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 61 74 69  ctions..*/.stati
1300: 63 20 76 6f 69 64 20 75 70 70 65 72 46 75 6e 63  c void upperFunc
1310: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
1320: 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61   *context, int a
1330: 72 67 63 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c  rgc, sqlite3_val
1340: 75 65 20 2a 2a 61 72 67 76 29 7b 0a 20 20 63 68  ue **argv){.  ch
1350: 61 72 20 2a 7a 3b 0a 20 20 69 6e 74 20 69 3b 0a  ar *z;.  int i;.
1360: 20 20 69 66 28 20 61 72 67 63 3c 31 20 7c 7c 20    if( argc<1 || 
1370: 53 51 4c 49 54 45 5f 4e 55 4c 4c 3d 3d 73 71 6c  SQLITE_NULL==sql
1380: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
1390: 61 72 67 76 5b 30 5d 29 20 29 20 72 65 74 75 72  argv[0]) ) retur
13a0: 6e 3b 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65 4d  n;.  z = sqliteM
13b0: 61 6c 6c 6f 63 28 73 71 6c 69 74 65 33 5f 76 61  alloc(sqlite3_va
13c0: 6c 75 65 5f 62 79 74 65 73 28 61 72 67 76 5b 30  lue_bytes(argv[0
13d0: 5d 29 2b 31 29 3b 0a 20 20 69 66 28 20 7a 3d 3d  ])+1);.  if( z==
13e0: 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 73 74  0 ) return;.  st
13f0: 72 63 70 79 28 7a 2c 20 73 71 6c 69 74 65 33 5f  rcpy(z, sqlite3_
1400: 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b  value_text(argv[
1410: 30 5d 29 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b  0]));.  for(i=0;
1420: 20 7a 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20   z[i]; i++){.   
1430: 20 69 66 28 20 69 73 6c 6f 77 65 72 28 7a 5b 69   if( islower(z[i
1440: 5d 29 20 29 20 7a 5b 69 5d 20 3d 20 74 6f 75 70  ]) ) z[i] = toup
1450: 70 65 72 28 7a 5b 69 5d 29 3b 0a 20 20 7d 0a 20  per(z[i]);.  }. 
1460: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
1470: 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a 2c  text(context, z,
1480: 20 2d 31 2c 20 31 29 3b 0a 20 20 73 71 6c 69 74   -1, 1);.  sqlit
1490: 65 46 72 65 65 28 7a 29 3b 0a 7d 0a 73 74 61 74  eFree(z);.}.stat
14a0: 69 63 20 76 6f 69 64 20 6c 6f 77 65 72 46 75 6e  ic void lowerFun
14b0: 63 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  c(sqlite3_contex
14c0: 74 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20  t *context, int 
14d0: 61 72 67 63 2c 20 73 71 6c 69 74 65 33 5f 76 61  argc, sqlite3_va
14e0: 6c 75 65 20 2a 2a 61 72 67 76 29 7b 0a 20 20 63  lue **argv){.  c
14f0: 68 61 72 20 2a 7a 3b 0a 20 20 69 6e 74 20 69 3b  har *z;.  int i;
1500: 0a 20 20 69 66 28 20 61 72 67 63 3c 31 20 7c 7c  .  if( argc<1 ||
1510: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 3d 3d 73 71   SQLITE_NULL==sq
1520: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65  lite3_value_type
1530: 28 61 72 67 76 5b 30 5d 29 20 29 20 72 65 74 75  (argv[0]) ) retu
1540: 72 6e 3b 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65  rn;.  z = sqlite
1550: 4d 61 6c 6c 6f 63 28 73 71 6c 69 74 65 33 5f 76  Malloc(sqlite3_v
1560: 61 6c 75 65 5f 62 79 74 65 73 28 61 72 67 76 5b  alue_bytes(argv[
1570: 30 5d 29 2b 31 29 3b 0a 20 20 69 66 28 20 7a 3d  0])+1);.  if( z=
1580: 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 73  =0 ) return;.  s
1590: 74 72 63 70 79 28 7a 2c 20 73 71 6c 69 74 65 33  trcpy(z, sqlite3
15a0: 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72 67 76  _value_text(argv
15b0: 5b 30 5d 29 29 3b 0a 20 20 66 6f 72 28 69 3d 30  [0]));.  for(i=0
15c0: 3b 20 7a 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20  ; z[i]; i++){.  
15d0: 20 20 69 66 28 20 69 73 75 70 70 65 72 28 7a 5b    if( isupper(z[
15e0: 69 5d 29 20 29 20 7a 5b 69 5d 20 3d 20 74 6f 6c  i]) ) z[i] = tol
15f0: 6f 77 65 72 28 7a 5b 69 5d 29 3b 0a 20 20 7d 0a  ower(z[i]);.  }.
1600: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74    sqlite3_result
1610: 5f 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 7a  _text(context, z
1620: 2c 20 2d 31 2c 20 31 29 3b 0a 20 20 73 71 6c 69  , -1, 1);.  sqli
1630: 74 65 46 72 65 65 28 7a 29 3b 0a 7d 0a 0a 2f 2a  teFree(z);.}../*
1640: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69  .** Implementati
1650: 6f 6e 20 6f 66 20 74 68 65 20 49 46 4e 55 4c 4c  on of the IFNULL
1660: 28 29 2c 20 4e 56 4c 28 29 2c 20 61 6e 64 20 43  (), NVL(), and C
1670: 4f 41 4c 45 53 43 45 28 29 20 66 75 6e 63 74 69  OALESCE() functi
1680: 6f 6e 73 2e 20 20 0a 2a 2a 20 41 6c 6c 20 74 68  ons.  .** All th
1690: 72 65 65 20 64 6f 20 74 68 65 20 73 61 6d 65 20  ree do the same 
16a0: 74 68 69 6e 67 2e 20 20 54 68 65 79 20 72 65 74  thing.  They ret
16b0: 75 72 6e 20 74 68 65 20 66 69 72 73 74 20 6e 6f  urn the first no
16c0: 6e 2d 4e 55 4c 4c 0a 2a 2a 20 61 72 67 75 6d 65  n-NULL.** argume
16d0: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  nt..*/.static vo
16e0: 69 64 20 69 66 6e 75 6c 6c 46 75 6e 63 28 0a 20  id ifnullFunc(. 
16f0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
1700: 20 2a 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74   *context,.  int
1710: 20 61 72 67 63 2c 0a 20 20 73 71 6c 69 74 65 33   argc,.  sqlite3
1720: 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b  _value **argv.){
1730: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28  .  int i;.  for(
1740: 69 3d 30 3b 20 69 3c 61 72 67 63 3b 20 69 2b 2b  i=0; i<argc; i++
1750: 29 7b 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54  ){.    if( SQLIT
1760: 45 5f 4e 55 4c 4c 21 3d 73 71 6c 69 74 65 33 5f  E_NULL!=sqlite3_
1770: 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67 76 5b  value_type(argv[
1780: 69 5d 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  i]) ){.      sql
1790: 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75  ite3_result_valu
17a0: 65 28 63 6f 6e 74 65 78 74 2c 20 61 72 67 76 5b  e(context, argv[
17b0: 69 5d 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  i]);.      break
17c0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f  ;.    }.  }.}../
17d0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
17e0: 69 6f 6e 20 6f 66 20 72 61 6e 64 6f 6d 28 29 2e  ion of random().
17f0: 20 20 52 65 74 75 72 6e 20 61 20 72 61 6e 64 6f    Return a rando
1800: 6d 20 69 6e 74 65 67 65 72 2e 20 20 0a 2a 2f 0a  m integer.  .*/.
1810: 73 74 61 74 69 63 20 76 6f 69 64 20 72 61 6e 64  static void rand
1820: 6f 6d 46 75 6e 63 28 0a 20 20 73 71 6c 69 74 65  omFunc(.  sqlite
1830: 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65  3_context *conte
1840: 78 74 2c 0a 20 20 69 6e 74 20 61 72 67 63 2c 0a  xt,.  int argc,.
1850: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20    sqlite3_value 
1860: 2a 2a 61 72 67 76 0a 29 7b 0a 20 20 69 6e 74 20  **argv.){.  int 
1870: 72 3b 0a 20 20 73 71 6c 69 74 65 33 52 61 6e 64  r;.  sqlite3Rand
1880: 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66 28 72 29  omness(sizeof(r)
1890: 2c 20 26 72 29 3b 0a 20 20 73 71 6c 69 74 65 33  , &r);.  sqlite3
18a0: 5f 72 65 73 75 6c 74 5f 69 6e 74 28 63 6f 6e 74  _result_int(cont
18b0: 65 78 74 2c 20 72 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  ext, r);.}../*.*
18c0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
18d0: 20 6f 66 20 74 68 65 20 6c 61 73 74 5f 69 6e 73   of the last_ins
18e0: 65 72 74 5f 72 6f 77 69 64 28 29 20 53 51 4c 20  ert_rowid() SQL 
18f0: 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 72  function.  The r
1900: 65 74 75 72 6e 0a 2a 2a 20 76 61 6c 75 65 20 69  eturn.** value i
1910: 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68  s the same as th
1920: 65 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69  e sqlite3_last_i
1930: 6e 73 65 72 74 5f 72 6f 77 69 64 28 29 20 41 50  nsert_rowid() AP
1940: 49 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 73  I function..*/.s
1950: 74 61 74 69 63 20 76 6f 69 64 20 6c 61 73 74 5f  tatic void last_
1960: 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 0a 20 20  insert_rowid(.  
1970: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
1980: 2a 63 6f 6e 74 65 78 74 2c 20 0a 20 20 69 6e 74  *context, .  int
1990: 20 61 72 67 2c 20 0a 20 20 73 71 6c 69 74 65 33   arg, .  sqlite3
19a0: 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b  _value **argv.){
19b0: 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 20 3d 20  .  sqlite *db = 
19c0: 73 71 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 74  sqlite3_user_dat
19d0: 61 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 73 71  a(context);.  sq
19e0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74  lite3_result_int
19f0: 36 34 28 63 6f 6e 74 65 78 74 2c 20 73 71 6c 69  64(context, sqli
1a00: 74 65 33 5f 6c 61 73 74 5f 69 6e 73 65 72 74 5f  te3_last_insert_
1a10: 72 6f 77 69 64 28 64 62 29 29 3b 0a 7d 0a 0a 2f  rowid(db));.}../
1a20: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
1a30: 69 6f 6e 20 6f 66 20 74 68 65 20 63 68 61 6e 67  ion of the chang
1a40: 65 5f 63 6f 75 6e 74 28 29 20 53 51 4c 20 66 75  e_count() SQL fu
1a50: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 72 65 74  nction.  The ret
1a60: 75 72 6e 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20  urn.** value is 
1a70: 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20  the same as the 
1a80: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 28  sqlite3_changes(
1a90: 29 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 2e 0a  ) API function..
1aa0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63  */.static void c
1ab0: 68 61 6e 67 65 5f 63 6f 75 6e 74 28 0a 20 20 73  hange_count(.  s
1ac0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
1ad0: 63 6f 6e 74 65 78 74 2c 0a 20 20 69 6e 74 20 61  context,.  int a
1ae0: 72 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61  rg,.  sqlite3_va
1af0: 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a 20 20  lue **argv.){.  
1b00: 73 71 6c 69 74 65 20 2a 64 62 20 3d 20 73 71 6c  sqlite *db = sql
1b10: 69 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28 63  ite3_user_data(c
1b20: 6f 6e 74 65 78 74 29 3b 0a 20 20 73 71 6c 69 74  ontext);.  sqlit
1b30: 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 28 63 6f  e3_result_int(co
1b40: 6e 74 65 78 74 2c 20 73 71 6c 69 74 65 33 5f 63  ntext, sqlite3_c
1b50: 68 61 6e 67 65 73 28 64 62 29 29 3b 0a 7d 0a 0a  hanges(db));.}..
1b60: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
1b70: 74 69 6f 6e 20 6f 66 20 74 68 65 20 6c 61 73 74  tion of the last
1b80: 5f 73 74 61 74 65 6d 65 6e 74 5f 63 68 61 6e 67  _statement_chang
1b90: 65 5f 63 6f 75 6e 74 28 29 20 53 51 4c 20 66 75  e_count() SQL fu
1ba0: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 0a 2a 2a 20  nction.  The.** 
1bb0: 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20  return value is 
1bc0: 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20  the same as the 
1bd0: 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 73 74 61  sqlite3_last_sta
1be0: 74 65 6d 65 6e 74 5f 63 68 61 6e 67 65 73 28 29  tement_changes()
1bf0: 20 41 50 49 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e   API.** function
1c00: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
1c10: 20 6c 61 73 74 5f 73 74 61 74 65 6d 65 6e 74 5f   last_statement_
1c20: 63 68 61 6e 67 65 5f 63 6f 75 6e 74 28 0a 20 20  change_count(.  
1c30: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
1c40: 2a 63 6f 6e 74 65 78 74 2c 20 0a 20 20 69 6e 74  *context, .  int
1c50: 20 61 72 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f   arg,.  sqlite3_
1c60: 76 61 6c 75 65 20 2a 2a 61 72 67 76 0a 29 7b 0a  value **argv.){.
1c70: 20 20 73 71 6c 69 74 65 20 2a 64 62 20 3d 20 73    sqlite *db = s
1c80: 71 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 74 61  qlite3_user_data
1c90: 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20 73 71 6c  (context);.  sql
1ca0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 28  ite3_result_int(
1cb0: 63 6f 6e 74 65 78 74 2c 20 73 71 6c 69 74 65 33  context, sqlite3
1cc0: 5f 6c 61 73 74 5f 73 74 61 74 65 6d 65 6e 74 5f  _last_statement_
1cd0: 63 68 61 6e 67 65 73 28 64 62 29 29 3b 0a 7d 0a  changes(db));.}.
1ce0: 0a 2f 2a 0a 2a 2a 20 41 20 4c 49 4b 45 20 70 61  ./*.** A LIKE pa
1cf0: 74 74 65 72 6e 20 63 6f 6d 70 69 6c 65 73 20 74  ttern compiles t
1d00: 6f 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66  o an instance of
1d10: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73   the following s
1d20: 74 72 75 63 74 75 72 65 2e 20 52 65 66 65 72 0a  tructure. Refer.
1d30: 2a 2a 20 74 6f 20 74 68 65 20 63 6f 6d 6d 65 6e  ** to the commen
1d40: 74 20 66 6f 72 20 63 6f 6d 70 69 6c 65 4c 69 6b  t for compileLik
1d50: 65 28 29 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72  e() function for
1d60: 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 73 74 72   details..*/.str
1d70: 75 63 74 20 4c 69 6b 65 50 61 74 74 65 72 6e 20  uct LikePattern 
1d80: 7b 0a 20 20 69 6e 74 20 6e 53 74 61 74 65 3b 0a  {.  int nState;.
1d90: 20 20 73 74 72 75 63 74 20 4c 69 6b 65 53 74 61    struct LikeSta
1da0: 74 65 20 7b 0a 20 20 20 20 69 6e 74 20 76 61 6c  te {.    int val
1db0: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55  ;           /* U
1dc0: 6e 69 63 6f 64 65 20 63 6f 64 65 70 6f 69 6e 74  nicode codepoint
1dd0: 20 6f 72 20 2d 31 20 66 6f 72 20 61 6e 79 20 63   or -1 for any c
1de0: 68 61 72 20 69 2e 65 2e 20 27 5f 27 20 2a 2f 0a  har i.e. '_' */.
1df0: 20 20 20 20 69 6e 74 20 66 61 69 6c 73 74 61 74      int failstat
1e00: 65 3b 20 20 20 20 20 2f 2a 20 53 74 61 74 65 20  e;     /* State 
1e10: 74 6f 20 6a 75 6d 70 20 74 6f 20 69 66 20 6e 65  to jump to if ne
1e20: 78 74 20 63 68 61 72 20 69 73 20 6e 6f 74 20 76  xt char is not v
1e30: 61 6c 20 2a 2f 0a 20 20 7d 20 61 53 74 61 74 65  al */.  } aState
1e40: 5b 30 5d 3b 0a 7d 3b 0a 74 79 70 65 64 65 66 20  [0];.};.typedef 
1e50: 73 74 72 75 63 74 20 4c 69 6b 65 50 61 74 74 65  struct LikePatte
1e60: 72 6e 20 4c 69 6b 65 50 61 74 74 65 72 6e 3b 0a  rn LikePattern;.
1e70: 0a 76 6f 69 64 20 64 65 6c 65 74 65 4c 69 6b 65  .void deleteLike
1e80: 28 76 6f 69 64 20 2a 70 4c 69 6b 65 29 7b 0a 20  (void *pLike){. 
1e90: 20 73 71 6c 69 74 65 46 72 65 65 28 70 4c 69 6b   sqliteFree(pLik
1ea0: 65 29 3b 0a 7d 0a 0a 0a 2f 2a 20 23 64 65 66 69  e);.}.../* #defi
1eb0: 6e 65 20 54 52 41 43 45 5f 4c 49 4b 45 20 2a 2f  ne TRACE_LIKE */
1ec0: 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 54 52  ..#if defined(TR
1ed0: 41 43 45 5f 4c 49 4b 45 29 20 26 26 20 21 64 65  ACE_LIKE) && !de
1ee0: 66 69 6e 65 64 28 4e 44 45 42 55 47 29 0a 63 68  fined(NDEBUG).ch
1ef0: 61 72 20 2a 64 75 6d 70 4c 69 6b 65 28 4c 69 6b  ar *dumpLike(Lik
1f00: 65 50 61 74 74 65 72 6e 20 2a 70 4c 69 6b 65 29  ePattern *pLike)
1f10: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74  {.  int i;.  int
1f20: 20 6b 20 3d 20 30 3b 0a 20 20 63 68 61 72 20 2a   k = 0;.  char *
1f30: 7a 42 75 66 20 3d 20 28 63 68 61 72 20 2a 29 73  zBuf = (char *)s
1f40: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 70 4c 69 6b  qliteMalloc(pLik
1f50: 65 2d 3e 6e 53 74 61 74 65 2a 34 30 29 3b 0a 20  e->nState*40);. 
1f60: 20 0a 20 20 6b 20 2b 3d 20 73 70 72 69 6e 74 66   .  k += sprintf
1f70: 28 26 7a 42 75 66 5b 6b 5d 2c 20 22 25 64 20 73  (&zBuf[k], "%d s
1f80: 74 61 74 65 73 20 2d 20 22 2c 20 70 4c 69 6b 65  tates - ", pLike
1f90: 2d 3e 6e 53 74 61 74 65 29 3b 0a 20 20 66 6f 72  ->nState);.  for
1fa0: 28 69 3d 30 3b 20 69 3c 70 4c 69 6b 65 2d 3e 6e  (i=0; i<pLike->n
1fb0: 53 74 61 74 65 3b 20 69 2b 2b 29 7b 0a 20 20 20  State; i++){.   
1fc0: 20 6b 20 2b 3d 20 73 70 72 69 6e 74 66 28 26 7a   k += sprintf(&z
1fd0: 42 75 66 5b 6b 5d 2c 20 22 20 25 64 3a 28 25 64  Buf[k], " %d:(%d
1fe0: 2c 20 25 64 29 22 2c 20 69 2c 20 70 4c 69 6b 65  , %d)", i, pLike
1ff0: 2d 3e 61 53 74 61 74 65 5b 69 5d 2e 76 61 6c 2c  ->aState[i].val,
2000: 0a 20 20 20 20 20 20 20 20 70 4c 69 6b 65 2d 3e  .        pLike->
2010: 61 53 74 61 74 65 5b 69 5d 2e 66 61 69 6c 73 74  aState[i].failst
2020: 61 74 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  ate);.  }.  retu
2030: 72 6e 20 7a 42 75 66 3b 0a 7d 0a 23 65 6e 64 69  rn zBuf;.}.#endi
2040: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  f../*.** This fu
2050: 6e 63 74 69 6f 6e 20 63 6f 6d 70 69 6c 65 73 20  nction compiles 
2060: 61 6e 20 53 51 4c 20 27 4c 49 4b 45 27 20 70 61  an SQL 'LIKE' pa
2070: 74 74 65 72 6e 20 69 6e 74 6f 20 61 20 73 74 61  ttern into a sta
2080: 74 65 20 6d 61 63 68 69 6e 65 2c 20 0a 2a 2a 20  te machine, .** 
2090: 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 20 61  represented by a
20a0: 20 4c 69 6b 65 50 61 74 74 65 72 6e 20 73 74 72   LikePattern str
20b0: 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 45 61  ucture..**.** Ea
20c0: 63 68 20 73 74 61 74 65 20 6f 66 20 74 68 65 20  ch state of the 
20d0: 73 74 61 74 65 2d 6d 61 63 68 69 6e 65 20 68 61  state-machine ha
20e0: 73 20 74 77 6f 20 61 74 74 72 69 62 75 74 65 73  s two attributes
20f0: 2c 20 27 76 61 6c 27 20 61 6e 64 0a 2a 2a 20 27  , 'val' and.** '
2100: 66 61 69 6c 73 74 61 74 65 27 2e 20 54 68 65 20  failstate'. The 
2110: 76 61 6c 20 61 74 74 72 69 62 75 74 65 20 69 73  val attribute is
2120: 20 65 69 74 68 65 72 20 74 68 65 20 76 61 6c 75   either the valu
2130: 65 20 6f 66 20 61 20 75 6e 69 63 6f 64 65 20 0a  e of a unicode .
2140: 2a 2a 20 63 6f 64 65 70 6f 69 6e 74 2c 20 6f 72  ** codepoint, or
2150: 20 2d 31 2c 20 69 6e 64 69 63 61 74 69 6e 67 20   -1, indicating 
2160: 61 20 27 5f 27 20 77 69 6c 64 63 61 72 64 20 28  a '_' wildcard (
2170: 6d 61 74 63 68 20 61 6e 79 20 73 69 6e 67 6c 65  match any single
2180: 0a 2a 2a 20 63 68 61 72 61 63 74 65 72 29 2e 20  .** character). 
2190: 54 68 65 20 66 61 69 6c 73 74 61 74 65 20 69 73  The failstate is
21a0: 20 65 69 74 68 65 72 20 74 68 65 20 6e 75 6d 62   either the numb
21b0: 65 72 20 6f 66 20 61 6e 6f 74 68 65 72 20 73 74  er of another st
21c0: 61 74 65 0a 2a 2a 20 6f 72 20 2d 31 2c 20 69 6e  ate.** or -1, in
21d0: 64 69 63 61 74 69 6e 67 20 6a 75 6d 70 20 74 6f  dicating jump to
21e0: 20 27 6e 6f 20 6d 61 74 63 68 27 2e 0a 2a 2a 0a   'no match'..**.
21f0: 2a 2a 20 54 6f 20 73 65 65 20 69 66 20 61 20 73  ** To see if a s
2200: 74 72 69 6e 67 20 6d 61 74 63 68 65 73 20 61 20  tring matches a 
2210: 70 61 74 74 65 72 6e 20 74 68 65 20 70 61 74 74  pattern the patt
2220: 65 72 6e 20 69 73 0a 2a 2a 20 63 6f 6d 70 69 6c  ern is.** compil
2230: 65 64 20 74 6f 20 61 20 73 74 61 74 65 20 6d 61  ed to a state ma
2240: 63 68 69 6e 65 20 74 68 61 74 20 69 73 20 65 78  chine that is ex
2250: 65 63 75 74 65 64 20 61 63 63 6f 72 64 69 6e 67  ecuted according
2260: 20 74 6f 20 74 68 65 20 61 6c 67 6f 72 69 74 68   to the algorith
2270: 6d 0a 2a 2a 20 62 65 6c 6f 77 2e 20 54 68 65 20  m.** below. The 
2280: 73 74 72 69 6e 67 20 69 73 20 61 73 73 75 6d 65  string is assume
2290: 64 20 74 6f 20 62 65 20 74 65 72 6d 69 6e 61 74  d to be terminat
22a0: 65 64 20 62 79 20 61 20 27 4e 55 4c 27 20 63 68  ed by a 'NUL' ch
22b0: 61 72 61 63 74 65 72 0a 2a 2a 20 28 75 6e 69 63  aracter.** (unic
22c0: 6f 64 65 20 63 6f 64 65 70 6f 69 6e 74 20 30 29  ode codepoint 0)
22d0: 2e 0a 2a 2a 0a 2a 2a 20 31 20 20 20 53 20 3d 20  ..**.** 1   S = 
22e0: 30 0a 2a 2a 20 32 20 20 20 44 4f 20 0a 2a 2a 20  0.** 2   DO .** 
22f0: 33 20 20 20 20 20 20 20 43 20 3d 20 3c 4e 65 78  3       C = <Nex
2300: 74 20 63 68 61 72 61 63 74 65 72 20 66 72 6f 6d  t character from
2310: 20 69 6e 70 75 74 20 73 74 72 69 6e 67 3e 0a 2a   input string>.*
2320: 2a 20 34 20 20 20 20 20 20 20 49 46 28 20 43 20  * 4       IF( C 
2330: 6d 61 74 63 68 65 73 20 3c 53 74 61 74 65 20 53  matches <State S
2340: 20 76 61 6c 3e 20 29 0a 2a 2a 20 35 20 20 20 20   val> ).** 5    
2350: 20 20 20 20 20 20 20 53 20 3d 20 53 2b 31 0a 2a         S = S+1.*
2360: 2a 20 36 20 20 20 20 20 20 20 45 4c 53 45 20 49  * 6       ELSE I
2370: 46 28 20 53 20 21 3d 20 3c 53 74 61 74 65 20 53  F( S != <State S
2380: 20 66 61 69 6c 73 74 61 74 65 3e 20 29 0a 2a 2a   failstate> ).**
2390: 20 37 20 20 20 20 20 20 20 20 20 20 20 53 20 3d   7           S =
23a0: 20 3c 53 74 61 74 65 20 53 20 66 61 69 6c 73 74   <State S failst
23b0: 61 74 65 3e 0a 2a 2a 20 38 20 20 20 20 20 20 20  ate>.** 8       
23c0: 20 20 20 20 3c 52 65 77 69 6e 64 20 49 6e 70 75      <Rewind Inpu
23d0: 74 20 73 74 72 69 6e 67 20 31 20 63 68 61 72 61  t string 1 chara
23e0: 63 74 65 72 3e 0a 2a 2a 20 39 20 20 20 57 48 49  cter>.** 9   WHI
23f0: 4c 45 28 20 28 43 20 21 3d 20 4e 55 4c 29 20 41  LE( (C != NUL) A
2400: 4e 44 20 28 53 20 21 3d 20 46 41 49 4c 45 44 29  ND (S != FAILED)
2410: 20 29 0a 2a 2a 20 31 30 0a 2a 2a 20 31 31 20 20   ).** 10.** 11  
2420: 49 46 28 20 53 20 3d 3d 20 3c 6e 75 6d 62 65 72  IF( S == <number
2430: 20 6f 66 20 73 74 61 74 65 73 3e 20 29 0a 2a 2a   of states> ).**
2440: 20 31 32 20 20 20 20 20 20 52 45 54 55 52 4e 20   12      RETURN 
2450: 4d 41 54 43 48 0a 2a 2a 20 31 33 20 20 45 4c 53  MATCH.** 13  ELS
2460: 45 0a 2a 2a 20 31 34 20 20 20 20 20 20 52 45 54  E.** 14      RET
2470: 55 52 4e 20 4e 4f 2d 4d 41 54 43 48 0a 2a 2a 20  URN NO-MATCH.** 
2480: 20 20 20 20 20 20 0a 2a 2a 20 49 6e 20 70 72 61        .** In pra
2490: 63 74 69 63 65 20 74 68 65 72 65 20 69 73 20 61  ctice there is a
24a0: 20 73 6d 61 6c 6c 20 6f 70 74 69 6d 69 7a 61 74   small optimizat
24b0: 69 6f 6e 20 74 6f 20 61 76 6f 69 64 20 74 68 65  ion to avoid the
24c0: 20 3c 52 65 77 69 6e 64 3e 0a 2a 2a 20 6f 70 65   <Rewind>.** ope
24d0: 72 61 74 69 6f 6e 20 69 6e 20 6c 69 6e 65 20 38  ration in line 8
24e0: 20 6f 66 20 74 68 65 20 64 65 73 63 72 69 70 74   of the descript
24f0: 69 6f 6e 20 61 62 6f 76 65 2e 0a 2a 2a 0a 2a 2a  ion above..**.**
2500: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68   For example, th
2510: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 74 74  e following patt
2520: 65 72 6e 2c 20 27 58 25 41 42 61 62 63 25 5f 59  ern, 'X%ABabc%_Y
2530: 27 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 74 6f  ' is compiled to
2540: 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 20 6d 61  .** the state ma
2550: 63 68 69 6e 65 20 62 65 6c 6f 77 2e 0a 2a 2a 0a  chine below..**.
2560: 2a 2a 20 53 74 61 74 65 20 20 20 20 56 61 6c 20  ** State    Val 
2570: 20 20 20 20 20 20 20 20 20 46 61 69 6c 53 74 61           FailSta
2580: 74 65 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  te.** ----------
2590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
25a0: 2d 2d 2d 2d 2d 0a 2a 2a 20 30 20 20 20 20 20 20  -----.** 0      
25b0: 20 20 31 32 30 20 28 78 29 20 20 20 20 20 20 2d    120 (x)      -
25c0: 31 20 28 4e 4f 20 4d 41 54 43 48 29 0a 2a 2a 20  1 (NO MATCH).** 
25d0: 31 20 20 20 20 20 20 20 20 39 37 20 20 28 61 29  1        97  (a)
25e0: 20 20 20 20 20 20 31 0a 2a 2a 20 32 20 20 20 20        1.** 2    
25f0: 20 20 20 20 39 38 20 20 28 62 29 20 20 20 20 20      98  (b)     
2600: 20 31 0a 2a 2a 20 33 20 20 20 20 20 20 20 20 39   1.** 3        9
2610: 37 20 20 28 61 29 20 20 20 20 20 20 31 0a 2a 2a  7  (a)      1.**
2620: 20 34 20 20 20 20 20 20 20 20 39 38 20 20 28 62   4        98  (b
2630: 29 20 20 20 20 20 20 32 0a 2a 2a 20 35 20 20 20  )      2.** 5   
2640: 20 20 20 20 20 39 39 20 20 28 63 29 20 20 20 20       99  (c)    
2650: 20 20 33 0a 2a 2a 20 36 20 20 20 20 20 20 20 20    3.** 6        
2660: 2d 31 20 20 28 5f 29 20 20 20 20 20 20 36 0a 2a  -1  (_)      6.*
2670: 2a 20 37 20 20 20 20 20 20 20 20 31 32 31 20 28  * 7        121 (
2680: 79 29 20 20 20 20 20 20 37 0a 2a 2a 20 38 20 20  y)      7.** 8  
2690: 20 20 20 20 20 20 30 20 20 20 28 4e 55 4c 29 20        0   (NUL) 
26a0: 20 20 20 37 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61     7.**.** The a
26b0: 6c 67 6f 72 69 74 68 6d 73 20 69 6d 70 6c 65 6d  lgorithms implem
26c0: 65 6e 74 65 64 20 74 6f 20 63 6f 6d 70 69 6c 65  ented to compile
26d0: 20 61 6e 64 20 65 78 65 63 75 74 65 20 74 68 65   and execute the
26e0: 20 73 74 61 74 65 20 6d 61 63 68 69 6e 65 20 77   state machine w
26f0: 65 72 65 0a 2a 2a 20 66 69 72 73 74 20 70 72 65  ere.** first pre
2700: 73 65 6e 74 65 64 20 69 6e 20 22 46 61 73 74 20  sented in "Fast 
2710: 70 61 74 74 65 72 6e 20 6d 61 74 63 68 69 6e 67  pattern matching
2720: 20 69 6e 20 73 74 72 69 6e 67 73 22 2c 20 4b 6e   in strings", Kn
2730: 75 74 68 2c 20 4d 6f 72 72 69 73 20 61 6e 64 0a  uth, Morris and.
2740: 2a 2a 20 50 72 61 74 74 2c 20 31 39 37 37 2e 0a  ** Pratt, 1977..
2750: 2a 2a 20 20 20 20 20 20 20 0a 2a 2f 0a 4c 69 6b  **       .*/.Lik
2760: 65 50 61 74 74 65 72 6e 20 2a 63 6f 6d 70 69 6c  ePattern *compil
2770: 65 4c 69 6b 65 28 73 71 6c 69 74 65 33 5f 76 61  eLike(sqlite3_va
2780: 6c 75 65 20 2a 70 50 61 74 74 65 72 6e 2c 20 75  lue *pPattern, u
2790: 38 20 65 6e 63 29 7b 0a 20 20 4c 69 6b 65 50 61  8 enc){.  LikePa
27a0: 74 74 65 72 6e 20 2a 70 4c 69 6b 65 3b 0a 20 20  ttern *pLike;.  
27b0: 73 74 72 75 63 74 20 4c 69 6b 65 53 74 61 74 65  struct LikeState
27c0: 20 2a 61 53 74 61 74 65 3b 0a 20 20 69 6e 74 20   *aState;.  int 
27d0: 70 63 5f 73 74 61 74 65 20 3d 20 2d 31 3b 20 20  pc_state = -1;  
27e0: 20 20 2f 2a 20 53 74 61 74 65 20 6e 75 6d 62 65    /* State numbe
27f0: 72 20 6f 66 20 70 72 65 76 69 6f 75 73 20 27 25  r of previous '%
2800: 27 20 77 69 6c 64 20 63 61 72 64 20 2a 2f 0a 20  ' wild card */. 
2810: 20 69 6e 74 20 6e 20 3d 20 30 3b 0a 20 20 69 6e   int n = 0;.  in
2820: 74 20 63 3b 0a 0a 20 20 69 6e 74 20 6f 66 66 73  t c;..  int offs
2830: 65 74 20 3d 20 30 3b 0a 20 20 63 6f 6e 73 74 20  et = 0;.  const 
2840: 63 68 61 72 20 2a 7a 4c 69 6b 65 3b 0a 20 0a 20  char *zLike;. . 
2850: 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45   if( enc==SQLITE
2860: 5f 55 54 46 38 20 29 7b 0a 20 20 20 20 7a 4c 69  _UTF8 ){.    zLi
2870: 6b 65 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c  ke = sqlite3_val
2880: 75 65 5f 74 65 78 74 28 70 50 61 74 74 65 72 6e  ue_text(pPattern
2890: 29 3b 0a 20 20 20 20 6e 20 3d 20 73 71 6c 69 74  );.    n = sqlit
28a0: 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 70  e3_value_bytes(p
28b0: 50 61 74 74 65 72 6e 29 20 2b 20 31 3b 0a 20 20  Pattern) + 1;.  
28c0: 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 4c 69 6b 65  }else{.    zLike
28d0: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
28e0: 5f 74 65 78 74 31 36 28 70 50 61 74 74 65 72 6e  _text16(pPattern
28f0: 29 3b 0a 20 20 20 20 6e 20 3d 20 73 71 6c 69 74  );.    n = sqlit
2900: 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36  e3_value_bytes16
2910: 28 70 50 61 74 74 65 72 6e 29 2f 32 20 2b 20 31  (pPattern)/2 + 1
2920: 3b 0a 20 20 7d 0a 0a 20 20 70 4c 69 6b 65 20 3d  ;.  }..  pLike =
2930: 20 28 4c 69 6b 65 50 61 74 74 65 72 6e 20 2a 29   (LikePattern *)
2940: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 4d 61 6c  .      sqliteMal
2950: 6c 6f 63 28 73 69 7a 65 6f 66 28 4c 69 6b 65 50  loc(sizeof(LikeP
2960: 61 74 74 65 72 6e 29 2b 6e 2a 73 69 7a 65 6f 66  attern)+n*sizeof
2970: 28 73 74 72 75 63 74 20 4c 69 6b 65 53 74 61 74  (struct LikeStat
2980: 65 29 29 3b 0a 20 20 61 53 74 61 74 65 20 3d 20  e));.  aState = 
2990: 70 4c 69 6b 65 2d 3e 61 53 74 61 74 65 3b 0a 0a  pLike->aState;..
29a0: 20 20 6e 20 3d 20 30 3b 0a 20 20 64 6f 20 7b 0a    n = 0;.  do {.
29b0: 20 20 20 20 63 20 3d 20 73 71 6c 69 74 65 33 52      c = sqlite3R
29c0: 65 61 64 55 6e 69 43 68 61 72 28 7a 4c 69 6b 65  eadUniChar(zLike
29d0: 2c 20 26 6f 66 66 73 65 74 2c 20 26 65 6e 63 2c  , &offset, &enc,
29e0: 20 31 29 3b 0a 20 20 20 20 69 66 28 20 63 3d 3d   1);.    if( c==
29f0: 39 35 20 29 7b 20 20 20 20 20 20 20 20 2f 2a 20  95 ){        /* 
2a00: 41 20 27 5f 27 20 77 69 6c 64 63 61 72 64 20 2a  A '_' wildcard *
2a10: 2f 0a 20 20 20 20 20 20 61 53 74 61 74 65 5b 6e  /.      aState[n
2a20: 5d 2e 76 61 6c 20 3d 20 2d 31 3b 0a 20 20 20 20  ].val = -1;.    
2a30: 20 20 6e 2b 2b 3b 0a 20 20 20 20 7d 65 6c 73 65    n++;.    }else
2a40: 20 69 66 28 20 63 3d 3d 33 37 20 29 7b 20 20 2f   if( c==37 ){  /
2a50: 2a 20 41 20 27 25 27 20 77 69 6c 64 63 61 72 64  * A '%' wildcard
2a60: 20 2a 2f 0a 20 20 20 20 20 20 61 53 74 61 74 65   */.      aState
2a70: 5b 6e 5d 2e 66 61 69 6c 73 74 61 74 65 20 3d 20  [n].failstate = 
2a80: 6e 3b 0a 20 20 20 20 20 20 70 63 5f 73 74 61 74  n;.      pc_stat
2a90: 65 20 3d 20 6e 3b 0a 20 20 20 20 7d 65 6c 73 65  e = n;.    }else
2aa0: 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  {              /
2ab0: 2a 20 41 20 72 65 67 75 6c 61 72 20 63 68 61 72  * A regular char
2ac0: 61 63 74 65 72 20 2a 2f 0a 20 20 20 20 20 20 61  acter */.      a
2ad0: 53 74 61 74 65 5b 6e 5d 2e 76 61 6c 20 3d 20 63  State[n].val = c
2ae0: 3b 0a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  ;..      assert(
2af0: 20 70 63 5f 73 74 61 74 65 3c 3d 6e 20 29 3b 0a   pc_state<=n );.
2b00: 20 20 20 20 20 20 69 66 28 20 70 63 5f 73 74 61        if( pc_sta
2b10: 74 65 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 20  te<0 ){.        
2b20: 61 53 74 61 74 65 5b 6e 5d 2e 66 61 69 6c 73 74  aState[n].failst
2b30: 61 74 65 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20  ate = -1;.      
2b40: 7d 65 6c 73 65 20 69 66 28 20 70 63 5f 73 74 61  }else if( pc_sta
2b50: 74 65 3d 3d 6e 20 29 7b 0a 20 20 20 20 20 20 20  te==n ){.       
2b60: 20 69 66 28 20 63 20 29 7b 0a 20 20 20 20 20 20   if( c ){.      
2b70: 20 20 20 20 61 53 74 61 74 65 5b 6e 5d 2e 66 61      aState[n].fa
2b80: 69 6c 73 74 61 74 65 20 3d 20 70 63 5f 73 74 61  ilstate = pc_sta
2b90: 74 65 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73  te;.        }els
2ba0: 65 7b 0a 20 20 20 20 20 20 20 20 20 20 61 53 74  e{.          aSt
2bb0: 61 74 65 5b 6e 5d 2e 66 61 69 6c 73 74 61 74 65  ate[n].failstate
2bc0: 20 3d 20 2d 32 3b 0a 20 20 20 20 20 20 20 20 7d   = -2;.        }
2bd0: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  .      }else{.  
2be0: 20 20 20 20 20 20 69 6e 74 20 6b 20 3d 20 70 4c        int k = pL
2bf0: 69 6b 65 2d 3e 61 53 74 61 74 65 5b 6e 2d 31 5d  ike->aState[n-1]
2c00: 2e 66 61 69 6c 73 74 61 74 65 3b 0a 20 20 20 20  .failstate;.    
2c10: 20 20 20 20 77 68 69 6c 65 28 20 6b 3e 70 63 5f      while( k>pc_
2c20: 73 74 61 74 65 20 26 26 20 61 53 74 61 74 65 5b  state && aState[
2c30: 6b 2b 31 5d 2e 76 61 6c 21 3d 2d 31 20 26 26 20  k+1].val!=-1 && 
2c40: 61 53 74 61 74 65 5b 6b 2b 31 5d 2e 76 61 6c 21  aState[k+1].val!
2c50: 3d 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  =c ){.          
2c60: 6b 20 3d 20 61 53 74 61 74 65 5b 6b 5d 2e 66 61  k = aState[k].fa
2c70: 69 6c 73 74 61 74 65 3b 0a 20 20 20 20 20 20 20  ilstate;.       
2c80: 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 6b   }.        if( k
2c90: 21 3d 70 63 5f 73 74 61 74 65 20 26 26 20 61 53  !=pc_state && aS
2ca0: 74 61 74 65 5b 6b 2b 31 5d 2e 76 61 6c 3d 3d 63  tate[k+1].val==c
2cb0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73   ){.          as
2cc0: 73 65 72 74 28 20 6b 3d 3d 70 63 5f 73 74 61 74  sert( k==pc_stat
2cd0: 65 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6b  e );.          k
2ce0: 2b 2b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ++;.        }.  
2cf0: 20 20 20 20 20 20 61 53 74 61 74 65 5b 6e 5d 2e        aState[n].
2d00: 66 61 69 6c 73 74 61 74 65 20 3d 20 6b 3b 0a 20  failstate = k;. 
2d10: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6e 2b 2b       }.      n++
2d20: 3b 0a 20 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65  ;.    }.  }while
2d30: 28 20 63 20 29 3b 0a 20 20 70 4c 69 6b 65 2d 3e  ( c );.  pLike->
2d40: 6e 53 74 61 74 65 20 3d 20 6e 3b 0a 23 69 66 20  nState = n;.#if 
2d50: 64 65 66 69 6e 65 64 28 54 52 41 43 45 5f 4c 49  defined(TRACE_LI
2d60: 4b 45 29 20 26 26 20 21 64 65 66 69 6e 65 64 28  KE) && !defined(
2d70: 4e 44 45 42 55 47 29 0a 20 20 7b 0a 20 20 20 20  NDEBUG).  {.    
2d80: 63 68 61 72 20 2a 7a 43 6f 6d 70 69 6c 65 64 20  char *zCompiled 
2d90: 3d 20 64 75 6d 70 4c 69 6b 65 28 70 4c 69 6b 65  = dumpLike(pLike
2da0: 29 3b 0a 20 20 20 20 70 72 69 6e 74 66 28 22 50  );.    printf("P
2db0: 61 74 74 65 72 6e 3d 5c 22 25 73 5c 22 20 43 6f  attern=\"%s\" Co
2dc0: 6d 70 69 6c 65 64 3d 5c 22 25 73 5c 22 5c 6e 22  mpiled=\"%s\"\n"
2dd0: 2c 20 7a 50 61 74 74 65 72 6e 2c 20 7a 43 6f 6d  , zPattern, zCom
2de0: 70 69 6c 65 64 29 3b 0a 20 20 20 20 73 71 6c 69  piled);.    sqli
2df0: 74 65 46 72 65 65 28 7a 43 6f 6d 70 69 6c 65 64  teFree(zCompiled
2e00: 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20  );.  }.#endif.  
2e10: 72 65 74 75 72 6e 20 70 4c 69 6b 65 3b 0a 7d 0a  return pLike;.}.
2e20: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
2e30: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6c 69 6b  ation of the lik
2e40: 65 28 29 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e  e() SQL function
2e50: 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  .  This function
2e60: 20 69 6d 70 6c 65 6d 65 6e 74 73 0a 2a 2a 20 74   implements.** t
2e70: 68 65 20 62 75 69 6c 64 2d 69 6e 20 4c 49 4b 45  he build-in LIKE
2e80: 20 6f 70 65 72 61 74 6f 72 2e 20 20 54 68 65 20   operator.  The 
2e90: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74  first argument t
2ea0: 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 69  o the function i
2eb0: 73 20 74 68 65 0a 2a 2a 20 70 61 74 74 65 72 6e  s the.** pattern
2ec0: 20 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 20   and the second 
2ed0: 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20  argument is the 
2ee0: 73 74 72 69 6e 67 2e 20 20 53 6f 2c 20 74 68 65  string.  So, the
2ef0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 3a   SQL statements:
2f00: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 41 20 4c  .**.**       A L
2f10: 49 4b 45 20 42 0a 2a 2a 0a 2a 2a 20 69 73 20 69  IKE B.**.** is i
2f20: 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 6c 69  mplemented as li
2f30: 6b 65 28 42 2c 41 29 2e 0a 2a 2a 0a 2a 2a 20 49  ke(B,A)..**.** I
2f40: 66 20 74 68 65 20 70 6f 69 6e 74 65 72 20 72 65  f the pointer re
2f50: 74 72 69 65 76 65 64 20 62 79 20 76 69 61 20 61  trieved by via a
2f60: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
2f70: 5f 75 73 65 72 5f 64 61 74 61 28 29 20 69 73 0a  _user_data() is.
2f80: 2a 2a 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65  ** not NULL, the
2f90: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  n this function 
2fa0: 75 73 65 73 20 55 54 46 2d 31 36 2e 20 4f 74 68  uses UTF-16. Oth
2fb0: 65 72 77 69 73 65 20 55 54 46 2d 38 2e 0a 2a 2f  erwise UTF-8..*/
2fc0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6c 69 6b  .static void lik
2fd0: 65 46 75 6e 63 28 0a 20 20 73 71 6c 69 74 65 33  eFunc(.  sqlite3
2fe0: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
2ff0: 74 2c 20 0a 20 20 69 6e 74 20 61 72 67 63 2c 20  t, .  int argc, 
3000: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  .  sqlite3_value
3010: 20 2a 2a 61 72 67 76 0a 29 7b 0a 20 20 72 65 67   **argv.){.  reg
3020: 69 73 74 65 72 20 69 6e 74 20 63 3b 0a 20 20 75  ister int c;.  u
3030: 38 20 65 6e 63 3b 0a 20 20 69 6e 74 20 6f 66 66  8 enc;.  int off
3040: 73 65 74 20 3d 20 30 3b 0a 20 20 63 6f 6e 73 74  set = 0;.  const
3050: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
3060: 7a 53 74 72 69 6e 67 3b 0a 20 20 4c 69 6b 65 50  zString;.  LikeP
3070: 61 74 74 65 72 6e 20 2a 70 4c 69 6b 65 20 3d 20  attern *pLike = 
3080: 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 78 64  sqlite3_get_auxd
3090: 61 74 61 28 63 6f 6e 74 65 78 74 2c 20 30 29 3b  ata(context, 0);
30a0: 20 0a 20 20 73 74 72 75 63 74 20 4c 69 6b 65 53   .  struct LikeS
30b0: 74 61 74 65 20 2a 61 53 74 61 74 65 3b 0a 20 20  tate *aState;.  
30c0: 72 65 67 69 73 74 65 72 20 73 74 72 75 63 74 20  register struct 
30d0: 4c 69 6b 65 53 74 61 74 65 20 2a 70 53 74 61 74  LikeState *pStat
30e0: 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 65 69 74 68  e;..  /* If eith
30f0: 65 72 20 61 72 67 75 6d 65 6e 74 20 69 73 20 4e  er argument is N
3100: 55 4c 4c 2c 20 74 68 65 20 72 65 73 75 6c 74 20  ULL, the result 
3110: 69 73 20 4e 55 4c 4c 20 2a 2f 0a 20 20 69 66 28  is NULL */.  if(
3120: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
3130: 79 70 65 28 61 72 67 76 5b 31 5d 29 3d 3d 53 51  ype(argv[1])==SQ
3140: 4c 49 54 45 5f 4e 55 4c 4c 20 7c 7c 20 0a 20 20  LITE_NULL || .  
3150: 20 20 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75      sqlite3_valu
3160: 65 5f 74 79 70 65 28 61 72 67 76 5b 30 5d 29 3d  e_type(argv[0])=
3170: 3d 53 51 4c 49 54 45 5f 4e 55 4c 4c 20 29 7b 0a  =SQLITE_NULL ){.
3180: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a      return;.  }.
3190: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 75 73 65  .  /* If the use
31a0: 72 2d 64 61 74 61 20 70 6f 69 6e 74 65 72 20 69  r-data pointer i
31b0: 73 20 4e 55 4c 4c 2c 20 75 73 65 20 55 54 46 2d  s NULL, use UTF-
31c0: 38 2e 20 4f 74 68 65 72 77 69 73 65 20 55 54 46  8. Otherwise UTF
31d0: 2d 31 36 2e 20 2a 2f 0a 20 20 69 66 28 20 73 71  -16. */.  if( sq
31e0: 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28  lite3_user_data(
31f0: 63 6f 6e 74 65 78 74 29 20 29 7b 0a 20 20 20 20  context) ){.    
3200: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46  enc = SQLITE_UTF
3210: 31 36 4e 41 54 49 56 45 3b 0a 20 20 20 20 7a 53  16NATIVE;.    zS
3220: 74 72 69 6e 67 20 3d 20 28 63 6f 6e 73 74 20 75  tring = (const u
3230: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29 73  nsigned char *)s
3240: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
3250: 74 31 36 28 61 72 67 76 5b 31 5d 29 3b 0a 20 20  t16(argv[1]);.  
3260: 20 20 61 73 73 65 72 74 28 30 29 3b 0a 20 20 7d    assert(0);.  }
3270: 65 6c 73 65 7b 0a 20 20 20 20 65 6e 63 20 3d 20  else{.    enc = 
3280: 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20 20  SQLITE_UTF8;.   
3290: 20 7a 53 74 72 69 6e 67 20 3d 20 73 71 6c 69 74   zString = sqlit
32a0: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 61 72  e3_value_text(ar
32b0: 67 76 5b 31 5d 29 3b 0a 20 20 7d 0a 0a 20 20 2f  gv[1]);.  }..  /
32c0: 2a 20 49 66 20 74 68 65 20 4c 49 4b 45 20 70 61  * If the LIKE pa
32d0: 74 74 65 72 6e 20 68 61 73 20 6e 6f 74 20 62 65  ttern has not be
32e0: 65 6e 20 63 6f 6d 70 69 6c 65 64 2c 20 63 6f 6d  en compiled, com
32f0: 70 69 6c 65 20 69 74 20 6e 6f 77 2e 20 2a 2f 0a  pile it now. */.
3300: 20 20 69 66 28 20 21 70 4c 69 6b 65 20 29 7b 0a    if( !pLike ){.
3310: 20 20 20 20 70 4c 69 6b 65 20 3d 20 63 6f 6d 70      pLike = comp
3320: 69 6c 65 4c 69 6b 65 28 61 72 67 76 5b 30 5d 2c  ileLike(argv[0],
3330: 20 65 6e 63 29 3b 0a 20 20 20 20 69 66 28 20 21   enc);.    if( !
3340: 70 4c 69 6b 65 20 29 7b 0a 20 20 20 20 20 20 73  pLike ){.      s
3350: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72  qlite3_result_er
3360: 72 6f 72 28 63 6f 6e 74 65 78 74 2c 20 22 6f 75  ror(context, "ou
3370: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 2d 31  t of memory", -1
3380: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 3b  );.      return;
3390: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
33a0: 65 33 5f 73 65 74 5f 61 75 78 64 61 74 61 28 63  e3_set_auxdata(c
33b0: 6f 6e 74 65 78 74 2c 20 30 2c 20 70 4c 69 6b 65  ontext, 0, pLike
33c0: 2c 20 64 65 6c 65 74 65 4c 69 6b 65 29 3b 0a 20  , deleteLike);. 
33d0: 20 7d 0a 20 20 61 53 74 61 74 65 20 3d 20 70 4c   }.  aState = pL
33e0: 69 6b 65 2d 3e 61 53 74 61 74 65 3b 0a 20 20 70  ike->aState;.  p
33f0: 53 74 61 74 65 20 3d 20 61 53 74 61 74 65 3b 0a  State = aState;.
3400: 0a 20 20 64 6f 20 7b 0a 20 20 20 20 69 66 28 20  .  do {.    if( 
3410: 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 38  enc==SQLITE_UTF8
3420: 20 29 7b 0a 20 20 20 20 20 20 63 20 3d 20 7a 53   ){.      c = zS
3430: 74 72 69 6e 67 5b 6f 66 66 73 65 74 2b 2b 5d 3b  tring[offset++];
3440: 0a 20 20 20 20 20 20 69 66 28 20 63 26 30 78 38  .      if( c&0x8
3450: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 6f 66 66  0 ){.        off
3460: 73 65 74 2d 2d 3b 0a 20 20 20 20 20 20 20 20 63  set--;.        c
3470: 20 3d 20 73 71 6c 69 74 65 33 52 65 61 64 55 6e   = sqlite3ReadUn
3480: 69 43 68 61 72 28 7a 53 74 72 69 6e 67 2c 20 26  iChar(zString, &
3490: 6f 66 66 73 65 74 2c 20 26 65 6e 63 2c 20 31 29  offset, &enc, 1)
34a0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65  ;.      }.    }e
34b0: 6c 73 65 7b 0a 20 20 20 20 20 20 63 20 3d 20 73  lse{.      c = s
34c0: 71 6c 69 74 65 33 52 65 61 64 55 6e 69 43 68 61  qlite3ReadUniCha
34d0: 72 28 7a 53 74 72 69 6e 67 2c 20 26 6f 66 66 73  r(zString, &offs
34e0: 65 74 2c 20 26 65 6e 63 2c 20 31 29 3b 0a 20 20  et, &enc, 1);.  
34f0: 20 20 7d 0a 0a 73 6b 69 70 5f 72 65 61 64 3a 0a    }..skip_read:.
3500: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 54 52 41  .#if defined(TRA
3510: 43 45 5f 4c 49 4b 45 29 20 26 26 20 21 64 65 66  CE_LIKE) && !def
3520: 69 6e 65 64 28 4e 44 45 42 55 47 29 0a 20 20 20  ined(NDEBUG).   
3530: 20 70 72 69 6e 74 66 28 22 53 74 61 74 65 3d 25   printf("State=%
3540: 64 3a 28 25 64 2c 20 25 64 29 20 49 6e 70 75 74  d:(%d, %d) Input
3550: 3d 25 64 5c 6e 22 2c 20 0a 20 20 20 20 20 20 20  =%d\n", .       
3560: 20 28 61 53 74 61 74 65 20 2d 20 70 53 74 61 74   (aState - pStat
3570: 65 29 2c 20 70 53 74 61 74 65 2d 3e 76 61 6c 2c  e), pState->val,
3580: 20 70 53 74 61 74 65 2d 3e 66 61 69 6c 73 74 61   pState->failsta
3590: 74 65 2c 20 63 29 3b 0a 23 65 6e 64 69 66 0a 0a  te, c);.#endif..
35a0: 20 20 20 20 69 66 28 20 70 53 74 61 74 65 2d 3e      if( pState->
35b0: 76 61 6c 3d 3d 2d 31 20 7c 7c 20 70 53 74 61 74  val==-1 || pStat
35c0: 65 2d 3e 76 61 6c 3d 3d 63 20 29 7b 0a 20 20 20  e->val==c ){.   
35d0: 20 20 20 70 53 74 61 74 65 2b 2b 3b 0a 20 20 20     pState++;.   
35e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 74   }else{.      st
35f0: 72 75 63 74 20 4c 69 6b 65 53 74 61 74 65 20 2a  ruct LikeState *
3600: 70 46 61 69 6c 53 74 61 74 65 20 3d 20 26 61 53  pFailState = &aS
3610: 74 61 74 65 5b 70 53 74 61 74 65 2d 3e 66 61 69  tate[pState->fai
3620: 6c 73 74 61 74 65 5d 3b 0a 20 20 20 20 20 20 69  lstate];.      i
3630: 66 28 20 70 53 74 61 74 65 21 3d 70 46 61 69 6c  f( pState!=pFail
3640: 53 74 61 74 65 20 29 7b 0a 20 20 20 20 20 20 20  State ){.       
3650: 20 70 53 74 61 74 65 20 3d 20 70 46 61 69 6c 53   pState = pFailS
3660: 74 61 74 65 3b 0a 20 20 20 20 20 20 20 20 69 66  tate;.        if
3670: 28 20 63 20 26 26 20 70 53 74 61 74 65 3e 3d 61  ( c && pState>=a
3680: 53 74 61 74 65 20 29 20 67 6f 74 6f 20 73 6b 69  State ) goto ski
3690: 70 5f 72 65 61 64 3b 0a 20 20 20 20 20 20 7d 0a  p_read;.      }.
36a0: 20 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20      }.  }while( 
36b0: 63 20 26 26 20 70 53 74 61 74 65 3e 3d 61 53 74  c && pState>=aSt
36c0: 61 74 65 20 29 3b 0a 0a 20 20 69 66 28 20 28 70  ate );..  if( (p
36d0: 53 74 61 74 65 2d 61 53 74 61 74 65 29 3d 3d 70  State-aState)==p
36e0: 4c 69 6b 65 2d 3e 6e 53 74 61 74 65 20 7c 7c 20  Like->nState || 
36f0: 28 70 53 74 61 74 65 2d 61 53 74 61 74 65 29 3c  (pState-aState)<
3700: 2d 31 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  -1 ){.    sqlite
3710: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 28 63 6f 6e  3_result_int(con
3720: 74 65 78 74 2c 20 31 29 3b 0a 20 20 7d 65 6c 73  text, 1);.  }els
3730: 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72  e{.    sqlite3_r
3740: 65 73 75 6c 74 5f 69 6e 74 28 63 6f 6e 74 65 78  esult_int(contex
3750: 74 2c 20 30 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  t, 0);.  }.}../*
3760: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69  .** Implementati
3770: 6f 6e 20 6f 66 20 74 68 65 20 67 6c 6f 62 28 29  on of the glob()
3780: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 2e 20 20   SQL function.  
3790: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 6d  This function im
37a0: 70 6c 65 6d 65 6e 74 73 0a 2a 2a 20 74 68 65 20  plements.** the 
37b0: 62 75 69 6c 64 2d 69 6e 20 47 4c 4f 42 20 6f 70  build-in GLOB op
37c0: 65 72 61 74 6f 72 2e 20 20 54 68 65 20 66 69 72  erator.  The fir
37d0: 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74  st argument to t
37e0: 68 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 74  he function is t
37f0: 68 65 0a 2a 2a 20 73 74 72 69 6e 67 20 61 6e 64  he.** string and
3800: 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75   the second argu
3810: 6d 65 6e 74 20 69 73 20 74 68 65 20 70 61 74 74  ment is the patt
3820: 65 72 6e 2e 20 20 53 6f 2c 20 74 68 65 20 53 51  ern.  So, the SQ
3830: 4c 20 73 74 61 74 65 6d 65 6e 74 73 3a 0a 2a 2a  L statements:.**
3840: 0a 2a 2a 20 20 20 20 20 20 20 41 20 47 4c 4f 42  .**       A GLOB
3850: 20 42 0a 2a 2a 0a 2a 2a 20 69 73 20 69 6d 70 6c   B.**.** is impl
3860: 65 6d 65 6e 74 65 64 20 61 73 20 67 6c 6f 62 28  emented as glob(
3870: 41 2c 42 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  A,B)..*/.static 
3880: 76 6f 69 64 20 67 6c 6f 62 46 75 6e 63 28 73 71  void globFunc(sq
3890: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63  lite3_context *c
38a0: 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61 72 67 2c  ontext, int arg,
38b0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
38c0: 2a 61 72 67 76 29 7b 0a 20 20 63 6f 6e 73 74 20  *argv){.  const 
38d0: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 7a  unsigned char *z
38e0: 41 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  A = sqlite3_valu
38f0: 65 5f 74 65 78 74 28 61 72 67 76 5b 30 5d 29 3b  e_text(argv[0]);
3900: 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  .  const unsigne
3910: 64 20 63 68 61 72 20 2a 7a 42 20 3d 20 73 71 6c  d char *zB = sql
3920: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28  ite3_value_text(
3930: 61 72 67 76 5b 31 5d 29 3b 0a 20 20 69 66 28 20  argv[1]);.  if( 
3940: 7a 41 20 26 26 20 7a 42 20 29 7b 0a 20 20 20 20  zA && zB ){.    
3950: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69  sqlite3_result_i
3960: 6e 74 28 63 6f 6e 74 65 78 74 2c 20 73 71 6c 69  nt(context, sqli
3970: 74 65 33 47 6c 6f 62 43 6f 6d 70 61 72 65 28 7a  te3GlobCompare(z
3980: 41 2c 20 7a 42 29 29 3b 0a 20 20 7d 0a 7d 0a 0a  A, zB));.  }.}..
3990: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
39a0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 4e 55 4c 4c  tion of the NULL
39b0: 49 46 28 78 2c 79 29 20 66 75 6e 63 74 69 6f 6e  IF(x,y) function
39c0: 2e 20 20 54 68 65 20 72 65 73 75 6c 74 20 69 73  .  The result is
39d0: 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72   the first.** ar
39e0: 67 75 6d 65 6e 74 20 69 66 20 74 68 65 20 61 72  gument if the ar
39f0: 67 75 6d 65 6e 74 73 20 61 72 65 20 64 69 66 66  guments are diff
3a00: 65 72 65 6e 74 2e 20 20 54 68 65 20 72 65 73 75  erent.  The resu
3a10: 6c 74 20 69 73 20 4e 55 4c 4c 20 69 66 20 74 68  lt is NULL if th
3a20: 65 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 73 20 61  e.** arguments a
3a30: 72 65 20 65 71 75 61 6c 20 74 6f 20 65 61 63 68  re equal to each
3a40: 20 6f 74 68 65 72 2e 0a 2a 2f 0a 73 74 61 74 69   other..*/.stati
3a50: 63 20 76 6f 69 64 20 6e 75 6c 6c 69 66 46 75 6e  c void nullifFun
3a60: 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  c(.  sqlite3_con
3a70: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a 20  text *context,. 
3a80: 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71 6c   int argc,.  sql
3a90: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67  ite3_value **arg
3aa0: 76 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a  v.){.  CollSeq *
3ab0: 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 47  pColl = sqlite3G
3ac0: 65 74 46 75 6e 63 43 6f 6c 6c 53 65 71 28 63 6f  etFuncCollSeq(co
3ad0: 6e 74 65 78 74 29 3b 0a 20 20 69 66 28 20 73 71  ntext);.  if( sq
3ae0: 6c 69 74 65 33 4d 65 6d 43 6f 6d 70 61 72 65 28  lite3MemCompare(
3af0: 61 72 67 76 5b 30 5d 2c 20 61 72 67 76 5b 31 5d  argv[0], argv[1]
3b00: 2c 20 70 43 6f 6c 6c 29 21 3d 30 20 29 7b 0a 20  , pColl)!=0 ){. 
3b10: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
3b20: 74 5f 76 61 6c 75 65 28 63 6f 6e 74 65 78 74 2c  t_value(context,
3b30: 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20 7d 0a 7d   argv[0]);.  }.}
3b40: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
3b50: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 56 45  tation of the VE
3b60: 52 53 49 4f 4e 28 2a 29 20 66 75 6e 63 74 69 6f  RSION(*) functio
3b70: 6e 2e 20 20 54 68 65 20 72 65 73 75 6c 74 20 69  n.  The result i
3b80: 73 20 74 68 65 20 76 65 72 73 69 6f 6e 0a 2a 2a  s the version.**
3b90: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c   of the SQLite l
3ba0: 69 62 72 61 72 79 20 74 68 61 74 20 69 73 20 72  ibrary that is r
3bb0: 75 6e 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69  unning..*/.stati
3bc0: 63 20 76 6f 69 64 20 76 65 72 73 69 6f 6e 46 75  c void versionFu
3bd0: 6e 63 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  nc(.  sqlite3_co
3be0: 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 0a  ntext *context,.
3bf0: 20 20 69 6e 74 20 61 72 67 63 2c 0a 20 20 73 71    int argc,.  sq
3c00: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72  lite3_value **ar
3c10: 67 76 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f  gv.){.  sqlite3_
3c20: 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e 74  result_text(cont
3c30: 65 78 74 2c 20 73 71 6c 69 74 65 33 5f 76 65 72  ext, sqlite3_ver
3c40: 73 69 6f 6e 2c 20 2d 31 2c 20 30 29 3b 0a 7d 0a  sion, -1, 0);.}.
3c50: 0a 2f 2a 0a 2a 2a 20 45 58 50 45 52 49 4d 45 4e  ./*.** EXPERIMEN
3c60: 54 41 4c 20 2d 20 54 68 69 73 20 69 73 20 6e 6f  TAL - This is no
3c70: 74 20 61 6e 20 6f 66 66 69 63 69 61 6c 20 66 75  t an official fu
3c80: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 69 6e 74  nction.  The int
3c90: 65 72 66 61 63 65 20 6d 61 79 0a 2a 2a 20 63 68  erface may.** ch
3ca0: 61 6e 67 65 2e 20 20 54 68 69 73 20 66 75 6e 63  ange.  This func
3cb0: 74 69 6f 6e 20 6d 61 79 20 64 69 73 61 70 70 65  tion may disappe
3cc0: 61 72 2e 20 20 44 6f 20 6e 6f 74 20 77 72 69 74  ar.  Do not writ
3cd0: 65 20 63 6f 64 65 20 74 68 61 74 20 64 65 70 65  e code that depe
3ce0: 6e 64 73 0a 2a 2a 20 6f 6e 20 74 68 69 73 20 66  nds.** on this f
3cf0: 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49  unction..**.** I
3d00: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
3d10: 20 74 68 65 20 51 55 4f 54 45 28 29 20 66 75 6e   the QUOTE() fun
3d20: 63 74 69 6f 6e 2e 20 20 54 68 69 73 20 66 75 6e  ction.  This fun
3d30: 63 74 69 6f 6e 20 74 61 6b 65 73 20 61 20 73 69  ction takes a si
3d40: 6e 67 6c 65 0a 2a 2a 20 61 72 67 75 6d 65 6e 74  ngle.** argument
3d50: 2e 20 20 49 66 20 74 68 65 20 61 72 67 75 6d 65  .  If the argume
3d60: 6e 74 20 69 73 20 6e 75 6d 65 72 69 63 2c 20 74  nt is numeric, t
3d70: 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20  he return value 
3d80: 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 0a 2a  is the same as.*
3d90: 2a 20 74 68 65 20 61 72 67 75 6d 65 6e 74 2e 20  * the argument. 
3da0: 20 49 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74   If the argument
3db0: 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 20 72 65   is NULL, the re
3dc0: 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 74 68  turn value is th
3dd0: 65 20 73 74 72 69 6e 67 0a 2a 2a 20 22 4e 55 4c  e string.** "NUL
3de0: 4c 22 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20  L".  Otherwise, 
3df0: 74 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20  the argument is 
3e00: 65 6e 63 6c 6f 73 65 64 20 69 6e 20 73 69 6e 67  enclosed in sing
3e10: 6c 65 20 71 75 6f 74 65 73 20 77 69 74 68 0a 2a  le quotes with.*
3e20: 2a 20 73 69 6e 67 6c 65 2d 71 75 6f 74 65 20 65  * single-quote e
3e30: 73 63 61 70 65 73 2e 0a 2a 2f 0a 73 74 61 74 69  scapes..*/.stati
3e40: 63 20 76 6f 69 64 20 71 75 6f 74 65 46 75 6e 63  c void quoteFunc
3e50: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
3e60: 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61   *context, int a
3e70: 72 67 63 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c  rgc, sqlite3_val
3e80: 75 65 20 2a 2a 61 72 67 76 29 7b 0a 20 20 69 66  ue **argv){.  if
3e90: 28 20 61 72 67 63 3c 31 20 29 20 72 65 74 75 72  ( argc<1 ) retur
3ea0: 6e 3b 0a 20 20 73 77 69 74 63 68 28 20 73 71 6c  n;.  switch( sql
3eb0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
3ec0: 61 72 67 76 5b 30 5d 29 20 29 7b 0a 20 20 20 20  argv[0]) ){.    
3ed0: 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 55 4c 4c  case SQLITE_NULL
3ee0: 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  : {.      sqlite
3ef0: 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f  3_result_text(co
3f00: 6e 74 65 78 74 2c 20 22 4e 55 4c 4c 22 2c 20 34  ntext, "NULL", 4
3f10: 2c 20 30 29 3b 0a 20 20 20 20 20 20 62 72 65 61  , 0);.      brea
3f20: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  k;.    }.    cas
3f30: 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52  e SQLITE_INTEGER
3f40: 3a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  :.    case SQLIT
3f50: 45 5f 46 4c 4f 41 54 3a 20 7b 0a 20 20 20 20 20  E_FLOAT: {.     
3f60: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
3f70: 76 61 6c 75 65 28 63 6f 6e 74 65 78 74 2c 20 61  value(context, a
3f80: 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20 20 20 62  rgv[0]);.      b
3f90: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
3fa0: 63 61 73 65 20 53 51 4c 49 54 45 5f 42 4c 4f 42  case SQLITE_BLOB
3fb0: 3a 20 7b 0a 20 20 20 20 20 20 73 74 61 74 69 63  : {.      static
3fc0: 20 63 6f 6e 73 74 20 63 68 61 72 20 68 65 78 64   const char hexd
3fd0: 69 67 69 74 73 5b 5d 20 3d 20 7b 20 0a 20 20 20  igits[] = { .   
3fe0: 20 20 20 20 20 27 30 27 2c 20 27 31 27 2c 20 27       '0', '1', '
3ff0: 32 27 2c 20 27 33 27 2c 20 27 34 27 2c 20 27 35  2', '3', '4', '5
4000: 27 2c 20 27 36 27 2c 20 27 37 27 2c 0a 20 20 20  ', '6', '7',.   
4010: 20 20 20 20 20 27 38 27 2c 20 27 39 27 2c 20 27       '8', '9', '
4020: 41 27 2c 20 27 42 27 2c 20 27 43 27 2c 20 27 44  A', 'B', 'C', 'D
4030: 27 2c 20 27 45 27 2c 20 27 46 27 20 0a 20 20 20  ', 'E', 'F' .   
4040: 20 20 20 7d 3b 0a 20 20 20 20 20 20 63 68 61 72     };.      char
4050: 20 2a 7a 54 65 78 74 20 3d 20 30 3b 0a 20 20 20   *zText = 0;.   
4060: 20 20 20 69 6e 74 20 6e 42 6c 6f 62 20 3d 20 73     int nBlob = s
4070: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74  qlite3_value_byt
4080: 65 73 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 20  es(argv[0]);.   
4090: 20 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a     char const *z
40a0: 42 6c 6f 62 20 3d 20 73 71 6c 69 74 65 33 5f 76  Blob = sqlite3_v
40b0: 61 6c 75 65 5f 62 6c 6f 62 28 61 72 67 76 5b 30  alue_blob(argv[0
40c0: 5d 29 3b 0a 0a 20 20 20 20 20 20 7a 54 65 78 74  ]);..      zText
40d0: 20 3d 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74   = (char *)sqlit
40e0: 65 4d 61 6c 6c 6f 63 28 28 32 2a 6e 42 6c 6f 62  eMalloc((2*nBlob
40f0: 29 2b 34 29 3b 20 0a 20 20 20 20 20 20 69 66 28  )+4); .      if(
4100: 20 21 7a 54 65 78 74 20 29 7b 0a 20 20 20 20 20   !zText ){.     
4110: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
4120: 74 5f 65 72 72 6f 72 28 63 6f 6e 74 65 78 74 2c  t_error(context,
4130: 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22   "out of memory"
4140: 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 7d 65 6c  , -1);.      }el
4150: 73 65 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20  se{.        int 
4160: 69 3b 0a 20 20 20 20 20 20 20 20 66 6f 72 28 69  i;.        for(i
4170: 3d 30 3b 20 69 3c 6e 42 6c 6f 62 3b 20 69 2b 2b  =0; i<nBlob; i++
4180: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 7a 54 65  ){.          zTe
4190: 78 74 5b 28 69 2a 32 29 2b 32 5d 20 3d 20 68 65  xt[(i*2)+2] = he
41a0: 78 64 69 67 69 74 73 5b 28 7a 42 6c 6f 62 5b 69  xdigits[(zBlob[i
41b0: 5d 3e 3e 34 29 26 30 78 30 46 5d 3b 0a 20 20 20  ]>>4)&0x0F];.   
41c0: 20 20 20 20 20 20 20 7a 54 65 78 74 5b 28 69 2a         zText[(i*
41d0: 32 29 2b 33 5d 20 3d 20 68 65 78 64 69 67 69 74  2)+3] = hexdigit
41e0: 73 5b 28 7a 42 6c 6f 62 5b 69 5d 29 26 30 78 30  s[(zBlob[i])&0x0
41f0: 46 5d 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  F];.        }.  
4200: 20 20 20 20 20 20 7a 54 65 78 74 5b 28 6e 42 6c        zText[(nBl
4210: 6f 62 2a 32 29 2b 32 5d 20 3d 20 27 5c 27 27 3b  ob*2)+2] = '\'';
4220: 0a 20 20 20 20 20 20 20 20 7a 54 65 78 74 5b 28  .        zText[(
4230: 6e 42 6c 6f 62 2a 32 29 2b 33 5d 20 3d 20 27 5c  nBlob*2)+3] = '\
4240: 30 27 3b 0a 20 20 20 20 20 20 20 20 7a 54 65 78  0';.        zTex
4250: 74 5b 30 5d 20 3d 20 27 58 27 3b 0a 20 20 20 20  t[0] = 'X';.    
4260: 20 20 20 20 7a 54 65 78 74 5b 31 5d 20 3d 20 27      zText[1] = '
4270: 5c 27 27 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  \'';.        sql
4280: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74  ite3_result_text
4290: 28 63 6f 6e 74 65 78 74 2c 20 7a 54 65 78 74 2c  (context, zText,
42a0: 20 2d 31 2c 20 31 29 3b 0a 20 20 20 20 20 20 20   -1, 1);.       
42b0: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 54 65 78   sqliteFree(zTex
42c0: 74 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  t);.      }.    
42d0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20    break;.    }. 
42e0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54     case SQLITE_T
42f0: 45 58 54 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74  EXT: {.      int
4300: 20 69 2c 6a 2c 6e 3b 0a 20 20 20 20 20 20 63 6f   i,j,n;.      co
4310: 6e 73 74 20 63 68 61 72 20 2a 7a 41 72 67 20 3d  nst char *zArg =
4320: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
4330: 65 78 74 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20  ext(argv[0]);.  
4340: 20 20 20 20 63 68 61 72 20 2a 7a 3b 0a 0a 20 20      char *z;..  
4350: 20 20 20 20 66 6f 72 28 69 3d 6e 3d 30 3b 20 7a      for(i=n=0; z
4360: 41 72 67 5b 69 5d 3b 20 69 2b 2b 29 7b 20 69 66  Arg[i]; i++){ if
4370: 28 20 7a 41 72 67 5b 69 5d 3d 3d 27 5c 27 27 20  ( zArg[i]=='\'' 
4380: 29 20 6e 2b 2b 3b 20 7d 0a 20 20 20 20 20 20 7a  ) n++; }.      z
4390: 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28   = sqliteMalloc(
43a0: 20 69 2b 6e 2b 33 20 29 3b 0a 20 20 20 20 20 20   i+n+3 );.      
43b0: 69 66 28 20 7a 3d 3d 30 20 29 20 72 65 74 75 72  if( z==0 ) retur
43c0: 6e 3b 0a 20 20 20 20 20 20 7a 5b 30 5d 20 3d 20  n;.      z[0] = 
43d0: 27 5c 27 27 3b 0a 20 20 20 20 20 20 66 6f 72 28  '\'';.      for(
43e0: 69 3d 30 2c 20 6a 3d 31 3b 20 7a 41 72 67 5b 69  i=0, j=1; zArg[i
43f0: 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20  ]; i++){.       
4400: 20 7a 5b 6a 2b 2b 5d 20 3d 20 7a 41 72 67 5b 69   z[j++] = zArg[i
4410: 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a  ];.        if( z
4420: 41 72 67 5b 69 5d 3d 3d 27 5c 27 27 20 29 7b 0a  Arg[i]=='\'' ){.
4430: 20 20 20 20 20 20 20 20 20 20 7a 5b 6a 2b 2b 5d            z[j++]
4440: 20 3d 20 27 5c 27 27 3b 0a 20 20 20 20 20 20 20   = '\'';.       
4450: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20   }.      }.     
4460: 20 7a 5b 6a 2b 2b 5d 20 3d 20 27 5c 27 27 3b 0a   z[j++] = '\'';.
4470: 20 20 20 20 20 20 7a 5b 6a 5d 20 3d 20 30 3b 0a        z[j] = 0;.
4480: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65        sqlite3_re
4490: 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e 74 65 78  sult_text(contex
44a0: 74 2c 20 7a 2c 20 6a 2c 20 31 29 3b 0a 20 20 20  t, z, j, 1);.   
44b0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 29     sqliteFree(z)
44c0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 23  ;.    }.  }.}..#
44d0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 53 4f 55  ifdef SQLITE_SOU
44e0: 4e 44 45 58 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75  NDEX./*.** Compu
44f0: 74 65 20 74 68 65 20 73 6f 75 6e 64 65 78 20 65  te the soundex e
4500: 6e 63 6f 64 69 6e 67 20 6f 66 20 61 20 77 6f 72  ncoding of a wor
4510: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  d..*/.static voi
4520: 64 20 73 6f 75 6e 64 65 78 46 75 6e 63 28 73 71  d soundexFunc(sq
4530: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63  lite3_context *c
4540: 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61 72 67 63  ontext, int argc
4550: 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  , sqlite3_value 
4560: 2a 2a 61 72 67 76 29 7b 0a 20 20 63 68 61 72 20  **argv){.  char 
4570: 7a 52 65 73 75 6c 74 5b 38 5d 3b 0a 20 20 63 6f  zResult[8];.  co
4580: 6e 73 74 20 63 68 61 72 20 2a 7a 49 6e 3b 0a 20  nst char *zIn;. 
4590: 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 73 74 61   int i, j;.  sta
45a0: 74 69 63 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  tic const unsign
45b0: 65 64 20 63 68 61 72 20 69 43 6f 64 65 5b 5d 20  ed char iCode[] 
45c0: 3d 20 7b 0a 20 20 20 20 30 2c 20 30 2c 20 30 2c  = {.    0, 0, 0,
45d0: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20   0, 0, 0, 0, 0, 
45e0: 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  0, 0, 0, 0, 0, 0
45f0: 2c 20 30 2c 20 30 2c 0a 20 20 20 20 30 2c 20 30  , 0, 0,.    0, 0
4600: 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c  , 0, 0, 0, 0, 0,
4610: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20   0, 0, 0, 0, 0, 
4620: 30 2c 20 30 2c 20 30 2c 20 30 2c 0a 20 20 20 20  0, 0, 0, 0,.    
4630: 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  0, 0, 0, 0, 0, 0
4640: 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c  , 0, 0, 0, 0, 0,
4650: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 0a   0, 0, 0, 0, 0,.
4660: 20 20 20 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20      0, 0, 0, 0, 
4670: 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  0, 0, 0, 0, 0, 0
4680: 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c  , 0, 0, 0, 0, 0,
4690: 20 30 2c 0a 20 20 20 20 30 2c 20 30 2c 20 31 2c   0,.    0, 0, 1,
46a0: 20 32 2c 20 33 2c 20 30 2c 20 31 2c 20 32 2c 20   2, 3, 0, 1, 2, 
46b0: 30 2c 20 30 2c 20 32 2c 20 32 2c 20 34 2c 20 35  0, 0, 2, 2, 4, 5
46c0: 2c 20 35 2c 20 30 2c 0a 20 20 20 20 31 2c 20 32  , 5, 0,.    1, 2
46d0: 2c 20 36 2c 20 32 2c 20 33 2c 20 30 2c 20 31 2c  , 6, 2, 3, 0, 1,
46e0: 20 30 2c 20 32 2c 20 30 2c 20 32 2c 20 30 2c 20   0, 2, 0, 2, 0, 
46f0: 30 2c 20 30 2c 20 30 2c 20 30 2c 0a 20 20 20 20  0, 0, 0, 0,.    
4700: 30 2c 20 30 2c 20 31 2c 20 32 2c 20 33 2c 20 30  0, 0, 1, 2, 3, 0
4710: 2c 20 31 2c 20 32 2c 20 30 2c 20 30 2c 20 32 2c  , 1, 2, 0, 0, 2,
4720: 20 32 2c 20 34 2c 20 35 2c 20 35 2c 20 30 2c 0a   2, 4, 5, 5, 0,.
4730: 20 20 20 20 31 2c 20 32 2c 20 36 2c 20 32 2c 20      1, 2, 6, 2, 
4740: 33 2c 20 30 2c 20 31 2c 20 30 2c 20 32 2c 20 30  3, 0, 1, 0, 2, 0
4750: 2c 20 32 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c  , 2, 0, 0, 0, 0,
4760: 20 30 2c 0a 20 20 7d 3b 0a 20 20 61 73 73 65 72   0,.  };.  asser
4770: 74 28 20 61 72 67 63 3d 3d 31 20 29 3b 0a 20 20  t( argc==1 );.  
4780: 7a 49 6e 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  zIn = sqlite3_va
4790: 6c 75 65 5f 74 65 78 74 28 61 72 67 76 5b 30 5d  lue_text(argv[0]
47a0: 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 7a 49  );.  for(i=0; zI
47b0: 6e 5b 69 5d 20 26 26 20 21 69 73 61 6c 70 68 61  n[i] && !isalpha
47c0: 28 7a 49 6e 5b 69 5d 29 3b 20 69 2b 2b 29 7b 7d  (zIn[i]); i++){}
47d0: 0a 20 20 69 66 28 20 7a 49 6e 5b 69 5d 20 29 7b  .  if( zIn[i] ){
47e0: 0a 20 20 20 20 7a 52 65 73 75 6c 74 5b 30 5d 20  .    zResult[0] 
47f0: 3d 20 74 6f 75 70 70 65 72 28 7a 49 6e 5b 69 5d  = toupper(zIn[i]
4800: 29 3b 0a 20 20 20 20 66 6f 72 28 6a 3d 31 3b 20  );.    for(j=1; 
4810: 6a 3c 34 20 26 26 20 7a 49 6e 5b 69 5d 3b 20 69  j<4 && zIn[i]; i
4820: 2b 2b 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 63  ++){.      int c
4830: 6f 64 65 20 3d 20 69 43 6f 64 65 5b 7a 49 6e 5b  ode = iCode[zIn[
4840: 69 5d 26 30 78 37 66 5d 3b 0a 20 20 20 20 20 20  i]&0x7f];.      
4850: 69 66 28 20 63 6f 64 65 3e 30 20 29 7b 0a 20 20  if( code>0 ){.  
4860: 20 20 20 20 20 20 7a 52 65 73 75 6c 74 5b 6a 2b        zResult[j+
4870: 2b 5d 20 3d 20 63 6f 64 65 20 2b 20 27 30 27 3b  +] = code + '0';
4880: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
4890: 20 20 20 77 68 69 6c 65 28 20 6a 3c 34 20 29 7b     while( j<4 ){
48a0: 0a 20 20 20 20 20 20 7a 52 65 73 75 6c 74 5b 6a  .      zResult[j
48b0: 2b 2b 5d 20 3d 20 27 30 27 3b 0a 20 20 20 20 7d  ++] = '0';.    }
48c0: 0a 20 20 20 20 7a 52 65 73 75 6c 74 5b 6a 5d 20  .    zResult[j] 
48d0: 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  = 0;.    sqlite3
48e0: 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e  _result_text(con
48f0: 74 65 78 74 2c 20 7a 52 65 73 75 6c 74 2c 20 34  text, zResult, 4
4900: 2c 20 31 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  , 1);.  }else{. 
4910: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
4920: 74 5f 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20  t_text(context, 
4930: 22 3f 30 30 30 22 2c 20 34 2c 20 30 29 3b 0a 20  "?000", 4, 0);. 
4940: 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66   }.}.#endif..#if
4950: 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a  def SQLITE_TEST.
4960: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
4970: 69 6f 6e 20 67 65 6e 65 72 61 74 65 73 20 61 20  ion generates a 
4980: 73 74 72 69 6e 67 20 6f 66 20 72 61 6e 64 6f 6d  string of random
4990: 20 63 68 61 72 61 63 74 65 72 73 2e 20 20 55 73   characters.  Us
49a0: 65 64 20 66 6f 72 0a 2a 2a 20 67 65 6e 65 72 61  ed for.** genera
49b0: 74 69 6e 67 20 74 65 73 74 20 64 61 74 61 2e 0a  ting test data..
49c0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72  */.static void r
49d0: 61 6e 64 53 74 72 28 73 71 6c 69 74 65 33 5f 63  andStr(sqlite3_c
49e0: 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c  ontext *context,
49f0: 20 69 6e 74 20 61 72 67 63 2c 20 73 71 6c 69 74   int argc, sqlit
4a00: 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76 29  e3_value **argv)
4a10: 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  {.  static const
4a20: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 7a   unsigned char z
4a30: 53 72 63 5b 5d 20 3d 20 0a 20 20 20 20 20 22 61  Src[] = .     "a
4a40: 62 63 64 65 66 67 68 69 6a 6b 6c 6d 6e 6f 70 71  bcdefghijklmnopq
4a50: 72 73 74 75 76 77 78 79 7a 22 0a 20 20 20 20 20  rstuvwxyz".     
4a60: 22 41 42 43 44 45 46 47 48 49 4a 4b 4c 4d 4e 4f  "ABCDEFGHIJKLMNO
4a70: 50 51 52 53 54 55 56 57 58 59 5a 22 0a 20 20 20  PQRSTUVWXYZ".   
4a80: 20 20 22 30 31 32 33 34 35 36 37 38 39 22 0a 20    "0123456789". 
4a90: 20 20 20 20 22 2e 2d 21 2c 3a 2a 5e 2b 3d 5f 7c      ".-!,:*^+=_|
4aa0: 3f 2f 3c 3e 20 22 3b 0a 20 20 69 6e 74 20 69 4d  ?/<> ";.  int iM
4ab0: 69 6e 2c 20 69 4d 61 78 2c 20 6e 2c 20 72 2c 20  in, iMax, n, r, 
4ac0: 69 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68  i;.  unsigned ch
4ad0: 61 72 20 7a 42 75 66 5b 31 30 30 30 5d 3b 0a 20  ar zBuf[1000];. 
4ae0: 20 69 66 28 20 61 72 67 63 3e 3d 31 20 29 7b 0a   if( argc>=1 ){.
4af0: 20 20 20 20 69 4d 69 6e 20 3d 20 73 71 6c 69 74      iMin = sqlit
4b00: 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 61 72 67  e3_value_int(arg
4b10: 76 5b 30 5d 29 3b 0a 20 20 20 20 69 66 28 20 69  v[0]);.    if( i
4b20: 4d 69 6e 3c 30 20 29 20 69 4d 69 6e 20 3d 20 30  Min<0 ) iMin = 0
4b30: 3b 0a 20 20 20 20 69 66 28 20 69 4d 69 6e 3e 3d  ;.    if( iMin>=
4b40: 73 69 7a 65 6f 66 28 7a 42 75 66 29 20 29 20 69  sizeof(zBuf) ) i
4b50: 4d 69 6e 20 3d 20 73 69 7a 65 6f 66 28 7a 42 75  Min = sizeof(zBu
4b60: 66 29 2d 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  f)-1;.  }else{. 
4b70: 20 20 20 69 4d 69 6e 20 3d 20 31 3b 0a 20 20 7d     iMin = 1;.  }
4b80: 0a 20 20 69 66 28 20 61 72 67 63 3e 3d 32 20 29  .  if( argc>=2 )
4b90: 7b 0a 20 20 20 20 69 4d 61 78 20 3d 20 73 71 6c  {.    iMax = sql
4ba0: 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 61  ite3_value_int(a
4bb0: 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20 69 66 28  rgv[1]);.    if(
4bc0: 20 69 4d 61 78 3c 69 4d 69 6e 20 29 20 69 4d 61   iMax<iMin ) iMa
4bd0: 78 20 3d 20 69 4d 69 6e 3b 0a 20 20 20 20 69 66  x = iMin;.    if
4be0: 28 20 69 4d 61 78 3e 3d 73 69 7a 65 6f 66 28 7a  ( iMax>=sizeof(z
4bf0: 42 75 66 29 20 29 20 69 4d 61 78 20 3d 20 73 69  Buf) ) iMax = si
4c00: 7a 65 6f 66 28 7a 42 75 66 29 2d 31 3b 0a 20 20  zeof(zBuf)-1;.  
4c10: 7d 65 6c 73 65 7b 0a 20 20 20 20 69 4d 61 78 20  }else{.    iMax 
4c20: 3d 20 35 30 3b 0a 20 20 7d 0a 20 20 6e 20 3d 20  = 50;.  }.  n = 
4c30: 69 4d 69 6e 3b 0a 20 20 69 66 28 20 69 4d 61 78  iMin;.  if( iMax
4c40: 3e 69 4d 69 6e 20 29 7b 0a 20 20 20 20 73 71 6c  >iMin ){.    sql
4c50: 69 74 65 33 52 61 6e 64 6f 6d 6e 65 73 73 28 73  ite3Randomness(s
4c60: 69 7a 65 6f 66 28 72 29 2c 20 26 72 29 3b 0a 20  izeof(r), &r);. 
4c70: 20 20 20 72 20 26 3d 20 30 78 37 66 66 66 66 66     r &= 0x7fffff
4c80: 66 66 3b 0a 20 20 20 20 6e 20 2b 3d 20 72 25 28  ff;.    n += r%(
4c90: 69 4d 61 78 20 2b 20 31 20 2d 20 69 4d 69 6e 29  iMax + 1 - iMin)
4ca0: 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20  ;.  }.  assert( 
4cb0: 6e 3c 73 69 7a 65 6f 66 28 7a 42 75 66 29 20 29  n<sizeof(zBuf) )
4cc0: 3b 0a 20 20 73 71 6c 69 74 65 33 52 61 6e 64 6f  ;.  sqlite3Rando
4cd0: 6d 6e 65 73 73 28 6e 2c 20 7a 42 75 66 29 3b 0a  mness(n, zBuf);.
4ce0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 3b 20    for(i=0; i<n; 
4cf0: 69 2b 2b 29 7b 0a 20 20 20 20 7a 42 75 66 5b 69  i++){.    zBuf[i
4d00: 5d 20 3d 20 7a 53 72 63 5b 7a 42 75 66 5b 69 5d  ] = zSrc[zBuf[i]
4d10: 25 28 73 69 7a 65 6f 66 28 7a 53 72 63 29 2d 31  %(sizeof(zSrc)-1
4d20: 29 5d 3b 0a 20 20 7d 0a 20 20 7a 42 75 66 5b 6e  )];.  }.  zBuf[n
4d30: 5d 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33  ] = 0;.  sqlite3
4d40: 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 63 6f 6e  _result_text(con
4d50: 74 65 78 74 2c 20 7a 42 75 66 2c 20 6e 2c 20 31  text, zBuf, n, 1
4d60: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  );.}.#endif../*.
4d70: 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f  ** An instance o
4d80: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  f the following 
4d90: 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 73 20  structure holds 
4da0: 74 68 65 20 63 6f 6e 74 65 78 74 20 6f 66 20 61  the context of a
4db0: 0a 2a 2a 20 73 75 6d 28 29 20 6f 72 20 61 76 67  .** sum() or avg
4dc0: 28 29 20 61 67 67 72 65 67 61 74 65 20 63 6f 6d  () aggregate com
4dd0: 70 75 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 74 79 70  putation..*/.typ
4de0: 65 64 65 66 20 73 74 72 75 63 74 20 53 75 6d 43  edef struct SumC
4df0: 74 78 20 53 75 6d 43 74 78 3b 0a 73 74 72 75 63  tx SumCtx;.struc
4e00: 74 20 53 75 6d 43 74 78 20 7b 0a 20 20 64 6f 75  t SumCtx {.  dou
4e10: 62 6c 65 20 73 75 6d 3b 20 20 20 20 20 2f 2a 20  ble sum;     /* 
4e20: 53 75 6d 20 6f 66 20 74 65 72 6d 73 20 2a 2f 0a  Sum of terms */.
4e30: 20 20 69 6e 74 20 63 6e 74 3b 20 20 20 20 20 20    int cnt;      
4e40: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65    /* Number of e
4e50: 6c 65 6d 65 6e 74 73 20 73 75 6d 6d 65 64 20 2a  lements summed *
4e60: 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74  /.};../*.** Rout
4e70: 69 6e 65 73 20 75 73 65 64 20 74 6f 20 63 6f 6d  ines used to com
4e80: 70 75 74 65 20 74 68 65 20 73 75 6d 20 6f 72 20  pute the sum or 
4e90: 61 76 65 72 61 67 65 2e 0a 2a 2f 0a 73 74 61 74  average..*/.stat
4ea0: 69 63 20 76 6f 69 64 20 73 75 6d 53 74 65 70 28  ic void sumStep(
4eb0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
4ec0: 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61 72  *context, int ar
4ed0: 67 63 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  gc, sqlite3_valu
4ee0: 65 20 2a 2a 61 72 67 76 29 7b 0a 20 20 53 75 6d  e **argv){.  Sum
4ef0: 43 74 78 20 2a 70 3b 0a 20 20 69 66 28 20 61 72  Ctx *p;.  if( ar
4f00: 67 63 3c 31 20 29 20 72 65 74 75 72 6e 3b 0a 20  gc<1 ) return;. 
4f10: 20 70 20 3d 20 73 71 6c 69 74 65 33 5f 61 67 67   p = sqlite3_agg
4f20: 72 65 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 63  regate_context(c
4f30: 6f 6e 74 65 78 74 2c 20 73 69 7a 65 6f 66 28 2a  ontext, sizeof(*
4f40: 70 29 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20  p));.  if( p && 
4f50: 53 51 4c 49 54 45 5f 4e 55 4c 4c 21 3d 73 71 6c  SQLITE_NULL!=sql
4f60: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
4f70: 61 72 67 76 5b 30 5d 29 20 29 7b 0a 20 20 20 20  argv[0]) ){.    
4f80: 70 2d 3e 73 75 6d 20 2b 3d 20 73 71 6c 69 74 65  p->sum += sqlite
4f90: 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 61  3_value_double(a
4fa0: 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20 70 2d 3e  rgv[0]);.    p->
4fb0: 63 6e 74 2b 2b 3b 0a 20 20 7d 0a 7d 0a 73 74 61  cnt++;.  }.}.sta
4fc0: 74 69 63 20 76 6f 69 64 20 73 75 6d 46 69 6e 61  tic void sumFina
4fd0: 6c 69 7a 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e  lize(sqlite3_con
4fe0: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 29 7b 0a  text *context){.
4ff0: 20 20 53 75 6d 43 74 78 20 2a 70 3b 0a 20 20 70    SumCtx *p;.  p
5000: 20 3d 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65   = sqlite3_aggre
5010: 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f 6e  gate_context(con
5020: 74 65 78 74 2c 20 73 69 7a 65 6f 66 28 2a 70 29  text, sizeof(*p)
5030: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73  );.  sqlite3_res
5040: 75 6c 74 5f 64 6f 75 62 6c 65 28 63 6f 6e 74 65  ult_double(conte
5050: 78 74 2c 20 70 20 3f 20 70 2d 3e 73 75 6d 20 3a  xt, p ? p->sum :
5060: 20 30 2e 30 29 3b 0a 7d 0a 73 74 61 74 69 63 20   0.0);.}.static 
5070: 76 6f 69 64 20 61 76 67 46 69 6e 61 6c 69 7a 65  void avgFinalize
5080: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
5090: 20 2a 63 6f 6e 74 65 78 74 29 7b 0a 20 20 53 75   *context){.  Su
50a0: 6d 43 74 78 20 2a 70 3b 0a 20 20 70 20 3d 20 73  mCtx *p;.  p = s
50b0: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65  qlite3_aggregate
50c0: 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74  _context(context
50d0: 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20  , sizeof(*p));. 
50e0: 20 69 66 28 20 70 20 26 26 20 70 2d 3e 63 6e 74   if( p && p->cnt
50f0: 3e 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  >0 ){.    sqlite
5100: 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28  3_result_double(
5110: 63 6f 6e 74 65 78 74 2c 20 70 2d 3e 73 75 6d 2f  context, p->sum/
5120: 28 64 6f 75 62 6c 65 29 70 2d 3e 63 6e 74 29 3b  (double)p->cnt);
5130: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6e  .  }.}../*.** An
5140: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65   instance of the
5150: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63   following struc
5160: 74 75 72 65 20 68 6f 6c 64 73 20 74 68 65 20 63  ture holds the c
5170: 6f 6e 74 65 78 74 20 6f 66 20 61 0a 2a 2a 20 76  ontext of a.** v
5180: 61 72 69 61 6e 63 65 20 6f 72 20 73 74 61 6e 64  ariance or stand
5190: 61 72 64 20 64 65 76 69 61 74 69 6f 6e 20 63 6f  ard deviation co
51a0: 6d 70 75 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 74 79  mputation..*/.ty
51b0: 70 65 64 65 66 20 73 74 72 75 63 74 20 53 74 64  pedef struct Std
51c0: 44 65 76 43 74 78 20 53 74 64 44 65 76 43 74 78  DevCtx StdDevCtx
51d0: 3b 0a 73 74 72 75 63 74 20 53 74 64 44 65 76 43  ;.struct StdDevC
51e0: 74 78 20 7b 0a 20 20 64 6f 75 62 6c 65 20 73 75  tx {.  double su
51f0: 6d 3b 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f 66  m;     /* Sum of
5200: 20 74 65 72 6d 73 20 2a 2f 0a 20 20 64 6f 75 62   terms */.  doub
5210: 6c 65 20 73 75 6d 32 3b 20 20 20 20 2f 2a 20 53  le sum2;    /* S
5220: 75 6d 20 6f 66 20 74 68 65 20 73 71 75 61 72 65  um of the square
5230: 73 20 6f 66 20 74 65 72 6d 73 20 2a 2f 0a 20 20  s of terms */.  
5240: 69 6e 74 20 63 6e 74 3b 20 20 20 20 20 20 20 20  int cnt;        
5250: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 65 72  /* Number of ter
5260: 6d 73 20 63 6f 75 6e 74 65 64 20 2a 2f 0a 7d 3b  ms counted */.};
5270: 0a 0a 23 69 66 20 30 20 20 20 2f 2a 20 4f 6d 69  ..#if 0   /* Omi
5280: 74 20 62 65 63 61 75 73 65 20 6d 61 74 68 20 6c  t because math l
5290: 69 62 72 61 72 79 20 69 73 20 72 65 71 75 69 72  ibrary is requir
52a0: 65 64 20 2a 2f 0a 2f 2a 0a 2a 2a 20 52 6f 75 74  ed */./*.** Rout
52b0: 69 6e 65 73 20 75 73 65 64 20 74 6f 20 63 6f 6d  ines used to com
52c0: 70 75 74 65 20 74 68 65 20 73 74 61 6e 64 61 72  pute the standar
52d0: 64 20 64 65 76 69 61 74 69 6f 6e 20 61 73 20 61  d deviation as a
52e0: 6e 20 61 67 67 72 65 67 61 74 65 2e 0a 2a 2f 0a  n aggregate..*/.
52f0: 73 74 61 74 69 63 20 76 6f 69 64 20 73 74 64 44  static void stdD
5300: 65 76 53 74 65 70 28 73 71 6c 69 74 65 33 5f 63  evStep(sqlite3_c
5310: 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c  ontext *context,
5320: 20 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74   int argc, const
5330: 20 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20   char **argv){. 
5340: 20 53 74 64 44 65 76 43 74 78 20 2a 70 3b 0a 20   StdDevCtx *p;. 
5350: 20 64 6f 75 62 6c 65 20 78 3b 0a 20 20 69 66 28   double x;.  if(
5360: 20 61 72 67 63 3c 31 20 29 20 72 65 74 75 72 6e   argc<1 ) return
5370: 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 5f  ;.  p = sqlite3_
5380: 61 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78  aggregate_contex
5390: 74 28 63 6f 6e 74 65 78 74 2c 20 73 69 7a 65 6f  t(context, sizeo
53a0: 66 28 2a 70 29 29 3b 0a 20 20 69 66 28 20 70 20  f(*p));.  if( p 
53b0: 26 26 20 61 72 67 76 5b 30 5d 20 29 7b 0a 20 20  && argv[0] ){.  
53c0: 20 20 78 20 3d 20 73 71 6c 69 74 65 33 41 74 6f    x = sqlite3Ato
53d0: 46 28 61 72 67 76 5b 30 5d 2c 20 30 29 3b 0a 20  F(argv[0], 0);. 
53e0: 20 20 20 70 2d 3e 73 75 6d 20 2b 3d 20 78 3b 0a     p->sum += x;.
53f0: 20 20 20 20 70 2d 3e 73 75 6d 32 20 2b 3d 20 78      p->sum2 += x
5400: 2a 78 3b 0a 20 20 20 20 70 2d 3e 63 6e 74 2b 2b  *x;.    p->cnt++
5410: 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76  ;.  }.}.static v
5420: 6f 69 64 20 73 74 64 44 65 76 46 69 6e 61 6c 69  oid stdDevFinali
5430: 7a 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  ze(sqlite3_conte
5440: 78 74 20 2a 63 6f 6e 74 65 78 74 29 7b 0a 20 20  xt *context){.  
5450: 64 6f 75 62 6c 65 20 72 4e 20 3d 20 73 71 6c 69  double rN = sqli
5460: 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f  te3_aggregate_co
5470: 75 6e 74 28 63 6f 6e 74 65 78 74 29 3b 0a 20 20  unt(context);.  
5480: 53 74 64 44 65 76 43 74 78 20 2a 70 20 3d 20 73  StdDevCtx *p = s
5490: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65  qlite3_aggregate
54a0: 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74  _context(context
54b0: 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20  , sizeof(*p));. 
54c0: 20 69 66 28 20 70 20 26 26 20 70 2d 3e 63 6e 74   if( p && p->cnt
54d0: 3e 31 20 29 7b 0a 20 20 20 20 64 6f 75 62 6c 65  >1 ){.    double
54e0: 20 72 43 6e 74 20 3d 20 63 6e 74 3b 0a 20 20 20   rCnt = cnt;.   
54f0: 20 73 71 6c 69 74 65 33 5f 73 65 74 5f 72 65 73   sqlite3_set_res
5500: 75 6c 74 5f 64 6f 75 62 6c 65 28 63 6f 6e 74 65  ult_double(conte
5510: 78 74 2c 20 0a 20 20 20 20 20 20 20 73 71 72 74  xt, .       sqrt
5520: 28 28 70 2d 3e 73 75 6d 32 20 2d 20 70 2d 3e 73  ((p->sum2 - p->s
5530: 75 6d 2a 70 2d 3e 73 75 6d 2f 72 43 6e 74 29 2f  um*p->sum/rCnt)/
5540: 28 72 43 6e 74 2d 31 2e 30 29 29 29 3b 0a 20 20  (rCnt-1.0)));.  
5550: 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a  }.}.#endif../*.*
5560: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
5570: 73 74 72 75 63 74 75 72 65 20 6b 65 65 70 73 20  structure keeps 
5580: 74 72 61 63 6b 20 6f 66 20 73 74 61 74 65 20 69  track of state i
5590: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 20 74  nformation for t
55a0: 68 65 0a 2a 2a 20 63 6f 75 6e 74 28 29 20 61 67  he.** count() ag
55b0: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
55c0: 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72  ..*/.typedef str
55d0: 75 63 74 20 43 6f 75 6e 74 43 74 78 20 43 6f 75  uct CountCtx Cou
55e0: 6e 74 43 74 78 3b 0a 73 74 72 75 63 74 20 43 6f  ntCtx;.struct Co
55f0: 75 6e 74 43 74 78 20 7b 0a 20 20 69 6e 74 20 6e  untCtx {.  int n
5600: 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74  ;.};../*.** Rout
5610: 69 6e 65 73 20 74 6f 20 69 6d 70 6c 65 6d 65 6e  ines to implemen
5620: 74 20 74 68 65 20 63 6f 75 6e 74 28 29 20 61 67  t the count() ag
5630: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
5640: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
5650: 20 63 6f 75 6e 74 53 74 65 70 28 73 71 6c 69 74   countStep(sqlit
5660: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74  e3_context *cont
5670: 65 78 74 2c 20 69 6e 74 20 61 72 67 63 2c 20 73  ext, int argc, s
5680: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61  qlite3_value **a
5690: 72 67 76 29 7b 0a 20 20 43 6f 75 6e 74 43 74 78  rgv){.  CountCtx
56a0: 20 2a 70 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74   *p;.  p = sqlit
56b0: 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e  e3_aggregate_con
56c0: 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 73 69  text(context, si
56d0: 7a 65 6f 66 28 2a 70 29 29 3b 0a 20 20 69 66 28  zeof(*p));.  if(
56e0: 20 28 61 72 67 63 3d 3d 30 20 7c 7c 20 53 51 4c   (argc==0 || SQL
56f0: 49 54 45 5f 4e 55 4c 4c 21 3d 73 71 6c 69 74 65  ITE_NULL!=sqlite
5700: 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 61 72 67  3_value_type(arg
5710: 76 5b 30 5d 29 29 20 26 26 20 70 20 29 7b 0a 20  v[0])) && p ){. 
5720: 20 20 20 70 2d 3e 6e 2b 2b 3b 0a 20 20 7d 0a 7d     p->n++;.  }.}
5730: 20 20 20 0a 73 74 61 74 69 63 20 76 6f 69 64 20     .static void 
5740: 63 6f 75 6e 74 46 69 6e 61 6c 69 7a 65 28 73 71  countFinalize(sq
5750: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63  lite3_context *c
5760: 6f 6e 74 65 78 74 29 7b 0a 20 20 43 6f 75 6e 74  ontext){.  Count
5770: 43 74 78 20 2a 70 3b 0a 20 20 70 20 3d 20 73 71  Ctx *p;.  p = sq
5780: 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f  lite3_aggregate_
5790: 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74 2c  context(context,
57a0: 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20 20   sizeof(*p));.  
57b0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69  sqlite3_result_i
57c0: 6e 74 28 63 6f 6e 74 65 78 74 2c 20 70 20 3f 20  nt(context, p ? 
57d0: 70 2d 3e 6e 20 3a 20 30 29 3b 0a 7d 0a 0a 2f 2a  p->n : 0);.}../*
57e0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
57f0: 6e 20 74 72 61 63 6b 73 20 73 74 61 74 65 20 69  n tracks state i
5800: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 20 74  nformation for t
5810: 68 65 20 6d 69 6e 28 29 20 61 6e 64 20 6d 61 78  he min() and max
5820: 28 29 0a 2a 2a 20 61 67 67 72 65 67 61 74 65 20  ().** aggregate 
5830: 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 74 79  functions..*/.ty
5840: 70 65 64 65 66 20 73 74 72 75 63 74 20 4d 69 6e  pedef struct Min
5850: 4d 61 78 43 74 78 20 4d 69 6e 4d 61 78 43 74 78  MaxCtx MinMaxCtx
5860: 3b 0a 73 74 72 75 63 74 20 4d 69 6e 4d 61 78 43  ;.struct MinMaxC
5870: 74 78 20 7b 0a 20 20 63 68 61 72 20 2a 7a 3b 20  tx {.  char *z; 
5880: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62          /* The b
5890: 65 73 74 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20  est so far */.  
58a0: 63 68 61 72 20 7a 42 75 66 5b 32 38 5d 3b 20 20  char zBuf[28];  
58b0: 20 2f 2a 20 53 70 61 63 65 20 74 68 61 74 20 63   /* Space that c
58c0: 61 6e 20 62 65 20 75 73 65 64 20 66 6f 72 20 73  an be used for s
58d0: 74 6f 72 61 67 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a  torage */.};../*
58e0: 0a 2a 2a 20 52 6f 75 74 69 6e 65 73 20 74 6f 20  .** Routines to 
58f0: 69 6d 70 6c 65 6d 65 6e 74 20 6d 69 6e 28 29 20  implement min() 
5900: 61 6e 64 20 6d 61 78 28 29 20 61 67 67 72 65 67  and max() aggreg
5910: 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a  ate functions..*
5920: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d 69  /.static void mi
5930: 6e 6d 61 78 53 74 65 70 28 73 71 6c 69 74 65 33  nmaxStep(sqlite3
5940: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
5950: 74 2c 20 69 6e 74 20 61 72 67 63 2c 20 73 71 6c  t, int argc, sql
5960: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67  ite3_value **arg
5970: 76 29 7b 0a 20 20 69 6e 74 20 6d 61 78 20 3d 20  v){.  int max = 
5980: 30 3b 0a 20 20 69 6e 74 20 63 6d 70 20 3d 20 30  0;.  int cmp = 0
5990: 3b 0a 20 20 4d 65 6d 20 2a 70 41 72 67 20 20 3d  ;.  Mem *pArg  =
59a0: 20 28 4d 65 6d 20 2a 29 61 72 67 76 5b 30 5d 3b   (Mem *)argv[0];
59b0: 0a 20 20 4d 65 6d 20 2a 70 42 65 73 74 20 3d 20  .  Mem *pBest = 
59c0: 28 4d 65 6d 20 2a 29 73 71 6c 69 74 65 33 5f 61  (Mem *)sqlite3_a
59d0: 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78 74  ggregate_context
59e0: 28 63 6f 6e 74 65 78 74 2c 20 73 69 7a 65 6f 66  (context, sizeof
59f0: 28 2a 70 42 65 73 74 29 29 3b 0a 0a 20 20 69 66  (*pBest));..  if
5a00: 28 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 3d 3d 73  ( SQLITE_NULL==s
5a10: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
5a20: 65 28 61 72 67 76 5b 30 5d 29 20 29 20 72 65 74  e(argv[0]) ) ret
5a30: 75 72 6e 3b 0a 0a 20 20 69 66 28 20 70 42 65 73  urn;..  if( pBes
5a40: 74 2d 3e 66 6c 61 67 73 20 29 7b 0a 20 20 20 20  t->flags ){.    
5a50: 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d  CollSeq *pColl =
5a60: 20 73 71 6c 69 74 65 33 47 65 74 46 75 6e 63 43   sqlite3GetFuncC
5a70: 6f 6c 6c 53 65 71 28 63 6f 6e 74 65 78 74 29 3b  ollSeq(context);
5a80: 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 73 74 65  .    /* This ste
5a90: 70 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73  p function is us
5aa0: 65 64 20 66 6f 72 20 62 6f 74 68 20 74 68 65 20  ed for both the 
5ab0: 6d 69 6e 28 29 20 61 6e 64 20 6d 61 78 28 29 20  min() and max() 
5ac0: 61 67 67 72 65 67 61 74 65 73 2c 0a 20 20 20 20  aggregates,.    
5ad0: 2a 2a 20 74 68 65 20 6f 6e 6c 79 20 64 69 66 66  ** the only diff
5ae0: 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74  erence between t
5af0: 68 65 20 74 77 6f 20 62 65 69 6e 67 20 74 68 61  he two being tha
5b00: 74 20 74 68 65 20 73 65 6e 73 65 20 6f 66 20 74  t the sense of t
5b10: 68 65 0a 20 20 20 20 2a 2a 20 63 6f 6d 70 61 72  he.    ** compar
5b20: 69 73 6f 6e 20 69 73 20 69 6e 76 65 72 74 65 64  ison is inverted
5b30: 2e 20 46 6f 72 20 74 68 65 20 6d 61 78 28 29 20  . For the max() 
5b40: 61 67 67 72 65 67 61 74 65 2c 20 74 68 65 0a 20  aggregate, the. 
5b50: 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 75 73     ** sqlite3_us
5b60: 65 72 5f 64 61 74 61 28 29 20 66 75 6e 63 74 69  er_data() functi
5b70: 6f 6e 20 72 65 74 75 72 6e 73 20 28 76 6f 69 64  on returns (void
5b80: 20 2a 29 2d 31 2e 20 46 6f 72 20 6d 69 6e 28 29   *)-1. For min()
5b90: 20 69 74 0a 20 20 20 20 2a 2a 20 72 65 74 75 72   it.    ** retur
5ba0: 6e 73 20 28 76 6f 69 64 20 2a 29 64 62 2c 20 77  ns (void *)db, w
5bb0: 68 65 72 65 20 64 62 20 69 73 20 74 68 65 20 73  here db is the s
5bc0: 71 6c 69 74 65 33 2a 20 64 61 74 61 62 61 73 65  qlite3* database
5bd0: 20 70 6f 69 6e 74 65 72 2e 0a 20 20 20 20 2a 2a   pointer..    **
5be0: 20 54 68 65 72 65 66 6f 72 65 20 74 68 65 20 6e   Therefore the n
5bf0: 65 78 74 20 73 74 61 74 65 6d 65 6e 74 20 73 65  ext statement se
5c00: 74 73 20 76 61 72 69 61 62 6c 65 20 27 6d 61 78  ts variable 'max
5c10: 27 20 74 6f 20 31 20 66 6f 72 20 74 68 65 20 6d  ' to 1 for the m
5c20: 61 78 28 29 0a 20 20 20 20 2a 2a 20 61 67 67 72  ax().    ** aggr
5c30: 65 67 61 74 65 2c 20 6f 72 20 30 20 66 6f 72 20  egate, or 0 for 
5c40: 6d 69 6e 28 29 2e 0a 20 20 20 20 2a 2f 0a 20 20  min()..    */.  
5c50: 20 20 6d 61 78 20 3d 20 28 28 73 71 6c 69 74 65    max = ((sqlite
5c60: 33 5f 75 73 65 72 5f 64 61 74 61 28 63 6f 6e 74  3_user_data(cont
5c70: 65 78 74 29 3d 3d 28 76 6f 69 64 20 2a 29 2d 31  ext)==(void *)-1
5c80: 29 3f 31 3a 30 29 3b 0a 20 20 20 20 63 6d 70 20  )?1:0);.    cmp 
5c90: 3d 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f 6d 70  = sqlite3MemComp
5ca0: 61 72 65 28 70 42 65 73 74 2c 20 70 41 72 67 2c  are(pBest, pArg,
5cb0: 20 70 43 6f 6c 6c 29 3b 0a 20 20 20 20 69 66 28   pColl);.    if(
5cc0: 20 28 6d 61 78 20 26 26 20 63 6d 70 3c 30 29 20   (max && cmp<0) 
5cd0: 7c 7c 20 28 21 6d 61 78 20 26 26 20 63 6d 70 3e  || (!max && cmp>
5ce0: 30 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  0) ){.      sqli
5cf0: 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79 28 70  te3VdbeMemCopy(p
5d00: 42 65 73 74 2c 20 70 41 72 67 29 3b 0a 20 20 20  Best, pArg);.   
5d10: 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20   }.  }else{.    
5d20: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6f  sqlite3VdbeMemCo
5d30: 70 79 28 70 42 65 73 74 2c 20 70 41 72 67 29 3b  py(pBest, pArg);
5d40: 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f  .  }.}.static vo
5d50: 69 64 20 6d 69 6e 4d 61 78 46 69 6e 61 6c 69 7a  id minMaxFinaliz
5d60: 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  e(sqlite3_contex
5d70: 74 20 2a 63 6f 6e 74 65 78 74 29 7b 0a 20 20 73  t *context){.  s
5d80: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 52  qlite3_value *pR
5d90: 65 73 3b 0a 20 20 70 52 65 73 20 3d 20 28 73 71  es;.  pRes = (sq
5da0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 29 73 71  lite3_value *)sq
5db0: 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f  lite3_aggregate_
5dc0: 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74 2c  context(context,
5dd0: 20 73 69 7a 65 6f 66 28 4d 65 6d 29 29 3b 0a 20   sizeof(Mem));. 
5de0: 20 69 66 28 20 70 52 65 73 2d 3e 66 6c 61 67 73   if( pRes->flags
5df0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
5e00: 72 65 73 75 6c 74 5f 76 61 6c 75 65 28 63 6f 6e  result_value(con
5e10: 74 65 78 74 2c 20 70 52 65 73 29 3b 0a 20 20 7d  text, pRes);.  }
5e20: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
5e30: 75 6e 63 74 69 6f 6e 20 72 65 67 69 73 74 65 72  unction register
5e40: 65 64 20 61 6c 6c 20 6f 66 20 74 68 65 20 61 62  ed all of the ab
5e50: 6f 76 65 20 43 20 66 75 6e 63 74 69 6f 6e 73 20  ove C functions 
5e60: 61 73 20 53 51 4c 0a 2a 2a 20 66 75 6e 63 74 69  as SQL.** functi
5e70: 6f 6e 73 2e 20 20 54 68 69 73 20 73 68 6f 75 6c  ons.  This shoul
5e80: 64 20 62 65 20 74 68 65 20 6f 6e 6c 79 20 72 6f  d be the only ro
5e90: 75 74 69 6e 65 20 69 6e 20 74 68 69 73 20 66 69  utine in this fi
5ea0: 6c 65 20 77 69 74 68 0a 2a 2a 20 65 78 74 65 72  le with.** exter
5eb0: 6e 61 6c 20 6c 69 6e 6b 61 67 65 2e 0a 2a 2f 0a  nal linkage..*/.
5ec0: 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 67 69  void sqlite3Regi
5ed0: 73 74 65 72 42 75 69 6c 74 69 6e 46 75 6e 63 74  sterBuiltinFunct
5ee0: 69 6f 6e 73 28 73 71 6c 69 74 65 20 2a 64 62 29  ions(sqlite *db)
5ef0: 7b 0a 20 20 73 74 61 74 69 63 20 73 74 72 75 63  {.  static struc
5f00: 74 20 7b 0a 20 20 20 20 20 63 68 61 72 20 2a 7a  t {.     char *z
5f10: 4e 61 6d 65 3b 0a 20 20 20 20 20 73 69 67 6e 65  Name;.     signe
5f20: 64 20 63 68 61 72 20 6e 41 72 67 3b 0a 20 20 20  d char nArg;.   
5f30: 20 20 75 38 20 61 72 67 54 79 70 65 3b 20 20 20    u8 argType;   
5f40: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 30              /* 0
5f50: 3a 20 6e 6f 6e 65 2e 20 20 31 3a 20 64 62 20 20  : none.  1: db  
5f60: 32 3a 20 28 2d 31 29 20 2a 2f 0a 20 20 20 20 20  2: (-1) */.     
5f70: 75 38 20 65 54 65 78 74 52 65 70 3b 20 20 20 20  u8 eTextRep;    
5f80: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 3a 20            /* 1: 
5f90: 55 54 46 2d 31 36 2e 20 20 30 3a 20 55 54 46 2d  UTF-16.  0: UTF-
5fa0: 38 20 2a 2f 0a 20 20 20 20 20 75 38 20 6e 65 65  8 */.     u8 nee
5fb0: 64 43 6f 6c 6c 53 65 71 3b 0a 20 20 20 20 20 76  dCollSeq;.     v
5fc0: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c  oid (*xFunc)(sql
5fd0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e  ite3_context*,in
5fe0: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  t,sqlite3_value 
5ff0: 2a 2a 29 3b 0a 20 20 7d 20 61 46 75 6e 63 73 5b  **);.  } aFuncs[
6000: 5d 20 3d 20 7b 0a 20 20 20 20 7b 20 22 6d 69 6e  ] = {.    { "min
6010: 22 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ",              
6020: 20 20 20 20 20 20 20 20 20 20 2d 31 2c 20 30 2c            -1, 0,
6030: 20 30 2c 20 31 2c 20 6d 69 6e 6d 61 78 46 75 6e   0, 1, minmaxFun
6040: 63 20 7d 2c 0a 20 20 20 20 7b 20 22 6d 69 6e 22  c },.    { "min"
6050: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
6060: 20 20 20 20 20 20 20 20 20 20 30 2c 20 30 2c 20            0, 0, 
6070: 30 2c 20 31 2c 20 30 20 20 20 20 20 20 20 20 20  0, 1, 0         
6080: 20 7d 2c 0a 20 20 20 20 7b 20 22 6d 61 78 22 2c   },.    { "max",
6090: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
60a0: 20 20 20 20 20 20 20 20 2d 31 2c 20 32 2c 20 30          -1, 2, 0
60b0: 2c 20 31 2c 20 6d 69 6e 6d 61 78 46 75 6e 63 20  , 1, minmaxFunc 
60c0: 7d 2c 0a 20 20 20 20 7b 20 22 6d 61 78 22 2c 20  },.    { "max", 
60d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
60e0: 20 20 20 20 20 20 20 20 30 2c 20 32 2c 20 30 2c          0, 2, 0,
60f0: 20 31 2c 20 30 20 20 20 20 20 20 20 20 20 20 7d   1, 0          }
6100: 2c 0a 20 20 20 20 7b 20 22 74 79 70 65 6f 66 22  ,.    { "typeof"
6110: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
6120: 20 20 20 20 20 20 20 31 2c 20 30 2c 20 30 2c 20         1, 0, 0, 
6130: 30 2c 20 74 79 70 65 6f 66 46 75 6e 63 20 7d 2c  0, typeofFunc },
6140: 0a 20 20 20 20 7b 20 22 6c 65 6e 67 74 68 22 2c  .    { "length",
6150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6160: 20 20 20 20 20 20 31 2c 20 30 2c 20 30 2c 20 30        1, 0, 0, 0
6170: 2c 20 6c 65 6e 67 74 68 46 75 6e 63 20 7d 2c 0a  , lengthFunc },.
6180: 20 20 20 20 7b 20 22 73 75 62 73 74 72 22 2c 20      { "substr", 
6190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
61a0: 20 20 20 20 20 33 2c 20 30 2c 20 30 2c 20 30 2c       3, 0, 0, 0,
61b0: 20 73 75 62 73 74 72 46 75 6e 63 20 7d 2c 0a 20   substrFunc },. 
61c0: 20 20 20 7b 20 22 61 62 73 22 2c 20 20 20 20 20     { "abs",     
61d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
61e0: 20 20 20 20 31 2c 20 30 2c 20 30 2c 20 30 2c 20      1, 0, 0, 0, 
61f0: 61 62 73 46 75 6e 63 20 20 20 20 7d 2c 0a 20 20  absFunc    },.  
6200: 20 20 7b 20 22 72 6f 75 6e 64 22 2c 20 20 20 20    { "round",    
6210: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6220: 20 20 20 31 2c 20 30 2c 20 30 2c 20 30 2c 20 72     1, 0, 0, 0, r
6230: 6f 75 6e 64 46 75 6e 63 20 20 7d 2c 0a 20 20 20  oundFunc  },.   
6240: 20 7b 20 22 72 6f 75 6e 64 22 2c 20 20 20 20 20   { "round",     
6250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6260: 20 20 32 2c 20 30 2c 20 30 2c 20 30 2c 20 72 6f    2, 0, 0, 0, ro
6270: 75 6e 64 46 75 6e 63 20 20 7d 2c 0a 20 20 20 20  undFunc  },.    
6280: 7b 20 22 75 70 70 65 72 22 2c 20 20 20 20 20 20  { "upper",      
6290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
62a0: 20 31 2c 20 30 2c 20 30 2c 20 30 2c 20 75 70 70   1, 0, 0, 0, upp
62b0: 65 72 46 75 6e 63 20 20 7d 2c 0a 20 20 20 20 7b  erFunc  },.    {
62c0: 20 22 6c 6f 77 65 72 22 2c 20 20 20 20 20 20 20   "lower",       
62d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
62e0: 31 2c 20 30 2c 20 30 2c 20 30 2c 20 6c 6f 77 65  1, 0, 0, 0, lowe
62f0: 72 46 75 6e 63 20 20 7d 2c 0a 20 20 20 20 7b 20  rFunc  },.    { 
6300: 22 63 6f 61 6c 65 73 63 65 22 2c 20 20 20 20 20  "coalesce",     
6310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 31                -1
6320: 2c 20 30 2c 20 30 2c 20 30 2c 20 69 66 6e 75 6c  , 0, 0, 0, ifnul
6330: 6c 46 75 6e 63 20 7d 2c 0a 20 20 20 20 7b 20 22  lFunc },.    { "
6340: 63 6f 61 6c 65 73 63 65 22 2c 20 20 20 20 20 20  coalesce",      
6350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 2c                0,
6360: 20 30 2c 20 30 2c 20 30 2c 20 30 20 20 20 20 20   0, 0, 0, 0     
6370: 20 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 63       },.    { "c
6380: 6f 61 6c 65 73 63 65 22 2c 20 20 20 20 20 20 20  oalesce",       
6390: 20 20 20 20 20 20 20 20 20 20 20 20 20 31 2c 20               1, 
63a0: 30 2c 20 30 2c 20 30 2c 20 30 20 20 20 20 20 20  0, 0, 0, 0      
63b0: 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 69 66      },.    { "if
63c0: 6e 75 6c 6c 22 2c 20 20 20 20 20 20 20 20 20 20  null",          
63d0: 20 20 20 20 20 20 20 20 20 20 20 20 32 2c 20 30              2, 0
63e0: 2c 20 30 2c 20 31 2c 20 69 66 6e 75 6c 6c 46 75  , 0, 1, ifnullFu
63f0: 6e 63 20 7d 2c 0a 20 20 20 20 7b 20 22 72 61 6e  nc },.    { "ran
6400: 64 6f 6d 22 2c 20 20 20 20 20 20 20 20 20 20 20  dom",           
6410: 20 20 20 20 20 20 20 20 20 20 2d 31 2c 20 30 2c            -1, 0,
6420: 20 30 2c 20 30 2c 20 72 61 6e 64 6f 6d 46 75 6e   0, 0, randomFun
6430: 63 20 7d 2c 0a 20 20 20 20 7b 20 22 6c 69 6b 65  c },.    { "like
6440: 22 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ",              
6450: 20 20 20 20 20 20 20 20 20 20 32 2c 20 30 2c 20            2, 0, 
6460: 30 2c 20 30 2c 20 6c 69 6b 65 46 75 6e 63 20 20  0, 0, likeFunc  
6470: 20 7d 2c 20 2f 2a 20 55 54 46 2d 38 20 2a 2f 0a   }, /* UTF-8 */.
6480: 20 20 20 20 7b 20 22 6c 69 6b 65 22 2c 20 20 20      { "like",   
6490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
64a0: 20 20 20 20 20 32 2c 20 32 2c 20 31 2c 20 30 2c       2, 2, 1, 0,
64b0: 20 6c 69 6b 65 46 75 6e 63 20 20 20 7d 2c 20 2f   likeFunc   }, /
64c0: 2a 20 55 54 46 2d 31 36 20 2a 2f 0a 20 20 20 20  * UTF-16 */.    
64d0: 7b 20 22 67 6c 6f 62 22 2c 20 20 20 20 20 20 20  { "glob",       
64e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
64f0: 20 32 2c 20 30 2c 20 30 2c 20 30 2c 20 67 6c 6f   2, 0, 0, 0, glo
6500: 62 46 75 6e 63 20 20 20 7d 2c 0a 20 20 20 20 7b  bFunc   },.    {
6510: 20 22 6e 75 6c 6c 69 66 22 2c 20 20 20 20 20 20   "nullif",      
6520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6530: 32 2c 20 30 2c 20 30 2c 20 30 2c 20 6e 75 6c 6c  2, 0, 0, 0, null
6540: 69 66 46 75 6e 63 20 7d 2c 0a 20 20 20 20 7b 20  ifFunc },.    { 
6550: 22 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 22  "sqlite_version"
6560: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30  ,              0
6570: 2c 20 30 2c 20 30 2c 20 30 2c 20 76 65 72 73 69  , 0, 0, 0, versi
6580: 6f 6e 46 75 6e 63 7d 2c 0a 20 20 20 20 7b 20 22  onFunc},.    { "
6590: 71 75 6f 74 65 22 2c 20 20 20 20 20 20 20 20 20  quote",         
65a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 2c                1,
65b0: 20 30 2c 20 30 2c 20 30 2c 20 71 75 6f 74 65 46   0, 0, 0, quoteF
65c0: 75 6e 63 20 20 7d 2c 0a 20 20 20 20 7b 20 22 6c  unc  },.    { "l
65d0: 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64  ast_insert_rowid
65e0: 22 2c 20 20 20 20 20 20 20 20 20 20 20 30 2c 20  ",           0, 
65f0: 31 2c 20 30 2c 20 30 2c 20 6c 61 73 74 5f 69 6e  1, 0, 0, last_in
6600: 73 65 72 74 5f 72 6f 77 69 64 20 7d 2c 0a 20 20  sert_rowid },.  
6610: 20 20 7b 20 22 63 68 61 6e 67 65 5f 63 6f 75 6e    { "change_coun
6620: 74 22 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  t",             
6630: 20 20 20 30 2c 20 31 2c 20 30 2c 20 30 2c 20 63     0, 1, 0, 0, c
6640: 68 61 6e 67 65 5f 63 6f 75 6e 74 20 20 20 20 20  hange_count     
6650: 20 7d 2c 0a 20 20 20 20 7b 20 22 6c 61 73 74 5f   },.    { "last_
6660: 73 74 61 74 65 6d 65 6e 74 5f 63 68 61 6e 67 65  statement_change
6670: 5f 63 6f 75 6e 74 22 2c 20 30 2c 20 31 2c 20 30  _count", 0, 1, 0
6680: 2c 20 30 2c 20 6c 61 73 74 5f 73 74 61 74 65 6d  , 0, last_statem
6690: 65 6e 74 5f 63 68 61 6e 67 65 5f 63 6f 75 6e 74  ent_change_count
66a0: 20 7d 2c 0a 23 69 66 64 65 66 20 53 51 4c 49 54   },.#ifdef SQLIT
66b0: 45 5f 53 4f 55 4e 44 45 58 0a 20 20 20 20 7b 20  E_SOUNDEX.    { 
66c0: 22 73 6f 75 6e 64 65 78 22 2c 20 20 20 20 20 20  "soundex",      
66d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31                 1
66e0: 2c 20 30 2c 20 30 2c 20 30 2c 20 73 6f 75 6e 64  , 0, 0, 0, sound
66f0: 65 78 46 75 6e 63 7d 2c 0a 23 65 6e 64 69 66 0a  exFunc},.#endif.
6700: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
6710: 53 54 0a 20 20 20 20 7b 20 22 72 61 6e 64 73 74  ST.    { "randst
6720: 72 22 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  r",             
6730: 20 20 20 20 20 20 20 20 32 2c 20 30 2c 20 30 2c          2, 0, 0,
6740: 20 30 2c 20 72 61 6e 64 53 74 72 20 20 20 20 7d   0, randStr    }
6750: 2c 0a 23 65 6e 64 69 66 0a 20 20 7d 3b 0a 20 20  ,.#endif.  };.  
6760: 73 74 61 74 69 63 20 73 74 72 75 63 74 20 7b 0a  static struct {.
6770: 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b      char *zName;
6780: 0a 20 20 20 20 73 69 67 6e 65 64 20 63 68 61 72  .    signed char
6790: 20 6e 41 72 67 3b 0a 20 20 20 20 75 38 20 61 72   nArg;.    u8 ar
67a0: 67 54 79 70 65 3b 0a 20 20 20 20 75 38 20 6e 65  gType;.    u8 ne
67b0: 65 64 43 6f 6c 6c 53 65 71 3b 0a 20 20 20 20 76  edCollSeq;.    v
67c0: 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c  oid (*xStep)(sql
67d0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e  ite3_context*,in
67e0: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a  t,sqlite3_value*
67f0: 2a 29 3b 0a 20 20 20 20 76 6f 69 64 20 28 2a 78  *);.    void (*x
6800: 46 69 6e 61 6c 69 7a 65 29 28 73 71 6c 69 74 65  Finalize)(sqlite
6810: 33 5f 63 6f 6e 74 65 78 74 2a 29 3b 0a 20 20 7d  3_context*);.  }
6820: 20 61 41 67 67 73 5b 5d 20 3d 20 7b 0a 20 20 20   aAggs[] = {.   
6830: 20 7b 20 22 6d 69 6e 22 2c 20 20 20 20 31 2c 20   { "min",    1, 
6840: 30 2c 20 31 2c 20 6d 69 6e 6d 61 78 53 74 65 70  0, 1, minmaxStep
6850: 2c 20 20 20 6d 69 6e 4d 61 78 46 69 6e 61 6c 69  ,   minMaxFinali
6860: 7a 65 20 7d 2c 0a 20 20 20 20 7b 20 22 6d 61 78  ze },.    { "max
6870: 22 2c 20 20 20 20 31 2c 20 32 2c 20 31 2c 20 6d  ",    1, 2, 1, m
6880: 69 6e 6d 61 78 53 74 65 70 2c 20 20 20 6d 69 6e  inmaxStep,   min
6890: 4d 61 78 46 69 6e 61 6c 69 7a 65 20 7d 2c 0a 20  MaxFinalize },. 
68a0: 20 20 20 7b 20 22 73 75 6d 22 2c 20 20 20 20 31     { "sum",    1
68b0: 2c 20 30 2c 20 30 2c 20 73 75 6d 53 74 65 70 2c  , 0, 0, sumStep,
68c0: 20 20 20 20 20 20 73 75 6d 46 69 6e 61 6c 69 7a        sumFinaliz
68d0: 65 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 61  e    },.    { "a
68e0: 76 67 22 2c 20 20 20 20 31 2c 20 30 2c 20 30 2c  vg",    1, 0, 0,
68f0: 20 73 75 6d 53 74 65 70 2c 20 20 20 20 20 20 61   sumStep,      a
6900: 76 67 46 69 6e 61 6c 69 7a 65 20 20 20 20 7d 2c  vgFinalize    },
6910: 0a 20 20 20 20 7b 20 22 63 6f 75 6e 74 22 2c 20  .    { "count", 
6920: 20 30 2c 20 30 2c 20 30 2c 20 63 6f 75 6e 74 53   0, 0, 0, countS
6930: 74 65 70 2c 20 20 20 20 63 6f 75 6e 74 46 69 6e  tep,    countFin
6940: 61 6c 69 7a 65 20 20 7d 2c 0a 20 20 20 20 7b 20  alize  },.    { 
6950: 22 63 6f 75 6e 74 22 2c 20 20 31 2c 20 30 2c 20  "count",  1, 0, 
6960: 30 2c 20 63 6f 75 6e 74 53 74 65 70 2c 20 20 20  0, countStep,   
6970: 20 63 6f 75 6e 74 46 69 6e 61 6c 69 7a 65 20 20   countFinalize  
6980: 7d 2c 0a 23 69 66 20 30 0a 20 20 20 20 7b 20 22  },.#if 0.    { "
6990: 73 74 64 64 65 76 22 2c 20 31 2c 20 30 2c 20 73  stddev", 1, 0, s
69a0: 74 64 44 65 76 53 74 65 70 2c 20 20 20 73 74 64  tdDevStep,   std
69b0: 44 65 76 46 69 6e 61 6c 69 7a 65 20 7d 2c 0a 23  DevFinalize },.#
69c0: 65 6e 64 69 66 0a 20 20 7d 3b 0a 20 20 69 6e 74  endif.  };.  int
69d0: 20 69 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b 20   i;..  for(i=0; 
69e0: 69 3c 73 69 7a 65 6f 66 28 61 46 75 6e 63 73 29  i<sizeof(aFuncs)
69f0: 2f 73 69 7a 65 6f 66 28 61 46 75 6e 63 73 5b 30  /sizeof(aFuncs[0
6a00: 5d 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 76 6f  ]); i++){.    vo
6a10: 69 64 20 2a 70 41 72 67 20 3d 20 30 3b 0a 20 20  id *pArg = 0;.  
6a20: 20 20 73 77 69 74 63 68 28 20 61 46 75 6e 63 73    switch( aFuncs
6a30: 5b 69 5d 2e 61 72 67 54 79 70 65 20 29 7b 0a 20  [i].argType ){. 
6a40: 20 20 20 20 20 63 61 73 65 20 31 3a 20 70 41 72       case 1: pAr
6a50: 67 20 3d 20 64 62 3b 20 62 72 65 61 6b 3b 0a 20  g = db; break;. 
6a60: 20 20 20 20 20 63 61 73 65 20 32 3a 20 70 41 72       case 2: pAr
6a70: 67 20 3d 20 28 76 6f 69 64 20 2a 29 28 2d 31 29  g = (void *)(-1)
6a80: 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20  ; break;.    }. 
6a90: 20 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74     sqlite3_creat
6aa0: 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 61  e_function(db, a
6ab0: 46 75 6e 63 73 5b 69 5d 2e 7a 4e 61 6d 65 2c 20  Funcs[i].zName, 
6ac0: 61 46 75 6e 63 73 5b 69 5d 2e 6e 41 72 67 2c 0a  aFuncs[i].nArg,.
6ad0: 20 20 20 20 20 20 20 20 61 46 75 6e 63 73 5b 69          aFuncs[i
6ae0: 5d 2e 65 54 65 78 74 52 65 70 2c 20 30 2c 20 70  ].eTextRep, 0, p
6af0: 41 72 67 2c 20 61 46 75 6e 63 73 5b 69 5d 2e 78  Arg, aFuncs[i].x
6b00: 46 75 6e 63 2c 20 30 2c 20 30 29 3b 0a 20 20 20  Func, 0, 0);.   
6b10: 20 69 66 28 20 61 46 75 6e 63 73 5b 69 5d 2e 6e   if( aFuncs[i].n
6b20: 65 65 64 43 6f 6c 6c 53 65 71 20 29 7b 0a 20 20  eedCollSeq ){.  
6b30: 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75      FuncDef *pFu
6b40: 6e 63 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64  nc = sqlite3Find
6b50: 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 61 46 75  Function(db, aFu
6b60: 6e 63 73 5b 69 5d 2e 7a 4e 61 6d 65 2c 20 0a 20  ncs[i].zName, . 
6b70: 20 20 20 20 20 20 20 20 20 73 74 72 6c 65 6e 28           strlen(
6b80: 61 46 75 6e 63 73 5b 69 5d 2e 7a 4e 61 6d 65 29  aFuncs[i].zName)
6b90: 2c 20 61 46 75 6e 63 73 5b 69 5d 2e 6e 41 72 67  , aFuncs[i].nArg
6ba0: 2c 20 61 46 75 6e 63 73 5b 69 5d 2e 65 54 65 78  , aFuncs[i].eTex
6bb0: 74 52 65 70 2c 20 30 29 3b 0a 20 20 20 20 20 20  tRep, 0);.      
6bc0: 69 66 28 20 70 46 75 6e 63 20 26 26 20 61 46 75  if( pFunc && aFu
6bd0: 6e 63 73 5b 69 5d 2e 6e 65 65 64 43 6f 6c 6c 53  ncs[i].needCollS
6be0: 65 71 20 29 7b 0a 20 20 20 20 20 20 20 20 70 46  eq ){.        pF
6bf0: 75 6e 63 2d 3e 6e 65 65 64 43 6f 6c 6c 53 65 71  unc->needCollSeq
6c00: 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20   = 1;.      }.  
6c10: 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 69 3d    }.  }.  for(i=
6c20: 30 3b 20 69 3c 73 69 7a 65 6f 66 28 61 41 67 67  0; i<sizeof(aAgg
6c30: 73 29 2f 73 69 7a 65 6f 66 28 61 41 67 67 73 5b  s)/sizeof(aAggs[
6c40: 30 5d 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 76  0]); i++){.    v
6c50: 6f 69 64 20 2a 70 41 72 67 20 3d 20 30 3b 0a 20  oid *pArg = 0;. 
6c60: 20 20 20 73 77 69 74 63 68 28 20 61 41 67 67 73     switch( aAggs
6c70: 5b 69 5d 2e 61 72 67 54 79 70 65 20 29 7b 0a 20  [i].argType ){. 
6c80: 20 20 20 20 20 63 61 73 65 20 31 3a 20 70 41 72       case 1: pAr
6c90: 67 20 3d 20 64 62 3b 20 62 72 65 61 6b 3b 0a 20  g = db; break;. 
6ca0: 20 20 20 20 20 63 61 73 65 20 32 3a 20 70 41 72       case 2: pAr
6cb0: 67 20 3d 20 28 76 6f 69 64 20 2a 29 28 2d 31 29  g = (void *)(-1)
6cc0: 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20  ; break;.    }. 
6cd0: 20 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74     sqlite3_creat
6ce0: 65 5f 66 75 6e 63 74 69 6f 6e 28 64 62 2c 20 61  e_function(db, a
6cf0: 41 67 67 73 5b 69 5d 2e 7a 4e 61 6d 65 2c 20 61  Aggs[i].zName, a
6d00: 41 67 67 73 5b 69 5d 2e 6e 41 72 67 2c 20 30 2c  Aggs[i].nArg, 0,
6d10: 20 30 2c 20 70 41 72 67 2c 0a 20 20 20 20 20 20   0, pArg,.      
6d20: 20 20 30 2c 20 61 41 67 67 73 5b 69 5d 2e 78 53    0, aAggs[i].xS
6d30: 74 65 70 2c 20 61 41 67 67 73 5b 69 5d 2e 78 46  tep, aAggs[i].xF
6d40: 69 6e 61 6c 69 7a 65 29 3b 0a 20 20 20 20 69 66  inalize);.    if
6d50: 28 20 61 41 67 67 73 5b 69 5d 2e 6e 65 65 64 43  ( aAggs[i].needC
6d60: 6f 6c 6c 53 65 71 20 29 7b 0a 20 20 20 20 20 20  ollSeq ){.      
6d70: 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 20 3d  FuncDef *pFunc =
6d80: 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e 63   sqlite3FindFunc
6d90: 74 69 6f 6e 28 20 64 62 2c 20 61 41 67 67 73 5b  tion( db, aAggs[
6da0: 69 5d 2e 7a 4e 61 6d 65 2c 0a 20 20 20 20 20 20  i].zName,.      
6db0: 20 20 20 20 73 74 72 6c 65 6e 28 61 41 67 67 73      strlen(aAggs
6dc0: 5b 69 5d 2e 7a 4e 61 6d 65 29 2c 20 61 41 67 67  [i].zName), aAgg
6dd0: 73 5b 69 5d 2e 6e 41 72 67 2c 20 30 2c 20 30 29  s[i].nArg, 0, 0)
6de0: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 46 75 6e  ;.      if( pFun
6df0: 63 20 26 26 20 61 41 67 67 73 5b 69 5d 2e 6e 65  c && aAggs[i].ne
6e00: 65 64 43 6f 6c 6c 53 65 71 20 29 7b 0a 20 20 20  edCollSeq ){.   
6e10: 20 20 20 20 20 70 46 75 6e 63 2d 3e 6e 65 65 64       pFunc->need
6e20: 43 6f 6c 6c 53 65 71 20 3d 20 31 3b 0a 20 20 20  CollSeq = 1;.   
6e30: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20     }.    }.  }. 
6e40: 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72   sqlite3Register
6e50: 44 61 74 65 54 69 6d 65 46 75 6e 63 74 69 6f 6e  DateTimeFunction
6e60: 73 28 64 62 29 3b 0a 7d 0a 0a                    s(db);.}..