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

Artifact afd3837cea0dec93dcb4724d073c84fa0da68e23:


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 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68  ".#include "os.h
0200: 22 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  "../*.** Return 
0210: 54 52 55 45 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20  TRUE (non-zero) 
0220: 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  of the statement
0230: 20 73 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20   supplied as an 
0240: 61 72 67 75 6d 65 6e 74 20 6e 65 65 64 73 0a 2a  argument needs.*
0250: 2a 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 6c  * to be recompil
0260: 65 64 2e 20 20 41 20 73 74 61 74 65 6d 65 6e 74  ed.  A statement
0270: 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65 63   needs to be rec
0280: 6f 6d 70 69 6c 65 64 20 77 68 65 6e 65 76 65 72  ompiled whenever
0290: 20 74 68 65 0a 2a 2a 20 65 78 65 63 75 74 69 6f   the.** executio
02a0: 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 63 68  n environment ch
02b0: 61 6e 67 65 73 20 69 6e 20 61 20 77 61 79 20 74  anges in a way t
02c0: 68 61 74 20 77 6f 75 6c 64 20 61 6c 74 65 72 20  hat would alter 
02d0: 74 68 65 20 70 72 6f 67 72 61 6d 0a 2a 2a 20 74  the program.** t
02e0: 68 61 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70  hat sqlite3_prep
02f0: 61 72 65 28 29 20 67 65 6e 65 72 61 74 65 73 2e  are() generates.
0300: 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69    For example, i
0310: 66 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 73 20  f new functions 
0320: 6f 72 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20  or.** collating 
0330: 73 65 71 75 65 6e 63 65 73 20 61 72 65 20 72 65  sequences are re
0340: 67 69 73 74 65 72 65 64 20 6f 72 20 69 66 20 61  gistered or if a
0350: 6e 20 61 75 74 68 6f 72 69 7a 65 72 20 66 75 6e  n authorizer fun
0360: 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 61 64 64 65  ction is.** adde
0370: 64 20 6f 72 20 63 68 61 6e 67 65 64 2e 0a 2a 2f  d or changed..*/
0380: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 70  .int sqlite3_exp
0390: 69 72 65 64 28 73 71 6c 69 74 65 33 5f 73 74 6d  ired(sqlite3_stm
03a0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62  t *pStmt){.  Vdb
03b0: 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53  e *p = (Vdbe*)pS
03c0: 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 3d  tmt;.  return p=
03d0: 3d 30 20 7c 7c 20 70 2d 3e 65 78 70 69 72 65 64  =0 || p->expired
03e0: 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ;.}../**********
03f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0400: 2a 2a 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  ** sqlite3_value
0410: 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  _  *************
0420: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0430: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  **.** The follow
0440: 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 65 78 74  ing routines ext
0450: 72 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  ract information
0460: 20 66 72 6f 6d 20 61 20 4d 65 6d 20 6f 72 20 73   from a Mem or s
0470: 71 6c 69 74 65 33 5f 76 61 6c 75 65 0a 2a 2a 20  qlite3_value.** 
0480: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63 6f  structure..*/.co
0490: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65  nst void *sqlite
04a0: 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 73 71 6c  3_value_blob(sql
04b0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c  ite3_value *pVal
04c0: 29 7b 0a 20 20 4d 65 6d 20 2a 70 20 3d 20 28 4d  ){.  Mem *p = (M
04d0: 65 6d 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28 20  em*)pVal;.  if( 
04e0: 70 2d 3e 66 6c 61 67 73 20 26 20 28 4d 45 4d 5f  p->flags & (MEM_
04f0: 42 6c 6f 62 7c 4d 45 4d 5f 53 74 72 29 20 29 7b  Blob|MEM_Str) ){
0500: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 2d 3e 7a  .    return p->z
0510: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72  ;.  }else{.    r
0520: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
0530: 6c 75 65 5f 74 65 78 74 28 70 56 61 6c 29 3b 0a  lue_text(pVal);.
0540: 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65    }.}.int sqlite
0550: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 73 71  3_value_bytes(sq
0560: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
0570: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
0580: 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70  ite3ValueBytes(p
0590: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38  Val, SQLITE_UTF8
05a0: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  );.}.int sqlite3
05b0: 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28 73  _value_bytes16(s
05c0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
05d0: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71  al){.  return sq
05e0: 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28  lite3ValueBytes(
05f0: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  pVal, SQLITE_UTF
0600: 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 64 6f 75  16NATIVE);.}.dou
0610: 62 6c 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  ble sqlite3_valu
0620: 65 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33  e_double(sqlite3
0630: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20  _value *pVal){. 
0640: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
0650: 64 62 65 52 65 61 6c 56 61 6c 75 65 28 28 4d 65  dbeRealValue((Me
0660: 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 69 6e 74 20  m*)pVal);.}.int 
0670: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e  sqlite3_value_in
0680: 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  t(sqlite3_value 
0690: 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e  *pVal){.  return
06a0: 20 73 71 6c 69 74 65 33 56 64 62 65 49 6e 74 56   sqlite3VdbeIntV
06b0: 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56 61 6c 29  alue((Mem*)pVal)
06c0: 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34  ;.}.sqlite_int64
06d0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69   sqlite3_value_i
06e0: 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 76 61 6c  nt64(sqlite3_val
06f0: 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74  ue *pVal){.  ret
0700: 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65 49  urn sqlite3VdbeI
0710: 6e 74 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56  ntValue((Mem*)pV
0720: 61 6c 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73  al);.}.const uns
0730: 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69  igned char *sqli
0740: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 73  te3_value_text(s
0750: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
0760: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 28 63  al){.  return (c
0770: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
0780: 61 72 20 2a 29 73 71 6c 69 74 65 33 56 61 6c 75  ar *)sqlite3Valu
0790: 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c 49  eText(pVal, SQLI
07a0: 54 45 5f 55 54 46 38 29 3b 0a 7d 0a 23 69 66 6e  TE_UTF8);.}.#ifn
07b0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
07c0: 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64  UTF16.const void
07d0: 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f   *sqlite3_value_
07e0: 74 65 78 74 31 36 28 73 71 6c 69 74 65 33 5f 76  text16(sqlite3_v
07f0: 61 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20 20 72  alue* pVal){.  r
0800: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61 6c  eturn sqlite3Val
0810: 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c  ueText(pVal, SQL
0820: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 29  ITE_UTF16NATIVE)
0830: 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a  ;.}.const void *
0840: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
0850: 78 74 31 36 62 65 28 73 71 6c 69 74 65 33 5f 76  xt16be(sqlite3_v
0860: 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72  alue *pVal){.  r
0870: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61 6c  eturn sqlite3Val
0880: 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c  ueText(pVal, SQL
0890: 49 54 45 5f 55 54 46 31 36 42 45 29 3b 0a 7d 0a  ITE_UTF16BE);.}.
08a0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
08b0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36  te3_value_text16
08c0: 6c 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  le(sqlite3_value
08d0: 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72   *pVal){.  retur
08e0: 6e 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65  n sqlite3ValueTe
08f0: 78 74 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f  xt(pVal, SQLITE_
0900: 55 54 46 31 36 4c 45 29 3b 0a 7d 0a 23 65 6e 64  UTF16LE);.}.#end
0910: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
0920: 54 5f 55 54 46 31 36 20 2a 2f 0a 69 6e 74 20 73  T_UTF16 */.int s
0930: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
0940: 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a  e(sqlite3_value*
0950: 20 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e   pVal){.  return
0960: 20 70 56 61 6c 2d 3e 74 79 70 65 3b 0a 7d 0a 0a   pVal->type;.}..
0970: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
0980: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71  ************* sq
0990: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 20 20 2a  lite3_result_  *
09a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
09b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
09c0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
09d0: 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73 65  routines are use
09e0: 64 20 62 79 20 75 73 65 72 2d 64 65 66 69 6e 65  d by user-define
09f0: 64 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 73  d functions to s
0a00: 70 65 63 69 66 79 0a 2a 2a 20 74 68 65 20 66 75  pecify.** the fu
0a10: 6e 63 74 69 6f 6e 20 72 65 73 75 6c 74 2e 0a 2a  nction result..*
0a20: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72  /.void sqlite3_r
0a30: 65 73 75 6c 74 5f 62 6c 6f 62 28 0a 20 20 73 71  esult_blob(.  sq
0a40: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
0a50: 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f  Ctx, .  const vo
0a60: 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c  id *z, .  int n,
0a70: 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29   .  void (*xDel)
0a80: 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61 73  (void *).){.  as
0a90: 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b 0a 20 20  sert( n>=0 );.  
0aa0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
0ab0: 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a  tStr(&pCtx->s, z
0ac0: 2c 20 6e 2c 20 30 2c 20 78 44 65 6c 29 3b 0a 7d  , n, 0, xDel);.}
0ad0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
0ae0: 73 75 6c 74 5f 64 6f 75 62 6c 65 28 73 71 6c 69  sult_double(sqli
0af0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
0b00: 78 2c 20 64 6f 75 62 6c 65 20 72 56 61 6c 29 7b  x, double rVal){
0b10: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
0b20: 6d 53 65 74 44 6f 75 62 6c 65 28 26 70 43 74 78  mSetDouble(&pCtx
0b30: 2d 3e 73 2c 20 72 56 61 6c 29 3b 0a 7d 0a 76 6f  ->s, rVal);.}.vo
0b40: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
0b50: 74 5f 65 72 72 6f 72 28 73 71 6c 69 74 65 33 5f  t_error(sqlite3_
0b60: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63  context *pCtx, c
0b70: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e  onst char *z, in
0b80: 74 20 6e 29 7b 0a 20 20 70 43 74 78 2d 3e 69 73  t n){.  pCtx->is
0b90: 45 72 72 6f 72 20 3d 20 31 3b 0a 20 20 73 71 6c  Error = 1;.  sql
0ba0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
0bb0: 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e  r(&pCtx->s, z, n
0bc0: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53  , SQLITE_UTF8, S
0bd0: 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29  QLITE_TRANSIENT)
0be0: 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  ;.}.void sqlite3
0bf0: 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 31 36 28  _result_error16(
0c00: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
0c10: 2a 70 43 74 78 2c 20 63 6f 6e 73 74 20 76 6f 69  *pCtx, const voi
0c20: 64 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20  d *z, int n){.  
0c30: 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20  pCtx->isError = 
0c40: 31 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  1;.  sqlite3Vdbe
0c50: 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d  MemSetStr(&pCtx-
0c60: 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45  >s, z, n, SQLITE
0c70: 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51  _UTF16NATIVE, SQ
0c80: 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b  LITE_TRANSIENT);
0c90: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0ca0: 72 65 73 75 6c 74 5f 69 6e 74 28 73 71 6c 69 74  result_int(sqlit
0cb0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
0cc0: 2c 20 69 6e 74 20 69 56 61 6c 29 7b 0a 20 20 73  , int iVal){.  s
0cd0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
0ce0: 49 6e 74 36 34 28 26 70 43 74 78 2d 3e 73 2c 20  Int64(&pCtx->s, 
0cf0: 28 69 36 34 29 69 56 61 6c 29 3b 0a 7d 0a 76 6f  (i64)iVal);.}.vo
0d00: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
0d10: 74 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f  t_int64(sqlite3_
0d20: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69  context *pCtx, i
0d30: 36 34 20 69 56 61 6c 29 7b 0a 20 20 73 71 6c 69  64 iVal){.  sqli
0d40: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74  te3VdbeMemSetInt
0d50: 36 34 28 26 70 43 74 78 2d 3e 73 2c 20 69 56 61  64(&pCtx->s, iVa
0d60: 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74  l);.}.void sqlit
0d70: 65 33 5f 72 65 73 75 6c 74 5f 6e 75 6c 6c 28 73  e3_result_null(s
0d80: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0d90: 70 43 74 78 29 7b 0a 20 20 73 71 6c 69 74 65 33  pCtx){.  sqlite3
0da0: 56 64 62 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 26  VdbeMemSetNull(&
0db0: 70 43 74 78 2d 3e 73 29 3b 0a 7d 0a 76 6f 69 64  pCtx->s);.}.void
0dc0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
0dd0: 74 65 78 74 28 0a 20 20 73 71 6c 69 74 65 33 5f  text(.  sqlite3_
0de0: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a  context *pCtx, .
0df0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c    const char *z,
0e00: 20 0a 20 20 69 6e 74 20 6e 2c 0a 20 20 76 6f 69   .  int n,.  voi
0e10: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a  d (*xDel)(void *
0e20: 29 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64  ).){.  sqlite3Vd
0e30: 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74  beMemSetStr(&pCt
0e40: 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49  x->s, z, n, SQLI
0e50: 54 45 5f 55 54 46 38 2c 20 78 44 65 6c 29 3b 0a  TE_UTF8, xDel);.
0e60: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
0e70: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 76 6f 69 64  _OMIT_UTF16.void
0e80: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
0e90: 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69 74 65  text16(.  sqlite
0ea0: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
0eb0: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
0ec0: 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20  z, .  int n, .  
0ed0: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
0ee0: 64 20 2a 29 0a 29 7b 0a 20 20 73 71 6c 69 74 65  d *).){.  sqlite
0ef0: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26  3VdbeMemSetStr(&
0f00: 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53  pCtx->s, z, n, S
0f10: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56  QLITE_UTF16NATIV
0f20: 45 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64  E, xDel);.}.void
0f30: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
0f40: 74 65 78 74 31 36 62 65 28 0a 20 20 73 71 6c 69  text16be(.  sqli
0f50: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
0f60: 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  x, .  const void
0f70: 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a   *z, .  int n, .
0f80: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76    void (*xDel)(v
0f90: 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 73 71 6c 69  oid *).){.  sqli
0fa0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72  te3VdbeMemSetStr
0fb0: 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c  (&pCtx->s, z, n,
0fc0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c   SQLITE_UTF16BE,
0fd0: 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73   xDel);.}.void s
0fe0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
0ff0: 78 74 31 36 6c 65 28 0a 20 20 73 71 6c 69 74 65  xt16le(.  sqlite
1000: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
1010: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
1020: 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20  z, .  int n, .  
1030: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
1040: 64 20 2a 29 0a 29 7b 0a 20 20 73 71 6c 69 74 65  d *).){.  sqlite
1050: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26  3VdbeMemSetStr(&
1060: 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53  pCtx->s, z, n, S
1070: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 78  QLITE_UTF16LE, x
1080: 44 65 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  Del);.}.#endif /
1090: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  * SQLITE_OMIT_UT
10a0: 46 31 36 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  F16 */.void sqli
10b0: 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75 65  te3_result_value
10c0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
10d0: 20 2a 70 43 74 78 2c 20 73 71 6c 69 74 65 33 5f   *pCtx, sqlite3_
10e0: 76 61 6c 75 65 20 2a 70 56 61 6c 75 65 29 7b 0a  value *pValue){.
10f0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
1100: 43 6f 70 79 28 26 70 43 74 78 2d 3e 73 2c 20 70  Copy(&pCtx->s, p
1110: 56 61 6c 75 65 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a  Value);.}.../*.*
1120: 2a 20 45 78 65 63 75 74 65 20 74 68 65 20 73 74  * Execute the st
1130: 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2c 20 65  atement pStmt, e
1140: 69 74 68 65 72 20 75 6e 74 69 6c 20 61 20 72 6f  ither until a ro
1150: 77 20 6f 66 20 64 61 74 61 20 69 73 20 72 65 61  w of data is rea
1160: 64 79 2c 20 74 68 65 0a 2a 2a 20 73 74 61 74 65  dy, the.** state
1170: 6d 65 6e 74 20 69 73 20 63 6f 6d 70 6c 65 74 65  ment is complete
1180: 6c 79 20 65 78 65 63 75 74 65 64 20 6f 72 20 61  ly executed or a
1190: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a  n error occurs..
11a0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73  */.int sqlite3_s
11b0: 74 65 70 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  tep(sqlite3_stmt
11c0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65   *pStmt){.  Vdbe
11d0: 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74   *p = (Vdbe*)pSt
11e0: 6d 74 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  mt;.  sqlite3 *d
11f0: 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20  b;.  int rc;..  
1200: 61 73 73 65 72 74 28 21 73 71 6c 69 74 65 33 54  assert(!sqlite3T
1210: 68 72 65 61 64 44 61 74 61 52 65 61 64 4f 6e 6c  hreadDataReadOnl
1220: 79 28 29 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65  y()->mallocFaile
1230: 64 29 3b 0a 0a 20 20 69 66 28 20 70 3d 3d 30 20  d);..  if( p==0 
1240: 7c 7c 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42  || p->magic!=VDB
1250: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 7b 0a 20  E_MAGIC_RUN ){. 
1260: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
1270: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69  _MISUSE;.  }.  i
1280: 66 28 20 70 2d 3e 61 62 6f 72 74 65 64 20 29 7b  f( p->aborted ){
1290: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
12a0: 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d 0a 20 20  TE_ABORT;.  }.  
12b0: 69 66 28 20 70 2d 3e 70 63 3c 3d 30 20 26 26 20  if( p->pc<=0 && 
12c0: 70 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a 20 20  p->expired ){.  
12d0: 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c    if( p->rc==SQL
12e0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
12f0: 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 53  p->rc = SQLITE_S
1300: 43 48 45 4d 41 3b 0a 20 20 20 20 7d 0a 20 20 20  CHEMA;.    }.   
1310: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
1320: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 64 62 20 3d  RROR;.  }.  db =
1330: 20 70 2d 3e 64 62 3b 0a 20 20 69 66 28 20 73 71   p->db;.  if( sq
1340: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
1350: 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d  ) ){.    p->rc =
1360: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
1370: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
1380: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
1390: 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 23  if( p->pc<0 ){.#
13a0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
13b0: 49 54 5f 54 52 41 43 45 0a 20 20 20 20 2f 2a 20  IT_TRACE.    /* 
13c0: 49 6e 76 6f 6b 65 20 74 68 65 20 74 72 61 63 65  Invoke the trace
13d0: 20 63 61 6c 6c 62 61 63 6b 20 69 66 20 74 68 65   callback if the
13e0: 72 65 20 69 73 20 6f 6e 65 0a 20 20 20 20 2a 2f  re is one.    */
13f0: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 78 54 72  .    if( db->xTr
1400: 61 63 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 74  ace && !db->init
1410: 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20 61  .busy ){.      a
1420: 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20  ssert( p->nOp>0 
1430: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  );.      assert(
1440: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31   p->aOp[p->nOp-1
1450: 5d 2e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f  ].opcode==OP_Noo
1460: 70 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72  p );.      asser
1470: 74 28 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70  t( p->aOp[p->nOp
1480: 2d 31 5d 2e 70 33 21 3d 30 20 29 3b 0a 20 20 20  -1].p3!=0 );.   
1490: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f     assert( p->aO
14a0: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 74 79  p[p->nOp-1].p3ty
14b0: 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29  pe==P3_DYNAMIC )
14c0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53  ;.      sqlite3S
14d0: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20  afetyOff(db);.  
14e0: 20 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28 64      db->xTrace(d
14f0: 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 70 2d  b->pTraceArg, p-
1500: 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70  >aOp[p->nOp-1].p
1510: 33 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 71  3);.      if( sq
1520: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
1530: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e  ) ){.        p->
1540: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55  rc = SQLITE_MISU
1550: 53 45 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75  SE;.        retu
1560: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
1570: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
1580: 20 20 20 20 69 66 28 20 64 62 2d 3e 78 50 72 6f      if( db->xPro
1590: 66 69 6c 65 20 26 26 20 21 64 62 2d 3e 69 6e 69  file && !db->ini
15a0: 74 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20  t.busy ){.      
15b0: 64 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a 20 20 20  double rNow;.   
15c0: 20 20 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72     sqlite3OsCurr
15d0: 65 6e 74 54 69 6d 65 28 26 72 4e 6f 77 29 3b 0a  entTime(&rNow);.
15e0: 20 20 20 20 20 20 70 2d 3e 73 74 61 72 74 54 69        p->startTi
15f0: 6d 65 20 3d 20 28 72 4e 6f 77 20 2d 20 28 69 6e  me = (rNow - (in
1600: 74 29 72 4e 6f 77 29 2a 33 36 30 30 2e 30 2a 32  t)rNow)*3600.0*2
1610: 34 2e 30 2a 31 30 30 30 30 30 30 30 30 30 2e 30  4.0*1000000000.0
1620: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a  ;.    }.#endif..
1630: 20 20 20 20 2f 2a 20 50 72 69 6e 74 20 61 20 63      /* Print a c
1640: 6f 70 79 20 6f 66 20 53 51 4c 20 61 73 20 69 74  opy of SQL as it
1650: 20 69 73 20 65 78 65 63 75 74 65 64 20 69 66 20   is executed if 
1660: 74 68 65 20 53 51 4c 5f 54 52 41 43 45 20 70 72  the SQL_TRACE pr
1670: 61 67 6d 61 20 69 73 20 74 75 72 6e 65 64 0a 20  agma is turned. 
1680: 20 20 20 2a 2a 20 6f 6e 20 69 6e 20 64 65 62 75     ** on in debu
1690: 67 67 69 6e 67 20 6d 6f 64 65 2e 0a 20 20 20 20  gging mode..    
16a0: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  */.#ifdef SQLITE
16b0: 5f 44 45 42 55 47 0a 20 20 20 20 69 66 28 20 28  _DEBUG.    if( (
16c0: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
16d0: 54 45 5f 53 71 6c 54 72 61 63 65 29 21 3d 30 20  TE_SqlTrace)!=0 
16e0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
16f0: 44 65 62 75 67 50 72 69 6e 74 66 28 22 53 51 4c  DebugPrintf("SQL
1700: 2d 74 72 61 63 65 3a 20 25 73 5c 6e 22 2c 20 70  -trace: %s\n", p
1710: 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e  ->aOp[p->nOp-1].
1720: 70 33 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69  p3);.    }.#endi
1730: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55  f /* SQLITE_DEBU
1740: 47 20 2a 2f 0a 0a 20 20 20 20 64 62 2d 3e 61 63  G */..    db->ac
1750: 74 69 76 65 56 64 62 65 43 6e 74 2b 2b 3b 0a 20  tiveVdbeCnt++;. 
1760: 20 20 20 70 2d 3e 70 63 20 3d 20 30 3b 0a 20 20     p->pc = 0;.  
1770: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
1780: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20  _OMIT_EXPLAIN.  
1790: 69 66 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29  if( p->explain )
17a0: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
17b0: 65 33 56 64 62 65 4c 69 73 74 28 70 29 3b 0a 20  e3VdbeList(p);. 
17c0: 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 20 2f 2a   }else.#endif /*
17d0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50   SQLITE_OMIT_EXP
17e0: 4c 41 49 4e 20 2a 2f 0a 20 20 7b 0a 20 20 20 20  LAIN */.  {.    
17f0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
1800: 45 78 65 63 28 70 29 3b 0a 20 20 7d 0a 0a 20 20  Exec(p);.  }..  
1810: 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74  if( sqlite3Safet
1820: 79 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20  yOff(db) ){.    
1830: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55  rc = SQLITE_MISU
1840: 53 45 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66  SE;.  }..#ifndef
1850: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41   SQLITE_OMIT_TRA
1860: 43 45 0a 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74  CE.  /* Invoke t
1870: 68 65 20 70 72 6f 66 69 6c 65 20 63 61 6c 6c 62  he profile callb
1880: 61 63 6b 20 69 66 20 74 68 65 72 65 20 69 73 20  ack if there is 
1890: 6f 6e 65 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72  one.  */.  if( r
18a0: 63 21 3d 53 51 4c 49 54 45 5f 52 4f 57 20 26 26  c!=SQLITE_ROW &&
18b0: 20 64 62 2d 3e 78 50 72 6f 66 69 6c 65 20 26 26   db->xProfile &&
18c0: 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20   !db->init.busy 
18d0: 29 7b 0a 20 20 20 20 64 6f 75 62 6c 65 20 72 4e  ){.    double rN
18e0: 6f 77 3b 0a 20 20 20 20 75 36 34 20 65 6c 61 70  ow;.    u64 elap
18f0: 73 65 54 69 6d 65 3b 0a 0a 20 20 20 20 73 71 6c  seTime;..    sql
1900: 69 74 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d  ite3OsCurrentTim
1910: 65 28 26 72 4e 6f 77 29 3b 0a 20 20 20 20 65 6c  e(&rNow);.    el
1920: 61 70 73 65 54 69 6d 65 20 3d 20 28 72 4e 6f 77  apseTime = (rNow
1930: 20 2d 20 28 69 6e 74 29 72 4e 6f 77 29 2a 33 36   - (int)rNow)*36
1940: 30 30 2e 30 2a 32 34 2e 30 2a 31 30 30 30 30 30  00.0*24.0*100000
1950: 30 30 30 30 2e 30 20 2d 20 70 2d 3e 73 74 61 72  0000.0 - p->star
1960: 74 54 69 6d 65 3b 0a 20 20 20 20 61 73 73 65 72  tTime;.    asser
1970: 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 20  t( p->nOp>0 );. 
1980: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f     assert( p->aO
1990: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 6f 70 63 6f  p[p->nOp-1].opco
19a0: 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 3b 0a 20  de==OP_Noop );. 
19b0: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f     assert( p->aO
19c0: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 21 3d  p[p->nOp-1].p3!=
19d0: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  0 );.    assert(
19e0: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31   p->aOp[p->nOp-1
19f0: 5d 2e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e  ].p3type==P3_DYN
1a00: 41 4d 49 43 20 29 3b 0a 20 20 20 20 64 62 2d 3e  AMIC );.    db->
1a10: 78 50 72 6f 66 69 6c 65 28 64 62 2d 3e 70 50 72  xProfile(db->pPr
1a20: 6f 66 69 6c 65 41 72 67 2c 20 70 2d 3e 61 4f 70  ofileArg, p->aOp
1a30: 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 2c 20 65  [p->nOp-1].p3, e
1a40: 6c 61 70 73 65 54 69 6d 65 29 3b 0a 20 20 7d 0a  lapseTime);.  }.
1a50: 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65  #endif..  sqlite
1a60: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 72 63  3Error(p->db, rc
1a70: 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3f 20 22  , p->zErrMsg ? "
1a80: 25 73 22 20 3a 20 30 2c 20 70 2d 3e 7a 45 72 72  %s" : 0, p->zErr
1a90: 4d 73 67 29 3b 0a 20 20 73 71 6c 69 74 65 33 4d  Msg);.  sqlite3M
1aa0: 61 6c 6c 6f 63 43 6c 65 61 72 46 61 69 6c 65 64  allocClearFailed
1ab0: 28 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  ();.  return rc;
1ac0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63  .}../*.** Extrac
1ad0: 74 20 74 68 65 20 75 73 65 72 20 64 61 74 61 20  t the user data 
1ae0: 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33 5f 63  from a sqlite3_c
1af0: 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72 65  ontext structure
1b00: 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a 2a 2a   and return a.**
1b10: 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 2e 0a   pointer to it..
1b20: 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  */.void *sqlite3
1b30: 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c 69 74  _user_data(sqlit
1b40: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a  e3_context *p){.
1b50: 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70    assert( p && p
1b60: 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72 65 74  ->pFunc );.  ret
1b70: 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e 70 55  urn p->pFunc->pU
1b80: 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a 0a 2a  serData;.}../*.*
1b90: 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72 20 72 65  * Allocate or re
1ba0: 74 75 72 6e 20 74 68 65 20 61 67 67 72 65 67 61  turn the aggrega
1bb0: 74 65 20 63 6f 6e 74 65 78 74 20 66 6f 72 20 61  te context for a
1bc0: 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20   user function. 
1bd0: 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74 65 78   A new.** contex
1be0: 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 6f  t is allocated o
1bf0: 6e 20 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c  n the first call
1c00: 2e 20 20 53 75 62 73 65 71 75 65 6e 74 20 63 61  .  Subsequent ca
1c10: 6c 6c 73 20 72 65 74 75 72 6e 20 74 68 65 0a 2a  lls return the.*
1c20: 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78 74 20 74  * same context t
1c30: 68 61 74 20 77 61 73 20 72 65 74 75 72 6e 65 64  hat was returned
1c40: 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c 6c 73 2e   on prior calls.
1c50: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  .*/.void *sqlite
1c60: 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e 74  3_aggregate_cont
1c70: 65 78 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  ext(sqlite3_cont
1c80: 65 78 74 20 2a 70 2c 20 69 6e 74 20 6e 42 79 74  ext *p, int nByt
1c90: 65 29 7b 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20  e){.  Mem *pMem 
1ca0: 3d 20 70 2d 3e 70 4d 65 6d 3b 0a 20 20 61 73 73  = p->pMem;.  ass
1cb0: 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70 46 75  ert( p && p->pFu
1cc0: 6e 63 20 26 26 20 70 2d 3e 70 46 75 6e 63 2d 3e  nc && p->pFunc->
1cd0: 78 53 74 65 70 20 29 3b 0a 20 20 69 66 28 20 28  xStep );.  if( (
1ce0: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45  pMem->flags & ME
1cf0: 4d 5f 41 67 67 29 3d 3d 30 20 29 7b 0a 20 20 20  M_Agg)==0 ){.   
1d00: 20 69 66 28 20 6e 42 79 74 65 3d 3d 30 20 29 7b   if( nByte==0 ){
1d10: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
1d20: 4d 65 6d 2d 3e 66 6c 61 67 73 3d 3d 4d 45 4d 5f  Mem->flags==MEM_
1d30: 4e 75 6c 6c 20 29 3b 0a 20 20 20 20 20 20 70 4d  Null );.      pM
1d40: 65 6d 2d 3e 7a 20 3d 20 30 3b 0a 20 20 20 20 7d  em->z = 0;.    }
1d50: 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4d 65 6d  else{.      pMem
1d60: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 41 67  ->flags = MEM_Ag
1d70: 67 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 78  g;.      pMem->x
1d80: 44 65 6c 20 3d 20 73 71 6c 69 74 65 33 46 72 65  Del = sqlite3Fre
1d90: 65 58 3b 0a 20 20 20 20 20 20 2a 28 46 75 6e 63  eX;.      *(Func
1da0: 44 65 66 2a 2a 29 26 70 4d 65 6d 2d 3e 69 20 3d  Def**)&pMem->i =
1db0: 20 70 2d 3e 70 46 75 6e 63 3b 0a 20 20 20 20 20   p->pFunc;.     
1dc0: 20 69 66 28 20 6e 42 79 74 65 3c 3d 4e 42 46 53   if( nByte<=NBFS
1dd0: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d   ){.        pMem
1de0: 2d 3e 7a 20 3d 20 70 4d 65 6d 2d 3e 7a 53 68 6f  ->z = pMem->zSho
1df0: 72 74 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d 73  rt;.        mems
1e00: 65 74 28 70 4d 65 6d 2d 3e 7a 2c 20 30 2c 20 6e  et(pMem->z, 0, n
1e10: 42 79 74 65 29 3b 0a 20 20 20 20 20 20 7d 65 6c  Byte);.      }el
1e20: 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d  se{.        pMem
1e30: 2d 3e 7a 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c  ->z = sqliteMall
1e40: 6f 63 28 20 6e 42 79 74 65 20 29 3b 0a 20 20 20  oc( nByte );.   
1e50: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20     }.    }.  }. 
1e60: 20 72 65 74 75 72 6e 20 28 76 6f 69 64 2a 29 70   return (void*)p
1e70: 4d 65 6d 2d 3e 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Mem->z;.}../*.**
1e80: 20 52 65 74 75 72 6e 20 74 68 65 20 61 75 78 69   Return the auxi
1e90: 6c 61 72 79 20 64 61 74 61 20 70 6f 69 6e 74 65  lary data pointe
1ea0: 72 2c 20 69 66 20 61 6e 79 2c 20 66 6f 72 20 74  r, if any, for t
1eb0: 68 65 20 69 41 72 67 27 74 68 20 61 72 67 75 6d  he iArg'th argum
1ec0: 65 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 75 73  ent to.** the us
1ed0: 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66 69  er-function defi
1ee0: 6e 65 64 20 62 79 20 70 43 74 78 2e 0a 2a 2f 0a  ned by pCtx..*/.
1ef0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 67 65  void *sqlite3_ge
1f00: 74 5f 61 75 78 64 61 74 61 28 73 71 6c 69 74 65  t_auxdata(sqlite
1f10: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
1f20: 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 20 56 64   int iArg){.  Vd
1f30: 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e  beFunc *pVdbeFun
1f40: 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 65 46  c = pCtx->pVdbeF
1f50: 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 64 62  unc;.  if( !pVdb
1f60: 65 46 75 6e 63 20 7c 7c 20 69 41 72 67 3e 3d 70  eFunc || iArg>=p
1f70: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 7c  VdbeFunc->nAux |
1f80: 7c 20 69 41 72 67 3c 30 20 29 7b 0a 20 20 20 20  | iArg<0 ){.    
1f90: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
1fa0: 72 65 74 75 72 6e 20 70 56 64 62 65 46 75 6e 63  return pVdbeFunc
1fb0: 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d 2e 70 41  ->apAux[iArg].pA
1fc0: 75 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  ux;.}../*.** Set
1fd0: 20 74 68 65 20 61 75 78 69 6c 61 72 79 20 64 61   the auxilary da
1fe0: 74 61 20 70 6f 69 6e 74 65 72 20 61 6e 64 20 64  ta pointer and d
1ff0: 65 6c 65 74 65 20 66 75 6e 63 74 69 6f 6e 2c 20  elete function, 
2000: 66 6f 72 20 74 68 65 20 69 41 72 67 27 74 68 0a  for the iArg'th.
2010: 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74  ** argument to t
2020: 68 65 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e  he user-function
2030: 20 64 65 66 69 6e 65 64 20 62 79 20 70 43 74 78   defined by pCtx
2040: 2e 20 41 6e 79 20 70 72 65 76 69 6f 75 73 20 76  . Any previous v
2050: 61 6c 75 65 20 69 73 0a 2a 2a 20 64 65 6c 65 74  alue is.** delet
2060: 65 64 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68  ed by calling th
2070: 65 20 64 65 6c 65 74 65 20 66 75 6e 63 74 69 6f  e delete functio
2080: 6e 20 73 70 65 63 69 66 69 65 64 20 77 68 65 6e  n specified when
2090: 20 69 74 20 77 61 73 20 73 65 74 2e 0a 2a 2f 0a   it was set..*/.
20a0: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73 65 74  void sqlite3_set
20b0: 5f 61 75 78 64 61 74 61 28 0a 20 20 73 71 6c 69  _auxdata(.  sqli
20c0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
20d0: 78 2c 20 0a 20 20 69 6e 74 20 69 41 72 67 2c 20  x, .  int iArg, 
20e0: 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c 20 0a  .  void *pAux, .
20f0: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 65 74 65    void (*xDelete
2100: 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 73 74  )(void*).){.  st
2110: 72 75 63 74 20 41 75 78 44 61 74 61 20 2a 70 41  ruct AuxData *pA
2120: 75 78 44 61 74 61 3b 0a 20 20 56 64 62 65 46 75  uxData;.  VdbeFu
2130: 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 3b 0a 20  nc *pVdbeFunc;. 
2140: 20 69 66 28 20 69 41 72 67 3c 30 20 29 20 72 65   if( iArg<0 ) re
2150: 74 75 72 6e 3b 0a 0a 20 20 70 56 64 62 65 46 75  turn;..  pVdbeFu
2160: 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 65  nc = pCtx->pVdbe
2170: 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 64  Func;.  if( !pVd
2180: 62 65 46 75 6e 63 20 7c 7c 20 70 56 64 62 65 46  beFunc || pVdbeF
2190: 75 6e 63 2d 3e 6e 41 75 78 3c 3d 69 41 72 67 20  unc->nAux<=iArg 
21a0: 29 7b 0a 20 20 20 20 69 6e 74 20 6e 4d 61 6c 6c  ){.    int nMall
21b0: 6f 63 20 3d 20 73 69 7a 65 6f 66 28 56 64 62 65  oc = sizeof(Vdbe
21c0: 46 75 6e 63 29 20 2b 20 73 69 7a 65 6f 66 28 73  Func) + sizeof(s
21d0: 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a 69  truct AuxData)*i
21e0: 41 72 67 3b 0a 20 20 20 20 70 56 64 62 65 46 75  Arg;.    pVdbeFu
21f0: 6e 63 20 3d 20 73 71 6c 69 74 65 52 65 61 6c 6c  nc = sqliteReall
2200: 6f 63 28 70 56 64 62 65 46 75 6e 63 2c 20 6e 4d  oc(pVdbeFunc, nM
2210: 61 6c 6c 6f 63 29 3b 0a 20 20 20 20 69 66 28 20  alloc);.    if( 
2220: 21 70 56 64 62 65 46 75 6e 63 20 29 20 72 65 74  !pVdbeFunc ) ret
2230: 75 72 6e 3b 0a 20 20 20 20 70 43 74 78 2d 3e 70  urn;.    pCtx->p
2240: 56 64 62 65 46 75 6e 63 20 3d 20 70 56 64 62 65  VdbeFunc = pVdbe
2250: 46 75 6e 63 3b 0a 20 20 20 20 6d 65 6d 73 65 74  Func;.    memset
2260: 28 26 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41  (&pVdbeFunc->apA
2270: 75 78 5b 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41  ux[pVdbeFunc->nA
2280: 75 78 5d 2c 20 30 2c 20 0a 20 20 20 20 20 20 20  ux], 0, .       
2290: 20 20 20 20 20 20 73 69 7a 65 6f 66 28 73 74 72        sizeof(str
22a0: 75 63 74 20 41 75 78 44 61 74 61 29 2a 28 69 41  uct AuxData)*(iA
22b0: 72 67 2b 31 2d 70 56 64 62 65 46 75 6e 63 2d 3e  rg+1-pVdbeFunc->
22c0: 6e 41 75 78 29 29 3b 0a 20 20 20 20 70 56 64 62  nAux));.    pVdb
22d0: 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3d 20 69 41  eFunc->nAux = iA
22e0: 72 67 2b 31 3b 0a 20 20 20 20 70 56 64 62 65 46  rg+1;.    pVdbeF
22f0: 75 6e 63 2d 3e 70 46 75 6e 63 20 3d 20 70 43 74  unc->pFunc = pCt
2300: 78 2d 3e 70 46 75 6e 63 3b 0a 20 20 7d 0a 0a 20  x->pFunc;.  }.. 
2310: 20 70 41 75 78 44 61 74 61 20 3d 20 26 70 56 64   pAuxData = &pVd
2320: 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 41  beFunc->apAux[iA
2330: 72 67 5d 3b 0a 20 20 69 66 28 20 70 41 75 78 44  rg];.  if( pAuxD
2340: 61 74 61 2d 3e 70 41 75 78 20 26 26 20 70 41 75  ata->pAux && pAu
2350: 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 20 29  xData->xDelete )
2360: 7b 0a 20 20 20 20 70 41 75 78 44 61 74 61 2d 3e  {.    pAuxData->
2370: 78 44 65 6c 65 74 65 28 70 41 75 78 44 61 74 61  xDelete(pAuxData
2380: 2d 3e 70 41 75 78 29 3b 0a 20 20 7d 0a 20 20 70  ->pAux);.  }.  p
2390: 41 75 78 44 61 74 61 2d 3e 70 41 75 78 20 3d 20  AuxData->pAux = 
23a0: 70 41 75 78 3b 0a 20 20 70 41 75 78 44 61 74 61  pAux;.  pAuxData
23b0: 2d 3e 78 44 65 6c 65 74 65 20 3d 20 78 44 65 6c  ->xDelete = xDel
23c0: 65 74 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  ete;.}../*.** Re
23d0: 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20  turn the number 
23e0: 6f 66 20 74 69 6d 65 73 20 74 68 65 20 53 74 65  of times the Ste
23f0: 70 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20 61 20  p function of a 
2400: 61 67 67 72 65 67 61 74 65 20 68 61 73 20 62 65  aggregate has be
2410: 65 6e 20 0a 2a 2a 20 63 61 6c 6c 65 64 2e 0a 2a  en .** called..*
2420: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
2430: 65 20 69 73 20 64 65 66 69 6e 65 64 20 68 65 72  e is defined her
2440: 65 20 69 6e 20 76 64 62 65 2e 63 20 62 65 63 61  e in vdbe.c beca
2450: 75 73 65 20 69 74 20 64 65 70 65 6e 64 73 20 6f  use it depends o
2460: 6e 20 6b 6e 6f 77 69 6e 67 0a 2a 2a 20 74 68 65  n knowing.** the
2470: 20 69 6e 74 65 72 6e 61 6c 73 20 6f 66 20 74 68   internals of th
2480: 65 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  e sqlite3_contex
2490: 74 20 73 74 72 75 63 74 75 72 65 20 77 68 69 63  t structure whic
24a0: 68 20 69 73 20 6f 6e 6c 79 20 64 65 66 69 6e 65  h is only define
24b0: 64 20 69 6e 0a 2a 2a 20 74 68 69 73 20 73 6f 75  d in.** this sou
24c0: 72 63 65 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74  rce file..*/.int
24d0: 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61   sqlite3_aggrega
24e0: 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33  te_count(sqlite3
24f0: 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20  _context *p){.  
2500: 61 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e  assert( p && p->
2510: 70 46 75 6e 63 20 26 26 20 70 2d 3e 70 46 75 6e  pFunc && p->pFun
2520: 63 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20 72 65  c->xStep );.  re
2530: 74 75 72 6e 20 70 2d 3e 70 4d 65 6d 2d 3e 6e 3b  turn p->pMem->n;
2540: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
2550: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63   the number of c
2560: 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72 65  olumns in the re
2570: 73 75 6c 74 20 73 65 74 20 66 6f 72 20 74 68 65  sult set for the
2580: 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74   statement pStmt
2590: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
25a0: 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 73 71  _column_count(sq
25b0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
25c0: 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20  t){.  Vdbe *pVm 
25d0: 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b  = (Vdbe *)pStmt;
25e0: 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 20 3f 20  .  return pVm ? 
25f0: 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20  pVm->nResColumn 
2600: 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  : 0;.}../*.** Re
2610: 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20  turn the number 
2620: 6f 66 20 76 61 6c 75 65 73 20 61 76 61 69 6c 61  of values availa
2630: 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 75 72  ble from the cur
2640: 72 65 6e 74 20 72 6f 77 20 6f 66 20 74 68 65 0a  rent row of the.
2650: 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65  ** currently exe
2660: 63 75 74 69 6e 67 20 73 74 61 74 65 6d 65 6e 74  cuting statement
2670: 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73   pStmt..*/.int s
2680: 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e  qlite3_data_coun
2690: 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  t(sqlite3_stmt *
26a0: 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a  pStmt){.  Vdbe *
26b0: 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53  pVm = (Vdbe *)pS
26c0: 74 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d 3d 3d  tmt;.  if( pVm==
26d0: 30 20 7c 7c 20 21 70 56 6d 2d 3e 72 65 73 4f 6e  0 || !pVm->resOn
26e0: 53 74 61 63 6b 20 29 20 72 65 74 75 72 6e 20 30  Stack ) return 0
26f0: 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 2d 3e  ;.  return pVm->
2700: 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d 0a 0a 0a  nResColumn;.}...
2710: 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73  /*.** Check to s
2720: 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69 43 6f  ee if column iCo
2730: 6c 20 6f 66 20 74 68 65 20 67 69 76 65 6e 20 73  l of the given s
2740: 74 61 74 65 6d 65 6e 74 20 69 73 20 76 61 6c 69  tatement is vali
2750: 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20 69 73 2c  d.  If.** it is,
2760: 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65   return a pointe
2770: 72 20 74 6f 20 74 68 65 20 4d 65 6d 20 66 6f 72  r to the Mem for
2780: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68   the value of th
2790: 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 49 66  at column..** If
27a0: 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20 76 61 6c   iCol is not val
27b0: 69 64 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69  id, return a poi
27c0: 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 20 77 68  nter to a Mem wh
27d0: 69 63 68 20 68 61 73 20 61 20 76 61 6c 75 65 0a  ich has a value.
27e0: 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73  ** of NULL..*/.s
27f0: 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f 6c 75 6d  tatic Mem *colum
2800: 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f 73 74 6d  nMem(sqlite3_stm
2810: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
2820: 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20 3d 20  {.  Vdbe *pVm = 
2830: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20  (Vdbe *)pStmt;. 
2840: 20 69 6e 74 20 76 61 6c 73 20 3d 20 73 71 6c 69   int vals = sqli
2850: 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74 28 70  te3_data_count(p
2860: 53 74 6d 74 29 3b 0a 20 20 69 66 28 20 69 3e 3d  Stmt);.  if( i>=
2870: 76 61 6c 73 20 7c 7c 20 69 3c 30 20 29 7b 0a 20  vals || i<0 ){. 
2880: 20 20 20 73 74 61 74 69 63 20 4d 65 6d 20 6e 75     static Mem nu
2890: 6c 6c 4d 65 6d 3b 0a 20 20 20 20 69 66 28 20 6e  llMem;.    if( n
28a0: 75 6c 6c 4d 65 6d 2e 66 6c 61 67 73 3d 3d 30 20  ullMem.flags==0 
28b0: 29 7b 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 67 73  ){ nullMem.flags
28c0: 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 20 7d 0a 20   = MEM_Null; }. 
28d0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
28e0: 70 56 6d 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f  pVm->db, SQLITE_
28f0: 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 72  RANGE, 0);.    r
2900: 65 74 75 72 6e 20 26 6e 75 6c 6c 4d 65 6d 3b 0a  eturn &nullMem;.
2910: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 26 70 56    }.  return &pV
2920: 6d 2d 3e 70 54 6f 73 5b 28 31 2d 76 61 6c 73 29  m->pTos[(1-vals)
2930: 2b 69 5d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  +i];.}../*.** Th
2940: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63  is function is c
2950: 61 6c 6c 65 64 20 61 66 74 65 72 20 69 6e 76 6f  alled after invo
2960: 6b 69 6e 67 20 61 6e 20 73 71 6c 69 74 65 33 5f  king an sqlite3_
2970: 76 61 6c 75 65 5f 58 58 58 20 66 75 6e 63 74 69  value_XXX functi
2980: 6f 6e 20 6f 6e 20 61 20 0a 2a 2a 20 63 6f 6c 75  on on a .** colu
2990: 6d 6e 20 76 61 6c 75 65 20 28 69 2e 65 2e 20 61  mn value (i.e. a
29a0: 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20   value returned 
29b0: 62 79 20 65 76 61 6c 75 61 74 69 6e 67 20 61 6e  by evaluating an
29c0: 20 53 51 4c 20 65 78 70 72 65 73 73 69 6f 6e 20   SQL expression 
29d0: 69 6e 20 74 68 65 0a 2a 2a 20 73 65 6c 65 63 74  in the.** select
29e0: 20 6c 69 73 74 20 6f 66 20 61 20 53 45 4c 45 43   list of a SELEC
29f0: 54 20 73 74 61 74 65 6d 65 6e 74 29 20 74 68 61  T statement) tha
2a00: 74 20 6d 61 79 20 63 61 75 73 65 20 61 20 6d 61  t may cause a ma
2a10: 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2e 20  lloc() failure. 
2a20: 49 66 20 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20  If .** malloc() 
2a30: 68 61 73 20 66 61 69 6c 65 64 2c 20 74 68 65 20  has failed, the 
2a40: 74 68 72 65 61 64 73 20 6d 61 6c 6c 6f 63 46 61  threads mallocFa
2a50: 69 6c 65 64 20 66 6c 61 67 20 69 73 20 63 6c 65  iled flag is cle
2a60: 61 72 65 64 20 61 6e 64 20 74 68 65 20 72 65 73  ared and the res
2a70: 75 6c 74 0a 2a 2a 20 63 6f 64 65 20 6f 66 20 73  ult.** code of s
2a80: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 20 73  tatement pStmt s
2a90: 65 74 20 74 6f 20 53 51 4c 49 54 45 5f 4e 4f 4d  et to SQLITE_NOM
2aa0: 45 4d 2e 0a 2a 2a 0a 2a 2a 20 53 70 65 63 69 66  EM..**.** Specif
2ab0: 69 63 6c 79 2c 20 74 68 69 73 20 69 73 20 63 61  icly, this is ca
2ac0: 6c 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e  lled from within
2ad0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 73 71 6c 69  :.**.**     sqli
2ae0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 28 29  te3_column_int()
2af0: 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f  .**     sqlite3_
2b00: 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34 28 29 0a 2a  column_int64().*
2b10: 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f  *     sqlite3_co
2b20: 6c 75 6d 6e 5f 74 65 78 74 28 29 0a 2a 2a 20 20  lumn_text().**  
2b30: 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d     sqlite3_colum
2b40: 6e 5f 74 65 78 74 31 36 28 29 0a 2a 2a 20 20 20  n_text16().**   
2b50: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e    sqlite3_column
2b60: 5f 72 65 61 6c 28 29 0a 2a 2a 20 20 20 20 20 73  _real().**     s
2b70: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79  qlite3_column_by
2b80: 74 65 73 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c  tes().**     sql
2b90: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65  ite3_column_byte
2ba0: 73 31 36 28 29 0a 2a 2a 0a 2a 2a 20 42 75 74 20  s16().**.** But 
2bb0: 6e 6f 74 20 66 6f 72 20 73 71 6c 69 74 65 33 5f  not for sqlite3_
2bc0: 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 29 2c 20 77  column_blob(), w
2bd0: 68 69 63 68 20 6e 65 76 65 72 20 63 61 6c 6c 73  hich never calls
2be0: 20 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 73 74   malloc()..*/.st
2bf0: 61 74 69 63 20 76 6f 69 64 20 63 6f 6c 75 6d 6e  atic void column
2c00: 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 73 71  MallocFailure(sq
2c10: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
2c20: 74 29 0a 7b 0a 20 20 2f 2a 20 49 66 20 6d 61 6c  t).{.  /* If mal
2c30: 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 64 75 72  loc() failed dur
2c40: 69 6e 67 20 61 6e 20 65 6e 63 6f 64 69 6e 67 20  ing an encoding 
2c50: 63 6f 6e 76 65 72 73 69 6f 6e 20 77 69 74 68 69  conversion withi
2c60: 6e 20 61 6e 0a 20 20 2a 2a 20 73 71 6c 69 74 65  n an.  ** sqlite
2c70: 33 5f 63 6f 6c 75 6d 6e 5f 58 58 58 20 41 50 49  3_column_XXX API
2c80: 2c 20 74 68 65 6e 20 73 65 74 20 74 68 65 20 72  , then set the r
2c90: 65 74 75 72 6e 20 63 6f 64 65 20 6f 66 20 74 68  eturn code of th
2ca0: 65 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 0a 20  e statement to. 
2cb0: 20 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d   ** SQLITE_NOMEM
2cc0: 2e 20 54 68 65 20 6e 65 78 74 20 63 61 6c 6c 20  . The next call 
2cd0: 74 6f 20 5f 73 74 65 70 28 29 20 28 69 66 20 61  to _step() (if a
2ce0: 6e 79 29 20 77 69 6c 6c 20 72 65 74 75 72 6e 20  ny) will return 
2cf0: 53 51 4c 49 54 45 5f 45 52 52 4f 52 0a 20 20 2a  SQLITE_ERROR.  *
2d00: 2a 20 61 6e 64 20 5f 66 69 6e 61 6c 69 7a 65 28  * and _finalize(
2d10: 29 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 4e 4f  ) will return NO
2d20: 4d 45 4d 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  MEM..  */.  if( 
2d30: 73 71 6c 69 74 65 33 54 68 72 65 61 64 44 61 74  sqlite3ThreadDat
2d40: 61 52 65 61 64 4f 6e 6c 79 28 29 2d 3e 6d 61 6c  aReadOnly()->mal
2d50: 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20  locFailed ){.   
2d60: 20 28 28 56 64 62 65 20 2a 29 70 53 74 6d 74 29   ((Vdbe *)pStmt)
2d70: 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f  ->rc = SQLITE_NO
2d80: 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  MEM;.    sqlite3
2d90: 4d 61 6c 6c 6f 63 43 6c 65 61 72 46 61 69 6c 65  MallocClearFaile
2da0: 64 28 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a 2a  d();.  }.}../***
2db0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2dc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65  ********* sqlite
2dd0: 33 5f 63 6f 6c 75 6d 6e 5f 20 20 2a 2a 2a 2a 2a  3_column_  *****
2de0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2df0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68  **********.** Th
2e00: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74  e following rout
2e10: 69 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 6f  ines are used to
2e20: 20 61 63 63 65 73 73 20 65 6c 65 6d 65 6e 74 73   access elements
2e30: 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 20   of the current 
2e40: 72 6f 77 0a 2a 2a 20 69 6e 20 74 68 65 20 72 65  row.** in the re
2e50: 73 75 6c 74 20 73 65 74 2e 0a 2a 2f 0a 63 6f 6e  sult set..*/.con
2e60: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  st void *sqlite3
2e70: 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 73 71 6c  _column_blob(sql
2e80: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
2e90: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e 73  , int i){.  cons
2ea0: 74 20 76 6f 69 64 20 2a 76 61 6c 3b 0a 20 20 73  t void *val;.  s
2eb0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 44 69 73 61  qlite3MallocDisa
2ec0: 6c 6c 6f 77 28 29 3b 0a 20 20 76 61 6c 20 3d 20  llow();.  val = 
2ed0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c  sqlite3_value_bl
2ee0: 6f 62 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53  ob( columnMem(pS
2ef0: 74 6d 74 2c 69 29 20 29 3b 0a 20 20 73 71 6c 69  tmt,i) );.  sqli
2f00: 74 65 33 4d 61 6c 6c 6f 63 41 6c 6c 6f 77 28 29  te3MallocAllow()
2f10: 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a  ;.  return val;.
2f20: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f  }.int sqlite3_co
2f30: 6c 75 6d 6e 5f 62 79 74 65 73 28 73 71 6c 69 74  lumn_bytes(sqlit
2f40: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
2f50: 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 76 61  int i){.  int va
2f60: 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  l = sqlite3_valu
2f70: 65 5f 62 79 74 65 73 28 20 63 6f 6c 75 6d 6e 4d  e_bytes( columnM
2f80: 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20  em(pStmt,i) );. 
2f90: 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69   columnMallocFai
2fa0: 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72  lure(pStmt);.  r
2fb0: 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74  eturn val;.}.int
2fc0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
2fd0: 62 79 74 65 73 31 36 28 73 71 6c 69 74 65 33 5f  bytes16(sqlite3_
2fe0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
2ff0: 20 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d   i){.  int val =
3000: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62   sqlite3_value_b
3010: 79 74 65 73 31 36 28 20 63 6f 6c 75 6d 6e 4d 65  ytes16( columnMe
3020: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20  m(pStmt,i) );.  
3030: 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c  columnMallocFail
3040: 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65  ure(pStmt);.  re
3050: 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 64 6f 75 62  turn val;.}.doub
3060: 6c 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  le sqlite3_colum
3070: 6e 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33  n_double(sqlite3
3080: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
3090: 74 20 69 29 7b 0a 20 20 64 6f 75 62 6c 65 20 76  t i){.  double v
30a0: 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c  al = sqlite3_val
30b0: 75 65 5f 64 6f 75 62 6c 65 28 20 63 6f 6c 75 6d  ue_double( colum
30c0: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
30d0: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46  .  columnMallocF
30e0: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20  ailure(pStmt);. 
30f0: 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69   return val;.}.i
3100: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  nt sqlite3_colum
3110: 6e 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 73 74  n_int(sqlite3_st
3120: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
3130: 29 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20 73  ){.  int val = s
3140: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74  qlite3_value_int
3150: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d  ( columnMem(pStm
3160: 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e  t,i) );.  column
3170: 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53  MallocFailure(pS
3180: 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76  tmt);.  return v
3190: 61 6c 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74  al;.}.sqlite_int
31a0: 36 34 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  64 sqlite3_colum
31b0: 6e 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f  n_int64(sqlite3_
31c0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
31d0: 20 69 29 7b 0a 20 20 73 71 6c 69 74 65 5f 69 6e   i){.  sqlite_in
31e0: 74 36 34 20 76 61 6c 20 3d 20 73 71 6c 69 74 65  t64 val = sqlite
31f0: 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 20 63  3_value_int64( c
3200: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69  olumnMem(pStmt,i
3210: 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c  ) );.  columnMal
3220: 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74  locFailure(pStmt
3230: 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b  );.  return val;
3240: 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  .}.const unsigne
3250: 64 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f  d char *sqlite3_
3260: 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 73 71 6c 69  column_text(sqli
3270: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
3280: 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e 73 74   int i){.  const
3290: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
32a0: 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  val = sqlite3_va
32b0: 6c 75 65 5f 74 65 78 74 28 20 63 6f 6c 75 6d 6e  lue_text( column
32c0: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a  Mem(pStmt,i) );.
32d0: 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61    columnMallocFa
32e0: 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20  ilure(pStmt);.  
32f0: 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 23 69  return val;.}.#i
3300: 66 20 30 0a 73 71 6c 69 74 65 33 5f 76 61 6c 75  f 0.sqlite3_valu
3310: 65 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  e *sqlite3_colum
3320: 6e 5f 76 61 6c 75 65 28 73 71 6c 69 74 65 33 5f  n_value(sqlite3_
3330: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
3340: 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f   i){.  return co
3350: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 20 69  lumnMem(pStmt, i
3360: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 23 69 66 6e  );.}.#endif.#ifn
3370: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
3380: 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64  UTF16.const void
3390: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
33a0: 5f 74 65 78 74 31 36 28 73 71 6c 69 74 65 33 5f  _text16(sqlite3_
33b0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
33c0: 20 69 29 7b 0a 20 20 63 6f 6e 73 74 20 76 6f 69   i){.  const voi
33d0: 64 20 2a 76 61 6c 20 3d 20 73 71 6c 69 74 65 33  d *val = sqlite3
33e0: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 20 63  _value_text16( c
33f0: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69  olumnMem(pStmt,i
3400: 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c  ) );.  columnMal
3410: 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74  locFailure(pStmt
3420: 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b  );.  return val;
3430: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
3440: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
3450: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f  /.int sqlite3_co
3460: 6c 75 6d 6e 5f 74 79 70 65 28 73 71 6c 69 74 65  lumn_type(sqlite
3470: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
3480: 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt i){.  return 
3490: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79  sqlite3_value_ty
34a0: 70 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53  pe( columnMem(pS
34b0: 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 0a 2f 2a 0a  tmt,i) );.}../*.
34c0: 2a 2a 20 43 6f 6e 76 65 72 74 20 74 68 65 20 4e  ** Convert the N
34d0: 2d 74 68 20 65 6c 65 6d 65 6e 74 20 6f 66 20 70  -th element of p
34e0: 53 74 6d 74 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d  Stmt->pColName[]
34f0: 20 69 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 75   into a string u
3500: 73 69 6e 67 0a 2a 2a 20 78 46 75 6e 63 28 29 20  sing.** xFunc() 
3510: 74 68 65 6e 20 72 65 74 75 72 6e 20 74 68 61 74  then return that
3520: 20 73 74 72 69 6e 67 2e 20 20 49 66 20 4e 20 69   string.  If N i
3530: 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 20  s out of range, 
3540: 72 65 74 75 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20  return 0..**.** 
3550: 54 68 65 72 65 20 61 72 65 20 75 70 20 74 6f 20  There are up to 
3560: 35 20 6e 61 6d 65 73 20 66 6f 72 20 65 61 63 68  5 names for each
3570: 20 63 6f 6c 75 6d 6e 2e 20 20 75 73 65 54 79 70   column.  useTyp
3580: 65 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 69  e determines whi
3590: 63 68 0a 2a 2a 20 6e 61 6d 65 20 69 73 20 72 65  ch.** name is re
35a0: 74 75 72 6e 65 64 2e 20 20 48 65 72 65 20 61 72  turned.  Here ar
35b0: 65 20 74 68 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a  e the names:.**.
35c0: 2a 2a 20 20 20 20 30 20 20 20 20 20 20 54 68 65  **    0      The
35d0: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 61 73 20   column name as 
35e0: 69 74 20 73 68 6f 75 6c 64 20 62 65 20 64 69 73  it should be dis
35f0: 70 6c 61 79 65 64 20 66 6f 72 20 6f 75 74 70 75  played for outpu
3600: 74 0a 2a 2a 20 20 20 20 31 20 20 20 20 20 20 54  t.**    1      T
3610: 68 65 20 64 61 74 61 74 79 70 65 20 6e 61 6d 65  he datatype name
3620: 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 0a   for the column.
3630: 2a 2a 20 20 20 20 32 20 20 20 20 20 20 54 68 65  **    2      The
3640: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74   name of the dat
3650: 61 62 61 73 65 20 74 68 61 74 20 74 68 65 20 63  abase that the c
3660: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72  olumn derives fr
3670: 6f 6d 0a 2a 2a 20 20 20 20 33 20 20 20 20 20 20  om.**    3      
3680: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
3690: 74 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 63  table that the c
36a0: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72  olumn derives fr
36b0: 6f 6d 0a 2a 2a 20 20 20 20 34 20 20 20 20 20 20  om.**    4      
36c0: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
36d0: 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61  table column tha
36e0: 74 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c  t the result col
36f0: 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d  umn derives from
3700: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 72 65  .**.** If the re
3710: 73 75 6c 74 20 69 73 20 6e 6f 74 20 61 20 73 69  sult is not a si
3720: 6d 70 6c 65 20 63 6f 6c 75 6d 6e 20 72 65 66 65  mple column refe
3730: 72 65 6e 63 65 20 28 69 66 20 69 74 20 69 73 20  rence (if it is 
3740: 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a  an expression.**
3750: 20 6f 72 20 61 20 63 6f 6e 73 74 61 6e 74 29 20   or a constant) 
3760: 74 68 65 6e 20 75 73 65 54 79 70 65 73 20 32 2c  then useTypes 2,
3770: 20 33 2c 20 61 6e 64 20 34 20 72 65 74 75 72 6e   3, and 4 return
3780: 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63   NULL..*/.static
3790: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c   const void *col
37a0: 75 6d 6e 4e 61 6d 65 28 0a 20 20 73 71 6c 69 74  umnName(.  sqlit
37b0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 0a  e3_stmt *pStmt,.
37c0: 20 20 69 6e 74 20 4e 2c 0a 20 20 63 6f 6e 73 74    int N,.  const
37d0: 20 76 6f 69 64 20 2a 28 2a 78 46 75 6e 63 29 28   void *(*xFunc)(
37e0: 4d 65 6d 2a 29 2c 0a 20 20 69 6e 74 20 75 73 65  Mem*),.  int use
37f0: 54 79 70 65 0a 29 7b 0a 20 20 63 6f 6e 73 74 20  Type.){.  const 
3800: 76 6f 69 64 20 2a 72 65 74 3b 0a 20 20 56 64 62  void *ret;.  Vdb
3810: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
3820: 53 74 6d 74 3b 0a 20 20 69 6e 74 20 6e 20 3d 20  Stmt;.  int n = 
3830: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63  sqlite3_column_c
3840: 6f 75 6e 74 28 70 53 74 6d 74 29 3b 0a 0a 20 20  ount(pStmt);..  
3850: 69 66 28 20 70 3d 3d 30 20 7c 7c 20 4e 3e 3d 6e  if( p==0 || N>=n
3860: 20 7c 7c 20 4e 3c 30 20 29 7b 0a 20 20 20 20 72   || N<0 ){.    r
3870: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 4e  eturn 0;.  }.  N
3880: 20 2b 3d 20 75 73 65 54 79 70 65 2a 6e 3b 0a 20   += useType*n;. 
3890: 20 72 65 74 20 3d 20 78 46 75 6e 63 28 26 70 2d   ret = xFunc(&p-
38a0: 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29 3b 0a 0a  >aColName[N]);..
38b0: 20 20 2f 2a 20 41 20 6d 61 6c 6c 6f 63 20 6d 61    /* A malloc ma
38c0: 79 20 68 61 76 65 20 66 61 69 6c 65 64 20 69 6e  y have failed in
38d0: 73 69 64 65 20 6f 66 20 74 68 65 20 78 46 75 6e  side of the xFun
38e0: 63 28 29 20 63 61 6c 6c 2e 20 49 66 20 74 68 69  c() call. If thi
38f0: 73 20 69 73 20 74 68 65 20 63 61 73 65 2c 0a 20  s is the case,. 
3900: 20 2a 2a 20 63 6c 65 61 72 20 74 68 65 20 6d 61   ** clear the ma
3910: 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20  llocFailed flag 
3920: 61 6e 64 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e  and return NULL.
3930: 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 4d  .  */.  sqlite3M
3940: 61 6c 6c 6f 63 43 6c 65 61 72 46 61 69 6c 65 64  allocClearFailed
3950: 28 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 74  ();.  return ret
3960: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
3970: 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  n the name of th
3980: 65 20 4e 74 68 20 63 6f 6c 75 6d 6e 20 6f 66 20  e Nth column of 
3990: 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 72  the result set r
39a0: 65 74 75 72 6e 65 64 20 62 79 20 53 51 4c 0a 2a  eturned by SQL.*
39b0: 2a 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d  * statement pStm
39c0: 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72  t..*/.const char
39d0: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
39e0: 5f 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74  _name(sqlite3_st
39f0: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e  mt *pStmt, int N
3a00: 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75  ){.  return colu
3a10: 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c  mnName(pStmt, N,
3a20: 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29   (const void*(*)
3a30: 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76  (Mem*))sqlite3_v
3a40: 61 6c 75 65 5f 74 65 78 74 2c 20 30 29 3b 0a 7d  alue_text, 0);.}
3a50: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
3a60: 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74  OMIT_UTF16.const
3a70: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
3a80: 6f 6c 75 6d 6e 5f 6e 61 6d 65 31 36 28 73 71 6c  olumn_name16(sql
3a90: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
3aa0: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
3ab0: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53  rn columnName(pS
3ac0: 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76  tmt, N, (const v
3ad0: 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71  oid*(*)(Mem*))sq
3ae0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
3af0: 31 36 2c 20 30 29 3b 0a 7d 0a 23 65 6e 64 69 66  16, 0);.}.#endif
3b00: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
3b10: 68 65 20 63 6f 6c 75 6d 6e 20 64 65 63 6c 61 72  he column declar
3b20: 61 74 69 6f 6e 20 74 79 70 65 20 28 69 66 20 61  ation type (if a
3b30: 70 70 6c 69 63 61 62 6c 65 29 20 6f 66 20 74 68  pplicable) of th
3b40: 65 20 27 69 27 74 68 20 63 6f 6c 75 6d 6e 0a 2a  e 'i'th column.*
3b50: 2a 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20  * of the result 
3b60: 73 65 74 20 6f 66 20 53 51 4c 20 73 74 61 74 65  set of SQL state
3b70: 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 63  ment pStmt..*/.c
3b80: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74  onst char *sqlit
3b90: 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79  e3_column_declty
3ba0: 70 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  pe(sqlite3_stmt 
3bb0: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
3bc0: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e    return columnN
3bd0: 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63  ame(pStmt, N, (c
3be0: 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65  onst void*(*)(Me
3bf0: 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75  m*))sqlite3_valu
3c00: 65 5f 74 65 78 74 2c 20 31 29 3b 0a 7d 0a 23 69  e_text, 1);.}.#i
3c10: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
3c20: 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f  T_UTF16.const vo
3c30: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  id *sqlite3_colu
3c40: 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 28 73 71  mn_decltype16(sq
3c50: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
3c60: 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74  t, int N){.  ret
3c70: 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70  urn columnName(p
3c80: 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20  Stmt, N, (const 
3c90: 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73  void*(*)(Mem*))s
3ca0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
3cb0: 74 31 36 2c 20 31 29 3b 0a 7d 0a 23 65 6e 64 69  t16, 1);.}.#endi
3cc0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
3cd0: 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 66 20 21  _UTF16 */..#if !
3ce0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f  defined(SQLITE_O
3cf0: 4d 49 54 5f 4f 52 49 47 49 4e 5f 4e 41 4d 45 53  MIT_ORIGIN_NAMES
3d00: 29 20 26 26 20 30 0a 2f 2a 0a 2a 2a 20 52 65 74  ) && 0./*.** Ret
3d10: 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  urn the name of 
3d20: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 72 6f  the database fro
3d30: 6d 20 77 68 69 63 68 20 61 20 72 65 73 75 6c 74  m which a result
3d40: 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e   column derives.
3d50: 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75  .** NULL is retu
3d60: 72 6e 65 64 20 69 66 20 74 68 65 20 72 65 73 75  rned if the resu
3d70: 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20  lt column is an 
3d80: 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f  expression or co
3d90: 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79  nstant or.** any
3da0: 74 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68  thing else which
3db0: 20 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 62 69   is not an unabi
3dc0: 67 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20  guous reference 
3dd0: 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 63 6f  to a database co
3de0: 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63  lumn..*/.const c
3df0: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  har *sqlite3_col
3e00: 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d  umn_database_nam
3e10: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
3e20: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
3e30: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
3e40: 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f  me(pStmt, N, (co
3e50: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
3e60: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
3e70: 5f 74 65 78 74 2c 20 32 29 3b 0a 7d 0a 23 69 66  _text, 2);.}.#if
3e80: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
3e90: 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69  _UTF16.const voi
3ea0: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  d *sqlite3_colum
3eb0: 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 31  n_database_name1
3ec0: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
3ed0: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
3ee0: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
3ef0: 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f  me(pStmt, N, (co
3f00: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
3f10: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
3f20: 5f 74 65 78 74 31 36 2c 20 32 29 3b 0a 7d 0a 23  _text16, 2);.}.#
3f30: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
3f40: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f  OMIT_UTF16 */../
3f50: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
3f60: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
3f70: 65 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72  e from which a r
3f80: 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72  esult column der
3f90: 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73  ives..** NULL is
3fa0: 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65   returned if the
3fb0: 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69   result column i
3fc0: 73 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20  s an expression 
3fd0: 6f 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a  or constant or.*
3fe0: 2a 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20  * anything else 
3ff0: 77 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20  which is not an 
4000: 75 6e 61 62 69 67 75 6f 75 73 20 72 65 66 65 72  unabiguous refer
4010: 65 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62 61  ence to a databa
4020: 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f  se column..*/.co
4030: 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65  nst char *sqlite
4040: 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e  3_column_table_n
4050: 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ame(sqlite3_stmt
4060: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b   *pStmt, int N){
4070: 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e  .  return column
4080: 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28  Name(pStmt, N, (
4090: 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d  const void*(*)(M
40a0: 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c  em*))sqlite3_val
40b0: 75 65 5f 74 65 78 74 2c 20 33 29 3b 0a 7d 0a 23  ue_text, 3);.}.#
40c0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
40d0: 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76  IT_UTF16.const v
40e0: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  oid *sqlite3_col
40f0: 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31 36  umn_table_name16
4100: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
4110: 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20  Stmt, int N){.  
4120: 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d  return columnNam
4130: 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e  e(pStmt, N, (con
4140: 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a  st void*(*)(Mem*
4150: 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ))sqlite3_value_
4160: 74 65 78 74 31 36 2c 20 33 29 3b 0a 7d 0a 23 65  text16, 3);.}.#e
4170: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f  ndif /* SQLITE_O
4180: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a  MIT_UTF16 */../*
4190: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
41a0: 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65  ame of the table
41b0: 20 63 6f 6c 75 6d 6e 20 66 72 6f 6d 20 77 68 69   column from whi
41c0: 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75  ch a result colu
41d0: 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e  mn derives..** N
41e0: 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20  ULL is returned 
41f0: 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f  if the result co
4200: 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65  lumn is an expre
4210: 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e  ssion or constan
4220: 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67  t or.** anything
4230: 20 65 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e   else which is n
4240: 6f 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73  ot an unabiguous
4250: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20   reference to a 
4260: 64 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e  database column.
4270: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a  .*/.const char *
4280: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f  sqlite3_column_o
4290: 72 69 67 69 6e 5f 6e 61 6d 65 28 73 71 6c 69 74  rigin_name(sqlit
42a0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
42b0: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
42c0: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d   columnName(pStm
42d0: 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69  t, N, (const voi
42e0: 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69  d*(*)(Mem*))sqli
42f0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c 20  te3_value_text, 
4300: 34 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51  4);.}.#ifndef SQ
4310: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
4320: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
4330: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69  te3_column_origi
4340: 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33  n_name16(sqlite3
4350: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
4360: 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63  t N){.  return c
4370: 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c  olumnName(pStmt,
4380: 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a   N, (const void*
4390: 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65  (*)(Mem*))sqlite
43a0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20  3_value_text16, 
43b0: 34 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20  4);.}.#endif /* 
43c0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
43d0: 36 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 53  6 */.#endif /* S
43e0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 4f 52 49 47 49  QLITE_OMIT_ORIGI
43f0: 4e 5f 4e 41 4d 45 53 20 2a 2f 0a 0a 0a 0a 0a 2f  N_NAMES */...../
4400: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4410: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20  *************** 
4420: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 20 20 2a  sqlite3_bind_  *
4430: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4440: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 0a 2a  **********.** .*
4450: 2a 20 52 6f 75 74 69 6e 65 73 20 75 73 65 64 20  * Routines used 
4460: 74 6f 20 61 74 74 61 63 68 20 76 61 6c 75 65 73  to attach values
4470: 20 74 6f 20 77 69 6c 64 63 61 72 64 73 20 69 6e   to wildcards in
4480: 20 61 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20   a compiled SQL 
4490: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 2f 2a  statement..*/./*
44a0: 0a 2a 2a 20 55 6e 62 69 6e 64 20 74 68 65 20 76  .** Unbind the v
44b0: 61 6c 75 65 20 62 6f 75 6e 64 20 74 6f 20 76 61  alue bound to va
44c0: 72 69 61 62 6c 65 20 69 20 69 6e 20 76 69 72 74  riable i in virt
44d0: 75 61 6c 20 6d 61 63 68 69 6e 65 20 70 2e 20 54  ual machine p. T
44e0: 68 69 73 20 69 73 20 74 68 65 20 0a 2a 2a 20 74  his is the .** t
44f0: 68 65 20 73 61 6d 65 20 61 73 20 62 69 6e 64 69  he same as bindi
4500: 6e 67 20 61 20 4e 55 4c 4c 20 76 61 6c 75 65 20  ng a NULL value 
4510: 74 6f 20 74 68 65 20 63 6f 6c 75 6d 6e 2e 20 49  to the column. I
4520: 66 20 74 68 65 20 22 69 22 20 70 61 72 61 6d 65  f the "i" parame
4530: 74 65 72 20 69 73 0a 2a 2a 20 6f 75 74 20 6f 66  ter is.** out of
4540: 20 72 61 6e 67 65 2c 20 74 68 65 6e 20 53 51 4c   range, then SQL
4550: 49 54 45 5f 52 41 4e 47 45 20 69 73 20 72 65 74  ITE_RANGE is ret
4560: 75 72 6e 65 64 2e 20 4f 74 68 65 77 69 73 65 20  urned. Othewise 
4570: 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a  SQLITE_OK..**.**
4580: 20 54 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20   The error code 
4590: 73 74 6f 72 65 64 20 69 6e 20 64 61 74 61 62 61  stored in databa
45a0: 73 65 20 70 2d 3e 64 62 20 69 73 20 6f 76 65 72  se p->db is over
45b0: 77 72 69 74 74 65 6e 20 77 69 74 68 20 74 68 65  written with the
45c0: 20 72 65 74 75 72 6e 0a 2a 2a 20 76 61 6c 75 65   return.** value
45d0: 20 69 6e 20 61 6e 79 20 63 61 73 65 2e 0a 2a 2f   in any case..*/
45e0: 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64 62 65  .static int vdbe
45f0: 55 6e 62 69 6e 64 28 56 64 62 65 20 2a 70 2c 20  Unbind(Vdbe *p, 
4600: 69 6e 74 20 69 29 7b 0a 20 20 4d 65 6d 20 2a 70  int i){.  Mem *p
4610: 56 61 72 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20  Var;.  if( p==0 
4620: 7c 7c 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42  || p->magic!=VDB
4630: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 7c 7c 20 70  E_MAGIC_RUN || p
4640: 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 69  ->pc>=0 ){.    i
4650: 66 28 20 70 20 29 20 73 71 6c 69 74 65 33 45 72  f( p ) sqlite3Er
4660: 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54  ror(p->db, SQLIT
4670: 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b 0a 20 20  E_MISUSE, 0);.  
4680: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
4690: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66  MISUSE;.  }.  if
46a0: 28 20 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56  ( i<1 || i>p->nV
46b0: 61 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ar ){.    sqlite
46c0: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51  3Error(p->db, SQ
46d0: 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a  LITE_RANGE, 0);.
46e0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
46f0: 45 5f 52 41 4e 47 45 3b 0a 20 20 7d 0a 20 20 69  E_RANGE;.  }.  i
4700: 2d 2d 3b 0a 20 20 70 56 61 72 20 3d 20 26 70 2d  --;.  pVar = &p-
4710: 3e 61 56 61 72 5b 69 5d 3b 0a 20 20 73 71 6c 69  >aVar[i];.  sqli
4720: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
4730: 65 28 70 56 61 72 29 3b 0a 20 20 70 56 61 72 2d  e(pVar);.  pVar-
4740: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c  >flags = MEM_Nul
4750: 6c 3b 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f  l;.  sqlite3Erro
4760: 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f  r(p->db, SQLITE_
4770: 4f 4b 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e  OK, 0);.  return
4780: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
4790: 2a 0a 2a 2a 20 42 69 6e 64 20 61 20 74 65 78 74  *.** Bind a text
47a0: 20 6f 72 20 42 4c 4f 42 20 76 61 6c 75 65 2e 0a   or BLOB value..
47b0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 69  */.static int bi
47c0: 6e 64 54 65 78 74 28 0a 20 20 73 71 6c 69 74 65  ndText(.  sqlite
47d0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a  3_stmt *pStmt, .
47e0: 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73    int i, .  cons
47f0: 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a  t void *zData, .
4800: 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20    int nData, .  
4810: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
4820: 64 2a 29 2c 0a 20 20 69 6e 74 20 65 6e 63 6f 64  d*),.  int encod
4830: 69 6e 67 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70  ing.){.  Vdbe *p
4840: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74   = (Vdbe *)pStmt
4850: 3b 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20  ;.  Mem *pVar;. 
4860: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 72 63 20 3d   int rc;..  rc =
4870: 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69   vdbeUnbind(p, i
4880: 29 3b 0a 20 20 69 66 28 20 72 63 20 7c 7c 20 7a  );.  if( rc || z
4890: 44 61 74 61 3d 3d 30 20 29 7b 0a 20 20 20 20 72  Data==0 ){.    r
48a0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
48b0: 70 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b  pVar = &p->aVar[
48c0: 69 2d 31 5d 3b 0a 20 20 72 63 20 3d 20 73 71 6c  i-1];.  rc = sql
48d0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
48e0: 72 28 70 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e  r(pVar, zData, n
48f0: 44 61 74 61 2c 20 65 6e 63 6f 64 69 6e 67 2c 20  Data, encoding, 
4900: 78 44 65 6c 29 3b 0a 20 20 69 66 28 20 72 63 20  xDel);.  if( rc 
4910: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63  ){.    return rc
4920: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d  ;.  }.  if( rc==
4930: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 6e 63  SQLITE_OK && enc
4940: 6f 64 69 6e 67 21 3d 30 20 29 7b 0a 20 20 20 20  oding!=0 ){.    
4950: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
4960: 43 68 61 6e 67 65 45 6e 63 6f 64 69 6e 67 28 70  ChangeEncoding(p
4970: 56 61 72 2c 20 45 4e 43 28 70 2d 3e 64 62 29 29  Var, ENC(p->db))
4980: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
4990: 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e  c;.}.../*.** Bin
49a0: 64 20 61 20 62 6c 6f 62 20 76 61 6c 75 65 20 74  d a blob value t
49b0: 6f 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65  o an SQL stateme
49c0: 6e 74 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a  nt variable..*/.
49d0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
49e0: 5f 62 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33  _blob(.  sqlite3
49f0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20  _stmt *pStmt, . 
4a00: 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74   int i, .  const
4a10: 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20   void *zData, . 
4a20: 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76   int nData, .  v
4a30: 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64  oid (*xDel)(void
4a40: 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 62  *).){.  return b
4a50: 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69  indText(pStmt, i
4a60: 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20  , zData, nData, 
4a70: 78 44 65 6c 2c 20 30 29 3b 0a 7d 0a 69 6e 74 20  xDel, 0);.}.int 
4a80: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f 75  sqlite3_bind_dou
4a90: 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ble(sqlite3_stmt
4aa0: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20   *pStmt, int i, 
4ab0: 64 6f 75 62 6c 65 20 72 56 61 6c 75 65 29 7b 0a  double rValue){.
4ac0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65    int rc;.  Vdbe
4ad0: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
4ae0: 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65  tmt;.  rc = vdbe
4af0: 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20  Unbind(p, i);.  
4b00: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
4b10: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  K ){.    sqlite3
4b20: 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65  VdbeMemSetDouble
4b30: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20  (&p->aVar[i-1], 
4b40: 72 56 61 6c 75 65 29 3b 0a 20 20 7d 0a 20 20 72  rValue);.  }.  r
4b50: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
4b60: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74  sqlite3_bind_int
4b70: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
4b80: 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 69 56 61  , int i, int iVa
4b90: 6c 75 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  lue){.  return s
4ba0: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36  qlite3_bind_int6
4bb0: 34 28 70 2c 20 69 2c 20 28 69 36 34 29 69 56 61  4(p, i, (i64)iVa
4bc0: 6c 75 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69  lue);.}.int sqli
4bd0: 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34 28 73  te3_bind_int64(s
4be0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
4bf0: 6d 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c 69 74  mt, int i, sqlit
4c00: 65 5f 69 6e 74 36 34 20 69 56 61 6c 75 65 29 7b  e_int64 iValue){
4c10: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62  .  int rc;.  Vdb
4c20: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
4c30: 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62  Stmt;.  rc = vdb
4c40: 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20  eUnbind(p, i);. 
4c50: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
4c60: 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  OK ){.    sqlite
4c70: 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34  3VdbeMemSetInt64
4c80: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20  (&p->aVar[i-1], 
4c90: 69 56 61 6c 75 65 29 3b 0a 20 20 7d 0a 20 20 72  iValue);.  }.  r
4ca0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
4cb0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c  sqlite3_bind_nul
4cc0: 6c 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 20  l(sqlite3_stmt* 
4cd0: 70 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74  p, int i){.  ret
4ce0: 75 72 6e 20 76 64 62 65 55 6e 62 69 6e 64 28 28  urn vdbeUnbind((
4cf0: 56 64 62 65 20 2a 29 70 2c 20 69 29 3b 0a 7d 0a  Vdbe *)p, i);.}.
4d00: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
4d10: 5f 74 65 78 74 28 20 0a 20 20 73 71 6c 69 74 65  _text( .  sqlite
4d20: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a  3_stmt *pStmt, .
4d30: 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73    int i, .  cons
4d40: 74 20 63 68 61 72 20 2a 7a 44 61 74 61 2c 20 0a  t char *zData, .
4d50: 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20    int nData, .  
4d60: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
4d70: 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20  d*).){.  return 
4d80: 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20  bindText(pStmt, 
4d90: 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c  i, zData, nData,
4da0: 20 78 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55 54   xDel, SQLITE_UT
4db0: 46 38 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53  F8);.}.#ifndef S
4dc0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
4dd0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
4de0: 64 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69  d_text16(.  sqli
4df0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
4e00: 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f   .  int i, .  co
4e10: 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c  nst void *zData,
4e20: 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a   .  int nData, .
4e30: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76    void (*xDel)(v
4e40: 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72  oid*).){.  retur
4e50: 6e 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74  n bindText(pStmt
4e60: 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74  , i, zData, nDat
4e70: 61 2c 20 78 44 65 6c 2c 20 53 51 4c 49 54 45 5f  a, xDel, SQLITE_
4e80: 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a  UTF16NATIVE);.}.
4e90: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
4ea0: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a  _OMIT_UTF16 */..
4eb0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
4ec0: 20 6e 75 6d 62 65 72 20 6f 66 20 77 69 6c 64 63   number of wildc
4ed0: 61 72 64 73 20 74 68 61 74 20 63 61 6e 20 62 65  ards that can be
4ee0: 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 62 6f 75   potentially bou
4ef0: 6e 64 20 74 6f 2e 0a 2a 2a 20 54 68 69 73 20 72  nd to..** This r
4f00: 6f 75 74 69 6e 65 20 69 73 20 61 64 64 65 64 20  outine is added 
4f10: 74 6f 20 73 75 70 70 6f 72 74 20 44 42 44 3a 3a  to support DBD::
4f20: 53 51 4c 69 74 65 2e 20 20 0a 2a 2f 0a 69 6e 74  SQLite.  .*/.int
4f30: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61   sqlite3_bind_pa
4f40: 72 61 6d 65 74 65 72 5f 63 6f 75 6e 74 28 73 71  rameter_count(sq
4f50: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
4f60: 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  t){.  Vdbe *p = 
4f70: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20  (Vdbe*)pStmt;.  
4f80: 72 65 74 75 72 6e 20 70 20 3f 20 70 2d 3e 6e 56  return p ? p->nV
4f90: 61 72 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ar : 0;.}../*.**
4fa0: 20 43 72 65 61 74 65 20 61 20 6d 61 70 70 69 6e   Create a mappin
4fb0: 67 20 66 72 6f 6d 20 76 61 72 69 61 62 6c 65 20  g from variable 
4fc0: 6e 75 6d 62 65 72 73 20 74 6f 20 76 61 72 69 61  numbers to varia
4fd0: 62 6c 65 20 6e 61 6d 65 73 0a 2a 2a 20 69 6e 20  ble names.** in 
4fe0: 74 68 65 20 56 64 62 65 2e 61 7a 56 61 72 5b 5d  the Vdbe.azVar[]
4ff0: 20 61 72 72 61 79 2c 20 69 66 20 73 75 63 68 20   array, if such 
5000: 61 20 6d 61 70 70 69 6e 67 20 64 6f 65 73 20 6e  a mapping does n
5010: 6f 74 20 61 6c 72 65 61 64 79 0a 2a 2a 20 65 78  ot already.** ex
5020: 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ist..*/.static v
5030: 6f 69 64 20 63 72 65 61 74 65 56 61 72 4d 61 70  oid createVarMap
5040: 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 66 28  (Vdbe *p){.  if(
5050: 20 21 70 2d 3e 6f 6b 56 61 72 20 29 7b 0a 20 20   !p->okVar ){.  
5060: 20 20 69 6e 74 20 6a 3b 0a 20 20 20 20 4f 70 20    int j;.    Op 
5070: 2a 70 4f 70 3b 0a 20 20 20 20 66 6f 72 28 6a 3d  *pOp;.    for(j=
5080: 30 2c 20 70 4f 70 3d 70 2d 3e 61 4f 70 3b 20 6a  0, pOp=p->aOp; j
5090: 3c 70 2d 3e 6e 4f 70 3b 20 6a 2b 2b 2c 20 70 4f  <p->nOp; j++, pO
50a0: 70 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20  p++){.      if( 
50b0: 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f  pOp->opcode==OP_
50c0: 56 61 72 69 61 62 6c 65 20 29 7b 0a 20 20 20 20  Variable ){.    
50d0: 20 20 20 20 61 73 73 65 72 74 28 20 70 4f 70 2d      assert( pOp-
50e0: 3e 70 31 3e 30 20 26 26 20 70 4f 70 2d 3e 70 31  >p1>0 && pOp->p1
50f0: 3c 3d 70 2d 3e 6e 56 61 72 20 29 3b 0a 20 20 20  <=p->nVar );.   
5100: 20 20 20 20 20 70 2d 3e 61 7a 56 61 72 5b 70 4f       p->azVar[pO
5110: 70 2d 3e 70 31 2d 31 5d 20 3d 20 70 4f 70 2d 3e  p->p1-1] = pOp->
5120: 70 33 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  p3;.      }.    
5130: 7d 0a 20 20 20 20 70 2d 3e 6f 6b 56 61 72 20 3d  }.    p->okVar =
5140: 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a   1;.  }.}../*.**
5150: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65   Return the name
5160: 20 6f 66 20 61 20 77 69 6c 64 63 61 72 64 20 70   of a wildcard p
5170: 61 72 61 6d 65 74 65 72 2e 20 20 52 65 74 75 72  arameter.  Retur
5180: 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 20 69 6e  n NULL if the in
5190: 64 65 78 0a 2a 2a 20 69 73 20 6f 75 74 20 6f 66  dex.** is out of
51a0: 20 72 61 6e 67 65 20 6f 72 20 69 66 20 74 68 65   range or if the
51b0: 20 77 69 6c 64 63 61 72 64 20 69 73 20 75 6e 6e   wildcard is unn
51c0: 61 6d 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  amed..**.** The 
51d0: 72 65 73 75 6c 74 20 69 73 20 61 6c 77 61 79 73  result is always
51e0: 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e 73 74   UTF-8..*/.const
51f0: 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 62   char *sqlite3_b
5200: 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f 6e 61  ind_parameter_na
5210: 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  me(sqlite3_stmt 
5220: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a  *pStmt, int i){.
5230: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
5240: 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28 20  e*)pStmt;.  if( 
5250: 70 3d 3d 30 20 7c 7c 20 69 3c 31 20 7c 7c 20 69  p==0 || i<1 || i
5260: 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 20  >p->nVar ){.    
5270: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
5280: 63 72 65 61 74 65 56 61 72 4d 61 70 28 70 29 3b  createVarMap(p);
5290: 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 61 7a 56  .  return p->azV
52a0: 61 72 5b 69 2d 31 5d 3b 0a 7d 0a 0a 2f 2a 0a 2a  ar[i-1];.}../*.*
52b0: 2a 20 47 69 76 65 6e 20 61 20 77 69 6c 64 63 61  * Given a wildca
52c0: 72 64 20 70 61 72 61 6d 65 74 65 72 20 6e 61 6d  rd parameter nam
52d0: 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 69 6e  e, return the in
52e0: 64 65 78 20 6f 66 20 74 68 65 20 76 61 72 69 61  dex of the varia
52f0: 62 6c 65 0a 2a 2a 20 77 69 74 68 20 74 68 61 74  ble.** with that
5300: 20 6e 61 6d 65 2e 20 20 49 66 20 74 68 65 72 65   name.  If there
5310: 20 69 73 20 6e 6f 20 76 61 72 69 61 62 6c 65 20   is no variable 
5320: 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 6e  with the given n
5330: 61 6d 65 2c 0a 2a 2a 20 72 65 74 75 72 6e 20 30  ame,.** return 0
5340: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
5350: 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f  _bind_parameter_
5360: 69 6e 64 65 78 28 73 71 6c 69 74 65 33 5f 73 74  index(sqlite3_st
5370: 6d 74 20 2a 70 53 74 6d 74 2c 20 63 6f 6e 73 74  mt *pStmt, const
5380: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 29 7b 0a 20   char *zName){. 
5390: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
53a0: 2a 29 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20 69  *)pStmt;.  int i
53b0: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 7b 0a  ;.  if( p==0 ){.
53c0: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
53d0: 7d 0a 20 20 63 72 65 61 74 65 56 61 72 4d 61 70  }.  createVarMap
53e0: 28 70 29 3b 20 0a 20 20 69 66 28 20 7a 4e 61 6d  (p); .  if( zNam
53f0: 65 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30  e ){.    for(i=0
5400: 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b 20 69 2b 2b  ; i<p->nVar; i++
5410: 29 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 63  ){.      const c
5420: 68 61 72 20 2a 7a 20 3d 20 70 2d 3e 61 7a 56 61  har *z = p->azVa
5430: 72 5b 69 5d 3b 0a 20 20 20 20 20 20 69 66 28 20  r[i];.      if( 
5440: 7a 20 26 26 20 73 74 72 63 6d 70 28 7a 2c 7a 4e  z && strcmp(z,zN
5450: 61 6d 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20  ame)==0 ){.     
5460: 20 20 20 72 65 74 75 72 6e 20 69 2b 31 3b 0a 20     return i+1;. 
5470: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
5480: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a  .  return 0;.}..
5490: 2f 2a 0a 2a 2a 20 54 72 61 6e 73 66 65 72 20 61  /*.** Transfer a
54a0: 6c 6c 20 62 69 6e 64 69 6e 67 73 20 66 72 6f 6d  ll bindings from
54b0: 20 74 68 65 20 66 69 72 73 74 20 73 74 61 74 65   the first state
54c0: 6d 65 6e 74 20 6f 76 65 72 20 74 6f 20 74 68 65  ment over to the
54d0: 20 73 65 63 6f 6e 64 2e 0a 2a 2a 20 49 66 20 74   second..** If t
54e0: 68 65 20 74 77 6f 20 73 74 61 74 65 6d 65 6e 74  he two statement
54f0: 73 20 63 6f 6e 74 61 69 6e 20 61 20 64 69 66 66  s contain a diff
5500: 65 72 65 6e 74 20 6e 75 6d 62 65 72 20 6f 66 20  erent number of 
5510: 62 69 6e 64 69 6e 67 73 2c 20 74 68 65 6e 0a 2a  bindings, then.*
5520: 2a 20 61 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f  * an SQLITE_ERRO
5530: 52 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a  R is returned..*
5540: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 72  /.int sqlite3_tr
5550: 61 6e 73 66 65 72 5f 62 69 6e 64 69 6e 67 73 28  ansfer_bindings(
5560: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 46  sqlite3_stmt *pF
5570: 72 6f 6d 53 74 6d 74 2c 20 73 71 6c 69 74 65 33  romStmt, sqlite3
5580: 5f 73 74 6d 74 20 2a 70 54 6f 53 74 6d 74 29 7b  _stmt *pToStmt){
5590: 0a 20 20 56 64 62 65 20 2a 70 46 72 6f 6d 20 3d  .  Vdbe *pFrom =
55a0: 20 28 56 64 62 65 2a 29 70 46 72 6f 6d 53 74 6d   (Vdbe*)pFromStm
55b0: 74 3b 0a 20 20 56 64 62 65 20 2a 70 54 6f 20 3d  t;.  Vdbe *pTo =
55c0: 20 28 56 64 62 65 2a 29 70 54 6f 53 74 6d 74 3b   (Vdbe*)pToStmt;
55d0: 0a 20 20 69 6e 74 20 69 2c 20 72 63 20 3d 20 53  .  int i, rc = S
55e0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20  QLITE_OK;.  if( 
55f0: 28 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21 3d 56  (pFrom->magic!=V
5600: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26  DBE_MAGIC_RUN &&
5610: 20 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21 3d 56   pFrom->magic!=V
5620: 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 29 0a  DBE_MAGIC_HALT).
5630: 20 20 20 20 7c 7c 20 28 70 54 6f 2d 3e 6d 61 67      || (pTo->mag
5640: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52  ic!=VDBE_MAGIC_R
5650: 55 4e 20 26 26 20 70 54 6f 2d 3e 6d 61 67 69 63  UN && pTo->magic
5660: 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  !=VDBE_MAGIC_HAL
5670: 54 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  T) ){.    return
5680: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
5690: 20 20 7d 0a 20 20 69 66 28 20 70 46 72 6f 6d 2d    }.  if( pFrom-
56a0: 3e 6e 56 61 72 21 3d 70 54 6f 2d 3e 6e 56 61 72  >nVar!=pTo->nVar
56b0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
56c0: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d  QLITE_ERROR;.  }
56d0: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d  .  for(i=0; rc==
56e0: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 70  SQLITE_OK && i<p
56f0: 46 72 6f 6d 2d 3e 6e 56 61 72 3b 20 69 2b 2b 29  From->nVar; i++)
5700: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
5710: 65 33 56 64 62 65 4d 65 6d 4d 6f 76 65 28 26 70  e3VdbeMemMove(&p
5720: 54 6f 2d 3e 61 56 61 72 5b 69 5d 2c 20 26 70 46  To->aVar[i], &pF
5730: 72 6f 6d 2d 3e 61 56 61 72 5b 69 5d 29 3b 0a 20  rom->aVar[i]);. 
5740: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
5750: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
5760: 74 68 65 20 73 71 6c 69 74 65 33 2a 20 64 61 74  the sqlite3* dat
5770: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74 6f 20  abase handle to 
5780: 77 68 69 63 68 20 74 68 65 20 70 72 65 70 61 72  which the prepar
5790: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 67 69 76  ed statement giv
57a0: 65 6e 0a 2a 2a 20 69 6e 20 74 68 65 20 61 72 67  en.** in the arg
57b0: 75 6d 65 6e 74 20 62 65 6c 6f 6e 67 73 2e 20 20  ument belongs.  
57c0: 54 68 69 73 20 69 73 20 74 68 65 20 73 61 6d 65  This is the same
57d0: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
57e0: 20 74 68 61 74 20 77 61 73 0a 2a 2a 20 74 68 65   that was.** the
57f0: 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20   first argument 
5800: 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  to the sqlite3_p
5810: 72 65 70 61 72 65 28 29 20 74 68 61 74 20 77 61  repare() that wa
5820: 73 20 75 73 65 64 20 74 6f 20 63 72 65 61 74 65  s used to create
5830: 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 6d 65 6e  .** the statemen
5840: 74 20 69 6e 20 74 68 65 20 66 69 72 73 74 20 70  t in the first p
5850: 6c 61 63 65 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33  lace..*/.sqlite3
5860: 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 68 61 6e   *sqlite3_db_han
5870: 64 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  dle(sqlite3_stmt
5880: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 72 65 74 75   *pStmt){.  retu
5890: 72 6e 20 70 53 74 6d 74 20 3f 20 28 28 56 64 62  rn pStmt ? ((Vdb
58a0: 65 2a 29 70 53 74 6d 74 29 2d 3e 64 62 20 3a 20  e*)pStmt)->db : 
58b0: 30 3b 0a 7d 0a                                   0;.}.