/ Hex Artifact Content
Login

Artifact 2cd4922913234ad384ccb75dd41bc35259a8338c:


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 31 38 20 32 30 30 32 2f 30 35 2f 32 39 20  1.18 2002/05/29 
02a0: 32 33 3a 32 32 3a 32 33 20 64 72 68 20 45 78 70  23:22:23 drh Exp
02b0: 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 3c   $.*/.#include <
02c0: 63 74 79 70 65 2e 68 3e 0a 23 69 6e 63 6c 75 64  ctype.h>.#includ
02d0: 65 20 3c 6d 61 74 68 2e 68 3e 0a 23 69 6e 63 6c  e <math.h>.#incl
02e0: 75 64 65 20 3c 73 74 64 6c 69 62 2e 68 3e 0a 23  ude <stdlib.h>.#
02f0: 69 6e 63 6c 75 64 65 20 3c 61 73 73 65 72 74 2e  include <assert.
0300: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c  h>.#include "sql
0310: 69 74 65 49 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a  iteInt.h"../*.**
0320: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
0330: 6f 66 20 74 68 65 20 6e 6f 6e 2d 61 67 67 72 65  of the non-aggre
0340: 67 61 74 65 20 6d 69 6e 28 29 20 61 6e 64 20 6d  gate min() and m
0350: 61 78 28 29 20 66 75 6e 63 74 69 6f 6e 73 0a 2a  ax() functions.*
0360: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d 69  /.static void mi
0370: 6e 46 75 6e 63 28 73 71 6c 69 74 65 5f 66 75 6e  nFunc(sqlite_fun
0380: 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20  c *context, int 
0390: 61 72 67 63 2c 20 63 6f 6e 73 74 20 63 68 61 72  argc, const char
03a0: 20 2a 2a 61 72 67 76 29 7b 0a 20 20 63 6f 6e 73   **argv){.  cons
03b0: 74 20 63 68 61 72 20 2a 7a 42 65 73 74 3b 20 0a  t char *zBest; .
03c0: 20 20 69 6e 74 20 69 3b 0a 0a 20 20 69 66 28 20    int i;..  if( 
03d0: 61 72 67 63 3d 3d 30 20 29 20 72 65 74 75 72 6e  argc==0 ) return
03e0: 3b 0a 20 20 7a 42 65 73 74 20 3d 20 61 72 67 76  ;.  zBest = argv
03f0: 5b 30 5d 3b 0a 20 20 69 66 28 20 7a 42 65 73 74  [0];.  if( zBest
0400: 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  ==0 ) return;.  
0410: 66 6f 72 28 69 3d 31 3b 20 69 3c 61 72 67 63 3b  for(i=1; i<argc;
0420: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 61   i++){.    if( a
0430: 72 67 76 5b 69 5d 3d 3d 30 20 29 20 72 65 74 75  rgv[i]==0 ) retu
0440: 72 6e 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69  rn;.    if( sqli
0450: 74 65 43 6f 6d 70 61 72 65 28 61 72 67 76 5b 69  teCompare(argv[i
0460: 5d 2c 20 7a 42 65 73 74 29 3c 30 20 29 7b 0a 20  ], zBest)<0 ){. 
0470: 20 20 20 20 20 7a 42 65 73 74 20 3d 20 61 72 67       zBest = arg
0480: 76 5b 69 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  v[i];.    }.  }.
0490: 20 20 73 71 6c 69 74 65 5f 73 65 74 5f 72 65 73    sqlite_set_res
04a0: 75 6c 74 5f 73 74 72 69 6e 67 28 63 6f 6e 74 65  ult_string(conte
04b0: 78 74 2c 20 7a 42 65 73 74 2c 20 2d 31 29 3b 0a  xt, zBest, -1);.
04c0: 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d 61  }.static void ma
04d0: 78 46 75 6e 63 28 73 71 6c 69 74 65 5f 66 75 6e  xFunc(sqlite_fun
04e0: 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74 20  c *context, int 
04f0: 61 72 67 63 2c 20 63 6f 6e 73 74 20 63 68 61 72  argc, const char
0500: 20 2a 2a 61 72 67 76 29 7b 0a 20 20 63 6f 6e 73   **argv){.  cons
0510: 74 20 63 68 61 72 20 2a 7a 42 65 73 74 3b 20 0a  t char *zBest; .
0520: 20 20 69 6e 74 20 69 3b 0a 0a 20 20 69 66 28 20    int i;..  if( 
0530: 61 72 67 63 3d 3d 30 20 29 20 72 65 74 75 72 6e  argc==0 ) return
0540: 3b 0a 20 20 7a 42 65 73 74 20 3d 20 61 72 67 76  ;.  zBest = argv
0550: 5b 30 5d 3b 0a 20 20 69 66 28 20 7a 42 65 73 74  [0];.  if( zBest
0560: 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  ==0 ) return;.  
0570: 66 6f 72 28 69 3d 31 3b 20 69 3c 61 72 67 63 3b  for(i=1; i<argc;
0580: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 61   i++){.    if( a
0590: 72 67 76 5b 69 5d 3d 3d 30 20 29 20 72 65 74 75  rgv[i]==0 ) retu
05a0: 72 6e 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69  rn;.    if( sqli
05b0: 74 65 43 6f 6d 70 61 72 65 28 61 72 67 76 5b 69  teCompare(argv[i
05c0: 5d 2c 20 7a 42 65 73 74 29 3e 30 20 29 7b 0a 20  ], zBest)>0 ){. 
05d0: 20 20 20 20 20 7a 42 65 73 74 20 3d 20 61 72 67       zBest = arg
05e0: 76 5b 69 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  v[i];.    }.  }.
05f0: 20 20 73 71 6c 69 74 65 5f 73 65 74 5f 72 65 73    sqlite_set_res
0600: 75 6c 74 5f 73 74 72 69 6e 67 28 63 6f 6e 74 65  ult_string(conte
0610: 78 74 2c 20 7a 42 65 73 74 2c 20 2d 31 29 3b 0a  xt, zBest, -1);.
0620: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
0630: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6c  ntation of the l
0640: 65 6e 67 74 68 28 29 20 66 75 6e 63 74 69 6f 6e  ength() function
0650: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
0660: 6c 65 6e 67 74 68 46 75 6e 63 28 73 71 6c 69 74  lengthFunc(sqlit
0670: 65 5f 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c  e_func *context,
0680: 20 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74   int argc, const
0690: 20 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20   char **argv){. 
06a0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a   const char *z;.
06b0: 20 20 69 6e 74 20 6c 65 6e 3b 0a 0a 20 20 61 73    int len;..  as
06c0: 73 65 72 74 28 20 61 72 67 63 3d 3d 31 20 29 3b  sert( argc==1 );
06d0: 0a 20 20 7a 20 3d 20 61 72 67 76 5b 30 5d 3b 0a  .  z = argv[0];.
06e0: 20 20 69 66 28 20 7a 3d 3d 30 20 29 20 72 65 74    if( z==0 ) ret
06f0: 75 72 6e 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  urn;.#ifdef SQLI
0700: 54 45 5f 55 54 46 38 0a 20 20 66 6f 72 28 6c 65  TE_UTF8.  for(le
0710: 6e 3d 30 3b 20 2a 7a 3b 20 7a 2b 2b 29 7b 20 69  n=0; *z; z++){ i
0720: 66 28 20 28 30 78 63 30 26 2a 7a 29 21 3d 30 78  f( (0xc0&*z)!=0x
0730: 38 30 20 29 20 6c 65 6e 2b 2b 3b 20 7d 0a 23 65  80 ) len++; }.#e
0740: 6c 73 65 0a 20 20 6c 65 6e 20 3d 20 73 74 72 6c  lse.  len = strl
0750: 65 6e 28 7a 29 3b 0a 23 65 6e 64 69 66 0a 20 20  en(z);.#endif.  
0760: 73 71 6c 69 74 65 5f 73 65 74 5f 72 65 73 75 6c  sqlite_set_resul
0770: 74 5f 69 6e 74 28 63 6f 6e 74 65 78 74 2c 20 6c  t_int(context, l
0780: 65 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  en);.}../*.** Im
0790: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
07a0: 74 68 65 20 61 62 73 28 29 20 66 75 6e 63 74 69  the abs() functi
07b0: 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  on.*/.static voi
07c0: 64 20 61 62 73 46 75 6e 63 28 73 71 6c 69 74 65  d absFunc(sqlite
07d0: 5f 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20  _func *context, 
07e0: 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74 20  int argc, const 
07f0: 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20  char **argv){.  
0800: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20  const char *z;. 
0810: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 31   assert( argc==1
0820: 20 29 3b 0a 20 20 7a 20 3d 20 61 72 67 76 5b 30   );.  z = argv[0
0830: 5d 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29 20  ];.  if( z==0 ) 
0840: 72 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 7a 5b  return;.  if( z[
0850: 30 5d 3d 3d 27 2d 27 20 26 26 20 69 73 64 69 67  0]=='-' && isdig
0860: 69 74 28 7a 5b 31 5d 29 20 29 20 7a 2b 2b 3b 0a  it(z[1]) ) z++;.
0870: 20 20 73 71 6c 69 74 65 5f 73 65 74 5f 72 65 73    sqlite_set_res
0880: 75 6c 74 5f 73 74 72 69 6e 67 28 63 6f 6e 74 65  ult_string(conte
0890: 78 74 2c 20 7a 2c 20 2d 31 29 3b 0a 7d 0a 0a 2f  xt, z, -1);.}../
08a0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
08b0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 75 62 73 74  ion of the subst
08c0: 72 28 29 20 66 75 6e 63 74 69 6f 6e 0a 2a 2f 0a  r() function.*/.
08d0: 73 74 61 74 69 63 20 76 6f 69 64 20 73 75 62 73  static void subs
08e0: 74 72 46 75 6e 63 28 73 71 6c 69 74 65 5f 66 75  trFunc(sqlite_fu
08f0: 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74  nc *context, int
0900: 20 61 72 67 63 2c 20 63 6f 6e 73 74 20 63 68 61   argc, const cha
0910: 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20 63 6f 6e  r **argv){.  con
0920: 73 74 20 63 68 61 72 20 2a 7a 3b 0a 23 69 66 64  st char *z;.#ifd
0930: 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38 0a 20  ef SQLITE_UTF8. 
0940: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 32 3b   const char *z2;
0950: 0a 20 20 69 6e 74 20 69 3b 0a 23 65 6e 64 69 66  .  int i;.#endif
0960: 0a 20 20 69 6e 74 20 70 31 2c 20 70 32 2c 20 6c  .  int p1, p2, l
0970: 65 6e 3b 0a 20 20 61 73 73 65 72 74 28 20 61 72  en;.  assert( ar
0980: 67 63 3d 3d 33 20 29 3b 0a 20 20 7a 20 3d 20 61  gc==3 );.  z = a
0990: 72 67 76 5b 30 5d 3b 0a 20 20 69 66 28 20 7a 3d  rgv[0];.  if( z=
09a0: 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 70  =0 ) return;.  p
09b0: 31 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 31 5d  1 = atoi(argv[1]
09c0: 3f 61 72 67 76 5b 31 5d 3a 30 29 3b 0a 20 20 70  ?argv[1]:0);.  p
09d0: 32 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 32 5d  2 = atoi(argv[2]
09e0: 3f 61 72 67 76 5b 32 5d 3a 30 29 3b 0a 23 69 66  ?argv[2]:0);.#if
09f0: 64 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38 0a  def SQLITE_UTF8.
0a00: 20 20 66 6f 72 28 6c 65 6e 3d 30 2c 20 7a 32 3d    for(len=0, z2=
0a10: 7a 3b 20 2a 7a 32 3b 20 7a 32 2b 2b 29 7b 20 69  z; *z2; z2++){ i
0a20: 66 28 20 28 30 78 63 30 26 2a 7a 32 29 21 3d 30  f( (0xc0&*z2)!=0
0a30: 78 38 30 20 29 20 6c 65 6e 2b 2b 3b 20 7d 0a 23  x80 ) len++; }.#
0a40: 65 6c 73 65 0a 20 20 6c 65 6e 20 3d 20 73 74 72  else.  len = str
0a50: 6c 65 6e 28 7a 29 3b 0a 23 65 6e 64 69 66 0a 20  len(z);.#endif. 
0a60: 20 69 66 28 20 70 31 3c 30 20 29 7b 0a 20 20 20   if( p1<0 ){.   
0a70: 20 70 31 20 2b 3d 20 6c 65 6e 3b 0a 20 20 20 20   p1 += len;.    
0a80: 69 66 28 20 70 31 3c 30 20 29 7b 0a 20 20 20 20  if( p1<0 ){.    
0a90: 20 20 70 32 20 2b 3d 20 70 31 3b 0a 20 20 20 20    p2 += p1;.    
0aa0: 20 20 70 31 20 3d 20 30 3b 0a 20 20 20 20 7d 0a    p1 = 0;.    }.
0ab0: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 31 3e 30    }else if( p1>0
0ac0: 20 29 7b 0a 20 20 20 20 70 31 2d 2d 3b 0a 20 20   ){.    p1--;.  
0ad0: 7d 0a 20 20 69 66 28 20 70 31 2b 70 32 3e 6c 65  }.  if( p1+p2>le
0ae0: 6e 20 29 7b 0a 20 20 20 20 70 32 20 3d 20 6c 65  n ){.    p2 = le
0af0: 6e 2d 70 31 3b 0a 20 20 7d 0a 23 69 66 64 65 66  n-p1;.  }.#ifdef
0b00: 20 53 51 4c 49 54 45 5f 55 54 46 38 0a 20 20 66   SQLITE_UTF8.  f
0b10: 6f 72 28 69 3d 30 3b 20 69 3c 70 31 3b 20 69 2b  or(i=0; i<p1; i+
0b20: 2b 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20  +){.    assert( 
0b30: 7a 5b 69 5d 20 29 3b 0a 20 20 20 20 69 66 28 20  z[i] );.    if( 
0b40: 28 7a 5b 69 5d 26 30 78 63 30 29 3d 3d 30 78 38  (z[i]&0xc0)==0x8
0b50: 30 20 29 20 70 31 2b 2b 3b 0a 20 20 7d 0a 20 20  0 ) p1++;.  }.  
0b60: 77 68 69 6c 65 28 20 7a 5b 69 5d 20 26 26 20 28  while( z[i] && (
0b70: 7a 5b 69 5d 26 30 78 63 30 29 3d 3d 30 78 38 30  z[i]&0xc0)==0x80
0b80: 20 29 7b 20 69 2b 2b 3b 20 70 31 2b 2b 3b 20 7d   ){ i++; p1++; }
0b90: 0a 20 20 66 6f 72 28 3b 20 69 3c 70 31 2b 70 32  .  for(; i<p1+p2
0ba0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 61 73 73 65  ; i++){.    asse
0bb0: 72 74 28 20 7a 5b 69 5d 20 29 3b 0a 20 20 20 20  rt( z[i] );.    
0bc0: 69 66 28 20 28 7a 5b 69 5d 26 30 78 63 30 29 3d  if( (z[i]&0xc0)=
0bd0: 3d 30 78 38 30 20 29 20 70 32 2b 2b 3b 0a 20 20  =0x80 ) p2++;.  
0be0: 7d 0a 20 20 77 68 69 6c 65 28 20 7a 5b 69 5d 20  }.  while( z[i] 
0bf0: 26 26 20 28 7a 5b 69 5d 26 30 78 63 30 29 3d 3d  && (z[i]&0xc0)==
0c00: 30 78 38 30 20 29 7b 20 69 2b 2b 3b 20 70 32 2b  0x80 ){ i++; p2+
0c10: 2b 3b 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66  +; }.#endif.  if
0c20: 28 20 70 32 3c 30 20 29 20 70 32 20 3d 20 30 3b  ( p2<0 ) p2 = 0;
0c30: 0a 20 20 73 71 6c 69 74 65 5f 73 65 74 5f 72 65  .  sqlite_set_re
0c40: 73 75 6c 74 5f 73 74 72 69 6e 67 28 63 6f 6e 74  sult_string(cont
0c50: 65 78 74 2c 20 26 7a 5b 70 31 5d 2c 20 70 32 29  ext, &z[p1], p2)
0c60: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  ;.}../*.** Imple
0c70: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
0c80: 20 72 6f 75 6e 64 28 29 20 66 75 6e 63 74 69 6f   round() functio
0c90: 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  n.*/.static void
0ca0: 20 72 6f 75 6e 64 46 75 6e 63 28 73 71 6c 69 74   roundFunc(sqlit
0cb0: 65 5f 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c  e_func *context,
0cc0: 20 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74   int argc, const
0cd0: 20 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20   char **argv){. 
0ce0: 20 69 6e 74 20 6e 3b 0a 20 20 64 6f 75 62 6c 65   int n;.  double
0cf0: 20 72 3b 0a 20 20 63 68 61 72 20 7a 42 75 66 5b   r;.  char zBuf[
0d00: 31 30 30 5d 3b 0a 20 20 61 73 73 65 72 74 28 20  100];.  assert( 
0d10: 61 72 67 63 3d 3d 31 20 7c 7c 20 61 72 67 63 3d  argc==1 || argc=
0d20: 3d 32 20 29 3b 0a 20 20 69 66 28 20 61 72 67 76  =2 );.  if( argv
0d30: 5b 30 5d 3d 3d 30 20 7c 7c 20 28 61 72 67 63 3d  [0]==0 || (argc=
0d40: 3d 32 20 26 26 20 61 72 67 76 5b 31 5d 3d 3d 30  =2 && argv[1]==0
0d50: 29 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 6e 20  ) ) return;.  n 
0d60: 3d 20 61 72 67 63 3d 3d 32 20 3f 20 61 74 6f 69  = argc==2 ? atoi
0d70: 28 61 72 67 76 5b 31 5d 29 20 3a 20 30 3b 0a 20  (argv[1]) : 0;. 
0d80: 20 69 66 28 20 6e 3e 33 30 20 29 20 6e 20 3d 20   if( n>30 ) n = 
0d90: 33 30 3b 0a 20 20 69 66 28 20 6e 3c 30 20 29 20  30;.  if( n<0 ) 
0da0: 6e 20 3d 20 30 3b 0a 20 20 72 20 3d 20 61 74 6f  n = 0;.  r = ato
0db0: 66 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 73 70  f(argv[0]);.  sp
0dc0: 72 69 6e 74 66 28 7a 42 75 66 2c 22 25 2e 2a 66  rintf(zBuf,"%.*f
0dd0: 22 2c 6e 2c 72 29 3b 0a 20 20 73 71 6c 69 74 65  ",n,r);.  sqlite
0de0: 5f 73 65 74 5f 72 65 73 75 6c 74 5f 73 74 72 69  _set_result_stri
0df0: 6e 67 28 63 6f 6e 74 65 78 74 2c 20 7a 42 75 66  ng(context, zBuf
0e00: 2c 20 2d 31 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  , -1);.}../*.** 
0e10: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
0e20: 66 20 74 68 65 20 75 70 70 65 72 28 29 20 61 6e  f the upper() an
0e30: 64 20 6c 6f 77 65 72 28 29 20 53 51 4c 20 66 75  d lower() SQL fu
0e40: 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 61 74  nctions..*/.stat
0e50: 69 63 20 76 6f 69 64 20 75 70 70 65 72 46 75 6e  ic void upperFun
0e60: 63 28 73 71 6c 69 74 65 5f 66 75 6e 63 20 2a 63  c(sqlite_func *c
0e70: 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61 72 67 63  ontext, int argc
0e80: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 61  , const char **a
0e90: 72 67 76 29 7b 0a 20 20 63 68 61 72 20 2a 7a 3b  rgv){.  char *z;
0ea0: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28 20  .  int i;.  if( 
0eb0: 61 72 67 63 3c 31 20 7c 7c 20 61 72 67 76 5b 30  argc<1 || argv[0
0ec0: 5d 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  ]==0 ) return;. 
0ed0: 20 7a 20 3d 20 73 71 6c 69 74 65 5f 73 65 74 5f   z = sqlite_set_
0ee0: 72 65 73 75 6c 74 5f 73 74 72 69 6e 67 28 63 6f  result_string(co
0ef0: 6e 74 65 78 74 2c 20 61 72 67 76 5b 30 5d 2c 20  ntext, argv[0], 
0f00: 2d 31 29 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20  -1);.  if( z==0 
0f10: 29 20 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28  ) return;.  for(
0f20: 69 3d 30 3b 20 7a 5b 69 5d 3b 20 69 2b 2b 29 7b  i=0; z[i]; i++){
0f30: 0a 20 20 20 20 69 66 28 20 69 73 6c 6f 77 65 72  .    if( islower
0f40: 28 7a 5b 69 5d 29 20 29 20 7a 5b 69 5d 20 3d 20  (z[i]) ) z[i] = 
0f50: 74 6f 75 70 70 65 72 28 7a 5b 69 5d 29 3b 0a 20  toupper(z[i]);. 
0f60: 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64   }.}.static void
0f70: 20 6c 6f 77 65 72 46 75 6e 63 28 73 71 6c 69 74   lowerFunc(sqlit
0f80: 65 5f 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c  e_func *context,
0f90: 20 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74   int argc, const
0fa0: 20 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20   char **argv){. 
0fb0: 20 63 68 61 72 20 2a 7a 3b 0a 20 20 69 6e 74 20   char *z;.  int 
0fc0: 69 3b 0a 20 20 69 66 28 20 61 72 67 63 3c 31 20  i;.  if( argc<1 
0fd0: 7c 7c 20 61 72 67 76 5b 30 5d 3d 3d 30 20 29 20  || argv[0]==0 ) 
0fe0: 72 65 74 75 72 6e 3b 0a 20 20 7a 20 3d 20 73 71  return;.  z = sq
0ff0: 6c 69 74 65 5f 73 65 74 5f 72 65 73 75 6c 74 5f  lite_set_result_
1000: 73 74 72 69 6e 67 28 63 6f 6e 74 65 78 74 2c 20  string(context, 
1010: 61 72 67 76 5b 30 5d 2c 20 2d 31 29 3b 0a 20 20  argv[0], -1);.  
1020: 69 66 28 20 7a 3d 3d 30 20 29 20 72 65 74 75 72  if( z==0 ) retur
1030: 6e 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 7a 5b  n;.  for(i=0; z[
1040: 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66  i]; i++){.    if
1050: 28 20 69 73 75 70 70 65 72 28 7a 5b 69 5d 29 20  ( isupper(z[i]) 
1060: 29 20 7a 5b 69 5d 20 3d 20 74 6f 6c 6f 77 65 72  ) z[i] = tolower
1070: 28 7a 5b 69 5d 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  (z[i]);.  }.}../
1080: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
1090: 69 6f 6e 20 6f 66 20 74 68 65 20 49 46 4e 55 4c  ion of the IFNUL
10a0: 4c 28 29 2c 20 4e 56 4c 28 29 2c 20 61 6e 64 20  L(), NVL(), and 
10b0: 43 4f 41 4c 45 53 43 45 28 29 20 66 75 6e 63 74  COALESCE() funct
10c0: 69 6f 6e 73 2e 20 20 0a 2a 2a 20 41 6c 6c 20 74  ions.  .** All t
10d0: 68 72 65 65 20 64 6f 20 74 68 65 20 73 61 6d 65  hree do the same
10e0: 20 74 68 69 6e 67 2e 20 20 54 68 65 79 20 72 65   thing.  They re
10f0: 74 75 72 6e 20 74 68 65 20 66 69 72 73 74 20 61  turn the first a
1100: 72 67 75 6d 65 6e 74 0a 2a 2a 20 6e 6f 6e 2d 4e  rgument.** non-N
1110: 55 4c 4c 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f  ULL argument..*/
1120: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 69 66 6e  .static void ifn
1130: 75 6c 6c 46 75 6e 63 28 73 71 6c 69 74 65 5f 66  ullFunc(sqlite_f
1140: 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e  unc *context, in
1150: 74 20 61 72 67 63 2c 20 63 6f 6e 73 74 20 63 68  t argc, const ch
1160: 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20 69 6e  ar **argv){.  in
1170: 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20  t i;.  for(i=0; 
1180: 69 3c 61 72 67 63 3b 20 69 2b 2b 29 7b 0a 20 20  i<argc; i++){.  
1190: 20 20 69 66 28 20 61 72 67 76 5b 69 5d 20 29 7b    if( argv[i] ){
11a0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 5f 73 65  .      sqlite_se
11b0: 74 5f 72 65 73 75 6c 74 5f 73 74 72 69 6e 67 28  t_result_string(
11c0: 63 6f 6e 74 65 78 74 2c 20 61 72 67 76 5b 69 5d  context, argv[i]
11d0: 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 62 72 65  , -1);.      bre
11e0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a  ak;.    }.  }.}.
11f0: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
1200: 61 74 69 6f 6e 20 6f 66 20 72 61 6e 64 6f 6d 28  ation of random(
1210: 29 2e 20 20 52 65 74 75 72 6e 20 61 20 72 61 6e  ).  Return a ran
1220: 64 6f 6d 20 69 6e 74 65 67 65 72 2e 20 20 0a 2a  dom integer.  .*
1230: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 61  /.static void ra
1240: 6e 64 6f 6d 46 75 6e 63 28 73 71 6c 69 74 65 5f  ndomFunc(sqlite_
1250: 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69  func *context, i
1260: 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74 20 63  nt argc, const c
1270: 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20 73  har **argv){.  s
1280: 71 6c 69 74 65 5f 73 65 74 5f 72 65 73 75 6c 74  qlite_set_result
1290: 5f 69 6e 74 28 63 6f 6e 74 65 78 74 2c 20 73 71  _int(context, sq
12a0: 6c 69 74 65 52 61 6e 64 6f 6d 49 6e 74 65 67 65  liteRandomIntege
12b0: 72 28 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  r());.}../*.** 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 6c 61 73 74 5f 69 6e 73 65 72 74   the last_insert
12e0: 5f 72 6f 77 69 64 28 29 20 53 51 4c 20 66 75 6e  _rowid() SQL fun
12f0: 63 74 69 6f 6e 2e 20 20 54 68 65 20 72 65 74 75  ction.  The retu
1300: 72 6e 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20 74  rn.** value is t
1310: 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20 73  he same as the s
1320: 71 6c 69 74 65 5f 6c 61 73 74 5f 69 6e 73 65 72  qlite_last_inser
1330: 74 5f 72 6f 77 69 64 28 29 20 41 50 49 20 66 75  t_rowid() API fu
1340: 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69  nction..*/.stati
1350: 63 20 76 6f 69 64 20 6c 61 73 74 5f 69 6e 73 65  c void last_inse
1360: 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 65 5f  rt_rowid(sqlite_
1370: 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69  func *context, i
1380: 6e 74 20 61 72 67 2c 20 63 6f 6e 73 74 20 63 68  nt arg, const ch
1390: 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20 73 71  ar **argv){.  sq
13a0: 6c 69 74 65 20 2a 64 62 20 3d 20 73 71 6c 69 74  lite *db = sqlit
13b0: 65 5f 75 73 65 72 5f 64 61 74 61 28 63 6f 6e 74  e_user_data(cont
13c0: 65 78 74 29 3b 0a 20 20 73 71 6c 69 74 65 5f 73  ext);.  sqlite_s
13d0: 65 74 5f 72 65 73 75 6c 74 5f 69 6e 74 28 63 6f  et_result_int(co
13e0: 6e 74 65 78 74 2c 20 73 71 6c 69 74 65 5f 6c 61  ntext, sqlite_la
13f0: 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28  st_insert_rowid(
1400: 64 62 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  db));.}../*.** I
1410: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
1420: 20 74 68 65 20 6c 69 6b 65 28 29 20 53 51 4c 20   the like() SQL 
1430: 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 20  function.  This 
1440: 66 75 6e 63 74 69 6f 6e 20 69 6d 70 6c 65 6d 65  function impleme
1450: 6e 74 73 0a 2a 2a 20 74 68 65 20 62 75 69 6c 64  nts.** the build
1460: 2d 69 6e 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  -in LIKE operato
1470: 72 2e 20 20 54 68 65 20 66 69 72 73 74 20 61 72  r.  The first ar
1480: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75  gument to the fu
1490: 6e 63 74 69 6f 6e 20 69 73 20 74 68 65 0a 2a 2a  nction is the.**
14a0: 20 73 74 72 69 6e 67 20 61 6e 64 20 74 68 65 20   string and the 
14b0: 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20  second argument 
14c0: 69 73 20 74 68 65 20 70 61 74 74 65 72 6e 2e 20  is the pattern. 
14d0: 20 53 6f 2c 20 74 68 65 20 53 51 4c 20 73 74 61   So, the SQL sta
14e0: 74 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a 20 20  tements:.**.**  
14f0: 20 20 20 20 20 41 20 4c 49 4b 45 20 42 0a 2a 2a       A LIKE B.**
1500: 0a 2a 2a 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74  .** is implement
1510: 65 64 20 61 73 20 6c 69 6b 65 28 41 2c 42 29 2e  ed as like(A,B).
1520: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
1530: 6c 69 6b 65 46 75 6e 63 28 73 71 6c 69 74 65 5f  likeFunc(sqlite_
1540: 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69  func *context, i
1550: 6e 74 20 61 72 67 2c 20 63 6f 6e 73 74 20 63 68  nt arg, const ch
1560: 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20 69 66  ar **argv){.  if
1570: 28 20 61 72 67 76 5b 30 5d 3d 3d 30 20 7c 7c 20  ( argv[0]==0 || 
1580: 61 72 67 76 5b 31 5d 3d 3d 30 20 29 20 72 65 74  argv[1]==0 ) ret
1590: 75 72 6e 3b 0a 20 20 73 71 6c 69 74 65 5f 73 65  urn;.  sqlite_se
15a0: 74 5f 72 65 73 75 6c 74 5f 69 6e 74 28 63 6f 6e  t_result_int(con
15b0: 74 65 78 74 2c 20 73 71 6c 69 74 65 4c 69 6b 65  text, sqliteLike
15c0: 43 6f 6d 70 61 72 65 28 61 72 67 76 5b 30 5d 2c  Compare(argv[0],
15d0: 20 61 72 67 76 5b 31 5d 29 29 3b 0a 7d 0a 0a 2f   argv[1]));.}../
15e0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
15f0: 69 6f 6e 20 6f 66 20 74 68 65 20 67 6c 6f 62 28  ion of the glob(
1600: 29 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 2e 20  ) SQL function. 
1610: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
1620: 6d 70 6c 65 6d 65 6e 74 73 0a 2a 2a 20 74 68 65  mplements.** the
1630: 20 62 75 69 6c 64 2d 69 6e 20 47 4c 4f 42 20 6f   build-in GLOB o
1640: 70 65 72 61 74 6f 72 2e 20 20 54 68 65 20 66 69  perator.  The fi
1650: 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  rst argument to 
1660: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  the function is 
1670: 74 68 65 0a 2a 2a 20 73 74 72 69 6e 67 20 61 6e  the.** string an
1680: 64 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67  d the second arg
1690: 75 6d 65 6e 74 20 69 73 20 74 68 65 20 70 61 74  ument is the pat
16a0: 74 65 72 6e 2e 20 20 53 6f 2c 20 74 68 65 20 53  tern.  So, the S
16b0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 3a 0a 2a  QL statements:.*
16c0: 2a 0a 2a 2a 20 20 20 20 20 20 20 41 20 47 4c 4f  *.**       A GLO
16d0: 42 20 42 0a 2a 2a 0a 2a 2a 20 69 73 20 69 6d 70  B B.**.** is imp
16e0: 6c 65 6d 65 6e 74 65 64 20 61 73 20 67 6c 6f 62  lemented as glob
16f0: 28 41 2c 42 29 2e 0a 2a 2f 0a 73 74 61 74 69 63  (A,B)..*/.static
1700: 20 76 6f 69 64 20 67 6c 6f 62 46 75 6e 63 28 73   void globFunc(s
1710: 71 6c 69 74 65 5f 66 75 6e 63 20 2a 63 6f 6e 74  qlite_func *cont
1720: 65 78 74 2c 20 69 6e 74 20 61 72 67 2c 20 63 6f  ext, int arg, co
1730: 6e 73 74 20 63 68 61 72 20 2a 2a 61 72 67 76 29  nst char **argv)
1740: 7b 0a 20 20 69 66 28 20 61 72 67 76 5b 30 5d 3d  {.  if( argv[0]=
1750: 3d 30 20 7c 7c 20 61 72 67 76 5b 31 5d 3d 3d 30  =0 || argv[1]==0
1760: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 73 71 6c   ) return;.  sql
1770: 69 74 65 5f 73 65 74 5f 72 65 73 75 6c 74 5f 69  ite_set_result_i
1780: 6e 74 28 63 6f 6e 74 65 78 74 2c 20 73 71 6c 69  nt(context, sqli
1790: 74 65 47 6c 6f 62 43 6f 6d 70 61 72 65 28 61 72  teGlobCompare(ar
17a0: 67 76 5b 30 5d 2c 20 61 72 67 76 5b 31 5d 29 29  gv[0], argv[1]))
17b0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  ;.}../*.** Imple
17c0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
17d0: 20 4e 55 4c 4c 49 46 28 78 2c 79 29 20 66 75 6e   NULLIF(x,y) fun
17e0: 63 74 69 6f 6e 2e 20 20 54 68 65 20 72 65 73 75  ction.  The resu
17f0: 6c 74 20 69 73 20 74 68 65 20 66 69 72 73 74 0a  lt is the first.
1800: 2a 2a 20 61 72 67 75 6d 65 6e 74 20 69 66 20 74  ** argument if t
1810: 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65  he arguments are
1820: 20 64 69 66 66 65 72 65 6e 74 2e 20 20 54 68 65   different.  The
1830: 20 72 65 73 75 6c 74 20 69 73 20 4e 55 4c 4c 20   result is NULL 
1840: 69 66 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65  if the.** argume
1850: 6e 74 73 20 61 72 65 20 65 71 75 61 6c 20 74 6f  nts are equal to
1860: 20 65 61 63 68 20 6f 74 68 65 72 2e 0a 2a 2f 0a   each other..*/.
1870: 73 74 61 74 69 63 20 76 6f 69 64 20 6e 75 6c 6c  static void null
1880: 69 66 46 75 6e 63 28 73 71 6c 69 74 65 5f 66 75  ifFunc(sqlite_fu
1890: 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20 69 6e 74  nc *context, int
18a0: 20 61 72 67 63 2c 20 63 6f 6e 73 74 20 63 68 61   argc, const cha
18b0: 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20 69 66 28  r **argv){.  if(
18c0: 20 61 72 67 76 5b 30 5d 21 3d 30 20 26 26 20 73   argv[0]!=0 && s
18d0: 71 6c 69 74 65 43 6f 6d 70 61 72 65 28 61 72 67  qliteCompare(arg
18e0: 76 5b 30 5d 2c 61 72 67 76 5b 31 5d 29 21 3d 30  v[0],argv[1])!=0
18f0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f 73   ){.    sqlite_s
1900: 65 74 5f 72 65 73 75 6c 74 5f 73 74 72 69 6e 67  et_result_string
1910: 28 63 6f 6e 74 65 78 74 2c 20 61 72 67 76 5b 30  (context, argv[0
1920: 5d 2c 20 2d 31 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  ], -1);.  }.}../
1930: 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65  *.** An instance
1940: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e   of the followin
1950: 67 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64  g structure hold
1960: 73 20 74 68 65 20 63 6f 6e 74 65 78 74 20 6f 66  s the context of
1970: 20 61 0a 2a 2a 20 73 75 6d 28 29 20 6f 72 20 61   a.** sum() or a
1980: 76 67 28 29 20 61 67 67 72 65 67 61 74 65 20 63  vg() aggregate c
1990: 6f 6d 70 75 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 74  omputation..*/.t
19a0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 75  ypedef struct Su
19b0: 6d 43 74 78 20 53 75 6d 43 74 78 3b 0a 73 74 72  mCtx SumCtx;.str
19c0: 75 63 74 20 53 75 6d 43 74 78 20 7b 0a 20 20 64  uct SumCtx {.  d
19d0: 6f 75 62 6c 65 20 73 75 6d 3b 20 20 20 20 20 2f  ouble sum;     /
19e0: 2a 20 53 75 6d 20 6f 66 20 74 65 72 6d 73 20 2a  * Sum of terms *
19f0: 2f 0a 20 20 69 6e 74 20 63 6e 74 3b 20 20 20 20  /.  int cnt;    
1a00: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
1a10: 20 65 6c 65 6d 65 6e 74 73 20 73 75 6d 6d 65 64   elements summed
1a20: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f   */.};../*.** Ro
1a30: 75 74 69 6e 65 73 20 75 73 65 64 20 74 6f 20 63  utines used to c
1a40: 6f 6d 70 75 74 65 20 74 68 65 20 73 75 6d 20 6f  ompute the sum o
1a50: 72 20 61 76 65 72 61 67 65 2e 0a 2a 2f 0a 73 74  r average..*/.st
1a60: 61 74 69 63 20 76 6f 69 64 20 73 75 6d 53 74 65  atic void sumSte
1a70: 70 28 73 71 6c 69 74 65 5f 66 75 6e 63 20 2a 63  p(sqlite_func *c
1a80: 6f 6e 74 65 78 74 2c 20 69 6e 74 20 61 72 67 63  ontext, int argc
1a90: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 61  , const char **a
1aa0: 72 67 76 29 7b 0a 20 20 53 75 6d 43 74 78 20 2a  rgv){.  SumCtx *
1ab0: 70 3b 0a 20 20 69 66 28 20 61 72 67 63 3c 31 20  p;.  if( argc<1 
1ac0: 29 20 72 65 74 75 72 6e 3b 0a 20 20 70 20 3d 20  ) return;.  p = 
1ad0: 73 71 6c 69 74 65 5f 61 67 67 72 65 67 61 74 65  sqlite_aggregate
1ae0: 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74  _context(context
1af0: 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20  , sizeof(*p));. 
1b00: 20 69 66 28 20 70 20 26 26 20 61 72 67 76 5b 30   if( p && argv[0
1b10: 5d 20 29 7b 0a 20 20 20 20 70 2d 3e 73 75 6d 20  ] ){.    p->sum 
1b20: 2b 3d 20 61 74 6f 66 28 61 72 67 76 5b 30 5d 29  += atof(argv[0])
1b30: 3b 0a 20 20 20 20 70 2d 3e 63 6e 74 2b 2b 3b 0a  ;.    p->cnt++;.
1b40: 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69    }.}.static voi
1b50: 64 20 73 75 6d 46 69 6e 61 6c 69 7a 65 28 73 71  d sumFinalize(sq
1b60: 6c 69 74 65 5f 66 75 6e 63 20 2a 63 6f 6e 74 65  lite_func *conte
1b70: 78 74 29 7b 0a 20 20 53 75 6d 43 74 78 20 2a 70  xt){.  SumCtx *p
1b80: 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 5f 61  ;.  p = sqlite_a
1b90: 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78 74  ggregate_context
1ba0: 28 63 6f 6e 74 65 78 74 2c 20 73 69 7a 65 6f 66  (context, sizeof
1bb0: 28 2a 70 29 29 3b 0a 20 20 73 71 6c 69 74 65 5f  (*p));.  sqlite_
1bc0: 73 65 74 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c  set_result_doubl
1bd0: 65 28 63 6f 6e 74 65 78 74 2c 20 70 20 3f 20 70  e(context, p ? p
1be0: 2d 3e 73 75 6d 20 3a 20 30 2e 30 29 3b 0a 7d 0a  ->sum : 0.0);.}.
1bf0: 73 74 61 74 69 63 20 76 6f 69 64 20 61 76 67 46  static void avgF
1c00: 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 5f 66  inalize(sqlite_f
1c10: 75 6e 63 20 2a 63 6f 6e 74 65 78 74 29 7b 0a 20  unc *context){. 
1c20: 20 53 75 6d 43 74 78 20 2a 70 3b 0a 20 20 70 20   SumCtx *p;.  p 
1c30: 3d 20 73 71 6c 69 74 65 5f 61 67 67 72 65 67 61  = sqlite_aggrega
1c40: 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65  te_context(conte
1c50: 78 74 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b  xt, sizeof(*p));
1c60: 0a 20 20 69 66 28 20 70 20 26 26 20 70 2d 3e 63  .  if( p && p->c
1c70: 6e 74 3e 30 20 29 7b 0a 20 20 20 20 73 71 6c 69  nt>0 ){.    sqli
1c80: 74 65 5f 73 65 74 5f 72 65 73 75 6c 74 5f 64 6f  te_set_result_do
1c90: 75 62 6c 65 28 63 6f 6e 74 65 78 74 2c 20 70 2d  uble(context, p-
1ca0: 3e 73 75 6d 2f 28 64 6f 75 62 6c 65 29 70 2d 3e  >sum/(double)p->
1cb0: 63 6e 74 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  cnt);.  }.}../*.
1cc0: 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f  ** An instance o
1cd0: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  f the following 
1ce0: 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 73 20  structure holds 
1cf0: 74 68 65 20 63 6f 6e 74 65 78 74 20 6f 66 20 61  the context of a
1d00: 0a 2a 2a 20 76 61 72 69 61 6e 63 65 20 6f 72 20  .** variance or 
1d10: 73 74 61 6e 64 61 72 64 20 64 65 76 69 61 74 69  standard deviati
1d20: 6f 6e 20 63 6f 6d 70 75 74 61 74 69 6f 6e 2e 0a  on computation..
1d30: 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  */.typedef struc
1d40: 74 20 53 74 64 44 65 76 43 74 78 20 53 74 64 44  t StdDevCtx StdD
1d50: 65 76 43 74 78 3b 0a 73 74 72 75 63 74 20 53 74  evCtx;.struct St
1d60: 64 44 65 76 43 74 78 20 7b 0a 20 20 64 6f 75 62  dDevCtx {.  doub
1d70: 6c 65 20 73 75 6d 3b 20 20 20 20 20 2f 2a 20 53  le sum;     /* S
1d80: 75 6d 20 6f 66 20 74 65 72 6d 73 20 2a 2f 0a 20  um of terms */. 
1d90: 20 64 6f 75 62 6c 65 20 73 75 6d 32 3b 20 20 20   double sum2;   
1da0: 20 2f 2a 20 53 75 6d 20 6f 66 20 74 68 65 20 73   /* Sum of the s
1db0: 71 75 61 72 65 73 20 6f 66 20 74 65 72 6d 73 20  quares of terms 
1dc0: 2a 2f 0a 20 20 69 6e 74 20 63 6e 74 3b 20 20 20  */.  int cnt;   
1dd0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
1de0: 66 20 74 65 72 6d 73 20 63 6f 75 6e 74 65 64 20  f terms counted 
1df0: 2a 2f 0a 7d 3b 0a 0a 23 69 66 20 30 20 20 20 2f  */.};..#if 0   /
1e00: 2a 20 4f 6d 69 74 20 62 65 63 61 75 73 65 20 6d  * Omit because m
1e10: 61 74 68 20 6c 69 62 72 61 72 79 20 69 73 20 72  ath library is r
1e20: 65 71 75 69 72 65 64 20 2a 2f 0a 2f 2a 0a 2a 2a  equired */./*.**
1e30: 20 52 6f 75 74 69 6e 65 73 20 75 73 65 64 20 74   Routines used t
1e40: 6f 20 63 6f 6d 70 75 74 65 20 74 68 65 20 73 74  o compute the st
1e50: 61 6e 64 61 72 64 20 64 65 76 69 61 74 69 6f 6e  andard deviation
1e60: 20 61 73 20 61 6e 20 61 67 67 72 65 67 61 74 65   as an aggregate
1e70: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
1e80: 20 73 74 64 44 65 76 53 74 65 70 28 73 71 6c 69   stdDevStep(sqli
1e90: 74 65 5f 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74  te_func *context
1ea0: 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73  , int argc, cons
1eb0: 74 20 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a  t char **argv){.
1ec0: 20 20 53 74 64 44 65 76 43 74 78 20 2a 70 3b 0a    StdDevCtx *p;.
1ed0: 20 20 64 6f 75 62 6c 65 20 78 3b 0a 20 20 69 66    double x;.  if
1ee0: 28 20 61 72 67 63 3c 31 20 29 20 72 65 74 75 72  ( argc<1 ) retur
1ef0: 6e 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 5f  n;.  p = sqlite_
1f00: 61 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78  aggregate_contex
1f10: 74 28 63 6f 6e 74 65 78 74 2c 20 73 69 7a 65 6f  t(context, sizeo
1f20: 66 28 2a 70 29 29 3b 0a 20 20 69 66 28 20 70 20  f(*p));.  if( p 
1f30: 26 26 20 61 72 67 76 5b 30 5d 20 29 7b 0a 20 20  && argv[0] ){.  
1f40: 20 20 78 20 3d 20 61 74 6f 66 28 61 72 67 76 5b    x = atof(argv[
1f50: 30 5d 29 3b 0a 20 20 20 20 70 2d 3e 73 75 6d 20  0]);.    p->sum 
1f60: 2b 3d 20 78 3b 0a 20 20 20 20 70 2d 3e 73 75 6d  += x;.    p->sum
1f70: 32 20 2b 3d 20 78 2a 78 3b 0a 20 20 20 20 70 2d  2 += x*x;.    p-
1f80: 3e 63 6e 74 2b 2b 3b 0a 20 20 7d 0a 7d 0a 73 74  >cnt++;.  }.}.st
1f90: 61 74 69 63 20 76 6f 69 64 20 73 74 64 44 65 76  atic void stdDev
1fa0: 46 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 5f  Finalize(sqlite_
1fb0: 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 29 7b 0a  func *context){.
1fc0: 20 20 64 6f 75 62 6c 65 20 72 4e 20 3d 20 73 71    double rN = sq
1fd0: 6c 69 74 65 5f 61 67 67 72 65 67 61 74 65 5f 63  lite_aggregate_c
1fe0: 6f 75 6e 74 28 63 6f 6e 74 65 78 74 29 3b 0a 20  ount(context);. 
1ff0: 20 53 74 64 44 65 76 43 74 78 20 2a 70 20 3d 20   StdDevCtx *p = 
2000: 73 71 6c 69 74 65 5f 61 67 67 72 65 67 61 74 65  sqlite_aggregate
2010: 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74  _context(context
2020: 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20  , sizeof(*p));. 
2030: 20 69 66 28 20 70 20 26 26 20 70 2d 3e 63 6e 74   if( p && p->cnt
2040: 3e 31 20 29 7b 0a 20 20 20 20 64 6f 75 62 6c 65  >1 ){.    double
2050: 20 72 43 6e 74 20 3d 20 63 6e 74 3b 0a 20 20 20   rCnt = cnt;.   
2060: 20 73 71 6c 69 74 65 5f 73 65 74 5f 72 65 73 75   sqlite_set_resu
2070: 6c 74 5f 64 6f 75 62 6c 65 28 63 6f 6e 74 65 78  lt_double(contex
2080: 74 2c 20 0a 20 20 20 20 20 20 20 73 71 72 74 28  t, .       sqrt(
2090: 28 70 2d 3e 73 75 6d 32 20 2d 20 70 2d 3e 73 75  (p->sum2 - p->su
20a0: 6d 2a 70 2d 3e 73 75 6d 2f 72 43 6e 74 29 2f 28  m*p->sum/rCnt)/(
20b0: 72 43 6e 74 2d 31 2e 30 29 29 29 3b 0a 20 20 7d  rCnt-1.0)));.  }
20c0: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  .}.#endif../*.**
20d0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73   The following s
20e0: 74 72 75 63 74 75 72 65 20 6b 65 65 70 73 20 74  tructure keeps t
20f0: 72 61 63 6b 20 6f 66 20 73 74 61 74 65 20 69 6e  rack of state in
2100: 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 20 74 68  formation for th
2110: 65 0a 2a 2a 20 63 6f 75 6e 74 28 29 20 61 67 67  e.** count() agg
2120: 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 2e  regate function.
2130: 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75  .*/.typedef stru
2140: 63 74 20 43 6f 75 6e 74 43 74 78 20 43 6f 75 6e  ct CountCtx Coun
2150: 74 43 74 78 3b 0a 73 74 72 75 63 74 20 43 6f 75  tCtx;.struct Cou
2160: 6e 74 43 74 78 20 7b 0a 20 20 69 6e 74 20 6e 3b  ntCtx {.  int n;
2170: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 69  .};../*.** Routi
2180: 6e 65 73 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74  nes to implement
2190: 20 74 68 65 20 63 6f 75 6e 74 28 29 20 61 67 67   the count() agg
21a0: 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 2e  regate function.
21b0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
21c0: 63 6f 75 6e 74 53 74 65 70 28 73 71 6c 69 74 65  countStep(sqlite
21d0: 5f 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20  _func *context, 
21e0: 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74 20  int argc, const 
21f0: 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20  char **argv){.  
2200: 43 6f 75 6e 74 43 74 78 20 2a 70 3b 0a 20 20 70  CountCtx *p;.  p
2210: 20 3d 20 73 71 6c 69 74 65 5f 61 67 67 72 65 67   = sqlite_aggreg
2220: 61 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74  ate_context(cont
2230: 65 78 74 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29  ext, sizeof(*p))
2240: 3b 0a 20 20 69 66 28 20 28 61 72 67 63 3d 3d 30  ;.  if( (argc==0
2250: 20 7c 7c 20 61 72 67 76 5b 30 5d 29 20 26 26 20   || argv[0]) && 
2260: 70 20 29 7b 0a 20 20 20 20 70 2d 3e 6e 2b 2b 3b  p ){.    p->n++;
2270: 0a 20 20 7d 0a 7d 20 20 20 0a 73 74 61 74 69 63  .  }.}   .static
2280: 20 76 6f 69 64 20 63 6f 75 6e 74 46 69 6e 61 6c   void countFinal
2290: 69 7a 65 28 73 71 6c 69 74 65 5f 66 75 6e 63 20  ize(sqlite_func 
22a0: 2a 63 6f 6e 74 65 78 74 29 7b 0a 20 20 43 6f 75  *context){.  Cou
22b0: 6e 74 43 74 78 20 2a 70 3b 0a 20 20 70 20 3d 20  ntCtx *p;.  p = 
22c0: 73 71 6c 69 74 65 5f 61 67 67 72 65 67 61 74 65  sqlite_aggregate
22d0: 5f 63 6f 6e 74 65 78 74 28 63 6f 6e 74 65 78 74  _context(context
22e0: 2c 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20  , sizeof(*p));. 
22f0: 20 73 71 6c 69 74 65 5f 73 65 74 5f 72 65 73 75   sqlite_set_resu
2300: 6c 74 5f 69 6e 74 28 63 6f 6e 74 65 78 74 2c 20  lt_int(context, 
2310: 70 20 3f 20 70 2d 3e 6e 20 3a 20 30 29 3b 0a 7d  p ? p->n : 0);.}
2320: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
2330: 63 74 69 6f 6e 20 74 72 61 63 6b 73 20 73 74 61  ction tracks sta
2340: 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66  te information f
2350: 6f 72 20 74 68 65 20 6d 69 6e 28 29 20 61 6e 64  or the min() and
2360: 20 6d 61 78 28 29 0a 2a 2a 20 61 67 67 72 65 67   max().** aggreg
2370: 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a  ate functions..*
2380: 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  /.typedef struct
2390: 20 4d 69 6e 4d 61 78 43 74 78 20 4d 69 6e 4d 61   MinMaxCtx MinMa
23a0: 78 43 74 78 3b 0a 73 74 72 75 63 74 20 4d 69 6e  xCtx;.struct Min
23b0: 4d 61 78 43 74 78 20 7b 0a 20 20 63 68 61 72 20  MaxCtx {.  char 
23c0: 2a 7a 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54  *z;         /* T
23d0: 68 65 20 62 65 73 74 20 73 6f 20 66 61 72 20 2a  he best so far *
23e0: 2f 0a 20 20 63 68 61 72 20 7a 42 75 66 5b 32 38  /.  char zBuf[28
23f0: 5d 3b 20 20 20 2f 2a 20 53 70 61 63 65 20 74 68  ];   /* Space th
2400: 61 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 66  at can be used f
2410: 6f 72 20 73 74 6f 72 61 67 65 20 2a 2f 0a 7d 3b  or storage */.};
2420: 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 69 6e 65 73  ../*.** Routines
2430: 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 6d 69   to implement mi
2440: 6e 28 29 20 61 6e 64 20 6d 61 78 28 29 20 61 67  n() and max() ag
2450: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
2460: 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  s..*/.static voi
2470: 64 20 6d 69 6e 53 74 65 70 28 73 71 6c 69 74 65  d minStep(sqlite
2480: 5f 66 75 6e 63 20 2a 63 6f 6e 74 65 78 74 2c 20  _func *context, 
2490: 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73 74 20  int argc, const 
24a0: 63 68 61 72 20 2a 2a 61 72 67 76 29 7b 0a 20 20  char **argv){.  
24b0: 4d 69 6e 4d 61 78 43 74 78 20 2a 70 3b 0a 20 20  MinMaxCtx *p;.  
24c0: 70 20 3d 20 73 71 6c 69 74 65 5f 61 67 67 72 65  p = sqlite_aggre
24d0: 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 63 6f 6e  gate_context(con
24e0: 74 65 78 74 2c 20 73 69 7a 65 6f 66 28 2a 70 29  text, sizeof(*p)
24f0: 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c  );.  if( p==0 ||
2500: 20 61 72 67 63 3c 31 20 7c 7c 20 61 72 67 76 5b   argc<1 || argv[
2510: 30 5d 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a  0]==0 ) return;.
2520: 20 20 69 66 28 20 73 71 6c 69 74 65 5f 61 67 67    if( sqlite_agg
2530: 72 65 67 61 74 65 5f 63 6f 75 6e 74 28 63 6f 6e  regate_count(con
2540: 74 65 78 74 29 3d 3d 31 20 7c 7c 20 73 71 6c 69  text)==1 || sqli
2550: 74 65 43 6f 6d 70 61 72 65 28 61 72 67 76 5b 30  teCompare(argv[0
2560: 5d 2c 70 2d 3e 7a 29 3c 30 20 29 7b 0a 20 20 20  ],p->z)<0 ){.   
2570: 20 69 6e 74 20 6c 65 6e 3b 0a 20 20 20 20 69 66   int len;.    if
2580: 28 20 70 2d 3e 7a 20 26 26 20 70 2d 3e 7a 21 3d  ( p->z && p->z!=
2590: 70 2d 3e 7a 42 75 66 20 29 7b 0a 20 20 20 20 20  p->zBuf ){.     
25a0: 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 7a   sqliteFree(p->z
25b0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6c 65 6e  );.    }.    len
25c0: 20 3d 20 73 74 72 6c 65 6e 28 61 72 67 76 5b 30   = strlen(argv[0
25d0: 5d 29 3b 0a 20 20 20 20 69 66 28 20 6c 65 6e 20  ]);.    if( len 
25e0: 3c 20 73 69 7a 65 6f 66 28 70 2d 3e 7a 42 75 66  < sizeof(p->zBuf
25f0: 29 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 7a 20  ) ){.      p->z 
2600: 3d 20 70 2d 3e 7a 42 75 66 3b 0a 20 20 20 20 7d  = p->zBuf;.    }
2610: 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 2d 3e 7a  else{.      p->z
2620: 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28   = sqliteMalloc(
2630: 20 6c 65 6e 2b 31 20 29 3b 0a 20 20 20 20 20 20   len+1 );.      
2640: 69 66 28 20 70 2d 3e 7a 3d 3d 30 20 29 20 72 65  if( p->z==0 ) re
2650: 74 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20  turn;.    }.    
2660: 73 74 72 63 70 79 28 70 2d 3e 7a 2c 20 61 72 67  strcpy(p->z, arg
2670: 76 5b 30 5d 29 3b 0a 20 20 7d 0a 7d 0a 73 74 61  v[0]);.  }.}.sta
2680: 74 69 63 20 76 6f 69 64 20 6d 61 78 53 74 65 70  tic void maxStep
2690: 28 73 71 6c 69 74 65 5f 66 75 6e 63 20 2a 63 6f  (sqlite_func *co
26a0: 6e 74 65 78 74 2c 20 69 6e 74 20 61 72 67 63 2c  ntext, int argc,
26b0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 61 72   const char **ar
26c0: 67 76 29 7b 0a 20 20 4d 69 6e 4d 61 78 43 74 78  gv){.  MinMaxCtx
26d0: 20 2a 70 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74   *p;.  p = sqlit
26e0: 65 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e 74  e_aggregate_cont
26f0: 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 73 69 7a  ext(context, siz
2700: 65 6f 66 28 2a 70 29 29 3b 0a 20 20 69 66 28 20  eof(*p));.  if( 
2710: 70 3d 3d 30 20 7c 7c 20 61 72 67 63 3c 31 20 7c  p==0 || argc<1 |
2720: 7c 20 61 72 67 76 5b 30 5d 3d 3d 30 20 29 20 72  | argv[0]==0 ) r
2730: 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 73 71 6c  eturn;.  if( sql
2740: 69 74 65 5f 61 67 67 72 65 67 61 74 65 5f 63 6f  ite_aggregate_co
2750: 75 6e 74 28 63 6f 6e 74 65 78 74 29 3d 3d 31 20  unt(context)==1 
2760: 7c 7c 20 73 71 6c 69 74 65 43 6f 6d 70 61 72 65  || sqliteCompare
2770: 28 61 72 67 76 5b 30 5d 2c 70 2d 3e 7a 29 3e 30  (argv[0],p->z)>0
2780: 20 29 7b 0a 20 20 20 20 69 6e 74 20 6c 65 6e 3b   ){.    int len;
2790: 0a 20 20 20 20 69 66 28 20 70 2d 3e 7a 20 26 26  .    if( p->z &&
27a0: 20 70 2d 3e 7a 21 3d 70 2d 3e 7a 42 75 66 20 29   p->z!=p->zBuf )
27b0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72  {.      sqliteFr
27c0: 65 65 28 70 2d 3e 7a 29 3b 0a 20 20 20 20 7d 0a  ee(p->z);.    }.
27d0: 20 20 20 20 6c 65 6e 20 3d 20 73 74 72 6c 65 6e      len = strlen
27e0: 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20 20 20 69  (argv[0]);.    i
27f0: 66 28 20 6c 65 6e 20 3c 20 73 69 7a 65 6f 66 28  f( len < sizeof(
2800: 70 2d 3e 7a 42 75 66 29 20 29 7b 0a 20 20 20 20  p->zBuf) ){.    
2810: 20 20 70 2d 3e 7a 20 3d 20 70 2d 3e 7a 42 75 66    p->z = p->zBuf
2820: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
2830: 20 20 20 70 2d 3e 7a 20 3d 20 73 71 6c 69 74 65     p->z = sqlite
2840: 4d 61 6c 6c 6f 63 28 20 6c 65 6e 2b 31 20 29 3b  Malloc( len+1 );
2850: 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e 7a 3d  .      if( p->z=
2860: 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 20  =0 ) return;.   
2870: 20 7d 0a 20 20 20 20 73 74 72 63 70 79 28 70 2d   }.    strcpy(p-
2880: 3e 7a 2c 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20  >z, argv[0]);.  
2890: 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20  }.}.static void 
28a0: 6d 69 6e 4d 61 78 46 69 6e 61 6c 69 7a 65 28 73  minMaxFinalize(s
28b0: 71 6c 69 74 65 5f 66 75 6e 63 20 2a 63 6f 6e 74  qlite_func *cont
28c0: 65 78 74 29 7b 0a 20 20 4d 69 6e 4d 61 78 43 74  ext){.  MinMaxCt
28d0: 78 20 2a 70 3b 0a 20 20 70 20 3d 20 73 71 6c 69  x *p;.  p = sqli
28e0: 74 65 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e  te_aggregate_con
28f0: 74 65 78 74 28 63 6f 6e 74 65 78 74 2c 20 73 69  text(context, si
2900: 7a 65 6f 66 28 2a 70 29 29 3b 0a 20 20 69 66 28  zeof(*p));.  if(
2910: 20 70 20 26 26 20 70 2d 3e 7a 20 29 7b 0a 20 20   p && p->z ){.  
2920: 20 20 73 71 6c 69 74 65 5f 73 65 74 5f 72 65 73    sqlite_set_res
2930: 75 6c 74 5f 73 74 72 69 6e 67 28 63 6f 6e 74 65  ult_string(conte
2940: 78 74 2c 20 70 2d 3e 7a 2c 20 73 74 72 6c 65 6e  xt, p->z, strlen
2950: 28 70 2d 3e 7a 29 29 3b 0a 20 20 7d 0a 20 20 69  (p->z));.  }.  i
2960: 66 28 20 70 20 26 26 20 70 2d 3e 7a 20 26 26 20  f( p && p->z && 
2970: 70 2d 3e 7a 21 3d 70 2d 3e 7a 42 75 66 20 29 7b  p->z!=p->zBuf ){
2980: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28  .    sqliteFree(
2990: 70 2d 3e 7a 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  p->z);.  }.}../*
29a0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
29b0: 6e 20 72 65 67 69 73 74 65 72 65 64 20 61 6c 6c  n registered all
29c0: 20 6f 66 20 74 68 65 20 61 62 6f 76 65 20 43 20   of the above C 
29d0: 66 75 6e 63 74 69 6f 6e 73 20 61 73 20 53 51 4c  functions as SQL
29e0: 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20  .** functions.  
29f0: 54 68 69 73 20 73 68 6f 75 6c 64 20 62 65 20 74  This should be t
2a00: 68 65 20 6f 6e 6c 79 20 72 6f 75 74 69 6e 65 20  he only routine 
2a10: 69 6e 20 74 68 69 73 20 66 69 6c 65 20 77 69 74  in this file wit
2a20: 68 0a 2a 2a 20 65 78 74 65 72 6e 61 6c 20 6c 69  h.** external li
2a30: 6e 6b 61 67 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73  nkage..*/.void s
2a40: 71 6c 69 74 65 52 65 67 69 73 74 65 72 42 75 69  qliteRegisterBui
2a50: 6c 64 69 6e 46 75 6e 63 74 69 6f 6e 73 28 73 71  ldinFunctions(sq
2a60: 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 73 74 61  lite *db){.  sta
2a70: 74 69 63 20 73 74 72 75 63 74 20 7b 0a 20 20 20  tic struct {.   
2a80: 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 0a 20    char *zName;. 
2a90: 20 20 20 20 69 6e 74 20 6e 41 72 67 3b 0a 20 20      int nArg;.  
2aa0: 20 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29     void (*xFunc)
2ab0: 28 73 71 6c 69 74 65 5f 66 75 6e 63 2a 2c 69 6e  (sqlite_func*,in
2ac0: 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2a 29 3b  t,const char**);
2ad0: 0a 20 20 7d 20 61 46 75 6e 63 73 5b 5d 20 3d 20  .  } aFuncs[] = 
2ae0: 7b 0a 20 20 20 20 7b 20 22 6d 69 6e 22 2c 20 20  {.    { "min",  
2af0: 20 20 20 20 20 2d 31 2c 20 6d 69 6e 46 75 6e 63       -1, minFunc
2b00: 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 6d 69      },.    { "mi
2b10: 6e 22 2c 20 20 20 20 20 20 20 20 30 2c 20 30 20  n",        0, 0 
2b20: 20 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20 20           },.    
2b30: 7b 20 22 6d 61 78 22 2c 20 20 20 20 20 20 20 2d  { "max",       -
2b40: 31 2c 20 6d 61 78 46 75 6e 63 20 20 20 20 7d 2c  1, maxFunc    },
2b50: 0a 20 20 20 20 7b 20 22 6d 61 78 22 2c 20 20 20  .    { "max",   
2b60: 20 20 20 20 20 30 2c 20 30 20 20 20 20 20 20 20       0, 0       
2b70: 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 6c 65 6e     },.    { "len
2b80: 67 74 68 22 2c 20 20 20 20 20 31 2c 20 6c 65 6e  gth",     1, len
2b90: 67 74 68 46 75 6e 63 20 7d 2c 0a 20 20 20 20 7b  gthFunc },.    {
2ba0: 20 22 73 75 62 73 74 72 22 2c 20 20 20 20 20 33   "substr",     3
2bb0: 2c 20 73 75 62 73 74 72 46 75 6e 63 20 7d 2c 0a  , substrFunc },.
2bc0: 20 20 20 20 7b 20 22 61 62 73 22 2c 20 20 20 20      { "abs",    
2bd0: 20 20 20 20 31 2c 20 61 62 73 46 75 6e 63 20 20      1, absFunc  
2be0: 20 20 7d 2c 0a 20 20 20 20 7b 20 22 72 6f 75 6e    },.    { "roun
2bf0: 64 22 2c 20 20 20 20 20 20 31 2c 20 72 6f 75 6e  d",      1, roun
2c00: 64 46 75 6e 63 20 20 7d 2c 0a 20 20 20 20 7b 20  dFunc  },.    { 
2c10: 22 72 6f 75 6e 64 22 2c 20 20 20 20 20 20 32 2c  "round",      2,
2c20: 20 72 6f 75 6e 64 46 75 6e 63 20 20 7d 2c 0a 20   roundFunc  },. 
2c30: 20 20 20 7b 20 22 75 70 70 65 72 22 2c 20 20 20     { "upper",   
2c40: 20 20 20 31 2c 20 75 70 70 65 72 46 75 6e 63 20     1, upperFunc 
2c50: 20 7d 2c 0a 20 20 20 20 7b 20 22 6c 6f 77 65 72   },.    { "lower
2c60: 22 2c 20 20 20 20 20 20 31 2c 20 6c 6f 77 65 72  ",      1, lower
2c70: 46 75 6e 63 20 20 7d 2c 0a 20 20 20 20 7b 20 22  Func  },.    { "
2c80: 63 6f 61 6c 65 73 63 65 22 2c 20 20 2d 31 2c 20  coalesce",  -1, 
2c90: 69 66 6e 75 6c 6c 46 75 6e 63 20 7d 2c 0a 20 20  ifnullFunc },.  
2ca0: 20 20 7b 20 22 63 6f 61 6c 65 73 63 65 22 2c 20    { "coalesce", 
2cb0: 20 20 30 2c 20 30 20 20 20 20 20 20 20 20 20 20    0, 0          
2cc0: 7d 2c 0a 20 20 20 20 7b 20 22 63 6f 61 6c 65 73  },.    { "coales
2cd0: 63 65 22 2c 20 20 20 31 2c 20 30 20 20 20 20 20  ce",   1, 0     
2ce0: 20 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 69       },.    { "i
2cf0: 66 6e 75 6c 6c 22 2c 20 20 20 20 20 32 2c 20 69  fnull",     2, i
2d00: 66 6e 75 6c 6c 46 75 6e 63 20 7d 2c 0a 20 20 20  fnullFunc },.   
2d10: 20 7b 20 22 72 61 6e 64 6f 6d 22 2c 20 20 20 20   { "random",    
2d20: 2d 31 2c 20 72 61 6e 64 6f 6d 46 75 6e 63 20 7d  -1, randomFunc }
2d30: 2c 0a 20 20 20 20 7b 20 22 6c 69 6b 65 22 2c 20  ,.    { "like", 
2d40: 20 20 20 20 20 20 32 2c 20 6c 69 6b 65 46 75 6e        2, likeFun
2d50: 63 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 67 6c  c   },.    { "gl
2d60: 6f 62 22 2c 20 20 20 20 20 20 20 32 2c 20 67 6c  ob",       2, gl
2d70: 6f 62 46 75 6e 63 20 20 20 7d 2c 0a 20 20 20 20  obFunc   },.    
2d80: 7b 20 22 6e 75 6c 6c 69 66 22 2c 20 20 20 20 20  { "nullif",     
2d90: 32 2c 20 6e 75 6c 6c 69 66 46 75 6e 63 20 7d 2c  2, nullifFunc },
2da0: 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 73  .  };.  static s
2db0: 74 72 75 63 74 20 7b 0a 20 20 20 20 63 68 61 72  truct {.    char
2dc0: 20 2a 7a 4e 61 6d 65 3b 0a 20 20 20 20 69 6e 74   *zName;.    int
2dd0: 20 6e 41 72 67 3b 0a 20 20 20 20 76 6f 69 64 20   nArg;.    void 
2de0: 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65 5f  (*xStep)(sqlite_
2df0: 66 75 6e 63 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20  func*,int,const 
2e00: 63 68 61 72 2a 2a 29 3b 0a 20 20 20 20 76 6f 69  char**);.    voi
2e10: 64 20 28 2a 78 46 69 6e 61 6c 69 7a 65 29 28 73  d (*xFinalize)(s
2e20: 71 6c 69 74 65 5f 66 75 6e 63 2a 29 3b 0a 20 20  qlite_func*);.  
2e30: 7d 20 61 41 67 67 73 5b 5d 20 3d 20 7b 0a 20 20  } aAggs[] = {.  
2e40: 20 20 7b 20 22 6d 69 6e 22 2c 20 20 20 20 31 2c    { "min",    1,
2e50: 20 6d 69 6e 53 74 65 70 2c 20 20 20 20 20 20 6d   minStep,      m
2e60: 69 6e 4d 61 78 46 69 6e 61 6c 69 7a 65 20 7d 2c  inMaxFinalize },
2e70: 0a 20 20 20 20 7b 20 22 6d 61 78 22 2c 20 20 20  .    { "max",   
2e80: 20 31 2c 20 6d 61 78 53 74 65 70 2c 20 20 20 20   1, maxStep,    
2e90: 20 20 6d 69 6e 4d 61 78 46 69 6e 61 6c 69 7a 65    minMaxFinalize
2ea0: 20 7d 2c 0a 20 20 20 20 7b 20 22 73 75 6d 22 2c   },.    { "sum",
2eb0: 20 20 20 20 31 2c 20 73 75 6d 53 74 65 70 2c 20      1, sumStep, 
2ec0: 20 20 20 20 20 73 75 6d 46 69 6e 61 6c 69 7a 65       sumFinalize
2ed0: 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 61 76      },.    { "av
2ee0: 67 22 2c 20 20 20 20 31 2c 20 73 75 6d 53 74 65  g",    1, sumSte
2ef0: 70 2c 20 20 20 20 20 20 61 76 67 46 69 6e 61 6c  p,      avgFinal
2f00: 69 7a 65 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20  ize    },.    { 
2f10: 22 63 6f 75 6e 74 22 2c 20 20 30 2c 20 63 6f 75  "count",  0, cou
2f20: 6e 74 53 74 65 70 2c 20 20 20 20 63 6f 75 6e 74  ntStep,    count
2f30: 46 69 6e 61 6c 69 7a 65 20 20 7d 2c 0a 20 20 20  Finalize  },.   
2f40: 20 7b 20 22 63 6f 75 6e 74 22 2c 20 20 31 2c 20   { "count",  1, 
2f50: 63 6f 75 6e 74 53 74 65 70 2c 20 20 20 20 63 6f  countStep,    co
2f60: 75 6e 74 46 69 6e 61 6c 69 7a 65 20 20 7d 2c 0a  untFinalize  },.
2f70: 23 69 66 20 30 0a 20 20 20 20 7b 20 22 73 74 64  #if 0.    { "std
2f80: 64 65 76 22 2c 20 31 2c 20 73 74 64 44 65 76 53  dev", 1, stdDevS
2f90: 74 65 70 2c 20 20 20 73 74 64 44 65 76 46 69 6e  tep,   stdDevFin
2fa0: 61 6c 69 7a 65 20 7d 2c 0a 23 65 6e 64 69 66 0a  alize },.#endif.
2fb0: 20 20 7d 3b 0a 20 20 69 6e 74 20 69 3b 0a 0a 20    };.  int i;.. 
2fc0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73 69 7a 65   for(i=0; i<size
2fd0: 6f 66 28 61 46 75 6e 63 73 29 2f 73 69 7a 65 6f  of(aFuncs)/sizeo
2fe0: 66 28 61 46 75 6e 63 73 5b 30 5d 29 3b 20 69 2b  f(aFuncs[0]); i+
2ff0: 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f 63  +){.    sqlite_c
3000: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 64  reate_function(d
3010: 62 2c 20 61 46 75 6e 63 73 5b 69 5d 2e 7a 4e 61  b, aFuncs[i].zNa
3020: 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 61  me,.           a
3030: 46 75 6e 63 73 5b 69 5d 2e 6e 41 72 67 2c 20 61  Funcs[i].nArg, a
3040: 46 75 6e 63 73 5b 69 5d 2e 78 46 75 6e 63 2c 20  Funcs[i].xFunc, 
3050: 30 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  0);.  }.  sqlite
3060: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e  _create_function
3070: 28 64 62 2c 20 22 6c 61 73 74 5f 69 6e 73 65 72  (db, "last_inser
3080: 74 5f 72 6f 77 69 64 22 2c 20 30 2c 20 0a 20 20  t_rowid", 0, .  
3090: 20 20 20 20 20 20 20 20 20 6c 61 73 74 5f 69 6e           last_in
30a0: 73 65 72 74 5f 72 6f 77 69 64 2c 20 64 62 29 3b  sert_rowid, db);
30b0: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73 69  .  for(i=0; i<si
30c0: 7a 65 6f 66 28 61 41 67 67 73 29 2f 73 69 7a 65  zeof(aAggs)/size
30d0: 6f 66 28 61 41 67 67 73 5b 30 5d 29 3b 20 69 2b  of(aAggs[0]); i+
30e0: 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f 63  +){.    sqlite_c
30f0: 72 65 61 74 65 5f 61 67 67 72 65 67 61 74 65 28  reate_aggregate(
3100: 64 62 2c 20 61 41 67 67 73 5b 69 5d 2e 7a 4e 61  db, aAggs[i].zNa
3110: 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 61  me,.           a
3120: 41 67 67 73 5b 69 5d 2e 6e 41 72 67 2c 20 61 41  Aggs[i].nArg, aA
3130: 67 67 73 5b 69 5d 2e 78 53 74 65 70 2c 20 61 41  ggs[i].xStep, aA
3140: 67 67 73 5b 69 5d 2e 78 46 69 6e 61 6c 69 7a 65  ggs[i].xFinalize
3150: 2c 20 30 29 3b 0a 20 20 7d 0a 7d 0a              , 0);.  }.}.