/ Hex Artifact Content
Login

Artifact 85bbe1d0243a89655433d60711b4bd71979b59cd:


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 4d 65 6d 20 2a 70 4d 65  yte){.  Mem *pMe
1c40: 6d 20 3d 20 70 2d 3e 70 4d 65 6d 3b 0a 20 20 61  m = p->pMem;.  a
1c50: 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70  ssert( p && p->p
1c60: 46 75 6e 63 20 26 26 20 70 2d 3e 70 46 75 6e 63  Func && p->pFunc
1c70: 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20 69 66 28  ->xStep );.  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 56 64 62 65  *iArg;.    pVdbe
2190: 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 52 65 61  Func = sqliteRea
21a0: 6c 6c 6f 63 28 70 56 64 62 65 46 75 6e 63 2c 20  lloc(pVdbeFunc, 
21b0: 6e 4d 61 6c 6c 6f 63 29 3b 0a 20 20 20 20 69 66  nMalloc);.    if
21c0: 28 20 21 70 56 64 62 65 46 75 6e 63 20 29 20 72  ( !pVdbeFunc ) r
21d0: 65 74 75 72 6e 3b 0a 20 20 20 20 70 43 74 78 2d  eturn;.    pCtx-
21e0: 3e 70 56 64 62 65 46 75 6e 63 20 3d 20 70 56 64  >pVdbeFunc = pVd
21f0: 62 65 46 75 6e 63 3b 0a 20 20 20 20 6d 65 6d 73  beFunc;.    mems
2200: 65 74 28 26 70 56 64 62 65 46 75 6e 63 2d 3e 61  et(&pVdbeFunc->a
2210: 70 41 75 78 5b 70 56 64 62 65 46 75 6e 63 2d 3e  pAux[pVdbeFunc->
2220: 6e 41 75 78 5d 2c 20 30 2c 20 0a 20 20 20 20 20  nAux], 0, .     
2230: 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28 73          sizeof(s
2240: 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a 28  truct AuxData)*(
2250: 69 41 72 67 2b 31 2d 70 56 64 62 65 46 75 6e 63  iArg+1-pVdbeFunc
2260: 2d 3e 6e 41 75 78 29 29 3b 0a 20 20 20 20 70 56  ->nAux));.    pV
2270: 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3d 20  dbeFunc->nAux = 
2280: 69 41 72 67 2b 31 3b 0a 20 20 20 20 70 56 64 62  iArg+1;.    pVdb
2290: 65 46 75 6e 63 2d 3e 70 46 75 6e 63 20 3d 20 70  eFunc->pFunc = p
22a0: 43 74 78 2d 3e 70 46 75 6e 63 3b 0a 20 20 7d 0a  Ctx->pFunc;.  }.
22b0: 0a 20 20 70 41 75 78 44 61 74 61 20 3d 20 26 70  .  pAuxData = &p
22c0: 56 64 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b  VdbeFunc->apAux[
22d0: 69 41 72 67 5d 3b 0a 20 20 69 66 28 20 70 41 75  iArg];.  if( pAu
22e0: 78 44 61 74 61 2d 3e 70 41 75 78 20 26 26 20 70  xData->pAux && p
22f0: 41 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65  AuxData->xDelete
2300: 20 29 7b 0a 20 20 20 20 70 41 75 78 44 61 74 61   ){.    pAuxData
2310: 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78 44 61  ->xDelete(pAuxDa
2320: 74 61 2d 3e 70 41 75 78 29 3b 0a 20 20 7d 0a 20  ta->pAux);.  }. 
2330: 20 70 41 75 78 44 61 74 61 2d 3e 70 41 75 78 20   pAuxData->pAux 
2340: 3d 20 70 41 75 78 3b 0a 20 20 70 41 75 78 44 61  = pAux;.  pAuxDa
2350: 74 61 2d 3e 78 44 65 6c 65 74 65 20 3d 20 78 44  ta->xDelete = xD
2360: 65 6c 65 74 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  elete;.}../*.** 
2370: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
2380: 72 20 6f 66 20 74 69 6d 65 73 20 74 68 65 20 53  r of times the S
2390: 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20  tep function of 
23a0: 61 20 61 67 67 72 65 67 61 74 65 20 68 61 73 20  a aggregate has 
23b0: 62 65 65 6e 20 0a 2a 2a 20 63 61 6c 6c 65 64 2e  been .** called.
23c0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
23d0: 69 6e 65 20 69 73 20 64 65 66 69 6e 65 64 20 68  ine is defined h
23e0: 65 72 65 20 69 6e 20 76 64 62 65 2e 63 20 62 65  ere in vdbe.c be
23f0: 63 61 75 73 65 20 69 74 20 64 65 70 65 6e 64 73  cause it depends
2400: 20 6f 6e 20 6b 6e 6f 77 69 6e 67 0a 2a 2a 20 74   on knowing.** t
2410: 68 65 20 69 6e 74 65 72 6e 61 6c 73 20 6f 66 20  he internals of 
2420: 74 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74  the sqlite3_cont
2430: 65 78 74 20 73 74 72 75 63 74 75 72 65 20 77 68  ext structure wh
2440: 69 63 68 20 69 73 20 6f 6e 6c 79 20 64 65 66 69  ich is only defi
2450: 6e 65 64 20 69 6e 0a 2a 2a 20 74 68 69 73 20 73  ned in.** this s
2460: 6f 75 72 63 65 20 66 69 6c 65 2e 0a 2a 2f 0a 69  ource file..*/.i
2470: 6e 74 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65  nt sqlite3_aggre
2480: 67 61 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74  gate_count(sqlit
2490: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a  e3_context *p){.
24a0: 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70    assert( p && p
24b0: 2d 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e 70 46  ->pFunc && p->pF
24c0: 75 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20  unc->xStep );.  
24d0: 72 65 74 75 72 6e 20 70 2d 3e 70 4d 65 6d 2d 3e  return p->pMem->
24e0: 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  n;.}../*.** Retu
24f0: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  rn the number of
2500: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20   columns in the 
2510: 72 65 73 75 6c 74 20 73 65 74 20 66 6f 72 20 74  result set for t
2520: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74  he statement pSt
2530: 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  mt..*/.int sqlit
2540: 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28  e3_column_count(
2550: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
2560: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 56  tmt){.  Vdbe *pV
2570: 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  m = (Vdbe *)pStm
2580: 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 20  t;.  return pVm 
2590: 3f 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d  ? pVm->nResColum
25a0: 6e 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  n : 0;.}../*.** 
25b0: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
25c0: 72 20 6f 66 20 76 61 6c 75 65 73 20 61 76 61 69  r of values avai
25d0: 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63  lable from the c
25e0: 75 72 72 65 6e 74 20 72 6f 77 20 6f 66 20 74 68  urrent row of th
25f0: 65 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 65  e.** currently e
2600: 78 65 63 75 74 69 6e 67 20 73 74 61 74 65 6d 65  xecuting stateme
2610: 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74  nt pStmt..*/.int
2620: 20 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f   sqlite3_data_co
2630: 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  unt(sqlite3_stmt
2640: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65   *pStmt){.  Vdbe
2650: 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29   *pVm = (Vdbe *)
2660: 70 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d  pStmt;.  if( pVm
2670: 3d 3d 30 20 7c 7c 20 21 70 56 6d 2d 3e 72 65 73  ==0 || !pVm->res
2680: 4f 6e 53 74 61 63 6b 20 29 20 72 65 74 75 72 6e  OnStack ) return
2690: 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d   0;.  return pVm
26a0: 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d 0a  ->nResColumn;.}.
26b0: 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f  ../*.** Check to
26c0: 20 73 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69   see if column i
26d0: 43 6f 6c 20 6f 66 20 74 68 65 20 67 69 76 65 6e  Col of the given
26e0: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 76 61   statement is va
26f0: 6c 69 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20 69  lid.  If.** it i
2700: 73 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e  s, return a poin
2710: 74 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 20 66  ter to the Mem f
2720: 6f 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  or the value of 
2730: 74 68 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20  that column..** 
2740: 49 66 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20 76  If iCol is not v
2750: 61 6c 69 64 2c 20 72 65 74 75 72 6e 20 61 20 70  alid, return a p
2760: 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 20  ointer to a Mem 
2770: 77 68 69 63 68 20 68 61 73 20 61 20 76 61 6c 75  which has a valu
2780: 65 0a 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a 2f  e.** of NULL..*/
2790: 0a 73 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f 6c  .static Mem *col
27a0: 75 6d 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f 73  umnMem(sqlite3_s
27b0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
27c0: 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20  i){.  Vdbe *pVm 
27d0: 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b  = (Vdbe *)pStmt;
27e0: 0a 20 20 69 6e 74 20 76 61 6c 73 20 3d 20 73 71  .  int vals = sq
27f0: 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74  lite3_data_count
2800: 28 70 53 74 6d 74 29 3b 0a 20 20 69 66 28 20 69  (pStmt);.  if( i
2810: 3e 3d 76 61 6c 73 20 7c 7c 20 69 3c 30 20 29 7b  >=vals || i<0 ){
2820: 0a 20 20 20 20 73 74 61 74 69 63 20 4d 65 6d 20  .    static Mem 
2830: 6e 75 6c 6c 4d 65 6d 3b 0a 20 20 20 20 69 66 28  nullMem;.    if(
2840: 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 67 73 3d 3d   nullMem.flags==
2850: 30 20 29 7b 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61  0 ){ nullMem.fla
2860: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 20 7d  gs = MEM_Null; }
2870: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
2880: 72 28 70 56 6d 2d 3e 64 62 2c 20 53 51 4c 49 54  r(pVm->db, SQLIT
2890: 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20  E_RANGE, 0);.   
28a0: 20 72 65 74 75 72 6e 20 26 6e 75 6c 6c 4d 65 6d   return &nullMem
28b0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 26  ;.  }.  return &
28c0: 70 56 6d 2d 3e 70 54 6f 73 5b 28 31 2d 76 61 6c  pVm->pTos[(1-val
28d0: 73 29 2b 69 5d 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a  s)+i];.}../*****
28e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
28f0: 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f  ******* sqlite3_
2900: 63 6f 6c 75 6d 6e 5f 20 20 2a 2a 2a 2a 2a 2a 2a  column_  *******
2910: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2920: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20  ********.** The 
2930: 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e  following routin
2940: 65 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 61  es are used to a
2950: 63 63 65 73 73 20 65 6c 65 6d 65 6e 74 73 20 6f  ccess elements o
2960: 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f  f the current ro
2970: 77 0a 2a 2a 20 69 6e 20 74 68 65 20 72 65 73 75  w.** in the resu
2980: 6c 74 20 73 65 74 2e 0a 2a 2f 0a 63 6f 6e 73 74  lt set..*/.const
2990: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
29a0: 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 73 71 6c 69 74  olumn_blob(sqlit
29b0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
29c0: 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e  int i){.  return
29d0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62   sqlite3_value_b
29e0: 6c 6f 62 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70  lob( columnMem(p
29f0: 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74  Stmt,i) );.}.int
2a00: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
2a10: 62 79 74 65 73 28 73 71 6c 69 74 65 33 5f 73 74  bytes(sqlite3_st
2a20: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
2a30: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
2a40: 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28  te3_value_bytes(
2a50: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
2a60: 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c  ,i) );.}.int sql
2a70: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65  ite3_column_byte
2a80: 73 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  s16(sqlite3_stmt
2a90: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
2aa0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
2ab0: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28  3_value_bytes16(
2ac0: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
2ad0: 2c 69 29 20 29 3b 0a 7d 0a 64 6f 75 62 6c 65 20  ,i) );.}.double 
2ae0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
2af0: 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74  ouble(sqlite3_st
2b00: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
2b10: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
2b20: 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65  te3_value_double
2b30: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d  ( columnMem(pStm
2b40: 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 20 73 71  t,i) );.}.int sq
2b50: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74  lite3_column_int
2b60: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
2b70: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20  Stmt, int i){.  
2b80: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76  return sqlite3_v
2b90: 61 6c 75 65 5f 69 6e 74 28 20 63 6f 6c 75 6d 6e  alue_int( column
2ba0: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a  Mem(pStmt,i) );.
2bb0: 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73  }.sqlite_int64 s
2bc0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e  qlite3_column_in
2bd0: 74 36 34 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  t64(sqlite3_stmt
2be0: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
2bf0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
2c00: 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 20 63  3_value_int64( c
2c10: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69  olumnMem(pStmt,i
2c20: 29 20 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73  ) );.}.const uns
2c30: 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69  igned char *sqli
2c40: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28  te3_column_text(
2c50: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
2c60: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72  tmt, int i){.  r
2c70: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61  eturn sqlite3_va
2c80: 6c 75 65 5f 74 65 78 74 28 20 63 6f 6c 75 6d 6e  lue_text( column
2c90: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a  Mem(pStmt,i) );.
2ca0: 7d 0a 23 69 66 20 30 0a 73 71 6c 69 74 65 33 5f  }.#if 0.sqlite3_
2cb0: 76 61 6c 75 65 20 2a 73 71 6c 69 74 65 33 5f 63  value *sqlite3_c
2cc0: 6f 6c 75 6d 6e 5f 76 61 6c 75 65 28 73 71 6c 69  olumn_value(sqli
2cd0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
2ce0: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
2cf0: 6e 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d  n columnMem(pStm
2d00: 74 2c 20 69 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a  t, i);.}.#endif.
2d10: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
2d20: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
2d30: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f  void *sqlite3_co
2d40: 6c 75 6d 6e 5f 74 65 78 74 31 36 28 73 71 6c 69  lumn_text16(sqli
2d50: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
2d60: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72   int i){.  retur
2d70: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  n sqlite3_value_
2d80: 74 65 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d 65  text16( columnMe
2d90: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a  m(pStmt,i) );.}.
2da0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
2db0: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69  _OMIT_UTF16 */.i
2dc0: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  nt sqlite3_colum
2dd0: 6e 5f 74 79 70 65 28 73 71 6c 69 74 65 33 5f 73  n_type(sqlite3_s
2de0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
2df0: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  i){.  return sql
2e00: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
2e10: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
2e20: 2c 69 29 20 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ,i) );.}../*.** 
2e30: 43 6f 6e 76 65 72 74 20 74 68 65 20 4e 2d 74 68  Convert the N-th
2e40: 20 65 6c 65 6d 65 6e 74 20 6f 66 20 70 53 74 6d   element of pStm
2e50: 74 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d 20 69 6e  t->pColName[] in
2e60: 74 6f 20 61 20 73 74 72 69 6e 67 20 75 73 69 6e  to a string usin
2e70: 67 0a 2a 2a 20 78 46 75 6e 63 28 29 20 74 68 65  g.** xFunc() the
2e80: 6e 20 72 65 74 75 72 6e 20 74 68 61 74 20 73 74  n return that st
2e90: 72 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 20 6f  ring.  If N is o
2ea0: 75 74 20 6f 66 20 72 61 6e 67 65 2c 20 72 65 74  ut of range, ret
2eb0: 75 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  urn 0..**.** The
2ec0: 72 65 20 61 72 65 20 75 70 20 74 6f 20 35 20 6e  re are up to 5 n
2ed0: 61 6d 65 73 20 66 6f 72 20 65 61 63 68 20 63 6f  ames for each co
2ee0: 6c 75 6d 6e 2e 20 20 75 73 65 54 79 70 65 20 64  lumn.  useType d
2ef0: 65 74 65 72 6d 69 6e 65 73 20 77 68 69 63 68 0a  etermines which.
2f00: 2a 2a 20 6e 61 6d 65 20 69 73 20 72 65 74 75 72  ** name is retur
2f10: 6e 65 64 2e 20 20 48 65 72 65 20 61 72 65 20 74  ned.  Here are t
2f20: 68 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20  he names:.**.** 
2f30: 20 20 20 30 20 20 20 20 20 20 54 68 65 20 63 6f     0      The co
2f40: 6c 75 6d 6e 20 6e 61 6d 65 20 61 73 20 69 74 20  lumn name as it 
2f50: 73 68 6f 75 6c 64 20 62 65 20 64 69 73 70 6c 61  should be displa
2f60: 79 65 64 20 66 6f 72 20 6f 75 74 70 75 74 0a 2a  yed for output.*
2f70: 2a 20 20 20 20 31 20 20 20 20 20 20 54 68 65 20  *    1      The 
2f80: 64 61 74 61 74 79 70 65 20 6e 61 6d 65 20 66 6f  datatype name fo
2f90: 72 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 2a 2a 20  r the column.** 
2fa0: 20 20 20 32 20 20 20 20 20 20 54 68 65 20 6e 61     2      The na
2fb0: 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  me of the databa
2fc0: 73 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75  se that the colu
2fd0: 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a  mn derives from.
2fe0: 2a 2a 20 20 20 20 33 20 20 20 20 20 20 54 68 65  **    3      The
2ff0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
3000: 6c 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75  le that the colu
3010: 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a  mn derives from.
3020: 2a 2a 20 20 20 20 34 20 20 20 20 20 20 54 68 65  **    4      The
3030: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
3040: 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 74  le column that t
3050: 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e  he result column
3060: 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a 2a 2a   derives from.**
3070: 0a 2a 2a 20 49 66 20 74 68 65 20 72 65 73 75 6c  .** If the resul
3080: 74 20 69 73 20 6e 6f 74 20 61 20 73 69 6d 70 6c  t is not a simpl
3090: 65 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 65 6e  e column referen
30a0: 63 65 20 28 69 66 20 69 74 20 69 73 20 61 6e 20  ce (if it is an 
30b0: 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 6f 72  expression.** or
30c0: 20 61 20 63 6f 6e 73 74 61 6e 74 29 20 74 68 65   a constant) the
30d0: 6e 20 75 73 65 54 79 70 65 73 20 32 2c 20 33 2c  n useTypes 2, 3,
30e0: 20 61 6e 64 20 34 20 72 65 74 75 72 6e 20 4e 55   and 4 return NU
30f0: 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f  LL..*/.static co
3100: 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c 75 6d 6e  nst void *column
3110: 4e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33 5f  Name(.  sqlite3_
3120: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 0a 20 20 69  stmt *pStmt,.  i
3130: 6e 74 20 4e 2c 0a 20 20 63 6f 6e 73 74 20 76 6f  nt N,.  const vo
3140: 69 64 20 2a 28 2a 78 46 75 6e 63 29 28 4d 65 6d  id *(*xFunc)(Mem
3150: 2a 29 2c 0a 20 20 69 6e 74 20 75 73 65 54 79 70  *),.  int useTyp
3160: 65 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d  e.){.  Vdbe *p =
3170: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a   (Vdbe *)pStmt;.
3180: 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c 69 74 65    int n = sqlite
3190: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70  3_column_count(p
31a0: 53 74 6d 74 29 3b 0a 0a 20 20 69 66 28 20 70 3d  Stmt);..  if( p=
31b0: 3d 30 20 7c 7c 20 4e 3e 3d 6e 20 7c 7c 20 4e 3c  =0 || N>=n || N<
31c0: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
31d0: 30 3b 0a 20 20 7d 0a 20 20 4e 20 2b 3d 20 75 73  0;.  }.  N += us
31e0: 65 54 79 70 65 2a 6e 3b 0a 20 20 72 65 74 75 72  eType*n;.  retur
31f0: 6e 20 78 46 75 6e 63 28 26 70 2d 3e 61 43 6f 6c  n xFunc(&p->aCol
3200: 4e 61 6d 65 5b 4e 5d 29 3b 0a 7d 0a 0a 0a 2f 2a  Name[N]);.}.../*
3210: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
3220: 61 6d 65 20 6f 66 20 74 68 65 20 4e 74 68 20 63  ame of the Nth c
3230: 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73  olumn of the res
3240: 75 6c 74 20 73 65 74 20 72 65 74 75 72 6e 65 64  ult set returned
3250: 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74 61 74 65   by SQL.** state
3260: 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 63  ment pStmt..*/.c
3270: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74  onst char *sqlit
3280: 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 73  e3_column_name(s
3290: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
32a0: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65  mt, int N){.  re
32b0: 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28  turn columnName(
32c0: 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74  pStmt, N, (const
32d0: 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29   void*(*)(Mem*))
32e0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
32f0: 78 74 2c 20 30 29 3b 0a 7d 0a 23 69 66 6e 64 65  xt, 0);.}.#ifnde
3300: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  f SQLITE_OMIT_UT
3310: 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a  F16.const void *
3320: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e  sqlite3_column_n
3330: 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73 74  ame16(sqlite3_st
3340: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e  mt *pStmt, int N
3350: 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75  ){.  return colu
3360: 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c  mnName(pStmt, N,
3370: 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29   (const void*(*)
3380: 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76  (Mem*))sqlite3_v
3390: 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 30 29 3b  alue_text16, 0);
33a0: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  .}.#endif../*.**
33b0: 20 52 65 74 75 72 6e 20 74 68 65 20 63 6f 6c 75   Return the colu
33c0: 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 74  mn declaration t
33d0: 79 70 65 20 28 69 66 20 61 70 70 6c 69 63 61 62  ype (if applicab
33e0: 6c 65 29 20 6f 66 20 74 68 65 20 27 69 27 74 68  le) of the 'i'th
33f0: 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74 68   column.** of th
3400: 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66 20  e result set of 
3410: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 70 53  SQL statement pS
3420: 74 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68  tmt..*/.const ch
3430: 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ar *sqlite3_colu
3440: 6d 6e 5f 64 65 63 6c 74 79 70 65 28 73 71 6c 69  mn_decltype(sqli
3450: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
3460: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72   int N){.  retur
3470: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74  n columnName(pSt
3480: 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f  mt, N, (const vo
3490: 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c  id*(*)(Mem*))sql
34a0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c  ite3_value_text,
34b0: 20 31 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53   1);.}.#ifndef S
34c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
34d0: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
34e0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c  ite3_column_decl
34f0: 74 79 70 65 31 36 28 73 71 6c 69 74 65 33 5f 73  type16(sqlite3_s
3500: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
3510: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c  N){.  return col
3520: 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e  umnName(pStmt, N
3530: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a  , (const void*(*
3540: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f  )(Mem*))sqlite3_
3550: 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 31 29  value_text16, 1)
3560: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
3570: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20  LITE_OMIT_UTF16 
3580: 2a 2f 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64  */..#if !defined
3590: 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4f 52 49  (SQLITE_OMIT_ORI
35a0: 47 49 4e 5f 4e 41 4d 45 53 29 20 26 26 20 30 0a  GIN_NAMES) && 0.
35b0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
35c0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74   name of the dat
35d0: 61 62 61 73 65 20 66 72 6f 6d 20 77 68 69 63 68  abase from which
35e0: 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e   a result column
35f0: 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c   derives..** NUL
3600: 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66  L is returned if
3610: 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75   the result colu
3620: 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73 73  mn is an express
3630: 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e 74 20  ion or constant 
3640: 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20 65  or.** anything e
3650: 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e 6f 74  lse which is not
3660: 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73 20 72   an unabiguous r
3670: 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 64 61  eference to a da
3680: 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a  tabase column..*
3690: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  /.const char *sq
36a0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74  lite3_column_dat
36b0: 61 62 61 73 65 5f 6e 61 6d 65 28 73 71 6c 69 74  abase_name(sqlit
36c0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
36d0: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
36e0: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d   columnName(pStm
36f0: 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69  t, N, (const voi
3700: 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69  d*(*)(Mem*))sqli
3710: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c 20  te3_value_text, 
3720: 32 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51  2);.}.#ifndef SQ
3730: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
3740: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
3750: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62  te3_column_datab
3760: 61 73 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74  ase_name16(sqlit
3770: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
3780: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
3790: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d   columnName(pStm
37a0: 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69  t, N, (const voi
37b0: 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69  d*(*)(Mem*))sqli
37c0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36  te3_value_text16
37d0: 2c 20 32 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  , 2);.}.#endif /
37e0: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  * SQLITE_OMIT_UT
37f0: 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65  F16 */../*.** Re
3800: 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66  turn the name of
3810: 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f 6d 20   the table from 
3820: 77 68 69 63 68 20 61 20 72 65 73 75 6c 74 20 63  which a result c
3830: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a  olumn derives..*
3840: 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e  * NULL is return
3850: 65 64 20 69 66 20 74 68 65 20 72 65 73 75 6c 74  ed if the result
3860: 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78   column is an ex
3870: 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73  pression or cons
3880: 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68  tant or.** anyth
3890: 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20 69  ing else which i
38a0: 73 20 6e 6f 74 20 61 6e 20 75 6e 61 62 69 67 75  s not an unabigu
38b0: 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f  ous reference to
38c0: 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75   a database colu
38d0: 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  mn..*/.const cha
38e0: 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  r *sqlite3_colum
38f0: 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 28 73 71 6c  n_table_name(sql
3900: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
3910: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
3920: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53  rn columnName(pS
3930: 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76  tmt, N, (const v
3940: 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71  oid*(*)(Mem*))sq
3950: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
3960: 2c 20 33 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20  , 3);.}.#ifndef 
3970: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
3980: 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  6.const void *sq
3990: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62  lite3_column_tab
39a0: 6c 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65  le_name16(sqlite
39b0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
39c0: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt N){.  return 
39d0: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74  columnName(pStmt
39e0: 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64  , N, (const void
39f0: 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74  *(*)(Mem*))sqlit
3a00: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c  e3_value_text16,
3a10: 20 33 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a   3);.}.#endif /*
3a20: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
3a30: 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  16 */../*.** Ret
3a40: 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  urn the name of 
3a50: 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e  the table column
3a60: 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72 65   from which a re
3a70: 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69  sult column deri
3a80: 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20  ves..** NULL is 
3a90: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20  returned if the 
3aa0: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 73  result column is
3ab0: 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f   an expression o
3ac0: 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a  r constant or.**
3ad0: 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 77   anything else w
3ae0: 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20 75  hich is not an u
3af0: 6e 61 62 69 67 75 6f 75 73 20 72 65 66 65 72 65  nabiguous refere
3b00: 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62 61 73  nce to a databas
3b10: 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e  e column..*/.con
3b20: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33  st char *sqlite3
3b30: 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e  _column_origin_n
3b40: 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ame(sqlite3_stmt
3b50: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b   *pStmt, int N){
3b60: 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e  .  return column
3b70: 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28  Name(pStmt, N, (
3b80: 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d  const void*(*)(M
3b90: 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c  em*))sqlite3_val
3ba0: 75 65 5f 74 65 78 74 2c 20 34 29 3b 0a 7d 0a 23  ue_text, 4);.}.#
3bb0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
3bc0: 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76  IT_UTF16.const v
3bd0: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  oid *sqlite3_col
3be0: 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31  umn_origin_name1
3bf0: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
3c00: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
3c10: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
3c20: 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f  me(pStmt, N, (co
3c30: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
3c40: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
3c50: 5f 74 65 78 74 31 36 2c 20 34 29 3b 0a 7d 0a 23  _text16, 4);.}.#
3c60: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
3c70: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 23 65  OMIT_UTF16 */.#e
3c80: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f  ndif /* SQLITE_O
3c90: 4d 49 54 5f 4f 52 49 47 49 4e 5f 4e 41 4d 45 53  MIT_ORIGIN_NAMES
3ca0: 20 2a 2f 0a 0a 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a   */...../*******
3cb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3cc0: 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33  ******** sqlite3
3cd0: 5f 62 69 6e 64 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a  _bind_  ********
3ce0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3cf0: 2a 2a 2a 0a 2a 2a 20 0a 2a 2a 20 52 6f 75 74 69  ***.** .** Routi
3d00: 6e 65 73 20 75 73 65 64 20 74 6f 20 61 74 74 61  nes used to atta
3d10: 63 68 20 76 61 6c 75 65 73 20 74 6f 20 77 69 6c  ch values to wil
3d20: 64 63 61 72 64 73 20 69 6e 20 61 20 63 6f 6d 70  dcards in a comp
3d30: 69 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65  iled SQL stateme
3d40: 6e 74 2e 0a 2a 2f 0a 2f 2a 0a 2a 2a 20 55 6e 62  nt..*/./*.** Unb
3d50: 69 6e 64 20 74 68 65 20 76 61 6c 75 65 20 62 6f  ind the value bo
3d60: 75 6e 64 20 74 6f 20 76 61 72 69 61 62 6c 65 20  und to variable 
3d70: 69 20 69 6e 20 76 69 72 74 75 61 6c 20 6d 61 63  i in virtual mac
3d80: 68 69 6e 65 20 70 2e 20 54 68 69 73 20 69 73 20  hine p. This is 
3d90: 74 68 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d 65  the .** the same
3da0: 20 61 73 20 62 69 6e 64 69 6e 67 20 61 20 4e 55   as binding a NU
3db0: 4c 4c 20 76 61 6c 75 65 20 74 6f 20 74 68 65 20  LL value to the 
3dc0: 63 6f 6c 75 6d 6e 2e 20 49 66 20 74 68 65 20 22  column. If the "
3dd0: 69 22 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a  i" parameter is.
3de0: 2a 2a 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c  ** out of range,
3df0: 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 52 41 4e   then SQLITE_RAN
3e00: 47 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20  GE is returned. 
3e10: 4f 74 68 65 77 69 73 65 20 53 51 4c 49 54 45 5f  Othewise SQLITE_
3e20: 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65 72  OK..**.** The er
3e30: 72 6f 72 20 63 6f 64 65 20 73 74 6f 72 65 64 20  ror code stored 
3e40: 69 6e 20 64 61 74 61 62 61 73 65 20 70 2d 3e 64  in database p->d
3e50: 62 20 69 73 20 6f 76 65 72 77 72 69 74 74 65 6e  b is overwritten
3e60: 20 77 69 74 68 20 74 68 65 20 72 65 74 75 72 6e   with the return
3e70: 0a 2a 2a 20 76 61 6c 75 65 20 69 6e 20 61 6e 79  .** value in any
3e80: 20 63 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63   case..*/.static
3e90: 20 69 6e 74 20 76 64 62 65 55 6e 62 69 6e 64 28   int vdbeUnbind(
3ea0: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 69 29 7b  Vdbe *p, int i){
3eb0: 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20 20  .  Mem *pVar;.  
3ec0: 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 6d  if( p==0 || p->m
3ed0: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43  agic!=VDBE_MAGIC
3ee0: 5f 52 55 4e 20 7c 7c 20 70 2d 3e 70 63 3e 3d 30  _RUN || p->pc>=0
3ef0: 20 29 7b 0a 20 20 20 20 69 66 28 20 70 20 29 20   ){.    if( p ) 
3f00: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e  sqlite3Error(p->
3f10: 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  db, SQLITE_MISUS
3f20: 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72  E, 0);.    retur
3f30: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
3f40: 0a 20 20 7d 0a 20 20 69 66 28 20 69 3c 31 20 7c  .  }.  if( i<1 |
3f50: 7c 20 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20  | i>p->nVar ){. 
3f60: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
3f70: 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41  p->db, SQLITE_RA
3f80: 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74  NGE, 0);.    ret
3f90: 75 72 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  urn SQLITE_RANGE
3fa0: 3b 0a 20 20 7d 0a 20 20 69 2d 2d 3b 0a 20 20 70  ;.  }.  i--;.  p
3fb0: 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69  Var = &p->aVar[i
3fc0: 5d 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  ];.  sqlite3Vdbe
3fd0: 4d 65 6d 52 65 6c 65 61 73 65 28 70 56 61 72 29  MemRelease(pVar)
3fe0: 3b 0a 20 20 70 56 61 72 2d 3e 66 6c 61 67 73 20  ;.  pVar->flags 
3ff0: 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 73 71  = MEM_Null;.  sq
4000: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62  lite3Error(p->db
4010: 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b  , SQLITE_OK, 0);
4020: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
4030: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 69  _OK;.}../*.** Bi
4040: 6e 64 20 61 20 74 65 78 74 20 6f 72 20 42 4c 4f  nd a text or BLO
4050: 42 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74  B value..*/.stat
4060: 69 63 20 69 6e 74 20 62 69 6e 64 54 65 78 74 28  ic int bindText(
4070: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
4080: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69  *pStmt, .  int i
4090: 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  , .  const void 
40a0: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e  *zData, .  int n
40b0: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a  Data, .  void (*
40c0: 78 44 65 6c 29 28 76 6f 69 64 2a 29 2c 0a 20 20  xDel)(void*),.  
40d0: 69 6e 74 20 65 6e 63 6f 64 69 6e 67 0a 29 7b 0a  int encoding.){.
40e0: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
40f0: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d  e *)pStmt;.  Mem
4100: 20 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72 63   *pVar;.  int rc
4110: 3b 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e  ;..  rc = vdbeUn
4120: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66  bind(p, i);.  if
4130: 28 20 72 63 20 7c 7c 20 7a 44 61 74 61 3d 3d 30  ( rc || zData==0
4140: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72   ){.    return r
4150: 63 3b 0a 20 20 7d 0a 20 20 70 56 61 72 20 3d 20  c;.  }.  pVar = 
4160: 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 3b 0a 20  &p->aVar[i-1];. 
4170: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
4180: 65 4d 65 6d 53 65 74 53 74 72 28 70 56 61 72 2c  eMemSetStr(pVar,
4190: 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 65   zData, nData, e
41a0: 6e 63 6f 64 69 6e 67 2c 20 78 44 65 6c 29 3b 0a  ncoding, xDel);.
41b0: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20    if( rc ){.    
41c0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20  return rc;.  }. 
41d0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
41e0: 4f 4b 20 26 26 20 65 6e 63 6f 64 69 6e 67 21 3d  OK && encoding!=
41f0: 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71  0 ){.    rc = sq
4200: 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 45  lite3VdbeChangeE
4210: 6e 63 6f 64 69 6e 67 28 70 56 61 72 2c 20 70 2d  ncoding(pVar, p-
4220: 3e 64 62 2d 3e 65 6e 63 29 3b 0a 20 20 7d 0a 20  >db->enc);.  }. 
4230: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a   return rc;.}...
4240: 2f 2a 0a 2a 2a 20 42 69 6e 64 20 61 20 62 6c 6f  /*.** Bind a blo
4250: 62 20 76 61 6c 75 65 20 74 6f 20 61 6e 20 53 51  b value to an SQ
4260: 4c 20 73 74 61 74 65 6d 65 6e 74 20 76 61 72 69  L statement vari
4270: 61 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  able..*/.int sql
4280: 69 74 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 28 0a  ite3_bind_blob(.
4290: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
42a0: 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c  pStmt, .  int i,
42b0: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
42c0: 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e 44  zData, .  int nD
42d0: 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78  ata, .  void (*x
42e0: 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20  Del)(void*).){. 
42f0: 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78 74   return bindText
4300: 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61  (pStmt, i, zData
4310: 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20 30  , nData, xDel, 0
4320: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  );.}.int sqlite3
4330: 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28 73 71 6c  _bind_double(sql
4340: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
4350: 2c 20 69 6e 74 20 69 2c 20 64 6f 75 62 6c 65 20  , int i, double 
4360: 72 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72  rValue){.  int r
4370: 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  c;.  Vdbe *p = (
4380: 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20  Vdbe *)pStmt;.  
4390: 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28  rc = vdbeUnbind(
43a0: 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d  p, i);.  if( rc=
43b0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
43c0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
43d0: 53 65 74 44 6f 75 62 6c 65 28 26 70 2d 3e 61 56  SetDouble(&p->aV
43e0: 61 72 5b 69 2d 31 5d 2c 20 72 56 61 6c 75 65 29  ar[i-1], rValue)
43f0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
4400: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  c;.}.int sqlite3
4410: 5f 62 69 6e 64 5f 69 6e 74 28 73 71 6c 69 74 65  _bind_int(sqlite
4420: 33 5f 73 74 6d 74 20 2a 70 2c 20 69 6e 74 20 69  3_stmt *p, int i
4430: 2c 20 69 6e 74 20 69 56 61 6c 75 65 29 7b 0a 20  , int iValue){. 
4440: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f   return sqlite3_
4450: 62 69 6e 64 5f 69 6e 74 36 34 28 70 2c 20 69 2c  bind_int64(p, i,
4460: 20 28 69 36 34 29 69 56 61 6c 75 65 29 3b 0a 7d   (i64)iValue);.}
4470: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
4480: 64 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f  d_int64(sqlite3_
4490: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
44a0: 20 69 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34   i, sqlite_int64
44b0: 20 69 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20   iValue){.  int 
44c0: 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  rc;.  Vdbe *p = 
44d0: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20  (Vdbe *)pStmt;. 
44e0: 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64   rc = vdbeUnbind
44f0: 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63  (p, i);.  if( rc
4500: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
4510: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
4520: 6d 53 65 74 49 6e 74 36 34 28 26 70 2d 3e 61 56  mSetInt64(&p->aV
4530: 61 72 5b 69 2d 31 5d 2c 20 69 56 61 6c 75 65 29  ar[i-1], iValue)
4540: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
4550: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  c;.}.int sqlite3
4560: 5f 62 69 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69 74  _bind_null(sqlit
4570: 65 33 5f 73 74 6d 74 2a 20 70 2c 20 69 6e 74 20  e3_stmt* p, int 
4580: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 76 64 62  i){.  return vdb
4590: 65 55 6e 62 69 6e 64 28 28 56 64 62 65 20 2a 29  eUnbind((Vdbe *)
45a0: 70 2c 20 69 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c  p, i);.}.int sql
45b0: 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 28 20  ite3_bind_text( 
45c0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
45d0: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69  *pStmt, .  int i
45e0: 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  , .  const char 
45f0: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e  *zData, .  int n
4600: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a  Data, .  void (*
4610: 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a  xDel)(void*).){.
4620: 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78    return bindTex
4630: 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74  t(pStmt, i, zDat
4640: 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20  a, nData, xDel, 
4650: 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d 0a  SQLITE_UTF8);.}.
4660: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
4670: 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71  MIT_UTF16.int sq
4680: 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31  lite3_bind_text1
4690: 36 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d  6(.  sqlite3_stm
46a0: 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74  t *pStmt, .  int
46b0: 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69   i, .  const voi
46c0: 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74  d *zData, .  int
46d0: 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20   nData, .  void 
46e0: 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29  (*xDel)(void*).)
46f0: 7b 0a 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54  {.  return bindT
4700: 65 78 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44  ext(pStmt, i, zD
4710: 61 74 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c  ata, nData, xDel
4720: 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41  , SQLITE_UTF16NA
4730: 54 49 56 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20  TIVE);.}.#endif 
4740: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  /* SQLITE_OMIT_U
4750: 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52  TF16 */../*.** R
4760: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
4770: 20 6f 66 20 77 69 6c 64 63 61 72 64 73 20 74 68   of wildcards th
4780: 61 74 20 63 61 6e 20 62 65 20 70 6f 74 65 6e 74  at can be potent
4790: 69 61 6c 6c 79 20 62 6f 75 6e 64 20 74 6f 2e 0a  ially bound to..
47a0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
47b0: 69 73 20 61 64 64 65 64 20 74 6f 20 73 75 70 70  is added to supp
47c0: 6f 72 74 20 44 42 44 3a 3a 53 51 4c 69 74 65 2e  ort DBD::SQLite.
47d0: 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65    .*/.int sqlite
47e0: 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72  3_bind_parameter
47f0: 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73  _count(sqlite3_s
4800: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56  tmt *pStmt){.  V
4810: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29  dbe *p = (Vdbe*)
4820: 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20  pStmt;.  return 
4830: 70 20 3f 20 70 2d 3e 6e 56 61 72 20 3a 20 30 3b  p ? p->nVar : 0;
4840: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65  .}../*.** Create
4850: 20 61 20 6d 61 70 70 69 6e 67 20 66 72 6f 6d 20   a mapping from 
4860: 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 73  variable numbers
4870: 20 74 6f 20 76 61 72 69 61 62 6c 65 20 6e 61 6d   to variable nam
4880: 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 56 64 62  es.** in the Vdb
4890: 65 2e 61 7a 56 61 72 5b 5d 20 61 72 72 61 79 2c  e.azVar[] array,
48a0: 20 69 66 20 73 75 63 68 20 61 20 6d 61 70 70 69   if such a mappi
48b0: 6e 67 20 64 6f 65 73 20 6e 6f 74 20 61 6c 72 65  ng does not alre
48c0: 61 64 79 0a 2a 2a 20 65 78 69 73 74 2e 0a 2a 2f  ady.** exist..*/
48d0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 72 65  .static void cre
48e0: 61 74 65 56 61 72 4d 61 70 28 56 64 62 65 20 2a  ateVarMap(Vdbe *
48f0: 70 29 7b 0a 20 20 69 66 28 20 21 70 2d 3e 6f 6b  p){.  if( !p->ok
4900: 56 61 72 20 29 7b 0a 20 20 20 20 69 6e 74 20 6a  Var ){.    int j
4910: 3b 0a 20 20 20 20 4f 70 20 2a 70 4f 70 3b 0a 20  ;.    Op *pOp;. 
4920: 20 20 20 66 6f 72 28 6a 3d 30 2c 20 70 4f 70 3d     for(j=0, pOp=
4930: 70 2d 3e 61 4f 70 3b 20 6a 3c 70 2d 3e 6e 4f 70  p->aOp; j<p->nOp
4940: 3b 20 6a 2b 2b 2c 20 70 4f 70 2b 2b 29 7b 0a 20  ; j++, pOp++){. 
4950: 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 6f 70       if( pOp->op
4960: 63 6f 64 65 3d 3d 4f 50 5f 56 61 72 69 61 62 6c  code==OP_Variabl
4970: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73  e ){.        ass
4980: 65 72 74 28 20 70 4f 70 2d 3e 70 31 3e 30 20 26  ert( pOp->p1>0 &
4990: 26 20 70 4f 70 2d 3e 70 31 3c 3d 70 2d 3e 6e 56  & pOp->p1<=p->nV
49a0: 61 72 20 29 3b 0a 20 20 20 20 20 20 20 20 70 2d  ar );.        p-
49b0: 3e 61 7a 56 61 72 5b 70 4f 70 2d 3e 70 31 2d 31  >azVar[pOp->p1-1
49c0: 5d 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a 20 20 20  ] = pOp->p3;.   
49d0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 70     }.    }.    p
49e0: 2d 3e 6f 6b 56 61 72 20 3d 20 31 3b 0a 20 20 7d  ->okVar = 1;.  }
49f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
4a00: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 77   the name of a w
4a10: 69 6c 64 63 61 72 64 20 70 61 72 61 6d 65 74 65  ildcard paramete
4a20: 72 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20  r.  Return NULL 
4a30: 69 66 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a 20  if the index.** 
4a40: 69 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 20  is out of range 
4a50: 6f 72 20 69 66 20 74 68 65 20 77 69 6c 64 63 61  or if the wildca
4a60: 72 64 20 69 73 20 75 6e 6e 61 6d 65 64 2e 0a 2a  rd is unnamed..*
4a70: 2a 0a 2a 2a 20 54 68 65 20 72 65 73 75 6c 74 20  *.** The result 
4a80: 69 73 20 61 6c 77 61 79 73 20 55 54 46 2d 38 2e  is always UTF-8.
4a90: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a  .*/.const char *
4aa0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61 72  sqlite3_bind_par
4ab0: 61 6d 65 74 65 72 5f 6e 61 6d 65 28 73 71 6c 69  ameter_name(sqli
4ac0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
4ad0: 20 69 6e 74 20 69 29 7b 0a 20 20 56 64 62 65 20   int i){.  Vdbe 
4ae0: 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d  *p = (Vdbe*)pStm
4af0: 74 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c  t;.  if( p==0 ||
4b00: 20 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56 61   i<1 || i>p->nVa
4b10: 72 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  r ){.    return 
4b20: 30 3b 0a 20 20 7d 0a 20 20 63 72 65 61 74 65 56  0;.  }.  createV
4b30: 61 72 4d 61 70 28 70 29 3b 0a 20 20 72 65 74 75  arMap(p);.  retu
4b40: 72 6e 20 70 2d 3e 61 7a 56 61 72 5b 69 2d 31 5d  rn p->azVar[i-1]
4b50: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e  ;.}../*.** Given
4b60: 20 61 20 77 69 6c 64 63 61 72 64 20 70 61 72 61   a wildcard para
4b70: 6d 65 74 65 72 20 6e 61 6d 65 2c 20 72 65 74 75  meter name, retu
4b80: 72 6e 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20  rn the index of 
4b90: 74 68 65 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20  the variable.** 
4ba0: 77 69 74 68 20 74 68 61 74 20 6e 61 6d 65 2e 20  with that name. 
4bb0: 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20   If there is no 
4bc0: 76 61 72 69 61 62 6c 65 20 77 69 74 68 20 74 68  variable with th
4bd0: 65 20 67 69 76 65 6e 20 6e 61 6d 65 2c 0a 2a 2a  e given name,.**
4be0: 20 72 65 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69 6e   return 0..*/.in
4bf0: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70  t sqlite3_bind_p
4c00: 61 72 61 6d 65 74 65 72 5f 69 6e 64 65 78 28 73  arameter_index(s
4c10: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
4c20: 6d 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  mt, const char *
4c30: 7a 4e 61 6d 65 29 7b 0a 20 20 56 64 62 65 20 2a  zName){.  Vdbe *
4c40: 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74  p = (Vdbe*)pStmt
4c50: 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28  ;.  int i;.  if(
4c60: 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74   p==0 ){.    ret
4c70: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 63 72 65  urn 0;.  }.  cre
4c80: 61 74 65 56 61 72 4d 61 70 28 70 29 3b 20 0a 20  ateVarMap(p); . 
4c90: 20 69 66 28 20 7a 4e 61 6d 65 20 29 7b 0a 20 20   if( zName ){.  
4ca0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e    for(i=0; i<p->
4cb0: 6e 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nVar; i++){.    
4cc0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20    const char *z 
4cd0: 3d 20 70 2d 3e 61 7a 56 61 72 5b 69 5d 3b 0a 20  = p->azVar[i];. 
4ce0: 20 20 20 20 20 69 66 28 20 7a 20 26 26 20 73 74       if( z && st
4cf0: 72 63 6d 70 28 7a 2c 7a 4e 61 6d 65 29 3d 3d 30  rcmp(z,zName)==0
4d00: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75   ){.        retu
4d10: 72 6e 20 69 2b 31 3b 0a 20 20 20 20 20 20 7d 0a  rn i+1;.      }.
4d20: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
4d30: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  rn 0;.}../*.** T
4d40: 72 61 6e 73 66 65 72 20 61 6c 6c 20 62 69 6e 64  ransfer all bind
4d50: 69 6e 67 73 20 66 72 6f 6d 20 74 68 65 20 66 69  ings from the fi
4d60: 72 73 74 20 73 74 61 74 65 6d 65 6e 74 20 6f 76  rst statement ov
4d70: 65 72 20 74 6f 20 74 68 65 20 73 65 63 6f 6e 64  er to the second
4d80: 2e 0a 2a 2a 20 49 66 20 74 68 65 20 74 77 6f 20  ..** If the two 
4d90: 73 74 61 74 65 6d 65 6e 74 73 20 63 6f 6e 74 61  statements conta
4da0: 69 6e 20 61 20 64 69 66 66 65 72 65 6e 74 20 6e  in a different n
4db0: 75 6d 62 65 72 20 6f 66 20 62 69 6e 64 69 6e 67  umber of binding
4dc0: 73 2c 20 74 68 65 6e 0a 2a 2a 20 61 6e 20 53 51  s, then.** an SQ
4dd0: 4c 49 54 45 5f 45 52 52 4f 52 20 69 73 20 72 65  LITE_ERROR is re
4de0: 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  turned..*/.int s
4df0: 71 6c 69 74 65 33 5f 74 72 61 6e 73 66 65 72 5f  qlite3_transfer_
4e00: 62 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33  bindings(sqlite3
4e10: 5f 73 74 6d 74 20 2a 70 46 72 6f 6d 53 74 6d 74  _stmt *pFromStmt
4e20: 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  , sqlite3_stmt *
4e30: 70 54 6f 53 74 6d 74 29 7b 0a 20 20 56 64 62 65  pToStmt){.  Vdbe
4e40: 20 2a 70 46 72 6f 6d 20 3d 20 28 56 64 62 65 2a   *pFrom = (Vdbe*
4e50: 29 70 46 72 6f 6d 53 74 6d 74 3b 0a 20 20 56 64  )pFromStmt;.  Vd
4e60: 62 65 20 2a 70 54 6f 20 3d 20 28 56 64 62 65 2a  be *pTo = (Vdbe*
4e70: 29 70 54 6f 53 74 6d 74 3b 0a 20 20 69 6e 74 20  )pToStmt;.  int 
4e80: 69 2c 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  i, rc = SQLITE_O
4e90: 4b 3b 0a 20 20 69 66 28 20 28 70 46 72 6f 6d 2d  K;.  if( (pFrom-
4ea0: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47  >magic!=VDBE_MAG
4eb0: 49 43 5f 52 55 4e 20 26 26 20 70 46 72 6f 6d 2d  IC_RUN && pFrom-
4ec0: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47  >magic!=VDBE_MAG
4ed0: 49 43 5f 48 41 4c 54 29 0a 20 20 20 20 7c 7c 20  IC_HALT).    || 
4ee0: 28 70 54 6f 2d 3e 6d 61 67 69 63 21 3d 56 44 42  (pTo->magic!=VDB
4ef0: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 70  E_MAGIC_RUN && p
4f00: 54 6f 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f  To->magic!=VDBE_
4f10: 4d 41 47 49 43 5f 48 41 4c 54 29 20 29 7b 0a 20  MAGIC_HALT) ){. 
4f20: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
4f30: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69  _MISUSE;.  }.  i
4f40: 66 28 20 70 46 72 6f 6d 2d 3e 6e 56 61 72 21 3d  f( pFrom->nVar!=
4f50: 70 54 6f 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20  pTo->nVar ){.   
4f60: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
4f70: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 66 6f 72 28  RROR;.  }.  for(
4f80: 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f  i=0; rc==SQLITE_
4f90: 4f 4b 20 26 26 20 69 3c 70 46 72 6f 6d 2d 3e 6e  OK && i<pFrom->n
4fa0: 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 72  Var; i++){.    r
4fb0: 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d  c = sqlite3VdbeM
4fc0: 65 6d 4d 6f 76 65 28 26 70 54 6f 2d 3e 61 56 61  emMove(&pTo->aVa
4fd0: 72 5b 69 5d 2c 20 26 70 46 72 6f 6d 2d 3e 61 56  r[i], &pFrom->aV
4fe0: 61 72 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20 72 65  ar[i]);.  }.  re
4ff0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
5000: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 71 6c  * Return the sql
5010: 69 74 65 33 2a 20 64 61 74 61 62 61 73 65 20 68  ite3* database h
5020: 61 6e 64 6c 65 20 74 6f 20 77 68 69 63 68 20 74  andle to which t
5030: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
5040: 65 6d 65 6e 74 20 67 69 76 65 6e 0a 2a 2a 20 69  ement given.** i
5050: 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 62  n the argument b
5060: 65 6c 6f 6e 67 73 2e 20 20 54 68 69 73 20 69 73  elongs.  This is
5070: 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61   the same databa
5080: 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 77  se handle that w
5090: 61 73 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20  as.** the first 
50a0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20  argument to the 
50b0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28  sqlite3_prepare(
50c0: 29 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20  ) that was used 
50d0: 74 6f 20 63 72 65 61 74 65 0a 2a 2a 20 74 68 65  to create.** the
50e0: 20 73 74 61 74 65 6d 65 6e 74 20 69 6e 20 74 68   statement in th
50f0: 65 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 2a  e first place..*
5100: 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74  /.sqlite3 *sqlit
5110: 65 33 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71 6c  e3_db_handle(sql
5120: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
5130: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74 6d  ){.  return pStm
5140: 74 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74 6d  t ? ((Vdbe*)pStm
5150: 74 29 2d 3e 64 62 20 3a 20 30 3b 0a 7d 0a        t)->db : 0;.}.