/ Hex Artifact Content
Login

Artifact 5025a9163107e0a4964212d16e1c4defa13dc5c2:


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 0a 2a 2a 20 52 65 74 75 72 6e 20  "../*.** Return 
0200: 54 52 55 45 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20  TRUE (non-zero) 
0210: 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  of the statement
0220: 20 73 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20   supplied as an 
0230: 61 72 67 75 6d 65 6e 74 20 6e 65 65 64 73 0a 2a  argument needs.*
0240: 2a 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 6c  * to be recompil
0250: 65 64 2e 20 20 41 20 73 74 61 74 65 6d 65 6e 74  ed.  A statement
0260: 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65 63   needs to be rec
0270: 6f 6d 70 69 6c 65 64 20 77 68 65 6e 65 76 65 72  ompiled whenever
0280: 20 74 68 65 0a 2a 2a 20 65 78 65 63 75 74 69 6f   the.** executio
0290: 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 63 68  n environment ch
02a0: 61 6e 67 65 73 20 69 6e 20 61 20 77 61 79 20 74  anges in a way t
02b0: 68 61 74 20 77 6f 75 6c 64 20 61 6c 74 65 72 20  hat would alter 
02c0: 74 68 65 20 70 72 6f 67 72 61 6d 0a 2a 2a 20 74  the program.** t
02d0: 68 61 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70  hat sqlite3_prep
02e0: 61 72 65 28 29 20 67 65 6e 65 72 61 74 65 73 2e  are() generates.
02f0: 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69    For example, i
0300: 66 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 73 20  f new functions 
0310: 6f 72 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20  or.** collating 
0320: 73 65 71 75 65 6e 63 65 73 20 61 72 65 20 72 65  sequences are re
0330: 67 69 73 74 65 72 65 64 20 6f 72 20 69 66 20 61  gistered or if a
0340: 6e 20 61 75 74 68 6f 72 69 7a 65 72 20 66 75 6e  n authorizer fun
0350: 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 61 64 64 65  ction is.** adde
0360: 64 20 6f 72 20 63 68 61 6e 67 65 64 2e 0a 2a 2f  d or changed..*/
0370: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 70  .int sqlite3_exp
0380: 69 72 65 64 28 73 71 6c 69 74 65 33 5f 73 74 6d  ired(sqlite3_stm
0390: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62  t *pStmt){.  Vdb
03a0: 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53  e *p = (Vdbe*)pS
03b0: 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 3d  tmt;.  return p=
03c0: 3d 30 20 7c 7c 20 70 2d 3e 65 78 70 69 72 65 64  =0 || p->expired
03d0: 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ;.}../**********
03e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
03f0: 2a 2a 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  ** sqlite3_value
0400: 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  _  *************
0410: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0420: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  **.** The follow
0430: 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 65 78 74  ing routines ext
0440: 72 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  ract information
0450: 20 66 72 6f 6d 20 61 20 4d 65 6d 20 6f 72 20 73   from a Mem or s
0460: 71 6c 69 74 65 33 5f 76 61 6c 75 65 0a 2a 2a 20  qlite3_value.** 
0470: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63 6f  structure..*/.co
0480: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65  nst void *sqlite
0490: 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 73 71 6c  3_value_blob(sql
04a0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c  ite3_value *pVal
04b0: 29 7b 0a 20 20 4d 65 6d 20 2a 70 20 3d 20 28 4d  ){.  Mem *p = (M
04c0: 65 6d 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28 20  em*)pVal;.  if( 
04d0: 70 2d 3e 66 6c 61 67 73 20 26 20 28 4d 45 4d 5f  p->flags & (MEM_
04e0: 42 6c 6f 62 7c 4d 45 4d 5f 53 74 72 29 20 29 7b  Blob|MEM_Str) ){
04f0: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 2d 3e 7a  .    return p->z
0500: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72  ;.  }else{.    r
0510: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
0520: 6c 75 65 5f 74 65 78 74 28 70 56 61 6c 29 3b 0a  lue_text(pVal);.
0530: 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65    }.}.int sqlite
0540: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 73 71  3_value_bytes(sq
0550: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
0560: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
0570: 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70  ite3ValueBytes(p
0580: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38  Val, SQLITE_UTF8
0590: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  );.}.int sqlite3
05a0: 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28 73  _value_bytes16(s
05b0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
05c0: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71  al){.  return sq
05d0: 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28  lite3ValueBytes(
05e0: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  pVal, SQLITE_UTF
05f0: 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 64 6f 75  16NATIVE);.}.dou
0600: 62 6c 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  ble sqlite3_valu
0610: 65 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33  e_double(sqlite3
0620: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20  _value *pVal){. 
0630: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
0640: 64 62 65 52 65 61 6c 56 61 6c 75 65 28 28 4d 65  dbeRealValue((Me
0650: 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 69 6e 74 20  m*)pVal);.}.int 
0660: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e  sqlite3_value_in
0670: 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  t(sqlite3_value 
0680: 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e  *pVal){.  return
0690: 20 73 71 6c 69 74 65 33 56 64 62 65 49 6e 74 56   sqlite3VdbeIntV
06a0: 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56 61 6c 29  alue((Mem*)pVal)
06b0: 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34  ;.}.sqlite_int64
06c0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69   sqlite3_value_i
06d0: 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 76 61 6c  nt64(sqlite3_val
06e0: 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74  ue *pVal){.  ret
06f0: 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65 49  urn sqlite3VdbeI
0700: 6e 74 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56  ntValue((Mem*)pV
0710: 61 6c 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73  al);.}.const uns
0720: 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69  igned char *sqli
0730: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 73  te3_value_text(s
0740: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
0750: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 28 63  al){.  return (c
0760: 6f 6e 73 74 20 63 68 61 72 20 2a 29 73 71 6c 69  onst char *)sqli
0770: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61  te3ValueText(pVa
0780: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b  l, SQLITE_UTF8);
0790: 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  .}.#ifndef SQLIT
07a0: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e  E_OMIT_UTF16.con
07b0: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  st void *sqlite3
07c0: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 73 71  _value_text16(sq
07d0: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70 56 61  lite3_value* pVa
07e0: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
07f0: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56  ite3ValueText(pV
0800: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  al, SQLITE_UTF16
0810: 4e 41 54 49 56 45 29 3b 0a 7d 0a 63 6f 6e 73 74  NATIVE);.}.const
0820: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76   void *sqlite3_v
0830: 61 6c 75 65 5f 74 65 78 74 31 36 62 65 28 73 71  alue_text16be(sq
0840: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
0850: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
0860: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56  ite3ValueText(pV
0870: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  al, SQLITE_UTF16
0880: 42 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69  BE);.}.const voi
0890: 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  d *sqlite3_value
08a0: 5f 74 65 78 74 31 36 6c 65 28 73 71 6c 69 74 65  _text16le(sqlite
08b0: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a  3_value *pVal){.
08c0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
08d0: 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20  ValueText(pVal, 
08e0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 29 3b  SQLITE_UTF16LE);
08f0: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
0900: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
0910: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 61  /.int sqlite3_va
0920: 6c 75 65 5f 74 79 70 65 28 73 71 6c 69 74 65 33  lue_type(sqlite3
0930: 5f 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20  _value* pVal){. 
0940: 20 72 65 74 75 72 6e 20 70 56 61 6c 2d 3e 74 79   return pVal->ty
0950: 70 65 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a  pe;.}../********
0960: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0970: 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65 73  **** sqlite3_res
0980: 75 6c 74 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ult_  **********
0990: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
09a0: 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c  *****.** The fol
09b0: 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20  lowing routines 
09c0: 61 72 65 20 75 73 65 64 20 62 79 20 75 73 65 72  are used by user
09d0: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f  -defined functio
09e0: 6e 73 20 74 6f 20 73 70 65 63 69 66 79 0a 2a 2a  ns to specify.**
09f0: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65   the function re
0a00: 73 75 6c 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  sult..*/.void sq
0a10: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 62 6c 6f  lite3_result_blo
0a20: 62 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  b(.  sqlite3_con
0a30: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63  text *pCtx, .  c
0a40: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20  onst void *z, . 
0a50: 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20   int n, .  void 
0a60: 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a  (*xDel)(void *).
0a70: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 6e 3e 3d  ){.  assert( n>=
0a80: 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  0 );.  sqlite3Vd
0a90: 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74  beMemSetStr(&pCt
0aa0: 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 30 2c 20 78  x->s, z, n, 0, x
0ab0: 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  Del);.}.void sql
0ac0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62  ite3_result_doub
0ad0: 6c 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  le(sqlite3_conte
0ae0: 78 74 20 2a 70 43 74 78 2c 20 64 6f 75 62 6c 65  xt *pCtx, double
0af0: 20 72 56 61 6c 29 7b 0a 20 20 73 71 6c 69 74 65   rVal){.  sqlite
0b00: 33 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c  3VdbeMemSetDoubl
0b10: 65 28 26 70 43 74 78 2d 3e 73 2c 20 72 56 61 6c  e(&pCtx->s, rVal
0b20: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
0b30: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 73  3_result_error(s
0b40: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0b50: 70 43 74 78 2c 20 63 6f 6e 73 74 20 63 68 61 72  pCtx, const char
0b60: 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 70   *z, int n){.  p
0b70: 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 31  Ctx->isError = 1
0b80: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ;.  sqlite3VdbeM
0b90: 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e  emSetStr(&pCtx->
0ba0: 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f  s, z, n, SQLITE_
0bb0: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 54 52 41  UTF8, SQLITE_TRA
0bc0: 4e 53 49 45 4e 54 29 3b 0a 7d 0a 76 6f 69 64 20  NSIENT);.}.void 
0bd0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65  sqlite3_result_e
0be0: 72 72 6f 72 31 36 28 73 71 6c 69 74 65 33 5f 63  rror16(sqlite3_c
0bf0: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f  ontext *pCtx, co
0c00: 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 69 6e 74  nst void *z, int
0c10: 20 6e 29 7b 0a 20 20 70 43 74 78 2d 3e 69 73 45   n){.  pCtx->isE
0c20: 72 72 6f 72 20 3d 20 31 3b 0a 20 20 73 71 6c 69  rror = 1;.  sqli
0c30: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72  te3VdbeMemSetStr
0c40: 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c  (&pCtx->s, z, n,
0c50: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
0c60: 49 56 45 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e  IVE, SQLITE_TRAN
0c70: 53 49 45 4e 54 29 3b 0a 7d 0a 76 6f 69 64 20 73  SIENT);.}.void s
0c80: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e  qlite3_result_in
0c90: 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  t(sqlite3_contex
0ca0: 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 69 56 61  t *pCtx, int iVa
0cb0: 6c 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  l){.  sqlite3Vdb
0cc0: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 26 70 43  eMemSetInt64(&pC
0cd0: 74 78 2d 3e 73 2c 20 28 69 36 34 29 69 56 61 6c  tx->s, (i64)iVal
0ce0: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
0cf0: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 28 73  3_result_int64(s
0d00: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0d10: 70 43 74 78 2c 20 69 36 34 20 69 56 61 6c 29 7b  pCtx, i64 iVal){
0d20: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
0d30: 6d 53 65 74 49 6e 74 36 34 28 26 70 43 74 78 2d  mSetInt64(&pCtx-
0d40: 3e 73 2c 20 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69  >s, iVal);.}.voi
0d50: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
0d60: 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f 63 6f  _null(sqlite3_co
0d70: 6e 74 65 78 74 20 2a 70 43 74 78 29 7b 0a 20 20  ntext *pCtx){.  
0d80: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
0d90: 74 4e 75 6c 6c 28 26 70 43 74 78 2d 3e 73 29 3b  tNull(&pCtx->s);
0da0: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0db0: 72 65 73 75 6c 74 5f 74 65 78 74 28 0a 20 20 73  result_text(.  s
0dc0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0dd0: 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 63  pCtx, .  const c
0de0: 68 61 72 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e  har *z, .  int n
0df0: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29  ,.  void (*xDel)
0e00: 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 73 71  (void *).){.  sq
0e10: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
0e20: 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20  tr(&pCtx->s, z, 
0e30: 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20  n, SQLITE_UTF8, 
0e40: 78 44 65 6c 29 3b 0a 7d 0a 23 69 66 6e 64 65 66  xDel);.}.#ifndef
0e50: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
0e60: 31 36 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  16.void sqlite3_
0e70: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 28 0a 20  result_text16(. 
0e80: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
0e90: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74   *pCtx, .  const
0ea0: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74   void *z, .  int
0eb0: 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44   n, .  void (*xD
0ec0: 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20  el)(void *).){. 
0ed0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
0ee0: 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20  etStr(&pCtx->s, 
0ef0: 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46  z, n, SQLITE_UTF
0f00: 31 36 4e 41 54 49 56 45 2c 20 78 44 65 6c 29 3b  16NATIVE, xDel);
0f10: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0f20: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 62 65 28  result_text16be(
0f30: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
0f40: 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e  xt *pCtx, .  con
0f50: 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69  st void *z, .  i
0f60: 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a  nt n, .  void (*
0f70: 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b  xDel)(void *).){
0f80: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
0f90: 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73  mSetStr(&pCtx->s
0fa0: 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55  , z, n, SQLITE_U
0fb0: 54 46 31 36 42 45 2c 20 78 44 65 6c 29 3b 0a 7d  TF16BE, xDel);.}
0fc0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
0fd0: 73 75 6c 74 5f 74 65 78 74 31 36 6c 65 28 0a 20  sult_text16le(. 
0fe0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
0ff0: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74   *pCtx, .  const
1000: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74   void *z, .  int
1010: 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44   n, .  void (*xD
1020: 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20  el)(void *).){. 
1030: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
1040: 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20  etStr(&pCtx->s, 
1050: 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46  z, n, SQLITE_UTF
1060: 31 36 4c 45 2c 20 78 44 65 6c 29 3b 0a 7d 0a 23  16LE, xDel);.}.#
1070: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
1080: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 76 6f  OMIT_UTF16 */.vo
1090: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
10a0: 74 5f 76 61 6c 75 65 28 73 71 6c 69 74 65 33 5f  t_value(sqlite3_
10b0: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 73  context *pCtx, s
10c0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
10d0: 61 6c 75 65 29 7b 0a 20 20 73 71 6c 69 74 65 33  alue){.  sqlite3
10e0: 56 64 62 65 4d 65 6d 43 6f 70 79 28 26 70 43 74  VdbeMemCopy(&pCt
10f0: 78 2d 3e 73 2c 20 70 56 61 6c 75 65 29 3b 0a 7d  x->s, pValue);.}
1100: 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 65  .../*.** Execute
1110: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70   the statement p
1120: 53 74 6d 74 2c 20 65 69 74 68 65 72 20 75 6e 74  Stmt, either unt
1130: 69 6c 20 61 20 72 6f 77 20 6f 66 20 64 61 74 61  il a row of data
1140: 20 69 73 20 72 65 61 64 79 2c 20 74 68 65 0a 2a   is ready, the.*
1150: 2a 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 63  * statement is c
1160: 6f 6d 70 6c 65 74 65 6c 79 20 65 78 65 63 75 74  ompletely execut
1170: 65 64 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 6f  ed or an error o
1180: 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ccurs..*/.int sq
1190: 6c 69 74 65 33 5f 73 74 65 70 28 73 71 6c 69 74  lite3_step(sqlit
11a0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
11b0: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
11c0: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 73 71 6c  be*)pStmt;.  sql
11d0: 69 74 65 33 20 2a 64 62 3b 0a 20 20 69 6e 74 20  ite3 *db;.  int 
11e0: 72 63 3b 0a 0a 20 20 69 66 28 20 70 3d 3d 30 20  rc;..  if( p==0 
11f0: 7c 7c 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42  || p->magic!=VDB
1200: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 7b 0a 20  E_MAGIC_RUN ){. 
1210: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
1220: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69  _MISUSE;.  }.  i
1230: 66 28 20 70 2d 3e 61 62 6f 72 74 65 64 20 29 7b  f( p->aborted ){
1240: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
1250: 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d 0a 20 20  TE_ABORT;.  }.  
1260: 69 66 28 20 70 2d 3e 70 63 3c 3d 30 20 26 26 20  if( p->pc<=0 && 
1270: 70 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a 20 20  p->expired ){.  
1280: 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c    if( p->rc==SQL
1290: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
12a0: 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 53  p->rc = SQLITE_S
12b0: 43 48 45 4d 41 3b 0a 20 20 20 20 7d 0a 20 20 20  CHEMA;.    }.   
12c0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
12d0: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 64 62 20 3d  RROR;.  }.  db =
12e0: 20 70 2d 3e 64 62 3b 0a 20 20 69 66 28 20 73 71   p->db;.  if( sq
12f0: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
1300: 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d  ) ){.    p->rc =
1310: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
1320: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
1330: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
1340: 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 20  if( p->pc<0 ){. 
1350: 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 65     /* Invoke the
1360: 20 74 72 61 63 65 20 63 61 6c 6c 62 61 63 6b 20   trace callback 
1370: 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65 0a  if there is one.
1380: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 28      */.    if( (
1390: 64 62 20 3d 20 70 2d 3e 64 62 29 2d 3e 78 54 72  db = p->db)->xTr
13a0: 61 63 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 74  ace && !db->init
13b0: 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20 61  .busy ){.      a
13c0: 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20  ssert( p->nOp>0 
13d0: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  );.      assert(
13e0: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31   p->aOp[p->nOp-1
13f0: 5d 2e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f  ].opcode==OP_Noo
1400: 70 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72  p );.      asser
1410: 74 28 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70  t( p->aOp[p->nOp
1420: 2d 31 5d 2e 70 33 21 3d 30 20 29 3b 0a 20 20 20  -1].p3!=0 );.   
1430: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f     assert( p->aO
1440: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 74 79  p[p->nOp-1].p3ty
1450: 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29  pe==P3_DYNAMIC )
1460: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53  ;.      sqlite3S
1470: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20  afetyOff(db);.  
1480: 20 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28 64      db->xTrace(d
1490: 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 70 2d  b->pTraceArg, p-
14a0: 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70  >aOp[p->nOp-1].p
14b0: 33 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 71  3);.      if( sq
14c0: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
14d0: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e  ) ){.        p->
14e0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55  rc = SQLITE_MISU
14f0: 53 45 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75  SE;.        retu
1500: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
1510: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
1520: 0a 20 20 20 20 2f 2a 20 50 72 69 6e 74 20 61 20  .    /* Print a 
1530: 63 6f 70 79 20 6f 66 20 53 51 4c 20 61 73 20 69  copy of SQL as i
1540: 74 20 69 73 20 65 78 65 63 75 74 65 64 20 69 66  t is executed if
1550: 20 74 68 65 20 53 51 4c 5f 54 52 41 43 45 20 70   the SQL_TRACE p
1560: 72 61 67 6d 61 20 69 73 20 74 75 72 6e 65 64 0a  ragma is turned.
1570: 20 20 20 20 2a 2a 20 6f 6e 20 69 6e 20 64 65 62      ** on in deb
1580: 75 67 67 69 6e 67 20 6d 6f 64 65 2e 0a 20 20 20  ugging mode..   
1590: 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54   */.#ifdef SQLIT
15a0: 45 5f 44 45 42 55 47 0a 20 20 20 20 69 66 28 20  E_DEBUG.    if( 
15b0: 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c  (db->flags & SQL
15c0: 49 54 45 5f 53 71 6c 54 72 61 63 65 29 21 3d 30  ITE_SqlTrace)!=0
15d0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
15e0: 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 53 51  3DebugPrintf("SQ
15f0: 4c 2d 74 72 61 63 65 3a 20 25 73 5c 6e 22 2c 20  L-trace: %s\n", 
1600: 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d  p->aOp[p->nOp-1]
1610: 2e 70 33 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64  .p3);.    }.#end
1620: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42  if /* SQLITE_DEB
1630: 55 47 20 2a 2f 0a 0a 20 20 20 20 64 62 2d 3e 61  UG */..    db->a
1640: 63 74 69 76 65 56 64 62 65 43 6e 74 2b 2b 3b 0a  ctiveVdbeCnt++;.
1650: 20 20 20 20 70 2d 3e 70 63 20 3d 20 30 3b 0a 20      p->pc = 0;. 
1660: 20 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54   }.#ifndef SQLIT
1670: 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20  E_OMIT_EXPLAIN. 
1680: 20 69 66 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20   if( p->explain 
1690: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  ){.    rc = sqli
16a0: 74 65 33 56 64 62 65 4c 69 73 74 28 70 29 3b 0a  te3VdbeList(p);.
16b0: 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 20 2f    }else.#endif /
16c0: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58  * SQLITE_OMIT_EX
16d0: 50 4c 41 49 4e 20 2a 2f 0a 20 20 7b 0a 20 20 20  PLAIN */.  {.   
16e0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
16f0: 65 45 78 65 63 28 70 29 3b 0a 20 20 7d 0a 0a 20  eExec(p);.  }.. 
1700: 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65   if( sqlite3Safe
1710: 74 79 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20  tyOff(db) ){.   
1720: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53   rc = SQLITE_MIS
1730: 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69  USE;.  }..  sqli
1740: 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20  te3Error(p->db, 
1750: 72 63 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 29 3b  rc, p->zErrMsg);
1760: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
1770: 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 20 74  ./*.** Extract t
1780: 68 65 20 75 73 65 72 20 64 61 74 61 20 66 72 6f  he user data fro
1790: 6d 20 61 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74  m a sqlite3_cont
17a0: 65 78 74 20 73 74 72 75 63 74 75 72 65 20 61 6e  ext structure an
17b0: 64 20 72 65 74 75 72 6e 20 61 0a 2a 2a 20 70 6f  d return a.** po
17c0: 69 6e 74 65 72 20 74 6f 20 69 74 2e 0a 2a 2f 0a  inter to it..*/.
17d0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 75 73  void *sqlite3_us
17e0: 65 72 5f 64 61 74 61 28 73 71 6c 69 74 65 33 5f  er_data(sqlite3_
17f0: 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20 61  context *p){.  a
1800: 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70  ssert( p && p->p
1810: 46 75 6e 63 20 29 3b 0a 20 20 72 65 74 75 72 6e  Func );.  return
1820: 20 70 2d 3e 70 46 75 6e 63 2d 3e 70 55 73 65 72   p->pFunc->pUser
1830: 44 61 74 61 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  Data;.}../*.** A
1840: 6c 6c 6f 63 61 74 65 20 6f 72 20 72 65 74 75 72  llocate or retur
1850: 6e 20 74 68 65 20 61 67 67 72 65 67 61 74 65 20  n the aggregate 
1860: 63 6f 6e 74 65 78 74 20 66 6f 72 20 61 20 75 73  context for a us
1870: 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20 20 41 20  er function.  A 
1880: 6e 65 77 0a 2a 2a 20 63 6f 6e 74 65 78 74 20 69  new.** context i
1890: 73 20 61 6c 6c 6f 63 61 74 65 64 20 6f 6e 20 74  s allocated on t
18a0: 68 65 20 66 69 72 73 74 20 63 61 6c 6c 2e 20 20  he first call.  
18b0: 53 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73  Subsequent calls
18c0: 20 72 65 74 75 72 6e 20 74 68 65 0a 2a 2a 20 73   return the.** s
18d0: 61 6d 65 20 63 6f 6e 74 65 78 74 20 74 68 61 74  ame context that
18e0: 20 77 61 73 20 72 65 74 75 72 6e 65 64 20 6f 6e   was returned on
18f0: 20 70 72 69 6f 72 20 63 61 6c 6c 73 2e 0a 2a 2a   prior calls..**
1900: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1910: 20 69 73 20 64 65 66 69 6e 65 64 20 68 65 72 65   is defined here
1920: 20 69 6e 20 76 64 62 65 2e 63 20 62 65 63 61 75   in vdbe.c becau
1930: 73 65 20 69 74 20 64 65 70 65 6e 64 73 20 6f 6e  se it depends on
1940: 20 6b 6e 6f 77 69 6e 67 0a 2a 2a 20 74 68 65 20   knowing.** the 
1950: 69 6e 74 65 72 6e 61 6c 73 20 6f 66 20 74 68 65  internals of the
1960: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
1970: 20 73 74 72 75 63 74 75 72 65 20 77 68 69 63 68   structure which
1980: 20 69 73 20 6f 6e 6c 79 20 64 65 66 69 6e 65 64   is only defined
1990: 20 69 6e 0a 2a 2a 20 74 68 69 73 20 73 6f 75 72   in.** this sour
19a0: 63 65 20 66 69 6c 65 2e 0a 2a 2f 0a 76 6f 69 64  ce file..*/.void
19b0: 20 2a 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67   *sqlite3_aggreg
19c0: 61 74 65 5f 63 6f 6e 74 65 78 74 28 73 71 6c 69  ate_context(sqli
19d0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 2c 20  te3_context *p, 
19e0: 69 6e 74 20 6e 42 79 74 65 29 7b 0a 20 20 61 73  int nByte){.  as
19f0: 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70 46  sert( p && p->pF
1a00: 75 6e 63 20 26 26 20 70 2d 3e 70 46 75 6e 63 2d  unc && p->pFunc-
1a10: 3e 78 53 74 65 70 20 29 3b 0a 20 20 69 66 28 20  >xStep );.  if( 
1a20: 70 2d 3e 70 41 67 67 3d 3d 30 20 29 7b 0a 20 20  p->pAgg==0 ){.  
1a30: 20 20 69 66 28 20 6e 42 79 74 65 3c 3d 4e 42 46    if( nByte<=NBF
1a40: 53 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 41  S ){.      p->pA
1a50: 67 67 20 3d 20 28 76 6f 69 64 2a 29 70 2d 3e 73  gg = (void*)p->s
1a60: 2e 7a 3b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74  .z;.      memset
1a70: 28 70 2d 3e 70 41 67 67 2c 20 30 2c 20 6e 42 79  (p->pAgg, 0, nBy
1a80: 74 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  te);.    }else{.
1a90: 20 20 20 20 20 20 70 2d 3e 70 41 67 67 20 3d 20        p->pAgg = 
1aa0: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 6e 42  sqliteMalloc( nB
1ab0: 79 74 65 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  yte );.    }.  }
1ac0: 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 70 41 67  .  return p->pAg
1ad0: 67 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  g;.}../*.** Retu
1ae0: 72 6e 20 74 68 65 20 61 75 78 69 6c 61 72 79 20  rn the auxilary 
1af0: 64 61 74 61 20 70 6f 69 6e 74 65 72 2c 20 69 66  data pointer, if
1b00: 20 61 6e 79 2c 20 66 6f 72 20 74 68 65 20 69 41   any, for the iA
1b10: 72 67 27 74 68 20 61 72 67 75 6d 65 6e 74 20 74  rg'th argument t
1b20: 6f 0a 2a 2a 20 74 68 65 20 75 73 65 72 2d 66 75  o.** the user-fu
1b30: 6e 63 74 69 6f 6e 20 64 65 66 69 6e 65 64 20 62  nction defined b
1b40: 79 20 70 43 74 78 2e 0a 2a 2f 0a 76 6f 69 64 20  y pCtx..*/.void 
1b50: 2a 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 78  *sqlite3_get_aux
1b60: 64 61 74 61 28 73 71 6c 69 74 65 33 5f 63 6f 6e  data(sqlite3_con
1b70: 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e 74 20  text *pCtx, int 
1b80: 69 41 72 67 29 7b 0a 20 20 56 64 62 65 46 75 6e  iArg){.  VdbeFun
1b90: 63 20 2a 70 56 64 62 65 46 75 6e 63 20 3d 20 70  c *pVdbeFunc = p
1ba0: 43 74 78 2d 3e 70 56 64 62 65 46 75 6e 63 3b 0a  Ctx->pVdbeFunc;.
1bb0: 20 20 69 66 28 20 21 70 56 64 62 65 46 75 6e 63    if( !pVdbeFunc
1bc0: 20 7c 7c 20 69 41 72 67 3e 3d 70 56 64 62 65 46   || iArg>=pVdbeF
1bd0: 75 6e 63 2d 3e 6e 41 75 78 20 7c 7c 20 69 41 72  unc->nAux || iAr
1be0: 67 3c 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  g<0 ){.    retur
1bf0: 6e 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  n 0;.  }.  retur
1c00: 6e 20 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41  n pVdbeFunc->apA
1c10: 75 78 5b 69 41 72 67 5d 2e 70 41 75 78 3b 0a 7d  ux[iArg].pAux;.}
1c20: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
1c30: 61 75 78 69 6c 61 72 79 20 64 61 74 61 20 70 6f  auxilary data po
1c40: 69 6e 74 65 72 20 61 6e 64 20 64 65 6c 65 74 65  inter and delete
1c50: 20 66 75 6e 63 74 69 6f 6e 2c 20 66 6f 72 20 74   function, for t
1c60: 68 65 20 69 41 72 67 27 74 68 0a 2a 2a 20 61 72  he iArg'th.** ar
1c70: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 75 73  gument to the us
1c80: 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66 69  er-function defi
1c90: 6e 65 64 20 62 79 20 70 43 74 78 2e 20 41 6e 79  ned by pCtx. Any
1ca0: 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 20   previous value 
1cb0: 69 73 0a 2a 2a 20 64 65 6c 65 74 65 64 20 62 79  is.** deleted by
1cc0: 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 64 65 6c   calling the del
1cd0: 65 74 65 20 66 75 6e 63 74 69 6f 6e 20 73 70 65  ete function spe
1ce0: 63 69 66 69 65 64 20 77 68 65 6e 20 69 74 20 77  cified when it w
1cf0: 61 73 20 73 65 74 2e 0a 2a 2f 0a 76 6f 69 64 20  as set..*/.void 
1d00: 73 71 6c 69 74 65 33 5f 73 65 74 5f 61 75 78 64  sqlite3_set_auxd
1d10: 61 74 61 28 0a 20 20 73 71 6c 69 74 65 33 5f 63  ata(.  sqlite3_c
1d20: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20  ontext *pCtx, . 
1d30: 20 69 6e 74 20 69 41 72 67 2c 20 0a 20 20 76 6f   int iArg, .  vo
1d40: 69 64 20 2a 70 41 75 78 2c 20 0a 20 20 76 6f 69  id *pAux, .  voi
1d50: 64 20 28 2a 78 44 65 6c 65 74 65 29 28 76 6f 69  d (*xDelete)(voi
1d60: 64 2a 29 0a 29 7b 0a 20 20 73 74 72 75 63 74 20  d*).){.  struct 
1d70: 41 75 78 44 61 74 61 20 2a 70 41 75 78 44 61 74  AuxData *pAuxDat
1d80: 61 3b 0a 20 20 56 64 62 65 46 75 6e 63 20 2a 70  a;.  VdbeFunc *p
1d90: 56 64 62 65 46 75 6e 63 3b 0a 20 20 69 66 28 20  VdbeFunc;.  if( 
1da0: 69 41 72 67 3c 30 20 29 20 72 65 74 75 72 6e 3b  iArg<0 ) return;
1db0: 0a 0a 20 20 70 56 64 62 65 46 75 6e 63 20 3d 20  ..  pVdbeFunc = 
1dc0: 70 43 74 78 2d 3e 70 56 64 62 65 46 75 6e 63 3b  pCtx->pVdbeFunc;
1dd0: 0a 20 20 69 66 28 20 21 70 56 64 62 65 46 75 6e  .  if( !pVdbeFun
1de0: 63 20 7c 7c 20 70 56 64 62 65 46 75 6e 63 2d 3e  c || pVdbeFunc->
1df0: 6e 41 75 78 3c 3d 69 41 72 67 20 29 7b 0a 20 20  nAux<=iArg ){.  
1e00: 20 20 69 6e 74 20 6e 4d 61 6c 6c 6f 63 20 3d 20    int nMalloc = 
1e10: 73 69 7a 65 6f 66 28 56 64 62 65 46 75 6e 63 29  sizeof(VdbeFunc)
1e20: 20 2b 20 73 69 7a 65 6f 66 28 73 74 72 75 63 74   + sizeof(struct
1e30: 20 41 75 78 44 61 74 61 29 2a 69 41 72 67 3b 0a   AuxData)*iArg;.
1e40: 20 20 20 20 70 43 74 78 2d 3e 70 56 64 62 65 46      pCtx->pVdbeF
1e50: 75 6e 63 20 3d 20 70 56 64 62 65 46 75 6e 63 20  unc = pVdbeFunc 
1e60: 3d 20 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63 28  = sqliteRealloc(
1e70: 70 56 64 62 65 46 75 6e 63 2c 20 6e 4d 61 6c 6c  pVdbeFunc, nMall
1e80: 6f 63 29 3b 0a 20 20 20 20 69 66 28 20 21 70 56  oc);.    if( !pV
1e90: 64 62 65 46 75 6e 63 20 29 20 72 65 74 75 72 6e  dbeFunc ) return
1ea0: 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 70 56  ;.    memset(&pV
1eb0: 64 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 70  dbeFunc->apAux[p
1ec0: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 5d 2c  VdbeFunc->nAux],
1ed0: 20 30 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20   0, .           
1ee0: 20 20 73 69 7a 65 6f 66 28 73 74 72 75 63 74 20    sizeof(struct 
1ef0: 41 75 78 44 61 74 61 29 2a 28 69 41 72 67 2b 31  AuxData)*(iArg+1
1f00: 2d 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78  -pVdbeFunc->nAux
1f10: 29 29 3b 0a 20 20 20 20 70 56 64 62 65 46 75 6e  ));.    pVdbeFun
1f20: 63 2d 3e 6e 41 75 78 20 3d 20 69 41 72 67 2b 31  c->nAux = iArg+1
1f30: 3b 0a 20 20 20 20 70 56 64 62 65 46 75 6e 63 2d  ;.    pVdbeFunc-
1f40: 3e 70 46 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70  >pFunc = pCtx->p
1f50: 46 75 6e 63 3b 0a 20 20 7d 0a 0a 20 20 70 41 75  Func;.  }..  pAu
1f60: 78 44 61 74 61 20 3d 20 26 70 56 64 62 65 46 75  xData = &pVdbeFu
1f70: 6e 63 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d 3b  nc->apAux[iArg];
1f80: 0a 20 20 69 66 28 20 70 41 75 78 44 61 74 61 2d  .  if( pAuxData-
1f90: 3e 70 41 75 78 20 26 26 20 70 41 75 78 44 61 74  >pAux && pAuxDat
1fa0: 61 2d 3e 78 44 65 6c 65 74 65 20 29 7b 0a 20 20  a->xDelete ){.  
1fb0: 20 20 70 41 75 78 44 61 74 61 2d 3e 78 44 65 6c    pAuxData->xDel
1fc0: 65 74 65 28 70 41 75 78 44 61 74 61 2d 3e 70 41  ete(pAuxData->pA
1fd0: 75 78 29 3b 0a 20 20 7d 0a 20 20 70 41 75 78 44  ux);.  }.  pAuxD
1fe0: 61 74 61 2d 3e 70 41 75 78 20 3d 20 70 41 75 78  ata->pAux = pAux
1ff0: 3b 0a 20 20 70 41 75 78 44 61 74 61 2d 3e 78 44  ;.  pAuxData->xD
2000: 65 6c 65 74 65 20 3d 20 78 44 65 6c 65 74 65 3b  elete = xDelete;
2010: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
2020: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74   the number of t
2030: 69 6d 65 73 20 74 68 65 20 53 74 65 70 20 66 75  imes the Step fu
2040: 6e 63 74 69 6f 6e 20 6f 66 20 61 20 61 67 67 72  nction of a aggr
2050: 65 67 61 74 65 20 68 61 73 20 62 65 65 6e 20 0a  egate has been .
2060: 2a 2a 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a  ** called..**.**
2070: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
2080: 20 64 65 66 69 6e 65 64 20 68 65 72 65 20 69 6e   defined here in
2090: 20 76 64 62 65 2e 63 20 62 65 63 61 75 73 65 20   vdbe.c because 
20a0: 69 74 20 64 65 70 65 6e 64 73 20 6f 6e 20 6b 6e  it depends on kn
20b0: 6f 77 69 6e 67 0a 2a 2a 20 74 68 65 20 69 6e 74  owing.** the int
20c0: 65 72 6e 61 6c 73 20 6f 66 20 74 68 65 20 73 71  ernals of the sq
20d0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 73 74  lite3_context st
20e0: 72 75 63 74 75 72 65 20 77 68 69 63 68 20 69 73  ructure which is
20f0: 20 6f 6e 6c 79 20 64 65 66 69 6e 65 64 20 69 6e   only defined in
2100: 0a 2a 2a 20 74 68 69 73 20 73 6f 75 72 63 65 20  .** this source 
2110: 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  file..*/.int sql
2120: 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63  ite3_aggregate_c
2130: 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e  ount(sqlite3_con
2140: 74 65 78 74 20 2a 70 29 7b 0a 20 20 61 73 73 65  text *p){.  asse
2150: 72 74 28 20 70 20 26 26 20 70 2d 3e 70 46 75 6e  rt( p && p->pFun
2160: 63 20 26 26 20 70 2d 3e 70 46 75 6e 63 2d 3e 78  c && p->pFunc->x
2170: 53 74 65 70 20 29 3b 0a 20 20 72 65 74 75 72 6e  Step );.  return
2180: 20 70 2d 3e 63 6e 74 3b 0a 7d 0a 0a 2f 2a 0a 2a   p->cnt;.}../*.*
2190: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  * Return the num
21a0: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69  ber of columns i
21b0: 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74  n the result set
21c0: 20 66 6f 72 20 74 68 65 20 73 74 61 74 65 6d 65   for the stateme
21d0: 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74  nt pStmt..*/.int
21e0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
21f0: 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74  count(sqlite3_st
2200: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64  mt *pStmt){.  Vd
2210: 62 65 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20  be *pVm = (Vdbe 
2220: 2a 29 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72  *)pStmt;.  retur
2230: 6e 20 70 56 6d 20 3f 20 70 56 6d 2d 3e 6e 52 65  n pVm ? pVm->nRe
2240: 73 43 6f 6c 75 6d 6e 20 3a 20 30 3b 0a 7d 0a 0a  sColumn : 0;.}..
2250: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
2260: 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65   number of value
2270: 73 20 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d  s available from
2280: 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77   the current row
2290: 20 6f 66 20 74 68 65 0a 2a 2a 20 63 75 72 72 65   of the.** curre
22a0: 6e 74 6c 79 20 65 78 65 63 75 74 69 6e 67 20 73  ntly executing s
22b0: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a  tatement pStmt..
22c0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64  */.int sqlite3_d
22d0: 61 74 61 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65  ata_count(sqlite
22e0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a  3_stmt *pStmt){.
22f0: 20 20 56 64 62 65 20 2a 70 56 6d 20 3d 20 28 56    Vdbe *pVm = (V
2300: 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69  dbe *)pStmt;.  i
2310: 66 28 20 70 56 6d 3d 3d 30 20 7c 7c 20 21 70 56  f( pVm==0 || !pV
2320: 6d 2d 3e 72 65 73 4f 6e 53 74 61 63 6b 20 29 20  m->resOnStack ) 
2330: 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 75  return 0;.  retu
2340: 72 6e 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75  rn pVm->nResColu
2350: 6d 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68  mn;.}.../*.** Ch
2360: 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 63 6f  eck to see if co
2370: 6c 75 6d 6e 20 69 43 6f 6c 20 6f 66 20 74 68 65  lumn iCol of the
2380: 20 67 69 76 65 6e 20 73 74 61 74 65 6d 65 6e 74   given statement
2390: 20 69 73 20 76 61 6c 69 64 2e 20 20 49 66 0a 2a   is valid.  If.*
23a0: 2a 20 69 74 20 69 73 2c 20 72 65 74 75 72 6e 20  * it is, return 
23b0: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  a pointer to the
23c0: 20 4d 65 6d 20 66 6f 72 20 74 68 65 20 76 61 6c   Mem for the val
23d0: 75 65 20 6f 66 20 74 68 61 74 20 63 6f 6c 75 6d  ue of that colum
23e0: 6e 2e 0a 2a 2a 20 49 66 20 69 43 6f 6c 20 69 73  n..** If iCol is
23f0: 20 6e 6f 74 20 76 61 6c 69 64 2c 20 72 65 74 75   not valid, retu
2400: 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  rn a pointer to 
2410: 61 20 4d 65 6d 20 77 68 69 63 68 20 68 61 73 20  a Mem which has 
2420: 61 20 76 61 6c 75 65 0a 2a 2a 20 6f 66 20 4e 55  a value.** of NU
2430: 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 4d 65  LL..*/.static Me
2440: 6d 20 2a 63 6f 6c 75 6d 6e 4d 65 6d 28 73 71 6c  m *columnMem(sql
2450: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
2460: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 56 64 62 65  , int i){.  Vdbe
2470: 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29   *pVm = (Vdbe *)
2480: 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20 76 61 6c  pStmt;.  int val
2490: 73 20 3d 20 73 71 6c 69 74 65 33 5f 64 61 74 61  s = sqlite3_data
24a0: 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 3b 0a 20  _count(pStmt);. 
24b0: 20 69 66 28 20 69 3e 3d 76 61 6c 73 20 7c 7c 20   if( i>=vals || 
24c0: 69 3c 30 20 29 7b 0a 20 20 20 20 73 74 61 74 69  i<0 ){.    stati
24d0: 63 20 4d 65 6d 20 6e 75 6c 6c 4d 65 6d 3b 0a 20  c Mem nullMem;. 
24e0: 20 20 20 69 66 28 20 6e 75 6c 6c 4d 65 6d 2e 66     if( nullMem.f
24f0: 6c 61 67 73 3d 3d 30 20 29 7b 20 6e 75 6c 6c 4d  lags==0 ){ nullM
2500: 65 6d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e  em.flags = MEM_N
2510: 75 6c 6c 3b 20 7d 0a 20 20 20 20 73 71 6c 69 74  ull; }.    sqlit
2520: 65 33 45 72 72 6f 72 28 70 56 6d 2d 3e 64 62 2c  e3Error(pVm->db,
2530: 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30   SQLITE_RANGE, 0
2540: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 26 6e  );.    return &n
2550: 75 6c 6c 4d 65 6d 3b 0a 20 20 7d 0a 20 20 72 65  ullMem;.  }.  re
2560: 74 75 72 6e 20 26 70 56 6d 2d 3e 70 54 6f 73 5b  turn &pVm->pTos[
2570: 28 31 2d 76 61 6c 73 29 2b 69 5d 3b 0a 7d 0a 0a  (1-vals)+i];.}..
2580: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
2590: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71  ************* sq
25a0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 20 20 2a  lite3_column_  *
25b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
25c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
25d0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
25e0: 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73 65  routines are use
25f0: 64 20 74 6f 20 61 63 63 65 73 73 20 65 6c 65 6d  d to access elem
2600: 65 6e 74 73 20 6f 66 20 74 68 65 20 63 75 72 72  ents of the curr
2610: 65 6e 74 20 72 6f 77 0a 2a 2a 20 69 6e 20 74 68  ent row.** in th
2620: 65 20 72 65 73 75 6c 74 20 73 65 74 2e 0a 2a 2f  e result set..*/
2630: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
2640: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62  ite3_column_blob
2650: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
2660: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20  Stmt, int i){.  
2670: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76  return sqlite3_v
2680: 61 6c 75 65 5f 62 6c 6f 62 28 20 63 6f 6c 75 6d  alue_blob( colum
2690: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
26a0: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63  .}.int sqlite3_c
26b0: 6f 6c 75 6d 6e 5f 62 79 74 65 73 28 73 71 6c 69  olumn_bytes(sqli
26c0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
26d0: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
26e0: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
26f0: 62 79 74 65 73 28 20 63 6f 6c 75 6d 6e 4d 65 6d  bytes( columnMem
2700: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69  (pStmt,i) );.}.i
2710: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  nt sqlite3_colum
2720: 6e 5f 62 79 74 65 73 31 36 28 73 71 6c 69 74 65  n_bytes16(sqlite
2730: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
2740: 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt i){.  return 
2750: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79  sqlite3_value_by
2760: 74 65 73 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d  tes16( columnMem
2770: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 64  (pStmt,i) );.}.d
2780: 6f 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 63 6f  ouble sqlite3_co
2790: 6c 75 6d 6e 5f 64 6f 75 62 6c 65 28 73 71 6c 69  lumn_double(sqli
27a0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
27b0: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
27c0: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
27d0: 64 6f 75 62 6c 65 28 20 63 6f 6c 75 6d 6e 4d 65  double( columnMe
27e0: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a  m(pStmt,i) );.}.
27f0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  int sqlite3_colu
2800: 6d 6e 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 73  mn_int(sqlite3_s
2810: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
2820: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  i){.  return sql
2830: 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 20  ite3_value_int( 
2840: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c  columnMem(pStmt,
2850: 69 29 20 29 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69  i) );.}.sqlite_i
2860: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 63 6f 6c  nt64 sqlite3_col
2870: 75 6d 6e 5f 69 6e 74 36 34 28 73 71 6c 69 74 65  umn_int64(sqlite
2880: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
2890: 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt i){.  return 
28a0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e  sqlite3_value_in
28b0: 74 36 34 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70  t64( columnMem(p
28c0: 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 63 6f 6e  Stmt,i) );.}.con
28d0: 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  st unsigned char
28e0: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
28f0: 5f 74 65 78 74 28 73 71 6c 69 74 65 33 5f 73 74  _text(sqlite3_st
2900: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
2910: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
2920: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 20  te3_value_text( 
2930: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c  columnMem(pStmt,
2940: 69 29 20 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20  i) );.}.#ifndef 
2950: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
2960: 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  6.const void *sq
2970: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78  lite3_column_tex
2980: 74 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  t16(sqlite3_stmt
2990: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
29a0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
29b0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 20  3_value_text16( 
29c0: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c  columnMem(pStmt,
29d0: 69 29 20 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  i) );.}.#endif /
29e0: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  * SQLITE_OMIT_UT
29f0: 46 31 36 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  F16 */.int sqlit
2a00: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 28 73  e3_column_type(s
2a10: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
2a20: 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65  mt, int i){.  re
2a30: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c  turn sqlite3_val
2a40: 75 65 5f 74 79 70 65 28 20 63 6f 6c 75 6d 6e 4d  ue_type( columnM
2a50: 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d  em(pStmt,i) );.}
2a60: 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20  ../*.** Convert 
2a70: 74 68 65 20 4e 2d 74 68 20 65 6c 65 6d 65 6e 74  the N-th element
2a80: 20 6f 66 20 70 53 74 6d 74 2d 3e 70 43 6f 6c 4e   of pStmt->pColN
2a90: 61 6d 65 5b 5d 20 69 6e 74 6f 20 61 20 73 74 72  ame[] into a str
2aa0: 69 6e 67 20 75 73 69 6e 67 0a 2a 2a 20 78 46 75  ing using.** xFu
2ab0: 6e 63 28 29 20 74 68 65 6e 20 72 65 74 75 72 6e  nc() then return
2ac0: 20 74 68 61 74 20 73 74 72 69 6e 67 2e 20 20 49   that string.  I
2ad0: 66 20 4e 20 69 73 20 6f 75 74 20 6f 66 20 72 61  f N is out of ra
2ae0: 6e 67 65 2c 20 72 65 74 75 72 6e 20 30 2e 0a 2a  nge, return 0..*
2af0: 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20 75  *.** There are u
2b00: 70 20 74 6f 20 35 20 6e 61 6d 65 73 20 66 6f 72  p to 5 names for
2b10: 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2e 20 20 75   each column.  u
2b20: 73 65 54 79 70 65 20 64 65 74 65 72 6d 69 6e 65  seType determine
2b30: 73 20 77 68 69 63 68 0a 2a 2a 20 6e 61 6d 65 20  s which.** name 
2b40: 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 48 65  is returned.  He
2b50: 72 65 20 61 72 65 20 74 68 65 20 6e 61 6d 65 73  re are the names
2b60: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 30 20 20 20 20  :.**.**    0    
2b70: 20 20 54 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d    The column nam
2b80: 65 20 61 73 20 69 74 20 73 68 6f 75 6c 64 20 62  e as it should b
2b90: 65 20 64 69 73 70 6c 61 79 65 64 20 66 6f 72 20  e displayed for 
2ba0: 6f 75 74 70 75 74 0a 2a 2a 20 20 20 20 31 20 20  output.**    1  
2bb0: 20 20 20 20 54 68 65 20 64 61 74 61 74 79 70 65      The datatype
2bc0: 20 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 63 6f   name for the co
2bd0: 6c 75 6d 6e 0a 2a 2a 20 20 20 20 32 20 20 20 20  lumn.**    2    
2be0: 20 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68    The name of th
2bf0: 65 20 64 61 74 61 62 61 73 65 20 74 68 61 74 20  e database that 
2c00: 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76  the column deriv
2c10: 65 73 20 66 72 6f 6d 0a 2a 2a 20 20 20 20 33 20  es from.**    3 
2c20: 20 20 20 20 20 54 68 65 20 6e 61 6d 65 20 6f 66       The name of
2c30: 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20   the table that 
2c40: 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76  the column deriv
2c50: 65 73 20 66 72 6f 6d 0a 2a 2a 20 20 20 20 34 20  es from.**    4 
2c60: 20 20 20 20 20 54 68 65 20 6e 61 6d 65 20 6f 66       The name of
2c70: 20 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d   the table colum
2c80: 6e 20 74 68 61 74 20 74 68 65 20 72 65 73 75 6c  n that the resul
2c90: 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73  t column derives
2ca0: 20 66 72 6f 6d 0a 2a 2a 0a 2a 2a 20 49 66 20 74   from.**.** If t
2cb0: 68 65 20 72 65 73 75 6c 74 20 69 73 20 6e 6f 74  he result is not
2cc0: 20 61 20 73 69 6d 70 6c 65 20 63 6f 6c 75 6d 6e   a simple column
2cd0: 20 72 65 66 65 72 65 6e 63 65 20 28 69 66 20 69   reference (if i
2ce0: 74 20 69 73 20 61 6e 20 65 78 70 72 65 73 73 69  t is an expressi
2cf0: 6f 6e 0a 2a 2a 20 6f 72 20 61 20 63 6f 6e 73 74  on.** or a const
2d00: 61 6e 74 29 20 74 68 65 6e 20 75 73 65 54 79 70  ant) then useTyp
2d10: 65 73 20 32 2c 20 33 2c 20 61 6e 64 20 34 20 72  es 2, 3, and 4 r
2d20: 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73  eturn NULL..*/.s
2d30: 74 61 74 69 63 20 63 6f 6e 73 74 20 76 6f 69 64  tatic const void
2d40: 20 2a 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20   *columnName(.  
2d50: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
2d60: 74 6d 74 2c 0a 20 20 69 6e 74 20 4e 2c 0a 20 20  tmt,.  int N,.  
2d70: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 28 2a 78 46  const void *(*xF
2d80: 75 6e 63 29 28 4d 65 6d 2a 29 2c 0a 20 20 69 6e  unc)(Mem*),.  in
2d90: 74 20 75 73 65 54 79 70 65 0a 29 7b 0a 20 20 56  t useType.){.  V
2da0: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a  dbe *p = (Vdbe *
2db0: 29 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20 6e 20  )pStmt;.  int n 
2dc0: 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  = sqlite3_column
2dd0: 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 3b 0a 0a  _count(pStmt);..
2de0: 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 4e 3e    if( p==0 || N>
2df0: 3d 6e 20 7c 7c 20 4e 3c 30 20 29 7b 0a 20 20 20  =n || N<0 ){.   
2e00: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20   return 0;.  }. 
2e10: 20 4e 20 2b 3d 20 75 73 65 54 79 70 65 2a 6e 3b   N += useType*n;
2e20: 0a 20 20 72 65 74 75 72 6e 20 78 46 75 6e 63 28  .  return xFunc(
2e30: 26 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29  &p->aColName[N])
2e40: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  ;.}.../*.** Retu
2e50: 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  rn the name of t
2e60: 68 65 20 4e 74 68 20 63 6f 6c 75 6d 6e 20 6f 66  he Nth column of
2e70: 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20   the result set 
2e80: 72 65 74 75 72 6e 65 64 20 62 79 20 53 51 4c 0a  returned by SQL.
2e90: 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74  ** statement pSt
2ea0: 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  mt..*/.const cha
2eb0: 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  r *sqlite3_colum
2ec0: 6e 5f 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73  n_name(sqlite3_s
2ed0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
2ee0: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c  N){.  return col
2ef0: 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e  umnName(pStmt, N
2f00: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a  , (const void*(*
2f10: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f  )(Mem*))sqlite3_
2f20: 76 61 6c 75 65 5f 74 65 78 74 2c 20 30 29 3b 0a  value_text, 0);.
2f30: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
2f40: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73  _OMIT_UTF16.cons
2f50: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  t void *sqlite3_
2f60: 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 31 36 28 73 71  column_name16(sq
2f70: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
2f80: 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74  t, int N){.  ret
2f90: 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70  urn columnName(p
2fa0: 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20  Stmt, N, (const 
2fb0: 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73  void*(*)(Mem*))s
2fc0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
2fd0: 74 31 36 2c 20 30 29 3b 0a 7d 0a 23 65 6e 64 69  t16, 0);.}.#endi
2fe0: 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  f../*.** Return 
2ff0: 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 63 6c 61  the column decla
3000: 72 61 74 69 6f 6e 20 74 79 70 65 20 28 69 66 20  ration type (if 
3010: 61 70 70 6c 69 63 61 62 6c 65 29 20 6f 66 20 74  applicable) of t
3020: 68 65 20 27 69 27 74 68 20 63 6f 6c 75 6d 6e 0a  he 'i'th column.
3030: 2a 2a 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ** of the result
3040: 20 73 65 74 20 6f 66 20 53 51 4c 20 73 74 61 74   set of SQL stat
3050: 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a  ement pStmt..*/.
3060: 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69  const char *sqli
3070: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74  te3_column_declt
3080: 79 70 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ype(sqlite3_stmt
3090: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b   *pStmt, int N){
30a0: 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e  .  return column
30b0: 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28  Name(pStmt, N, (
30c0: 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d  const void*(*)(M
30d0: 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c  em*))sqlite3_val
30e0: 75 65 5f 74 65 78 74 2c 20 31 29 3b 0a 7d 0a 23  ue_text, 1);.}.#
30f0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
3100: 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76  IT_UTF16.const v
3110: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  oid *sqlite3_col
3120: 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 28 73  umn_decltype16(s
3130: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
3140: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65  mt, int N){.  re
3150: 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28  turn columnName(
3160: 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74  pStmt, N, (const
3170: 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29   void*(*)(Mem*))
3180: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
3190: 78 74 31 36 2c 20 31 29 3b 0a 7d 0a 23 65 6e 64  xt16, 1);.}.#end
31a0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
31b0: 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 66 20  T_UTF16 */..#if 
31c0: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f  !defined(SQLITE_
31d0: 4f 4d 49 54 5f 4f 52 49 47 49 4e 5f 4e 41 4d 45  OMIT_ORIGIN_NAME
31e0: 53 29 20 26 26 20 30 0a 2f 2a 0a 2a 2a 20 52 65  S) && 0./*.** Re
31f0: 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66  turn the name of
3200: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 72   the database fr
3210: 6f 6d 20 77 68 69 63 68 20 61 20 72 65 73 75 6c  om which a resul
3220: 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73  t column derives
3230: 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74  ..** NULL is ret
3240: 75 72 6e 65 64 20 69 66 20 74 68 65 20 72 65 73  urned if the res
3250: 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e  ult column is an
3260: 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63   expression or c
3270: 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e  onstant or.** an
3280: 79 74 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63  ything else whic
3290: 68 20 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 62  h is not an unab
32a0: 69 67 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65  iguous reference
32b0: 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 63   to a database c
32c0: 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20  olumn..*/.const 
32d0: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f  char *sqlite3_co
32e0: 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61  lumn_database_na
32f0: 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  me(sqlite3_stmt 
3300: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
3310: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e    return columnN
3320: 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63  ame(pStmt, N, (c
3330: 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65  onst void*(*)(Me
3340: 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75  m*))sqlite3_valu
3350: 65 5f 74 65 78 74 2c 20 32 29 3b 0a 7d 0a 23 69  e_text, 2);.}.#i
3360: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
3370: 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f  T_UTF16.const vo
3380: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  id *sqlite3_colu
3390: 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65  mn_database_name
33a0: 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  16(sqlite3_stmt 
33b0: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
33c0: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e    return columnN
33d0: 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63  ame(pStmt, N, (c
33e0: 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65  onst void*(*)(Me
33f0: 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75  m*))sqlite3_valu
3400: 65 5f 74 65 78 74 31 36 2c 20 32 29 3b 0a 7d 0a  e_text16, 2);.}.
3410: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
3420: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a  _OMIT_UTF16 */..
3430: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
3440: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
3450: 6c 65 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20  le from which a 
3460: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65  result column de
3470: 72 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69  rives..** NULL i
3480: 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68  s returned if th
3490: 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20  e result column 
34a0: 69 73 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e  is an expression
34b0: 20 6f 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a   or constant or.
34c0: 2a 2a 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65  ** anything else
34d0: 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e   which is not an
34e0: 20 75 6e 61 62 69 67 75 6f 75 73 20 72 65 66 65   unabiguous refe
34f0: 72 65 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62  rence to a datab
3500: 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63  ase column..*/.c
3510: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74  onst char *sqlit
3520: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f  e3_column_table_
3530: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  name(sqlite3_stm
3540: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29  t *pStmt, int N)
3550: 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d  {.  return colum
3560: 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20  nName(pStmt, N, 
3570: 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28  (const void*(*)(
3580: 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61  Mem*))sqlite3_va
3590: 6c 75 65 5f 74 65 78 74 2c 20 33 29 3b 0a 7d 0a  lue_text, 3);.}.
35a0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
35b0: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
35c0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f  void *sqlite3_co
35d0: 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31  lumn_table_name1
35e0: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
35f0: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
3600: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
3610: 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f  me(pStmt, N, (co
3620: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
3630: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
3640: 5f 74 65 78 74 31 36 2c 20 33 29 3b 0a 7d 0a 23  _text16, 3);.}.#
3650: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
3660: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f  OMIT_UTF16 */../
3670: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
3680: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
3690: 65 20 63 6f 6c 75 6d 6e 20 66 72 6f 6d 20 77 68  e column from wh
36a0: 69 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c  ich a result col
36b0: 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20  umn derives..** 
36c0: 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64  NULL is returned
36d0: 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 63   if the result c
36e0: 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72  olumn is an expr
36f0: 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61  ession or consta
3700: 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e  nt or.** anythin
3710: 67 20 65 6c 73 65 20 77 68 69 63 68 20 69 73 20  g else which is 
3720: 6e 6f 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75  not an unabiguou
3730: 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61  s reference to a
3740: 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e   database column
3750: 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20  ..*/.const char 
3760: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  *sqlite3_column_
3770: 6f 72 69 67 69 6e 5f 6e 61 6d 65 28 73 71 6c 69  origin_name(sqli
3780: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
3790: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72   int N){.  retur
37a0: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74  n columnName(pSt
37b0: 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f  mt, N, (const vo
37c0: 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c  id*(*)(Mem*))sql
37d0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c  ite3_value_text,
37e0: 20 34 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53   4);.}.#ifndef S
37f0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
3800: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
3810: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67  ite3_column_orig
3820: 69 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65  in_name16(sqlite
3830: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
3840: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt N){.  return 
3850: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74  columnName(pStmt
3860: 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64  , N, (const void
3870: 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74  *(*)(Mem*))sqlit
3880: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c  e3_value_text16,
3890: 20 34 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a   4);.}.#endif /*
38a0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
38b0: 31 36 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a 20  16 */.#endif /* 
38c0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4f 52 49 47  SQLITE_OMIT_ORIG
38d0: 49 4e 5f 4e 41 4d 45 53 20 2a 2f 0a 0a 0a 0a 0a  IN_NAMES */.....
38e0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
38f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3900: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 20 20   sqlite3_bind_  
3910: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3920: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 0a  ***********.** .
3930: 2a 2a 20 52 6f 75 74 69 6e 65 73 20 75 73 65 64  ** Routines used
3940: 20 74 6f 20 61 74 74 61 63 68 20 76 61 6c 75 65   to attach value
3950: 73 20 74 6f 20 77 69 6c 64 63 61 72 64 73 20 69  s to wildcards i
3960: 6e 20 61 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c  n a compiled SQL
3970: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 2f   statement..*/./
3980: 2a 0a 2a 2a 20 55 6e 62 69 6e 64 20 74 68 65 20  *.** Unbind the 
3990: 76 61 6c 75 65 20 62 6f 75 6e 64 20 74 6f 20 76  value bound to v
39a0: 61 72 69 61 62 6c 65 20 69 20 69 6e 20 76 69 72  ariable i in vir
39b0: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 70 2e 20  tual machine p. 
39c0: 54 68 69 73 20 69 73 20 74 68 65 20 0a 2a 2a 20  This is the .** 
39d0: 74 68 65 20 73 61 6d 65 20 61 73 20 62 69 6e 64  the same as bind
39e0: 69 6e 67 20 61 20 4e 55 4c 4c 20 76 61 6c 75 65  ing a NULL value
39f0: 20 74 6f 20 74 68 65 20 63 6f 6c 75 6d 6e 2e 20   to the column. 
3a00: 49 66 20 74 68 65 20 22 69 22 20 70 61 72 61 6d  If the "i" param
3a10: 65 74 65 72 20 69 73 0a 2a 2a 20 6f 75 74 20 6f  eter is.** out o
3a20: 66 20 72 61 6e 67 65 2c 20 74 68 65 6e 20 53 51  f range, then SQ
3a30: 4c 49 54 45 5f 52 41 4e 47 45 20 69 73 20 72 65  LITE_RANGE is re
3a40: 74 75 72 6e 65 64 2e 20 4f 74 68 65 77 69 73 65  turned. Othewise
3a50: 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a   SQLITE_OK..**.*
3a60: 2a 20 54 68 65 20 65 72 72 6f 72 20 63 6f 64 65  * The error code
3a70: 20 73 74 6f 72 65 64 20 69 6e 20 64 61 74 61 62   stored in datab
3a80: 61 73 65 20 70 2d 3e 64 62 20 69 73 20 6f 76 65  ase p->db is ove
3a90: 72 77 72 69 74 74 65 6e 20 77 69 74 68 20 74 68  rwritten with th
3aa0: 65 20 72 65 74 75 72 6e 0a 2a 2a 20 76 61 6c 75  e return.** valu
3ab0: 65 20 69 6e 20 61 6e 79 20 63 61 73 65 2e 0a 2a  e in any case..*
3ac0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64 62  /.static int vdb
3ad0: 65 55 6e 62 69 6e 64 28 56 64 62 65 20 2a 70 2c  eUnbind(Vdbe *p,
3ae0: 20 69 6e 74 20 69 29 7b 0a 20 20 4d 65 6d 20 2a   int i){.  Mem *
3af0: 70 56 61 72 3b 0a 20 20 69 66 28 20 70 3d 3d 30  pVar;.  if( p==0
3b00: 20 7c 7c 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44   || p->magic!=VD
3b10: 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 7c 7c 20  BE_MAGIC_RUN || 
3b20: 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20  p->pc>=0 ){.    
3b30: 69 66 28 20 70 20 29 20 73 71 6c 69 74 65 33 45  if( p ) sqlite3E
3b40: 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49  rror(p->db, SQLI
3b50: 54 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b 0a 20  TE_MISUSE, 0);. 
3b60: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
3b70: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69  _MISUSE;.  }.  i
3b80: 66 28 20 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e  f( i<1 || i>p->n
3b90: 56 61 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  Var ){.    sqlit
3ba0: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53  e3Error(p->db, S
3bb0: 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30 29 3b  QLITE_RANGE, 0);
3bc0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
3bd0: 54 45 5f 52 41 4e 47 45 3b 0a 20 20 7d 0a 20 20  TE_RANGE;.  }.  
3be0: 69 2d 2d 3b 0a 20 20 70 56 61 72 20 3d 20 26 70  i--;.  pVar = &p
3bf0: 2d 3e 61 56 61 72 5b 69 5d 3b 0a 20 20 73 71 6c  ->aVar[i];.  sql
3c00: 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61  ite3VdbeMemRelea
3c10: 73 65 28 70 56 61 72 29 3b 0a 20 20 70 56 61 72  se(pVar);.  pVar
3c20: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75  ->flags = MEM_Nu
3c30: 6c 6c 3b 0a 20 20 73 71 6c 69 74 65 33 45 72 72  ll;.  sqlite3Err
3c40: 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45  or(p->db, SQLITE
3c50: 5f 4f 4b 2c 20 30 29 3b 0a 20 20 72 65 74 75 72  _OK, 0);.  retur
3c60: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
3c70: 2f 2a 0a 2a 2a 20 42 69 6e 64 20 61 20 74 65 78  /*.** Bind a tex
3c80: 74 20 6f 72 20 42 4c 4f 42 20 76 61 6c 75 65 2e  t or BLOB value.
3c90: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62  .*/.static int b
3ca0: 69 6e 64 54 65 78 74 28 0a 20 20 73 71 6c 69 74  indText(.  sqlit
3cb0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
3cc0: 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e  .  int i, .  con
3cd0: 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20  st void *zData, 
3ce0: 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20  .  int nData, . 
3cf0: 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f   void (*xDel)(vo
3d00: 69 64 2a 29 2c 0a 20 20 69 6e 74 20 65 6e 63 6f  id*),.  int enco
3d10: 64 69 6e 67 0a 29 7b 0a 20 20 56 64 62 65 20 2a  ding.){.  Vdbe *
3d20: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  p = (Vdbe *)pStm
3d30: 74 3b 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a  t;.  Mem *pVar;.
3d40: 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 72 63 20    int rc;..  rc 
3d50: 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20  = vdbeUnbind(p, 
3d60: 69 29 3b 0a 20 20 69 66 28 20 72 63 20 7c 7c 20  i);.  if( rc || 
3d70: 7a 44 61 74 61 3d 3d 30 20 29 7b 0a 20 20 20 20  zData==0 ){.    
3d80: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20  return rc;.  }. 
3d90: 20 70 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72   pVar = &p->aVar
3da0: 5b 69 2d 31 5d 3b 0a 20 20 72 63 20 3d 20 73 71  [i-1];.  rc = sq
3db0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
3dc0: 74 72 28 70 56 61 72 2c 20 7a 44 61 74 61 2c 20  tr(pVar, zData, 
3dd0: 6e 44 61 74 61 2c 20 65 6e 63 6f 64 69 6e 67 2c  nData, encoding,
3de0: 20 78 44 65 6c 29 3b 0a 20 20 69 66 28 20 72 63   xDel);.  if( rc
3df0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72   ){.    return r
3e00: 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d  c;.  }.  if( rc=
3e10: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 6e  =SQLITE_OK && en
3e20: 63 6f 64 69 6e 67 21 3d 30 20 29 7b 0a 20 20 20  coding!=0 ){.   
3e30: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
3e40: 65 43 68 61 6e 67 65 45 6e 63 6f 64 69 6e 67 28  eChangeEncoding(
3e50: 70 56 61 72 2c 20 70 2d 3e 64 62 2d 3e 65 6e 63  pVar, p->db->enc
3e60: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
3e70: 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 42 69  rc;.}.../*.** Bi
3e80: 6e 64 20 61 20 62 6c 6f 62 20 76 61 6c 75 65 20  nd a blob value 
3e90: 74 6f 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d  to an SQL statem
3ea0: 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2f  ent variable..*/
3eb0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
3ec0: 64 5f 62 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65  d_blob(.  sqlite
3ed0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a  3_stmt *pStmt, .
3ee0: 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73    int i, .  cons
3ef0: 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a  t void *zData, .
3f00: 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20    int nData, .  
3f10: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
3f20: 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20  d*).){.  return 
3f30: 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20  bindText(pStmt, 
3f40: 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c  i, zData, nData,
3f50: 20 78 44 65 6c 2c 20 30 29 3b 0a 7d 0a 69 6e 74   xDel, 0);.}.int
3f60: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f   sqlite3_bind_do
3f70: 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  uble(sqlite3_stm
3f80: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c  t *pStmt, int i,
3f90: 20 64 6f 75 62 6c 65 20 72 56 61 6c 75 65 29 7b   double rValue){
3fa0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62  .  int rc;.  Vdb
3fb0: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
3fc0: 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62  Stmt;.  rc = vdb
3fd0: 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20  eUnbind(p, i);. 
3fe0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
3ff0: 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  OK ){.    sqlite
4000: 33 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c  3VdbeMemSetDoubl
4010: 65 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c  e(&p->aVar[i-1],
4020: 20 72 56 61 6c 75 65 29 3b 0a 20 20 7d 0a 20 20   rValue);.  }.  
4030: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74  return rc;.}.int
4040: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e   sqlite3_bind_in
4050: 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  t(sqlite3_stmt *
4060: 70 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 69 56  p, int i, int iV
4070: 61 6c 75 65 29 7b 0a 20 20 72 65 74 75 72 6e 20  alue){.  return 
4080: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74  sqlite3_bind_int
4090: 36 34 28 70 2c 20 69 2c 20 28 69 36 34 29 69 56  64(p, i, (i64)iV
40a0: 61 6c 75 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c  alue);.}.int sql
40b0: 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34 28  ite3_bind_int64(
40c0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
40d0: 74 6d 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c 69  tmt, int i, sqli
40e0: 74 65 5f 69 6e 74 36 34 20 69 56 61 6c 75 65 29  te_int64 iValue)
40f0: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64  {.  int rc;.  Vd
4100: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29  be *p = (Vdbe *)
4110: 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64  pStmt;.  rc = vd
4120: 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a  beUnbind(p, i);.
4130: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
4140: 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  _OK ){.    sqlit
4150: 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36  e3VdbeMemSetInt6
4160: 34 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c  4(&p->aVar[i-1],
4170: 20 69 56 61 6c 75 65 29 3b 0a 20 20 7d 0a 20 20   iValue);.  }.  
4180: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74  return rc;.}.int
4190: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 6e 75   sqlite3_bind_nu
41a0: 6c 6c 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a  ll(sqlite3_stmt*
41b0: 20 70 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65   p, int i){.  re
41c0: 74 75 72 6e 20 76 64 62 65 55 6e 62 69 6e 64 28  turn vdbeUnbind(
41d0: 28 56 64 62 65 20 2a 29 70 2c 20 69 29 3b 0a 7d  (Vdbe *)p, i);.}
41e0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
41f0: 64 5f 74 65 78 74 28 20 0a 20 20 73 71 6c 69 74  d_text( .  sqlit
4200: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
4210: 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e  .  int i, .  con
4220: 73 74 20 63 68 61 72 20 2a 7a 44 61 74 61 2c 20  st char *zData, 
4230: 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20  .  int nData, . 
4240: 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f   void (*xDel)(vo
4250: 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e  id*).){.  return
4260: 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c   bindText(pStmt,
4270: 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61   i, zData, nData
4280: 2c 20 78 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55  , xDel, SQLITE_U
4290: 54 46 38 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20  TF8);.}.#ifndef 
42a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
42b0: 36 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69  6.int sqlite3_bi
42c0: 6e 64 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c  nd_text16(.  sql
42d0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
42e0: 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63  , .  int i, .  c
42f0: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61  onst void *zData
4300: 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20  , .  int nData, 
4310: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28  .  void (*xDel)(
4320: 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75  void*).){.  retu
4330: 72 6e 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d  rn bindText(pStm
4340: 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61  t, i, zData, nDa
4350: 74 61 2c 20 78 44 65 6c 2c 20 53 51 4c 49 54 45  ta, xDel, SQLITE
4360: 5f 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d  _UTF16NATIVE);.}
4370: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54  .#endif /* SQLIT
4380: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a  E_OMIT_UTF16 */.
4390: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
43a0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 77 69 6c 64  e number of wild
43b0: 63 61 72 64 73 20 74 68 61 74 20 63 61 6e 20 62  cards that can b
43c0: 65 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 62 6f  e potentially bo
43d0: 75 6e 64 20 74 6f 2e 0a 2a 2a 20 54 68 69 73 20  und to..** This 
43e0: 72 6f 75 74 69 6e 65 20 69 73 20 61 64 64 65 64  routine is added
43f0: 20 74 6f 20 73 75 70 70 6f 72 74 20 44 42 44 3a   to support DBD:
4400: 3a 53 51 4c 69 74 65 2e 20 20 0a 2a 2f 0a 69 6e  :SQLite.  .*/.in
4410: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70  t sqlite3_bind_p
4420: 61 72 61 6d 65 74 65 72 5f 63 6f 75 6e 74 28 73  arameter_count(s
4430: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
4440: 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d  mt){.  Vdbe *p =
4450: 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20   (Vdbe*)pStmt;. 
4460: 20 72 65 74 75 72 6e 20 70 20 3f 20 70 2d 3e 6e   return p ? p->n
4470: 56 61 72 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a  Var : 0;.}../*.*
4480: 2a 20 43 72 65 61 74 65 20 61 20 6d 61 70 70 69  * Create a mappi
4490: 6e 67 20 66 72 6f 6d 20 76 61 72 69 61 62 6c 65  ng from variable
44a0: 20 6e 75 6d 62 65 72 73 20 74 6f 20 76 61 72 69   numbers to vari
44b0: 61 62 6c 65 20 6e 61 6d 65 73 0a 2a 2a 20 69 6e  able names.** in
44c0: 20 74 68 65 20 56 64 62 65 2e 61 7a 56 61 72 5b   the Vdbe.azVar[
44d0: 5d 20 61 72 72 61 79 2c 20 69 66 20 73 75 63 68  ] array, if such
44e0: 20 61 20 6d 61 70 70 69 6e 67 20 64 6f 65 73 20   a mapping does 
44f0: 6e 6f 74 20 61 6c 72 65 61 64 79 0a 2a 2a 20 65  not already.** e
4500: 78 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  xist..*/.static 
4510: 76 6f 69 64 20 63 72 65 61 74 65 56 61 72 4d 61  void createVarMa
4520: 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 66  p(Vdbe *p){.  if
4530: 28 20 21 70 2d 3e 6f 6b 56 61 72 20 29 7b 0a 20  ( !p->okVar ){. 
4540: 20 20 20 69 6e 74 20 6a 3b 0a 20 20 20 20 4f 70     int j;.    Op
4550: 20 2a 70 4f 70 3b 0a 20 20 20 20 66 6f 72 28 6a   *pOp;.    for(j
4560: 3d 30 2c 20 70 4f 70 3d 70 2d 3e 61 4f 70 3b 20  =0, pOp=p->aOp; 
4570: 6a 3c 70 2d 3e 6e 4f 70 3b 20 6a 2b 2b 2c 20 70  j<p->nOp; j++, p
4580: 4f 70 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28  Op++){.      if(
4590: 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50   pOp->opcode==OP
45a0: 5f 56 61 72 69 61 62 6c 65 20 29 7b 0a 20 20 20  _Variable ){.   
45b0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 4f 70       assert( pOp
45c0: 2d 3e 70 31 3e 30 20 26 26 20 70 4f 70 2d 3e 70  ->p1>0 && pOp->p
45d0: 31 3c 3d 70 2d 3e 6e 56 61 72 20 29 3b 0a 20 20  1<=p->nVar );.  
45e0: 20 20 20 20 20 20 70 2d 3e 61 7a 56 61 72 5b 70        p->azVar[p
45f0: 4f 70 2d 3e 70 31 2d 31 5d 20 3d 20 70 4f 70 2d  Op->p1-1] = pOp-
4600: 3e 70 33 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  >p3;.      }.   
4610: 20 7d 0a 20 20 20 20 70 2d 3e 6f 6b 56 61 72 20   }.    p->okVar 
4620: 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  = 1;.  }.}../*.*
4630: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d  * Return the nam
4640: 65 20 6f 66 20 61 20 77 69 6c 64 63 61 72 64 20  e of a wildcard 
4650: 70 61 72 61 6d 65 74 65 72 2e 20 20 52 65 74 75  parameter.  Retu
4660: 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 20 69  rn NULL if the i
4670: 6e 64 65 78 0a 2a 2a 20 69 73 20 6f 75 74 20 6f  ndex.** is out o
4680: 66 20 72 61 6e 67 65 20 6f 72 20 69 66 20 74 68  f range or if th
4690: 65 20 77 69 6c 64 63 61 72 64 20 69 73 20 75 6e  e wildcard is un
46a0: 6e 61 6d 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  named..**.** The
46b0: 20 72 65 73 75 6c 74 20 69 73 20 61 6c 77 61 79   result is alway
46c0: 73 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e 73  s UTF-8..*/.cons
46d0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f  t char *sqlite3_
46e0: 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f 6e  bind_parameter_n
46f0: 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ame(sqlite3_stmt
4700: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
4710: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
4720: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28  be*)pStmt;.  if(
4730: 20 70 3d 3d 30 20 7c 7c 20 69 3c 31 20 7c 7c 20   p==0 || i<1 || 
4740: 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20  i>p->nVar ){.   
4750: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20   return 0;.  }. 
4760: 20 63 72 65 61 74 65 56 61 72 4d 61 70 28 70 29   createVarMap(p)
4770: 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 61 7a  ;.  return p->az
4780: 56 61 72 5b 69 2d 31 5d 3b 0a 7d 0a 0a 2f 2a 0a  Var[i-1];.}../*.
4790: 2a 2a 20 47 69 76 65 6e 20 61 20 77 69 6c 64 63  ** Given a wildc
47a0: 61 72 64 20 70 61 72 61 6d 65 74 65 72 20 6e 61  ard parameter na
47b0: 6d 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 69  me, return the i
47c0: 6e 64 65 78 20 6f 66 20 74 68 65 20 76 61 72 69  ndex of the vari
47d0: 61 62 6c 65 0a 2a 2a 20 77 69 74 68 20 74 68 61  able.** with tha
47e0: 74 20 6e 61 6d 65 2e 20 20 49 66 20 74 68 65 72  t name.  If ther
47f0: 65 20 69 73 20 6e 6f 20 76 61 72 69 61 62 6c 65  e is no variable
4800: 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20   with the given 
4810: 6e 61 6d 65 2c 0a 2a 2a 20 72 65 74 75 72 6e 20  name,.** return 
4820: 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  0..*/.int sqlite
4830: 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72  3_bind_parameter
4840: 5f 69 6e 64 65 78 28 73 71 6c 69 74 65 33 5f 73  _index(sqlite3_s
4850: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 63 6f 6e 73  tmt *pStmt, cons
4860: 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 29 7b 0a  t char *zName){.
4870: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
4880: 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20  e*)pStmt;.  int 
4890: 69 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 7b  i;.  if( p==0 ){
48a0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
48b0: 20 7d 0a 20 20 63 72 65 61 74 65 56 61 72 4d 61   }.  createVarMa
48c0: 70 28 70 29 3b 20 0a 20 20 69 66 28 20 7a 4e 61  p(p); .  if( zNa
48d0: 6d 65 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d  me ){.    for(i=
48e0: 30 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b 20 69 2b  0; i<p->nVar; i+
48f0: 2b 29 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20  +){.      const 
4900: 63 68 61 72 20 2a 7a 20 3d 20 70 2d 3e 61 7a 56  char *z = p->azV
4910: 61 72 5b 69 5d 3b 0a 20 20 20 20 20 20 69 66 28  ar[i];.      if(
4920: 20 7a 20 26 26 20 73 74 72 63 6d 70 28 7a 2c 7a   z && strcmp(z,z
4930: 4e 61 6d 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20  Name)==0 ){.    
4940: 20 20 20 20 72 65 74 75 72 6e 20 69 2b 31 3b 0a      return i+1;.
4950: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
4960: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
4970: 0a 2f 2a 0a 2a 2a 20 54 72 61 6e 73 66 65 72 20  ./*.** Transfer 
4980: 61 6c 6c 20 62 69 6e 64 69 6e 67 73 20 66 72 6f  all bindings fro
4990: 6d 20 74 68 65 20 66 69 72 73 74 20 73 74 61 74  m the first stat
49a0: 65 6d 65 6e 74 20 6f 76 65 72 20 74 6f 20 74 68  ement over to th
49b0: 65 20 73 65 63 6f 6e 64 2e 0a 2a 2a 20 49 66 20  e second..** If 
49c0: 74 68 65 20 74 77 6f 20 73 74 61 74 65 6d 65 6e  the two statemen
49d0: 74 73 20 63 6f 6e 74 61 69 6e 20 61 20 64 69 66  ts contain a dif
49e0: 66 65 72 65 6e 74 20 6e 75 6d 62 65 72 20 6f 66  ferent number of
49f0: 20 62 69 6e 64 69 6e 67 73 2c 20 74 68 65 6e 0a   bindings, then.
4a00: 2a 2a 20 61 6e 20 53 51 4c 49 54 45 5f 45 52 52  ** an SQLITE_ERR
4a10: 4f 52 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  OR is returned..
4a20: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74  */.int sqlite3_t
4a30: 72 61 6e 73 66 65 72 5f 62 69 6e 64 69 6e 67 73  ransfer_bindings
4a40: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
4a50: 46 72 6f 6d 53 74 6d 74 2c 20 73 71 6c 69 74 65  FromStmt, sqlite
4a60: 33 5f 73 74 6d 74 20 2a 70 54 6f 53 74 6d 74 29  3_stmt *pToStmt)
4a70: 7b 0a 20 20 56 64 62 65 20 2a 70 46 72 6f 6d 20  {.  Vdbe *pFrom 
4a80: 3d 20 28 56 64 62 65 2a 29 70 46 72 6f 6d 53 74  = (Vdbe*)pFromSt
4a90: 6d 74 3b 0a 20 20 56 64 62 65 20 2a 70 54 6f 20  mt;.  Vdbe *pTo 
4aa0: 3d 20 28 56 64 62 65 2a 29 70 54 6f 53 74 6d 74  = (Vdbe*)pToStmt
4ab0: 3b 0a 20 20 69 6e 74 20 69 2c 20 72 63 20 3d 20  ;.  int i, rc = 
4ac0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28  SQLITE_OK;.  if(
4ad0: 20 28 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21 3d   (pFrom->magic!=
4ae0: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26  VDBE_MAGIC_RUN &
4af0: 26 20 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21 3d  & pFrom->magic!=
4b00: 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 29  VDBE_MAGIC_HALT)
4b10: 0a 20 20 20 20 7c 7c 20 28 70 54 6f 2d 3e 6d 61  .    || (pTo->ma
4b20: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
4b30: 52 55 4e 20 26 26 20 70 54 6f 2d 3e 6d 61 67 69  RUN && pTo->magi
4b40: 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41  c!=VDBE_MAGIC_HA
4b50: 4c 54 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  LT) ){.    retur
4b60: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
4b70: 0a 20 20 7d 0a 20 20 69 66 28 20 70 46 72 6f 6d  .  }.  if( pFrom
4b80: 2d 3e 6e 56 61 72 21 3d 70 54 6f 2d 3e 6e 56 61  ->nVar!=pTo->nVa
4b90: 72 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  r ){.    return 
4ba0: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20  SQLITE_ERROR;.  
4bb0: 7d 0a 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d  }.  for(i=0; rc=
4bc0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c  =SQLITE_OK && i<
4bd0: 70 46 72 6f 6d 2d 3e 6e 56 61 72 3b 20 69 2b 2b  pFrom->nVar; i++
4be0: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  ){.    rc = sqli
4bf0: 74 65 33 56 64 62 65 4d 65 6d 4d 6f 76 65 28 26  te3VdbeMemMove(&
4c00: 70 54 6f 2d 3e 61 56 61 72 5b 69 5d 2c 20 26 70  pTo->aVar[i], &p
4c10: 46 72 6f 6d 2d 3e 61 56 61 72 5b 69 5d 29 3b 0a  From->aVar[i]);.
4c20: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
4c30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
4c40: 20 74 68 65 20 73 71 6c 69 74 65 33 2a 20 64 61   the sqlite3* da
4c50: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74 6f  tabase handle to
4c60: 20 77 68 69 63 68 20 74 68 65 20 70 72 65 70 61   which the prepa
4c70: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 67 69  red statement gi
4c80: 76 65 6e 0a 2a 2a 20 69 6e 20 74 68 65 20 61 72  ven.** in the ar
4c90: 67 75 6d 65 6e 74 20 62 65 6c 6f 6e 67 73 2e 20  gument belongs. 
4ca0: 20 54 68 69 73 20 69 73 20 74 68 65 20 73 61 6d   This is the sam
4cb0: 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  e database handl
4cc0: 65 20 74 68 61 74 20 77 61 73 0a 2a 2a 20 74 68  e that was.** th
4cd0: 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74  e first argument
4ce0: 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f   to the sqlite3_
4cf0: 70 72 65 70 61 72 65 28 29 20 74 68 61 74 20 77  prepare() that w
4d00: 61 73 20 75 73 65 64 20 74 6f 20 63 72 65 61 74  as used to creat
4d10: 65 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 6d 65  e.** the stateme
4d20: 6e 74 20 69 6e 20 74 68 65 20 66 69 72 73 74 20  nt in the first 
4d30: 70 6c 61 63 65 2e 0a 2a 2f 0a 73 71 6c 69 74 65  place..*/.sqlite
4d40: 33 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 68 61  3 *sqlite3_db_ha
4d50: 6e 64 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  ndle(sqlite3_stm
4d60: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 72 65 74  t *pStmt){.  ret
4d70: 75 72 6e 20 70 53 74 6d 74 20 3f 20 28 28 56 64  urn pStmt ? ((Vd
4d80: 62 65 2a 29 70 53 74 6d 74 29 2d 3e 64 62 20 3a  be*)pStmt)->db :
4d90: 20 30 3b 0a 7d 0a                                 0;.}.