/ Hex Artifact Content
Login

Artifact 6df708808458df837100521be72e728a581b5206:


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 63 68 61 72 20 2a 29 73 71 6c 69  onst char *)sqli
0780: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61  te3ValueText(pVa
0790: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b  l, SQLITE_UTF8);
07a0: 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  .}.#ifndef SQLIT
07b0: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e  E_OMIT_UTF16.con
07c0: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  st void *sqlite3
07d0: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 73 71  _value_text16(sq
07e0: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70 56 61  lite3_value* pVa
07f0: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
0800: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56  ite3ValueText(pV
0810: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  al, SQLITE_UTF16
0820: 4e 41 54 49 56 45 29 3b 0a 7d 0a 63 6f 6e 73 74  NATIVE);.}.const
0830: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76   void *sqlite3_v
0840: 61 6c 75 65 5f 74 65 78 74 31 36 62 65 28 73 71  alue_text16be(sq
0850: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
0860: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
0870: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56  ite3ValueText(pV
0880: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36  al, SQLITE_UTF16
0890: 42 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69  BE);.}.const voi
08a0: 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  d *sqlite3_value
08b0: 5f 74 65 78 74 31 36 6c 65 28 73 71 6c 69 74 65  _text16le(sqlite
08c0: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a  3_value *pVal){.
08d0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
08e0: 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20  ValueText(pVal, 
08f0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 29 3b  SQLITE_UTF16LE);
0900: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
0910: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
0920: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 61  /.int sqlite3_va
0930: 6c 75 65 5f 74 79 70 65 28 73 71 6c 69 74 65 33  lue_type(sqlite3
0940: 5f 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20  _value* pVal){. 
0950: 20 72 65 74 75 72 6e 20 70 56 61 6c 2d 3e 74 79   return pVal->ty
0960: 70 65 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a  pe;.}../********
0970: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0980: 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65 73  **** sqlite3_res
0990: 75 6c 74 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ult_  **********
09a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
09b0: 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c  *****.** The fol
09c0: 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20  lowing routines 
09d0: 61 72 65 20 75 73 65 64 20 62 79 20 75 73 65 72  are used by user
09e0: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f  -defined functio
09f0: 6e 73 20 74 6f 20 73 70 65 63 69 66 79 0a 2a 2a  ns to specify.**
0a00: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65   the function re
0a10: 73 75 6c 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  sult..*/.void sq
0a20: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 62 6c 6f  lite3_result_blo
0a30: 62 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  b(.  sqlite3_con
0a40: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63  text *pCtx, .  c
0a50: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20  onst void *z, . 
0a60: 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20   int n, .  void 
0a70: 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a  (*xDel)(void *).
0a80: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 6e 3e 3d  ){.  assert( n>=
0a90: 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  0 );.  sqlite3Vd
0aa0: 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74  beMemSetStr(&pCt
0ab0: 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 30 2c 20 78  x->s, z, n, 0, x
0ac0: 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  Del);.}.void sql
0ad0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62  ite3_result_doub
0ae0: 6c 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  le(sqlite3_conte
0af0: 78 74 20 2a 70 43 74 78 2c 20 64 6f 75 62 6c 65  xt *pCtx, double
0b00: 20 72 56 61 6c 29 7b 0a 20 20 73 71 6c 69 74 65   rVal){.  sqlite
0b10: 33 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c  3VdbeMemSetDoubl
0b20: 65 28 26 70 43 74 78 2d 3e 73 2c 20 72 56 61 6c  e(&pCtx->s, rVal
0b30: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
0b40: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 73  3_result_error(s
0b50: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0b60: 70 43 74 78 2c 20 63 6f 6e 73 74 20 63 68 61 72  pCtx, const char
0b70: 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 70   *z, int n){.  p
0b80: 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 31  Ctx->isError = 1
0b90: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ;.  sqlite3VdbeM
0ba0: 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e  emSetStr(&pCtx->
0bb0: 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f  s, z, n, SQLITE_
0bc0: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 54 52 41  UTF8, SQLITE_TRA
0bd0: 4e 53 49 45 4e 54 29 3b 0a 7d 0a 76 6f 69 64 20  NSIENT);.}.void 
0be0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65  sqlite3_result_e
0bf0: 72 72 6f 72 31 36 28 73 71 6c 69 74 65 33 5f 63  rror16(sqlite3_c
0c00: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f  ontext *pCtx, co
0c10: 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 69 6e 74  nst void *z, int
0c20: 20 6e 29 7b 0a 20 20 70 43 74 78 2d 3e 69 73 45   n){.  pCtx->isE
0c30: 72 72 6f 72 20 3d 20 31 3b 0a 20 20 73 71 6c 69  rror = 1;.  sqli
0c40: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72  te3VdbeMemSetStr
0c50: 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c  (&pCtx->s, z, n,
0c60: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
0c70: 49 56 45 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e  IVE, SQLITE_TRAN
0c80: 53 49 45 4e 54 29 3b 0a 7d 0a 76 6f 69 64 20 73  SIENT);.}.void s
0c90: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e  qlite3_result_in
0ca0: 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  t(sqlite3_contex
0cb0: 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 69 56 61  t *pCtx, int iVa
0cc0: 6c 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  l){.  sqlite3Vdb
0cd0: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 26 70 43  eMemSetInt64(&pC
0ce0: 74 78 2d 3e 73 2c 20 28 69 36 34 29 69 56 61 6c  tx->s, (i64)iVal
0cf0: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
0d00: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 28 73  3_result_int64(s
0d10: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0d20: 70 43 74 78 2c 20 69 36 34 20 69 56 61 6c 29 7b  pCtx, i64 iVal){
0d30: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
0d40: 6d 53 65 74 49 6e 74 36 34 28 26 70 43 74 78 2d  mSetInt64(&pCtx-
0d50: 3e 73 2c 20 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69  >s, iVal);.}.voi
0d60: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
0d70: 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f 63 6f  _null(sqlite3_co
0d80: 6e 74 65 78 74 20 2a 70 43 74 78 29 7b 0a 20 20  ntext *pCtx){.  
0d90: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
0da0: 74 4e 75 6c 6c 28 26 70 43 74 78 2d 3e 73 29 3b  tNull(&pCtx->s);
0db0: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0dc0: 72 65 73 75 6c 74 5f 74 65 78 74 28 0a 20 20 73  result_text(.  s
0dd0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
0de0: 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 63  pCtx, .  const c
0df0: 68 61 72 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e  har *z, .  int n
0e00: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29  ,.  void (*xDel)
0e10: 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 73 71  (void *).){.  sq
0e20: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
0e30: 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20  tr(&pCtx->s, z, 
0e40: 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20  n, SQLITE_UTF8, 
0e50: 78 44 65 6c 29 3b 0a 7d 0a 23 69 66 6e 64 65 66  xDel);.}.#ifndef
0e60: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
0e70: 31 36 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  16.void sqlite3_
0e80: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 28 0a 20  result_text16(. 
0e90: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
0ea0: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74   *pCtx, .  const
0eb0: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74   void *z, .  int
0ec0: 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44   n, .  void (*xD
0ed0: 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20  el)(void *).){. 
0ee0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
0ef0: 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20  etStr(&pCtx->s, 
0f00: 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46  z, n, SQLITE_UTF
0f10: 31 36 4e 41 54 49 56 45 2c 20 78 44 65 6c 29 3b  16NATIVE, xDel);
0f20: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
0f30: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 62 65 28  result_text16be(
0f40: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
0f50: 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e  xt *pCtx, .  con
0f60: 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69  st void *z, .  i
0f70: 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a  nt n, .  void (*
0f80: 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b  xDel)(void *).){
0f90: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
0fa0: 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73  mSetStr(&pCtx->s
0fb0: 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55  , z, n, SQLITE_U
0fc0: 54 46 31 36 42 45 2c 20 78 44 65 6c 29 3b 0a 7d  TF16BE, xDel);.}
0fd0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
0fe0: 73 75 6c 74 5f 74 65 78 74 31 36 6c 65 28 0a 20  sult_text16le(. 
0ff0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74   sqlite3_context
1000: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74   *pCtx, .  const
1010: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74   void *z, .  int
1020: 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44   n, .  void (*xD
1030: 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20  el)(void *).){. 
1040: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
1050: 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20  etStr(&pCtx->s, 
1060: 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46  z, n, SQLITE_UTF
1070: 31 36 4c 45 2c 20 78 44 65 6c 29 3b 0a 7d 0a 23  16LE, xDel);.}.#
1080: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
1090: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 76 6f  OMIT_UTF16 */.vo
10a0: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
10b0: 74 5f 76 61 6c 75 65 28 73 71 6c 69 74 65 33 5f  t_value(sqlite3_
10c0: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 73  context *pCtx, s
10d0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
10e0: 61 6c 75 65 29 7b 0a 20 20 73 71 6c 69 74 65 33  alue){.  sqlite3
10f0: 56 64 62 65 4d 65 6d 43 6f 70 79 28 26 70 43 74  VdbeMemCopy(&pCt
1100: 78 2d 3e 73 2c 20 70 56 61 6c 75 65 29 3b 0a 7d  x->s, pValue);.}
1110: 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 65  .../*.** Execute
1120: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70   the statement p
1130: 53 74 6d 74 2c 20 65 69 74 68 65 72 20 75 6e 74  Stmt, either unt
1140: 69 6c 20 61 20 72 6f 77 20 6f 66 20 64 61 74 61  il a row of data
1150: 20 69 73 20 72 65 61 64 79 2c 20 74 68 65 0a 2a   is ready, the.*
1160: 2a 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 63  * statement is c
1170: 6f 6d 70 6c 65 74 65 6c 79 20 65 78 65 63 75 74  ompletely execut
1180: 65 64 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 6f  ed or an error o
1190: 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ccurs..*/.int sq
11a0: 6c 69 74 65 33 5f 73 74 65 70 28 73 71 6c 69 74  lite3_step(sqlit
11b0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
11c0: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
11d0: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 73 71 6c  be*)pStmt;.  sql
11e0: 69 74 65 33 20 2a 64 62 3b 0a 20 20 69 6e 74 20  ite3 *db;.  int 
11f0: 72 63 3b 0a 0a 20 20 69 66 28 20 70 3d 3d 30 20  rc;..  if( p==0 
1200: 7c 7c 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42  || p->magic!=VDB
1210: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 7b 0a 20  E_MAGIC_RUN ){. 
1220: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
1230: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69  _MISUSE;.  }.  i
1240: 66 28 20 70 2d 3e 61 62 6f 72 74 65 64 20 29 7b  f( p->aborted ){
1250: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
1260: 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d 0a 20 20  TE_ABORT;.  }.  
1270: 69 66 28 20 70 2d 3e 70 63 3c 3d 30 20 26 26 20  if( p->pc<=0 && 
1280: 70 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a 20 20  p->expired ){.  
1290: 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c    if( p->rc==SQL
12a0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
12b0: 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 53  p->rc = SQLITE_S
12c0: 43 48 45 4d 41 3b 0a 20 20 20 20 7d 0a 20 20 20  CHEMA;.    }.   
12d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
12e0: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 64 62 20 3d  RROR;.  }.  db =
12f0: 20 70 2d 3e 64 62 3b 0a 20 20 69 66 28 20 73 71   p->db;.  if( sq
1300: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
1310: 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d  ) ){.    p->rc =
1320: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
1330: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
1340: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
1350: 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 23  if( p->pc<0 ){.#
1360: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
1370: 49 54 5f 54 52 41 43 45 0a 20 20 20 20 2f 2a 20  IT_TRACE.    /* 
1380: 49 6e 76 6f 6b 65 20 74 68 65 20 74 72 61 63 65  Invoke the trace
1390: 20 63 61 6c 6c 62 61 63 6b 20 69 66 20 74 68 65   callback if the
13a0: 72 65 20 69 73 20 6f 6e 65 0a 20 20 20 20 2a 2f  re is one.    */
13b0: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 78 54 72  .    if( db->xTr
13c0: 61 63 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 74  ace && !db->init
13d0: 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20 61  .busy ){.      a
13e0: 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20  ssert( p->nOp>0 
13f0: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  );.      assert(
1400: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31   p->aOp[p->nOp-1
1410: 5d 2e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f  ].opcode==OP_Noo
1420: 70 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72  p );.      asser
1430: 74 28 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70  t( p->aOp[p->nOp
1440: 2d 31 5d 2e 70 33 21 3d 30 20 29 3b 0a 20 20 20  -1].p3!=0 );.   
1450: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f     assert( p->aO
1460: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 74 79  p[p->nOp-1].p3ty
1470: 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29  pe==P3_DYNAMIC )
1480: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53  ;.      sqlite3S
1490: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20  afetyOff(db);.  
14a0: 20 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28 64      db->xTrace(d
14b0: 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 70 2d  b->pTraceArg, p-
14c0: 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70  >aOp[p->nOp-1].p
14d0: 33 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 71  3);.      if( sq
14e0: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62  lite3SafetyOn(db
14f0: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e  ) ){.        p->
1500: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55  rc = SQLITE_MISU
1510: 53 45 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75  SE;.        retu
1520: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
1530: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
1540: 20 20 20 20 69 66 28 20 64 62 2d 3e 78 50 72 6f      if( db->xPro
1550: 66 69 6c 65 20 26 26 20 21 64 62 2d 3e 69 6e 69  file && !db->ini
1560: 74 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20  t.busy ){.      
1570: 64 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a 20 20 20  double rNow;.   
1580: 20 20 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72     sqlite3OsCurr
1590: 65 6e 74 54 69 6d 65 28 26 72 4e 6f 77 29 3b 0a  entTime(&rNow);.
15a0: 20 20 20 20 20 20 70 2d 3e 73 74 61 72 74 54 69        p->startTi
15b0: 6d 65 20 3d 20 28 72 4e 6f 77 20 2d 20 28 69 6e  me = (rNow - (in
15c0: 74 29 72 4e 6f 77 29 2a 33 36 30 30 2e 30 2a 32  t)rNow)*3600.0*2
15d0: 34 2e 30 2a 31 30 30 30 30 30 30 30 30 30 2e 30  4.0*1000000000.0
15e0: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a  ;.    }.#endif..
15f0: 20 20 20 20 2f 2a 20 50 72 69 6e 74 20 61 20 63      /* Print a c
1600: 6f 70 79 20 6f 66 20 53 51 4c 20 61 73 20 69 74  opy of SQL as it
1610: 20 69 73 20 65 78 65 63 75 74 65 64 20 69 66 20   is executed if 
1620: 74 68 65 20 53 51 4c 5f 54 52 41 43 45 20 70 72  the SQL_TRACE pr
1630: 61 67 6d 61 20 69 73 20 74 75 72 6e 65 64 0a 20  agma is turned. 
1640: 20 20 20 2a 2a 20 6f 6e 20 69 6e 20 64 65 62 75     ** on in debu
1650: 67 67 69 6e 67 20 6d 6f 64 65 2e 0a 20 20 20 20  gging mode..    
1660: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  */.#ifdef SQLITE
1670: 5f 44 45 42 55 47 0a 20 20 20 20 69 66 28 20 28  _DEBUG.    if( (
1680: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
1690: 54 45 5f 53 71 6c 54 72 61 63 65 29 21 3d 30 20  TE_SqlTrace)!=0 
16a0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
16b0: 44 65 62 75 67 50 72 69 6e 74 66 28 22 53 51 4c  DebugPrintf("SQL
16c0: 2d 74 72 61 63 65 3a 20 25 73 5c 6e 22 2c 20 70  -trace: %s\n", p
16d0: 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e  ->aOp[p->nOp-1].
16e0: 70 33 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69  p3);.    }.#endi
16f0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55  f /* SQLITE_DEBU
1700: 47 20 2a 2f 0a 0a 20 20 20 20 64 62 2d 3e 61 63  G */..    db->ac
1710: 74 69 76 65 56 64 62 65 43 6e 74 2b 2b 3b 0a 20  tiveVdbeCnt++;. 
1720: 20 20 20 70 2d 3e 70 63 20 3d 20 30 3b 0a 20 20     p->pc = 0;.  
1730: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
1740: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20  _OMIT_EXPLAIN.  
1750: 69 66 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29  if( p->explain )
1760: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
1770: 65 33 56 64 62 65 4c 69 73 74 28 70 29 3b 0a 20  e3VdbeList(p);. 
1780: 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 20 2f 2a   }else.#endif /*
1790: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50   SQLITE_OMIT_EXP
17a0: 4c 41 49 4e 20 2a 2f 0a 20 20 7b 0a 20 20 20 20  LAIN */.  {.    
17b0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
17c0: 45 78 65 63 28 70 29 3b 0a 20 20 7d 0a 0a 20 20  Exec(p);.  }..  
17d0: 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74  if( sqlite3Safet
17e0: 79 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20  yOff(db) ){.    
17f0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55  rc = SQLITE_MISU
1800: 53 45 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66  SE;.  }..#ifndef
1810: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41   SQLITE_OMIT_TRA
1820: 43 45 0a 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74  CE.  /* Invoke t
1830: 68 65 20 70 72 6f 66 69 6c 65 20 63 61 6c 6c 62  he profile callb
1840: 61 63 6b 20 69 66 20 74 68 65 72 65 20 69 73 20  ack if there is 
1850: 6f 6e 65 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72  one.  */.  if( r
1860: 63 21 3d 53 51 4c 49 54 45 5f 52 4f 57 20 26 26  c!=SQLITE_ROW &&
1870: 20 64 62 2d 3e 78 50 72 6f 66 69 6c 65 20 26 26   db->xProfile &&
1880: 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20   !db->init.busy 
1890: 29 7b 0a 20 20 20 20 64 6f 75 62 6c 65 20 72 4e  ){.    double rN
18a0: 6f 77 3b 0a 20 20 20 20 75 36 34 20 65 6c 61 70  ow;.    u64 elap
18b0: 73 65 54 69 6d 65 3b 0a 0a 20 20 20 20 73 71 6c  seTime;..    sql
18c0: 69 74 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d  ite3OsCurrentTim
18d0: 65 28 26 72 4e 6f 77 29 3b 0a 20 20 20 20 65 6c  e(&rNow);.    el
18e0: 61 70 73 65 54 69 6d 65 20 3d 20 28 72 4e 6f 77  apseTime = (rNow
18f0: 20 2d 20 28 69 6e 74 29 72 4e 6f 77 29 2a 33 36   - (int)rNow)*36
1900: 30 30 2e 30 2a 32 34 2e 30 2a 31 30 30 30 30 30  00.0*24.0*100000
1910: 30 30 30 30 2e 30 20 2d 20 70 2d 3e 73 74 61 72  0000.0 - p->star
1920: 74 54 69 6d 65 3b 0a 20 20 20 20 61 73 73 65 72  tTime;.    asser
1930: 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 20  t( p->nOp>0 );. 
1940: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f     assert( p->aO
1950: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 6f 70 63 6f  p[p->nOp-1].opco
1960: 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 3b 0a 20  de==OP_Noop );. 
1970: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f     assert( p->aO
1980: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 21 3d  p[p->nOp-1].p3!=
1990: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  0 );.    assert(
19a0: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31   p->aOp[p->nOp-1
19b0: 5d 2e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e  ].p3type==P3_DYN
19c0: 41 4d 49 43 20 29 3b 0a 20 20 20 20 64 62 2d 3e  AMIC );.    db->
19d0: 78 50 72 6f 66 69 6c 65 28 64 62 2d 3e 70 50 72  xProfile(db->pPr
19e0: 6f 66 69 6c 65 41 72 67 2c 20 70 2d 3e 61 4f 70  ofileArg, p->aOp
19f0: 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 2c 20 65  [p->nOp-1].p3, e
1a00: 6c 61 70 73 65 54 69 6d 65 29 3b 0a 20 20 7d 0a  lapseTime);.  }.
1a10: 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65  #endif..  sqlite
1a20: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 72 63  3Error(p->db, rc
1a30: 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3f 20 22  , p->zErrMsg ? "
1a40: 25 73 22 20 3a 20 30 2c 20 70 2d 3e 7a 45 72 72  %s" : 0, p->zErr
1a50: 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  Msg);.  return r
1a60: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72  c;.}../*.** Extr
1a70: 61 63 74 20 74 68 65 20 75 73 65 72 20 64 61 74  act the user dat
1a80: 61 20 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33  a from a sqlite3
1a90: 5f 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75  _context structu
1aa0: 72 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a  re and return a.
1ab0: 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74  ** pointer to it
1ac0: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
1ad0: 65 33 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c  e3_user_data(sql
1ae0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29  ite3_context *p)
1af0: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26  {.  assert( p &&
1b00: 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72   p->pFunc );.  r
1b10: 65 74 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e  eturn p->pFunc->
1b20: 70 55 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a  pUserData;.}../*
1b30: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72 20  .** Allocate or 
1b40: 72 65 74 75 72 6e 20 74 68 65 20 61 67 67 72 65  return the aggre
1b50: 67 61 74 65 20 63 6f 6e 74 65 78 74 20 66 6f 72  gate context for
1b60: 20 61 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e   a user function
1b70: 2e 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74  .  A new.** cont
1b80: 65 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64  ext is allocated
1b90: 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 63 61   on the first ca
1ba0: 6c 6c 2e 20 20 53 75 62 73 65 71 75 65 6e 74 20  ll.  Subsequent 
1bb0: 63 61 6c 6c 73 20 72 65 74 75 72 6e 20 74 68 65  calls return the
1bc0: 0a 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78 74  .** same context
1bd0: 20 74 68 61 74 20 77 61 73 20 72 65 74 75 72 6e   that was return
1be0: 65 64 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c 6c  ed on prior call
1bf0: 73 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69  s..*/.void *sqli
1c00: 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f  te3_aggregate_co
1c10: 6e 74 65 78 74 28 73 71 6c 69 74 65 33 5f 63 6f  ntext(sqlite3_co
1c20: 6e 74 65 78 74 20 2a 70 2c 20 69 6e 74 20 6e 42  ntext *p, int nB
1c30: 79 74 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20  yte){.  assert( 
1c40: 70 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 26 26  p && p->pFunc &&
1c50: 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 53 74 65 70   p->pFunc->xStep
1c60: 20 29 3b 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20   );.  Mem *pMem 
1c70: 3d 20 70 2d 3e 70 4d 65 6d 3b 0a 20 20 69 66 28  = p->pMem;.  if(
1c80: 20 28 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20   (pMem->flags & 
1c90: 4d 45 4d 5f 41 67 67 29 3d 3d 30 20 29 7b 0a 20  MEM_Agg)==0 ){. 
1ca0: 20 20 20 69 66 28 20 6e 42 79 74 65 3d 3d 30 20     if( nByte==0 
1cb0: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  ){.      assert(
1cc0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 3d 3d 4d 45   pMem->flags==ME
1cd0: 4d 5f 4e 75 6c 6c 20 29 3b 0a 20 20 20 20 20 20  M_Null );.      
1ce0: 70 4d 65 6d 2d 3e 7a 20 3d 20 30 3b 0a 20 20 20  pMem->z = 0;.   
1cf0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4d   }else{.      pM
1d00: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
1d10: 41 67 67 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  Agg;.      pMem-
1d20: 3e 78 44 65 6c 20 3d 20 73 71 6c 69 74 65 33 46  >xDel = sqlite3F
1d30: 72 65 65 58 3b 0a 20 20 20 20 20 20 2a 28 46 75  reeX;.      *(Fu
1d40: 6e 63 44 65 66 2a 2a 29 26 70 4d 65 6d 2d 3e 69  ncDef**)&pMem->i
1d50: 20 3d 20 70 2d 3e 70 46 75 6e 63 3b 0a 20 20 20   = p->pFunc;.   
1d60: 20 20 20 69 66 28 20 6e 42 79 74 65 3c 3d 4e 42     if( nByte<=NB
1d70: 46 53 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4d  FS ){.        pM
1d80: 65 6d 2d 3e 7a 20 3d 20 70 4d 65 6d 2d 3e 7a 53  em->z = pMem->zS
1d90: 68 6f 72 74 3b 0a 20 20 20 20 20 20 20 20 6d 65  hort;.        me
1da0: 6d 73 65 74 28 70 4d 65 6d 2d 3e 7a 2c 20 30 2c  mset(pMem->z, 0,
1db0: 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 7d   nByte);.      }
1dc0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d  else{.        pM
1dd0: 65 6d 2d 3e 7a 20 3d 20 73 71 6c 69 74 65 4d 61  em->z = sqliteMa
1de0: 6c 6c 6f 63 28 20 6e 42 79 74 65 20 29 3b 0a 20  lloc( nByte );. 
1df0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
1e00: 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 2a  .  return (void*
1e10: 29 70 4d 65 6d 2d 3e 7a 3b 0a 7d 0a 0a 2f 2a 0a  )pMem->z;.}../*.
1e20: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61 75  ** Return the au
1e30: 78 69 6c 61 72 79 20 64 61 74 61 20 70 6f 69 6e  xilary data poin
1e40: 74 65 72 2c 20 69 66 20 61 6e 79 2c 20 66 6f 72  ter, if any, for
1e50: 20 74 68 65 20 69 41 72 67 27 74 68 20 61 72 67   the iArg'th arg
1e60: 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20  ument to.** the 
1e70: 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65  user-function de
1e80: 66 69 6e 65 64 20 62 79 20 70 43 74 78 2e 0a 2a  fined by pCtx..*
1e90: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
1ea0: 67 65 74 5f 61 75 78 64 61 74 61 28 73 71 6c 69  get_auxdata(sqli
1eb0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
1ec0: 78 2c 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 20  x, int iArg){.  
1ed0: 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46  VdbeFunc *pVdbeF
1ee0: 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62  unc = pCtx->pVdb
1ef0: 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56  eFunc;.  if( !pV
1f00: 64 62 65 46 75 6e 63 20 7c 7c 20 69 41 72 67 3e  dbeFunc || iArg>
1f10: 3d 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78  =pVdbeFunc->nAux
1f20: 20 7c 7c 20 69 41 72 67 3c 30 20 29 7b 0a 20 20   || iArg<0 ){.  
1f30: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
1f40: 20 20 72 65 74 75 72 6e 20 70 56 64 62 65 46 75    return pVdbeFu
1f50: 6e 63 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d 2e  nc->apAux[iArg].
1f60: 70 41 75 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  pAux;.}../*.** S
1f70: 65 74 20 74 68 65 20 61 75 78 69 6c 61 72 79 20  et the auxilary 
1f80: 64 61 74 61 20 70 6f 69 6e 74 65 72 20 61 6e 64  data pointer and
1f90: 20 64 65 6c 65 74 65 20 66 75 6e 63 74 69 6f 6e   delete function
1fa0: 2c 20 66 6f 72 20 74 68 65 20 69 41 72 67 27 74  , for the iArg't
1fb0: 68 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f  h.** argument to
1fc0: 20 74 68 65 20 75 73 65 72 2d 66 75 6e 63 74 69   the user-functi
1fd0: 6f 6e 20 64 65 66 69 6e 65 64 20 62 79 20 70 43  on defined by pC
1fe0: 74 78 2e 20 41 6e 79 20 70 72 65 76 69 6f 75 73  tx. Any previous
1ff0: 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 64 65 6c   value is.** del
2000: 65 74 65 64 20 62 79 20 63 61 6c 6c 69 6e 67 20  eted by calling 
2010: 74 68 65 20 64 65 6c 65 74 65 20 66 75 6e 63 74  the delete funct
2020: 69 6f 6e 20 73 70 65 63 69 66 69 65 64 20 77 68  ion specified wh
2030: 65 6e 20 69 74 20 77 61 73 20 73 65 74 2e 0a 2a  en it was set..*
2040: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73  /.void sqlite3_s
2050: 65 74 5f 61 75 78 64 61 74 61 28 0a 20 20 73 71  et_auxdata(.  sq
2060: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
2070: 43 74 78 2c 20 0a 20 20 69 6e 74 20 69 41 72 67  Ctx, .  int iArg
2080: 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c  , .  void *pAux,
2090: 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 65   .  void (*xDele
20a0: 74 65 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20  te)(void*).){.  
20b0: 73 74 72 75 63 74 20 41 75 78 44 61 74 61 20 2a  struct AuxData *
20c0: 70 41 75 78 44 61 74 61 3b 0a 20 20 56 64 62 65  pAuxData;.  Vdbe
20d0: 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 3b  Func *pVdbeFunc;
20e0: 0a 20 20 69 66 28 20 69 41 72 67 3c 30 20 29 20  .  if( iArg<0 ) 
20f0: 72 65 74 75 72 6e 3b 0a 0a 20 20 70 56 64 62 65  return;..  pVdbe
2100: 46 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64  Func = pCtx->pVd
2110: 62 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70  beFunc;.  if( !p
2120: 56 64 62 65 46 75 6e 63 20 7c 7c 20 70 56 64 62  VdbeFunc || pVdb
2130: 65 46 75 6e 63 2d 3e 6e 41 75 78 3c 3d 69 41 72  eFunc->nAux<=iAr
2140: 67 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 4d 61  g ){.    int nMa
2150: 6c 6c 6f 63 20 3d 20 73 69 7a 65 6f 66 28 56 64  lloc = sizeof(Vd
2160: 62 65 46 75 6e 63 29 20 2b 20 73 69 7a 65 6f 66  beFunc) + sizeof
2170: 28 73 74 72 75 63 74 20 41 75 78 44 61 74 61 29  (struct AuxData)
2180: 2a 69 41 72 67 3b 0a 20 20 20 20 70 43 74 78 2d  *iArg;.    pCtx-
2190: 3e 70 56 64 62 65 46 75 6e 63 20 3d 20 70 56 64  >pVdbeFunc = pVd
21a0: 62 65 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 52  beFunc = sqliteR
21b0: 65 61 6c 6c 6f 63 28 70 56 64 62 65 46 75 6e 63  ealloc(pVdbeFunc
21c0: 2c 20 6e 4d 61 6c 6c 6f 63 29 3b 0a 20 20 20 20  , nMalloc);.    
21d0: 69 66 28 20 21 70 56 64 62 65 46 75 6e 63 20 29  if( !pVdbeFunc )
21e0: 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 6d 65 6d   return;.    mem
21f0: 73 65 74 28 26 70 56 64 62 65 46 75 6e 63 2d 3e  set(&pVdbeFunc->
2200: 61 70 41 75 78 5b 70 56 64 62 65 46 75 6e 63 2d  apAux[pVdbeFunc-
2210: 3e 6e 41 75 78 5d 2c 20 30 2c 20 0a 20 20 20 20  >nAux], 0, .    
2220: 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28           sizeof(
2230: 73 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a  struct AuxData)*
2240: 28 69 41 72 67 2b 31 2d 70 56 64 62 65 46 75 6e  (iArg+1-pVdbeFun
2250: 63 2d 3e 6e 41 75 78 29 29 3b 0a 20 20 20 20 70  c->nAux));.    p
2260: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3d  VdbeFunc->nAux =
2270: 20 69 41 72 67 2b 31 3b 0a 20 20 20 20 70 56 64   iArg+1;.    pVd
2280: 62 65 46 75 6e 63 2d 3e 70 46 75 6e 63 20 3d 20  beFunc->pFunc = 
2290: 70 43 74 78 2d 3e 70 46 75 6e 63 3b 0a 20 20 7d  pCtx->pFunc;.  }
22a0: 0a 0a 20 20 70 41 75 78 44 61 74 61 20 3d 20 26  ..  pAuxData = &
22b0: 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41 75 78  pVdbeFunc->apAux
22c0: 5b 69 41 72 67 5d 3b 0a 20 20 69 66 28 20 70 41  [iArg];.  if( pA
22d0: 75 78 44 61 74 61 2d 3e 70 41 75 78 20 26 26 20  uxData->pAux && 
22e0: 70 41 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74  pAuxData->xDelet
22f0: 65 20 29 7b 0a 20 20 20 20 70 41 75 78 44 61 74  e ){.    pAuxDat
2300: 61 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78 44  a->xDelete(pAuxD
2310: 61 74 61 2d 3e 70 41 75 78 29 3b 0a 20 20 7d 0a  ata->pAux);.  }.
2320: 20 20 70 41 75 78 44 61 74 61 2d 3e 70 41 75 78    pAuxData->pAux
2330: 20 3d 20 70 41 75 78 3b 0a 20 20 70 41 75 78 44   = pAux;.  pAuxD
2340: 61 74 61 2d 3e 78 44 65 6c 65 74 65 20 3d 20 78  ata->xDelete = x
2350: 44 65 6c 65 74 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Delete;.}../*.**
2360: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62   Return the numb
2370: 65 72 20 6f 66 20 74 69 6d 65 73 20 74 68 65 20  er of times the 
2380: 53 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 6f 66  Step function of
2390: 20 61 20 61 67 67 72 65 67 61 74 65 20 68 61 73   a aggregate has
23a0: 20 62 65 65 6e 20 0a 2a 2a 20 63 61 6c 6c 65 64   been .** called
23b0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ..**.** This rou
23c0: 74 69 6e 65 20 69 73 20 64 65 66 69 6e 65 64 20  tine is defined 
23d0: 68 65 72 65 20 69 6e 20 76 64 62 65 2e 63 20 62  here in vdbe.c b
23e0: 65 63 61 75 73 65 20 69 74 20 64 65 70 65 6e 64  ecause it depend
23f0: 73 20 6f 6e 20 6b 6e 6f 77 69 6e 67 0a 2a 2a 20  s on knowing.** 
2400: 74 68 65 20 69 6e 74 65 72 6e 61 6c 73 20 6f 66  the internals of
2410: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6e   the sqlite3_con
2420: 74 65 78 74 20 73 74 72 75 63 74 75 72 65 20 77  text structure w
2430: 68 69 63 68 20 69 73 20 6f 6e 6c 79 20 64 65 66  hich is only def
2440: 69 6e 65 64 20 69 6e 0a 2a 2a 20 74 68 69 73 20  ined in.** this 
2450: 73 6f 75 72 63 65 20 66 69 6c 65 2e 0a 2a 2f 0a  source file..*/.
2460: 69 6e 74 20 73 71 6c 69 74 65 33 5f 61 67 67 72  int sqlite3_aggr
2470: 65 67 61 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69  egate_count(sqli
2480: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b  te3_context *p){
2490: 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20  .  assert( p && 
24a0: 70 2d 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e 70  p->pFunc && p->p
24b0: 46 75 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a 20  Func->xStep );. 
24c0: 20 72 65 74 75 72 6e 20 70 2d 3e 70 4d 65 6d 2d   return p->pMem-
24d0: 3e 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  >n;.}../*.** Ret
24e0: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
24f0: 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65  f columns in the
2500: 20 72 65 73 75 6c 74 20 73 65 74 20 66 6f 72 20   result set for 
2510: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53  the statement pS
2520: 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  tmt..*/.int sqli
2530: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74  te3_column_count
2540: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
2550: 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70  Stmt){.  Vdbe *p
2560: 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74  Vm = (Vdbe *)pSt
2570: 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d  mt;.  return pVm
2580: 20 3f 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75   ? pVm->nResColu
2590: 6d 6e 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  mn : 0;.}../*.**
25a0: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62   Return the numb
25b0: 65 72 20 6f 66 20 76 61 6c 75 65 73 20 61 76 61  er of values ava
25c0: 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20  ilable from the 
25d0: 63 75 72 72 65 6e 74 20 72 6f 77 20 6f 66 20 74  current row of t
25e0: 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20  he.** currently 
25f0: 65 78 65 63 75 74 69 6e 67 20 73 74 61 74 65 6d  executing statem
2600: 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e  ent pStmt..*/.in
2610: 74 20 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 63  t sqlite3_data_c
2620: 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  ount(sqlite3_stm
2630: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62  t *pStmt){.  Vdb
2640: 65 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a  e *pVm = (Vdbe *
2650: 29 70 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 56  )pStmt;.  if( pV
2660: 6d 3d 3d 30 20 7c 7c 20 21 70 56 6d 2d 3e 72 65  m==0 || !pVm->re
2670: 73 4f 6e 53 74 61 63 6b 20 29 20 72 65 74 75 72  sOnStack ) retur
2680: 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 56  n 0;.  return pV
2690: 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d  m->nResColumn;.}
26a0: 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74  .../*.** Check t
26b0: 6f 20 73 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20  o see if column 
26c0: 69 43 6f 6c 20 6f 66 20 74 68 65 20 67 69 76 65  iCol of the give
26d0: 6e 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 76  n statement is v
26e0: 61 6c 69 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20  alid.  If.** it 
26f0: 69 73 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69  is, return a poi
2700: 6e 74 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 20  nter to the Mem 
2710: 66 6f 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66  for the value of
2720: 20 74 68 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a   that column..**
2730: 20 49 66 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20   If iCol is not 
2740: 76 61 6c 69 64 2c 20 72 65 74 75 72 6e 20 61 20  valid, return a 
2750: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d  pointer to a Mem
2760: 20 77 68 69 63 68 20 68 61 73 20 61 20 76 61 6c   which has a val
2770: 75 65 0a 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a  ue.** of NULL..*
2780: 2f 0a 73 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f  /.static Mem *co
2790: 6c 75 6d 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f  lumnMem(sqlite3_
27a0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
27b0: 20 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d   i){.  Vdbe *pVm
27c0: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74   = (Vdbe *)pStmt
27d0: 3b 0a 20 20 69 6e 74 20 76 61 6c 73 20 3d 20 73  ;.  int vals = s
27e0: 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e  qlite3_data_coun
27f0: 74 28 70 53 74 6d 74 29 3b 0a 20 20 69 66 28 20  t(pStmt);.  if( 
2800: 69 3e 3d 76 61 6c 73 20 7c 7c 20 69 3c 30 20 29  i>=vals || i<0 )
2810: 7b 0a 20 20 20 20 73 74 61 74 69 63 20 4d 65 6d  {.    static Mem
2820: 20 6e 75 6c 6c 4d 65 6d 3b 0a 20 20 20 20 69 66   nullMem;.    if
2830: 28 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 67 73 3d  ( nullMem.flags=
2840: 3d 30 20 29 7b 20 6e 75 6c 6c 4d 65 6d 2e 66 6c  =0 ){ nullMem.fl
2850: 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 20  ags = MEM_Null; 
2860: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72  }.    sqlite3Err
2870: 6f 72 28 70 56 6d 2d 3e 64 62 2c 20 53 51 4c 49  or(pVm->db, SQLI
2880: 54 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20  TE_RANGE, 0);.  
2890: 20 20 72 65 74 75 72 6e 20 26 6e 75 6c 6c 4d 65    return &nullMe
28a0: 6d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  m;.  }.  return 
28b0: 26 70 56 6d 2d 3e 70 54 6f 73 5b 28 31 2d 76 61  &pVm->pTos[(1-va
28c0: 6c 73 29 2b 69 5d 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a  ls)+i];.}../****
28d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
28e0: 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33  ******** sqlite3
28f0: 5f 63 6f 6c 75 6d 6e 5f 20 20 2a 2a 2a 2a 2a 2a  _column_  ******
2900: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2910: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65  *********.** The
2920: 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69   following routi
2930: 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 6f 20  nes are used to 
2940: 61 63 63 65 73 73 20 65 6c 65 6d 65 6e 74 73 20  access elements 
2950: 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 72  of the current r
2960: 6f 77 0a 2a 2a 20 69 6e 20 74 68 65 20 72 65 73  ow.** in the res
2970: 75 6c 74 20 73 65 74 2e 0a 2a 2f 0a 63 6f 6e 73  ult set..*/.cons
2980: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  t void *sqlite3_
2990: 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 73 71 6c 69  column_blob(sqli
29a0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
29b0: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
29c0: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
29d0: 62 6c 6f 62 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  blob( columnMem(
29e0: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e  pStmt,i) );.}.in
29f0: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  t sqlite3_column
2a00: 5f 62 79 74 65 73 28 73 71 6c 69 74 65 33 5f 73  _bytes(sqlite3_s
2a10: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
2a20: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  i){.  return sql
2a30: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73  ite3_value_bytes
2a40: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d  ( columnMem(pStm
2a50: 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 20 73 71  t,i) );.}.int sq
2a60: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74  lite3_column_byt
2a70: 65 73 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d  es16(sqlite3_stm
2a80: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
2a90: 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  {.  return sqlit
2aa0: 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36  e3_value_bytes16
2ab0: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d  ( columnMem(pStm
2ac0: 74 2c 69 29 20 29 3b 0a 7d 0a 64 6f 75 62 6c 65  t,i) );.}.double
2ad0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
2ae0: 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73  double(sqlite3_s
2af0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
2b00: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  i){.  return sql
2b10: 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c  ite3_value_doubl
2b20: 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  e( columnMem(pSt
2b30: 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 20 73  mt,i) );.}.int s
2b40: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e  qlite3_column_in
2b50: 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  t(sqlite3_stmt *
2b60: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
2b70: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f   return sqlite3_
2b80: 76 61 6c 75 65 5f 69 6e 74 28 20 63 6f 6c 75 6d  value_int( colum
2b90: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
2ba0: 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  .}.sqlite_int64 
2bb0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69  sqlite3_column_i
2bc0: 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 73 74 6d  nt64(sqlite3_stm
2bd0: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
2be0: 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  {.  return sqlit
2bf0: 65 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 20  e3_value_int64( 
2c00: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c  columnMem(pStmt,
2c10: 69 29 20 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e  i) );.}.const un
2c20: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71 6c  signed char *sql
2c30: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74  ite3_column_text
2c40: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
2c50: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20  Stmt, int i){.  
2c60: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76  return sqlite3_v
2c70: 61 6c 75 65 5f 74 65 78 74 28 20 63 6f 6c 75 6d  alue_text( colum
2c80: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
2c90: 0a 7d 0a 23 69 66 20 30 0a 73 71 6c 69 74 65 33  .}.#if 0.sqlite3
2ca0: 5f 76 61 6c 75 65 20 2a 73 71 6c 69 74 65 33 5f  _value *sqlite3_
2cb0: 63 6f 6c 75 6d 6e 5f 76 61 6c 75 65 28 73 71 6c  column_value(sql
2cc0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
2cd0: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75  , int i){.  retu
2ce0: 72 6e 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  rn columnMem(pSt
2cf0: 6d 74 2c 20 69 29 3b 0a 7d 0a 23 65 6e 64 69 66  mt, i);.}.#endif
2d00: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
2d10: 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74  OMIT_UTF16.const
2d20: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
2d30: 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 73 71 6c  olumn_text16(sql
2d40: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
2d50: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75  , int i){.  retu
2d60: 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  rn sqlite3_value
2d70: 5f 74 65 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d  _text16( columnM
2d80: 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d  em(pStmt,i) );.}
2d90: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54  .#endif /* SQLIT
2da0: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a  E_OMIT_UTF16 */.
2db0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  int sqlite3_colu
2dc0: 6d 6e 5f 74 79 70 65 28 73 71 6c 69 74 65 33 5f  mn_type(sqlite3_
2dd0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
2de0: 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71   i){.  return sq
2df0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65  lite3_value_type
2e00: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d  ( columnMem(pStm
2e10: 74 2c 69 29 20 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  t,i) );.}../*.**
2e20: 20 43 6f 6e 76 65 72 74 20 74 68 65 20 4e 2d 74   Convert the N-t
2e30: 68 20 65 6c 65 6d 65 6e 74 20 6f 66 20 70 53 74  h element of pSt
2e40: 6d 74 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d 20 69  mt->pColName[] i
2e50: 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 75 73 69  nto a string usi
2e60: 6e 67 0a 2a 2a 20 78 46 75 6e 63 28 29 20 74 68  ng.** xFunc() th
2e70: 65 6e 20 72 65 74 75 72 6e 20 74 68 61 74 20 73  en return that s
2e80: 74 72 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 20  tring.  If N is 
2e90: 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 20 72 65  out of range, re
2ea0: 74 75 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20 54 68  turn 0..**.** Th
2eb0: 65 72 65 20 61 72 65 20 75 70 20 74 6f 20 35 20  ere are up to 5 
2ec0: 6e 61 6d 65 73 20 66 6f 72 20 65 61 63 68 20 63  names for each c
2ed0: 6f 6c 75 6d 6e 2e 20 20 75 73 65 54 79 70 65 20  olumn.  useType 
2ee0: 64 65 74 65 72 6d 69 6e 65 73 20 77 68 69 63 68  determines which
2ef0: 0a 2a 2a 20 6e 61 6d 65 20 69 73 20 72 65 74 75  .** name is retu
2f00: 72 6e 65 64 2e 20 20 48 65 72 65 20 61 72 65 20  rned.  Here are 
2f10: 74 68 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a  the names:.**.**
2f20: 20 20 20 20 30 20 20 20 20 20 20 54 68 65 20 63      0      The c
2f30: 6f 6c 75 6d 6e 20 6e 61 6d 65 20 61 73 20 69 74  olumn name as it
2f40: 20 73 68 6f 75 6c 64 20 62 65 20 64 69 73 70 6c   should be displ
2f50: 61 79 65 64 20 66 6f 72 20 6f 75 74 70 75 74 0a  ayed for output.
2f60: 2a 2a 20 20 20 20 31 20 20 20 20 20 20 54 68 65  **    1      The
2f70: 20 64 61 74 61 74 79 70 65 20 6e 61 6d 65 20 66   datatype name f
2f80: 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 2a 2a  or the column.**
2f90: 20 20 20 20 32 20 20 20 20 20 20 54 68 65 20 6e      2      The n
2fa0: 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  ame of the datab
2fb0: 61 73 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c  ase that the col
2fc0: 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d  umn derives from
2fd0: 0a 2a 2a 20 20 20 20 33 20 20 20 20 20 20 54 68  .**    3      Th
2fe0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61  e name of the ta
2ff0: 62 6c 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c  ble that the col
3000: 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d  umn derives from
3010: 0a 2a 2a 20 20 20 20 34 20 20 20 20 20 20 54 68  .**    4      Th
3020: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61  e name of the ta
3030: 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20  ble column that 
3040: 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d  the result colum
3050: 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a 2a  n derives from.*
3060: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 72 65 73 75  *.** If the resu
3070: 6c 74 20 69 73 20 6e 6f 74 20 61 20 73 69 6d 70  lt is not a simp
3080: 6c 65 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 65  le column refere
3090: 6e 63 65 20 28 69 66 20 69 74 20 69 73 20 61 6e  nce (if it is an
30a0: 20 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 6f   expression.** o
30b0: 72 20 61 20 63 6f 6e 73 74 61 6e 74 29 20 74 68  r a constant) th
30c0: 65 6e 20 75 73 65 54 79 70 65 73 20 32 2c 20 33  en useTypes 2, 3
30d0: 2c 20 61 6e 64 20 34 20 72 65 74 75 72 6e 20 4e  , and 4 return N
30e0: 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63  ULL..*/.static c
30f0: 6f 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c 75 6d  onst void *colum
3100: 6e 4e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33  nName(.  sqlite3
3110: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 0a 20 20  _stmt *pStmt,.  
3120: 69 6e 74 20 4e 2c 0a 20 20 63 6f 6e 73 74 20 76  int N,.  const v
3130: 6f 69 64 20 2a 28 2a 78 46 75 6e 63 29 28 4d 65  oid *(*xFunc)(Me
3140: 6d 2a 29 2c 0a 20 20 69 6e 74 20 75 73 65 54 79  m*),.  int useTy
3150: 70 65 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70 20  pe.){.  Vdbe *p 
3160: 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b  = (Vdbe *)pStmt;
3170: 0a 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c 69 74  .  int n = sqlit
3180: 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28  e3_column_count(
3190: 70 53 74 6d 74 29 3b 0a 0a 20 20 69 66 28 20 70  pStmt);..  if( p
31a0: 3d 3d 30 20 7c 7c 20 4e 3e 3d 6e 20 7c 7c 20 4e  ==0 || N>=n || N
31b0: 3c 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  <0 ){.    return
31c0: 20 30 3b 0a 20 20 7d 0a 20 20 4e 20 2b 3d 20 75   0;.  }.  N += u
31d0: 73 65 54 79 70 65 2a 6e 3b 0a 20 20 72 65 74 75  seType*n;.  retu
31e0: 72 6e 20 78 46 75 6e 63 28 26 70 2d 3e 61 43 6f  rn xFunc(&p->aCo
31f0: 6c 4e 61 6d 65 5b 4e 5d 29 3b 0a 7d 0a 0a 0a 2f  lName[N]);.}.../
3200: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
3210: 6e 61 6d 65 20 6f 66 20 74 68 65 20 4e 74 68 20  name of the Nth 
3220: 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65  column of the re
3230: 73 75 6c 74 20 73 65 74 20 72 65 74 75 72 6e 65  sult set returne
3240: 64 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74 61 74  d by SQL.** stat
3250: 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a  ement pStmt..*/.
3260: 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69  const char *sqli
3270: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28  te3_column_name(
3280: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
3290: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72  tmt, int N){.  r
32a0: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65  eturn columnName
32b0: 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73  (pStmt, N, (cons
32c0: 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29  t void*(*)(Mem*)
32d0: 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  )sqlite3_value_t
32e0: 65 78 74 2c 20 30 29 3b 0a 7d 0a 23 69 66 6e 64  ext, 0);.}.#ifnd
32f0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  ef SQLITE_OMIT_U
3300: 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20  TF16.const void 
3310: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  *sqlite3_column_
3320: 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73  name16(sqlite3_s
3330: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
3340: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c  N){.  return col
3350: 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e  umnName(pStmt, N
3360: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a  , (const void*(*
3370: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f  )(Mem*))sqlite3_
3380: 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 30 29  value_text16, 0)
3390: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a  ;.}.#endif../*.*
33a0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63 6f 6c  * Return the col
33b0: 75 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f 6e 20  umn declaration 
33c0: 74 79 70 65 20 28 69 66 20 61 70 70 6c 69 63 61  type (if applica
33d0: 62 6c 65 29 20 6f 66 20 74 68 65 20 27 69 27 74  ble) of the 'i't
33e0: 68 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74  h column.** of t
33f0: 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66  he result set of
3400: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 70   SQL statement p
3410: 53 74 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63  Stmt..*/.const c
3420: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  har *sqlite3_col
3430: 75 6d 6e 5f 64 65 63 6c 74 79 70 65 28 73 71 6c  umn_decltype(sql
3440: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
3450: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
3460: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53  rn columnName(pS
3470: 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76  tmt, N, (const v
3480: 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71  oid*(*)(Mem*))sq
3490: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
34a0: 2c 20 31 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20  , 1);.}.#ifndef 
34b0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
34c0: 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  6.const void *sq
34d0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63  lite3_column_dec
34e0: 6c 74 79 70 65 31 36 28 73 71 6c 69 74 65 33 5f  ltype16(sqlite3_
34f0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
3500: 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f   N){.  return co
3510: 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20  lumnName(pStmt, 
3520: 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28  N, (const void*(
3530: 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33  *)(Mem*))sqlite3
3540: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 31  _value_text16, 1
3550: 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53  );.}.#endif /* S
3560: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
3570: 20 2a 2f 0a 0a 23 69 66 20 21 64 65 66 69 6e 65   */..#if !define
3580: 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4f 52  d(SQLITE_OMIT_OR
3590: 49 47 49 4e 5f 4e 41 4d 45 53 29 20 26 26 20 30  IGIN_NAMES) && 0
35a0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
35b0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61  e name of the da
35c0: 74 61 62 61 73 65 20 66 72 6f 6d 20 77 68 69 63  tabase from whic
35d0: 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d  h a result colum
35e0: 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e 55  n derives..** NU
35f0: 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20 69  LL is returned i
3600: 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c  f the result col
3610: 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73  umn is an expres
3620: 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e 74  sion or constant
3630: 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20   or.** anything 
3640: 65 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e 6f  else which is no
3650: 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73 20  t an unabiguous 
3660: 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 64  reference to a d
3670: 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a  atabase column..
3680: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
3690: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61  qlite3_column_da
36a0: 74 61 62 61 73 65 5f 6e 61 6d 65 28 73 71 6c 69  tabase_name(sqli
36b0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
36c0: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72   int N){.  retur
36d0: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74  n columnName(pSt
36e0: 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f  mt, N, (const vo
36f0: 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c  id*(*)(Mem*))sql
3700: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c  ite3_value_text,
3710: 20 32 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53   2);.}.#ifndef S
3720: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
3730: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
3740: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61  ite3_column_data
3750: 62 61 73 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69  base_name16(sqli
3760: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
3770: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72   int N){.  retur
3780: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74  n columnName(pSt
3790: 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f  mt, N, (const vo
37a0: 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c  id*(*)(Mem*))sql
37b0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
37c0: 36 2c 20 32 29 3b 0a 7d 0a 23 65 6e 64 69 66 20  6, 2);.}.#endif 
37d0: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  /* SQLITE_OMIT_U
37e0: 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52  TF16 */../*.** R
37f0: 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f  eturn the name o
3800: 66 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f 6d  f the table from
3810: 20 77 68 69 63 68 20 61 20 72 65 73 75 6c 74 20   which a result 
3820: 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a  column derives..
3830: 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72  ** NULL is retur
3840: 6e 65 64 20 69 66 20 74 68 65 20 72 65 73 75 6c  ned if the resul
3850: 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65  t column is an e
3860: 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e  xpression or con
3870: 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74  stant or.** anyt
3880: 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20  hing else which 
3890: 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 62 69 67  is not an unabig
38a0: 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20 74  uous reference t
38b0: 6f 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c  o a database col
38c0: 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68  umn..*/.const ch
38d0: 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ar *sqlite3_colu
38e0: 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 28 73 71  mn_table_name(sq
38f0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
3900: 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74  t, int N){.  ret
3910: 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70  urn columnName(p
3920: 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20  Stmt, N, (const 
3930: 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73  void*(*)(Mem*))s
3940: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
3950: 74 2c 20 33 29 3b 0a 7d 0a 23 69 66 6e 64 65 66  t, 3);.}.#ifndef
3960: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
3970: 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73  16.const void *s
3980: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61  qlite3_column_ta
3990: 62 6c 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74  ble_name16(sqlit
39a0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
39b0: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
39c0: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d   columnName(pStm
39d0: 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69  t, N, (const voi
39e0: 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69  d*(*)(Mem*))sqli
39f0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36  te3_value_text16
3a00: 2c 20 33 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  , 3);.}.#endif /
3a10: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  * SQLITE_OMIT_UT
3a20: 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65  F16 */../*.** Re
3a30: 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66  turn the name of
3a40: 20 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d   the table colum
3a50: 6e 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72  n from which a r
3a60: 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72  esult column der
3a70: 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73  ives..** NULL is
3a80: 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65   returned if the
3a90: 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69   result column i
3aa0: 73 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20  s an expression 
3ab0: 6f 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a  or constant or.*
3ac0: 2a 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20  * anything else 
3ad0: 77 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20  which is not an 
3ae0: 75 6e 61 62 69 67 75 6f 75 73 20 72 65 66 65 72  unabiguous refer
3af0: 65 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62 61  ence to a databa
3b00: 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f  se column..*/.co
3b10: 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65  nst char *sqlite
3b20: 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f  3_column_origin_
3b30: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  name(sqlite3_stm
3b40: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29  t *pStmt, int N)
3b50: 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d  {.  return colum
3b60: 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20  nName(pStmt, N, 
3b70: 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28  (const void*(*)(
3b80: 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61  Mem*))sqlite3_va
3b90: 6c 75 65 5f 74 65 78 74 2c 20 34 29 3b 0a 7d 0a  lue_text, 4);.}.
3ba0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
3bb0: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
3bc0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f  void *sqlite3_co
3bd0: 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65  lumn_origin_name
3be0: 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  16(sqlite3_stmt 
3bf0: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
3c00: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e    return columnN
3c10: 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63  ame(pStmt, N, (c
3c20: 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65  onst void*(*)(Me
3c30: 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75  m*))sqlite3_valu
3c40: 65 5f 74 65 78 74 31 36 2c 20 34 29 3b 0a 7d 0a  e_text16, 4);.}.
3c50: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
3c60: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 23  _OMIT_UTF16 */.#
3c70: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
3c80: 4f 4d 49 54 5f 4f 52 49 47 49 4e 5f 4e 41 4d 45  OMIT_ORIGIN_NAME
3c90: 53 20 2a 2f 0a 0a 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a  S */...../******
3ca0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3cb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65  ********* sqlite
3cc0: 33 5f 62 69 6e 64 5f 20 20 2a 2a 2a 2a 2a 2a 2a  3_bind_  *******
3cd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3ce0: 2a 2a 2a 2a 0a 2a 2a 20 0a 2a 2a 20 52 6f 75 74  ****.** .** Rout
3cf0: 69 6e 65 73 20 75 73 65 64 20 74 6f 20 61 74 74  ines used to att
3d00: 61 63 68 20 76 61 6c 75 65 73 20 74 6f 20 77 69  ach values to wi
3d10: 6c 64 63 61 72 64 73 20 69 6e 20 61 20 63 6f 6d  ldcards in a com
3d20: 70 69 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d  piled SQL statem
3d30: 65 6e 74 2e 0a 2a 2f 0a 2f 2a 0a 2a 2a 20 55 6e  ent..*/./*.** Un
3d40: 62 69 6e 64 20 74 68 65 20 76 61 6c 75 65 20 62  bind the value b
3d50: 6f 75 6e 64 20 74 6f 20 76 61 72 69 61 62 6c 65  ound to variable
3d60: 20 69 20 69 6e 20 76 69 72 74 75 61 6c 20 6d 61   i in virtual ma
3d70: 63 68 69 6e 65 20 70 2e 20 54 68 69 73 20 69 73  chine p. This is
3d80: 20 74 68 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d   the .** the sam
3d90: 65 20 61 73 20 62 69 6e 64 69 6e 67 20 61 20 4e  e as binding a N
3da0: 55 4c 4c 20 76 61 6c 75 65 20 74 6f 20 74 68 65  ULL value to the
3db0: 20 63 6f 6c 75 6d 6e 2e 20 49 66 20 74 68 65 20   column. If the 
3dc0: 22 69 22 20 70 61 72 61 6d 65 74 65 72 20 69 73  "i" parameter is
3dd0: 0a 2a 2a 20 6f 75 74 20 6f 66 20 72 61 6e 67 65  .** out of range
3de0: 2c 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 52 41  , then SQLITE_RA
3df0: 4e 47 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e  NGE is returned.
3e00: 20 4f 74 68 65 77 69 73 65 20 53 51 4c 49 54 45   Othewise SQLITE
3e10: 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65  _OK..**.** The e
3e20: 72 72 6f 72 20 63 6f 64 65 20 73 74 6f 72 65 64  rror code stored
3e30: 20 69 6e 20 64 61 74 61 62 61 73 65 20 70 2d 3e   in database p->
3e40: 64 62 20 69 73 20 6f 76 65 72 77 72 69 74 74 65  db is overwritte
3e50: 6e 20 77 69 74 68 20 74 68 65 20 72 65 74 75 72  n with the retur
3e60: 6e 0a 2a 2a 20 76 61 6c 75 65 20 69 6e 20 61 6e  n.** value in an
3e70: 79 20 63 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69  y case..*/.stati
3e80: 63 20 69 6e 74 20 76 64 62 65 55 6e 62 69 6e 64  c int vdbeUnbind
3e90: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 69 29  (Vdbe *p, int i)
3ea0: 7b 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20  {.  Mem *pVar;. 
3eb0: 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e   if( p==0 || p->
3ec0: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
3ed0: 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e 70 63 3e 3d  C_RUN || p->pc>=
3ee0: 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 20 29  0 ){.    if( p )
3ef0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d   sqlite3Error(p-
3f00: 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55  >db, SQLITE_MISU
3f10: 53 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75  SE, 0);.    retu
3f20: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
3f30: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 3c 31 20  ;.  }.  if( i<1 
3f40: 7c 7c 20 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a  || i>p->nVar ){.
3f50: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
3f60: 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52  (p->db, SQLITE_R
3f70: 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 72 65  ANGE, 0);.    re
3f80: 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47  turn SQLITE_RANG
3f90: 45 3b 0a 20 20 7d 0a 20 20 69 2d 2d 3b 0a 20 20  E;.  }.  i--;.  
3fa0: 70 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b  pVar = &p->aVar[
3fb0: 69 5d 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  i];.  sqlite3Vdb
3fc0: 65 4d 65 6d 52 65 6c 65 61 73 65 28 70 56 61 72  eMemRelease(pVar
3fd0: 29 3b 0a 20 20 70 56 61 72 2d 3e 66 6c 61 67 73  );.  pVar->flags
3fe0: 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 73   = MEM_Null;.  s
3ff0: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64  qlite3Error(p->d
4000: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29  b, SQLITE_OK, 0)
4010: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
4020: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42  E_OK;.}../*.** B
4030: 69 6e 64 20 61 20 74 65 78 74 20 6f 72 20 42 4c  ind a text or BL
4040: 4f 42 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61  OB value..*/.sta
4050: 74 69 63 20 69 6e 74 20 62 69 6e 64 54 65 78 74  tic int bindText
4060: 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74  (.  sqlite3_stmt
4070: 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20   *pStmt, .  int 
4080: 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  i, .  const void
4090: 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20   *zData, .  int 
40a0: 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28  nData, .  void (
40b0: 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 2c 0a 20  *xDel)(void*),. 
40c0: 20 69 6e 74 20 65 6e 63 6f 64 69 6e 67 0a 29 7b   int encoding.){
40d0: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
40e0: 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65  be *)pStmt;.  Me
40f0: 6d 20 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72  m *pVar;.  int r
4100: 63 3b 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55  c;..  rc = vdbeU
4110: 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69  nbind(p, i);.  i
4120: 66 28 20 72 63 20 7c 7c 20 7a 44 61 74 61 3d 3d  f( rc || zData==
4130: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
4140: 72 63 3b 0a 20 20 7d 0a 20 20 70 56 61 72 20 3d  rc;.  }.  pVar =
4150: 20 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 3b 0a   &p->aVar[i-1];.
4160: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64    rc = sqlite3Vd
4170: 62 65 4d 65 6d 53 65 74 53 74 72 28 70 56 61 72  beMemSetStr(pVar
4180: 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20  , zData, nData, 
4190: 65 6e 63 6f 64 69 6e 67 2c 20 78 44 65 6c 29 3b  encoding, xDel);
41a0: 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20  .  if( rc ){.   
41b0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a   return rc;.  }.
41c0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
41d0: 5f 4f 4b 20 26 26 20 65 6e 63 6f 64 69 6e 67 21  _OK && encoding!
41e0: 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73  =0 ){.    rc = s
41f0: 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65  qlite3VdbeChange
4200: 45 6e 63 6f 64 69 6e 67 28 70 56 61 72 2c 20 70  Encoding(pVar, p
4210: 2d 3e 64 62 2d 3e 65 6e 63 29 3b 0a 20 20 7d 0a  ->db->enc);.  }.
4220: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
4230: 0a 2f 2a 0a 2a 2a 20 42 69 6e 64 20 61 20 62 6c  ./*.** Bind a bl
4240: 6f 62 20 76 61 6c 75 65 20 74 6f 20 61 6e 20 53  ob value to an S
4250: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 76 61 72  QL statement var
4260: 69 61 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71  iable..*/.int sq
4270: 6c 69 74 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 28  lite3_bind_blob(
4280: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
4290: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69  *pStmt, .  int i
42a0: 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  , .  const void 
42b0: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e  *zData, .  int n
42c0: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a  Data, .  void (*
42d0: 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a  xDel)(void*).){.
42e0: 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78    return bindTex
42f0: 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74  t(pStmt, i, zDat
4300: 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20  a, nData, xDel, 
4310: 30 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  0);.}.int sqlite
4320: 33 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28 73 71  3_bind_double(sq
4330: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
4340: 74 2c 20 69 6e 74 20 69 2c 20 64 6f 75 62 6c 65  t, int i, double
4350: 20 72 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20   rValue){.  int 
4360: 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  rc;.  Vdbe *p = 
4370: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20  (Vdbe *)pStmt;. 
4380: 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64   rc = vdbeUnbind
4390: 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63  (p, i);.  if( rc
43a0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
43b0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
43c0: 6d 53 65 74 44 6f 75 62 6c 65 28 26 70 2d 3e 61  mSetDouble(&p->a
43d0: 56 61 72 5b 69 2d 31 5d 2c 20 72 56 61 6c 75 65  Var[i-1], rValue
43e0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
43f0: 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  rc;.}.int sqlite
4400: 33 5f 62 69 6e 64 5f 69 6e 74 28 73 71 6c 69 74  3_bind_int(sqlit
4410: 65 33 5f 73 74 6d 74 20 2a 70 2c 20 69 6e 74 20  e3_stmt *p, int 
4420: 69 2c 20 69 6e 74 20 69 56 61 6c 75 65 29 7b 0a  i, int iValue){.
4430: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
4440: 5f 62 69 6e 64 5f 69 6e 74 36 34 28 70 2c 20 69  _bind_int64(p, i
4450: 2c 20 28 69 36 34 29 69 56 61 6c 75 65 29 3b 0a  , (i64)iValue);.
4460: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69  }.int sqlite3_bi
4470: 6e 64 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33  nd_int64(sqlite3
4480: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
4490: 74 20 69 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36  t i, sqlite_int6
44a0: 34 20 69 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74  4 iValue){.  int
44b0: 20 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d   rc;.  Vdbe *p =
44c0: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a   (Vdbe *)pStmt;.
44d0: 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e    rc = vdbeUnbin
44e0: 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72  d(p, i);.  if( r
44f0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
4500: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d      sqlite3VdbeM
4510: 65 6d 53 65 74 49 6e 74 36 34 28 26 70 2d 3e 61  emSetInt64(&p->a
4520: 56 61 72 5b 69 2d 31 5d 2c 20 69 56 61 6c 75 65  Var[i-1], iValue
4530: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
4540: 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  rc;.}.int sqlite
4550: 33 5f 62 69 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69  3_bind_null(sqli
4560: 74 65 33 5f 73 74 6d 74 2a 20 70 2c 20 69 6e 74  te3_stmt* p, int
4570: 20 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 76 64   i){.  return vd
4580: 62 65 55 6e 62 69 6e 64 28 28 56 64 62 65 20 2a  beUnbind((Vdbe *
4590: 29 70 2c 20 69 29 3b 0a 7d 0a 69 6e 74 20 73 71  )p, i);.}.int sq
45a0: 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 28  lite3_bind_text(
45b0: 20 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74   .  sqlite3_stmt
45c0: 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20   *pStmt, .  int 
45d0: 69 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72  i, .  const char
45e0: 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20   *zData, .  int 
45f0: 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28  nData, .  void (
4600: 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b  *xDel)(void*).){
4610: 0a 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65  .  return bindTe
4620: 78 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61  xt(pStmt, i, zDa
4630: 74 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c  ta, nData, xDel,
4640: 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d   SQLITE_UTF8);.}
4650: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
4660: 4f 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 73  OMIT_UTF16.int s
4670: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74  qlite3_bind_text
4680: 31 36 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 74  16(.  sqlite3_st
4690: 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e  mt *pStmt, .  in
46a0: 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f  t i, .  const vo
46b0: 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e  id *zData, .  in
46c0: 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69 64  t nData, .  void
46d0: 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a   (*xDel)(void*).
46e0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 62 69 6e 64  ){.  return bind
46f0: 54 65 78 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a  Text(pStmt, i, z
4700: 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 78 44 65  Data, nData, xDe
4710: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e  l, SQLITE_UTF16N
4720: 41 54 49 56 45 29 3b 0a 7d 0a 23 65 6e 64 69 66  ATIVE);.}.#endif
4730: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
4740: 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  UTF16 */../*.** 
4750: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
4760: 72 20 6f 66 20 77 69 6c 64 63 61 72 64 73 20 74  r of wildcards t
4770: 68 61 74 20 63 61 6e 20 62 65 20 70 6f 74 65 6e  hat can be poten
4780: 74 69 61 6c 6c 79 20 62 6f 75 6e 64 20 74 6f 2e  tially bound to.
4790: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
47a0: 20 69 73 20 61 64 64 65 64 20 74 6f 20 73 75 70   is added to sup
47b0: 70 6f 72 74 20 44 42 44 3a 3a 53 51 4c 69 74 65  port DBD::SQLite
47c0: 2e 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  .  .*/.int sqlit
47d0: 65 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65  e3_bind_paramete
47e0: 72 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f  r_count(sqlite3_
47f0: 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20  stmt *pStmt){.  
4800: 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a  Vdbe *p = (Vdbe*
4810: 29 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e  )pStmt;.  return
4820: 20 70 20 3f 20 70 2d 3e 6e 56 61 72 20 3a 20 30   p ? p->nVar : 0
4830: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ;.}../*.** Creat
4840: 65 20 61 20 6d 61 70 70 69 6e 67 20 66 72 6f 6d  e a mapping from
4850: 20 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 72   variable number
4860: 73 20 74 6f 20 76 61 72 69 61 62 6c 65 20 6e 61  s to variable na
4870: 6d 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 56 64  mes.** in the Vd
4880: 62 65 2e 61 7a 56 61 72 5b 5d 20 61 72 72 61 79  be.azVar[] array
4890: 2c 20 69 66 20 73 75 63 68 20 61 20 6d 61 70 70  , if such a mapp
48a0: 69 6e 67 20 64 6f 65 73 20 6e 6f 74 20 61 6c 72  ing does not alr
48b0: 65 61 64 79 0a 2a 2a 20 65 78 69 73 74 2e 0a 2a  eady.** exist..*
48c0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 72  /.static void cr
48d0: 65 61 74 65 56 61 72 4d 61 70 28 56 64 62 65 20  eateVarMap(Vdbe 
48e0: 2a 70 29 7b 0a 20 20 69 66 28 20 21 70 2d 3e 6f  *p){.  if( !p->o
48f0: 6b 56 61 72 20 29 7b 0a 20 20 20 20 69 6e 74 20  kVar ){.    int 
4900: 6a 3b 0a 20 20 20 20 4f 70 20 2a 70 4f 70 3b 0a  j;.    Op *pOp;.
4910: 20 20 20 20 66 6f 72 28 6a 3d 30 2c 20 70 4f 70      for(j=0, pOp
4920: 3d 70 2d 3e 61 4f 70 3b 20 6a 3c 70 2d 3e 6e 4f  =p->aOp; j<p->nO
4930: 70 3b 20 6a 2b 2b 2c 20 70 4f 70 2b 2b 29 7b 0a  p; j++, pOp++){.
4940: 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 6f        if( pOp->o
4950: 70 63 6f 64 65 3d 3d 4f 50 5f 56 61 72 69 61 62  pcode==OP_Variab
4960: 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73  le ){.        as
4970: 73 65 72 74 28 20 70 4f 70 2d 3e 70 31 3e 30 20  sert( pOp->p1>0 
4980: 26 26 20 70 4f 70 2d 3e 70 31 3c 3d 70 2d 3e 6e  && pOp->p1<=p->n
4990: 56 61 72 20 29 3b 0a 20 20 20 20 20 20 20 20 70  Var );.        p
49a0: 2d 3e 61 7a 56 61 72 5b 70 4f 70 2d 3e 70 31 2d  ->azVar[pOp->p1-
49b0: 31 5d 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a 20 20  1] = pOp->p3;.  
49c0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
49d0: 70 2d 3e 6f 6b 56 61 72 20 3d 20 31 3b 0a 20 20  p->okVar = 1;.  
49e0: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  }.}../*.** Retur
49f0: 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20  n the name of a 
4a00: 77 69 6c 64 63 61 72 64 20 70 61 72 61 6d 65 74  wildcard paramet
4a10: 65 72 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c  er.  Return NULL
4a20: 20 69 66 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a   if the index.**
4a30: 20 69 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65   is out of range
4a40: 20 6f 72 20 69 66 20 74 68 65 20 77 69 6c 64 63   or if the wildc
4a50: 61 72 64 20 69 73 20 75 6e 6e 61 6d 65 64 2e 0a  ard is unnamed..
4a60: 2a 2a 0a 2a 2a 20 54 68 65 20 72 65 73 75 6c 74  **.** The result
4a70: 20 69 73 20 61 6c 77 61 79 73 20 55 54 46 2d 38   is always UTF-8
4a80: 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20  ..*/.const char 
4a90: 2a 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61  *sqlite3_bind_pa
4aa0: 72 61 6d 65 74 65 72 5f 6e 61 6d 65 28 73 71 6c  rameter_name(sql
4ab0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
4ac0: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 56 64 62 65  , int i){.  Vdbe
4ad0: 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74   *p = (Vdbe*)pSt
4ae0: 6d 74 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c  mt;.  if( p==0 |
4af0: 7c 20 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56  | i<1 || i>p->nV
4b00: 61 72 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ar ){.    return
4b10: 20 30 3b 0a 20 20 7d 0a 20 20 63 72 65 61 74 65   0;.  }.  create
4b20: 56 61 72 4d 61 70 28 70 29 3b 0a 20 20 72 65 74  VarMap(p);.  ret
4b30: 75 72 6e 20 70 2d 3e 61 7a 56 61 72 5b 69 2d 31  urn p->azVar[i-1
4b40: 5d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65  ];.}../*.** Give
4b50: 6e 20 61 20 77 69 6c 64 63 61 72 64 20 70 61 72  n a wildcard par
4b60: 61 6d 65 74 65 72 20 6e 61 6d 65 2c 20 72 65 74  ameter name, ret
4b70: 75 72 6e 20 74 68 65 20 69 6e 64 65 78 20 6f 66  urn the index of
4b80: 20 74 68 65 20 76 61 72 69 61 62 6c 65 0a 2a 2a   the variable.**
4b90: 20 77 69 74 68 20 74 68 61 74 20 6e 61 6d 65 2e   with that name.
4ba0: 20 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f    If there is no
4bb0: 20 76 61 72 69 61 62 6c 65 20 77 69 74 68 20 74   variable with t
4bc0: 68 65 20 67 69 76 65 6e 20 6e 61 6d 65 2c 0a 2a  he given name,.*
4bd0: 2a 20 72 65 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69  * return 0..*/.i
4be0: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  nt sqlite3_bind_
4bf0: 70 61 72 61 6d 65 74 65 72 5f 69 6e 64 65 78 28  parameter_index(
4c00: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
4c10: 74 6d 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 20  tmt, const char 
4c20: 2a 7a 4e 61 6d 65 29 7b 0a 20 20 56 64 62 65 20  *zName){.  Vdbe 
4c30: 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d  *p = (Vdbe*)pStm
4c40: 74 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66  t;.  int i;.  if
4c50: 28 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65  ( p==0 ){.    re
4c60: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 63 72  turn 0;.  }.  cr
4c70: 65 61 74 65 56 61 72 4d 61 70 28 70 29 3b 20 0a  eateVarMap(p); .
4c80: 20 20 69 66 28 20 7a 4e 61 6d 65 20 29 7b 0a 20    if( zName ){. 
4c90: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d     for(i=0; i<p-
4ca0: 3e 6e 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20  >nVar; i++){.   
4cb0: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a     const char *z
4cc0: 20 3d 20 70 2d 3e 61 7a 56 61 72 5b 69 5d 3b 0a   = p->azVar[i];.
4cd0: 20 20 20 20 20 20 69 66 28 20 7a 20 26 26 20 73        if( z && s
4ce0: 74 72 63 6d 70 28 7a 2c 7a 4e 61 6d 65 29 3d 3d  trcmp(z,zName)==
4cf0: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74  0 ){.        ret
4d00: 75 72 6e 20 69 2b 31 3b 0a 20 20 20 20 20 20 7d  urn i+1;.      }
4d10: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
4d20: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
4d30: 54 72 61 6e 73 66 65 72 20 61 6c 6c 20 62 69 6e  Transfer all bin
4d40: 64 69 6e 67 73 20 66 72 6f 6d 20 74 68 65 20 66  dings from the f
4d50: 69 72 73 74 20 73 74 61 74 65 6d 65 6e 74 20 6f  irst statement o
4d60: 76 65 72 20 74 6f 20 74 68 65 20 73 65 63 6f 6e  ver to the secon
4d70: 64 2e 0a 2a 2a 20 49 66 20 74 68 65 20 74 77 6f  d..** If the two
4d80: 20 73 74 61 74 65 6d 65 6e 74 73 20 63 6f 6e 74   statements cont
4d90: 61 69 6e 20 61 20 64 69 66 66 65 72 65 6e 74 20  ain a different 
4da0: 6e 75 6d 62 65 72 20 6f 66 20 62 69 6e 64 69 6e  number of bindin
4db0: 67 73 2c 20 74 68 65 6e 0a 2a 2a 20 61 6e 20 53  gs, then.** an S
4dc0: 51 4c 49 54 45 5f 45 52 52 4f 52 20 69 73 20 72  QLITE_ERROR is r
4dd0: 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20  eturned..*/.int 
4de0: 73 71 6c 69 74 65 33 5f 74 72 61 6e 73 66 65 72  sqlite3_transfer
4df0: 5f 62 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 65  _bindings(sqlite
4e00: 33 5f 73 74 6d 74 20 2a 70 46 72 6f 6d 53 74 6d  3_stmt *pFromStm
4e10: 74 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  t, sqlite3_stmt 
4e20: 2a 70 54 6f 53 74 6d 74 29 7b 0a 20 20 56 64 62  *pToStmt){.  Vdb
4e30: 65 20 2a 70 46 72 6f 6d 20 3d 20 28 56 64 62 65  e *pFrom = (Vdbe
4e40: 2a 29 70 46 72 6f 6d 53 74 6d 74 3b 0a 20 20 56  *)pFromStmt;.  V
4e50: 64 62 65 20 2a 70 54 6f 20 3d 20 28 56 64 62 65  dbe *pTo = (Vdbe
4e60: 2a 29 70 54 6f 53 74 6d 74 3b 0a 20 20 69 6e 74  *)pToStmt;.  int
4e70: 20 69 2c 20 72 63 20 3d 20 53 51 4c 49 54 45 5f   i, rc = SQLITE_
4e80: 4f 4b 3b 0a 20 20 69 66 28 20 28 70 46 72 6f 6d  OK;.  if( (pFrom
4e90: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
4ea0: 47 49 43 5f 52 55 4e 20 26 26 20 70 46 72 6f 6d  GIC_RUN && pFrom
4eb0: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
4ec0: 47 49 43 5f 48 41 4c 54 29 0a 20 20 20 20 7c 7c  GIC_HALT).    ||
4ed0: 20 28 70 54 6f 2d 3e 6d 61 67 69 63 21 3d 56 44   (pTo->magic!=VD
4ee0: 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20  BE_MAGIC_RUN && 
4ef0: 70 54 6f 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45  pTo->magic!=VDBE
4f00: 5f 4d 41 47 49 43 5f 48 41 4c 54 29 20 29 7b 0a  _MAGIC_HALT) ){.
4f10: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
4f20: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
4f30: 69 66 28 20 70 46 72 6f 6d 2d 3e 6e 56 61 72 21  if( pFrom->nVar!
4f40: 3d 70 54 6f 2d 3e 6e 56 61 72 20 29 7b 0a 20 20  =pTo->nVar ){.  
4f50: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
4f60: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 66 6f 72  ERROR;.  }.  for
4f70: 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45  (i=0; rc==SQLITE
4f80: 5f 4f 4b 20 26 26 20 69 3c 70 46 72 6f 6d 2d 3e  _OK && i<pFrom->
4f90: 6e 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nVar; i++){.    
4fa0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
4fb0: 4d 65 6d 4d 6f 76 65 28 26 70 54 6f 2d 3e 61 56  MemMove(&pTo->aV
4fc0: 61 72 5b 69 5d 2c 20 26 70 46 72 6f 6d 2d 3e 61  ar[i], &pFrom->a
4fd0: 56 61 72 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20 72  Var[i]);.  }.  r
4fe0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
4ff0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 71  ** Return the sq
5000: 6c 69 74 65 33 2a 20 64 61 74 61 62 61 73 65 20  lite3* database 
5010: 68 61 6e 64 6c 65 20 74 6f 20 77 68 69 63 68 20  handle to which 
5020: 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61  the prepared sta
5030: 74 65 6d 65 6e 74 20 67 69 76 65 6e 0a 2a 2a 20  tement given.** 
5040: 69 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20  in the argument 
5050: 62 65 6c 6f 6e 67 73 2e 20 20 54 68 69 73 20 69  belongs.  This i
5060: 73 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62  s the same datab
5070: 61 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20  ase handle that 
5080: 77 61 73 0a 2a 2a 20 74 68 65 20 66 69 72 73 74  was.** the first
5090: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65   argument to the
50a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
50b0: 28 29 20 74 68 61 74 20 77 61 73 20 75 73 65 64  () that was used
50c0: 20 74 6f 20 63 72 65 61 74 65 0a 2a 2a 20 74 68   to create.** th
50d0: 65 20 73 74 61 74 65 6d 65 6e 74 20 69 6e 20 74  e statement in t
50e0: 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a  he first place..
50f0: 2a 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69  */.sqlite3 *sqli
5100: 74 65 33 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71  te3_db_handle(sq
5110: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
5120: 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74  t){.  return pSt
5130: 6d 74 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74  mt ? ((Vdbe*)pSt
5140: 6d 74 29 2d 3e 64 62 20 3a 20 30 3b 0a 7d 0a     mt)->db : 0;.}.