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

Artifact 36d4c78bc765dc89cac07ff975b26256e0ac90fc:


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 52  (Mem *)pVal;.  R
0500: 65 61 6c 69 66 79 28 70 4d 65 6d 2c 20 66 6c 61  ealify(pMem, fla
0510: 67 73 54 6f 45 6e 63 28 70 4d 65 6d 2d 3e 66 6c  gsToEnc(pMem->fl
0520: 61 67 73 29 29 3b 0a 20 20 72 65 74 75 72 6e 20  ags));.  return 
0530: 70 4d 65 6d 2d 3e 72 3b 0a 7d 0a 69 6e 74 20 73  pMem->r;.}.int s
0540: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74  qlite3_value_int
0550: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  (sqlite3_value *
0560: 70 56 61 6c 29 7b 0a 20 20 4d 65 6d 20 2a 70 4d  pVal){.  Mem *pM
0570: 65 6d 20 3d 20 28 4d 65 6d 20 2a 29 70 56 61 6c  em = (Mem *)pVal
0580: 3b 0a 20 20 49 6e 74 65 67 65 72 69 66 79 28 70  ;.  Integerify(p
0590: 4d 65 6d 2c 20 66 6c 61 67 73 54 6f 45 6e 63 28  Mem, flagsToEnc(
05a0: 70 4d 65 6d 2d 3e 66 6c 61 67 73 29 29 3b 0a 20  pMem->flags));. 
05b0: 20 72 65 74 75 72 6e 20 28 69 6e 74 29 70 56 61   return (int)pVa
05c0: 6c 2d 3e 69 3b 0a 7d 0a 6c 6f 6e 67 20 6c 6f 6e  l->i;.}.long lon
05d0: 67 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 61  g int sqlite3_va
05e0: 6c 75 65 5f 69 6e 74 36 34 28 73 71 6c 69 74 65  lue_int64(sqlite
05f0: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a  3_value *pVal){.
0600: 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 28 4d    Mem *pMem = (M
0610: 65 6d 20 2a 29 70 56 61 6c 3b 0a 20 20 49 6e 74  em *)pVal;.  Int
0620: 65 67 65 72 69 66 79 28 70 4d 65 6d 2c 20 66 6c  egerify(pMem, fl
0630: 61 67 73 54 6f 45 6e 63 28 70 4d 65 6d 2d 3e 66  agsToEnc(pMem->f
0640: 6c 61 67 73 29 29 3b 0a 20 20 72 65 74 75 72 6e  lags));.  return
0650: 20 70 56 61 6c 2d 3e 69 3b 0a 7d 0a 63 6f 6e 73   pVal->i;.}.cons
0660: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20  t unsigned char 
0670: 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  *sqlite3_value_t
0680: 65 78 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  ext(sqlite3_valu
0690: 65 20 2a 70 56 61 6c 29 7b 0a 20 20 69 66 28 20  e *pVal){.  if( 
06a0: 70 56 61 6c 2d 3e 66 6c 61 67 73 26 4d 45 4d 5f  pVal->flags&MEM_
06b0: 4e 75 6c 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 46  Null ){.    /* F
06c0: 6f 72 20 61 20 4e 55 4c 4c 20 72 65 74 75 72 6e  or a NULL return
06d0: 20 61 20 4e 55 4c 4c 20 50 6f 69 6e 74 65 72 20   a NULL Pointer 
06e0: 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  */.    return 0;
06f0: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 56 61 6c  .  }..  if( pVal
0700: 2d 3e 66 6c 61 67 73 26 4d 45 4d 5f 53 74 72 20  ->flags&MEM_Str 
0710: 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65  ){.    /* If the
0720: 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 61 20  re is already a 
0730: 73 74 72 69 6e 67 20 72 65 70 72 65 73 65 6e 74  string represent
0740: 61 74 69 6f 6e 2c 20 6d 61 6b 65 20 73 75 72 65  ation, make sure
0750: 20 69 74 20 69 73 20 69 6e 0a 20 20 20 20 2a 2a   it is in.    **
0760: 20 65 6e 63 6f 64 65 64 20 69 6e 20 55 54 46 2d   encoded in UTF-
0770: 38 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 53 65  8..    */.    Se
0780: 74 45 6e 63 6f 64 69 6e 67 28 70 56 61 6c 2c 20  tEncoding(pVal, 
0790: 4d 45 4d 5f 55 74 66 38 7c 4d 45 4d 5f 54 65 72  MEM_Utf8|MEM_Ter
07a0: 6d 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  m);.  }else if( 
07b0: 21 28 70 56 61 6c 2d 3e 66 6c 61 67 73 26 4d 45  !(pVal->flags&ME
07c0: 4d 5f 42 6c 6f 62 29 20 29 7b 0a 20 20 20 20 2f  M_Blob) ){.    /
07d0: 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 75 6e 6c  * Otherwise, unl
07e0: 65 73 73 20 74 68 69 73 20 69 73 20 61 20 62 6c  ess this is a bl
07f0: 6f 62 2c 20 63 6f 6e 76 65 72 74 20 69 74 20 74  ob, convert it t
0800: 6f 20 61 20 55 54 46 2d 38 20 73 74 72 69 6e 67  o a UTF-8 string
0810: 20 2a 2f 0a 20 20 20 20 53 74 72 69 6e 67 69 66   */.    Stringif
0820: 79 28 70 56 61 6c 2c 20 54 45 58 54 5f 55 74 66  y(pVal, TEXT_Utf
0830: 38 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72  8);.  }..  retur
0840: 6e 20 70 56 61 6c 2d 3e 7a 3b 0a 7d 0a 63 6f 6e  n pVal->z;.}.con
0850: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  st void *sqlite3
0860: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 73 71  _value_text16(sq
0870: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70 56 61  lite3_value* pVa
0880: 6c 29 7b 0a 20 20 69 66 28 20 70 56 61 6c 2d 3e  l){.  if( pVal->
0890: 66 6c 61 67 73 26 4d 45 4d 5f 4e 75 6c 6c 20 29  flags&MEM_Null )
08a0: 7b 0a 20 20 20 20 2f 2a 20 46 6f 72 20 61 20 4e  {.    /* For a N
08b0: 55 4c 4c 20 72 65 74 75 72 6e 20 61 20 4e 55 4c  ULL return a NUL
08c0: 4c 20 50 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20  L Pointer */.   
08d0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a   return 0;.  }..
08e0: 20 20 69 66 28 20 70 56 61 6c 2d 3e 66 6c 61 67    if( pVal->flag
08f0: 73 26 4d 45 4d 5f 53 74 72 20 29 7b 0a 20 20 20  s&MEM_Str ){.   
0900: 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 20   /* If there is 
0910: 61 6c 72 65 61 64 79 20 61 20 73 74 72 69 6e 67  already a string
0920: 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 2c   representation,
0930: 20 6d 61 6b 65 20 73 75 72 65 20 69 74 20 69 73   make sure it is
0940: 20 69 6e 0a 20 20 20 20 2a 2a 20 65 6e 63 6f 64   in.    ** encod
0950: 65 64 20 69 6e 20 55 54 46 2d 31 36 20 6d 61 63  ed in UTF-16 mac
0960: 68 69 6e 65 20 62 79 74 65 20 6f 72 64 65 72 2e  hine byte order.
0970: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 53 65 74 45  .    */.    SetE
0980: 6e 63 6f 64 69 6e 67 28 70 56 61 6c 2c 20 65 6e  ncoding(pVal, en
0990: 63 54 6f 46 6c 61 67 73 28 54 45 58 54 5f 55 74  cToFlags(TEXT_Ut
09a0: 66 31 36 29 7c 4d 45 4d 5f 54 65 72 6d 29 3b 0a  f16)|MEM_Term);.
09b0: 20 20 7d 65 6c 73 65 20 69 66 28 20 21 28 70 56    }else if( !(pV
09c0: 61 6c 2d 3e 66 6c 61 67 73 26 4d 45 4d 5f 42 6c  al->flags&MEM_Bl
09d0: 6f 62 29 20 29 7b 0a 20 20 20 20 2f 2a 20 4f 74  ob) ){.    /* Ot
09e0: 68 65 72 77 69 73 65 2c 20 75 6e 6c 65 73 73 20  herwise, unless 
09f0: 74 68 69 73 20 69 73 20 61 20 62 6c 6f 62 2c 20  this is a blob, 
0a00: 63 6f 6e 76 65 72 74 20 69 74 20 74 6f 20 61 20  convert it to a 
0a10: 55 54 46 2d 31 36 20 73 74 72 69 6e 67 20 2a 2f  UTF-16 string */
0a20: 0a 20 20 20 20 53 74 72 69 6e 67 69 66 79 28 70  .    Stringify(p
0a30: 56 61 6c 2c 20 54 45 58 54 5f 55 74 66 31 36 29  Val, TEXT_Utf16)
0a40: 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20  ;.  }..  return 
0a50: 28 63 6f 6e 73 74 20 76 6f 69 64 20 2a 29 28 70  (const void *)(p
0a60: 56 61 6c 2d 3e 7a 29 3b 0a 7d 0a 69 6e 74 20 73  Val->z);.}.int s
0a70: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
0a80: 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a  e(sqlite3_value*
0a90: 20 70 56 61 6c 29 7b 0a 20 20 69 6e 74 20 66 20   pVal){.  int f 
0aa0: 3d 20 28 28 4d 65 6d 20 2a 29 70 56 61 6c 29 2d  = ((Mem *)pVal)-
0ab0: 3e 66 6c 61 67 73 3b 0a 20 20 69 66 28 20 66 26  >flags;.  if( f&
0ac0: 4d 45 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20 20 20  MEM_Null ){.    
0ad0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 33 5f 4e  return SQLITE3_N
0ae0: 55 4c 4c 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66  ULL;.  }.  if( f
0af0: 26 4d 45 4d 5f 49 6e 74 20 29 7b 0a 20 20 20 20  &MEM_Int ){.    
0b00: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 33 5f 49  return SQLITE3_I
0b10: 4e 54 45 47 45 52 3b 0a 20 20 7d 0a 20 20 69 66  NTEGER;.  }.  if
0b20: 28 20 66 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a  ( f&MEM_Real ){.
0b30: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
0b40: 45 33 5f 46 4c 4f 41 54 3b 0a 20 20 7d 0a 20 20  E3_FLOAT;.  }.  
0b50: 69 66 28 20 66 26 4d 45 4d 5f 53 74 72 20 29 7b  if( f&MEM_Str ){
0b60: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
0b70: 54 45 33 5f 54 45 58 54 3b 0a 20 20 7d 0a 20 20  TE3_TEXT;.  }.  
0b80: 69 66 28 20 66 26 4d 45 4d 5f 42 6c 6f 62 20 29  if( f&MEM_Blob )
0b90: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
0ba0: 49 54 45 33 5f 42 4c 4f 42 3b 0a 20 20 7d 0a 20  ITE3_BLOB;.  }. 
0bb0: 20 61 73 73 65 72 74 28 30 29 3b 0a 7d 0a 0a 2f   assert(0);.}../
0bc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0bd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c  ************ sql
0be0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 20 20 2a 2a  ite3_result_  **
0bf0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0c00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a  *************.**
0c10: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72   The following r
0c20: 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73 65 64  outines are used
0c30: 20 62 79 20 75 73 65 72 2d 64 65 66 69 6e 65 64   by user-defined
0c40: 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 73 70   functions to sp
0c50: 65 63 69 66 79 0a 2a 2a 20 74 68 65 20 66 75 6e  ecify.** the fun
0c60: 63 74 69 6f 6e 20 72 65 73 75 6c 74 2e 0a 2a 2f  ction result..*/
0c70: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
0c80: 73 75 6c 74 5f 62 6c 6f 62 28 0a 20 20 73 71 6c  sult_blob(.  sql
0c90: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
0ca0: 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69  tx, .  const voi
0cb0: 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20  d *z, .  int n, 
0cc0: 0a 20 20 69 6e 74 20 65 43 6f 70 79 0a 29 7b 0a  .  int eCopy.){.
0cd0: 20 20 61 73 73 65 72 74 28 20 6e 3e 30 20 29 3b    assert( n>0 );
0ce0: 0a 20 20 4d 65 6d 53 65 74 53 74 72 28 26 70 43  .  MemSetStr(&pC
0cf0: 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 30 2c 20  tx->s, z, n, 0, 
0d00: 65 43 6f 70 79 29 3b 0a 7d 0a 76 6f 69 64 20 73  eCopy);.}.void s
0d10: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f  qlite3_result_do
0d20: 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e  uble(sqlite3_con
0d30: 74 65 78 74 20 2a 70 43 74 78 2c 20 64 6f 75 62  text *pCtx, doub
0d40: 6c 65 20 72 56 61 6c 29 7b 0a 20 20 73 71 6c 69  le rVal){.  sqli
0d50: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 44 6f 75  te3VdbeMemSetDou
0d60: 62 6c 65 28 26 70 43 74 78 2d 3e 73 2c 20 72 56  ble(&pCtx->s, rV
0d70: 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69  al);.}.void sqli
0d80: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72  te3_result_error
0d90: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
0da0: 20 2a 70 43 74 78 2c 20 63 6f 6e 73 74 20 63 68   *pCtx, const ch
0db0: 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20  ar *z, int n){. 
0dc0: 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d   pCtx->isError =
0dd0: 20 31 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62   1;.  sqlite3Vdb
0de0: 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78  eMemSetStr(&pCtx
0df0: 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 54 45 58 54 5f  ->s, z, n, TEXT_
0e00: 55 74 66 38 2c 20 31 29 3b 0a 7d 0a 76 6f 69 64  Utf8, 1);.}.void
0e10: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
0e20: 65 72 72 6f 72 31 36 28 73 71 6c 69 74 65 33 5f  error16(sqlite3_
0e30: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63  context *pCtx, c
0e40: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 69 6e  onst void *z, in
0e50: 74 20 6e 29 7b 0a 20 20 70 43 74 78 2d 3e 69 73  t n){.  pCtx->is
0e60: 45 72 72 6f 72 20 3d 20 31 3b 0a 20 20 73 71 6c  Error = 1;.  sql
0e70: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
0e80: 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e  r(&pCtx->s, z, n
0e90: 2c 20 54 45 58 54 5f 55 74 66 31 36 2c 20 31 29  , TEXT_Utf16, 1)
0ea0: 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  ;.}.void sqlite3
0eb0: 5f 72 65 73 75 6c 74 5f 69 6e 74 33 32 28 73 71  _result_int32(sq
0ec0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
0ed0: 43 74 78 2c 20 69 6e 74 20 69 56 61 6c 29 7b 0a  Ctx, int iVal){.
0ee0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
0ef0: 53 65 74 49 6e 74 36 34 28 26 70 43 74 78 2d 3e  SetInt64(&pCtx->
0f00: 73 2c 20 28 69 36 34 29 69 56 61 6c 29 3b 0a 7d  s, (i64)iVal);.}
0f10: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
0f20: 73 75 6c 74 5f 69 6e 74 36 34 28 73 71 6c 69 74  sult_int64(sqlit
0f30: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
0f40: 2c 20 69 36 34 20 69 56 61 6c 29 7b 0a 20 20 73  , i64 iVal){.  s
0f50: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
0f60: 49 6e 74 36 34 28 26 70 43 74 78 2d 3e 73 2c 20  Int64(&pCtx->s, 
0f70: 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  iVal);.}.void sq
0f80: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 6e 75 6c  lite3_result_nul
0f90: 6c 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  l(sqlite3_contex
0fa0: 74 20 2a 70 43 74 78 29 7b 0a 20 20 73 71 69 6c  t *pCtx){.  sqil
0fb0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 4e 75 6c  te3VdbeMemSetNul
0fc0: 6c 28 26 70 43 74 78 2d 3e 73 29 3b 0a 7d 0a 76  l(&pCtx->s);.}.v
0fd0: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75  oid sqlite3_resu
0fe0: 6c 74 5f 74 65 78 74 28 0a 20 20 73 71 6c 69 74  lt_text(.  sqlit
0ff0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
1000: 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  , .  const char 
1010: 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 0a 20 20  *z, .  int n,.  
1020: 69 6e 74 20 65 43 6f 70 79 0a 29 7b 0a 20 20 4d  int eCopy.){.  M
1030: 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e  emSetStr(&pCtx->
1040: 73 2c 20 7a 2c 20 6e 2c 20 54 45 58 54 5f 55 74  s, z, n, TEXT_Ut
1050: 66 38 2c 20 65 43 6f 70 79 29 3b 0a 7d 0a 76 6f  f8, eCopy);.}.vo
1060: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
1070: 74 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69  t_text16(.  sqli
1080: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
1090: 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  x, .  const void
10a0: 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a   *z, .  int n, .
10b0: 20 20 69 6e 74 20 65 43 6f 70 79 0a 29 7b 0a 20    int eCopy.){. 
10c0: 20 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78   MemSetStr(&pCtx
10d0: 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 54 45 58 54 5f  ->s, z, n, TEXT_
10e0: 55 74 66 31 36 2c 20 65 43 6f 70 79 29 3b 0a 7d  Utf16, eCopy);.}
10f0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
1100: 73 75 6c 74 5f 76 61 6c 75 65 28 73 71 6c 69 74  sult_value(sqlit
1110: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
1120: 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  , sqlite3_value 
1130: 2a 70 56 61 6c 75 65 29 7b 0a 20 20 73 71 6c 69  *pValue){.  sqli
1140: 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79 28 26  te3VdbeMemCopy(&
1150: 70 43 74 78 2d 3e 73 2c 20 70 56 61 6c 75 65 29  pCtx->s, pValue)
1160: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63  ;.}.../*.** Exec
1170: 75 74 65 20 74 68 65 20 73 74 61 74 65 6d 65 6e  ute the statemen
1180: 74 20 70 53 74 6d 74 2c 20 65 69 74 68 65 72 20  t pStmt, either 
1190: 75 6e 74 69 6c 20 61 20 72 6f 77 20 6f 66 20 64  until a row of d
11a0: 61 74 61 20 69 73 20 72 65 61 64 79 2c 20 74 68  ata is ready, th
11b0: 65 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 69  e.** statement i
11c0: 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 65 78 65  s completely exe
11d0: 63 75 74 65 64 20 6f 72 20 61 6e 20 65 72 72 6f  cuted or an erro
11e0: 72 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74  r occurs..*/.int
11f0: 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 73 71   sqlite3_step(sq
1200: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
1210: 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  t){.  Vdbe *p = 
1220: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20  (Vdbe*)pStmt;.  
1230: 73 71 6c 69 74 65 20 2a 64 62 3b 0a 20 20 69 6e  sqlite *db;.  in
1240: 74 20 72 63 3b 0a 0a 20 20 69 66 28 20 70 2d 3e  t rc;..  if( p->
1250: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
1260: 43 5f 52 55 4e 20 29 7b 0a 20 20 20 20 72 65 74  C_RUN ){.    ret
1270: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
1280: 45 3b 0a 20 20 7d 0a 20 20 64 62 20 3d 20 70 2d  E;.  }.  db = p-
1290: 3e 64 62 3b 0a 20 20 69 66 28 20 73 71 6c 69 74  >db;.  if( sqlit
12a0: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29  e3SafetyOn(db) )
12b0: 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51  {.    p->rc = SQ
12c0: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 20  LITE_MISUSE;.   
12d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
12e0: 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66 28  ISUSE;.  }.  if(
12f0: 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29 7b 0a 20   p->explain ){. 
1300: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
1310: 64 62 65 4c 69 73 74 28 70 29 3b 0a 20 20 7d 65  dbeList(p);.  }e
1320: 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71  lse{.    rc = sq
1330: 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 70 29  lite3VdbeExec(p)
1340: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 73 71 6c  ;.  }..  if( sql
1350: 69 74 65 33 53 61 66 65 74 79 4f 66 66 28 64 62  ite3SafetyOff(db
1360: 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51  ) ){.    rc = SQ
1370: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d  LITE_MISUSE;.  }
1380: 0a 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72  ..  sqlite3Error
1390: 28 70 2d 3e 64 62 2c 20 72 63 2c 20 70 2d 3e 7a  (p->db, rc, p->z
13a0: 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 72  ErrMsg);.  retur
13b0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  n rc;.}../*.** R
13c0: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
13d0: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
13e0: 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 66 6f  he result set fo
13f0: 72 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20  r the statement 
1400: 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71  pStmt..*/.int sq
1410: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75  lite3_column_cou
1420: 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  nt(sqlite3_stmt 
1430: 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20  *pStmt){.  Vdbe 
1440: 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70  *pVm = (Vdbe *)p
1450: 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70  Stmt;.  return p
1460: 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a  Vm->nResColumn;.
1470: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
1480: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61  the number of va
1490: 6c 75 65 73 20 61 76 61 69 6c 61 62 6c 65 20 66  lues available f
14a0: 72 6f 6d 20 74 68 65 20 63 75 72 72 65 6e 74 20  rom the current 
14b0: 72 6f 77 20 6f 66 20 74 68 65 0a 2a 2a 20 63 75  row of the.** cu
14c0: 72 72 65 6e 74 6c 79 20 65 78 65 63 75 74 69 6e  rrently executin
14d0: 67 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d  g statement pStm
14e0: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  t..*/.int sqlite
14f0: 33 5f 64 61 74 61 5f 63 6f 75 6e 74 28 73 71 6c  3_data_count(sql
1500: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
1510: 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20 3d  ){.  Vdbe *pVm =
1520: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a   (Vdbe *)pStmt;.
1530: 20 20 69 66 28 20 21 70 56 6d 2d 3e 72 65 73 4f    if( !pVm->resO
1540: 6e 53 74 61 63 6b 20 29 20 72 65 74 75 72 6e 20  nStack ) return 
1550: 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 2d  0;.  return pVm-
1560: 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d 0a 0a  >nResColumn;.}..
1570: 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20  ./*.** Check to 
1580: 73 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69 43  see if column iC
1590: 6f 6c 20 6f 66 20 74 68 65 20 67 69 76 65 6e 20  ol of the given 
15a0: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 76 61 6c  statement is val
15b0: 69 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20 69 73  id.  If.** it is
15c0: 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  , return a point
15d0: 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 20 66 6f  er to the Mem fo
15e0: 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74  r the value of t
15f0: 68 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 49  hat column..** I
1600: 66 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20 76 61  f iCol is not va
1610: 6c 69 64 2c 20 72 65 74 75 72 6e 20 61 20 70 6f  lid, return a po
1620: 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 20 77  inter to a Mem w
1630: 68 69 63 68 20 68 61 73 20 61 20 76 61 6c 75 65  hich has a value
1640: 0a 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a 2f 0a  .** of NULL..*/.
1650: 73 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f 6c 75  static Mem *colu
1660: 6d 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f 73 74  mnMem(sqlite3_st
1670: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
1680: 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20 3d  ){.  Vdbe *pVm =
1690: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a   (Vdbe *)pStmt;.
16a0: 20 20 69 6e 74 20 76 61 6c 73 20 3d 20 73 71 6c    int vals = sql
16b0: 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74 28  ite3_data_count(
16c0: 70 53 74 6d 74 29 3b 0a 20 20 69 66 28 20 69 3e  pStmt);.  if( i>
16d0: 3d 76 61 6c 73 20 7c 7c 20 69 3c 30 20 29 7b 0a  =vals || i<0 ){.
16e0: 20 20 20 20 73 74 61 74 69 63 20 4d 65 6d 20 6e      static Mem n
16f0: 75 6c 6c 4d 65 6d 3b 0a 20 20 20 20 69 66 28 20  ullMem;.    if( 
1700: 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 67 73 3d 3d 30  nullMem.flags==0
1710: 20 29 7b 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 67   ){ nullMem.flag
1720: 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 20 7d 0a  s = MEM_Null; }.
1730: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
1740: 28 70 56 6d 2d 3e 64 62 2c 20 53 51 4c 49 54 45  (pVm->db, SQLITE
1750: 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20  _RANGE, 0);.    
1760: 72 65 74 75 72 6e 20 26 6e 75 6c 6c 4d 65 6d 3b  return &nullMem;
1770: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 26 70  .  }.  return &p
1780: 56 6d 2d 3e 70 54 6f 73 5b 28 31 2d 76 61 6c 73  Vm->pTos[(1-vals
1790: 29 2b 69 5d 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a  )+i];.}../******
17a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
17b0: 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 63  ****** sqlite3_c
17c0: 6f 6c 75 6d 6e 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a  olumn_  ********
17d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
17e0: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66  *******.** The f
17f0: 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65  ollowing routine
1800: 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 61 63  s are used to ac
1810: 63 65 73 73 20 65 6c 65 6d 65 6e 74 73 20 6f 66  cess elements of
1820: 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77   the current row
1830: 0a 2a 2a 20 69 6e 20 74 68 65 20 72 65 73 75 6c  .** in the resul
1840: 74 20 73 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71  t set..*/.int sq
1850: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74  lite3_column_byt
1860: 65 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  es(sqlite3_stmt 
1870: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a  *pStmt, int i){.
1880: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
1890: 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 20 63 6f  _value_bytes( co
18a0: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29  lumnMem(pStmt,i)
18b0: 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65   );.}.int sqlite
18c0: 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 31 36  3_column_bytes16
18d0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
18e0: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20  Stmt, int i){.  
18f0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76  return sqlite3_v
1900: 61 6c 75 65 5f 62 79 74 65 73 31 36 28 20 63 6f  alue_bytes16( co
1910: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29  lumnMem(pStmt,i)
1920: 20 29 3b 0a 7d 0a 64 6f 75 62 6c 65 20 73 71 6c   );.}.double sql
1930: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62  ite3_column_doub
1940: 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  le(sqlite3_stmt 
1950: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a  *pStmt, int i){.
1960: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
1970: 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 20 63  _value_double( c
1980: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69  olumnMem(pStmt,i
1990: 29 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74  ) );.}.int sqlit
19a0: 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 28 73 71  e3_column_int(sq
19b0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
19c0: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74  t, int i){.  ret
19d0: 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  urn sqlite3_valu
19e0: 65 5f 69 6e 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d  e_int( columnMem
19f0: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 6c  (pStmt,i) );.}.l
1a00: 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 20 73 71 6c  ong long int sql
1a10: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36  ite3_column_int6
1a20: 34 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  4(sqlite3_stmt *
1a30: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
1a40: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f   return sqlite3_
1a50: 76 61 6c 75 65 5f 69 6e 74 36 34 28 20 63 6f 6c  value_int64( col
1a60: 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20  umnMem(pStmt,i) 
1a70: 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 69 67  );.}.const unsig
1a80: 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69 74 65  ned char *sqlite
1a90: 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 73 71  3_column_text(sq
1aa0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
1ab0: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74  t, int i){.  ret
1ac0: 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  urn sqlite3_valu
1ad0: 65 5f 74 65 78 74 28 20 63 6f 6c 75 6d 6e 4d 65  e_text( columnMe
1ae0: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a  m(pStmt,i) );.}.
1af0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
1b00: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31  te3_column_text1
1b10: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
1b20: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
1b30: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f   return sqlite3_
1b40: 76 61 6c 75 65 5f 74 65 78 74 31 36 28 20 63 6f  value_text16( co
1b50: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29  lumnMem(pStmt,i)
1b60: 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65   );.}.int sqlite
1b70: 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 28 73 71  3_column_type(sq
1b80: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
1b90: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74  t, int i){.  ret
1ba0: 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  urn sqlite3_valu
1bb0: 65 5f 74 79 70 65 28 20 63 6f 6c 75 6d 6e 4d 65  e_type( columnMe
1bc0: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a  m(pStmt,i) );.}.
1bd0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
1be0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 4e  he name of the N
1bf0: 74 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65  th column of the
1c00: 20 72 65 73 75 6c 74 20 73 65 74 20 72 65 74 75   result set retu
1c10: 72 6e 65 64 20 62 79 20 53 51 4c 0a 2a 2a 20 73  rned by SQL.** s
1c20: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a  tatement pStmt..
1c30: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
1c40: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61  qlite3_column_na
1c50: 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  me(sqlite3_stmt 
1c60: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
1c70: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
1c80: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d  e *)pStmt;.  Mem
1c90: 20 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 0a 20 20 69   *pColName;..  i
1ca0: 66 28 20 4e 3e 3d 73 71 6c 69 74 65 33 5f 63 6f  f( N>=sqlite3_co
1cb0: 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74  lumn_count(pStmt
1cc0: 29 20 7c 7c 20 4e 3c 30 20 29 7b 0a 20 20 20 20  ) || N<0 ){.    
1cd0: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e  sqlite3Error(p->
1ce0: 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  db, SQLITE_RANGE
1cf0: 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  , 0);.    return
1d00: 20 30 3b 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 4e   0;.  }..  pColN
1d10: 61 6d 65 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e  ame = &(p->aColN
1d20: 61 6d 65 5b 4e 5d 29 3b 0a 20 20 72 65 74 75 72  ame[N]);.  retur
1d30: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
1d40: 74 65 78 74 28 70 43 6f 6c 4e 61 6d 65 29 3b 0a  text(pColName);.
1d50: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
1d60: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
1d70: 27 69 27 74 68 20 63 6f 6c 75 6d 6e 20 6f 66 20  'i'th column of 
1d80: 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f  the result set o
1d90: 66 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 0a  f SQL statement.
1da0: 2a 2a 20 70 53 74 6d 74 2c 20 65 6e 63 6f 64 65  ** pStmt, encode
1db0: 64 20 61 73 20 55 54 46 2d 31 36 2e 0a 2a 2f 0a  d as UTF-16..*/.
1dc0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
1dd0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 31  te3_column_name1
1de0: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
1df0: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
1e00: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
1e10: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20   *)pStmt;.  Mem 
1e20: 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 0a 20 20 69 66  *pColName;..  if
1e30: 28 20 4e 3e 3d 73 71 6c 69 74 65 33 5f 63 6f 6c  ( N>=sqlite3_col
1e40: 75 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29  umn_count(pStmt)
1e50: 20 7c 7c 20 4e 3c 30 20 29 7b 0a 20 20 20 20 73   || N<0 ){.    s
1e60: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64  qlite3Error(p->d
1e70: 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c  b, SQLITE_RANGE,
1e80: 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20   0);.    return 
1e90: 30 3b 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 4e 61  0;.  }..  pColNa
1ea0: 6d 65 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61  me = &(p->aColNa
1eb0: 6d 65 5b 4e 5d 29 3b 0a 20 20 72 65 74 75 72 6e  me[N]);.  return
1ec0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
1ed0: 65 78 74 31 36 28 70 43 6f 6c 4e 61 6d 65 29 3b  ext16(pColName);
1ee0: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  .}.../*.** This 
1ef0: 72 6f 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20  routine returns 
1f00: 65 69 74 68 65 72 20 74 68 65 20 63 6f 6c 75 6d  either the colum
1f10: 6e 20 6e 61 6d 65 2c 20 6f 72 20 64 65 63 6c 61  n name, or decla
1f20: 72 61 74 69 6f 6e 20 74 79 70 65 20 28 73 65 65  ration type (see
1f30: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  .** sqlite3_colu
1f40: 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 28 29 20  mn_decltype16() 
1f50: 29 20 6f 66 20 74 68 65 20 27 69 27 74 68 20 63  ) of the 'i'th c
1f60: 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73  olumn of the res
1f70: 75 6c 74 20 73 65 74 20 6f 66 0a 2a 2a 20 53 51  ult set of.** SQ
1f80: 4c 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d  L statement pStm
1f90: 74 2e 20 54 68 65 20 72 65 74 75 72 6e 65 64 20  t. The returned 
1fa0: 73 74 72 69 6e 67 20 69 73 20 55 54 46 2d 31 36  string is UTF-16
1fb0: 20 65 6e 63 6f 64 65 64 2e 0a 2a 2a 0a 2a 2a 20   encoded..**.** 
1fc0: 54 68 65 20 64 65 63 6c 61 72 61 74 69 6f 6e 20  The declaration 
1fd0: 74 79 70 65 20 69 73 20 72 65 74 75 72 6e 65 64  type is returned
1fe0: 20 69 66 20 27 64 65 63 6c 74 79 70 65 27 20 69   if 'decltype' i
1ff0: 73 20 74 72 75 65 2c 20 6f 74 68 65 72 77 69 73  s true, otherwis
2000: 65 0a 2a 2a 20 74 68 65 20 63 6f 6c 75 6d 6e 20  e.** the column 
2010: 6e 61 6d 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  name..*/.static 
2020: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c 75  const void *colu
2030: 6d 6e 4e 61 6d 65 31 36 28 73 71 6c 69 74 65 33  mnName16(sqlite3
2040: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
2050: 74 20 69 2c 20 69 6e 74 20 64 65 63 6c 74 79 70  t i, int decltyp
2060: 65 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  e){.  Vdbe *p = 
2070: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 0a  (Vdbe *)pStmt;..
2080: 20 20 69 66 28 20 69 3e 3d 73 71 6c 69 74 65 33    if( i>=sqlite3
2090: 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70 53  _column_count(pS
20a0: 74 6d 74 29 20 7c 7c 20 69 3c 30 20 29 7b 0a 20  tmt) || i<0 ){. 
20b0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
20c0: 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41  p->db, SQLITE_RA
20d0: 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74  NGE, 0);.    ret
20e0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 69 66  urn 0;.  }..  if
20f0: 28 20 64 65 63 6c 74 79 70 65 20 29 7b 0a 20 20  ( decltype ){.  
2100: 20 20 69 20 2b 3d 20 70 2d 3e 6e 52 65 73 43 6f    i += p->nResCo
2110: 6c 75 6d 6e 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  lumn;.  }..  if(
2120: 20 21 70 2d 3e 61 7a 43 6f 6c 4e 61 6d 65 31 36   !p->azColName16
2130: 20 29 7b 0a 20 20 20 20 70 2d 3e 61 7a 43 6f 6c   ){.    p->azCol
2140: 4e 61 6d 65 31 36 20 3d 20 28 76 6f 69 64 20 2a  Name16 = (void *
2150: 2a 29 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 73  *)sqliteMalloc(s
2160: 69 7a 65 6f 66 28 76 6f 69 64 20 2a 29 2a 70 2d  izeof(void *)*p-
2170: 3e 6e 52 65 73 43 6f 6c 75 6d 6e 2a 32 29 3b 0a  >nResColumn*2);.
2180: 20 20 20 20 69 66 28 20 21 70 2d 3e 61 7a 43 6f      if( !p->azCo
2190: 6c 4e 61 6d 65 31 36 20 29 7b 0a 20 20 20 20 20  lName16 ){.     
21a0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d   sqlite3Error(p-
21b0: 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  >db, SQLITE_NOME
21c0: 4d 2c 20 30 29 3b 0a 20 20 20 20 20 20 72 65 74  M, 0);.      ret
21d0: 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d  urn 0;.    }.  }
21e0: 0a 20 20 69 66 28 20 21 70 2d 3e 61 7a 43 6f 6c  .  if( !p->azCol
21f0: 4e 61 6d 65 31 36 5b 69 5d 20 29 7b 0a 20 20 20  Name16[i] ){.   
2200: 20 69 66 28 20 53 51 4c 49 54 45 33 5f 42 49 47   if( SQLITE3_BIG
2210: 45 4e 44 49 41 4e 20 29 7b 0a 20 20 20 20 20 20  ENDIAN ){.      
2220: 70 2d 3e 61 7a 43 6f 6c 4e 61 6d 65 31 36 5b 69  p->azColName16[i
2230: 5d 20 3d 20 73 71 6c 69 74 65 33 75 74 66 38 74  ] = sqlite3utf8t
2240: 6f 31 36 62 65 28 70 2d 3e 61 7a 43 6f 6c 4e 61  o16be(p->azColNa
2250: 6d 65 5b 69 5d 2c 20 2d 31 29 3b 0a 20 20 20 20  me[i], -1);.    
2260: 7d 0a 20 20 20 20 69 66 28 20 21 70 2d 3e 61 7a  }.    if( !p->az
2270: 43 6f 6c 4e 61 6d 65 31 36 5b 69 5d 20 29 7b 0a  ColName16[i] ){.
2280: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72        sqlite3Err
2290: 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45  or(p->db, SQLITE
22a0: 5f 4e 4f 4d 45 4d 2c 20 30 29 3b 0a 20 20 20 20  _NOMEM, 0);.    
22b0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20    return 0;.    
22c0: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  }.  }.  return p
22d0: 2d 3e 61 7a 43 6f 6c 4e 61 6d 65 31 36 5b 69 5d  ->azColName16[i]
22e0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
22f0: 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 63  n the column dec
2300: 6c 61 72 61 74 69 6f 6e 20 74 79 70 65 20 28 69  laration type (i
2310: 66 20 61 70 70 6c 69 63 61 62 6c 65 29 20 6f 66  f applicable) of
2320: 20 74 68 65 20 27 69 27 74 68 20 63 6f 6c 75 6d   the 'i'th colum
2330: 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 72 65 73 75  n.** of the resu
2340: 6c 74 20 73 65 74 20 6f 66 20 53 51 4c 20 73 74  lt set of SQL st
2350: 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2c 20 65  atement pStmt, e
2360: 6e 63 6f 64 65 64 20 61 73 20 55 54 46 2d 38 2e  ncoded as UTF-8.
2370: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a  .*/.const char *
2380: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
2390: 65 63 6c 74 79 70 65 28 73 71 6c 69 74 65 33 5f  ecltype(sqlite3_
23a0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
23b0: 20 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d   i){.  Vdbe *p =
23c0: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a   (Vdbe *)pStmt;.
23d0: 0a 20 20 69 66 28 20 69 3e 3d 73 71 6c 69 74 65  .  if( i>=sqlite
23e0: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70  3_column_count(p
23f0: 53 74 6d 74 29 20 7c 7c 20 69 3c 30 20 29 7b 0a  Stmt) || i<0 ){.
2400: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
2410: 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52  (p->db, SQLITE_R
2420: 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 72 65  ANGE, 0);.    re
2430: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 72  turn 0;.  }..  r
2440: 65 74 75 72 6e 20 70 2d 3e 61 7a 43 6f 6c 4e 61  eturn p->azColNa
2450: 6d 65 5b 69 2b 70 2d 3e 6e 52 65 73 43 6f 6c 75  me[i+p->nResColu
2460: 6d 6e 5d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  mn];.}../*.** Re
2470: 74 75 72 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20  turn the column 
2480: 64 65 63 6c 61 72 61 74 69 6f 6e 20 74 79 70 65  declaration type
2490: 20 28 69 66 20 61 70 70 6c 69 63 61 62 6c 65 29   (if applicable)
24a0: 20 6f 66 20 74 68 65 20 27 69 27 74 68 20 63 6f   of the 'i'th co
24b0: 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 72  lumn.** of the r
24c0: 65 73 75 6c 74 20 73 65 74 20 6f 66 20 53 51 4c  esult set of SQL
24d0: 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74   statement pStmt
24e0: 2c 20 65 6e 63 6f 64 65 64 20 61 73 20 55 54 46  , encoded as UTF
24f0: 2d 31 36 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f  -16..*/.const vo
2500: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  id *sqlite3_colu
2510: 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 28 73 71  mn_decltype16(sq
2520: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
2530: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74  t, int i){.  ret
2540: 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 31 36  urn columnName16
2550: 28 70 53 74 6d 74 2c 20 69 2c 20 31 29 3b 0a 7d  (pStmt, i, 1);.}
2560: 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ../*************
2570: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2580: 2a 2a 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  ** sqlite3_bind_
2590: 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a    **************
25a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a  *************.**
25b0: 20 0a 2a 2a 20 52 6f 75 74 69 6e 65 73 20 75 73   .** Routines us
25c0: 65 64 20 74 6f 20 61 74 74 61 63 68 20 76 61 6c  ed to attach val
25d0: 75 65 73 20 74 6f 20 77 69 6c 64 63 61 72 64 73  ues to wildcards
25e0: 20 69 6e 20 61 20 63 6f 6d 70 69 6c 65 64 20 53   in a compiled S
25f0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f  QL statement..*/
2600: 0a 2f 2a 0a 2a 2a 20 55 6e 62 69 6e 64 20 74 68  ./*.** Unbind th
2610: 65 20 76 61 6c 75 65 20 62 6f 75 6e 64 20 74 6f  e value bound to
2620: 20 76 61 72 69 61 62 6c 65 20 69 20 69 6e 20 76   variable i in v
2630: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 70  irtual machine p
2640: 2e 20 54 68 69 73 20 69 73 20 74 68 65 20 0a 2a  . This is the .*
2650: 2a 20 74 68 65 20 73 61 6d 65 20 61 73 20 62 69  * the same as bi
2660: 6e 64 69 6e 67 20 61 20 4e 55 4c 4c 20 76 61 6c  nding a NULL val
2670: 75 65 20 74 6f 20 74 68 65 20 63 6f 6c 75 6d 6e  ue to the column
2680: 2e 20 49 66 20 74 68 65 20 22 69 22 20 70 61 72  . If the "i" par
2690: 61 6d 65 74 65 72 20 69 73 0a 2a 2a 20 6f 75 74  ameter is.** out
26a0: 20 6f 66 20 72 61 6e 67 65 2c 20 74 68 65 6e 20   of range, then 
26b0: 53 51 4c 49 54 45 5f 52 41 4e 47 45 20 69 73 20  SQLITE_RANGE is 
26c0: 72 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 77 69  returned. Othewi
26d0: 73 65 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a  se SQLITE_OK..**
26e0: 0a 2a 2a 20 54 68 65 20 65 72 72 6f 72 20 63 6f  .** The error co
26f0: 64 65 20 73 74 6f 72 65 64 20 69 6e 20 64 61 74  de stored in dat
2700: 61 62 61 73 65 20 70 2d 3e 64 62 20 69 73 20 6f  abase p->db is o
2710: 76 65 72 77 72 69 74 74 65 6e 20 77 69 74 68 20  verwritten with 
2720: 74 68 65 20 72 65 74 75 72 6e 0a 2a 2a 20 76 61  the return.** va
2730: 6c 75 65 20 69 6e 20 61 6e 79 20 63 61 73 65 2e  lue in any case.
2740: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76  .*/.static int v
2750: 64 62 65 55 6e 62 69 6e 64 28 56 64 62 65 20 2a  dbeUnbind(Vdbe *
2760: 70 2c 20 69 6e 74 20 69 29 7b 0a 20 20 4d 65 6d  p, int i){.  Mem
2770: 20 2a 70 56 61 72 3b 0a 20 20 69 66 28 20 70 2d   *pVar;.  if( p-
2780: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47  >magic!=VDBE_MAG
2790: 49 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e 70 63 21  IC_RUN || p->pc!
27a0: 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  =0 ){.    sqlite
27b0: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51  3Error(p->db, SQ
27c0: 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b  LITE_MISUSE, 0);
27d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
27e0: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20  TE_MISUSE;.  }. 
27f0: 20 69 66 28 20 69 3c 31 20 7c 7c 20 69 3e 70 2d   if( i<1 || i>p-
2800: 3e 6e 56 61 72 20 29 7b 0a 20 20 20 20 73 71 6c  >nVar ){.    sql
2810: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c  ite3Error(p->db,
2820: 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30   SQLITE_RANGE, 0
2830: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
2840: 4c 49 54 45 5f 52 41 4e 47 45 3b 0a 20 20 7d 0a  LITE_RANGE;.  }.
2850: 20 20 69 2d 2d 3b 0a 20 20 70 56 61 72 20 3d 20    i--;.  pVar = 
2860: 26 70 2d 3e 61 70 56 61 72 5b 69 5d 3b 0a 20 20  &p->apVar[i];.  
2870: 69 66 28 20 70 56 61 72 2d 3e 66 6c 61 67 73 26  if( pVar->flags&
2880: 4d 45 4d 5f 44 79 6e 20 29 7b 0a 20 20 20 20 73  MEM_Dyn ){.    s
2890: 71 6c 69 74 65 46 72 65 65 28 70 56 61 72 2d 3e  qliteFree(pVar->
28a0: 7a 29 3b 0a 20 20 7d 0a 20 20 70 56 61 72 2d 3e  z);.  }.  pVar->
28b0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
28c0: 3b 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72  ;.  sqlite3Error
28d0: 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4f  (p->db, SQLITE_O
28e0: 4b 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20  K, 0);.  return 
28f0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
2900: 0a 2a 2a 20 42 69 6e 64 20 61 20 62 6c 6f 62 20  .** Bind a blob 
2910: 76 61 6c 75 65 20 74 6f 20 61 6e 20 53 51 4c 20  value to an SQL 
2920: 73 74 61 74 65 6d 65 6e 74 20 76 61 72 69 61 62  statement variab
2930: 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  le..*/.int sqlit
2940: 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 28 0a 20 20  e3_bind_blob(.  
2950: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 2c  sqlite3_stmt *p,
2960: 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f   .  int i, .  co
2970: 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c  nst void *zData,
2980: 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a   .  int nData, .
2990: 20 20 69 6e 74 20 65 43 6f 70 79 0a 29 7b 0a 20    int eCopy.){. 
29a0: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
29b0: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20   *)pStmt;.  Mem 
29c0: 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72 63 3b  *pVar;.  int rc;
29d0: 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62  ..  rc = vdbeUnb
29e0: 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28  ind(p, i);.  if(
29f0: 20 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72   rc ){.    retur
2a00: 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 56 61 72  n rc;.  }.  pVar
2a10: 20 3d 20 26 70 2d 3e 61 70 56 61 72 5b 69 2d 31   = &p->apVar[i-1
2a20: 5d 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  ];.  rc = sqlite
2a30: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70  3VdbeMemSetStr(p
2a40: 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74  Var, zData, nDat
2a50: 61 2c 20 30 2c 20 65 43 6f 70 79 29 3b 0a 20 20  a, 0, eCopy);.  
2a60: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74  return rc;.}.int
2a70: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f   sqlite3_bind_do
2a80: 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  uble(sqlite3_stm
2a90: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c  t *pStmt, int i,
2aa0: 20 64 6f 75 62 6c 65 20 72 56 61 6c 75 65 29 7b   double rValue){
2ab0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62  .  int rc;.  Vdb
2ac0: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
2ad0: 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a 70 56 61  Stmt;.  Mem *pVa
2ae0: 72 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e  r;.  rc = vdbeUn
2af0: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66  bind(p, i);.  if
2b00: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
2b10: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64  ){.    sqlite3Vd
2b20: 62 65 4d 65 6d 53 65 74 52 65 61 6c 28 26 70 2d  beMemSetReal(&p-
2b30: 3e 61 70 56 61 72 5b 69 2d 31 5d 2c 20 72 56 61  >apVar[i-1], rVa
2b40: 6c 75 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  lue);.  }.  retu
2b50: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
2b60: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
2b70: 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  _int(sqlite3_stm
2b80: 74 20 2a 70 2c 20 69 6e 74 20 69 2c 20 69 6e 74  t *p, int i, int
2b90: 20 69 56 61 6c 75 65 29 7b 0a 20 20 72 65 74 75   iValue){.  retu
2ba0: 72 6e 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  rn sqlite3_bind_
2bb0: 69 6e 74 36 34 28 70 2c 20 69 2c 20 28 6c 6f 6e  int64(p, i, (lon
2bc0: 67 20 6c 6f 6e 67 20 69 6e 74 29 69 56 61 6c 75  g long int)iValu
2bd0: 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  e);.}.int sqlite
2be0: 33 5f 62 69 6e 64 5f 69 6e 74 36 34 28 73 71 6c  3_bind_int64(sql
2bf0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
2c00: 2c 20 69 6e 74 20 69 2c 20 6c 6f 6e 67 20 6c 6f  , int i, long lo
2c10: 6e 67 20 69 6e 74 20 69 56 61 6c 75 65 29 7b 0a  ng int iValue){.
2c20: 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65    int rc;.  Vdbe
2c30: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
2c40: 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65  tmt;.  rc = vdbe
2c50: 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20  Unbind(p, i);.  
2c60: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
2c70: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  K ){.    sqlite3
2c80: 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 28 26 70  VdbeMemSetInt(&p
2c90: 2d 3e 61 70 56 61 72 5b 69 2d 31 5d 2c 20 69 56  ->apVar[i-1], iV
2ca0: 61 6c 75 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74  alue);.  }.  ret
2cb0: 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71  urn rc;.}.int sq
2cc0: 6c 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c 28  lite3_bind_null(
2cd0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 20 70 2c  sqlite3_stmt* p,
2ce0: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
2cf0: 6e 20 76 64 62 65 55 6e 62 69 6e 64 28 28 56 64  n vdbeUnbind((Vd
2d00: 62 65 20 2a 29 70 2c 20 69 29 3b 0a 7d 0a 69 6e  be *)p, i);.}.in
2d10: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74  t sqlite3_bind_t
2d20: 65 78 74 28 20 0a 20 20 73 71 6c 69 74 65 33 5f  ext( .  sqlite3_
2d30: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20  stmt *pStmt, .  
2d40: 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20  int i, .  const 
2d50: 63 68 61 72 20 2a 7a 44 61 74 61 2c 20 0a 20 20  char *zData, .  
2d60: 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 69 6e  int nData, .  in
2d70: 74 20 65 43 6f 70 79 0a 29 7b 0a 20 20 56 64 62  t eCopy.){.  Vdb
2d80: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
2d90: 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a 70 56 61  Stmt;.  Mem *pVa
2da0: 72 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20  r;.  int rc;..  
2db0: 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28  rc = vdbeUnbind(
2dc0: 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 20  p, i);.  if( rc 
2dd0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63  ){.    return rc
2de0: 3b 0a 20 20 7d 0a 20 20 70 56 61 72 20 3d 20 26  ;.  }.  pVar = &
2df0: 70 2d 3e 61 70 56 61 72 5b 69 2d 31 5d 3b 0a 20  p->apVar[i-1];. 
2e00: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
2e10: 65 4d 65 6d 53 65 74 53 74 72 28 70 56 61 72 2c  eMemSetStr(pVar,
2e20: 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 54   zData, nData, T
2e30: 45 58 54 5f 55 74 66 38 2c 20 65 43 6f 70 79 29  EXT_Utf8, eCopy)
2e40: 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20  ;.  if( rc ){.  
2e50: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d    return rc;.  }
2e60: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56  .  rc = sqlite3V
2e70: 64 62 65 53 65 74 45 6e 63 6f 64 69 6e 67 28 70  dbeSetEncoding(p
2e80: 56 61 72 2c 20 70 2d 3e 64 62 2d 3e 65 6e 63 29  Var, p->db->enc)
2e90: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
2ea0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
2eb0: 64 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69  d_text16(.  sqli
2ec0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
2ed0: 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f   .  int i, .  co
2ee0: 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c  nst void *zData,
2ef0: 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a   .  int nData, .
2f00: 20 20 69 6e 74 20 65 43 6f 70 79 0a 29 7b 0a 20    int eCopy.){. 
2f10: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
2f20: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20   *)pStmt;.  Mem 
2f30: 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72 63 3b  *pVar;.  int rc;
2f40: 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62  ..  rc = vdbeUnb
2f50: 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28  ind(p, i);.  if(
2f60: 20 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72   rc ){.    retur
2f70: 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 4d 65 6d 20  n rc;.  }.  Mem 
2f80: 2a 70 56 61 72 20 3d 20 26 70 2d 3e 61 70 56 61  *pVar = &p->apVa
2f90: 72 5b 69 2d 31 5d 3b 0a 0a 20 20 2f 2a 20 54 68  r[i-1];..  /* Th
2fa0: 65 72 65 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e  ere may or may n
2fb0: 6f 74 20 62 65 20 61 20 62 79 74 65 20 6f 72 64  ot be a byte ord
2fc0: 65 72 20 6d 61 72 6b 20 61 74 20 74 68 65 20 73  er mark at the s
2fd0: 74 61 72 74 20 6f 66 20 74 68 65 20 55 54 46 2d  tart of the UTF-
2fe0: 31 36 2e 0a 20 20 2a 2a 20 45 69 74 68 65 72 20  16..  ** Either 
2ff0: 77 61 79 20 73 65 74 20 27 74 78 74 5f 65 6e 63  way set 'txt_enc
3000: 27 20 74 6f 20 74 68 65 20 54 45 58 54 5f 55 74  ' to the TEXT_Ut
3010: 66 31 36 2a 20 76 61 6c 75 65 20 69 6e 64 69 63  f16* value indic
3020: 61 74 69 6e 67 20 74 68 65 20 0a 20 20 2a 2a 20  ating the .  ** 
3030: 61 63 74 75 61 6c 20 62 79 74 65 20 6f 72 64 65  actual byte orde
3040: 72 20 75 73 65 64 20 62 79 20 74 68 69 73 20 73  r used by this s
3050: 74 72 69 6e 67 2e 20 49 66 20 74 68 65 20 73 74  tring. If the st
3060: 72 69 6e 67 20 64 6f 65 73 20 68 61 70 70 65 6e  ring does happen
3070: 0a 20 20 2a 2a 20 74 6f 20 63 6f 6e 74 61 69 6e  .  ** to contain
3080: 20 61 20 42 4f 4d 2c 20 74 68 65 6e 20 6d 6f 76   a BOM, then mov
3090: 65 20 7a 44 61 74 61 20 73 6f 20 74 68 61 74 20  e zData so that 
30a0: 69 74 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65  it points to the
30b0: 20 66 69 72 73 74 0a 20 20 2a 2a 20 62 79 74 65   first.  ** byte
30c0: 20 61 66 74 65 72 20 74 68 65 20 42 4f 4d 2e 0a   after the BOM..
30d0: 20 20 2a 2f 0a 20 20 74 78 74 5f 65 6e 63 20 3d    */.  txt_enc =
30e0: 20 73 71 6c 69 74 65 33 55 74 66 52 65 61 64 42   sqlite3UtfReadB
30f0: 6f 6d 28 7a 44 61 74 61 2c 20 6e 44 61 74 61 29  om(zData, nData)
3100: 3b 0a 20 20 69 66 28 20 74 78 74 5f 65 6e 63 20  ;.  if( txt_enc 
3110: 29 7b 0a 20 20 20 20 7a 44 61 74 61 20 3d 20 28  ){.    zData = (
3120: 76 6f 69 64 20 2a 29 28 28 28 75 38 20 2a 29 7a  void *)(((u8 *)z
3130: 44 61 74 61 29 20 2b 20 32 29 3b 0a 20 20 20 20  Data) + 2);.    
3140: 6e 44 61 74 61 20 2d 3d 20 32 3b 0a 20 20 7d 65  nData -= 2;.  }e
3150: 6c 73 65 7b 0a 20 20 20 20 74 78 74 5f 65 6e 63  lse{.    txt_enc
3160: 20 3d 20 53 51 4c 49 54 45 33 5f 42 49 47 45 4e   = SQLITE3_BIGEN
3170: 44 49 41 4e 3f 54 45 58 54 5f 55 74 66 31 36 62  DIAN?TEXT_Utf16b
3180: 65 3a 54 45 58 54 5f 55 74 66 31 36 6c 65 3b 0a  e:TEXT_Utf16le;.
3190: 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74    }.  rc = sqlit
31a0: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
31b0: 70 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61  pVar, zData, nDa
31c0: 74 61 2c 20 74 78 74 5f 65 6e 63 2c 20 65 43 6f  ta, txt_enc, eCo
31d0: 70 79 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b  py);.  if( rc ){
31e0: 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  .    return rc;.
31f0: 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74    }.  rc = sqlit
3200: 65 33 56 64 62 65 53 65 74 45 6e 63 6f 64 69 6e  e3VdbeSetEncodin
3210: 67 28 70 56 61 72 2c 20 70 2d 3e 64 62 2d 3e 65  g(pVar, p->db->e
3220: 6e 63 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  nc);.  return rc
3230: 3b 0a 7d 0a                                      ;.}.