/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact 854732720c2cfc6ff76b28eef6253ac84a5408bc:


0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 4d 61 79 20 32  /*.** 2004 May 2
0010: 36 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  6.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
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: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65  .**.** This file
0180: 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 75   contains code u
0190: 73 65 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20  se to implement 
01a0: 41 50 49 73 20 74 68 61 74 20 61 72 65 20 70 61  APIs that are pa
01b0: 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 56 44 42  rt of the.** VDB
01c0: 45 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22  E..*/.#include "
01d0: 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e  sqliteInt.h".#in
01e0: 63 6c 75 64 65 20 22 76 64 62 65 49 6e 74 2e 68  clude "vdbeInt.h
01f0: 22 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  "../************
0200: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0210: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 20   sqlite3_value_ 
0220: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a   ***************
0230: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0240: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
0250: 67 20 72 6f 75 74 69 6e 65 73 20 65 78 74 72 61  g routines extra
0260: 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66  ct information f
0270: 72 6f 6d 20 61 20 4d 65 6d 20 6f 72 20 73 71 6c  rom a Mem or sql
0280: 69 74 65 33 5f 76 61 6c 75 65 0a 2a 2a 20 73 74  ite3_value.** st
0290: 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63 6f 6e 73  ructure..*/.cons
02a0: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  t void *sqlite3_
02b0: 76 61 6c 75 65 5f 62 6c 6f 62 28 73 71 6c 69 74  value_blob(sqlit
02c0: 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b  e3_value *pVal){
02d0: 0a 20 20 4d 65 6d 20 2a 70 20 3d 20 28 4d 65 6d  .  Mem *p = (Mem
02e0: 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28 20 70 2d  *)pVal;.  if( p-
02f0: 3e 66 6c 61 67 73 20 26 20 28 4d 45 4d 5f 42 6c  >flags & (MEM_Bl
0300: 6f 62 7c 4d 45 4d 5f 53 74 72 29 20 29 7b 0a 20  ob|MEM_Str) ){. 
0310: 20 20 20 72 65 74 75 72 6e 20 70 2d 3e 7a 3b 0a     return p->z;.
0320: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74    }else{.    ret
0330: 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  urn sqlite3_valu
0340: 65 5f 74 65 78 74 28 70 56 61 6c 29 3b 0a 20 20  e_text(pVal);.  
0350: 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  }.}.int sqlite3_
0360: 76 61 6c 75 65 5f 62 79 74 65 73 28 73 71 6c 69  value_bytes(sqli
0370: 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29  te3_value *pVal)
0380: 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  {.  return sqlit
0390: 65 33 56 61 6c 75 65 42 79 74 65 73 28 70 56 61  e3ValueBytes(pVa
03a0: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b  l, SQLITE_UTF8);
03b0: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 76  .}.int sqlite3_v
03c0: 61 6c 75 65 5f 62 79 74 65 73 31 36 28 73 71 6c  alue_bytes16(sql
03d0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c  ite3_value *pVal
03e0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
03f0: 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70 56  te3ValueBytes(pV
0400: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  al, SQLITE_UTF16
0410: 4e 41 54 49 56 45 29 3b 0a 7d 0a 64 6f 75 62 6c  NATIVE);.}.doubl
0420: 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  e sqlite3_value_
0430: 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 76  double(sqlite3_v
0440: 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72  alue *pVal){.  r
0450: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62  eturn sqlite3Vdb
0460: 65 52 65 61 6c 56 61 6c 75 65 28 28 4d 65 6d 2a  eRealValue((Mem*
0470: 29 70 56 61 6c 29 3b 0a 7d 0a 69 6e 74 20 73 71  )pVal);.}.int sq
0480: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28  lite3_value_int(
0490: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70  sqlite3_value *p
04a0: 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  Val){.  return s
04b0: 71 6c 69 74 65 33 56 64 62 65 49 6e 74 56 61 6c  qlite3VdbeIntVal
04c0: 75 65 28 28 4d 65 6d 2a 29 70 56 61 6c 29 3b 0a  ue((Mem*)pVal);.
04d0: 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73  }.sqlite_int64 s
04e0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74  qlite3_value_int
04f0: 36 34 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  64(sqlite3_value
0500: 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72   *pVal){.  retur
0510: 6e 20 73 71 6c 69 74 65 33 56 64 62 65 49 6e 74  n sqlite3VdbeInt
0520: 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56 61 6c  Value((Mem*)pVal
0530: 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 69 67  );.}.const unsig
0540: 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69 74 65  ned char *sqlite
0550: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 73 71 6c  3_value_text(sql
0560: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c  ite3_value *pVal
0570: 29 7b 0a 20 20 72 65 74 75 72 6e 20 28 63 6f 6e  ){.  return (con
0580: 73 74 20 63 68 61 72 20 2a 29 73 71 6c 69 74 65  st char *)sqlite
0590: 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c  3ValueText(pVal,
05a0: 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d   SQLITE_UTF8);.}
05b0: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
05c0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
05d0: 36 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a  6(sqlite3_value*
05e0: 20 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e   pVal){.  return
05f0: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78   sqlite3ValueTex
0600: 74 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55  t(pVal, SQLITE_U
0610: 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 63  TF16NATIVE);.}.c
0620: 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74  onst void *sqlit
0630: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 62  e3_value_text16b
0640: 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  e(sqlite3_value 
0650: 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e  *pVal){.  return
0660: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78   sqlite3ValueTex
0670: 74 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55  t(pVal, SQLITE_U
0680: 54 46 31 36 42 45 29 3b 0a 7d 0a 63 6f 6e 73 74  TF16BE);.}.const
0690: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76   void *sqlite3_v
06a0: 61 6c 75 65 5f 74 65 78 74 31 36 6c 65 28 73 71  alue_text16le(sq
06b0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
06c0: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
06d0: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56  ite3ValueText(pV
06e0: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  al, SQLITE_UTF16
06f0: 4c 45 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74  LE);.}.int sqlit
0700: 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 73 71  e3_value_type(sq
0710: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70 56 61  lite3_value* pVa
0720: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 56 61  l){.  return pVa
0730: 6c 2d 3e 74 79 70 65 3b 0a 7d 0a 0a 2f 2a 2a 2a  l->type;.}../***
0740: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0750: 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65  ********* sqlite
0760: 33 5f 72 65 73 75 6c 74 5f 20 20 2a 2a 2a 2a 2a  3_result_  *****
0770: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0780: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68  **********.** Th
0790: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74  e following rout
07a0: 69 6e 65 73 20 61 72 65 20 75 73 65 64 20 62 79  ines are used by
07b0: 20 75 73 65 72 2d 64 65 66 69 6e 65 64 20 66 75   user-defined fu
07c0: 6e 63 74 69 6f 6e 73 20 74 6f 20 73 70 65 63 69  nctions to speci
07d0: 66 79 0a 2a 2a 20 74 68 65 20 66 75 6e 63 74 69  fy.** the functi
07e0: 6f 6e 20 72 65 73 75 6c 74 2e 0a 2a 2f 0a 76 6f  on result..*/.vo
07f0: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
0800: 74 5f 62 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65  t_blob(.  sqlite
0810: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
0820: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
0830: 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20  z, .  int n, .  
0840: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
0850: 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74  d *).){.  assert
0860: 28 20 6e 3e 30 20 29 3b 0a 20 20 73 71 6c 69 74  ( n>0 );.  sqlit
0870: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
0880: 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20  &pCtx->s, z, n, 
0890: 30 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64  0, xDel);.}.void
08a0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
08b0: 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 63  double(sqlite3_c
08c0: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 64 6f  ontext *pCtx, do
08d0: 75 62 6c 65 20 72 56 61 6c 29 7b 0a 20 20 73 71  uble rVal){.  sq
08e0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 44  lite3VdbeMemSetD
08f0: 6f 75 62 6c 65 28 26 70 43 74 78 2d 3e 73 2c 20  ouble(&pCtx->s, 
0900: 72 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  rVal);.}.void sq
0910: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
0920: 6f 72 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  or(sqlite3_conte
0930: 78 74 20 2a 70 43 74 78 2c 20 63 6f 6e 73 74 20  xt *pCtx, const 
0940: 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b  char *z, int n){
0950: 0a 20 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72  .  pCtx->isError
0960: 20 3d 20 31 3b 0a 20 20 73 71 6c 69 74 65 33 56   = 1;.  sqlite3V
0970: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43  dbeMemSetStr(&pC
0980: 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c  tx->s, z, n, SQL
0990: 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45  ITE_UTF8, SQLITE
09a0: 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a 7d 0a 76  _TRANSIENT);.}.v
09b0: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75  oid sqlite3_resu
09c0: 6c 74 5f 65 72 72 6f 72 31 36 28 73 71 6c 69 74  lt_error16(sqlit
09d0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
09e0: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c  , const void *z,
09f0: 20 69 6e 74 20 6e 29 7b 0a 20 20 70 43 74 78 2d   int n){.  pCtx-
0a00: 3e 69 73 45 72 72 6f 72 20 3d 20 31 3b 0a 20 20  >isError = 1;.  
0a10: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
0a20: 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a  tStr(&pCtx->s, z
0a30: 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  , n, SQLITE_UTF1
0a40: 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 54 45 5f  6NATIVE, SQLITE_
0a50: 54 52 41 4e 53 49 45 4e 54 29 3b 0a 7d 0a 76 6f  TRANSIENT);.}.vo
0a60: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
0a70: 74 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 63 6f  t_int(sqlite3_co
0a80: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e 74  ntext *pCtx, int
0a90: 20 69 56 61 6c 29 7b 0a 20 20 73 71 6c 69 74 65   iVal){.  sqlite
0aa0: 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34  3VdbeMemSetInt64
0ab0: 28 26 70 43 74 78 2d 3e 73 2c 20 28 69 36 34 29  (&pCtx->s, (i64)
0ac0: 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  iVal);.}.void sq
0ad0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74  lite3_result_int
0ae0: 36 34 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  64(sqlite3_conte
0af0: 78 74 20 2a 70 43 74 78 2c 20 69 36 34 20 69 56  xt *pCtx, i64 iV
0b00: 61 6c 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64  al){.  sqlite3Vd
0b10: 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 26 70  beMemSetInt64(&p
0b20: 43 74 78 2d 3e 73 2c 20 69 56 61 6c 29 3b 0a 7d  Ctx->s, iVal);.}
0b30: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
0b40: 73 75 6c 74 5f 6e 75 6c 6c 28 73 71 6c 69 74 65  sult_null(sqlite
0b50: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 29  3_context *pCtx)
0b60: 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  {.  sqlite3VdbeM
0b70: 65 6d 53 65 74 4e 75 6c 6c 28 26 70 43 74 78 2d  emSetNull(&pCtx-
0b80: 3e 73 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69  >s);.}.void sqli
0b90: 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 28  te3_result_text(
0ba0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
0bb0: 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e  xt *pCtx, .  con
0bc0: 73 74 20 63 68 61 72 20 2a 7a 2c 20 0a 20 20 69  st char *z, .  i
0bd0: 6e 74 20 6e 2c 0a 20 20 76 6f 69 64 20 28 2a 78  nt n,.  void (*x
0be0: 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a  Del)(void *).){.
0bf0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
0c00: 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c  SetStr(&pCtx->s,
0c10: 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54   z, n, SQLITE_UT
0c20: 46 38 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69  F8, xDel);.}.voi
0c30: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
0c40: 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69 74  _text16(.  sqlit
0c50: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
0c60: 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  , .  const void 
0c70: 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20  *z, .  int n, . 
0c80: 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f   void (*xDel)(vo
0c90: 69 64 20 2a 29 0a 29 7b 0a 20 20 73 71 6c 69 74  id *).){.  sqlit
0ca0: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
0cb0: 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20  &pCtx->s, z, n, 
0cc0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49  SQLITE_UTF16NATI
0cd0: 56 45 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69  VE, xDel);.}.voi
0ce0: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
0cf0: 5f 74 65 78 74 31 36 62 65 28 0a 20 20 73 71 6c  _text16be(.  sql
0d00: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
0d10: 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69  tx, .  const voi
0d20: 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20  d *z, .  int n, 
0d30: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28  .  void (*xDel)(
0d40: 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 73 71 6c  void *).){.  sql
0d50: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
0d60: 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e  r(&pCtx->s, z, n
0d70: 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45  , SQLITE_UTF16BE
0d80: 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20  , xDel);.}.void 
0d90: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74  sqlite3_result_t
0da0: 65 78 74 31 36 6c 65 28 0a 20 20 73 71 6c 69 74  ext16le(.  sqlit
0db0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
0dc0: 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  , .  const void 
0dd0: 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20  *z, .  int n, . 
0de0: 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f   void (*xDel)(vo
0df0: 69 64 20 2a 29 0a 29 7b 0a 20 20 73 71 6c 69 74  id *).){.  sqlit
0e00: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
0e10: 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20  &pCtx->s, z, n, 
0e20: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20  SQLITE_UTF16LE, 
0e30: 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  xDel);.}.void sq
0e40: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c  lite3_result_val
0e50: 75 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  ue(sqlite3_conte
0e60: 78 74 20 2a 70 43 74 78 2c 20 73 71 6c 69 74 65  xt *pCtx, sqlite
0e70: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 75 65 29  3_value *pValue)
0e80: 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  {.  sqlite3VdbeM
0e90: 65 6d 43 6f 70 79 28 26 70 43 74 78 2d 3e 73 2c  emCopy(&pCtx->s,
0ea0: 20 70 56 61 6c 75 65 29 3b 0a 7d 0a 0a 0a 2f 2a   pValue);.}.../*
0eb0: 0a 2a 2a 20 45 78 65 63 75 74 65 20 74 68 65 20  .** Execute the 
0ec0: 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2c  statement pStmt,
0ed0: 20 65 69 74 68 65 72 20 75 6e 74 69 6c 20 61 20   either until a 
0ee0: 72 6f 77 20 6f 66 20 64 61 74 61 20 69 73 20 72  row of data is r
0ef0: 65 61 64 79 2c 20 74 68 65 0a 2a 2a 20 73 74 61  eady, the.** sta
0f00: 74 65 6d 65 6e 74 20 69 73 20 63 6f 6d 70 6c 65  tement is comple
0f10: 74 65 6c 79 20 65 78 65 63 75 74 65 64 20 6f 72  tely executed or
0f20: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
0f30: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
0f40: 5f 73 74 65 70 28 73 71 6c 69 74 65 33 5f 73 74  _step(sqlite3_st
0f50: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64  mt *pStmt){.  Vd
0f60: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70  be *p = (Vdbe*)p
0f70: 53 74 6d 74 3b 0a 20 20 73 71 6c 69 74 65 20 2a  Stmt;.  sqlite *
0f80: 64 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20  db;.  int rc;.. 
0f90: 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e   if( p==0 || p->
0fa0: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
0fb0: 43 5f 52 55 4e 20 29 7b 0a 20 20 20 20 72 65 74  C_RUN ){.    ret
0fc0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
0fd0: 45 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e  E;.  }.  if( p->
0fe0: 61 62 6f 72 74 65 64 20 29 7b 0a 20 20 20 20 72  aborted ){.    r
0ff0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 41 42 4f  eturn SQLITE_ABO
1000: 52 54 3b 0a 20 20 7d 0a 20 20 64 62 20 3d 20 70  RT;.  }.  db = p
1010: 2d 3e 64 62 3b 0a 20 20 69 66 28 20 73 71 6c 69  ->db;.  if( sqli
1020: 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20  te3SafetyOn(db) 
1030: 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53  ){.    p->rc = S
1040: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
1050: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
1060: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66  MISUSE;.  }.  if
1070: 28 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 20 20 20  ( p->pc<0 ){.   
1080: 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43   db->activeVdbeC
1090: 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e 70 63 20  nt++;.    p->pc 
10a0: 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  = 0;.  }.  if( p
10b0: 2d 3e 65 78 70 6c 61 69 6e 20 29 7b 0a 20 20 20  ->explain ){.   
10c0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
10d0: 65 4c 69 73 74 28 70 29 3b 0a 20 20 7d 65 6c 73  eList(p);.  }els
10e0: 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  e{.    rc = sqli
10f0: 74 65 33 56 64 62 65 45 78 65 63 28 70 29 3b 0a  te3VdbeExec(p);.
1100: 20 20 7d 0a 0a 20 20 69 66 28 20 73 71 6c 69 74    }..  if( sqlit
1110: 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 20  e3SafetyOff(db) 
1120: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
1130: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a  TE_MISUSE;.  }..
1140: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70    sqlite3Error(p
1150: 2d 3e 64 62 2c 20 72 63 2c 20 70 2d 3e 7a 45 72  ->db, rc, p->zEr
1160: 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e 20  rMsg);.  return 
1170: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 74  rc;.}../*.** Ext
1180: 72 61 63 74 20 74 68 65 20 75 73 65 72 20 64 61  ract the user da
1190: 74 61 20 66 72 6f 6d 20 61 20 73 71 6c 69 74 65  ta from a sqlite
11a0: 33 5f 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74  3_context struct
11b0: 75 72 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61  ure and return a
11c0: 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 69  .** pointer to i
11d0: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69  t..*/.void *sqli
11e0: 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28 73 71  te3_user_data(sq
11f0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
1200: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26  ){.  assert( p &
1210: 26 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20  & p->pFunc );.  
1220: 72 65 74 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d  return p->pFunc-
1230: 3e 70 55 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f  >pUserData;.}../
1240: 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72  *.** Allocate or
1250: 20 72 65 74 75 72 6e 20 74 68 65 20 61 67 67 72   return the aggr
1260: 65 67 61 74 65 20 63 6f 6e 74 65 78 74 20 66 6f  egate context fo
1270: 72 20 61 20 75 73 65 72 20 66 75 6e 63 74 69 6f  r a user functio
1280: 6e 2e 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e  n.  A new.** con
1290: 74 65 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65  text is allocate
12a0: 64 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 63  d on the first c
12b0: 61 6c 6c 2e 20 20 53 75 62 73 65 71 75 65 6e 74  all.  Subsequent
12c0: 20 63 61 6c 6c 73 20 72 65 74 75 72 6e 20 74 68   calls return th
12d0: 65 0a 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78  e.** same contex
12e0: 74 20 74 68 61 74 20 77 61 73 20 72 65 74 75 72  t that was retur
12f0: 6e 65 64 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c  ned on prior cal
1300: 6c 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  ls..**.** This r
1310: 6f 75 74 69 6e 65 20 69 73 20 64 65 66 69 6e 65  outine is define
1320: 64 20 68 65 72 65 20 69 6e 20 76 64 62 65 2e 63  d here in vdbe.c
1330: 20 62 65 63 61 75 73 65 20 69 74 20 64 65 70 65   because it depe
1340: 6e 64 73 20 6f 6e 20 6b 6e 6f 77 69 6e 67 0a 2a  nds on knowing.*
1350: 2a 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 73 20  * the internals 
1360: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 63  of the sqlite3_c
1370: 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72 65  ontext structure
1380: 20 77 68 69 63 68 20 69 73 20 6f 6e 6c 79 20 64   which is only d
1390: 65 66 69 6e 65 64 20 69 6e 0a 2a 2a 20 74 68 69  efined in.** thi
13a0: 73 20 73 6f 75 72 63 65 20 66 69 6c 65 2e 0a 2a  s source file..*
13b0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
13c0: 61 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78  aggregate_contex
13d0: 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  t(sqlite3_contex
13e0: 74 20 2a 70 2c 20 69 6e 74 20 6e 42 79 74 65 29  t *p, int nByte)
13f0: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26  {.  assert( p &&
1400: 20 70 2d 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e   p->pFunc && p->
1410: 70 46 75 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a  pFunc->xStep );.
1420: 20 20 69 66 28 20 70 2d 3e 70 41 67 67 3d 3d 30    if( p->pAgg==0
1430: 20 29 7b 0a 20 20 20 20 69 66 28 20 6e 42 79 74   ){.    if( nByt
1440: 65 3c 3d 4e 42 46 53 20 29 7b 0a 20 20 20 20 20  e<=NBFS ){.     
1450: 20 70 2d 3e 70 41 67 67 20 3d 20 28 76 6f 69 64   p->pAgg = (void
1460: 2a 29 70 2d 3e 73 2e 7a 3b 0a 20 20 20 20 20 20  *)p->s.z;.      
1470: 6d 65 6d 73 65 74 28 70 2d 3e 70 41 67 67 2c 20  memset(p->pAgg, 
1480: 30 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 7d  0, nByte);.    }
1490: 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 2d 3e 70  else{.      p->p
14a0: 41 67 67 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c  Agg = sqliteMall
14b0: 6f 63 28 20 6e 42 79 74 65 20 29 3b 0a 20 20 20  oc( nByte );.   
14c0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
14d0: 70 2d 3e 70 41 67 67 3b 0a 7d 0a 0a 2f 2a 0a 2a  p->pAgg;.}../*.*
14e0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61 75 78  * Return the aux
14f0: 69 6c 61 72 79 20 64 61 74 61 20 70 6f 69 6e 74  ilary data point
1500: 65 72 2c 20 69 66 20 61 6e 79 2c 20 66 6f 72 20  er, if any, for 
1510: 74 68 65 20 69 41 72 67 27 74 68 20 61 72 67 75  the iArg'th argu
1520: 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 75  ment to.** the u
1530: 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66  ser-function def
1540: 69 6e 65 64 20 62 79 20 70 43 74 78 2e 0a 2a 2f  ined by pCtx..*/
1550: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 67  .void *sqlite3_g
1560: 65 74 5f 61 75 78 64 61 74 61 28 73 71 6c 69 74  et_auxdata(sqlit
1570: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
1580: 2c 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 20 56  , int iArg){.  V
1590: 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75  dbeFunc *pVdbeFu
15a0: 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 65  nc = pCtx->pVdbe
15b0: 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 64  Func;.  if( !pVd
15c0: 62 65 46 75 6e 63 20 7c 7c 20 69 41 72 67 3e 3d  beFunc || iArg>=
15d0: 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20  pVdbeFunc->nAux 
15e0: 7c 7c 20 69 41 72 67 3c 30 20 29 7b 0a 20 20 20  || iArg<0 ){.   
15f0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20   return 0;.  }. 
1600: 20 72 65 74 75 72 6e 20 70 56 64 62 65 46 75 6e   return pVdbeFun
1610: 63 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d 2e 70  c->apAux[iArg].p
1620: 41 75 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65  Aux;.}../*.** Se
1630: 74 20 74 68 65 20 61 75 78 69 6c 61 72 79 20 64  t the auxilary d
1640: 61 74 61 20 70 6f 69 6e 74 65 72 20 61 6e 64 20  ata pointer and 
1650: 64 65 6c 65 74 65 20 66 75 6e 63 74 69 6f 6e 2c  delete function,
1660: 20 66 6f 72 20 74 68 65 20 69 41 72 67 27 74 68   for the iArg'th
1670: 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  .** argument to 
1680: 74 68 65 20 75 73 65 72 2d 66 75 6e 63 74 69 6f  the user-functio
1690: 6e 20 64 65 66 69 6e 65 64 20 62 79 20 70 43 74  n defined by pCt
16a0: 78 2e 20 41 6e 79 20 70 72 65 76 69 6f 75 73 20  x. Any previous 
16b0: 76 61 6c 75 65 20 69 73 0a 2a 2a 20 64 65 6c 65  value is.** dele
16c0: 74 65 64 20 62 79 20 63 61 6c 6c 69 6e 67 20 74  ted by calling t
16d0: 68 65 20 64 65 6c 65 74 65 20 66 75 6e 63 74 69  he delete functi
16e0: 6f 6e 20 73 70 65 63 69 66 69 65 64 20 77 68 65  on specified whe
16f0: 6e 20 69 74 20 77 61 73 20 73 65 74 2e 0a 2a 2f  n it was set..*/
1700: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73 65  .void sqlite3_se
1710: 74 5f 61 75 78 64 61 74 61 28 0a 20 20 73 71 6c  t_auxdata(.  sql
1720: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
1730: 74 78 2c 20 0a 20 20 69 6e 74 20 69 41 72 67 2c  tx, .  int iArg,
1740: 20 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c 20   .  void *pAux, 
1750: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 65 74  .  void (*xDelet
1760: 65 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 73  e)(void*).){.  s
1770: 74 72 75 63 74 20 41 75 78 44 61 74 61 20 2a 70  truct AuxData *p
1780: 41 75 78 44 61 74 61 3b 0a 20 20 56 64 62 65 46  AuxData;.  VdbeF
1790: 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 3b 0a  unc *pVdbeFunc;.
17a0: 20 20 69 66 28 20 69 41 72 67 3c 30 20 29 20 72    if( iArg<0 ) r
17b0: 65 74 75 72 6e 3b 0a 0a 20 20 70 56 64 62 65 46  eturn;..  pVdbeF
17c0: 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62  unc = pCtx->pVdb
17d0: 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56  eFunc;.  if( !pV
17e0: 64 62 65 46 75 6e 63 20 7c 7c 20 70 56 64 62 65  dbeFunc || pVdbe
17f0: 46 75 6e 63 2d 3e 6e 41 75 78 3c 3d 69 41 72 67  Func->nAux<=iArg
1800: 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 4d 61 6c   ){.    int nMal
1810: 6c 6f 63 20 3d 20 73 69 7a 65 6f 66 28 56 64 62  loc = sizeof(Vdb
1820: 65 46 75 6e 63 29 20 2b 20 73 69 7a 65 6f 66 28  eFunc) + sizeof(
1830: 73 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a  struct AuxData)*
1840: 69 41 72 67 3b 0a 20 20 20 20 70 43 74 78 2d 3e  iArg;.    pCtx->
1850: 70 56 64 62 65 46 75 6e 63 20 3d 20 70 56 64 62  pVdbeFunc = pVdb
1860: 65 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 52 65  eFunc = sqliteRe
1870: 61 6c 6c 6f 63 28 70 56 64 62 65 46 75 6e 63 2c  alloc(pVdbeFunc,
1880: 20 6e 4d 61 6c 6c 6f 63 29 3b 0a 20 20 20 20 69   nMalloc);.    i
1890: 66 28 20 21 70 56 64 62 65 46 75 6e 63 20 29 20  f( !pVdbeFunc ) 
18a0: 72 65 74 75 72 6e 3b 0a 20 20 20 20 6d 65 6d 73  return;.    mems
18b0: 65 74 28 26 70 56 64 62 65 46 75 6e 63 2d 3e 61  et(&pVdbeFunc->a
18c0: 70 41 75 78 5b 70 56 64 62 65 46 75 6e 63 2d 3e  pAux[pVdbeFunc->
18d0: 6e 41 75 78 5d 2c 20 30 2c 20 0a 20 20 20 20 20  nAux], 0, .     
18e0: 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28 73          sizeof(s
18f0: 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a 28  truct AuxData)*(
1900: 69 41 72 67 2b 31 2d 70 56 64 62 65 46 75 6e 63  iArg+1-pVdbeFunc
1910: 2d 3e 6e 41 75 78 29 29 3b 0a 20 20 20 20 70 56  ->nAux));.    pV
1920: 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3d 20  dbeFunc->nAux = 
1930: 69 41 72 67 2b 31 3b 0a 20 20 20 20 70 56 64 62  iArg+1;.    pVdb
1940: 65 46 75 6e 63 2d 3e 70 46 75 6e 63 20 3d 20 70  eFunc->pFunc = p
1950: 43 74 78 2d 3e 70 46 75 6e 63 3b 0a 20 20 7d 0a  Ctx->pFunc;.  }.
1960: 0a 20 20 70 41 75 78 44 61 74 61 20 3d 20 26 70  .  pAuxData = &p
1970: 56 64 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b  VdbeFunc->apAux[
1980: 69 41 72 67 5d 3b 0a 20 20 69 66 28 20 70 41 75  iArg];.  if( pAu
1990: 78 44 61 74 61 2d 3e 70 41 75 78 20 26 26 20 70  xData->pAux && p
19a0: 41 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65  AuxData->xDelete
19b0: 20 29 7b 0a 20 20 20 20 70 41 75 78 44 61 74 61   ){.    pAuxData
19c0: 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78 44 61  ->xDelete(pAuxDa
19d0: 74 61 2d 3e 70 41 75 78 29 3b 0a 20 20 7d 0a 20  ta->pAux);.  }. 
19e0: 20 70 41 75 78 44 61 74 61 2d 3e 70 41 75 78 20   pAuxData->pAux 
19f0: 3d 20 70 41 75 78 3b 0a 20 20 70 41 75 78 44 61  = pAux;.  pAuxDa
1a00: 74 61 2d 3e 78 44 65 6c 65 74 65 20 3d 20 78 44  ta->xDelete = xD
1a10: 65 6c 65 74 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  elete;.}../*.** 
1a20: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
1a30: 72 20 6f 66 20 74 69 6d 65 73 20 74 68 65 20 53  r of times the S
1a40: 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20  tep function of 
1a50: 61 20 61 67 67 72 65 67 61 74 65 20 68 61 73 20  a aggregate has 
1a60: 62 65 65 6e 20 0a 2a 2a 20 63 61 6c 6c 65 64 2e  been .** called.
1a70: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
1a80: 69 6e 65 20 69 73 20 64 65 66 69 6e 65 64 20 68  ine is defined h
1a90: 65 72 65 20 69 6e 20 76 64 62 65 2e 63 20 62 65  ere in vdbe.c be
1aa0: 63 61 75 73 65 20 69 74 20 64 65 70 65 6e 64 73  cause it depends
1ab0: 20 6f 6e 20 6b 6e 6f 77 69 6e 67 0a 2a 2a 20 74   on knowing.** t
1ac0: 68 65 20 69 6e 74 65 72 6e 61 6c 73 20 6f 66 20  he internals of 
1ad0: 74 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74  the sqlite3_cont
1ae0: 65 78 74 20 73 74 72 75 63 74 75 72 65 20 77 68  ext structure wh
1af0: 69 63 68 20 69 73 20 6f 6e 6c 79 20 64 65 66 69  ich is only defi
1b00: 6e 65 64 20 69 6e 0a 2a 2a 20 74 68 69 73 20 73  ned in.** this s
1b10: 6f 75 72 63 65 20 66 69 6c 65 2e 0a 2a 2f 0a 69  ource file..*/.i
1b20: 6e 74 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65  nt sqlite3_aggre
1b30: 67 61 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74  gate_count(sqlit
1b40: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a  e3_context *p){.
1b50: 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70    assert( p && p
1b60: 2d 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e 70 46  ->pFunc && p->pF
1b70: 75 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20  unc->xStep );.  
1b80: 72 65 74 75 72 6e 20 70 2d 3e 63 6e 74 3b 0a 7d  return p->cnt;.}
1b90: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
1ba0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c  he number of col
1bb0: 75 6d 6e 73 20 69 6e 20 74 68 65 20 72 65 73 75  umns in the resu
1bc0: 6c 74 20 73 65 74 20 66 6f 72 20 74 68 65 20 73  lt set for the s
1bd0: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a  tatement pStmt..
1be0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  */.int sqlite3_c
1bf0: 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 73 71 6c 69  olumn_count(sqli
1c00: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29  te3_stmt *pStmt)
1c10: 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20 3d 20  {.  Vdbe *pVm = 
1c20: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20  (Vdbe *)pStmt;. 
1c30: 20 72 65 74 75 72 6e 20 70 56 6d 20 3f 20 70 56   return pVm ? pV
1c40: 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3a 20  m->nResColumn : 
1c50: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  0;.}../*.** Retu
1c60: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  rn the number of
1c70: 20 76 61 6c 75 65 73 20 61 76 61 69 6c 61 62 6c   values availabl
1c80: 65 20 66 72 6f 6d 20 74 68 65 20 63 75 72 72 65  e from the curre
1c90: 6e 74 20 72 6f 77 20 6f 66 20 74 68 65 0a 2a 2a  nt row of the.**
1ca0: 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 63 75   currently execu
1cb0: 74 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 20 70  ting statement p
1cc0: 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  Stmt..*/.int sql
1cd0: 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74 28  ite3_data_count(
1ce0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
1cf0: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 56  tmt){.  Vdbe *pV
1d00: 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  m = (Vdbe *)pStm
1d10: 74 3b 0a 20 20 69 66 28 20 70 56 6d 3d 3d 30 20  t;.  if( pVm==0 
1d20: 7c 7c 20 21 70 56 6d 2d 3e 72 65 73 4f 6e 53 74  || !pVm->resOnSt
1d30: 61 63 6b 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  ack ) return 0;.
1d40: 20 20 72 65 74 75 72 6e 20 70 56 6d 2d 3e 6e 52    return pVm->nR
1d50: 65 73 43 6f 6c 75 6d 6e 3b 0a 7d 0a 0a 0a 2f 2a  esColumn;.}.../*
1d60: 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65  .** Check to see
1d70: 20 69 66 20 63 6f 6c 75 6d 6e 20 69 43 6f 6c 20   if column iCol 
1d80: 6f 66 20 74 68 65 20 67 69 76 65 6e 20 73 74 61  of the given sta
1d90: 74 65 6d 65 6e 74 20 69 73 20 76 61 6c 69 64 2e  tement is valid.
1da0: 20 20 49 66 0a 2a 2a 20 69 74 20 69 73 2c 20 72    If.** it is, r
1db0: 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20  eturn a pointer 
1dc0: 74 6f 20 74 68 65 20 4d 65 6d 20 66 6f 72 20 74  to the Mem for t
1dd0: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 61 74  he value of that
1de0: 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 49 66 20 69   column..** If i
1df0: 43 6f 6c 20 69 73 20 6e 6f 74 20 76 61 6c 69 64  Col is not valid
1e00: 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  , return a point
1e10: 65 72 20 74 6f 20 61 20 4d 65 6d 20 77 68 69 63  er to a Mem whic
1e20: 68 20 68 61 73 20 61 20 76 61 6c 75 65 0a 2a 2a  h has a value.**
1e30: 20 6f 66 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61   of NULL..*/.sta
1e40: 74 69 63 20 4d 65 6d 20 2a 63 6f 6c 75 6d 6e 4d  tic Mem *columnM
1e50: 65 6d 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  em(sqlite3_stmt 
1e60: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a  *pStmt, int i){.
1e70: 20 20 56 64 62 65 20 2a 70 56 6d 20 3d 20 28 56    Vdbe *pVm = (V
1e80: 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69  dbe *)pStmt;.  i
1e90: 6e 74 20 76 61 6c 73 20 3d 20 73 71 6c 69 74 65  nt vals = sqlite
1ea0: 33 5f 64 61 74 61 5f 63 6f 75 6e 74 28 70 53 74  3_data_count(pSt
1eb0: 6d 74 29 3b 0a 20 20 69 66 28 20 69 3e 3d 76 61  mt);.  if( i>=va
1ec0: 6c 73 20 7c 7c 20 69 3c 30 20 29 7b 0a 20 20 20  ls || i<0 ){.   
1ed0: 20 73 74 61 74 69 63 20 4d 65 6d 20 6e 75 6c 6c   static Mem null
1ee0: 4d 65 6d 3b 0a 20 20 20 20 69 66 28 20 6e 75 6c  Mem;.    if( nul
1ef0: 6c 4d 65 6d 2e 66 6c 61 67 73 3d 3d 30 20 29 7b  lMem.flags==0 ){
1f00: 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 67 73 20 3d   nullMem.flags =
1f10: 20 4d 45 4d 5f 4e 75 6c 6c 3b 20 7d 0a 20 20 20   MEM_Null; }.   
1f20: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 56   sqlite3Error(pV
1f30: 6d 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41  m->db, SQLITE_RA
1f40: 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74  NGE, 0);.    ret
1f50: 75 72 6e 20 26 6e 75 6c 6c 4d 65 6d 3b 0a 20 20  urn &nullMem;.  
1f60: 7d 0a 20 20 72 65 74 75 72 6e 20 26 70 56 6d 2d  }.  return &pVm-
1f70: 3e 70 54 6f 73 5b 28 31 2d 76 61 6c 73 29 2b 69  >pTos[(1-vals)+i
1f80: 5d 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a  ];.}../*********
1f90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1fa0: 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  *** sqlite3_colu
1fb0: 6d 6e 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  mn_  ***********
1fc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1fd0: 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c  ****.** The foll
1fe0: 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 61  owing routines a
1ff0: 72 65 20 75 73 65 64 20 74 6f 20 61 63 63 65 73  re used to acces
2000: 73 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20 74 68  s elements of th
2010: 65 20 63 75 72 72 65 6e 74 20 72 6f 77 0a 2a 2a  e current row.**
2020: 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73   in the result s
2030: 65 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69  et..*/.const voi
2040: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  d *sqlite3_colum
2050: 6e 5f 62 6c 6f 62 28 73 71 6c 69 74 65 33 5f 73  n_blob(sqlite3_s
2060: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
2070: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  i){.  return sql
2080: 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28  ite3_value_blob(
2090: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
20a0: 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c  ,i) );.}.int sql
20b0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65  ite3_column_byte
20c0: 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  s(sqlite3_stmt *
20d0: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
20e0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f   return sqlite3_
20f0: 76 61 6c 75 65 5f 62 79 74 65 73 28 20 63 6f 6c  value_bytes( col
2100: 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20  umnMem(pStmt,i) 
2110: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  );.}.int sqlite3
2120: 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 31 36 28  _column_bytes16(
2130: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
2140: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72  tmt, int i){.  r
2150: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
2160: 6c 75 65 5f 62 79 74 65 73 31 36 28 20 63 6f 6c  lue_bytes16( col
2170: 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20  umnMem(pStmt,i) 
2180: 29 3b 0a 7d 0a 64 6f 75 62 6c 65 20 73 71 6c 69  );.}.double sqli
2190: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62 6c  te3_column_doubl
21a0: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
21b0: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
21c0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f   return sqlite3_
21d0: 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 20 63 6f  value_double( co
21e0: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29  lumnMem(pStmt,i)
21f0: 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65   );.}.int sqlite
2200: 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 28 73 71 6c  3_column_int(sql
2210: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
2220: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75  , int i){.  retu
2230: 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  rn sqlite3_value
2240: 5f 69 6e 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  _int( columnMem(
2250: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 73 71  pStmt,i) );.}.sq
2260: 6c 69 74 65 5f 69 6e 74 36 34 20 73 71 6c 69 74  lite_int64 sqlit
2270: 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34 28  e3_column_int64(
2280: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
2290: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72  tmt, int i){.  r
22a0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
22b0: 6c 75 65 5f 69 6e 74 36 34 28 20 63 6f 6c 75 6d  lue_int64( colum
22c0: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
22d0: 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  .}.const unsigne
22e0: 64 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f  d char *sqlite3_
22f0: 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 73 71 6c 69  column_text(sqli
2300: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
2310: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
2320: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
2330: 74 65 78 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  text( columnMem(
2340: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 63 6f  pStmt,i) );.}.co
2350: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65  nst void *sqlite
2360: 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28  3_column_text16(
2370: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
2380: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72  tmt, int i){.  r
2390: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
23a0: 6c 75 65 5f 74 65 78 74 31 36 28 20 63 6f 6c 75  lue_text16( colu
23b0: 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29  mnMem(pStmt,i) )
23c0: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ;.}.int sqlite3_
23d0: 63 6f 6c 75 6d 6e 5f 74 79 70 65 28 73 71 6c 69  column_type(sqli
23e0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
23f0: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
2400: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
2410: 74 79 70 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  type( columnMem(
2420: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 0a 0a  pStmt,i) );.}...
2430: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
2440: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 4e 74 68   name of the Nth
2450: 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72   column of the r
2460: 65 73 75 6c 74 20 73 65 74 20 72 65 74 75 72 6e  esult set return
2470: 65 64 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74 61  ed by SQL.** sta
2480: 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f  tement pStmt..*/
2490: 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c  .const char *sql
24a0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65  ite3_column_name
24b0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
24c0: 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20  Stmt, int N){.  
24d0: 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20  Vdbe *p = (Vdbe 
24e0: 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a  *)pStmt;.  Mem *
24f0: 70 43 6f 6c 4e 61 6d 65 3b 0a 0a 20 20 69 66 28  pColName;..  if(
2500: 20 4e 3e 3d 73 71 6c 69 74 65 33 5f 63 6f 6c 75   N>=sqlite3_colu
2510: 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 20  mn_count(pStmt) 
2520: 7c 7c 20 4e 3c 30 20 29 7b 0a 20 20 20 20 72 65  || N<0 ){.    re
2530: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 70  turn 0;.  }..  p
2540: 43 6f 6c 4e 61 6d 65 20 3d 20 26 28 70 2d 3e 61  ColName = &(p->a
2550: 43 6f 6c 4e 61 6d 65 5b 4e 5d 29 3b 0a 20 20 72  ColName[N]);.  r
2560: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
2570: 6c 75 65 5f 74 65 78 74 28 70 43 6f 6c 4e 61 6d  lue_text(pColNam
2580: 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  e);.}../*.** Ret
2590: 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  urn the name of 
25a0: 74 68 65 20 27 69 27 74 68 20 63 6f 6c 75 6d 6e  the 'i'th column
25b0: 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 73   of the result s
25c0: 65 74 20 6f 66 20 53 51 4c 20 73 74 61 74 65 6d  et of SQL statem
25d0: 65 6e 74 0a 2a 2a 20 70 53 74 6d 74 2c 20 65 6e  ent.** pStmt, en
25e0: 63 6f 64 65 64 20 61 73 20 55 54 46 2d 31 36 2e  coded as UTF-16.
25f0: 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a  .*/.const void *
2600: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e  sqlite3_column_n
2610: 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73 74  ame16(sqlite3_st
2620: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e  mt *pStmt, int N
2630: 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  ){.  Vdbe *p = (
2640: 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20  Vdbe *)pStmt;.  
2650: 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 0a  Mem *pColName;..
2660: 20 20 69 66 28 20 4e 3e 3d 73 71 6c 69 74 65 33    if( N>=sqlite3
2670: 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70 53  _column_count(pS
2680: 74 6d 74 29 20 7c 7c 20 4e 3c 30 20 29 7b 0a 20  tmt) || N<0 ){. 
2690: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
26a0: 0a 0a 20 20 70 43 6f 6c 4e 61 6d 65 20 3d 20 26  ..  pColName = &
26b0: 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29  (p->aColName[N])
26c0: 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  ;.  return sqlit
26d0: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28  e3_value_text16(
26e0: 70 43 6f 6c 4e 61 6d 65 29 3b 0a 7d 0a 0a 2f 2a  pColName);.}../*
26f0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63  .** Return the c
2700: 6f 6c 75 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f  olumn declaratio
2710: 6e 20 74 79 70 65 20 28 69 66 20 61 70 70 6c 69  n type (if appli
2720: 63 61 62 6c 65 29 20 6f 66 20 74 68 65 20 27 69  cable) of the 'i
2730: 27 74 68 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66  'th column.** of
2740: 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20   the result set 
2750: 6f 66 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  of SQL statement
2760: 20 70 53 74 6d 74 2c 20 65 6e 63 6f 64 65 64 20   pStmt, encoded 
2770: 61 73 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e  as UTF-8..*/.con
2780: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33  st char *sqlite3
2790: 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65  _column_decltype
27a0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
27b0: 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20  Stmt, int N){.  
27c0: 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20  Vdbe *p = (Vdbe 
27d0: 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a  *)pStmt;.  Mem *
27e0: 70 43 6f 6c 4e 61 6d 65 3b 0a 0a 20 20 69 66 28  pColName;..  if(
27f0: 20 4e 3e 3d 73 71 6c 69 74 65 33 5f 63 6f 6c 75   N>=sqlite3_colu
2800: 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 20  mn_count(pStmt) 
2810: 7c 7c 20 4e 3c 30 20 29 7b 0a 20 20 20 20 72 65  || N<0 ){.    re
2820: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 70  turn 0;.  }..  p
2830: 43 6f 6c 4e 61 6d 65 20 3d 20 26 28 70 2d 3e 61  ColName = &(p->a
2840: 43 6f 6c 4e 61 6d 65 5b 4e 2b 73 71 6c 69 74 65  ColName[N+sqlite
2850: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70  3_column_count(p
2860: 53 74 6d 74 29 5d 29 3b 0a 20 20 72 65 74 75 72  Stmt)]);.  retur
2870: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
2880: 74 65 78 74 28 70 43 6f 6c 4e 61 6d 65 29 3b 0a  text(pColName);.
2890: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
28a0: 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 63 6c 61  the column decla
28b0: 72 61 74 69 6f 6e 20 74 79 70 65 20 28 69 66 20  ration type (if 
28c0: 61 70 70 6c 69 63 61 62 6c 65 29 20 6f 66 20 74  applicable) of t
28d0: 68 65 20 27 69 27 74 68 20 63 6f 6c 75 6d 6e 0a  he 'i'th column.
28e0: 2a 2a 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ** of the result
28f0: 20 73 65 74 20 6f 66 20 53 51 4c 20 73 74 61 74   set of SQL stat
2900: 65 6d 65 6e 74 20 70 53 74 6d 74 2c 20 65 6e 63  ement pStmt, enc
2910: 6f 64 65 64 20 61 73 20 55 54 46 2d 31 36 2e 0a  oded as UTF-16..
2920: 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73  */.const void *s
2930: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65  qlite3_column_de
2940: 63 6c 74 79 70 65 31 36 28 73 71 6c 69 74 65 33  cltype16(sqlite3
2950: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
2960: 74 20 4e 29 7b 0a 20 20 56 64 62 65 20 2a 70 20  t N){.  Vdbe *p 
2970: 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b  = (Vdbe *)pStmt;
2980: 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65  .  Mem *pColName
2990: 3b 0a 0a 20 20 69 66 28 20 4e 3e 3d 73 71 6c 69  ;..  if( N>=sqli
29a0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74  te3_column_count
29b0: 28 70 53 74 6d 74 29 20 7c 7c 20 4e 3c 30 20 29  (pStmt) || N<0 )
29c0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a  {.    return 0;.
29d0: 20 20 7d 0a 0a 20 20 70 43 6f 6c 4e 61 6d 65 20    }..  pColName 
29e0: 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b  = &(p->aColName[
29f0: 4e 2b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  N+sqlite3_column
2a00: 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 5d 29 3b  _count(pStmt)]);
2a10: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
2a20: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 70  3_value_text16(p
2a30: 43 6f 6c 4e 61 6d 65 29 3b 0a 7d 0a 0a 2f 2a 2a  ColName);.}../**
2a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71  ************* sq
2a60: 6c 69 74 65 33 5f 62 69 6e 64 5f 20 20 2a 2a 2a  lite3_bind_  ***
2a70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a80: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 0a 2a 2a 20  ********.** .** 
2a90: 52 6f 75 74 69 6e 65 73 20 75 73 65 64 20 74 6f  Routines used to
2aa0: 20 61 74 74 61 63 68 20 76 61 6c 75 65 73 20 74   attach values t
2ab0: 6f 20 77 69 6c 64 63 61 72 64 73 20 69 6e 20 61  o wildcards in a
2ac0: 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20 73 74   compiled SQL st
2ad0: 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 2f 2a 0a 2a  atement..*/./*.*
2ae0: 2a 20 55 6e 62 69 6e 64 20 74 68 65 20 76 61 6c  * Unbind the val
2af0: 75 65 20 62 6f 75 6e 64 20 74 6f 20 76 61 72 69  ue bound to vari
2b00: 61 62 6c 65 20 69 20 69 6e 20 76 69 72 74 75 61  able i in virtua
2b10: 6c 20 6d 61 63 68 69 6e 65 20 70 2e 20 54 68 69  l machine p. Thi
2b20: 73 20 69 73 20 74 68 65 20 0a 2a 2a 20 74 68 65  s is the .** the
2b30: 20 73 61 6d 65 20 61 73 20 62 69 6e 64 69 6e 67   same as binding
2b40: 20 61 20 4e 55 4c 4c 20 76 61 6c 75 65 20 74 6f   a NULL value to
2b50: 20 74 68 65 20 63 6f 6c 75 6d 6e 2e 20 49 66 20   the column. If 
2b60: 74 68 65 20 22 69 22 20 70 61 72 61 6d 65 74 65  the "i" paramete
2b70: 72 20 69 73 0a 2a 2a 20 6f 75 74 20 6f 66 20 72  r is.** out of r
2b80: 61 6e 67 65 2c 20 74 68 65 6e 20 53 51 4c 49 54  ange, then SQLIT
2b90: 45 5f 52 41 4e 47 45 20 69 73 20 72 65 74 75 72  E_RANGE is retur
2ba0: 6e 65 64 2e 20 4f 74 68 65 77 69 73 65 20 53 51  ned. Othewise SQ
2bb0: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 54  LITE_OK..**.** T
2bc0: 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 73 74  he error code st
2bd0: 6f 72 65 64 20 69 6e 20 64 61 74 61 62 61 73 65  ored in database
2be0: 20 70 2d 3e 64 62 20 69 73 20 6f 76 65 72 77 72   p->db is overwr
2bf0: 69 74 74 65 6e 20 77 69 74 68 20 74 68 65 20 72  itten with the r
2c00: 65 74 75 72 6e 0a 2a 2a 20 76 61 6c 75 65 20 69  eturn.** value i
2c10: 6e 20 61 6e 79 20 63 61 73 65 2e 0a 2a 2f 0a 73  n any case..*/.s
2c20: 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 55 6e  tatic int vdbeUn
2c30: 62 69 6e 64 28 56 64 62 65 20 2a 70 2c 20 69 6e  bind(Vdbe *p, in
2c40: 74 20 69 29 7b 0a 20 20 4d 65 6d 20 2a 70 56 61  t i){.  Mem *pVa
2c50: 72 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c  r;.  if( p==0 ||
2c60: 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f   p->magic!=VDBE_
2c70: 4d 41 47 49 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e  MAGIC_RUN || p->
2c80: 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c  pc>=0 ){.    sql
2c90: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c  ite3Error(p->db,
2ca0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20   SQLITE_MISUSE, 
2cb0: 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  0);.    return S
2cc0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
2cd0: 7d 0a 20 20 69 66 28 20 69 3c 31 20 7c 7c 20 69  }.  if( i<1 || i
2ce0: 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 20  >p->nVar ){.    
2cf0: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e  sqlite3Error(p->
2d00: 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  db, SQLITE_RANGE
2d10: 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  , 0);.    return
2d20: 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 3b 0a 20   SQLITE_RANGE;. 
2d30: 20 7d 0a 20 20 69 2d 2d 3b 0a 20 20 70 56 61 72   }.  i--;.  pVar
2d40: 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69 5d 3b 0a   = &p->aVar[i];.
2d50: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
2d60: 52 65 6c 65 61 73 65 28 70 56 61 72 29 3b 0a 20  Release(pVar);. 
2d70: 20 70 56 61 72 2d 3e 66 6c 61 67 73 20 3d 20 4d   pVar->flags = M
2d80: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 73 71 6c 69 74  EM_Null;.  sqlit
2d90: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53  e3Error(p->db, S
2da0: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20  QLITE_OK, 0);.  
2db0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
2dc0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e 64 20  ;.}../*.** Bind 
2dd0: 61 20 62 6c 6f 62 20 76 61 6c 75 65 20 74 6f 20  a blob value to 
2de0: 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  an SQL statement
2df0: 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 69 6e   variable..*/.in
2e00: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 62  t sqlite3_bind_b
2e10: 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  lob(.  sqlite3_s
2e20: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69  tmt *pStmt, .  i
2e30: 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76  nt i, .  const v
2e40: 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69  oid *zData, .  i
2e50: 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69  nt nData, .  voi
2e60: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29  d (*xDel)(void*)
2e70: 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  .){.  Vdbe *p = 
2e80: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20  (Vdbe *)pStmt;. 
2e90: 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20 20 69 6e   Mem *pVar;.  in
2ea0: 74 20 72 63 3b 0a 0a 20 20 72 63 20 3d 20 76 64  t rc;..  rc = vd
2eb0: 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a  beUnbind(p, i);.
2ec0: 20 20 69 66 28 20 72 63 20 7c 7c 20 7a 44 61 74    if( rc || zDat
2ed0: 61 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  a==0 ){.    retu
2ee0: 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 56 61  rn rc;.  }.  pVa
2ef0: 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69 2d 31  r = &p->aVar[i-1
2f00: 5d 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  ];.  rc = sqlite
2f10: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70  3VdbeMemSetStr(p
2f20: 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74  Var, zData, nDat
2f30: 61 2c 20 30 2c 20 78 44 65 6c 29 3b 0a 20 20 72  a, 0, xDel);.  r
2f40: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
2f50: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f 75  sqlite3_bind_dou
2f60: 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ble(sqlite3_stmt
2f70: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20   *pStmt, int i, 
2f80: 64 6f 75 62 6c 65 20 72 56 61 6c 75 65 29 7b 0a  double rValue){.
2f90: 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65    int rc;.  Vdbe
2fa0: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
2fb0: 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65  tmt;.  rc = vdbe
2fc0: 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20  Unbind(p, i);.  
2fd0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
2fe0: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  K ){.    sqlite3
2ff0: 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65  VdbeMemSetDouble
3000: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20  (&p->aVar[i-1], 
3010: 72 56 61 6c 75 65 29 3b 0a 20 20 7d 0a 20 20 72  rValue);.  }.  r
3020: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
3030: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74  sqlite3_bind_int
3040: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
3050: 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 69 56 61  , int i, int iVa
3060: 6c 75 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  lue){.  return s
3070: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36  qlite3_bind_int6
3080: 34 28 70 2c 20 69 2c 20 28 69 36 34 29 69 56 61  4(p, i, (i64)iVa
3090: 6c 75 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69  lue);.}.int sqli
30a0: 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34 28 73  te3_bind_int64(s
30b0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
30c0: 6d 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c 69 74  mt, int i, sqlit
30d0: 65 5f 69 6e 74 36 34 20 69 56 61 6c 75 65 29 7b  e_int64 iValue){
30e0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62  .  int rc;.  Vdb
30f0: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
3100: 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62  Stmt;.  rc = vdb
3110: 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20  eUnbind(p, i);. 
3120: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
3130: 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  OK ){.    sqlite
3140: 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34  3VdbeMemSetInt64
3150: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20  (&p->aVar[i-1], 
3160: 69 56 61 6c 75 65 29 3b 0a 20 20 7d 0a 20 20 72  iValue);.  }.  r
3170: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
3180: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c  sqlite3_bind_nul
3190: 6c 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 20  l(sqlite3_stmt* 
31a0: 70 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74  p, int i){.  ret
31b0: 75 72 6e 20 76 64 62 65 55 6e 62 69 6e 64 28 28  urn vdbeUnbind((
31c0: 56 64 62 65 20 2a 29 70 2c 20 69 29 3b 0a 7d 0a  Vdbe *)p, i);.}.
31d0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
31e0: 5f 74 65 78 74 28 20 0a 20 20 73 71 6c 69 74 65  _text( .  sqlite
31f0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a  3_stmt *pStmt, .
3200: 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73    int i, .  cons
3210: 74 20 63 68 61 72 20 2a 7a 44 61 74 61 2c 20 0a  t char *zData, .
3220: 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20    int nData, .  
3230: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
3240: 64 2a 29 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70  d*).){.  Vdbe *p
3250: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74   = (Vdbe *)pStmt
3260: 3b 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20  ;.  Mem *pVar;. 
3270: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 72 63 20 3d   int rc;..  rc =
3280: 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69   vdbeUnbind(p, i
3290: 29 3b 0a 20 20 69 66 28 20 72 63 20 7c 7c 20 7a  );.  if( rc || z
32a0: 44 61 74 61 3d 3d 30 20 29 7b 0a 20 20 20 20 72  Data==0 ){.    r
32b0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
32c0: 70 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b  pVar = &p->aVar[
32d0: 69 2d 31 5d 3b 0a 20 20 72 63 20 3d 20 73 71 6c  i-1];.  rc = sql
32e0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
32f0: 72 28 70 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e  r(pVar, zData, n
3300: 44 61 74 61 2c 20 53 51 4c 49 54 45 5f 55 54 46  Data, SQLITE_UTF
3310: 38 2c 20 78 44 65 6c 29 3b 0a 20 20 69 66 28 20  8, xDel);.  if( 
3320: 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  rc ){.    return
3330: 20 72 63 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20   rc;.  }.  rc = 
3340: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
3350: 65 45 6e 63 6f 64 69 6e 67 28 70 56 61 72 2c 20  eEncoding(pVar, 
3360: 70 2d 3e 64 62 2d 3e 65 6e 63 29 3b 0a 20 20 72  p->db->enc);.  r
3370: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
3380: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78  sqlite3_bind_tex
3390: 74 31 36 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  t16(.  sqlite3_s
33a0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69  tmt *pStmt, .  i
33b0: 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76  nt i, .  const v
33c0: 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69  oid *zData, .  i
33d0: 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69  nt nData, .  voi
33e0: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29  d (*xDel)(void*)
33f0: 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  .){.  Vdbe *p = 
3400: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20  (Vdbe *)pStmt;. 
3410: 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20 20 69 6e   Mem *pVar;.  in
3420: 74 20 72 63 3b 0a 0a 20 20 72 63 20 3d 20 76 64  t rc;..  rc = vd
3430: 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a  beUnbind(p, i);.
3440: 20 20 69 66 28 20 72 63 20 7c 7c 20 7a 44 61 74    if( rc || zDat
3450: 61 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  a==0 ){.    retu
3460: 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 56 61  rn rc;.  }.  pVa
3470: 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69 2d 31  r = &p->aVar[i-1
3480: 5d 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  ];..  rc = sqlit
3490: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
34a0: 70 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61  pVar, zData, nDa
34b0: 74 61 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  ta, SQLITE_UTF16
34c0: 4e 41 54 49 56 45 2c 20 78 44 65 6c 29 3b 0a 20  NATIVE, xDel);. 
34d0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72   if( rc ){.    r
34e0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
34f0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
3500: 43 68 61 6e 67 65 45 6e 63 6f 64 69 6e 67 28 70  ChangeEncoding(p
3510: 56 61 72 2c 20 70 2d 3e 64 62 2d 3e 65 6e 63 29  Var, p->db->enc)
3520: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
3530: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
3540: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 77 69 6c  he number of wil
3550: 64 63 61 72 64 73 20 74 68 61 74 20 63 61 6e 20  dcards that can 
3560: 62 65 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 62  be potentially b
3570: 6f 75 6e 64 20 74 6f 2e 0a 2a 2a 20 54 68 69 73  ound to..** This
3580: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 64 64 65   routine is adde
3590: 64 20 74 6f 20 73 75 70 70 6f 72 74 20 44 42 44  d to support DBD
35a0: 3a 3a 53 51 4c 69 74 65 2e 20 20 0a 2a 2f 0a 69  ::SQLite.  .*/.i
35b0: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  nt sqlite3_bind_
35c0: 70 61 72 61 6d 65 74 65 72 5f 63 6f 75 6e 74 28  parameter_count(
35d0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
35e0: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20  tmt){.  Vdbe *p 
35f0: 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a  = (Vdbe*)pStmt;.
3600: 20 20 72 65 74 75 72 6e 20 70 20 3f 20 70 2d 3e    return p ? p->
3610: 6e 56 61 72 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a  nVar : 0;.}../*.
3620: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61  ** Return the na
3630: 6d 65 20 6f 66 20 61 20 77 69 6c 64 63 61 72 64  me of a wildcard
3640: 20 70 61 72 61 6d 65 74 65 72 2e 20 20 52 65 74   parameter.  Ret
3650: 75 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 20  urn NULL if the 
3660: 69 6e 64 65 78 0a 2a 2a 20 69 73 20 6f 75 74 20  index.** is out 
3670: 6f 66 20 72 61 6e 67 65 20 6f 72 20 69 66 20 74  of range or if t
3680: 68 65 20 77 69 6c 64 63 61 72 64 20 69 73 20 75  he wildcard is u
3690: 6e 6e 61 6d 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  nnamed..**.** Th
36a0: 65 20 72 65 73 75 6c 74 20 69 73 20 61 6c 77 61  e result is alwa
36b0: 79 73 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e  ys UTF-8..*/.con
36c0: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33  st char *sqlite3
36d0: 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f  _bind_parameter_
36e0: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  name(sqlite3_stm
36f0: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
3700: 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56  {.  Vdbe *p = (V
3710: 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66  dbe*)pStmt;.  if
3720: 28 20 70 3d 3d 30 20 7c 7c 20 69 3c 31 20 7c 7c  ( p==0 || i<1 ||
3730: 20 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20   i>p->nVar ){.  
3740: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
3750: 20 20 69 66 28 20 21 70 2d 3e 6f 6b 56 61 72 20    if( !p->okVar 
3760: 29 7b 0a 20 20 20 20 69 6e 74 20 6a 3b 0a 20 20  ){.    int j;.  
3770: 20 20 4f 70 20 2a 70 4f 70 3b 0a 20 20 20 20 66    Op *pOp;.    f
3780: 6f 72 28 6a 3d 30 2c 20 70 4f 70 3d 70 2d 3e 61  or(j=0, pOp=p->a
3790: 4f 70 3b 20 6a 3c 70 2d 3e 6e 4f 70 3b 20 6a 2b  Op; j<p->nOp; j+
37a0: 2b 2c 20 70 4f 70 2b 2b 29 7b 0a 20 20 20 20 20  +, pOp++){.     
37b0: 20 69 66 28 20 70 4f 70 2d 3e 6f 70 63 6f 64 65   if( pOp->opcode
37c0: 3d 3d 4f 50 5f 56 61 72 69 61 62 6c 65 20 29 7b  ==OP_Variable ){
37d0: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
37e0: 20 70 4f 70 2d 3e 70 31 3e 30 20 26 26 20 70 4f   pOp->p1>0 && pO
37f0: 70 2d 3e 70 31 3c 3d 70 2d 3e 6e 56 61 72 20 29  p->p1<=p->nVar )
3800: 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 61 7a 56  ;.        p->azV
3810: 61 72 5b 70 4f 70 2d 3e 70 31 2d 31 5d 20 3d 20  ar[pOp->p1-1] = 
3820: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 7d  pOp->p3;.      }
3830: 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 6f 6b  .    }.    p->ok
3840: 56 61 72 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72  Var = 1;.  }.  r
3850: 65 74 75 72 6e 20 70 2d 3e 61 7a 56 61 72 5b 69  eturn p->azVar[i
3860: 2d 31 5d 3b 0a 7d 0a                             -1];.}.