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

Artifact bcf5821ed09070d586898374b905861c4dd73d0b:


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 4d 65 6d 20 2a 70 20 3d 20 28 4d 65  {.  Mem *p = (Me
0390: 6d 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28 20 28  m*)pVal;.  if( (
03a0: 70 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 42  p->flags & MEM_B
03b0: 6c 6f 62 29 21 3d 30 20 7c 7c 20 73 71 6c 69 74  lob)!=0 || sqlit
03c0: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 70 56  e3_value_text(pV
03d0: 61 6c 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  al) ){.    retur
03e0: 6e 20 70 2d 3e 6e 3b 0a 20 20 7d 0a 20 20 72 65  n p->n;.  }.  re
03f0: 74 75 72 6e 20 30 3b 0a 7d 0a 69 6e 74 20 73 71  turn 0;.}.int sq
0400: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65  lite3_value_byte
0410: 73 31 36 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  s16(sqlite3_valu
0420: 65 20 2a 70 56 61 6c 29 7b 0a 20 20 4d 65 6d 20  e *pVal){.  Mem 
0430: 2a 70 20 3d 20 28 4d 65 6d 2a 29 70 56 61 6c 3b  *p = (Mem*)pVal;
0440: 0a 20 20 69 66 28 20 28 70 2d 3e 66 6c 61 67 73  .  if( (p->flags
0450: 20 26 20 4d 45 4d 5f 42 6c 6f 62 29 21 3d 30 20   & MEM_Blob)!=0 
0460: 7c 7c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  || sqlite3_value
0470: 5f 74 65 78 74 31 36 28 70 56 61 6c 29 20 29 7b  _text16(pVal) ){
0480: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 28 4d 65  .    return ((Me
0490: 6d 20 2a 29 70 56 61 6c 29 2d 3e 6e 3b 0a 20 20  m *)pVal)->n;.  
04a0: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
04b0: 64 6f 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 76  double sqlite3_v
04c0: 61 6c 75 65 5f 64 6f 75 62 6c 65 28 73 71 6c 69  alue_double(sqli
04d0: 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29  te3_value *pVal)
04e0: 7b 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20  {.  Mem *pMem = 
04f0: 28 4d 65 6d 20 2a 29 70 56 61 6c 3b 0a 20 20 73  (Mem *)pVal;.  s
0500: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 61  qlite3VdbeMemRea
0510: 6c 69 66 79 28 70 4d 65 6d 29 3b 0a 20 20 72 65  lify(pMem);.  re
0520: 74 75 72 6e 20 70 4d 65 6d 2d 3e 72 3b 0a 7d 0a  turn pMem->r;.}.
0530: 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  int sqlite3_valu
0540: 65 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 76 61  e_int(sqlite3_va
0550: 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 4d 65  lue *pVal){.  Me
0560: 6d 20 2a 70 4d 65 6d 20 3d 20 28 4d 65 6d 20 2a  m *pMem = (Mem *
0570: 29 70 56 61 6c 3b 0a 20 20 73 71 6c 69 74 65 33  )pVal;.  sqlite3
0580: 56 64 62 65 4d 65 6d 49 6e 74 65 67 65 72 69 66  VdbeMemIntegerif
0590: 79 28 70 4d 65 6d 29 3b 0a 20 20 72 65 74 75 72  y(pMem);.  retur
05a0: 6e 20 28 69 6e 74 29 70 56 61 6c 2d 3e 69 3b 0a  n (int)pVal->i;.
05b0: 7d 0a 6c 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 20  }.long long int 
05c0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e  sqlite3_value_in
05d0: 74 36 34 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  t64(sqlite3_valu
05e0: 65 20 2a 70 56 61 6c 29 7b 0a 20 20 4d 65 6d 20  e *pVal){.  Mem 
05f0: 2a 70 4d 65 6d 20 3d 20 28 4d 65 6d 20 2a 29 70  *pMem = (Mem *)p
0600: 56 61 6c 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  Val;.  sqlite3Vd
0610: 62 65 4d 65 6d 49 6e 74 65 67 65 72 69 66 79 28  beMemIntegerify(
0620: 70 4d 65 6d 29 3b 0a 20 20 72 65 74 75 72 6e 20  pMem);.  return 
0630: 70 56 61 6c 2d 3e 69 3b 0a 7d 0a 63 6f 6e 73 74  pVal->i;.}.const
0640: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
0650: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
0660: 78 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  xt(sqlite3_value
0670: 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72   *pVal){.  retur
0680: 6e 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29  n (const char *)
0690: 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74  sqlite3ValueText
06a0: 28 70 56 61 6c 2c 20 54 45 58 54 5f 55 74 66 38  (pVal, TEXT_Utf8
06b0: 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 64 20  );.}.const void 
06c0: 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  *sqlite3_value_t
06d0: 65 78 74 31 36 28 73 71 6c 69 74 65 33 5f 76 61  ext16(sqlite3_va
06e0: 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20 20 72 65  lue* pVal){.  re
06f0: 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61 6c 75  turn sqlite3Valu
0700: 65 54 65 78 74 28 70 56 61 6c 2c 20 54 45 58 54  eText(pVal, TEXT
0710: 5f 55 74 66 31 36 29 3b 0a 7d 0a 69 6e 74 20 73  _Utf16);.}.int s
0720: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
0730: 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a  e(sqlite3_value*
0740: 20 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e   pVal){.  return
0750: 20 70 56 61 6c 2d 3e 74 79 70 65 3b 0a 7d 0a 0a   pVal->type;.}..
0760: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
0770: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71  ************* sq
0780: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 20 20 2a  lite3_result_  *
0790: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
07a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
07b0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
07c0: 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73 65  routines are use
07d0: 64 20 62 79 20 75 73 65 72 2d 64 65 66 69 6e 65  d by user-define
07e0: 64 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 73  d functions to s
07f0: 70 65 63 69 66 79 0a 2a 2a 20 74 68 65 20 66 75  pecify.** the fu
0800: 6e 63 74 69 6f 6e 20 72 65 73 75 6c 74 2e 0a 2a  nction result..*
0810: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72  /.void sqlite3_r
0820: 65 73 75 6c 74 5f 62 6c 6f 62 28 0a 20 20 73 71  esult_blob(.  sq
0830: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
0840: 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f  Ctx, .  const vo
0850: 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c  id *z, .  int n,
0860: 20 0a 20 20 69 6e 74 20 65 43 6f 70 79 0a 29 7b   .  int eCopy.){
0870: 0a 20 20 61 73 73 65 72 74 28 20 6e 3e 30 20 29  .  assert( n>0 )
0880: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ;.  sqlite3VdbeM
0890: 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e  emSetStr(&pCtx->
08a0: 73 2c 20 7a 2c 20 6e 2c 20 30 2c 20 65 43 6f 70  s, z, n, 0, eCop
08b0: 79 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74  y);.}.void sqlit
08c0: 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65  e3_result_double
08d0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
08e0: 20 2a 70 43 74 78 2c 20 64 6f 75 62 6c 65 20 72   *pCtx, double r
08f0: 56 61 6c 29 7b 0a 20 20 73 71 6c 69 74 65 33 56  Val){.  sqlite3V
0900: 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65 28  dbeMemSetDouble(
0910: 26 70 43 74 78 2d 3e 73 2c 20 72 56 61 6c 29 3b  &pCtx->s, rVal);
0920: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0930: 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 73 71 6c  result_error(sql
0940: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
0950: 74 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  tx, const char *
0960: 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 70 43 74  z, int n){.  pCt
0970: 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 31 3b 0a  x->isError = 1;.
0980: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
0990: 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c  SetStr(&pCtx->s,
09a0: 20 7a 2c 20 6e 2c 20 54 45 58 54 5f 55 74 66 38   z, n, TEXT_Utf8
09b0: 2c 20 31 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  , 1);.}.void sql
09c0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f  ite3_result_erro
09d0: 72 31 36 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  r16(sqlite3_cont
09e0: 65 78 74 20 2a 70 43 74 78 2c 20 63 6f 6e 73 74  ext *pCtx, const
09f0: 20 76 6f 69 64 20 2a 7a 2c 20 69 6e 74 20 6e 29   void *z, int n)
0a00: 7b 0a 20 20 70 43 74 78 2d 3e 69 73 45 72 72 6f  {.  pCtx->isErro
0a10: 72 20 3d 20 31 3b 0a 20 20 73 71 6c 69 74 65 33  r = 1;.  sqlite3
0a20: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70  VdbeMemSetStr(&p
0a30: 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 54 45  Ctx->s, z, n, TE
0a40: 58 54 5f 55 74 66 31 36 2c 20 31 29 3b 0a 7d 0a  XT_Utf16, 1);.}.
0a50: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73  void sqlite3_res
0a60: 75 6c 74 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f  ult_int(sqlite3_
0a70: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69  context *pCtx, i
0a80: 6e 74 20 69 56 61 6c 29 7b 0a 20 20 73 71 6c 69  nt iVal){.  sqli
0a90: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74  te3VdbeMemSetInt
0aa0: 36 34 28 26 70 43 74 78 2d 3e 73 2c 20 28 69 36  64(&pCtx->s, (i6
0ab0: 34 29 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20  4)iVal);.}.void 
0ac0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69  sqlite3_result_i
0ad0: 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 63 6f 6e  nt64(sqlite3_con
0ae0: 74 65 78 74 20 2a 70 43 74 78 2c 20 69 36 34 20  text *pCtx, i64 
0af0: 69 56 61 6c 29 7b 0a 20 20 73 71 6c 69 74 65 33  iVal){.  sqlite3
0b00: 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28  VdbeMemSetInt64(
0b10: 26 70 43 74 78 2d 3e 73 2c 20 69 56 61 6c 29 3b  &pCtx->s, iVal);
0b20: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0b30: 72 65 73 75 6c 74 5f 6e 75 6c 6c 28 73 71 6c 69  result_null(sqli
0b40: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
0b50: 78 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  x){.  sqlite3Vdb
0b60: 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 26 70 43 74  eMemSetNull(&pCt
0b70: 78 2d 3e 73 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  x->s);.}.void sq
0b80: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78  lite3_result_tex
0b90: 74 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  t(.  sqlite3_con
0ba0: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63  text *pCtx, .  c
0bb0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 0a 20  onst char *z, . 
0bc0: 20 69 6e 74 20 6e 2c 0a 20 20 69 6e 74 20 65 43   int n,.  int eC
0bd0: 6f 70 79 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33  opy.){.  sqlite3
0be0: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70  VdbeMemSetStr(&p
0bf0: 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 54 45  Ctx->s, z, n, TE
0c00: 58 54 5f 55 74 66 38 2c 20 65 43 6f 70 79 29 3b  XT_Utf8, eCopy);
0c10: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0c20: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 28 0a 20  result_text16(. 
0c30: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
0c40: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74   *pCtx, .  const
0c50: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74   void *z, .  int
0c60: 20 6e 2c 20 0a 20 20 69 6e 74 20 65 43 6f 70 79   n, .  int eCopy
0c70: 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  .){.  sqlite3Vdb
0c80: 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78  eMemSetStr(&pCtx
0c90: 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 54 45 58 54 5f  ->s, z, n, TEXT_
0ca0: 55 74 66 31 36 2c 20 65 43 6f 70 79 29 3b 0a 7d  Utf16, eCopy);.}
0cb0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
0cc0: 73 75 6c 74 5f 76 61 6c 75 65 28 73 71 6c 69 74  sult_value(sqlit
0cd0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
0ce0: 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  , sqlite3_value 
0cf0: 2a 70 56 61 6c 75 65 29 7b 0a 20 20 73 71 6c 69  *pValue){.  sqli
0d00: 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79 28 26  te3VdbeMemCopy(&
0d10: 70 43 74 78 2d 3e 73 2c 20 70 56 61 6c 75 65 29  pCtx->s, pValue)
0d20: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63  ;.}.../*.** Exec
0d30: 75 74 65 20 74 68 65 20 73 74 61 74 65 6d 65 6e  ute the statemen
0d40: 74 20 70 53 74 6d 74 2c 20 65 69 74 68 65 72 20  t pStmt, either 
0d50: 75 6e 74 69 6c 20 61 20 72 6f 77 20 6f 66 20 64  until a row of d
0d60: 61 74 61 20 69 73 20 72 65 61 64 79 2c 20 74 68  ata is ready, th
0d70: 65 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 69  e.** statement i
0d80: 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 65 78 65  s completely exe
0d90: 63 75 74 65 64 20 6f 72 20 61 6e 20 65 72 72 6f  cuted or an erro
0da0: 72 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74  r occurs..*/.int
0db0: 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 73 71   sqlite3_step(sq
0dc0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
0dd0: 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  t){.  Vdbe *p = 
0de0: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20  (Vdbe*)pStmt;.  
0df0: 73 71 6c 69 74 65 20 2a 64 62 3b 0a 20 20 69 6e  sqlite *db;.  in
0e00: 74 20 72 63 3b 0a 0a 20 20 69 66 28 20 70 2d 3e  t rc;..  if( p->
0e10: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
0e20: 43 5f 52 55 4e 20 29 7b 0a 20 20 20 20 72 65 74  C_RUN ){.    ret
0e30: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
0e40: 45 3b 0a 20 20 7d 0a 20 20 64 62 20 3d 20 70 2d  E;.  }.  db = p-
0e50: 3e 64 62 3b 0a 20 20 69 66 28 20 73 71 6c 69 74  >db;.  if( sqlit
0e60: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29  e3SafetyOn(db) )
0e70: 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51  {.    p->rc = SQ
0e80: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 20  LITE_MISUSE;.   
0e90: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
0ea0: 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66 28  ISUSE;.  }.  if(
0eb0: 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 20 20 20 20   p->pc<0 ){.    
0ec0: 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e  db->activeVdbeCn
0ed0: 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e 70 63 20 3d  t++;.    p->pc =
0ee0: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d   0;.  }.  if( p-
0ef0: 3e 65 78 70 6c 61 69 6e 20 29 7b 0a 20 20 20 20  >explain ){.    
0f00: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
0f10: 4c 69 73 74 28 70 29 3b 0a 20 20 7d 65 6c 73 65  List(p);.  }else
0f20: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
0f30: 65 33 56 64 62 65 45 78 65 63 28 70 29 3b 0a 20  e3VdbeExec(p);. 
0f40: 20 7d 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65   }..  if( sqlite
0f50: 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 20 29  3SafetyOff(db) )
0f60: 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  {.    rc = SQLIT
0f70: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20  E_MISUSE;.  }.. 
0f80: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d   sqlite3Error(p-
0f90: 3e 64 62 2c 20 72 63 2c 20 70 2d 3e 7a 45 72 72  >db, rc, p->zErr
0fa0: 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  Msg);.  return r
0fb0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72  c;.}../*.** Extr
0fc0: 61 63 74 20 74 68 65 20 75 73 65 72 20 64 61 74  act the user dat
0fd0: 61 20 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33  a from a sqlite3
0fe0: 5f 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75  _context structu
0ff0: 72 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a  re and return a.
1000: 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74  ** pointer to it
1010: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
1020: 65 33 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c  e3_user_data(sql
1030: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29  ite3_context *p)
1040: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26  {.  assert( p &&
1050: 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72   p->pFunc );.  r
1060: 65 74 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e  eturn p->pFunc->
1070: 70 55 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a  pUserData;.}../*
1080: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72 20  .** Allocate or 
1090: 72 65 74 75 72 6e 20 74 68 65 20 61 67 67 72 65  return the aggre
10a0: 67 61 74 65 20 63 6f 6e 74 65 78 74 20 66 6f 72  gate context for
10b0: 20 61 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e   a user function
10c0: 2e 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74  .  A new.** cont
10d0: 65 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64  ext is allocated
10e0: 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 63 61   on the first ca
10f0: 6c 6c 2e 20 20 53 75 62 73 65 71 75 65 6e 74 20  ll.  Subsequent 
1100: 63 61 6c 6c 73 20 72 65 74 75 72 6e 20 74 68 65  calls return the
1110: 0a 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78 74  .** same context
1120: 20 74 68 61 74 20 77 61 73 20 72 65 74 75 72 6e   that was return
1130: 65 64 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c 6c  ed on prior call
1140: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  s..**.** This ro
1150: 75 74 69 6e 65 20 69 73 20 64 65 66 69 6e 65 64  utine is defined
1160: 20 68 65 72 65 20 69 6e 20 76 64 62 65 2e 63 20   here in vdbe.c 
1170: 62 65 63 61 75 73 65 20 69 74 20 64 65 70 65 6e  because it depen
1180: 64 73 20 6f 6e 20 6b 6e 6f 77 69 6e 67 0a 2a 2a  ds on knowing.**
1190: 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 73 20 6f   the internals o
11a0: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 63 6f  f the sqlite3_co
11b0: 6e 74 65 78 74 20 73 74 72 75 63 74 75 72 65 20  ntext structure 
11c0: 77 68 69 63 68 20 69 73 20 6f 6e 6c 79 20 64 65  which is only de
11d0: 66 69 6e 65 64 20 69 6e 0a 2a 2a 20 74 68 69 73  fined in.** this
11e0: 20 73 6f 75 72 63 65 20 66 69 6c 65 2e 0a 2a 2f   source file..*/
11f0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 61  .void *sqlite3_a
1200: 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78 74  ggregate_context
1210: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
1220: 20 2a 70 2c 20 69 6e 74 20 6e 42 79 74 65 29 7b   *p, int nByte){
1230: 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20  .  assert( p && 
1240: 70 2d 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e 70  p->pFunc && p->p
1250: 46 75 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a 20  Func->xStep );. 
1260: 20 69 66 28 20 70 2d 3e 70 41 67 67 3d 3d 30 20   if( p->pAgg==0 
1270: 29 7b 0a 20 20 20 20 69 66 28 20 6e 42 79 74 65  ){.    if( nByte
1280: 3c 3d 4e 42 46 53 20 29 7b 0a 20 20 20 20 20 20  <=NBFS ){.      
1290: 70 2d 3e 70 41 67 67 20 3d 20 28 76 6f 69 64 2a  p->pAgg = (void*
12a0: 29 70 2d 3e 73 2e 7a 3b 0a 20 20 20 20 20 20 6d  )p->s.z;.      m
12b0: 65 6d 73 65 74 28 70 2d 3e 70 41 67 67 2c 20 30  emset(p->pAgg, 0
12c0: 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 7d 65  , nByte);.    }e
12d0: 6c 73 65 7b 0a 20 20 20 20 20 20 70 2d 3e 70 41  lse{.      p->pA
12e0: 67 67 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f  gg = sqliteMallo
12f0: 63 28 20 6e 42 79 74 65 20 29 3b 0a 20 20 20 20  c( nByte );.    
1300: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  }.  }.  return p
1310: 2d 3e 70 41 67 67 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ->pAgg;.}../*.**
1320: 20 52 65 74 75 72 6e 20 74 68 65 20 61 75 78 69   Return the auxi
1330: 6c 61 72 79 20 64 61 74 61 20 70 6f 69 6e 74 65  lary data pointe
1340: 72 2c 20 69 66 20 61 6e 79 2c 20 66 6f 72 20 74  r, if any, for t
1350: 68 65 20 69 41 72 67 27 74 68 20 61 72 67 75 6d  he iArg'th argum
1360: 65 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 75 73  ent to.** the us
1370: 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66 69  er-function defi
1380: 6e 65 64 20 62 79 20 70 43 74 78 2e 0a 2a 2f 0a  ned by pCtx..*/.
1390: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 67 65  void *sqlite3_ge
13a0: 74 5f 61 75 78 64 61 74 61 28 73 71 6c 69 74 65  t_auxdata(sqlite
13b0: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
13c0: 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 20 56 64   int iArg){.  Vd
13d0: 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e  beFunc *pVdbeFun
13e0: 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 65 46  c = pCtx->pVdbeF
13f0: 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 64 62  unc;.  if( !pVdb
1400: 65 46 75 6e 63 20 7c 7c 20 69 41 72 67 3e 3d 70  eFunc || iArg>=p
1410: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 7c  VdbeFunc->nAux |
1420: 7c 20 69 41 72 67 3c 30 20 29 7b 0a 20 20 20 20  | iArg<0 ){.    
1430: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
1440: 72 65 74 75 72 6e 20 70 43 74 78 2d 3e 70 56 64  return pCtx->pVd
1450: 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 41  beFunc->apAux[iA
1460: 72 67 5d 2e 70 41 75 78 3b 0a 7d 0a 0a 2f 2a 0a  rg].pAux;.}../*.
1470: 2a 2a 20 53 65 74 20 74 68 65 20 61 75 78 69 6c  ** Set the auxil
1480: 61 72 79 20 64 61 74 61 20 70 6f 69 6e 74 65 72  ary data pointer
1490: 20 61 6e 64 20 64 65 6c 65 74 65 20 66 75 6e 63   and delete func
14a0: 74 69 6f 6e 2c 20 66 6f 72 20 74 68 65 20 69 41  tion, for the iA
14b0: 72 67 27 74 68 0a 2a 2a 20 61 72 67 75 6d 65 6e  rg'th.** argumen
14c0: 74 20 74 6f 20 74 68 65 20 75 73 65 72 2d 66 75  t to the user-fu
14d0: 6e 63 74 69 6f 6e 20 64 65 66 69 6e 65 64 20 62  nction defined b
14e0: 79 20 70 43 74 78 2e 20 41 6e 79 20 70 72 65 76  y pCtx. Any prev
14f0: 69 6f 75 73 20 76 61 6c 75 65 20 69 73 0a 2a 2a  ious value is.**
1500: 20 64 65 6c 65 74 65 64 20 62 79 20 63 61 6c 6c   deleted by call
1510: 69 6e 67 20 74 68 65 20 64 65 6c 65 74 65 20 66  ing the delete f
1520: 75 6e 63 74 69 6f 6e 20 73 70 65 63 69 66 69 65  unction specifie
1530: 64 20 77 68 65 6e 20 69 74 20 77 61 73 20 73 65  d when it was se
1540: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
1550: 65 33 5f 73 65 74 5f 61 75 78 64 61 74 61 28 0a  e3_set_auxdata(.
1560: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
1570: 74 20 2a 70 43 74 78 2c 20 0a 20 20 69 6e 74 20  t *pCtx, .  int 
1580: 69 41 72 67 2c 20 0a 20 20 76 6f 69 64 20 2a 70  iArg, .  void *p
1590: 41 75 78 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78  Aux, .  void (*x
15a0: 44 65 6c 65 74 65 29 28 76 6f 69 64 2a 29 0a 29  Delete)(void*).)
15b0: 7b 0a 20 20 73 74 72 75 63 74 20 41 75 78 44 61  {.  struct AuxDa
15c0: 74 61 20 2a 70 41 75 78 44 61 74 61 3b 0a 20 20  ta *pAuxData;.  
15d0: 69 66 28 20 69 41 72 67 3c 30 20 29 20 72 65 74  if( iArg<0 ) ret
15e0: 75 72 6e 3b 0a 0a 20 20 69 66 28 20 21 70 43 74  urn;..  if( !pCt
15f0: 78 2d 3e 70 56 64 62 65 46 75 6e 63 20 7c 7c 20  x->pVdbeFunc || 
1600: 70 43 74 78 2d 3e 70 56 64 62 65 46 75 6e 63 2d  pCtx->pVdbeFunc-
1610: 3e 6e 41 75 78 3c 3d 69 41 72 67 20 29 7b 0a 20  >nAux<=iArg ){. 
1620: 20 20 20 69 6e 74 20 6e 4d 61 6c 6c 6f 63 20 3d     int nMalloc =
1630: 20 73 69 7a 65 6f 66 28 56 64 62 65 46 75 6e 63   sizeof(VdbeFunc
1640: 29 2b 73 69 7a 65 6f 66 28 73 74 72 75 63 74 20  )+sizeof(struct 
1650: 41 75 78 44 61 74 61 29 2a 28 69 41 72 67 2b 31  AuxData)*(iArg+1
1660: 29 3b 0a 20 20 20 20 70 43 74 78 2d 3e 70 56 64  );.    pCtx->pVd
1670: 62 65 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 52  beFunc = sqliteR
1680: 65 61 6c 6c 6f 63 28 70 43 74 78 2d 3e 70 56 64  ealloc(pCtx->pVd
1690: 62 65 46 75 6e 63 2c 20 6e 4d 61 6c 6c 6f 63 29  beFunc, nMalloc)
16a0: 3b 0a 20 20 20 20 69 66 28 20 21 70 43 74 78 2d  ;.    if( !pCtx-
16b0: 3e 70 56 64 62 65 46 75 6e 63 20 29 20 72 65 74  >pVdbeFunc ) ret
16c0: 75 72 6e 3b 0a 20 20 20 20 70 43 74 78 2d 3e 70  urn;.    pCtx->p
16d0: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3d  VdbeFunc->nAux =
16e0: 20 69 41 72 67 2b 31 3b 0a 20 20 20 20 70 43 74   iArg+1;.    pCt
16f0: 78 2d 3e 70 56 64 62 65 46 75 6e 63 2d 3e 70 46  x->pVdbeFunc->pF
1700: 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 46 75 6e  unc = pCtx->pFun
1710: 63 3b 0a 20 20 7d 0a 0a 20 20 70 41 75 78 44 61  c;.  }..  pAuxDa
1720: 74 61 20 3d 20 26 70 43 74 78 2d 3e 70 56 64 62  ta = &pCtx->pVdb
1730: 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 41 72  eFunc->apAux[iAr
1740: 67 5d 3b 0a 20 20 69 66 28 20 70 41 75 78 44 61  g];.  if( pAuxDa
1750: 74 61 2d 3e 70 41 75 78 20 26 26 20 70 41 75 78  ta->pAux && pAux
1760: 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 20 29 7b  Data->xDelete ){
1770: 0a 20 20 20 20 70 41 75 78 44 61 74 61 2d 3e 78  .    pAuxData->x
1780: 44 65 6c 65 74 65 28 70 41 75 78 44 61 74 61 2d  Delete(pAuxData-
1790: 3e 70 41 75 78 29 3b 0a 20 20 7d 0a 20 20 70 41  >pAux);.  }.  pA
17a0: 75 78 44 61 74 61 2d 3e 70 41 75 78 20 3d 20 70  uxData->pAux = p
17b0: 41 75 78 3b 0a 20 20 70 41 75 78 44 61 74 61 2d  Aux;.  pAuxData-
17c0: 3e 78 44 65 6c 65 74 65 20 3d 20 78 44 65 6c 65  >xDelete = xDele
17d0: 74 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  te;.}../*.** Ret
17e0: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
17f0: 66 20 74 69 6d 65 73 20 74 68 65 20 53 74 65 70  f times the Step
1800: 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20 61 20 61   function of a a
1810: 67 67 72 65 67 61 74 65 20 68 61 73 20 62 65 65  ggregate has bee
1820: 6e 20 0a 2a 2a 20 63 61 6c 6c 65 64 2e 0a 2a 2a  n .** called..**
1830: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1840: 20 69 73 20 64 65 66 69 6e 65 64 20 68 65 72 65   is defined here
1850: 20 69 6e 20 76 64 62 65 2e 63 20 62 65 63 61 75   in vdbe.c becau
1860: 73 65 20 69 74 20 64 65 70 65 6e 64 73 20 6f 6e  se it depends on
1870: 20 6b 6e 6f 77 69 6e 67 0a 2a 2a 20 74 68 65 20   knowing.** the 
1880: 69 6e 74 65 72 6e 61 6c 73 20 6f 66 20 74 68 65  internals of the
1890: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
18a0: 20 73 74 72 75 63 74 75 72 65 20 77 68 69 63 68   structure which
18b0: 20 69 73 20 6f 6e 6c 79 20 64 65 66 69 6e 65 64   is only defined
18c0: 20 69 6e 0a 2a 2a 20 74 68 69 73 20 73 6f 75 72   in.** this sour
18d0: 63 65 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20  ce file..*/.int 
18e0: 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74  sqlite3_aggregat
18f0: 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f  e_count(sqlite3_
1900: 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20 61  context *p){.  a
1910: 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70  ssert( p && p->p
1920: 46 75 6e 63 20 26 26 20 70 2d 3e 70 46 75 6e 63  Func && p->pFunc
1930: 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20 72 65 74  ->xStep );.  ret
1940: 75 72 6e 20 70 2d 3e 63 6e 74 3b 0a 7d 0a 0a 2f  urn p->cnt;.}../
1950: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
1960: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e  number of column
1970: 73 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20  s in the result 
1980: 73 65 74 20 66 6f 72 20 74 68 65 20 73 74 61 74  set for the stat
1990: 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a  ement pStmt..*/.
19a0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  int sqlite3_colu
19b0: 6d 6e 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33  mn_count(sqlite3
19c0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
19d0: 20 56 64 62 65 20 2a 70 56 6d 20 3d 20 28 56 64   Vdbe *pVm = (Vd
19e0: 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72 65  be *)pStmt;.  re
19f0: 74 75 72 6e 20 70 56 6d 2d 3e 6e 52 65 73 43 6f  turn pVm->nResCo
1a00: 6c 75 6d 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  lumn;.}../*.** R
1a10: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
1a20: 20 6f 66 20 76 61 6c 75 65 73 20 61 76 61 69 6c   of values avail
1a30: 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 75  able from the cu
1a40: 72 72 65 6e 74 20 72 6f 77 20 6f 66 20 74 68 65  rrent row of the
1a50: 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 65 78  .** currently ex
1a60: 65 63 75 74 69 6e 67 20 73 74 61 74 65 6d 65 6e  ecuting statemen
1a70: 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20  t pStmt..*/.int 
1a80: 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75  sqlite3_data_cou
1a90: 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  nt(sqlite3_stmt 
1aa0: 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20  *pStmt){.  Vdbe 
1ab0: 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70  *pVm = (Vdbe *)p
1ac0: 53 74 6d 74 3b 0a 20 20 69 66 28 20 21 70 56 6d  Stmt;.  if( !pVm
1ad0: 2d 3e 72 65 73 4f 6e 53 74 61 63 6b 20 29 20 72  ->resOnStack ) r
1ae0: 65 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 75 72  eturn 0;.  retur
1af0: 6e 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d  n pVm->nResColum
1b00: 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65  n;.}.../*.** Che
1b10: 63 6b 20 74 6f 20 73 65 65 20 69 66 20 63 6f 6c  ck to see if col
1b20: 75 6d 6e 20 69 43 6f 6c 20 6f 66 20 74 68 65 20  umn iCol of the 
1b30: 67 69 76 65 6e 20 73 74 61 74 65 6d 65 6e 74 20  given statement 
1b40: 69 73 20 76 61 6c 69 64 2e 20 20 49 66 0a 2a 2a  is valid.  If.**
1b50: 20 69 74 20 69 73 2c 20 72 65 74 75 72 6e 20 61   it is, return a
1b60: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
1b70: 4d 65 6d 20 66 6f 72 20 74 68 65 20 76 61 6c 75  Mem for the valu
1b80: 65 20 6f 66 20 74 68 61 74 20 63 6f 6c 75 6d 6e  e of that column
1b90: 2e 0a 2a 2a 20 49 66 20 69 43 6f 6c 20 69 73 20  ..** If iCol is 
1ba0: 6e 6f 74 20 76 61 6c 69 64 2c 20 72 65 74 75 72  not valid, retur
1bb0: 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61  n a pointer to a
1bc0: 20 4d 65 6d 20 77 68 69 63 68 20 68 61 73 20 61   Mem which has a
1bd0: 20 76 61 6c 75 65 0a 2a 2a 20 6f 66 20 4e 55 4c   value.** of NUL
1be0: 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 4d 65 6d  L..*/.static Mem
1bf0: 20 2a 63 6f 6c 75 6d 6e 4d 65 6d 28 73 71 6c 69   *columnMem(sqli
1c00: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
1c10: 20 69 6e 74 20 69 29 7b 0a 20 20 56 64 62 65 20   int i){.  Vdbe 
1c20: 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70  *pVm = (Vdbe *)p
1c30: 53 74 6d 74 3b 0a 20 20 69 6e 74 20 76 61 6c 73  Stmt;.  int vals
1c40: 20 3d 20 73 71 6c 69 74 65 33 5f 64 61 74 61 5f   = sqlite3_data_
1c50: 63 6f 75 6e 74 28 70 53 74 6d 74 29 3b 0a 20 20  count(pStmt);.  
1c60: 69 66 28 20 69 3e 3d 76 61 6c 73 20 7c 7c 20 69  if( i>=vals || i
1c70: 3c 30 20 29 7b 0a 20 20 20 20 73 74 61 74 69 63  <0 ){.    static
1c80: 20 4d 65 6d 20 6e 75 6c 6c 4d 65 6d 3b 0a 20 20   Mem nullMem;.  
1c90: 20 20 69 66 28 20 6e 75 6c 6c 4d 65 6d 2e 66 6c    if( nullMem.fl
1ca0: 61 67 73 3d 3d 30 20 29 7b 20 6e 75 6c 6c 4d 65  ags==0 ){ nullMe
1cb0: 6d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75  m.flags = MEM_Nu
1cc0: 6c 6c 3b 20 7d 0a 20 20 20 20 73 71 6c 69 74 65  ll; }.    sqlite
1cd0: 33 45 72 72 6f 72 28 70 56 6d 2d 3e 64 62 2c 20  3Error(pVm->db, 
1ce0: 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30 29  SQLITE_RANGE, 0)
1cf0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 26 6e 75  ;.    return &nu
1d00: 6c 6c 4d 65 6d 3b 0a 20 20 7d 0a 20 20 72 65 74  llMem;.  }.  ret
1d10: 75 72 6e 20 26 70 56 6d 2d 3e 70 54 6f 73 5b 28  urn &pVm->pTos[(
1d20: 31 2d 76 61 6c 73 29 2b 69 5d 3b 0a 7d 0a 0a 2f  1-vals)+i];.}../
1d30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1d40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c  ************ sql
1d50: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 20 20 2a 2a  ite3_column_  **
1d60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1d70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a  *************.**
1d80: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72   The following r
1d90: 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73 65 64  outines are used
1da0: 20 74 6f 20 61 63 63 65 73 73 20 65 6c 65 6d 65   to access eleme
1db0: 6e 74 73 20 6f 66 20 74 68 65 20 63 75 72 72 65  nts of the curre
1dc0: 6e 74 20 72 6f 77 0a 2a 2a 20 69 6e 20 74 68 65  nt row.** in the
1dd0: 20 72 65 73 75 6c 74 20 73 65 74 2e 0a 2a 2f 0a   result set..*/.
1de0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
1df0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 28  te3_column_blob(
1e00: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
1e10: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72  tmt, int i){.  r
1e20: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
1e30: 6c 75 65 5f 62 6c 6f 62 28 20 63 6f 6c 75 6d 6e  lue_blob( column
1e40: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a  Mem(pStmt,i) );.
1e50: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f  }.int sqlite3_co
1e60: 6c 75 6d 6e 5f 62 79 74 65 73 28 73 71 6c 69 74  lumn_bytes(sqlit
1e70: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
1e80: 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e  int i){.  return
1e90: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62   sqlite3_value_b
1ea0: 79 74 65 73 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  ytes( columnMem(
1eb0: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e  pStmt,i) );.}.in
1ec0: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  t sqlite3_column
1ed0: 5f 62 79 74 65 73 31 36 28 73 71 6c 69 74 65 33  _bytes16(sqlite3
1ee0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
1ef0: 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  t i){.  return s
1f00: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74  qlite3_value_byt
1f10: 65 73 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  es16( columnMem(
1f20: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 64 6f  pStmt,i) );.}.do
1f30: 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c  uble sqlite3_col
1f40: 75 6d 6e 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74  umn_double(sqlit
1f50: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
1f60: 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e  int i){.  return
1f70: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64   sqlite3_value_d
1f80: 6f 75 62 6c 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d  ouble( columnMem
1f90: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69  (pStmt,i) );.}.i
1fa0: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  nt sqlite3_colum
1fb0: 6e 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 73 74  n_int(sqlite3_st
1fc0: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
1fd0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
1fe0: 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 20 63  te3_value_int( c
1ff0: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69  olumnMem(pStmt,i
2000: 29 20 29 3b 0a 7d 0a 6c 6f 6e 67 20 6c 6f 6e 67  ) );.}.long long
2010: 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c   int sqlite3_col
2020: 75 6d 6e 5f 69 6e 74 36 34 28 73 71 6c 69 74 65  umn_int64(sqlite
2030: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
2040: 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt i){.  return 
2050: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e  sqlite3_value_in
2060: 74 36 34 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70  t64( columnMem(p
2070: 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 63 6f 6e  Stmt,i) );.}.con
2080: 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  st unsigned char
2090: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
20a0: 5f 74 65 78 74 28 73 71 6c 69 74 65 33 5f 73 74  _text(sqlite3_st
20b0: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
20c0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
20d0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 20  te3_value_text( 
20e0: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c  columnMem(pStmt,
20f0: 69 29 20 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f  i) );.}.const vo
2100: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  id *sqlite3_colu
2110: 6d 6e 5f 74 65 78 74 31 36 28 73 71 6c 69 74 65  mn_text16(sqlite
2120: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
2130: 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt i){.  return 
2140: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
2150: 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  xt16( columnMem(
2160: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e  pStmt,i) );.}.in
2170: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  t sqlite3_column
2180: 5f 74 79 70 65 28 73 71 6c 69 74 65 33 5f 73 74  _type(sqlite3_st
2190: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
21a0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
21b0: 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 20  te3_value_type( 
21c0: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c  columnMem(pStmt,
21d0: 69 29 20 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  i) );.}.../*.** 
21e0: 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20  Return the name 
21f0: 6f 66 20 74 68 65 20 4e 74 68 20 63 6f 6c 75 6d  of the Nth colum
2200: 6e 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20  n of the result 
2210: 73 65 74 20 72 65 74 75 72 6e 65 64 20 62 79 20  set returned by 
2220: 53 51 4c 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74  SQL.** statement
2230: 20 70 53 74 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74   pStmt..*/.const
2240: 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63   char *sqlite3_c
2250: 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 73 71 6c 69 74  olumn_name(sqlit
2260: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
2270: 69 6e 74 20 4e 29 7b 0a 20 20 56 64 62 65 20 2a  int N){.  Vdbe *
2280: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  p = (Vdbe *)pStm
2290: 74 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61  t;.  Mem *pColNa
22a0: 6d 65 3b 0a 0a 20 20 69 66 28 20 4e 3e 3d 73 71  me;..  if( N>=sq
22b0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75  lite3_column_cou
22c0: 6e 74 28 70 53 74 6d 74 29 20 7c 7c 20 4e 3c 30  nt(pStmt) || N<0
22d0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45   ){.    sqlite3E
22e0: 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49  rror(p->db, SQLI
22f0: 54 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20  TE_RANGE, 0);.  
2300: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
2310: 0a 20 20 70 43 6f 6c 4e 61 6d 65 20 3d 20 26 28  .  pColName = &(
2320: 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29 3b  p->aColName[N]);
2330: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
2340: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 70 43 6f  3_value_text(pCo
2350: 6c 4e 61 6d 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  lName);.}../*.**
2360: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65   Return the name
2370: 20 6f 66 20 74 68 65 20 27 69 27 74 68 20 63 6f   of the 'i'th co
2380: 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73 75  lumn of the resu
2390: 6c 74 20 73 65 74 20 6f 66 20 53 51 4c 20 73 74  lt set of SQL st
23a0: 61 74 65 6d 65 6e 74 0a 2a 2a 20 70 53 74 6d 74  atement.** pStmt
23b0: 2c 20 65 6e 63 6f 64 65 64 20 61 73 20 55 54 46  , encoded as UTF
23c0: 2d 31 36 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f  -16..*/.const vo
23d0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  id *sqlite3_colu
23e0: 6d 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65  mn_name16(sqlite
23f0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
2400: 6e 74 20 4e 29 7b 0a 20 20 56 64 62 65 20 2a 70  nt N){.  Vdbe *p
2410: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74   = (Vdbe *)pStmt
2420: 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d  ;.  Mem *pColNam
2430: 65 3b 0a 0a 20 20 69 66 28 20 4e 3e 3d 73 71 6c  e;..  if( N>=sql
2440: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e  ite3_column_coun
2450: 74 28 70 53 74 6d 74 29 20 7c 7c 20 4e 3c 30 20  t(pStmt) || N<0 
2460: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72  ){.    sqlite3Er
2470: 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54  ror(p->db, SQLIT
2480: 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20  E_RANGE, 0);.   
2490: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a   return 0;.  }..
24a0: 20 20 70 43 6f 6c 4e 61 6d 65 20 3d 20 26 28 70    pColName = &(p
24b0: 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29 3b 0a  ->aColName[N]);.
24c0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
24d0: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 70 43  _value_text16(pC
24e0: 6f 6c 4e 61 6d 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  olName);.}../*.*
24f0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63 6f 6c  * Return the col
2500: 75 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f 6e 20  umn declaration 
2510: 74 79 70 65 20 28 69 66 20 61 70 70 6c 69 63 61  type (if applica
2520: 62 6c 65 29 20 6f 66 20 74 68 65 20 27 69 27 74  ble) of the 'i't
2530: 68 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74  h column.** of t
2540: 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66  he result set of
2550: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 70   SQL statement p
2560: 53 74 6d 74 2c 20 65 6e 63 6f 64 65 64 20 61 73  Stmt, encoded as
2570: 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e 73 74   UTF-8..*/.const
2580: 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63   char *sqlite3_c
2590: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 28 73  olumn_decltype(s
25a0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
25b0: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 56 64  mt, int N){.  Vd
25c0: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29  be *p = (Vdbe *)
25d0: 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a 70 43  pStmt;.  Mem *pC
25e0: 6f 6c 4e 61 6d 65 3b 0a 0a 20 20 69 66 28 20 4e  olName;..  if( N
25f0: 3e 3d 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  >=sqlite3_column
2600: 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 20 7c 7c  _count(pStmt) ||
2610: 20 4e 3c 30 20 29 7b 0a 20 20 20 20 73 71 6c 69   N<0 ){.    sqli
2620: 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20  te3Error(p->db, 
2630: 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30 29  SQLITE_RANGE, 0)
2640: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a  ;.    return 0;.
2650: 20 20 7d 0a 0a 20 20 70 43 6f 6c 4e 61 6d 65 20    }..  pColName 
2660: 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b  = &(p->aColName[
2670: 4e 2b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  N+sqlite3_column
2680: 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 5d 29 3b  _count(pStmt)]);
2690: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
26a0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 70 43 6f  3_value_text(pCo
26b0: 6c 4e 61 6d 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  lName);.}../*.**
26c0: 20 52 65 74 75 72 6e 20 74 68 65 20 63 6f 6c 75   Return the colu
26d0: 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 74  mn declaration t
26e0: 79 70 65 20 28 69 66 20 61 70 70 6c 69 63 61 62  ype (if applicab
26f0: 6c 65 29 20 6f 66 20 74 68 65 20 27 69 27 74 68  le) of the 'i'th
2700: 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74 68   column.** of th
2710: 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66 20  e result set of 
2720: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 70 53  SQL statement pS
2730: 74 6d 74 2c 20 65 6e 63 6f 64 65 64 20 61 73 20  tmt, encoded as 
2740: 55 54 46 2d 31 36 2e 0a 2a 2f 0a 63 6f 6e 73 74  UTF-16..*/.const
2750: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
2760: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36  olumn_decltype16
2770: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
2780: 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20  Stmt, int N){.  
2790: 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20  Vdbe *p = (Vdbe 
27a0: 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a  *)pStmt;.  Mem *
27b0: 70 43 6f 6c 4e 61 6d 65 3b 0a 0a 20 20 69 66 28  pColName;..  if(
27c0: 20 4e 3e 3d 73 71 6c 69 74 65 33 5f 63 6f 6c 75   N>=sqlite3_colu
27d0: 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 20  mn_count(pStmt) 
27e0: 7c 7c 20 4e 3c 30 20 29 7b 0a 20 20 20 20 73 71  || N<0 ){.    sq
27f0: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62  lite3Error(p->db
2800: 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20  , SQLITE_RANGE, 
2810: 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30  0);.    return 0
2820: 3b 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 4e 61 6d  ;.  }..  pColNam
2830: 65 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d  e = &(p->aColNam
2840: 65 5b 4e 2b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  e[N+sqlite3_colu
2850: 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 5d  mn_count(pStmt)]
2860: 29 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  );.  return sqli
2870: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36  te3_value_text16
2880: 28 70 43 6f 6c 4e 61 6d 65 29 3b 0a 7d 0a 0a 2f  (pColName);.}../
2890: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
28a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20  *************** 
28b0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 20 20 2a  sqlite3_bind_  *
28c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
28d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 0a 2a  **********.** .*
28e0: 2a 20 52 6f 75 74 69 6e 65 73 20 75 73 65 64 20  * Routines used 
28f0: 74 6f 20 61 74 74 61 63 68 20 76 61 6c 75 65 73  to attach values
2900: 20 74 6f 20 77 69 6c 64 63 61 72 64 73 20 69 6e   to wildcards in
2910: 20 61 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20   a compiled SQL 
2920: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 2f 2a  statement..*/./*
2930: 0a 2a 2a 20 55 6e 62 69 6e 64 20 74 68 65 20 76  .** Unbind the v
2940: 61 6c 75 65 20 62 6f 75 6e 64 20 74 6f 20 76 61  alue bound to va
2950: 72 69 61 62 6c 65 20 69 20 69 6e 20 76 69 72 74  riable i in virt
2960: 75 61 6c 20 6d 61 63 68 69 6e 65 20 70 2e 20 54  ual machine p. T
2970: 68 69 73 20 69 73 20 74 68 65 20 0a 2a 2a 20 74  his is the .** t
2980: 68 65 20 73 61 6d 65 20 61 73 20 62 69 6e 64 69  he same as bindi
2990: 6e 67 20 61 20 4e 55 4c 4c 20 76 61 6c 75 65 20  ng a NULL value 
29a0: 74 6f 20 74 68 65 20 63 6f 6c 75 6d 6e 2e 20 49  to the column. I
29b0: 66 20 74 68 65 20 22 69 22 20 70 61 72 61 6d 65  f the "i" parame
29c0: 74 65 72 20 69 73 0a 2a 2a 20 6f 75 74 20 6f 66  ter is.** out of
29d0: 20 72 61 6e 67 65 2c 20 74 68 65 6e 20 53 51 4c   range, then SQL
29e0: 49 54 45 5f 52 41 4e 47 45 20 69 73 20 72 65 74  ITE_RANGE is ret
29f0: 75 72 6e 65 64 2e 20 4f 74 68 65 77 69 73 65 20  urned. Othewise 
2a00: 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a  SQLITE_OK..**.**
2a10: 20 54 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20   The error code 
2a20: 73 74 6f 72 65 64 20 69 6e 20 64 61 74 61 62 61  stored in databa
2a30: 73 65 20 70 2d 3e 64 62 20 69 73 20 6f 76 65 72  se p->db is over
2a40: 77 72 69 74 74 65 6e 20 77 69 74 68 20 74 68 65  written with the
2a50: 20 72 65 74 75 72 6e 0a 2a 2a 20 76 61 6c 75 65   return.** value
2a60: 20 69 6e 20 61 6e 79 20 63 61 73 65 2e 0a 2a 2f   in any case..*/
2a70: 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64 62 65  .static int vdbe
2a80: 55 6e 62 69 6e 64 28 56 64 62 65 20 2a 70 2c 20  Unbind(Vdbe *p, 
2a90: 69 6e 74 20 69 29 7b 0a 20 20 4d 65 6d 20 2a 70  int i){.  Mem *p
2aa0: 56 61 72 3b 0a 20 20 69 66 28 20 70 2d 3e 6d 61  Var;.  if( p->ma
2ab0: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
2ac0: 52 55 4e 20 7c 7c 20 70 2d 3e 70 63 3e 3d 30 20  RUN || p->pc>=0 
2ad0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72  ){.    sqlite3Er
2ae0: 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54  ror(p->db, SQLIT
2af0: 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b 0a 20 20  E_MISUSE, 0);.  
2b00: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
2b10: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66  MISUSE;.  }.  if
2b20: 28 20 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56  ( i<1 || i>p->nV
2b30: 61 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ar ){.    sqlite
2b40: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51  3Error(p->db, SQ
2b50: 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a  LITE_RANGE, 0);.
2b60: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
2b70: 45 5f 52 41 4e 47 45 3b 0a 20 20 7d 0a 20 20 69  E_RANGE;.  }.  i
2b80: 2d 2d 3b 0a 20 20 70 56 61 72 20 3d 20 26 70 2d  --;.  pVar = &p-
2b90: 3e 61 70 56 61 72 5b 69 5d 3b 0a 20 20 69 66 28  >apVar[i];.  if(
2ba0: 20 70 56 61 72 2d 3e 66 6c 61 67 73 26 4d 45 4d   pVar->flags&MEM
2bb0: 5f 44 79 6e 20 29 7b 0a 20 20 20 20 73 71 6c 69  _Dyn ){.    sqli
2bc0: 74 65 46 72 65 65 28 70 56 61 72 2d 3e 7a 29 3b  teFree(pVar->z);
2bd0: 0a 20 20 7d 0a 20 20 70 56 61 72 2d 3e 66 6c 61  .  }.  pVar->fla
2be0: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20  gs = MEM_Null;. 
2bf0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d   sqlite3Error(p-
2c00: 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20  >db, SQLITE_OK, 
2c10: 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  0);.  return SQL
2c20: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
2c30: 20 42 69 6e 64 20 61 20 62 6c 6f 62 20 76 61 6c   Bind a blob val
2c40: 75 65 20 74 6f 20 61 6e 20 53 51 4c 20 73 74 61  ue to an SQL sta
2c50: 74 65 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e  tement variable.
2c60: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
2c70: 62 69 6e 64 5f 62 6c 6f 62 28 0a 20 20 73 71 6c  bind_blob(.  sql
2c80: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
2c90: 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63  , .  int i, .  c
2ca0: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61  onst void *zData
2cb0: 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20  , .  int nData, 
2cc0: 0a 20 20 69 6e 74 20 65 43 6f 70 79 0a 29 7b 0a  .  int eCopy.){.
2cd0: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
2ce0: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d  e *)pStmt;.  Mem
2cf0: 20 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72 63   *pVar;.  int rc
2d00: 3b 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e  ;..  rc = vdbeUn
2d10: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66  bind(p, i);.  if
2d20: 28 20 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75  ( rc ){.    retu
2d30: 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 56 61  rn rc;.  }.  pVa
2d40: 72 20 3d 20 26 70 2d 3e 61 70 56 61 72 5b 69 2d  r = &p->apVar[i-
2d50: 31 5d 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  1];.  rc = sqlit
2d60: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
2d70: 70 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61  pVar, zData, nDa
2d80: 74 61 2c 20 30 2c 20 65 43 6f 70 79 29 3b 0a 20  ta, 0, eCopy);. 
2d90: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e   return rc;.}.in
2da0: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64  t sqlite3_bind_d
2db0: 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74  ouble(sqlite3_st
2dc0: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
2dd0: 2c 20 64 6f 75 62 6c 65 20 72 56 61 6c 75 65 29  , double rValue)
2de0: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64  {.  int rc;.  Vd
2df0: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29  be *p = (Vdbe *)
2e00: 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64  pStmt;.  rc = vd
2e10: 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a  beUnbind(p, i);.
2e20: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
2e30: 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  _OK ){.    sqlit
2e40: 65 33 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62  e3VdbeMemSetDoub
2e50: 6c 65 28 26 70 2d 3e 61 70 56 61 72 5b 69 2d 31  le(&p->apVar[i-1
2e60: 5d 2c 20 72 56 61 6c 75 65 29 3b 0a 20 20 7d 0a  ], rValue);.  }.
2e70: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
2e80: 4f 4b 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  OK;.}.int sqlite
2e90: 33 5f 62 69 6e 64 5f 69 6e 74 28 73 71 6c 69 74  3_bind_int(sqlit
2ea0: 65 33 5f 73 74 6d 74 20 2a 70 2c 20 69 6e 74 20  e3_stmt *p, int 
2eb0: 69 2c 20 69 6e 74 20 69 56 61 6c 75 65 29 7b 0a  i, int iValue){.
2ec0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
2ed0: 5f 62 69 6e 64 5f 69 6e 74 36 34 28 70 2c 20 69  _bind_int64(p, i
2ee0: 2c 20 28 6c 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74  , (long long int
2ef0: 29 69 56 61 6c 75 65 29 3b 0a 7d 0a 69 6e 74 20  )iValue);.}.int 
2f00: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74  sqlite3_bind_int
2f10: 36 34 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  64(sqlite3_stmt 
2f20: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20 6c  *pStmt, int i, l
2f30: 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 20 69 56 61  ong long int iVa
2f40: 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  lue){.  int rc;.
2f50: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
2f60: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 20  e *)pStmt;.  rc 
2f70: 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20  = vdbeUnbind(p, 
2f80: 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  i);.  if( rc==SQ
2f90: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73  LITE_OK ){.    s
2fa0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
2fb0: 49 6e 74 36 34 28 26 70 2d 3e 61 70 56 61 72 5b  Int64(&p->apVar[
2fc0: 69 2d 31 5d 2c 20 69 56 61 6c 75 65 29 3b 0a 20  i-1], iValue);. 
2fd0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
2fe0: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69  }.int sqlite3_bi
2ff0: 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f  nd_null(sqlite3_
3000: 73 74 6d 74 2a 20 70 2c 20 69 6e 74 20 69 29 7b  stmt* p, int i){
3010: 0a 20 20 72 65 74 75 72 6e 20 76 64 62 65 55 6e  .  return vdbeUn
3020: 62 69 6e 64 28 28 56 64 62 65 20 2a 29 70 2c 20  bind((Vdbe *)p, 
3030: 69 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  i);.}.int sqlite
3040: 33 5f 62 69 6e 64 5f 74 65 78 74 28 20 0a 20 20  3_bind_text( .  
3050: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
3060: 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a  tmt, .  int i, .
3070: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44    const char *zD
3080: 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74  ata, .  int nDat
3090: 61 2c 20 0a 20 20 69 6e 74 20 65 43 6f 70 79 0a  a, .  int eCopy.
30a0: 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  ){.  Vdbe *p = (
30b0: 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20  Vdbe *)pStmt;.  
30c0: 4d 65 6d 20 2a 70 56 61 72 3b 0a 20 20 69 6e 74  Mem *pVar;.  int
30d0: 20 72 63 3b 0a 0a 20 20 72 63 20 3d 20 76 64 62   rc;..  rc = vdb
30e0: 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20  eUnbind(p, i);. 
30f0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72   if( rc ){.    r
3100: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
3110: 70 56 61 72 20 3d 20 26 70 2d 3e 61 70 56 61 72  pVar = &p->apVar
3120: 5b 69 2d 31 5d 3b 0a 20 20 72 63 20 3d 20 73 71  [i-1];.  rc = sq
3130: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
3140: 74 72 28 70 56 61 72 2c 20 7a 44 61 74 61 2c 20  tr(pVar, zData, 
3150: 6e 44 61 74 61 2c 20 54 45 58 54 5f 55 74 66 38  nData, TEXT_Utf8
3160: 2c 20 65 43 6f 70 79 29 3b 0a 20 20 69 66 28 20  , eCopy);.  if( 
3170: 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  rc ){.    return
3180: 20 72 63 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20   rc;.  }.  rc = 
3190: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
31a0: 65 45 6e 63 6f 64 69 6e 67 28 70 56 61 72 2c 20  eEncoding(pVar, 
31b0: 70 2d 3e 64 62 2d 3e 65 6e 63 29 3b 0a 20 20 72  p->db->enc);.  r
31c0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
31d0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78  sqlite3_bind_tex
31e0: 74 31 36 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  t16(.  sqlite3_s
31f0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69  tmt *pStmt, .  i
3200: 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76  nt i, .  const v
3210: 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69  oid *zData, .  i
3220: 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 69 6e 74  nt nData, .  int
3230: 20 65 43 6f 70 79 0a 29 7b 0a 20 20 56 64 62 65   eCopy.){.  Vdbe
3240: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
3250: 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a 70 56 61 72  tmt;.  Mem *pVar
3260: 3b 0a 20 20 69 6e 74 20 72 63 2c 20 74 78 74 5f  ;.  int rc, txt_
3270: 65 6e 63 3b 0a 0a 20 20 72 63 20 3d 20 76 64 62  enc;..  rc = vdb
3280: 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20  eUnbind(p, i);. 
3290: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72   if( rc ){.    r
32a0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
32b0: 70 56 61 72 20 3d 20 26 70 2d 3e 61 70 56 61 72  pVar = &p->apVar
32c0: 5b 69 2d 31 5d 3b 0a 0a 20 20 2f 2a 20 54 68 65  [i-1];..  /* The
32d0: 72 65 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f  re may or may no
32e0: 74 20 62 65 20 61 20 62 79 74 65 20 6f 72 64 65  t be a byte orde
32f0: 72 20 6d 61 72 6b 20 61 74 20 74 68 65 20 73 74  r mark at the st
3300: 61 72 74 20 6f 66 20 74 68 65 20 55 54 46 2d 31  art of the UTF-1
3310: 36 2e 0a 20 20 2a 2a 20 45 69 74 68 65 72 20 77  6..  ** Either w
3320: 61 79 20 73 65 74 20 27 74 78 74 5f 65 6e 63 27  ay set 'txt_enc'
3330: 20 74 6f 20 74 68 65 20 54 45 58 54 5f 55 74 66   to the TEXT_Utf
3340: 31 36 2a 20 76 61 6c 75 65 20 69 6e 64 69 63 61  16* value indica
3350: 74 69 6e 67 20 74 68 65 20 0a 20 20 2a 2a 20 61  ting the .  ** a
3360: 63 74 75 61 6c 20 62 79 74 65 20 6f 72 64 65 72  ctual byte order
3370: 20 75 73 65 64 20 62 79 20 74 68 69 73 20 73 74   used by this st
3380: 72 69 6e 67 2e 20 49 66 20 74 68 65 20 73 74 72  ring. If the str
3390: 69 6e 67 20 64 6f 65 73 20 68 61 70 70 65 6e 0a  ing does happen.
33a0: 20 20 2a 2a 20 74 6f 20 63 6f 6e 74 61 69 6e 20    ** to contain 
33b0: 61 20 42 4f 4d 2c 20 74 68 65 6e 20 6d 6f 76 65  a BOM, then move
33c0: 20 7a 44 61 74 61 20 73 6f 20 74 68 61 74 20 69   zData so that i
33d0: 74 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20  t points to the 
33e0: 66 69 72 73 74 0a 20 20 2a 2a 20 62 79 74 65 20  first.  ** byte 
33f0: 61 66 74 65 72 20 74 68 65 20 42 4f 4d 2e 0a 20  after the BOM.. 
3400: 20 2a 2f 0a 20 20 74 78 74 5f 65 6e 63 20 3d 20   */.  txt_enc = 
3410: 73 71 6c 69 74 65 33 55 74 66 52 65 61 64 42 6f  sqlite3UtfReadBo
3420: 6d 28 7a 44 61 74 61 2c 20 6e 44 61 74 61 29 3b  m(zData, nData);
3430: 0a 20 20 69 66 28 20 74 78 74 5f 65 6e 63 20 29  .  if( txt_enc )
3440: 7b 0a 20 20 20 20 7a 44 61 74 61 20 3d 20 28 76  {.    zData = (v
3450: 6f 69 64 20 2a 29 28 28 28 75 38 20 2a 29 7a 44  oid *)(((u8 *)zD
3460: 61 74 61 29 20 2b 20 32 29 3b 0a 20 20 20 20 6e  ata) + 2);.    n
3470: 44 61 74 61 20 2d 3d 20 32 3b 0a 20 20 7d 65 6c  Data -= 2;.  }el
3480: 73 65 7b 0a 20 20 20 20 74 78 74 5f 65 6e 63 20  se{.    txt_enc 
3490: 3d 20 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49  = SQLITE_BIGENDI
34a0: 41 4e 3f 54 45 58 54 5f 55 74 66 31 36 62 65 3a  AN?TEXT_Utf16be:
34b0: 54 45 58 54 5f 55 74 66 31 36 6c 65 3b 0a 20 20  TEXT_Utf16le;.  
34c0: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  }.  rc = sqlite3
34d0: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 56  VdbeMemSetStr(pV
34e0: 61 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61  ar, zData, nData
34f0: 2c 20 74 78 74 5f 65 6e 63 2c 20 65 43 6f 70 79  , txt_enc, eCopy
3500: 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20  );.  if( rc ){. 
3510: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
3520: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  }.  rc = sqlite3
3530: 56 64 62 65 43 68 61 6e 67 65 45 6e 63 6f 64 69  VdbeChangeEncodi
3540: 6e 67 28 70 56 61 72 2c 20 70 2d 3e 64 62 2d 3e  ng(pVar, p->db->
3550: 65 6e 63 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  enc);.  return r
3560: 63 3b 0a 7d 0a                                   c;.}.